@qduc/term2 0.27.0 → 0.28.0

package/dist/services/control-socket/control-command.js

@@ -0,0 +1,161 @@
+import { connect } from 'node:net';
+import { once } from 'node:events';
+import path from 'node:path';
+import { CONTROL_PROTOCOL_VERSION, listControlAdvertisements } from './control-socket.js';
+async function call(socketPath, method, params) {
+    const socket = connect(socketPath);
+    try {
+        await once(socket, 'connect');
+        const read = async () => {
+            let buffered = '';
+            while (!buffered.includes('\n')) {
+                const [chunk] = (await once(socket, 'data'));
+                buffered += chunk.toString('utf8');
+            }
+            const line = buffered.slice(0, buffered.indexOf('\n'));
+            return JSON.parse(line);
+        };
+        socket.write(`${JSON.stringify({ v: CONTROL_PROTOCOL_VERSION, id: 'hello', method: 'hello' })}\n`);
+        const hello = await read();
+        if (!hello.ok)
+            return hello;
+        socket.write(`${JSON.stringify({ v: CONTROL_PROTOCOL_VERSION, id: 'call', method, ...(params ? { params } : {}) })}\n`);
+        return await read();
+    }
+    finally {
+        socket.destroy();
+    }
+}
+function outputResult(output, result, json) {
+    output.write(json
+        ? `${JSON.stringify(result)}\n`
+        : `${Object.entries(result)
+            .map(([key, value]) => `${key}=${value && typeof value === 'object' ? JSON.stringify(value) : String(value)}`)
+            .join(' ')}\n`);
+}
+export async function runControlCommand(argv, stdout, stderr, stdin = process.stdin) {
+    try {
+        return await runControlCommandImpl(argv, stdout, stderr, stdin);
+    }
+    catch (error) {
+        stderr.write(`Control command failed: ${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+}
+async function runControlCommandImpl(argv, stdout, stderr, stdin) {
+    const runtimeDir = process.env.XDG_RUNTIME_DIR;
+    if (!runtimeDir || !path.isAbsolute(runtimeDir)) {
+        stderr.write('Error: XDG_RUNTIME_DIR must be present and absolute.\n');
+        return 1;
+    }
+    const [subcommand, ...rest] = argv;
+    if (subcommand === 'list') {
+        const status = rest.includes('--status');
+        const ads = listControlAdvertisements(runtimeDir);
+        for (const ad of ads) {
+            const value = { ...ad };
+            if (status) {
+                const response = await call(ad.socketPath, 'status');
+                if (response.ok)
+                    Object.assign(value, response.result);
+                else
+                    value.error = response.error?.code ?? 'unavailable';
+            }
+            stdout.write(`${JSON.stringify(value)}\n`);
+        }
+        return 0;
+    }
+    const json = rest.includes('--json');
+    const positional = rest.filter((arg, index) => arg !== '--json' &&
+        !['--id', '--message-id', '--timeout'].includes(arg) &&
+        !['--id', '--message-id', '--timeout'].includes(rest[index - 1] ?? ''));
+    const name = positional[0];
+    const advertisement = name && listControlAdvertisements(runtimeDir).find((item) => item.name === name);
+    if (!advertisement) {
+        stderr.write(`Error: no live control socket named ${name ?? ''}.\n`);
+        return 1;
+    }
+    if (subcommand === 'status' && positional.length === 1) {
+        const response = await call(advertisement.socketPath, 'status');
+        if (!response.ok) {
+            stderr.write(`${response.error?.message ?? response.error?.code ?? 'Control request failed'}\n`);
+            return 1;
+        }
+        outputResult(stdout, response.result, json);
+        return 0;
+    }
+    if (subcommand === 'get' && positional.length === 2) {
+        const response = await call(advertisement.socketPath, 'get', { topic: positional[1] });
+        if (!response.ok) {
+            stderr.write(`${response.error?.message ?? response.error?.code ?? 'Control request failed'}\n`);
+            return 1;
+        }
+        outputResult(stdout, response.result, json);
+        return 0;
+    }
+    if (subcommand === 'submit' || subcommand === 'steer') {
+        const idIndex = rest.indexOf('--id');
+        const requestId = idIndex >= 0 ? rest[idIndex + 1] : undefined;
+        if (!requestId || !/^[A-Za-z0-9_-]{1,256}$/.test(requestId) || positional.length !== 1)
+            return 1;
+        let text = '';
+        for await (const chunk of stdin)
+            text += chunk.toString();
+        if (text.length === 0) {
+            stderr.write('Error: stdin must contain a non-empty message.\n');
+            return 1;
+        }
+        const response = await call(advertisement.socketPath, subcommand, { text, clientRequestId: requestId });
+        if (!response.ok) {
+            stderr.write(`${response.error?.message ?? response.error?.code ?? 'Control request failed'}\n`);
+            return 1;
+        }
+        outputResult(stdout, response.result, json);
+        return 0;
+    }
+    if (subcommand === 'interrupt' && positional.length === 1) {
+        const response = await call(advertisement.socketPath, 'interrupt');
+        if (!response.ok) {
+            stderr.write(`${response.error?.message ?? response.error?.code ?? 'Control request failed'}\n`);
+            return 1;
+        }
+        outputResult(stdout, response.result, json);
+        return 0;
+    }
+    if (subcommand === 'wait-turn') {
+        const messageIndex = rest.indexOf('--message-id');
+        const messageId = messageIndex >= 0 ? rest[messageIndex + 1] : undefined;
+        const timeoutIndex = rest.indexOf('--timeout');
+        const timeoutSeconds = timeoutIndex >= 0 ? Number(rest[timeoutIndex + 1]) : 600;
+        if (!messageId || !Number.isFinite(timeoutSeconds) || timeoutSeconds < 0 || positional.length !== 1)
+            return 1;
+        const deadline = Date.now() + timeoutSeconds * 1000;
+        let firstPoll = true;
+        while (firstPoll || Date.now() <= deadline) {
+            firstPoll = false;
+            const response = await call(advertisement.socketPath, 'status');
+            if (!response.ok) {
+                stderr.write(`${response.error?.message ?? response.error?.code ?? 'Control request failed'}\n`);
+                return 1;
+            }
+            const result = response.result;
+            if (result.phase === 'awaiting_approval') {
+                outputResult(stdout, { status: 'awaiting_approval', messageId }, json);
+                return 3;
+            }
+            const queued = Array.isArray(result.queue) && result.queue.some((item) => item.id === messageId);
+            if (result.phase === 'idle' && !queued) {
+                outputResult(stdout, { status: 'complete', messageId }, json);
+                return 0;
+            }
+            if (Date.now() >= deadline)
+                break;
+            await new Promise((resolve) => setTimeout(resolve, 1000));
+        }
+        outputResult(stdout, { status: 'timeout', messageId }, json);
+        return 2;
+    }
+    stderr.write('Usage: term2 control list [--status] | status <name> [--json] | get <name> <topic> [--json] | submit|steer <name> --id <id> | interrupt <name> | wait-turn <name> --message-id <id>\n');
+    return 1;
+}
+//# sourceMappingURL=control-command.js.map

package/dist/services/control-socket/control-command.js.map

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

package/dist/services/control-socket/control-session-port.d.ts

@@ -0,0 +1,24 @@
+import type { UsageAccumulator } from '../../utils/ai/token-usage.js';
+import type { ConversationOrchestrator } from '../conversation/conversation-orchestrator.js';
+import type { ConversationService } from '../conversation/conversation-service.js';
+import type { SettingsService } from '../settings/settings-service.js';
+import { type ControlSessionPort, type ControlSocketServer } from './control-socket.js';
+export interface ControlSessionMetadata {
+    workspaceRoot: string | null;
+    version: string;
+    createdAt: string;
+    logPath: string;
+}
+export declare function createControlSessionPort(input: {
+    conversationService: ConversationService;
+    orchestrator: ConversationOrchestrator;
+    settingsService: SettingsService;
+    usageAccumulator: UsageAccumulator;
+    controlSocket: ControlSocketServer;
+    addSystemMessage?: (text: string) => void;
+    cancelAskUser?: () => void;
+    stopProcessing?: () => void;
+    stopProcessingWithNotice?: () => void;
+    sessionMetadata: () => ControlSessionMetadata;
+}): ControlSessionPort;
+//# sourceMappingURL=control-session-port.d.ts.map

package/dist/services/control-socket/control-session-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-session-port.d.ts","sourceRoot":"","sources":["../../../source/services/control-socket/control-session-port.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AAC7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAEnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAEzB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,mBAAmB,EAAE,mBAAmB,CAAC;IACzC,YAAY,EAAE,wBAAwB,CAAC;IACvC,eAAe,EAAE,eAAe,CAAC;IACjC,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,aAAa,EAAE,mBAAmB,CAAC;IACnC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,wBAAwB,CAAC,EAAE,MAAM,IAAI,CAAC;IACtC,eAAe,EAAE,MAAM,sBAAsB,CAAC;CAC/C,GAAG,kBAAkB,CAiIrB"}

package/dist/services/control-socket/control-session-port.js

@@ -0,0 +1,185 @@
+import os from 'node:os';
+import process from 'node:process';
+import { getModelContextWindow } from '../../providers/model-catalog/catalog.js';
+import { TOOL_NAME_ASK_USER } from '../../tools/tool-names.js';
+import { getAskUserQuestions } from '../session/pending-interaction-state.js';
+import { projectControlPhase, } from './control-socket.js';
+export function createControlSessionPort(input) {
+    const { conversationService, orchestrator, settingsService, usageAccumulator, controlSocket } = input;
+    const contextWindow = () => {
+        const provider = settingsService.get('agent.provider');
+        const model = settingsService.get('agent.model');
+        return provider && model ? getModelContextWindow(provider, model) ?? null : null;
+    };
+    const toolCalls = () => conversationService.getUnsettledToolExecutions();
+    const mutate = async (text, busyMode, onSteerSettled) => {
+        const large = conversationService.previewLargeUncachedInput(text);
+        const surge = conversationService.previewInputSurge(text);
+        if (large.action !== 'allow' || surge.action !== 'allow') {
+            return { delivery: 'rejected', reason: 'needs_confirmation' };
+        }
+        return new Promise((resolve, reject) => {
+            let admissionReported = false;
+            const send = orchestrator.sendUserMessage(text, {
+                busyMode,
+                onSteerSettled,
+                onAdmitted: (messageId, delivery) => {
+                    if (admissionReported)
+                        return;
+                    admissionReported = true;
+                    input.addSystemMessage?.(`Control ${busyMode === 'steer' ? 'steer' : 'submit'} ${messageId}`);
+                    resolve({ messageId, delivery });
+                },
+            });
+            void send.then(() => {
+                if (!admissionReported) {
+                    admissionReported = true;
+                    resolve({ delivery: 'rejected', reason: 'not_admitted' });
+                }
+            }, reject);
+        });
+    };
+    return {
+        submit: ({ text }) => mutate(text, 'follow_up'),
+        steer: ({ text, onSteerSettled }) => mutate(text, 'steer', onSteerSettled),
+        interrupt: async () => {
+            const pending = conversationService.getPendingInteractionSnapshot();
+            const nested = conversationService.getNestedApprovalSnapshot();
+            if (pending?.approval.toolName === 'ask_user')
+                input.cancelAskUser?.();
+            else if (nested || pending)
+                input.stopProcessing?.();
+            else if (orchestrator.isTurnActive() || conversationService.isQueueOwningSubmissions()) {
+                input.stopProcessingWithNotice?.();
+            }
+            else
+                return { accepted: false, reason: 'idle' };
+            return { accepted: true };
+        },
+        status: () => {
+            const pending = conversationService.getPendingInteractionSnapshot();
+            const nested = conversationService.getNestedApprovalSnapshot();
+            const projection = projectControlPhase({
+                foregroundToolName: pending?.approval.toolName,
+                hasNestedApproval: !pending && nested !== null,
+                activeTurn: orchestrator.isTurnActive(),
+                queueOwnsSubmissions: conversationService.isQueueOwningSubmissions(),
+                queueActive: conversationService.isQueueActive(),
+            });
+            const calls = toolCalls();
+            return {
+                ...projection,
+                queueStateKind: conversationService.queueStateKind(),
+                sessionId: conversationService.sessionId,
+                queue: orchestrator.listOutstandingSubmissions().map((submission) => ({
+                    ...submission,
+                    text: submission.text.slice(0, 500),
+                })),
+                currentTool: calls[0] ?? null,
+                context: { contextWindow: contextWindow(), promptTokens: null },
+                cost: orchestrator.getCostSummary(),
+                model: settingsService.get('agent.model') ?? null,
+                provider: settingsService.get('agent.provider') ?? null,
+                reasoningEffort: settingsService.get('agent.reasoningEffort') ?? null,
+            };
+        },
+        get: (topic) => {
+            if (topic === 'session') {
+                return {
+                    sessionId: conversationService.sessionId,
+                    socketName: controlSocket.name,
+                    pid: process.pid,
+                    host: os.hostname(),
+                    cwd: process.cwd(),
+                    ...input.sessionMetadata(),
+                    startedAt: controlSocket.startedAt,
+                    profileId: settingsService.get('app.activeProfileId') ?? null,
+                };
+            }
+            if (topic === 'model') {
+                return {
+                    provider: settingsService.get('agent.provider') ?? null,
+                    model: settingsService.get('agent.model') ?? null,
+                    reasoningEffort: settingsService.get('agent.reasoningEffort') ?? null,
+                    autoApproveMode: settingsService.get('shell.autoApproveMode') ?? null,
+                };
+            }
+            if (topic === 'usage') {
+                const usage = usageAccumulator.get();
+                return {
+                    cumulative: {
+                        prompt_tokens: usage.prompt_tokens ?? 0,
+                        completion_tokens: usage.completion_tokens ?? 0,
+                        cache_read_tokens: usage.cache_read_tokens ?? 0,
+                        cache_creation_tokens: usage.cache_creation_tokens ?? 0,
+                    },
+                    contextWindow: contextWindow(),
+                    cost: orchestrator.getCostSummary(),
+                    lastRequest: null,
+                };
+            }
+            if (topic === 'pending')
+                return getPendingSnapshot(conversationService);
+            if (topic === 'tools')
+                return { calls: toolCalls() };
+            return {
+                tasks: conversationService.backgroundTaskControl
+                    .listDetails()
+                    .slice(0, 32)
+                    .map((task) => ({
+                    kind: task.kind,
+                    id: task.id,
+                    status: task.status,
+                    startedAt: task.startedAt,
+                    labelExcerpt: (task.kind === 'subagent' ? task.taskPreview : task.command).slice(0, 500),
+                })),
+            };
+        },
+    };
+}
+function getPendingSnapshot(conversationService) {
+    const pending = conversationService.getPendingInteractionSnapshot();
+    const nested = conversationService.getNestedApprovalSnapshot();
+    return {
+        foreground: pending
+            ? {
+                interactionId: pending.interactionId,
+                revision: pending.revision,
+                toolName: pending.approval.toolName,
+                callId: pending.approval.callId,
+                checkIn: pending.approval.checkIn ?? false,
+                currentAskUserQuestionIndex: pending.currentAskUserQuestionIndex,
+                argumentsExcerpt: pending.approval.argumentsText.slice(0, 500),
+                ...(pending.approval.toolName === TOOL_NAME_ASK_USER
+                    ? { questions: projectAskUserQuestions(pending.approval) }
+                    : {}),
+            }
+            : null,
+        nested: nested
+            ? {
+                requestId: nested.requestId,
+                nestedCallId: nested.nestedCallId,
+                toolName: nested.approval.toolName,
+                argumentsExcerpt: nested.approval.argumentsText.slice(0, 500),
+            }
+            : null,
+    };
+}
+function projectAskUserQuestions(approval) {
+    return getAskUserQuestions(approval)
+        .slice(0, 5)
+        .flatMap((item) => {
+        if (typeof item.question !== 'string')
+            return [];
+        return [
+            {
+                question: item.question,
+                options: (Array.isArray(item.options) ? item.options : [])
+                    .slice(0, 8)
+                    .flatMap((option) => option && typeof option.label === 'string' ? [{ label: option.label.slice(0, 80) }] : []),
+                is_multi_select: item.is_multi_select === true,
+            },
+        ];
+    });
+}
+//# sourceMappingURL=control-session-port.js.map

package/dist/services/control-socket/control-session-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-session-port.js","sourceRoot":"","sources":["../../../source/services/control-socket/control-session-port.ts"],"names":[],"mappings":"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"}

package/dist/services/control-socket/control-socket.d.ts

@@ -0,0 +1,130 @@
+export declare const CONTROL_PROTOCOL_VERSION = 1;
+export declare const CONTROL_MAX_FRAME_BYTES: number;
+export declare const CONTROL_MAX_CONNECTIONS = 8;
+export declare const CONTROL_TOPICS: readonly ['session', 'model', 'usage', 'pending', 'tools', 'background'];
+export type ControlTopic = (typeof CONTROL_TOPICS)[number];
+export type ControlPhase = 'idle' | 'working' | 'awaiting_approval';
+export declare function projectControlPhase(input: {
+    foregroundToolName?: string | null;
+    hasNestedApproval: boolean;
+    activeTurn: boolean;
+    queueOwnsSubmissions: boolean;
+    queueActive: boolean;
+}): {
+    phase: ControlPhase;
+    waitKind: 'question' | 'approval' | 'nested_approval' | null;
+};
+export type ControlErrorCode = 'unsupported_version' | 'unknown_method' | 'invalid_request' | 'payload_too_large' | 'unauthorized' | 'not_ready' | 'conflict' | 'rejected' | 'unavailable' | 'internal';
+export interface ControlSessionPort {
+    status(): unknown;
+    get(topic: ControlTopic): unknown;
+    submit?(params: {
+        text: string;
+        clientRequestId: string;
+        origin?: unknown;
+        onSteerSettled?: () => void;
+    }): Promise<ControlMutationReceipt>;
+    steer?(params: {
+        text: string;
+        clientRequestId: string;
+        origin?: unknown;
+        onSteerSettled?: () => void;
+    }): Promise<ControlMutationReceipt>;
+    interrupt?(): Promise<{
+        accepted: boolean;
+        reason?: string;
+    }>;
+}
+export interface ControlMutationReceipt {
+    messageId?: string;
+    delivery: 'started' | 'queued' | 'steering' | 'rejected';
+    reason?: string;
+    replayed?: boolean;
+}
+/** FIFO admission primitive shared by future state-changing methods. */
+export declare class ControlAdmissionLock {
+    #private;
+    run<T>(operation: () => T | Promise<T>): Promise<T>;
+}
+export interface ControlReceiptEntry<T> {
+    bodyHash: string;
+    receipt: T;
+    pending: boolean;
+}
+/** Process-local replay table; a live pending operation is never evicted. */
+export declare class ControlIdempotencyMap<T> {
+    #private;
+    constructor(capacity?: number);
+    canStore(): boolean;
+    get(clientRequestId: string, body: unknown): {
+        kind: 'missing';
+    } | {
+        kind: 'conflict';
+    } | {
+        kind: 'replay';
+        receipt: T;
+    };
+    set(clientRequestId: string, body: unknown, receipt: T, pending?: boolean): void;
+    settle(clientRequestId: string): void;
+}
+export interface ControlAdvertisement {
+    v: 1;
+    name: string;
+    pid: number;
+    startedAt: string;
+    sessionId: string;
+    socketPath: string;
+    cwd: string;
+    host: string;
+}
+export declare function isControlSocketName(name: string): boolean;
+export declare function controlDirectory(runtimeDir: string): string;
+export declare function parseProcStartTime(stat: string): string | null;
+export declare function readProcStartTime(pid: number): string | null;
+export interface ControlSocketOptions {
+    name: string;
+    sessionId: () => string;
+    port?: ControlSessionPort | null;
+    runtimeDir?: string;
+    pid?: number;
+    cwd?: string;
+    host?: string;
+    startTime?: () => string | null;
+    isPidAlive?: (pid: number) => boolean;
+    setSocketMode?: (socketPath: string) => void;
+    socketIsLive?: (socketPath: string) => Promise<boolean>;
+}
+/** Owns socket framing, discovery files, connection admission, and the read-only v1 wire. */
+export declare class ControlSocketServer {
+    #private;
+    readonly name: string;
+    readonly directory: string;
+    readonly socketPath: string;
+    readonly advertisementPath: string;
+    constructor(options: ControlSocketOptions);
+    get startedAt(): string;
+    refreshAdvertisement(): void;
+    bind(port: ControlSessionPort): void;
+    unbind(port: ControlSessionPort): void;
+    bindInterruptHandler(handler: () => Promise<{
+        accepted: boolean;
+        reason?: string;
+    }> | {
+        accepted: boolean;
+        reason?: string;
+    }): void;
+    unbindInterruptHandler(handler: () => Promise<{
+        accepted: boolean;
+        reason?: string;
+    }> | {
+        accepted: boolean;
+        reason?: string;
+    }): void;
+    listen(): Promise<void>;
+    close(): Promise<void>;
+}
+declare function defaultPidAlive(pid: number): boolean;
+export declare function reapControlDirectory(directory: string, host?: string, isPidAlive?: typeof defaultPidAlive, startTime?: typeof readProcStartTime): void;
+export declare function listControlAdvertisements(runtimeDir: string, host?: string): ControlAdvertisement[];
+export {};
+//# sourceMappingURL=control-socket.d.ts.map

package/dist/services/control-socket/control-socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-socket.d.ts","sourceRoot":"","sources":["../../../source/services/control-socket/control-socket.ts"],"names":[],"mappings":"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"}