runpane 2.4.136 → 2.4.137

package/dist/localControl.js

@@ -15,6 +15,9 @@ exports.runSessionsSetAgent = runSessionsSetAgent;
 exports.runSessionsAssociate = runSessionsAssociate;
 exports.runSessionsDetach = runSessionsDetach;
 exports.runSessionsOverview = runSessionsOverview;
+exports.runLockAcquire = runLockAcquire;
+exports.runLockRelease = runLockRelease;
+exports.runLockList = runLockList;
 exports.runPanesCost = runPanesCost;
 exports.runWorkspaceState = runWorkspaceState;
 exports.runWatch = runWatch;
@@ -29,13 +32,19 @@ exports.runPanelsCreate = runPanelsCreate;
 exports.runPanelsOutput = runPanelsOutput;
 exports.runPanelsInput = runPanelsInput;
 exports.runPanelsScreen = runPanelsScreen;
+exports.runPanelsLastMessage = runPanelsLastMessage;
+exports.runReport = runReport;
 exports.runPanelsSubmit = runPanelsSubmit;
+exports.markSuggestionLine = markSuggestionLine;
+exports.printPromptNotes = printPromptNotes;
 exports.runPanelsSubmitComposer = runPanelsSubmitComposer;
 exports.runPanelsWait = runPanelsWait;
 exports.runAgentsDoctor = runAgentsDoctor;
 exports.buildPanelInputRequest = buildPanelInputRequest;
 exports.buildPaneCreateRequest = buildPaneCreateRequest;
+const node_crypto_1 = require("node:crypto");
 const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
 const node_process_1 = require("node:process");
 const promises_1 = require("node:readline/promises");
 const boundaryDecoder_1 = require("./boundaryDecoder");
@@ -65,6 +74,7 @@ const paneSummarySchema = boundaryDecoder_1.boundary.object({
     name: boundaryDecoder_1.boundary.string,
     status: boundaryDecoder_1.boundary.string,
     agentStatus: boundaryDecoder_1.boundary.enumeration('active', 'idle'),
+    agentState: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('ready', 'working', 'blocked', 'none')),
     worktreePath: boundaryDecoder_1.boundary.string,
     repoId: boundaryDecoder_1.boundary.number,
     repoName: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
@@ -76,7 +86,7 @@ const paneSummarySchema = boundaryDecoder_1.boundary.object({
     ownership: boundaryDecoder_1.boundary.enumeration('pane', 'external'),
 });
 const panelBlockedSchema = boundaryDecoder_1.boundary.object({
-    kind: boundaryDecoder_1.boundary.enumeration('codex-update', 'agent-prompt', 'submission_unverified', 'unknown'),
+    kind: boundaryDecoder_1.boundary.enumeration('codex-update', 'agent-prompt', 'submission_unverified', 'composer-unknown', 'unknown'),
     message: boundaryDecoder_1.boundary.string,
     suggestedCommand: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
 });
@@ -100,6 +110,14 @@ const panelReadinessSchema = boundaryDecoder_1.boundary.object({
     nextCommand: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
 });
 const verificationSchema = boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('observed', 'unverifiable'));
+const deliverySchema = boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.object({
+    state: boundaryDecoder_1.boundary.enumeration('taken', 'queued', 'in-composer', 'unknown'),
+    evidence: boundaryDecoder_1.boundary.enumeration('transcript', 'screen', 'argv'),
+}));
+const promptWarningsSchema = boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.object({
+    code: boundaryDecoder_1.boundary.enumeration('leading-bang-runs-shell', 'leading-hash-memory', 'leading-slash-command', 'leading-at-mention'),
+    message: boundaryDecoder_1.boundary.string,
+})));
 const initialInputSchema = boundaryDecoder_1.boundary.object({
     delivered: boundaryDecoder_1.boundary.boolean,
     submitted: boundaryDecoder_1.boundary.boolean,
@@ -108,6 +126,7 @@ const initialInputSchema = boundaryDecoder_1.boundary.object({
     sequenceName: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('codex-ctrl-enter-cr', 'enter-cr', 'argument')),
     verifiedSubmitted: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
     verification: verificationSchema,
+    delivery: deliverySchema,
     staged: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
     attempts: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
     sentAt: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
@@ -130,7 +149,52 @@ const archiveSafetySchema = boundaryDecoder_1.boundary.object({
         sha: boundaryDecoder_1.boundary.string,
         subject: boundaryDecoder_1.boundary.string,
     }))),
+    reason: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('external-worktree', 'main-repo', 'missing-project-context', 'git-error')),
+    worktreeWillRemain: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.literal(true)),
+    upstreamGone: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
+    mergedViaPr: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.object({
+        number: boundaryDecoder_1.boundary.number,
+        headOid: boundaryDecoder_1.boundary.string,
+    })),
+});
+const agentReportFields = {
+    state: boundaryDecoder_1.boundary.enumeration('ready', 'blocked', 'failed', 'done'),
+    pr: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
+    head: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    summary: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    summaryTruncated: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.literal(true)),
+    summaryPath: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    question: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    reportedAt: boundaryDecoder_1.boundary.string,
+};
+const agentReportSchema = boundaryDecoder_1.boundary.object(agentReportFields);
+const reportResultSchema = boundaryDecoder_1.boundary.object({
+    ok: boundaryDecoder_1.boundary.literal(true),
+    generation: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
+    paneId: boundaryDecoder_1.boundary.string,
+    panelId: boundaryDecoder_1.boundary.string,
+    report: agentReportSchema,
+    sessionIds: boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string),
 });
+const panelLastMessageResultSchema = boundaryDecoder_1.boundary.union(boundaryDecoder_1.boundary.object({
+    ok: boundaryDecoder_1.boundary.literal(true),
+    panelId: boundaryDecoder_1.boundary.string,
+    paneId: boundaryDecoder_1.boundary.string,
+    agentType: boundaryDecoder_1.boundary.enumeration('claude', 'codex'),
+    text: boundaryDecoder_1.boundary.string,
+    length: boundaryDecoder_1.boundary.number,
+    limit: boundaryDecoder_1.boundary.number,
+    truncated: boundaryDecoder_1.boundary.boolean,
+}), boundaryDecoder_1.boundary.object({
+    ok: boundaryDecoder_1.boundary.literal(false),
+    panelId: boundaryDecoder_1.boundary.string,
+    paneId: boundaryDecoder_1.boundary.string,
+    reason: boundaryDecoder_1.boundary.literal('transcript-unavailable'),
+    message: boundaryDecoder_1.boundary.string,
+}));
+const archiveBlockCodeSchema = boundaryDecoder_1.boundary.enumeration('uncommitted-changes', 'unpushed-commits', 'uncommitted-and-unpushed', 'status-unknown');
+const worktreeCleanupSchema = boundaryDecoder_1.boundary.enumeration('completed', 'failed', 'timeout', 'not-applicable');
+const trashDeletionSchema = boundaryDecoder_1.boundary.enumeration('pending', 'done');
 const panelSummarySchema = boundaryDecoder_1.boundary.object({
     id: boundaryDecoder_1.boundary.string,
     panelId: boundaryDecoder_1.boundary.string,
@@ -140,10 +204,13 @@ const panelSummarySchema = boundaryDecoder_1.boundary.object({
     active: boundaryDecoder_1.boundary.boolean,
     initialized: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
     agentType: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    agentDetection: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('declared', 'command', 'process', 'screen')),
+    launchCommand: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
     isCliPanel: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
     position: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
     createdAt: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
     lastActiveAt: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    report: boundaryDecoder_1.boundary.optional(agentReportSchema),
 });
 const repoListResultSchema = boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.literal(true),
@@ -256,6 +323,55 @@ const orchestrationPaneOverviewSchema = boundaryDecoder_1.boundary.object({
         prTitle: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
         prState: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
     })),
+    report: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.object({ ...agentReportFields, panelId: boundaryDecoder_1.boundary.nonEmptyString })),
+});
+const lockOwnerSchema = boundaryDecoder_1.boundary.object({
+    kind: boundaryDecoder_1.boundary.enumeration('pane', 'external'),
+    paneId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.nonEmptyString),
+    panelId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.nonEmptyString),
+    label: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+});
+const lockRecordSchema = boundaryDecoder_1.boundary.object({
+    name: boundaryDecoder_1.boundary.nonEmptyString,
+    scope: boundaryDecoder_1.boundary.enumeration('session', 'global'),
+    sessionId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.nonEmptyString),
+    owner: lockOwnerSchema,
+    note: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    acquiredAt: boundaryDecoder_1.boundary.nonEmptyString,
+    expiresAt: boundaryDecoder_1.boundary.nonEmptyString,
+    ttlMs: boundaryDecoder_1.boundary.number,
+});
+const lockAcquireResultSchema = boundaryDecoder_1.boundary.union(boundaryDecoder_1.boundary.object({
+    ok: boundaryDecoder_1.boundary.literal(true),
+    acquired: boundaryDecoder_1.boundary.literal(true),
+    renewed: boundaryDecoder_1.boundary.boolean,
+    waitedMs: boundaryDecoder_1.boundary.number,
+    lock: lockRecordSchema,
+}), boundaryDecoder_1.boundary.object({
+    ok: boundaryDecoder_1.boundary.literal(false),
+    acquired: boundaryDecoder_1.boundary.literal(false),
+    timedOut: boundaryDecoder_1.boundary.boolean,
+    waitedMs: boundaryDecoder_1.boundary.number,
+    heldBy: lockOwnerSchema,
+    expiresAt: boundaryDecoder_1.boundary.nonEmptyString,
+    lock: lockRecordSchema,
+}));
+const lockReleaseResultSchema = boundaryDecoder_1.boundary.union(boundaryDecoder_1.boundary.object({
+    ok: boundaryDecoder_1.boundary.literal(true),
+    released: boundaryDecoder_1.boundary.boolean,
+    forced: boundaryDecoder_1.boundary.boolean,
+    lock: boundaryDecoder_1.boundary.optional(lockRecordSchema),
+}), boundaryDecoder_1.boundary.object({
+    ok: boundaryDecoder_1.boundary.literal(false),
+    released: boundaryDecoder_1.boundary.literal(false),
+    reason: boundaryDecoder_1.boundary.literal('not-owner'),
+    heldBy: lockOwnerSchema,
+    expiresAt: boundaryDecoder_1.boundary.nonEmptyString,
+    lock: lockRecordSchema,
+}));
+const lockListResultSchema = boundaryDecoder_1.boundary.object({
+    ok: boundaryDecoder_1.boundary.literal(true),
+    locks: boundaryDecoder_1.boundary.array(lockRecordSchema),
 });
 const runpaneSessionOverviewResultSchema = boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.literal(true),
@@ -268,6 +384,7 @@ const runpaneSessionOverviewResultSchema = boundaryDecoder_1.boundary.object({
         freshness: boundaryDecoder_1.boundary.enumeration('current', 'stale'),
     })),
     refreshedAt: boundaryDecoder_1.boundary.nonEmptyString,
+    locks: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(lockRecordSchema)),
 });
 function orchestrationReportSchemaFields() {
     return {
@@ -367,6 +484,8 @@ exports.paneCreateResultSchema = boundaryDecoder_1.boundary.object({
             ok: boundaryDecoder_1.boundary.boolean,
             error: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
         })),
+        promptFile: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+        warnings: promptWarningsSchema,
     }), boundaryDecoder_1.boundary.object({
         ok: boundaryDecoder_1.boundary.literal(false),
         index: boundaryDecoder_1.boundary.number,
@@ -385,7 +504,7 @@ const paneArchiveResultSchema = boundaryDecoder_1.boundary.union(boundaryDecoder
     generation: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
     paneId: boundaryDecoder_1.boundary.string,
     blocked: boundaryDecoder_1.boundary.object({
-        code: boundaryDecoder_1.boundary.enumeration('uncommitted-changes', 'unpushed-commits', 'uncommitted-and-unpushed', 'status-unknown'),
+        code: archiveBlockCodeSchema,
         message: boundaryDecoder_1.boundary.string,
         safetyCheck: archiveSafetySchema,
     }),
@@ -398,7 +517,7 @@ const paneArchiveResultSchema = boundaryDecoder_1.boundary.union(boundaryDecoder
     forced: boundaryDecoder_1.boundary.boolean,
     safetyCheck: archiveSafetySchema,
     blocked: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.object({
-        code: boundaryDecoder_1.boundary.enumeration('uncommitted-changes', 'unpushed-commits', 'uncommitted-and-unpushed', 'status-unknown'),
+        code: archiveBlockCodeSchema,
         message: boundaryDecoder_1.boundary.string,
         safetyCheck: archiveSafetySchema,
     })),
@@ -408,10 +527,35 @@ const paneArchiveResultSchema = boundaryDecoder_1.boundary.union(boundaryDecoder
     paneId: boundaryDecoder_1.boundary.string,
     archived: boundaryDecoder_1.boundary.literal(true),
     forced: boundaryDecoder_1.boundary.boolean,
-    worktreeCleanup: boundaryDecoder_1.boundary.enumeration('completed', 'failed', 'timeout', 'not-applicable'),
+    worktreeCleanup: worktreeCleanupSchema,
+    trashDeletion: boundaryDecoder_1.boundary.optional(trashDeletionSchema),
     worktreePath: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
     safetyCheck: archiveSafetySchema,
 }));
+const paneArchiveBulkResultSchema = boundaryDecoder_1.boundary.object({
+    ok: boundaryDecoder_1.boundary.boolean,
+    sessionId: boundaryDecoder_1.boundary.string,
+    merged: boundaryDecoder_1.boundary.literal(true),
+    dryRun: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.literal(true)),
+    removeWorktree: boundaryDecoder_1.boundary.boolean,
+    archived: boundaryDecoder_1.boundary.number,
+    skipped: boundaryDecoder_1.boundary.number,
+    failed: boundaryDecoder_1.boundary.number,
+    items: boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.object({
+        paneId: boundaryDecoder_1.boundary.string,
+        name: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+        outcome: boundaryDecoder_1.boundary.enumeration('archived', 'would-archive', 'skipped', 'failed'),
+        skipped: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.object({
+            code: boundaryDecoder_1.boundary.enumeration('uncommitted-changes', 'unpushed-commits', 'uncommitted-and-unpushed', 'status-unknown', 'missing-pane', 'already-archived', 'main-repo'),
+            message: boundaryDecoder_1.boundary.string,
+        })),
+        error: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+        safetyCheck: boundaryDecoder_1.boundary.optional(archiveSafetySchema),
+        worktreeCleanup: boundaryDecoder_1.boundary.optional(worktreeCleanupSchema),
+        trashDeletion: boundaryDecoder_1.boundary.optional(trashDeletionSchema),
+        worktreePath: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    })),
+});
 const panePinResultSchema = boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.literal(true),
     generation: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
@@ -452,6 +596,8 @@ const panelCreateResultSchema = boundaryDecoder_1.boundary.object({
     }),
     readiness: boundaryDecoder_1.boundary.optional(panelReadinessSchema),
     initialInput: boundaryDecoder_1.boundary.optional(initialInputSchema),
+    promptFile: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    warnings: promptWarningsSchema,
     nextCommand: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
 });
 const panelOutputResultSchema = boundaryDecoder_1.boundary.object({
@@ -490,6 +636,7 @@ exports.panelScreenResultSchema = boundaryDecoder_1.boundary.object({
     composer: boundaryDecoder_1.boundary.object({
         isPresent: boundaryDecoder_1.boundary.boolean,
         hasUndeliveredText: boundaryDecoder_1.boundary.boolean,
+        ghostText: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
     }),
     nextCommand: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
 });
@@ -503,8 +650,11 @@ exports.panelSubmitResultSchema = boundaryDecoder_1.boundary.object({
     sequenceName: boundaryDecoder_1.boundary.enumeration('codex-ctrl-enter-cr', 'enter-cr', 'tab'),
     verifiedSubmitted: boundaryDecoder_1.boundary.boolean,
     verification: verificationSchema,
+    delivery: deliverySchema,
     sentAt: boundaryDecoder_1.boundary.string,
     blocked: boundaryDecoder_1.boundary.optional(panelBlockedSchema),
+    promptFile: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    warnings: promptWarningsSchema,
     nextCommand: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
 });
 const panelSubmitComposerResultSchema = boundaryDecoder_1.boundary.object({
@@ -517,6 +667,7 @@ const panelSubmitComposerResultSchema = boundaryDecoder_1.boundary.object({
     sequenceName: boundaryDecoder_1.boundary.enumeration('codex-ctrl-enter-cr', 'enter-cr', 'tab'),
     verifiedSubmitted: boundaryDecoder_1.boundary.boolean,
     verification: verificationSchema,
+    delivery: deliverySchema,
     sentAt: boundaryDecoder_1.boundary.string,
     blocked: boundaryDecoder_1.boundary.optional(panelBlockedSchema),
     nextCommand: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
@@ -554,7 +705,7 @@ const agentDoctorResultSchema = boundaryDecoder_1.boundary.object({
     })),
     warnings: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string)),
 });
-const workspaceEntryKindSchema = boundaryDecoder_1.boundary.enumeration('agent.ready', 'agent.busy', 'agent.blocked', 'agent.unknown', 'agent.idle', 'pane.created', 'pane.gone', 'panel.exited');
+const workspaceEntryKindSchema = boundaryDecoder_1.boundary.enumeration('agent.ready', 'agent.busy', 'agent.blocked', 'agent.unknown', 'agent.idle', 'pane.created', 'pane.gone', 'panel.exited', 'pane.associated', 'pane.detached', 'pr.conflicted', 'pr.checks', 'pr.merged', 'agent.report');
 const agentStateSchema = boundaryDecoder_1.boundary.enumeration('blocked', 'working', 'idle', 'unknown');
 const workspacePanelSummarySchema = boundaryDecoder_1.boundary.object({
     panelId: boundaryDecoder_1.boundary.string,
@@ -576,7 +727,7 @@ const workspaceEntrySchema = boundaryDecoder_1.boundary.object({
     agentType: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
     from: boundaryDecoder_1.boundary.optional(agentStateSchema),
     to: boundaryDecoder_1.boundary.optional(agentStateSchema),
-    source: boundaryDecoder_1.boundary.enumeration('agent', 'exit', 'session'),
+    source: boundaryDecoder_1.boundary.enumeration('agent', 'exit', 'session', 'github'),
     reason: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.nullable(boundaryDecoder_1.boundary.string)),
     settledMs: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
     idleMs: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
@@ -585,7 +736,14 @@ const workspaceEntrySchema = boundaryDecoder_1.boundary.object({
     heldInputPresent: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
     exitCode: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
     baseline: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.literal(true)),
+    replay: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.literal(true)),
     changedWhileAway: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
+    sessionId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    sessionName: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    pr: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.object({ number: boundaryDecoder_1.boundary.number, url: boundaryDecoder_1.boundary.string, headOid: boundaryDecoder_1.boundary.string })),
+    checks: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('passed', 'failed')),
+    failingChecks: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string)),
+    report: boundaryDecoder_1.boundary.optional(agentReportSchema),
     panels: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(workspacePanelSummarySchema)),
 });
 exports.workspaceStateResultSchema = boundaryDecoder_1.boundary.object({
@@ -604,20 +762,24 @@ const workspaceWaitResultSchema = boundaryDecoder_1.boundary.object({
     reset: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.object({
         reason: boundaryDecoder_1.boundary.enumeration('first-use', 'epoch-changed', 'cursor-truncated', 'unknown-consumer'),
     })),
+    session: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.object({ id: boundaryDecoder_1.boundary.string, name: boundaryDecoder_1.boundary.string })),
     nextCommand: boundaryDecoder_1.boundary.string,
 });
 const repoSelectorSchema = boundaryDecoder_1.boundary.union(boundaryDecoder_1.boundary.nonEmptyString, boundaryDecoder_1.boundary.object({ id: boundaryDecoder_1.boundary.number }), boundaryDecoder_1.boundary.object({ path: boundaryDecoder_1.boundary.string }), boundaryDecoder_1.boundary.object({ name: boundaryDecoder_1.boundary.string }), boundaryDecoder_1.boundary.object({ active: boundaryDecoder_1.boundary.literal(true) }));
 const paneToolInputSchema = boundaryDecoder_1.boundary.object({
     agent: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
     command: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    agentType: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
     title: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
     initialInput: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    initialInputAsFilePointer: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
 });
 const paneCreateRequestInputSchema = boundaryDecoder_1.boundary.object({
     repo: repoSelectorSchema,
     panes: boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.object({
         name: boundaryDecoder_1.boundary.string,
         worktreeName: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+        branch: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
         baseBranch: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
         sessionPrompt: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
         pinned: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
@@ -646,6 +808,8 @@ const paneAdoptRequestInputSchema = boundaryDecoder_1.boundary.object({
         launch: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
     })),
     dryRun: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
+    waitReady: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
+    readyTimeoutMs: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
     noFocus: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
     focus: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
     source: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('user', 'agent')),
@@ -775,9 +939,123 @@ async function runSessionsOverview(parsed) {
     for (const pane of result.panes) {
         const details = pane.missing ? 'missing' : pane.archived ? 'archived' : pane.panels.map(panel => `${panel.title}=${panel.state}`).join(', ') || 'no terminal panels';
         console.log(`  ${pane.name}: ${details}`);
+        if (pane.report) {
+            console.log(`    report ${(0, watchLines_1.describeReport)(pane.report)} (panel ${pane.report.panelId}, ${pane.report.reportedAt})`);
+        }
+    }
+    for (const lock of result.locks ?? []) {
+        console.log(`  lock ${formatLockLine(lock)}`);
+    }
+    return 0;
+}
+/** One daemon call waits at most this long; longer waits chain calls, each blocking in the daemon. */
+const LOCK_WAIT_PER_CALL_MS = 120_000;
+async function runLockAcquire(parsed) {
+    const name = requireLockName(parsed, 'acquire');
+    if (parsed.lockTtlMs === undefined)
+        throw new Error('runpane lock acquire requires --ttl <duration>, such as --ttl 30m.');
+    const request = { name, ttlMs: parsed.lockTtlMs, note: parsed.note, owner: lockOwnerFromParsed(parsed, false) };
+    const waitMs = parsed.lockWaitMs ?? 0;
+    const startedAt = Date.now();
+    let result;
+    for (;;) {
+        const callWaitMs = Math.min(Math.max(0, waitMs - (Date.now() - startedAt)), LOCK_WAIT_PER_CALL_MS);
+        result = await (0, daemonClient_1.invokeDaemon)('runpane:locks:acquire', [{ ...request, waitMs: callWaitMs }], lockAcquireResultSchema, {
+            paneDir: parsed.paneDir,
+            timeoutMs: callWaitMs + 15_000,
+        });
+        // Only a call that waited out its whole window without the lock coming free chains another.
+        if (result.ok || !result.timedOut || Date.now() - startedAt >= waitMs)
+            break;
+    }
+    const final = { ...result, waitedMs: Date.now() - startedAt };
+    if (parsed.json) {
+        printJson(final);
+    }
+    else if (final.ok) {
+        console.log(`${final.renewed ? 'Renewed' : 'Acquired'} lock ${formatLockLine(final.lock)}`);
+    }
+    else {
+        console.log(`Lock ${final.lock.name} is held by ${formatLockOwner(final.heldBy)} until ${final.expiresAt}${final.lock.note ? ` (${final.lock.note})` : ''}.`);
+    }
+    return final.ok ? 0 : 1;
+}
+async function runLockRelease(parsed) {
+    const name = requireLockName(parsed, 'release');
+    const request = {
+        name,
+        force: parsed.force || undefined,
+        sessionId: parsed.sessionId?.trim() || undefined,
+        owner: lockOwnerFromParsed(parsed, parsed.force === true),
+    };
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:locks:release', [request], lockReleaseResultSchema, { paneDir: parsed.paneDir });
+    if (parsed.json) {
+        printJson(result);
+    }
+    else if (!result.ok) {
+        console.log(`Lock ${name} is held by ${formatLockOwner(result.heldBy)} until ${result.expiresAt}; only its owner can release it. Rerun with --force to release it anyway.`);
+    }
+    else if (result.released) {
+        console.log(`${result.forced ? 'Force-released' : 'Released'} lock ${name}.`);
     }
+    else {
+        console.log(`Lock ${name} was not held.`);
+    }
+    return result.ok ? 0 : 1;
+}
+async function runLockList(parsed) {
+    const sessionId = parsed.sessionId?.trim() || undefined;
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:locks:list', [{ sessionId }], lockListResultSchema, { paneDir: parsed.paneDir });
+    if (parsed.json) {
+        printJson(result);
+        return 0;
+    }
+    for (const lock of result.locks)
+        console.log(formatLockLine(lock));
+    if (result.locks.length === 0)
+        console.log('No locks held.');
     return 0;
 }
+function requireLockName(parsed, action) {
+    const name = parsed.name?.trim();
+    if (!name)
+        throw new Error(`runpane lock ${action} requires --name <name>.`);
+    return name;
+}
+/**
+ * The caller owns the lock: --pane/--panel when given, else the Pane terminal
+ * it runs in ($PANE_SESSION_ID/$PANE_PANEL_ID). Outside Pane, --note names the owner.
+ */
+function lockOwnerFromParsed(parsed, forced) {
+    const explicit = Boolean(parsed.paneId || parsed.panelId);
+    const paneId = explicit ? parsed.paneId : process.env.PANE_SESSION_ID?.trim() || undefined;
+    const panelId = explicit ? parsed.panelId : process.env.PANE_PANEL_ID?.trim() || undefined;
+    const owner = {};
+    if (paneId || panelId) {
+        if (paneId)
+            owner.paneId = paneId;
+        if (panelId)
+            owner.panelId = panelId;
+        return owner;
+    }
+    const label = parsed.note?.trim();
+    if (!label && !forced) {
+        throw new Error('Outside a Pane terminal, pass --note <text> to say who holds the lock (or --pane/--panel to act for a Pane).');
+    }
+    if (label)
+        owner.label = label;
+    return owner;
+}
+function formatLockOwner(owner) {
+    if (owner.kind === 'external')
+        return `external "${owner.label ?? ''}"`;
+    return owner.panelId ? `pane ${owner.paneId} panel ${owner.panelId}` : `pane ${owner.paneId}`;
+}
+function formatLockLine(lock) {
+    const scope = lock.scope === 'session' ? `session ${lock.sessionId}` : 'global';
+    const note = lock.note ? ` (${lock.note})` : '';
+    return `${lock.name} [${scope}] held by ${formatLockOwner(lock.owner)} until ${lock.expiresAt}${note}`;
+}
 function sessionSelectorFromParsed(parsed) {
     const sessionId = parsed.sessionId?.trim();
     if (!sessionId)
@@ -867,12 +1145,21 @@ async function runWatch(parsed) {
         ? undefined
         : parsed.agentsOnly || parsed.follow ? true : undefined;
     const includeHeldInput = parsed.includeHeldInput && !parsed.noHeldInput ? true : undefined;
+    // Lines mode turns presence into STUCK; JSON mode passes heldInputPresent through as the equivalent.
     const includeHeldInputPresence = defaults.includeHeldInputPresence
-        && !parsed.noHeldInput && parsed.follow && format === 'lines' ? true : undefined;
+        && !parsed.noHeldInput && parsed.follow ? true : undefined;
     const cadenceValueFlagPresent = (0, commands_1.hasCadenceValueFlag)(parsed);
     // Cadence state lives in the daemon per named consumer, so an anonymous follower names itself.
+    // A Session watch is named after the Session, so it survives an orchestrator agent switch.
+    const sessionCursor = parsed.sessionId ? sessionWatchCursorName(parsed.sessionId) : undefined;
+    const panelCursor = process.env.PANE_PANEL_ID ? derivedWatchCursorName('panel', process.env.PANE_PANEL_ID) : undefined;
     const watchAs = parsed.watchAs
-        ?? (parsed.follow ? process.env.PANE_PANEL_ID || (cadenceValueFlagPresent ? `follow-${process.pid}` : undefined) : undefined);
+        ?? (parsed.follow ? sessionCursor || panelCursor || (cadenceValueFlagPresent ? `follow-${process.pid}` : undefined) : undefined);
+    // --quiet drops lines that only prove liveness; --self-test still prints its WATCH OK result.
+    const emitControlLine = (line) => {
+        if (!parsed.quiet)
+            emitWatchLine(line);
+    };
     const request = {
         as: watchAs,
         since: parsed.watchSince,
@@ -881,6 +1168,8 @@ async function runWatch(parsed) {
         limit: parsed.limit,
         kinds: parsed.watchKinds,
         paneIds: parsed.watchPaneIds,
+        // The daemon resolves the Session (id or exact name) and re-reads its Panes on every read.
+        session: parsed.sessionId,
         excludePaneIds: parsed.watchExcludePaneIds,
         repo: parsed.repo,
         nameContains: parsed.nameContains,
@@ -914,12 +1203,20 @@ async function runWatch(parsed) {
                 timeoutMs: timeoutMs + 5_000,
                 eventInclude: [],
             });
+            if (request.session && !result.session) {
+                // An older daemon ignores the unknown field and would watch every Pane instead.
+                throw new Error('This Pane daemon does not support runpane watch --session; update Pane, or pass one --pane per Session Pane.');
+            }
             if (failingCode) {
-                emitWatchLine((0, watchLines_1.formatNonEntry)('_reconnected', { generation: result.generation }, format));
+                emitControlLine((0, watchLines_1.formatNonEntry)('_reconnected', { generation: result.generation }, format));
                 failingCode = undefined;
             }
             if (!armed && (parsed.follow || parsed.selfTest)) {
-                emitWatchLine((0, watchLines_1.formatNonEntry)('_ok', { generation: result.generation, epoch: result.epoch }, format));
+                const okLine = (0, watchLines_1.formatNonEntry)('_ok', { generation: result.generation, epoch: result.epoch }, format);
+                if (parsed.selfTest)
+                    emitWatchLine(okLine);
+                else
+                    emitControlLine(okLine);
                 armed = true;
                 if (parsed.selfTest)
                     return 0;
@@ -927,7 +1224,7 @@ async function runWatch(parsed) {
             for (const line of (0, watchLines_1.formatWaitResult)(result, format))
                 emitWatchLine(line);
             if (heartbeatMs > 0 && Date.now() - lastHeartbeatAt >= heartbeatMs) {
-                emitWatchLine((0, watchLines_1.formatNonEntry)('_heartbeat', {
+                emitControlLine((0, watchLines_1.formatNonEntry)('_heartbeat', {
                     generation: result.generation,
                     at: new Date().toISOString(),
                 }, format));
@@ -958,6 +1255,27 @@ async function runWatch(parsed) {
 function emitWatchLine(line) {
     node_process_1.stdout.write(`${line}\n`);
 }
+/** Names older daemons accept; the daemon itself allows up to 128 characters. */
+const PORTABLE_WATCH_CURSOR_PATTERN = /^[A-Za-z0-9._-]{1,64}$/u;
+/**
+ * Returns a derived watch cursor name (one runpane builds from an ID, not one the user typed)
+ * that every daemon accepts. A name that is too long or has other characters becomes
+ * `<prefix>-<first 12 hex chars of its sha256>`, which is stable across runs.
+ */
+function derivedWatchCursorName(prefix, name) {
+    if (PORTABLE_WATCH_CURSOR_PATTERN.test(name))
+        return name;
+    return `${prefix}-${(0, node_crypto_1.createHash)('sha256').update(name).digest('hex').slice(0, 12)}`;
+}
+/**
+ * Default cursor for `watch --session`: `session-<uuid>` for a Session id
+ * (`__orchestration_session_<uuid>__`), `session-<name>` for a name, shortened like any
+ * derived name when it is longer than 64 characters or has other characters.
+ */
+function sessionWatchCursorName(session) {
+    const uuid = /^__orchestration_session_(.+)__$/u.exec(session)?.[1];
+    return derivedWatchCursorName('session', `session-${uuid ?? session}`);
+}
 function watchErrorCode(error) {
     return error instanceof daemonClient_1.PaneDaemonClientError ? error.code ?? 'PaneDaemonClientError' : error.name || 'Error';
 }
@@ -1012,6 +1330,9 @@ async function runPanesAdopt(parsed) {
         if (!parsed.repo || !parsed.repoPath || !parsed.name) {
             throw new Error('runpane panes adopt requires --repo, --path, and --name.');
         }
+        if (!parsed.launch && (parsed.initialInput !== undefined || parsed.initialInputFile !== undefined || parsed.waitReady)) {
+            throw new Error('runpane panes adopt only sends a prompt or waits for readiness with --launch. Add --launch to start the agent now.');
+        }
         const tool = await buildToolSpec(parsed, 'panes adopt');
         request = {
             repo: parsed.repo,
@@ -1026,6 +1347,8 @@ async function runPanesAdopt(parsed) {
                     launch: parsed.launch || undefined,
                 }],
             dryRun: parsed.dryRun || undefined,
+            waitReady: parsed.waitReady || undefined,
+            readyTimeoutMs: parsed.readyTimeoutMs,
             noFocus: parsed.noFocus || undefined,
             focus: parsed.focus || undefined,
             source: parsed.source === 'user' || parsed.source === 'agent' ? parsed.source : undefined,
@@ -1035,7 +1358,7 @@ async function runPanesAdopt(parsed) {
     await confirmPaneAdopt(parsed, request);
     const result = await (0, daemonClient_1.invokeDaemon)('runpane:panes:adopt', [request], exports.paneCreateResultSchema, {
         paneDir: parsed.paneDir,
-        timeoutMs: 120_000,
+        timeoutMs: 120_000 + (request.waitReady ? (request.readyTimeoutMs ?? 30_000) : 0),
     });
     if (parsed.json)
         printJson(result);
@@ -1044,8 +1367,11 @@ async function runPanesAdopt(parsed) {
     return result.ok ? 0 : 1;
 }
 async function runPanesArchive(parsed) {
+    if (parsed.sessionId) {
+        return runPanesArchiveSession(parsed, parsed.sessionId);
+    }
     if (!parsed.paneId) {
-        throw new Error('runpane panes archive requires --pane.');
+        throw new Error('runpane panes archive requires --pane (or --session with --merged).');
     }
     const request = {
         paneId: parsed.paneId,
@@ -1056,7 +1382,9 @@ async function runPanesArchive(parsed) {
         request.source = parsed.source;
     if (parsed.dryRun)
         request.dryRun = true;
-    await confirmPaneArchive(parsed, request);
+    if (parsed.removeWorktree)
+        request.removeWorktree = true;
+    await confirmPaneArchive(parsed, `Archive pane ${request.paneId}${request.force ? ' (including any uncommitted or unpushed work)' : ''}`);
     const result = await (0, daemonClient_1.invokeDaemon)('runpane:panes:archive', [request], paneArchiveResultSchema, {
         paneDir: parsed.paneDir,
         timeoutMs: 40_000,
@@ -1069,6 +1397,31 @@ async function runPanesArchive(parsed) {
     }
     return result.ok ? 0 : 1;
 }
+async function runPanesArchiveSession(parsed, sessionId) {
+    if (!parsed.merged) {
+        throw new Error('runpane panes archive --session requires --merged.');
+    }
+    const request = { sessionId, merged: true };
+    if (parsed.source === 'user' || parsed.source === 'agent')
+        request.source = parsed.source;
+    if (parsed.dryRun)
+        request.dryRun = true;
+    if (parsed.removeWorktree)
+        request.removeWorktree = true;
+    await confirmPaneArchive(parsed, `Archive every merged or pushed Pane in Session ${sessionId}`);
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:panes:archive', [request], paneArchiveBulkResultSchema, {
+        paneDir: parsed.paneDir,
+        // Each Pane refreshes its upstream and may wait for its worktree removal.
+        timeoutMs: 600_000,
+    });
+    if (parsed.json) {
+        printJson(result);
+    }
+    else {
+        printPaneArchiveBulkResult(result);
+    }
+    return result.ok ? 0 : 1;
+}
 async function runPanesPin(parsed, pinned) {
     if (!parsed.paneId) {
         throw new Error(`runpane panes ${pinned ? 'pin' : 'unpin'} requires --pane.`);
@@ -1218,12 +1571,84 @@ async function runPanelsScreen(parsed) {
         printJson(result);
         return 0;
     }
-    node_process_1.stdout.write(result.text);
-    if (result.text && !result.text.endsWith('\n')) {
+    const text = markSuggestionLine(result.text, result.composer.ghostText);
+    node_process_1.stdout.write(text);
+    if (text && !text.endsWith('\n')) {
         node_process_1.stdout.write('\n');
     }
     return 0;
 }
+async function runPanelsLastMessage(parsed) {
+    if (!parsed.panelId) {
+        throw new Error('runpane panels last-message requires --panel.');
+    }
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:panels:last-message', [{
+            panelId: parsed.panelId,
+            limit: parsed.limit,
+        }], panelLastMessageResultSchema, {
+        paneDir: parsed.paneDir,
+    });
+    if (parsed.json) {
+        printJson(result);
+    }
+    else if (result.ok) {
+        node_process_1.stdout.write(result.text);
+        if (result.text && !result.text.endsWith('\n'))
+            node_process_1.stdout.write('\n');
+        if (result.truncated)
+            console.error(`(showing the last ${result.limit} of ${result.length} characters)`);
+    }
+    else {
+        console.error(`${result.reason}: ${result.message}`);
+    }
+    return result.ok ? 0 : 1;
+}
+/** Where a report is for: explicit --panel (with an optional --pane), else the Pane terminal's own panel. */
+function resolveReportIdentity(parsed, env = process.env) {
+    if (parsed.paneId || parsed.panelId) {
+        if (!parsed.panelId) {
+            throw new Error('runpane report --pane also needs --panel <panel-id>. Find it with `runpane panels list --pane <pane-id>`.');
+        }
+        return parsed.paneId ? { paneId: parsed.paneId, panelId: parsed.panelId } : { panelId: parsed.panelId };
+    }
+    const panelId = env.PANE_PANEL_ID?.trim();
+    if (!panelId) {
+        throw new Error('runpane report cannot tell which panel is reporting. Run it inside a Pane terminal '
+            + '(which sets PANE_SESSION_ID and PANE_PANEL_ID), or pass --pane <pane-id> --panel <panel-id>.');
+    }
+    const paneId = env.PANE_SESSION_ID?.trim();
+    return paneId ? { paneId, panelId } : { panelId };
+}
+/** The CLIs send one character past the daemon's 16,000 so it still marks an overlong summary truncated. */
+const MAX_SENT_SUMMARY_LENGTH = 16_001;
+async function runReport(parsed, env = process.env) {
+    const identity = resolveReportIdentity(parsed, env);
+    const summaryText = parsed.summaryFile !== undefined
+        ? stripUtf8Bom(readInputSource(parsed.summaryFile))
+        : parsed.summary;
+    const summaryPath = parsed.summaryFile !== undefined && parsed.summaryFile !== '-'
+        ? node_path_1.default.resolve(parsed.summaryFile)
+        : undefined;
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:report', [{
+            ...identity,
+            state: parsed.reportState,
+            pr: parsed.reportPr,
+            head: parsed.reportHead,
+            summary: summaryText?.slice(0, MAX_SENT_SUMMARY_LENGTH),
+            summaryPath,
+            question: parsed.question,
+        }], reportResultSchema, {
+        paneDir: parsed.paneDir,
+    });
+    if (parsed.json) {
+        printJson(result);
+    }
+    else {
+        const sessions = result.sessionIds.length > 0 ? ` Recorded on Session ${result.sessionIds.join(', ')}.` : '';
+        console.log(`Reported ${(0, watchLines_1.describeReport)(result.report)} for panel ${result.panelId}.${sessions}`);
+    }
+    return 0;
+}
 async function runPanelsSubmit(parsed) {
     const request = buildPanelInputRequest(parsed, 'submit');
     await confirmPanelInput(parsed, request, 'submit');
@@ -1237,15 +1662,50 @@ async function runPanelsSubmit(parsed) {
         const verb = result.ok ? 'Submitted' : 'Could not verify';
         const verified = result.verifiedSubmitted ? ' verified' : ' unverified';
         console.log(`${verb} ${result.inputBytes} byte${result.inputBytes === 1 ? '' : 's'} via ${result.sequenceName} to panel ${result.panelId}.${verified}`);
+        printDelivery(result.delivery);
         if (result.blocked) {
             console.log(`Blocked: ${result.blocked.message}`);
         }
+        printPromptNotes(result);
         if (result.nextCommand) {
             console.log(`Next: ${result.nextCommand}`);
         }
     }
     return result.ok ? 0 : 1;
 }
+/** Where the prompt went, for human output: `Delivery: queued (transcript)`. */
+function printDelivery(delivery, prefix = '') {
+    if (delivery) {
+        console.log(`${prefix}Delivery: ${delivery.state} (${delivery.evidence})`);
+    }
+}
+/**
+ * Mark the composer line that shows ghost text (a placeholder or the agent's
+ * suggested next prompt), so it does not read as typed input.
+ */
+function markSuggestionLine(text, ghostText) {
+    const ghost = ghostText?.split('\n')[0]?.trim();
+    if (!ghost)
+        return text;
+    const lines = text.split('\n');
+    for (let index = lines.length - 1; index >= 0; index -= 1) {
+        const line = lines[index].trim();
+        if (/^[❯›>]/u.test(line) && line.includes(ghost)) {
+            lines[index] = `${lines[index].trimEnd()}  ⟨suggestion⟩`;
+            break;
+        }
+    }
+    return lines.join('\n');
+}
+/** The prompt file Pane wrote and any leading-character warnings, for human output. */
+function printPromptNotes(result, prefix = '') {
+    if (result.promptFile) {
+        console.log(`${prefix}Prompt file: ${result.promptFile}`);
+    }
+    for (const warning of result.warnings ?? []) {
+        console.log(`${prefix}Warning (${warning.code}): ${warning.message}`);
+    }
+}
 async function runPanelsSubmitComposer(parsed) {
     if (!parsed.panelId) {
         throw new Error('runpane panels submit-composer requires --panel.');
@@ -1263,6 +1723,7 @@ async function runPanelsSubmitComposer(parsed) {
     else {
         const verified = result.verifiedSubmitted ? ' verified' : ' unverified';
         console.log(`${result.ok ? 'Submitted' : 'Could not verify'} composer with ${result.sequenceName} to panel ${result.panelId}.${verified}`);
+        printDelivery(result.delivery);
         if (result.blocked) {
             console.log(`Blocked: ${result.blocked.message}`);
         }
@@ -1332,11 +1793,15 @@ function buildPanelInputRequest(parsed, command = 'input') {
         throw new Error(`runpane panels ${command} requires --text, --keys, or --input-file.`);
     }
     if (parsed.keys !== undefined && command !== 'input') {
-        throw new Error('--keys is for panels input; panels submit sends text followed by Enter.');
+        throw new Error('--keys is for panels input; panels submit sends text followed by the agent submit key.');
+    }
+    if (parsed.asFilePointer && command !== 'submit') {
+        throw new Error('--as-file-pointer is for panels submit; panels input sends exact bytes.');
     }
     return {
         panelId: parsed.panelId,
         input: parsed.keys ? keysToBytes(parsed.keys) : parsed.panelInputFile ? readInputSource(parsed.panelInputFile) : parsed.panelInput ?? '',
+        asFilePointer: parsed.asFilePointer || undefined,
     };
 }
 /** `--keys down,enter`: named keys from the contract, or a single literal character each. */
@@ -1421,6 +1886,7 @@ async function buildPaneCreateRequest(parsed) {
         panes: [{
                 name: parsed.name,
                 worktreeName: parsed.worktreeName,
+                branch: parsed.branch,
                 baseBranch: parsed.baseBranch,
                 pinned: resolvePinnedOverride(parsed) ?? true,
                 tool,
@@ -1478,10 +1944,22 @@ async function confirmRepoAdd(parsed, request) {
     }
 }
 async function buildToolSpec(parsed, command = 'panes create') {
-    if (parsed.agent && parsed.toolCommand) {
-        throw new Error('Use either --agent or --tool-command, not both.');
-    }
     const initialInput = resolveInitialInput(parsed);
+    if (parsed.asFilePointer && initialInput === undefined) {
+        throw new Error(`--as-file-pointer needs a prompt: pass --prompt or --initial-input-file to runpane ${command}.`);
+    }
+    const initialInputAsFilePointer = parsed.asFilePointer || undefined;
+    // With --tool-command, --agent names the agent the command runs (a wrapper
+    // such as `agent-farm run`); Pane launches the command unchanged.
+    if (parsed.toolCommand && parsed.agent) {
+        return {
+            command: parsed.toolCommand,
+            agentType: parsed.agent,
+            title: parsed.title,
+            initialInput,
+            initialInputAsFilePointer,
+        };
+    }
     let agent = parsed.agent;
     if (!agent && !parsed.toolCommand) {
         if (!isInteractiveShell()) {
@@ -1494,6 +1972,7 @@ async function buildToolSpec(parsed, command = 'panes create') {
             agent,
             title: parsed.title,
             initialInput,
+            initialInputAsFilePointer,
         };
     }
     if (!parsed.toolCommand) {
@@ -1503,11 +1982,12 @@ async function buildToolSpec(parsed, command = 'panes create') {
         command: parsed.toolCommand,
         title: parsed.title,
         initialInput,
+        initialInputAsFilePointer,
     };
 }
 function resolveInitialInput(parsed) {
     if (parsed.initialInput && parsed.initialInputFile) {
-        throw new Error('Use either --initial-input/--prompt or --initial-input-file, not both.');
+        throw new Error('Use either --initial-input/--prompt or --initial-input-file/--prompt-file, not both.');
     }
     if (parsed.initialInputFile) {
         return readInputSource(parsed.initialInputFile);
@@ -1549,7 +2029,7 @@ async function confirmPaneAdopt(parsed, request) {
         rl.close();
     }
 }
-async function confirmPaneArchive(parsed, request) {
+async function confirmPaneArchive(parsed, question) {
     if (parsed.dryRun || parsed.yes) {
         return;
     }
@@ -1558,8 +2038,7 @@ async function confirmPaneArchive(parsed, request) {
     }
     const rl = (0, promises_1.createInterface)({ input: node_process_1.stdin, output: node_process_1.stdout });
     try {
-        const suffix = request.force ? ' (including any uncommitted or unpushed work)' : '';
-        const answer = (await rl.question(`Archive pane ${request.paneId}${suffix}? [y/N] `)).trim().toLowerCase();
+        const answer = (await rl.question(`${question}? [y/N] `)).trim().toLowerCase();
         if (answer !== 'y' && answer !== 'yes') {
             throw new Error('Cancelled.');
         }
@@ -1735,6 +2214,12 @@ function workspaceLabel(kind) {
         'pane.created': 'NEW',
         'pane.gone': 'GONE',
         'panel.exited': 'EXIT',
+        'pane.associated': 'JOINED',
+        'pane.detached': 'LEFT',
+        'pr.conflicted': 'PR CONFLICTED',
+        'pr.checks': 'PR CHECKS',
+        'pr.merged': 'PR MERGED',
+        'agent.report': 'REPORT',
     };
     return labels[kind];
 }
@@ -1804,6 +2289,7 @@ function printPaneCreateResult(result) {
                     ? `  Associated with Session ${item.association.sessionId}`
                     : `  Not associated with Session ${item.association.sessionId}: ${item.association.error ?? 'unknown error'}`);
             }
+            printPromptNotes(item, '  ');
             if (item.nextCommand) {
                 console.log(`  Next: ${item.nextCommand}`);
             }
@@ -1828,11 +2314,44 @@ function printPaneArchiveResult(result) {
         console.error(`Next: ${result.nextCommand}`);
         return;
     }
-    console.log(`Archived pane ${result.paneId}${result.forced ? ' (forced)' : ''}. Worktree cleanup: ${result.worktreeCleanup}.`);
+    const trash = result.trashDeletion === 'pending' ? ' (files are still being deleted in the background)' : '';
+    console.log(`Archived pane ${result.paneId}${result.forced ? ' (forced)' : ''}. Worktree cleanup: ${result.worktreeCleanup}${trash}.`);
+    printArchiveSkipReason(result.safetyCheck);
+    if (result.safetyCheck.mergedViaPr) {
+        console.log(`Merged via PR #${result.safetyCheck.mergedViaPr.number} (head ${result.safetyCheck.mergedViaPr.headOid}).`);
+    }
+}
+function printPaneArchiveBulkResult(result) {
+    const verb = result.dryRun ? 'Would archive' : 'Archived';
+    console.log(`${verb} ${result.archived} Pane(s) in Session ${result.sessionId}; skipped ${result.skipped}; failed ${result.failed}.`);
+    for (const item of result.items) {
+        const label = item.name ? `${item.name} (${item.paneId})` : item.paneId;
+        if (item.outcome === 'skipped') {
+            console.log(`  skipped ${label}: ${item.skipped?.code ?? 'unknown'} - ${item.skipped?.message ?? ''}`);
+        }
+        else if (item.outcome === 'failed') {
+            console.error(`  failed ${label}: ${item.error ?? 'unknown error'}`);
+        }
+        else {
+            const merged = item.safetyCheck?.mergedViaPr ? ` merged via PR #${item.safetyCheck.mergedViaPr.number}` : '';
+            const trash = item.trashDeletion === 'pending' ? ', files deleting in background' : '';
+            const cleanup = item.worktreeCleanup ? ` worktree ${item.worktreeCleanup}${trash}` : '';
+            console.log(`  ${item.outcome} ${label}${merged}${cleanup}`);
+        }
+    }
+}
+function printArchiveSkipReason(safetyCheck, print = console.log) {
+    if (!safetyCheck.reason)
+        return;
+    print(`Safety check skipped: ${safetyCheck.reason}${safetyCheck.worktreeWillRemain ? '; the worktree stays on disk' : ''}.`);
 }
 function printArchiveCommitEvidence(safetyCheck, print = console.log) {
+    printArchiveSkipReason(safetyCheck, print);
     if (safetyCheck.upstream) {
-        print(`Upstream: ${safetyCheck.upstream}${safetyCheck.upstreamRefreshed ? ' (refreshed)' : ''}`);
+        print(`Upstream: ${safetyCheck.upstream}${safetyCheck.upstreamRefreshed ? ' (refreshed)' : ''}${safetyCheck.upstreamGone ? ' (gone from the remote)' : ''}`);
+    }
+    if (safetyCheck.mergedViaPr) {
+        print(`Merged via PR #${safetyCheck.mergedViaPr.number} (head ${safetyCheck.mergedViaPr.headOid})`);
     }
     for (const commit of safetyCheck.unpushedCommitDetails ?? []) {
         print(`Unpushed: ${commit.sha} ${commit.subject}`);
@@ -1847,6 +2366,7 @@ function printPanelCreateResult(result) {
         }
     }
     printInitialInputDelivery(result.initialInput);
+    printPromptNotes(result);
     if (result.nextCommand) {
         console.log(`Next: ${result.nextCommand}`);
     }
@@ -1864,6 +2384,7 @@ function printInitialInputDelivery(initialInput, prefix = '') {
     const attempts = initialInput.attempts === undefined ? '' : ` after ${initialInput.attempts} attempt${initialInput.attempts === 1 ? '' : 's'}`;
     const staged = initialInput.staged === undefined ? '' : `; staged: ${initialInput.staged ? 'yes' : 'no'}`;
     console.log(`${prefix}Initial input: ${status}${strategy}${attempts}${staged}`);
+    printDelivery(initialInput.delivery, prefix);
     if (initialInput.blocked) {
         console.log(`${prefix}Initial input blocked: ${initialInput.blocked.message}`);
     }
@@ -1923,7 +2444,8 @@ function printPanelListResult(result) {
         const marker = panel.active ? '*' : ' ';
         const initialized = panel.initialized === undefined ? '' : panel.initialized ? ' initialized' : ' not-initialized';
         const agent = panel.agentType ? ` ${panel.agentType}` : '';
-        console.log(`${marker} ${panel.id}\t${panel.type}\t${panel.title}${initialized}${agent}`);
+        const detection = panel.agentDetection && panel.agentDetection !== 'command' ? ` (${panel.agentDetection})` : '';
+        console.log(`${marker} ${panel.id}\t${panel.type}\t${panel.title}${initialized}${agent}${detection}`);
     }
 }
 function isInteractiveShell() {
@@ -1949,6 +2471,7 @@ function parsePaneCreateItemPayload(value, index) {
     return {
         name: value.name,
         worktreeName: value.worktreeName,
+        branch: value.branch,
         baseBranch: value.baseBranch,
         sessionPrompt: value.sessionPrompt,
         pinned: value.pinned,
@@ -1968,13 +2491,23 @@ function parsePaneToolSpecPayload(value, index) {
             agent,
             title: value.title,
             initialInput: value.initialInput,
+            initialInputAsFilePointer: value.initialInputAsFilePointer,
         };
     }
     if (value.command !== undefined && value.command.trim().length > 0) {
+        let agentType;
+        try {
+            agentType = value.agentType === undefined ? undefined : (0, boundaryDecoder_1.decodeBoundary)(value.agentType, agentSchema);
+        }
+        catch {
+            throw new Error(`--from-json pane ${index} includes an unsupported agentType.`);
+        }
         return {
             command: value.command,
+            agentType,
             title: value.title,
             initialInput: value.initialInput,
+            initialInputAsFilePointer: value.initialInputAsFilePointer,
         };
     }
     throw new Error(`--from-json pane ${index} tool must include agent or command.`);