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

package/dist/capabilities/shared.specs.js

@@ -0,0 +1,134 @@
+/**
+ * The `shared` 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 `shared.ts`, so nothing the
+ * implementations pull in reaches the entry graph. `shared.ts` imports these
+ * back and attaches each to its implementation, so there is one spec object
+ * behind both halves.
+ *
+ * Wire names, descriptions and schemas are the ones the three `Tool`
+ * subclasses in `../tools/shared-tools.ts` carried, unchanged.
+ */
+import { isString } from "../utils/type-guards.js";
+export const listSharedSpec = {
+    name: "list_shared",
+    description: "List entries in shared agent memory (results from prior steps and tasks, " +
+        "inputs, and shared facts published by other agents). Returns metadata " +
+        "only — call `read_shared` to fetch full values. Use this when you need " +
+        "context from upstream work but don't yet know which entry holds it.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            kind: {
+                type: "array",
+                items: {
+                    type: "string",
+                    enum: ["task_result", "step_result", "input", "shared"]
+                },
+                description: "Optional filter — restrict results to the listed kinds. Omit to list everything."
+            },
+            key_prefix: {
+                type: "string",
+                description: "Optional filter — only entries whose key starts with this prefix (e.g. \"task:\")."
+            },
+            sources: {
+                type: "array",
+                items: { type: "string" },
+                description: "Optional filter — only entries produced by one of these source IDs."
+            }
+        },
+        additionalProperties: false
+    },
+    category: "read",
+    userMessage: (params) => {
+        const parts = [];
+        if (Array.isArray(params.kind))
+            parts.push(`kinds=${params.kind.join(",")}`);
+        if (params.key_prefix)
+            parts.push(`prefix=${params.key_prefix}`);
+        if (Array.isArray(params.sources))
+            parts.push(`sources=${params.sources.join(",")}`);
+        return parts.length > 0
+            ? `Listing memory (${parts.join(" ")})`
+            : "Listing memory";
+    }
+};
+export const readSharedSpec = {
+    name: "read_shared",
+    description: "Read full values from shared agent memory by key. Use the keys returned " +
+        "by `list_shared`. Returns each requested entry with its value, kind, " +
+        "title, and source. Missing keys are reported in `missing`.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            keys: {
+                type: "array",
+                items: { type: "string" },
+                description: "Memory keys to read (e.g. [\"task:research\", \"step:summary\"]). " +
+                    "A key with no `<namespace>:` prefix is also looked up under " +
+                    "`shared:`, so a suffix passed to `share_result` reads back as-is."
+            }
+        },
+        required: ["keys"],
+        additionalProperties: false
+    },
+    category: "read",
+    userMessage: (params) => {
+        const keys = Array.isArray(params.keys)
+            ? params.keys.map(String)
+            : [];
+        if (keys.length === 0)
+            return "Reading memory";
+        if (keys.length === 1)
+            return `Reading memory: ${keys[0]}`;
+        return `Reading memory: ${keys.length} entries`;
+    }
+};
+export const shareResultSpec = {
+    name: "share_result",
+    description: "Publish a value to shared agent memory under the `shared:` namespace. " +
+        "Other agents and downstream steps can discover it via `list_shared` and " +
+        "fetch it via `read_shared`. Use this to broadcast facts, intermediate " +
+        "findings, or coordination signals to the rest of the team. Shared memory " +
+        "lives only for the current run — to keep something past it, use " +
+        "`memory_save` instead.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            key: {
+                type: "string",
+                minLength: 1,
+                description: "Suffix for the memory key. Stored as `shared:<key>`. Use a short, " +
+                    "descriptive identifier (e.g. \"top_sources\"). A leading " +
+                    "`shared:` is optional and stripped, so passing a key straight " +
+                    "back from `list_shared` writes the same entry."
+            },
+            value: {
+                description: "The value to publish. Any JSON-serializable structure or string."
+            },
+            title: {
+                type: "string",
+                description: "Optional human-readable title shown when the entry is listed."
+            },
+            description: {
+                type: "string",
+                description: "Optional brief description shown alongside the title."
+            }
+        },
+        required: ["key", "value"],
+        additionalProperties: false
+    },
+    category: "read",
+    userMessage: (params) => {
+        const key = isString(params.key) ? params.key : "(no key)";
+        return `Publishing to memory: shared:${key}`;
+    }
+};
+/** Every spec this module declares, in declaration order. */
+export const sharedSpecs = [
+    listSharedSpec,
+    readSharedSpec,
+    shareResultSpec
+];
+//# sourceMappingURL=shared.specs.js.map

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

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

package/dist/capabilities/sketches.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The `sketches` capability module.
+ *
+ * Sketch capabilities: list and create, the five version tools, the headless
+ * layer editor, validate, and delete. The version tools used to be
+ * `../tools/sketch-version-tools.ts`; the editor was `sketch-edit-tools.ts`;
+ * `validate_sketch` lived beside the workflow tools in `../tools/mcp-tools.ts`.
+ *
+ * Wire names, descriptions and schemas are unchanged from the old classes.
+ *
+ * The tRPC-only sketch loader `validate_sketch` took as a constructor argument
+ * is `run.loaders?.sketch`. Every heavy dependency (`@nodetool-ai/models`, the
+ * sketch validator, the eval surface's blend-mode table) is imported inside the
+ * implementation that needs it.
+ *
+ * Design: docs/tool-class-retirement-design.md § "Migration".
+ */
+import type { CapabilityExport, CapabilityModule } from "./types.js";
+declare const createSketch: CapabilityExport;
+declare const listSketches: CapabilityExport;
+declare const getSketch: CapabilityExport;
+declare const listSketchVersions: CapabilityExport;
+declare const getSketchVersion: CapabilityExport;
+declare const createSketchVersion: CapabilityExport;
+declare const restoreSketchVersion: CapabilityExport;
+declare const deleteSketchVersion: CapabilityExport;
+declare const editSketch: CapabilityExport;
+/**
+ * The brief expansion, headless. The browser sends the same prompt and schema
+ * from `@nodetool-ai/protocol` through `generate_text`; keeping both halves on
+ * one module is what makes a brief refined here and one refined in the editor
+ * the same artifact.
+ *
+ * D4: one language-model call and one document write. No layer is added and no
+ * generation is started.
+ */
+declare const refineImageBrief: CapabilityExport;
+declare const validateSketch: CapabilityExport;
+/** Every sketch capability, in the order the tool files declared them. */
+/**
+ * Delete a sketch the caller owns.
+ *
+ * The ownership check and the version cascade are `ImageDocument.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 deleteSketch: CapabilityExport;
+export declare const SKETCH_CAPABILITIES: readonly CapabilityExport[];
+export declare const module: CapabilityModule;
+export { listSketches, createSketch, getSketch, listSketchVersions, getSketchVersion, createSketchVersion, restoreSketchVersion, deleteSketchVersion, editSketch, refineImageBrief, validateSketch, deleteSketch };
+//# sourceMappingURL=sketches.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sketches.d.ts","sourceRoot":"","sources":["../../src/capabilities/sketches.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAuKpB,QAAA,MAAM,YAAY,EAAE,gBAoEnB,CAAC;AAEF,QAAA,MAAM,YAAY,EAAE,gBA2BnB,CAAC;AAEF,QAAA,MAAM,SAAS,EAAE,gBAOhB,CAAC;AAEF,QAAA,MAAM,kBAAkB,EAAE,gBA4BzB,CAAC;AAEF,QAAA,MAAM,gBAAgB,EAAE,gBA0BvB,CAAC;AAEF,QAAA,MAAM,mBAAmB,EAAE,gBAqB1B,CAAC;AAEF,QAAA,MAAM,oBAAoB,EAAE,gBAkE3B,CAAC;AAEF,QAAA,MAAM,mBAAmB,EAAE,gBAuB1B,CAAC;AAojBF,QAAA,MAAM,UAAU,EAAE,gBA+HjB,CAAC;AAMF;;;;;;;;GAQG;AACH,QAAA,MAAM,gBAAgB,EAAE,gBAqFvB,CAAC;AAuBF,QAAA,MAAM,cAAc,EAAE,gBA6ErB,CAAC;AAEF,0EAA0E;AAC1E;;;;;;;GAOG;AACH,QAAA,MAAM,YAAY,EAAE,gBAYnB,CAAC;AACF,eAAO,MAAM,mBAAmB,EAAE,SAAS,gBAAgB,EAa1D,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,YAAY,EACb,CAAC"}