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

package/dist/capabilities/skills.js

@@ -0,0 +1,269 @@
+/**
+ * The `skills` capability module — the user's own instruction documents.
+ *
+ * A skill is a name, a one-line description of when it applies, and a Markdown
+ * body. The catalog of names and descriptions is rendered into every chat
+ * turn's prompt (`skill-prompt.ts`), so discovery costs nothing; `load_skill`
+ * is how the body reaches the model, and the other three are authoring.
+ *
+ * Two tiers share these names. A **user skill** is a row someone wrote and can
+ * rewrite. A **system skill** ships with the build (`system-skills.ts`) and is
+ * read-only: `list_skills` and `load_skill` serve both, and the three authoring
+ * calls refuse a shipped name so nothing can edit or delete one. A user row that
+ * already held the name predates the reservation and still wins.
+ *
+ * `@nodetool-ai/models` is imported inside each implementation, so loading this
+ * module never opens a database.
+ */
+import { listSkillsSpec, loadSkillSpec, createSkillSpec, updateSkillSpec, deleteSkillSpec } from "./skills.specs.js";
+import { isString } from "../utils/type-guards.js";
+import { findSystemSkill, isSystemSkillName, loadSystemSkills } from "../system-skills.js";
+function requireUser(context) {
+    const userId = context.userId;
+    if (!userId)
+        return { error: "No user context; cannot access skills." };
+    return { userId };
+}
+function errorMessage(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+/** Normalize a name the model may have typed with its leading slash. */
+function skillName(value) {
+    return isString(value) ? value.trim().replace(/^\//, "").toLowerCase() : "";
+}
+/**
+ * The refusal a shipped name earns. Immutability is the point of the tier: an
+ * agent that mis-reads its own instructions must not be able to edit the
+ * document those instructions came from.
+ */
+function reservedNameError(name, verb) {
+    return (`"${name}" is a system skill that ships with NodeTool and cannot be ` +
+        `${verb}. Pick another name; load_skill still reads it.`);
+}
+async function findSkill(userId, name) {
+    const { Skill } = await import("@nodetool-ai/models");
+    return Skill.findByName(userId, name);
+}
+// ---------------------------------------------------------------------------
+// list_skills
+// ---------------------------------------------------------------------------
+const listSkills = {
+    spec: listSkillsSpec,
+    impl: async (run, params) => {
+        const scope = requireUser(run.context);
+        if ("error" in scope)
+            return { success: false, error: scope.error };
+        try {
+            const { Skill } = await import("@nodetool-ai/models");
+            const rows = await Skill.listByUser(scope.userId);
+            const query = isString(params.query)
+                ? params.query.trim().toLowerCase()
+                : "";
+            const taken = new Set(rows.map((row) => row.name.toLowerCase()));
+            const merged = [
+                ...rows.map((row) => ({
+                    name: row.name,
+                    description: row.description,
+                    updated_at: row.updated_at,
+                    system: false
+                })),
+                // A shipped skill whose name a user row already holds is shadowed by
+                // that row and is not listed twice.
+                ...loadSystemSkills()
+                    .filter((skill) => !taken.has(skill.name))
+                    .map((skill) => ({
+                    name: skill.name,
+                    description: skill.description,
+                    updated_at: null,
+                    system: true
+                }))
+            ];
+            const skills = merged.filter((skill) => !query ||
+                `${skill.name} ${skill.description}`.toLowerCase().includes(query));
+            return { success: true, count: skills.length, skills };
+        }
+        catch (e) {
+            return { success: false, error: errorMessage(e) };
+        }
+    }
+};
+// ---------------------------------------------------------------------------
+// load_skill
+// ---------------------------------------------------------------------------
+const loadSkill = {
+    spec: loadSkillSpec,
+    impl: async (run, params) => {
+        const scope = requireUser(run.context);
+        if ("error" in scope)
+            return { success: false, error: scope.error };
+        const name = skillName(params.name);
+        if (!name)
+            return { success: false, error: "name is required" };
+        try {
+            const skill = await findSkill(scope.userId, name);
+            if (skill) {
+                return {
+                    success: true,
+                    name: skill.name,
+                    description: skill.description,
+                    instructions: skill.content,
+                    system: false
+                };
+            }
+            const shipped = findSystemSkill(name);
+            if (shipped) {
+                return {
+                    success: true,
+                    name: shipped.name,
+                    description: shipped.description,
+                    instructions: shipped.content,
+                    system: true
+                };
+            }
+            return {
+                success: false,
+                error: `No skill named "${name}". Call list_skills to see what exists.`
+            };
+        }
+        catch (e) {
+            return { success: false, error: errorMessage(e) };
+        }
+    }
+};
+// ---------------------------------------------------------------------------
+// create_skill
+// ---------------------------------------------------------------------------
+const createSkill = {
+    spec: createSkillSpec,
+    impl: async (run, params) => {
+        const scope = requireUser(run.context);
+        if ("error" in scope)
+            return { success: false, error: scope.error };
+        const name = skillName(params.name);
+        const description = isString(params.description)
+            ? params.description.trim()
+            : "";
+        const content = isString(params.content) ? params.content : "";
+        if (!name || !description || !content.trim()) {
+            return {
+                success: false,
+                error: "name, description and content are all required"
+            };
+        }
+        if (isSystemSkillName(name)) {
+            return { success: false, error: reservedNameError(name, "overwritten") };
+        }
+        try {
+            if (await findSkill(scope.userId, name)) {
+                return {
+                    success: false,
+                    error: `A skill named "${name}" already exists. Use update_skill to change it.`
+                };
+            }
+            const { Skill } = await import("@nodetool-ai/models");
+            const skill = await Skill.create({
+                user_id: scope.userId,
+                name,
+                description,
+                content
+            });
+            return { success: true, name: skill.name, skill_id: skill.id };
+        }
+        catch (e) {
+            return { success: false, error: errorMessage(e) };
+        }
+    }
+};
+// ---------------------------------------------------------------------------
+// update_skill
+// ---------------------------------------------------------------------------
+const updateSkill = {
+    spec: updateSkillSpec,
+    impl: async (run, params) => {
+        const scope = requireUser(run.context);
+        if ("error" in scope)
+            return { success: false, error: scope.error };
+        const name = skillName(params.name);
+        if (!name)
+            return { success: false, error: "name is required" };
+        try {
+            const skill = await findSkill(scope.userId, name);
+            if (!skill) {
+                // A shipped name with no user row behind it is the immutable tier, and
+                // says so — rather than the "no such skill" a plain lookup would give.
+                if (isSystemSkillName(name)) {
+                    return { success: false, error: reservedNameError(name, "edited") };
+                }
+                return { success: false, error: `No skill named "${name}"` };
+            }
+            const newName = skillName(params.new_name);
+            if (newName && newName !== name) {
+                if (isSystemSkillName(newName)) {
+                    return {
+                        success: false,
+                        error: reservedNameError(newName, "renamed over")
+                    };
+                }
+                if (await findSkill(scope.userId, newName)) {
+                    return {
+                        success: false,
+                        error: `A skill named "${newName}" already exists.`
+                    };
+                }
+                skill.name = newName;
+            }
+            if (isString(params.description)) {
+                skill.description = params.description.trim();
+            }
+            if (isString(params.content))
+                skill.content = params.content;
+            await skill.save();
+            return { success: true, name: skill.name, skill_id: skill.id };
+        }
+        catch (e) {
+            return { success: false, error: errorMessage(e) };
+        }
+    }
+};
+// ---------------------------------------------------------------------------
+// delete_skill
+// ---------------------------------------------------------------------------
+const deleteSkill = {
+    spec: deleteSkillSpec,
+    impl: async (run, params) => {
+        const scope = requireUser(run.context);
+        if ("error" in scope)
+            return { success: false, error: scope.error };
+        const name = skillName(params.name);
+        if (!name)
+            return { success: false, error: "name is required" };
+        try {
+            const skill = await findSkill(scope.userId, name);
+            if (!skill) {
+                if (isSystemSkillName(name)) {
+                    return { success: false, error: reservedNameError(name, "deleted") };
+                }
+                return { success: false, error: `No skill named "${name}"` };
+            }
+            await skill.delete();
+            return { success: true, name };
+        }
+        catch (e) {
+            return { success: false, error: errorMessage(e) };
+        }
+    }
+};
+/** Every skills capability, in declaration order. */
+export const SKILLS_CAPABILITIES = [
+    listSkills,
+    loadSkill,
+    createSkill,
+    updateSkill,
+    deleteSkill
+];
+export const module = {
+    module: "skills",
+    exports: SKILLS_CAPABILITIES
+};
+export { listSkills, loadSkill, createSkill, updateSkill, deleteSkill };
+//# sourceMappingURL=skills.js.map

package/dist/capabilities/skills.js.map

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

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

@@ -0,0 +1,17 @@
+/**
+ * The `skills` module's specs — data only, no implementation.
+ *
+ * Skills are the user's own instruction documents, stored per user in the
+ * database. The catalog (name + description) is rendered into the system
+ * prompt, so a turn already knows what exists; these capabilities are how an
+ * agent reads one in full and how it authors them.
+ */
+import type { CapabilitySpec } from "./types.js";
+export declare const listSkillsSpec: CapabilitySpec;
+export declare const loadSkillSpec: CapabilitySpec;
+export declare const createSkillSpec: CapabilitySpec;
+export declare const updateSkillSpec: CapabilitySpec;
+export declare const deleteSkillSpec: CapabilitySpec;
+/** Every spec this module declares, in declaration order. */
+export declare const skillsSpecs: readonly CapabilitySpec[];
+//# sourceMappingURL=skills.specs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.specs.d.ts","sourceRoot":"","sources":["../../src/capabilities/skills.specs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAOjD,eAAO,MAAM,cAAc,EAAE,cAmB5B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,cAgB3B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cA0B7B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAkB7B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,cAe7B,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,WAAW,EAAE,SAAS,cAAc,EAMhD,CAAC"}

package/dist/capabilities/skills.specs.js

@@ -0,0 +1,108 @@
+/**
+ * The `skills` module's specs — data only, no implementation.
+ *
+ * Skills are the user's own instruction documents, stored per user in the
+ * database. The catalog (name + description) is rendered into the system
+ * prompt, so a turn already knows what exists; these capabilities are how an
+ * agent reads one in full and how it authors them.
+ */
+import { isString } from "../utils/type-guards.js";
+const NAME_DESCRIPTION = "Skill name — a lowercase slug (a-z, 0-9, hyphen), as listed in the skill " +
+    "catalog and as typed by the user with a leading slash (`/my-skill`).";
+export const listSkillsSpec = {
+    name: "list_skills",
+    description: "List the user's skills — name and description each, without the " +
+        "instructions. Use it to find a skill worth loading; call `load_skill` " +
+        "to read one in full before following it.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Optional text filter matched against name and description."
+            }
+        },
+        required: []
+    },
+    category: "read",
+    userMessage: () => "Listing skills"
+};
+export const loadSkillSpec = {
+    name: "load_skill",
+    description: "Load one skill's full instructions by name. Do this before acting on a " +
+        "skill the catalog only summarizes — the description says when a skill " +
+        "applies, the instructions say what to do.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: { type: "string", description: NAME_DESCRIPTION }
+        },
+        required: ["name"]
+    },
+    category: "read",
+    userMessage: (params) => isString(params.name) ? `Loading skill /${params.name}` : "Loading skill"
+};
+export const createSkillSpec = {
+    name: "create_skill",
+    description: "Create a skill for the user: a named, described set of instructions the " +
+        "agent can load later. Write the description as *when to use this* — it " +
+        "is the only part always in context. Names must be unique per user.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: { type: "string", description: NAME_DESCRIPTION },
+            description: {
+                type: "string",
+                description: "One line saying when this skill applies. Max 1024 characters, no " +
+                    "markup."
+            },
+            content: {
+                type: "string",
+                description: "The instructions themselves, as Markdown."
+            }
+        },
+        required: ["name", "description", "content"]
+    },
+    category: "write",
+    userMessage: (params) => isString(params.name) ? `Creating skill /${params.name}` : "Creating skill"
+};
+export const updateSkillSpec = {
+    name: "update_skill",
+    description: "Update an existing skill by name. Only the fields you pass change; pass " +
+        "`new_name` to rename it.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: { type: "string", description: NAME_DESCRIPTION },
+            new_name: { type: "string", description: "New name for the skill." },
+            description: { type: "string", description: "New description." },
+            content: { type: "string", description: "New Markdown instructions." }
+        },
+        required: ["name"]
+    },
+    category: "write",
+    userMessage: (params) => isString(params.name) ? `Updating skill /${params.name}` : "Updating skill"
+};
+export const deleteSkillSpec = {
+    name: "delete_skill",
+    description: "Delete one of the user's skills by name. This is permanent — ask first " +
+        "unless the user asked for the deletion.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: { type: "string", description: NAME_DESCRIPTION }
+        },
+        required: ["name"]
+    },
+    category: "write",
+    userMessage: (params) => isString(params.name) ? `Deleting skill /${params.name}` : "Deleting skill"
+};
+/** Every spec this module declares, in declaration order. */
+export const skillsSpecs = [
+    listSkillsSpec,
+    loadSkillSpec,
+    createSkillSpec,
+    updateSkillSpec,
+    deleteSkillSpec
+];
+//# sourceMappingURL=skills.specs.js.map

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

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

package/dist/capabilities/storyboards.d.ts

@@ -0,0 +1,68 @@
+/**
+ * The `storyboards` capability module.
+ *
+ * Storyboard capabilities: list and create, render stills and clips, revise
+ * one take, assemble a timeline, edit the shot list, extract a script, and
+ * delete. The render path used to be seven `Tool` subclasses in
+ * `../tools/storyboard-render-tools.ts`.
+ *
+ * Wire names, descriptions and schemas are unchanged. Prompt composition,
+ * entity seasoning, and the shot → timeline mapping stay the editor's own
+ * (`entitiesForShot` from `@nodetool-ai/protocol`, `buildStoryboardTimeline`
+ * from `@nodetool-ai/timeline`), so a board rendered headlessly matches one
+ * rendered in the UI. Every heavy dependency is imported inside the
+ * implementation that needs it.
+ *
+ * Design: docs/tool-class-retirement-design.md § "Migration".
+ */
+import type { VideoRef } from "@nodetool-ai/protocol";
+import type { CapabilityExport, CapabilityModule } from "./types.js";
+/**
+ * The clip a render actually produced, with its real length when readable.
+ *
+ * A video model quantizes the duration it is asked for — a shot directed at
+ * 1.5s came back as 5.184s — and the ref carried only the asset id, so
+ * assembly laid down the *intended* 1.5s over five seconds of footage and
+ * threw the rest away without saying so. The bytes are already in hand here,
+ * so the length is free to read; a container we cannot parse leaves `duration`
+ * unset, which every reader treats as unknown rather than zero.
+ */
+export declare function renderedVideoRef(saved: {
+    assetId: string;
+    uri: string;
+    output: unknown;
+}): VideoRef;
+declare const listStoryboards: CapabilityExport;
+declare const createStoryboard: CapabilityExport;
+declare const getStoryboard: CapabilityExport;
+declare const renderStoryboardStills: CapabilityExport;
+declare const renderStoryboardClips: CapabilityExport;
+declare const reviseStoryboardClip: CapabilityExport;
+declare const assembleStoryboardTimeline: CapabilityExport;
+declare const BOARD_OPS: readonly ["add_shot", "update_shot", "remove_shot", "reorder_shot", "move_shot", "duplicate_shot", "set_board", "set_setup", "update_scene", "create_scene", "merge_scene", "set_style", "select_version", "delete_version", "add_keyframe_version"];
+type BoardOpName = (typeof BOARD_OPS)[number];
+/** The op a name selects, following {@link BOARD_OP_ALIASES}. */
+export declare const resolveBoardOpName: (value: string) => BoardOpName | null;
+declare const editStoryboard: CapabilityExport;
+/**
+ * The Director, headless. The browser runs the same three protocol functions
+ * from `useDirectScreenplay`; keeping the prompt, the schema and the parse in
+ * `@nodetool-ai/protocol` is what makes a board directed here and one directed
+ * in the editor the same artifact.
+ */
+declare const directStoryboard: CapabilityExport;
+declare const extractScriptFromStoryboard: CapabilityExport;
+/** Every storyboard capability, in the order the tool file declared them. */
+/**
+ * Delete a storyboard the caller owns.
+ *
+ * The ownership check and the version cascade are `Storyboard.deleteOwned`, the
+ * same function the tRPC route calls — a delete is not a place for two copies
+ * of one rule, and version rows outliving their document would be unreachable
+ * garbage. Missing and not-yours are one answer.
+ */
+declare const deleteStoryboard: CapabilityExport;
+export declare const STORYBOARD_CAPABILITIES: readonly CapabilityExport[];
+export declare const module: CapabilityModule;
+export { listStoryboards, createStoryboard, getStoryboard, renderStoryboardStills, renderStoryboardClips, reviseStoryboardClip, assembleStoryboardTimeline, editStoryboard, directStoryboard, extractScriptFromStoryboard, deleteStoryboard };
+//# sourceMappingURL=storyboards.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storyboards.d.ts","sourceRoot":"","sources":["../../src/capabilities/storyboards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAYH,OAAO,KAAK,EASV,QAAQ,EACT,MAAM,uBAAuB,CAAC;AAS/B,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AA8VpB;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,QAAQ,CAYX;AAqBD,QAAA,MAAM,eAAe,EAAE,gBAuBtB,CAAC;AAmBF,QAAA,MAAM,gBAAgB,EAAE,gBAoDvB,CAAC;AAEF,QAAA,MAAM,aAAa,EAAE,gBA6CpB,CAAC;AA6GF,QAAA,MAAM,sBAAsB,EAAE,gBAgG7B,CAAC;AAEF,QAAA,MAAM,qBAAqB,EAAE,gBA4I5B,CAAC;AAEF,QAAA,MAAM,oBAAoB,EAAE,gBA6E3B,CAAC;AAMF,QAAA,MAAM,0BAA0B,EAAE,gBA+QjC,CAAC;AAcF,QAAA,MAAM,SAAS,YACb,UAAU,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,CACd,CAAC;AAEX,KAAK,WAAW,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AA6B9C,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,UAAW,MAAM,KAAG,WAAW,GAAG,IAIhE,CAAC;AA64BF,QAAA,MAAM,cAAc,EAAE,gBAmGrB,CAAC;AAQF;;;;;GAKG;AACH,QAAA,MAAM,gBAAgB,EAAE,gBAqKvB,CAAC;AAWF,QAAA,MAAM,2BAA2B,EAAE,gBA6JlC,CAAC;AAEF,6EAA6E;AAC7E;;;;;;;GAOG;AACH,QAAA,MAAM,gBAAgB,EAAE,gBAYvB,CAAC;AACF,eAAO,MAAM,uBAAuB,EAAE,SAAS,gBAAgB,EAY9D,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,cAAc,EACd,gBAAgB,EAChB,2BAA2B,EAC3B,gBAAgB,EACjB,CAAC"}