awb-agent-manager 1.6.76 → 1.6.78

package/dist/lib/runtime/acp/acp-client.js

@@ -0,0 +1,227 @@
+import { spawn } from 'node:child_process';
+import { ACP_PROTOCOL_VERSION } from './acp-types.js';
+import { AcpProtocolError, JsonRpcPeer, } from './json-rpc-peer.js';
+import { isChildTool } from '../collaboration-governor.js';
+export { AcpProtocolError } from './json-rpc-peer.js';
+function objectValue(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+function stringValue(value) {
+    return typeof value === 'string' ? value : '';
+}
+function numberValue(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : 0;
+}
+function field(value, camel, snake) {
+    return value[camel] ?? value[snake];
+}
+function sanitizeDiagnostic(value, depth = 0) {
+    if (depth > 4)
+        return '[truncated]';
+    if (typeof value === 'string')
+        return value.slice(0, 2_048);
+    if (Array.isArray(value)) {
+        return value.slice(0, 50).map((entry) => sanitizeDiagnostic(entry, depth + 1));
+    }
+    if (!value || typeof value !== 'object')
+        return value;
+    const result = {};
+    for (const [key, entry] of Object.entries(value).slice(0, 50)) {
+        result[key] = /token|secret|password|authorization|api.?key/i.test(key)
+            ? '[REDACTED]'
+            : sanitizeDiagnostic(entry, depth + 1);
+    }
+    return result;
+}
+function normalizeUsage(sessionId, usageValue) {
+    const usage = objectValue(usageValue);
+    return {
+        type: 'usage',
+        sessionId,
+        inputTokens: numberValue(field(usage, 'inputTokens', 'input_tokens')),
+        outputTokens: numberValue(field(usage, 'outputTokens', 'output_tokens')),
+        totalTokens: numberValue(field(usage, 'totalTokens', 'total_tokens')),
+        cachedReadTokens: numberValue(field(usage, 'cachedReadTokens', 'cached_read_tokens')),
+        thoughtTokens: numberValue(field(usage, 'thoughtTokens', 'thought_tokens')),
+    };
+}
+function normalizeUpdate(paramsValue, childToolCalls) {
+    const params = objectValue(paramsValue);
+    const sessionId = stringValue(params.sessionId
+        ?? params.session_id);
+    const update = objectValue(params.update);
+    const kind = stringValue(field(update, 'sessionUpdate', 'session_update'));
+    if (kind === 'agent_message_chunk' || kind === 'user_message_chunk') {
+        const content = objectValue(update.content);
+        return { type: 'message_delta', sessionId, text: stringValue(content.text) };
+    }
+    if (kind === 'agent_thought_chunk') {
+        const content = objectValue(update.content);
+        return { type: 'reasoning_delta', sessionId, text: stringValue(content.text) };
+    }
+    if (kind === 'tool_call') {
+        const toolCallId = stringValue(field(update, 'toolCallId', 'tool_call_id'));
+        const title = stringValue(update.title);
+        const toolKind = stringValue(update.kind) || undefined;
+        if (isChildTool({ title, kind: toolKind })) {
+            childToolCalls.add(toolCallId);
+            return {
+                type: 'child_started',
+                sessionId,
+                childRunId: toolCallId,
+                title,
+                kind: toolKind,
+                input: field(update, 'rawInput', 'raw_input'),
+            };
+        }
+        return {
+            type: 'tool_started',
+            sessionId,
+            toolCallId,
+            title,
+            kind: toolKind,
+            input: field(update, 'rawInput', 'raw_input'),
+        };
+    }
+    if (kind === 'tool_call_update') {
+        const status = stringValue(update.status);
+        const toolCallId = stringValue(field(update, 'toolCallId', 'tool_call_id'));
+        if (childToolCalls.has(toolCallId)
+            && (status === 'completed' || status === 'failed' || status === 'cancelled')) {
+            childToolCalls.delete(toolCallId);
+            return {
+                type: 'child_finished',
+                sessionId,
+                childRunId: toolCallId,
+                status: status,
+                output: field(update, 'rawOutput', 'raw_output'),
+            };
+        }
+        return {
+            type: status === 'completed' || status === 'failed'
+                ? 'tool_completed'
+                : 'tool_updated',
+            sessionId,
+            toolCallId,
+            status: status || undefined,
+            output: field(update, 'rawOutput', 'raw_output'),
+        };
+    }
+    if (kind === 'usage_update') {
+        const nativeUsage = update.usage ?? {
+            inputTokens: update.inputTokens,
+            outputTokens: update.outputTokens,
+            totalTokens: update.used,
+        };
+        return normalizeUsage(sessionId, nativeUsage);
+    }
+    return {
+        type: 'diagnostic',
+        method: 'session/update',
+        sessionId,
+        data: sanitizeDiagnostic(update),
+    };
+}
+export class AcpClient {
+    #peer;
+    #onEvent;
+    #onPermissionRequest;
+    #childToolCalls = new Set();
+    constructor(peer, options) {
+        this.#peer = peer;
+        this.#onEvent = options.onEvent;
+        this.#onPermissionRequest = options.onPermissionRequest;
+    }
+    static async spawn(options) {
+        if (!options.command.trim()) {
+            throw new AcpProtocolError('acp_write_failed', 'ACP command is required');
+        }
+        let client;
+        const child = spawn(options.command, options.args ?? [], {
+            ...options.spawnOptions,
+            cwd: options.cwd,
+            env: options.env,
+            shell: false,
+            windowsHide: true,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const peer = new JsonRpcPeer(child, {
+            requestTimeoutMs: options.requestTimeoutMs,
+            maxLineBytes: options.maxLineBytes,
+            maxMessageBytes: options.maxMessageBytes,
+            onStderr: options.onStderr,
+            onNotification: (method, params) => {
+                if (client)
+                    client.#handleNotification(method, params);
+            },
+            onRequest: (method, params) => {
+                if (!client)
+                    throw new Error('ACP client is not ready');
+                return client.#handleRequest(method, params);
+            },
+        });
+        client = new AcpClient(peer, options);
+        return client;
+    }
+    get process() {
+        return this.#peer.process;
+    }
+    request(method, params, options) {
+        return this.#peer.request(method, params, options);
+    }
+    initialize(request) {
+        return this.request('initialize', {
+            protocolVersion: request.protocolVersion ?? ACP_PROTOCOL_VERSION,
+            clientCapabilities: request.clientCapabilities ?? {},
+            clientInfo: request.clientInfo,
+        });
+    }
+    newSession(request) {
+        return this.request('session/new', request);
+    }
+    loadSession(request) {
+        return this.request('session/load', request);
+    }
+    prompt(request, options) {
+        return this.request('session/prompt', request, options);
+    }
+    cancel(sessionId) {
+        this.#peer.notify('session/cancel', { sessionId });
+        return Promise.resolve();
+    }
+    async closeSession(sessionId) {
+        await this.request('session/close', { sessionId });
+    }
+    close() {
+        this.#peer.close();
+    }
+    #handleNotification(method, params) {
+        if (method === 'session/update') {
+            this.#onEvent?.(normalizeUpdate(params, this.#childToolCalls));
+            return;
+        }
+        const data = objectValue(params);
+        this.#onEvent?.({
+            type: 'diagnostic',
+            method,
+            sessionId: stringValue(data.sessionId ?? data.session_id) || undefined,
+            data: sanitizeDiagnostic(params),
+        });
+    }
+    async #handleRequest(method, params) {
+        if (method !== 'session/request_permission') {
+            throw new Error(`Unsupported ACP client request: ${method}`);
+        }
+        const request = params;
+        const outcome = this.#onPermissionRequest
+            ? await this.#onPermissionRequest(request)
+            : { outcome: 'cancelled' };
+        return { outcome };
+    }
+}
+export function runtimeEventFromPromptUsage(sessionId, usage) {
+    return usage ? normalizeUsage(sessionId, usage) : null;
+}
+//# sourceMappingURL=acp-client.js.map

package/dist/lib/runtime/acp/acp-client.js.map

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

package/dist/lib/runtime/acp/acp-types.d.ts

@@ -0,0 +1,118 @@
+export declare const ACP_PROTOCOL_VERSION = 1;
+export type JsonRpcId = string | number;
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id: JsonRpcId;
+    method: string;
+    params?: unknown;
+}
+export interface JsonRpcNotification {
+    jsonrpc: '2.0';
+    method: string;
+    params?: unknown;
+}
+export interface JsonRpcSuccess {
+    jsonrpc: '2.0';
+    id: JsonRpcId;
+    result: unknown;
+}
+export interface JsonRpcFailure {
+    jsonrpc: '2.0';
+    id: JsonRpcId;
+    error: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export type JsonRpcMessage = JsonRpcRequest | JsonRpcNotification | JsonRpcSuccess | JsonRpcFailure;
+export interface AcpImplementation {
+    name: string;
+    version: string;
+}
+export interface AcpInitializeRequest {
+    protocolVersion?: number;
+    clientCapabilities?: Record<string, unknown>;
+    clientInfo: AcpImplementation;
+}
+export interface AcpInitializeResponse {
+    protocolVersion: number;
+    agentCapabilities: Record<string, unknown>;
+    agentInfo: AcpImplementation;
+    authMethods?: unknown[];
+}
+export interface AcpMcpServer {
+    name: string;
+    command?: string;
+    args?: string[];
+    env?: Array<{
+        name: string;
+        value: string;
+    }>;
+    url?: string;
+    headers?: Array<{
+        name: string;
+        value: string;
+    }>;
+}
+export interface AcpNewSessionRequest {
+    cwd: string;
+    mcpServers?: AcpMcpServer[];
+}
+export interface AcpNewSessionResponse {
+    sessionId: string;
+    models?: unknown;
+    modes?: unknown;
+}
+export interface AcpLoadSessionRequest extends AcpNewSessionRequest {
+    sessionId: string;
+}
+export interface AcpContentBlock {
+    type: string;
+    text?: string;
+    [key: string]: unknown;
+}
+export interface AcpPromptRequest {
+    sessionId: string;
+    prompt: AcpContentBlock[];
+}
+export interface AcpUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    cachedReadTokens?: number;
+    thoughtTokens?: number;
+}
+export interface AcpPromptResponse {
+    stopReason: string;
+    usage?: AcpUsage;
+}
+export interface AcpPermissionOption {
+    optionId: string;
+    name: string;
+    kind: string;
+}
+export interface AcpPermissionRequest {
+    sessionId: string;
+    toolCall: {
+        toolCallId: string;
+        title?: string;
+        kind?: string;
+        [key: string]: unknown;
+    };
+    options: AcpPermissionOption[];
+}
+export type AcpPermissionOutcome = {
+    outcome: 'selected';
+    optionId: string;
+} | {
+    outcome: 'cancelled';
+};
+export interface AcpSessionUpdateParams {
+    sessionId: string;
+    update: {
+        sessionUpdate?: string;
+        session_update?: string;
+        [key: string]: unknown;
+    };
+}

package/dist/lib/runtime/acp/acp-types.js

@@ -0,0 +1,2 @@
+export const ACP_PROTOCOL_VERSION = 1;
+//# sourceMappingURL=acp-types.js.map

package/dist/lib/runtime/acp/acp-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-types.js","sourceRoot":"","sources":["../../../../src/lib/runtime/acp/acp-types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC"}

package/dist/lib/runtime/acp/json-rpc-peer.d.ts

@@ -0,0 +1,34 @@
+import type { ChildProcessWithoutNullStreams } from 'node:child_process';
+export type AcpProtocolErrorCode = 'acp_timeout' | 'acp_aborted' | 'acp_closed' | 'acp_process_exited' | 'acp_malformed_message' | 'acp_message_too_large' | 'acp_remote_error' | 'acp_write_failed';
+export declare class AcpProtocolError extends Error {
+    readonly code: AcpProtocolErrorCode;
+    readonly exitCode?: number | null;
+    readonly rpcCode?: number;
+    readonly data?: unknown;
+    constructor(code: AcpProtocolErrorCode, message: string, options?: {
+        cause?: unknown;
+        exitCode?: number | null;
+        rpcCode?: number;
+        data?: unknown;
+    });
+}
+export interface JsonRpcPeerOptions {
+    requestTimeoutMs?: number;
+    maxLineBytes?: number;
+    maxMessageBytes?: number;
+    onNotification?: (method: string, params: unknown) => void | Promise<void>;
+    onRequest?: (method: string, params: unknown) => unknown | Promise<unknown>;
+    onStderr?: (line: string) => void;
+}
+export interface JsonRpcRequestOptions {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+export declare class JsonRpcPeer {
+    #private;
+    constructor(child: ChildProcessWithoutNullStreams, options?: JsonRpcPeerOptions);
+    get process(): ChildProcessWithoutNullStreams;
+    request<T = unknown>(method: string, params?: unknown, options?: JsonRpcRequestOptions): Promise<T>;
+    notify(method: string, params?: unknown): void;
+    close(): void;
+}

package/dist/lib/runtime/acp/json-rpc-peer.js

@@ -0,0 +1,262 @@
+export class AcpProtocolError extends Error {
+    code;
+    exitCode;
+    rpcCode;
+    data;
+    constructor(code, message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = 'AcpProtocolError';
+        this.code = code;
+        this.exitCode = options.exitCode;
+        this.rpcCode = options.rpcCode;
+        this.data = options.data;
+    }
+}
+const DEFAULT_REQUEST_TIMEOUT_MS = 30_000;
+const DEFAULT_MAX_LINE_BYTES = 4 * 1024 * 1024;
+const DEFAULT_MAX_MESSAGE_BYTES = 4 * 1024 * 1024;
+function hasOwn(value, key) {
+    return Object.prototype.hasOwnProperty.call(value, key);
+}
+function redactDiagnostic(input) {
+    return input
+        .replace(/\b(authorization\s*:\s*bearer|api[_-]?key|access[_-]?token|refresh[_-]?token|password|secret|token)\b(\s*[:=]\s*|\s+)[^\s,;]+/gi, '$1$2[REDACTED]')
+        .slice(0, 8_192);
+}
+export class JsonRpcPeer {
+    #child;
+    #options;
+    #pending = new Map();
+    #nextId = 1;
+    #stdoutBuffer = Buffer.alloc(0);
+    #stderrBuffer = '';
+    #fatalError = null;
+    #closed = false;
+    constructor(child, options = {}) {
+        this.#child = child;
+        this.#options = {
+            ...options,
+            requestTimeoutMs: options.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,
+            maxLineBytes: options.maxLineBytes ?? DEFAULT_MAX_LINE_BYTES,
+            maxMessageBytes: options.maxMessageBytes ?? DEFAULT_MAX_MESSAGE_BYTES,
+        };
+        child.stdout.on('data', (chunk) => {
+            this.#consumeStdout(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        });
+        child.stderr.setEncoding('utf8');
+        child.stderr.on('data', (chunk) => this.#consumeStderr(chunk));
+        child.once('error', (error) => {
+            this.#fail(new AcpProtocolError('acp_process_exited', error.message, { cause: error }));
+        });
+        child.once('exit', (code, signal) => {
+            if (this.#closed)
+                return;
+            this.#fail(new AcpProtocolError('acp_process_exited', `ACP process exited (code=${String(code)}, signal=${String(signal)})`, { exitCode: code }));
+        });
+    }
+    get process() {
+        return this.#child;
+    }
+    request(method, params, options = {}) {
+        if (this.#fatalError)
+            return Promise.reject(this.#fatalError);
+        if (this.#closed) {
+            return Promise.reject(new AcpProtocolError('acp_closed', 'ACP peer is closed'));
+        }
+        if (options.signal?.aborted) {
+            return Promise.reject(new AcpProtocolError('acp_aborted', `ACP request aborted: ${method}`));
+        }
+        const id = this.#nextId++;
+        const timeoutMs = options.timeoutMs ?? this.#options.requestTimeoutMs;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.#pending.delete(id);
+                reject(new AcpProtocolError('acp_timeout', `ACP request timed out after ${timeoutMs}ms: ${method}`));
+            }, timeoutMs);
+            const pending = {
+                resolve: (value) => resolve(value),
+                reject,
+                timer,
+            };
+            if (options.signal) {
+                const onAbort = () => {
+                    const current = this.#pending.get(id);
+                    if (!current)
+                        return;
+                    this.#pending.delete(id);
+                    clearTimeout(current.timer);
+                    reject(new AcpProtocolError('acp_aborted', `ACP request aborted: ${method}`));
+                };
+                options.signal.addEventListener('abort', onAbort, { once: true });
+                pending.removeAbort = () => options.signal?.removeEventListener('abort', onAbort);
+            }
+            this.#pending.set(id, pending);
+            try {
+                this.#write({ jsonrpc: '2.0', id, method, params });
+            }
+            catch (error) {
+                this.#settle(id, false, error);
+            }
+        });
+    }
+    notify(method, params) {
+        if (this.#fatalError)
+            throw this.#fatalError;
+        if (this.#closed)
+            throw new AcpProtocolError('acp_closed', 'ACP peer is closed');
+        this.#write({ jsonrpc: '2.0', method, params });
+    }
+    close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#rejectPending(new AcpProtocolError('acp_closed', 'ACP peer closed'));
+        if (!this.#child.killed)
+            this.#child.kill();
+    }
+    #write(message) {
+        const encoded = `${JSON.stringify(message)}\n`;
+        if (Buffer.byteLength(encoded) > this.#options.maxMessageBytes) {
+            throw new AcpProtocolError('acp_message_too_large', 'Outbound ACP message exceeds the configured byte limit');
+        }
+        try {
+            this.#child.stdin.write(encoded);
+        }
+        catch (error) {
+            throw new AcpProtocolError('acp_write_failed', 'Failed to write ACP message', {
+                cause: error,
+            });
+        }
+    }
+    #consumeStdout(chunk) {
+        if (this.#fatalError || this.#closed)
+            return;
+        this.#stdoutBuffer = Buffer.concat([this.#stdoutBuffer, chunk]);
+        if (this.#stdoutBuffer.length > this.#options.maxLineBytes
+            && this.#stdoutBuffer.indexOf(0x0a) === -1) {
+            this.#fail(new AcpProtocolError('acp_message_too_large', 'ACP stdout line exceeds the configured byte limit'));
+            return;
+        }
+        while (true) {
+            const newline = this.#stdoutBuffer.indexOf(0x0a);
+            if (newline === -1)
+                break;
+            const line = this.#stdoutBuffer.subarray(0, newline);
+            this.#stdoutBuffer = this.#stdoutBuffer.subarray(newline + 1);
+            if (line.length === 0)
+                continue;
+            if (line.length > this.#options.maxLineBytes) {
+                this.#fail(new AcpProtocolError('acp_message_too_large', 'ACP stdout line exceeds the configured byte limit'));
+                return;
+            }
+            this.#parseLine(line.toString('utf8').replace(/\r$/, ''));
+            if (this.#fatalError)
+                return;
+        }
+    }
+    #consumeStderr(chunk) {
+        this.#stderrBuffer += chunk;
+        const lines = this.#stderrBuffer.split(/\r?\n/);
+        this.#stderrBuffer = lines.pop() ?? '';
+        for (const line of lines) {
+            if (line)
+                this.#options.onStderr?.(redactDiagnostic(line));
+        }
+    }
+    #parseLine(line) {
+        let value;
+        try {
+            value = JSON.parse(line);
+        }
+        catch (error) {
+            this.#fail(new AcpProtocolError('acp_malformed_message', 'ACP stdout contained malformed JSON', { cause: error }));
+            return;
+        }
+        if (!value || typeof value !== 'object' || Array.isArray(value)) {
+            this.#fail(new AcpProtocolError('acp_malformed_message', 'ACP stdout contained an invalid JSON-RPC message'));
+            return;
+        }
+        const message = value;
+        if (message.jsonrpc !== '2.0') {
+            this.#fail(new AcpProtocolError('acp_malformed_message', 'ACP message is missing jsonrpc=2.0'));
+            return;
+        }
+        if (typeof message.method === 'string') {
+            if (hasOwn(message, 'id')) {
+                void this.#handleIncomingRequest(message.id, message.method, message.params);
+            }
+            else {
+                void Promise.resolve(this.#options.onNotification?.(message.method, message.params)).catch(() => undefined);
+            }
+            return;
+        }
+        if (!hasOwn(message, 'id')) {
+            this.#fail(new AcpProtocolError('acp_malformed_message', 'ACP response is missing an id'));
+            return;
+        }
+        const id = message.id;
+        if (hasOwn(message, 'error')) {
+            const remote = message;
+            this.#settle(id, false, new AcpProtocolError('acp_remote_error', remote.error?.message || 'ACP peer returned an error', { rpcCode: remote.error?.code, data: remote.error?.data }));
+        }
+        else if (hasOwn(message, 'result')) {
+            this.#settle(id, true, message.result);
+        }
+        else {
+            this.#fail(new AcpProtocolError('acp_malformed_message', 'ACP response has neither result nor error'));
+        }
+    }
+    async #handleIncomingRequest(id, method, params) {
+        try {
+            if (!this.#options.onRequest) {
+                this.#write({
+                    jsonrpc: '2.0',
+                    id,
+                    error: { code: -32601, message: `Method not found: ${method}` },
+                });
+                return;
+            }
+            const result = await this.#options.onRequest(method, params);
+            this.#write({ jsonrpc: '2.0', id, result: result ?? null });
+        }
+        catch (error) {
+            this.#write({
+                jsonrpc: '2.0',
+                id,
+                error: {
+                    code: -32000,
+                    message: error instanceof Error ? error.message : 'Client request handler failed',
+                },
+            });
+        }
+    }
+    #settle(id, succeeded, value) {
+        const pending = this.#pending.get(id);
+        if (!pending)
+            return;
+        this.#pending.delete(id);
+        clearTimeout(pending.timer);
+        pending.removeAbort?.();
+        if (succeeded)
+            pending.resolve(value);
+        else
+            pending.reject(value);
+    }
+    #rejectPending(error) {
+        for (const [id, pending] of this.#pending) {
+            this.#pending.delete(id);
+            clearTimeout(pending.timer);
+            pending.removeAbort?.();
+            pending.reject(error);
+        }
+    }
+    #fail(error) {
+        if (this.#fatalError || this.#closed)
+            return;
+        this.#fatalError = error;
+        this.#rejectPending(error);
+        if (!this.#child.killed)
+            this.#child.kill();
+    }
+}
+//# sourceMappingURL=json-rpc-peer.js.map