agent-orcha 0.0.4 → 0.0.5

package/dist/lib/templates/resource-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-templates.d.ts","sourceRoot":"","sources":["../../../lib/templates/resource-templates.ts"],"names":[],"mappings":"AAkJA,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO7G"}

package/dist/lib/templates/resource-templates.js

@@ -0,0 +1,146 @@
+import { stringify } from 'yaml';
+// ── Example Templates ────────────────────────────────────────────────
+const agentExample = (name) => ({
+    name,
+    description: 'TODO - describe what this agent does',
+    version: '1.0.0',
+    llm: {
+        name: 'default',
+        temperature: 0.3,
+    },
+    prompt: {
+        system: 'You are a helpful assistant.\nTODO - add your system prompt here.',
+        inputVariables: ['query'],
+    },
+    tools: ['function:tool-name'],
+    // skills: ['skill-name'],
+    // output: { type: 'json', schema: {} },
+    // metadata: { category: 'custom', tags: [] },
+});
+const workflowExample = (name) => ({
+    name,
+    description: 'TODO - describe what this workflow does',
+    version: '1.0.0',
+    type: 'steps',
+    input: {
+        schema: {
+            query: {
+                type: 'string',
+                required: true,
+                description: 'The input query',
+            },
+        },
+    },
+    steps: [
+        {
+            id: 'step-1',
+            agent: 'TODO-agent-name',
+            input: { query: '{{input.query}}' },
+            output: { key: 'result' },
+            // condition: '...',
+            // retry: { maxAttempts: 3, delay: 1000 },
+        },
+    ],
+    output: {
+        result: '{{steps.step-1.output}}',
+    },
+    // config: { timeout: 30000, continueOnError: false },
+    // metadata: { category: 'custom', tags: [] },
+});
+const knowledgeExample = (name) => ({
+    name,
+    description: 'TODO - describe this knowledge store',
+    source: {
+        type: 'directory',
+        path: 'knowledge/data',
+        pattern: '*.txt',
+    },
+    loader: {
+        type: 'text',
+    },
+    splitter: {
+        type: 'recursive',
+        chunkSize: 1000,
+        chunkOverlap: 200,
+    },
+    embedding: 'default',
+    store: {
+        type: 'memory',
+    },
+    // search: { topK: 5, scoreThreshold: 0.7 },
+    // metadata: { category: 'custom', tags: [] },
+});
+const functionTemplate = (name) => `\
+export default {
+  name: '${name}',
+  description: 'TODO - describe what this function does',
+
+  parameters: {
+    input: {
+      type: 'string',
+      description: 'The input value',
+    },
+  },
+
+  execute: async ({ input }) => {
+    // TODO - implement your function logic
+    return input;
+  },
+};
+`;
+const skillTemplate = (name) => `\
+---
+name: ${name}
+description: TODO - describe what this skill does
+sandbox: false  # set to true to auto-inject sandbox_exec tool
+---
+
+# ${name}
+
+TODO - write skill instructions here.
+
+These instructions are injected into the agent's system prompt
+when this skill is attached.
+
+## Usage
+
+Describe how to use this skill, including any commands,
+APIs, or tools the agent should invoke.
+`;
+// ── Resource Registry ────────────────────────────────────────────────
+const resources = {
+    agent: {
+        path: (name) => `agents/${name}.agent.yaml`,
+        content: (name) => stringify(agentExample(name)),
+    },
+    workflow: {
+        path: (name) => `workflows/${name}.workflow.yaml`,
+        content: (name) => stringify(workflowExample(name)),
+    },
+    knowledge: {
+        path: (name) => `knowledge/${name}.knowledge.yaml`,
+        content: (name) => stringify(knowledgeExample(name)),
+    },
+    function: {
+        path: (name) => `functions/${name}.function.js`,
+        content: functionTemplate,
+    },
+    skill: {
+        path: (name) => `skills/${name}/SKILL.md`,
+        content: skillTemplate,
+    },
+};
+// ── Public API ───────────────────────────────────────────────────────
+export function getResourceTypes() {
+    return Object.keys(resources);
+}
+export function generateResourceTemplate(type, name) {
+    const resource = resources[type];
+    if (!resource)
+        return null;
+    return {
+        path: resource.path(name),
+        content: resource.content(name),
+    };
+}
+//# sourceMappingURL=resource-templates.js.map

package/dist/lib/templates/resource-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-templates.js","sourceRoot":"","sources":["../../../lib/templates/resource-templates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,wEAAwE;AAExE,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;IACtC,IAAI;IACJ,WAAW,EAAE,sCAAsC;IACnD,OAAO,EAAE,OAAO;IAChB,GAAG,EAAE;QACH,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,GAAG;KACjB;IACD,MAAM,EAAE;QACN,MAAM,EAAE,mEAAmE;QAC3E,cAAc,EAAE,CAAC,OAAO,CAAC;KAC1B;IACD,KAAK,EAAE,CAAC,oBAAoB,CAAC;IAC7B,0BAA0B;IAC1B,wCAAwC;IACxC,8CAA8C;CAC/C,CAAC,CAAC;AAEH,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;IACzC,IAAI;IACJ,WAAW,EAAE,yCAAyC;IACtD,OAAO,EAAE,OAAO;IAChB,IAAI,EAAE,OAAO;IACb,KAAK,EAAE;QACL,MAAM,EAAE;YACN,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,iBAAiB;aAC/B;SACF;KACF;IACD,KAAK,EAAE;QACL;YACE,EAAE,EAAE,QAAQ;YACZ,KAAK,EAAE,iBAAiB;YACxB,KAAK,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE;YACnC,MAAM,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE;YACzB,oBAAoB;YACpB,0CAA0C;SAC3C;KACF;IACD,MAAM,EAAE;QACN,MAAM,EAAE,yBAAyB;KAClC;IACD,sDAAsD;IACtD,8CAA8C;CAC/C,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI;IACJ,WAAW,EAAE,sCAAsC;IACnD,MAAM,EAAE;QACN,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,OAAO;KACjB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,MAAM;KACb;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,IAAI;QACf,YAAY,EAAE,GAAG;KAClB;IACD,SAAS,EAAE,SAAS;IACpB,KAAK,EAAE;QACL,IAAI,EAAE,QAAQ;KACf;IACD,4CAA4C;IAC5C,8CAA8C;CAC/C,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC;;WAEhC,IAAI;;;;;;;;;;;;;;;CAed,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC;;QAEhC,IAAI;;;;;IAKR,IAAI;;;;;;;;;;;CAWP,CAAC;AAEF,wEAAwE;AAExE,MAAM,SAAS,GAGV;IACH,KAAK,EAAE;QACL,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,IAAI,aAAa;QAC3C,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;KACjD;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,IAAI,gBAAgB;QACjD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;KACpD;IACD,SAAS,EAAE;QACT,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,IAAI,iBAAiB;QAClD,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;KACrD;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,IAAI,cAAc;QAC/C,OAAO,EAAE,gBAAgB;KAC1B;IACD,KAAK,EAAE;QACL,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,IAAI,WAAW;QACzC,OAAO,EAAE,aAAa;KACvB;CACF,CAAC;AAEF,wEAAwE;AAExE,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,IAAY;IACjE,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QACzB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/lib/tools/agent-tool-wrapper.d.ts

@@ -1,9 +1,9 @@
-import type { StructuredTool } from '@langchain/core/tools';
-import type { AgentDefinition } from '../agents/types.js';
-import type { AgentExecutor } from '../agents/agent-executor.js';
-import type { AgentLoader } from '../agents/agent-loader.js';
+import type { StructuredTool } from '../types/llm-types.ts';
+import type { AgentDefinition } from '../agents/types.ts';
+import type { AgentExecutor } from '../agents/agent-executor.ts';
+import type { AgentLoader } from '../agents/agent-loader.ts';
 /**
- * Wraps agents as LangChain tools so they can be called by other agents in LangGraph workflows.
+ * Wraps agents as tools so they can be called by other agents in ReAct workflows.
  */
 export declare class AgentToolWrapper {
     /**

package/dist/lib/tools/agent-tool-wrapper.js

@@ -1,8 +1,8 @@
-import { tool } from '@langchain/core/tools';
+import { tool } from "../types/tool-factory.js";
 import { z } from 'zod';
-import { logger } from '../logger.js';
+import { logger } from "../logger.js";
 /**
- * Wraps agents as LangChain tools so they can be called by other agents in LangGraph workflows.
+ * Wraps agents as tools so they can be called by other agents in ReAct workflows.
  */
 export class AgentToolWrapper {
     /**

package/dist/lib/tools/agent-tool-wrapper.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-tool-wrapper.js","sourceRoot":"","sources":["../../../lib/tools/agent-tool-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;OAEG;IACH,MAAM,CAAC,UAAU,CACf,IAAY,EACZ,UAA2B,EAC3B,QAAuB;QAEvB,OAAO,IAAI,CACT,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;YAClB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;gBAC3D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;gBAElE,OAAO,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;oBACtC,CAAC,CAAC,MAAM,CAAC,MAAM;oBACf,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5E,MAAM,CAAC,KAAK,CAAC,eAAe,IAAI,WAAW,EAAE,KAAK,CAAC,CAAC;gBACpD,OAAO,0BAA0B,IAAI,MAAM,YAAY,EAAE,CAAC;YAC5D,CAAC;QACH,CAAC,EACD;YACE,IAAI,EAAE,SAAS,IAAI,EAAE;YACrB,WAAW,EAAE,GAAG,UAAU,CAAC,WAAW,wBAAwB,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK;YAC7G,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;aAC/D,CAAC;SACH,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,CACtB,UAAoB,EACpB,WAAwB,EACxB,QAAuB;QAEvB,MAAM,KAAK,GAAqB,EAAE,CAAC;QAEnC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;gBACzD,SAAS;YACX,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,cAAc,CACzB,WAAwB,EACxB,QAAuB;QAEvB,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;CACF"}
+{"version":3,"file":"agent-tool-wrapper.js","sourceRoot":"","sources":["../../../lib/tools/agent-tool-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;OAEG;IACH,MAAM,CAAC,UAAU,CACf,IAAY,EACZ,UAA2B,EAC3B,QAAuB;QAEvB,OAAO,IAAI,CACT,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;YAClB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;gBAC3D,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;gBAElE,OAAO,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;oBACtC,CAAC,CAAC,MAAM,CAAC,MAAM;oBACf,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5E,MAAM,CAAC,KAAK,CAAC,eAAe,IAAI,WAAW,EAAE,KAAK,CAAC,CAAC;gBACpD,OAAO,0BAA0B,IAAI,MAAM,YAAY,EAAE,CAAC;YAC5D,CAAC;QACH,CAAC,EACD;YACE,IAAI,EAAE,SAAS,IAAI,EAAE;YACrB,WAAW,EAAE,GAAG,UAAU,CAAC,WAAW,wBAAwB,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK;YAC7G,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;aAC/D,CAAC;SACH,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,CACtB,UAAoB,EACpB,WAAwB,EACxB,QAAuB;QAEvB,MAAM,KAAK,GAAqB,EAAE,CAAC;QAEnC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;gBACzD,SAAS;YACX,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,cAAc,CACzB,WAAwB,EACxB,QAAuB;QAEvB,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/lib/tools/built-in/ask-user.tool.d.ts

@@ -1,4 +1,4 @@
-import type { StructuredTool } from '@langchain/core/tools';
+import type { StructuredTool } from '../../types/llm-types.ts';
 /**
  * Creates a tool that allows agents to ask the user for input during workflow execution.
  * When called, this tool throws a NodeInterrupt which pauses the graph and waits for user response.

package/dist/lib/tools/built-in/ask-user.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ask-user.tool.d.ts","sourceRoot":"","sources":["../../../../lib/tools/built-in/ask-user.tool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAoBlD"}
+{"version":3,"file":"ask-user.tool.d.ts","sourceRoot":"","sources":["../../../../lib/tools/built-in/ask-user.tool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAoBlD"}

package/dist/lib/tools/built-in/ask-user.tool.js

@@ -1,6 +1,6 @@
-import { tool } from '@langchain/core/tools';
+import { tool } from "../../types/tool-factory.js";
 import { z } from 'zod';
-import { NodeInterrupt } from '@langchain/langgraph';
+import { NodeInterrupt } from "../../types/llm-types.js";
 /**
  * Creates a tool that allows agents to ask the user for input during workflow execution.
  * When called, this tool throws a NodeInterrupt which pauses the graph and waits for user response.

package/dist/lib/tools/built-in/ask-user.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"ask-user.tool.js","sourceRoot":"","sources":["../../../../lib/tools/built-in/ask-user.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CACT,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,yCAAyC;QACzC,gDAAgD;QAChD,MAAM,IAAI,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxC,CAAC,EACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,mKAAmK;QACrK,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,CACP,sFAAsF,CACvF;SACJ,CAAC;KACH,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ask-user.tool.js","sourceRoot":"","sources":["../../../../lib/tools/built-in/ask-user.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CACT,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,yCAAyC;QACzC,gDAAgD;QAChD,MAAM,IAAI,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxC,CAAC,EACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,mKAAmK;QACrK,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,QAAQ,CACP,sFAAsF,CACvF;SACJ,CAAC;KACH,CACF,CAAC;AACJ,CAAC"}

package/dist/lib/tools/built-in/index.d.ts

@@ -1,3 +1,10 @@
-export { createKnowledgeSearchTool } from './knowledge-search.tool.js';
-export { createAskUserTool } from './ask-user.tool.js';
+export { createKnowledgeSearchTool } from './knowledge-search.tool.ts';
+export { createAskUserTool } from './ask-user.tool.ts';
+export { createKnowledgeTraverseTool } from './knowledge-traverse.tool.ts';
+export { createKnowledgeEntityLookupTool } from './knowledge-entity-lookup.tool.ts';
+export { createKnowledgeGraphSchemaTool } from './knowledge-graph-schema.tool.ts';
+export { createKnowledgeSqlTool } from './knowledge-sql.tool.ts';
+export { createKnowledgeTools, buildGraphSchemaDescription } from './knowledge-tools-factory.ts';
+export { validateReadonlyCypher, validateReadonlySql } from './query-validators.ts';
+export { createMemorySaveTool } from './memory-save.tool.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/tools/built-in/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../lib/tools/built-in/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../lib/tools/built-in/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/lib/tools/built-in/index.js

@@ -1,3 +1,10 @@
-export { createKnowledgeSearchTool } from './knowledge-search.tool.js';
-export { createAskUserTool } from './ask-user.tool.js';
+export { createKnowledgeSearchTool } from "./knowledge-search.tool.js";
+export { createAskUserTool } from "./ask-user.tool.js";
+export { createKnowledgeTraverseTool } from "./knowledge-traverse.tool.js";
+export { createKnowledgeEntityLookupTool } from "./knowledge-entity-lookup.tool.js";
+export { createKnowledgeGraphSchemaTool } from "./knowledge-graph-schema.tool.js";
+export { createKnowledgeSqlTool } from "./knowledge-sql.tool.js";
+export { createKnowledgeTools, buildGraphSchemaDescription } from "./knowledge-tools-factory.js";
+export { validateReadonlyCypher, validateReadonlySql } from "./query-validators.js";
+export { createMemorySaveTool } from "./memory-save.tool.js";
 //# sourceMappingURL=index.js.map

package/dist/lib/tools/built-in/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/tools/built-in/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../lib/tools/built-in/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,8BAA8B,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AACjG,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/lib/tools/built-in/knowledge-entity-lookup.tool.d.ts

@@ -0,0 +1,9 @@
+import type { StructuredTool } from '../../types/llm-types.ts';
+import type { SqliteStore } from '../../knowledge/sqlite-store.ts';
+import type { KnowledgeConfig } from '../../knowledge/types.ts';
+/**
+ * Create an entity lookup tool for a knowledge base with entities.
+ * Find entities by name, ID, or type.
+ */
+export declare function createKnowledgeEntityLookupTool(name: string, config: KnowledgeConfig, sqliteStore: SqliteStore): StructuredTool;
+//# sourceMappingURL=knowledge-entity-lookup.tool.d.ts.map

package/dist/lib/tools/built-in/knowledge-entity-lookup.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-entity-lookup.tool.d.ts","sourceRoot":"","sources":["../../../../lib/tools/built-in/knowledge-entity-lookup.tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,iCAAiC,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGhE;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EACvB,WAAW,EAAE,WAAW,GACvB,cAAc,CAqEhB"}

package/dist/lib/tools/built-in/knowledge-entity-lookup.tool.js

@@ -0,0 +1,102 @@
+import { tool } from "../../types/tool-factory.js";
+import { z } from 'zod';
+import { buildGraphSchemaDescription } from "./knowledge-tools-factory.js";
+/**
+ * Create an entity lookup tool for a knowledge base with entities.
+ * Find entities by name, ID, or type.
+ */
+export function createKnowledgeEntityLookupTool(name, config, sqliteStore) {
+    const schemaInfo = buildGraphSchemaDescription(config);
+    return tool(async ({ id, name: entityName, type, limit }) => {
+        const effectiveLimit = Math.min(limit ?? 10, 50);
+        // Direct ID lookup
+        if (id) {
+            try {
+                const entity = sqliteStore.getEntity(id);
+                if (!entity) {
+                    return `No entity found with ID "${id}".`;
+                }
+                return formatEntities([entity]);
+            }
+            catch (error) {
+                return `Lookup error: ${error instanceof Error ? error.message : String(error)}`;
+            }
+        }
+        // Name and/or type search
+        try {
+            const allEntities = sqliteStore.getAllEntities();
+            let filtered = allEntities;
+            // Filter by type first (exact match, case-insensitive)
+            if (type) {
+                const typeLower = type.toLowerCase();
+                filtered = filtered.filter((e) => e.type.toLowerCase() === typeLower);
+            }
+            // Filter by name (partial match, case-insensitive)
+            if (entityName) {
+                const nameLower = entityName.toLowerCase();
+                filtered = filtered.filter((e) => e.name.toLowerCase().includes(nameLower) || e.id.toLowerCase().includes(nameLower));
+            }
+            if (filtered.length === 0) {
+                const criteria = [];
+                if (entityName)
+                    criteria.push(`name="${entityName}"`);
+                if (type)
+                    criteria.push(`type="${type}"`);
+                return `No entities found matching ${criteria.join(', ')}.`;
+            }
+            const results = filtered.slice(0, effectiveLimit);
+            const total = filtered.length;
+            return formatEntities(results, total > effectiveLimit ? total : undefined);
+        }
+        catch (error) {
+            return `Lookup error: ${error instanceof Error ? error.message : String(error)}`;
+        }
+    }, {
+        name: `knowledge_entity_lookup_${name}`,
+        description: `Find entities in the "${name}" knowledge graph by name, ID, or type. Returns entity details including properties.
+
+${schemaInfo}
+
+TIPS: Use type filter to browse entities of a specific kind. Use name for searching. Use the returned entity IDs with knowledge_traverse_${name} to explore relationships.`,
+        schema: z.object({
+            id: z.string().optional().describe('Exact entity ID to look up (takes precedence over name/type filters)'),
+            name: z.string().optional().describe('Search entities by name (case-insensitive partial match)'),
+            type: z.string().optional().describe('Filter by entity type (case-insensitive exact match)'),
+            limit: z.number().optional().describe('Max results to return (default 10, max 50)'),
+        }),
+    });
+}
+function formatEntities(entities, totalCount) {
+    const lines = [];
+    if (totalCount) {
+        lines.push(`Found ${totalCount} entities (showing ${entities.length}):\n`);
+    }
+    else {
+        lines.push(`Found ${entities.length} entity(ies):\n`);
+    }
+    for (const entity of entities) {
+        lines.push(`[${entity.type}] ${entity.name}`);
+        lines.push(`  ID: ${entity.id}`);
+        if (entity.description) {
+            lines.push(`  Description: ${entity.description.substring(0, 200)}`);
+        }
+        // Show key properties
+        try {
+            const props = JSON.parse(entity.properties);
+            const entries = Object.entries(props).filter(([key]) => !['sourceChunkIds', 'embedding'].includes(key));
+            if (entries.length > 0) {
+                const propStrs = entries
+                    .slice(0, 8)
+                    .map(([k, v]) => {
+                    const val = typeof v === 'string' && v.length > 80 ? v.substring(0, 80) + '...' : v;
+                    return `${k}: ${val}`;
+                });
+                lines.push(`  Properties: ${propStrs.join(', ')}`);
+            }
+        }
+        catch { /* properties not valid JSON */ }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=knowledge-entity-lookup.tool.js.map

package/dist/lib/tools/built-in/knowledge-entity-lookup.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-entity-lookup.tool.js","sourceRoot":"","sources":["../../../../lib/tools/built-in/knowledge-entity-lookup.tool.ts"],"names":[],"mappings":"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"}

package/dist/lib/tools/built-in/knowledge-graph-schema.tool.d.ts

@@ -0,0 +1,9 @@
+import type { StructuredTool } from '../../types/llm-types.ts';
+import type { SqliteStore } from '../../knowledge/sqlite-store.ts';
+import type { KnowledgeConfig } from '../../knowledge/types.ts';
+/**
+ * Create a graph schema discovery tool for a knowledge base with entities.
+ * Shows entity types, relationship types, and counts.
+ */
+export declare function createKnowledgeGraphSchemaTool(name: string, config: KnowledgeConfig, sqliteStore: SqliteStore): StructuredTool;
+//# sourceMappingURL=knowledge-graph-schema.tool.d.ts.map

package/dist/lib/tools/built-in/knowledge-graph-schema.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph-schema.tool.d.ts","sourceRoot":"","sources":["../../../../lib/tools/built-in/knowledge-graph-schema.tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,EACvB,WAAW,EAAE,WAAW,GACvB,cAAc,CAsGhB"}

package/dist/lib/tools/built-in/knowledge-graph-schema.tool.js

@@ -0,0 +1,96 @@
+import { tool } from "../../types/tool-factory.js";
+import { z } from 'zod';
+/**
+ * Create a graph schema discovery tool for a knowledge base with entities.
+ * Shows entity types, relationship types, and counts.
+ */
+export function createKnowledgeGraphSchemaTool(name, config, sqliteStore) {
+    return tool(async ({ includeExamples }) => {
+        try {
+            const allEntities = sqliteStore.getAllEntities();
+            const allRelationships = sqliteStore.getAllRelationships();
+            // Group entities by type
+            const entitiesByType = new Map();
+            for (const entity of allEntities) {
+                const list = entitiesByType.get(entity.type) ?? [];
+                list.push(entity);
+                entitiesByType.set(entity.type, list);
+            }
+            // Group relationships by type
+            const relsByType = new Map();
+            for (const rel of allRelationships) {
+                const list = relsByType.get(rel.type) ?? [];
+                list.push(rel);
+                relsByType.set(rel.type, list);
+            }
+            const sections = [];
+            sections.push(`GRAPH SCHEMA for "${name}"`);
+            sections.push(`Total: ${allEntities.length} entities, ${allRelationships.length} relationships\n`);
+            // Entity types
+            sections.push('ENTITY TYPES:');
+            for (const [type, entities] of entitiesByType) {
+                // Collect property keys from this type
+                const propKeys = new Set();
+                for (const entity of entities.slice(0, 20)) {
+                    try {
+                        const props = JSON.parse(entity.properties);
+                        for (const key of Object.keys(props)) {
+                            propKeys.add(key);
+                        }
+                    }
+                    catch { /* */ }
+                }
+                sections.push(`  ${type} (${entities.length} entities)`);
+                if (propKeys.size > 0) {
+                    sections.push(`    Properties: ${Array.from(propKeys).join(', ')}`);
+                }
+                if (includeExamples) {
+                    const examples = entities.slice(0, 3);
+                    for (const ex of examples) {
+                        const desc = ex.description ? ` — ${ex.description.substring(0, 80)}` : '';
+                        sections.push(`    Example: ${ex.name}${desc}`);
+                    }
+                }
+            }
+            // Relationship types
+            sections.push('\nRELATIONSHIP TYPES:');
+            for (const [type, rels] of relsByType) {
+                sections.push(`  ${type} (${rels.length} relationships)`);
+                if (includeExamples && rels.length > 0) {
+                    const examples = rels.slice(0, 3);
+                    for (const ex of examples) {
+                        const desc = ex.description ? ` — ${ex.description.substring(0, 80)}` : '';
+                        sections.push(`    Example: (${ex.source_id}) -[${type}]-> (${ex.target_id})${desc}`);
+                    }
+                }
+            }
+            // Configured types from YAML (for reference)
+            if (config.graph?.directMapping) {
+                sections.push('\nCONFIGURED MAPPING (from YAML):');
+                for (const entity of config.graph.directMapping.entities) {
+                    const props = entity.properties.map((p) => typeof p === 'string' ? p : Object.values(p)[0]);
+                    sections.push(`  Entity: ${entity.type} (id: ${entity.idColumn}, name: ${entity.nameColumn ?? entity.idColumn})`);
+                    sections.push(`    Mapped properties: ${props.join(', ')}`);
+                }
+                if (config.graph.directMapping.relationships) {
+                    for (const rel of config.graph.directMapping.relationships) {
+                        sections.push(`  Relationship: (${rel.source}) -[${rel.type}]-> (${rel.target})`);
+                    }
+                }
+            }
+            return sections.join('\n');
+        }
+        catch (error) {
+            return `Schema discovery error: ${error instanceof Error ? error.message : String(error)}`;
+        }
+    }, {
+        name: `knowledge_graph_schema_${name}`,
+        description: `Discover the schema of the "${name}" knowledge graph — entity types, relationship types, property names, counts, and database table definitions. Use this FIRST when exploring an unfamiliar graph to understand its structure before running queries.
+
+TIPS: Call with includeExamples=true to see sample entities of each type. Use the entity types and relationship types from the output to write precise traversal queries.`,
+        schema: z.object({
+            includeExamples: z.boolean().optional().describe('Include 2-3 example entities per type (default: false)'),
+        }),
+    });
+}
+//# sourceMappingURL=knowledge-graph-schema.tool.js.map

package/dist/lib/tools/built-in/knowledge-graph-schema.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-graph-schema.tool.js","sourceRoot":"","sources":["../../../../lib/tools/built-in/knowledge-graph-schema.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAC5C,IAAY,EACZ,MAAuB,EACvB,WAAwB;IAExB,OAAO,IAAI,CACT,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE;QAC5B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,WAAW,CAAC,cAAc,EAAE,CAAC;YACjD,MAAM,gBAAgB,GAAG,WAAW,CAAC,mBAAmB,EAAE,CAAC;YAE3D,yBAAyB;YACzB,MAAM,cAAc,GAAG,IAAI,GAAG,EAA8B,CAAC;YAC7D,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;gBACjC,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACnD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAClB,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACxC,CAAC;YAED,8BAA8B;YAC9B,MAAM,UAAU,GAAG,IAAI,GAAG,EAAmC,CAAC;YAC9D,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;gBACnC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACf,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACjC,CAAC;YAED,MAAM,QAAQ,GAAa,EAAE,CAAC;YAE9B,QAAQ,CAAC,IAAI,CAAC,qBAAqB,IAAI,GAAG,CAAC,CAAC;YAC5C,QAAQ,CAAC,IAAI,CAAC,UAAU,WAAW,CAAC,MAAM,cAAc,gBAAgB,CAAC,MAAM,kBAAkB,CAAC,CAAC;YAEnG,eAAe;YACf,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC/B,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,cAAc,EAAE,CAAC;gBAC9C,uCAAuC;gBACvC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;gBACnC,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;oBAC3C,IAAI,CAAC;wBACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;wBAC5C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;4BACrC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;wBACpB,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;gBACnB,CAAC;gBAED,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,QAAQ,CAAC,MAAM,YAAY,CAAC,CAAC;gBACzD,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;oBACtB,QAAQ,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACtE,CAAC;gBAED,IAAI,eAAe,EAAE,CAAC;oBACpB,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACtC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;wBAC1B,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC3E,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;oBAClD,CAAC;gBACH,CAAC;YACH,CAAC;YAED,qBAAqB;YACrB,QAAQ,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;YACvC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,UAAU,EAAE,CAAC;gBACtC,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC,MAAM,iBAAiB,CAAC,CAAC;gBAE1D,IAAI,eAAe,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBAClC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;wBAC1B,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC3E,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC,SAAS,OAAO,IAAI,QAAQ,EAAE,CAAC,SAAS,IAAI,IAAI,EAAE,CAAC,CAAC;oBACxF,CAAC;gBACH,CAAC;YACH,CAAC;YAED,6CAA6C;YAC7C,IAAI,MAAM,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC;gBAChC,QAAQ,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;gBACnD,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;oBACzD,MAAM,KAAK,GAAI,MAAM,CAAC,UAAoB,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CACxD,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAChD,CAAC;oBACF,QAAQ,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,IAAI,SAAS,MAAM,CAAC,QAAQ,WAAW,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC;oBAClH,QAAQ,CAAC,IAAI,CAAC,0BAA0B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAC9D,CAAC;gBACD,IAAI,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,aAAa,EAAE,CAAC;oBAC7C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,aAAa,EAAE,CAAC;wBAC3D,QAAQ,CAAC,IAAI,CAAC,oBAAoB,GAAG,CAAC,MAAM,OAAO,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;oBACpF,CAAC;gBACH,CAAC;YACH,CAAC;YAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7F,CAAC;IACH,CAAC,EACD;QACE,IAAI,EAAE,0BAA0B,IAAI,EAAE;QACtC,WAAW,EAAE,+BAA+B,IAAI;;0KAEoH;QACpK,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;SAC3G,CAAC;KACH,CACF,CAAC;AACJ,CAAC"}

package/dist/lib/tools/built-in/knowledge-search.tool.d.ts

@@ -1,4 +1,4 @@
-import type { StructuredTool } from '@langchain/core/tools';
-import type { KnowledgeStoreInstance } from '../../knowledge/types.js';
+import type { StructuredTool } from '../../types/llm-types.ts';
+import type { KnowledgeStoreInstance } from '../../knowledge/types.ts';
 export declare function createKnowledgeSearchTool(name: string, store: KnowledgeStoreInstance): StructuredTool;
 //# sourceMappingURL=knowledge-search.tool.d.ts.map

package/dist/lib/tools/built-in/knowledge-search.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-search.tool.d.ts","sourceRoot":"","sources":["../../../../lib/tools/built-in/knowledge-search.tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,GAAG,cAAc,CA4BrG"}
+{"version":3,"file":"knowledge-search.tool.d.ts","sourceRoot":"","sources":["../../../../lib/tools/built-in/knowledge-search.tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,GAAG,cAAc,CA4BrG"}

package/dist/lib/tools/built-in/knowledge-search.tool.js

@@ -1,4 +1,4 @@
-import { tool } from '@langchain/core/tools';
+import { tool } from "../../types/tool-factory.js";
 import { z } from 'zod';
 export function createKnowledgeSearchTool(name, store) {
     return tool(async ({ query, k }) => {

package/dist/lib/tools/built-in/knowledge-search.tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"knowledge-search.tool.js","sourceRoot":"","sources":["../../../../lib/tools/built-in/knowledge-search.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,yBAAyB,CAAC,IAAY,EAAE,KAA6B;IACnF,OAAO,IAAI,CACT,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE;QACrB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAE7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,8BAA8B,CAAC;QACxC,CAAC;QAED,OAAO,OAAO;aACX,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YACrB,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;iBAC7C,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,KAAK,EAAE,CAAC;iBACzC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,OAAO,IAAI,KAAK,GAAG,CAAC,aAAa,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC;QACpH,CAAC,CAAC;aACD,IAAI,CAAC,aAAa,CAAC,CAAC;IACzB,CAAC,EACD;QACE,IAAI,EAAE,oBAAoB,IAAI,EAAE;QAChC,WAAW,EAAE,eAAe,IAAI,6CAA6C,KAAK,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,sOAAsO;QACjV,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sKAAsK,CAAC;YAClM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;SAC9E,CAAC;KACH,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"knowledge-search.tool.js","sourceRoot":"","sources":["../../../../lib/tools/built-in/knowledge-search.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,yBAAyB,CAAC,IAAY,EAAE,KAA6B;IACnF,OAAO,IAAI,CACT,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE;QACrB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAE7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,8BAA8B,CAAC;QACxC,CAAC;QAED,OAAO,OAAO;aACX,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YACrB,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;iBAC7C,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,KAAK,EAAE,CAAC;iBACzC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,OAAO,IAAI,KAAK,GAAG,CAAC,aAAa,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC;QACpH,CAAC,CAAC;aACD,IAAI,CAAC,aAAa,CAAC,CAAC;IACzB,CAAC,EACD;QACE,IAAI,EAAE,oBAAoB,IAAI,EAAE;QAChC,WAAW,EAAE,eAAe,IAAI,6CAA6C,KAAK,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,sOAAsO;QACjV,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sKAAsK,CAAC;YAClM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;SAC9E,CAAC;KACH,CACF,CAAC;AACJ,CAAC"}

package/dist/lib/tools/built-in/knowledge-sql.tool.d.ts

@@ -0,0 +1,7 @@
+import type { StructuredTool } from '../../types/llm-types.ts';
+import type { KnowledgeConfig } from '../../knowledge/types.ts';
+/**
+ * Create a SQL query tool for a knowledge base backed by a database source.
+ */
+export declare function createKnowledgeSqlTool(name: string, config: KnowledgeConfig): StructuredTool;
+//# sourceMappingURL=knowledge-sql.tool.d.ts.map

package/dist/lib/tools/built-in/knowledge-sql.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-sql.tool.d.ts","sourceRoot":"","sources":["../../../../lib/tools/built-in/knowledge-sql.tool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,0BAA0B,CAAC;AAItF;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,GACtB,cAAc,CAsDhB"}