specrails-core 5.2.3 → 5.4.0

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

@@ -0,0 +1,192 @@
+import { readVerificationEvidence } from '../installer/runtime/pipeline-state.js';
+import { toolEvent } from './tool-event.js';
+import { assertEffortSupported, unknownCapabilities } from './capabilities.js';
+import { OpenSpecTools, OPENSPEC_TOOL_DEFINITION, openSpecPrompt } from './openspec.js';
+import { AgentExecutionError, unknownUsage, validateAgentRequest } from './executor-types.js';
+import { sumCacheUsage } from './efficiency-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;
+    }
+    capabilities() { return { ...unknownCapabilities('openai-compatible'), continuation: 'unsupported', effortSupport: 'unsupported', supportedEfforts: [] }; }
+    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);
+        assertEffortSupported(request, this.capabilities());
+        this.validateLimits(request);
+        if (!request.model?.trim())
+            throw new AgentExecutionError('OpenAI-compatible execution requires a model', 'invalid_model');
+        const controller = new AbortController();
+        const toolset = new WorkspaceTools(request.cwd, request.allowedRoots, request.role);
+        const openspec = request.openspec ? new OpenSpecTools(request.openspec, controller.signal) : undefined;
+        const definitions = [...toolset.definitions(), ...(openspec ? [OPENSPEC_TOOL_DEFINITION] : []), ...(request.openspec?.evidenceScope && request.role !== 'architect' ? [{ type: 'function', function: { name: 'read_verification_evidence', description: 'Read host verification evidence and source files with opaque IDs and bounded cursors. List to discover IDs.', parameters: { type: 'object', additionalProperties: false, properties: { id: { type: 'string' }, section: { type: 'string', enum: ['summary', 'stdout', 'stderr', 'source'] }, sourceId: { type: 'string' }, cursor: { type: 'string' }, limit: { type: 'integer', minimum: 1, maximum: 100 } } } } }] : [])];
+        const maxTurns = request.maxTurns ?? 100;
+        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 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. Execute only the assigned role and its supplied OpenSpec workflow.` },
+            { role: 'user', content: (request.openspec ? openSpecPrompt(request.openspec) : '') + 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: 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 cached = number(record(reported?.prompt_tokens_details)?.cached_tokens);
+                const inputTokens = number(reported?.prompt_tokens);
+                const cache = record(reported?.prompt_tokens_details)?.cached_tokens === undefined ? {} : {
+                    cacheReadInputTokens: cached !== null && inputTokens !== null && cached <= inputTokens ? cached : null,
+                    uncachedInputTokens: cached !== null && inputTokens !== null && cached <= inputTokens ? inputTokens - cached : null,
+                    cacheWriteInputTokens: null,
+                };
+                const current = {
+                    inputTokens: number(reported?.prompt_tokens), outputTokens: number(reported?.completion_tokens),
+                    costUsd: number(reported?.cost_usd ?? data?.cost_usd), ...cache,
+                };
+                usage = { inputTokens: add(usage.inputTokens, current.inputTokens), outputTokens: add(usage.outputTokens, current.outputTokens), costUsd: add(usage.costUsd, current.costUsd), ...(responses === 0 ? cache : sumCacheUsage([usage, current])) };
+                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?.(toolEvent(fn.name, fn.arguments));
+                        let result;
+                        try {
+                            result = fn.name === 'read_verification_evidence' && request.openspec?.evidenceScope && request.role !== 'architect' ? JSON.stringify(readVerificationEvidence(request.openspec.evidenceScope, JSON.parse(fn.arguments))) : fn.name === 'openspec_workflow' && openspec ? JSON.stringify(await openspec.execute(JSON.parse(fn.arguments))) : 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.
+            const code = error.cause?.code;
+            const diagnostic = typeof code === 'string' && /^(?:E[A-Z_]+|UND_ERR_[A-Z_]+)$/.test(code) ? ` (${code})` : '';
+            throw new AgentExecutionError('OpenAI-compatible request failed' + diagnostic, '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/openspec-tool-server.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/agent-runtime/openspec-tool-server.js

@@ -0,0 +1,37 @@
+import { readVerificationEvidence } from '../installer/runtime/pipeline-state.js';
+import { readFileSync } from 'node:fs';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { OpenSpecTools } from './openspec.js';
+const configPath = process.argv[2];
+if (!configPath)
+    throw new Error('Missing role OpenSpec context');
+const context = JSON.parse(readFileSync(configPath, 'utf8'));
+const server = new McpServer({ name: 'specrails-openspec', version: '1' });
+server.registerTool('workflow', {
+    description: 'Execute the official OpenSpec skill and CLI operations for the current change. Load the role skill first; for developer/reviewer this also executes and returns real status and instructions apply. Read the returned context files and finish the skill. Use instructions before authoring artifacts. Change identity and write scope are fixed by the host.',
+    inputSchema: { action: z.enum(['load_skill', 'new', 'status', 'instructions', 'validate', 'write_artifact']), artifact: z.string().optional(), path: z.string().optional(), content: z.string().optional() },
+}, async (args, extra) => {
+    const tools = new OpenSpecTools(context, extra.signal);
+    try {
+        return { content: [{ type: 'text', text: JSON.stringify(await tools.execute(args)) }] };
+    }
+    catch (error) {
+        return { isError: true, content: [{ type: 'text', text: error instanceof Error ? error.message : String(error) }] };
+    }
+});
+if (context.evidenceScope && context.role !== 'architect')
+    server.registerTool('read_verification_evidence', {
+        description: 'Read persisted host verification results and harness sources. List first to discover opaque IDs; use returned cursors to page output. Read-only, bounded and scoped to this run.',
+        inputSchema: { id: z.string().optional(), section: z.enum(['summary', 'stdout', 'stderr', 'source']).optional(), sourceId: z.string().optional(), cursor: z.string().optional(), limit: z.number().int().min(1).max(100).optional() },
+    }, async (args) => {
+        try {
+            return { content: [{ type: 'text', text: JSON.stringify(readVerificationEvidence(context.evidenceScope, args)) }] };
+        }
+        catch (error) {
+            return { isError: true, content: [{ type: 'text', text: error instanceof Error ? error.message : String(error) }] };
+        }
+    });
+await server.connect(new StdioServerTransport());
+//# sourceMappingURL=openspec-tool-server.js.map

package/dist/agent-runtime/openspec-tool-server.js.map

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

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

@@ -0,0 +1,123 @@
+import type { AgentRole, CliProvider } from './executor-types.js';
+export declare const OPENSPEC_VERSION = "1.4.1";
+export declare const ROLE_SKILLS: {
+    readonly architect: "openspec-ff-change";
+    readonly developer: "openspec-apply-change";
+    readonly reviewer: "openspec-verify-change";
+};
+export interface OpenSpecRoleContext {
+    evidenceScope?: {
+        backlogRoot: string;
+        runId: string;
+    };
+    root: string;
+    change: string;
+    stateDirectory: string;
+    cli: string;
+    skillPath: string;
+    skillHash: string;
+    role: AgentRole;
+}
+export interface OpenSpecStatus {
+    changeRoot: string;
+    schemaName: string;
+    isComplete: boolean;
+    applyRequires: string[];
+    actionContext?: {
+        allowedEditRoots?: string[];
+        mode?: string;
+    };
+    artifacts: {
+        id: string;
+        status: string;
+    }[];
+    artifactPaths: Record<string, {
+        existingOutputPaths: string[];
+        resolvedOutputPath: string;
+    }>;
+}
+export interface OpenSpecApply {
+    state: 'blocked' | 'ready' | 'all_done';
+    contextFiles: Record<string, string | string[]>;
+    tasks: {
+        id: string;
+        description: string;
+        done: boolean;
+    }[];
+    progress: {
+        total: number;
+        complete: number;
+        remaining: number;
+    };
+}
+export declare function hash(text: string): string;
+export declare function resolveOpenSpecCli(): string;
+export declare function runOpenSpec(cli: string, root: string, args: string[], signal?: AbortSignal): Promise<string>;
+/** Reject symlink traversal even when the final destination does not exist. */
+export declare function artifactPath(root: string, relative: string): string;
+/** CLI-generated skills, never reimplemented templates. No user/global config writes. */
+export declare function prepareOpenSpec(root: string, change: string, directory: string): {
+    cli: string;
+    skillRoot: string;
+    identity: Record<string, string>;
+};
+export declare function roleOpenSpecContext(prepared: ReturnType<typeof prepareOpenSpec>, root: string, change: string, directory: string, role: AgentRole, provider: CliProvider): OpenSpecRoleContext;
+/** OpenSpec uses cwd paths; Windows may report a different case or short-name
+ * spelling than realpathSync. Compare existing filesystem identities, not text. */
+export declare function sameOpenSpecDirectory(candidate: unknown, expected: string): boolean;
+export declare class OpenSpecTools {
+    readonly context: OpenSpecRoleContext;
+    private readonly signal?;
+    constructor(context: OpenSpecRoleContext, signal?: AbortSignal | undefined);
+    private call;
+    status(): Promise<OpenSpecStatus>;
+    apply(): Promise<OpenSpecApply>;
+    validate(): Promise<unknown>;
+    execute(input: {
+        action: string;
+        artifact?: string;
+        path?: string;
+        content?: string;
+    }): Promise<unknown>;
+    private participationEvents;
+    participationCursor(): number;
+    assertParticipation(after?: number): void;
+    assertReady(): Promise<OpenSpecApply>;
+}
+export declare const OPENSPEC_BRIDGE_ENTRY: string;
+export declare const OPENSPEC_TOOL_DEFINITION: {
+    type: string;
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            additionalProperties: boolean;
+            required: string[];
+            properties: {
+                action: {
+                    type: string;
+                    enum: string[];
+                };
+                artifact: {
+                    type: string;
+                };
+                path: {
+                    type: string;
+                };
+                content: {
+                    type: string;
+                };
+            };
+        };
+    };
+};
+export declare function openSpecPrompt(context: OpenSpecRoleContext): string;
+export declare function writeOpenSpecBridge(context: OpenSpecRoleContext, directory: string): {
+    command: string;
+    args: string[];
+};
+/** A repairable protocol omission, distinct from invalid artifacts or failed verification. */
+export declare class OpenSpecParticipationError extends Error {
+}
+export declare function openSpecRepairPrompt(context: OpenSpecRoleContext): string;