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

package/dist/capabilities/example-timelines.js

@@ -0,0 +1,233 @@
+import { getExampleTimelineBundle, getExampleTimelineSource, listExampleTimelines } from "@nodetool-ai/timeline/examples/node";
+import { getExampleTimelineSpec, getExampleTimelineSourceSpec, 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));
+}
+/**
+ * One entry per distinct group. Siblings with the same name and parent
+ * (a repeater's items, such as one card per email) share the first
+ * sibling's entry, and `same_name_ids` lists the others, so a wide
+ * repeater does not fill the tool result.
+ */
+function sceneCatalog(groups) {
+    const entries = [];
+    const firstByKey = new Map();
+    for (const group of groups) {
+        const key = `${group.parentId ?? ""}\u0000${group.name ?? group.id}`;
+        const first = firstByKey.get(key);
+        if (first && group.name) {
+            (first.same_name_ids ??= []).push(group.id);
+            continue;
+        }
+        const entry = {
+            id: group.id,
+            name: group.name,
+            parent_id: group.parentId,
+            start_ms: group.startMs,
+            end_ms: group.startMs + group.durationMs
+        };
+        firstByKey.set(key, entry);
+        entries.push(entry);
+    }
+    return entries;
+}
+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: sceneCatalog(groups),
+            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."
+            }
+        };
+    }
+};
+const getExampleSource = {
+    spec: getExampleTimelineSourceSpec,
+    impl: async (_run, params) => {
+        const slug = params["slug"];
+        if (typeof slug !== "string" || !slug) {
+            return { error: "slug is required. Use list_example_timelines." };
+        }
+        const source = getExampleTimelineSource({}, slug);
+        if (!source) {
+            return {
+                error: `No shipped source for "${slug}". Use an exact slug from list_example_timelines.`
+            };
+        }
+        return {
+            slug: source.slug,
+            source: source.source,
+            imports: source.imports
+        };
+    }
+};
+export const module = {
+    module: "example-timelines",
+    exports: [listExamples, getExample, getExampleSource]
+};
+//# 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,6 @@
+import type { CapabilitySpec } from "./types.js";
+export declare const listExampleTimelinesSpec: CapabilitySpec;
+export declare const getExampleTimelineSpec: CapabilitySpec;
+export declare const getExampleTimelineSourceSpec: 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,4BAA4B,EAAE,cAmB1C,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,SAAS,cAAc,EAI1D,CAAC"}

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

@@ -0,0 +1,71 @@
+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 (siblings with the same name share one entry, with the other ids in same_name_ids) 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, including an id from same_name_ids. 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 getExampleTimelineSourceSpec = {
+    name: "get_example_timeline_source",
+    description: "Read the builder script that made a shipped example: its full JavaScript source, as authored, plus the module specifiers it imports. Use this to see how a scene, an effect chain or a repeater was actually built — get_example_timeline only shows the compiled document. Exact slug from list_example_timelines.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            slug: {
+                type: "string",
+                description: "Exact slug from list_example_timelines, such as kite or prism."
+            }
+        },
+        required: ["slug"],
+        additionalProperties: false
+    },
+    category: "read",
+    userMessage: (params) => `Reading example timeline source ${String(params["slug"])}`
+};
+export const exampleTimelinesSpecs = [
+    listExampleTimelinesSpec,
+    getExampleTimelineSpec,
+    getExampleTimelineSourceSpec
+];
+//# 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,4fAA4f;IAC9f,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,uHAAuH;aAC1H;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,4BAA4B,GAAmB;IAC1D,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,qTAAqT;IACvT,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,gEAAgE;aACnE;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;QAClB,oBAAoB,EAAE,KAAK;KAC5B;IACD,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE,CACtB,mCAAmC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE;CAC9D,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAA8B;IAC9D,wBAAwB;IACxB,sBAAsB;IACtB,4BAA4B;CAC7B,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"}