runpane 2.4.104 → 2.4.106

package/dist/localControl.js

@@ -6,6 +6,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runReposList = runReposList;
 exports.runReposAdd = runReposAdd;
 exports.runPanesList = runPanesList;
+exports.runSessionsList = runSessionsList;
+exports.runSessionsCreate = runSessionsCreate;
+exports.runSessionsGet = runSessionsGet;
+exports.runSessionsUpdate = runSessionsUpdate;
+exports.runSessionsSetAgent = runSessionsSetAgent;
+exports.runSessionsAssociate = runSessionsAssociate;
+exports.runSessionsDetach = runSessionsDetach;
+exports.runSessionsOverview = runSessionsOverview;
 exports.runPanesCost = runPanesCost;
 exports.runWorkspaceState = runWorkspaceState;
 exports.runWatch = runWatch;
@@ -29,6 +37,7 @@ const promises_1 = require("node:readline/promises");
 const boundaryDecoder_1 = require("./boundaryDecoder");
 const daemonClient_1 = require("./daemonClient");
 const contract_1 = require("./generated/contract");
+const commands_1 = require("./commands");
 const watchLines_1 = require("./watchLines");
 const agentSchema = boundaryDecoder_1.boundary.enumeration(...contract_1.RUNPANE_CONTRACT.enums.agents);
 const repoSummarySchema = boundaryDecoder_1.boundary.object({
@@ -148,6 +157,123 @@ const paneListResultSchema = boundaryDecoder_1.boundary.object({
     repo: boundaryDecoder_1.boundary.optional(repoSummarySchema),
     panes: boundaryDecoder_1.boundary.array(paneSummarySchema),
 });
+const orchestrationLinkSchema = boundaryDecoder_1.boundary.object({
+    label: boundaryDecoder_1.boundary.nonEmptyString,
+    url: boundaryDecoder_1.boundary.nonEmptyString,
+    kind: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('evidence', 'output', 'ticket', 'pull-request', 'other')),
+    provenance: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    addedAt: boundaryDecoder_1.boundary.nonEmptyString,
+});
+const orchestrationReportSchema = boundaryDecoder_1.boundary.object({
+    summary: boundaryDecoder_1.boundary.nonEmptyString,
+    status: boundaryDecoder_1.boundary.enumeration('reported', 'verified'),
+    evidence: boundaryDecoder_1.boundary.array(orchestrationLinkSchema),
+    reportedAt: boundaryDecoder_1.boundary.nonEmptyString,
+    provenance: boundaryDecoder_1.boundary.nonEmptyString,
+});
+const orchestrationAssociationSchema = boundaryDecoder_1.boundary.object({
+    paneId: boundaryDecoder_1.boundary.nonEmptyString,
+    panelIds: boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.nonEmptyString),
+    attachedAt: boundaryDecoder_1.boundary.nonEmptyString,
+});
+const orchestrationActivitySchema = boundaryDecoder_1.boundary.object({
+    id: boundaryDecoder_1.boundary.nonEmptyString,
+    kind: boundaryDecoder_1.boundary.enumeration('created', 'updated', 'associated', 'detached', 'working', 'blocked', 'idle', 'unknown', 'report'),
+    message: boundaryDecoder_1.boundary.string,
+    at: boundaryDecoder_1.boundary.nonEmptyString,
+    source: boundaryDecoder_1.boundary.enumeration('user', 'agent', 'system'),
+    paneId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.nonEmptyString),
+    panelId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.nonEmptyString),
+});
+const orchestrationSessionRecordSchema = boundaryDecoder_1.boundary.object({
+    id: boundaryDecoder_1.boundary.nonEmptyString,
+    name: boundaryDecoder_1.boundary.nonEmptyString,
+    archived: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
+    isPinned: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
+    agent: agentSchema,
+    internalSessionId: boundaryDecoder_1.boundary.nonEmptyString,
+    panelIds: boundaryDecoder_1.boundary.object({
+        claude: boundaryDecoder_1.boundary.nonEmptyString,
+        codex: boundaryDecoder_1.boundary.nonEmptyString,
+        cursor: boundaryDecoder_1.boundary.nonEmptyString,
+    }),
+    goal: boundaryDecoder_1.boundary.string,
+    context: boundaryDecoder_1.boundary.string,
+    decisions: boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string),
+    blockers: boundaryDecoder_1.boundary.array(boundaryDecoder_1.boundary.string),
+    nextAction: boundaryDecoder_1.boundary.string,
+    evidence: boundaryDecoder_1.boundary.array(orchestrationLinkSchema),
+    outputs: boundaryDecoder_1.boundary.array(orchestrationLinkSchema),
+    associations: boundaryDecoder_1.boundary.array(orchestrationAssociationSchema),
+    activity: boundaryDecoder_1.boundary.array(orchestrationActivitySchema),
+    report: boundaryDecoder_1.boundary.optional(orchestrationReportSchema),
+    reportActivityId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.nonEmptyString),
+    reportAcceptedAt: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.nonEmptyString),
+    revision: boundaryDecoder_1.boundary.number,
+    createdAt: boundaryDecoder_1.boundary.nonEmptyString,
+    updatedAt: boundaryDecoder_1.boundary.nonEmptyString,
+});
+const 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({
+    ok: boundaryDecoder_1.boundary.literal(true),
+    session: orchestrationSessionRecordSchema,
+    panelId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.nonEmptyString),
+    internalSessionId: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.nonEmptyString),
+});
+const orchestrationPanelOverviewSchema = boundaryDecoder_1.boundary.object({
+    panelId: boundaryDecoder_1.boundary.nonEmptyString,
+    title: boundaryDecoder_1.boundary.string,
+    agentType: boundaryDecoder_1.boundary.optional(agentSchema),
+    state: boundaryDecoder_1.boundary.enumeration('blocked', 'working', 'idle', 'unknown'),
+    initialized: boundaryDecoder_1.boundary.boolean,
+    lastActivityAt: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.nonEmptyString),
+    missing: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
+});
+const orchestrationPaneOverviewSchema = boundaryDecoder_1.boundary.object({
+    paneId: boundaryDecoder_1.boundary.nonEmptyString,
+    name: boundaryDecoder_1.boundary.string,
+    worktreePath: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    branch: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    archived: boundaryDecoder_1.boundary.boolean,
+    missing: boundaryDecoder_1.boundary.boolean,
+    panels: boundaryDecoder_1.boundary.array(orchestrationPanelOverviewSchema),
+    git: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.object({
+        state: boundaryDecoder_1.boundary.string,
+        ahead: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
+        behind: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
+        hasUncommittedChanges: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
+        hasUntrackedFiles: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.boolean),
+        prNumber: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.number),
+        prUrl: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+        prTitle: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+        prState: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.string),
+    })),
+});
+const runpaneSessionOverviewResultSchema = boundaryDecoder_1.boundary.object({
+    ok: boundaryDecoder_1.boundary.literal(true),
+    session: orchestrationSessionRecordSchema,
+    status: boundaryDecoder_1.boundary.enumeration('working', 'blocked', 'idle', 'unknown', 'unassociated'),
+    panes: boundaryDecoder_1.boundary.array(orchestrationPaneOverviewSchema),
+    activity: boundaryDecoder_1.boundary.array(orchestrationActivitySchema),
+    report: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.object({
+        ...orchestrationReportSchemaFields(),
+        freshness: boundaryDecoder_1.boundary.enumeration('current', 'stale'),
+    })),
+    refreshedAt: boundaryDecoder_1.boundary.nonEmptyString,
+});
+function orchestrationReportSchemaFields() {
+    return {
+        summary: boundaryDecoder_1.boundary.nonEmptyString,
+        status: boundaryDecoder_1.boundary.enumeration('reported', 'verified'),
+        evidence: boundaryDecoder_1.boundary.array(orchestrationLinkSchema),
+        reportedAt: boundaryDecoder_1.boundary.nonEmptyString,
+        provenance: boundaryDecoder_1.boundary.nonEmptyString,
+    };
+}
 const usageTotalsResultSchema = boundaryDecoder_1.boundary.object({
     inputTokens: boundaryDecoder_1.boundary.number,
     outputTokens: boundaryDecoder_1.boundary.number,
@@ -554,6 +680,135 @@ async function runPanesList(parsed) {
     printPaneListResult(result);
     return 0;
 }
+async function runSessionsList(parsed) {
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:sessions:list', [], runpaneSessionListResultSchema, {
+        paneDir: parsed.paneDir,
+    });
+    if (parsed.json) {
+        printJson(result);
+        return 0;
+    }
+    for (const session of result.sessions) {
+        console.log(`${session.id}\t${session.name}\t${session.agent}\t${session.associations.length} Pane(s)`);
+    }
+    if (result.sessions.length === 0)
+        console.log('No named Sessions.');
+    return 0;
+}
+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, {
+        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, {
+        paneDir: parsed.paneDir,
+    });
+    return printSessionResult(result, parsed.json, '');
+}
+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, {
+        paneDir: parsed.paneDir,
+    });
+    return printSessionResult(result, parsed.json, 'Updated');
+}
+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, {
+        paneDir: parsed.paneDir,
+    });
+    return printSessionResult(result, parsed.json, 'Updated agent for');
+}
+async function runSessionsAssociate(parsed) {
+    const selector = sessionSelectorFromParsed(parsed);
+    if (!parsed.paneId)
+        throw new Error('runpane sessions associate requires --pane.');
+    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 });
+    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, {
+        paneDir: parsed.paneDir,
+    });
+    return printSessionResult(result, parsed.json, 'Detached');
+}
+async function runSessionsOverview(parsed) {
+    const result = await (0, daemonClient_1.invokeDaemon)('runpane:sessions:overview', [sessionSelectorFromParsed(parsed)], runpaneSessionOverviewResultSchema, {
+        paneDir: parsed.paneDir,
+    });
+    if (parsed.json) {
+        printJson(result);
+        return 0;
+    }
+    console.log(`${result.session.name}: ${result.status}`);
+    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}`);
+    }
+    return 0;
+}
+function sessionSelectorFromParsed(parsed) {
+    const sessionId = parsed.sessionId?.trim();
+    if (!sessionId)
+        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({
+        name: boundaryDecoder_1.boundary.nonEmptyString,
+        agent: boundaryDecoder_1.boundary.optional(boundaryDecoder_1.boundary.enumeration('codex', 'claude', 'cursor')),
+        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')),
+        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);
+        return 0;
+    }
+    const prefix = action ? `${action} ` : '';
+    console.log(`${prefix}${result.session.name} (${result.session.id})`);
+    if (result.panelId)
+        console.log(`  panel: ${result.panelId}`);
+    return 0;
+}
 async function runPanesCost(parsed) {
     const result = await (0, daemonClient_1.invokeDaemon)('runpane:panes:cost', [{
             repo: parsed.repo,
@@ -597,7 +852,10 @@ async function runWatch(parsed) {
     const includeHeldInput = parsed.includeHeldInput && !parsed.noHeldInput ? true : undefined;
     const includeHeldInputPresence = defaults.includeHeldInputPresence
         && !parsed.noHeldInput && parsed.follow && format === 'lines' ? true : undefined;
-    const watchAs = parsed.watchAs ?? (parsed.follow ? process.env.PANE_PANEL_ID : undefined);
+    const cadenceValueFlagPresent = (0, commands_1.hasCadenceValueFlag)(parsed);
+    // Cadence state lives in the daemon per named consumer, so an anonymous follower names itself.
+    const watchAs = parsed.watchAs
+        ?? (parsed.follow ? process.env.PANE_PANEL_ID || (cadenceValueFlagPresent ? `follow-${process.pid}` : undefined) : undefined);
     const request = {
         as: watchAs,
         since: parsed.watchSince,
@@ -614,6 +872,10 @@ async function runWatch(parsed) {
         includeHeldInput,
         includeHeldInputPresence,
         idleAfterMs,
+        settleMs: parsed.settleMs,
+        blockedSettleMs: parsed.blockedSettleMs,
+        minIntervalMs: parsed.minIntervalMs,
+        idleBackoff: parsed.idleBackoff || undefined,
     };
     let armed = false;
     let failingCode;