agent-orcha 0.0.4 → 0.0.7

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/integration-tools.d.ts

@@ -0,0 +1,4 @@
+import type { StructuredTool } from '../../types/llm-types.ts';
+import type { IntegrationAccessor } from '../../integrations/types.ts';
+export declare function createIntegrationTools(accessor: IntegrationAccessor, agentName: string): StructuredTool[];
+//# sourceMappingURL=integration-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"integration-tools.d.ts","sourceRoot":"","sources":["../../../../lib/tools/built-in/integration-tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,EAAE,MAAM,GAChB,cAAc,EAAE,CA2DlB"}

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

@@ -0,0 +1,47 @@
+import { tool } from "../../types/tool-factory.js";
+import { z } from 'zod';
+export function createIntegrationTools(accessor, agentName) {
+    const tools = [];
+    const hasChannel = accessor.hasChannelIntegration(agentName);
+    const hasEmail = accessor.hasEmailIntegration(agentName);
+    if (hasChannel) {
+        tools.push(tool(async ({ message }) => {
+            accessor.postMessage(agentName, message);
+            return 'Message posted to integration channel successfully.';
+        }, {
+            name: 'integration_post',
+            description: 'Post a message to your integration channel. ' +
+                'Use this when asked to report, share, or send information to your channel.',
+            schema: z.object({
+                message: z.string().describe('The message to post to the integration channel'),
+            }),
+        }));
+    }
+    if (hasChannel || hasEmail) {
+        tools.push(tool(async () => {
+            const context = accessor.getChannelContext(agentName);
+            return context || 'No recent messages.';
+        }, {
+            name: 'integration_context',
+            description: 'Get recent messages or emails from your integration. ' +
+                'Use this to understand the current conversation context.',
+            schema: z.object({}),
+        }));
+    }
+    if (hasEmail) {
+        tools.push(tool(async ({ to, subject, body }) => {
+            await accessor.sendEmail(agentName, to, subject, body);
+            return `Email sent to ${to} with subject "${subject}".`;
+        }, {
+            name: 'email_send',
+            description: 'Send an email to a recipient. Use this to compose and send emails.',
+            schema: z.object({
+                to: z.string().describe('Recipient email address'),
+                subject: z.string().describe('Email subject line'),
+                body: z.string().describe('Email body text'),
+            }),
+        }));
+    }
+    return tools;
+}
+//# sourceMappingURL=integration-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"integration-tools.js","sourceRoot":"","sources":["../../../../lib/tools/built-in/integration-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,UAAU,sBAAsB,CACpC,QAA6B,EAC7B,SAAiB;IAEjB,MAAM,KAAK,GAAqB,EAAE,CAAC;IACnC,MAAM,UAAU,GAAG,QAAQ,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAEzD,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CACb,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YACpB,QAAQ,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACzC,OAAO,qDAAqD,CAAC;QAC/D,CAAC,EACD;YACE,IAAI,EAAE,kBAAkB;YACxB,WAAW,EACT,8CAA8C;gBAC9C,4EAA4E;YAC9E,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;aAC/E,CAAC;SACH,CACF,CAAC,CAAC;IACL,CAAC;IAED,IAAI,UAAU,IAAI,QAAQ,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,IAAI,CACb,KAAK,IAAI,EAAE;YACT,MAAM,OAAO,GAAG,QAAQ,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;YACtD,OAAO,OAAO,IAAI,qBAAqB,CAAC;QAC1C,CAAC,EACD;YACE,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EACT,uDAAuD;gBACvD,0DAA0D;YAC5D,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;SACrB,CACF,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,KAAK,CAAC,IAAI,CAAC,IAAI,CACb,KAAK,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;YAC9B,MAAM,QAAQ,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YACvD,OAAO,iBAAiB,EAAE,kBAAkB,OAAO,IAAI,CAAC;QAC1D,CAAC,EACD;YACE,IAAI,EAAE,YAAY;YAClB,WAAW,EACT,oEAAoE;YACtE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;gBACf,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;gBAClD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;gBAClD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;aAC7C,CAAC;SACH,CACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,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,CAyEhB"}

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

@@ -0,0 +1,108 @@
+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, offset }) => {
+        const effectiveLimit = Math.min(limit ?? 10, 50);
+        const effectiveOffset = Math.max(offset ?? 0, 0);
+        // 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 paged = filtered.slice(effectiveOffset);
+            const results = paged.slice(0, effectiveLimit);
+            const total = filtered.length;
+            const hasMore = effectiveOffset + results.length < total;
+            return formatEntities(results, total > effectiveLimit || effectiveOffset > 0 ? total : undefined, effectiveOffset, hasMore);
+        }
+        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. Use offset to paginate through large result sets (e.g., offset=0 then offset=50 to get all entities).`,
+        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)'),
+            offset: z.number().optional().describe('Skip this many results before returning (default 0). Use with limit to paginate.'),
+        }),
+    });
+}
+function formatEntities(entities, totalCount, offset = 0, hasMore = false) {
+    const lines = [];
+    if (totalCount) {
+        const rangeStart = offset + 1;
+        const rangeEnd = offset + entities.length;
+        lines.push(`Found ${totalCount} entities (showing ${rangeStart}-${rangeEnd})${hasMore ? ` — use offset=${rangeEnd} to see more` : ''}:\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":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAE3E;;;GAGG;AACH,MAAM,UAAU,+BAA+B,CAC7C,IAAY,EACZ,MAAuB,EACvB,WAAwB;IAExB,MAAM,UAAU,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAEvD,OAAO,IAAI,CACT,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;QACtD,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACjD,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAEjD,mBAAmB;QACnB,IAAI,EAAE,EAAE,CAAC;YACP,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBACzC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO,4BAA4B,EAAE,IAAI,CAAC;gBAC5C,CAAC;gBACD,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YAClC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,iBAAiB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACnF,CAAC;QACH,CAAC;QAED,0BAA0B;QAC1B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,WAAW,CAAC,cAAc,EAAE,CAAC;YACjD,IAAI,QAAQ,GAAG,WAAW,CAAC;YAE3B,uDAAuD;YACvD,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;gBACrC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,CAAC;YACxE,CAAC;YAED,mDAAmD;YACnD,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;gBAC3C,QAAQ,GAAG,QAAQ,CAAC,MAAM,CACxB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAC1F,CAAC;YACJ,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,QAAQ,GAAa,EAAE,CAAC;gBAC9B,IAAI,UAAU;oBAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,UAAU,GAAG,CAAC,CAAC;gBACtD,IAAI,IAAI;oBAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC;gBAC1C,OAAO,8BAA8B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;YAC9D,CAAC;YAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;YAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;YAC9B,MAAM,OAAO,GAAG,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC;YAEzD,OAAO,cAAc,CAAC,OAAO,EAAE,KAAK,GAAG,cAAc,IAAI,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC;QAC9H,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,iBAAiB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACnF,CAAC;IACH,CAAC,EACD;QACE,IAAI,EAAE,2BAA2B,IAAI,EAAE;QACvC,WAAW,EAAE,yBAAyB,IAAI;;EAE9C,UAAU;;2IAE+H,IAAI,kIAAkI;QAC3Q,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;YACf,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sEAAsE,CAAC;YAC1G,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;YAChG,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;YAC5F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YACnF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kFAAkF,CAAC;SAC3H,CAAC;KACH,CACF,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,QAAqB,EAAE,UAAmB,EAAE,MAAM,GAAG,CAAC,EAAE,OAAO,GAAG,KAAK;IAC7F,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,SAAS,UAAU,sBAAsB,UAAU,IAAI,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,iBAAiB,QAAQ,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7I,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,iBAAiB,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACjC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,sBAAsB;QACtB,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAC1C,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAC1D,CAAC;YACF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,QAAQ,GAAG,OAAO;qBACrB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;qBACX,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;oBACd,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;oBACpF,OAAO,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC;gBACxB,CAAC,CAAC,CAAC;gBACL,KAAK,CAAC,IAAI,CAAC,iBAAiB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,+BAA+B,CAAC,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

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":"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"}

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,CAuDhB"}

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

@@ -0,0 +1,128 @@
+import { tool } from "../../types/tool-factory.js";
+import { z } from 'zod';
+import { getPool, getDatabaseType } from "../../knowledge/utils/connection-pool.js";
+import { validateReadonlySql } from "./query-validators.js";
+/**
+ * Create a SQL query tool for a knowledge base backed by a database source.
+ */
+export function createKnowledgeSqlTool(name, config) {
+    const dbSource = config.source;
+    const dbType = getDatabaseType(dbSource.connectionString);
+    const exampleQueries = buildSqlExamples(dbSource, dbType);
+    return tool(async ({ query, limit }) => {
+        const validation = validateReadonlySql(query);
+        if (!validation.valid) {
+            return `Query rejected: ${validation.reason}`;
+        }
+        const effectiveLimit = Math.min(limit ?? 25, 100);
+        // Strip trailing semicolons and append LIMIT if not already present
+        const trimmed = query.trimEnd().replace(/;+$/, '');
+        const hasLimit = /\bLIMIT\b/i.test(trimmed);
+        const finalQuery = hasLimit ? trimmed : `${trimmed}\nLIMIT ${effectiveLimit}`;
+        try {
+            const pool = getPool(dbSource.connectionString);
+            if (dbType === 'sqlite') {
+                return executeSqliteReadonly(pool, finalQuery);
+            }
+            else if (dbType === 'postgresql') {
+                return await executePostgresReadonly(pool, finalQuery);
+            }
+            else {
+                return await executeMysqlReadonly(pool, finalQuery);
+            }
+        }
+        catch (error) {
+            return `SQL query error: ${error instanceof Error ? error.message : String(error)}`;
+        }
+    }, {
+        name: `knowledge_sql_${name}`,
+        description: `Run a readonly SQL query against the "${name}" source database (${dbType}).
+
+SOURCE QUERY (shows available tables/columns):
+${dbSource.query.trim()}
+
+Content column: ${dbSource.contentColumn}
+${dbSource.metadataColumns ? `Metadata columns: ${dbSource.metadataColumns.join(', ')}` : ''}
+
+EXAMPLE QUERIES:
+${exampleQueries}
+
+RESTRICTIONS: Only SELECT queries allowed. No INSERT, UPDATE, DELETE, DROP, ALTER, TRUNCATE, CREATE, GRANT, or REVOKE.
+
+TIPS: Use this when you need precise filtering, aggregation, or joins that semantic search can't provide. The source query above shows the tables and columns available.`,
+        schema: z.object({
+            query: z.string().describe('A readonly SQL SELECT query'),
+            limit: z.number().optional().describe('Max rows to return (default 25, max 100). Ignored if query already has LIMIT.'),
+        }),
+    });
+}
+async function executePostgresReadonly(pool, query) {
+    const client = await pool.connect();
+    try {
+        await client.query('BEGIN');
+        await client.query('SET TRANSACTION READ ONLY');
+        const result = await client.query(query);
+        await client.query('COMMIT');
+        if (!result.rows || result.rows.length === 0) {
+            return 'Query returned no results.';
+        }
+        return JSON.stringify(result.rows, null, 2);
+    }
+    catch (error) {
+        await client.query('ROLLBACK').catch(() => { });
+        throw error;
+    }
+    finally {
+        client.release();
+    }
+}
+async function executeMysqlReadonly(pool, query) {
+    const connection = await pool.getConnection();
+    try {
+        await connection.query('START TRANSACTION READ ONLY');
+        const [rows] = await connection.query(query);
+        await connection.query('COMMIT');
+        if (!rows || (Array.isArray(rows) && rows.length === 0)) {
+            return 'Query returned no results.';
+        }
+        return JSON.stringify(rows, null, 2);
+    }
+    catch (error) {
+        await connection.query('ROLLBACK').catch(() => { });
+        throw error;
+    }
+    finally {
+        connection.release();
+    }
+}
+function executeSqliteReadonly(db, query) {
+    const rows = db.prepare(query).all();
+    if (!rows || rows.length === 0) {
+        return 'Query returned no results.';
+    }
+    return JSON.stringify(rows, null, 2);
+}
+function buildSqlExamples(dbSource, dbType) {
+    // Parse table names from the original query
+    const tableMatch = dbSource.query.match(/FROM\s+"?(\w+)"?/i);
+    const tableName = tableMatch ? tableMatch[1] : 'table';
+    const contentCol = dbSource.contentColumn;
+    const metaCols = dbSource.metadataColumns ?? [];
+    const examples = [];
+    // Count query
+    examples.push(`- SELECT COUNT(*) FROM "${tableName}"`);
+    // Simple select with content
+    if (metaCols.length > 0) {
+        const selectCols = metaCols.slice(0, 3).map((c) => `"${c}"`).join(', ');
+        examples.push(`- SELECT ${selectCols} FROM "${tableName}" LIMIT 10`);
+    }
+    // Content search — SQLite and MySQL don't support ILIKE
+    const likeOp = dbType === 'postgresql' ? 'ILIKE' : 'LIKE';
+    examples.push(`- SELECT "${contentCol}" FROM "${tableName}" WHERE "${contentCol}" ${likeOp} '%keyword%' LIMIT 10`);
+    // Aggregate if there's a useful column
+    if (metaCols.length > 1) {
+        examples.push(`- SELECT "${metaCols[0]}", COUNT(*) as cnt FROM "${tableName}" GROUP BY "${metaCols[0]}" ORDER BY cnt DESC LIMIT 10`);
+    }
+    return examples.join('\n');
+}
+//# sourceMappingURL=knowledge-sql.tool.js.map

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

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

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

@@ -0,0 +1,17 @@
+import type { StructuredTool } from '../../types/llm-types.ts';
+import type { KnowledgeStoreInstance, KnowledgeConfig } from '../../knowledge/types.ts';
+import type { SqliteStore } from '../../knowledge/sqlite-store.ts';
+/**
+ * Create the full toolset for a knowledge base based on its type.
+ *
+ * - All KBs get: search
+ * - KBs with entities get: search + traverse + entity_lookup + graph_schema
+ * - Database-sourced KBs additionally get: sql
+ */
+export declare function createKnowledgeTools(name: string, store: KnowledgeStoreInstance, sqliteStore?: SqliteStore): StructuredTool[];
+/**
+ * Build a human-readable schema description from a knowledge config with graph.
+ * Used in tool descriptions to help LLMs understand the graph structure.
+ */
+export declare function buildGraphSchemaDescription(config: KnowledgeConfig): string;
+//# sourceMappingURL=knowledge-tools-factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-tools-factory.d.ts","sourceRoot":"","sources":["../../../../lib/tools/built-in/knowledge-tools-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACxF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAUnE;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,sBAAsB,EAC7B,WAAW,CAAC,EAAE,WAAW,GACxB,cAAc,EAAE,CAsBlB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAyB3E"}