@comput/pi-intercom 0.3.0 → 0.4.2

package/dist/index.js

@@ -0,0 +1,186 @@
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import { Type } from 'typebox';
+import { getAgentDir, SessionManager, SettingsManager, truncateHead, withFileMutationQueue } from '@earendil-works/pi-coding-agent';
+import { ConfigStore } from './config.js';
+import { Intercom, UNSUPPORTED_CANCELLATION } from './runtime.js';
+import { launchers } from './launcher.js';
+import { ensureMonitorPane } from './monitor-launcher.js';
+import { createActivityTracker } from './activity.js';
+const to = Type.Object({ to: Type.String({ minLength: 1, maxLength: 128 }) });
+const tools = [
+    ['create_worker', 'Coordinator only. Launch one anonymous worker in projectDirectory (default root). No assignment, configuration, or registration wait.', Type.Object({ projectDirectory: Type.Optional(Type.String()) })],
+    ['configure_worker', 'Coordinator only. Write explicit reported connection details and responsibility to config. Does not notify, reload, or start work. Use reload_worker separately.', Type.Object({ sessionId: Type.String(), port: Type.Integer({ minimum: 1, maximum: 65535 }), projectDirectory: Type.String(), name: Type.String({ minLength: 1, maxLength: 128 }), description: Type.String({ minLength: 1, maxLength: 4096 }) })],
+    ['reload_worker', 'Coordinator only. Ask worker to reread responsibility and synchronize names. NOT Pi extension reload, cancellation, restart, or work assignment.', to],
+    ['send', 'Configured sessions only. Send an explicit work/progress/findings message by recipient name. Idle delivery starts a turn; busy delivery steers at supported boundaries. Receipt is not an agent reply. Progress questions do not cancel assignments.', Type.Object({ to: Type.String(), message: Type.String({ minLength: 1, maxLength: 48000 }) })],
+    ['worker_status', 'Configured sessions only. Read paginated JSON worker observations and public reports from local files, optionally by worker name. Last-observed status is not live liveness or task completion; reports are self-reported, not approval. No worker prompts, live probing or Telegram dependency. Follow nextOffset for further pages; null report means no readable active report.', Type.Object({ name: Type.Optional(Type.String({ minLength: 1, maxLength: 128 })), offset: Type.Optional(Type.Integer({ minimum: 0 })), limit: Type.Optional(Type.Integer({ minimum: 1, maximum: 20 })) })],
+    ['list', 'Configured sessions only. Read current saved names, responsibilities, session IDs, roles and ports. No live probing. Output limited to 50 KiB/2000 lines; full data remains in config.json.', Type.Object({})],
+    ['request_status', 'Coordinator only. Ask worker extension to send an independent sessionId/port/busy report without a model turn on worker. No synchronous status reply.', to],
+    ['report_work', 'Configured, responsibility-loaded workers only. Store one public report (blocked, needs_decision, ready_for_review) and notify the coordinator; clear retires it. Summary required except clear (omit or empty). Never include private reasoning, credentials, raw tool payloads, or secrets. Receipt is not approval, verified completion, or permission for follow-up work.', Type.Object({ status: Type.String({ enum: ['blocked', 'needs_decision', 'ready_for_review', 'clear'] }), summary: Type.Optional(Type.String({ maxLength: 2000 })) })],
+    ['report_status', 'Worker only (including anonymous). Send runtime sessionId/port/busy report to coordinator. This is NOT registration and creates no config entry.', Type.Object({})],
+    ['stop_worker', UNSUPPORTED_CANCELLATION, to],
+    ['close_worker', UNSUPPORTED_CANCELLATION, to],
+    ['resume_worker', 'Coordinator only. Launch saved session by ID in configured directory. No replacement/removal on failure; no old assignment is automatically started.', to],
+    ['remove_worker', 'Coordinator only. Remove config entry only; never stop process or delete session files. A running worker must be explicitly closed before removal. Stop/close are disabled on current host: arrange explicit user closure first.', to],
+    ['set_multiplexer', 'Coordinator only. Set herdr (default, Windows/Linux) or none (separate visible Windows terminals; unsupported on Linux) for future launches. Never move/restart existing workers or fall back.', Type.Object({ multiplexer: Type.String({ enum: ['herdr', 'none'] }) })],
+];
+// Launchers pass no --session-dir. Match child Pi's env > per-cwd settings >
+// default lookup, resolving relative paths against the child's cwd, not ours.
+// SettingsManager's public getter applies Pi's own path/tilde normalization.
+export function resumeSessionDirectory(cwd, envSessionDir = process.env.PI_CODING_AGENT_SESSION_DIR, agentDir = getAgentDir()) {
+    const settings = envSessionDir
+        ? SettingsManager.inMemory({ sessionDir: envSessionDir })
+        : SettingsManager.create(cwd, path.resolve(cwd, agentDir));
+    const sessionDir = settings.getSessionDir();
+    return sessionDir ? path.resolve(cwd, sessionDir) : undefined;
+}
+// Participate in Pi's own per-file mutation queue as well as Intercom serialization.
+class PiConfigStore extends ConfigStore {
+    update(id, mutate, assertValid) {
+        return withFileMutationQueue(this.file, () => super.update(id, mutate, assertValid));
+    }
+}
+export default function intercomExtension(pi) {
+    let runtime;
+    let context;
+    let generation = 0;
+    let activityOutcome = 'snapshot';
+    const activity = createActivityTracker((phase, detail) => {
+        runtime?.recordObservation('host.activity', { busy: phase !== 'idle', phase, detail, outcome: activityOutcome });
+    });
+    const launcher = launchers({
+        extension: fileURLToPath(import.meta.url),
+        sessionExists: async (cwd, id) => (await SessionManager.list(cwd, resumeSessionDirectory(cwd))).some(s => s.id === id),
+    });
+    pi.on('session_start', async (_event, ctx) => {
+        const started = ++generation;
+        activity.reset();
+        const oldRuntime = runtime;
+        runtime = undefined;
+        await oldRuntime?.close();
+        if (started !== generation)
+            return;
+        context = ctx;
+        if (!['win32', 'linux'].includes(process.platform) || ctx.mode !== 'tui')
+            throw new Error('PiIntercom requires Windows or Linux interactive Pi. No resources started.');
+        if (!ctx.isProjectTrusted())
+            throw new Error('PiIntercom requires project trust before honoring shared project configuration.');
+        runtime = new Intercom({
+            cwd: ctx.cwd,
+            sessionId: () => context.sessionManager.getSessionId(),
+            busy: () => !context.isIdle(),
+            // Always supply the supported busy mode: the arrival snapshot can become
+            // stale before Pi checks it. Pi still starts a normal turn when idle.
+            deliver: content => pi.sendUserMessage(content, { deliverAs: 'steer' }),
+            setName: async (name) => { if (pi.getSessionName() !== name)
+                pi.setSessionName(name); await launcher.syncName(name); },
+            notify: text => ctx.ui.notify(text, 'info'),
+        }, { launch: launcher.launch, store: root => new PiConfigStore(root) });
+        const current = runtime;
+        try {
+            await current.start();
+        }
+        catch (e) {
+            if (runtime === current)
+                runtime = undefined;
+            ctx.ui.notify(String(e), 'error');
+            return;
+        }
+        if (started !== generation) {
+            await current.close();
+            return;
+        }
+        try {
+            if ((await current.state()).me?.coordinator) {
+                try {
+                    await current.retireDashboardMetadata();
+                }
+                catch (error) {
+                    if (started !== generation)
+                        return;
+                    ctx.ui.notify(`Legacy dashboard metadata cleanup failed; messaging remains available: ${String(error)}`, 'warning');
+                }
+                if (started !== generation)
+                    return;
+                const monitor = await ensureMonitorPane({
+                    root: current.store.root, sessionId: ctx.sessionManager.getSessionId(),
+                    script: fileURLToPath(new URL('../dist/monitor.js', import.meta.url)),
+                    assertCurrent: () => { if (started !== generation || runtime !== current)
+                        throw new Error('Coordinator session changed'); },
+                });
+                if (started !== generation)
+                    return;
+                ctx.ui.notify(`Intercom status monitor: ${monitor.outcome}${monitor.pane ? ` (${monitor.pane})` : ''}`, 'info');
+            }
+        }
+        catch (error) {
+            if (started !== generation)
+                return;
+            ctx.ui.notify(String(error), 'warning');
+        }
+    });
+    pi.on('session_shutdown', async () => {
+        generation++;
+        activity.reset();
+        const oldRuntime = runtime;
+        runtime = undefined;
+        context = undefined;
+        await oldRuntime?.close();
+    });
+    pi.on('agent_start', async (_event, ctx) => {
+        context = ctx;
+        activityOutcome = 'started';
+        try {
+            activity.start();
+        }
+        finally {
+            activityOutcome = 'snapshot';
+        }
+    });
+    pi.on('agent_settled', async (_event, ctx) => {
+        context = ctx;
+        activityOutcome = 'settled';
+        try {
+            activity.settled();
+        }
+        finally {
+            activityOutcome = 'snapshot';
+        }
+    });
+    pi.on('message_update', (event, ctx) => {
+        context = ctx;
+        // Inspect the event discriminator only. Never access reasoning/text payloads.
+        activity.message(event.assistantMessageEvent.type);
+    });
+    pi.on('tool_execution_start', (event, ctx) => {
+        context = ctx;
+        activity.toolStart(event.toolCallId, event.toolName);
+    });
+    pi.on('tool_execution_end', (event, ctx) => {
+        context = ctx;
+        activity.toolEnd(event.toolCallId);
+    });
+    pi.on('before_agent_start', async (event, ctx) => {
+        context = ctx;
+        if (!runtime)
+            return;
+        const { me } = await runtime.state();
+        const loaded = runtime.responsibility;
+        return { systemPrompt: event.systemPrompt + '\n\nPiIntercom: communicates; Pi decides orchestration. Responsibility is not a work assignment. Do not implement unrelated work from findings. After assigned work, report as instructed and wait; do not autonomously exit. Progress questions require reporting and continuing unless explicitly redirected. stop_worker/close_worker are disabled due to host cancellation blocker.\n' + (me && loaded ? `Identity: ${loaded.name} (${me.sessionId}). Responsibility: ${loaded.description}.` : 'Anonymous/unloaded worker: wait for coordinator configuration and separate reload; do not treat registration as authorization to work.') };
+    });
+    for (const [operation, description, parameters] of tools) {
+        pi.registerTool({
+            name: `intercom_${operation}`, label: `Intercom ${operation}`, description, parameters,
+            async execute(_id, args, signal, _update, ctx) {
+                signal?.throwIfAborted();
+                context = ctx;
+                if (!runtime)
+                    throw new Error('PiIntercom not initialized; inspect startup error.');
+                const result = await runtime.tool(operation, args);
+                const output = truncateHead(JSON.stringify(result, null, 2));
+                return { content: [{ type: 'text', text: output.content + (output.truncated ? `\n[Truncated; full shared configuration: ${runtime.store.file}]` : '') }], details: {} };
+            },
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/launcher.d.ts

@@ -0,0 +1,17 @@
+import type { LaunchRequest } from './runtime.js';
+export type Run = (file: string, args: string[]) => Promise<string>;
+export declare const run: Run;
+export declare const psQuote: (value: string) => string;
+export declare const shQuote: (value: string) => string;
+export declare const encoded: (script: string) => string;
+export interface LauncherOptions {
+    extension: string;
+    platform?: string;
+    env?: NodeJS.ProcessEnv;
+    run?: Run;
+    sessionExists(cwd: string, id: string): Promise<boolean>;
+}
+export declare function launchers(options: LauncherOptions): {
+    launch: (request: LaunchRequest) => Promise<unknown>;
+    syncName: (name: string) => Promise<void>;
+};

package/dist/launcher.js

@@ -0,0 +1,77 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { fail } from './config.js';
+export const run = async (file, args) => {
+    const { stdout } = await promisify(execFile)(file, args, { windowsHide: true, timeout: 40000, maxBuffer: 1024 * 1024 });
+    return stdout;
+};
+export const psQuote = (value) => `'${value.replaceAll("'", "''")}'`;
+export const shQuote = (value) => `'${value.replaceAll("'", "'\"'\"'")}'`;
+export const encoded = (script) => Buffer.from(script, 'utf16le').toString('base64');
+export function launchers(options) {
+    const exec = options.run ?? run, env = options.env ?? process.env;
+    async function launch(request) {
+        const platform = options.platform ?? process.platform;
+        if (platform !== 'win32' && platform !== 'linux')
+            fail('launchers support Windows and Linux only');
+        if (platform === 'linux' && request.multiplexer === 'none')
+            fail('Linux worker launching requires Herdr; none is Windows-only. No terminal fallback');
+        if (request.sessionId && !await options.sessionExists(request.cwd, request.sessionId))
+            fail('saved Pi session not found in project directory; never-used sessions may not be persisted. Config unchanged; no replacement launched');
+        const args = ['-e', options.extension, ...(request.sessionId ? ['--session', request.sessionId] : [])];
+        if (request.multiplexer === 'herdr') {
+            if (env.HERDR_ENV !== '1' || !env.HERDR_WORKSPACE_ID)
+                fail('Herdr launcher requires this Pi to run inside a Herdr-managed workspace; no fallback');
+            let created;
+            try {
+                created = JSON.parse(await exec('herdr', ['tab', 'create', '--workspace', env.HERDR_WORKSPACE_ID, '--cwd', request.cwd, '--label', 'Intercom (anonymous)', '--no-focus']));
+            }
+            catch (e) {
+                fail(`Herdr tab launch failed: ${String(e)}; no fallback or cleanup`);
+            }
+            const pane = created.result?.root_pane?.pane_id, tab = created.result?.tab?.tab_id;
+            if (!pane || !tab)
+                fail('Herdr creation response missing returned pane/tab IDs; no guessed targeting or cleanup');
+            // Herdr's Windows agent-start wrapper uses Start-Process on `pi`, which
+            // can resolve to a PowerShell shim and fail with invalid Win32 application.
+            // Run an explicit PowerShell command in the returned shell pane instead.
+            // This acknowledges command submission only, not Pi readiness/registration.
+            const script = `$ErrorActionPreference='Stop'; Set-Location -LiteralPath ${psQuote(request.cwd)}; & (Get-Command pi.ps1 -ErrorAction Stop).Source ${args.map(psQuote).join(' ')}; if ($LASTEXITCODE -ne 0) { Write-Error ('Pi exited with code ' + $LASTEXITCODE) }`;
+            const command = platform === 'win32'
+                ? `powershell.exe -NoProfile -ExecutionPolicy Bypass -EncodedCommand ${encoded(script)}`
+                : `sh -c ${shQuote(`cd ${shQuote(request.cwd)} && exec pi ${args.map(shQuote).join(' ')}`)}`;
+            try {
+                await exec('herdr', ['pane', 'run', pane, command]);
+            }
+            catch (e) {
+                fail(`Herdr Pi command submission failed in tab ${tab}, pane ${pane}: ${String(e)}. Tab/process may remain; no automatic cleanup/retry/replacement`);
+            }
+            return { commandSubmitted: true, tab, pane, piReadiness: 'not observed; inspect pane for startup failures', registrationAwaited: false };
+        }
+        if (request.multiplexer !== 'none')
+            fail('unsupported multiplexer');
+        // Use encoded PowerShell rather than constructing cmd.exe command strings.
+        // The outer process reports only successful visible terminal creation, not Pi readiness.
+        const child = `$ErrorActionPreference='Stop'; Get-ChildItem Env: | Where-Object { $_.Name -like 'HERDR_*' -or $_.Name -like 'PI_SESSION_*' } | ForEach-Object { Remove-Item ('Env:' + $_.Name) }; Set-Location -LiteralPath ${psQuote(request.cwd)}; & (Get-Command pi.cmd -ErrorAction Stop).Source ${args.map(psQuote).join(' ')}; if ($LASTEXITCODE -ne 0) { Write-Error ('Pi exited with code ' + $LASTEXITCODE) }`;
+        const outer = `$ErrorActionPreference='Stop'; $null=Get-Command pi.cmd -ErrorAction Stop; $p=Start-Process -FilePath (Join-Path $PSHOME 'powershell.exe') -WorkingDirectory ${psQuote(request.cwd)} -ArgumentList @('-NoProfile','-NoExit','-EncodedCommand',${psQuote(encoded(child))}) -WindowStyle Normal -PassThru; $p.Id`;
+        const result = await exec('powershell.exe', ['-NoProfile', '-NonInteractive', '-EncodedCommand', encoded(outer)]);
+        const pid = Number(result.trim());
+        if (!Number.isInteger(pid) || pid <= 0)
+            fail('visible terminal launch returned no process ID; outcome unknown');
+        return { terminalLaunched: true, pid, piReadiness: 'not observed; inspect visible terminal for startup failures', registrationAwaited: false };
+    }
+    async function syncName(name) {
+        if (env.HERDR_ENV !== '1')
+            return;
+        // Resolve inherited pane context, including panes moved since launch.
+        if (!env.HERDR_PANE_ID)
+            fail('Herdr tab name sync requires caller pane identity');
+        const data = JSON.parse(await exec('herdr', ['pane', 'current', '--current']));
+        const tab = data.result?.pane?.tab_id;
+        if (typeof tab !== 'string')
+            fail('Herdr current-pane response missing tab_id; tab name not synchronized');
+        await exec('herdr', ['tab', 'rename', tab, name]);
+    }
+    return { launch, syncName };
+}
+//# sourceMappingURL=launcher.js.map

package/dist/launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.js","sourceRoot":"","sources":["../src/launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAInC,MAAM,CAAC,MAAM,GAAG,GAAQ,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;IAC3C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;IACxH,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AACF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;AAC7E,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC;AAClF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAQ7F,MAAM,UAAU,SAAS,CAAC,OAAwB;IAChD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IAClE,KAAK,UAAU,MAAM,CAAC,OAAsB;QAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;QACtD,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,OAAO;YAAE,IAAI,CAAC,0CAA0C,CAAC,CAAC;QACnG,IAAI,QAAQ,KAAK,OAAO,IAAI,OAAO,CAAC,WAAW,KAAK,MAAM;YAAE,IAAI,CAAC,mFAAmF,CAAC,CAAC;QACtJ,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,SAAS,CAAC;YAAE,IAAI,CAAC,sIAAsI,CAAC,CAAC;QACpO,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvG,IAAI,OAAO,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,SAAS,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,kBAAkB;gBAAE,IAAI,CAAC,sFAAsF,CAAC,CAAC;YACnJ,IAAI,OAAqF,CAAC;YAC1F,IAAI,CAAC;gBAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,CAAC,kBAAkB,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,sBAAsB,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;YAAC,CAAC;YACnL,OAAO,CAAC,EAAE,CAAC;gBAAC,IAAI,CAAC,4BAA4B,MAAM,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC;YAAC,CAAC;YACpF,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC;YACnF,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG;gBAAE,IAAI,CAAC,wFAAwF,CAAC,CAAC;YAClH,wEAAwE;YACxE,4EAA4E;YAC5E,yEAAyE;YACzE,4EAA4E;YAC5E,MAAM,MAAM,GAAG,4DAA4D,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,qDAAqD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,qFAAqF,CAAC;YACrQ,MAAM,OAAO,GAAG,QAAQ,KAAK,OAAO;gBAClC,CAAC,CAAC,qEAAqE,OAAO,CAAC,MAAM,CAAC,EAAE;gBACxF,CAAC,CAAC,SAAS,OAAO,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/F,IAAI,CAAC;gBAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;YAAC,CAAC;YAC5D,OAAO,CAAC,EAAE,CAAC;gBAAC,IAAI,CAAC,6CAA6C,GAAG,UAAU,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,kEAAkE,CAAC,CAAC;YAAC,CAAC;YACnK,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,iDAAiD,EAAE,mBAAmB,EAAE,KAAK,EAAE,CAAC;QAC3I,CAAC;QACD,IAAI,OAAO,CAAC,WAAW,KAAK,MAAM;YAAE,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACpE,2EAA2E;QAC3E,yFAAyF;QACzF,MAAM,KAAK,GAAG,gNAAgN,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,qDAAqD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,qFAAqF,CAAC;QACxZ,MAAM,KAAK,GAAG,gKAAgK,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,6DAA6D,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,wCAAwC,CAAC;QAC/T,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAClH,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;YAAE,IAAI,CAAC,iEAAiE,CAAC,CAAC;QAChH,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,6DAA6D,EAAE,mBAAmB,EAAE,KAAK,EAAE,CAAC;IACjJ,CAAC;IACD,KAAK,UAAU,QAAQ,CAAC,IAAY;QAClC,IAAI,GAAG,CAAC,SAAS,KAAK,GAAG;YAAE,OAAO;QAClC,sEAAsE;QACtE,IAAI,CAAC,GAAG,CAAC,aAAa;YAAE,IAAI,CAAC,mDAAmD,CAAC,CAAC;QAClF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAC/E,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC;QACtC,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,IAAI,CAAC,uEAAuE,CAAC,CAAC;QAC3G,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC"}

package/dist/monitor-launcher.d.ts

@@ -0,0 +1,17 @@
+import { type Run } from './launcher.js';
+export interface MonitorLaunchOptions {
+    root: string;
+    sessionId: string;
+    script: string;
+    node?: string;
+    platform?: string;
+    env?: NodeJS.ProcessEnv;
+    run?: Run;
+    assertCurrent?(): void;
+}
+/** Pane ownership is separate from agent config. Pending records fence uncertain
+ * mutations across reloads; neither errors nor absence of readiness cause retries. */
+export declare function ensureMonitorPane(options: MonitorLaunchOptions): Promise<{
+    outcome: string;
+    pane?: string;
+}>;

package/dist/monitor-launcher.js

@@ -0,0 +1,136 @@
+import path from 'node:path';
+import { createHash, randomUUID } from 'node:crypto';
+import { access, mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
+import { run, shQuote, psQuote, encoded } from './launcher.js';
+/** Pane ownership is separate from agent config. Pending records fence uncertain
+ * mutations across reloads; neither errors nor absence of readiness cause retries. */
+export async function ensureMonitorPane(options) {
+    const env = options.env ?? process.env;
+    if (env.HERDR_ENV !== '1')
+        return { outcome: 'unavailable: coordinator is not inside Herdr' };
+    if (!env.HERDR_PANE_ID)
+        throw new Error('Monitor requires caller pane identity; no focused-pane fallback');
+    const platform = options.platform ?? process.platform;
+    if (!['win32', 'linux'].includes(platform))
+        throw new Error('Monitor launcher supports Windows/Linux only');
+    const exec = options.run ?? run;
+    const check = () => options.assertCurrent?.();
+    const call = async (args) => {
+        check();
+        const output = await exec('herdr', args);
+        check();
+        // pane run acknowledges command submission with an empty stdout on current Herdr.
+        if (!output.trim() && args[1] === 'run')
+            return {};
+        return JSON.parse(output).result;
+    };
+    const caller = (await call(['pane', 'current', '--current']))?.pane;
+    if (!caller?.pane_id || !caller.tab_id || !caller.workspace_id)
+        throw new Error('Missing current Herdr pane identity');
+    const label = 'Intercom monitor';
+    const legacyMarker = `Intercom monitor [${options.sessionId}]`;
+    const key = createHash('sha256').update(options.sessionId).digest('hex').slice(0, 24);
+    const directory = path.join(options.root, '.pi-intercom');
+    await mkdir(directory, { recursive: true });
+    const file = path.join(directory, `monitor-${key}.json`), lock = `${file}.lock`;
+    check();
+    try {
+        await writeFile(lock, '', { flag: 'wx', mode: 0o600 });
+    }
+    catch {
+        throw new Error(`Monitor launch locked; inspect ${lock} before recovery. No pane created.`);
+    }
+    let state;
+    const save = async () => {
+        const temporary = `${file}.${randomUUID()}.tmp`;
+        try {
+            await writeFile(temporary, JSON.stringify(state), { flag: 'wx', mode: 0o600 });
+            await rename(temporary, file);
+        }
+        finally {
+            await unlink(temporary).catch(() => { });
+        }
+    };
+    try {
+        try {
+            state = JSON.parse(await readFile(file, 'utf8'));
+            if (state?.version !== 1 || state.sessionId !== options.sessionId || typeof state.stage !== 'string')
+                throw new Error('Invalid monitor ownership record');
+        }
+        catch (e) {
+            if (e.code !== 'ENOENT')
+                throw e;
+        }
+        const panes = (await call(['pane', 'list', '--workspace', caller.workspace_id]))?.panes;
+        if (!Array.isArray(panes) || panes.some(p => !p?.pane_id || !p.tab_id))
+            throw new Error('Invalid Herdr pane inventory');
+        const matches = panes.filter(p => p.label === legacyMarker ||
+            (state && state.workspace === caller.workspace_id && state.pane === p.pane_id));
+        if (matches.length > 1)
+            throw new Error('Multiple monitor markers; inspect panes. No automatic changes.');
+        if (matches.length === 1) {
+            const pane = matches[0];
+            if (pane.pane_id === caller.pane_id || pane.tab_id !== caller.tab_id)
+                throw new Error('Monitor marker is on caller or moved to another tab; no duplicate created');
+            if (state && (state.workspace !== caller.workspace_id || state.caller !== caller.pane_id || (state.pane && state.pane !== pane.pane_id))) {
+                throw new Error('Monitor ownership differs from current caller; no automatic changes');
+            }
+            if (state && !['submitted', 'observed'].includes(state.stage)) {
+                throw new Error(`Monitor partial launch needs inspection (${state.stage}); no retry or duplicate`);
+            }
+            if (!state) {
+                state = { version: 1, sessionId: options.sessionId, workspace: caller.workspace_id, caller: caller.pane_id, pane: pane.pane_id, stage: 'observed' };
+                await save();
+            }
+            if (pane.label !== label)
+                await call(['pane', 'rename', pane.pane_id, label]);
+            return { outcome: 'existing pane preserved; process readiness not checked', pane: pane.pane_id };
+        }
+        if (panes.some(p => p.tab_id === caller.tab_id && p.label === label)) {
+            throw new Error('Unowned monitor label in coordinator tab; inspect before creating another pane');
+        }
+        if (state && (!['submitted', 'observed'].includes(state.stage) || state.workspace !== caller.workspace_id || panes.some(p => p.pane_id === state.pane))) {
+            throw new Error(`Monitor ownership/partial launch needs inspection (${state.stage}, pane ${state.pane ?? 'unknown'}); no retry or duplicate`);
+        }
+        await access(options.script); // Missing build must not leave a new empty pane.
+        check();
+        state = { version: 1, sessionId: options.sessionId, workspace: caller.workspace_id, caller: caller.pane_id, stage: 'split_pending' };
+        await save();
+        // Small top quarter after swapping pane identities. Verify actual geometry below.
+        const split = await call(['pane', 'split', '--pane', caller.pane_id, '--direction', 'down', '--ratio', '0.25', '--cwd', options.root, '--no-focus']);
+        const pane = split?.pane?.pane_id;
+        if (typeof pane !== 'string' || pane === caller.pane_id)
+            throw new Error('Split returned no distinct pane ID');
+        state.pane = pane;
+        state.stage = 'rename_pending';
+        await save();
+        await call(['pane', 'rename', pane, label]);
+        state.stage = 'swap_pending';
+        await save();
+        const swapped = await call(['pane', 'swap', '--source-pane', caller.pane_id, '--target-pane', pane]);
+        if (swapped?.swap?.changed !== true)
+            throw new Error('Herdr did not confirm pane swap');
+        const layout = (await call(['pane', 'layout', '--pane', caller.pane_id]))?.layout;
+        const top = layout?.panes?.find((p) => p.pane_id === pane)?.rect;
+        const bottom = layout?.panes?.find((p) => p.pane_id === caller.pane_id)?.rect;
+        if (!top || !bottom || top.y >= bottom.y || layout.focused_pane_id !== caller.pane_id)
+            throw new Error('Monitor geometry/focus not confirmed; inspect panes before recovery');
+        state.stage = 'run_pending';
+        await save();
+        const args = [options.script, '--root', options.root];
+        const command = platform === 'win32'
+            ? `powershell.exe -NoProfile -ExecutionPolicy Bypass -EncodedCommand ${encoded(`& ${psQuote(options.node ?? process.execPath)} ${args.map(psQuote).join(' ')}`)}`
+            : `sh -c ${shQuote(`exec ${shQuote(options.node ?? process.execPath)} ${args.map(shQuote).join(' ')}`)}`;
+        await call(['pane', 'run', pane, command]);
+        state.stage = 'submitted';
+        await save();
+        return { outcome: 'command submitted; monitor readiness not awaited', pane };
+    }
+    catch (e) {
+        throw new Error(`Intercom monitor: ${String(e)}. Pane ${state?.pane ?? 'unknown'} may remain; no automatic cleanup.`);
+    }
+    finally {
+        await unlink(lock).catch(() => { });
+    }
+}
+//# sourceMappingURL=monitor-launcher.js.map

package/dist/monitor-launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor-launcher.js","sourceRoot":"","sources":["../src/monitor-launcher.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAY,MAAM,eAAe,CAAC;AASzE;sFACsF;AACtF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA6B;IACnE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,IAAI,GAAG,CAAC,SAAS,KAAK,GAAG;QAAE,OAAO,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC;IAC9F,IAAI,CAAC,GAAG,CAAC,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IAC3G,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACtD,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC5G,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC;IAChC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,KAAK,EAAE,IAAc,EAAE,EAAE;QACpC,KAAK,EAAE,CAAC;QACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACzC,KAAK,EAAE,CAAC;QACR,kFAAkF;QAClF,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK;YAAE,OAAO,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;IACnC,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,IAAY,CAAC;IAC5E,IAAI,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACvH,MAAM,KAAK,GAAG,kBAAkB,CAAC;IACjC,MAAM,YAAY,GAAG,qBAAqB,OAAO,CAAC,SAAS,GAAG,CAAC;IAC/D,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtF,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAC1D,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,OAAO,CAAC,EAAE,IAAI,GAAG,GAAG,IAAI,OAAO,CAAC;IAChF,KAAK,EAAE,CAAC;IACR,IAAI,CAAC;QAAC,MAAM,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAAC,CAAC;IAC/D,MAAM,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,oCAAoC,CAAC,CAAC;IAAC,CAAC;IACtG,IAAI,KAA8B,CAAC;IACnC,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;QACtB,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,UAAU,EAAE,MAAM,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/E,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC;gBAAS,CAAC;YAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAAC,CAAC;IACxD,CAAC,CAAC;IACF,IAAI,CAAC;QACH,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;YACjD,IAAI,KAAK,EAAE,OAAO,KAAK,CAAC,IAAI,KAAK,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAC5J,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YAAC,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,CAAC,CAAC;QAAC,CAAC;QAC5E,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,KAAe,CAAC;QAClG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACxH,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,YAAY;YACxD,CAAC,KAAK,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QAClF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QAC1G,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACxB,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;YACnK,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,YAAY,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;gBACzI,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;YACzF,CAAC;YACD,IAAI,KAAK,IAAI,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9D,MAAM,IAAI,KAAK,CAAC,4CAA4C,KAAK,CAAC,KAAK,0BAA0B,CAAC,CAAC;YACrG,CAAC;YACD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,KAAK,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;gBACpJ,MAAM,IAAI,EAAE,CAAC;YACf,CAAC;YACD,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK;gBAAE,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAC9E,OAAO,EAAE,OAAO,EAAE,wDAAwD,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACnG,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;QACpG,CAAC;QACD,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,YAAY,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACzJ,MAAM,IAAI,KAAK,CAAC,sDAAsD,KAAK,CAAC,KAAK,UAAU,KAAK,CAAC,IAAI,IAAI,SAAS,0BAA0B,CAAC,CAAC;QAChJ,CAAC;QACD,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,iDAAiD;QAC/E,KAAK,EAAE,CAAC;QACR,KAAK,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;QACrI,MAAM,IAAI,EAAE,CAAC;QACb,kFAAkF;QAClF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC;QACrJ,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC;QAClC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC/G,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,KAAK,GAAG,gBAAgB,CAAC;QAAC,MAAM,IAAI,EAAE,CAAC;QAChE,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAC5C,KAAK,CAAC,KAAK,GAAG,cAAc,CAAC;QAAC,MAAM,IAAI,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC,CAAC;QACrG,IAAI,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACxF,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAClF,MAAM,GAAG,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAsB,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,EAAE,IAAI,CAAC;QACtF,MAAM,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAsB,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC;QACnG,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,eAAe,KAAK,MAAM,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;QAC9K,KAAK,CAAC,KAAK,GAAG,aAAa,CAAC;QAAC,MAAM,IAAI,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,OAAO,GAAG,QAAQ,KAAK,OAAO;YAClC,CAAC,CAAC,qEAAqE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;YACjK,CAAC,CAAC,SAAS,OAAO,CAAC,QAAQ,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3G,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QAC3C,KAAK,CAAC,KAAK,GAAG,WAAW,CAAC;QAAC,MAAM,IAAI,EAAE,CAAC;QACxC,OAAO,EAAE,OAAO,EAAE,kDAAkD,EAAE,IAAI,EAAE,CAAC;IAC/E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,CAAC,CAAC,UAAU,KAAK,EAAE,IAAI,IAAI,SAAS,oCAAoC,CAAC,CAAC;IACxH,CAAC;YAAS,CAAC;QAAC,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAAC,CAAC;AACnD,CAAC"}

package/dist/monitor-view.d.ts

@@ -0,0 +1,6 @@
+import type { ObservationSnapshot } from './snapshot.js';
+/** Presentation only. All user-controlled text is sanitized before trusted ANSI styling. */
+export declare function renderMonitor(snapshot: ObservationSnapshot | undefined, width: number, height: number, now?: number, color?: boolean, options?: {
+    selectedIndex?: number;
+    details?: boolean;
+}): string[];

package/dist/monitor-view.js

@@ -0,0 +1,134 @@
+import { stripVTControlCharacters } from 'node:util';
+import { truncateToWidth, visibleWidth } from 'pi-intercom-tui';
+import { workerObservation } from './worker-status.js';
+const safe = (value) => stripVTControlCharacters(value).replace(/[\x00-\x1f\x7f-\x9f\u2028-\u202e\u2066-\u2069]/g, ' ');
+const clip = (value, width) => stripVTControlCharacters(truncateToWidth(safe(value), Math.max(0, width)));
+const cell = (value, width) => {
+    const text = clip(value, width);
+    return text + ' '.repeat(Math.max(0, width - visibleWidth(text)));
+};
+const ageLabel = (milliseconds) => {
+    const seconds = Math.floor(milliseconds / 1000);
+    if (seconds < 60)
+        return `${seconds}s ago`;
+    if (seconds < 3600)
+        return `${Math.floor(seconds / 60)}m ago`;
+    if (seconds < 86400)
+        return `${Math.floor(seconds / 3600)}h ago`;
+    return `${Math.floor(seconds / 86400)}d ago`;
+};
+const reportLabels = {
+    blocked: 'Blocked', needs_decision: 'Needs decision', ready_for_review: 'Ready for review',
+};
+// Wrap only sanitized grapheme clusters, bounded by the terminal's remaining rows.
+function wrapSummary(value, width, rows) {
+    if (width <= 0 || rows <= 0)
+        return [];
+    const result = [];
+    let current = '';
+    for (const { segment } of new Intl.Segmenter(undefined, { granularity: 'grapheme' }).segment(safe(value))) {
+        if (visibleWidth(current + segment) > width) {
+            if (current)
+                result.push(current);
+            current = '';
+            if (result.length >= rows)
+                break;
+        }
+        current += visibleWidth(segment) <= width ? segment : clip(segment, width);
+    }
+    if (current && result.length < rows)
+        result.push(current);
+    return result;
+}
+/** Presentation only. All user-controlled text is sanitized before trusted ANSI styling. */
+export function renderMonitor(snapshot, width, height, now = Date.now(), color = false, options = {}) {
+    width = Math.max(0, Math.min(1000, Math.floor(width)));
+    height = Math.max(0, Math.min(1000, Math.floor(height)));
+    if (!width || !height)
+        return [];
+    const paint = (code, text) => color ? `\x1b[${code}m${text}\x1b[0m` : text;
+    const dim = (text) => paint('90', text);
+    const line = (text) => clip(text, width);
+    const lines = [];
+    if (!snapshot?.config) {
+        lines.push(paint('33', line('  Status unavailable — waiting for local observations')));
+    }
+    else {
+        const workers = snapshot.config.agents.filter(agent => !agent.coordinator);
+        // Report remains distinct from observed status; last activity gives way first.
+        const wide = width >= 100;
+        const nameWidth = wide ? Math.min(22, Math.max(10, width - 88)) : 10;
+        const activityWidth = wide ? 12 : 8, ageWidth = 16, reportWidth = 16;
+        const table = (name, activity, age, detail, report = '—', tone = '90', selected = false) => {
+            const prefix = `${selected ? '› ' : '  '}${cell(name, nameWidth)}  ${cell(age, ageWidth)}  `;
+            const status = cell(activity, activityWidth);
+            const tail = `  ${cell(report, reportWidth)}${wide ? `  ${detail}` : ''}`;
+            // Clip as plain text first; no untrusted escape sequences enter the output.
+            if (!color)
+                return line(prefix + status + tail);
+            const namePart = clip(prefix, width);
+            const statusRoom = Math.max(0, width - visibleWidth(namePart));
+            const statusPart = clip(status, statusRoom);
+            const tailRoom = Math.max(0, statusRoom - visibleWidth(statusPart));
+            return (selected ? paint('1;36', namePart) : namePart) + paint(tone, statusPart) + dim(clip(tail, tailRoom));
+        };
+        lines.push(paint('1', table('Worker', 'Status', 'Seen', 'Last activity', 'Report')));
+        lines.push(dim(line('  ' + '─'.repeat(Math.max(0, width - 2)))));
+        const selectedIndex = Math.min(workers.length - 1, Math.max(-1, options.selectedIndex ?? -1));
+        const showDetails = Boolean(options.details && selectedIndex >= 0 && height >= 8);
+        const selectedReport = snapshot.reports?.find(report => report.sessionId === workers[selectedIndex]?.sessionId && reportLabels[report.status]);
+        const detailBudget = showDetails ? Math.min(selectedReport ? 12 : 5, height - 5) : 0;
+        const available = Math.max(0, height - lines.length - 2 - detailBudget);
+        const needsOverflow = workers.length > available;
+        const count = Math.min(workers.length, Math.max(0, available - (needsOverflow && available > 1 ? 1 : 0)));
+        const start = Math.max(0, Math.min(Math.max(0, workers.length - count), selectedIndex - count + 1));
+        let selectedDetail = [];
+        for (const [offset, worker] of workers.slice(start, start + count).entries()) {
+            const observation = workerObservation(snapshot, worker.sessionId, now);
+            const activity = observation.observedStatus, evidence = observation.lastActivity;
+            const age = observation.observationAgeSeconds === null ? '—' : ageLabel(observation.observationAgeSeconds * 1000) + (observation.stale ? ' (old)' : '');
+            const tone = observation.stale ? '90' : activity === 'thinking' ? '35' : activity === 'working' ? '36' : activity === 'idle' ? '32' : '90';
+            const selected = start + offset === selectedIndex;
+            const report = snapshot.reports?.find(report => report.sessionId === worker.sessionId && reportLabels[report.status]);
+            lines.push(table(worker.name, activity, age, evidence, report ? reportLabels[report.status] : '—', tone, selected));
+            if (selected && showDetails && report) {
+                const elapsed = now - Date.parse(report.updatedAt);
+                const reportAge = !Number.isFinite(elapsed) || elapsed < 0 ? 'clock uncertain' : ageLabel(elapsed) + (elapsed > snapshot.staleAfterMs ? ' (old)' : '');
+                const contextRows = detailBudget >= 5 ? [
+                    ...(detailBudget >= 6 ? [paint('1', line(`  ${worker.name}`))] : []),
+                    line(`  Responsibility: ${worker.description || 'Not specified'}`),
+                    line(`  Observed status: ${activity} · ${age}`),
+                ] : [];
+                selectedDetail = [
+                    ...contextRows,
+                    line(`  Report: ${reportLabels[report.status]} · ${reportAge}`),
+                    line('  Self-reported, pending review'),
+                    ...wrapSummary(`Summary: ${report.summary}`, Math.max(0, width - 2), Math.max(0, detailBudget - 2 - contextRows.length)).map(text => line(`  ${text}`)),
+                ];
+            }
+            else if (selected && showDetails)
+                selectedDetail = [
+                    dim(line('  ' + '─'.repeat(Math.max(0, width - 2)))),
+                    paint('1', line(`  ${worker.name}`)),
+                    line(`  Responsibility: ${worker.description || 'Not specified'}`),
+                    line(`  Observed status: ${activity} · ${age}`),
+                    line(`  Last activity: ${evidence}`),
+                ];
+        }
+        if (workers.length > count && available > count)
+            lines.push(dim(line(`  ${workers.length - count} more · rows ${count ? start + 1 : 0}–${start + count} of ${workers.length} · ↑↓ to browse`)));
+        lines.push(...(selectedReport ? selectedDetail.slice(0, detailBudget) : selectedDetail.slice(-detailBudget || selectedDetail.length)));
+        if (!workers.length && available)
+            lines.push(dim(line('  No workers configured yet')));
+    }
+    // Anchor the hint at the bottom; do not fill the pane with decorative boxes.
+    const partial = snapshot && (snapshot.truncated || snapshot.errors.length);
+    const controls = options.details ? 'q quit · Esc back · ↑↓ select' : 'q quit · ↑↓ select · Enter details';
+    const hasReports = snapshot?.reports?.some(report => reportLabels[report.status] && snapshot.config?.agents.some(agent => !agent.coordinator && agent.sessionId === report.sessionId));
+    const footer = width < 18 ? 'q quit' : `  ${controls}${partial ? ' · Partial observations' : ''}${hasReports ? ' · Reports: self-reported, pending review' : ''}`;
+    while (lines.length < height - 1)
+        lines.push('');
+    lines.push(dim(line(footer)));
+    return lines.slice(0, height);
+}
+//# sourceMappingURL=monitor-view.js.map