factory-factory 0.4.5 → 0.4.7

package/dist/src/backend/services/session/service/acp/acp-runtime-config-controller.test.js

@@ -0,0 +1,208 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { AcpRuntimeConfigController } from './acp-runtime-config-controller.js';
+import { createTestProcessHandle, defaultConfigOptions } from './acp-runtime-manager.test-helpers.js';
+const mocks = vi.hoisted(() => {
+    const loggerCategories = [];
+    const warn = vi.fn();
+    return {
+        loggerCategories,
+        warn,
+        createLogger: (category) => {
+            loggerCategories.push(category);
+            return { warn };
+        },
+    };
+});
+vi.mock('@/backend/services/logger.service', () => ({
+    createLogger: mocks.createLogger,
+}));
+const LOGICAL_SESSION_ID = 'factory-session-1';
+function expectManagerWarning(message, metadata) {
+    expect(mocks.warn).toHaveBeenCalledWith(message, metadata);
+    expect(mocks.loggerCategories).toContain('acp-runtime-manager');
+}
+function configOptions() {
+    return [
+        {
+            id: 'model',
+            name: 'Model',
+            type: 'select',
+            category: 'model',
+            currentValue: 'sonnet',
+            options: [
+                { value: 'sonnet', name: 'Sonnet' },
+                { value: 'opus', name: 'Opus' },
+            ],
+        },
+        {
+            id: 'mode',
+            name: 'Mode',
+            type: 'select',
+            category: 'mode',
+            currentValue: 'default',
+            options: [
+                { value: 'default', name: 'Default' },
+                { value: 'plan', name: 'Plan' },
+            ],
+        },
+    ];
+}
+describe('AcpRuntimeConfigController', () => {
+    let controller;
+    beforeEach(() => {
+        controller = new AcpRuntimeConfigController();
+        mocks.warn.mockReset();
+    });
+    it('updates a handle cache from a generic config response', async () => {
+        const nextOptions = configOptions().map((option) => option.id === 'mode' ? { ...option, currentValue: 'plan' } : option);
+        const setSessionConfigOption = vi.fn().mockResolvedValue({ configOptions: nextOptions });
+        const handle = createTestProcessHandle({
+            provider: 'CODEX',
+            connection: { setSessionConfigOption },
+        });
+        handle.configOptions = configOptions();
+        await expect(controller.setConfigOption(handle, 'thought_level', 'high', LOGICAL_SESSION_ID)).resolves.toEqual(nextOptions);
+        expect(setSessionConfigOption).toHaveBeenCalledWith({
+            sessionId: handle.providerSessionId,
+            configId: 'thought_level',
+            value: 'high',
+        });
+        expect(handle.configOptions).toEqual(nextOptions);
+    });
+    it('replaces only the cached mode value after setSessionMode succeeds', async () => {
+        const setSessionMode = vi.fn().mockResolvedValue({});
+        const handle = createTestProcessHandle({
+            connection: { setSessionMode },
+        });
+        handle.configOptions = configOptions();
+        await expect(controller.setSessionMode(handle, 'plan', LOGICAL_SESSION_ID)).resolves.toEqual([
+            configOptions()[0],
+            { ...configOptions()[1], currentValue: 'plan' },
+        ]);
+        expect(setSessionMode).toHaveBeenCalledWith({
+            sessionId: handle.providerSessionId,
+            modeId: 'plan',
+        });
+        expect(handle.configOptions.find((option) => option.category === 'mode')?.currentValue).toBe('plan');
+    });
+    it('uses Claude unstable_setSessionModel and replaces the cached model value', async () => {
+        const unstableSetSessionModel = vi.fn().mockResolvedValue({});
+        const handle = createTestProcessHandle({
+            provider: 'CLAUDE',
+            connection: { unstable_setSessionModel: unstableSetSessionModel },
+        });
+        handle.configOptions = configOptions();
+        await expect(controller.setSessionModel(handle, 'opus', LOGICAL_SESSION_ID)).resolves.toEqual([
+            { ...configOptions()[0], currentValue: 'opus' },
+            configOptions()[1],
+        ]);
+        expect(unstableSetSessionModel).toHaveBeenCalledWith({
+            sessionId: handle.providerSessionId,
+            modelId: 'opus',
+        });
+    });
+    it('falls back to generic model configuration when Claude unstable model is unavailable', async () => {
+        const unstableSetSessionModel = vi
+            .fn()
+            .mockRejectedValue({ code: -32_601, message: 'Method not found' });
+        const setSessionConfigOption = vi.fn().mockResolvedValue({
+            configOptions: configOptions().map((option) => option.id === 'model' ? { ...option, currentValue: 'opus' } : option),
+        });
+        const handle = createTestProcessHandle({
+            provider: 'CLAUDE',
+            connection: { unstable_setSessionModel: unstableSetSessionModel, setSessionConfigOption },
+        });
+        handle.configOptions = configOptions();
+        await controller.setSessionModel(handle, 'opus', LOGICAL_SESSION_ID);
+        expect(setSessionConfigOption).toHaveBeenCalledWith({
+            sessionId: handle.providerSessionId,
+            configId: 'model',
+            value: 'opus',
+        });
+        expect(handle.configOptions.find((option) => option.category === 'model')?.currentValue).toBe('opus');
+        expectManagerWarning('unstable_setSessionModel unavailable, falling back to setSessionConfigOption', {
+            sessionId: LOGICAL_SESSION_ID,
+            modelId: 'opus',
+            provider: 'CLAUDE',
+        });
+    });
+    it('propagates a Claude model error that is not method-not-found', async () => {
+        const error = new Error('Model rejected');
+        const unstableSetSessionModel = vi.fn().mockRejectedValue(error);
+        const handle = createTestProcessHandle({
+            provider: 'CLAUDE',
+            connection: { unstable_setSessionModel: unstableSetSessionModel },
+        });
+        handle.configOptions = configOptions();
+        await expect(controller.setSessionModel(handle, 'opus', LOGICAL_SESSION_ID)).rejects.toBe(error);
+        expectManagerWarning('setSessionModel failed', {
+            sessionId: LOGICAL_SESSION_ID,
+            modelId: 'opus',
+            provider: 'CLAUDE',
+            error: 'Model rejected',
+        });
+    });
+    it('uses generic model configuration for Codex', async () => {
+        const setSessionConfigOption = vi.fn().mockResolvedValue({
+            configOptions: configOptions().map((option) => option.id === 'model' ? { ...option, currentValue: 'gpt-5.2-codex' } : option),
+        });
+        const unstableSetSessionModel = vi.fn();
+        const handle = createTestProcessHandle({
+            provider: 'CODEX',
+            connection: { setSessionConfigOption, unstable_setSessionModel: unstableSetSessionModel },
+        });
+        handle.configOptions = configOptions();
+        await controller.setSessionModel(handle, 'gpt-5.2-codex', LOGICAL_SESSION_ID);
+        expect(unstableSetSessionModel).not.toHaveBeenCalled();
+        expect(setSessionConfigOption).toHaveBeenCalledWith({
+            sessionId: handle.providerSessionId,
+            configId: 'model',
+            value: 'gpt-5.2-codex',
+        });
+    });
+    it('rejects a generic response missing required config categories', async () => {
+        const setSessionConfigOption = vi.fn().mockResolvedValue({
+            configOptions: [
+                {
+                    id: 'reasoning_effort',
+                    name: 'Reasoning Effort',
+                    type: 'select',
+                    category: 'thought_level',
+                    currentValue: 'medium',
+                    options: [{ value: 'medium', name: 'Medium' }],
+                },
+            ],
+        });
+        const handle = createTestProcessHandle({ connection: { setSessionConfigOption } });
+        handle.configOptions = configOptions();
+        await expect(controller.setConfigOption(handle, 'mode', 'plan', LOGICAL_SESSION_ID)).rejects.toThrow('missing required config option categories: model, mode');
+        expect(handle.configOptions).toEqual(configOptions());
+    });
+    it('warns under the manager category with the logical session ID for generic failures', async () => {
+        const configError = new Error('Config rejected');
+        const setSessionConfigOption = vi.fn().mockRejectedValue(configError);
+        const handle = createTestProcessHandle({ connection: { setSessionConfigOption } });
+        handle.configOptions = defaultConfigOptions();
+        await expect(controller.setConfigOption(handle, 'mode', 'plan', LOGICAL_SESSION_ID)).rejects.toBe(configError);
+        expectManagerWarning('setSessionConfigOption failed', {
+            sessionId: LOGICAL_SESSION_ID,
+            configId: 'mode',
+            provider: handle.provider,
+            error: 'Config rejected',
+        });
+    });
+    it('warns under the manager category with the logical session ID for mode failures', async () => {
+        const modeError = new Error('Mode rejected');
+        const setSessionMode = vi.fn().mockRejectedValue(modeError);
+        const modeHandle = createTestProcessHandle({ connection: { setSessionMode } });
+        modeHandle.configOptions = configOptions();
+        await expect(controller.setSessionMode(modeHandle, 'plan', LOGICAL_SESSION_ID)).rejects.toBe(modeError);
+        expectManagerWarning('setSessionMode failed', {
+            sessionId: LOGICAL_SESSION_ID,
+            modeId: 'plan',
+            provider: modeHandle.provider,
+            error: 'Mode rejected',
+        });
+    });
+});
+//# sourceMappingURL=acp-runtime-config-controller.test.js.map

package/dist/src/backend/services/session/service/acp/acp-runtime-config-controller.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-runtime-config-controller.test.js","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/acp/acp-runtime-config-controller.test.ts"],"names":[],"mappings":"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"}

package/dist/src/backend/services/session/service/acp/acp-runtime-contracts.d.ts

@@ -0,0 +1,25 @@
+import type { AcpProcessHandle } from './acp-process-handle.js';
+import type { AcpRuntimePurpose } from './acp-runtime-events.js';
+export type AcpRuntimeMetadata = {
+    incarnationId: string;
+    purpose: AcpRuntimePurpose;
+    installed: boolean;
+};
+export type AcpRuntimeContext = {
+    workspaceId: string;
+    workingDir: string;
+};
+export type AcpStartupSignal = {
+    promise: Promise<never>;
+    dispose(): void;
+};
+export type AcpRuntimeCreatedCallback = (sessionId: string, client: AcpProcessHandle, context: AcpRuntimeContext) => void;
+export type AcpActiveProcessSnapshot = {
+    sessionId: string;
+    pid: number | undefined;
+    status: string;
+    isRunning: boolean;
+    isPromptInFlight: boolean;
+    provider: string;
+};
+//# sourceMappingURL=acp-runtime-contracts.d.ts.map

package/dist/src/backend/services/session/service/acp/acp-runtime-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-runtime-contracts.d.ts","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/acp/acp-runtime-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,CACtC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,iBAAiB,KACvB,IAAI,CAAC;AAEV,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/src/backend/services/session/service/acp/acp-runtime-contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=acp-runtime-contracts.js.map

package/dist/src/backend/services/session/service/acp/acp-runtime-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-runtime-contracts.js","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/acp/acp-runtime-contracts.ts"],"names":[],"mappings":""}

package/dist/src/backend/services/session/service/acp/acp-runtime-error-handler.d.ts

@@ -0,0 +1,5 @@
+import type { ChildProcess } from 'node:child_process';
+import type { AcpRuntimeMetadata } from './acp-runtime-contracts.js';
+import type { AcpRuntimeEventHandlers } from './acp-runtime-events.js';
+export declare function wireAcpRuntimeErrorHandler(child: ChildProcess, sessionId: string, handlers: AcpRuntimeEventHandlers, runtime: Pick<AcpRuntimeMetadata, 'incarnationId' | 'purpose'>, shouldDispatch: () => boolean): void;
+//# sourceMappingURL=acp-runtime-error-handler.d.ts.map

package/dist/src/backend/services/session/service/acp/acp-runtime-error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-runtime-error-handler.d.ts","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/acp/acp-runtime-error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAKpE,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,uBAAuB,EACjC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,eAAe,GAAG,SAAS,CAAC,EAC9D,cAAc,EAAE,MAAM,OAAO,GAC5B,IAAI,CAiCN"}

package/dist/src/backend/services/session/service/acp/acp-runtime-error-handler.js

@@ -0,0 +1,39 @@
+import { createLogger } from '../../../../../backend/services/logger.service.js';
+import { normalizeUnknownError } from './acp-stream-normalizer.js';
+const logger = createLogger('acp-runtime-manager');
+export function wireAcpRuntimeErrorHandler(child, sessionId, handlers, runtime, shouldDispatch) {
+    child.on('error', async (error) => {
+        const normalizedError = normalizeUnknownError(error);
+        if (!shouldDispatch()) {
+            return;
+        }
+        if (!(handlers.onRuntimeError || handlers.onError)) {
+            logger.warn('ACP child process error (no handler provided)', {
+                sessionId,
+                error: normalizedError.message,
+            });
+            return;
+        }
+        try {
+            if (handlers.onRuntimeError) {
+                await handlers.onRuntimeError({
+                    sessionId,
+                    error: normalizedError,
+                    incarnationId: runtime.incarnationId,
+                    purpose: runtime.purpose,
+                });
+            }
+            else {
+                await handlers.onError?.(sessionId, normalizedError);
+            }
+        }
+        catch (handlerError) {
+            logger.warn('Failed to handle ACP error event', {
+                sessionId,
+                originalError: normalizedError.message,
+                handlerError: handlerError instanceof Error ? handlerError.message : String(handlerError),
+            });
+        }
+    });
+}
+//# sourceMappingURL=acp-runtime-error-handler.js.map

package/dist/src/backend/services/session/service/acp/acp-runtime-error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-runtime-error-handler.js","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/acp/acp-runtime-error-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,MAAM,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAC;AAEnD,MAAM,UAAU,0BAA0B,CACxC,KAAmB,EACnB,SAAiB,EACjB,QAAiC,EACjC,OAA8D,EAC9D,cAA6B;IAE7B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QAChC,MAAM,eAAe,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,CAAC,QAAQ,CAAC,cAAc,IAAI,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,IAAI,CAAC,+CAA+C,EAAE;gBAC3D,SAAS;gBACT,KAAK,EAAE,eAAe,CAAC,OAAO;aAC/B,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;gBAC5B,MAAM,QAAQ,CAAC,cAAc,CAAC;oBAC5B,SAAS;oBACT,KAAK,EAAE,eAAe;oBACtB,aAAa,EAAE,OAAO,CAAC,aAAa;oBACpC,OAAO,EAAE,OAAO,CAAC,OAAO;iBACzB,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAAC,OAAO,YAAY,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE;gBAC9C,SAAS;gBACT,aAAa,EAAE,eAAe,CAAC,OAAO;gBACtC,YAAY,EAAE,YAAY,YAAY,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;aAC1F,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/backend/services/session/service/acp/acp-runtime-errors.d.ts

@@ -0,0 +1,20 @@
+export declare class PromptTimeoutError extends Error {
+    readonly timeoutMs: number;
+    constructor(sessionId: string, timeoutMs: number);
+}
+export declare class AcpBrowseSessionUnavailableError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+export type AcpSubagentBrowseErrorCode = 'INVALID_INPUT' | 'NOT_FOUND' | 'PRECONDITION_FAILED' | 'INTERNAL_ERROR';
+export declare class AcpSubagentBrowseError extends Error {
+    readonly code: AcpSubagentBrowseErrorCode;
+    constructor(code: AcpSubagentBrowseErrorCode, message: string, options?: ErrorOptions);
+}
+export type AcpErrorLogDetails = {
+    message: string;
+    code?: number | string;
+    data?: unknown;
+};
+export declare function getAcpErrorLogDetails(error: unknown): AcpErrorLogDetails;
+export declare function isMethodNotFoundError(error: unknown): boolean;
+//# sourceMappingURL=acp-runtime-errors.d.ts.map

package/dist/src/backend/services/session/service/acp/acp-runtime-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-runtime-errors.d.ts","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/acp/acp-runtime-errors.ts"],"names":[],"mappings":"AAAA,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,SAAS,EAAE,MAAM;gBADjC,SAAS,EAAE,MAAM,EACD,SAAS,EAAE,MAAM;CAKpC;AAED,qBAAa,gCAAiC,SAAQ,KAAK;gBAC7C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AAED,MAAM,MAAM,0BAA0B,GAClC,eAAe,GACf,WAAW,GACX,qBAAqB,GACrB,gBAAgB,CAAC;AAErB,qBAAa,sBAAuB,SAAQ,KAAK;aAE7B,IAAI,EAAE,0BAA0B;gBAAhC,IAAI,EAAE,0BAA0B,EAChD,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,YAAY;CAKzB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AA8B7F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAmBxE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG7D"}

package/dist/src/backend/services/session/service/acp/acp-runtime-errors.js

@@ -0,0 +1,68 @@
+export class PromptTimeoutError extends Error {
+    timeoutMs;
+    constructor(sessionId, timeoutMs) {
+        super(`ACP prompt timed out after ${timeoutMs}ms for session ${sessionId}`);
+        this.timeoutMs = timeoutMs;
+        this.name = 'PromptTimeoutError';
+    }
+}
+export class AcpBrowseSessionUnavailableError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'AcpBrowseSessionUnavailableError';
+    }
+}
+export class AcpSubagentBrowseError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.code = code;
+        this.name = 'AcpSubagentBrowseError';
+    }
+}
+function getAcpErrorMetadata(error) {
+    const code = typeof error.code === 'number' || typeof error.code === 'string' ? error.code : undefined;
+    return {
+        ...(code !== undefined ? { code } : {}),
+        ...(typeof error.data !== 'undefined' ? { data: error.data } : {}),
+    };
+}
+function stringifyAcpError(error) {
+    try {
+        const serialized = JSON.stringify(error);
+        if (serialized !== undefined) {
+            return serialized;
+        }
+    }
+    catch {
+    }
+    try {
+        return String(error);
+    }
+    catch {
+        return 'Unknown ACP error';
+    }
+}
+export function getAcpErrorLogDetails(error) {
+    if (error instanceof Error) {
+        const maybe = error;
+        return {
+            message: error.message,
+            ...getAcpErrorMetadata(maybe),
+        };
+    }
+    if (typeof error === 'object' && error !== null) {
+        const maybe = error;
+        const message = typeof maybe.message === 'string' ? maybe.message : stringifyAcpError(error);
+        return {
+            message,
+            ...getAcpErrorMetadata(maybe),
+        };
+    }
+    return { message: String(error) };
+}
+export function isMethodNotFoundError(error) {
+    const details = getAcpErrorLogDetails(error);
+    return details.code === -32_601 || details.message.includes('Method not found');
+}
+//# sourceMappingURL=acp-runtime-errors.js.map

package/dist/src/backend/services/session/service/acp/acp-runtime-errors.js.map

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

package/dist/src/backend/services/session/service/acp/acp-runtime-errors.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=acp-runtime-errors.test.d.ts.map

package/dist/src/backend/services/session/service/acp/acp-runtime-errors.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-runtime-errors.test.d.ts","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/acp/acp-runtime-errors.test.ts"],"names":[],"mappings":""}

package/dist/src/backend/services/session/service/acp/acp-runtime-errors.test.js

@@ -0,0 +1,17 @@
+import { describe, expect, it } from 'vitest';
+import { getAcpErrorLogDetails, isMethodNotFoundError } from './acp-runtime-errors.js';
+describe('ACP runtime error normalization', () => {
+    it('falls back to a string when JSON serialization returns undefined', () => {
+        const error = { code: -32_601, toJSON: () => undefined };
+        expect(getAcpErrorLogDetails(error)).toEqual({
+            message: '[object Object]',
+            code: -32_601,
+        });
+    });
+    it('checks method-not-found errors without throwing on undefined JSON output', () => {
+        const error = { toJSON: () => undefined };
+        expect(() => isMethodNotFoundError(error)).not.toThrow();
+        expect(isMethodNotFoundError(error)).toBe(false);
+    });
+});
+//# sourceMappingURL=acp-runtime-errors.test.js.map

package/dist/src/backend/services/session/service/acp/acp-runtime-errors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-runtime-errors.test.js","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/acp/acp-runtime-errors.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAEpF,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAE1E,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;QAEzD,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;YAC3C,OAAO,EAAE,iBAAiB;YAC1B,IAAI,EAAE,CAAC,MAAM;SACd,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,GAAG,EAAE;QAElF,MAAM,KAAK,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;QAE1C,MAAM,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACzD,MAAM,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/backend/services/session/service/acp/acp-runtime-events.d.ts

@@ -1,4 +1,30 @@
 import type { RequestPermissionRequest, SessionNotification } from '@agentclientprotocol/sdk';
+import type { SubagentsChangedParams } from '../../../../../shared/acp-protocol/subagents.js';
+import type { AcpPermissionBridge } from './acp-permission-bridge.js';
+export type AcpRuntimePurpose = 'active' | 'browse';
+export type AcpRuntimeExitEvent = Readonly<{
+    sessionId: string;
+    exitCode: number | null;
+    incarnationId: string;
+    purpose: AcpRuntimePurpose;
+    managed: boolean;
+}>;
+export type AcpRuntimeErrorEvent = Readonly<{
+    sessionId: string;
+    error: Error;
+    incarnationId: string;
+    purpose: AcpRuntimePurpose;
+}>;
+export type AcpRuntimeEventHandlers = {
+    onSessionId?: (sessionId: string, providerSessionId: string) => Promise<void>;
+    onRuntimeExit?: (event: AcpRuntimeExitEvent) => Promise<void>;
+    onRuntimeError?: (event: AcpRuntimeErrorEvent) => Promise<void> | void;
+    onExit?: (sessionId: string, code: number | null) => Promise<void>;
+    onError?: (sessionId: string, error: Error) => Promise<void> | void;
+    onAcpEvent?: (sessionId: string, event: AcpRuntimeEvent) => void;
+    onAcpLog?: (sessionId: string, payload: Record<string, unknown>) => void;
+    permissionBridge?: AcpPermissionBridge;
+};
 export type AcpSessionUpdateEvent = {
     type: 'acp_session_update';
     update: SessionNotification['update'];
@@ -8,5 +34,14 @@ export type AcpPermissionRequestEvent = {
     requestId: string;
     params: RequestPermissionRequest;
 };
-export type AcpRuntimeEvent = AcpSessionUpdateEvent | AcpPermissionRequestEvent;
+export type AcpSubagentsChangedEvent = {
+    type: 'acp_subagents_changed';
+    subagentId: string;
+    change: SubagentsChangedParams['change'];
+};
+export type AcpTaskStatusChangedEvent = {
+    type: 'acp_task_status_changed';
+    active: boolean;
+};
+export type AcpRuntimeEvent = AcpSessionUpdateEvent | AcpPermissionRequestEvent | AcpSubagentsChangedEvent | AcpTaskStatusChangedEvent;
 //# sourceMappingURL=acp-runtime-events.d.ts.map

package/dist/src/backend/services/session/service/acp/acp-runtime-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"acp-runtime-events.d.ts","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/acp/acp-runtime-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE9F,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,wBAAwB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,qBAAqB,GAAG,yBAAyB,CAAC"}
+{"version":3,"file":"acp-runtime-events.d.ts","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/acp/acp-runtime-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC9F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEpD,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,iBAAiB,CAAC;CAC5B,CAAC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG;IACpC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEvE,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpE,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACjE,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAEzE,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,wBAAwB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,yBAAyB,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GACvB,qBAAqB,GACrB,yBAAyB,GACzB,wBAAwB,GACxB,yBAAyB,CAAC"}

package/dist/src/backend/services/session/service/acp/acp-runtime-exit-handler.d.ts

@@ -0,0 +1,5 @@
+import type { AcpRuntimeEventHandlers, AcpRuntimeExitEvent } from './acp-runtime-events.js';
+export declare function guardExit(sessionId: string): void;
+export declare function createExitFence(): readonly [Promise<void>, () => void];
+export declare function dispatchAcpRuntimeExit(handlers: AcpRuntimeEventHandlers, event: AcpRuntimeExitEvent): Promise<void>;
+//# sourceMappingURL=acp-runtime-exit-handler.d.ts.map

package/dist/src/backend/services/session/service/acp/acp-runtime-exit-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-runtime-exit-handler.d.ts","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/acp/acp-runtime-exit-handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAKzF,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAMjD;AAED,wBAAgB,eAAe,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,CAMtE;AAED,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,uBAAuB,EACjC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,IAAI,CAAC,CAef"}

package/dist/src/backend/services/session/service/acp/acp-runtime-exit-handler.js

@@ -0,0 +1,35 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { createLogger } from '../../../../../backend/services/logger.service.js';
+const logger = createLogger('acp-runtime-manager');
+const exitHandlerSession = new AsyncLocalStorage();
+export function guardExit(sessionId) {
+    if (exitHandlerSession.getStore() === sessionId) {
+        throw new Error(`Cannot create ACP client for session ${sessionId} from its runtime exit handler`);
+    }
+}
+export function createExitFence() {
+    let release;
+    const fence = new Promise((resolve) => {
+        release = resolve;
+    });
+    return [fence, release];
+}
+export function dispatchAcpRuntimeExit(handlers, event) {
+    return exitHandlerSession.run(event.sessionId, async () => {
+        try {
+            if (handlers.onRuntimeExit) {
+                await handlers.onRuntimeExit(event);
+            }
+            else if (!event.managed && handlers.onExit) {
+                await handlers.onExit(event.sessionId, event.exitCode);
+            }
+        }
+        catch (error) {
+            logger.warn('Failed to handle ACP exit event', {
+                sessionId: event.sessionId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    });
+}
+//# sourceMappingURL=acp-runtime-exit-handler.js.map

package/dist/src/backend/services/session/service/acp/acp-runtime-exit-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-runtime-exit-handler.js","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/acp/acp-runtime-exit-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAGjE,MAAM,MAAM,GAAG,YAAY,CAAC,qBAAqB,CAAC,CAAC;AACnD,MAAM,kBAAkB,GAAG,IAAI,iBAAiB,EAAU,CAAC;AAE3D,MAAM,UAAU,SAAS,CAAC,SAAiB;IACzC,IAAI,kBAAkB,CAAC,QAAQ,EAAE,KAAK,SAAS,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CACb,wCAAwC,SAAS,gCAAgC,CAClF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,OAAoB,CAAC;IACzB,MAAM,KAAK,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAC1C,OAAO,GAAG,OAAO,CAAC;IACpB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,QAAiC,EACjC,KAA0B;IAE1B,OAAO,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QACxD,IAAI,CAAC;YACH,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;gBAC3B,MAAM,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC;iBAAM,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAC7C,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE;gBAC7C,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/backend/services/session/service/acp/acp-runtime-manager.browsing.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=acp-runtime-manager.browsing.test.d.ts.map

package/dist/src/backend/services/session/service/acp/acp-runtime-manager.browsing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acp-runtime-manager.browsing.test.d.ts","sourceRoot":"","sources":["../../../../../../../src/backend/services/session/service/acp/acp-runtime-manager.browsing.test.ts"],"names":[],"mappings":""}