@fabric-harness/sdk 0.1.0

package/dist/error.js

@@ -0,0 +1,48 @@
+import { redactJson } from './redaction.js';
+export class FabricError extends Error {
+    code;
+    details;
+    publicMessage;
+    publicDetails;
+    retryable;
+    constructor(options) {
+        super(options.message, options.cause !== undefined ? { cause: options.cause } : undefined);
+        this.name = 'FabricError';
+        this.code = options.code;
+        if (options.details !== undefined)
+            this.details = redactJson(options.details);
+        this.publicMessage = options.publicMessage ?? safePublicMessage(options.code, options.message);
+        if (options.publicDetails !== undefined)
+            this.publicDetails = redactJson(options.publicDetails);
+        this.retryable = options.retryable ?? false;
+    }
+    toJSON(audience = process.env.FABRIC_MODE === 'production' ? 'public' : 'developer') {
+        const json = { name: this.name, code: this.code, message: audience === 'public' ? this.publicMessage : redactJson(this.message), retryable: this.retryable };
+        const details = audience === 'public' ? this.publicDetails : this.details;
+        if (details !== undefined)
+            json.details = redactJson(details);
+        return json;
+    }
+    toPublicJSON() {
+        return this.toJSON('public');
+    }
+    toDeveloperJSON() {
+        return this.toJSON('developer');
+    }
+}
+function safePublicMessage(code, message) {
+    if (process.env.FABRIC_MODE !== 'production')
+        return redactJson(message);
+    if (code === 'UNKNOWN')
+        return 'An unexpected Fabric Harness error occurred.';
+    return redactJson(message);
+}
+export function isFabricError(error) {
+    return error instanceof FabricError;
+}
+export function toFabricError(error, fallback) {
+    if (isFabricError(error))
+        return error;
+    return new FabricError({ ...fallback, cause: error });
+}
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAsC5C,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAkB;IACtB,OAAO,CAAc;IACrB,aAAa,CAAS;IACtB,aAAa,CAAc;IAC3B,SAAS,CAAU;IAE5B,YAAY,OAA2B;QACrC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC3F,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9E,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,iBAAiB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/F,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS;YAAE,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;QAChG,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,WAAmC,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW;QACzG,MAAM,IAAI,GAAe,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QACzK,MAAM,OAAO,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAC1E,IAAI,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,IAAqB,EAAE,OAAe;IAC/D,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,YAAY;QAAE,OAAO,UAAU,CAAC,OAAO,CAAW,CAAC;IACnF,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,8CAA8C,CAAC;IAC9E,OAAO,UAAU,CAAC,OAAO,CAAW,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,YAAY,WAAW,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,QAA2C;IACvF,IAAI,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,IAAI,WAAW,CAAC,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;AACxD,CAAC"}

package/dist/filesystem-source.d.ts

@@ -0,0 +1,69 @@
+import type { SandboxEnv, SandboxFactory } from './sandbox.js';
+import type { SandboxBackend } from './types.js';
+/**
+ * A read-only content source that can be mounted into a sandbox at
+ * sandbox-creation time. The agent then has built-in `read`, `glob`,
+ * and `grep` tools available over the mounted content — no retrieval
+ * pipeline, no embeddings, no vector store required.
+ *
+ * Sources are intentionally minimal: they yield (path, content) pairs.
+ * Implementations decide how to enumerate (eager vs lazy is up to the
+ * source author) — the mount step pulls the full set into the sandbox.
+ */
+export interface FilesystemSource {
+    /** Stable name for telemetry / logs. */
+    readonly name?: string;
+    /** Yield path/content pairs. Paths are relative to the mount root. */
+    entries(): AsyncIterable<FilesystemEntry>;
+}
+export interface FilesystemEntry {
+    /** Path relative to the mount point (no leading slash). */
+    path: string;
+    content: string | Uint8Array;
+    /** Optional metadata; reserved for future use (mtime, content-type). */
+    metadata?: Record<string, unknown>;
+}
+export interface MountedSource {
+    source: FilesystemSource;
+    /** Absolute path inside the sandbox where this source is mounted. */
+    mountAt?: string;
+}
+/**
+ * Read a host directory recursively as a read-only source.
+ *
+ * `include` is called for each candidate file path (relative to
+ * `hostPath`). Return `false` to skip. Defaults to including everything.
+ */
+export declare function localDirectorySource(hostPath: string, options?: {
+    name?: string;
+    include?: (relativePath: string) => boolean;
+}): FilesystemSource;
+/**
+ * Build a source from an in-memory map of `path -> content`. Useful for
+ * tests, fixtures, and small static knowledge bases bundled into the
+ * agent module itself.
+ */
+export declare function inMemorySource(files: Record<string, string | Uint8Array>, options?: {
+    name?: string;
+}): FilesystemSource;
+/**
+ * Wrap a sandbox backend or factory so each new sandbox is pre-populated
+ * with the contents of one or more `FilesystemSource`s. The result is a
+ * `SandboxFactory` that can be passed directly to `init({ sandbox })`.
+ *
+ * ```ts
+ * const sandbox = withFilesystemSources('empty', [{
+ *   mountAt: '/workspace/kb',
+ *   source: localDirectorySource('./knowledge-base'),
+ * }]);
+ *
+ * const agent = await init({ sandbox, model: 'anthropic/claude-sonnet-4-6' });
+ * ```
+ *
+ * The agent's built-in `grep`, `glob`, and `read` tools then operate on
+ * the mounted content directly. Writes to mounted paths are not blocked
+ * by the SDK — sources are conventionally read-only; treat the agent's
+ * role/skill prompts as the place to enforce that.
+ */
+export declare function withFilesystemSources(base: SandboxBackend | SandboxFactory | SandboxEnv, sources: MountedSource[]): SandboxFactory;
+//# sourceMappingURL=filesystem-source.d.ts.map

package/dist/filesystem-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-source.d.ts","sourceRoot":"","sources":["../src/filesystem-source.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAyB,MAAM,cAAc,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sEAAsE;IACtE,OAAO,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,gBAAgB,CAAC;IACzB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAA;CAAO,GAAG,gBAAgB,CASrJ;AAwBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,EAAE,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,gBAAgB,CAU5H;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,cAAc,GAAG,cAAc,GAAG,UAAU,EAClD,OAAO,EAAE,aAAa,EAAE,GACvB,cAAc,CAehB"}

package/dist/filesystem-source.js

@@ -0,0 +1,109 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { createSandboxEnv } from './sandbox.js';
+/**
+ * Read a host directory recursively as a read-only source.
+ *
+ * `include` is called for each candidate file path (relative to
+ * `hostPath`). Return `false` to skip. Defaults to including everything.
+ */
+export function localDirectorySource(hostPath, options = {}) {
+    const include = options.include ?? (() => true);
+    const name = options.name ?? `local:${hostPath}`;
+    return {
+        name,
+        async *entries() {
+            yield* walkDirectory(hostPath, '', include);
+        },
+    };
+}
+async function* walkDirectory(root, prefix, include) {
+    const dirHandle = path.join(root, prefix);
+    let entries;
+    try {
+        entries = await fs.readdir(dirHandle, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const relative = prefix ? path.posix.join(prefix, entry.name) : entry.name;
+        if (entry.isDirectory()) {
+            yield* walkDirectory(root, relative, include);
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        if (!include(relative))
+            continue;
+        const absolute = path.join(root, relative);
+        const content = await fs.readFile(absolute);
+        yield { path: relative, content: new Uint8Array(content) };
+    }
+}
+/**
+ * Build a source from an in-memory map of `path -> content`. Useful for
+ * tests, fixtures, and small static knowledge bases bundled into the
+ * agent module itself.
+ */
+export function inMemorySource(files, options = {}) {
+    const name = options.name ?? 'in-memory';
+    return {
+        name,
+        async *entries() {
+            for (const [filePath, content] of Object.entries(files)) {
+                yield { path: filePath.replace(/^\//, ''), content };
+            }
+        },
+    };
+}
+/**
+ * Wrap a sandbox backend or factory so each new sandbox is pre-populated
+ * with the contents of one or more `FilesystemSource`s. The result is a
+ * `SandboxFactory` that can be passed directly to `init({ sandbox })`.
+ *
+ * ```ts
+ * const sandbox = withFilesystemSources('empty', [{
+ *   mountAt: '/workspace/kb',
+ *   source: localDirectorySource('./knowledge-base'),
+ * }]);
+ *
+ * const agent = await init({ sandbox, model: 'anthropic/claude-sonnet-4-6' });
+ * ```
+ *
+ * The agent's built-in `grep`, `glob`, and `read` tools then operate on
+ * the mounted content directly. Writes to mounted paths are not blocked
+ * by the SDK — sources are conventionally read-only; treat the agent's
+ * role/skill prompts as the place to enforce that.
+ */
+export function withFilesystemSources(base, sources) {
+    return async (options) => {
+        const sandbox = await resolveBaseSandbox(base, options);
+        for (const mounted of sources) {
+            const mountAt = mounted.mountAt ?? sandbox.cwd;
+            await ensureDirectory(sandbox, mountAt);
+            for await (const entry of mounted.source.entries()) {
+                const target = path.posix.join(mountAt, entry.path);
+                const parent = path.posix.dirname(target);
+                await ensureDirectory(sandbox, parent);
+                await sandbox.writeFile(target, entry.content);
+            }
+        }
+        return sandbox;
+    };
+}
+async function resolveBaseSandbox(base, options) {
+    if (typeof base === 'object' && base !== null && 'exec' in base)
+        return base;
+    if (typeof base === 'function')
+        return base(options);
+    return createSandboxEnv({ ...options, backend: base });
+}
+async function ensureDirectory(sandbox, dir) {
+    if (!dir || dir === '/' || dir === '.')
+        return;
+    if (await sandbox.exists(dir))
+        return;
+    await sandbox.mkdir(dir, { recursive: true });
+}
+//# sourceMappingURL=filesystem-source.js.map

package/dist/filesystem-source.js.map

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

package/dist/history.d.ts

@@ -0,0 +1,16 @@
+import type { ModelMessage } from './model.js';
+import type { Role, SessionData, SessionEntry } from './types.js';
+export declare const DEFAULT_HEADLESS_PREAMBLE = "You are running in headless autonomous mode (background-agent mode) with no human operator assumed. Work autonomously: Do not ask clarifying questions or wait for in-band user input. Make safe, reasonable assumptions when possible; if blocked by missing credentials, unavailable capabilities, denied policy, or required approvals, fail closed with a concise actionable explanation. Irreversible or high-risk actions must go through policy/approval gates, not natural-language confirmation. Summarize what you did and any remaining risks or follow-ups.";
+export declare class SessionHistory {
+    private readonly entries;
+    private readonly byId;
+    private readonly leafId;
+    private constructor();
+    static fromData(data: SessionData | undefined): SessionHistory;
+    getActivePath(): SessionEntry[];
+    getLatestCompaction(): SessionEntry | undefined;
+    buildContextEntries(): SessionEntry[];
+    buildModelMessages(role?: Role): ModelMessage[];
+}
+export declare function buildModelMessagesFromHistory(data: SessionData | undefined, role?: Role): ModelMessage[];
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAElE,eAAO,MAAM,yBAAyB,4iBAA4iB,CAAC;AAEnlB,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C,OAAO;IAMP,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,cAAc;IAI9D,aAAa,IAAI,YAAY,EAAE;IAU/B,mBAAmB,IAAI,YAAY,GAAG,SAAS;IAS/C,mBAAmB,IAAI,YAAY,EAAE;IAgBrC,kBAAkB,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,YAAY,EAAE;CAiChD;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,YAAY,EAAE,CAExG"}

package/dist/history.js

@@ -0,0 +1,118 @@
+export const DEFAULT_HEADLESS_PREAMBLE = 'You are running in headless autonomous mode (background-agent mode) with no human operator assumed. Work autonomously: Do not ask clarifying questions or wait for in-band user input. Make safe, reasonable assumptions when possible; if blocked by missing credentials, unavailable capabilities, denied policy, or required approvals, fail closed with a concise actionable explanation. Irreversible or high-risk actions must go through policy/approval gates, not natural-language confirmation. Summarize what you did and any remaining risks or follow-ups.';
+export class SessionHistory {
+    entries;
+    byId;
+    leafId;
+    constructor(entries, leafId) {
+        this.entries = [...entries];
+        this.leafId = leafId;
+        this.byId = new Map(entries.map((entry) => [entry.id, entry]));
+    }
+    static fromData(data) {
+        return new SessionHistory(data?.entries ?? [], data?.leafId);
+    }
+    getActivePath() {
+        const path = [];
+        let current = this.leafId ? this.byId.get(this.leafId) : this.entries.at(-1);
+        while (current) {
+            path.push(current);
+            current = current.parentId ? this.byId.get(current.parentId) : undefined;
+        }
+        return path.reverse();
+    }
+    getLatestCompaction() {
+        const path = this.getActivePath();
+        for (let index = path.length - 1; index >= 0; index -= 1) {
+            const entry = path[index];
+            if (entry?.type === 'compaction')
+                return entry;
+        }
+        return undefined;
+    }
+    buildContextEntries() {
+        const path = this.getActivePath();
+        const compaction = this.getLatestCompaction();
+        if (!compaction)
+            return path;
+        const firstKeptEntryId = typeof compaction.data?.firstKeptEntryId === 'string'
+            ? compaction.data.firstKeptEntryId
+            : undefined;
+        const firstKeptIndex = firstKeptEntryId
+            ? path.findIndex((entry) => entry.id === firstKeptEntryId)
+            : -1;
+        const compactionIndex = path.findIndex((entry) => entry.id === compaction.id);
+        const keptStart = firstKeptIndex >= 0 ? firstKeptIndex : compactionIndex + 1;
+        return [compaction, ...path.slice(keptStart).filter((entry) => entry.id !== compaction.id)];
+    }
+    buildModelMessages(role) {
+        const messages = [{ role: 'system', content: role ? `${DEFAULT_HEADLESS_PREAMBLE}\n\n${role.content}` : DEFAULT_HEADLESS_PREAMBLE }];
+        const entries = this.buildContextEntries();
+        let i = 0;
+        while (i < entries.length) {
+            const entry = entries[i];
+            if (!entry) {
+                i += 1;
+                continue;
+            }
+            // Group consecutive tool_call entries into a single assistant message with toolCalls
+            if (entry.type === 'tool_call') {
+                const toolCalls = [];
+                while (i < entries.length) {
+                    const tc = entries[i];
+                    if (!tc || tc.type !== 'tool_call')
+                        break;
+                    const id = typeof tc.data?.toolCallId === 'string' ? tc.data.toolCallId : `tc-${tc.id}`;
+                    toolCalls.push({
+                        id,
+                        name: typeof tc.data?.tool === 'string' ? tc.data.tool : 'unknown',
+                        input: tc.data?.input,
+                    });
+                    i += 1;
+                }
+                messages.push({ role: 'assistant', content: '', toolCalls });
+                continue;
+            }
+            const message = entryToModelMessage(entry);
+            if (message)
+                messages.push(message);
+            i += 1;
+        }
+        return messages;
+    }
+}
+export function buildModelMessagesFromHistory(data, role) {
+    return SessionHistory.fromData(data).buildModelMessages(role);
+}
+function entryToModelMessage(entry) {
+    switch (entry.type) {
+        case 'compaction': {
+            const summary = typeof entry.data?.summary === 'string' ? entry.data.summary : 'Previous context was compacted.';
+            return { role: 'user', content: `[Context Summary]\n\n${summary}` };
+        }
+        case 'user_prompt': {
+            const text = typeof entry.data?.text === 'string' ? entry.data.text : undefined;
+            return text ? { role: 'user', content: text } : undefined;
+        }
+        case 'assistant_message': {
+            const text = typeof entry.data?.text === 'string' ? entry.data.text : undefined;
+            return text ? { role: 'assistant', content: text } : undefined;
+        }
+        case 'tool_call': {
+            // Handled by grouping in buildModelMessages; skip individual entries
+            return undefined;
+        }
+        case 'tool_result': {
+            const tool = typeof entry.data?.tool === 'string' ? entry.data.tool : 'tool';
+            const output = entry.data?.output;
+            const toolCallId = typeof entry.data?.toolCallId === 'string' ? entry.data.toolCallId : undefined;
+            return { role: 'tool', name: tool, content: JSON.stringify(output ?? null), ...(toolCallId ? { toolCallId } : {}) };
+        }
+        case 'error': {
+            const error = typeof entry.data?.error === 'string' ? entry.data.error : undefined;
+            return error ? { role: 'user', content: `[Error]\n\n${error}` } : undefined;
+        }
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,yBAAyB,GAAG,yiBAAyiB,CAAC;AAEnlB,MAAM,OAAO,cAAc;IACR,OAAO,CAAiB;IACxB,IAAI,CAA4B;IAChC,MAAM,CAAqB;IAE5C,YAAoB,OAAuB,EAAE,MAA0B;QACrE,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAA6B;QAC3C,OAAO,IAAI,cAAc,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC;IAED,aAAa;QACX,MAAM,IAAI,GAAmB,EAAE,CAAC;QAChC,IAAI,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,OAAO,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACnB,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3E,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAED,mBAAmB;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QAClC,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,KAAK,EAAE,IAAI,KAAK,YAAY;gBAAE,OAAO,KAAK,CAAC;QACjD,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,mBAAmB;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QAClC,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC9C,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAE7B,MAAM,gBAAgB,GAAG,OAAO,UAAU,CAAC,IAAI,EAAE,gBAAgB,KAAK,QAAQ;YAC5E,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,gBAAgB;YAClC,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,cAAc,GAAG,gBAAgB;YACrC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,gBAAgB,CAAC;YAC1D,CAAC,CAAC,CAAC,CAAC,CAAC;QACP,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,UAAU,CAAC,EAAE,CAAC,CAAC;QAC9E,MAAM,SAAS,GAAG,cAAc,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC;QAC7E,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,kBAAkB,CAAC,IAAW;QAC5B,MAAM,QAAQ,GAAmB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,yBAAyB,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,yBAAyB,EAAE,CAAC,CAAC;QAErJ,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3C,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,EAAE,CAAC;gBAAC,CAAC,IAAI,CAAC,CAAC;gBAAC,SAAS;YAAC,CAAC;YAEjC,qFAAqF;YACrF,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC/B,MAAM,SAAS,GAAoB,EAAE,CAAC;gBACtC,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;oBAC1B,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;oBACtB,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,KAAK,WAAW;wBAAE,MAAM;oBAC1C,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACxF,SAAS,CAAC,IAAI,CAAC;wBACb,EAAE;wBACF,IAAI,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;wBAClE,KAAK,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK;qBACtB,CAAC,CAAC;oBACH,CAAC,IAAI,CAAC,CAAC;gBACT,CAAC;gBACD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC7D,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC3C,IAAI,OAAO;gBAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED,MAAM,UAAU,6BAA6B,CAAC,IAA6B,EAAE,IAAW;IACtF,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAmB;IAC9C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,IAAI,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,iCAAiC,CAAC;YACjH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,OAAO,EAAE,EAAE,CAAC;QACtE,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YAChF,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,CAAC;QACD,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;YAChF,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACjE,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,qEAAqE;YACrE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;YAC7E,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC;YAClC,MAAM,UAAU,GAAG,OAAO,KAAK,CAAC,IAAI,EAAE,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YAClG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACtH,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;YACnF,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9E,CAAC;QACD;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+export { init, StubFabricAgent } from './agent.js';
+export { agent, defineAgent, getAgentDefinition } from './agent-definition.js';
+export { resolveRuntimeMode, isStatelessRuntime, isInMemoryStore } from './runtime-mode.js';
+export { evaluateContextBudget, estimateModelMessagesTokens, estimateSessionEntriesTokens, estimateTextTokens, isContextOverflowError } from './context-budget.js';
+export { createFabricContext } from './context.js';
+export { FabricError, isFabricError, toFabricError } from './error.js';
+export { redactError, redactJson, redactText } from './redaction.js';
+export { DEFAULT_HEADLESS_PREAMBLE, SessionHistory, buildModelMessagesFromHistory } from './history.js';
+export { NativeLoopRuntime, defaultLoopRuntime } from './loop.js';
+export { connectMcpServer, createMcpTools } from './mcp.js';
+export { StdioMcpClient, createStdioMcpClient } from './mcp-stdio.js';
+export { AnthropicModelProvider, AzureOpenAIModelProvider, BedrockModelProvider, CohereModelProvider, FallbackModelProvider, GeminiModelProvider, MockModelProvider, OpenAICompatibleModelProvider, ProviderHttpError, VertexAIModelProvider, defaultModelProvider, generateWithRuntime, toolsToModelSchemas, } from './model.js';
+export { clampCommandTimeout, evaluateCommandPolicy, evaluateToolCallPolicy, } from './policy.js';
+export { parseModelRef, resolveModelProvider } from './providers.js';
+export { RESULT_END_DELIMITER, RESULT_START_DELIMITER, buildResultRetryPrompt, extractResultValue, validateResult } from './result.js';
+export { StubFabricSession } from './session.js';
+export { createRemoteSandboxEnv, createSandboxEnv, DockerSandboxEnv, EmptySandboxEnv, LocalSandboxEnv, UnimplementedSandboxEnv } from './sandbox.js';
+export { inMemorySource, localDirectorySource, withFilesystemSources } from './filesystem-source.js';
+export type { FilesystemEntry, FilesystemSource, MountedSource } from './filesystem-source.js';
+export { SchemaValidationError, formatSchemaIssues, schema } from './schema.js';
+export { emitOpenTelemetrySpan, openTelemetryExporter } from './otel.js';
+export { consoleTelemetryExporter, entryToTelemetrySpan, eventToTelemetrySpan } from './telemetry.js';
+export { InMemorySessionStore, NoopSessionStore, approvalStatesFromEntries, defaultSessionStore, noopSessionStore } from './store.js';
+export { bashTool, createBuiltinTools, createCommandTools, createFileTools, defineCommand, defineTool, editFileTool, existsTool, globTool, grepTool, mkdirTool, readFileBufferTool, readFileTool, readdirTool, rmTool, secret, shellQuote, statTool, writeFileTool, } from './tools.js';
+export type { ContextBudget, ContextBudgetOptions } from './context-budget.js';
+export type { FabricErrorCode, FabricErrorOptions } from './error.js';
+export type { RedactionOptions } from './redaction.js';
+export type { ApprovalRisk, CapabilityPolicy, CommandPolicy, FilesystemPolicy, PolicyDecision, ToolPolicy } from './policy.js';
+export type { ModelConfig, ParsedModelRef, ProviderSettings, ProvidersConfig, ResolveModelProviderOptions, ResolvedModelProvider } from './providers.js';
+export type { AgentDefinition, AgentTriggers, DefineAgentOptions, DefinedAgent } from './agent-definition.js';
+export type { RuntimeModeResolution } from './runtime-mode.js';
+export type { JsonSchemaObject, Schema, SchemaIssue } from './schema.js';
+export type { AgentLoopRuntime, PromptRunInput, PromptRunResult, } from './loop.js';
+export type { CreateMcpToolsOptions, McpClientLike, McpServerConnection, McpServerOptions, McpToolDescriptor, McpTransport } from './mcp.js';
+export type { OpenTelemetryExporterOptions } from './otel.js';
+export type { TelemetryExporter, TelemetrySpan } from './telemetry.js';
+export type { StdioMcpClientOptions } from './mcp-stdio.js';
+export type { ModelAttemptEvent, ModelMessage, ModelMessageRole, ModelProvider, ModelRequest, ModelResponse, ModelRuntimeOptions, ModelToolCall, ModelToolSchema, ModelUsage, AnthropicProviderOptions, AzureOpenAIProviderOptions, BedrockProviderOptions, CohereProviderOptions, FallbackModelProviderOptions, GeminiProviderOptions, OpenAICompatibleProviderOptions, VertexAIProviderOptions, } from './model.js';
+export type { FabricSession } from './session.js';
+export { pruneSnapshots } from './sandbox.js';
+export type { DockerSandboxOptions, FileStat, LocalSandboxOptions, RemoteSandboxApi, RemoteSandboxOptions, SandboxAdapterDescriptor, SandboxCapabilities, SandboxEnv, SandboxExecOptions, SandboxFactory, SandboxFactoryOptions, SandboxSnapshot, SnapshotPruneOptions, SnapshotPruneResult, } from './sandbox.js';
+export type { ActorIdentity, AgentInit, ApprovalCallback, ApprovalDecision, ApprovalOptions, ApprovalRequest, ApprovalResponse, ApprovalState, ApprovalStateStatus, ApprovalUnavailableStrategy, ApprovalVote, ArtifactCreateOptions, ArtifactRef, AutonomyMode, AutonomyOptions, CheckpointCreateOptions, CheckpointRestoreOptions, CheckpointResult, CompactionOptions, CompactionResult, FabricActor, FabricAgent, FabricContext, FabricEvent, FabricEventCallback, FabricEventType, FabricRuntime, JsonObject, JsonPrimitive, JsonValue, CredentialMissingStrategy, MissingInputStrategy, PromptOptions, ResultExtractionOptions, ResultValidator, Role, SandboxBackend, SessionData, SessionEntry, SessionEntryType, SessionOptions, SessionStore, ShellOptions, ShellResult, Skill, SkillOptions, TaskOptions, } from './types.js';
+export type { BashInput, BuiltinFileTool, BuiltinTool, Command, CommandEnvValue, CommandToolInput, CommandToolOptions, EditInput, ExistsInput, GlobInput, GrepInput, GrepMatch, MkdirInput, ReadFileBufferInput, ReadFileInput, ReaddirInput, RmInput, SecretRef, StatInput, ToolCall, ToolCallResult, ToolContext, ToolDef, ToolEffect, WriteFileInput, } from './tools.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,25 @@
+export { init, StubFabricAgent } from './agent.js';
+export { agent, defineAgent, getAgentDefinition } from './agent-definition.js';
+export { resolveRuntimeMode, isStatelessRuntime, isInMemoryStore } from './runtime-mode.js';
+export { evaluateContextBudget, estimateModelMessagesTokens, estimateSessionEntriesTokens, estimateTextTokens, isContextOverflowError } from './context-budget.js';
+export { createFabricContext } from './context.js';
+export { FabricError, isFabricError, toFabricError } from './error.js';
+export { redactError, redactJson, redactText } from './redaction.js';
+export { DEFAULT_HEADLESS_PREAMBLE, SessionHistory, buildModelMessagesFromHistory } from './history.js';
+export { NativeLoopRuntime, defaultLoopRuntime } from './loop.js';
+export { connectMcpServer, createMcpTools } from './mcp.js';
+export { StdioMcpClient, createStdioMcpClient } from './mcp-stdio.js';
+export { AnthropicModelProvider, AzureOpenAIModelProvider, BedrockModelProvider, CohereModelProvider, FallbackModelProvider, GeminiModelProvider, MockModelProvider, OpenAICompatibleModelProvider, ProviderHttpError, VertexAIModelProvider, defaultModelProvider, generateWithRuntime, toolsToModelSchemas, } from './model.js';
+export { clampCommandTimeout, evaluateCommandPolicy, evaluateToolCallPolicy, } from './policy.js';
+export { parseModelRef, resolveModelProvider } from './providers.js';
+export { RESULT_END_DELIMITER, RESULT_START_DELIMITER, buildResultRetryPrompt, extractResultValue, validateResult } from './result.js';
+export { StubFabricSession } from './session.js';
+export { createRemoteSandboxEnv, createSandboxEnv, DockerSandboxEnv, EmptySandboxEnv, LocalSandboxEnv, UnimplementedSandboxEnv } from './sandbox.js';
+export { inMemorySource, localDirectorySource, withFilesystemSources } from './filesystem-source.js';
+export { SchemaValidationError, formatSchemaIssues, schema } from './schema.js';
+export { emitOpenTelemetrySpan, openTelemetryExporter } from './otel.js';
+export { consoleTelemetryExporter, entryToTelemetrySpan, eventToTelemetrySpan } from './telemetry.js';
+export { InMemorySessionStore, NoopSessionStore, approvalStatesFromEntries, defaultSessionStore, noopSessionStore } from './store.js';
+export { bashTool, createBuiltinTools, createCommandTools, createFileTools, defineCommand, defineTool, editFileTool, existsTool, globTool, grepTool, mkdirTool, readFileBufferTool, readFileTool, readdirTool, rmTool, secret, shellQuote, statTool, writeFileTool, } from './tools.js';
+export { pruneSnapshots } from './sandbox.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACnK,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAAE,6BAA6B,EAAE,MAAM,cAAc,CAAC;AACxG,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,6BAA6B,EAC7B,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACvI,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AACrJ,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAErG,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtG,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACtI,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,MAAM,EACN,MAAM,EACN,UAAU,EACV,QAAQ,EACR,aAAa,GACd,MAAM,YAAY,CAAC;AAwCpB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/lite.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @fabric-harness/sdk/lite — minimal headless surface.
+ *
+ * This entry point re-exports the small subset of the SDK needed to write
+ * a stateless / headless agent in ~10 lines. Nothing here pulls Temporal,
+ * persistent stores, telemetry exporters, or backend-specific code into
+ * the import graph. Use this when bundling for Cloudflare Workers, Vercel
+ * Edge, AWS Lambda, or any environment where you want the smallest
+ * possible import footprint.
+ *
+ * For the full surface (typed I/O schemas, capability policy,
+ * artifacts, durable runtime, custom session stores), import from
+ * `@fabric-harness/sdk` directly.
+ *
+ * ```ts
+ * import { defineAgent } from '@fabric-harness/sdk/lite';
+ *
+ * export default defineAgent(async ({ init, payload }) => {
+ *   const session = await (await init({
+ *     model: 'anthropic/claude-sonnet-4-6',
+ *     runtime: 'stateless',
+ *   })).session();
+ *   return { reply: (await session.prompt(String(payload?.message ?? ''))).text };
+ * });
+ * ```
+ */
+export { init, StubFabricAgent } from './agent.js';
+export { agent, defineAgent, getAgentDefinition } from './agent-definition.js';
+export { createFabricContext } from './context.js';
+export { FabricError, isFabricError, toFabricError } from './error.js';
+export { schema, SchemaValidationError } from './schema.js';
+export { defineCommand, defineTool, secret, shellQuote } from './tools.js';
+export { createSandboxEnv, EmptySandboxEnv, LocalSandboxEnv } from './sandbox.js';
+export { inMemorySource, localDirectorySource, withFilesystemSources } from './filesystem-source.js';
+export type { FilesystemEntry, FilesystemSource, MountedSource } from './filesystem-source.js';
+export { resolveRuntimeMode, isStatelessRuntime } from './runtime-mode.js';
+export { noopSessionStore, NoopSessionStore } from './store.js';
+export { connectMcpServer } from './mcp.js';
+export type { AgentDefinition, AgentTriggers, DefineAgentOptions, DefinedAgent } from './agent-definition.js';
+export type { Schema, SchemaIssue, JsonSchemaObject } from './schema.js';
+export type { Command, CommandEnvValue, SecretRef, ToolDef, } from './tools.js';
+export type { AgentInit, FabricAgent, FabricContext, FabricRuntime, JsonObject, JsonValue, PromptOptions, Role, SandboxBackend, SessionOptions, ShellOptions, ShellResult, Skill, SkillOptions, } from './types.js';
+export type { FabricSession } from './session.js';
+export type { SandboxEnv, SandboxFactory, SandboxFactoryOptions } from './sandbox.js';
+export type { ModelConfig, ProviderSettings, ProvidersConfig } from './providers.js';
+//# sourceMappingURL=lite.d.ts.map

package/dist/lite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lite.d.ts","sourceRoot":"","sources":["../src/lite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACrG,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC9G,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EACV,OAAO,EACP,eAAe,EACf,SAAS,EACT,OAAO,GACR,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,SAAS,EACT,WAAW,EACX,aAAa,EACb,aAAa,EACb,UAAU,EACV,SAAS,EACT,aAAa,EACb,IAAI,EACJ,cAAc,EACd,cAAc,EACd,YAAY,EACZ,WAAW,EACX,KAAK,EACL,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACtF,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/lite.js

@@ -0,0 +1,38 @@
+/**
+ * @fabric-harness/sdk/lite — minimal headless surface.
+ *
+ * This entry point re-exports the small subset of the SDK needed to write
+ * a stateless / headless agent in ~10 lines. Nothing here pulls Temporal,
+ * persistent stores, telemetry exporters, or backend-specific code into
+ * the import graph. Use this when bundling for Cloudflare Workers, Vercel
+ * Edge, AWS Lambda, or any environment where you want the smallest
+ * possible import footprint.
+ *
+ * For the full surface (typed I/O schemas, capability policy,
+ * artifacts, durable runtime, custom session stores), import from
+ * `@fabric-harness/sdk` directly.
+ *
+ * ```ts
+ * import { defineAgent } from '@fabric-harness/sdk/lite';
+ *
+ * export default defineAgent(async ({ init, payload }) => {
+ *   const session = await (await init({
+ *     model: 'anthropic/claude-sonnet-4-6',
+ *     runtime: 'stateless',
+ *   })).session();
+ *   return { reply: (await session.prompt(String(payload?.message ?? ''))).text };
+ * });
+ * ```
+ */
+export { init, StubFabricAgent } from './agent.js';
+export { agent, defineAgent, getAgentDefinition } from './agent-definition.js';
+export { createFabricContext } from './context.js';
+export { FabricError, isFabricError, toFabricError } from './error.js';
+export { schema, SchemaValidationError } from './schema.js';
+export { defineCommand, defineTool, secret, shellQuote } from './tools.js';
+export { createSandboxEnv, EmptySandboxEnv, LocalSandboxEnv } from './sandbox.js';
+export { inMemorySource, localDirectorySource, withFilesystemSources } from './filesystem-source.js';
+export { resolveRuntimeMode, isStatelessRuntime } from './runtime-mode.js';
+export { noopSessionStore, NoopSessionStore } from './store.js';
+export { connectMcpServer } from './mcp.js';
+//# sourceMappingURL=lite.js.map

package/dist/lite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lite.js","sourceRoot":"","sources":["../src/lite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAErG,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC"}

package/dist/loop.d.ts

@@ -0,0 +1,41 @@
+import type { ModelMessage, ModelProvider, ModelUsage } from './model.js';
+import type { CapabilityPolicy } from './policy.js';
+import type { SandboxEnv } from './sandbox.js';
+import type { ToolCall, ToolCallResult, ToolDef } from './tools.js';
+import type { FabricEvent, JsonObject, SessionEntry, SessionEntryType } from './types.js';
+export interface AgentLoopRuntime {
+    readonly name: string;
+    runPrompt(input: PromptRunInput): Promise<PromptRunResult>;
+}
+export interface PromptRunInput {
+    sessionId: string;
+    text: string;
+    messages: ModelMessage[];
+    tools: Map<string, ToolDef>;
+    sandbox: SandboxEnv;
+    model?: string;
+    modelProvider?: ModelProvider;
+    toolCalls?: ToolCall[];
+    maxIterations?: number;
+    modelTimeoutMs?: number;
+    modelRetries?: number;
+    modelRetryDelayMs?: number;
+    signal?: AbortSignal;
+    policy?: CapabilityPolicy;
+    approvalTimeoutMs?: number;
+    executeToolCalls(calls: ToolCall[], policy?: CapabilityPolicy, approvalTimeoutMs?: number): Promise<ToolCallResult[]>;
+    recordEntry(type: SessionEntryType, data?: JsonObject): Promise<SessionEntry>;
+    emit(type: FabricEvent['type'], data?: JsonObject): Promise<void>;
+}
+export interface PromptRunResult {
+    text: string;
+    raw: unknown;
+    usage?: ModelUsage;
+}
+export declare class NativeLoopRuntime implements AgentLoopRuntime {
+    readonly name = "native";
+    runPrompt(input: PromptRunInput): Promise<PromptRunResult>;
+    private executeModelToolCalls;
+}
+export declare const defaultLoopRuntime: NativeLoopRuntime;
+//# sourceMappingURL=loop.d.ts.map