@nodetool-ai/agents 0.7.0-rc.22 → 0.8.1

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/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":"AASA,OAAO,KAAK,EAAoB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAkOrE,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC"}

package/dist/capabilities/example-timelines.js

@@ -0,0 +1,191 @@
+import { getExampleTimelineBundle, listExampleTimelines } from "@nodetool-ai/timeline/examples/node";
+import { getExampleTimelineSpec, listExampleTimelinesSpec } from "./example-timelines.specs.js";
+const MAX_CLIP_CHARS = 12000;
+function stats(document) {
+    const clips = document.clips;
+    return {
+        clips: clips.length,
+        tracks: document.tracks.length,
+        groups: clips.filter((clip) => clip.mediaType === "group").length,
+        custom_animations: clips.reduce((count, clip) => count +
+            (clip.animations ?? []).filter((animation) => animation.preset === "custom").length, 0),
+        effect_types: [
+            ...new Set(clips.flatMap((clip) => (clip.effects ?? []).map((effect) => effect.type)))
+        ].sort(),
+        camera2d: document.camera2d != null,
+        tempo: document.tempo != null,
+        repeaters: clips.filter((clip) => clip.repeater != null).length,
+        blend_modes: [
+            ...new Set(clips.flatMap((clip) => (clip.blendMode ? [clip.blendMode] : [])))
+        ].sort(),
+        motion_blur: clips.filter((clip) => clip.motionBlur != null).length,
+        masks: clips.filter((clip) => clip.mask != null).length
+    };
+}
+function summary(slug, bundle) {
+    return {
+        slug,
+        name: bundle.name,
+        description: bundle.description,
+        source: "shipped",
+        read_only: true,
+        duration_ms: bundle.durationMs,
+        fps: bundle.fps,
+        width: bundle.width,
+        height: bundle.height,
+        poster_uri: bundle.posterUri,
+        video_uri: bundle.videoUri,
+        stats: stats(bundle.document)
+    };
+}
+const listExamples = {
+    spec: listExampleTimelinesSpec,
+    impl: async (_run, params) => {
+        const query = typeof params["query"] === "string" ? params["query"].toLowerCase() : "";
+        const examples = listExampleTimelines().flatMap((example) => {
+            if (query &&
+                !`${example.slug} ${example.name} ${example.description}`
+                    .toLowerCase()
+                    .includes(query)) {
+                return [];
+            }
+            const bundle = getExampleTimelineBundle({}, example.slug);
+            return bundle ? [summary(example.slug, bundle)] : [];
+        });
+        return { examples, count: examples.length };
+    }
+};
+function sceneClips(document, scene, durationMs) {
+    const start = scene?.startMs ?? 0;
+    const end = start + (scene?.durationMs ?? durationMs);
+    if (!scene) {
+        return document.clips.filter((clip) => clip.startMs < end && clip.startMs + clip.durationMs > start);
+    }
+    const children = new Map();
+    for (const clip of document.clips) {
+        if (!clip.parentId) {
+            continue;
+        }
+        const bucket = children.get(clip.parentId) ?? [];
+        bucket.push(clip);
+        children.set(clip.parentId, bucket);
+    }
+    const selected = new Set();
+    const queue = [scene];
+    for (let index = 0; index < queue.length; index += 1) {
+        const clip = queue[index];
+        if (!clip || selected.has(clip.id)) {
+            continue;
+        }
+        selected.add(clip.id);
+        queue.push(...(children.get(clip.id) ?? []));
+    }
+    // Parent transforms are part of the selected scene, including nested scenes.
+    const byId = new Map(document.clips.map((clip) => [clip.id, clip]));
+    let parentId = scene.parentId;
+    while (parentId && !selected.has(parentId)) {
+        selected.add(parentId);
+        parentId = byId.get(parentId)?.parentId;
+    }
+    return document.clips.filter((clip) => selected.has(clip.id) ||
+        (!clip.parentId &&
+            clip.mediaType !== "group" &&
+            clip.startMs < end &&
+            clip.startMs + clip.durationMs > start));
+}
+const getExample = {
+    spec: getExampleTimelineSpec,
+    impl: async (_run, params) => {
+        const slug = params["slug"];
+        if (typeof slug !== "string" || !slug) {
+            return { error: "slug is required. Use list_example_timelines." };
+        }
+        const bundle = getExampleTimelineBundle({}, slug);
+        if (!bundle) {
+            return {
+                error: `No shipped example timeline named "${slug}". Use an exact slug from list_example_timelines.`
+            };
+        }
+        const groups = bundle.document.clips
+            .filter((clip) => clip.mediaType === "group")
+            .sort((a, b) => a.startMs - b.startMs || a.id.localeCompare(b.id));
+        const sceneId = params["scene_id"];
+        if (sceneId !== undefined && typeof sceneId !== "string") {
+            return { error: "scene_id must be an exact group id." };
+        }
+        const scene = sceneId === undefined
+            ? (groups.find((group) => !group.parentId) ?? groups[0])
+            : groups.find((group) => group.id === sceneId);
+        if (sceneId !== undefined && !scene) {
+            return {
+                error: `No scene group "${sceneId}" in ${slug}. Omit scene_id to read its scene catalog.`
+            };
+        }
+        const offset = params["clip_offset"] ?? 0;
+        const limit = params["clip_limit"] ?? 12;
+        if (typeof offset !== "number" ||
+            !Number.isInteger(offset) ||
+            offset < 0 ||
+            typeof limit !== "number" ||
+            !Number.isInteger(limit) ||
+            limit < 1 ||
+            limit > 40) {
+            return {
+                error: "clip_offset must be a nonnegative integer and clip_limit an integer from 1 to 40."
+            };
+        }
+        const candidates = sceneClips(bundle.document, scene, bundle.durationMs);
+        const clips = [];
+        const omitted = [];
+        let size = 0;
+        let cursor = Math.min(offset, candidates.length);
+        for (; cursor < candidates.length && clips.length < limit; cursor += 1) {
+            const clip = candidates[cursor];
+            if (!clip) {
+                continue;
+            }
+            const chars = JSON.stringify(clip).length;
+            if (chars > MAX_CLIP_CHARS) {
+                omitted.push(clip.id);
+                continue;
+            }
+            if (size + chars > MAX_CLIP_CHARS) {
+                break;
+            }
+            clips.push(clip);
+            size += chars;
+        }
+        const trackIds = new Set(clips.map((clip) => clip.trackId));
+        return {
+            ...summary(slug, bundle),
+            scenes: groups.map((group) => ({
+                id: group.id,
+                name: group.name,
+                parent_id: group.parentId,
+                start_ms: group.startMs,
+                end_ms: group.startMs + group.durationMs
+            })),
+            excerpt: {
+                scene_id: scene?.id ?? null,
+                start_ms: scene?.startMs ?? 0,
+                end_ms: scene ? scene.startMs + scene.durationMs : bundle.durationMs,
+                tracks: bundle.document.tracks.filter((track) => trackIds.has(track.id)),
+                clips,
+                markers: [],
+                camera2d: bundle.document.camera2d,
+                tempo: bundle.document.tempo,
+                total_clips: candidates.length,
+                clip_offset: offset,
+                next_clip_offset: cursor < candidates.length ? cursor : null,
+                truncated: cursor < candidates.length || omitted.length > 0,
+                omitted_clip_ids: omitted,
+                note: "Times use the original timeline clock. Merge clip pages before rendering a scene. Oversized omitted clips require the installed example for rendering."
+            }
+        };
+    }
+};
+export const module = {
+    module: "example-timelines",
+    exports: [listExamples, getExample]
+};
+//# sourceMappingURL=example-timelines.js.map

package/dist/capabilities/example-timelines.js.map

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

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

@@ -0,0 +1,5 @@
+import type { CapabilitySpec } from "./types.js";
+export declare const listExampleTimelinesSpec: CapabilitySpec;
+export declare const getExampleTimelineSpec: CapabilitySpec;
+export declare const exampleTimelinesSpecs: readonly CapabilitySpec[];
+//# sourceMappingURL=example-timelines.specs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"example-timelines.specs.d.ts","sourceRoot":"","sources":["../../src/capabilities/example-timelines.specs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,wBAAwB,EAAE,cAgBtC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,cAoCpC,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,SAAS,cAAc,EAG1D,CAAC"}

package/dist/capabilities/example-timelines.specs.js

@@ -0,0 +1,53 @@
+export const listExampleTimelinesSpec = {
+    name: "list_example_timelines",
+    description: "List the read-only timeline examples shipped with NodeTool, including exact slugs, structural stats and package poster/video locators. No repository filesystem or user library is needed. Study an example with get_example_timeline.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Filter slug, name or description by this text."
+            }
+        },
+        additionalProperties: false
+    },
+    category: "read",
+    userMessage: () => "Listing example timelines"
+};
+export const getExampleTimelineSpec = {
+    name: "get_example_timeline",
+    description: "Study a shipped example by exact slug: metadata, structural stats, scene group catalog and a bounded scene excerpt with authored clip styles, keyframes and effects. Defaults to the first scene. The excerpt includes descendants and overlapping global layers. Page clips with next_clip_offset until truncated is false. Times remain in the original timeline clock. These references are read-only and have no saved timeline id.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            slug: {
+                type: "string",
+                description: "Exact slug from list_example_timelines, such as kite or prism."
+            },
+            scene_id: {
+                type: "string",
+                description: "Exact group clip id from this example's scenes catalog. Omit for its first scene."
+            },
+            clip_offset: {
+                type: "integer",
+                minimum: 0,
+                description: "Clip page offset. Use next_clip_offset from the preceding excerpt."
+            },
+            clip_limit: {
+                type: "integer",
+                minimum: 1,
+                maximum: 40,
+                description: "Maximum clips per excerpt, default 12. Clip payloads are also capped at 12000 characters. A partial excerpt is not a complete renderable scene."
+            }
+        },
+        required: ["slug"],
+        additionalProperties: false
+    },
+    category: "read",
+    userMessage: (params) => `Reading example timeline ${String(params["slug"])}`
+};
+export const exampleTimelinesSpecs = [
+    listExampleTimelinesSpec,
+    getExampleTimelineSpec
+];
+//# sourceMappingURL=example-timelines.specs.js.map

package/dist/capabilities/example-timelines.specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-timelines.specs.js","sourceRoot":"","sources":["../../src/capabilities/example-timelines.specs.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,wBAAwB,GAAmB;IACtD,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EACT,wOAAwO;IAC1O,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,gDAAgD;aAC9D;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B;IACD,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,GAAG,EAAE,CAAC,2BAA2B;CAC/C,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAmB;IACpD,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,yaAAya;IAC3a,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,gEAAgE;aACnE;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,mFAAmF;aACtF;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,WAAW,EACT,oEAAoE;aACvE;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,EAAE;gBACX,WAAW,EACT,iJAAiJ;aACpJ;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,oBAAoB,EAAE,KAAK;KAC5B;IACD,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,4BAA4B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE;CAC9E,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAA8B;IAC9D,wBAAwB;IACxB,sBAAsB;CACvB,CAAC"}

package/dist/capabilities/files.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The `files` capability module — the workspace namespace.
+ *
+ * Seven capabilities that used to be seven `Tool` subclasses across three
+ * files: `read_file`, `write_file` and `list_directory` (`filesystem-tools.ts`),
+ * `edit_file`, `glob` and `grep` (`edit-search-tools.ts`), and `todo_write`
+ * (`todo-tools.ts`, the per-thread checklist).
+ *
+ * All six file capabilities go through `context.workspace`, never `node:fs`.
+ * That is what makes them work on a cloud deployment, where the workspace is a
+ * prefix in object storage and there is no directory to walk — and it is why
+ * the symlink guards that used to live here are gone: containment is the
+ * workspace's own rule, checked once, in one place.
+ *
+ * Every one is context-only: what the class read off the `ProcessingContext`
+ * the implementation reads off `run.context`, and nothing else rides on the
+ * run. A belt builds all seven from `files.specs.ts` by name, so
+ * `BUILTIN_TOOL_NAMES` sees what it saw before.
+ *
+ * The todo store lives here with the implementation that writes it;
+ * `../tools/todo-tools.ts` re-exports the three readers other code calls.
+ *
+ * Design: docs/tool-class-retirement-design.md § "PRs 4–9 — remaining
+ * namespaces".
+ */
+import type { ProcessingContext } from "@nodetool-ai/runtime";
+import type { TodoItem } from "@nodetool-ai/protocol";
+import type { CapabilityExport, CapabilityModule, CapabilityRun } from "./types.js";
+/**
+ * A run over one call's context — all a file capability needs.
+ */
+export declare function fileCapabilityRun(context: ProcessingContext): CapabilityRun;
+declare const readFileCapability: CapabilityExport;
+declare const writeFileCapability: CapabilityExport;
+declare const listDirectory: CapabilityExport;
+declare const editFile: CapabilityExport;
+declare const glob: CapabilityExport;
+declare const grep: CapabilityExport;
+/**
+ * Read the current todo list for a chat thread. Returns a defensive copy.
+ * Other code (tests, server endpoints) can use this to hydrate UI state.
+ */
+export declare function getThreadTodos(threadId: string): TodoItem[];
+/** Clear all todos for a thread (e.g. on thread delete). */
+export declare function clearThreadTodos(threadId: string): void;
+/** Test-only — wipe the global store. */
+export declare function _resetTodoStoreForTests(): void;
+declare const todoWrite: CapabilityExport;
+/** Every files capability, in the order the tool classes were listed. */
+export declare const FILE_CAPABILITIES: readonly CapabilityExport[];
+export declare const module: CapabilityModule;
+export { readFileCapability, writeFileCapability, listDirectory, editFile, glob, grep, todoWrite };
+//# sourceMappingURL=files.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/capabilities/files.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAEV,iBAAiB,EAGlB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,QAAQ,EAA0B,MAAM,uBAAuB,CAAC;AAQ9E,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AAWpB;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG,aAAa,CAE3E;AAsKD,QAAA,MAAM,kBAAkB,EAAE,gBA6EzB,CAAC;AAEF,QAAA,MAAM,mBAAmB,EAAE,gBAoD1B,CAAC;AAmFF,QAAA,MAAM,aAAa,EAAE,gBAyBpB,CAAC;AAqPF,QAAA,MAAM,QAAQ,EAAE,gBA0Jf,CAAC;AAsCF,QAAA,MAAM,IAAI,EAAE,gBA2DX,CAAC;AAUF,QAAA,MAAM,IAAI,EAAE,gBA0NX,CAAC;AA+BF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,CAG3D;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEvD;AAED,yCAAyC;AACzC,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAyBD,QAAA,MAAM,SAAS,EAAE,gBAqChB,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,iBAAiB,EAAE,SAAS,gBAAgB,EAQxD,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,SAAS,EACV,CAAC"}