specrails-core 5.2.3 → 5.3.0

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

@@ -0,0 +1,179 @@
+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')
+        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 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: 'plan' }, () => {
+            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 ?? 24))
+                        throw new AgentExecutionError('Kimi ACP exceeded its tool limit', 'max_turns');
+                    request.onEvent?.({ kind: 'tool-start', tool: typeof update.title === 'string' ? update.title : 'kimi-tool' });
+                }
+                if (update.sessionUpdate === 'current_mode_update' && update.currentModeId !== 'plan')
+                    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 !== 'plan')
+                        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 (['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: true, writeTextFile: true }, terminal: true } }, 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: [], ...(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(mode => mode.id === 'plan') && !modeValues.some(mode => mode.value === 'plan'))
+                        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,18 @@
+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);
+    validateLimits(limits: AgentLimits): void;
+    execute(request: AgentRequest): Promise<AgentResult>;
+}
+export {};

package/dist/agent-runtime/openai-executor.js

@@ -0,0 +1,174 @@
+import { AgentExecutionError, unknownUsage, validateAgentRequest } from './executor-types.js';
+import { WorkspaceTools } from './workspace-tools.js';
+function record(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+function number(value) { return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : null; }
+function add(left, right) { return left === null || right === null ? null : left + right; }
+export function parseStructuredText(text) {
+    try {
+        return record(JSON.parse(text.trim().replace(/^```(?:json)?\s*\n/, '').replace(/\n```$/, '')));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** No SDK, gateway, tracing backend, paid probe, or mandatory key. */
+export class OpenAICompatibleExecutor {
+    provider;
+    options;
+    constructor(provider, options = {}) {
+        this.provider = provider;
+        this.options = options;
+    }
+    validateLimits(limits) {
+        if (limits.maxCostUsd !== undefined)
+            throw new AgentExecutionError('A strict USD cap requires an executor with a native spending limit; OpenAI-compatible endpoints do not provide one. Use a token cap or an executor with native cost enforcement.', 'cost_limit_unsupported');
+    }
+    async execute(request) {
+        validateAgentRequest(request);
+        this.validateLimits(request);
+        if (!request.model?.trim())
+            throw new AgentExecutionError('OpenAI-compatible execution requires a model', 'invalid_model');
+        const toolset = new WorkspaceTools(request.cwd, request.allowedRoots, request.role);
+        const maxTurns = request.maxTurns ?? 24;
+        if (!Number.isSafeInteger(maxTurns) || maxTurns < 1)
+            throw new AgentExecutionError('maxTurns must be a positive integer', 'invalid_limit');
+        const timeoutMs = request.timeoutMs ?? 15 * 60_000;
+        if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1)
+            throw new AgentExecutionError('timeoutMs must be a positive integer', 'invalid_limit');
+        const env = this.options.env ?? process.env;
+        const key = this.provider.apiKeyEnv ? env[this.provider.apiKeyEnv] : undefined;
+        if (this.provider.apiKeyEnv && !key)
+            throw new AgentExecutionError(`Credential environment variable ${this.provider.apiKeyEnv} is not set`, 'missing_credential');
+        const endpoint = new URL(this.provider.baseUrl.replace(/\/+$/, '') + '/chat/completions');
+        if (!['http:', 'https:'].includes(endpoint.protocol) || endpoint.username || endpoint.password || endpoint.hash || endpoint.search)
+            throw new AgentExecutionError('Invalid OpenAI-compatible endpoint', 'invalid_endpoint');
+        const headers = { 'Content-Type': 'application/json' };
+        if (key)
+            headers.Authorization = `Bearer ${key}`;
+        const controller = new AbortController();
+        const abort = () => controller.abort(request.signal?.reason);
+        request.signal?.addEventListener('abort', abort, { once: true });
+        if (request.signal?.aborted)
+            abort();
+        const timer = setTimeout(() => controller.abort(new Error('Agent timeout')), timeoutMs);
+        let usage = { inputTokens: 0, outputTokens: 0, costUsd: 0 };
+        let responses = 0;
+        const messages = [
+            { role: 'system', content: `You execute one ${request.role} task. Use only the provided workspace tools. Allowed roots: ${JSON.stringify(toolset.roots)}. Working directory: ${toolset.cwd}. Return the complete requested final result. Do not coordinate another workflow or call a platform skill.` },
+            { role: 'user', content: request.prompt },
+        ];
+        try {
+            for (let turn = 0; turn < maxTurns; turn++) {
+                controller.signal.throwIfAborted();
+                const observed = (usage.inputTokens ?? 0) + (usage.outputTokens ?? 0);
+                if (request.maxTokens !== undefined && responses && (usage.inputTokens === null || usage.outputTokens === null))
+                    throw new AgentExecutionError('Provider omitted usage required by the token budget', 'usage_unavailable', usage);
+                if (request.maxTokens !== undefined && observed >= request.maxTokens)
+                    throw new AgentExecutionError('Agent token budget exhausted', 'token_budget', usage);
+                const response = await (this.options.fetch ?? globalThis.fetch)(endpoint, {
+                    method: 'POST', headers, signal: controller.signal, redirect: 'error',
+                    body: JSON.stringify({ model: request.model, messages, tools: toolset.definitions(), tool_choice: 'auto', stream: false,
+                        ...(request.maxTokens === undefined ? {} : { max_tokens: Math.max(1, Math.floor(request.maxTokens - observed)) }),
+                    }),
+                });
+                if (!response.ok) {
+                    await response.body?.cancel();
+                    throw new AgentExecutionError(`OpenAI-compatible provider returned HTTP ${response.status}`, 'provider_http_error', responses ? usage : unknownUsage());
+                }
+                const body = await readBoundedResponse(response);
+                const data = record(body), reported = record(data?.usage);
+                const current = {
+                    inputTokens: number(reported?.prompt_tokens), outputTokens: number(reported?.completion_tokens),
+                    costUsd: number(reported?.cost_usd ?? data?.cost_usd),
+                };
+                usage = { inputTokens: add(usage.inputTokens, current.inputTokens), outputTokens: add(usage.outputTokens, current.outputTokens), costUsd: add(usage.costUsd, current.costUsd) };
+                responses++;
+                request.onEvent?.({ kind: 'usage', usage: { ...usage } });
+                if (request.maxTokens !== undefined && (usage.inputTokens === null || usage.outputTokens === null))
+                    throw new AgentExecutionError('Provider omitted usage required by the token budget', 'usage_unavailable', usage);
+                if (request.maxTokens !== undefined && (usage.inputTokens ?? 0) + (usage.outputTokens ?? 0) > request.maxTokens)
+                    throw new AgentExecutionError('Agent token budget exceeded', 'token_budget', usage);
+                if (request.maxCostUsd !== undefined && usage.costUsd !== null && usage.costUsd > request.maxCostUsd)
+                    throw new AgentExecutionError('Agent cost budget exceeded', 'cost_budget', usage);
+                if (!data || data.error)
+                    throw new AgentExecutionError('Provider returned an error or invalid response', 'provider_response_error', usage);
+                const choice = Array.isArray(data.choices) ? record(data.choices[0]) : undefined;
+                const message = record(choice?.message);
+                if (!message || message.role !== 'assistant')
+                    throw new AgentExecutionError('Provider response has no assistant message', 'invalid_response', usage);
+                if (choice?.finish_reason === 'length' || choice?.finish_reason === 'content_filter')
+                    throw new AgentExecutionError('Provider did not complete the requested result', 'incomplete_response', usage);
+                const calls = message.tool_calls;
+                if (calls !== undefined && !Array.isArray(calls))
+                    throw new AgentExecutionError('Invalid tool calls in provider response', 'invalid_tool_call', usage);
+                if (Array.isArray(calls) && calls.length > 0) {
+                    if (calls.length > 32)
+                        throw new AgentExecutionError('Provider requested too many tools in one turn', 'invalid_tool_call', usage);
+                    messages.push({ role: 'assistant', content: typeof message.content === 'string' ? message.content : null, tool_calls: calls });
+                    const ids = new Set();
+                    for (const raw of calls) {
+                        controller.signal.throwIfAborted();
+                        const call = record(raw), fn = record(call?.function);
+                        if (call?.type !== 'function' || typeof call.id !== 'string' || !call.id || ids.has(call.id) || typeof fn?.name !== 'string' || typeof fn.arguments !== 'string')
+                            throw new AgentExecutionError('Malformed provider tool call', 'invalid_tool_call', usage);
+                        ids.add(call.id);
+                        request.onEvent?.({ kind: 'tool-start', tool: fn.name });
+                        let result;
+                        try {
+                            result = toolset.execute(fn.name, JSON.parse(fn.arguments));
+                        }
+                        catch (error) {
+                            result = JSON.stringify({ error: error instanceof Error ? error.message : 'Tool execution failed' });
+                        }
+                        messages.push({ role: 'tool', tool_call_id: call.id, content: result });
+                        request.onEvent?.({ kind: 'tool-end', tool: fn.name });
+                    }
+                    continue;
+                }
+                if (typeof message.content !== 'string' || !message.content.trim())
+                    throw new AgentExecutionError('Provider returned an empty final result', 'invalid_response', usage);
+                request.onEvent?.({ kind: 'text', text: message.content });
+                return { text: message.content, usage, structured: parseStructuredText(message.content) };
+            }
+            throw new AgentExecutionError(`Agent exhausted ${maxTurns} turns without a final result`, 'max_turns', usage);
+        }
+        catch (error) {
+            if (error instanceof AgentExecutionError)
+                throw error;
+            if (controller.signal.aborted)
+                throw new AgentExecutionError(request.signal?.aborted ? 'Agent cancelled' : 'Agent timed out', request.signal?.aborted ? 'aborted' : 'timeout', responses ? usage : unknownUsage());
+            // Do not persist provider response bodies, URLs or credentials echoed by errors.
+            throw new AgentExecutionError('OpenAI-compatible request failed', 'provider_request_error', responses ? usage : unknownUsage());
+        }
+        finally {
+            clearTimeout(timer);
+            request.signal?.removeEventListener('abort', abort);
+        }
+    }
+}
+async function readBoundedResponse(response) {
+    if (!response.body)
+        throw new Error('Missing response body');
+    const reader = response.body.getReader(), chunks = [];
+    let length = 0;
+    try {
+        for (;;) {
+            const part = await reader.read();
+            if (part.done)
+                break;
+            length += part.value.byteLength;
+            if (length > 2 * 1024 * 1024) {
+                await reader.cancel();
+                throw new Error('Provider response exceeds 2 MiB');
+            }
+            chunks.push(part.value);
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    return JSON.parse(Buffer.concat(chunks).toString('utf8'));
+}
+//# sourceMappingURL=openai-executor.js.map

package/dist/agent-runtime/openai-executor.js.map

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

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

@@ -0,0 +1,40 @@
+import type { AgentRole } from './executor-types.js';
+import type { PipelineContext, VerificationCommand } from '../installer/runtime/pipeline-state.js';
+import { type ReviewPolicy } from './graph/review-policy.js';
+import type { DeveloperRecord } from './graph/state.js';
+/** Bump whenever the wording changes: the version is part of the frozen run identity. */
+export declare const ROLE_INSTRUCTIONS_VERSION = "3";
+export interface RoleFeedback {
+    verification?: unknown;
+    review?: unknown;
+}
+/** One frozen acceptance criterion the reviewer must certify, identified by stable scope coordinates. */
+export interface FrozenCriterion {
+    specId: string;
+    criterionIndex: number;
+    requirement: string;
+}
+export interface RoleInstructionOptions {
+    feedback?: RoleFeedback;
+    verification?: VerificationCommand[];
+    /** Answers the requester gave to earlier architect questions, oldest first. */
+    answers?: string[];
+    /** Review gate thresholds rendered for the reviewer; defaults when omitted. */
+    policy?: ReviewPolicy;
+    /** Frozen acceptance criteria the reviewer certifies one by one. */
+    criteria?: FrozenCriterion[];
+    /** The developer's own account of the change, shown to the reviewer as a claim to verify. */
+    developer?: DeveloperRecord | null;
+}
+export declare const ARCHITECT_OUTPUT_SCHEMA: Record<string, unknown>;
+export declare const DEVELOPER_OUTPUT_SCHEMA: Record<string, unknown>;
+export declare const REVIEW_OUTPUT_SCHEMA: Record<string, unknown>;
+/** Central role instructions. Roles describe their own work only: traversal,
+ * retries, checks, approvals, archive and delivery belong to the host. */
+export declare function roleInstructions(role: AgentRole, context: PipelineContext, change: string, options?: RoleInstructionOptions): string;
+/** A short follow-up for a provider session that already holds the role instructions. */
+export declare function correctionInstructions(role: AgentRole, feedback: RoleFeedback | undefined): string;
+/** Asks the architect, still in its session, to resolve a low-confidence design by investigating instead of guessing. */
+export declare function deepenInstructions(question: string | undefined): string;
+/** Asks a structured role to resend a malformed reply without repeating its work. */
+export declare function repairInstructions(role: AgentRole, problem: string): string;