specrails-core 5.2.3 → 5.4.0

package/dist/agent-runtime/graph-checkpointer.js

@@ -0,0 +1,137 @@
+import { BaseCheckpointSaver, copyCheckpoint, WRITES_IDX_MAP, } from '@langchain/langgraph-checkpoint';
+const SAFE_KEY = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,255}$/;
+function key(...parts) { return JSON.stringify(parts); }
+function assertKey(field, value, allowEmpty = false) {
+    if (typeof value !== 'string' || (!allowEmpty && !value) || (value && !SAFE_KEY.test(value)))
+        throw new Error(`Invalid checkpoint ${field}`);
+    return value;
+}
+/**
+ * LangGraph checkpointer whose whole history lives inside the run's durable
+ * envelope. Every checkpoint or pending write is persisted through the same
+ * atomic file write as the host ledger, so traversal state and receipts can
+ * never disagree after a crash. Values are serialized by LangGraph's own
+ * serializer and stored as base64 so the envelope stays plain JSON.
+ */
+export class FileCheckpointSaver extends BaseCheckpointSaver {
+    io;
+    checkpoints = new Map();
+    writes = new Map();
+    constructor(io) {
+        super();
+        this.io = io;
+        const stored = io.load();
+        if (stored) {
+            if (stored.format !== 1 || !Array.isArray(stored.checkpoints) || !Array.isArray(stored.writes))
+                throw new Error('Invalid graph checkpoint store');
+            for (const entry of stored.checkpoints)
+                this.checkpoints.set(key(entry.threadId, entry.ns, entry.id), entry);
+            for (const entry of stored.writes)
+                this.writes.set(key(entry.threadId, entry.ns, entry.checkpointId, entry.taskId, String(entry.idx)), entry);
+        }
+    }
+    /** A JSON snapshot of the complete store. */
+    serialize() {
+        return { format: 1, checkpoints: [...this.checkpoints.values()], writes: [...this.writes.values()] };
+    }
+    async dump(value) {
+        const [type, bytes] = await this.serde.dumpsTyped(value);
+        return { type, data: Buffer.from(bytes).toString('base64') };
+    }
+    async load(blob) {
+        return await this.serde.loadsTyped(blob.type, Buffer.from(blob.data, 'base64'));
+    }
+    persist() { return this.io.save(this.serialize()); }
+    async tuple(entry) {
+        const pendingWrites = await Promise.all([...this.writes.values()]
+            .filter(write => write.threadId === entry.threadId && write.ns === entry.ns && write.checkpointId === entry.id)
+            .map(async (write) => [write.taskId, write.channel, await this.load(write.value)]));
+        const result = {
+            config: { configurable: { thread_id: entry.threadId, checkpoint_ns: entry.ns, checkpoint_id: entry.id } },
+            checkpoint: await this.load(entry.checkpoint),
+            metadata: await this.load(entry.metadata),
+            pendingWrites,
+        };
+        if (entry.parentId !== undefined)
+            result.parentConfig = { configurable: { thread_id: entry.threadId, checkpoint_ns: entry.ns, checkpoint_id: entry.parentId } };
+        return result;
+    }
+    entries(threadId, ns) {
+        return [...this.checkpoints.values()]
+            .filter(entry => (threadId === undefined || entry.threadId === threadId) && (ns === undefined || entry.ns === ns))
+            .sort((a, b) => b.id.localeCompare(a.id));
+    }
+    async getTuple(config) {
+        const threadId = assertKey('thread_id', config.configurable?.thread_id);
+        const ns = assertKey('checkpoint_ns', config.configurable?.checkpoint_ns ?? '', true);
+        const checkpointId = config.configurable?.checkpoint_id;
+        if (checkpointId !== undefined) {
+            const entry = this.checkpoints.get(key(threadId, ns, assertKey('checkpoint_id', checkpointId)));
+            return entry ? this.tuple(entry) : undefined;
+        }
+        const latest = this.entries(threadId, ns)[0];
+        return latest ? this.tuple(latest) : undefined;
+    }
+    async *list(config, options) {
+        const threadId = config.configurable?.thread_id;
+        const ns = config.configurable?.checkpoint_ns;
+        const only = config.configurable?.checkpoint_id;
+        const before = options?.before?.configurable?.checkpoint_id;
+        let remaining = options?.limit;
+        for (const entry of this.entries(threadId, ns)) {
+            if (only !== undefined && entry.id !== only)
+                continue;
+            if (before !== undefined && entry.id >= before)
+                continue;
+            const tuple = await this.tuple(entry);
+            if (options?.filter && !Object.entries(options.filter).every(([name, value]) => tuple.metadata?.[name] === value))
+                continue;
+            if (remaining !== undefined) {
+                if (remaining <= 0)
+                    break;
+                remaining -= 1;
+            }
+            yield tuple;
+        }
+    }
+    async put(config, checkpoint, metadata, _newVersions) {
+        const threadId = assertKey('thread_id', config.configurable?.thread_id);
+        const ns = assertKey('checkpoint_ns', config.configurable?.checkpoint_ns ?? '', true);
+        const id = assertKey('checkpoint_id', checkpoint.id);
+        const parentId = config.configurable?.checkpoint_id;
+        const entry = {
+            threadId, ns, id, ...(parentId !== undefined ? { parentId } : {}),
+            checkpoint: await this.dump(copyCheckpoint(checkpoint)), metadata: await this.dump(metadata),
+        };
+        this.checkpoints.set(key(threadId, ns, id), entry);
+        await this.persist();
+        return { configurable: { thread_id: threadId, checkpoint_ns: ns, checkpoint_id: id } };
+    }
+    async putWrites(config, writes, taskId) {
+        const threadId = assertKey('thread_id', config.configurable?.thread_id);
+        const ns = assertKey('checkpoint_ns', config.configurable?.checkpoint_ns ?? '', true);
+        const checkpointId = assertKey('checkpoint_id', config.configurable?.checkpoint_id);
+        assertKey('task_id', taskId);
+        let changed = false;
+        for (const [index, [channel, value]] of writes.entries()) {
+            const idx = WRITES_IDX_MAP[channel] ?? index;
+            const writeKey = key(threadId, ns, checkpointId, taskId, String(idx));
+            if (idx >= 0 && this.writes.has(writeKey))
+                continue;
+            this.writes.set(writeKey, { threadId, ns, checkpointId, taskId, idx, channel, value: await this.dump(value) });
+            changed = true;
+        }
+        if (changed)
+            await this.persist();
+    }
+    async deleteThread(threadId) {
+        for (const [name, entry] of this.checkpoints)
+            if (entry.threadId === threadId)
+                this.checkpoints.delete(name);
+        for (const [name, entry] of this.writes)
+            if (entry.threadId === threadId)
+                this.writes.delete(name);
+        await this.persist();
+    }
+}
+//# sourceMappingURL=graph-checkpointer.js.map

package/dist/agent-runtime/graph-checkpointer.js.map

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

package/dist/agent-runtime/index.d.ts

@@ -0,0 +1,20 @@
+/** Hosts define graph state with LangGraph's Annotation without a direct LangGraph dependency. */
+export { Annotation } from '@langchain/langgraph';
+export * from './executor-types.js';
+export * from './efficiency.js';
+export * from './config.js';
+export * from './capabilities.js';
+export * from './runtime-identity.js';
+export * from './executors.js';
+export * from './workflow.js';
+export * from './core-host.js';
+export * from './graph/state.js';
+export { coreNodes, developerRecord, buildAcceptanceReport, MAX_DEEPEN_PASSES, type CoreNodeDeps } from './graph/nodes.js';
+export { DEFAULT_REVIEW_POLICY, REVIEW_ASPECTS, evaluateReview, resolveReviewPolicy, type ReviewAspect, type ReviewPolicy } from './graph/review-policy.js';
+export { createRoleInvoker, type Accept, type InvokeOptions, type InvokeOutcome, type RoleInvoker, type RoleInvokerDeps } from './graph/roles.js';
+export { parseAgentObject } from './graph/artifacts.js';
+export { FileCheckpointSaver, type GraphStoreIO, type SerializedGraphStore } from './graph-checkpointer.js';
+export { ARCHITECT_OUTPUT_SCHEMA, DEVELOPER_OUTPUT_SCHEMA, REVIEW_OUTPUT_SCHEMA, ROLE_INSTRUCTIONS_VERSION, rolePromptDefaults, correctionInstructions, deepenInstructions, repairInstructions, roleInstructions, type FrozenCriterion, type RoleFeedback, type RoleInstructionOptions, } from './prompts.js';
+export { OPENSPEC_VERSION, ROLE_SKILLS, type OpenSpecRoleContext } from './openspec.js';
+export * from './efficiency-summary.js';
+export { readVerificationEvidence, type VerificationEvidenceQuery } from '../installer/runtime/pipeline-state.js';

package/dist/agent-runtime/index.js

@@ -0,0 +1,21 @@
+/** Hosts define graph state with LangGraph's Annotation without a direct LangGraph dependency. */
+export { Annotation } from '@langchain/langgraph';
+export * from './executor-types.js';
+export * from './efficiency.js';
+export * from './config.js';
+export * from './capabilities.js';
+export * from './runtime-identity.js';
+export * from './executors.js';
+export * from './workflow.js';
+export * from './core-host.js';
+export * from './graph/state.js';
+export { coreNodes, developerRecord, buildAcceptanceReport, MAX_DEEPEN_PASSES } from './graph/nodes.js';
+export { DEFAULT_REVIEW_POLICY, REVIEW_ASPECTS, evaluateReview, resolveReviewPolicy } from './graph/review-policy.js';
+export { createRoleInvoker } from './graph/roles.js';
+export { parseAgentObject } from './graph/artifacts.js';
+export { FileCheckpointSaver } from './graph-checkpointer.js';
+export { ARCHITECT_OUTPUT_SCHEMA, DEVELOPER_OUTPUT_SCHEMA, REVIEW_OUTPUT_SCHEMA, ROLE_INSTRUCTIONS_VERSION, rolePromptDefaults, correctionInstructions, deepenInstructions, repairInstructions, roleInstructions, } from './prompts.js';
+export { OPENSPEC_VERSION, ROLE_SKILLS } from './openspec.js';
+export * from './efficiency-summary.js';
+export { readVerificationEvidence } from '../installer/runtime/pipeline-state.js';
+//# sourceMappingURL=index.js.map

package/dist/agent-runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent-runtime/index.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,cAAc,qBAAqB,CAAA;AACnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,qBAAqB,EAAE,iBAAiB,EAAqB,MAAM,kBAAkB,CAAA;AAC1H,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAwC,MAAM,0BAA0B,CAAA;AAC3J,OAAO,EAAE,iBAAiB,EAA+F,MAAM,kBAAkB,CAAA;AACjJ,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAgD,MAAM,yBAAyB,CAAA;AAC3G,OAAO,EACL,uBAAuB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,yBAAyB,EACjG,kBAAkB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,GACrG,MAAM,cAAc,CAAA;AAErB,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAA4B,MAAM,eAAe,CAAA;AAEvF,cAAc,yBAAyB,CAAA;AACvC,OAAO,EAAE,wBAAwB,EAAkC,MAAM,wCAAwC,CAAA"}

package/dist/agent-runtime/kimi-acp.d.ts

@@ -0,0 +1,11 @@
+import { type AgentRequest, type AgentResult } from './executor-types.js';
+import { type CliProcessRunner } from './cli-process.js';
+/** Native ACP v1 keeps Kimi 0.27 read-only roles usable without a platform skill or a model call during capability negotiation. */
+export declare function executeKimiReadonlyAcp(request: AgentRequest, options?: {
+    runProcess?: CliProcessRunner;
+    env?: NodeJS.ProcessEnv;
+    openspecBridge?: {
+        command: string;
+        args: string[];
+    };
+}): Promise<AgentResult>;

package/dist/agent-runtime/kimi-acp.js

@@ -0,0 +1,190 @@
+import { toolEvent } from './tool-event.js';
+import { normalizeKimiCliModel } from '../installer/runtime/kimi.js';
+import { AgentExecutionError, unknownUsage, validateAgentRequest } from './executor-types.js';
+import { runCliProcess } from './cli-process.js';
+import { parseStructuredText } from './openai-executor.js';
+import { WorkspaceTools } from './workspace-tools.js';
+function record(value) { return value && typeof value === 'object' && !Array.isArray(value) ? value : {}; }
+/** Native ACP v1 keeps Kimi 0.27 read-only roles usable without a platform skill or a model call during capability negotiation. */
+export async function executeKimiReadonlyAcp(request, options = {}) {
+    validateAgentRequest(request);
+    if (request.role === 'developer' && !options.openspecBridge)
+        throw new AgentExecutionError('Read-only ACP transport cannot execute developer roles', 'invalid_request');
+    if (request.maxCostUsd !== undefined)
+        throw new AgentExecutionError('Kimi cannot enforce a strict USD cap', 'cost_limit_unsupported');
+    if (request.maxTokens !== undefined)
+        throw new AgentExecutionError('Kimi 0.27 ACP does not report authoritative token usage. Remove the token cap or choose another provider for this role.', 'usage_unavailable');
+    const readOnly = request.role !== 'developer';
+    const mode = readOnly ? 'plan' : 'auto';
+    const tools = new WorkspaceTools(request.cwd, request.allowedRoots, request.role);
+    let transport, nextId = 0, sessionId, text = '', completed = false, turns = 0, permissionDenied = false;
+    const calls = new Map();
+    const send = (method, params, success) => {
+        const id = ++nextId;
+        calls.set(id, { method, success });
+        transport.send(JSON.stringify({ jsonrpc: '2.0', id, method, params }));
+    };
+    const prompt = () => {
+        send('session/prompt', { sessionId, prompt: [{ type: 'text', text: request.prompt }] }, result => {
+            if (result.stopReason !== 'end_turn' || !text.trim())
+                throw new AgentExecutionError('Kimi ACP did not return a complete final result', 'incomplete_response');
+            if (permissionDenied)
+                throw new AgentExecutionError('Kimi requested a forbidden operation during a read-only role', 'tool_policy_violation');
+            completed = true;
+            transport.complete();
+        });
+    };
+    const selectMode = () => {
+        send('session/set_mode', { sessionId, modeId: mode }, () => {
+            if (request.model)
+                send('session/set_config_option', { sessionId, configId: 'model', value: normalizeKimiCliModel(request.model) }, prompt);
+            else
+                prompt();
+        });
+    };
+    const onMessage = (line) => {
+        let message;
+        try {
+            message = record(JSON.parse(line));
+        }
+        catch {
+            throw new AgentExecutionError('Kimi emitted malformed ACP framing', 'invalid_response');
+        }
+        if (message.jsonrpc !== '2.0')
+            throw new AgentExecutionError('Kimi emitted an invalid JSON-RPC envelope', 'invalid_response');
+        if (typeof message.method === 'string') {
+            const params = record(message.params);
+            if (message.method === 'session/update' && message.id === undefined) {
+                if (!sessionId || params.sessionId !== sessionId)
+                    return;
+                const update = record(params.update);
+                if (update.sessionUpdate === 'agent_message_chunk') {
+                    const content = record(update.content);
+                    if (content.type === 'text' && typeof content.text === 'string') {
+                        text += content.text;
+                        request.onEvent?.({ kind: 'text', text: content.text });
+                    }
+                }
+                if (update.sessionUpdate === 'tool_call') {
+                    // Progress text remains in onEvent; structured results contain only
+                    // the assistant turn after the last tool invocation.
+                    text = '';
+                    turns++;
+                    if (turns > (request.maxTurns ?? 100))
+                        throw new AgentExecutionError('Kimi ACP exceeded its tool limit', 'max_turns');
+                    request.onEvent?.(toolEvent(typeof update.title === 'string' ? update.title : 'kimi-tool', { ...record(update.rawInput), paths: Array.isArray(update.locations) ? update.locations.map(location => record(location).path) : [] }));
+                }
+                if (update.sessionUpdate === 'current_mode_update' && update.currentModeId !== mode)
+                    throw new AgentExecutionError('Kimi left its read-only mode', 'tool_policy_violation');
+                if (update.sessionUpdate === 'config_option_update' && Array.isArray(update.configOptions)) {
+                    const mode = update.configOptions.map(record).find(option => option.id === 'mode');
+                    if (mode && mode.currentValue !== (readOnly ? 'plan' : 'auto'))
+                        throw new AgentExecutionError('Kimi left its read-only mode', 'tool_policy_violation');
+                }
+                return;
+            }
+            if (message.id === undefined)
+                return;
+            const respond = (result) => transport.send(JSON.stringify({ jsonrpc: '2.0', id: message.id, result }));
+            const deny = () => {
+                permissionDenied = true;
+                transport.send(JSON.stringify({ jsonrpc: '2.0', id: message.id, error: { code: -32603, message: 'Operation unavailable in a read-only Specrails role' } }));
+            };
+            if (!sessionId || params.sessionId !== sessionId) {
+                deny();
+                return;
+            }
+            if (message.method === 'fs/read_text_file') {
+                let content;
+                try {
+                    if (typeof params.path !== 'string')
+                        throw new Error('Missing path');
+                    content = tools.execute('read_file', { path: params.path });
+                    if (params.line !== undefined || params.limit !== undefined) {
+                        const start = params.line ?? 1, limit = params.limit ?? Number.MAX_SAFE_INTEGER;
+                        if (!Number.isSafeInteger(start) || start < 1 || !Number.isSafeInteger(limit) || limit < 1)
+                            throw new Error('Invalid line range');
+                        content = content.split('\n').slice(start - 1, start - 1 + limit).join('\n');
+                    }
+                }
+                catch {
+                    deny();
+                    return;
+                }
+                respond({ content });
+                return;
+            }
+            if (message.method === 'session/request_permission') {
+                // Only an explicit read/search of a validated workspace path may be approved.
+                const tool = record(params.toolCall), input = record(tool.rawInput);
+                const file = input.path ?? input.file_path;
+                const choices = Array.isArray(params.options) ? params.options.map(record) : [];
+                const allow = choices.find(option => option.kind === 'allow_once');
+                if (options.openspecBridge && ['mcp__specrails_openspec__workflow', 'mcp__specrails_openspec__read_verification_evidence'].includes(typeof tool.title === 'string' ? tool.title : '') && typeof allow?.optionId === 'string') {
+                    respond({ outcome: { outcome: 'selected', optionId: allow.optionId } });
+                    return;
+                }
+                if (!readOnly && typeof allow?.optionId === 'string') {
+                    respond({ outcome: { outcome: 'selected', optionId: allow.optionId } });
+                    return;
+                }
+                if (['read', 'search'].includes(String(tool.kind)) && typeof file === 'string' && typeof allow?.optionId === 'string') {
+                    try {
+                        tools.execute(tool.kind === 'read' ? 'read_file' : 'list_files', { path: file });
+                        respond({ outcome: { outcome: 'selected', optionId: allow.optionId } });
+                        return;
+                    }
+                    catch { /* reject an unscoped or unsupported read */ }
+                }
+                // No pre-existing provider permission can authorize a write/shell/mode switch for this role.
+                permissionDenied = true;
+                respond({ outcome: { outcome: 'cancelled' } });
+                return;
+            }
+            deny();
+            return;
+        }
+        if (typeof message.id !== 'number')
+            throw new AgentExecutionError('Kimi returned an unexpected ACP response', 'invalid_response');
+        const call = calls.get(message.id);
+        if (!call)
+            throw new AgentExecutionError('Kimi returned an unknown ACP response id', 'invalid_response');
+        calls.delete(message.id);
+        if (message.error)
+            throw new AgentExecutionError(`Kimi ACP ${call.method} failed. Check CLI capabilities, authentication and the configured model.`, 'provider_execution_error');
+        if (!message.result || typeof message.result !== 'object')
+            throw new AgentExecutionError('Kimi ACP response is missing its result', 'invalid_response');
+        call.success(record(message.result));
+    };
+    const result = await (options.runProcess ?? runCliProcess)({ command: 'kimi', args: ['acp'] }, {
+        cwd: tools.cwd, signal: request.signal, timeoutMs: request.timeoutMs ?? 15 * 60_000, env: options.env, onLine: onMessage,
+        duplex: control => {
+            transport = control;
+            send('initialize', { protocolVersion: 1, clientInfo: { name: 'specrails-core', version: '1' }, clientCapabilities: { fs: { readTextFile: readOnly, writeTextFile: readOnly }, terminal: readOnly } }, initialized => {
+                if (initialized.protocolVersion !== 1)
+                    throw new AgentExecutionError('Kimi ACP protocol version is unsupported', 'provider_capability_unsupported');
+                const capabilities = record(record(initialized.agentCapabilities).sessionCapabilities);
+                if (tools.roots.length > 1 && capabilities.additionalDirectories === undefined)
+                    throw new AgentExecutionError('This Kimi ACP version cannot expose multiple repositories. Upgrade Kimi or use another provider for this read-only role.', 'provider_capability_unsupported');
+                send('session/new', { cwd: tools.cwd, mcpServers: options.openspecBridge ? [{ name: 'specrails_openspec', ...options.openspecBridge, env: [] }] : [], ...(tools.roots.length > 1 ? { additionalDirectories: tools.roots.filter(root => root !== tools.cwd) } : {}) }, session => {
+                    if (typeof session.sessionId !== 'string' || !session.sessionId)
+                        throw new AgentExecutionError('Kimi ACP returned no session id', 'invalid_response');
+                    sessionId = session.sessionId;
+                    const modes = record(session.modes);
+                    const modeOption = Array.isArray(session.configOptions) ? session.configOptions.map(record).find(option => option.id === 'mode') : undefined;
+                    const available = Array.isArray(modes.availableModes) ? modes.availableModes.map(record) : [];
+                    const modeValues = Array.isArray(modeOption?.options) ? modeOption.options.map(record) : [];
+                    if (!available.some(item => item.id === mode) && !modeValues.some(item => item.value === mode))
+                        throw new AgentExecutionError('Kimi ACP does not expose enforced plan mode; upgrade Kimi Code before using a read-only role', 'provider_capability_unsupported');
+                    selectMode();
+                });
+            });
+        },
+    });
+    if (result.exitCode !== 0 || !completed)
+        throw new AgentExecutionError('Kimi ACP exited before completing the role', 'incomplete_response');
+    const usage = unknownUsage();
+    request.onEvent?.({ kind: 'usage', usage });
+    return { text, usage, sessionId, structured: parseStructuredText(text) };
+}
+//# sourceMappingURL=kimi-acp.js.map

package/dist/agent-runtime/kimi-acp.js.map

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

package/dist/agent-runtime/openai-executor.d.ts

@@ -0,0 +1,26 @@
+import { type AgentExecutor, type AgentLimits, type AgentRequest, type AgentResult, type RuntimeProviderConfig } from './executor-types.js';
+type ApiProvider = Extract<RuntimeProviderConfig, {
+    kind: 'openai-compatible';
+}>;
+export interface OpenAICompatibleOptions {
+    fetch?: typeof globalThis.fetch;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function parseStructuredText(text: string): Record<string, unknown> | undefined;
+/** No SDK, gateway, tracing backend, paid probe, or mandatory key. */
+export declare class OpenAICompatibleExecutor implements AgentExecutor {
+    private readonly provider;
+    private readonly options;
+    constructor(provider: ApiProvider, options?: OpenAICompatibleOptions);
+    capabilities(): {
+        continuation: "unsupported";
+        effortSupport: "unsupported";
+        supportedEfforts: never[];
+        transport: string;
+        observedModel: boolean;
+        observedEffort: boolean;
+    };
+    validateLimits(limits: AgentLimits): void;
+    execute(request: AgentRequest): Promise<AgentResult>;
+}
+export {};