@nifrajs/coding-agent 3.2.0

package/dist/deployment-adapters.js

@@ -0,0 +1,147 @@
+/**
+ * Truthful public deployment reference profiles.
+ *
+ * These adapters are deterministic lifecycle fixtures. They do not start a process, connect to a
+ * network, distribute secrets, or isolate hostile code. A real deployment implementation belongs
+ * behind the public `AgentDeploymentAdapter` contract and must provide its own security proof.
+ */
+import { DeploymentError, parseDeploymentCapabilityReport, } from "@nifrajs/agent";
+const LOCAL_PROCESS_CAPABILITIES = Object.freeze({
+    schemaVersion: 1,
+    adapterId: "local-process",
+    capabilities: Object.freeze({
+        runtime: "local",
+        network: "none",
+        filesystem: "workspace",
+        process: "child",
+        secrets: "none",
+        workspace: Object.freeze({ mode: "scoped", maxBytes: 10_000_000_000 }),
+        cancellation: "cooperative",
+        hostileCodeIsolation: "none",
+    }),
+    limitations: Object.freeze(["not-a-sandbox", "trusted-local"]),
+});
+const CI_CAPABILITIES = Object.freeze({
+    schemaVersion: 1,
+    adapterId: "ci",
+    capabilities: Object.freeze({
+        runtime: "ci",
+        network: "none",
+        filesystem: "workspace",
+        process: "child",
+        secrets: "none",
+        workspace: Object.freeze({ mode: "scoped", maxBytes: 10_000_000_000 }),
+        cancellation: "cooperative",
+        hostileCodeIsolation: "none",
+    }),
+    limitations: Object.freeze(["not-a-sandbox", "ephemeral"]),
+});
+const REPLAY_CAPABILITIES = Object.freeze({
+    schemaVersion: 1,
+    adapterId: "replay",
+    capabilities: Object.freeze({
+        runtime: "replay",
+        network: "none",
+        filesystem: "none",
+        process: "none",
+        secrets: "none",
+        workspace: Object.freeze({ mode: "none", maxBytes: 0 }),
+        cancellation: "cooperative",
+        hostileCodeIsolation: "none",
+    }),
+    limitations: Object.freeze(["not-a-sandbox", "no-side-effects"]),
+});
+class DeterministicDeploymentAdapter {
+    id;
+    report;
+    states = new Map();
+    constructor(report) {
+        this.report = parseDeploymentCapabilityReport(report);
+        this.id = this.report.adapterId;
+    }
+    capabilityReport() {
+        return this.report;
+    }
+    prepare(request) {
+        this.assertActive(request.signal);
+        const deploymentId = request.plan.deploymentId;
+        if (this.states.has(deploymentId))
+            throw new DeploymentError("invalid_transition");
+        this.states.set(deploymentId, "prepared");
+        return Object.freeze({
+            deploymentId,
+            state: "prepared",
+            preparedRef: `${deploymentId}:prepared`,
+        });
+    }
+    start(request) {
+        this.assertActive(request.signal);
+        if (this.states.get(request.deploymentId) !== "prepared" ||
+            request.preparedRef !== `${request.deploymentId}:prepared`)
+            throw new DeploymentError("invalid_transition");
+        this.states.set(request.deploymentId, "running");
+        return Object.freeze({
+            deploymentId: request.deploymentId,
+            state: "running",
+            handleRef: `${request.deploymentId}:handle`,
+        });
+    }
+    inspect(request) {
+        this.assertActive(request.signal);
+        const state = this.states.get(request.deploymentId);
+        if (state === undefined)
+            throw new DeploymentError("invalid_transition");
+        return Object.freeze({
+            deploymentId: request.deploymentId,
+            state,
+            ...(state === "running" ? { handleRef: `${request.deploymentId}:handle` } : {}),
+        });
+    }
+    cancel(request) {
+        this.assertActive(request.signal);
+        const state = this.states.get(request.deploymentId);
+        if (state !== "prepared" && state !== "running")
+            throw new DeploymentError("invalid_transition");
+        this.states.set(request.deploymentId, "cancelled");
+        return Object.freeze({ deploymentId: request.deploymentId, state: "cancelled" });
+    }
+    dispose(request) {
+        this.assertActive(request.signal);
+        this.states.set(request.deploymentId, "disposed");
+        return Object.freeze({ deploymentId: request.deploymentId, state: "disposed" });
+    }
+    assertActive(signal) {
+        if (signal.aborted)
+            throw new DeploymentError("cancelled");
+    }
+}
+export class LocalProcessDeploymentAdapter extends DeterministicDeploymentAdapter {
+    constructor() {
+        super(LOCAL_PROCESS_CAPABILITIES);
+    }
+}
+export class CiDeploymentAdapter extends DeterministicDeploymentAdapter {
+    constructor() {
+        super(CI_CAPABILITIES);
+    }
+}
+export class ReplayDeploymentAdapter extends DeterministicDeploymentAdapter {
+    constructor() {
+        super(REPLAY_CAPABILITIES);
+    }
+}
+export function createLocalProcessDeploymentAdapter() {
+    return new LocalProcessDeploymentAdapter();
+}
+export function createCiDeploymentAdapter() {
+    return new CiDeploymentAdapter();
+}
+export function createReplayDeploymentAdapter() {
+    return new ReplayDeploymentAdapter();
+}
+export const DEPLOYMENT_REFERENCE_PROFILES = Object.freeze({
+    localProcess: LOCAL_PROCESS_CAPABILITIES,
+    ci: CI_CAPABILITIES,
+    replay: REPLAY_CAPABILITIES,
+});
+//# sourceMappingURL=deployment-adapters.js.map

package/dist/deployment-adapters.js.map

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

package/dist/diff.d.ts

@@ -0,0 +1,17 @@
+export interface ProjectDiffOptions {
+    readonly cwd: string;
+    readonly timeoutMs?: number;
+    readonly maxOutputBytes?: number;
+    readonly exposeErrorStacks?: boolean;
+}
+export interface ProjectDiffResult {
+    readonly ok: boolean;
+    readonly status: number | null;
+    readonly output?: string;
+    readonly truncated?: boolean;
+    readonly error?: string;
+    readonly stack?: string;
+}
+/** Read a bounded, non-interactive git diff for review surfaces. No user-supplied git arguments are accepted. */
+export declare function readProjectDiff(options: ProjectDiffOptions): Promise<ProjectDiffResult>;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAA;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,iHAAiH;AACjH,wBAAsB,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAkD7F"}

package/dist/diff.js

@@ -0,0 +1,61 @@
+import { publicErrorDetails } from "./errors.js";
+import { readBoundedText } from "./process.js";
+/** Read a bounded, non-interactive git diff for review surfaces. No user-supplied git arguments are accepted. */
+export async function readProjectDiff(options) {
+    const timeoutMs = options.timeoutMs ?? 30_000;
+    const maxOutputBytes = options.maxOutputBytes ?? 512 * 1024;
+    if (!Number.isSafeInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 10 * 60_000)
+        throw new RangeError("project diff: timeoutMs is invalid");
+    if (!Number.isSafeInteger(maxOutputBytes) ||
+        maxOutputBytes < 1024 ||
+        maxOutputBytes > 16 * 1024 * 1024)
+        throw new RangeError("project diff: maxOutputBytes is invalid");
+    const proc = Bun.spawn(["git", "--no-pager", "diff", "HEAD", "--no-ext-diff", "--unified=3", "--"], {
+        cwd: options.cwd,
+        stdin: "ignore",
+        stdout: "pipe",
+        stderr: "pipe",
+        env: safeEnv(),
+    });
+    let timedOut = false;
+    const timer = setTimeout(() => {
+        timedOut = true;
+        proc.kill();
+    }, timeoutMs);
+    try {
+        const [stdout, stderr, status] = await Promise.all([
+            readBoundedText(proc.stdout, maxOutputBytes),
+            readBoundedText(proc.stderr, Math.min(maxOutputBytes, 64 * 1024)),
+            proc.exited,
+        ]);
+        return {
+            ok: !timedOut && status === 0,
+            status,
+            output: stdout.text.length > 0 ? stdout.text : stderr.text,
+            ...(stdout.truncated ? { truncated: true } : {}),
+            ...(timedOut ? { error: `git diff timed out after ${timeoutMs}ms` } : {}),
+        };
+    }
+    catch (error) {
+        const details = publicErrorDetails(error, "git diff failed", options.exposeErrorStacks === true);
+        return {
+            ok: false,
+            status: null,
+            error: details.message,
+            ...(details.stack === undefined ? {} : { stack: details.stack }),
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function safeEnv() {
+    const result = {};
+    for (const name of ["PATH", "HOME", "LANG", "LC_ALL", "TERM", "GIT_PAGER"]) {
+        const value = name === "GIT_PAGER" ? "cat" : process.env[name];
+        if (value !== undefined)
+            result[name] = value;
+    }
+    return result;
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,9 @@
+export interface PublicErrorDetails {
+    readonly message: string;
+    readonly stack?: string;
+}
+/** Return the useful diagnostic without serializing an Error object or its stack. */
+export declare function publicErrorMessage(error: unknown, fallback: string): string;
+/** Add a bounded stack only for an explicitly trusted local diagnostics channel. */
+export declare function publicErrorDetails(error: unknown, fallback: string, includeStack?: boolean): PublicErrorDetails;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAa3E;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,UAAQ,GACnB,kBAAkB,CAgBpB"}

package/dist/errors.js

@@ -0,0 +1,35 @@
+const MAX_PUBLIC_ERROR_LENGTH = 4096;
+const MAX_PUBLIC_STACK_LENGTH = 16 * 1024;
+/** Return the useful diagnostic without serializing an Error object or its stack. */
+export function publicErrorMessage(error, fallback) {
+    const message = error instanceof Error
+        ? error.message
+        : typeof error === "string"
+            ? error
+            : error !== null && typeof error === "object" && "message" in error
+                ? error.message
+                : undefined;
+    if (typeof message !== "string" || message.length === 0)
+        return fallback;
+    return message.length > MAX_PUBLIC_ERROR_LENGTH
+        ? `${message.slice(0, MAX_PUBLIC_ERROR_LENGTH)}…`
+        : message;
+}
+/** Add a bounded stack only for an explicitly trusted local diagnostics channel. */
+export function publicErrorDetails(error, fallback, includeStack = false) {
+    const message = publicErrorMessage(error, fallback);
+    if (!includeStack || !(error instanceof Error) || typeof error.stack !== "string")
+        return { message };
+    const stack = error.stack;
+    return {
+        message,
+        ...(stack.length === 0
+            ? {}
+            : {
+                stack: stack.length > MAX_PUBLIC_STACK_LENGTH
+                    ? `${stack.slice(0, MAX_PUBLIC_STACK_LENGTH)}…`
+                    : stack,
+            }),
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,uBAAuB,GAAG,IAAI,CAAA;AACpC,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,CAAA;AAOzC,qFAAqF;AACrF,MAAM,UAAU,kBAAkB,CAAC,KAAc,EAAE,QAAgB;IACjE,MAAM,OAAO,GACX,KAAK,YAAY,KAAK;QACpB,CAAC,CAAC,KAAK,CAAC,OAAO;QACf,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ;YACzB,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK;gBACjE,CAAC,CAAE,KAAwC,CAAC,OAAO;gBACnD,CAAC,CAAC,SAAS,CAAA;IACnB,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAA;IACxE,OAAO,OAAO,CAAC,MAAM,GAAG,uBAAuB;QAC7C,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,GAAG;QACjD,CAAC,CAAC,OAAO,CAAA;AACb,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,kBAAkB,CAChC,KAAc,EACd,QAAgB,EAChB,YAAY,GAAG,KAAK;IAEpB,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;IACnD,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;QAC/E,OAAO,EAAE,OAAO,EAAE,CAAA;IACpB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAA;IACzB,OAAO;QACL,OAAO;QACP,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YACpB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,KAAK,EACH,KAAK,CAAC,MAAM,GAAG,uBAAuB;oBACpC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,uBAAuB,CAAC,GAAG;oBAC/C,CAAC,CAAC,KAAK;aACZ,CAAC;KACP,CAAA;AACH,CAAC"}

package/dist/extensions.d.ts

@@ -0,0 +1,104 @@
+import { type WorkflowEvent, type WorkflowResult, type WorkflowStep } from "./workflows.js";
+export interface ExtensionContext {
+    readonly cwd: string;
+    readonly registerCommand: (name: string, handler: ExtensionCommand) => void;
+    readonly registerTool: (tool: ExtensionTool) => void;
+    readonly registerWorkflow: (name: string, workflow: ExtensionWorkflow) => void;
+    readonly registerSubagent: (role: ExtensionSubagent) => void;
+    readonly registerProvider: (provider: ExtensionProvider) => void;
+    readonly on: (event: string, handler: ExtensionEventHandler) => void;
+}
+export type ExtensionCommand = (args: string, context: ExtensionContext) => unknown | PromiseLike<unknown>;
+export interface ExtensionTool {
+    readonly name: string;
+    readonly description: string;
+    readonly capabilities?: readonly string[];
+    readonly execute: (input: unknown, context: ExtensionContext) => unknown | PromiseLike<unknown>;
+}
+export interface ExtensionSubagent {
+    readonly name: string;
+    readonly description: string;
+    readonly prompt: string;
+    readonly capabilities?: readonly string[];
+    readonly maxDepth?: number;
+}
+export interface ExtensionProvider {
+    readonly name: string;
+    readonly description: string;
+    readonly capabilities?: readonly string[];
+}
+export type ExtensionEventHandler = (payload: unknown, context: ExtensionContext) => unknown | PromiseLike<unknown>;
+/** A workflow factory keeps orchestration lazy and lets every extension fully customize its steps. */
+export type ExtensionWorkflow = (context: ExtensionContext) => WorkflowStep | PromiseLike<WorkflowStep>;
+export interface WorkflowRunOptions {
+    readonly signal?: AbortSignal;
+    readonly maxSteps?: number;
+    readonly maxDepth?: number;
+    readonly onEvent?: (event: WorkflowEvent) => void | PromiseLike<void>;
+    readonly exposeErrorStacks?: boolean;
+}
+export interface CodingAgentExtension {
+    readonly id: string;
+    readonly path: string;
+    readonly capabilities: readonly string[];
+    readonly dispose?: () => void | PromiseLike<void>;
+}
+export interface ExtensionReloadResult {
+    readonly revision: string;
+    readonly loaded: readonly string[];
+    readonly disabled: readonly string[];
+    readonly rolledBack: boolean;
+    readonly error?: string;
+}
+export interface ExtensionHostOptions {
+    readonly cwd: string;
+    readonly roots: readonly string[];
+    readonly trustedCapabilities?: readonly string[];
+    /** Optional fast syntax/type/build gate that runs before a module is staged. */
+    readonly validate?: (path: string) => void | PromiseLike<void>;
+    readonly onError?: (error: {
+        readonly path: string;
+        readonly error: unknown;
+    }) => void;
+}
+/** Discover only project-local extension files; no home-directory or dependency scan is implicit. */
+export declare function discoverExtensions(cwd: string): Promise<readonly string[]>;
+/** Parse an extension without activating it. This is a fast syntax gate before staging. */
+export declare function validateExtensionModule(path: string): Promise<void>;
+/**
+ * Transactional TypeScript extension loader for the Nifra-native backend.
+ *
+ * This loader only activates explicitly supplied files. It never scans a project implicitly and it
+ * leaves the previous extension graph intact when a staged reload fails.
+ */
+export declare class ExtensionHost {
+    private readonly options;
+    private active;
+    private commands;
+    private tools;
+    private workflows;
+    private subagents;
+    private providers;
+    private handlers;
+    private revision;
+    constructor(options: ExtensionHostOptions);
+    get extensions(): readonly CodingAgentExtension[];
+    get currentRevision(): string;
+    get availableCommands(): readonly string[];
+    get availableTools(): readonly ExtensionTool[];
+    get availableWorkflows(): readonly string[];
+    get availableSubagents(): readonly ExtensionSubagent[];
+    get availableProviders(): readonly ExtensionProvider[];
+    reload(): Promise<ExtensionReloadResult>;
+    close(): Promise<void>;
+    command(name: string): ExtensionCommand | undefined;
+    tool(name: string): ExtensionTool | undefined;
+    workflow(name: string): ExtensionWorkflow | undefined;
+    subagent(name: string): ExtensionSubagent | undefined;
+    provider(name: string): ExtensionProvider | undefined;
+    runWorkflow(name: string, options?: WorkflowRunOptions): Promise<WorkflowResult>;
+    emit(event: string, payload: unknown): Promise<void>;
+    private loadOne;
+    private context;
+}
+//# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

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