@lloyal-labs/rig 2.1.0 → 3.0.1

package/dist/registry.js

@@ -0,0 +1,245 @@
+"use strict";
+/**
+ * `createAppRegistry` — harness-wide app registry with a **declarative**
+ * app set and structured, **isolated** per-app lifecycle.
+ *
+ * The harness declares its apps as factories; the registry owns the rest:
+ *
+ * - `createAppRegistry({ configStore, apps })` runs each factory in its own
+ *   **detached** Effection scope, seeded with the app-facing framework
+ *   contexts (`AppConfigStoreCtx`, `RerankerCtx`) so the factory
+ *   reads config + reranker. The factory body is setup; a `resource()`
+ *   factory's `ensure(...)` is teardown. The registry tears the scopes
+ *   down on its own scope exit, reverse register-order, **best-effort** —
+ *   a throwing teardown is logged but never strands a sibling, and never
+ *   crashes the harness. The harness does **not** call a per-app register
+ *   verb at boot.
+ * - `registry.enable(factory)` / `registry.disable(name)` handle the
+ *   genuine dynamic case (mid-session enable/disable). `enable` →
+ *   `'enabled'`, `disable` → `'disabled'` (matching {@link AppState}).
+ *   `disable` swallows + logs a throwing teardown, so a mid-session
+ *   uninstall can't crash the session — possible only because each app
+ *   owns a detached scope whose teardown errors don't propagate to a
+ *   parent.
+ *
+ * There are no install/uninstall/enable/disable hooks on the App. A
+ * factory that throws (or whose manifest fails validation) tears down its
+ * partial scope and propagates; the app never enters the registry.
+ * Per-app independent — one app's failure can't roll back another.
+ *
+ * @packageDocumentation
+ * @category Protocol
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAppRegistry = createAppRegistry;
+const effection_1 = require("effection");
+const lloyal_agents_1 = require("@lloyal-labs/lloyal-agents");
+const protocol_1 = require("./protocol");
+/**
+ * Create the harness-wide app registry.
+ *
+ * Sets `AppRegistryCtx` and `AppConfigStoreCtx` in the caller's scope (the
+ * `initAgents` pattern), enables each factory in `opts.apps`, and tears
+ * every enabled app's scope down on the caller's scope exit (reverse
+ * order, best-effort).
+ *
+ * @example
+ * ```ts
+ * import { createWebApp } from '@lloyal-labs/web-app';
+ * import { createCorpusApp } from '@lloyal-labs/corpus-app';
+ * import { createJiraApp } from '@lloyal-labs/jira-app';
+ *
+ * yield* RerankerCtx.set(reranker);          // before, if factories read it
+ * const registry = yield* createAppRegistry({
+ *   configStore,
+ *   apps: [createWebApp, createCorpusApp, createJiraApp],
+ * });
+ * // ... pool dispatch ...
+ * // registry scope exit tears down every app (factory ensures fire)
+ * ```
+ */
+function* createAppRegistry(opts) {
+    const { configStore, grantStore, apps } = opts;
+    const entries = new Map();
+    const order = [];
+    const registry = {
+        byName(name) {
+            return entries.get(name)?.app;
+        },
+        enabled() {
+            return order.map((n) => entries.get(n).app).filter(Boolean);
+        },
+        stateOf(name) {
+            return entries.has(name) ? 'enabled' : 'disabled';
+        },
+        *enable(factory) {
+            // Read the app-facing framework contexts to seed into the app's
+            // detached scope (factories read config + reranker).
+            let reranker;
+            try {
+                reranker = yield* lloyal_agents_1.RerankerCtx.expect();
+            }
+            catch {
+                reranker = undefined;
+            }
+            const [scope, destroy] = (0, effection_1.createScope)();
+            let added = false;
+            try {
+                // Run the factory in a DETACHED scope (so its teardown errors stay
+                // isolated and swallowable), seeded with the framework contexts.
+                // It resolves the App out, then suspends — keeping the App and its
+                // ensure() teardown alive until `destroy()`.
+                const app = yield* (0, effection_1.call)(() => new Promise((resolve, reject) => {
+                    scope
+                        .run(function* () {
+                        try {
+                            yield* lloyal_agents_1.AppConfigStoreCtx.set(configStore);
+                            yield* lloyal_agents_1.AppRegistryCtx.set(registry);
+                            if (reranker !== undefined)
+                                yield* lloyal_agents_1.RerankerCtx.set(reranker);
+                            const constructed = yield* factory();
+                            resolve(constructed);
+                            yield* (0, effection_1.suspend)();
+                        }
+                        catch (err) {
+                            reject(err);
+                        }
+                    })
+                        .catch(() => {
+                        /* halt-after-resolve rejection — expected, ignore */
+                    });
+                }));
+                const declared = app.manifest.appProtocolVersion ?? '3.0';
+                if (!protocol_1.SUPPORTED_APP_PROTOCOL_VERSIONS.includes(declared)) {
+                    throw new Error(`App "${app.manifest.name}" declares appProtocolVersion="${declared}", ` +
+                        `but the framework supports [${protocol_1.SUPPORTED_APP_PROTOCOL_VERSIONS.map((v) => `"${v}"`).join(', ')}]. ` +
+                        `Upgrade the app or use a framework version that supports this protocol.`);
+                }
+                const existingConfig = yield* configStore.get(app.manifest.name);
+                if (existingConfig !== undefined && app.manifest.configSchema) {
+                    validateConfigShape(app.manifest.name, existingConfig, app.manifest.configSchema);
+                }
+                if (entries.has(app.manifest.name)) {
+                    throw new Error(`App "${app.manifest.name}" is already enabled. ` +
+                        `Call registry.disable("${app.manifest.name}") first to replace it.`);
+                }
+                entries.set(app.manifest.name, { app, destroy });
+                order.push(app.manifest.name);
+                added = true;
+                return app;
+            }
+            finally {
+                // Factory threw, validation failed, or the caller was halted before
+                // the app entered the registry → tear down its detached scope
+                // (best-effort; don't mask the original error).
+                if (!added) {
+                    try {
+                        yield* (0, effection_1.call)(() => destroy());
+                    }
+                    catch {
+                        /* teardown error on the failure path — original error wins */
+                    }
+                }
+            }
+        },
+        *disable(name) {
+            const entry = entries.get(name);
+            if (!entry)
+                return;
+            entries.delete(name);
+            const idx = order.indexOf(name);
+            if (idx >= 0)
+                order.splice(idx, 1);
+            try {
+                yield* (0, effection_1.call)(() => entry.destroy());
+            }
+            catch (err) {
+                console.error(`[lloyal-rig] teardown for app "${name}" threw during disable — app removed regardless:`, err);
+            }
+        },
+    };
+    yield* lloyal_agents_1.AppRegistryCtx.set(registry);
+    yield* lloyal_agents_1.AppConfigStoreCtx.set(configStore);
+    // Seed the grant store so the agent pool's authGuard can
+    // read the session's protected-tool grants. Absent = fail-closed.
+    if (grantStore)
+        yield* lloyal_agents_1.GrantStoreCtx.set(grantStore);
+    // Tear down every still-enabled app on registry scope exit, reverse
+    // register-order, best-effort (a throwing teardown is logged, never
+    // strands a sibling, never crashes the harness). Registered before the
+    // boot set so a mid-boot failure still cleans up the apps that enabled.
+    yield* (0, effection_1.ensure)(function* () {
+        for (let i = order.length - 1; i >= 0; i--) {
+            const name = order[i];
+            const entry = entries.get(name);
+            if (!entry)
+                continue;
+            try {
+                yield* (0, effection_1.call)(() => entry.destroy());
+            }
+            catch (err) {
+                console.error(`[lloyal-rig] teardown for app "${name}" threw — continuing teardown:`, err);
+            }
+        }
+        entries.clear();
+        order.length = 0;
+    });
+    if (apps) {
+        for (const factory of apps) {
+            yield* registry.enable(factory);
+        }
+    }
+    return registry;
+}
+// ── Helpers ───────────────────────────────────────────────────────
+/**
+ * Minimal structural schema check. Validates that every property in
+ * `schema.required` exists on `config` with a type compatible with
+ * `schema.properties[name].type`. This is a guardrail — the framework
+ * does not ship a full JSON Schema validator. Apps requiring richer
+ * validation should run their own check in the factory body.
+ */
+function validateConfigShape(appName, config, schema) {
+    if (schema.type && schema.type !== 'object') {
+        return; // non-object schemas are out of scope for the guardrail
+    }
+    for (const key of schema.required ?? []) {
+        if (!(key in config)) {
+            throw new Error(`App "${appName}" stored config is missing required key "${key}" ` +
+                `declared in manifest.configSchema. Re-run the app's config flow or clear stale config.`);
+        }
+    }
+    for (const [key, rawPropSchema] of Object.entries(schema.properties ?? {})) {
+        if (!(key in config))
+            continue;
+        const propSchema = rawPropSchema;
+        if (!propSchema || typeof propSchema.type !== 'string')
+            continue;
+        const value = config[key];
+        if (!matchesPrimitiveType(value, propSchema.type)) {
+            throw new Error(`App "${appName}" stored config key "${key}" has type "${typeof value}" ` +
+                `but manifest.configSchema declares "${propSchema.type}". ` +
+                `Re-run the app's config flow or clear stale config.`);
+        }
+    }
+}
+function matchesPrimitiveType(value, declared) {
+    switch (declared) {
+        case 'string':
+            return typeof value === 'string';
+        case 'number':
+        case 'integer':
+            return typeof value === 'number';
+        case 'boolean':
+            return typeof value === 'boolean';
+        case 'array':
+            return Array.isArray(value);
+        case 'object':
+            return typeof value === 'object' && value !== null && !Array.isArray(value);
+        case 'null':
+            return value === null;
+        default:
+            return true;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/reranker.d.ts

@@ -1,17 +1,35 @@
-import type { Reranker } from "./tools/types";
+import type { Operation } from "effection";
+import type { Reranker } from "@lloyal-labs/lloyal-agents";
 /**
- * Create a {@link Reranker} backed by a dedicated reranking model context
+ * Create a {@link Reranker} backed by a dedicated reranking model context,
+ * as an Effection `resource()`.
  *
  * Loads a separate model (typically a cross-encoder) into its own KV cache
- * and exposes `score`, `tokenizeChunks`, and `dispose` methods. The returned
- * `score` method yields {@link ScoredResult} batches as an async iterable,
- * mapping raw indices back to the original {@link Chunk} metadata.
+ * and exposes `score`, `scoreBatch`, `tokenizeChunks`, and `dispose`. The
+ * returned `score` method yields {@link ScoredResult} batches as an async
+ * iterable, mapping raw indices back to the original {@link Chunk} metadata.
+ *
+ * **Lifecycle.** The reranker owns its underlying `SessionContext` + `Rerank`
+ * and disposes them transitively when the yielding scope exits (success,
+ * error, or halt). The harness yields it once per process lifecycle and
+ * publishes it on `RerankerCtx` so App factories can read it via
+ * `RerankerCtx.expect()`. `dispose()` remains on the interface
+ * for callers that manage teardown explicitly; it is idempotent so the
+ * resource finally and an explicit call don't double-free.
  *
  * @param modelPath - Absolute path to the reranking model file (GGUF)
  * @param opts - Optional context sizing overrides
  * @param opts.nSeqMax - Maximum parallel scoring sequences (default 8)
  * @param opts.nCtx - Context window size for the reranker model (default 4096)
- * @returns A ready-to-use reranker instance; call `dispose()` when finished
+ * @returns An Effection resource yielding a ready-to-use reranker
+ *
+ * @example
+ * ```ts
+ * const reranker = yield* createReranker(rerankerPath, { nSeqMax: 8, nCtx: 4096 });
+ * yield* RerankerCtx.set(reranker);
+ * // ... pool work ...
+ * // reranker disposes automatically on scope exit
+ * ```
  *
  * @category Rig
  */
@@ -19,5 +37,5 @@ export declare function createReranker(modelPath: string, opts?: {
     nSeqMax?: number;
     nCtx?: number;
     nBatch?: number;
-}): Promise<Reranker>;
+}): Operation<Reranker>;
 //# sourceMappingURL=reranker.d.ts.map

package/dist/reranker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reranker.d.ts","sourceRoot":"","sources":["../src/reranker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAgB,MAAM,eAAe,CAAC;AAE5D;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,OAAO,CAAC,QAAQ,CAAC,CAoEnB"}
+{"version":3,"file":"reranker.d.ts","sourceRoot":"","sources":["../src/reranker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAS,QAAQ,EAAgB,MAAM,4BAA4B,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,SAAS,CAAC,QAAQ,CAAC,CA4FrB"}

package/dist/reranker.js

@@ -3,81 +3,121 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createReranker = createReranker;
 const lloyal_node_1 = require("@lloyal-labs/lloyal.node");
 const sdk_1 = require("@lloyal-labs/sdk");
+const effection_1 = require("effection");
 /**
- * Create a {@link Reranker} backed by a dedicated reranking model context
+ * Create a {@link Reranker} backed by a dedicated reranking model context,
+ * as an Effection `resource()`.
  *
  * Loads a separate model (typically a cross-encoder) into its own KV cache
- * and exposes `score`, `tokenizeChunks`, and `dispose` methods. The returned
- * `score` method yields {@link ScoredResult} batches as an async iterable,
- * mapping raw indices back to the original {@link Chunk} metadata.
+ * and exposes `score`, `scoreBatch`, `tokenizeChunks`, and `dispose`. The
+ * returned `score` method yields {@link ScoredResult} batches as an async
+ * iterable, mapping raw indices back to the original {@link Chunk} metadata.
+ *
+ * **Lifecycle.** The reranker owns its underlying `SessionContext` + `Rerank`
+ * and disposes them transitively when the yielding scope exits (success,
+ * error, or halt). The harness yields it once per process lifecycle and
+ * publishes it on `RerankerCtx` so App factories can read it via
+ * `RerankerCtx.expect()`. `dispose()` remains on the interface
+ * for callers that manage teardown explicitly; it is idempotent so the
+ * resource finally and an explicit call don't double-free.
  *
  * @param modelPath - Absolute path to the reranking model file (GGUF)
  * @param opts - Optional context sizing overrides
  * @param opts.nSeqMax - Maximum parallel scoring sequences (default 8)
  * @param opts.nCtx - Context window size for the reranker model (default 4096)
- * @returns A ready-to-use reranker instance; call `dispose()` when finished
+ * @returns An Effection resource yielding a ready-to-use reranker
+ *
+ * @example
+ * ```ts
+ * const reranker = yield* createReranker(rerankerPath, { nSeqMax: 8, nCtx: 4096 });
+ * yield* RerankerCtx.set(reranker);
+ * // ... pool work ...
+ * // reranker disposes automatically on scope exit
+ * ```
  *
  * @category Rig
  */
-async function createReranker(modelPath, opts) {
-    const nSeqMax = opts?.nSeqMax ?? 8;
-    const nCtx = opts?.nCtx ?? 4096;
-    const nBatch = opts?.nBatch ?? Math.floor(nCtx / nSeqMax);
-    const ctx = await (0, lloyal_node_1.createContext)({
-        modelPath,
-        nCtx,
-        nSeqMax,
-        nBatch,
-        typeK: 'q4_0',
-        typeV: 'q4_0',
-    });
-    const rerank = await sdk_1.Rerank.create(ctx, { nSeqMax, nCtx });
-    return {
-        score(query, chunks) {
-            const inner = rerank.score(query, chunks.map((c) => c.tokens), 10);
-            return {
-                [Symbol.asyncIterator]() {
-                    const it = inner[Symbol.asyncIterator]();
-                    return {
-                        async next() {
-                            const { value, done } = await it.next();
-                            if (done)
+function createReranker(modelPath, opts) {
+    return (0, effection_1.resource)(function* (provide) {
+        // Default bumped 8→10: warm-trunk + per-query branch consume 2 leases in
+        // the R3 Rerank composition, so leaves get N-2 slots; 10 keeps the leaf
+        // budget at the prior default of 8.
+        const nSeqMax = opts?.nSeqMax ?? 10;
+        const nCtx = opts?.nCtx ?? 4096;
+        const nBatch = opts?.nBatch ?? Math.floor(nCtx / nSeqMax);
+        const ctx = yield* (0, effection_1.call)(() => (0, lloyal_node_1.createContext)({
+            modelPath,
+            nCtx,
+            nSeqMax,
+            nBatch,
+            typeK: 'q4_0',
+            typeV: 'q4_0',
+        }));
+        const rerank = yield* (0, effection_1.call)(() => sdk_1.Rerank.create(ctx, { nSeqMax, nCtx }));
+        let disposed = false;
+        const reranker = {
+            score(query, chunks) {
+                const inner = rerank.score(query, chunks.map((c) => c.tokens), 10);
+                return {
+                    [Symbol.asyncIterator]() {
+                        const it = inner[Symbol.asyncIterator]();
+                        return {
+                            async next() {
+                                const { value, done } = await it.next();
+                                if (done)
+                                    return {
+                                        value: undefined,
+                                        done: true,
+                                    };
                                 return {
-                                    value: undefined,
-                                    done: true,
+                                    value: {
+                                        filled: value.filled,
+                                        total: value.total,
+                                        results: value.results.map((r) => ({
+                                            file: chunks[r.index].resource,
+                                            heading: chunks[r.index].heading,
+                                            section: chunks[r.index].section,
+                                            snippet: chunks[r.index].text.slice(0, 200),
+                                            score: r.score,
+                                            startLine: chunks[r.index].startLine,
+                                            endLine: chunks[r.index].endLine,
+                                        })),
+                                    },
+                                    done: false,
                                 };
-                            return {
-                                value: {
-                                    filled: value.filled,
-                                    total: value.total,
-                                    results: value.results.map((r) => ({
-                                        file: chunks[r.index].resource,
-                                        heading: chunks[r.index].heading,
-                                        section: chunks[r.index].section,
-                                        snippet: chunks[r.index].text.slice(0, 200),
-                                        score: r.score,
-                                        startLine: chunks[r.index].startLine,
-                                        endLine: chunks[r.index].endLine,
-                                    })),
-                                },
-                                done: false,
-                            };
-                        },
-                    };
-                },
-            };
-        },
-        scoreBatch(query, texts) {
-            return rerank.scoreBatch(query, texts);
-        },
-        async tokenizeChunks(chunks) {
-            for (const chunk of chunks) {
-                chunk.tokens = await rerank.tokenize(chunk.text);
-            }
-        },
-        dispose() {
-            rerank.dispose();
-        },
-    };
+                            },
+                        };
+                    },
+                };
+            },
+            scoreBatch(query, texts) {
+                return rerank.scoreBatch(query, texts);
+            },
+            tokenize(text) {
+                return rerank.tokenize(text);
+            },
+            async tokenizeChunks(chunks) {
+                // Tokenize in parallel — _tokenize is N-API AsyncWorker dispatch, so
+                // Promise.all overlaps work across threadpool slots. Serial for-await
+                // was a bottleneck on large corpora (1000+ chunks).
+                const toks = await Promise.all(chunks.map((c) => rerank.tokenize(c.text)));
+                for (let i = 0; i < chunks.length; i++) {
+                    chunks[i].tokens = toks[i];
+                }
+            },
+            dispose() {
+                if (disposed)
+                    return;
+                disposed = true;
+                rerank.dispose();
+            },
+        };
+        try {
+            yield* provide(reranker);
+        }
+        finally {
+            reranker.dispose();
+        }
+    });
 }
 //# sourceMappingURL=reranker.js.map

package/dist/reranker.js.map

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

package/dist/resources/types.d.ts

@@ -1,41 +1,14 @@
 /**
- * A loaded document available for search, read, and grep operations
- *
- * Represents a single file (typically Markdown) loaded into memory.
- * Resources are chunked into {@link Chunk} instances for reranking.
- *
- * @category Rig
- */
-export interface Resource {
-    /** File name (basename, not full path) used as the resource identifier */
-    name: string;
-    /** Full text content of the file */
-    content: string;
-}
-/**
- * A scored passage within a {@link Resource}, used for reranking and retrieval
- *
- * Chunks are produced by {@link chunkResources} (section-based for Markdown)
- * or {@link chunkFetchedPages} (paragraph-based for web content). The
- * {@link tokens} array is populated lazily by {@link Reranker.tokenizeChunks}
- * before scoring.
- *
+ * @deprecated `Resource` and `Chunk` now live in
+ * `@lloyal-labs/lloyal-agents` (abstract chunking types
+ * moved to agents to mirror the `Source` / `Tool` pattern: abstract
+ * types in agents, concrete chunking factories in rig). This module
+ * re-exports them so existing rig internal callers keep working
+ * during the Phase 3-6 refactor window; new code should import
+ * directly from `@lloyal-labs/lloyal-agents`.
+ *
+ * @packageDocumentation
  * @category Rig
  */
-export interface Chunk {
-    /** Resource identifier (file name or URL) this chunk belongs to */
-    resource: string;
-    /** Leaf section heading (e.g. "Recovery loop") */
-    heading: string;
-    /** Hierarchical section path (e.g. "Agents > Lifecycle > Recovery loop"). Empty for web chunks. */
-    section: string;
-    /** Raw text content of the chunk */
-    text: string;
-    /** Pre-tokenized representation for the reranker — empty until {@link Reranker.tokenizeChunks} runs */
-    tokens: number[];
-    /** First line number (1-based) in the source resource */
-    startLine: number;
-    /** Last line number (1-based) in the source resource */
-    endLine: number;
-}
+export type { Resource, Chunk } from '@lloyal-labs/lloyal-agents';
 //# sourceMappingURL=types.d.ts.map

package/dist/resources/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/resources/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACvB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,KAAK;IACpB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,mGAAmG;IACnG,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,uGAAuG;IACvG,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/resources/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/resources/types.js

@@ -1,3 +1,15 @@
 "use strict";
+/**
+ * @deprecated `Resource` and `Chunk` now live in
+ * `@lloyal-labs/lloyal-agents` (abstract chunking types
+ * moved to agents to mirror the `Source` / `Tool` pattern: abstract
+ * types in agents, concrete chunking factories in rig). This module
+ * re-exports them so existing rig internal callers keep working
+ * during the Phase 3-6 refactor window; new code should import
+ * directly from `@lloyal-labs/lloyal-agents`.
+ *
+ * @packageDocumentation
+ * @category Rig
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=types.js.map

package/dist/resources/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/resources/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/resources/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG"}