@zergai/ztc 0.3.0-beta.1 → 0.4.0-beta.1

package/dist/ui/ratatui/protocol.d.ts

@@ -28,6 +28,7 @@ export interface TranscriptAnchor {
     line_offset: number;
 }
 /** Capability strings advertised by zmux/ztc-tui on the `Ready` event. */
+export declare const CAPABILITY_PANE_DELIVERY_ACK = "pane_delivery_ack_v1";
 export declare const CAPABILITY_SCROLLBACK_ANCHOR = "scrollback_anchor";
 export declare const CAPABILITY_DESKTOP_UPDATE_RESTART = "desktop_update_restart_v1";
 export declare const CAPABILITY_CLIPBOARD_IMAGE = "clipboard_image";
@@ -158,12 +159,14 @@ export type RustCommand = {
     target?: number;
 } | {
     type: 'read_pane';
+    request_id?: string;
     pane_id: number;
     lines?: number;
     viewport?: boolean;
     ansi?: boolean;
 } | {
     type: 'write_pane';
+    request_id?: string;
     pane_id: number;
     input: string;
     submit?: boolean;
@@ -356,8 +359,22 @@ export type RustEvent = {
     type: 'session_restored';
     restored_panes: number;
     skipped_panes: number;
+} | {
+    type: 'pane_write_result';
+    request_id?: string;
+    pane_id: number;
+    delivered: boolean;
+    queued?: boolean;
+    encoding_pending?: boolean;
+    delivered_bytes?: number;
+    total_bytes?: number;
+    partial?: boolean;
+    cancelled?: boolean;
+    error?: string;
 } | {
     type: 'pane_read';
+    request_id?: string;
+    error?: string;
     pane_id: number;
     content: string;
     viewport?: boolean;

package/dist/ui/ratatui/protocol.js

@@ -5,6 +5,7 @@
  * Shared by both ztc-tui (inline viewport) and zmux (fullscreen multiplexer).
  */
 /** Capability strings advertised by zmux/ztc-tui on the `Ready` event. */
+export const CAPABILITY_PANE_DELIVERY_ACK = 'pane_delivery_ack_v1';
 export const CAPABILITY_SCROLLBACK_ANCHOR = 'scrollback_anchor';
 export const CAPABILITY_DESKTOP_UPDATE_RESTART = 'desktop_update_restart_v1';
 export const CAPABILITY_CLIPBOARD_IMAGE = 'clipboard_image';

package/dist/utils/shell.d.ts

@@ -18,6 +18,8 @@ export type RunShellCommandOptions = SandboxCommandOptions & {
     temporaryWriteRoot?: string;
     /** Text written verbatim to the command's stdin (avoids shell quoting). */
     stdin?: string;
+    noTimeout?: boolean;
+    onOutput?: (stream: 'stdout' | 'stderr', chunk: string) => void;
 };
 /**
  * Terminate every live shell-tool child group with `signal` and return the pids

package/dist/utils/shell.js

@@ -157,7 +157,7 @@ export async function runShellCommand(command, cwd, signal, timeoutMs, sandboxOp
         throw new Error(`Command rejected for safety reasons: ${describeSafetyRule(verdict.rule)} (target: ${verdict.token}). `
             + `[safety rule=${verdict.rule} token=${verdict.token}]`);
     }
-    const { env, temporaryWriteRoot, stdin, ...sandboxCommandOptions } = sandboxOptions ?? {};
+    const { env, temporaryWriteRoot, stdin, noTimeout, onOutput, ...sandboxCommandOptions } = sandboxOptions ?? {};
     const subprocessEnv = env
         ?? (temporaryWriteRoot === undefined
             ? buildUserSubprocessEnv()
@@ -201,7 +201,15 @@ export async function runShellCommand(command, cwd, signal, timeoutMs, sandboxOp
         let stderrOverflow = false;
         let timedOut = false;
         let cancelled = false;
+        let outputError;
         child.stdout?.on('data', (chunk) => {
+            try {
+                onOutput?.('stdout', chunk);
+            }
+            catch (error) {
+                outputError = error;
+                onAbort();
+            }
             if (stdout.length >= MAX_OUTPUT) {
                 stdoutOverflow = true;
                 return;
@@ -213,6 +221,13 @@ export async function runShellCommand(command, cwd, signal, timeoutMs, sandboxOp
             }
         });
         child.stderr?.on('data', (chunk) => {
+            try {
+                onOutput?.('stderr', chunk);
+            }
+            catch (error) {
+                outputError = error;
+                onAbort();
+            }
             if (stderr.length >= MAX_OUTPUT) {
                 stderrOverflow = true;
                 return;
@@ -224,16 +239,32 @@ export async function runShellCommand(command, cwd, signal, timeoutMs, sandboxOp
             }
         });
         let killTimer = null;
+        let termination;
         const escalateKill = () => {
-            if (child.pid)
-                killGroup(child.pid, 'SIGTERM');
-            killTimer = setTimeout(() => {
-                if (child.pid && child.exitCode === null && child.signalCode === null) {
-                    killGroup(child.pid, 'SIGKILL');
-                }
-            }, 250);
+            if (termination)
+                return;
+            termination = new Promise(resolve => {
+                if (child.pid)
+                    killGroup(child.pid, 'SIGTERM');
+                killTimer = setTimeout(() => {
+                    if (child.pid) {
+                        // The leader may already have exited while descendants still own
+                        // the group. Never fall back to a potentially recycled leader PID.
+                        if (process.platform !== 'win32') {
+                            try {
+                                process.kill(-child.pid, 'SIGKILL');
+                            }
+                            catch { /* group already exited */ }
+                        }
+                        else if (child.exitCode === null && child.signalCode === null) {
+                            killGroup(child.pid, 'SIGKILL');
+                        }
+                    }
+                    resolve();
+                }, 250);
+            });
         };
-        const timeoutHandle = setTimeout(() => { timedOut = true; escalateKill(); }, timeout);
+        const timeoutHandle = noTimeout ? undefined : setTimeout(() => { timedOut = true; escalateKill(); }, timeout);
         const onAbort = () => { cancelled = true; escalateKill(); };
         if (signal)
             signal.addEventListener('abort', onAbort, { once: true });
@@ -261,7 +292,13 @@ export async function runShellCommand(command, cwd, signal, timeoutMs, sandboxOp
             cleanup();
             rejectResult(e);
         };
-        child.on('error', (err) => {
+        child.on('error', async (err) => {
+            if (termination)
+                await termination;
+            if (outputError) {
+                settleReject(outputError);
+                return;
+            }
             if (cancelled) {
                 settleReject(new Error('Command cancelled'));
                 return;
@@ -275,7 +312,13 @@ export async function runShellCommand(command, cwd, signal, timeoutMs, sandboxOp
                 truncated: stdoutOverflow || stderrOverflow,
             });
         });
-        child.on('close', (code, sig) => {
+        child.on('close', async (code, sig) => {
+            if (termination)
+                await termination;
+            if (outputError) {
+                settleReject(outputError);
+                return;
+            }
             if (cancelled) {
                 settleReject(new Error('Command cancelled'));
                 return;

package/dist/web/mirror_stream.d.ts

@@ -18,7 +18,7 @@ import type { SlashCommandUsage } from '../agent/commands/index.js';
 import type { MessageAttachment, MessageInput } from '../types.js';
 import type { HostedSessionSettings } from '../hosted/session_settings.js';
 import { type PaneStateUpdate } from './pane_registry.js';
-export type MirrorEventType = 'message' | 'stream_start' | 'reasoning_delta' | 'stream_delta' | 'stream_end' | 'tool_call' | 'tool_result' | 'status' | 'token_usage' | 'error' | 'cancel' | 'mode_change' | 'pane_info' | 'pane_output' | 'zde_lite_state' | 'session_end' | 'reload' | 'clear' | 'todo_list' | 'prompt_entry' | 'ask_user' | 'queue_state' | 'accounts' | 'open_accounts' | 'hook_approval_request' | 'widget_prompt' | 'widget_select' | 'widget_questionnaire' | 'widget_dismiss' | 'widget_settings' | 'context_progress_bar_config' | 'zlicky_cursor' | 'zlicky_highlight' | 'zlicky_clear' | 'zlicky_status' | 'zlicky_capture_request' | 'cv_run_start' | 'cv_run_tick' | 'cv_run_end' | 'cv_diagnose_start' | 'cv_diagnose_classification' | 'cv_diagnose_proposal' | 'cv_diagnose_pr_opened' | 'cv_diagnose_end' | (string & {});
+export type MirrorEventType = 'message' | 'stream_start' | 'reasoning_delta' | 'stream_delta' | 'stream_end' | 'tool_call' | 'tool_result' | 'status' | 'token_usage' | 'error' | 'cancel' | 'mode_change' | 'pane_info' | 'pane_output' | 'zde_lite_state' | 'session_end' | 'reload' | 'clear' | 'todo_list' | 'prompt_entry' | 'ask_user' | 'queue_state' | 'command_jobs' | 'accounts' | 'open_accounts' | 'hook_approval_request' | 'widget_prompt' | 'widget_select' | 'widget_questionnaire' | 'widget_dismiss' | 'widget_settings' | 'context_progress_bar_config' | 'zlicky_cursor' | 'zlicky_highlight' | 'zlicky_clear' | 'zlicky_status' | 'zlicky_capture_request' | 'cv_run_start' | 'cv_run_tick' | 'cv_run_end' | 'cv_diagnose_start' | 'cv_diagnose_classification' | 'cv_diagnose_proposal' | 'cv_diagnose_pr_opened' | 'cv_diagnose_end' | (string & {});
 export interface MirrorEvent {
     type: MirrorEventType;
     timestamp: string;
@@ -199,6 +199,7 @@ export interface MirrorPaneViewportResult {
     error?: string;
 }
 export interface MirrorPaneRecord {
+    commandJobs?: import('../agent/runtime/command_jobs.js').CommandReceipt[];
     title?: string;
     paneType?: string;
     provider?: string;

package/dist/web/mirror_stream.js

@@ -2826,6 +2826,13 @@ export class MirrorStreamServer {
             // Replay cached pane content that may have been evicted from event history,
             // so new clients always see it regardless of history depth.
             for (const [pid, info] of this.panes.entries()) {
+                if (info.commandJobs) {
+                    res.write(`data: ${JSON.stringify({
+                        type: 'command_jobs',
+                        timestamp: new Date().toISOString(),
+                        data: { pane_id: pid, jobs: info.commandJobs },
+                    })}\n\n`);
+                }
                 if ((info.paneType === 'doc' || info.paneType === 'feed') && info.docContent) {
                     res.write(`data: ${JSON.stringify({
                         type: 'pane_output',

package/dist/web/pane_registry.js

@@ -95,6 +95,7 @@ export class PaneRegistry {
                 provider: prev?.provider,
                 model: prev?.model,
                 status: prev?.status,
+                commandJobs: prev?.commandJobs,
                 // Preserve cached content across a relayout — SSE reconnect replay
                 // (publishPaneInfo → doc/terminal snapshots) depends on it; a bare
                 // relayout must not blank a pane until its next output event.
@@ -114,19 +115,24 @@ export class PaneRegistry {
             });
         }
         if (!next.has(0)) {
-            next.set(0, { title: 'Overseer', paneType: 'ztc', isVisible: true });
+            next.set(0, { ...this.panes.get(0), title: 'Overseer', paneType: 'ztc', isVisible: true });
         }
         this.panes = next;
     }
     /** Derive runtime status + cache pane content from a published event. */
     applyEvent(event) {
-        const paneId = typeof event.data.pane_id === 'number' ? event.data.pane_id : undefined;
+        const paneId = typeof event.data.pane_id === 'number' ? event.data.pane_id : event.type === 'command_jobs' ? 0 : undefined;
         if (paneId === undefined)
             return;
+        if (paneId === 0 && event.type === 'command_jobs')
+            this.ensureOverseer();
         const pane = this.panes.get(paneId);
         if (!pane)
             return;
         switch (event.type) {
+            case 'command_jobs':
+                pane.commandJobs = Array.isArray(event.data.jobs) ? event.data.jobs.slice(0, 60) : [];
+                break;
             case 'stream_start':
                 pane.status = 'streaming';
                 break;

package/dist/web/view_plugin.d.ts

@@ -5,6 +5,7 @@
  * Domain modules (Colony, monitoring dashboards, etc.) extend it
  * by implementing this interface and registering via registerViewPlugin().
  */
+export type { CommandReceipt as CommandJobView } from '../agent/runtime/command_jobs.js';
 import type { IncomingMessage, ServerResponse } from 'http';
 import type { MirrorEvent, MirrorPaneRecord } from './mirror_stream.js';
 /**