Merge pull request #9 from statelyai/davidkpiano/tools

Add tool choice

.changeset/rude-mice-add.md

@@ -0,0 +1,31 @@
+---
+'@statelyai/agent': patch
+---
+
+Add `adapter.fromTool(…)`, which creates an actor that chooses agent logic based on a input.
+
+```ts
+const actor = adapter.fromTool(() => 'Draw me a picture of a donut', {
+  // tools
+  makeIllustration: {
+    description: 'Makes an illustration',
+    run: async (input) => {
+      /* ... */
+    },
+    inputSchema: {
+      /* ... */
+    },
+  },
+  getWeather: {
+    description: 'Gets the weather',
+    run: async (input) => {
+      /* ... */
+    },
+    inputSchema: {
+      /* ... */
+    },
+  },
+});
+
+//...
+```

.vscode/launch.json

@@ -1,17 +1,17 @@
 {
-  // Use IntelliSense to learn about possible attributes.
-  // Hover to view descriptions of existing attributes.
   // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
   "version": "0.2.0",
   "configurations": [
     {
       "type": "node",
       "request": "launch",
-      "name": "Launch Program",
-      "skipFiles": ["<node_internals>/**"],
-      "program": "${file}",
-      "preLaunchTask": "tsc: build - tsconfig.json",
-      "outFiles": ["${workspaceFolder}/**/*.js"]
+      "name": "Debug Current Test File",
+      "autoAttachChildProcesses": true,
+      "skipFiles": ["<node_internals>/**", "**/node_modules/**"],
+      "program": "${workspaceRoot}/node_modules/vitest/vitest.mjs",
+      "args": ["run", "${relativeFile}"],
+      "smartStep": true,
+      "console": "integratedTerminal"
     }
   ]
 }

examples/joke.ts

@@ -61,7 +61,7 @@ const getTopic = fromPromise(async () => {
   return topic;
 });
 
-const decide = adapter.fromEventChoice(
+const decide = adapter.fromEvent(
   (lastRating: string) =>
     `Choose what to do next, given the previous rating of the joke: ${lastRating}`
 );

examples/ticTacToe.ts

@@ -80,7 +80,7 @@ const initialContext = {
   events: [],
 } satisfies typeof schemas.types.context;
 
-const bot = adapter.fromEventChoice(
+const bot = adapter.fromEvent(
   ({ context }: { context: typeof schemas.types.context }) => `
 You are playing a game of tic tac toe. This is the current game state. The 3x3 board is represented by a 9-element array. The first element is the top-left cell, the second element is the top-middle cell, the third element is the top-right cell, the fourth element is the middle-left cell, and so on. The value of each cell is either null, x, or o. The value of null means that the cell is empty. The value of x means that the cell is occupied by an x. The value of o means that the cell is occupied by an o.
 

examples/weather.ts

@@ -84,7 +84,7 @@ const machine = setup({
   types: schemas.types,
   actors: {
     getWeather,
-    decide: adapter.fromEventChoice(
+    decide: adapter.fromEvent(
       (input: string) =>
         `Decide what to do based on the given input, which may or may not be a location: ${input}`
     ),

package.json

@@ -27,7 +27,8 @@
     "openai": "^4.24.1",
     "ts-node": "^10.9.2",
     "tsup": "^8.0.1",
-    "typescript": "^5.3.3"
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.2"
   },
   "publishConfig": {
     "access": "public"