runpane 2.4.186 → 2.4.187

package/dist/localControl.js

@@ -37,6 +37,8 @@ exports.runPanelsInput = runPanelsInput;
 exports.runPanelsScreen = runPanelsScreen;
 exports.runPanelsLastMessage = runPanelsLastMessage;
 exports.runReport = runReport;
+exports.runInbox = runInbox;
+exports.runInboxAck = runInboxAck;
 exports.runPanelsSubmit = runPanelsSubmit;
 exports.markSuggestionLine = markSuggestionLine;
 exports.printPromptNotes = printPromptNotes;
@@ -54,6 +56,7 @@ const node_process_1 = require("node:process");
 const promises_1 = require("node:readline/promises");
 const boundaryDecoder_1 = require("./boundaryDecoder");
 const daemonClient_1 = require("./daemonClient");
+const errors_1 = require("./errors");
 const contract_1 = require("./generated/contract");
 const commands_1 = require("./commands");
 const sessionPayload_1 = require("./sessionPayload");
@@ -182,6 +185,7 @@ const agentReportFields = {
     reportedAt: boundaryDecoder_1.boundary.string,
 };
 const agentReportSchema = boundaryDecoder_1.boundary.object(agentReportFields);
+const expectedReportSchema = boundaryDecoder_1.boundary.object({ since: boundaryDecoder_1.boundary.string });
 const reportResultSchema = boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.literal(true),
     generation: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
@@ -326,6 +330,7 @@ const orchestrationPanelOverviewSchema = boundaryDecoder_1.boundary.object({
     initialized: boundaryDecoder_1.boundary.boolean,
     lastActivityAt: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.nonEmptyString),
     missing: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
+    report: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.object({ ...agentReportFields, data: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.jsonObject) })),
 });
 const orchestrationPaneOverviewSchema = boundaryDecoder_1.boundary.object({
     paneId: boundaryDecoder_1.boundary.nonEmptyString,
@@ -489,7 +494,6 @@ const paneCostResultSchema = boundaryDecoder_1.boundary.object({
 });
 exports.paneCreateResultSchema = boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.boolean,
-    generation: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
     repo: repoSummarySchema,
     items: boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.union(boundaryDecoder_1.boundary.object({
         ok: boundaryDecoder_1.boundary.boolean,
@@ -516,7 +520,9 @@ exports.paneCreateResultSchema = boundaryDecoder_1.boundary.object({
             error: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
         })),
         promptFile: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+        attachments: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string)),
         warnings: promptWarningsSchema,
+        expectedReport: boundaryDecoder_1.boundary.optional(expectedReportSchema),
         setupQueue: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.object({
             position: boundaryDecoder_1.boundary.number,
             message: boundaryDecoder_1.boundary.string,
@@ -540,6 +546,8 @@ exports.paneCreateResultSchema = boundaryDecoder_1.boundary.object({
             code: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
         }),
     }))),
+    epoch: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    generation: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
 });
 const paneArchiveResultSchema = boundaryDecoder_1.boundary.union(boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.literal(false),
@@ -681,7 +689,6 @@ const panelResumeResultSchema = boundaryDecoder_1.boundary.object({
 });
 exports.panelCreateResultSchema = boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.boolean,
-    generation: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
     paneId: boundaryDecoder_1.boundary.string,
     panelId: boundaryDecoder_1.boundary.string,
     title: boundaryDecoder_1.boundary.string,
@@ -695,8 +702,12 @@ exports.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),
+    attachments: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string)),
     warnings: promptWarningsSchema,
+    expectedReport: boundaryDecoder_1.boundary.optional(expectedReportSchema),
     nextCommand: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    epoch: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    generation: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
 });
 const panelOutputResultSchema = boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.literal(true),
@@ -740,7 +751,6 @@ exports.panelScreenResultSchema = boundaryDecoder_1.boundary.object({
 });
 exports.panelSubmitResultSchema = boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.boolean,
-    generation: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
     panelId: boundaryDecoder_1.boundary.string,
     paneId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
     inputBytes: boundaryDecoder_1.boundary.number,
@@ -752,8 +762,12 @@ exports.panelSubmitResultSchema = boundaryDecoder_1.boundary.object({
     sentAt: boundaryDecoder_1.boundary.string,
     blocked: boundaryDecoder_1.boundary.optional(panelBlockedSchema),
     promptFile: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    attachments: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string)),
     warnings: promptWarningsSchema,
+    expectedReport: boundaryDecoder_1.boundary.optional(expectedReportSchema),
     nextCommand: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    epoch: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    generation: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
 });
 const panelSubmitComposerResultSchema = boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.boolean,
@@ -805,7 +819,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', 'panel.stopped', 'pane.associated', 'pane.detached', 'pr.conflicted', 'pr.checks', 'pr.merged', 'pr.closed', 'pr.head', 'pr.review', 'pr.comment', 'pr.stopped', 'github.unavailable', 'github.recovered', 'agent.report');
+const workspaceEntryKindSchema = boundaryDecoder_1.boundary.enumeration('agent.ready', 'agent.busy', 'agent.blocked', 'agent.unknown', 'agent.idle', 'pane.created', 'pane.gone', 'panel.exited', 'panel.stopped', 'pane.associated', 'pane.detached', 'pr.conflicted', 'pr.checks', 'pr.merged', 'pr.closed', 'pr.head', 'pr.base_changed', 'pr.base_deleted', 'pr.review', 'pr.comment', 'pr.stopped', 'github.unavailable', 'github.recovered', 'agent.report', 'agent.report.missing');
 const agentStateSchema = boundaryDecoder_1.boundary.enumeration('blocked', 'working', 'idle', 'unknown');
 const workspacePanelSummarySchema = boundaryDecoder_1.boundary.object({
     panelId: boundaryDecoder_1.boundary.string,
@@ -843,10 +857,15 @@ const workspaceEntrySchema = boundaryDecoder_1.boundary.object({
     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 })),
+    base: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.object({ from: boundaryDecoder_1.boundary.string, to: 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)),
+    lastOutput: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    lastOutputSource: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('transcript', 'screen')),
+    expectedSince: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    screenLines: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string)),
 });
 exports.workspaceStateResultSchema = boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.literal(true),
@@ -1048,7 +1067,11 @@ 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) {
+        if (pane.panels.some(panel => panel.report)) {
+            for (const panel of pane.panels)
+                console.log(`    ${describePanelOverview(panel)}`);
+        }
+        else if (pane.report) {
             console.log(`    report ${(0, watchLines_1.describeReport)(pane.report)} (panel ${pane.report.panelId}, ${pane.report.reportedAt})`);
         }
     }
@@ -1057,6 +1080,11 @@ async function runSessionsOverview(parsed) {
     }
     return 0;
 }
+/** `Reviewer (panel <id>): idle, report ready pr#747 fc5dce9 at <reportedAt>`; a panel without a report shows only its state. */
+function describePanelOverview(panel) {
+    const line = `${panel.title} (panel ${panel.panelId}): ${panel.state}`;
+    return panel.report ? `${line}, report ${(0, watchLines_1.describeReport)(panel.report)} at ${panel.report.reportedAt}` : line;
+}
 /** 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) {
@@ -1220,7 +1248,7 @@ async function runPrWatchCommand(parsed) {
     printJson(result);
     return 0;
 }
-async function runWatch(parsed) {
+async function runWatch(parsed, dispatch) {
     if (parsed.watchAs && parsed.watchSince !== undefined) {
         throw new Error('runpane watch accepts either --as or --since, not both.');
     }
@@ -1299,6 +1327,10 @@ async function runWatch(parsed) {
             return 0;
         }
         if (deadlineAt !== undefined && Date.now() >= deadlineAt) {
+            if (dispatch) {
+                printDispatchResult({ ok: false, outcome: 'timeout', ...dispatch, generation: request.since ?? 0 });
+                return 124;
+            }
             emitControlLine((0, watchLines_1.formatNonEntry)('_timeout', { timeoutMs: parsed.timeoutMs }, format));
             return 124;
         }
@@ -1329,7 +1361,8 @@ async function runWatch(parsed) {
                 throw new Error('This Pane daemon does not support runpane watch --session; update Pane, or pass one --pane per Session Pane.');
             }
             if (failingCode) {
-                emitControlLine((0, watchLines_1.formatNonEntry)('_reconnected', { generation: result.generation }, format));
+                if (!dispatch)
+                    emitControlLine((0, watchLines_1.formatNonEntry)('_reconnected', { generation: result.generation }, format));
                 failingCode = undefined;
             }
             if (!armed && (keepsWaiting || parsed.selfTest)) {
@@ -1344,11 +1377,27 @@ async function runWatch(parsed) {
             if (parsed.untilEvent) {
                 // A reset restates current state; it never ends the wait. Nor does the caller's own panel.
                 if (result.reset || result.dropped !== undefined) {
+                    if (dispatch) {
+                        printDispatchResult({ ok: false, outcome: 'indeterminate', ...dispatch, generation: result.generation,
+                            reason: result.reset?.reason ?? 'history-dropped',
+                            nextCommand: `runpane panels screen --panel ${dispatch.panelId ?? '<panel-id>'} --json; runpane inbox --json` });
+                        return 6;
+                    }
                     for (const line of (0, watchLines_1.formatWaitResult)(result, format))
                         emitControlLine(line);
                 }
                 else {
-                    const entries = ownPanelId ? result.entries.filter(entry => entry.panelId !== ownPanelId) : result.entries;
+                    if (dispatch) {
+                        const entry = result.entries.find(candidate => !candidate.replay && !candidate.baseline
+                            && isDispatchOutcomeKind(candidate.kind)
+                            && (candidate.kind === 'pane.gone' || !dispatch.panelId || candidate.panelId === dispatch.panelId));
+                        if (entry && isDispatchOutcomeKind(entry.kind)) {
+                            const { outcome, exitCode } = DISPATCH_OUTCOMES[entry.kind];
+                            printDispatchResult(compactDispatchResult(outcome, entry));
+                            return exitCode;
+                        }
+                    }
+                    const entries = dispatch ? [] : ownPanelId ? result.entries.filter(entry => entry.panelId !== ownPanelId) : result.entries;
                     if (entries.length > 0) {
                         for (const line of (0, watchLines_1.formatWaitResult)({ ...result, entries }, format))
                             emitWatchLine(line);
@@ -1383,7 +1432,8 @@ async function runWatch(parsed) {
             }
             const code = watchErrorCode(watchError);
             if (failingCode !== code || heartbeatMs > 0 && Date.now() - lastFailureAt >= heartbeatMs) {
-                emitWatchLine((0, watchLines_1.formatNonEntry)('_error', { code, message: watchError.message }, format));
+                if (!dispatch)
+                    emitWatchLine((0, watchLines_1.formatNonEntry)('_error', { code, message: watchError.message }, format));
                 lastFailureAt = Date.now();
             }
             failingCode = code;
@@ -1446,11 +1496,26 @@ function isRetryableWatchError(error) {
 }
 async function runPanesCreate(parsed) {
     const request = await buildPaneCreateRequest(parsed);
+    if (parsed.waitForResult && request.panes.length !== 1)
+        throw new errors_1.RunpaneError('ERR_RUNPANE_WAIT_MULTI_PANE', 'panes create --wait accepts one Pane, but this request has several. No workers were created.', 'Create several without --wait, then dispatch each with panels submit --wait.');
+    if (parsed.expectReport !== undefined)
+        request.expectReport = parsed.expectReport;
     await confirmPaneCreate(parsed, request);
     const result = await (0, daemonClient_1.invokeDaemon)('runpane:panes:create', [request], exports.paneCreateResultSchema, {
         paneDir: parsed.paneDir,
         timeoutMs: (parsed.timeoutMs ?? 120_000) + (parsed.readyTimeoutMs ?? 30_000) + 10_000,
     });
+    if (parsed.waitForResult) {
+        const [item] = result.items;
+        if (result.items.length !== 1) {
+            printJson(result);
+            throw new errors_1.RunpaneError('ERR_RUNPANE_WAIT_CREATE_RESULTS', 'Pane returned an unexpected number of creation results; the creation results are printed above.', 'Inspect the returned ids before retrying.');
+        }
+        // A Pane queued behind setup has no panel yet; its first agent panel's events still name the Pane.
+        if (result.ok && item && 'paneId' in item && item.paneId) {
+            return waitForDispatchResult(parsed, { paneId: item.paneId, panelId: item.panelId, since: result.generation, epoch: result.epoch });
+        }
+    }
     if (parsed.json) {
         printJson(result);
     }
@@ -1661,11 +1726,16 @@ async function runPanelsList(parsed) {
 }
 async function runPanelsCreate(parsed) {
     const request = await buildPanelCreateRequest(parsed);
+    if (parsed.expectReport !== undefined)
+        request.expectReport = parsed.expectReport;
     await confirmPanelCreate(parsed, request);
     const result = await (0, daemonClient_1.invokeDaemon)('runpane:panels:create', [request], exports.panelCreateResultSchema, {
         paneDir: parsed.paneDir,
         timeoutMs: (parsed.readyTimeoutMs ?? 30_000) + 10_000,
     });
+    if (parsed.waitForResult && result.ok) {
+        return waitForDispatchResult(parsed, { paneId: result.paneId, panelId: result.panelId, since: result.generation, epoch: result.epoch });
+    }
     if (parsed.json) {
         printJson(result);
     }
@@ -1852,12 +1922,115 @@ function describeReportDelivery(result) {
             + 'and a watch with a named cursor (runpane watch --as <name> --kinds agent.report) still receives it when it next waits.');
     return lines;
 }
+const inboxItemSchema = boundaryDecoder_1.boundary.object({
+    id: boundaryDecoder_1.boundary.string,
+    sessionId: boundaryDecoder_1.boundary.string,
+    kind: boundaryDecoder_1.boundary.enumeration('report', 'report.missing', 'blocked'),
+    at: boundaryDecoder_1.boundary.string,
+    paneId: boundaryDecoder_1.boundary.string,
+    paneName: boundaryDecoder_1.boundary.string,
+    panelId: boundaryDecoder_1.boundary.string,
+    panelTitle: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    agentType: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    report: boundaryDecoder_1.boundary.optional(agentReportSchema),
+    lastOutput: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    lastOutputSource: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('transcript', 'screen')),
+    reason: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    screenLines: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string)),
+});
+const inboxListResultSchema = boundaryDecoder_1.boundary.object({
+    ok: boundaryDecoder_1.boundary.literal(true),
+    session: boundaryDecoder_1.boundary.object({ id: boundaryDecoder_1.boundary.string, name: boundaryDecoder_1.boundary.string }),
+    items: boundaryDecoder_1.boundary.array(inboxItemSchema),
+});
+const inboxAckResultSchema = boundaryDecoder_1.boundary.object({
+    ok: boundaryDecoder_1.boundary.literal(true),
+    acknowledged: boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string),
+    unknown: boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string),
+});
+const MAX_INBOX_DETAIL_LENGTH = 300;
+/** `--session`, else the Session whose orchestrator this terminal is. */
+function inboxSession(parsed, env) {
+    return parsed.sessionId?.trim() || env.PANE_ORCHESTRATION_SESSION_ID?.trim() || undefined;
+}
+async function runInbox(parsed, env = process.env) {
+    const session = inboxSession(parsed, env);
+    if (!session) {
+        throw new Error('runpane inbox needs --session <id|name> outside a Session orchestrator (PANE_ORCHESTRATION_SESSION_ID).');
+    }
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:inbox:list', [{ session }], inboxListResultSchema, { paneDir: parsed.paneDir });
+    if (parsed.json) {
+        printJson(result);
+        return 0;
+    }
+    if (result.items.length === 0) {
+        console.log(`Inbox for ${result.session.name}: nothing unacknowledged.`);
+        return 0;
+    }
+    console.log(`Inbox for ${result.session.name}: ${result.items.length} unacknowledged.`);
+    for (const item of result.items)
+        console.log(formatInboxItem(item));
+    console.log(`Clear handled items with: runpane inbox ack ${result.items.map(item => item.id).join(' ')}`);
+    return 0;
+}
+async function runInboxAck(parsed, env = process.env) {
+    const session = parsed.all ? inboxSession(parsed, env) : parsed.sessionId;
+    if (parsed.all && !session) {
+        throw new Error('runpane inbox ack --all needs --session <id|name> outside a Session orchestrator.');
+    }
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:inbox:ack', [{
+            ids: parsed.all ? undefined : parsed.inboxIds,
+            session,
+            all: parsed.all || undefined,
+        }], inboxAckResultSchema, { paneDir: parsed.paneDir });
+    if (parsed.json) {
+        printJson(result);
+    }
+    else {
+        console.log(`Acknowledged ${result.acknowledged.length} inbox item${result.acknowledged.length === 1 ? '' : 's'}.`);
+        if (result.unknown.length > 0)
+            console.log(`Not found (already acknowledged?): ${result.unknown.join(', ')}`);
+    }
+    return 0;
+}
+/** `<id> REPORT <pane> pane <id> panel <id> ready pr#12 abc1234`, then indented detail lines. */
+function formatInboxItem(item) {
+    const where = `${oneLine(item.paneName)} pane ${item.paneId} panel ${item.panelId}`;
+    if (item.kind === 'report') {
+        const lines = [`${item.id} REPORT ${where} ${item.report ? (0, watchLines_1.describeReport)(item.report) : 'unknown'}`];
+        if (item.report?.summary)
+            lines.push(`  ${clip(oneLine(item.report.summary))}`);
+        return lines.join('\n');
+    }
+    if (item.kind === 'report.missing') {
+        const lines = [`${item.id} MISSING REPORT ${where} ${item.reason ?? 'ready'} without runpane report`];
+        if (item.lastOutput)
+            lines.push(`  last ${item.lastOutputSource ?? 'output'}: ${clip(oneLine(item.lastOutput), true)}`);
+        return lines.join('\n');
+    }
+    const lines = [`${item.id} BLOCKED ${where} waiting on a prompt`];
+    for (const line of (item.screenLines ?? []).slice(-8))
+        lines.push(`  | ${line}`);
+    return lines.join('\n');
+}
+function oneLine(text) {
+    return text.replace(/\s+/gu, ' ').trim();
+}
+/** Cut to the detail length, keeping the start, or the end when `tail` (an agent's conclusion is last). */
+function clip(text, tail = false) {
+    if (text.length <= MAX_INBOX_DETAIL_LENGTH)
+        return text;
+    return tail ? `…${text.slice(text.length - MAX_INBOX_DETAIL_LENGTH + 1)}` : `${text.slice(0, MAX_INBOX_DETAIL_LENGTH - 1)}…`;
+}
 async function runPanelsSubmit(parsed) {
     const request = buildPanelInputRequest(parsed, 'submit');
     await confirmPanelInput(parsed, request, 'submit');
     const result = await (0, daemonClient_1.invokeDaemon)('runpane:panels:submit', [request], exports.panelSubmitResultSchema, {
         paneDir: parsed.paneDir,
     });
+    if (parsed.waitForResult && result.ok) {
+        return waitForDispatchResult(parsed, { paneId: result.paneId, panelId: result.panelId, since: result.generation, epoch: result.epoch });
+    }
     if (parsed.json) {
         printJson(result);
     }
@@ -1876,6 +2049,64 @@ async function runPanelsSubmit(parsed) {
     }
     return result.ok ? 0 : 1;
 }
+/** Each way a `--wait` dispatch ends, the journal kind behind it, and the exit code it returns. */
+const DISPATCH_OUTCOMES = {
+    'agent.report': { outcome: 'report', exitCode: 0 },
+    'agent.report.missing': { outcome: 'missing', exitCode: 3 },
+    'agent.blocked': { outcome: 'blocked', exitCode: 4 },
+    'panel.exited': { outcome: 'exited', exitCode: 5 },
+    'pane.gone': { outcome: 'gone', exitCode: 5 },
+};
+const DISPATCH_WAIT_KINDS = ['agent.report', 'agent.report.missing', 'agent.blocked', 'panel.exited', 'pane.gone'];
+function isDispatchOutcomeKind(kind) {
+    return Object.hasOwn(DISPATCH_OUTCOMES, kind);
+}
+/**
+ * `--wait`: block until the dispatched panel reports, misses its report, waits on a prompt, or
+ * exits, then print the result as one line of JSON. `since` is the journal generation the daemon took
+ * before delivering the work, so an event right after delivery is never missed.
+ */
+async function waitForDispatchResult(parsed, target) {
+    if (!target.paneId || target.since === undefined) {
+        throw new Error('This Pane daemon does not return a journal position, so --wait cannot follow the work. Update Pane, or use runpane watch --until-event.');
+    }
+    return runWatch({ ...parsed, follow: false, untilEvent: true,
+        watchAs: undefined, watchFrom: undefined, watchSince: target.since, watchEpoch: target.epoch,
+        watchKinds: DISPATCH_WAIT_KINDS, watchPaneIds: [target.paneId],
+        sessionId: undefined, repo: undefined, includeShells: true, noHeldInput: true,
+        timeoutMs: parsed.waitTimeoutMs || undefined,
+    }, { paneId: target.paneId, panelId: target.panelId });
+}
+function printDispatchResult(result) {
+    console.log(JSON.stringify(result));
+}
+/** The `--wait` result: what the orchestrator needs to act, never the transcript. */
+function compactDispatchResult(outcome, entry) {
+    const { report } = entry;
+    return {
+        ok: outcome === 'report',
+        outcome,
+        paneId: entry.paneId,
+        paneName: entry.paneName,
+        generation: entry.gen,
+        at: entry.at,
+        panelId: entry.panelId,
+        report: report && {
+            state: report.state,
+            pr: report.pr,
+            head: report.head,
+            summary: report.summary,
+            summaryTruncated: report.summaryTruncated,
+            summaryPath: report.summaryPath,
+            question: report.question,
+        },
+        screenLines: entry.screenLines?.length ? entry.screenLines : undefined,
+        lastOutput: entry.lastOutput || undefined,
+        lastOutputSource: entry.lastOutput ? entry.lastOutputSource : undefined,
+        reason: entry.reason || undefined,
+        exitCode: entry.exitCode,
+    };
+}
 /** Where the prompt went, for human output: `Delivery: queued (transcript)`. */
 function printDelivery(delivery, prefix = '') {
     if (delivery) {
@@ -1907,6 +2138,12 @@ function printPromptNotes(result, prefix = '') {
     if (result.promptFile) {
         console.log(`${prefix}Prompt file: ${result.promptFile}`);
     }
+    for (const attachment of result.attachments ?? []) {
+        console.log(`${prefix}Attached: ${attachment}`);
+    }
+    if (result.expectedReport) {
+        console.log(`${prefix}Expecting a runpane report; without one Pane emits agent.report.missing.`);
+    }
     for (const warning of result.warnings ?? []) {
         console.log(`${prefix}Warning (${warning.code}): ${warning.message}`);
     }
@@ -2038,8 +2275,10 @@ function buildPanelInputRequest(parsed, command = 'input') {
         panelId: parsed.panelId,
         input: parsed.keys ? keysToBytes(parsed.keys) : parsed.panelInputFile ? readInputSource(parsed.panelInputFile) : parsed.panelInput ?? '',
         asFilePointer: parsed.asFilePointer || undefined,
+        attachments: resolveAttachments(parsed, `panels ${command}`),
         interrupt: parsed.interrupt || undefined,
         source: parsed.source === 'user' || parsed.source === 'agent' ? parsed.source : undefined,
+        expectReport: command === 'submit' ? parsed.expectReport : undefined,
     };
 }
 /** `--keys down,enter`: named keys from the contract, or a single literal character each. */
@@ -2187,6 +2426,7 @@ async function buildToolSpec(parsed, command = 'panes create') {
         throw new Error(`--as-file-pointer needs a prompt: pass --prompt or --initial-input-file to runpane ${command}.`);
     }
     const initialInputAsFilePointer = parsed.asFilePointer || undefined;
+    const initialInputAttachments = resolveAttachments(parsed, command);
     // 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) {
@@ -2196,6 +2436,7 @@ async function buildToolSpec(parsed, command = 'panes create') {
             title: parsed.title,
             initialInput,
             initialInputAsFilePointer,
+            initialInputAttachments,
         };
     }
     let agent = parsed.agent;
@@ -2211,6 +2452,7 @@ async function buildToolSpec(parsed, command = 'panes create') {
             title: parsed.title,
             initialInput,
             initialInputAsFilePointer,
+            initialInputAttachments,
         };
     }
     if (!parsed.toolCommand) {
@@ -2221,8 +2463,30 @@ async function buildToolSpec(parsed, command = 'panes create') {
         title: parsed.title,
         initialInput,
         initialInputAsFilePointer,
+        initialInputAttachments,
     };
 }
+/**
+ * `--attach` files as absolute paths. Pane copies them beside the prompt file
+ * (inside the worktree when it can), so they need `--as-file-pointer`.
+ */
+function resolveAttachments(parsed, command) {
+    if (!parsed.attachments?.length)
+        return undefined;
+    if (!['panes create', 'panels create', 'panels submit'].includes(command)) {
+        throw new errors_1.RunpaneError('ERR_ATTACH_UNSUPPORTED', `--attach is not supported by runpane ${command}. Nothing was sent.`, 'Use --attach with panes create, panels create or panels submit.');
+    }
+    if (!parsed.asFilePointer) {
+        throw new errors_1.RunpaneError('ERR_ATTACH_NEEDS_FILE_POINTER', `--attach needs --as-file-pointer: Pane lists the copied files beside the prompt file. Nothing was sent.`, `Add --as-file-pointer to runpane ${command}.`);
+    }
+    return parsed.attachments.map((file) => {
+        const absolute = node_path_1.default.resolve(file);
+        if (!node_fs_1.default.statSync(absolute, { throwIfNoEntry: false })?.isFile()) {
+            throw new errors_1.RunpaneError('ERR_ATTACH_NOT_FOUND', `--attach ${file}: no such file. Nothing was sent.`, 'Pass an existing file path, then retry.');
+        }
+        return absolute;
+    });
+}
 function resolveInitialInput(parsed) {
     if (parsed.initialInput && parsed.initialInputFile) {
         throw new Error('Use either --initial-input/--prompt or --initial-input-file/--prompt-file, not both.');
@@ -2499,12 +2763,15 @@ function workspaceLabel(kind) {
         'pr.merged': 'PR MERGED',
         'pr.closed': 'PR.CLOSED',
         'pr.head': 'PR.HEAD',
+        'pr.base_changed': 'PR.BASE_CHANGED',
+        'pr.base_deleted': 'PR.BASE_DELETED',
         'pr.review': 'PR.REVIEW',
         'pr.comment': 'PR.COMMENT',
         'pr.stopped': 'PR.STOPPED',
         'github.unavailable': 'GITHUB.UNAVAILABLE',
         'github.recovered': 'GITHUB.RECOVERED',
         'agent.report': 'REPORT',
+        'agent.report.missing': 'MISSING REPORT',
     };
     return labels[kind];
 }