runpane 2.4.180 → 2.4.181

package/dist/localControl.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.workspaceStateResultSchema = exports.panelSubmitResultSchema = exports.panelScreenResultSchema = exports.panelCreateResultSchema = exports.panelListResultSchema = exports.paneCreateResultSchema = exports.paneListResultSchema = exports.repoListResultSchema = void 0;
+exports.workspaceStateResultSchema = exports.panelSubmitResultSchema = exports.panelScreenResultSchema = exports.panelCreateResultSchema = exports.panelListResultSchema = exports.paneCreateResultSchema = exports.runpaneSessionResultSchema = exports.runpaneSessionListResultSchema = exports.paneListResultSchema = exports.repoListResultSchema = void 0;
 exports.runReposList = runReposList;
 exports.runReposAdd = runReposAdd;
 exports.runPanesList = runPanesList;
@@ -41,6 +41,7 @@ exports.markSuggestionLine = markSuggestionLine;
 exports.printPromptNotes = printPromptNotes;
 exports.runPanelsSubmitComposer = runPanelsSubmitComposer;
 exports.runPanelsWait = runPanelsWait;
+exports.runPanelsResume = runPanelsResume;
 exports.runAgentsDoctor = runAgentsDoctor;
 exports.buildPanelInputRequest = buildPanelInputRequest;
 exports.buildPanelCreateRequest = buildPanelCreateRequest;
@@ -54,6 +55,7 @@ const boundaryDecoder_1 = require("./boundaryDecoder");
 const daemonClient_1 = require("./daemonClient");
 const contract_1 = require("./generated/contract");
 const commands_1 = require("./commands");
+const sessionPayload_1 = require("./sessionPayload");
 const watchLines_1 = require("./watchLines");
 const agentSchema = boundaryDecoder_1.boundary.enumeration(...contract_1.RUNPANE_CONTRACT.enums.agents);
 const orchestrationAgentSchema = boundaryDecoder_1.boundary.enumeration('claude', 'codex', 'cursor');
@@ -96,6 +98,7 @@ const panelBlockedSchema = boundaryDecoder_1.boundary.object({
 });
 const panelStateSchema = boundaryDecoder_1.boundary.object({
     initialized: boundaryDecoder_1.boundary.boolean,
+    running: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
     isAlternateScreen: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
     activityStatus: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('active', 'idle')),
     isCliReady: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
@@ -103,6 +106,10 @@ const panelStateSchema = boundaryDecoder_1.boundary.object({
     agentType: boundaryDecoder_1.boundary.optional(agentSchema),
     lastActivity: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
 });
+const panelReadinessReasonSchema = boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.object({
+    code: boundaryDecoder_1.boundary.enumeration('no-agent-detected', 'agent-not-ready', 'command-exited'),
+    message: boundaryDecoder_1.boundary.string,
+}));
 const panelReadinessSchema = boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.boolean,
     condition: boundaryDecoder_1.boundary.string,
@@ -111,6 +118,7 @@ const panelReadinessSchema = boundaryDecoder_1.boundary.object({
     elapsedMs: boundaryDecoder_1.boundary.number,
     state: panelStateSchema,
     blocked: boundaryDecoder_1.boundary.optional(panelBlockedSchema),
+    reason: panelReadinessReasonSchema,
     nextCommand: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
 });
 const verificationSchema = boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('observed', 'unverifiable'));
@@ -180,6 +188,7 @@ const reportResultSchema = boundaryDecoder_1.boundary.object({
     panelId: boundaryDecoder_1.boundary.string,
     report: agentReportSchema,
     sessionIds: boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string),
+    liveWatchers: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
 });
 const panelLastMessageResultSchema = boundaryDecoder_1.boundary.union(boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.literal(true),
@@ -208,14 +217,18 @@ const panelSummarySchema = boundaryDecoder_1.boundary.object({
     title: boundaryDecoder_1.boundary.string,
     active: boundaryDecoder_1.boundary.boolean,
     initialized: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
+    running: 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),
+    dock: 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),
+    resumeId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    resumeSource: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('agent-farm', 'configured', 'agent')),
 });
 exports.repoListResultSchema = boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.literal(true),
@@ -293,12 +306,12 @@ const orchestrationSessionRecordSchema = boundaryDecoder_1.boundary.object({
     createdAt: boundaryDecoder_1.boundary.nonEmptyString,
     updatedAt: boundaryDecoder_1.boundary.nonEmptyString,
 });
-const runpaneSessionListResultSchema = boundaryDecoder_1.boundary.object({
+exports.runpaneSessionListResultSchema = boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.literal(true),
     sessions: boundaryDecoder_1.boundary.array(orchestrationSessionRecordSchema),
     selectedSessionId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.nonEmptyString),
 });
-const runpaneSessionResultSchema = boundaryDecoder_1.boundary.object({
+exports.runpaneSessionResultSchema = boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.literal(true),
     session: orchestrationSessionRecordSchema,
     panelId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.nonEmptyString),
@@ -507,6 +520,12 @@ exports.paneCreateResultSchema = boundaryDecoder_1.boundary.object({
             position: boundaryDecoder_1.boundary.number,
             message: boundaryDecoder_1.boundary.string,
         })),
+        base: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.object({
+            ref: boundaryDecoder_1.boundary.string,
+            commit: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+            refresh: boundaryDecoder_1.boundary.enumeration('fetched', 'recent', 'skipped', 'failed'),
+            notice: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+        })),
     }), boundaryDecoder_1.boundary.object({
         ok: boundaryDecoder_1.boundary.literal(false),
         index: boundaryDecoder_1.boundary.number,
@@ -620,6 +639,45 @@ exports.panelListResultSchema = boundaryDecoder_1.boundary.object({
     paneId: boundaryDecoder_1.boundary.string,
     panels: boundaryDecoder_1.boundary.array(panelSummarySchema),
 });
+const panelResumeManyResultSchema = boundaryDecoder_1.boundary.object({
+    ok: boundaryDecoder_1.boundary.boolean,
+    scope: boundaryDecoder_1.boundary.object({
+        kind: boundaryDecoder_1.boundary.enumeration('session', 'all-stopped'),
+        sessionId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+        sessionName: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    }),
+    resumed: boundaryDecoder_1.boundary.number,
+    alreadyRunning: boundaryDecoder_1.boundary.number,
+    failed: boundaryDecoder_1.boundary.number,
+    notReady: boundaryDecoder_1.boundary.number,
+    concurrency: boundaryDecoder_1.boundary.number,
+    items: boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.object({
+        ok: boundaryDecoder_1.boundary.boolean,
+        panelId: boundaryDecoder_1.boundary.string,
+        paneId: boundaryDecoder_1.boundary.string,
+        paneName: boundaryDecoder_1.boundary.string,
+        panelTitle: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+        agentType: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+        action: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('resumed', 'already-running')),
+        message: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+        agentSessionId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+        readiness: boundaryDecoder_1.boundary.optional(panelReadinessSchema),
+        error: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    })),
+    nextCommand: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+});
+const panelResumeResultSchema = boundaryDecoder_1.boundary.object({
+    ok: boundaryDecoder_1.boundary.boolean,
+    panelId: boundaryDecoder_1.boundary.string,
+    paneId: boundaryDecoder_1.boundary.string,
+    action: boundaryDecoder_1.boundary.enumeration('resumed', 'already-running'),
+    message: boundaryDecoder_1.boundary.string,
+    agentType: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    agentSessionId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    panel: panelSummarySchema,
+    readiness: boundaryDecoder_1.boundary.optional(panelReadinessSchema),
+    nextCommand: boundaryDecoder_1.boundary.string,
+});
 exports.panelCreateResultSchema = boundaryDecoder_1.boundary.object({
     ok: boundaryDecoder_1.boundary.boolean,
     generation: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
@@ -719,6 +777,8 @@ const panelWaitResultSchema = boundaryDecoder_1.boundary.object({
     elapsedMs: boundaryDecoder_1.boundary.number,
     state: panelStateSchema,
     blocked: boundaryDecoder_1.boundary.optional(panelBlockedSchema),
+    reason: panelReadinessReasonSchema,
+    stopped: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.literal(true)),
     nextCommand: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
     panelId: boundaryDecoder_1.boundary.string,
     paneId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
@@ -744,13 +804,14 @@ 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', 'pane.associated', 'pane.detached', 'pr.conflicted', 'pr.checks', 'pr.merged', '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', 'agent.report');
 const agentStateSchema = boundaryDecoder_1.boundary.enumeration('blocked', 'working', 'idle', 'unknown');
 const workspacePanelSummarySchema = boundaryDecoder_1.boundary.object({
     panelId: boundaryDecoder_1.boundary.string,
     title: boundaryDecoder_1.boundary.string,
     agentType: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
     agentState: boundaryDecoder_1.boundary.optional(agentStateSchema),
+    running: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
 });
 const workspaceEntrySchema = boundaryDecoder_1.boundary.object({
     gen: boundaryDecoder_1.boundary.number,
@@ -774,6 +835,7 @@ const workspaceEntrySchema = boundaryDecoder_1.boundary.object({
     heldInput: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
     heldInputPresent: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
     exitCode: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
+    running: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
     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),
@@ -901,7 +963,7 @@ async function runPanesList(parsed) {
     return 0;
 }
 async function runSessionsList(parsed) {
-    const result = await (0, daemonClient_1.invokeDaemon)('runpane:sessions:list', [], runpaneSessionListResultSchema, {
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:sessions:list', [], exports.runpaneSessionListResultSchema, {
         paneDir: parsed.paneDir,
     });
     if (parsed.json) {
@@ -918,15 +980,15 @@ async function runSessionsList(parsed) {
 async function runSessionsCreate(parsed) {
     if (!parsed.fromJson)
         throw new Error('runpane sessions create requires --from-json <path|->.');
-    const input = parseSessionCreatePayload(JSON.parse(stripUtf8Bom(readInputSource(parsed.fromJson))));
-    const result = await (0, daemonClient_1.invokeDaemon)('runpane:sessions:create', [input], runpaneSessionResultSchema, {
+    const input = (0, sessionPayload_1.parseSessionCreatePayload)(JSON.parse(stripUtf8Bom(readInputSource(parsed.fromJson))));
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:sessions:create', [input], exports.runpaneSessionResultSchema, {
         paneDir: parsed.paneDir,
     });
     return printSessionResult(result, parsed.json, 'Created');
 }
 async function runSessionsGet(parsed) {
     const selector = sessionSelectorFromParsed(parsed);
-    const result = await (0, daemonClient_1.invokeDaemon)('runpane:sessions:get', [selector], runpaneSessionResultSchema, {
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:sessions:get', [selector], exports.runpaneSessionResultSchema, {
         paneDir: parsed.paneDir,
     });
     return printSessionResult(result, parsed.json, '');
@@ -934,8 +996,8 @@ async function runSessionsGet(parsed) {
 async function runSessionsUpdate(parsed) {
     if (!parsed.fromJson)
         throw new Error('runpane sessions update requires --from-json <path|->.');
-    const input = parseSessionUpdatePayload(JSON.parse(stripUtf8Bom(readInputSource(parsed.fromJson))));
-    const result = await (0, daemonClient_1.invokeDaemon)('runpane:sessions:update', [{ selector: sessionSelectorFromParsed(parsed), input }], runpaneSessionResultSchema, {
+    const input = (0, sessionPayload_1.parseSessionUpdatePayload)(JSON.parse(stripUtf8Bom(readInputSource(parsed.fromJson))));
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:sessions:update', [{ selector: sessionSelectorFromParsed(parsed), input }], exports.runpaneSessionResultSchema, {
         paneDir: parsed.paneDir,
     });
     return printSessionResult(result, parsed.json, 'Updated');
@@ -943,14 +1005,14 @@ async function runSessionsUpdate(parsed) {
 async function runSessionsPin(parsed, pinned) {
     const result = await (0, daemonClient_1.invokeDaemon)('runpane:sessions:update', [{
             selector: sessionSelectorFromParsed(parsed), input: { isPinned: pinned },
-        }], runpaneSessionResultSchema, { paneDir: parsed.paneDir });
+        }], exports.runpaneSessionResultSchema, { paneDir: parsed.paneDir });
     return printSessionResult(result, parsed.json, pinned ? 'Pinned' : 'Unpinned');
 }
 async function runSessionsSetAgent(parsed) {
     const selector = sessionSelectorFromParsed(parsed);
     if (!parsed.agent)
         throw new Error('runpane sessions set-agent requires --agent.');
-    const result = await (0, daemonClient_1.invokeDaemon)('runpane:sessions:set-agent', [{ selector, agent: parsed.agent }], runpaneSessionResultSchema, {
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:sessions:set-agent', [{ selector, agent: parsed.agent }], exports.runpaneSessionResultSchema, {
         paneDir: parsed.paneDir,
     });
     return printSessionResult(result, parsed.json, 'Updated agent for');
@@ -962,12 +1024,12 @@ async function runSessionsAssociate(parsed) {
     const result = await (0, daemonClient_1.invokeDaemon)('runpane:sessions:associate', [{ selector, association: {
                 paneId: parsed.paneId,
                 panelIds: parsed.panelId ? [parsed.panelId] : undefined,
-            } }], runpaneSessionResultSchema, { paneDir: parsed.paneDir });
+            } }], exports.runpaneSessionResultSchema, { paneDir: parsed.paneDir });
     return printSessionResult(result, parsed.json, 'Associated');
 }
 async function runSessionsDetach(parsed) {
     const selector = sessionSelectorFromParsed(parsed);
-    const result = await (0, daemonClient_1.invokeDaemon)('runpane:sessions:detach', [{ selector, paneId: parsed.paneId }], runpaneSessionResultSchema, {
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:sessions:detach', [{ selector, paneId: parsed.paneId }], exports.runpaneSessionResultSchema, {
         paneDir: parsed.paneDir,
     });
     return printSessionResult(result, parsed.json, 'Detached');
@@ -1107,44 +1169,6 @@ function sessionSelectorFromParsed(parsed) {
         throw new Error('Named Session id or name is required via --session.');
     return { sessionId };
 }
-function parseSessionCreatePayload(value) {
-    return (0, boundaryDecoder_1.decodeBoundary)(value, boundaryDecoder_1.boundary.object({
-        runtime: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('windows', 'wsl')),
-        wslDistribution: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.nonEmptyString),
-        name: boundaryDecoder_1.boundary.nonEmptyString,
-        isPinned: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
-        agent: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('codex', 'claude', 'cursor')),
-        launchCommand: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
-        profile: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
-        goal: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
-        context: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
-        decisions: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string)),
-        blockers: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string)),
-        nextAction: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
-        evidence: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(orchestrationLinkSchema)),
-        outputs: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(orchestrationLinkSchema)),
-    }));
-}
-function parseSessionUpdatePayload(value) {
-    return (0, boundaryDecoder_1.decodeBoundary)(value, boundaryDecoder_1.boundary.object({
-        name: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
-        archived: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
-        isPinned: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
-        agent: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('codex', 'claude', 'cursor')),
-        launchCommand: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
-        profile: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
-        goal: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
-        context: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
-        decisions: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string)),
-        blockers: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string)),
-        nextAction: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
-        evidence: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(orchestrationLinkSchema)),
-        outputs: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.array(orchestrationLinkSchema)),
-        report: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.nullable(orchestrationReportSchema)),
-        expectedRevision: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
-        source: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('user', 'agent')),
-    }));
-}
 function printSessionResult(result, json, action) {
     if (json) {
         printJson(result);
@@ -1191,22 +1215,34 @@ async function runWatch(parsed) {
     }
     const defaults = contract_1.RUNPANE_CONTRACT.defaults.watch;
     const format = parsed.watchFormat ?? (parsed.json ? 'json' : 'lines');
+    // --until-event takes --follow's scope defaults; it only stops after the first event.
+    const keepsWaiting = parsed.follow || parsed.untilEvent;
     const heartbeatMs = (0, watchLines_1.effectiveWatchHeartbeatMs)(parsed.heartbeatSeconds ?? (parsed.follow ? defaults.heartbeatSeconds : 0));
-    const idleAfterMs = parsed.idleAfterMs ?? (parsed.follow ? defaults.idleAfterMs : 0);
+    const idleAfterMs = parsed.idleAfterMs ?? (keepsWaiting ? defaults.idleAfterMs : 0);
     const effectiveAgentsOnly = parsed.includeShells
         ? undefined
-        : parsed.agentsOnly || parsed.follow ? true : undefined;
+        : parsed.agentsOnly || keepsWaiting ? 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 ? true : undefined;
+        && !parsed.noHeldInput && keepsWaiting ? true : undefined;
     const cadenceValueFlagPresent = (0, commands_1.hasCadenceValueFlag)(parsed);
+    const ownPanelId = process.env.PANE_PANEL_ID?.trim() || undefined;
     // 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 panelCursor = ownPanelId ? derivedWatchCursorName('panel', ownPanelId) : undefined;
+    // An --until-event re-arm resumes where the last one stopped, under a name apart from the
+    // panel's --follow cursor so it never takes over a running monitor.
+    const untilEventCursor = ownPanelId && parsed.watchSince === undefined
+        ? derivedWatchCursorName('until', `until-${ownPanelId}`)
+        : undefined;
     const watchAs = parsed.watchAs
+        ?? (parsed.untilEvent ? untilEventCursor : undefined)
         ?? (parsed.follow ? sessionCursor || panelCursor || (cadenceValueFlagPresent ? `follow-${process.pid}` : undefined) : undefined);
+    // Under --until-event, --timeout-ms is the deadline for the whole wait, not for one daemon call.
+    const deadlineAt = parsed.untilEvent && parsed.timeoutMs !== undefined ? Date.now() + parsed.timeoutMs : undefined;
+    exitWhenReaderCloses();
     // --quiet drops lines that only prove liveness; --self-test still prints its WATCH OK result.
     const emitControlLine = (line) => {
         if (!parsed.quiet)
@@ -1239,9 +1275,15 @@ async function runWatch(parsed) {
     let failingCode;
     let lastFailureAt = 0;
     let lastHeartbeatAt = Date.now();
-    let anonymousIdleWindowStartMs = !watchAs && parsed.follow ? 0 : undefined;
+    let anonymousIdleWindowStartMs = !watchAs && keepsWaiting ? 0 : undefined;
     do {
-        const requestedWaitMs = parsed.timeoutMs ?? (heartbeatMs > 0 ? heartbeatMs : 60_000);
+        if (deadlineAt !== undefined && Date.now() >= deadlineAt) {
+            emitControlLine((0, watchLines_1.formatNonEntry)('_timeout', { timeoutMs: parsed.timeoutMs }, format));
+            return 124;
+        }
+        const requestedWaitMs = deadlineAt !== undefined
+            ? deadlineAt - Date.now()
+            : parsed.timeoutMs ?? (heartbeatMs > 0 ? heartbeatMs : parsed.untilEvent ? 120_000 : 60_000);
         const heartbeatWaitMs = heartbeatMs > 0
             ? Math.max(0, heartbeatMs - (Date.now() - lastHeartbeatAt))
             : requestedWaitMs;
@@ -1263,7 +1305,7 @@ async function runWatch(parsed) {
                 emitControlLine((0, watchLines_1.formatNonEntry)('_reconnected', { generation: result.generation }, format));
                 failingCode = undefined;
             }
-            if (!armed && (parsed.follow || parsed.selfTest)) {
+            if (!armed && (keepsWaiting || parsed.selfTest)) {
                 const okLine = (0, watchLines_1.formatNonEntry)('_ok', { generation: result.generation, epoch: result.epoch }, format);
                 if (parsed.selfTest)
                     emitWatchLine(okLine);
@@ -1273,8 +1315,25 @@ async function runWatch(parsed) {
                 if (parsed.selfTest)
                     return 0;
             }
-            for (const line of (0, watchLines_1.formatWaitResult)(result, format))
-                emitWatchLine(line);
+            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) {
+                    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 (entries.length > 0) {
+                        for (const line of (0, watchLines_1.formatWaitResult)({ ...result, entries }, format))
+                            emitWatchLine(line);
+                        return 0;
+                    }
+                }
+            }
+            else {
+                for (const line of (0, watchLines_1.formatWaitResult)(result, format))
+                    emitWatchLine(line);
+            }
             if (heartbeatMs > 0 && Date.now() - lastHeartbeatAt >= heartbeatMs) {
                 emitControlLine((0, watchLines_1.formatNonEntry)('_heartbeat', {
                     generation: result.generation,
@@ -1284,13 +1343,13 @@ async function runWatch(parsed) {
             }
             if (!watchAs) {
                 request.since = result.generation;
-                if (parsed.follow)
+                if (keepsWaiting)
                     anonymousIdleWindowStartMs = Date.now();
             }
         }
         catch (error) {
             const watchError = error instanceof Error ? error : new Error(String(error));
-            if (!parsed.follow || !isRetryableWatchError(watchError)) {
+            if (!keepsWaiting || !isRetryableWatchError(watchError)) {
                 return emitWatchFailure(watchError, format);
             }
             const code = watchErrorCode(watchError);
@@ -1301,12 +1360,22 @@ async function runWatch(parsed) {
             failingCode = code;
             await new Promise(resolve => setTimeout(resolve, 1_000));
         }
-    } while (parsed.follow);
+    } while (keepsWaiting);
     return 0;
 }
 function emitWatchLine(line) {
     node_process_1.stdout.write(`${line}\n`);
 }
+/** Codes a stdout write fails with once its reader is gone: a pipe, a socket pair (macOS), or Windows. */
+const CLOSED_READER_CODES = new Set(['EPIPE', 'ENOTCONN', 'ECONNRESET', 'EOF']);
+/** A reader that exits early (`| head -1`) closes stdout; the next write then ends the watch cleanly. */
+function exitWhenReaderCloses() {
+    node_process_1.stdout.on('error', (error) => {
+        if (!CLOSED_READER_CODES.has(error.code ?? ''))
+            throw error;
+        process.exit(0);
+    });
+}
 /** Names older daemons accept; the daemon itself allows up to 128 characters. */
 const PORTABLE_WATCH_CURSOR_PATTERN = /^[A-Za-z0-9._-]{1,64}$/u;
 /**
@@ -1731,11 +1800,29 @@ async function runReport(parsed, env = process.env) {
         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}`);
+        for (const line of describeReportDelivery(result))
+            console.log(line);
     }
     return 0;
 }
+/**
+ * What `runpane report` prints: the report, who recorded it, and how many watches were waiting.
+ * Zero waiting watchers means nobody is waiting right now, not that the report is lost.
+ */
+function describeReportDelivery(result) {
+    const sessions = result.sessionIds.length > 0 ? ` Recorded on Session ${result.sessionIds.join(', ')}.` : '';
+    const watchers = result.liveWatchers ?? 0;
+    const delivered = watchers > 0 ? ` Delivered to ${watchers} waiting watcher${watchers === 1 ? '' : 's'}.` : '';
+    const lines = [`Reported ${(0, watchLines_1.describeReport)(result.report)} for panel ${result.panelId}.${sessions}${delivered}`];
+    if (result.sessionIds.length > 0 || watchers > 0)
+        return lines;
+    const stored = `It is stored on the panel (runpane agents status --panel ${result.panelId})`;
+    lines.push(result.liveWatchers === undefined
+        ? `No Session recorded this report. ${stored}, and only watchers that list agent.report receive it.`
+        : `No Session recorded this report and no watcher was waiting for it. ${stored}, `
+            + 'and a watch with a named cursor (runpane watch --as <name> --kinds agent.report) still receives it when it next waits.');
+    return lines;
+}
 async function runPanelsSubmit(parsed) {
     const request = buildPanelInputRequest(parsed, 'submit');
     await confirmPanelInput(parsed, request, 'submit');
@@ -1843,6 +1930,34 @@ async function runPanelsWait(parsed) {
     printPanelWaitResult(result);
     return result.ok ? 0 : 1;
 }
+async function runPanelsResume(parsed) {
+    const scopes = [parsed.panelId, parsed.sessionId, parsed.allStopped].filter(Boolean).length;
+    if (scopes !== 1) {
+        throw new Error('runpane panels resume requires exactly one of --panel, --session, or --all-stopped.');
+    }
+    if (parsed.panelId && parsed.concurrency !== undefined) {
+        throw new Error('runpane panels resume --concurrency applies only to --session or --all-stopped.');
+    }
+    await confirmPanelResume(parsed);
+    if (!parsed.panelId) {
+        return runPanelsResumeMany(parsed);
+    }
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:panels:resume', [{
+            panelId: parsed.panelId,
+            waitReady: parsed.waitReady,
+            readyTimeoutMs: parsed.readyTimeoutMs,
+        }], panelResumeResultSchema, {
+        paneDir: parsed.paneDir,
+        timeoutMs: (parsed.readyTimeoutMs ?? 30_000) + 10_000,
+    });
+    if (parsed.json) {
+        printJson(result);
+    }
+    else {
+        printPanelResumeResult(result);
+    }
+    return result.ok ? 0 : 1;
+}
 async function runAgentsDoctor(parsed) {
     if (!parsed.agent) {
         throw new Error(`runpane agents doctor requires --agent ${contract_1.RUNPANE_CONTRACT.enums.agents.join('|')}.`);
@@ -2255,6 +2370,27 @@ async function confirmPanelInput(parsed, request, command = 'input') {
         rl.close();
     }
 }
+async function confirmPanelResume(parsed) {
+    if (parsed.yes) {
+        return;
+    }
+    if (!isInteractiveShell()) {
+        throw new Error('runpane panels resume restarts a Pane terminal. Rerun with --yes in non-interactive shells.');
+    }
+    const rl = (0, promises_1.createInterface)({ input: node_process_1.stdin, output: node_process_1.stdout });
+    try {
+        const target = parsed.panelId
+            ? `panel ${parsed.panelId}`
+            : parsed.sessionId ? `every stopped agent panel in Session ${parsed.sessionId}` : 'every stopped agent panel';
+        const answer = (await rl.question(`Resume ${target}? [y/N] `)).trim().toLowerCase();
+        if (answer !== 'y' && answer !== 'yes') {
+            throw new Error('Cancelled.');
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
 async function confirmPanelSubmitComposer(parsed) {
     if (parsed.yes) {
         return;
@@ -2326,6 +2462,7 @@ function workspaceLabel(kind) {
         'pane.created': 'NEW',
         'pane.gone': 'GONE',
         'panel.exited': 'EXIT',
+        'panel.stopped': 'STOPPED',
         'pane.associated': 'JOINED',
         'pane.detached': 'LEFT',
         'pr.conflicted': 'PR CONFLICTED',
@@ -2393,12 +2530,8 @@ function printPaneCreateResult(result, dryRun = false, action = 'create') {
                 continue;
             }
             console.log(`Created ${item.name ?? `pane ${item.index}`}: session ${item.sessionId ?? 'unknown'} panel ${item.panelId ?? 'unknown'}${worktree}`);
-            if (item.readiness) {
-                console.log(`  Ready: ${item.readiness.ok ? 'yes' : item.readiness.timedOut ? 'timed out' : 'blocked'} after ${item.readiness.elapsedMs}ms`);
-                if (item.readiness.blocked) {
-                    console.log(`  Blocked: ${item.readiness.blocked.message}`);
-                }
-            }
+            if (item.readiness)
+                printReadiness(item.readiness, '  ');
             printInitialInputDelivery(item.initialInput, '  ');
             if (item.association) {
                 console.log(item.association.ok
@@ -2406,6 +2539,9 @@ function printPaneCreateResult(result, dryRun = false, action = 'create') {
                     : `  Not associated with Session ${item.association.sessionId}: ${item.association.error ?? 'unknown error'}`);
             }
             printPromptNotes(item, '  ');
+            if (item.base?.notice) {
+                console.log(`  ! ${item.base.notice}`);
+            }
             if (item.setupQueue) {
                 console.log(`  ${item.setupQueue.message}`);
             }
@@ -2478,18 +2614,32 @@ function printArchiveCommitEvidence(safetyCheck, print = console.log) {
 }
 function printPanelCreateResult(result) {
     console.log(`Created panel ${result.panelId} in pane ${result.paneId}: ${result.title}${result.active ? ' active' : ' background'}`);
-    if (result.readiness) {
-        console.log(`Ready: ${result.readiness.ok ? 'yes' : result.readiness.timedOut ? 'timed out' : 'blocked'} after ${result.readiness.elapsedMs}ms`);
-        if (result.readiness.blocked) {
-            console.log(`Blocked: ${result.readiness.blocked.message}`);
-        }
-    }
+    if (result.readiness)
+        printReadiness(result.readiness);
     printInitialInputDelivery(result.initialInput);
     printPromptNotes(result);
     if (result.nextCommand) {
         console.log(`Next: ${result.nextCommand}`);
     }
 }
+/** One-line status for a bulk resume item that resumed but did not become ready. */
+function notReadySummary(readiness) {
+    if (readiness.blocked)
+        return `blocked: ${readiness.blocked.message}`;
+    const state = readiness.reason?.code === 'command-exited' ? 'command exited' : 'not ready';
+    return readiness.reason ? `${state}: ${readiness.reason.message}` : state;
+}
+function printReadiness(readiness, prefix = '') {
+    const state = readiness.ok ? 'yes'
+        : readiness.blocked ? 'blocked'
+            : readiness.reason?.code === 'command-exited' ? 'command exited'
+                : readiness.timedOut ? 'timed out' : 'no';
+    console.log(`${prefix}Ready: ${state} after ${readiness.elapsedMs}ms`);
+    if (readiness.blocked)
+        console.log(`${prefix}Blocked: ${readiness.blocked.message}`);
+    if (readiness.reason)
+        console.log(`${prefix}Why: ${readiness.reason.message}`);
+}
 function printInitialInputDelivery(initialInput, prefix = '') {
     if (!initialInput) {
         return;
@@ -2511,10 +2661,51 @@ function printInitialInputDelivery(initialInput, prefix = '') {
         console.log(`${prefix}Initial input error: ${initialInput.error.message}`);
     }
 }
+/** Time the daemon gets to restart every panel in scope, before any readiness wait. */
+const RESUME_MANY_RESTART_BUDGET_MS = 5 * 60_000;
+async function runPanelsResumeMany(parsed) {
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:panels:resume-many', [{
+            sessionId: parsed.sessionId,
+            allStopped: parsed.allStopped || undefined,
+            waitReady: parsed.waitReady,
+            readyTimeoutMs: parsed.readyTimeoutMs,
+            concurrency: parsed.concurrency,
+        }], panelResumeManyResultSchema, {
+        paneDir: parsed.paneDir,
+        // The resumed panels wait together, so the wait adds one --ready-timeout-ms however many there are.
+        timeoutMs: RESUME_MANY_RESTART_BUDGET_MS + (parsed.waitReady ? parsed.readyTimeoutMs ?? 30_000 : 0),
+    });
+    if (parsed.json) {
+        printJson(result);
+    }
+    else {
+        const scope = result.scope.kind === 'session' ? `Session ${result.scope.sessionName}` : 'every Pane';
+        const notReady = result.notReady > 0 ? `, ${result.notReady} not ready` : '';
+        console.log(`Resumed ${result.resumed} stopped agent panel${result.resumed === 1 ? '' : 's'} in ${scope}, ${result.concurrency} at a time; ${result.alreadyRunning} already running, ${result.failed} failed${notReady}.`);
+        for (const item of result.items) {
+            const status = item.error
+                ? `failed: ${item.error}`
+                : item.readiness && !item.readiness.ok
+                    ? notReadySummary(item.readiness)
+                    : item.action ?? 'resumed';
+            console.log(`${item.ok ? 'OK' : 'FAIL'} ${item.paneName} panel ${item.panelId}: ${status}`);
+        }
+    }
+    return result.ok ? 0 : 1;
+}
+function printPanelResumeResult(result) {
+    console.log(`${result.action === 'resumed' ? 'Resumed' : 'Already running:'} panel ${result.panelId} in pane ${result.paneId}. ${result.message}`);
+    if (result.readiness)
+        printReadiness(result.readiness);
+    console.log(`Next: ${result.nextCommand}`);
+}
 function printPanelWaitResult(result) {
     if (result.ok) {
         console.log(`Matched ${result.condition} for panel ${result.panelId} after ${result.elapsedMs}ms.`);
     }
+    else if (result.stopped && !result.timedOut) {
+        console.log(`Panel ${result.panelId} is not running, so it cannot become ${result.condition}.`);
+    }
     else if (result.blocked) {
         console.log(`Blocked waiting for ${result.condition} on panel ${result.panelId}: ${result.blocked.message}`);
     }
@@ -2524,7 +2715,10 @@ function printPanelWaitResult(result) {
     else {
         console.log(`Did not match ${result.condition} for panel ${result.panelId}.`);
     }
+    if (result.reason)
+        console.log(`Why: ${result.reason.message}`);
     const statusParts = [
+        result.state.running === false ? 'stopped' : undefined,
         result.state.initialized ? 'initialized' : 'not-initialized',
         result.state.activityStatus,
         result.state.isCliReady === undefined ? undefined : result.state.isCliReady ? 'cli-ready' : 'cli-not-ready',
@@ -2562,9 +2756,11 @@ function printPanelListResult(result) {
     for (const panel of result.panels) {
         const marker = panel.active ? '*' : ' ';
         const initialized = panel.initialized === undefined ? '' : panel.initialized ? ' initialized' : ' not-initialized';
+        const stopped = panel.running === false ? ' stopped' : '';
         const agent = panel.agentType ? ` ${panel.agentType}` : '';
         const detection = panel.agentDetection && panel.agentDetection !== 'command' ? ` (${panel.agentDetection})` : '';
-        console.log(`${marker} ${panel.id}\t${panel.type}\t${panel.title}${initialized}${agent}${detection}`);
+        const resume = panel.resumeId ? ` resume ${panel.resumeId}` : '';
+        console.log(`${marker} ${panel.id}\t${panel.type}\t${panel.title}${initialized}${stopped}${agent}${detection}${resume}`);
     }
 }
 function isInteractiveShell() {