@xenosystem/acp-agent 0.1.1

package/dist/adapters/adapterEventMapper.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Map validated adapter events → normalized `ProviderEvent`s (XACP-011).
+ *
+ * The harness reuses the existing ProviderEvent model + `providerEventToAcpUpdate`, so adapter
+ * output flows through the SAME normalization the ACP server already uses. This module only
+ * translates the fixture adapter's protocol into ProviderEvent payloads; it performs no I/O.
+ */
+import { type ProviderEvent } from "../providers/providerEvents.js";
+import type { ParsedAdapterEvent } from "./adapterHarnessTypes.js";
+export interface MappedAdapterEvents {
+    events: ProviderEvent[];
+    /** Terminal disposition derived from a `completed`/`failed` event, if present. */
+    terminal?: "completed" | "failed";
+    failureMessage?: string;
+}
+export declare function mapAdapterEvents(parsed: ParsedAdapterEvent[], opts: {
+    providerId: string;
+    sessionId: string;
+    requestId: string;
+    now: () => string;
+}): MappedAdapterEvents;
+//# sourceMappingURL=adapterEventMapper.d.ts.map

package/dist/adapters/adapterEventMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterEventMapper.d.ts","sourceRoot":"","sources":["../../src/adapters/adapterEventMapper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAsB,KAAK,aAAa,EAA0B,MAAM,gCAAgC,CAAC;AAChH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAeD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,kBAAkB,EAAE,EAC5B,IAAI,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,MAAM,CAAA;CAAE,GACpF,mBAAmB,CAmDrB"}

package/dist/adapters/adapterEventMapper.js

@@ -0,0 +1,70 @@
+/**
+ * Map validated adapter events → normalized `ProviderEvent`s (XACP-011).
+ *
+ * The harness reuses the existing ProviderEvent model + `providerEventToAcpUpdate`, so adapter
+ * output flows through the SAME normalization the ACP server already uses. This module only
+ * translates the fixture adapter's protocol into ProviderEvent payloads; it performs no I/O.
+ */
+import { createEventFactory } from "../providers/providerEvents.js";
+const PLAN_PRIORITIES = new Set(["high", "medium", "low"]);
+const PLAN_STATUSES = new Set(["pending", "in_progress", "completed"]);
+function normalizePlanEntries(raw) {
+    if (!Array.isArray(raw))
+        return [];
+    return raw.map((e) => {
+        const o = (e ?? {});
+        const priority = PLAN_PRIORITIES.has(o.priority) ? o.priority : "medium";
+        const status = PLAN_STATUSES.has(o.status) ? o.status : "pending";
+        return { content: typeof o.content === "string" ? o.content : "", priority, status };
+    });
+}
+export function mapAdapterEvents(parsed, opts) {
+    const factory = createEventFactory(opts);
+    const events = [];
+    let terminal;
+    let failureMessage;
+    const push = (kind, payload) => {
+        events.push(factory.next(kind, payload));
+    };
+    for (const ev of parsed) {
+        const r = ev.raw;
+        switch (ev.type) {
+            case "plan":
+                push("plan", { entries: normalizePlanEntries(r.entries) });
+                break;
+            case "message_delta":
+                push("message_delta", { text: String(r.text ?? "") });
+                break;
+            case "tool_started":
+                push("tool_started", {
+                    toolCallId: String(r.toolCallId),
+                    ...(typeof r.title === "string" ? { title: r.title } : {}),
+                    ...(r.kind === "read" || r.kind === "think" ? { kind: r.kind } : {}),
+                });
+                break;
+            case "tool_updated":
+                push("tool_updated", { toolCallId: String(r.toolCallId), status: "in_progress" });
+                break;
+            case "tool_completed":
+                push("tool_completed", { toolCallId: String(r.toolCallId), status: "completed" });
+                break;
+            case "tool_failed":
+                push("tool_failed", { toolCallId: String(r.toolCallId), status: "failed" });
+                break;
+            case "usage":
+                push("usage", { used: Number(r.used ?? 0), size: Number(r.size ?? 0) });
+                break;
+            case "completed":
+                terminal = "completed";
+                push("completed", { disposition: "completed" });
+                break;
+            case "failed":
+                terminal = "failed";
+                failureMessage = typeof r.message === "string" ? r.message : "adapter reported failure";
+                push("failed", { disposition: "failed", message: failureMessage });
+                break;
+        }
+    }
+    return { events, ...(terminal ? { terminal } : {}), ...(failureMessage ? { failureMessage } : {}) };
+}
+//# sourceMappingURL=adapterEventMapper.js.map

package/dist/adapters/adapterEventMapper.js.map

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

package/dist/adapters/adapterEventParser.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Parser for the fixture adapter's stdout protocol (XACP-011).
+ *
+ * Fail-safe by design: empty lines are ignored; malformed JSON, oversized lines, unknown event
+ * types, and invalid field shapes are recorded as bounded, REDACTED diagnostics and skipped —
+ * they never throw and never crash the harness. Secret-like content in a rejected snippet is
+ * masked before it is retained.
+ */
+import type { AdapterParseOutcome } from "./adapterHarnessTypes.js";
+/** Max accepted bytes for a single protocol line (a runaway line is rejected as oversized). */
+export declare const MAX_LINE_BYTES: number;
+/** Bound + redact a snippet for diagnostics — never echo a secret-like token or a long payload. */
+export declare function safeSnippet(line: string): string;
+/** Parse adapter stdout into validated events + diagnostics. Never throws. */
+export declare function parseAdapterOutput(stdout: string): AdapterParseOutcome;
+//# sourceMappingURL=adapterEventParser.d.ts.map

package/dist/adapters/adapterEventParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterEventParser.d.ts","sourceRoot":"","sources":["../../src/adapters/adapterEventParser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAEV,mBAAmB,EAEpB,MAAM,0BAA0B,CAAC;AAElC,+FAA+F;AAC/F,eAAO,MAAM,cAAc,QAAY,CAAC;AAexC,mGAAmG;AACnG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGhD;AAwBD,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CA0CtE"}

package/dist/adapters/adapterEventParser.js

@@ -0,0 +1,95 @@
+/**
+ * Parser for the fixture adapter's stdout protocol (XACP-011).
+ *
+ * Fail-safe by design: empty lines are ignored; malformed JSON, oversized lines, unknown event
+ * types, and invalid field shapes are recorded as bounded, REDACTED diagnostics and skipped —
+ * they never throw and never crash the harness. Secret-like content in a rejected snippet is
+ * masked before it is retained.
+ */
+import { redactSecretLikeText } from "../security/redaction.js";
+import { resolveContractVersion } from "./adapterContractVersion.js";
+/** Max accepted bytes for a single protocol line (a runaway line is rejected as oversized). */
+export const MAX_LINE_BYTES = 64 * 1024;
+const SNIPPET_MAX = 80;
+const KNOWN_TYPES = new Set([
+    "plan",
+    "message_delta",
+    "tool_started",
+    "tool_updated",
+    "tool_completed",
+    "tool_failed",
+    "usage",
+    "completed",
+    "failed",
+]);
+/** Bound + redact a snippet for diagnostics — never echo a secret-like token or a long payload. */
+export function safeSnippet(line) {
+    const trimmed = line.trim().slice(0, SNIPPET_MAX);
+    return redactSecretLikeText(trimmed, { mask: "[REDACTED]", sensitiveKeyHints: [] });
+}
+/** Validate the required fields per event type. Returns true when the shape is acceptable. */
+function fieldsValid(type, obj) {
+    switch (type) {
+        case "plan":
+            return Array.isArray(obj.entries);
+        case "message_delta":
+            return typeof obj.text === "string";
+        case "tool_started":
+        case "tool_updated":
+        case "tool_completed":
+        case "tool_failed":
+            return typeof obj.toolCallId === "string" && obj.toolCallId.length > 0;
+        case "usage":
+            return typeof obj.used === "number" || typeof obj.size === "number";
+        case "completed":
+        case "failed":
+            return true;
+        default:
+            return false;
+    }
+}
+/** Parse adapter stdout into validated events + diagnostics. Never throws. */
+export function parseAdapterOutput(stdout) {
+    const events = [];
+    const diagnostics = [];
+    for (const rawLine of stdout.split(/\r?\n/)) {
+        if (!rawLine.trim())
+            continue; // empty lines ignored
+        if (Buffer.byteLength(rawLine) > MAX_LINE_BYTES) {
+            diagnostics.push({ reason: "oversized", redactedSnippet: safeSnippet(rawLine) });
+            continue;
+        }
+        let obj;
+        try {
+            obj = JSON.parse(rawLine);
+        }
+        catch {
+            diagnostics.push({ reason: "malformed_json", redactedSnippet: safeSnippet(rawLine) });
+            continue;
+        }
+        if (!obj || typeof obj !== "object" || Array.isArray(obj)) {
+            diagnostics.push({ reason: "invalid_fields", redactedSnippet: safeSnippet(rawLine) });
+            continue;
+        }
+        const record = obj;
+        // Contract version gate (XACP-012): a PRESENT-but-unsupported version fails safely; a missing
+        // version defaults to v1 (internal-fixture leniency — the harness supplies authoritative ids).
+        if (resolveContractVersion(record.version) === null) {
+            diagnostics.push({ reason: "unsupported_version", redactedSnippet: safeSnippet(rawLine) });
+            continue;
+        }
+        const type = record.type;
+        if (typeof type !== "string" || !KNOWN_TYPES.has(type)) {
+            diagnostics.push({ reason: "unknown_type", redactedSnippet: safeSnippet(rawLine) });
+            continue;
+        }
+        const t = type;
+        if (!fieldsValid(t, record)) {
+            diagnostics.push({ reason: "invalid_fields", redactedSnippet: safeSnippet(rawLine) });
+            continue;
+        }
+        events.push({ type: t, raw: record });
+    }
+    return { events, diagnostics };
+}
+//# sourceMappingURL=adapterEventParser.js.map

package/dist/adapters/adapterEventParser.js.map

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

package/dist/adapters/adapterEventProtocol.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Adapter stdout event protocol — FROZEN v1 (XACP-012).
+ *
+ * This is the INTERNAL protocol a cooperative adapter process writes to stdout (one JSON object
+ * per line). It is NOT ACP — the harness maps these to normalized `ProviderEvent`s, which the ACP
+ * server then maps to `session/update`. Keeping the two separate is deliberate.
+ *
+ * Every conforming event carries an envelope: `version`, `type`, `eventId`, `timestamp`,
+ * `requestId`. `validateAdapterProtocolEvent` is the canonical, fail-safe reference validator:
+ * unknown version, unknown type, or invalid fields are rejected (never thrown). The harness's
+ * `parseAdapterOutput` is a deliberately tolerant reader of this protocol (it accepts internal
+ * fixtures that omit envelope metadata and supplies authoritative ids itself); this validator is
+ * the strict contract a real adapter must satisfy.
+ */
+export type AdapterProtocolEventType = "plan" | "message_delta" | "tool_started" | "tool_updated" | "tool_completed" | "tool_failed" | "usage" | "completed" | "cancelled" | "failed" | "diagnostic";
+/** Envelope present on every v1 protocol event. */
+export interface AdapterProtocolEnvelope {
+    version: number;
+    type: AdapterProtocolEventType;
+    eventId: string;
+    timestamp: string;
+    requestId: string;
+}
+export interface AdapterPlanEvent extends AdapterProtocolEnvelope {
+    type: "plan";
+    entries: unknown[];
+}
+export interface AdapterMessageDeltaEvent extends AdapterProtocolEnvelope {
+    type: "message_delta";
+    text: string;
+}
+export interface AdapterToolStartedEvent extends AdapterProtocolEnvelope {
+    type: "tool_started";
+    toolCallId: string;
+    title?: string;
+    kind?: "read" | "think";
+}
+export interface AdapterToolUpdatedEvent extends AdapterProtocolEnvelope {
+    type: "tool_updated";
+    toolCallId: string;
+}
+export interface AdapterToolCompletedEvent extends AdapterProtocolEnvelope {
+    type: "tool_completed";
+    toolCallId: string;
+}
+export interface AdapterToolFailedEvent extends AdapterProtocolEnvelope {
+    type: "tool_failed";
+    toolCallId: string;
+}
+export interface AdapterUsageEvent extends AdapterProtocolEnvelope {
+    type: "usage";
+    used?: number;
+    size?: number;
+}
+export interface AdapterCompletedEvent extends AdapterProtocolEnvelope {
+    type: "completed";
+    stopReason?: string;
+}
+export interface AdapterCancelledEvent extends AdapterProtocolEnvelope {
+    type: "cancelled";
+}
+export interface AdapterFailedEvent extends AdapterProtocolEnvelope {
+    type: "failed";
+    message?: string;
+}
+export interface AdapterDiagnosticEvent extends AdapterProtocolEnvelope {
+    type: "diagnostic";
+    message?: string;
+}
+export type AdapterProtocolEvent = AdapterPlanEvent | AdapterMessageDeltaEvent | AdapterToolStartedEvent | AdapterToolUpdatedEvent | AdapterToolCompletedEvent | AdapterToolFailedEvent | AdapterUsageEvent | AdapterCompletedEvent | AdapterCancelledEvent | AdapterFailedEvent | AdapterDiagnosticEvent;
+export declare const ADAPTER_PROTOCOL_EVENT_TYPES: readonly AdapterProtocolEventType[];
+export type AdapterProtocolRejectReason = "unsupported_version" | "unknown_type" | "invalid_fields";
+export type AdapterProtocolValidation = {
+    ok: true;
+    event: AdapterProtocolEvent;
+} | {
+    ok: false;
+    reason: AdapterProtocolRejectReason;
+};
+/**
+ * Canonical fail-safe validator for a single parsed protocol object. Enforces the v1 envelope
+ * (version supported, required ids present) + per-type payload fields. Never throws.
+ */
+export declare function validateAdapterProtocolEvent(obj: unknown): AdapterProtocolValidation;
+//# sourceMappingURL=adapterEventProtocol.d.ts.map

package/dist/adapters/adapterEventProtocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterEventProtocol.d.ts","sourceRoot":"","sources":["../../src/adapters/adapterEventProtocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,MAAM,wBAAwB,GAChC,MAAM,GACN,eAAe,GACf,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,OAAO,GACP,WAAW,GACX,WAAW,GACX,QAAQ,GACR,YAAY,CAAC;AAEjB,mDAAmD;AACnD,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAiB,SAAQ,uBAAuB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,EAAE,CAAA;CAAE;AACtG,MAAM,WAAW,wBAAyB,SAAQ,uBAAuB;IAAG,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACjH,MAAM,WAAW,uBAAwB,SAAQ,uBAAuB;IAAG,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE;AAC9J,MAAM,WAAW,uBAAwB,SAAQ,uBAAuB;IAAG,IAAI,EAAE,cAAc,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AACrH,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB;IAAG,IAAI,EAAE,gBAAgB,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AACzH,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB;IAAG,IAAI,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AACnH,MAAM,WAAW,iBAAkB,SAAQ,uBAAuB;IAAG,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAClH,MAAM,WAAW,qBAAsB,SAAQ,uBAAuB;IAAG,IAAI,EAAE,WAAW,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;AACjH,MAAM,WAAW,qBAAsB,SAAQ,uBAAuB;IAAG,IAAI,EAAE,WAAW,CAAA;CAAE;AAC5F,MAAM,WAAW,kBAAmB,SAAQ,uBAAuB;IAAG,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;AACxG,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB;IAAG,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE;AAEhH,MAAM,MAAM,oBAAoB,GAC5B,gBAAgB,GAChB,wBAAwB,GACxB,uBAAuB,GACvB,uBAAuB,GACvB,yBAAyB,GACzB,sBAAsB,GACtB,iBAAiB,GACjB,qBAAqB,GACrB,qBAAqB,GACrB,kBAAkB,GAClB,sBAAsB,CAAC;AAE3B,eAAO,MAAM,4BAA4B,EAAE,SAAS,wBAAwB,EAY3E,CAAC;AAEF,MAAM,MAAM,2BAA2B,GACnC,qBAAqB,GACrB,cAAc,GACd,gBAAgB,CAAC;AAErB,MAAM,MAAM,yBAAyB,GACjC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,GACzC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,2BAA2B,CAAA;CAAE,CAAC;AAiCvD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,yBAAyB,CASpF"}

package/dist/adapters/adapterEventProtocol.js

@@ -0,0 +1,74 @@
+/**
+ * Adapter stdout event protocol — FROZEN v1 (XACP-012).
+ *
+ * This is the INTERNAL protocol a cooperative adapter process writes to stdout (one JSON object
+ * per line). It is NOT ACP — the harness maps these to normalized `ProviderEvent`s, which the ACP
+ * server then maps to `session/update`. Keeping the two separate is deliberate.
+ *
+ * Every conforming event carries an envelope: `version`, `type`, `eventId`, `timestamp`,
+ * `requestId`. `validateAdapterProtocolEvent` is the canonical, fail-safe reference validator:
+ * unknown version, unknown type, or invalid fields are rejected (never thrown). The harness's
+ * `parseAdapterOutput` is a deliberately tolerant reader of this protocol (it accepts internal
+ * fixtures that omit envelope metadata and supplies authoritative ids itself); this validator is
+ * the strict contract a real adapter must satisfy.
+ */
+import { resolveContractVersion } from "./adapterContractVersion.js";
+export const ADAPTER_PROTOCOL_EVENT_TYPES = [
+    "plan",
+    "message_delta",
+    "tool_started",
+    "tool_updated",
+    "tool_completed",
+    "tool_failed",
+    "usage",
+    "completed",
+    "cancelled",
+    "failed",
+    "diagnostic",
+];
+const TYPE_SET = new Set(ADAPTER_PROTOCOL_EVENT_TYPES);
+function envelopeValid(o) {
+    return (typeof o.eventId === "string" && o.eventId.length > 0 &&
+        typeof o.timestamp === "string" && o.timestamp.length > 0 &&
+        typeof o.requestId === "string" && o.requestId.length > 0);
+}
+function payloadValid(type, o) {
+    switch (type) {
+        case "plan":
+            return Array.isArray(o.entries);
+        case "message_delta":
+            return typeof o.text === "string";
+        case "tool_started":
+        case "tool_updated":
+        case "tool_completed":
+        case "tool_failed":
+            return typeof o.toolCallId === "string" && o.toolCallId.length > 0;
+        case "usage":
+            return typeof o.used === "number" || typeof o.size === "number";
+        case "completed":
+        case "cancelled":
+        case "failed":
+        case "diagnostic":
+            return true;
+    }
+}
+/**
+ * Canonical fail-safe validator for a single parsed protocol object. Enforces the v1 envelope
+ * (version supported, required ids present) + per-type payload fields. Never throws.
+ */
+export function validateAdapterProtocolEvent(obj) {
+    if (!obj || typeof obj !== "object" || Array.isArray(obj))
+        return { ok: false, reason: "invalid_fields" };
+    const o = obj;
+    if (resolveContractVersion(o.version) === null)
+        return { ok: false, reason: "unsupported_version" };
+    if (typeof o.type !== "string" || !TYPE_SET.has(o.type))
+        return { ok: false, reason: "unknown_type" };
+    const type = o.type;
+    if (!envelopeValid(o))
+        return { ok: false, reason: "invalid_fields" };
+    if (!payloadValid(type, o))
+        return { ok: false, reason: "invalid_fields" };
+    return { ok: true, event: o };
+}
+//# sourceMappingURL=adapterEventProtocol.js.map

package/dist/adapters/adapterEventProtocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterEventProtocol.js","sourceRoot":"","sources":["../../src/adapters/adapterEventProtocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAiDrE,MAAM,CAAC,MAAM,4BAA4B,GAAwC;IAC/E,MAAM;IACN,eAAe;IACf,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,aAAa;IACb,OAAO;IACP,WAAW;IACX,WAAW;IACX,QAAQ;IACR,YAAY;CACb,CAAC;AAWF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,4BAA4B,CAAC,CAAC;AAE/D,SAAS,aAAa,CAAC,CAA0B;IAC/C,OAAO,CACL,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACrD,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;QACzD,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAA8B,EAAE,CAA0B;IAC9E,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAClC,KAAK,eAAe;YAClB,OAAO,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;QACpC,KAAK,cAAc,CAAC;QACpB,KAAK,cAAc,CAAC;QACpB,KAAK,gBAAgB,CAAC;QACtB,KAAK,aAAa;YAChB,OAAO,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QACrE,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;QAClE,KAAK,WAAW,CAAC;QACjB,KAAK,WAAW,CAAC;QACjB,KAAK,QAAQ,CAAC;QACd,KAAK,YAAY;YACf,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,GAAY;IACvD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC1G,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,IAAI,sBAAsB,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC;IACpG,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;IACtG,MAAM,IAAI,GAAG,CAAC,CAAC,IAAgC,CAAC;IAChD,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IACtE,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAoC,EAAE,CAAC;AACnE,CAAC"}

package/dist/adapters/adapterFailureTaxonomy.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Frozen failure taxonomy for the adapter/runtime path (XACP-012 v1).
+ *
+ * Every failure on the adapter/runtime path maps to ONE of these codes. Each has a safe message
+ * and a `retryable` hint. Safe messages never contain stack traces, raw adapter output, env
+ * values, or secrets. This taxonomy is part of the frozen v1 contract.
+ */
+export declare const ADAPTER_FAILURE_CODES: readonly ["ADAPTER_CONTRACT_VERSION_UNSUPPORTED", "ADAPTER_EVENT_INVALID", "ADAPTER_EVENT_UNKNOWN_TYPE", "ADAPTER_EVENT_TOO_LARGE", "ADAPTER_PROCESS_FAILED", "ADAPTER_PROCESS_TIMED_OUT", "ADAPTER_PROCESS_CANCELLED", "ADAPTER_STDERR_SECRET_REDACTED", "PROVIDER_NOT_RUNNABLE", "PROVIDER_APPROVAL_MISSING", "PROVIDER_APPROVAL_STALE", "PROVIDER_POLICY_INVALID", "PROVIDER_SANDBOX_DENIED", "PROVIDER_SUPERVISOR_DENIED", "PROVIDER_INTERNAL_ERROR"];
+export type AdapterFailureCode = (typeof ADAPTER_FAILURE_CODES)[number];
+export interface AdapterFailureDescriptor {
+    code: AdapterFailureCode;
+    safeMessage: string;
+    retryable: boolean;
+}
+export declare function describeAdapterFailure(code: AdapterFailureCode): AdapterFailureDescriptor;
+export declare function isAdapterFailureCode(value: unknown): value is AdapterFailureCode;
+/** Map a runnability status to a frozen failure code (used when a provider can't run). */
+export declare function failureCodeForRunnability(status: string): AdapterFailureCode;
+//# sourceMappingURL=adapterFailureTaxonomy.d.ts.map

package/dist/adapters/adapterFailureTaxonomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterFailureTaxonomy.d.ts","sourceRoot":"","sources":["../../src/adapters/adapterFailureTaxonomy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,qBAAqB,2bAgBxB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,kBAAkB,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAoBD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,kBAAkB,GAAG,wBAAwB,CAGzF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED,0FAA0F;AAC1F,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAW5E"}

package/dist/adapters/adapterFailureTaxonomy.js

@@ -0,0 +1,62 @@
+/**
+ * Frozen failure taxonomy for the adapter/runtime path (XACP-012 v1).
+ *
+ * Every failure on the adapter/runtime path maps to ONE of these codes. Each has a safe message
+ * and a `retryable` hint. Safe messages never contain stack traces, raw adapter output, env
+ * values, or secrets. This taxonomy is part of the frozen v1 contract.
+ */
+export const ADAPTER_FAILURE_CODES = [
+    "ADAPTER_CONTRACT_VERSION_UNSUPPORTED",
+    "ADAPTER_EVENT_INVALID",
+    "ADAPTER_EVENT_UNKNOWN_TYPE",
+    "ADAPTER_EVENT_TOO_LARGE",
+    "ADAPTER_PROCESS_FAILED",
+    "ADAPTER_PROCESS_TIMED_OUT",
+    "ADAPTER_PROCESS_CANCELLED",
+    "ADAPTER_STDERR_SECRET_REDACTED",
+    "PROVIDER_NOT_RUNNABLE",
+    "PROVIDER_APPROVAL_MISSING",
+    "PROVIDER_APPROVAL_STALE",
+    "PROVIDER_POLICY_INVALID",
+    "PROVIDER_SANDBOX_DENIED",
+    "PROVIDER_SUPERVISOR_DENIED",
+    "PROVIDER_INTERNAL_ERROR",
+];
+const DESCRIPTORS = {
+    ADAPTER_CONTRACT_VERSION_UNSUPPORTED: { safeMessage: "adapter declared an unsupported contract version", retryable: false },
+    ADAPTER_EVENT_INVALID: { safeMessage: "adapter emitted an event with invalid fields", retryable: false },
+    ADAPTER_EVENT_UNKNOWN_TYPE: { safeMessage: "adapter emitted an unknown event type", retryable: false },
+    ADAPTER_EVENT_TOO_LARGE: { safeMessage: "adapter emitted an oversized event", retryable: false },
+    ADAPTER_PROCESS_FAILED: { safeMessage: "adapter process failed", retryable: true },
+    ADAPTER_PROCESS_TIMED_OUT: { safeMessage: "adapter process timed out", retryable: true },
+    ADAPTER_PROCESS_CANCELLED: { safeMessage: "adapter process was cancelled", retryable: false },
+    ADAPTER_STDERR_SECRET_REDACTED: { safeMessage: "adapter stderr contained secret-like content (redacted)", retryable: false },
+    PROVIDER_NOT_RUNNABLE: { safeMessage: "provider is not runnable", retryable: false },
+    PROVIDER_APPROVAL_MISSING: { safeMessage: "provider requires explicit approval", retryable: false },
+    PROVIDER_APPROVAL_STALE: { safeMessage: "provider approval is stale (definition/policy changed)", retryable: false },
+    PROVIDER_POLICY_INVALID: { safeMessage: "provider policy is invalid", retryable: false },
+    PROVIDER_SANDBOX_DENIED: { safeMessage: "sandbox context denied", retryable: false },
+    PROVIDER_SUPERVISOR_DENIED: { safeMessage: "process supervisor denied", retryable: false },
+    PROVIDER_INTERNAL_ERROR: { safeMessage: "internal error on the adapter/runtime path", retryable: false },
+};
+export function describeAdapterFailure(code) {
+    const d = DESCRIPTORS[code];
+    return { code, safeMessage: d.safeMessage, retryable: d.retryable };
+}
+export function isAdapterFailureCode(value) {
+    return typeof value === "string" && ADAPTER_FAILURE_CODES.includes(value);
+}
+/** Map a runnability status to a frozen failure code (used when a provider can't run). */
+export function failureCodeForRunnability(status) {
+    switch (status) {
+        case "requires_approval":
+            return "PROVIDER_APPROVAL_MISSING";
+        case "stale_approval":
+            return "PROVIDER_APPROVAL_STALE";
+        case "blocked_policy_invalid":
+            return "PROVIDER_POLICY_INVALID";
+        default:
+            return "PROVIDER_NOT_RUNNABLE";
+    }
+}
+//# sourceMappingURL=adapterFailureTaxonomy.js.map

package/dist/adapters/adapterFailureTaxonomy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterFailureTaxonomy.js","sourceRoot":"","sources":["../../src/adapters/adapterFailureTaxonomy.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,sCAAsC;IACtC,uBAAuB;IACvB,4BAA4B;IAC5B,yBAAyB;IACzB,wBAAwB;IACxB,2BAA2B;IAC3B,2BAA2B;IAC3B,gCAAgC;IAChC,uBAAuB;IACvB,2BAA2B;IAC3B,yBAAyB;IACzB,yBAAyB;IACzB,yBAAyB;IACzB,4BAA4B;IAC5B,yBAAyB;CACjB,CAAC;AAUX,MAAM,WAAW,GAA4E;IAC3F,oCAAoC,EAAE,EAAE,WAAW,EAAE,kDAAkD,EAAE,SAAS,EAAE,KAAK,EAAE;IAC3H,qBAAqB,EAAE,EAAE,WAAW,EAAE,8CAA8C,EAAE,SAAS,EAAE,KAAK,EAAE;IACxG,0BAA0B,EAAE,EAAE,WAAW,EAAE,uCAAuC,EAAE,SAAS,EAAE,KAAK,EAAE;IACtG,uBAAuB,EAAE,EAAE,WAAW,EAAE,oCAAoC,EAAE,SAAS,EAAE,KAAK,EAAE;IAChG,sBAAsB,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,SAAS,EAAE,IAAI,EAAE;IAClF,yBAAyB,EAAE,EAAE,WAAW,EAAE,2BAA2B,EAAE,SAAS,EAAE,IAAI,EAAE;IACxF,yBAAyB,EAAE,EAAE,WAAW,EAAE,+BAA+B,EAAE,SAAS,EAAE,KAAK,EAAE;IAC7F,8BAA8B,EAAE,EAAE,WAAW,EAAE,yDAAyD,EAAE,SAAS,EAAE,KAAK,EAAE;IAC5H,qBAAqB,EAAE,EAAE,WAAW,EAAE,0BAA0B,EAAE,SAAS,EAAE,KAAK,EAAE;IACpF,yBAAyB,EAAE,EAAE,WAAW,EAAE,qCAAqC,EAAE,SAAS,EAAE,KAAK,EAAE;IACnG,uBAAuB,EAAE,EAAE,WAAW,EAAE,wDAAwD,EAAE,SAAS,EAAE,KAAK,EAAE;IACpH,uBAAuB,EAAE,EAAE,WAAW,EAAE,4BAA4B,EAAE,SAAS,EAAE,KAAK,EAAE;IACxF,uBAAuB,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,SAAS,EAAE,KAAK,EAAE;IACpF,0BAA0B,EAAE,EAAE,WAAW,EAAE,2BAA2B,EAAE,SAAS,EAAE,KAAK,EAAE;IAC1F,uBAAuB,EAAE,EAAE,WAAW,EAAE,4CAA4C,EAAE,SAAS,EAAE,KAAK,EAAE;CACzG,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,IAAwB;IAC7D,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,qBAA2C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACnG,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,mBAAmB;YACtB,OAAO,2BAA2B,CAAC;QACrC,KAAK,gBAAgB;YACnB,OAAO,yBAAyB,CAAC;QACnC,KAAK,wBAAwB;YAC3B,OAAO,yBAAyB,CAAC;QACnC;YACE,OAAO,uBAAuB,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/adapters/adapterHarnessTypes.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Types for the provider-adapter TEST harness (XACP-011).
+ *
+ * The harness proves the FUTURE adapter seam end-to-end using only a harmless, deterministic,
+ * XENO-owned fixture adapter process: it runs
+ *
+ *   ProviderDefinition → policy config → manual approval → safety evaluation →
+ *   sandbox context → minimal process supervisor → adapter stdout protocol →
+ *   ProviderEvent[] → ACP session/update → audit/diagnostics
+ *
+ * It is NOT a real Codex/Claude/Gemini/OpenCode/Kimi/GLM/Hermes adapter, performs no network, loads no
+ * secrets, and never spawns a real provider CLI.
+ */
+import type { ProviderEvent } from "../providers/providerEvents.js";
+import type { ProviderAuthFailureDiagnostic, ProviderErrorCode } from "../providers/providerErrors.js";
+import type { ProviderDefinition, ProviderPromptRequest, ProviderPromptResult } from "../providers/providerTypes.js";
+import type { RunnabilityInput, RunnabilityResult } from "../config/providerRunnability.js";
+import type { ProviderProcessSupervisor } from "../process/providerProcessSupervisor.js";
+import type { SessionUpdate } from "../types.js";
+/** One parsed line of the adapter's stdout protocol (post-validation). */
+export interface ParsedAdapterEvent {
+    type: "plan" | "message_delta" | "tool_started" | "tool_updated" | "tool_completed" | "tool_failed" | "usage" | "completed" | "failed";
+    raw: Record<string, unknown>;
+}
+/** A line the parser could not accept (malformed JSON, oversized, unknown type, bad version). */
+export interface AdapterParseDiagnostic {
+    reason: "empty" | "malformed_json" | "oversized" | "unknown_type" | "invalid_fields" | "unsupported_version";
+    /** Redacted, bounded snippet — never raw secrets, never full payload. */
+    redactedSnippet: string;
+}
+export interface AdapterParseOutcome {
+    events: ParsedAdapterEvent[];
+    diagnostics: AdapterParseDiagnostic[];
+}
+/**
+ * Optional stdout parser for a REAL local provider (XACP-021) whose process emits its OWN native
+ * format (e.g. Claude Code `--output-format stream-json`) rather than the XENO v1 adapter
+ * protocol. When provided, it replaces the v1 `parseAdapterOutput` + `mapAdapterEvents` steps and
+ * returns normalized `ProviderEvent`s directly — so a real CLI still flows through the SAME gate →
+ * sandbox → supervisor → ProviderEvent → ACP path. The default (undefined) keeps the frozen v1
+ * protocol path unchanged.
+ */
+export type RealProviderStdoutParser = (stdout: string, ctx: {
+    providerId: string;
+    sessionId: string;
+    requestId: string;
+    now: () => string;
+}) => {
+    events: ProviderEvent[];
+    terminal: "completed" | "failed" | null;
+    failureCode?: ProviderErrorCode;
+    failureMessage?: string;
+    diagnosticsCount: number;
+};
+export interface AdapterHarnessConfig {
+    definition: ProviderDefinition;
+    /** Drives the runnability gate (policy entry / approval / policyInvalid). */
+    runnability: RunnabilityInput;
+    request: ProviderPromptRequest;
+    /** The fixture adapter to launch — a single executable token + argv (no shell, no real CLI). */
+    adapter: {
+        executable: string;
+        args: string[];
+        stdin?: string;
+    };
+    /** Real-provider native stdout parser (XACP-021). When set, replaces the v1 parse/map steps. */
+    parseStdout?: RealProviderStdoutParser;
+    /** Injected supervisor (defaults to a fresh minimal supervisor). */
+    supervisor?: ProviderProcessSupervisor;
+    /** Absolute cwd for the adapter process (defaults to a supervisor-owned temp workspace). */
+    cwd?: string;
+    /** Test-only env allowlist for the adapter (defaults to empty). */
+    envAllowlist?: Record<string, string>;
+    timeoutMs?: number;
+    stdoutLimitBytes?: number;
+    stderrLimitBytes?: number;
+    /** Cancels the prompt (the harness cancels the supervised process). */
+    signal?: AbortSignal;
+    /** Deterministic ISO clock for ProviderEvent timestamps. */
+    now?: () => string;
+    /** Optional sink for ProviderEvents (also collected in the result). */
+    emit?: (event: ProviderEvent) => void;
+}
+export interface AdapterHarnessDiagnostics {
+    providerId: string;
+    runnableStatus: string;
+    eventsEmitted: number;
+    parseDiagnostics: number;
+    acpUpdates: number;
+    /** From the process supervisor — includes the honest enforcement classification. */
+    supervisor?: Record<string, unknown>;
+    authFailure?: ProviderAuthFailureDiagnostic;
+    stdoutTruncated: boolean;
+    stderrTruncated: boolean;
+}
+export interface AdapterHarnessResult {
+    runnability: RunnabilityResult;
+    result: ProviderPromptResult;
+    events: ProviderEvent[];
+    acpUpdates: SessionUpdate[];
+    diagnostics: AdapterHarnessDiagnostics;
+}
+//# sourceMappingURL=adapterHarnessTypes.d.ts.map

package/dist/adapters/adapterHarnessTypes.d.ts.map

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

package/dist/adapters/adapterHarnessTypes.js

@@ -0,0 +1,15 @@
+/**
+ * Types for the provider-adapter TEST harness (XACP-011).
+ *
+ * The harness proves the FUTURE adapter seam end-to-end using only a harmless, deterministic,
+ * XENO-owned fixture adapter process: it runs
+ *
+ *   ProviderDefinition → policy config → manual approval → safety evaluation →
+ *   sandbox context → minimal process supervisor → adapter stdout protocol →
+ *   ProviderEvent[] → ACP session/update → audit/diagnostics
+ *
+ * It is NOT a real Codex/Claude/Gemini/OpenCode/Kimi/GLM/Hermes adapter, performs no network, loads no
+ * secrets, and never spawns a real provider CLI.
+ */
+export {};
+//# sourceMappingURL=adapterHarnessTypes.js.map

package/dist/adapters/adapterHarnessTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapterHarnessTypes.js","sourceRoot":"","sources":["../../src/adapters/adapterHarnessTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}