@xenosystem/acp-agent 0.1.1

package/dist/providers/fixtureProvider.js

@@ -0,0 +1,160 @@
+/**
+ * Deterministic fixture provider (XACP-005 — refactored onto the provider contract).
+ *
+ * Emits normalized `ProviderEvent`s which the ACP server maps to the SAME ACP `session/update`
+ * sequence the certified fixture endpoint has always produced (plan → 2× message → tool_call
+ * → in_progress → completed → usage → end_turn). Zero I/O authority: no model, network,
+ * filesystem mutation, terminal execution, provider CLI, or secrets.
+ */
+import { createEventFactory } from "./providerEvents.js";
+import { ProviderInternalError } from "./providerErrors.js";
+import { staticModelDiscovery } from "./providerDiscovery.js";
+export const FIXTURE_FINAL_TEXT = "XENO ACP fixture endpoint completed the requested task.";
+/** Conservative capability declaration — the fixture does nothing risky. */
+export const FIXTURE_CAPABILITIES = {
+    streamsText: true,
+    emitsPlan: true,
+    emitsToolCalls: true,
+    emitsUsage: true,
+    supportsCancel: true,
+    supportsMultipleSessions: true,
+    requiresAuth: false,
+    usesNetwork: false,
+    canReadFiles: false,
+    canWriteFiles: false,
+    canRunTerminal: false,
+};
+class FixtureRuntime {
+    definition;
+    options;
+    now;
+    sessionSeq = 0;
+    promptCount = 0;
+    constructor(definition, config) {
+        this.definition = definition;
+        const o = (config?.options ?? {});
+        this.options = {
+            ...(o.delayMs !== undefined ? { delayMs: Number(o.delayMs) } : {}),
+            fail: Boolean(o.fail),
+            stderrTest: Boolean(o.stderrTest),
+        };
+        this.now = () => new Date().toISOString();
+    }
+    initialize() {
+        /* nothing to set up */
+    }
+    createSession() {
+        this.sessionSeq += 1;
+        return { sessionId: `fixture-session-${this.sessionSeq}`, createdAt: this.now() };
+    }
+    cancel() {
+        /* cancellation is delivered via the prompt's AbortSignal; nothing extra to do */
+    }
+    dispose() {
+        /* no resources */
+    }
+    diagnostics() {
+        return {
+            provider: this.definition.id,
+            sessionsCreated: this.sessionSeq,
+            promptsRun: this.promptCount,
+            options: this.options,
+        };
+    }
+    async prompt(request, ctx) {
+        this.promptCount += 1;
+        const factory = createEventFactory({
+            providerId: this.definition.id,
+            sessionId: request.sessionId,
+            requestId: request.requestId,
+            now: this.now,
+        });
+        const emit = (kind, payload) => ctx.emit(factory.next(kind, payload));
+        const cancelled = () => ctx.signal.aborted;
+        if (this.options.stderrTest) {
+            ctx.log("stderr-test: diagnostic line A");
+            ctx.log("stderr-test: diagnostic line B — must not reach stdout");
+            emit("diagnostic", { message: "stderr-test active" });
+        }
+        if (this.options.fail) {
+            emit("tool_failed", { toolCallId: "fixture-1", status: "failed" });
+            const error = new ProviderInternalError({
+                safeMessage: "fixture failure (test mode)",
+                providerId: this.definition.id,
+            });
+            emit("failed", { disposition: "failed", message: error.safeMessage });
+            return { disposition: "failed", error };
+        }
+        emit("plan", {
+            entries: [
+                { content: "Inspect the request", priority: "high", status: "completed" },
+                { content: "Produce a deterministic response", priority: "medium", status: "in_progress" },
+            ],
+        });
+        if (cancelled())
+            return this.cancelledResult(emit);
+        emit("message_delta", { text: "XENO ACP fixture endpoint " });
+        emit("message_delta", { text: "completed the requested task." });
+        emit("tool_started", { toolCallId: "fixture-1", title: "Fixture inspection", kind: "read" });
+        emit("tool_updated", { toolCallId: "fixture-1", status: "in_progress" });
+        if (this.options.delayMs && this.options.delayMs > 0) {
+            const aborted = await delayOrAbort(this.options.delayMs, ctx.signal);
+            if (aborted)
+                return this.cancelledResult(emit);
+        }
+        if (cancelled())
+            return this.cancelledResult(emit);
+        emit("tool_completed", { toolCallId: "fixture-1", status: "completed" });
+        emit("usage", { used: 8, size: 1000 });
+        emit("completed", { disposition: "completed" });
+        return { disposition: "completed", usage: { inputTokens: 7, outputTokens: 9, totalTokens: 16 } };
+    }
+    cancelledResult(emit) {
+        emit("cancelled", { disposition: "cancelled" });
+        return { disposition: "cancelled" };
+    }
+}
+export function createFixtureProviderDefinition() {
+    const definition = {
+        id: "fixture",
+        displayName: "XENO Fixture",
+        description: "Deterministic fixture provider (no model, network, filesystem, or terminal).",
+        kind: "fixture",
+        trustClass: "xeno-owned",
+        authRequirement: "none",
+        networkRequirement: "none",
+        ioAuthority: { filesystem: "none", terminal: "none" },
+        capabilities: FIXTURE_CAPABILITIES,
+        enabled: true,
+        metadata: {
+            displayAlias: "XENO Fixture",
+            streaming: { mode: "streaming", safeMessage: "Fixture emits deterministic streaming ACP updates." },
+            setupHints: ["No setup required."],
+        },
+        modelDiscovery: staticModelDiscovery("Fixture exposes one deterministic test model.", [{ id: "fixture-default", label: "Fixture default", default: true, available: true, reason: null }]),
+        createRuntime(config) {
+            return new FixtureRuntime(definition, config);
+        },
+    };
+    return definition;
+}
+function delayOrAbort(ms, signal) {
+    return new Promise((resolve) => {
+        if (signal.aborted)
+            return resolve(true);
+        const timer = setTimeout(() => {
+            cleanup();
+            resolve(false);
+        }, ms);
+        const onAbort = () => {
+            cleanup();
+            resolve(true);
+        };
+        const cleanup = () => {
+            clearTimeout(timer);
+            signal.removeEventListener("abort", onAbort);
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+    });
+}
+//# sourceMappingURL=fixtureProvider.js.map

package/dist/providers/fixtureProvider.js.map

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

package/dist/providers/providerDiscovery.d.ts

@@ -0,0 +1,24 @@
+import type { RunnabilityResult } from "../config/providerRunnability.js";
+import type { ProviderDefinition, ProviderModelChoice, ProviderModelDiscovery, ProviderStreamingMetadata, ProviderVersionReadiness } from "./providerTypes.js";
+export interface ProviderDiscoverySummary {
+    providerId: string;
+    displayName: string;
+    runnability?: Pick<RunnabilityResult, "status" | "runnable" | "safeMessage">;
+    modelDiscovery: ProviderModelDiscovery;
+    versionReadiness: ProviderVersionReadiness;
+    streaming: ProviderStreamingMetadata;
+    setupHints: string[];
+}
+export interface ProviderModelValidation {
+    ok: boolean;
+    model?: string;
+    safeMessage?: string;
+}
+export declare function providerDisplayName(def: ProviderDefinition): string;
+export declare function isSafeProviderModelId(model: string): boolean;
+export declare function buildProviderDiscoverySummary(def: ProviderDefinition, runnability?: RunnabilityResult): ProviderDiscoverySummary;
+export declare function resolveProviderModelDiscovery(def: ProviderDefinition, runnability?: RunnabilityResult): ProviderModelDiscovery;
+export declare function validateProviderModelSelection(def: ProviderDefinition, model: string | undefined): ProviderModelValidation;
+export declare function defaultOnlyModelDiscovery(displayName: string): ProviderModelDiscovery;
+export declare function staticModelDiscovery(safeMessage: string, models: ProviderModelChoice[], defaultModelId?: string | null): ProviderModelDiscovery;
+//# sourceMappingURL=providerDiscovery.d.ts.map

package/dist/providers/providerDiscovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerDiscovery.d.ts","sourceRoot":"","sources":["../../src/providers/providerDiscovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EAEtB,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,oBAAoB,CAAC;AAI5B,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAC,CAAC;IAC7E,cAAc,EAAE,sBAAsB,CAAC;IACvC,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,SAAS,EAAE,yBAAyB,CAAC;IACrC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,kBAAkB,GAAG,MAAM,CAEnE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,kBAAkB,EACvB,WAAW,CAAC,EAAE,iBAAiB,GAC9B,wBAAwB,CAgB1B;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,kBAAkB,EACvB,WAAW,CAAC,EAAE,iBAAiB,GAC9B,sBAAsB,CA4BxB;AAED,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,kBAAkB,EACvB,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,uBAAuB,CAazB;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,sBAAsB,CAIrF;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,mBAAmB,EAAE,EAC7B,cAAc,GAAE,MAAM,GAAG,IAAwD,GAChF,sBAAsB,CASxB"}

package/dist/providers/providerDiscovery.js

@@ -0,0 +1,128 @@
+const SAFE_MODEL_ID = /^[A-Za-z0-9._:/+-]{1,120}$/;
+export function providerDisplayName(def) {
+    return def.metadata?.displayAlias || def.displayName;
+}
+export function isSafeProviderModelId(model) {
+    return SAFE_MODEL_ID.test(model);
+}
+export function buildProviderDiscoverySummary(def, runnability) {
+    return {
+        providerId: def.id,
+        displayName: providerDisplayName(def),
+        ...(runnability ? {
+            runnability: {
+                status: runnability.status,
+                runnable: runnability.runnable,
+                safeMessage: runnability.safeMessage,
+            },
+        } : {}),
+        modelDiscovery: resolveProviderModelDiscovery(def, runnability),
+        versionReadiness: resolveVersionReadiness(def),
+        streaming: resolveStreaming(def),
+        setupHints: def.metadata?.setupHints ?? [],
+    };
+}
+export function resolveProviderModelDiscovery(def, runnability) {
+    if (runnability && !runnability.runnable) {
+        return modelDiscovery("blocked", "none", {
+            safeMessage: runnability.safeMessage,
+        });
+    }
+    const declared = def.modelDiscovery;
+    if (!declared) {
+        return modelDiscovery("default_only", "none", {
+            safeMessage: `${providerDisplayName(def)} does not expose provider-owned model discovery; use CLI default.`,
+        });
+    }
+    const models = declared.models
+        .filter((model) => isSafeProviderModelId(model.id))
+        .map(normalizeModelChoice);
+    const defaultModelId = declared.defaultModelId && models.some((model) => model.id === declared.defaultModelId)
+        ? declared.defaultModelId
+        : null;
+    return {
+        status: declared.status,
+        source: declared.source,
+        defaultModelId,
+        allowCustomModel: Boolean(declared.allowCustomModel),
+        models,
+        safeMessage: declared.safeMessage || defaultSafeMessage(def, declared.status),
+    };
+}
+export function validateProviderModelSelection(def, model) {
+    if (!model)
+        return { ok: true };
+    if (!isSafeProviderModelId(model)) {
+        return { ok: false, safeMessage: `invalid provider model id for ${providerDisplayName(def)}` };
+    }
+    const discovery = resolveProviderModelDiscovery(def);
+    if (discovery.allowCustomModel)
+        return { ok: true, model };
+    const match = discovery.models.find((candidate) => candidate.id === model);
+    if (match && match.available)
+        return { ok: true, model };
+    if (discovery.status === "default_only") {
+        return { ok: false, safeMessage: `${providerDisplayName(def)} supports CLI default only.` };
+    }
+    return { ok: false, safeMessage: `${providerDisplayName(def)} does not expose model '${model}'.` };
+}
+export function defaultOnlyModelDiscovery(displayName) {
+    return modelDiscovery("default_only", "none", {
+        safeMessage: `${displayName} does not expose a safe model-list command; use CLI default.`,
+    });
+}
+export function staticModelDiscovery(safeMessage, models, defaultModelId = models.find((model) => model.default)?.id ?? null) {
+    return {
+        status: "available",
+        source: "adapter_static",
+        defaultModelId,
+        allowCustomModel: false,
+        models: models.map(normalizeModelChoice),
+        safeMessage,
+    };
+}
+function modelDiscovery(status, source, opts) {
+    return {
+        status,
+        source,
+        defaultModelId: null,
+        allowCustomModel: false,
+        models: [],
+        safeMessage: opts.safeMessage,
+    };
+}
+function normalizeModelChoice(model) {
+    return {
+        id: model.id,
+        label: model.label || model.id,
+        default: Boolean(model.default),
+        available: model.available !== false,
+        reason: typeof model.reason === "string" && model.reason.trim() ? model.reason.trim() : null,
+    };
+}
+function resolveVersionReadiness(def) {
+    return def.metadata?.versionReadiness ?? {
+        status: "not_checked",
+        installedVersion: null,
+        minimumKnownGoodVersion: null,
+        safeUpgradeHint: "No provider version probe is defined.",
+    };
+}
+function resolveStreaming(def) {
+    return def.metadata?.streaming ?? {
+        mode: def.capabilities.streamsText ? "streaming" : "none",
+        safeMessage: def.capabilities.streamsText
+            ? `${providerDisplayName(def)} reports streaming text capability.`
+            : `${providerDisplayName(def)} does not stream text.`,
+    };
+}
+function defaultSafeMessage(def, status) {
+    if (status === "default_only")
+        return `${providerDisplayName(def)} supports CLI default only.`;
+    if (status === "blocked")
+        return `${providerDisplayName(def)} is blocked.`;
+    if (status === "unavailable")
+        return `${providerDisplayName(def)} model discovery is unavailable.`;
+    return `${providerDisplayName(def)} exposes provider-owned model choices.`;
+}
+//# sourceMappingURL=providerDiscovery.js.map

package/dist/providers/providerDiscovery.js.map

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

package/dist/providers/providerErrors.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Typed provider error taxonomy.
+ *
+ * Every provider error carries a SAFE message (deterministic, no stack trace, no secrets).
+ * The ACP server maps a failed prompt to a JSON-RPC error using `safeMessage` only — raw
+ * stack traces never reach stdout.
+ */
+export type ProviderErrorCode = "PROVIDER_CONFIGURATION" | "PROVIDER_AUTH_REQUIRED" | "PROVIDER_RATE_LIMIT" | "PROVIDER_UNAVAILABLE" | "PROVIDER_TIMEOUT" | "PROVIDER_CANCELLED" | "PROVIDER_PROTOCOL" | "PROVIDER_SAFETY_VIOLATION" | "PROVIDER_NOT_IMPLEMENTED" | "PROVIDER_INTERNAL";
+export interface ProviderErrorInit {
+    code: ProviderErrorCode;
+    safeMessage: string;
+    providerId?: string;
+    retryable?: boolean;
+    redactedDetails?: string;
+}
+export interface ProviderAuthFailureDiagnostic {
+    providerId?: string;
+    code: "PROVIDER_AUTH_REQUIRED";
+    safeMessage: string;
+    retryable: boolean;
+    requiredAction: "authenticate_provider_cli_or_bind_required_secret_refs";
+    redactionState: "active";
+}
+export declare class ProviderError extends Error {
+    readonly code: ProviderErrorCode;
+    readonly providerId?: string;
+    readonly retryable: boolean;
+    readonly redactedDetails?: string;
+    constructor(init: ProviderErrorInit);
+    /** The safe, user-presentable message (alias of `message`). */
+    get safeMessage(): string;
+}
+export declare class ProviderConfigurationError extends ProviderError {
+    constructor(init: Omit<ProviderErrorInit, "code">);
+}
+export declare class ProviderAuthRequiredError extends ProviderError {
+    constructor(init: Omit<ProviderErrorInit, "code">);
+}
+export declare class ProviderRateLimitError extends ProviderError {
+    constructor(init: Omit<ProviderErrorInit, "code">);
+}
+export declare class ProviderUnavailableError extends ProviderError {
+    constructor(init: Omit<ProviderErrorInit, "code">);
+}
+export declare class ProviderTimeoutError extends ProviderError {
+    constructor(init: Omit<ProviderErrorInit, "code">);
+}
+export declare class ProviderCancelledError extends ProviderError {
+    constructor(init: Omit<ProviderErrorInit, "code">);
+}
+export declare class ProviderProtocolError extends ProviderError {
+    constructor(init: Omit<ProviderErrorInit, "code">);
+}
+export declare class ProviderSafetyViolationError extends ProviderError {
+    constructor(init: Omit<ProviderErrorInit, "code">);
+}
+export declare class ProviderNotImplementedError extends ProviderError {
+    constructor(init: Omit<ProviderErrorInit, "code">);
+}
+export declare class ProviderInternalError extends ProviderError {
+    constructor(init: Omit<ProviderErrorInit, "code">);
+}
+export declare function buildProviderAuthFailureDiagnostic(error: ProviderError): ProviderAuthFailureDiagnostic | undefined;
+//# sourceMappingURL=providerErrors.d.ts.map

package/dist/providers/providerErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerErrors.d.ts","sourceRoot":"","sources":["../../src/providers/providerErrors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,iBAAiB,GACzB,wBAAwB,GACxB,wBAAwB,GACxB,qBAAqB,GACrB,sBAAsB,GACtB,kBAAkB,GAClB,oBAAoB,GACpB,mBAAmB,GACnB,2BAA2B,GAC3B,0BAA0B,GAC1B,mBAAmB,CAAC;AAExB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,iBAAiB,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,wBAAwB,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,wDAAwD,CAAC;IACzE,cAAc,EAAE,QAAQ,CAAC;CAC1B;AAED,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;gBAEtB,IAAI,EAAE,iBAAiB;IASnC,+DAA+D;IAC/D,IAAI,WAAW,IAAI,MAAM,CAExB;CACF;AAGD,qBAAa,0BAA2B,SAAQ,aAAa;gBAC/C,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC;CAIlD;AACD,qBAAa,yBAA0B,SAAQ,aAAa;gBAC9C,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC;CAIlD;AACD,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC;CAIlD;AACD,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC;CAIlD;AACD,qBAAa,oBAAqB,SAAQ,aAAa;gBACzC,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC;CAIlD;AACD,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC;CAIlD;AACD,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC;CAIlD;AACD,qBAAa,4BAA6B,SAAQ,aAAa;gBACjD,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC;CAIlD;AACD,qBAAa,2BAA4B,SAAQ,aAAa;gBAChD,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC;CAIlD;AACD,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC;CAIlD;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,aAAa,GAAG,6BAA6B,GAAG,SAAS,CAUlH"}

package/dist/providers/providerErrors.js

@@ -0,0 +1,101 @@
+/**
+ * Typed provider error taxonomy.
+ *
+ * Every provider error carries a SAFE message (deterministic, no stack trace, no secrets).
+ * The ACP server maps a failed prompt to a JSON-RPC error using `safeMessage` only — raw
+ * stack traces never reach stdout.
+ */
+export class ProviderError extends Error {
+    code;
+    providerId;
+    retryable;
+    redactedDetails;
+    constructor(init) {
+        super(init.safeMessage);
+        this.name = "ProviderError";
+        this.code = init.code;
+        if (init.providerId !== undefined)
+            this.providerId = init.providerId;
+        this.retryable = init.retryable ?? false;
+        if (init.redactedDetails !== undefined)
+            this.redactedDetails = init.redactedDetails;
+    }
+    /** The safe, user-presentable message (alias of `message`). */
+    get safeMessage() {
+        return this.message;
+    }
+}
+// Named subclasses for an explicit, matchable taxonomy. Each fixes its `code`.
+export class ProviderConfigurationError extends ProviderError {
+    constructor(init) {
+        super({ ...init, code: "PROVIDER_CONFIGURATION" });
+        this.name = "ProviderConfigurationError";
+    }
+}
+export class ProviderAuthRequiredError extends ProviderError {
+    constructor(init) {
+        super({ ...init, code: "PROVIDER_AUTH_REQUIRED" });
+        this.name = "ProviderAuthRequiredError";
+    }
+}
+export class ProviderRateLimitError extends ProviderError {
+    constructor(init) {
+        super({ retryable: true, ...init, code: "PROVIDER_RATE_LIMIT" });
+        this.name = "ProviderRateLimitError";
+    }
+}
+export class ProviderUnavailableError extends ProviderError {
+    constructor(init) {
+        super({ ...init, code: "PROVIDER_UNAVAILABLE" });
+        this.name = "ProviderUnavailableError";
+    }
+}
+export class ProviderTimeoutError extends ProviderError {
+    constructor(init) {
+        super({ ...init, code: "PROVIDER_TIMEOUT" });
+        this.name = "ProviderTimeoutError";
+    }
+}
+export class ProviderCancelledError extends ProviderError {
+    constructor(init) {
+        super({ ...init, code: "PROVIDER_CANCELLED" });
+        this.name = "ProviderCancelledError";
+    }
+}
+export class ProviderProtocolError extends ProviderError {
+    constructor(init) {
+        super({ ...init, code: "PROVIDER_PROTOCOL" });
+        this.name = "ProviderProtocolError";
+    }
+}
+export class ProviderSafetyViolationError extends ProviderError {
+    constructor(init) {
+        super({ ...init, code: "PROVIDER_SAFETY_VIOLATION" });
+        this.name = "ProviderSafetyViolationError";
+    }
+}
+export class ProviderNotImplementedError extends ProviderError {
+    constructor(init) {
+        super({ ...init, code: "PROVIDER_NOT_IMPLEMENTED" });
+        this.name = "ProviderNotImplementedError";
+    }
+}
+export class ProviderInternalError extends ProviderError {
+    constructor(init) {
+        super({ ...init, code: "PROVIDER_INTERNAL" });
+        this.name = "ProviderInternalError";
+    }
+}
+export function buildProviderAuthFailureDiagnostic(error) {
+    if (error.code !== "PROVIDER_AUTH_REQUIRED")
+        return undefined;
+    return {
+        ...(error.providerId ? { providerId: error.providerId } : {}),
+        code: "PROVIDER_AUTH_REQUIRED",
+        safeMessage: error.safeMessage,
+        retryable: error.retryable,
+        requiredAction: "authenticate_provider_cli_or_bind_required_secret_refs",
+        redactionState: "active",
+    };
+}
+//# sourceMappingURL=providerErrors.js.map

package/dist/providers/providerErrors.js.map

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

package/dist/providers/providerEvents.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Normalized provider event model.
+ *
+ * Providers emit append-only `ProviderEvent`s; the ACP server maps the streamable ones to ACP
+ * `session/update` notifications (`providerEventToAcpUpdate`). Terminal events
+ * (`completed`/`cancelled`/`failed`) and `diagnostic` do NOT map to ACP updates — the prompt's
+ * disposition is the source of truth, and diagnostics go to stderr. A provider never writes to
+ * stdout and never executes a tool by itself.
+ */
+import type { SessionUpdate } from "../types.js";
+export type ProviderEventKind = "plan" | "message_delta" | "tool_started" | "tool_updated" | "tool_completed" | "tool_failed" | "usage" | "completed" | "cancelled" | "failed" | "diagnostic";
+export interface PlanPayload {
+    entries: Array<{
+        content: string;
+        priority: "high" | "medium" | "low";
+        status: "pending" | "in_progress" | "completed";
+    }>;
+}
+export interface MessageDeltaPayload {
+    text: string;
+}
+export interface ToolPayload {
+    toolCallId: string;
+    title?: string;
+    kind?: "read" | "edit" | "delete" | "move" | "search" | "execute" | "think" | "fetch" | "other";
+    status?: "pending" | "in_progress" | "completed" | "failed";
+    outcome?: "succeeded" | "cancelled" | "failed";
+}
+export interface UsagePayload {
+    used: number;
+    size: number;
+}
+export interface DiagnosticPayload {
+    message: string;
+}
+export interface TerminalPayload {
+    disposition: "completed" | "cancelled" | "failed";
+    message?: string;
+}
+export interface ProviderEvent {
+    eventId: string;
+    providerId: string;
+    sessionId: string;
+    requestId: string;
+    timestamp: string;
+    kind: ProviderEventKind;
+    payload: unknown;
+}
+/** Helper to build a well-formed, append-only provider event. */
+export interface ProviderEventFactory {
+    next(kind: ProviderEventKind, payload: unknown): ProviderEvent;
+}
+export declare function createEventFactory(opts: {
+    providerId: string;
+    sessionId: string;
+    requestId: string;
+    now: () => string;
+}): ProviderEventFactory;
+/** Map a streamable provider event to an ACP `session/update` payload (or null). */
+export declare function providerEventToAcpUpdate(event: ProviderEvent): SessionUpdate | null;
+/** True for the terminal event kinds (completed/cancelled/failed). */
+export declare function isTerminalEvent(kind: ProviderEventKind): boolean;
+//# sourceMappingURL=providerEvents.d.ts.map

package/dist/providers/providerEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providerEvents.d.ts","sourceRoot":"","sources":["../../src/providers/providerEvents.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,eAAe,GACf,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,aAAa,GACb,OAAO,GACP,WAAW,GACX,WAAW,GACX,QAAQ,GACR,YAAY,CAAC;AAEjB,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;QACpC,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;KACjD,CAAC,CAAC;CACJ;AACD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAChG,MAAM,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC5D,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;CAChD;AACD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AACD,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,iBAAiB,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,GAAG,aAAa,CAAC;CAChE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB,GAAG,oBAAoB,CAgBvB;AAED,oFAAoF;AACpF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,GAAG,IAAI,CAqDnF;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAEhE"}