@xenosystem/agent-interface-host 0.1.3

package/dist/acp/AcpRuntimeEventMapper.js

@@ -0,0 +1,326 @@
+function now() {
+    return new Date().toISOString();
+}
+function toolOutcomeFromMeta(meta) {
+    const xenoMeta = meta?.['xeno.dev'];
+    if (!xenoMeta || typeof xenoMeta !== 'object' || Array.isArray(xenoMeta))
+        return undefined;
+    const outcome = xenoMeta.outcome;
+    return outcome === 'succeeded' || outcome === 'cancelled' || outcome === 'failed'
+        ? outcome
+        : undefined;
+}
+export function mapAcpSessionUpdateToRuntimeEvent(notification, contextOrRequestId) {
+    const update = notification.update;
+    const context = normalizeContext(contextOrRequestId, notification.sessionId);
+    const base = {
+        timestamp: now(),
+        source: 'acp',
+        ...context,
+        acpSessionId: notification.sessionId || context.acpSessionId,
+    };
+    if (update.type === 'agent_message_chunk') {
+        return {
+            type: 'acp.session.message.delta',
+            event: {
+                ...base,
+                type: 'acp.session.message.delta',
+                messageId: update.messageId,
+                text: update.content,
+            },
+        };
+    }
+    if (update.type === 'plan') {
+        return {
+            type: 'acp.session.plan',
+            event: {
+                ...base,
+                type: 'acp.session.plan',
+                content: update.content,
+                entries: update.entries || [],
+            },
+        };
+    }
+    if (update.type === 'tool_call') {
+        return {
+            type: 'acp.tool.started',
+            event: {
+                ...base,
+                type: 'acp.tool.started',
+                toolCallId: update.toolCallId,
+                toolName: update.title || 'ACP Tool',
+                title: update.title,
+                kind: update.kind,
+                status: update.status || 'pending',
+                content: update.content || [],
+                locations: update.locations || [],
+                rawInput: update.rawInput,
+                rawOutput: update.rawOutput,
+            },
+        };
+    }
+    if (update.type === 'tool_call_update') {
+        const outcome = toolOutcomeFromMeta(update._meta);
+        const type = update.status === 'completed'
+            ? 'acp.tool.completed'
+            : update.status === 'failed'
+                ? 'acp.tool.failed'
+                : 'acp.tool.updated';
+        return {
+            type,
+            event: {
+                ...base,
+                type,
+                toolCallId: update.toolCallId,
+                // 🔴 Was `toolName: 'ACP Tool'` — a hardcoded constant on the COMPLETION event, so every
+                // finished ACP tool in the runtime timeline reported the same generic name. The started
+                // event carries the real title, so the fact was recoverable by joining on `toolCallId`,
+                // and anything reading completions alone — a support bundle, a timeline projection, an
+                // audit export — saw a wall of identical names and no way to know they were wrong.
+                //
+                // Now: the agent's title when it sends one, and NOTHING when it does not. A placeholder
+                // that looks like a value is worse than an absent field.
+                ...(update.title ? { toolName: update.title, title: update.title } : {}),
+                status: update.status,
+                content: update.content || [],
+                rawOutput: update.rawOutput,
+                error: update.error,
+                outcome,
+            },
+        };
+    }
+    return {
+        type: 'acp.session.usage',
+        event: {
+            ...base,
+            type: 'acp.session.usage',
+            inputTokens: update.inputTokens,
+            outputTokens: update.outputTokens,
+            totalTokens: update.totalTokens,
+        },
+    };
+}
+export function mapAcpPromptResultToRuntimeEvent(acpSessionId, contextOrRequestId, result) {
+    const context = normalizeContext(contextOrRequestId, acpSessionId);
+    const type = result.stopReason === 'cancelled' ? 'acp.session.cancelled' : 'acp.session.completed';
+    return {
+        type,
+        event: {
+            type,
+            timestamp: now(),
+            ...context,
+            acpSessionId,
+            stopReason: result.stopReason,
+            status: result.stopReason === 'cancelled' ? 'cancelled' : 'completed',
+            ...(result.resumeState ? { acpResumeState: result.resumeState } : {}),
+        },
+    };
+}
+export function mapAcpAgentStartedToRuntimeEvent(context, diagnostics) {
+    return acpLifecycleEvent('acp.agent.started', context, { status: 'starting', agentDiagnostics: diagnostics });
+}
+export function mapAcpAgentReadyToRuntimeEvent(context, diagnostics) {
+    return acpLifecycleEvent('acp.agent.ready', context, { status: 'ready', agentDiagnostics: diagnostics });
+}
+export function mapAcpAgentStderrToRuntimeEvent(context, stderrTail) {
+    return acpLifecycleEvent('acp.agent.stderr', context, { stderrTail: stderrTail.slice(-20) });
+}
+export function mapAcpAgentFailedToRuntimeEvent(context, error, diagnostics) {
+    return acpLifecycleEvent('acp.agent.failed', context, {
+        status: 'failed',
+        error,
+        agentDiagnostics: diagnostics,
+    });
+}
+export function mapAcpAgentExitedToRuntimeEvent(context, diagnostics) {
+    return acpLifecycleEvent('acp.agent.exited', context, {
+        status: 'process_exited',
+        exitCode: diagnostics?.exitCode,
+        signal: diagnostics?.signal,
+        agentDiagnostics: diagnostics,
+    });
+}
+export function mapAcpSessionStartedToRuntimeEvent(context, acpSessionId) {
+    return acpLifecycleEvent('acp.session.started', { ...context, acpSessionId }, { status: 'running' });
+}
+export function mapAcpSessionFailedToRuntimeEvent(context, status, error, diagnostics) {
+    return acpLifecycleEvent('acp.session.failed', context, {
+        status,
+        error,
+        agentDiagnostics: diagnostics,
+    });
+}
+export function mapAcpPermissionRequestedToRuntimeEvent(context, permissionId, request) {
+    return acpLifecycleEvent('acp.session.permission.requested', {
+        ...context,
+        acpSessionId: request.sessionId || context.acpSessionId,
+    }, {
+        permissionId,
+        status: 'pending',
+        prompt: request.prompt,
+        options: (request.options || []).map((option) => option.id),
+        // The id that means "remember this". Carried so a surface can offer an
+        // "always" choice at all: without it the only affordance is allow-once,
+        // and the host-owned policy engine can never be given a rule by a user.
+        ...((request.options || []).find((option) => option.kind === 'allow_always')
+            ? { allowAlwaysOptionId: (request.options || []).find((option) => option.kind === 'allow_always')?.id }
+            : {}),
+        ...((request.options || []).find((option) => option.kind === 'reject_always')
+            ? { rejectAlwaysOptionId: (request.options || []).find((option) => option.kind === 'reject_always')?.id }
+            : {}),
+        // WHAT is being permitted. Previously this event recorded `prompt` (a field
+        // ACP does not send, so always undefined) and bare option ids, which meant
+        // the journal said a permission was requested without ever saying for what.
+        // A reviewer auditing a run could not tell a file read from a delete.
+        ...(request.toolCall
+            ? {
+                toolKind: request.toolCall.kind,
+                toolTitle: request.toolCall.title,
+                toolCallId: request.toolCall.toolCallId,
+                // Paths only — `rawInput` is deliberately NOT journalled: it is
+                // agent-supplied and can carry file contents or secrets, and this
+                // record is redacted-resumable rather than a debug dump.
+                toolPaths: (request.toolCall.locations || []).map((location) => location.path),
+            }
+            : {}),
+    });
+}
+export function mapAcpPermissionDecidedToRuntimeEvent(context, permissionId, outcome, acpSessionId) {
+    const granted = outcome.outcome === 'selected';
+    return acpLifecycleEvent('acp.session.permission.decided', {
+        ...context,
+        acpSessionId: acpSessionId || context.acpSessionId,
+    }, {
+        permissionId,
+        status: granted ? 'granted' : 'denied',
+        allowed: granted,
+        selectedOptionId: outcome.outcome === 'selected' ? outcome.selectedOptionId : undefined,
+        reason: granted ? undefined : 'Permission cancelled.',
+    });
+}
+export function mapAcpChooseDirectoryResultToRuntimeEvent(context, request, result, chooseDirectoryId) {
+    const path = typeof result.path === 'string' && result.path.trim() ? result.path.trim() : undefined;
+    const error = typeof result.error === 'string' && result.error.trim()
+        ? result.error.trim().slice(0, 1000)
+        : undefined;
+    const selected = Boolean(path && !result.cancelled && !result.timedOut && !error);
+    const cancelled = result.cancelled === true && !error;
+    const type = selected
+        ? 'choose_directory.completed'
+        : cancelled
+            ? 'choose_directory.cancelled'
+            : 'choose_directory.failed';
+    const status = selected
+        ? 'completed'
+        : cancelled
+            ? 'cancelled'
+            : result.timedOut
+                ? 'timed_out'
+                : 'failed';
+    const outcome = selected ? 'succeeded' : cancelled ? 'cancelled' : 'failed';
+    const summary = selected
+        ? `Selected folder: ${path}`
+        : cancelled
+            ? 'Folder selection cancelled.'
+            : error || (result.timedOut ? 'Folder selection timed out.' : 'Folder selection failed.');
+    return acpLifecycleEvent(type, {
+        ...context,
+        acpSessionId: request.sessionId || context.acpSessionId,
+    }, {
+        chooseDirectoryId,
+        toolCallId: request.toolCallId,
+        toolName: 'ChooseDirectory',
+        title: request.title,
+        status,
+        outcome,
+        success: selected,
+        path,
+        result: summary,
+        error: selected || cancelled ? undefined : summary,
+        artifacts: selected
+            ? [{ type: 'directory', label: path, value: path }]
+            : undefined,
+    });
+}
+export function mapAcpChooseWorkspacePlacementResultToRuntimeEvent(context, request, result, workspacePlacementId) {
+    const choice = result.choice === 'inbox' || result.choice === 'reuse' || result.choice === 'create'
+        ? result.choice
+        : undefined;
+    const error = typeof result.error === 'string' && result.error.trim()
+        ? result.error.trim().slice(0, 1000)
+        : undefined;
+    const completed = Boolean(choice && !result.cancelled && !result.timedOut && !error);
+    const cancelled = result.cancelled === true && !error;
+    const type = completed
+        ? 'workspace_placement.completed'
+        : cancelled
+            ? 'workspace_placement.cancelled'
+            : 'workspace_placement.failed';
+    const status = completed
+        ? 'completed'
+        : cancelled
+            ? 'cancelled'
+            : result.timedOut
+                ? 'timed_out'
+                : 'failed';
+    const outcome = completed ? 'succeeded' : cancelled ? 'cancelled' : 'failed';
+    const summary = completed
+        ? result.result || `Workspace placement selected: ${choice}`
+        : cancelled
+            ? 'Workspace placement cancelled.'
+            : error || (result.timedOut ? 'Workspace placement timed out.' : 'Workspace placement failed.');
+    return acpLifecycleEvent(type, {
+        ...context,
+        acpSessionId: request.sessionId || context.acpSessionId,
+    }, {
+        workspacePlacementId,
+        toolCallId: request.toolCallId,
+        toolName: 'ChooseWorkspacePlacement',
+        title: request.title,
+        status,
+        outcome,
+        success: completed,
+        choice,
+        directory: result.directory || request.directory,
+        workspaceName: result.workspaceName,
+        result: summary,
+        error: completed || cancelled ? undefined : summary,
+    });
+}
+function acpLifecycleEvent(type, context, extra = {}) {
+    return {
+        type,
+        event: {
+            type,
+            timestamp: now(),
+            source: 'acp',
+            ...normalizeContext(context, context.acpSessionId),
+            ...extra,
+        },
+    };
+}
+function normalizeContext(contextOrRequestId, acpSessionId) {
+    if (typeof contextOrRequestId === 'string') {
+        return {
+            conversationId: '',
+            requestId: contextOrRequestId,
+            acpSessionId,
+            acpProcessId: 'acp-process-unknown',
+            acpAgentConfigId: 'acp-agent-unknown',
+            providerKind: 'acp-provider',
+            providerId: 'acp-agent-unknown',
+            schemaVersion: 1,
+            redactionState: 'redacted',
+        };
+    }
+    const acpAgentConfigId = contextOrRequestId.acpAgentConfigId || 'acp-agent-unknown';
+    return {
+        schemaVersion: 1,
+        redactionState: 'redacted',
+        providerKind: 'acp-provider',
+        providerId: acpAgentConfigId,
+        ...contextOrRequestId,
+        acpSessionId: acpSessionId || contextOrRequestId.acpSessionId,
+    };
+}
+//# sourceMappingURL=AcpRuntimeEventMapper.js.map

package/dist/acp/AcpRuntimeEventMapper.js.map

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

package/dist/acp/AcpSessionService.d.ts

@@ -0,0 +1,65 @@
+import { RuntimeEventStore } from '../runtime/RuntimeEventStore.js';
+import type { RuntimeEventEnvelope } from '../runtime/runtimeEventTypes.js';
+import { type CoordinationLanePort } from '../coordination/laneBridge.js';
+import type { RunActivityListener } from '../coordination/query.js';
+import { type AcpPermissionBridge } from './AcpPermissionBridge.js';
+import { type AcpHostBridge } from './AcpHostBridge.js';
+import type { AcpSessionRunRequest, AcpSessionRunResult } from './acpTypes.js';
+export interface AcpSessionServiceOptions {
+    runtimeStore?: undefined | RuntimeEventStore;
+    onRuntimeEvent?: undefined | ((event: RuntimeEventEnvelope) => void);
+    rootDir?: undefined | string;
+    permissionBridge?: undefined | AcpPermissionBridge;
+    hostBridge?: undefined | AcpHostBridge;
+    /**
+     * Coordination — §5.2b. A PORT, not the service: what an ACP agent may do is
+     * exactly the four calls below, and handing the whole `CoordinationService`
+     * across this boundary would make `endRun` and `setInboundPolicy` reachable
+     * from a lane that must not have them.
+     */
+    coordinationPort?: undefined | CoordinationLanePort;
+    /** Run state + last decision — §7. See `RuntimeRecordingAcpPermissionBridge`. */
+    onRunActivity?: undefined | RunActivityListener;
+    requestTimeoutMs?: undefined | number;
+}
+export interface AcpSessionBatchRunRequest {
+    config: AcpSessionRunRequest['config'];
+    prompts: Array<Omit<AcpSessionRunRequest, 'config'>>;
+    timeoutMs?: undefined | number;
+}
+export declare class AcpSessionService {
+    private readonly rootDir?;
+    private readonly runtimeStore;
+    private readonly onRuntimeEvent?;
+    private readonly permissionBridge;
+    private readonly hostBridge;
+    private readonly coordinationPort;
+    private readonly onRunActivity;
+    private readonly requestTimeoutMs;
+    private readonly conversationSessions;
+    private readonly conversationPromptTails;
+    constructor(options?: AcpSessionServiceOptions);
+    runPrompt(request: AcpSessionRunRequest): Promise<AcpSessionRunResult>;
+    runConversationPrompt(request: AcpSessionRunRequest): Promise<AcpSessionRunResult>;
+    private runConversationPromptExclusive;
+    closeConversationSessions(): Promise<void>;
+    closeConversation(conversationId: string, configId?: undefined | string): Promise<number>;
+    runPromptBatch(request: AcpSessionBatchRunRequest): Promise<AcpSessionRunResult[]>;
+    private runSinglePrompt;
+    private runExistingSessionPrompt;
+    private closeConversationSession;
+    private appendRuntimeEvent;
+    private appendLifecycleEvent;
+    private emitStderrIfPresent;
+    private listEventCount;
+    private workspaceKeyFor;
+    private sessionExecutionMeta;
+    private workspaceFingerprintFor;
+    private agentConfigFingerprintFor;
+    private resolveConversationCwd;
+}
+export declare function buildAcpConversationReplayPrompt(history: Array<{
+    role: 'user' | 'assistant';
+    content: string;
+}>, currentPrompt: string): string;
+//# sourceMappingURL=AcpSessionService.d.ts.map

package/dist/acp/AcpSessionService.d.ts.map

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