@primo-ai/tools 0.1.0

package/README.md

@@ -0,0 +1,49 @@
+# @primo-ai/tools
+
+Built-in tool implementations for AgentForge.
+
+## Overview
+
+Provides ready-to-use tools that can be passed to any AgentForge agent. Tools follow the `Tool<TInput, TOutput>` interface from `@primo-ai/sdk`.
+
+## Available Tools
+
+### echo
+
+Returns the input message unchanged. Useful for testing and debugging.
+
+```typescript
+import { echoTool } from '@primo-ai/tools';
+import { Agent } from '@primo-ai/core';
+
+const agent = new Agent({
+  model: 'deepseek/deepseek-v4-flash',
+  tools: [echoTool],
+});
+```
+
+**Schema:** `{ message: string }`
+**Output:** `string` (the input message)
+
+## Writing a Custom Tool
+
+Tools use Zod schemas for input validation:
+
+```typescript
+import { z } from 'zod';
+import type { Tool } from '@primo-ai/sdk';
+
+const myTool: Tool<{ query: string }, string> = {
+  name: 'search',
+  description: 'Search for information',
+  inputSchema: z.object({ query: z.string().describe('Search query') }),
+  execute: async ({ query }) => {
+    return `Results for: ${query}`;
+  },
+};
+```
+
+## Dependencies
+
+- `@primo-ai/sdk` -- `Tool` interface and type definitions
+- `zod` -- Schema validation

package/dist/echo.d.ts

@@ -0,0 +1,5 @@
+import type { Tool } from '@primo-ai/sdk';
+export declare const echoTool: Tool<{
+    message: string;
+}, string>;
+//# sourceMappingURL=echo.d.ts.map

package/dist/echo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo.d.ts","sourceRoot":"","sources":["../src/echo.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1C,eAAO,MAAM,QAAQ,EAAE,IAAI,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,CAKtD,CAAC"}

package/dist/echo.js

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export const echoTool = {
+    name: 'echo',
+    description: 'Returns the input message unchanged. Useful for testing.',
+    inputSchema: z.object({ message: z.string() }),
+    execute: async ({ message }) => message,
+};
+//# sourceMappingURL=echo.js.map

package/dist/echo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo.js","sourceRoot":"","sources":["../src/echo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,CAAC,MAAM,QAAQ,GAAsC;IACzD,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,0DAA0D;IACvE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAC9C,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO;CACxC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { echoTool } from './echo.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+// @primo-ai/tools — Built-in tools
+export { echoTool } from './echo.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@primo-ai/tools",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run --passWithNoTests",
+    "check-types": "tsc --noEmit",
+    "lint": "eslint src __tests__"
+  },
+  "devDependencies": {
+    "@primo-ai/sdk": "workspace:*",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.5"
+  },
+  "dependencies": {
+    "zod": "^4.4.3"
+  }
+}