bigtool-ts 0.1.0

package/dist/types.js

@@ -0,0 +1,97 @@
+/**
+ * Core type definitions for bigtool-ts.
+ *
+ * This module defines the fundamental interfaces that power the tool discovery
+ * system: sources, catalogs, loaders, search, and events.
+ *
+ * @module types
+ */
+/**
+ * Creates a simple typed event emitter.
+ *
+ * @typeParam T - The event payload type
+ * @returns A new EventEmitter instance
+ *
+ * @example
+ * ```typescript
+ * interface MyEvent {
+ *   type: string;
+ *   data: unknown;
+ * }
+ *
+ * const emitter = createEventEmitter<MyEvent>();
+ *
+ * emitter.on((event) => {
+ *   console.log(event.type, event.data);
+ * });
+ *
+ * await emitter.emit({ type: 'test', data: { foo: 'bar' } });
+ * ```
+ */
+export function createEventEmitter() {
+    let handlers = [];
+    const subscribe = (handler) => {
+        handlers = [...handlers, handler];
+        let unsubscribed = false;
+        return () => {
+            if (unsubscribed)
+                return;
+            unsubscribed = true;
+            handlers = handlers.filter((h) => h !== handler);
+        };
+    };
+    return {
+        subscribe,
+        on: subscribe,
+        async emit(event) {
+            const currentHandlers = handlers;
+            for (const handler of currentHandlers) {
+                await handler(event);
+            }
+        },
+        subscriberCount() {
+            return handlers.length;
+        },
+        clear() {
+            handlers = [];
+        },
+    };
+}
+/**
+ * Attach enhancement metadata to a tool.
+ *
+ * This is a fluent helper that adds search optimization hints
+ * to a StructuredTool. The metadata is used during indexing
+ * to improve search results.
+ *
+ * @typeParam T - The tool type (must extend StructuredTool)
+ * @param tool - The tool to enhance
+ * @param metadata - Enhancement metadata (categories, keywords)
+ * @returns The same tool instance with metadata attached
+ *
+ * @example
+ * ```typescript
+ * import { withMetadata } from '@repo/bigtool-ts';
+ *
+ * const createPRTool = new DynamicStructuredTool({
+ *   name: 'create_pr',
+ *   description: 'Creates a GitHub pull request',
+ *   schema: z.object({ title: z.string() }),
+ *   func: async (input) => { ... },
+ * });
+ *
+ * const enhanced = withMetadata(createPRTool, {
+ *   categories: ['github', 'git'],
+ *   keywords: ['PR', 'pull request', 'merge'],
+ * });
+ *
+ * // Use in a LocalSource
+ * const source = new LocalSource([enhanced]);
+ * ```
+ */
+export function withMetadata(tool, metadata) {
+    const enhanced = tool;
+    enhanced.__bigtool_metadata = metadata;
+    return enhanced;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAwGH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAI,QAAQ,GAAsB,EAAE,CAAC;IAErC,MAAM,SAAS,GAAG,CAAC,OAAwB,EAAe,EAAE;QAC1D,QAAQ,GAAG,CAAC,GAAG,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClC,IAAI,YAAY,GAAG,KAAK,CAAC;QACzB,OAAO,GAAG,EAAE;YACV,IAAI,YAAY;gBAAE,OAAO;YACzB,YAAY,GAAG,IAAI,CAAC;YACpB,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;QACnD,CAAC,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO;QACL,SAAS;QACT,EAAE,EAAE,SAAS;QACb,KAAK,CAAC,IAAI,CAAC,KAAQ;YACjB,MAAM,eAAe,GAAG,QAAQ,CAAC;YACjC,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;gBACtC,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;QACH,CAAC;QACD,eAAe;YACb,OAAO,QAAQ,CAAC,MAAM,CAAC;QACzB,CAAC;QACD,KAAK;YACH,QAAQ,GAAG,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAshBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAO,EACP,QAAyB;IAEzB,MAAM,QAAQ,GAAG,IAAwB,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,GAAG,QAAQ,CAAC;IACvC,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,118 @@
+{
+  "name": "bigtool-ts",
+  "version": "0.1.0",
+  "description": "Dynamic tool discovery for AI agents. Search and load tools on-demand instead of loading all tools upfront.",
+  "type": "module",
+  "license": "MIT",
+  "author": "wiski",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/wi-ski/bigtool-ts"
+  },
+  "bugs": {
+    "url": "https://github.com/wi-ski/bigtool-ts/issues"
+  },
+  "homepage": "https://github.com/wi-ski/bigtool-ts#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "langgraph",
+    "langchain",
+    "ai",
+    "tools",
+    "mcp",
+    "model-context-protocol",
+    "semantic-search",
+    "dynamic-tools",
+    "agents",
+    "llm"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./catalog": {
+      "types": "./dist/catalog/index.d.ts",
+      "import": "./dist/catalog/index.js"
+    },
+    "./search": {
+      "types": "./dist/search/index.d.ts",
+      "import": "./dist/search/index.js"
+    },
+    "./loader": {
+      "types": "./dist/loader/index.d.ts",
+      "import": "./dist/loader/index.js"
+    },
+    "./sources": {
+      "types": "./dist/sources/index.d.ts",
+      "import": "./dist/sources/index.js"
+    },
+    "./graph": {
+      "types": "./dist/graph/index.d.ts",
+      "import": "./dist/graph/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    },
+    "./adapters": {
+      "types": "./dist/adapters/index.d.ts",
+      "import": "./dist/adapters/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm run clean && pnpm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@orama/orama": "^3.0.0",
+    "eventemitter3": "^5.0.0",
+    "lru-cache": "^10.0.0",
+    "zod": "^3.23.0"
+  },
+  "peerDependencies": {
+    "@langchain/core": ">=0.2.0",
+    "@langchain/langgraph": ">=0.2.0",
+    "@langchain/openai": ">=0.2.0",
+    "@modelcontextprotocol/sdk": ">=1.0.0",
+    "ai": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@langchain/openai": {
+      "optional": true
+    },
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
+    "ai": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@langchain/core": "^1.0.0",
+    "@langchain/langgraph": "^1.0.0",
+    "@langchain/openai": "^0.3.0",
+    "@types/node": "^20",
+    "typescript": "^5",
+    "vitest": "^2.0.0"
+  }
+}