specrails-core 5.2.3 → 5.3.0

package/dist/agent-runtime/graph/roles.d.ts

@@ -0,0 +1,44 @@
+import type { PipelineContext } from '../../installer/runtime/pipeline-state.js';
+import type { ExecutorRegistry } from '../executors.js';
+import { type AgentEvent, type AgentResult, type AgentRole, type AgentUsage, type RuntimeConfig } from '../executor-types.js';
+import type { WorkflowStepContext } from '../workflow-types.js';
+/** Executor failures that mean "this session cannot be continued", not "the role failed". */
+export declare const SESSION_FALLBACK_CODES: Set<string>;
+export interface InvokeOptions {
+    prompt: string;
+    /** Parse the reply as one JSON object and hand it to `accept`. */
+    structured?: boolean;
+    /** Structured, but an unparseable reply is accepted as prose instead of repaired (`accept` gets `undefined`). */
+    lenient?: boolean;
+    outputSchema?: Record<string, unknown>;
+    resumeSessionId?: string;
+    /** Full prompt for a fresh session when the resumed session is unavailable. */
+    fallbackPrompt?: string;
+}
+export type InvokeOutcome<T> = {
+    ok: true;
+    value: T;
+    text: string;
+    result: AgentResult;
+} | {
+    ok: false;
+    error: string;
+};
+/** Validates and converts a role's reply. Throwing `Invalid|Expected|requires|Duplicate|malformed` requests one repair turn. */
+export type Accept<T> = (output: Record<string, unknown> | undefined, text: string, result: AgentResult) => T;
+export type RoleInvoker = <T>(role: AgentRole, step: WorkflowStepContext, options: InvokeOptions, accept: Accept<T>) => Promise<InvokeOutcome<T>>;
+export interface RoleInvokerDeps {
+    context: PipelineContext;
+    config: RuntimeConfig;
+    registry: ExecutorRegistry;
+    onAgentEvent?: (role: AgentRole, event: AgentEvent) => void;
+}
+export declare function sumUsage(a: AgentUsage, b: AgentUsage): AgentUsage;
+/**
+ * One role turn against the configured executor: budget-aware request, live
+ * event forwarding with repository-relative paths, structured parsing with a
+ * single in-session repair turn, and session fallback for corrections. Usage
+ * is reported to the step as soon as each provider call returns, so a later
+ * interrupt or failure never loses spend.
+ */
+export declare function createRoleInvoker(deps: RoleInvokerDeps): RoleInvoker;

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

@@ -0,0 +1,126 @@
+import path from 'node:path';
+import { AgentExecutionError } from '../executor-types.js';
+import { repairInstructions } from '../prompts.js';
+import { parseAgentObject } from './artifacts.js';
+/** Executor failures that mean "this session cannot be continued", not "the role failed". */
+export const SESSION_FALLBACK_CODES = new Set(['provider_execution_error', 'provider_spawn_error', 'incomplete_response', 'invalid_response', 'provider_not_found']);
+const REPAIRABLE = /Invalid|Expected|requires|Duplicate|malformed/i;
+export function sumUsage(a, b) {
+    const add = (x, y) => x === null || y === null ? null : x + y;
+    return { inputTokens: add(a.inputTokens, b.inputTokens), outputTokens: add(a.outputTokens, b.outputTokens), costUsd: add(a.costUsd, b.costUsd) };
+}
+/**
+ * One role turn against the configured executor: budget-aware request, live
+ * event forwarding with repository-relative paths, structured parsing with a
+ * single in-session repair turn, and session fallback for corrections. Usage
+ * is reported to the step as soon as each provider call returns, so a later
+ * interrupt or failure never loses spend.
+ */
+export function createRoleInvoker(deps) {
+    const { context, config, registry } = deps;
+    const roots = [...context.repositories.map(repo => repo.path)].sort((a, b) => b.length - a.length);
+    const relativize = (detail) => {
+        // Host logs read better with repository-relative paths; the tool call itself is unchanged.
+        for (const root of roots) {
+            if (detail === root)
+                return context.repositories.length > 1 ? path.basename(root) : '.';
+            if (detail.startsWith(root + path.sep))
+                return (context.repositories.length > 1 ? path.basename(root) + path.sep : '') + detail.slice(root.length + 1);
+        }
+        return detail;
+    };
+    const forward = (role, structured) => (event) => {
+        // The final JSON of a structured role is an artifact, not narration; the host
+        // reports what it did with it instead of echoing it into the log.
+        if (structured && event.kind === 'text' && /^\s*(\{|```)/.test(event.text ?? ''))
+            return;
+        const shaped = event.kind === 'tool-start' && event.detail ? { ...event, detail: relativize(event.detail) } : event;
+        try {
+            deps.onAgentEvent?.(role, shaped);
+        }
+        catch { /* Observer cannot replay agent effects. */ }
+    };
+    const note = (role, text) => { try {
+        deps.onAgentEvent?.(role, { kind: 'text', text });
+    }
+    catch { /* Observer cannot replay agent effects. */ } };
+    const execute = async (role, step, prompt, structured, extra) => {
+        const selected = config.agents[role];
+        const budget = step.remainingBudget();
+        try {
+            const result = await registry.execute(selected.provider, {
+                role, prompt, cwd: context.artifactRoot, allowedRoots: context.repositories.map(repo => repo.path),
+                model: selected.model, maxTurns: selected.maxTurns, signal: step.signal,
+                timeoutMs: config.limits?.timeoutMs,
+                maxTokens: budget.maxTokens, maxCostUsd: budget.maxCostUsd,
+                ...extra, onEvent: forward(role, structured),
+            });
+            step.reportUsage(result.usage);
+            return result;
+        }
+        catch (error) {
+            if (error instanceof AgentExecutionError)
+                step.reportUsage(error.usage);
+            throw error;
+        }
+    };
+    return async (role, step, options, accept) => {
+        const structured = options.structured === true;
+        try {
+            let result;
+            if (options.resumeSessionId && options.fallbackPrompt) {
+                // A correction pass continues the role's own session: the work it did and
+                // the reasons behind it are already in context.
+                try {
+                    result = await execute(role, step, options.prompt, structured, { resumeSessionId: options.resumeSessionId, outputSchema: options.outputSchema });
+                }
+                catch (error) {
+                    if (!(error instanceof AgentExecutionError) || !SESSION_FALLBACK_CODES.has(error.code))
+                        throw error;
+                    note(role, `Previous ${role} session is unavailable; starting a fresh ${role} turn with the same instructions.`);
+                    result = await execute(role, step, options.fallbackPrompt, structured, { outputSchema: options.outputSchema });
+                }
+            }
+            else {
+                result = await execute(role, step, options.prompt, structured, { resumeSessionId: options.resumeSessionId, outputSchema: options.outputSchema });
+            }
+            if (!structured)
+                return { ok: true, value: accept(undefined, result.text, result), text: result.text, result };
+            let output, problem;
+            try {
+                output = result.structured ?? parseAgentObject(result.text);
+            }
+            catch (error) {
+                problem = error instanceof Error ? error.message : String(error);
+            }
+            if (!output && options.lenient)
+                return { ok: true, value: accept(undefined, result.text, result), text: result.text, result };
+            if (output) {
+                try {
+                    return { ok: true, value: accept(output, result.text, result), text: result.text, result };
+                }
+                catch (error) {
+                    problem = error instanceof Error ? error.message : String(error);
+                    if (!REPAIRABLE.test(problem))
+                        return { ok: false, error: problem };
+                }
+            }
+            // One bounded repair turn inside the same session: the role keeps its work
+            // and only resends the object. Without a session the role starts over once.
+            if (!result.sessionId)
+                return { ok: false, error: problem ?? 'Unusable structured reply' };
+            note(role, `The ${role} reply was not a valid result (${problem}); asking the same session to resend it.`);
+            const repaired = await execute(role, step, repairInstructions(role, problem), structured, { resumeSessionId: result.sessionId, outputSchema: options.outputSchema });
+            try {
+                return { ok: true, value: accept(repaired.structured ?? parseAgentObject(repaired.text), repaired.text, repaired), text: repaired.text, result: repaired };
+            }
+            catch (error) {
+                return { ok: false, error: error instanceof Error ? error.message : String(error) };
+            }
+        }
+        catch (error) {
+            return { ok: false, error: error instanceof Error ? error.message : String(error) };
+        }
+    };
+}
+//# sourceMappingURL=roles.js.map

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

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

package/dist/agent-runtime/graph/state.d.ts

@@ -0,0 +1,75 @@
+import type { VerificationCommand } from '../../installer/runtime/pipeline-state.js';
+export type DesignConfidence = 'high' | 'medium' | 'low';
+export interface ArchitectureRecord {
+    change: string;
+    tasks: number;
+    specs: string[];
+    confidence: DesignConfidence;
+    /** The single blocking question the architect could not answer from the code. */
+    question?: string;
+    /** True when a low-confidence design proceeded on stated assumptions instead of asking. */
+    assumed?: boolean;
+}
+export interface DeveloperRecord {
+    summary: string;
+    provider: string;
+    sessionId?: string;
+    files: string[];
+    tests: string[];
+    verification?: string;
+    incomplete: Array<{
+        task: string;
+        reason: string;
+    }>;
+    /** False when the provider returned prose instead of the structured summary. */
+    structured: boolean;
+}
+export interface VerificationRecord {
+    valid: boolean;
+    reason?: string;
+    receiptId?: string;
+    incompleteTasks?: string[];
+    unverifiedRepositories: string[];
+    commands: Array<{
+        repositoryId: string;
+        command: string;
+        args: string[];
+        exitCode: number | null;
+        output: string;
+    }>;
+}
+export interface ReviewRecord {
+    approved: boolean;
+    summary: string;
+    issues: string[];
+    score: number;
+    aspects: Record<string, number>;
+    candidateHash?: string;
+}
+export interface ArchiveRecord {
+    archivePath: string;
+    deliveryOwner: string;
+}
+/**
+ * The Core implementation graph state. Every field is plain JSON so LangGraph
+ * checkpoints, the host ledger and the CLI status share one representation.
+ * Channel names never collide with node names (LangGraph forbids it).
+ */
+export declare const CoreState: import("@langchain/langgraph").AnnotationRoot<{
+    /** The frozen verification plan: configured commands plus the architect's proposals. */
+    plan: import("@langchain/langgraph").BaseChannel<VerificationCommand[], VerificationCommand[] | import("@langchain/langgraph").OverwriteValue<VerificationCommand[]>, unknown>;
+    unverifiedRepositories: import("@langchain/langgraph").BaseChannel<string[], string[] | import("@langchain/langgraph").OverwriteValue<string[]>, unknown>;
+    architecture: import("@langchain/langgraph").BaseChannel<ArchitectureRecord | null, ArchitectureRecord | import("@langchain/langgraph").OverwriteValue<ArchitectureRecord | null> | null, unknown>;
+    development: import("@langchain/langgraph").BaseChannel<DeveloperRecord | null, DeveloperRecord | import("@langchain/langgraph").OverwriteValue<DeveloperRecord | null> | null, unknown>;
+    verifyResult: import("@langchain/langgraph").BaseChannel<VerificationRecord | null, VerificationRecord | import("@langchain/langgraph").OverwriteValue<VerificationRecord | null> | null, unknown>;
+    review: import("@langchain/langgraph").BaseChannel<ReviewRecord | null, ReviewRecord | import("@langchain/langgraph").OverwriteValue<ReviewRecord | null> | null, unknown>;
+    /** Answers the requester gave to architect questions, oldest first. */
+    answers: import("@langchain/langgraph").BaseChannel<string[], string[] | import("@langchain/langgraph").OverwriteValue<string[]>, unknown>;
+    /** Autonomous investigation passes the architect already spent on a low-confidence design. */
+    deepenPasses: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
+    archived: import("@langchain/langgraph").BaseChannel<ArchiveRecord | null, ArchiveRecord | import("@langchain/langgraph").OverwriteValue<ArchiveRecord | null> | null, unknown>;
+}>;
+export type CoreStateType = typeof CoreState.State;
+export type CoreStateUpdate = typeof CoreState.Update;
+export type CoreNodeId = 'architect' | 'developer' | 'verify' | 'reviewer' | 'archive';
+export declare const CORE_NODE_ORDER: readonly CoreNodeId[];

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

@@ -0,0 +1,23 @@
+import { Annotation } from '@langchain/langgraph';
+const replace = () => ({ reducer: (_previous, next) => next });
+/**
+ * The Core implementation graph state. Every field is plain JSON so LangGraph
+ * checkpoints, the host ledger and the CLI status share one representation.
+ * Channel names never collide with node names (LangGraph forbids it).
+ */
+export const CoreState = Annotation.Root({
+    /** The frozen verification plan: configured commands plus the architect's proposals. */
+    plan: Annotation({ ...replace(), default: () => [] }),
+    unverifiedRepositories: Annotation({ ...replace(), default: () => [] }),
+    architecture: Annotation({ ...replace(), default: () => null }),
+    development: Annotation({ ...replace(), default: () => null }),
+    verifyResult: Annotation({ ...replace(), default: () => null }),
+    review: Annotation({ ...replace(), default: () => null }),
+    /** Answers the requester gave to architect questions, oldest first. */
+    answers: Annotation({ reducer: (previous, next) => [...previous, ...next], default: () => [] }),
+    /** Autonomous investigation passes the architect already spent on a low-confidence design. */
+    deepenPasses: Annotation({ ...replace(), default: () => 0 }),
+    archived: Annotation({ ...replace(), default: () => null }),
+});
+export const CORE_NODE_ORDER = ['architect', 'developer', 'verify', 'reviewer', 'archive'];
+//# sourceMappingURL=state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/agent-runtime/graph/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AA2CjD,MAAM,OAAO,GAAG,GAAM,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,SAAY,EAAE,IAAO,EAAK,EAAE,CAAC,IAAI,EAAE,CAAC,CAAA;AAE1E;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC;IACvC,wFAAwF;IACxF,IAAI,EAAE,UAAU,CAAwB,EAAE,GAAG,OAAO,EAAyB,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IACnG,sBAAsB,EAAE,UAAU,CAAW,EAAE,GAAG,OAAO,EAAY,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IAC3F,YAAY,EAAE,UAAU,CAA4B,EAAE,GAAG,OAAO,EAA6B,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IACrH,WAAW,EAAE,UAAU,CAAyB,EAAE,GAAG,OAAO,EAA0B,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IAC9G,YAAY,EAAE,UAAU,CAA4B,EAAE,GAAG,OAAO,EAA6B,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IACrH,MAAM,EAAE,UAAU,CAAsB,EAAE,GAAG,OAAO,EAAuB,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;IACnG,uEAAuE;IACvE,OAAO,EAAE,UAAU,CAAW,EAAE,OAAO,EAAE,CAAC,QAAkB,EAAE,IAAc,EAAY,EAAE,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;IACvI,8FAA8F;IAC9F,YAAY,EAAE,UAAU,CAAS,EAAE,GAAG,OAAO,EAAU,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;IAC5E,QAAQ,EAAE,UAAU,CAAuB,EAAE,GAAG,OAAO,EAAwB,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC;CACxG,CAAC,CAAA;AAIF,MAAM,CAAC,MAAM,eAAe,GAA0B,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAA"}

package/dist/agent-runtime/graph-checkpointer.d.ts

@@ -0,0 +1,61 @@
+import { BaseCheckpointSaver, type ChannelVersions, type Checkpoint, type CheckpointListOptions, type CheckpointMetadata, type CheckpointTuple, type PendingWrite } from '@langchain/langgraph-checkpoint';
+import type { RunnableConfig } from '@langchain/core/runnables';
+/** One serialized LangGraph value: the serializer's type tag plus base64 bytes. */
+export interface SerializedBlob {
+    type: string;
+    data: string;
+}
+export interface SerializedCheckpointEntry {
+    threadId: string;
+    ns: string;
+    id: string;
+    parentId?: string;
+    checkpoint: SerializedBlob;
+    metadata: SerializedBlob;
+}
+export interface SerializedWriteEntry {
+    threadId: string;
+    ns: string;
+    checkpointId: string;
+    taskId: string;
+    idx: number;
+    channel: string;
+    value: SerializedBlob;
+}
+/** The complete LangGraph checkpoint history of one run, as stored inside the run envelope. */
+export interface SerializedGraphStore {
+    format: 1;
+    checkpoints: SerializedCheckpointEntry[];
+    writes: SerializedWriteEntry[];
+}
+export interface GraphStoreIO {
+    /** The store persisted with the run, or undefined for a new run. */
+    load(): SerializedGraphStore | undefined;
+    /** Persist the complete store. The engine writes it atomically with the ledger. */
+    save(store: SerializedGraphStore): Promise<void>;
+}
+/**
+ * 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 declare class FileCheckpointSaver extends BaseCheckpointSaver {
+    private readonly io;
+    private readonly checkpoints;
+    private readonly writes;
+    constructor(io: GraphStoreIO);
+    /** A JSON snapshot of the complete store. */
+    serialize(): SerializedGraphStore;
+    private dump;
+    private load;
+    private persist;
+    private tuple;
+    private entries;
+    getTuple(config: RunnableConfig): Promise<CheckpointTuple | undefined>;
+    list(config: RunnableConfig, options?: CheckpointListOptions): AsyncGenerator<CheckpointTuple>;
+    put(config: RunnableConfig, checkpoint: Checkpoint, metadata: CheckpointMetadata, _newVersions: ChannelVersions): Promise<RunnableConfig>;
+    putWrites(config: RunnableConfig, writes: PendingWrite[], taskId: string): Promise<void>;
+    deleteThread(threadId: string): Promise<void>;
+}

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,14 @@
+/** 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 './config.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, correctionInstructions, deepenInstructions, repairInstructions, roleInstructions, type FrozenCriterion, type RoleFeedback, type RoleInstructionOptions, } from './prompts.js';

package/dist/agent-runtime/index.js

@@ -0,0 +1,15 @@
+/** 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 './config.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, correctionInstructions, deepenInstructions, repairInstructions, roleInstructions, } from './prompts.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,aAAa,CAAA;AAC3B,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,sBAAsB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,gBAAgB,GACjF,MAAM,cAAc,CAAA"}

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

@@ -0,0 +1,7 @@
+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;
+}): Promise<AgentResult>;