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

package/dist/capabilities/memory.specs.js

@@ -0,0 +1,208 @@
+/**
+ * The `memory` module's specs — data only, no implementation.
+ *
+ * Split out so a belt can be assembled synchronously: the registry's eager
+ * spec table imports this file, never `memory.ts`, so nothing the
+ * implementations pull in reaches the entry graph. `memory.ts` imports these
+ * back and attaches each to its implementation, so there is one spec object
+ * behind both halves.
+ */
+import { isString } from "../utils/type-guards.js";
+export const KNOWN_RESOURCE_TYPES = [
+    "asset",
+    "workflow",
+    "collection",
+    "node",
+    "job",
+    "timeline",
+    "script",
+    "storyboard",
+    "image_document",
+    "thread",
+    "url",
+    "other"
+];
+export const KIND_SCHEMA = {
+    type: "string",
+    enum: ["note", "fact", "preference", "decision", "resource"],
+    description: "Category of the memory. Use 'resource' when the point is the referenced " +
+        "resource(s), 'preference'/'decision'/'fact' for durable project context, " +
+        "else 'note'. Defaults to 'note'."
+};
+export const RESOURCES_SCHEMA = {
+    type: "array",
+    items: {
+        type: "object",
+        properties: {
+            type: {
+                type: "string",
+                description: "Resource kind — one of: " +
+                    KNOWN_RESOURCE_TYPES.join(", ") +
+                    ". Any other value is allowed too."
+            },
+            id: {
+                type: "string",
+                description: "Identifier: asset id, workflow id, collection name, node type, a URL, etc."
+            },
+            uri: {
+                type: "string",
+                description: "Optional canonical uri (asset://…, https://…)."
+            },
+            label: { type: "string", description: "Optional human label." }
+        },
+        required: ["type", "id"]
+    },
+    description: "Typed references to resources this memory is about — the assets you " +
+        "generated (type 'asset'), a workflow you built ('workflow'), a collection, " +
+        "a URL, etc. — so you can find and reuse them later. Asset references are " +
+        "validated and resolved to their asset:// uri; other kinds are stored as-is."
+};
+export const THREAD_SCOPE_SCHEMA = {
+    type: "string",
+    enum: ["all", "current"],
+    description: "Which conversation's memories to read. 'all' (the default) reads every " +
+        "memory you have ever saved, in any conversation. 'current' narrows to " +
+        "the ones recorded in this conversation."
+};
+export const memorySaveSpec = {
+    name: "memory_save",
+    description: "Save a durable memory. Use it to remember project facts, user " +
+        "preferences, decisions, and — crucially — the resources you produce or " +
+        "rely on (pass them in `resources`: the assets you generate, a workflow " +
+        "you built, a collection, a URL) so you can reuse them later. Memories " +
+        "are yours across every conversation, not just this one: what you save " +
+        "here you can read back in any later thread. The current conversation's " +
+        "memories are shown back to you at the start of each turn; reach the rest " +
+        "with memory_search or memory_list.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            content: {
+                type: "string",
+                description: "The memory itself — a self-contained note (e.g. 'The hero image " +
+                    "uses a teal/orange palette the user approved')."
+            },
+            title: {
+                type: "string",
+                description: "Optional short label shown when memories are listed."
+            },
+            kind: KIND_SCHEMA,
+            resources: RESOURCES_SCHEMA
+        },
+        required: ["content"]
+    },
+    category: "write",
+    userMessage: (params) => {
+        const title = isString(params.title) ? params.title : "";
+        return title ? `Remembering: ${title.slice(0, 60)}` : "Saving to memory";
+    }
+};
+export const memoryListSpec = {
+    name: "memory_list",
+    description: "List your durable memories, newest first, across every conversation. " +
+        "Each carries its referenced resources resolved (asset references carry a " +
+        "live asset:// uri you can pass to view_image or reuse in generation " +
+        "tools). Use memory_search instead when you know what you are looking for.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            limit: {
+                type: "number",
+                description: "Maximum memories to return (default 100, max 200)."
+            },
+            thread: THREAD_SCOPE_SCHEMA,
+            kinds: {
+                type: "array",
+                items: KIND_SCHEMA,
+                description: "Only these kinds. Omit for every kind."
+            }
+        },
+        required: []
+    },
+    category: "read",
+    userMessage: () => "Recalling memory"
+};
+export const memorySearchSpec = {
+    name: "memory_search",
+    description: "Search your durable memories by keyword, across every conversation. " +
+        "Every word you pass must appear in a memory's title or content, matched " +
+        "case-insensitively, so fewer words find more. Use it to recall what you " +
+        "learned in an earlier conversation — e.g. 'palette' or 'hero image'. " +
+        "Results are newest first with their resources resolved.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            query: {
+                type: "string",
+                description: "Words to look for, separated by spaces (e.g. 'brand colour'). " +
+                    "A memory matches only when it contains all of them."
+            },
+            limit: {
+                type: "number",
+                description: "Maximum matches to return (default 25, max 200)."
+            },
+            thread: THREAD_SCOPE_SCHEMA,
+            kinds: {
+                type: "array",
+                items: KIND_SCHEMA,
+                description: "Only search these kinds. Omit for every kind."
+            }
+        },
+        required: ["query"]
+    },
+    category: "read",
+    userMessage: (params) => {
+        const query = isString(params.query) ? params.query.trim() : "";
+        return query
+            ? `Searching memory for "${query.slice(0, 40)}"`
+            : "Searching memory";
+    }
+};
+export const memoryUpdateSpec = {
+    name: "memory_update",
+    description: "Update one of your memories by id, whichever conversation it was saved " +
+        "in. Only the fields you pass are changed; pass `resources` to replace " +
+        "the referenced resources.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            memory_id: {
+                type: "string",
+                description: "Id of the memory to update (from memory_list or memory_search)."
+            },
+            content: { type: "string", description: "New content text." },
+            title: { type: "string", description: "New title." },
+            kind: KIND_SCHEMA,
+            resources: RESOURCES_SCHEMA
+        },
+        required: ["memory_id"]
+    },
+    category: "write",
+    userMessage: () => "Updating conversation memory"
+};
+export const memoryDeleteSpec = {
+    name: "memory_delete",
+    description: "Delete one of your memories by id, whichever conversation it was saved " +
+        "in, when it is no longer relevant or was superseded.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            memory_id: {
+                type: "string",
+                description: "Id of the memory to delete (from memory_list or memory_search)."
+            }
+        },
+        required: ["memory_id"]
+    },
+    category: "write",
+    userMessage: () => "Forgetting a memory"
+};
+/** Every spec this module declares, in declaration order. */
+export const memorySpecs = [
+    memorySaveSpec,
+    memoryListSpec,
+    memorySearchSpec,
+    memoryUpdateSpec,
+    memoryDeleteSpec
+];
+//# sourceMappingURL=memory.specs.js.map

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

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

package/dist/capabilities/model3d.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The `model3d` capability module — the headless twin of the browser's
+ * `ui_3d_*` tools.
+ *
+ * Those tools drive a live three.js scene and fail when no editor is open,
+ * which left an agent with no way to build or fix a 3D model on its own. These
+ * six run the same verbs against the glTF asset itself: list the library, make
+ * a scene, read what is in one, edit it in place, check it, and render it
+ * through headless Blender. The scene
+ * operations, the units (degrees, CSS hex) and the "uuid or name" addressing
+ * are `@nodetool-ai/model3d`, shared with the editor, so a model built here
+ * opens there unchanged.
+ *
+ * What has no headless equivalent is the camera: `ui_3d_frame_scene` and
+ * `ui_3d_capture_view` need a WebGL context. `get_model3d` answers what it can
+ * without one — the scene's world-space bounds.
+ */
+import type { CapabilityExport, CapabilityModule } from "./types.js";
+declare const listModel3ds: CapabilityExport;
+declare const createModel3d: CapabilityExport;
+declare const getModel3d: CapabilityExport;
+declare const editModel3d: CapabilityExport;
+declare const validateModel3d: CapabilityExport;
+declare const renderModel3d: CapabilityExport;
+/** Every 3D-model capability, in declaration order. */
+export declare const MODEL3D_CAPABILITIES: readonly CapabilityExport[];
+export declare const module: CapabilityModule;
+export { listModel3ds, createModel3d, getModel3d, editModel3d, validateModel3d, renderModel3d };
+//# sourceMappingURL=model3d.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model3d.d.ts","sourceRoot":"","sources":["../../src/capabilities/model3d.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAmBH,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAqKpB,QAAA,MAAM,YAAY,EAAE,gBAkDnB,CAAC;AAMF,QAAA,MAAM,aAAa,EAAE,gBA8CpB,CAAC;AAMF,QAAA,MAAM,UAAU,EAAE,gBAoBjB,CAAC;AAwCF,QAAA,MAAM,WAAW,EAAE,gBAqBlB,CAAC;AAMF,QAAA,MAAM,eAAe,EAAE,gBA+BtB,CAAC;AA8HF,QAAA,MAAM,aAAa,EAAE,gBAuDpB,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,oBAAoB,EAAE,SAAS,gBAAgB,EAO3D,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC"}