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

package/dist/capabilities/collections.specs.js

@@ -0,0 +1,299 @@
+/**
+ * The `collections` 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 `collections.ts`, so nothing the
+ * implementations pull in reaches the entry graph. `collections.ts` imports these
+ * back and attaches each to its implementation, so there is one spec object
+ * behind both halves.
+ */
+export const QUERY_COLLECTION_SCHEMA = {
+    type: "object",
+    properties: {
+        collection: {
+            type: "string",
+            description: "Name of the collection to search"
+        },
+        query: {
+            type: "string",
+            description: "The text to search for"
+        },
+        n_results: {
+            type: "number",
+            description: "Maximum number of chunks to return",
+            default: 5
+        }
+    },
+    required: ["collection", "query"]
+};
+export const listCollectionsSpec = {
+    name: "list_collections",
+    description: "List the available knowledge collections (vector stores) the user has. " +
+        "Use this to discover what you can search before calling query_collection.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+        required: []
+    },
+    category: "read",
+    userMessage: () => "Listing knowledge collections"
+};
+export const queryCollectionSpec = {
+    name: "query_collection",
+    description: "Semantic search within a named knowledge collection. Returns the most " +
+        "relevant document chunks. Call list_collections first if you don't know " +
+        "the collection name.",
+    inputSchema: QUERY_COLLECTION_SCHEMA,
+    category: "read",
+    userMessage: (params) => {
+        const name = params["collection"];
+        return name ? `Searching collection '${name}'` : "Searching collection";
+    }
+};
+export const vectorTextSearchSpec = {
+    name: "vector_text_search",
+    description: "Search all vector database collections for similar text using semantic search",
+    inputSchema: {
+        type: "object",
+        properties: {
+            text: { type: "string", description: "The text to search for" },
+            n_results: {
+                type: "integer",
+                description: "Number of results to return",
+                default: 10
+            }
+        },
+        required: ["text"]
+    },
+    category: "read",
+    userMessage: (params) => {
+        const text = params["text"] ?? "something";
+        const msg = `Performing semantic search for '${text}'...`;
+        return msg.length > 80 ? "Performing semantic search..." : msg;
+    }
+};
+export const vectorIndexSpec = {
+    name: "vector_index",
+    description: "Index a text chunk into a vector database collection",
+    inputSchema: {
+        type: "object",
+        properties: {
+            text: { type: "string", description: "The text content to index" },
+            source_id: {
+                type: "string",
+                description: "Unique identifier for the source of the text"
+            },
+            metadata: {
+                type: "object",
+                description: "Metadata to associate with the text chunk",
+                default: {}
+            }
+        },
+        required: ["text", "source_id"]
+    },
+    category: "write",
+    userMessage: (params) => {
+        const sourceId = params["source_id"] ?? "a source";
+        const msg = `Indexing text chunk from ${sourceId}...`;
+        return msg.length > 80 ? "Indexing text chunk..." : msg;
+    }
+};
+export const vectorHybridSearchSpec = {
+    name: "vector_hybrid_search",
+    description: "Search all vector database collections using both semantic and keyword-based search",
+    inputSchema: {
+        type: "object",
+        properties: {
+            text: { type: "string", description: "The text to search for" },
+            n_results: {
+                type: "integer",
+                description: "Number of results to return per collection",
+                default: 5
+            },
+            k_constant: {
+                type: "number",
+                description: "Constant for reciprocal rank fusion",
+                default: 60.0
+            },
+            min_keyword_length: {
+                type: "integer",
+                description: "Minimum length for keyword tokens",
+                default: 3
+            }
+        },
+        required: ["text"]
+    },
+    category: "read",
+    userMessage: (params) => {
+        const text = params["text"] ?? "something";
+        const msg = `Performing hybrid search for '${text}'...`;
+        return msg.length > 80 ? "Performing hybrid search..." : msg;
+    }
+};
+export const vectorRecursiveSplitAndIndexSpec = {
+    name: "vector_recursive_split_and_index",
+    description: "Split text into chunks recursively and index them into a vector database collection",
+    inputSchema: {
+        type: "object",
+        properties: {
+            text: {
+                type: "string",
+                description: "The text content to split and index"
+            },
+            document_id: {
+                type: "string",
+                description: "Base identifier for the source document"
+            },
+            chunk_size: {
+                type: "integer",
+                description: "Maximum size of each chunk in characters",
+                default: 1000
+            },
+            chunk_overlap: {
+                type: "integer",
+                description: "Number of characters to overlap between chunks",
+                default: 200
+            },
+            separators: {
+                type: "array",
+                items: { type: "string" },
+                description: "List of separators for recursive splitting",
+                default: ["\n\n", "\n", "."]
+            },
+            metadata: {
+                type: "object",
+                description: "Additional metadata to associate with all chunks",
+                default: {}
+            }
+        },
+        required: ["text", "document_id"]
+    },
+    category: "write",
+    userMessage: (params) => {
+        const sourceId = params["source_id"] ?? "a source";
+        const msg = `Recursively splitting and indexing text from ${sourceId}...`;
+        return msg.length > 80 ? "Recursively splitting and indexing text..." : msg;
+    }
+};
+export const vectorMarkdownSplitAndIndexSpec = {
+    name: "vector_markdown_split_and_index",
+    description: "Split markdown text into chunks based on headers and index them into a vector database collection",
+    inputSchema: {
+        type: "object",
+        properties: {
+            file_path: {
+                type: "string",
+                description: "The path to the markdown file to split and index"
+            },
+            text: {
+                type: "string",
+                description: "Raw markdown content if no file_path provided"
+            },
+            chunk_size: {
+                type: "integer",
+                description: "Maximum size of each chunk in characters",
+                default: 1000
+            },
+            chunk_overlap: {
+                type: "integer",
+                description: "Number of characters to overlap between chunks",
+                default: 200
+            }
+        },
+        required: []
+    },
+    category: "write",
+    userMessage: (params) => {
+        const sourceId = params["source_id"] ?? "a source";
+        const msg = `Splitting and indexing Markdown from ${sourceId}...`;
+        return msg.length > 80 ? "Splitting and indexing Markdown..." : msg;
+    }
+};
+export const vectorBatchIndexSpec = {
+    name: "vector_batch_index",
+    description: "Index a batch of text chunks into a vector database collection",
+    inputSchema: {
+        type: "object",
+        properties: {
+            chunks: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        text: { type: "string" },
+                        source_id: { type: "string" },
+                        metadata: { type: "object", default: {} }
+                    },
+                    required: ["text", "source_id"]
+                },
+                description: "List of text chunks to index"
+            },
+            base_metadata: {
+                type: "object",
+                description: "Base metadata to add to all chunks",
+                default: {}
+            }
+        },
+        required: ["chunks"]
+    },
+    category: "write",
+    userMessage: (params) => {
+        const chunks = params["chunks"] ?? [];
+        return `Indexing a batch of ${chunks.length} text chunks...`;
+    }
+};
+export const createCollectionSpec = {
+    name: "create_collection",
+    description: "Create an empty vector collection to index documents into. The " +
+        "collection records you as its owner, so other users of this install " +
+        "cannot delete it. Pick the embedding model with find_model when you " +
+        "need one other than the default.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: {
+                type: "string",
+                description: "Collection name. No path separators, control characters or surrounding whitespace."
+            },
+            embedding_model: {
+                type: "string",
+                description: "Embedding model id, e.g. all-minilm:latest"
+            },
+            embedding_provider: {
+                type: "string",
+                description: "Provider serving the embedding model, e.g. ollama"
+            }
+        },
+        required: ["name"]
+    },
+    category: "write",
+    userMessage: (params) => `Creating collection ${params["name"]}`
+};
+export const deleteCollectionSpec = {
+    name: "delete_collection",
+    description: "Delete a vector collection and everything indexed in it. Irreversible. " +
+        "A collection owned by another user is refused.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            name: { type: "string", description: "The collection to delete" }
+        },
+        required: ["name"]
+    },
+    category: "write",
+    userMessage: (params) => `Deleting collection ${params["name"]}`
+};
+/** Every spec this module declares, in declaration order. */
+export const collectionsSpecs = [
+    listCollectionsSpec,
+    queryCollectionSpec,
+    vectorTextSearchSpec,
+    vectorIndexSpec,
+    vectorHybridSearchSpec,
+    vectorRecursiveSplitAndIndexSpec,
+    vectorMarkdownSplitAndIndexSpec,
+    vectorBatchIndexSpec,
+    createCollectionSpec,
+    deleteCollectionSpec
+];
+//# sourceMappingURL=collections.specs.js.map

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

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

package/dist/capabilities/compositions.d.ts

@@ -0,0 +1,57 @@
+/**
+ * The `compositions` capability module — reusable timeline templates,
+ * headlessly.
+ *
+ * A composition is a group clip plus its children and the parameters that vary
+ * (`@nodetool-ai/timeline`'s `composition.ts`). Two kinds exist and both read
+ * the same way: the ones NodeTool ships, JSON files under
+ * `packages/base-nodes/nodetool/examples/compositions/`, and the ones a user
+ * saved, ordinary JSON assets carrying a marker under
+ * `metadata.nodetool_composition` — the entity pattern (D11).
+ *
+ * Inserting one is not here: it is the `insert_composition` op on
+ * `edit_timeline`, so a template lands through the same bridge every other
+ * document edit goes through (I11).
+ */
+import type { TimelineComposition } from "@nodetool-ai/timeline";
+import type { CapabilityExport, CapabilityModule, CapabilityRun } from "./types.js";
+/** The metadata key a saved composition's marker lives under. */
+export declare const COMPOSITION_METADATA_KEY = "nodetool_composition";
+type ToolError = {
+    error: string;
+};
+export type CompositionSource = "shipped" | "user";
+export interface LoadedComposition {
+    composition: TimelineComposition;
+    source: CompositionSource;
+}
+/**
+ * Where the shipped compositions live: an explicit override, then the packaged
+ * layout (`examples/compositions` next to `server.mjs`), then the checkout.
+ *
+ * The three roots are the same ones every other shipped-example reader walks;
+ * this module resolves them itself rather than taking a loader on the run,
+ * because a composition is read with no user and no database.
+ */
+export declare function shippedCompositionsDir(): string | null;
+/** Whether a parsed value carries the shape a composition must have. */
+export declare function isComposition(value: unknown): value is TimelineComposition;
+/** Every composition NodeTool ships, sorted by id. */
+export declare function loadShippedCompositions(): TimelineComposition[];
+/** Every composition this user saved, newest asset first. */
+export declare function loadUserCompositions(run: CapabilityRun): Promise<TimelineComposition[] | ToolError>;
+/**
+ * One composition by id: a shipped slug wins, then the user's assets. The
+ * shipped set is checked first because its ids are slugs and an asset id is a
+ * uuid — they cannot collide, and a shipped read needs no database.
+ */
+export declare function loadComposition(run: CapabilityRun, compositionId: string): Promise<LoadedComposition | null>;
+declare const listCompositions: CapabilityExport;
+declare const getComposition: CapabilityExport;
+declare const saveComposition: CapabilityExport;
+declare const deleteComposition: CapabilityExport;
+/** Every composition capability, in declaration order. */
+export declare const COMPOSITION_CAPABILITIES: readonly CapabilityExport[];
+export declare const module: CapabilityModule;
+export { listCompositions, getComposition, saveComposition, deleteComposition };
+//# sourceMappingURL=compositions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compositions.d.ts","sourceRoot":"","sources":["../../src/capabilities/compositions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACd,MAAM,YAAY,CAAC;AAYpB,iEAAiE;AACjE,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAQ/D,KAAK,SAAS,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAKnC,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,mBAAmB,CAAC;IACjC,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,IAAI,CA4BtD;AAgBD,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAS1E;AAED,sDAAsD;AACtD,wBAAgB,uBAAuB,IAAI,mBAAmB,EAAE,CAe/D;AAED,6DAA6D;AAC7D,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,mBAAmB,EAAE,GAAG,SAAS,CAAC,CAiB5C;AAmBD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,aAAa,EAClB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAmBnC;AAoBD,QAAA,MAAM,gBAAgB,EAAE,gBA4CvB,CAAC;AAEF,QAAA,MAAM,cAAc,EAAE,gBAmBrB,CAAC;AAEF,QAAA,MAAM,eAAe,EAAE,gBAgItB,CAAC;AAEF,QAAA,MAAM,iBAAiB,EAAE,gBA2BxB,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB,EAAE,SAAS,gBAAgB,EAK/D,CAAC;AAEF,eAAO,MAAM,MAAM,EAAE,gBAGpB,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,CAAC"}