@link-assistant/agent 0.0.9 → 0.0.11

package/TOOLS.md

@@ -7,24 +7,28 @@ This document lists all tools supported by `@link-assistant/agent`. All tools ar
 ## File Operations
 
 ### read
+
 Reads file contents from the filesystem.
 
 **Status:** ✅ Fully supported and tested
 **Test:** [tests/read.tools.test.js](tests/read.tools.test.js)
 
 ### write
+
 Writes content to files in the filesystem.
 
 **Status:** ✅ Fully supported and tested
 **Test:** [tests/write.tools.test.js](tests/write.tools.test.js)
 
 ### edit
+
 Performs exact string replacements in files.
 
 **Status:** ✅ Fully supported and tested
 **Test:** [tests/edit.tools.test.js](tests/edit.tools.test.js)
 
 ### list (ls)
+
 Lists files and directories.
 
 **Status:** ✅ Fully supported and tested
@@ -33,18 +37,21 @@ Lists files and directories.
 ## Search Tools
 
 ### glob
+
 Fast file pattern matching tool that works with any codebase size. Supports glob patterns like `**/*.js` or `src/**/*.ts`.
 
 **Status:** ✅ Fully supported and tested
 **Test:** [tests/glob.tools.test.js](tests/glob.tools.test.js)
 
 ### grep
+
 Powerful search tool built on ripgrep. Supports full regex syntax and can filter by file type or glob pattern.
 
 **Status:** ✅ Fully supported and tested
 **Test:** [tests/grep.tools.test.js](tests/grep.tools.test.js)
 
 ### websearch
+
 Searches the web using Exa API for current information. Always enabled, no environment variables required.
 
 **Status:** ✅ Fully supported and tested
@@ -52,6 +59,7 @@ Searches the web using Exa API for current information. Always enabled, no envir
 **OpenCode Compatibility:** ✅ 100% compatible
 
 ### codesearch
+
 Searches code repositories and documentation using Exa API. Always enabled.
 
 **Status:** ✅ Fully supported and tested
@@ -61,18 +69,21 @@ Searches code repositories and documentation using Exa API. Always enabled.
 ## Execution Tools
 
 ### bash
+
 Executes bash commands in a persistent shell session with optional timeout.
 
 **Status:** ✅ Fully supported and tested
 **Test:** [tests/bash.tools.test.js](tests/bash.tools.test.js)
 
 ### batch
+
 Batches multiple tool calls together for optimal performance. Executes multiple tools in a single operation. Always enabled.
 
 **Status:** ✅ Fully supported and tested
 **Test:** [tests/batch.tools.test.js](tests/batch.tools.test.js)
 
 ### task
+
 Launches specialized agents to handle complex, multi-step tasks autonomously.
 
 **Status:** ✅ Fully supported and tested
@@ -81,12 +92,14 @@ Launches specialized agents to handle complex, multi-step tasks autonomously.
 ## Utility Tools
 
 ### todo (todowrite/todoread)
+
 Reads and writes TODO items for task tracking during execution.
 
 **Status:** ✅ Fully supported and tested
 **Test:** [tests/todo.tools.test.js](tests/todo.tools.test.js)
 
 ### webfetch
+
 Fetches content from a specified URL and processes it using an AI model.
 
 **Status:** ✅ Fully supported and tested
@@ -95,18 +108,22 @@ Fetches content from a specified URL and processes it using an AI model.
 ## Testing
 
 ### Run All Tool Tests
+
 ```bash
 bun test tests/*.tools.test.js
 ```
 
 ### Run Specific Tool Test
+
 ```bash
 bun test tests/bash.tools.test.js
 bun test tests/websearch.tools.test.js
 ```
 
 ### Test Coverage
+
 Each tool test verifies:
+
 - ✅ Correct JSON output structure
 - ✅ OpenCode compatibility (where applicable)
 - ✅ Proper input/output handling
@@ -115,16 +132,19 @@ Each tool test verifies:
 ## Key Features
 
 ### No Configuration Required
+
 - All tools work without environment variables or configuration files
 - WebSearch and CodeSearch work without `OPENCODE_EXPERIMENTAL_EXA`
 - Batch tool is always enabled, no experimental flag needed
 
 ### OpenCode Compatible
+
 - All tools produce JSON output compatible with OpenCode's format
 - WebSearch and CodeSearch tools are 100% compatible with OpenCode output
 - Tool event structure matches OpenCode specifications
 
 ### Plain Text Input Support
+
 `@link-assistant/agent` also accepts plain text input (not just JSON):
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/agent",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "A minimal, public domain AI CLI agent compatible with OpenCode's JSON interface. Bun-only runtime.",
   "main": "src/index.js",
   "type": "module",
@@ -8,7 +8,19 @@
     "agent": "./src/index.js"
   },
   "scripts": {
-    "dev": "bun run src/index.js"
+    "dev": "bun run src/index.js",
+    "test": "bun test",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "check:file-size": "node scripts/check-file-size.mjs",
+    "check": "npm run lint && npm run format:check && npm run check:file-size",
+    "prepare": "husky || true",
+    "changeset": "changeset",
+    "changeset:version": "node scripts/changeset-version.mjs",
+    "changeset:publish": "changeset publish",
+    "changeset:status": "changeset status --since=origin/main"
   },
   "engines": {
     "bun": ">=1.0.0"
@@ -86,5 +98,26 @@
     "yargs": "^18.0.0",
     "zod": "^4.1.12"
   },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.7",
+    "@eslint/js": "^9.18.0",
+    "eslint": "^9.38.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.6",
+    "prettier": "^3.6.2"
+  },
+  "lint-staged": {
+    "*.{js,mjs,cjs}": [
+      "eslint --fix --max-warnings 0",
+      "prettier --write",
+      "prettier --check"
+    ],
+    "*.md": [
+      "prettier --write",
+      "prettier --check"
+    ]
+  },
   "license": "Unlicense"
 }

package/src/agent/agent.ts

@@ -1,18 +1,18 @@
-import { Config } from "../config/config"
-import z from "zod"
-import { Provider } from "../provider/provider"
-import { generateObject, type ModelMessage } from "ai"
-import PROMPT_GENERATE from "./generate.txt"
-import { SystemPrompt } from "../session/system"
-import { Instance } from "../project/instance"
-import { mergeDeep } from "remeda"
+import { Config } from '../config/config';
+import z from 'zod';
+import { Provider } from '../provider/provider';
+import { generateObject, type ModelMessage } from 'ai';
+import PROMPT_GENERATE from './generate.txt';
+import { SystemPrompt } from '../session/system';
+import { Instance } from '../project/instance';
+import { mergeDeep } from 'remeda';
 
 export namespace Agent {
   export const Info = z
     .object({
       name: z.string(),
       description: z.string().optional(),
-      mode: z.enum(["subagent", "primary", "all"]),
+      mode: z.enum(['subagent', 'primary', 'all']),
       builtIn: z.boolean(),
       topP: z.number().optional(),
       temperature: z.number().optional(),
@@ -28,112 +28,126 @@ export namespace Agent {
       options: z.record(z.string(), z.any()),
     })
     .meta({
-      ref: "Agent",
-    })
-  export type Info = z.infer<typeof Info>
+      ref: 'Agent',
+    });
+  export type Info = z.infer<typeof Info>;
 
   const state = Instance.state(async () => {
-    const cfg = await Config.get()
-    const defaultTools = cfg.tools ?? {}
+    const cfg = await Config.get();
+    const defaultTools = cfg.tools ?? {};
 
     const result: Record<string, Info> = {
       general: {
-        name: "general",
+        name: 'general',
         description:
-          "General-purpose agent for researching complex questions, searching for code, and executing multi-step tasks. When you are searching for a keyword or file and are not confident that you will find the right match in the first few tries use this agent to perform the search for you.",
+          'General-purpose agent for researching complex questions, searching for code, and executing multi-step tasks. When you are searching for a keyword or file and are not confident that you will find the right match in the first few tries use this agent to perform the search for you.',
         tools: {
           todoread: false,
           todowrite: false,
           ...defaultTools,
         },
         options: {},
-        mode: "subagent",
+        mode: 'subagent',
         builtIn: true,
       },
       build: {
-        name: "build",
+        name: 'build',
         tools: { ...defaultTools },
         options: {},
-        mode: "primary",
+        mode: 'primary',
         builtIn: true,
       },
       plan: {
-        name: "plan",
+        name: 'plan',
         options: {},
         tools: {
           ...defaultTools,
         },
-        mode: "primary",
+        mode: 'primary',
         builtIn: true,
       },
-    }
+    };
     for (const [key, value] of Object.entries(cfg.agent ?? {})) {
       if (value.disable) {
-        delete result[key]
-        continue
+        delete result[key];
+        continue;
       }
-      let item = result[key]
+      let item = result[key];
       if (!item)
         item = result[key] = {
           name: key,
-          mode: "all",
+          mode: 'all',
           options: {},
           tools: {},
           builtIn: false,
-        }
-      const { name, model, prompt, tools, description, temperature, top_p, mode, color, ...extra } = value
+        };
+      const {
+        name,
+        model,
+        prompt,
+        tools,
+        description,
+        temperature,
+        top_p,
+        mode,
+        color,
+        ...extra
+      } = value;
       item.options = {
         ...item.options,
         ...extra,
-      }
-      if (model) item.model = Provider.parseModel(model)
-      if (prompt) item.prompt = prompt
+      };
+      if (model) item.model = Provider.parseModel(model);
+      if (prompt) item.prompt = prompt;
       if (tools)
         item.tools = {
           ...item.tools,
           ...tools,
-        }
+        };
       item.tools = {
         ...defaultTools,
         ...item.tools,
-      }
-      if (description) item.description = description
-      if (temperature != undefined) item.temperature = temperature
-      if (top_p != undefined) item.topP = top_p
-      if (mode) item.mode = mode
-      if (color) item.color = color
+      };
+      if (description) item.description = description;
+      if (temperature != undefined) item.temperature = temperature;
+      if (top_p != undefined) item.topP = top_p;
+      if (mode) item.mode = mode;
+      if (color) item.color = color;
       // just here for consistency & to prevent it from being added as an option
-      if (name) item.name = name
+      if (name) item.name = name;
     }
-    return result
-  })
+    return result;
+  });
 
   export async function get(agent: string) {
-    return state().then((x) => x[agent])
+    return state().then((x) => x[agent]);
   }
 
   export async function list() {
-    return state().then((x) => Object.values(x))
+    return state().then((x) => Object.values(x));
   }
 
   export async function generate(input: { description: string }) {
-    const defaultModel = await Provider.defaultModel()
-    const model = await Provider.getModel(defaultModel.providerID, defaultModel.modelID)
-    const system = SystemPrompt.header(defaultModel.providerID)
-    system.push(PROMPT_GENERATE)
-    const existing = await list()
+    const defaultModel = await Provider.defaultModel();
+    const model = await Provider.getModel(
+      defaultModel.providerID,
+      defaultModel.modelID
+    );
+    const system = SystemPrompt.header(defaultModel.providerID);
+    system.push(PROMPT_GENERATE);
+    const existing = await list();
     const result = await generateObject({
       temperature: 0.3,
       prompt: [
         ...system.map(
           (item): ModelMessage => ({
-            role: "system",
+            role: 'system',
             content: item,
-          }),
+          })
         ),
         {
-          role: "user",
-          content: `Create an agent configuration based on this request: \"${input.description}\".\n\nIMPORTANT: The following identifiers already exist and must NOT be used: ${existing.map((i) => i.name).join(", ")}\n  Return ONLY the JSON object, no other text, do not wrap in backticks`,
+          role: 'user',
+          content: `Create an agent configuration based on this request: \"${input.description}\".\n\nIMPORTANT: The following identifiers already exist and must NOT be used: ${existing.map((i) => i.name).join(', ')}\n  Return ONLY the JSON object, no other text, do not wrap in backticks`,
         },
       ],
       model: model.language,
@@ -142,8 +156,8 @@ export namespace Agent {
         whenToUse: z.string(),
         systemPrompt: z.string(),
       }),
-    })
-    return result.object
+    });
+    return result.object;
   }
 }