@the-open-engine/zeroshot 5.4.0

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

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInvoke = runInvoke;
+const promises_1 = require("node:fs/promises");
+const contract_env_1 = require("./contract-env");
+const contract_envelope_1 = require("./contract-envelope");
+const contract_support_1 = require("./contract-support");
+const invoke_evidence_1 = require("./invoke-evidence");
+const contract_parse_1 = require("./contract-parse");
+const json_1 = require("./json");
+async function cleanupFiles(commandSpec) {
+    const cleanup = commandSpec.cleanup ?? [];
+    const results = [];
+    for (const file of cleanup) {
+        try {
+            await (0, promises_1.unlink)(file);
+            results.push({ path: file, removed: true });
+        }
+        catch (error) {
+            results.push({ path: file, removed: false, error: (0, json_1.unknownToMessage)(error) });
+        }
+    }
+    return results;
+}
+async function runAndCleanup(commandSpec, runner, runnerOptions) {
+    let result = null;
+    let runnerError;
+    try {
+        result = await runner(commandSpec, runnerOptions);
+    }
+    catch (error) {
+        runnerError = error;
+    }
+    const cleanup = await cleanupFiles(commandSpec);
+    if (runnerError !== undefined)
+        throw runnerError;
+    if (result === null)
+        throw new Error('Provider runner did not produce a result.');
+    return { result, cleanup };
+}
+async function runInvoke(request, runner) {
+    const { adapter, commandSpec, options } = (0, contract_support_1.buildCommandSpec)(request);
+    const timeoutMs = (0, contract_support_1.optionalNumber)(request.raw, 'timeoutMs');
+    const runnerOptions = timeoutMs === undefined ? {} : { timeoutMs };
+    const { result, cleanup } = await runAndCleanup(commandSpec, runner, runnerOptions);
+    const parsed = (0, contract_parse_1.parseOutputEvents)(adapter, {
+        chunk: [result.stdout, result.stderr].join('\n'),
+        sources: [
+            { name: 'stdout', value: result.stdout },
+            { name: 'stderr', value: result.stderr },
+        ],
+    });
+    const classification = (0, invoke_evidence_1.providerFailureClassification)(adapter, result);
+    return (0, contract_envelope_1.successEnvelope)({
+        command: request.command ?? 'invoke',
+        adapter,
+        warnings: commandSpec.warnings,
+        redactions: (0, contract_env_1.commandRedactions)(commandSpec),
+        evidence: invokeEvidence(result, timeoutMs),
+        result: {
+            commandSpec,
+            outputFormat: options.outputFormat ?? null,
+            schemaMode: (0, contract_support_1.schemaMode)(options),
+            evidence: {
+                stdout: result.stdout,
+                stderr: result.stderr,
+            },
+            events: parsed.events,
+            diagnostics: parsed.diagnostics,
+            exitCode: result.exitCode,
+            signal: result.signal,
+            durationMs: result.durationMs,
+            timedOut: result.timedOut ?? false,
+            timeoutMs: result.timeoutMs ?? timeoutMs ?? null,
+            cleanup,
+            classification,
+        },
+    });
+}
+function invokeEvidence(result, timeoutMs) {
+    return {
+        exitCode: result.exitCode,
+        signal: result.signal,
+        durationMs: result.durationMs,
+        timedOut: result.timedOut ?? false,
+        timeoutMs: result.timeoutMs ?? timeoutMs ?? null,
+    };
+}
+//# sourceMappingURL=contract-invoke.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { BuildProviderCommandOptions } from './types';
+export declare function requestOptions(value: unknown): BuildProviderCommandOptions;
+//# sourceMappingURL=contract-options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract-options.d.ts","sourceRoot":"","sources":["../../src/agent-cli-provider/contract-options.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,2BAA2B,EAM5B,MAAM,SAAS,CAAC;AAwBjB,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,2BAA2B,CAY1E"}

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

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requestOptions = requestOptions;
+const json_1 = require("./json");
+const contract_errors_1 = require("./contract-errors");
+const contract_env_1 = require("./contract-env");
+const OUTPUT_FORMATS = ['text', 'json', 'stream-json'];
+const MODEL_LEVELS = ['level1', 'level2', 'level3'];
+const REASONING_EFFORTS = ['low', 'medium', 'high', 'xhigh'];
+const CLI_FEATURE_FIELDS = [
+    'supportsOutputFormat',
+    'supportsStreamJson',
+    'supportsJsonSchema',
+    'supportsAutoApprove',
+    'supportsIncludePartials',
+    'supportsVerbose',
+    'supportsModel',
+    'supportsJson',
+    'supportsOutputSchema',
+    'supportsCwd',
+    'supportsConfigOverride',
+    'supportsSkipGitRepoCheck',
+    'supportsVariant',
+    'unknown',
+];
+function requestOptions(value) {
+    if (value === undefined)
+        return {};
+    if (!(0, json_1.isRecord)(value)) {
+        throw (0, contract_errors_1.contractError)({
+            code: 'invalid-field',
+            message: 'options must be an object.',
+            exitCode: 2,
+            field: 'options',
+        });
+    }
+    rejectProviderCommandOverrides(value);
+    return normalizeBuildOptions(value);
+}
+function rejectProviderCommandOverrides(value) {
+    for (const field of ['command', 'commandArgs']) {
+        if (!Object.prototype.hasOwnProperty.call(value, field))
+            continue;
+        throw (0, contract_errors_1.contractError)({
+            code: 'forbidden-field',
+            message: `options.${field} is not accepted by provider executable requests; provider adapters own executable binaries and arguments.`,
+            exitCode: 2,
+            field: `options.${field}`,
+        });
+    }
+}
+function optionalStringValue(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === 'string')
+        return value;
+    (0, contract_errors_1.invalidField)(field, `${field} must be a string.`);
+}
+function optionalNullableStringValue(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (value === null)
+        return null;
+    if (typeof value === 'string')
+        return value;
+    (0, contract_errors_1.invalidField)(field, `${field} must be a string or null.`);
+}
+function optionalBooleanValue(value, field) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === 'boolean')
+        return value;
+    (0, contract_errors_1.invalidField)(field, `${field} must be a boolean.`);
+}
+function optionalEnumValue(value, field, allowed) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string') {
+        (0, contract_errors_1.invalidField)(field, `${field} must be a string.`);
+    }
+    for (const item of allowed) {
+        if (value === item)
+            return item;
+    }
+    (0, contract_errors_1.invalidField)(field, `${field} must be one of: ${allowed.join(', ')}.`);
+}
+function optionalModelSpec(value) {
+    if (value === undefined)
+        return undefined;
+    if (!(0, json_1.isRecord)(value)) {
+        (0, contract_errors_1.invalidField)('options.modelSpec', 'options.modelSpec must be an object.');
+    }
+    const level = optionalEnumValue(value.level, 'options.modelSpec.level', MODEL_LEVELS);
+    const model = optionalNullableStringValue(value.model, 'options.modelSpec.model');
+    const reasoningEffort = optionalEnumValue(value.reasoningEffort, 'options.modelSpec.reasoningEffort', REASONING_EFFORTS);
+    return {
+        ...(level === undefined ? {} : { level }),
+        ...(model === undefined ? {} : { model }),
+        ...(reasoningEffort === undefined ? {} : { reasoningEffort }),
+    };
+}
+function optionalCliFeatures(value) {
+    if (value === undefined)
+        return undefined;
+    if (!(0, json_1.isRecord)(value)) {
+        (0, contract_errors_1.invalidField)('options.cliFeatures', 'options.cliFeatures must be an object.');
+    }
+    const result = {};
+    for (const field of CLI_FEATURE_FIELDS) {
+        const item = optionalBooleanValue(value[field], `options.cliFeatures.${field}`);
+        if (item !== undefined)
+            result[field] = item;
+    }
+    return result;
+}
+function normalizeBuildOptions(value) {
+    const result = {};
+    addDefined(result, 'modelSpec', optionalModelSpec(value.modelSpec));
+    addDefined(result, 'outputFormat', optionalEnumValue(value.outputFormat, 'options.outputFormat', OUTPUT_FORMATS));
+    addPresent(result, value, 'jsonSchema');
+    addDefined(result, 'cwd', optionalStringValue(value.cwd, 'options.cwd'));
+    addDefined(result, 'autoApprove', optionalBooleanValue(value.autoApprove, 'options.autoApprove'));
+    addDefined(result, 'resumeSessionId', optionalStringValue(value.resumeSessionId, 'options.resumeSessionId'));
+    addDefined(result, 'continueSession', optionalBooleanValue(value.continueSession, 'options.continueSession'));
+    addDefined(result, 'cliFeatures', optionalCliFeatures(value.cliFeatures));
+    addDefined(result, 'strictSchema', optionalBooleanValue(value.strictSchema, 'options.strictSchema'));
+    if (Object.prototype.hasOwnProperty.call(value, 'authEnv')) {
+        result.authEnv = (0, contract_env_1.stringRecord)(value.authEnv, 'options.authEnv');
+    }
+    return result;
+}
+function addDefined(result, key, value) {
+    if (value !== undefined)
+        result[key] = value;
+}
+function addPresent(result, input, key) {
+    if (Object.prototype.hasOwnProperty.call(input, key))
+        result[key] = input[key];
+}
+//# sourceMappingURL=contract-options.js.map

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

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

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

@@ -0,0 +1,15 @@
+import { type ContractEnvelope, type ContractEvidence } from './contract-envelope';
+import { type RequestData } from './contract-support';
+import type { OutputEvent, ProviderAdapter } from './types';
+export declare function parseOutputEvents(adapter: ProviderAdapter, fragments: {
+    readonly chunk: string;
+    readonly sources: readonly {
+        readonly name: string;
+        readonly value: string;
+    }[];
+}): {
+    readonly events: readonly OutputEvent[];
+    readonly diagnostics: readonly ContractEvidence[];
+};
+export declare function runParseOutput(request: RequestData): ContractEnvelope;
+//# sourceMappingURL=contract-parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract-parse.d.ts","sourceRoot":"","sources":["../../src/agent-cli-provider/contract-parse.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAkD5D,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,eAAe,EACxB,SAAS,EAAE;IACT,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChF,GACA;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAAE,CAmBhG;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,gBAAgB,CAUrE"}

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

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseOutputEvents = parseOutputEvents;
+exports.runParseOutput = runParseOutput;
+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_support_1 = require("./contract-support");
+const json_1 = require("./json");
+function parseFragments(record) {
+    const sources = ['stdout', 'stderr', 'jsonl']
+        .map((name) => {
+        const value = (0, contract_errors_1.optionalString)(record, name);
+        return value === undefined ? null : { name, value };
+    })
+        .filter((value) => value !== null);
+    return {
+        chunk: sources.map((source) => source.value).join('\n'),
+        sources,
+    };
+}
+function collectParseDiagnostics(sources) {
+    const diagnostics = [];
+    for (const source of sources) {
+        collectSourceDiagnostics(diagnostics, source);
+    }
+    return diagnostics;
+}
+function collectSourceDiagnostics(diagnostics, source) {
+    const lines = source.value.split('\n');
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index]?.trim() ?? '';
+        if (!isMalformedJsonCandidate(line))
+            continue;
+        diagnostics.push({
+            kind: 'parse-error',
+            source: source.name,
+            line: index + 1,
+            fragment: line,
+        });
+    }
+}
+function isMalformedJsonCandidate(line) {
+    if (!line || (!line.startsWith('{') && !line.startsWith('[')))
+        return false;
+    return (0, json_1.tryParseJson)(line) === null;
+}
+function parseOutputEvents(adapter, fragments) {
+    const diagnostics = [...collectParseDiagnostics(fragments.sources)];
+    try {
+        return {
+            events: (0, adapters_1.parseProviderChunk)(adapter.id, fragments.chunk),
+            diagnostics,
+        };
+    }
+    catch (error) {
+        return {
+            events: [],
+            diagnostics: [
+                ...diagnostics,
+                {
+                    kind: 'parser-error',
+                    message: (0, json_1.unknownToMessage)(error),
+                },
+            ],
+        };
+    }
+}
+function runParseOutput(request) {
+    const adapter = (0, contract_support_1.adapterForProvider)(request.provider);
+    const fragments = parseFragments(request.raw);
+    const parsed = parseOutputEvents(adapter, fragments);
+    return (0, contract_envelope_1.successEnvelope)({
+        command: request.command ?? 'parse-output',
+        adapter,
+        redactions: (0, contract_env_1.envRedactions)(request.env),
+        result: parsed,
+    });
+}
+//# sourceMappingURL=contract-parse.js.map

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

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

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

@@ -0,0 +1,18 @@
+import type { BuildProviderCommandOptions, CommandSpec, ProviderAdapter } from './types';
+export { contractError, ContractRequestError, optionalNumber, optionalString, requiredString, } from './contract-errors';
+export { collectCommandSpecEnv, commandRedactions, envRedactions, mergeEnvForRedaction, providerCredentialEnv, stringRecord, } from './contract-env';
+export interface RequestData {
+    readonly raw: Record<string, unknown>;
+    readonly command: string | null;
+    readonly provider: string | null;
+    readonly env: Readonly<Record<string, string>>;
+}
+export declare function adapterForProvider(provider: string | null): ProviderAdapter;
+export declare function buildCommandSpec(request: RequestData): {
+    readonly adapter: ProviderAdapter;
+    readonly commandSpec: CommandSpec;
+    readonly options: BuildProviderCommandOptions;
+};
+export declare function schemaMode(options: BuildProviderCommandOptions): string;
+export declare function validateRequest(input: string, schemaVersion: 1): RequestData;
+//# sourceMappingURL=contract-support.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract-support.d.ts","sourceRoot":"","sources":["../../src/agent-cli-provider/contract-support.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,2BAA2B,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAIxB,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAChD;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,eAAe,CAmB3E;AAqBD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG;IACtD,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC;CAC/C,CAcA;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,CAGvE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,GAAG,WAAW,CAU5E"}

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

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringRecord = exports.providerCredentialEnv = exports.mergeEnvForRedaction = exports.envRedactions = exports.commandRedactions = exports.collectCommandSpecEnv = exports.requiredString = exports.optionalString = exports.optionalNumber = exports.ContractRequestError = exports.contractError = void 0;
+exports.adapterForProvider = adapterForProvider;
+exports.buildCommandSpec = buildCommandSpec;
+exports.schemaMode = schemaMode;
+exports.validateRequest = validateRequest;
+const adapters_1 = require("./adapters");
+const json_1 = require("./json");
+const redaction_1 = require("./redaction");
+const contract_options_1 = require("./contract-options");
+const single_agent_runtime_1 = require("./single-agent-runtime");
+var contract_errors_1 = require("./contract-errors");
+Object.defineProperty(exports, "contractError", { enumerable: true, get: function () { return contract_errors_1.contractError; } });
+Object.defineProperty(exports, "ContractRequestError", { enumerable: true, get: function () { return contract_errors_1.ContractRequestError; } });
+Object.defineProperty(exports, "optionalNumber", { enumerable: true, get: function () { return contract_errors_1.optionalNumber; } });
+Object.defineProperty(exports, "optionalString", { enumerable: true, get: function () { return contract_errors_1.optionalString; } });
+Object.defineProperty(exports, "requiredString", { enumerable: true, get: function () { return contract_errors_1.requiredString; } });
+var contract_env_1 = require("./contract-env");
+Object.defineProperty(exports, "collectCommandSpecEnv", { enumerable: true, get: function () { return contract_env_1.collectCommandSpecEnv; } });
+Object.defineProperty(exports, "commandRedactions", { enumerable: true, get: function () { return contract_env_1.commandRedactions; } });
+Object.defineProperty(exports, "envRedactions", { enumerable: true, get: function () { return contract_env_1.envRedactions; } });
+Object.defineProperty(exports, "mergeEnvForRedaction", { enumerable: true, get: function () { return contract_env_1.mergeEnvForRedaction; } });
+Object.defineProperty(exports, "providerCredentialEnv", { enumerable: true, get: function () { return contract_env_1.providerCredentialEnv; } });
+Object.defineProperty(exports, "stringRecord", { enumerable: true, get: function () { return contract_env_1.stringRecord; } });
+const contract_errors_2 = require("./contract-errors");
+const contract_env_2 = require("./contract-env");
+function adapterForProvider(provider) {
+    if (provider === null || provider.length === 0) {
+        throw (0, contract_errors_2.contractError)({
+            code: 'missing-field',
+            message: 'provider is required.',
+            exitCode: 2,
+            field: 'provider',
+        });
+    }
+    try {
+        return (0, adapters_1.getProviderAdapter)(provider);
+    }
+    catch {
+        throw (0, contract_errors_2.contractError)({
+            code: 'unknown-provider',
+            message: `Unknown provider: ${provider}.`,
+            exitCode: 4,
+            field: 'provider',
+        });
+    }
+}
+function mergeCommandSpec(commandSpec, env) {
+    const mergedEnv = { ...commandSpec.env, ...env };
+    return {
+        ...commandSpec,
+        env: mergedEnv,
+        redactions: (0, redaction_1.mergeRedactions)(commandSpec.redactions, (0, contract_env_2.envRedactions)(mergedEnv)),
+    };
+}
+function buildOptions(request) {
+    const options = (0, contract_options_1.requestOptions)(request.raw.options);
+    const cwd = (0, contract_errors_2.optionalString)(request.raw, 'cwd');
+    if (cwd === undefined || options.cwd !== undefined)
+        return options;
+    return { ...options, cwd };
+}
+function buildCommandSpec(request) {
+    const adapter = adapterForProvider(request.provider);
+    const context = (0, contract_errors_2.requiredString)(request.raw, 'context');
+    const options = buildOptions(request);
+    const prepared = (0, single_agent_runtime_1.prepareSingleAgentProviderCommand)({
+        provider: adapter.id,
+        context,
+        options,
+    });
+    return {
+        adapter: prepared.adapter,
+        options: prepared.options,
+        commandSpec: mergeCommandSpec(prepared.commandSpec, request.env),
+    };
+}
+function schemaMode(options) {
+    if (!options.jsonSchema)
+        return 'none';
+    return options.strictSchema === false ? 'prompt' : 'strict';
+}
+function validateRequest(input, schemaVersion) {
+    const parsed = parseRequestObject(input);
+    assertSchemaVersion(parsed, schemaVersion);
+    const command = requiredCommand(parsed);
+    return {
+        raw: parsed,
+        command,
+        provider: (0, json_1.getString)(parsed, 'provider'),
+        env: requestEnv(parsed),
+    };
+}
+const KNOWN_COMMANDS = [
+    'probe',
+    'build-command',
+    'parse-output',
+    'classify-error',
+    'invoke',
+];
+function parseRequestObject(input) {
+    let parsed;
+    try {
+        parsed = (0, json_1.parseJson)(input);
+    }
+    catch {
+        throw (0, contract_errors_2.contractError)({
+            code: 'malformed-json',
+            message: 'Request body must be valid JSON.',
+            exitCode: 2,
+        });
+    }
+    if ((0, json_1.isRecord)(parsed))
+        return parsed;
+    throw (0, contract_errors_2.contractError)({
+        code: 'invalid-request',
+        message: 'Request body must be a JSON object.',
+        exitCode: 2,
+    });
+}
+function assertSchemaVersion(parsed, schemaVersion) {
+    if (parsed.schemaVersion === schemaVersion)
+        return;
+    throw (0, contract_errors_2.contractError)({
+        code: 'unsupported-schema-version',
+        message: 'schemaVersion must be 1.',
+        exitCode: 2,
+        field: 'schemaVersion',
+    });
+}
+function requiredCommand(parsed) {
+    const command = (0, json_1.getString)(parsed, 'command');
+    if (command === null) {
+        throw (0, contract_errors_2.contractError)({
+            code: 'missing-field',
+            message: 'command is required.',
+            exitCode: 2,
+            field: 'command',
+        });
+    }
+    if (KNOWN_COMMANDS.includes(command))
+        return command;
+    throw (0, contract_errors_2.contractError)({
+        code: 'unknown-command',
+        message: `Unknown command: ${command}.`,
+        exitCode: 3,
+        field: 'command',
+    });
+}
+function requestEnv(parsed) {
+    return (0, contract_env_2.stringRecord)(parsed.env, 'env');
+}
+//# sourceMappingURL=contract-support.js.map

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

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

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

@@ -0,0 +1,13 @@
+import { type ProcessRunner } from './process-runner';
+import type { ContractEnvelope } from './contract-envelope';
+export { providerExecutableSchemaVersion, type ContractEnvelope, type ContractErrorEnvelope, type ContractErrorObject, type ContractEvidence, type ContractSuccessEnvelope, } from './contract-envelope';
+export type ProviderExecutableCommand = 'probe' | 'build-command' | 'parse-output' | 'classify-error' | 'invoke';
+export interface ProviderExecutableResponse {
+    readonly envelope: ContractEnvelope;
+    readonly exitCode: number;
+}
+export interface ProviderExecutableOptions {
+    readonly runner?: ProcessRunner;
+}
+export declare function runProviderExecutable(input: string, options?: ProviderExecutableOptions): Promise<ProviderExecutableResponse>;
+//# sourceMappingURL=contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../src/agent-cli-provider/contract.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,OAAO,EACL,+BAA+B,EAC/B,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,yBAAyB,GACjC,OAAO,GACP,eAAe,GACf,cAAc,GACd,gBAAgB,GAChB,QAAQ,CAAC;AAEb,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;CACjC;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,0BAA0B,CAAC,CAgBrC"}

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

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.providerExecutableSchemaVersion = void 0;
+exports.runProviderExecutable = runProviderExecutable;
+const contract_actions_1 = require("./contract-actions");
+const contract_fallback_1 = require("./contract-fallback");
+const contract_envelope_1 = require("./contract-envelope");
+const contract_support_1 = require("./contract-support");
+const process_runner_1 = require("./process-runner");
+var contract_envelope_2 = require("./contract-envelope");
+Object.defineProperty(exports, "providerExecutableSchemaVersion", { enumerable: true, get: function () { return contract_envelope_2.providerExecutableSchemaVersion; } });
+async function runProviderExecutable(input, options = {}) {
+    const fallback = (0, contract_fallback_1.requestEnvelopeData)(input);
+    try {
+        const request = (0, contract_support_1.validateRequest)(input, contract_envelope_1.providerExecutableSchemaVersion);
+        const envelope = await (0, contract_actions_1.dispatchRequest)(request, options.runner ?? (0, process_runner_1.spawnProcessRunner)());
+        return {
+            envelope: (0, contract_envelope_1.finalizeEnvelope)(envelope, request.env),
+            exitCode: 0,
+        };
+    }
+    catch (error) {
+        const requestError = (0, contract_fallback_1.requestErrorFromUnknown)(error);
+        return {
+            envelope: (0, contract_envelope_1.finalizeEnvelope)((0, contract_fallback_1.fallbackErrorEnvelope)(fallback, requestError), fallback.env),
+            exitCode: requestError.exitCode,
+        };
+    }
+}
+//# sourceMappingURL=contract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/agent-cli-provider/contract.ts"],"names":[],"mappings":";;;AAoCA,sDAmBC;AAvDD,yDAAqD;AACrD,2DAI6B;AAC7B,2DAAwF;AACxF,yDAAqD;AACrD,qDAA0E;AAG1E,yDAO6B;AAN3B,oIAAA,+BAA+B,OAAA;AAwB1B,KAAK,UAAU,qBAAqB,CACzC,KAAa,EACb,UAAqC,EAAE;IAEvC,MAAM,QAAQ,GAAG,IAAA,uCAAmB,EAAC,KAAK,CAAC,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,kCAAe,EAAC,KAAK,EAAE,mDAA+B,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,MAAM,IAAA,kCAAe,EAAC,OAAO,EAAE,OAAO,CAAC,MAAM,IAAI,IAAA,mCAAkB,GAAE,CAAC,CAAC;QACxF,OAAO;YACL,QAAQ,EAAE,IAAA,oCAAgB,EAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC;YACjD,QAAQ,EAAE,CAAC;SACZ,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,IAAA,2CAAuB,EAAC,KAAK,CAAC,CAAC;QACpD,OAAO;YACL,QAAQ,EAAE,IAAA,oCAAgB,EAAC,IAAA,yCAAqB,EAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC;YACvF,QAAQ,EAAE,YAAY,CAAC,QAAQ;SAChC,CAAC;IACJ,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,11 @@
+type EnvRecord = Readonly<Record<string, string | undefined>>;
+export declare function isExecutableResolutionEnvKey(key: string): boolean;
+export declare function isProcessControlEnvKey(key: string): boolean;
+export declare function isUnsafeProviderEnvKey(key: string): boolean;
+export declare function findExecutableResolutionEnvKey(env: EnvRecord): string | null;
+export declare function findUnsafeProviderEnvKey(env: EnvRecord): string | null;
+export declare function omitExecutableResolutionEnv(env: EnvRecord): Readonly<Record<string, string>>;
+export declare function omitProcessControlEnv(env: EnvRecord): Readonly<Record<string, string>>;
+export declare function omitUnsafeProviderEnv(env: EnvRecord): Readonly<Record<string, string>>;
+export {};
+//# sourceMappingURL=env-safety.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env-safety.d.ts","sourceRoot":"","sources":["../../src/agent-cli-provider/env-safety.ts"],"names":[],"mappings":"AA6BA,KAAK,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAE9D,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAI3D;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAK5E;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAKtE;AAcD,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAE5F;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAEtF;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAEtF"}