@nodetool-ai/agents 0.7.0-rc.23 → 0.8.2

package/dist/capabilities/entities.specs.js

@@ -0,0 +1,247 @@
+/**
+ * The `entities` module's specs — data only, no implementation.
+ *
+ * The registry's eager spec table imports this file and never `entities.ts`,
+ * so the models package the implementation reads stays out of the entry graph.
+ */
+export const DEFAULT_LIMIT = 100;
+export const MAX_LIMIT = 500;
+const KIND_PROPERTY = {
+    type: "string",
+    enum: ["character", "location", "style", "prop"],
+    description: "The kind of entity."
+};
+export const LIST_ENTITIES_SCHEMA = {
+    type: "object",
+    properties: {
+        kind: {
+            ...KIND_PROPERTY,
+            description: "Only entities of this kind. Omit for all of them."
+        },
+        query: {
+            type: "string",
+            description: "Only entities whose name or descriptor contains this text " +
+                "(case-insensitive)."
+        },
+        project_id: {
+            type: "string",
+            description: "Only entities belonging to this project. Omit for the whole library " +
+                "— entities are reusable across projects, so seasoning a prompt " +
+                "normally wants all of them."
+        },
+        limit: {
+            type: "number",
+            description: `Max entities to return (default ${DEFAULT_LIMIT}, max ${MAX_LIMIT}).`
+        }
+    }
+};
+export const listEntitiesSpec = {
+    name: "list_entities",
+    description: "List the reusable production entities (characters, locations, styles, " +
+        "props) in the ingredients library, with each one's id, name, kind and " +
+        "descriptor. Entities are what hold a character or a look steady across " +
+        "shots; pass their ids to apply_entities, or their names into prompt text.",
+    inputSchema: LIST_ENTITIES_SCHEMA,
+    category: "read",
+    userMessage: (params) => params["kind"]
+        ? `Listing ${String(params["kind"])} entities`
+        : "Listing entities"
+};
+export const GET_ENTITY_SCHEMA = {
+    type: "object",
+    properties: {
+        entity_id: {
+            type: "string",
+            description: "The entity's id (its asset id), from list_entities."
+        }
+    },
+    required: ["entity_id"]
+};
+export const getEntitySpec = {
+    name: "get_entity",
+    description: "Read one entity in full: its kind, name, descriptor, longer " +
+        "description, tags, reference images, and the kind-specific fields " +
+        "(a character's voice, a style's palette, a trained LoRA).",
+    inputSchema: GET_ENTITY_SCHEMA,
+    category: "read",
+    userMessage: (params) => `Reading entity ${String(params["entity_id"])}`
+};
+export const APPLY_ENTITIES_SCHEMA = {
+    type: "object",
+    properties: {
+        text: {
+            type: "string",
+            description: "The base prompt to season. Empty text applies every entity."
+        },
+        entity_ids: {
+            type: "array",
+            items: { type: "string" },
+            description: "Apply exactly these entities. Without ids, entities whose name " +
+                "appears in the text apply."
+        }
+    },
+    required: ["text"]
+};
+export const applyEntitiesSpec = {
+    name: "apply_entities",
+    description: "Paste entity descriptors into a prompt for cross-shot consistency, and " +
+        "return the augmented prompt plus the asset ids of the entities' " +
+        "reference images to pass to an image model. Pass `entity_ids` to apply a " +
+        "specific selection; without them, entities whose name appears in the " +
+        "text apply (all of them when the text is empty). Same rule the browser's " +
+        "ui_entity_apply and the ApplyEntities node use.",
+    inputSchema: APPLY_ENTITIES_SCHEMA,
+    category: "read",
+    userMessage: () => "Applying entities to a prompt"
+};
+export const CREATE_ENTITY_SCHEMA = {
+    type: "object",
+    properties: {
+        asset_id: {
+            type: "string",
+            description: "The image asset to tag as the entity's reference — generate or save " +
+                "it first (e.g. with generate_image), then tag it here."
+        },
+        kind: KIND_PROPERTY,
+        name: {
+            type: "string",
+            description: "Display name. Shot text referencing this name pulls the descriptor in."
+        },
+        descriptor: {
+            type: "string",
+            description: "The canonical visual description pasted into every prompt that uses " +
+                "this entity — keep it specific enough to hold one look across shots."
+        },
+        description: {
+            type: "string",
+            description: "Longer free-form notes. Not injected into prompts."
+        },
+        voice_id: {
+            type: ["string", "null"],
+            description: "Character voice id for TTS, when kind is character."
+        },
+        tags: {
+            type: "array",
+            items: { type: "string" },
+            description: "Optional labels for filtering the library."
+        },
+        lora: {
+            type: ["object", "null"],
+            description: "Optional trained LoRA ref ({url?, asset_id?, scale?}) for a character " +
+                "or style."
+        },
+        palette: {
+            type: ["array", "null"],
+            description: "Style palette as name+hex swatches ({name?, hex}), when kind is style."
+        },
+        project_id: {
+            type: "string",
+            description: "The project the entity belongs to. Omit inside a project and it " +
+                "joins that one — pass an id only to file it somewhere else."
+        }
+    },
+    required: ["asset_id", "kind", "name", "descriptor"]
+};
+export const createEntitySpec = {
+    name: "create_entity",
+    description: "Add an image asset to the ingredients library as an entity (character, " +
+        "location, style, or prop). The asset keeps its bytes; this writes the " +
+        "entity marker onto it, exactly what the browser's Save Entity does. The " +
+        "asset must be yours and must be an image, and must not already be an " +
+        "entity — update_entity edits the one that is already there. Created " +
+        "inside a project, the entity joins that project and shows up in its " +
+        "documents.",
+    inputSchema: CREATE_ENTITY_SCHEMA,
+    category: "write",
+    userMessage: (params) => `Creating ${String(params["kind"] ?? "")} entity ${String(params["name"] ?? "")}`.trim()
+};
+export const UPDATE_ENTITY_SCHEMA = {
+    type: "object",
+    properties: {
+        entity_id: {
+            type: "string",
+            description: "The entity's id (its asset id), from list_entities."
+        },
+        asset_id: {
+            type: ["string", "null"],
+            description: "Swap the entity's picture for a different image asset. The new asset " +
+                "must be yours and must be an image; the entity keeps its id, so every " +
+                "board and script that cast it still resolves. Pass null (or the " +
+                "entity's own id) to go back to its original image. Omit to leave the " +
+                "picture alone."
+        },
+        kind: {
+            ...KIND_PROPERTY,
+            description: "New kind. Only the kinds change; pass to reclassify."
+        },
+        name: { type: "string", description: "New display name." },
+        descriptor: { type: "string", description: "New canonical visual descriptor." },
+        description: {
+            type: "string",
+            description: "New longer notes. Not injected into prompts."
+        },
+        voice_id: {
+            type: ["string", "null"],
+            description: "New character voice id, or null to clear it."
+        },
+        tags: {
+            type: ["array", "null"],
+            description: "Replacement labels, or null to clear them."
+        },
+        lora: {
+            type: ["object", "null"],
+            description: "Replacement LoRA ref, or null to clear it."
+        },
+        palette: {
+            type: ["array", "null"],
+            description: "Replacement style palette, or null to clear it."
+        },
+        project_id: {
+            type: "string",
+            description: "Move the entity into this project. Pass \"default\" to take it out " +
+                "of every project. Omit to leave its project alone."
+        }
+    },
+    required: ["entity_id"]
+};
+export const updateEntitySpec = {
+    name: "update_entity",
+    description: "Change an existing entity's fields — kind, name, descriptor, notes, " +
+        "voice, tags, LoRA, palette, project via project_id, or the picture it " +
+        "shows via asset_id. Only the fields you pass change. Swapping the " +
+        "picture keeps the entity's id, so nothing that already cast it has to " +
+        "be re-pointed.",
+    inputSchema: UPDATE_ENTITY_SCHEMA,
+    category: "write",
+    userMessage: (params) => `Updating entity ${String(params["entity_id"])}`
+};
+export const DELETE_ENTITY_SCHEMA = {
+    type: "object",
+    properties: {
+        entity_id: {
+            type: "string",
+            description: "The entity's id (its asset id), from list_entities."
+        }
+    },
+    required: ["entity_id"]
+};
+export const deleteEntitySpec = {
+    name: "delete_entity",
+    description: "Remove an entity from the ingredients library. The underlying image " +
+        "asset stays intact — only the entity marker is cleared, exactly what the " +
+        "browser's Remove does. Linked script speakers keep their entityId until " +
+        "you clear it with edit_script; they just read as dangling.",
+    inputSchema: DELETE_ENTITY_SCHEMA,
+    category: "write",
+    userMessage: (params) => `Removing entity ${String(params["entity_id"])}`
+};
+/** Every spec this module declares, in declaration order. */
+export const entitiesSpecs = [
+    listEntitiesSpec,
+    getEntitySpec,
+    applyEntitiesSpec,
+    createEntitySpec,
+    updateEntitySpec,
+    deleteEntitySpec
+];
+//# sourceMappingURL=entities.specs.js.map

package/dist/capabilities/entities.specs.js.map

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

package/dist/capabilities/errors.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The `errors` capability module: read the caller's redacted error traces
+ * from `nodetool_error_traces` and render them for a bug report.
+ *
+ * Every read is scoped to the run's user id. Redaction happened before the
+ * rows were stored (`@nodetool-ai/models` `redactErrorTrace`), so what these
+ * return is safe to show the model and to paste into an issue.
+ * `@nodetool-ai/models` is imported inside each implementation, so loading
+ * this module costs nothing.
+ */
+import type { CapabilityExport, CapabilityModule } from "./types.js";
+declare const listErrorTraces: CapabilityExport;
+declare const getErrorTrace: CapabilityExport;
+declare const exportErrorReport: CapabilityExport;
+/** Every error-trace capability, in declaration order. */
+export declare const ERROR_CAPABILITIES: readonly CapabilityExport[];
+export declare const module: CapabilityModule;
+export { listErrorTraces, getErrorTrace, exportErrorReport };
+//# sourceMappingURL=errors.d.ts.map

package/dist/capabilities/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/capabilities/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAoBrE,QAAA,MAAM,eAAe,EAAE,gBA2BtB,CAAC;AAEF,QAAA,MAAM,aAAa,EAAE,gBAiBpB,CAAC;AAEF,QAAA,MAAM,iBAAiB,EAAE,gBA2BxB,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,EAAE,SAAS,gBAAgB,EAIzD,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/capabilities/errors.js

@@ -0,0 +1,109 @@
+/**
+ * The `errors` capability module: read the caller's redacted error traces
+ * from `nodetool_error_traces` and render them for a bug report.
+ *
+ * Every read is scoped to the run's user id. Redaction happened before the
+ * rows were stored (`@nodetool-ai/models` `redactErrorTrace`), so what these
+ * return is safe to show the model and to paste into an issue.
+ * `@nodetool-ai/models` is imported inside each implementation, so loading
+ * this module costs nothing.
+ */
+import { userIdOf } from "../tools/mcp-tool-support.js";
+import { exportErrorReportSpec, getErrorTraceSpec, listErrorTracesSpec } from "./errors.specs.js";
+import { isString } from "../utils/type-guards.js";
+const MAX_LIMIT = 200;
+const MAX_REPORT_TRACES = 50;
+function limitOf(value, fallback, max) {
+    const n = Number(value ?? fallback);
+    return Number.isFinite(n) ? Math.min(Math.max(1, Math.floor(n)), max) : fallback;
+}
+function optionalString(value) {
+    return isString(value) && value.trim() ? value.trim() : undefined;
+}
+const listErrorTraces = {
+    spec: listErrorTracesSpec,
+    impl: async (run, params) => {
+        const models = await import("@nodetool-ai/models");
+        const userId = userIdOf(run.context);
+        const since = optionalString(params["since"]);
+        const limit = limitOf(params["limit"], 20, MAX_LIMIT);
+        const source = optionalString(params["source"]);
+        if (source && !models.isErrorTraceSource(source)) {
+            return { error: `Unknown source "${source}".` };
+        }
+        const fingerprint = optionalString(params["fingerprint"]);
+        if (params["grouped"] !== false && !fingerprint && !source) {
+            const groups = await models.summarizeErrorTraces(userId, { since, limit });
+            return { groups };
+        }
+        const traces = await models.listErrorTraces(userId, {
+            since,
+            limit,
+            fingerprint,
+            source: source && models.isErrorTraceSource(source) ? source : undefined
+        });
+        // A listing omits stacks; get_error_trace reads one in full.
+        return {
+            traces: traces.map(({ stack: _stack, user_id: _user, ...rest }) => rest)
+        };
+    }
+};
+const getErrorTrace = {
+    spec: getErrorTraceSpec,
+    impl: async (run, params) => {
+        const { getErrorTrace: find } = await import("@nodetool-ai/models");
+        const id = String(params["trace_id"] ?? "");
+        const result = await find(userIdOf(run.context), id);
+        if (!result.ok) {
+            return {
+                error: result.reason === "ambiguous"
+                    ? `Trace id ${id} matches more than one trace; use the full id.`
+                    : `Error trace ${id} was not found.`
+            };
+        }
+        const { user_id: _user, ...trace } = result.trace;
+        return trace;
+    }
+};
+const exportErrorReport = {
+    spec: exportErrorReportSpec,
+    impl: async (run, params) => {
+        const models = await import("@nodetool-ai/models");
+        const userId = userIdOf(run.context);
+        const ids = Array.isArray(params["trace_ids"])
+            ? params["trace_ids"].filter(isString).slice(0, MAX_REPORT_TRACES)
+            : [];
+        let traces;
+        if (ids.length > 0) {
+            traces = [];
+            for (const id of ids) {
+                const result = await models.getErrorTrace(userId, id);
+                if (result.ok)
+                    traces.push(result.trace);
+            }
+        }
+        else {
+            traces = await models.listErrorTraces(userId, {
+                fingerprint: optionalString(params["fingerprint"]),
+                since: optionalString(params["since"]),
+                limit: limitOf(params["limit"], 10, MAX_REPORT_TRACES)
+            });
+        }
+        return {
+            markdown: models.formatErrorReport(traces),
+            trace_ids: traces.map((trace) => trace.id)
+        };
+    }
+};
+/** Every error-trace capability, in declaration order. */
+export const ERROR_CAPABILITIES = [
+    listErrorTraces,
+    getErrorTrace,
+    exportErrorReport
+];
+export const module = {
+    module: "errors",
+    exports: ERROR_CAPABILITIES
+};
+export { listErrorTraces, getErrorTrace, exportErrorReport };
+//# sourceMappingURL=errors.js.map

package/dist/capabilities/errors.js.map

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

package/dist/capabilities/errors.specs.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The `errors` module's specs — data only, no implementation. See
+ * `jobs.specs.ts` for why specs live apart from their implementations.
+ */
+import type { CapabilitySpec } from "./types.js";
+export declare const listErrorTracesSpec: CapabilitySpec;
+export declare const getErrorTraceSpec: CapabilitySpec;
+export declare const exportErrorReportSpec: CapabilitySpec;
+/** Every spec this module declares, in declaration order. */
+export declare const errorsSpecs: readonly CapabilitySpec[];
+//# sourceMappingURL=errors.specs.d.ts.map

package/dist/capabilities/errors.specs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.specs.d.ts","sourceRoot":"","sources":["../../src/capabilities/errors.specs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,eAAO,MAAM,mBAAmB,EAAE,cAwCjC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAe/B,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,cAiCnC,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,WAAW,EAAE,SAAS,cAAc,EAIhD,CAAC"}

package/dist/capabilities/errors.specs.js

@@ -0,0 +1,100 @@
+/**
+ * The `errors` module's specs — data only, no implementation. See
+ * `jobs.specs.ts` for why specs live apart from their implementations.
+ */
+const SOURCES = ["server", "trpc", "http", "job", "web", "electron", "agent", "cli"];
+export const listErrorTracesSpec = {
+    name: "list_error_traces",
+    description: "List the user's recorded error traces: server failures, failed " +
+        "workflow runs and client crashes. Traces are redacted before storage " +
+        "(no credentials, emails, IPs or prompt content). By default returns " +
+        "groups of identical errors (by fingerprint) with counts and first/last " +
+        "seen; pass grouped=false for individual traces, newest first. Use " +
+        "get_error_trace for the full stack.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            grouped: {
+                type: "boolean",
+                description: "Group identical errors by fingerprint",
+                default: true
+            },
+            since: {
+                type: "string",
+                description: "Only traces at or after this ISO-8601 time"
+            },
+            source: {
+                type: "string",
+                enum: SOURCES,
+                description: "Only traces from this source"
+            },
+            fingerprint: {
+                type: "string",
+                description: "Only occurrences of this error group"
+            },
+            limit: {
+                type: "number",
+                description: "Maximum groups or traces to return",
+                default: 20
+            }
+        },
+        required: []
+    },
+    category: "read",
+    userMessage: () => "Listing error traces"
+};
+export const getErrorTraceSpec = {
+    name: "get_error_trace",
+    description: "Get one redacted error trace with its stack and context (job, " +
+        "workflow, route, HTTP status). Accepts the full id or its 12-character " +
+        "prefix.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            trace_id: { type: "string", description: "The trace id" }
+        },
+        required: ["trace_id"]
+    },
+    category: "read",
+    userMessage: (params) => `Getting error trace ${params["trace_id"]}`
+};
+export const exportErrorReportSpec = {
+    name: "export_error_report",
+    description: "Render redacted error traces as Markdown for a bug report. Name traces " +
+        "by id, or select one error group by fingerprint, or everything since a " +
+        "time; with none of these, the most recent traces. Returns the Markdown " +
+        "and the trace ids it covers.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            trace_ids: {
+                type: "array",
+                items: { type: "string" },
+                description: "Trace ids (full or 12-character prefix)"
+            },
+            fingerprint: {
+                type: "string",
+                description: "Every recent occurrence of this error group"
+            },
+            since: {
+                type: "string",
+                description: "Only traces at or after this ISO-8601 time"
+            },
+            limit: {
+                type: "number",
+                description: "Maximum traces in the report",
+                default: 10
+            }
+        },
+        required: []
+    },
+    category: "read",
+    userMessage: () => "Exporting an error report"
+};
+/** Every spec this module declares, in declaration order. */
+export const errorsSpecs = [
+    listErrorTracesSpec,
+    getErrorTraceSpec,
+    exportErrorReportSpec
+];
+//# sourceMappingURL=errors.specs.js.map

package/dist/capabilities/errors.specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.specs.js","sourceRoot":"","sources":["../../src/capabilities/errors.specs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,OAAO,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAErF,MAAM,CAAC,MAAM,mBAAmB,GAAmB;IACjD,IAAI,EAAE,mBAAmB;IACzB,WAAW,EACT,iEAAiE;QACjE,uEAAuE;QACvE,sEAAsE;QACtE,yEAAyE;QACzE,oEAAoE;QACpE,qCAAqC;IACvC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,uCAAuC;gBACpD,OAAO,EAAE,IAAI;aACd;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4CAA4C;aAC1D;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,8BAA8B;aAC5C;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sCAAsC;aACpD;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,oCAAoC;gBACjD,OAAO,EAAE,EAAE;aACZ;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,GAAG,EAAE,CAAC,sBAAsB;CAC1C,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,gEAAgE;QAChE,yEAAyE;QACzE,SAAS;IACX,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;SAC1D;QACD,QAAQ,EAAE,CAAC,UAAU,CAAC;KACvB;IACD,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,uBAAuB,MAAM,CAAC,UAAU,CAAC,EAAE;CACrE,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAmB;IACnD,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,yEAAyE;QACzE,yEAAyE;QACzE,yEAAyE;QACzE,8BAA8B;IAChC,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EAAE,yCAAyC;aACvD;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4CAA4C;aAC1D;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8BAA8B;gBAC3C,OAAO,EAAE,EAAE;aACZ;SACF;QACD,QAAQ,EAAE,EAAE;KACb;IACD,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,GAAG,EAAE,CAAC,2BAA2B;CAC/C,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,WAAW,GAA8B;IACpD,mBAAmB;IACnB,iBAAiB;IACjB,qBAAqB;CACtB,CAAC"}

package/dist/capabilities/example-timelines.d.ts

@@ -0,0 +1,3 @@
+import type { CapabilityModule } from "./types.js";
+export declare const module: CapabilityModule;
+//# sourceMappingURL=example-timelines.d.ts.map

package/dist/capabilities/example-timelines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-timelines.d.ts","sourceRoot":"","sources":["../../src/capabilities/example-timelines.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAoB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAsRrE,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC"}