@nifrajs/coding-agent 3.2.0

package/dist/native.d.ts

@@ -0,0 +1,92 @@
+import { type ModelGateway, type ModelRoutePolicy } from "@nifrajs/agent";
+import { type AgentBackend, type AgentBackendInfo, type AgentEvent, type AgentSessionSnapshot, type CreateSessionInput, type ReloadResult, type SendMessageInput } from "@nifrajs/agent-protocol";
+export interface NativeMessage {
+    readonly role: "user" | "assistant" | "tool";
+    readonly text: string;
+    readonly name?: string;
+}
+export interface NativeTool {
+    readonly name: string;
+    readonly description: string;
+    readonly capabilities?: readonly string[];
+    readonly requiresApproval?: boolean | ((input: unknown) => boolean | PromiseLike<boolean>);
+    readonly execute: (input: unknown, context: {
+        readonly cwd: string;
+        readonly signal: AbortSignal;
+    }) => unknown | PromiseLike<unknown>;
+}
+export interface NativeModelRequest {
+    readonly sessionId: string;
+    readonly cwd: string;
+    readonly messages: readonly NativeMessage[];
+    readonly tools: readonly Pick<NativeTool, "name" | "description" | "capabilities">[];
+    readonly signal: AbortSignal;
+}
+export type NativeModelResponse = {
+    readonly type: "text";
+    readonly text: string;
+} | {
+    readonly type: "tool";
+    readonly name: string;
+    readonly input: unknown;
+};
+export type NativeModelChunk = {
+    readonly type: "text_delta";
+    readonly text: string;
+} | {
+    readonly type: "response";
+    readonly response: NativeModelResponse;
+};
+export interface NativeModelPort {
+    complete(request: NativeModelRequest): NativeModelResponse | PromiseLike<NativeModelResponse> | AsyncIterable<NativeModelChunk>;
+}
+export interface NativeGatewayModelPortOptions {
+    readonly gateway: ModelGateway;
+    readonly policy: ModelRoutePolicy;
+    readonly routeId?: string;
+}
+/** Adapt the provider-neutral gateway to the native backend without making it the default path. */
+export declare function createNativeGatewayModelPort(options: NativeGatewayModelPortOptions): NativeModelPort;
+export interface NativeApprovalPort {
+    request(input: {
+        readonly sessionId: string;
+        readonly tool: NativeTool;
+        readonly input: unknown;
+        readonly signal: AbortSignal;
+    }): boolean | PromiseLike<boolean>;
+}
+export interface NifraBackendOptions {
+    readonly model: NativeModelPort;
+    readonly tools?: readonly NativeTool[];
+    readonly approval?: NativeApprovalPort;
+    readonly maxSteps?: number;
+    readonly maxMessageChars?: number;
+    readonly now?: () => number;
+}
+/**
+ * Small provider port for a future Nifra-native backend.
+ *
+ * It deliberately knows only messages, tools, and the protocol. Provider SDKs, credentials, UI,
+ * and framework packages stay outside this module. A model may return one response or stream
+ * deltas followed by a final response.
+ */
+export declare class NifraBackend implements AgentBackend {
+    readonly info: AgentBackendInfo;
+    private readonly options;
+    private readonly sessions;
+    constructor(options: NifraBackendOptions);
+    createSession(input: CreateSessionInput): Promise<AgentSessionSnapshot>;
+    send(input: SendMessageInput): AsyncIterable<AgentEvent>;
+    cancel(sessionId: string, reason?: string): Promise<void>;
+    snapshot(sessionId: string): Promise<AgentSessionSnapshot>;
+    reload(sessionId: string): Promise<ReloadResult>;
+    close(sessionId: string): Promise<void>;
+    private run;
+    private consumeModel;
+    private finish;
+    private emit;
+    private update;
+    private requireSession;
+    private now;
+}
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

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

package/dist/native.js

@@ -0,0 +1,339 @@
+import { runModelGateway, structuredOutputParser, } from "@nifrajs/agent";
+import { agentError, createAgentEventStream, } from "@nifrajs/agent-protocol";
+/** Adapt the provider-neutral gateway to the native backend without making it the default path. */
+export function createNativeGatewayModelPort(options) {
+    const parser = structuredOutputParser((value) => parseNativeModelResponse(value));
+    return {
+        complete(request) {
+            return runModelGateway(options.gateway, {
+                input: request,
+                ...(options.routeId === undefined ? {} : { routeId: options.routeId }),
+                parser,
+                signal: request.signal,
+            }, options.policy).then((result) => {
+                if (!result.ok)
+                    throw new Error(`native gateway failed: ${result.error.code}`);
+                return result.output;
+            });
+        },
+    };
+}
+function parseNativeModelResponse(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        throw new TypeError("native model response is invalid");
+    const record = value;
+    if (record.type === "text" && typeof record.text === "string")
+        return Object.freeze({ type: "text", text: record.text });
+    if (record.type === "tool" && typeof record.name === "string" && Object.hasOwn(record, "input"))
+        return Object.freeze({ type: "tool", name: record.name, input: record.input });
+    throw new TypeError("native model response is invalid");
+}
+/**
+ * Small provider port for a future Nifra-native backend.
+ *
+ * It deliberately knows only messages, tools, and the protocol. Provider SDKs, credentials, UI,
+ * and framework packages stay outside this module. A model may return one response or stream
+ * deltas followed by a final response.
+ */
+export class NifraBackend {
+    info = Object.freeze({
+        name: "nifra",
+        capabilities: Object.freeze(["sessions", "extensions", "reload", "approvals", "streaming"]),
+    });
+    options;
+    sessions = new Map();
+    constructor(options) {
+        this.options = Object.freeze({
+            ...options,
+            maxSteps: options.maxSteps ?? 32,
+            maxMessageChars: options.maxMessageChars ?? 64 * 1024,
+            tools: Object.freeze([...(options.tools ?? [])]),
+        });
+        if (!Number.isSafeInteger(this.options.maxSteps) ||
+            this.options.maxSteps < 1 ||
+            this.options.maxSteps > 512)
+            throw new RangeError("nifra backend: maxSteps must be between 1 and 512");
+        if (!Number.isSafeInteger(this.options.maxMessageChars) || this.options.maxMessageChars < 256)
+            throw new RangeError("nifra backend: maxMessageChars must be at least 256");
+    }
+    async createSession(input) {
+        const id = input.sessionId ?? crypto.randomUUID();
+        if (!/^[a-zA-Z0-9._:-]{1,128}$/.test(id))
+            throw new TypeError("nifra backend: sessionId must be a bounded token");
+        if (this.sessions.has(id))
+            throw new Error(`nifra backend: session already exists: ${id}`);
+        const now = this.now();
+        const snapshot = {
+            version: 1,
+            id,
+            backend: this.info.name,
+            cwd: input.cwd,
+            status: "idle",
+            createdAt: now,
+            updatedAt: now,
+            lastSeq: 0,
+            capabilities: Object.freeze([...(input.capabilities ?? this.info.capabilities)]),
+        };
+        const session = {
+            id,
+            cwd: input.cwd,
+            messages: [],
+            controller: new AbortController(),
+            snapshot,
+            active: undefined,
+            seq: 0,
+            extensionRevision: 0,
+            closed: false,
+        };
+        this.sessions.set(id, session);
+        return snapshot;
+    }
+    send(input) {
+        const session = this.requireSession(input.sessionId);
+        if (session.closed)
+            return failedStream(agentError("SESSION_CLOSED", "Nifra session is closed"));
+        if (session.active !== undefined)
+            return failedStream(agentError("SESSION_BUSY", "Nifra session is busy"));
+        if (input.message.length === 0 || input.message.length > this.options.maxMessageChars)
+            return failedStream(agentError("MESSAGE_BOUNDED", "message is empty or exceeds the configured limit"));
+        const stream = createAgentEventStream();
+        session.active = stream;
+        session.controller = new AbortController();
+        const signal = session.controller.signal;
+        if (input.signal !== undefined) {
+            const externalSignal = input.signal;
+            if (externalSignal.aborted)
+                session.controller.abort(externalSignal.reason);
+            else
+                externalSignal.addEventListener("abort", () => session.controller.abort(externalSignal.reason), { once: true });
+        }
+        void this.run(session, input.message, stream, signal);
+        return stream;
+    }
+    async cancel(sessionId, reason = "cancelled") {
+        const session = this.requireSession(sessionId);
+        if (session.closed)
+            return;
+        const stream = session.active;
+        session.controller.abort(reason);
+        this.update(session, "stopped");
+        this.emit(session, { type: "session.stopped", reason });
+        stream?.complete();
+        session.active = undefined;
+    }
+    async snapshot(sessionId) {
+        return this.requireSession(sessionId).snapshot;
+    }
+    async reload(sessionId) {
+        const session = this.requireSession(sessionId);
+        if (session.active !== undefined)
+            return {
+                revision: session.snapshot.extensionRevision ?? "unchanged",
+                loaded: [],
+                disabled: [],
+                rolledBack: false,
+                error: agentError("SESSION_BUSY", "Nifra session is busy"),
+            };
+        session.extensionRevision += 1;
+        const revision = `nifra:${session.extensionRevision}`;
+        session.snapshot = Object.freeze({
+            ...session.snapshot,
+            extensionRevision: revision,
+            updatedAt: this.now(),
+        });
+        return { revision, loaded: [], disabled: [], rolledBack: false };
+    }
+    async close(sessionId) {
+        const session = this.requireSession(sessionId);
+        if (session.closed)
+            return;
+        session.closed = true;
+        session.controller.abort("closed");
+        session.active?.complete();
+        session.active = undefined;
+        this.sessions.delete(sessionId);
+    }
+    async run(session, message, stream, signal) {
+        const turnId = crypto.randomUUID();
+        this.update(session, "running", turnId);
+        this.emit(session, { type: "turn.started", turnId, prompt: message });
+        session.messages.push({ role: "user", text: message });
+        try {
+            for (let step = 0; step < this.options.maxSteps; step++) {
+                if (signal.aborted)
+                    throw new Error("native turn cancelled");
+                const raw = this.options.model.complete({
+                    sessionId: session.id,
+                    cwd: session.cwd,
+                    messages: Object.freeze(session.messages.map((item) => Object.freeze({ ...item }))),
+                    tools: Object.freeze(this.options.tools.map((tool) => ({
+                        name: tool.name,
+                        description: tool.description,
+                        ...(tool.capabilities === undefined ? {} : { capabilities: tool.capabilities }),
+                    }))),
+                    signal,
+                });
+                const response = await this.consumeModel(raw, session, turnId, signal);
+                if (response.type === "text") {
+                    session.messages.push({ role: "assistant", text: response.text });
+                    this.emit(session, { type: "assistant.message", turnId, text: response.text });
+                    this.finish(session, stream);
+                    return;
+                }
+                const tool = this.options.tools.find((candidate) => candidate.name === response.name);
+                if (tool === undefined) {
+                    this.emit(session, {
+                        type: "tool.completed",
+                        turnId,
+                        callId: crypto.randomUUID(),
+                        name: response.name,
+                        ok: false,
+                        error: agentError("UNKNOWN_TOOL", `unknown native tool: ${response.name}`),
+                    });
+                    session.messages.push({ role: "tool", name: response.name, text: "unknown tool" });
+                    continue;
+                }
+                const callId = crypto.randomUUID();
+                this.emit(session, {
+                    type: "tool.started",
+                    turnId,
+                    callId,
+                    name: tool.name,
+                    input: response.input,
+                });
+                const needsApproval = typeof tool.requiresApproval === "function"
+                    ? await tool.requiresApproval(response.input)
+                    : tool.requiresApproval === true;
+                if (needsApproval) {
+                    if (this.options.approval === undefined ||
+                        !(await this.options.approval.request({
+                            sessionId: session.id,
+                            tool,
+                            input: response.input,
+                            signal,
+                        }))) {
+                        this.emit(session, {
+                            type: "tool.completed",
+                            turnId,
+                            callId,
+                            name: tool.name,
+                            ok: false,
+                            error: agentError("APPROVAL_DENIED", `approval denied for ${tool.name}`),
+                        });
+                        session.messages.push({ role: "tool", name: tool.name, text: "approval denied" });
+                        continue;
+                    }
+                }
+                try {
+                    const output = await tool.execute(response.input, { cwd: session.cwd, signal });
+                    const text = boundedText(output);
+                    session.messages.push({ role: "tool", name: tool.name, text });
+                    this.emit(session, {
+                        type: "tool.completed",
+                        turnId,
+                        callId,
+                        name: tool.name,
+                        ok: true,
+                        output: text,
+                    });
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    session.messages.push({ role: "tool", name: tool.name, text: message });
+                    this.emit(session, {
+                        type: "tool.completed",
+                        turnId,
+                        callId,
+                        name: tool.name,
+                        ok: false,
+                        error: agentError("TOOL_FAILED", message),
+                    });
+                }
+            }
+            throw new Error("native turn exceeded maxSteps");
+        }
+        catch (error) {
+            if (session.closed)
+                return;
+            this.update(session, signal.aborted ? "stopped" : "failed");
+            this.emit(session, {
+                type: "session.failed",
+                error: agentError(signal.aborted ? "TURN_CANCELLED" : "NATIVE_TURN_FAILED", error instanceof Error ? error.message : String(error)),
+                recoverable: true,
+            });
+            stream.complete();
+            session.active = undefined;
+        }
+    }
+    async consumeModel(raw, session, turnId, signal) {
+        if (isAsyncIterable(raw)) {
+            let response;
+            for await (const chunk of raw) {
+                if (signal.aborted)
+                    throw new Error("native turn cancelled");
+                if (chunk.type === "text_delta")
+                    this.emit(session, { type: "assistant.delta", turnId, text: chunk.text });
+                else
+                    response = chunk.response;
+            }
+            if (response === undefined)
+                throw new Error("native model stream ended without a response");
+            return response;
+        }
+        return await raw;
+    }
+    finish(session, stream) {
+        this.update(session, "idle");
+        this.emit(session, { type: "session.completed", snapshot: session.snapshot });
+        stream.complete();
+        session.active = undefined;
+    }
+    emit(session, payload) {
+        const event = Object.freeze({
+            version: 1,
+            sessionId: session.id,
+            seq: session.seq++,
+            at: this.now(),
+            ...payload,
+        });
+        session.snapshot = Object.freeze({
+            ...session.snapshot,
+            lastSeq: event.seq,
+            updatedAt: event.at,
+        });
+        session.active?.push(event);
+    }
+    update(session, status, turnId) {
+        const next = { ...session.snapshot, status, updatedAt: this.now(), lastSeq: session.seq };
+        session.snapshot = Object.freeze(status === "running" && turnId !== undefined ? { ...next, activeTurnId: turnId } : next);
+        if (session.active !== undefined)
+            this.emit(session, { type: "session.updated", snapshot: session.snapshot });
+    }
+    requireSession(id) {
+        const session = this.sessions.get(id);
+        if (session === undefined)
+            throw new Error(`nifra backend: unknown session: ${id}`);
+        return session;
+    }
+    now() {
+        return this.options.now?.() ?? Date.now();
+    }
+}
+function isAsyncIterable(value) {
+    return value !== null && typeof value === "object" && Symbol.asyncIterator in value;
+}
+function boundedText(value) {
+    try {
+        const text = typeof value === "string" ? value : JSON.stringify(value);
+        return text.length > 64 * 1024 ? `${text.slice(0, 64 * 1024)}…[truncated]` : text;
+    }
+    catch {
+        return "[unserializable tool output]";
+    }
+}
+function failedStream(error) {
+    const stream = createAgentEventStream();
+    stream.fail(error);
+    return stream;
+}
+//# sourceMappingURL=native.js.map

package/dist/native.js.map

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

package/dist/orchestration/artifact-port.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Reference {@link ArtifactPort} implementations - the only artifact sinks the public repo ships.
+ *
+ * Neither persists durably: {@link noopArtifactPort} hashes and discards; {@link memoryArtifactPort}
+ * keeps bytes in a bounded process-local map for tests only and refuses a large budget. A durable,
+ * tenant-aware, or encrypted store is caller-owned and never lives here - the absence of a
+ * persisting sink in the public package IS the privacy guardrail.
+ */
+import type { ArtifactPort } from "@nifrajs/agent-protocol";
+/**
+ * Hashes the payload for a content-free {@link ArtifactRef}, then discards the bytes. The default
+ * port: public code sees only the digest, size, and coordinates - never the payload.
+ */
+export declare function noopArtifactPort(): ArtifactPort;
+/** A memory port that additionally exposes stored bytes for assertions. Test-only. */
+export interface MemoryArtifactPort extends ArtifactPort {
+    /** Return the retained bytes for an id, or undefined. Test assertions only. */
+    get(id: string): Uint8Array | undefined;
+    /** Number of retained payloads. */
+    readonly count: number;
+}
+/**
+ * A disposable in-memory port for tests. Retains payloads up to a small byte budget and throws past
+ * it, refusing any load that resembles durable use. NEVER use outside tests - it has no persistence,
+ * no tenancy, and no eviction beyond the hard cap.
+ */
+export declare function memoryArtifactPort(options?: {
+    readonly maxBytes?: number;
+}): MemoryArtifactPort;
+//# sourceMappingURL=artifact-port.d.ts.map

package/dist/orchestration/artifact-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-port.d.ts","sourceRoot":"","sources":["../../src/orchestration/artifact-port.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAmB,YAAY,EAAe,MAAM,yBAAyB,CAAA;AAOzF;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,YAAY,CAY/C;AAED,sFAAsF;AACtF,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,+EAA+E;IAC/E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAA;IACvC,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE;IAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3C,kBAAkB,CAyBpB"}

package/dist/orchestration/artifact-port.js

@@ -0,0 +1,59 @@
+/**
+ * Reference {@link ArtifactPort} implementations - the only artifact sinks the public repo ships.
+ *
+ * Neither persists durably: {@link noopArtifactPort} hashes and discards; {@link memoryArtifactPort}
+ * keeps bytes in a bounded process-local map for tests only and refuses a large budget. A durable,
+ * tenant-aware, or encrypted store is caller-owned and never lives here - the absence of a
+ * persisting sink in the public package IS the privacy guardrail.
+ */
+import { sha256Hex } from "./hash.js";
+function refId(digest, ctx) {
+    return `${ctx.nodeId}:${ctx.kind}:${digest.slice(0, 16)}`;
+}
+/**
+ * Hashes the payload for a content-free {@link ArtifactRef}, then discards the bytes. The default
+ * port: public code sees only the digest, size, and coordinates - never the payload.
+ */
+export function noopArtifactPort() {
+    return {
+        async put(payload, ctx) {
+            const digest = await sha256Hex(payload);
+            return {
+                id: refId(digest, ctx),
+                digest,
+                bytes: payload.length,
+                mediaType: "application/octet-stream",
+            };
+        },
+    };
+}
+/**
+ * A disposable in-memory port for tests. Retains payloads up to a small byte budget and throws past
+ * it, refusing any load that resembles durable use. NEVER use outside tests - it has no persistence,
+ * no tenancy, and no eviction beyond the hard cap.
+ */
+export function memoryArtifactPort(options = {}) {
+    const maxBytes = options.maxBytes ?? 1_048_576;
+    if (!Number.isSafeInteger(maxBytes) || maxBytes < 1)
+        throw new RangeError("memoryArtifactPort: maxBytes must be a positive integer");
+    const store = new Map();
+    let total = 0;
+    return {
+        get count() {
+            return store.size;
+        },
+        get(id) {
+            return store.get(id);
+        },
+        async put(payload, ctx) {
+            total += payload.length;
+            if (total > maxBytes)
+                throw new Error("memoryArtifactPort: byte budget exceeded - this port is test-only and never for durable use");
+            const digest = await sha256Hex(payload);
+            const id = refId(digest, ctx);
+            store.set(id, payload.slice());
+            return { id, digest, bytes: payload.length, mediaType: "application/octet-stream" };
+        },
+    };
+}
+//# sourceMappingURL=artifact-port.js.map

package/dist/orchestration/artifact-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-port.js","sourceRoot":"","sources":["../../src/orchestration/artifact-port.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAErC,SAAS,KAAK,CAAC,MAAc,EAAE,GAAoB;IACjD,OAAO,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAA;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,OAAmB,EAAE,GAAoB;YACjD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAA;YACvC,OAAO;gBACL,EAAE,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC;gBACtB,MAAM;gBACN,KAAK,EAAE,OAAO,CAAC,MAAM;gBACrB,SAAS,EAAE,0BAA0B;aACtC,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC;AAUD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAA0C,EAAE;IAE5C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAA;IAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC;QACjD,MAAM,IAAI,UAAU,CAAC,yDAAyD,CAAC,CAAA;IACjF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAA;IAC3C,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,OAAO;QACL,IAAI,KAAK;YACP,OAAO,KAAK,CAAC,IAAI,CAAA;QACnB,CAAC;QACD,GAAG,CAAC,EAAU;YACZ,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACtB,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,OAAmB,EAAE,GAAoB;YACjD,KAAK,IAAI,OAAO,CAAC,MAAM,CAAA;YACvB,IAAI,KAAK,GAAG,QAAQ;gBAClB,MAAM,IAAI,KAAK,CACb,6FAA6F,CAC9F,CAAA;YACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAA;YACvC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;YAC7B,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;YAC9B,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,0BAA0B,EAAE,CAAA;QACrF,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/orchestration/catalog.d.ts

@@ -0,0 +1,71 @@
+/**
+ * The StepCatalog: the local, closure-holding registry that resolves a plan node's `step` name to a
+ * runnable handler. A {@link RunPlan} is serializable and content-free precisely because it names
+ * steps by string; the executable behavior lives here, in-process, and never in the plan.
+ *
+ * A step declares a `version` and the `capabilities` it needs. The compiler uses both to fail closed:
+ * a node that pins a drifted version, or a step that needs a capability the host did not grant, is
+ * rejected before any node runs (ORC-05, ORC-07).
+ */
+import type { ArtifactPort, RunNodeKind } from "@nifrajs/agent-protocol";
+import type { SubagentExecutor, SubagentSpec } from "../subagents.js";
+/** Read-only view handed to a step's pure effect selector. No port, no mutation. */
+export interface StepEffectContext {
+    readonly nodeId: string;
+    readonly planDigest: string;
+    readonly values: ReadonlyMap<string, unknown>;
+}
+/** Runtime context handed to a step body. Payloads leave only through {@link StepRunContext.artifact}. */
+export interface StepRunContext {
+    readonly nodeId: string;
+    readonly planDigest: string;
+    readonly signal: AbortSignal;
+    /** Caller-owned artifact sink. The step routes any raw payload here to get a content-free ref. */
+    readonly artifact: ArtifactPort;
+    readonly values: ReadonlyMap<string, unknown>;
+    set(name: string, value: unknown): void;
+}
+/**
+ * One catalog handler. `kind` must match the plan node's kind at compile time.
+ *
+ * - Leaf kinds `task`/`verify`/`approve`/`checkpoint`/`handoff` implement {@link CatalogStep.run}.
+ * - `subagent` implements {@link CatalogStep.spec} and supplies an {@link CatalogStep.executor};
+ *   the compiler drives it through a {@link BoundedSubagentRunner} (never a private copy).
+ * - `branch` implements {@link CatalogStep.when}, a content-free predicate.
+ *
+ * `selectEffect`, when present, marks the step idempotent and projects its identity-bearing input
+ * into content-free bytes for `deriveNodeEffectKey`. It MUST be pure and read-only.
+ */
+export interface CatalogStep {
+    readonly kind: RunNodeKind;
+    /** Positive step version. Defaults to 1 when omitted. A node may pin an exact version. */
+    readonly version?: number;
+    /** Capabilities this step needs. The host's allow-list is the ceiling; a superset fails closed. */
+    readonly capabilities?: readonly string[];
+    run?(context: StepRunContext): unknown | PromiseLike<unknown>;
+    selectEffect?(context: StepEffectContext): Uint8Array;
+    /** `subagent` kind: the bounded child executor and the content-free spec projection. */
+    readonly executor?: SubagentExecutor;
+    spec?(context: StepRunContext): SubagentSpec | PromiseLike<SubagentSpec>;
+    /** `branch` kind: a content-free predicate selecting `then` or `otherwise`. */
+    when?(context: StepRunContext): boolean | PromiseLike<boolean>;
+}
+/** Thrown on a catalog construction fault: a key collision across merged catalogs. */
+export declare class CatalogError extends Error {
+    readonly reason: string;
+    constructor(reason: string);
+}
+/** The effective version of a step (defaults to 1). */
+export declare function stepVersion(step: CatalogStep): number;
+/** Resolves step names to handlers. Immutable after construction; lookup is deterministic. */
+export interface StepCatalog {
+    get(step: string): CatalogStep | undefined;
+    has(step: string): boolean;
+    /** Sorted for deterministic enumeration. */
+    readonly keys: readonly string[];
+}
+/** Build a StepCatalog from a name -> handler map. */
+export declare function createStepCatalog(entries: Readonly<Record<string, CatalogStep>>): StepCatalog;
+/** Merge catalogs into one. Throws {@link CatalogError} on any duplicate step key (collision). */
+export declare function mergeStepCatalogs(...catalogs: readonly StepCatalog[]): StepCatalog;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/orchestration/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/orchestration/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAErE,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC9C;AAED,0GAA0G;AAC1G,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,kGAAkG;IAClG,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7C,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;CACxC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,mGAAmG;IACnG,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACzC,GAAG,CAAC,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;IAC7D,YAAY,CAAC,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAAA;IACrD,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IACpC,IAAI,CAAC,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC,CAAA;IACxE,+EAA+E;IAC/E,IAAI,CAAC,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAA;CAC/D;AAED,sFAAsF;AACtF,qBAAa,YAAa,SAAQ,KAAK;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAIpC;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAErD;AAED,8FAA8F;AAC9F,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAA;IAC1C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CACjC;AAUD,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,GAAG,WAAW,CAE7F;AAED,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,GAAG,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,CASlF"}