@the-open-engine/zeroshot 5.4.0

package/lib/agent-cli-provider/contract-actions.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dispatchRequest = dispatchRequest;
+const adapters_1 = require("./adapters");
+const contract_env_1 = require("./contract-env");
+const contract_errors_1 = require("./contract-errors");
+const contract_envelope_1 = require("./contract-envelope");
+const contract_invoke_1 = require("./contract-invoke");
+const contract_parse_1 = require("./contract-parse");
+const contract_support_1 = require("./contract-support");
+const single_agent_runtime_1 = require("./single-agent-runtime");
+const json_1 = require("./json");
+function runBuildCommand(request) {
+    const { adapter, commandSpec, options } = (0, contract_support_1.buildCommandSpec)(request);
+    return (0, contract_envelope_1.successEnvelope)({
+        command: request.command ?? 'build-command',
+        adapter,
+        warnings: commandSpec.warnings,
+        redactions: (0, contract_env_1.commandRedactions)(commandSpec),
+        evidence: {
+            outputFormat: options.outputFormat ?? null,
+            schemaMode: (0, contract_support_1.schemaMode)(options),
+        },
+        result: {
+            commandSpec,
+            outputFormat: options.outputFormat ?? null,
+            schemaMode: (0, contract_support_1.schemaMode)(options),
+        },
+    });
+}
+function runProbe(request) {
+    const adapter = (0, contract_support_1.adapterForProvider)(request.provider);
+    const helpText = typeof request.raw.helpText === 'string' ? request.raw.helpText : null;
+    const capabilities = helpText === null ? (0, single_agent_runtime_1.detectRuntimeProviderCliFeatures)(adapter.id) : adapter.detectCliFeatures(helpText);
+    return (0, contract_envelope_1.successEnvelope)({
+        command: request.command ?? 'probe',
+        adapter,
+        redactions: (0, contract_env_1.envRedactions)(request.env),
+        result: {
+            provider: {
+                id: adapter.id,
+                displayName: adapter.displayName,
+                binary: adapter.binary,
+            },
+            contractVersion: contract_envelope_1.providerExecutableSchemaVersion,
+            adapterVersion: adapter.adapterVersion,
+            capabilities,
+            credentials: adapter.credentialEnvKeys.map((key) => ({
+                key,
+                present: Boolean(request.env[key] ?? process.env[key]),
+            })),
+        },
+    });
+}
+function statusFromError(error) {
+    if (!(0, json_1.isRecord)(error))
+        return null;
+    const directStatus = (0, json_1.getNumber)(error, 'status') ?? (0, json_1.getNumber)(error, 'statusCode');
+    if (directStatus !== null)
+        return directStatus;
+    const response = (0, json_1.getRecord)(error, 'response');
+    if (response === null)
+        return null;
+    return (0, json_1.getNumber)(response, 'status') ?? (0, json_1.getNumber)(response, 'statusCode');
+}
+function categoryForClassification(classification, error) {
+    const status = statusFromError(error);
+    if (status === 401 || status === 403)
+        return 'auth';
+    if (status === 429)
+        return 'rate-limit';
+    const message = (0, json_1.unknownToMessage)(error);
+    if (/auth|api[_ -]?key|unauthorized|forbidden|permission/i.test(message))
+        return 'auth';
+    if (/rate|429|quota|resource_exhausted/i.test(message))
+        return 'rate-limit';
+    if (/schema|json|parse|format/i.test(message))
+        return 'schema';
+    return classification.retryable ? 'retryable' : 'permanent';
+}
+function errorEvidence(error) {
+    const evidence = {
+        message: (0, json_1.unknownToMessage)(error),
+    };
+    if ((0, json_1.isRecord)(error)) {
+        const status = statusFromError(error);
+        const code = (0, json_1.getString)(error, 'code');
+        if (status !== null)
+            evidence.status = status;
+        if (code !== null)
+            evidence.code = code;
+    }
+    return evidence;
+}
+function runClassifyError(request) {
+    const adapter = (0, contract_support_1.adapterForProvider)(request.provider);
+    const error = request.raw.error;
+    if (error === undefined) {
+        throw (0, contract_errors_1.contractError)({
+            code: 'missing-field',
+            message: 'error is required.',
+            exitCode: 2,
+            field: 'error',
+        });
+    }
+    const classification = (0, adapters_1.classifyProviderError)(adapter.id, error);
+    return (0, contract_envelope_1.successEnvelope)({
+        command: request.command ?? 'classify-error',
+        adapter,
+        redactions: (0, contract_env_1.envRedactions)(request.env),
+        evidence: errorEvidence(error),
+        result: {
+            classification,
+            category: categoryForClassification(classification, error),
+            evidence: errorEvidence(error),
+        },
+    });
+}
+function dispatchRequest(request, runner) {
+    switch (request.command) {
+        case 'probe':
+            return runProbe(request);
+        case 'build-command':
+            return runBuildCommand(request);
+        case 'parse-output':
+            return (0, contract_parse_1.runParseOutput)(request);
+        case 'classify-error':
+            return runClassifyError(request);
+        case 'invoke':
+            return (0, contract_invoke_1.runInvoke)(request, runner);
+        default:
+            throw (0, contract_errors_1.contractError)({
+                code: 'unknown-command',
+                message: `Unknown command: ${request.command ?? ''}.`,
+                exitCode: 3,
+                field: 'command',
+            });
+    }
+}
+//# sourceMappingURL=contract-actions.js.map

package/lib/agent-cli-provider/contract-actions.js.map

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

package/lib/agent-cli-provider/contract-env.d.ts

@@ -0,0 +1,11 @@
+import type { CommandSpec, RedactionMetadata } from './types';
+export declare function stringRecord(value: unknown, field: string): Readonly<Record<string, string>>;
+export declare function envRedactions(env: Readonly<Record<string, string>>): readonly RedactionMetadata[];
+export declare function commandRedactions(commandSpec: CommandSpec): readonly RedactionMetadata[];
+export declare function providerCredentialEnv(provider: string | null): Readonly<Record<string, string>>;
+export declare function mergeEnvForRedaction(...inputs: readonly {
+    readonly source: string;
+    readonly env: Readonly<Record<string, string>>;
+}[]): Readonly<Record<string, string>>;
+export declare function collectCommandSpecEnv(value: unknown): Readonly<Record<string, string>>;
+//# sourceMappingURL=contract-env.d.ts.map

package/lib/agent-cli-provider/contract-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-env.d.ts","sourceRoot":"","sources":["../../src/agent-cli-provider/contract-env.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAmB,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE/E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAyB5F;AAaD,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,iBAAiB,EAAE,CAEjG;AAED,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,WAAW,GAAG,SAAS,iBAAiB,EAAE,CAExF;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAc/F;AAED,wBAAgB,oBAAoB,CAClC,GAAG,MAAM,EAAE,SAAS;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChD,EAAE,GACF,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAalC;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAItF"}

package/lib/agent-cli-provider/contract-env.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringRecord = stringRecord;
+exports.envRedactions = envRedactions;
+exports.commandRedactions = commandRedactions;
+exports.providerCredentialEnv = providerCredentialEnv;
+exports.mergeEnvForRedaction = mergeEnvForRedaction;
+exports.collectCommandSpecEnv = collectCommandSpecEnv;
+const adapters_1 = require("./adapters");
+const env_safety_1 = require("./env-safety");
+const json_1 = require("./json");
+const redaction_1 = require("./redaction");
+const contract_errors_1 = require("./contract-errors");
+function stringRecord(value, field) {
+    if (value === undefined)
+        return {};
+    if (!(0, json_1.isRecord)(value)) {
+        throw (0, contract_errors_1.contractError)({
+            code: 'invalid-field',
+            message: `${field} must be an object with string values.`,
+            exitCode: 2,
+            field,
+        });
+    }
+    const result = {};
+    for (const [key, item] of Object.entries(value)) {
+        if (typeof item !== 'string') {
+            throw (0, contract_errors_1.contractError)({
+                code: 'invalid-field',
+                message: `${field}.${key} must be a string.`,
+                exitCode: 2,
+                field: `${field}.${key}`,
+            });
+        }
+        result[key] = item;
+    }
+    assertNoUnsafeProviderEnv(result, field);
+    return result;
+}
+function assertNoUnsafeProviderEnv(env, field) {
+    const key = (0, env_safety_1.findUnsafeProviderEnvKey)(env);
+    if (key === null)
+        return;
+    throw (0, contract_errors_1.contractError)({
+        code: 'forbidden-field',
+        message: `${field}.${key} is not accepted by provider executable requests; provider adapters own executable resolution and process-control environment.`,
+        exitCode: 2,
+        field: `${field}.${key}`,
+    });
+}
+function envRedactions(env) {
+    return Object.keys(env).map((key) => ({ kind: 'env', key }));
+}
+function commandRedactions(commandSpec) {
+    return (0, redaction_1.mergeRedactions)(commandSpec.redactions, envRedactions(commandSpec.env));
+}
+function providerCredentialEnv(provider) {
+    if (provider === null)
+        return {};
+    let adapter;
+    try {
+        adapter = (0, adapters_1.getProviderAdapter)(provider);
+    }
+    catch {
+        return {};
+    }
+    const result = {};
+    for (const key of adapter.credentialEnvKeys) {
+        const value = process.env[key];
+        if (typeof value === 'string' && value.length > 0)
+            result[key] = value;
+    }
+    return result;
+}
+function mergeEnvForRedaction(...inputs) {
+    const result = {};
+    for (const input of inputs) {
+        for (const [key, value] of Object.entries(input.env)) {
+            if (value.length === 0)
+                continue;
+            if (result[key] === undefined || result[key] === value) {
+                result[key] = value;
+                continue;
+            }
+            result[`${key}:${input.source}`] = value;
+        }
+    }
+    return result;
+}
+function collectCommandSpecEnv(value) {
+    const result = {};
+    collectCommandSpecEnvInto(value, result);
+    return result;
+}
+function collectCommandSpecEnvInto(value, result) {
+    if (Array.isArray(value)) {
+        for (const item of value)
+            collectCommandSpecEnvInto(item, result);
+        return;
+    }
+    if (!(0, json_1.isRecord)(value))
+        return;
+    const commandSpec = value.commandSpec;
+    if ((0, json_1.isRecord)(commandSpec) && (0, json_1.isRecord)(commandSpec.env)) {
+        for (const [key, item] of Object.entries(commandSpec.env)) {
+            if (typeof item === 'string' && item.length > 0)
+                result[key] = item;
+        }
+    }
+    for (const item of Object.values(value))
+        collectCommandSpecEnvInto(item, result);
+}
+//# sourceMappingURL=contract-env.js.map

package/lib/agent-cli-provider/contract-env.js.map

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

package/lib/agent-cli-provider/contract-envelope.d.ts

@@ -0,0 +1,49 @@
+import type { ProviderAdapter, RedactionMetadata, WarningMetadata } from './types';
+export declare const providerExecutableSchemaVersion: 1;
+export interface ContractErrorObject {
+    readonly code: string;
+    readonly message: string;
+    readonly field?: string;
+    readonly classification?: unknown;
+}
+export interface ContractEvidence {
+    readonly [key: string]: unknown;
+}
+interface ContractEnvelopeBase {
+    readonly schemaVersion: 1;
+    readonly command: string | null;
+    readonly provider: string | null;
+    readonly adapterVersion: string | null;
+    readonly warnings: readonly WarningMetadata[];
+    readonly redactions: readonly RedactionMetadata[];
+    readonly evidence: ContractEvidence;
+}
+export interface ContractSuccessEnvelope<Result = unknown> extends ContractEnvelopeBase {
+    readonly ok: true;
+    readonly result: Result;
+}
+export interface ContractErrorEnvelope extends ContractEnvelopeBase {
+    readonly ok: false;
+    readonly error: ContractErrorObject;
+}
+export type ContractEnvelope<Result = unknown> = ContractSuccessEnvelope<Result> | ContractErrorEnvelope;
+export declare function finalizeEnvelope(envelope: ContractEnvelope, env: Readonly<Record<string, string>>): ContractEnvelope;
+export declare function successEnvelope<Result>(input: {
+    readonly command: string;
+    readonly adapter: ProviderAdapter;
+    readonly result: Result;
+    readonly warnings?: readonly WarningMetadata[];
+    readonly redactions?: readonly RedactionMetadata[];
+    readonly evidence?: ContractEvidence;
+}): ContractSuccessEnvelope<Result>;
+export declare function errorEnvelope(input: {
+    readonly command: string | null;
+    readonly provider: string | null;
+    readonly adapterVersion?: string | null;
+    readonly error: ContractErrorObject;
+    readonly warnings?: readonly WarningMetadata[];
+    readonly redactions?: readonly RedactionMetadata[];
+    readonly evidence?: ContractEvidence;
+}): ContractErrorEnvelope;
+export {};
+//# sourceMappingURL=contract-envelope.d.ts.map

package/lib/agent-cli-provider/contract-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-envelope.d.ts","sourceRoot":"","sources":["../../src/agent-cli-provider/contract-envelope.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEnF,eAAO,MAAM,+BAA+B,EAAG,CAAU,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB,CAAC,MAAM,GAAG,OAAO,CAAE,SAAQ,oBAAoB;IACrF,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;CACrC;AAED,MAAM,MAAM,gBAAgB,CAAC,MAAM,GAAG,OAAO,IACzC,uBAAuB,CAAC,MAAM,CAAC,GAC/B,qBAAqB,CAAC;AAE1B,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACpC,gBAAgB,CAgBlB;AAOD,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CACtC,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAYlC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CACtC,GAAG,qBAAqB,CAYxB"}

package/lib/agent-cli-provider/contract-envelope.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.providerExecutableSchemaVersion = void 0;
+exports.finalizeEnvelope = finalizeEnvelope;
+exports.successEnvelope = successEnvelope;
+exports.errorEnvelope = errorEnvelope;
+const contract_env_1 = require("./contract-env");
+const json_1 = require("./json");
+const redaction_1 = require("./redaction");
+exports.providerExecutableSchemaVersion = 1;
+function finalizeEnvelope(envelope, env) {
+    const redacted = (0, redaction_1.redactObject)(envelope, (0, contract_env_1.mergeEnvForRedaction)({ source: 'commandSpec', env: (0, contract_env_1.collectCommandSpecEnv)(envelope) }, { source: 'process', env: (0, contract_env_1.providerCredentialEnv)(envelope.provider) }, { source: 'request', env }));
+    if (!isContractEnvelope(redacted.value)) {
+        throw new Error('Redacted provider contract envelope lost its JSON shape.');
+    }
+    return {
+        ...redacted.value,
+        redactions: (0, redaction_1.mergeRedactions)(envelope.redactions, redacted.redactions),
+    };
+}
+function isContractEnvelope(value) {
+    if (!(0, json_1.isRecord)(value))
+        return false;
+    return value.schemaVersion === exports.providerExecutableSchemaVersion && typeof value.ok === 'boolean';
+}
+function successEnvelope(input) {
+    return {
+        schemaVersion: exports.providerExecutableSchemaVersion,
+        ok: true,
+        command: input.command,
+        provider: input.adapter.id,
+        adapterVersion: input.adapter.adapterVersion,
+        warnings: input.warnings ?? [],
+        redactions: input.redactions ?? [],
+        evidence: input.evidence ?? {},
+        result: input.result,
+    };
+}
+function errorEnvelope(input) {
+    return {
+        schemaVersion: exports.providerExecutableSchemaVersion,
+        ok: false,
+        command: input.command,
+        provider: input.provider,
+        adapterVersion: input.adapterVersion ?? null,
+        warnings: input.warnings ?? [],
+        redactions: input.redactions ?? [],
+        evidence: input.evidence ?? {},
+        error: input.error,
+    };
+}
+//# sourceMappingURL=contract-envelope.js.map

package/lib/agent-cli-provider/contract-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-envelope.js","sourceRoot":"","sources":["../../src/agent-cli-provider/contract-envelope.ts"],"names":[],"mappings":";;;AA0CA,4CAmBC;AAOD,0CAmBC;AAED,sCAoBC;AA7GD,iDAAoG;AACpG,iCAAkC;AAClC,2CAA4D;AAG/C,QAAA,+BAA+B,GAAG,CAAU,CAAC;AAqC1D,SAAgB,gBAAgB,CAC9B,QAA0B,EAC1B,GAAqC;IAErC,MAAM,QAAQ,GAAG,IAAA,wBAAY,EAC3B,QAAQ,EACR,IAAA,mCAAoB,EAClB,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,IAAA,oCAAqB,EAAC,QAAQ,CAAC,EAAE,EAC/D,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,IAAA,oCAAqB,EAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,EACpE,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAC3B,CACF,CAAC;IACF,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO;QACL,GAAG,QAAQ,CAAC,KAAK;QACjB,UAAU,EAAE,IAAA,2BAAe,EAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC;KACtE,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,CAAC,IAAA,eAAQ,EAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,OAAO,KAAK,CAAC,aAAa,KAAK,uCAA+B,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC;AAClG,CAAC;AAED,SAAgB,eAAe,CAAS,KAOvC;IACC,OAAO;QACL,aAAa,EAAE,uCAA+B;QAC9C,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE;QAC1B,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,cAAc;QAC5C,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;QAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC;AACJ,CAAC;AAED,SAAgB,aAAa,CAAC,KAQ7B;IACC,OAAO;QACL,aAAa,EAAE,uCAA+B;QAC9C,EAAE,EAAE,KAAK;QACT,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,IAAI;QAC5C,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;QAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC;AACJ,CAAC"}

package/lib/agent-cli-provider/contract-errors.d.ts

@@ -0,0 +1,22 @@
+export declare class ContractRequestError extends Error {
+    readonly code: string;
+    readonly exitCode: number;
+    readonly field?: string;
+    constructor(input: {
+        code: string;
+        message: string;
+        exitCode: number;
+        field?: string;
+    });
+}
+export declare function contractError(input: {
+    readonly code: string;
+    readonly message: string;
+    readonly exitCode: number;
+    readonly field?: string;
+}): ContractRequestError;
+export declare function invalidField(field: string, message: string): never;
+export declare function requiredString(record: Record<string, unknown>, field: string): string;
+export declare function optionalString(record: Record<string, unknown>, field: string): string | undefined;
+export declare function optionalNumber(record: Record<string, unknown>, field: string): number | undefined;
+//# sourceMappingURL=contract-errors.d.ts.map

package/lib/agent-cli-provider/contract-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-errors.d.ts","sourceRoot":"","sources":["../../src/agent-cli-provider/contract-errors.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEZ,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;CAOvF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,oBAAoB,CAEvB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAOlE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CASrF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUjG;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUjG"}

package/lib/agent-cli-provider/contract-errors.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContractRequestError = void 0;
+exports.contractError = contractError;
+exports.invalidField = invalidField;
+exports.requiredString = requiredString;
+exports.optionalString = optionalString;
+exports.optionalNumber = optionalNumber;
+class ContractRequestError extends Error {
+    code;
+    exitCode;
+    field;
+    constructor(input) {
+        super(input.message);
+        this.name = 'ContractRequestError';
+        this.code = input.code;
+        this.exitCode = input.exitCode;
+        if (input.field !== undefined)
+            this.field = input.field;
+    }
+}
+exports.ContractRequestError = ContractRequestError;
+function contractError(input) {
+    return new ContractRequestError(input);
+}
+function invalidField(field, message) {
+    throw contractError({
+        code: 'invalid-field',
+        message,
+        exitCode: 2,
+        field,
+    });
+}
+function requiredString(record, field) {
+    const value = record[field];
+    if (typeof value === 'string' && value.length > 0)
+        return value;
+    throw contractError({
+        code: 'missing-field',
+        message: `${field} is required.`,
+        exitCode: 2,
+        field,
+    });
+}
+function optionalString(record, field) {
+    const value = record[field];
+    if (value === undefined)
+        return undefined;
+    if (typeof value === 'string')
+        return value;
+    throw contractError({
+        code: 'invalid-field',
+        message: `${field} must be a string.`,
+        exitCode: 2,
+        field,
+    });
+}
+function optionalNumber(record, field) {
+    const value = record[field];
+    if (value === undefined)
+        return undefined;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    throw contractError({
+        code: 'invalid-field',
+        message: `${field} must be a finite number.`,
+        exitCode: 2,
+        field,
+    });
+}
+//# sourceMappingURL=contract-errors.js.map

package/lib/agent-cli-provider/contract-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-errors.js","sourceRoot":"","sources":["../../src/agent-cli-provider/contract-errors.ts"],"names":[],"mappings":";;;AAcA,sCAOC;AAED,oCAOC;AAED,wCASC;AAED,wCAUC;AAED,wCAUC;AAjED,MAAa,oBAAqB,SAAQ,KAAK;IACpC,IAAI,CAAS;IACb,QAAQ,CAAS;IACjB,KAAK,CAAU;IAExB,YAAY,KAA0E;QACpF,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC/B,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC1D,CAAC;CACF;AAZD,oDAYC;AAED,SAAgB,aAAa,CAAC,KAK7B;IACC,OAAO,IAAI,oBAAoB,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,SAAgB,YAAY,CAAC,KAAa,EAAE,OAAe;IACzD,MAAM,aAAa,CAAC;QAClB,IAAI,EAAE,eAAe;QACrB,OAAO;QACP,QAAQ,EAAE,CAAC;QACX,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,cAAc,CAAC,MAA+B,EAAE,KAAa;IAC3E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,MAAM,aAAa,CAAC;QAClB,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,GAAG,KAAK,eAAe;QAChC,QAAQ,EAAE,CAAC;QACX,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,cAAc,CAAC,MAA+B,EAAE,KAAa;IAC3E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,aAAa,CAAC;QAClB,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,GAAG,KAAK,oBAAoB;QACrC,QAAQ,EAAE,CAAC;QACX,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,cAAc,CAAC,MAA+B,EAAE,KAAa;IAC3E,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtE,MAAM,aAAa,CAAC;QAClB,IAAI,EAAE,eAAe;QACrB,OAAO,EAAE,GAAG,KAAK,2BAA2B;QAC5C,QAAQ,EAAE,CAAC;QACX,KAAK;KACN,CAAC,CAAC;AACL,CAAC"}

package/lib/agent-cli-provider/contract-fallback.d.ts

@@ -0,0 +1,7 @@
+import { ContractRequestError } from './contract-errors';
+import { type ContractEnvelope } from './contract-envelope';
+import type { RequestData } from './contract-support';
+export declare function requestEnvelopeData(input: string): RequestData;
+export declare function requestErrorFromUnknown(error: unknown): ContractRequestError;
+export declare function fallbackErrorEnvelope(fallback: RequestData, requestError: ContractRequestError): ContractEnvelope;
+//# sourceMappingURL=contract-fallback.d.ts.map

package/lib/agent-cli-provider/contract-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-fallback.d.ts","sourceRoot":"","sources":["../../src/agent-cli-provider/contract-fallback.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAiB,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAe9D;AAiDD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAO5E;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,WAAW,EACrB,YAAY,EAAE,oBAAoB,GACjC,gBAAgB,CAuBlB"}

package/lib/agent-cli-provider/contract-fallback.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requestEnvelopeData = requestEnvelopeData;
+exports.requestErrorFromUnknown = requestErrorFromUnknown;
+exports.fallbackErrorEnvelope = fallbackErrorEnvelope;
+const adapters_1 = require("./adapters");
+const contract_env_1 = require("./contract-env");
+const contract_errors_1 = require("./contract-errors");
+const contract_envelope_1 = require("./contract-envelope");
+const json_1 = require("./json");
+const redaction_1 = require("./redaction");
+function requestEnvelopeData(input) {
+    try {
+        const parsed = (0, json_1.parseJson)(input);
+        if ((0, json_1.isRecord)(parsed)) {
+            return {
+                raw: parsed,
+                command: (0, json_1.getString)(parsed, 'command'),
+                provider: (0, json_1.getString)(parsed, 'provider'),
+                env: fallbackRedactionEnv(parsed),
+            };
+        }
+    }
+    catch {
+        return { raw: {}, command: null, provider: null, env: {} };
+    }
+    return { raw: {}, command: null, provider: null, env: {} };
+}
+function fallbackStringRecord(value) {
+    if (!(0, json_1.isRecord)(value))
+        return {};
+    const result = {};
+    for (const [key, item] of Object.entries(value)) {
+        if (typeof item === 'string')
+            result[key] = item;
+    }
+    return result;
+}
+function fallbackRedactionEnv(value) {
+    const options = (0, json_1.isRecord)(value.options) ? value.options : {};
+    return (0, contract_env_1.mergeEnvForRedaction)({ source: 'request', env: fallbackStringRecord(value.env) }, { source: 'options.authEnv', env: fallbackStringRecord(options.authEnv) });
+}
+function redactFallbackField(input) {
+    if (input.value === null || !input.untrusted)
+        return { value: input.value, redactions: [] };
+    const result = (0, redaction_1.redactString)(input.value, input.env);
+    if (typeof result.value !== 'string') {
+        throw new Error('Redacted provider contract field lost its string shape.');
+    }
+    return { value: result.value, redactions: result.redactions };
+}
+function errorObject(requestError) {
+    if (requestError.field === undefined) {
+        return {
+            code: requestError.code,
+            message: requestError.message,
+        };
+    }
+    return {
+        code: requestError.code,
+        message: requestError.message,
+        field: requestError.field,
+    };
+}
+function requestErrorFromUnknown(error) {
+    if (error instanceof contract_errors_1.ContractRequestError)
+        return error;
+    return (0, contract_errors_1.contractError)({
+        code: 'internal-error',
+        message: (0, json_1.unknownToMessage)(error),
+        exitCode: 5,
+    });
+}
+function fallbackErrorEnvelope(fallback, requestError) {
+    const adapter = fallback.provider === null ? null : providerAdapterOrNull(fallback.provider);
+    const command = redactFallbackField({
+        value: fallback.command,
+        env: fallback.env,
+        untrusted: requestError.field === 'command',
+    });
+    const provider = redactFallbackField({
+        value: fallback.provider,
+        env: fallback.env,
+        untrusted: requestError.field === 'provider',
+    });
+    return (0, contract_envelope_1.errorEnvelope)({
+        command: command.value,
+        provider: provider.value,
+        adapterVersion: adapter?.adapterVersion ?? null,
+        redactions: (0, redaction_1.mergeRedactions)((0, contract_env_1.envRedactions)(fallback.env), command.redactions, provider.redactions),
+        error: errorObject(requestError),
+    });
+}
+function providerAdapterOrNull(provider) {
+    try {
+        return (0, adapters_1.getProviderAdapter)(provider);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=contract-fallback.js.map

package/lib/agent-cli-provider/contract-fallback.js.map

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

package/lib/agent-cli-provider/contract-invoke.d.ts

@@ -0,0 +1,5 @@
+import { type ContractEnvelope } from './contract-envelope';
+import { type RequestData } from './contract-support';
+import type { ProcessRunner } from './process-runner';
+export declare function runInvoke(request: RequestData, runner: ProcessRunner): Promise<ContractEnvelope>;
+//# sourceMappingURL=contract-invoke.d.ts.map

package/lib/agent-cli-provider/contract-invoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-invoke.d.ts","sourceRoot":"","sources":["../../src/agent-cli-provider/contract-invoke.ts"],"names":[],"mappings":"AAEA,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAgD,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKpG,OAAO,KAAK,EAAiB,aAAa,EAAwB,MAAM,kBAAkB,CAAC;AAyC3F,wBAAsB,SAAS,CAC7B,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAsC3B"}