@xenosystem/agent-interface-host 0.1.3

package/dist/acp/AcpCoordinationBridge.js

@@ -0,0 +1,13 @@
+/**
+ * The ACP lane's NAMES for the coordination primitives — nothing more.
+ *
+ * 🔴 The bridge itself is LANE-NEUTRAL and lives in
+ * `coordination/laneBridge.ts`, because the SDK lane offers the same three
+ * calls as registered tools and must not import from the ACP lane to do it.
+ * What belongs here is only the mapping from this protocol's method names onto
+ * those calls.
+ */
+export const XENO_ACP_COORDINATION_SEND_METHOD = 'xeno.dev/coordination_send';
+export const XENO_ACP_COORDINATION_QUERY_METHOD = 'xeno.dev/coordination_query';
+export const XENO_ACP_COORDINATION_CLAIM_METHOD = 'xeno.dev/coordination_claim';
+//# sourceMappingURL=AcpCoordinationBridge.js.map

package/dist/acp/AcpCoordinationBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AcpCoordinationBridge.js","sourceRoot":"","sources":["../../src/acp/AcpCoordinationBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,4BAA4B,CAAA;AAC7E,MAAM,CAAC,MAAM,kCAAkC,GAAG,6BAA6B,CAAA;AAC/E,MAAM,CAAC,MAAM,kCAAkC,GAAG,6BAA6B,CAAA"}

package/dist/acp/AcpDiagnosticsService.d.ts

@@ -0,0 +1,61 @@
+import type { AcpDiagnostics, AcpSessionStatus } from './acpTypes.js';
+export interface AcpSupportSessionDiagnostics {
+    conversationId: string;
+    requestId: string;
+    acpSessionId: string;
+    acpProcessId?: undefined | string;
+    acpAgentConfigId?: undefined | string;
+    status: AcpSessionStatus | 'unknown';
+    eventCount: number;
+    pendingPermissionCount: number;
+    toolCount: number;
+    failedToolCount: number;
+    lastEventType?: undefined | string;
+    lastEventAt?: undefined | string;
+    lastStopReason?: undefined | string;
+    lastError?: undefined | string;
+}
+export interface AcpSupportAgentDiagnostics {
+    acpAgentConfigId: string;
+    name?: undefined | string;
+    command?: undefined | string;
+    args?: undefined | string[];
+    cwd?: undefined | string;
+    envKeys: string[];
+    status?: undefined | string;
+    pid?: undefined | number;
+    protocolVersion?: undefined | number;
+    agentInfo?: undefined | AcpDiagnostics['agentInfo'];
+    agentCapabilities?: undefined | Record<string, unknown>;
+    activeSessionCount?: undefined | number;
+    pendingRequestCount?: undefined | number;
+    lifecycleTail: AcpDiagnostics['lifecycle'];
+    stderrTail: string[];
+    malformedMessageCount: number;
+    unsupportedMethodCount: number;
+    lastErrorCode?: undefined | string;
+    exitCode?: undefined | number | null;
+    signal?: undefined | NodeJS.Signals | null;
+}
+export interface AcpSupportDiagnosticsSummary {
+    success: boolean;
+    protocol: 'acp-v1-stdio';
+    eventCount: number;
+    sessionCount: number;
+    activeSessionCount: number;
+    failedSessionCount: number;
+    pendingRequestCount: number;
+    pendingPermissionCount: number;
+    malformedMessageCount: number;
+    stderrLineCount: number;
+    agents: AcpSupportAgentDiagnostics[];
+    sessions: AcpSupportSessionDiagnostics[];
+    lastError?: undefined | string;
+}
+export declare class AcpDiagnosticsService {
+    private readonly rootDir;
+    constructor(rootDir?: string);
+    collect(): AcpSupportDiagnosticsSummary;
+}
+export declare function collectAcpDiagnosticsSummary(rootDir?: string): AcpSupportDiagnosticsSummary;
+//# sourceMappingURL=AcpDiagnosticsService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcpDiagnosticsService.d.ts","sourceRoot":"","sources":["../../src/acp/AcpDiagnosticsService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAGrE,MAAM,WAAW,4BAA4B;IAC3C,cAAc,EAAE,MAAM,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACjC,gBAAgB,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACrC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAA;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,sBAAsB,EAAE,MAAM,CAAA;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IAClC,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IAChC,cAAc,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACnC,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE,MAAM,CAAA;IACxB,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACzB,OAAO,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IAC5B,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,EAAE,CAAA;IAC3B,GAAG,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACxB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IAC3B,GAAG,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACxB,eAAe,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACpC,SAAS,CAAC,EAAE,SAAS,GAAG,cAAc,CAAC,WAAW,CAAC,CAAA;IACnD,iBAAiB,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvD,kBAAkB,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACvC,mBAAmB,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACxC,aAAa,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;IAC1C,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,qBAAqB,EAAE,MAAM,CAAA;IAC7B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,aAAa,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IAClC,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAAA;IACpC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,OAAO,GAAG,IAAI,CAAA;CAC3C;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,cAAc,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,qBAAqB,EAAE,MAAM,CAAA;IAC7B,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,0BAA0B,EAAE,CAAA;IACpC,QAAQ,EAAE,4BAA4B,EAAE,CAAA;IACxC,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;CAC/B;AAID,qBAAa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,SAAmB;IAEvD,OAAO,IAAI,4BAA4B;CAGxC;AAED,wBAAgB,4BAA4B,CAAC,OAAO,SAAmB,GAAG,4BAA4B,CAmFrG"}

package/dist/acp/AcpDiagnosticsService.js

@@ -0,0 +1,203 @@
+import { homedir } from 'os';
+import { join } from 'path';
+import { RuntimeEventStore } from '../runtime/RuntimeEventStore.js';
+import { redactAcpArgs, redactAcpEnvKeys, redactAcpPath, redactAcpText } from './acpRedaction.js';
+const DEFAULT_XENO_DIR = join(homedir(), '.xeno');
+export class AcpDiagnosticsService {
+    rootDir;
+    constructor(rootDir = DEFAULT_XENO_DIR) {
+        this.rootDir = rootDir;
+    }
+    collect() {
+        return collectAcpDiagnosticsSummary(this.rootDir);
+    }
+}
+export function collectAcpDiagnosticsSummary(rootDir = DEFAULT_XENO_DIR) {
+    try {
+        const store = new RuntimeEventStore(join(rootDir, 'runtime-events'));
+        const sessions = new Map();
+        const agents = new Map();
+        let eventCount = 0;
+        let pendingRequestCount = 0;
+        let pendingPermissionCount = 0;
+        let malformedMessageCount = 0;
+        let stderrLineCount = 0;
+        let lastError;
+        for (const conversationId of store.listConversationIds()) {
+            const listed = store.list({ conversationId, limit: 5000 });
+            for (const event of listed.events) {
+                if (!event.type.startsWith('acp.'))
+                    continue;
+                eventCount += 1;
+                const payload = event.event;
+                const session = isSessionScopedEvent(event) ? sessionFor(sessions, event) : undefined;
+                if (session) {
+                    session.eventCount += 1;
+                    session.lastEventType = event.type;
+                    session.lastEventAt = event.timestamp;
+                    updateSessionFromEvent(session, event);
+                }
+                updateAgentFromEvent(agents, event);
+                if (event.type === 'acp.session.permission.requested') {
+                    pendingPermissionCount += 1;
+                    if (session)
+                        session.pendingPermissionCount += 1;
+                }
+                if (event.type === 'acp.session.permission.decided') {
+                    pendingPermissionCount = Math.max(0, pendingPermissionCount - 1);
+                    if (session)
+                        session.pendingPermissionCount = Math.max(0, session.pendingPermissionCount - 1);
+                }
+                if (event.type === 'acp.tool.started' && session)
+                    session.toolCount += 1;
+                if (event.type === 'acp.tool.failed' && session)
+                    session.failedToolCount += 1;
+                if (typeof payload.error === 'string')
+                    lastError = redactAcpText(payload.error);
+            }
+        }
+        for (const agent of agents.values()) {
+            pendingRequestCount += agent.pendingRequestCount || 0;
+            malformedMessageCount += agent.malformedMessageCount;
+            stderrLineCount += agent.stderrTail.length;
+        }
+        const sessionList = Array.from(sessions.values()).sort((left, right) => ((Date.parse(right.lastEventAt || '') || 0) - (Date.parse(left.lastEventAt || '') || 0)));
+        const agentList = Array.from(agents.values()).sort((left, right) => left.acpAgentConfigId.localeCompare(right.acpAgentConfigId));
+        return {
+            success: true,
+            protocol: 'acp-v1-stdio',
+            eventCount,
+            sessionCount: sessionList.length,
+            activeSessionCount: sessionList.filter((session) => session.status === 'running' || session.status === 'waiting_permission').length,
+            failedSessionCount: sessionList.filter((session) => session.status === 'failed' || session.status === 'timed_out' || session.status === 'process_exited').length,
+            pendingRequestCount,
+            pendingPermissionCount,
+            malformedMessageCount,
+            stderrLineCount,
+            agents: agentList.slice(0, 25),
+            sessions: sessionList.slice(0, 50),
+            lastError,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            protocol: 'acp-v1-stdio',
+            eventCount: 0,
+            sessionCount: 0,
+            activeSessionCount: 0,
+            failedSessionCount: 0,
+            pendingRequestCount: 0,
+            pendingPermissionCount: 0,
+            malformedMessageCount: 0,
+            stderrLineCount: 0,
+            agents: [],
+            sessions: [],
+            lastError: error instanceof Error ? redactAcpText(error.message) : redactAcpText(String(error)),
+        };
+    }
+}
+function isSessionScopedEvent(event) {
+    return typeof event.event.acpSessionId === 'string'
+        || event.type.startsWith('acp.session.')
+        || event.type.startsWith('acp.tool.');
+}
+function sessionFor(sessions, event) {
+    const payload = event.event;
+    const acpSessionId = stringValue(payload.acpSessionId) || `${event.conversationId}:${event.requestId}`;
+    const key = `${event.conversationId}:${event.requestId}:${acpSessionId}`;
+    const existing = sessions.get(key);
+    if (existing)
+        return existing;
+    const session = {
+        conversationId: event.conversationId,
+        requestId: event.requestId,
+        acpSessionId,
+        acpProcessId: stringValue(payload.acpProcessId),
+        acpAgentConfigId: stringValue(payload.acpAgentConfigId),
+        status: 'unknown',
+        eventCount: 0,
+        pendingPermissionCount: 0,
+        toolCount: 0,
+        failedToolCount: 0,
+    };
+    sessions.set(key, session);
+    return session;
+}
+function updateSessionFromEvent(session, event) {
+    const payload = event.event;
+    const status = stringValue(payload.status);
+    if (event.type === 'acp.session.started')
+        session.status = 'running';
+    if (event.type === 'acp.session.permission.requested')
+        session.status = 'waiting_permission';
+    if (event.type === 'acp.session.permission.decided' && session.status === 'waiting_permission')
+        session.status = 'running';
+    if (event.type === 'acp.session.completed')
+        session.status = 'completed';
+    if (event.type === 'acp.session.cancelled')
+        session.status = 'cancelled';
+    if (event.type === 'acp.session.failed')
+        session.status = statusForDiagnostics(status);
+    if (typeof payload.stopReason === 'string')
+        session.lastStopReason = payload.stopReason;
+    if (typeof payload.error === 'string')
+        session.lastError = redactAcpText(payload.error);
+}
+function updateAgentFromEvent(agents, event) {
+    const payload = event.event;
+    const diagnostics = asDiagnostics(payload.agentDiagnostics);
+    const acpAgentConfigId = stringValue(payload.acpAgentConfigId) || diagnostics?.agentConfigId || 'acp-agent-unknown';
+    const existing = agents.get(acpAgentConfigId);
+    const agent = existing || {
+        acpAgentConfigId,
+        envKeys: [],
+        lifecycleTail: [],
+        stderrTail: [],
+        malformedMessageCount: 0,
+        unsupportedMethodCount: 0,
+    };
+    if (diagnostics) {
+        agent.command = diagnostics.command ? redactAcpPath(diagnostics.command) : agent.command;
+        agent.args = diagnostics.args ? redactAcpArgs(diagnostics.args) : agent.args;
+        agent.cwd = redactAcpPath(diagnostics.cwd);
+        agent.envKeys = redactAcpEnvKeys(Object.fromEntries((diagnostics.envKeys || []).map((key) => [key, 'redacted'])));
+        agent.status = diagnostics.status;
+        agent.pid = diagnostics.pid;
+        agent.protocolVersion = diagnostics.protocolVersion;
+        agent.agentInfo = diagnostics.agentInfo;
+        agent.agentCapabilities = diagnostics.agentCapabilities;
+        agent.activeSessionCount = diagnostics.activeSessionCount;
+        agent.pendingRequestCount = diagnostics.pendingRequestCount;
+        agent.lifecycleTail = (diagnostics.lifecycle || []).slice(-20);
+        agent.stderrTail = (diagnostics.stderrTail || []).map((line) => redactAcpText(line)).slice(-20);
+        agent.malformedMessageCount = diagnostics.malformedMessageCount || 0;
+        agent.unsupportedMethodCount = diagnostics.unsupportedMethodCount || 0;
+        agent.lastErrorCode = diagnostics.lastErrorCode;
+        agent.exitCode = diagnostics.exitCode;
+        agent.signal = diagnostics.signal;
+    }
+    if (Array.isArray(payload.stderrTail)) {
+        agent.stderrTail = payload.stderrTail
+            .filter((line) => typeof line === 'string')
+            .map((line) => redactAcpText(line))
+            .slice(-20);
+    }
+    agents.set(acpAgentConfigId, agent);
+}
+function asDiagnostics(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+function stringValue(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+function statusForDiagnostics(value) {
+    if (value === 'timed_out')
+        return 'timed_out';
+    if (value === 'process_exited')
+        return 'process_exited';
+    if (value === 'cancelled')
+        return 'cancelled';
+    return 'failed';
+}
+//# sourceMappingURL=AcpDiagnosticsService.js.map

package/dist/acp/AcpDiagnosticsService.js.map

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

package/dist/acp/AcpExternalCertificationHarness.d.ts

@@ -0,0 +1,47 @@
+import { type ProviderCertificationStatus } from '@xenosystem/acp-provider-manager';
+import type { AcpAgentCertification, AcpAgentConfig, AcpAgentTestResult } from './acpTypes.js';
+export type AcpExternalCertificationStatus = ProviderCertificationStatus;
+export interface AcpExternalCertificationOptions {
+    registryRoot: string;
+    evidenceDir?: undefined | string;
+    fixtureSimulation?: undefined | boolean;
+    requestTimeoutMs?: undefined | number;
+}
+export interface AcpExternalCertificationResult {
+    status: AcpExternalCertificationStatus;
+    realExternalAttempted: boolean;
+    fixtureSimulation: boolean;
+    agentId: string;
+    agentName: string;
+    commandBasename: string;
+    argsCount: number;
+    envKeys: string[];
+    protocolVersion?: undefined | number;
+    agentInfo?: undefined | AcpAgentTestResult['agentInfo'];
+    stopReason?: undefined | string;
+    updateCount: number;
+    certification: AcpAgentCertification;
+    diagnostics: {
+        agentConfigId?: undefined | string;
+        status?: undefined | string;
+        protocolVersion?: undefined | number;
+        activeSessionCount?: undefined | number;
+        pendingRequestCount?: undefined | number;
+        stderrTail?: undefined | string[];
+        lifecycleCount?: undefined | number;
+        malformedMessageCount?: undefined | number;
+        unsupportedMethodCount?: undefined | number;
+        lastErrorCode?: undefined | string;
+        exitCode?: undefined | number | null;
+        signal?: undefined | NodeJS.Signals | null;
+    };
+    error?: undefined | string;
+}
+export declare function validateAcpExternalCertificationConfig(input: unknown): {
+    valid: boolean;
+    errors: string[];
+    config?: undefined | AcpAgentConfig;
+};
+export declare function runAcpExternalCertification(input: unknown, options: AcpExternalCertificationOptions): Promise<AcpExternalCertificationResult>;
+export declare function writeAcpExternalCertificationEvidence(evidenceDir: string, result: AcpExternalCertificationResult): void;
+//# sourceMappingURL=AcpExternalCertificationHarness.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AcpExternalCertificationHarness.d.ts","sourceRoot":"","sources":["../../src/acp/AcpExternalCertificationHarness.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,2BAA2B,EACjC,MAAM,kCAAkC,CAAA;AAQzC,OAAO,KAAK,EAAE,qBAAqB,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAE9F,MAAM,MAAM,8BAA8B,GAAG,2BAA2B,CAAA;AAExE,MAAM,WAAW,+BAA+B;IAC9C,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IAChC,iBAAiB,CAAC,EAAE,SAAS,GAAG,OAAO,CAAA;IACvC,gBAAgB,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;CACtC;AAED,MAAM,WAAW,8BAA8B;IAC7C,MAAM,EAAE,8BAA8B,CAAA;IACtC,qBAAqB,EAAE,OAAO,CAAA;IAC9B,iBAAiB,EAAE,OAAO,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,eAAe,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACpC,SAAS,CAAC,EAAE,SAAS,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAA;IACvD,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IAC/B,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,qBAAqB,CAAA;IACpC,WAAW,EAAE;QACX,aAAa,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;QAClC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;QAC3B,eAAe,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;QACpC,kBAAkB,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;QACvC,mBAAmB,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;QACxC,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,EAAE,CAAA;QACjC,cAAc,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;QACnC,qBAAqB,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;QAC1C,sBAAsB,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;QAC3C,aAAa,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;QAClC,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAAA;QACpC,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC,OAAO,GAAG,IAAI,CAAA;KAC3C,CAAA;IACD,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;CAC3B;AAED,wBAAgB,sCAAsC,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,GAAG,cAAc,CAAA;CAAE,CAUhJ;AAED,wBAAsB,2BAA2B,CAC/C,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,8BAA8B,CAAC,CA2CzC;AAED,wBAAgB,qCAAqC,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,8BAA8B,GAAG,IAAI,CAwCvH"}

package/dist/acp/AcpExternalCertificationHarness.js

@@ -0,0 +1,176 @@
+import { existsSync, mkdirSync, writeFileSync } from 'fs';
+import { basename, join } from 'path';
+import { classifyProviderCertification, createProviderCertificationRecord, } from '@xenosystem/acp-provider-manager';
+import { AcpAgentRegistryService, isFixtureAcpAgentConfig, normalizeAcpAgentConfig, validateAcpAgentConfig, } from './AcpAgentRegistryService.js';
+import { redactAcpText } from './acpRedaction.js';
+export function validateAcpExternalCertificationConfig(input) {
+    const config = normalizeAcpAgentConfig(input);
+    const validation = validateAcpAgentConfig(input);
+    if (!config || !validation.valid) {
+        return { valid: false, errors: validation.errors.length ? validation.errors : ['Invalid ACP external certification config.'] };
+    }
+    if (!config.enabled) {
+        return { valid: false, errors: ['ACP external certification config must be enabled.'] };
+    }
+    return { valid: true, errors: [], config };
+}
+export async function runAcpExternalCertification(input, options) {
+    const validation = validateAcpExternalCertificationConfig(input);
+    if (!validation.valid || !validation.config) {
+        throw new Error(validation.errors.join(' '));
+    }
+    mkdirSync(options.registryRoot, { recursive: true });
+    const service = new AcpAgentRegistryService({
+        rootDir: options.registryRoot,
+        requestTimeoutMs: options.requestTimeoutMs || 5_000,
+    });
+    const config = validation.config;
+    const fixtureSimulation = !!options.fixtureSimulation || isFixtureAcpAgentConfig(config);
+    const realExternalAttempted = !fixtureSimulation;
+    if (!service.getAgentInternal(config.id)) {
+        const saved = service.saveAgent(config);
+        if (!saved.success)
+            throw new Error(saved.error || 'Failed to save ACP external certification config.');
+    }
+    let result;
+    if (!existsSync(config.command)) {
+        result = buildCertificationResult(config, {
+            status: 'BLOCKED_BY_ENVIRONMENT',
+            realExternalAttempted,
+            fixtureSimulation,
+            updateCount: 0,
+            error: 'ACP external certification command does not exist in this environment.',
+        });
+    }
+    else {
+        const tested = await service.testAgent(config.id, { allowExternal: true });
+        result = buildCertificationResult(config, {
+            status: classifyProviderCertification(toProviderCertificationProbe(tested), fixtureSimulation),
+            realExternalAttempted,
+            fixtureSimulation,
+            tested,
+            updateCount: tested.updateCount,
+            error: tested.error,
+        });
+    }
+    service.setAgentCertification(config.id, result.certification, { includeRuntimeStatus: false });
+    if (options.evidenceDir)
+        writeAcpExternalCertificationEvidence(options.evidenceDir, result);
+    return result;
+}
+export function writeAcpExternalCertificationEvidence(evidenceDir, result) {
+    mkdirSync(evidenceDir, { recursive: true });
+    if (result.fixtureSimulation) {
+        writeFileSync(join(evidenceDir, 'cert-fixture-simulation.json'), `${JSON.stringify(result, null, 2)}\n`, 'utf-8');
+        writeFileSync(join(evidenceDir, 'cert-fixture-simulation.txt'), summarizeCertificationResult(result), 'utf-8');
+        writeFileSync(join(evidenceDir, 'cert-real-external-status.txt'), [
+            'real_external_agent_attempted: no',
+            'status: BLOCKED_BY_ENVIRONMENT',
+            'reason: no explicit real external ACP config was provided; fixture simulation was used to certify the harness only.',
+            '',
+        ].join('\n'), 'utf-8');
+    }
+    else {
+        writeFileSync(join(evidenceDir, 'cert-real-external-status.txt'), summarizeCertificationResult(result), 'utf-8');
+        writeFileSync(join(evidenceDir, 'cert-real-external-output-redacted.txt'), `${JSON.stringify(result, null, 2)}\n`, 'utf-8');
+    }
+    writeFileSync(join(evidenceDir, 'cert-security-scan.md'), [
+        '# AGENT-009E Certification Security Classification',
+        '',
+        '- auto-install: not used',
+        '- marketplace: not used',
+        '- downloads: not used',
+        '- renderer launch: not used',
+        '- raw ACP channel: not used',
+        '- registry-backed testAgent: used',
+        '- command exposure: basename only',
+        '- args exposure: count only',
+        '- env exposure: keys only',
+        '',
+    ].join('\n'), 'utf-8');
+    writeFileSync(join(evidenceDir, 'cert-environment.md'), [
+        '# AGENT-009E Certification Environment',
+        '',
+        `real_external_agent_attempted: ${result.realExternalAttempted ? 'yes' : 'no'}`,
+        `fixture_simulation: ${result.fixtureSimulation ? 'yes' : 'no'}`,
+        `status: ${result.status}`,
+        `command_basename: ${result.commandBasename}`,
+        `args_count: ${result.argsCount}`,
+        `env_keys: ${result.envKeys.join(', ') || '(none)'}`,
+        '',
+    ].join('\n'), 'utf-8');
+}
+function buildCertificationResult(config, input) {
+    const certification = buildCertification(config, input.status, input.tested, input.error);
+    return {
+        status: input.status,
+        realExternalAttempted: input.realExternalAttempted,
+        fixtureSimulation: input.fixtureSimulation,
+        agentId: redactAcpText(config.id, 200),
+        agentName: redactAcpText(config.name, 500),
+        commandBasename: basename(config.command) || '[redacted-command]',
+        argsCount: config.args.length,
+        envKeys: Object.keys(config.env || {}).sort(),
+        protocolVersion: input.tested?.protocolVersion,
+        agentInfo: input.tested?.agentInfo,
+        stopReason: input.tested?.stopReason,
+        updateCount: input.updateCount,
+        certification,
+        diagnostics: {
+            agentConfigId: input.tested?.diagnostics?.agentConfigId,
+            status: input.tested?.diagnostics?.status,
+            protocolVersion: input.tested?.diagnostics?.protocolVersion,
+            activeSessionCount: input.tested?.diagnostics?.activeSessionCount,
+            pendingRequestCount: input.tested?.diagnostics?.pendingRequestCount,
+            stderrTail: (input.tested?.diagnostics?.stderrTail || []).map((line) => redactAcpText(line, 500)),
+            lifecycleCount: input.tested?.diagnostics?.lifecycle?.length,
+            malformedMessageCount: input.tested?.diagnostics?.malformedMessageCount,
+            unsupportedMethodCount: input.tested?.diagnostics?.unsupportedMethodCount,
+            lastErrorCode: input.tested?.diagnostics?.lastErrorCode,
+            exitCode: input.tested?.diagnostics?.exitCode,
+            signal: input.tested?.diagnostics?.signal,
+        },
+        error: input.error ? redactAcpText(input.error, 1000) : undefined,
+    };
+}
+function buildCertification(config, status, tested, error) {
+    return createProviderCertificationRecord({
+        status,
+        providerName: config.name,
+        ...(tested ? { tested: toProviderCertificationProbe(tested) } : {}),
+        ...(error ? { error: redactAcpText(error, 500) } : {}),
+    });
+}
+function toProviderCertificationProbe(tested) {
+    return {
+        success: tested.success,
+        ...(typeof tested.protocolVersion === 'number' ? { protocolVersion: tested.protocolVersion } : {}),
+        ...(tested.agentInfo ? {
+            agentInfo: {
+                name: tested.agentInfo.name,
+                version: tested.agentInfo.version,
+            },
+        } : {}),
+        ...(tested.error ? { error: tested.error } : {}),
+    };
+}
+function summarizeCertificationResult(result) {
+    return [
+        `status: ${result.status}`,
+        `real_external_agent_attempted: ${result.realExternalAttempted ? 'yes' : 'no'}`,
+        `fixture_simulation: ${result.fixtureSimulation ? 'yes' : 'no'}`,
+        `agent_id: ${result.agentId}`,
+        `agent_name: ${result.agentName}`,
+        `command_basename: ${result.commandBasename}`,
+        `args_count: ${result.argsCount}`,
+        `env_keys: ${result.envKeys.join(', ') || '(none)'}`,
+        `protocol_version: ${result.protocolVersion || '(none)'}`,
+        `agent_info: ${result.agentInfo ? JSON.stringify(result.agentInfo) : '(none)'}`,
+        `stop_reason: ${result.stopReason || '(none)'}`,
+        `update_count: ${result.updateCount}`,
+        `certification_status: ${result.certification.status}`,
+        `error: ${result.error || '(none)'}`,
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=AcpExternalCertificationHarness.js.map

package/dist/acp/AcpExternalCertificationHarness.js.map

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

package/dist/acp/AcpHostBridge.d.ts

@@ -0,0 +1,81 @@
+import { type CoordinationLaneBridge } from '../coordination/laneBridge.js';
+export declare const XENO_ACP_META_KEY = "xeno.dev";
+export declare const XENO_ACP_CHOOSE_DIRECTORY_METHOD = "xeno.dev/choose_directory";
+export declare const XENO_ACP_CHOOSE_WORKSPACE_PLACEMENT_METHOD = "xeno.dev/choose_workspace_placement";
+/**
+ * Every host method an ACP agent may call, by the name it is ADVERTISED under.
+ *
+ * 🔴 ONE table, because dispatch and advertisement are two halves of the same
+ * fact and a method with only one of them is unreachable.
+ *
+ * Advertisement is not documentation: `initialize` sends this list, and an
+ * agent that never receives a method's name never calls it. A dispatcher
+ * handling a method nobody was told about is "built, tested, unreachable"
+ * wearing a protocol — the shape this repo has now hit five times. Deriving the
+ * advertisement from this array makes the mismatch unrepresentable rather than
+ * merely tested for; a mutation setting one entry to `false` no longer compiles
+ * into anything, because there is nowhere to write it.
+ */
+export declare const XENO_ACP_HOST_REQUEST_METHODS: {
+    readonly chooseDirectory: "xeno.dev/choose_directory";
+    readonly chooseWorkspacePlacement: "xeno.dev/choose_workspace_placement";
+    readonly coordinationSend: "xeno.dev/coordination_send";
+    readonly coordinationQuery: "xeno.dev/coordination_query";
+    readonly coordinationClaim: "xeno.dev/coordination_claim";
+};
+/** The `_meta['xeno.dev'].hostRequests` payload, derived, never hand-listed. */
+export declare function xenoAcpHostRequestAdvertisement(): Record<string, true>;
+export interface AcpChooseDirectoryRequest {
+    sessionId?: undefined | string;
+    requestId?: undefined | string;
+    title?: undefined | string;
+    toolCallId?: undefined | string;
+    emitRuntimeEvent?: undefined | ((event: Record<string, unknown>) => void);
+}
+export interface AcpChooseDirectoryResult {
+    path?: undefined | string;
+    cancelled?: undefined | boolean;
+    timedOut?: undefined | boolean;
+    error?: undefined | string;
+}
+export interface AcpChooseWorkspacePlacementRequest {
+    sessionId?: undefined | string;
+    requestId?: undefined | string;
+    directory?: undefined | string;
+    title?: undefined | string;
+    toolCallId?: undefined | string;
+    emitRuntimeEvent?: undefined | ((event: Record<string, unknown>) => void);
+}
+export interface AcpChooseWorkspacePlacementResult {
+    choice?: undefined | 'inbox' | 'reuse' | 'create';
+    directory?: undefined | string;
+    workspaceName?: undefined | string;
+    result?: undefined | string;
+    cancelled?: undefined | boolean;
+    timedOut?: undefined | boolean;
+    error?: undefined | string;
+}
+export interface AcpHostBridge {
+    chooseDirectory(request: AcpChooseDirectoryRequest): Promise<AcpChooseDirectoryResult>;
+    chooseWorkspacePlacement(request: AcpChooseWorkspacePlacementRequest): Promise<AcpChooseWorkspacePlacementResult>;
+    cancelOutstanding?(reason?: undefined | string): void;
+}
+export declare class FailClosedAcpHostBridge implements AcpHostBridge {
+    chooseDirectory(): Promise<AcpChooseDirectoryResult>;
+    chooseWorkspacePlacement(): Promise<AcpChooseWorkspacePlacementResult>;
+}
+export declare function parseChooseDirectoryRequest(value: unknown): AcpChooseDirectoryRequest;
+export declare function parseChooseWorkspacePlacementRequest(value: unknown): AcpChooseWorkspacePlacementRequest;
+export declare function handleAcpHostExtensionRequest(method: string, params: Record<string, unknown>, bridge?: AcpHostBridge, 
+/**
+ * Coordination — §5.2b's three primitives, on the surface that already exists.
+ *
+ * 🔴 Defaults to the UNAVAILABLE bridge, not to a working one and not to
+ * silence. A host without coordination mounted must say so by name: "no
+ * peers" and "this host cannot coordinate" are the same empty list and
+ * opposite meanings, and an agent told the first concludes it is working
+ * alone — then edits a file another run has claimed.
+ */
+coordination?: CoordinationLaneBridge): Promise<Record<string, unknown>>;
+export declare function cancelAcpHostBridge(bridge: AcpHostBridge, reason?: string): void;
+//# sourceMappingURL=AcpHostBridge.d.ts.map

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

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