{ "argumentSchema": { "$defs": { "Attachment": { "properties": { "attachedAt": { "type": "number" }, "nativeSessionId": { "type": "string" }, "sourceId": { "type": "string" }, "title": { "type": "string" }, "workstreamId": { "description": "The workstream the session was attached under, where one applies.", "type": "string" } }, "required": [ "sourceId", "nativeSessionId", "title", "attachedAt" ], "type": "object" }, "CheckoutEntry": { "properties": { "branch": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "commit": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "root": { "type": "string" } }, "required": [ "root" ], "type": "object" }, "PersonView": { "properties": { "login": { "type": "string" }, "name": { "type": "string" } }, "required": [ "name" ], "type": "object" }, "PullRequestView": { "properties": { "number": { "type": "number" }, "state": { "enum": [ "open", "draft", "merged", "closed" ] }, "title": { "type": "string" }, "updatedAt": { "type": "string" }, "url": { "type": "string" } }, "required": [ "number", "title", "state", "url", "updatedAt" ], "type": "object" }, "SessionEntry": { "properties": { "active": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "archived": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ] }, "cwd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "gitBranch": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "gitRepo": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "gitWorktreeRoot": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "nativeSessionId": { "type": "string" }, "sourceId": { "type": "string" }, "syncStatus": { "type": "string" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "updatedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "sourceId", "nativeSessionId", "title", "cwd", "gitRepo", "gitBranch", "gitWorktreeRoot", "updatedAt", "active", "archived", "syncStatus" ], "type": "object" }, "SessionIndexView": { "properties": { "checkouts": { "items": { "anyOf": [ { "type": "undefined" }, { "$ref": "#/$defs/CheckoutEntry" } ] }, "type": "array" }, "generatedAt": { "type": "string" }, "ownerDid": { "description": "The connector owner's DID; every command a workbench sends names it.", "type": "string" }, "schema": { "type": "string" }, "sessions": { "items": { "anyOf": [ { "type": "undefined" }, { "$ref": "#/$defs/SessionEntry" } ] }, "type": "array" }, "sources": { "items": { "anyOf": [ { "type": "undefined" }, { "$ref": "#/$defs/SourceEntry" } ] }, "type": "array" } }, "required": [ "schema", "sessions" ], "type": "object" }, "SessionStart": { "properties": { "commandId": { "type": "string" }, "nativeSessionId": { "type": "string" }, "sourceId": { "type": "string" }, "startedAt": { "type": "number" }, "title": { "type": "string" }, "workstreamId": { "description": "The workstream the start was made for, where one applies.", "type": "string" } }, "required": [ "commandId", "sourceId", "nativeSessionId", "title", "startedAt" ], "type": "object" }, "ShownHarness": { "properties": { "driver": { "type": "string" }, "id": { "type": "string" } }, "required": [ "id", "driver" ], "type": "object" }, "SnapshotView": { "properties": { "generatedAt": { "default": "", "type": "string" }, "people": { "default": [], "items": { "$ref": "#/$defs/PersonView" }, "type": "array" }, "repository": { "default": "", "type": "string" }, "workstreams": { "default": [], "items": { "$ref": "#/$defs/WorkstreamView" }, "type": "array" } }, "required": [ "repository", "generatedAt", "people", "workstreams" ], "type": "object" }, "SourceEntry": { "properties": { "driver": { "type": "string" }, "id": { "type": "string" } }, "required": [ "id", "driver" ], "type": "object" }, "TopicView": { "properties": { "lastActivityAt": { "type": "number" }, "summary": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string" } }, "required": [ "title", "url" ], "type": "object" }, "WorkstreamView": { "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "people": { "description": "Logins or names, as the snapshot's people list spells them.", "items": { "type": "string" }, "type": "array" }, "prs": { "items": { "$ref": "#/$defs/PullRequestView" }, "type": "array" }, "summary": { "type": "string" }, "topics": { "items": { "$ref": "#/$defs/TopicView" }, "type": "array" } }, "required": [ "id", "name", "summary", "people", "topics", "prs" ], "type": "object" } }, "properties": { "attached": { "asCell": [ "cell" ], "default": [], "description": "Sessions attached to workstreams by hand, this piece's own record.", "items": { "$ref": "#/$defs/Attachment" }, "type": "array" }, "commands": { "asCell": [ "cell" ], "default": [], "description": "The command queue the connector's host binds for this piece.", "items": { "type": "string" }, "type": "array" }, "harnessesShown": { "default": [], "description": "Harnesses listed in the picker that no configured source backs.", "items": { "$ref": "#/$defs/ShownHarness" }, "type": "array" }, "person": { "default": "", "description": "Whose work to show: a login or a name from the snapshot's people.", "type": "string" }, "sessions": { "$ref": "#/$defs/SessionIndexView", "description": "The agents connector's complete session index for the viewer." }, "snapshot": { "$ref": "#/$defs/SnapshotView", "description": "The work-snapshot piece, linked whole." }, "startMode": { "default": "", "description": "The permission mode a started session's first turn runs under.", "type": "string" }, "startSurface": { "default": "", "description": "Where a started session runs: `headless` (the default) runs the first\nturn on this Mac through the connector; `desktop` opens Claude Code on\nthis Mac with the kickoff ready to send, takes no mode, and the session\nthe app makes joins once the person sends it and the connector sees it.", "type": "string" }, "starts": { "asCell": [ "cell" ], "default": [], "description": "Every start this piece has sent, its own record. A start the index has\nconfirmed stays here, since the record is what files its session under\nthe workstream; one the index has not confirmed can be withdrawn.", "items": { "$ref": "#/$defs/SessionStart" }, "type": "array" } }, "type": "object" }, "pattern": "person-workbench/main.tsx", "resultSchema": { "$defs": { "AttachEvent": { "properties": { "nativeSessionId": { "type": "string" }, "sourceId": { "type": "string" }, "title": { "type": "string" }, "workstreamId": { "description": "One of the person's workstreams, as the workbench shows them.", "type": "string" } }, "required": [ "sourceId", "nativeSessionId", "workstreamId" ], "type": "object" }, "Attachment": { "properties": { "attachedAt": { "type": "number" }, "nativeSessionId": { "type": "string" }, "sourceId": { "type": "string" }, "title": { "type": "string" }, "workstreamId": { "description": "The workstream the session was attached under, where one applies.", "type": "string" } }, "required": [ "sourceId", "nativeSessionId", "title", "attachedAt" ], "type": "object" }, "DetachEvent": { "properties": { "nativeSessionId": { "type": "string" }, "sourceId": { "type": "string" } }, "required": [ "sourceId", "nativeSessionId" ], "type": "object" }, "PullRequestView": { "properties": { "number": { "type": "number" }, "state": { "enum": [ "open", "draft", "merged", "closed" ] }, "title": { "type": "string" }, "updatedAt": { "type": "string" }, "url": { "type": "string" } }, "required": [ "number", "title", "state", "url", "updatedAt" ], "type": "object" }, "SessionRow": { "properties": { "active": { "type": "boolean" }, "attached": { "type": "boolean" }, "cwd": { "type": "string" }, "gitBranch": { "type": "string" }, "gitRepo": { "type": "string" }, "key": { "type": "string" }, "nativeSessionId": { "type": "string" }, "sourceId": { "type": "string" }, "startedAs": { "description": "The id the start that made this session named, or \"\" when the session\nis its own start's or none.", "type": "string" }, "title": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "key", "sourceId", "nativeSessionId", "title", "cwd", "gitBranch", "gitRepo", "updatedAt", "active", "attached", "startedAs" ], "type": "object" }, "SessionStart": { "properties": { "commandId": { "type": "string" }, "nativeSessionId": { "type": "string" }, "sourceId": { "type": "string" }, "startedAt": { "type": "number" }, "title": { "type": "string" }, "workstreamId": { "description": "The workstream the start was made for, where one applies.", "type": "string" } }, "required": [ "commandId", "sourceId", "nativeSessionId", "title", "startedAt" ], "type": "object" }, "TopicView": { "properties": { "lastActivityAt": { "type": "number" }, "summary": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string" } }, "required": [ "title", "url" ], "type": "object" }, "WorkstreamCard": { "properties": { "id": { "type": "string" }, "mergedCount": { "type": "number" }, "name": { "type": "string" }, "openCount": { "type": "number" }, "people": { "items": { "type": "string" }, "type": "array" }, "prs": { "items": { "$ref": "#/$defs/PullRequestView" }, "type": "array" }, "sessions": { "items": { "$ref": "#/$defs/SessionRow" }, "type": "array" }, "summary": { "type": "string" }, "topics": { "items": { "$ref": "#/$defs/TopicView" }, "type": "array" } }, "required": [ "id", "name", "summary", "people", "topics", "prs", "openCount", "mergedCount", "sessions" ], "type": "object" } }, "properties": { "$NAME": { "type": "string" }, "$UI": { "$ref": "https://commonfabric.org/schemas/vnode.json" }, "attach": { "$ref": "#/$defs/AttachEvent", "asCell": [ "stream" ], "description": "Attach a session under one of the person's workstreams. Idempotent." }, "attached": { "default": [], "description": "The sessions attached by hand; `attachedSessions` adds the confirmed\nstarts to them.", "items": { "$ref": "#/$defs/Attachment" }, "type": "array" }, "attachedSessions": { "description": "Every attached session, the confirmed starts among them.", "items": { "$ref": "#/$defs/SessionRow" }, "type": "array" }, "commandAuthorization": { "ifc": { "writeAuthorizedBy": { "__ctWriterIdentityOf": { "file": "/packages/patterns/person-workbench/main.tsx", "moduleIdentity": "0OB-qmxBsQoV356JHUIt6GnuAw9nM2fP0WIzUwdx8xk", "path": [ "startWorkstreamSession" ] } } }, "type": "boolean" }, "detach": { "$ref": "#/$defs/DetachEvent", "asCell": [ "stream" ], "description": "Detach a session by provider identity, a started one included." }, "kickoff": { "type": "string" }, "orphanedSessions": { "description": "Attached sessions whose workstream the workbench no longer shows.", "items": { "$ref": "#/$defs/SessionRow" }, "type": "array" }, "personName": { "type": "string" }, "recentSessions": { "items": { "$ref": "#/$defs/SessionRow" }, "type": "array" }, "spawnPrompt": { "type": "string" }, "spawnRoot": { "type": "string" }, "spawnSource": { "type": "string" }, "spawnWorkstream": { "type": "string" }, "startBlocker": { "description": "Why Start would send nothing, or \"\" when it would.", "type": "string" }, "startSession": { "asCell": [ "stream", "opaque" ], "description": "Start a session for the picked workstream.", "tier": "wrapper" }, "startingSessions": { "description": "Starts the index has not confirmed yet.", "items": { "$ref": "#/$defs/SessionStart" }, "type": "array" }, "workstreams": { "items": { "$ref": "#/$defs/WorkstreamCard" }, "type": "array" } }, "required": [ "personName", "workstreams", "attached", "attachedSessions", "orphanedSessions", "startingSessions", "recentSessions", "kickoff", "startBlocker", "spawnPrompt", "spawnRoot", "spawnSource", "spawnWorkstream", "attach", "detach", "startSession", "$NAME", "$UI" ], "type": "object" } }