@wrongstack/tools 0.1.1 → 0.1.3

package/dist/test.js

@@ -0,0 +1,247 @@
+import * as path from 'path';
+import { spawn } from 'child_process';
+
+// src/test.ts
+function resolvePath(input, ctx) {
+  return path.isAbsolute(input) ? path.normalize(input) : path.resolve(ctx.cwd, input);
+}
+function ensureInsideRoot(absPath, ctx) {
+  const root = path.resolve(ctx.projectRoot);
+  const target = path.resolve(absPath);
+  const rel = path.relative(root, target);
+  if (rel.startsWith("..") || path.isAbsolute(rel)) {
+    throw new Error(`Path "${absPath}" is outside project root "${root}"`);
+  }
+  return target;
+}
+function safeResolve(input, ctx) {
+  return ensureInsideRoot(resolvePath(input, ctx), ctx);
+}
+async function* spawnStream(opts) {
+  const max = opts.maxBytes;
+  const flushAt = opts.flushBytes ?? 4 * 1024;
+  let stdout = "";
+  let stderr = "";
+  let pending = "";
+  let error;
+  const child = spawn(opts.cmd, opts.args, {
+    cwd: opts.cwd,
+    signal: opts.signal,
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  const queue = [];
+  let waiter;
+  const wake = () => {
+    if (waiter) {
+      const w = waiter;
+      waiter = void 0;
+      w();
+    }
+  };
+  child.stdout?.on("data", (c) => {
+    const s = c.toString();
+    if (stdout.length < max) stdout += s;
+    queue.push({ kind: "out", data: s });
+    wake();
+  });
+  child.stderr?.on("data", (c) => {
+    const s = c.toString();
+    if (stderr.length < max) stderr += s;
+    queue.push({ kind: "err", data: s });
+    wake();
+  });
+  child.on("error", (e) => {
+    error = e.message;
+    queue.push({ kind: "error", data: e.message });
+    wake();
+  });
+  child.on("close", (code) => {
+    queue.push({ kind: "close", data: "", code: code ?? 0 });
+    wake();
+  });
+  let exitCode = 0;
+  let spawnFailed = false;
+  for (; ; ) {
+    while (queue.length === 0) {
+      await new Promise((resolve2) => {
+        waiter = resolve2;
+      });
+    }
+    const chunk = queue.shift();
+    if (chunk.kind === "close") {
+      if (!spawnFailed) exitCode = chunk.code ?? 0;
+      break;
+    }
+    if (chunk.kind === "error") {
+      spawnFailed = true;
+      exitCode = 1;
+      continue;
+    }
+    pending += chunk.data;
+    if (pending.length >= flushAt) {
+      yield { type: "partial_output", text: pending };
+      pending = "";
+    }
+  }
+  if (pending.length > 0) {
+    yield { type: "partial_output", text: pending };
+  }
+  return {
+    stdout,
+    stderr,
+    exitCode,
+    truncated: stdout.length >= max || stderr.length >= max,
+    error
+  };
+}
+
+// src/test.ts
+var testTool = {
+  name: "test",
+  description: "Run tests with vitest, jest, or mocha. Returns pass/fail counts and output.",
+  usageHint: "Set `files` for specific tests. `watch` enables watch mode. `coverage` generates coverage report. `grep` filters by name.",
+  permission: "confirm",
+  mutating: false,
+  timeoutMs: 12e4,
+  inputSchema: {
+    type: "object",
+    properties: {
+      files: {
+        type: "string",
+        description: 'Test files: single path, comma-separated list, or glob (e.g. "**/*.test.ts")'
+      },
+      runner: {
+        type: "string",
+        enum: ["vitest", "jest", "mocha", "auto"],
+        description: "Test runner (default: auto-detect)"
+      },
+      watch: { type: "boolean", description: "Run in watch mode (default: false)" },
+      coverage: { type: "boolean", description: "Generate coverage report (default: false)" },
+      cwd: { type: "string", description: "Working directory (default: cwd)" },
+      grep: { type: "string", description: "Filter tests by name pattern (default: none)" },
+      timeout: { type: "integer", description: "Test timeout in ms (default: 30000)" }
+    }
+  },
+  async execute(input, ctx, opts) {
+    let final;
+    for await (const ev of testTool.executeStream(input, ctx, opts)) {
+      if (ev.type === "final") final = ev.output;
+    }
+    if (!final) throw new Error("test: stream ended without final event");
+    return final;
+  },
+  async *executeStream(input, ctx, opts) {
+    const cwd = input.cwd ? safeResolve(input.cwd, ctx) : ctx.cwd;
+    const runner = input.runner ?? "auto";
+    const detected = runner === "auto" ? await detectRunner(cwd) : runner;
+    if (!detected) {
+      yield {
+        type: "final",
+        output: {
+          runner: "none",
+          exit_code: 1,
+          tests_run: 0,
+          passed: 0,
+          failed: 0,
+          duration_ms: 0,
+          output: "No test runner found (vitest.config.ts, jest.config.js, .mocharc.json)",
+          truncated: false
+        }
+      };
+      return;
+    }
+    yield { type: "log", text: `Running ${detected}\u2026`, data: { runner: detected } };
+    const start = Date.now();
+    const args = buildArgs(detected, input);
+    const result = yield* spawnStream({
+      cmd: detected,
+      args,
+      cwd,
+      signal: opts.signal,
+      maxBytes: 2e5
+    });
+    const duration = Date.now() - start;
+    yield { type: "final", output: parseResult(detected, result, duration) };
+  }
+};
+async function detectRunner(cwd) {
+  const { stat } = await import('fs/promises');
+  const candidates = ["vitest.config.ts", "jest.config.js", ".mocharc.json"];
+  for (const f of candidates) {
+    try {
+      await stat(path.join(cwd, f));
+      if (f.includes("vitest")) return "vitest";
+      if (f.includes("jest")) return "jest";
+      if (f.includes("mocha")) return "mocha";
+    } catch {
+    }
+  }
+  return "vitest";
+}
+function buildArgs(runner, input) {
+  const args = [];
+  const timeout = input.timeout ?? 3e4;
+  switch (runner) {
+    case "vitest":
+      args.push("run", "--reporter=verbose");
+      if (input.watch) {
+        args[1] = "";
+        args.push("watch");
+      }
+      if (input.coverage) args.push("--coverage");
+      if (input.grep) args.push("--testNamePattern", input.grep);
+      args.push("--testTimeout", String(timeout));
+      break;
+    case "jest":
+      args.push("--verbose");
+      if (input.watch) args.push("--watch");
+      if (input.coverage) args.push("--coverage");
+      if (input.grep) args.push("--testPathPattern", input.grep);
+      args.push("--testTimeout", String(timeout));
+      break;
+    case "mocha":
+      args.push("--reporter", "spec");
+      if (input.grep) args.push("--grep", input.grep);
+      args.push("--timeout", String(timeout));
+      break;
+  }
+  if (input.files) {
+    const files = Array.isArray(input.files) ? input.files : input.files.split(",");
+    args.push("--", ...files.map((f) => f.trim()));
+  }
+  return args;
+}
+function parseResult(runner, result, duration) {
+  const out = result.stdout + result.stderr;
+  let tests_run = 0;
+  let passed = 0;
+  let failed = 0;
+  if (runner === "vitest") {
+    const passedMatch = out.match(/(\d+) passed/);
+    const failedMatch = out.match(/(\d+) failed/);
+    if (passedMatch?.[1]) passed = Number.parseInt(passedMatch[1], 10);
+    if (failedMatch?.[1]) failed = Number.parseInt(failedMatch[1], 10);
+    tests_run = passed + failed;
+  } else if (runner === "jest") {
+    const suitesMatch = out.match(/Test Suites:\s+(\d+)\s+total/);
+    const passedMatch = out.match(/Tests:\s+(\d+)\s+passed/);
+    const failedMatch = out.match(/Tests:\s+(\d+)\s+failed/);
+    tests_run = Number.parseInt(suitesMatch?.[1] ?? "0", 10);
+    passed = Number.parseInt(passedMatch?.[1] ?? "0", 10);
+    failed = Number.parseInt(failedMatch?.[1] ?? "0", 10);
+  }
+  return {
+    runner,
+    exit_code: result.exitCode,
+    tests_run,
+    passed,
+    failed,
+    duration_ms: duration,
+    output: result.stdout || result.error || "",
+    truncated: result.truncated
+  };
+}
+
+export { testTool };
+//# sourceMappingURL=test.js.map
+//# sourceMappingURL=test.js.map

package/dist/test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/_util.ts","../src/test.ts"],"names":["resolve","path2"],"mappings":"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","file":"test.js","sourcesContent":["import * as path from 'node:path';\r\nimport { spawn } from 'node:child_process';\r\nimport type { Context, ToolProgressEvent } from '@wrongstack/core';\r\n\r\nexport function resolvePath(input: string, ctx: Context): string {\r\n  return path.isAbsolute(input) ? path.normalize(input) : path.resolve(ctx.cwd, input);\r\n}\r\n\r\nexport function ensureInsideRoot(absPath: string, ctx: Context): string {\r\n  const root = path.resolve(ctx.projectRoot);\r\n  const target = path.resolve(absPath);\r\n  const rel = path.relative(root, target);\r\n  if (rel.startsWith('..') || path.isAbsolute(rel)) {\r\n    throw new Error(`Path \"${absPath}\" is outside project root \"${root}\"`);\r\n  }\r\n  return target;\r\n}\r\n\r\nexport function safeResolve(input: string, ctx: Context): string {\r\n  return ensureInsideRoot(resolvePath(input, ctx), ctx);\r\n}\r\n\r\nexport function truncateMiddle(s: string, max: number): string {\r\n  if (Buffer.byteLength(s, 'utf8') <= max) return s;\r\n  const half = Math.floor(max / 2);\r\n  return (\r\n    s.slice(0, half) +\r\n    `\\n…[truncated ${Buffer.byteLength(s, 'utf8') - max} bytes from middle]…\\n` +\r\n    s.slice(-half)\r\n  );\r\n}\r\n\r\nexport function isBinaryBuffer(buf: Buffer): boolean {\r\n  const len = Math.min(buf.length, 8192);\r\n  for (let i = 0; i < len; i++) {\r\n    if (buf[i] === 0) return true;\r\n  }\r\n  return false;\r\n}\r\n\r\nexport interface SpawnStreamResult {\r\n  stdout: string;\r\n  stderr: string;\r\n  exitCode: number;\r\n  truncated: boolean;\r\n  error?: string;\r\n}\r\n\r\nexport interface SpawnStreamOptions {\r\n  cmd: string;\r\n  args: string[];\r\n  cwd: string;\r\n  signal: AbortSignal;\r\n  maxBytes?: number;\r\n  /** Bytes of new stdout/stderr to accumulate before yielding a `partial_output` event. */\r\n  flushBytes?: number;\r\n}\r\n\r\n/**\r\n * Spawn a child process and yield `partial_output` progress events as\r\n * stdout/stderr arrive (batched by byte threshold), then return the full\r\n * buffered result. Shared between install/lint/format/typecheck/test/audit\r\n * so the TUI live tail sees consistent progress regardless of which tool\r\n * is running.\r\n */\r\nexport async function* spawnStream(\r\n  opts: SpawnStreamOptions,\r\n): AsyncGenerator<ToolProgressEvent, SpawnStreamResult> {\r\n  const max = opts.maxBytes ?? 200_000;\r\n  const flushAt = opts.flushBytes ?? 4 * 1024;\r\n  let stdout = '';\r\n  let stderr = '';\r\n  let pending = '';\r\n  let error: string | undefined;\r\n\r\n  const child = spawn(opts.cmd, opts.args, {\r\n    cwd: opts.cwd,\r\n    signal: opts.signal,\r\n    stdio: ['ignore', 'pipe', 'pipe'],\r\n  });\r\n\r\n  type Chunk = { kind: 'out' | 'err' | 'close' | 'error'; data: string; code?: number };\r\n  const queue: Chunk[] = [];\r\n  let waiter: (() => void) | undefined;\r\n  const wake = () => {\r\n    if (waiter) {\r\n      const w = waiter;\r\n      waiter = undefined;\r\n      w();\r\n    }\r\n  };\r\n\r\n  child.stdout?.on('data', (c) => {\r\n    const s = c.toString();\r\n    if (stdout.length < max) stdout += s;\r\n    queue.push({ kind: 'out', data: s });\r\n    wake();\r\n  });\r\n  child.stderr?.on('data', (c) => {\r\n    const s = c.toString();\r\n    if (stderr.length < max) stderr += s;\r\n    queue.push({ kind: 'err', data: s });\r\n    wake();\r\n  });\r\n  child.on('error', (e) => {\r\n    error = e.message;\r\n    queue.push({ kind: 'error', data: e.message });\r\n    wake();\r\n  });\r\n  child.on('close', (code) => {\r\n    queue.push({ kind: 'close', data: '', code: code ?? 0 });\r\n    wake();\r\n  });\r\n\r\n  let exitCode = 0;\r\n  let spawnFailed = false;\r\n  for (;;) {\r\n    while (queue.length === 0) {\r\n      await new Promise<void>((resolve) => {\r\n        waiter = resolve;\r\n      });\r\n    }\r\n    const chunk = queue.shift()!;\r\n    if (chunk.kind === 'close') {\r\n      // If we already saw a spawn error (ENOENT etc.), keep exitCode=1\r\n      // rather than the negative platform code Node fabricates.\r\n      if (!spawnFailed) exitCode = chunk.code ?? 0;\r\n      break;\r\n    }\r\n    if (chunk.kind === 'error') {\r\n      spawnFailed = true;\r\n      exitCode = 1;\r\n      // close usually follows\r\n      continue;\r\n    }\r\n    pending += chunk.data;\r\n    if (pending.length >= flushAt) {\r\n      yield { type: 'partial_output', text: pending };\r\n      pending = '';\r\n    }\r\n  }\r\n  if (pending.length > 0) {\r\n    yield { type: 'partial_output', text: pending };\r\n  }\r\n\r\n  return {\r\n    stdout,\r\n    stderr,\r\n    exitCode,\r\n    truncated: stdout.length >= max || stderr.length >= max,\r\n    error,\r\n  };\r\n}\r\n","import * as path from 'node:path';\r\nimport type { Tool, ToolStreamEvent } from '@wrongstack/core';\r\nimport { safeResolve, spawnStream } from './_util.js';\r\n\r\ninterface TestInput {\r\n  files?: string | string[];\r\n  runner?: 'vitest' | 'jest' | 'mocha' | 'auto';\r\n  watch?: boolean;\r\n  coverage?: boolean;\r\n  cwd?: string;\r\n  grep?: string;\r\n  timeout?: number;\r\n}\r\n\r\ninterface TestOutput {\r\n  runner: string;\r\n  exit_code: number;\r\n  tests_run: number;\r\n  passed: number;\r\n  failed: number;\r\n  duration_ms: number;\r\n  output: string;\r\n  truncated: boolean;\r\n}\r\n\r\nexport const testTool: Tool<TestInput, TestOutput> = {\r\n  name: 'test',\r\n  description:\r\n    'Run tests with vitest, jest, or mocha. Returns pass/fail counts and output.',\r\n  usageHint:\r\n    'Set `files` for specific tests. `watch` enables watch mode. `coverage` generates coverage report. `grep` filters by name.',\r\n  permission: 'confirm',\r\n  mutating: false,\r\n  timeoutMs: 120_000,\r\n  inputSchema: {\r\n    type: 'object',\r\n    properties: {\r\n      files: {\r\n        type: 'string',\r\n        description: 'Test files: single path, comma-separated list, or glob (e.g. \"**/*.test.ts\")',\r\n      },\r\n      runner: {\r\n        type: 'string',\r\n        enum: ['vitest', 'jest', 'mocha', 'auto'],\r\n        description: 'Test runner (default: auto-detect)',\r\n      },\r\n      watch: { type: 'boolean', description: 'Run in watch mode (default: false)' },\r\n      coverage: { type: 'boolean', description: 'Generate coverage report (default: false)' },\r\n      cwd: { type: 'string', description: 'Working directory (default: cwd)' },\r\n      grep: { type: 'string', description: 'Filter tests by name pattern (default: none)' },\r\n      timeout: { type: 'integer', description: 'Test timeout in ms (default: 30000)' },\r\n    },\r\n  },\r\n  async execute(input, ctx, opts) {\r\n    let final: TestOutput | undefined;\r\n    for await (const ev of testTool.executeStream!(input, ctx, opts)) {\r\n      if (ev.type === 'final') final = ev.output;\r\n    }\r\n    if (!final) throw new Error('test: stream ended without final event');\r\n    return final;\r\n  },\r\n  async *executeStream(input, ctx, opts): AsyncGenerator<ToolStreamEvent<TestOutput>> {\r\n    const cwd = input.cwd ? safeResolve(input.cwd, ctx) : ctx.cwd;\r\n    const runner = input.runner ?? 'auto';\r\n\r\n    const detected = runner === 'auto' ? await detectRunner(cwd) : runner;\r\n    if (!detected) {\r\n      yield {\r\n        type: 'final',\r\n        output: {\r\n          runner: 'none',\r\n          exit_code: 1,\r\n          tests_run: 0,\r\n          passed: 0,\r\n          failed: 0,\r\n          duration_ms: 0,\r\n          output: 'No test runner found (vitest.config.ts, jest.config.js, .mocharc.json)',\r\n          truncated: false,\r\n        },\r\n      };\r\n      return;\r\n    }\r\n\r\n    yield { type: 'log', text: `Running ${detected}…`, data: { runner: detected } };\r\n\r\n    const start = Date.now();\r\n    const args = buildArgs(detected, input);\r\n\r\n    const result = yield* spawnStream({\r\n      cmd: detected,\r\n      args,\r\n      cwd,\r\n      signal: opts.signal,\r\n      maxBytes: 200_000,\r\n    });\r\n    const duration = Date.now() - start;\r\n\r\n    yield { type: 'final', output: parseResult(detected, result, duration) };\r\n  },\r\n};\r\n\r\nasync function detectRunner(cwd: string): Promise<string | null> {\r\n  const { stat } = await import('node:fs/promises');\r\n  const candidates = ['vitest.config.ts', 'jest.config.js', '.mocharc.json'];\r\n  for (const f of candidates) {\r\n    try {\r\n      await stat(path.join(cwd, f));\r\n      if (f.includes('vitest')) return 'vitest';\r\n      if (f.includes('jest')) return 'jest';\r\n      if (f.includes('mocha')) return 'mocha';\r\n    } catch {\r\n      // continue\r\n    }\r\n  }\r\n  return 'vitest';\r\n}\r\n\r\nfunction buildArgs(runner: string, input: TestInput): string[] {\r\n  const args: string[] = [];\r\n  const timeout = input.timeout ?? 30000;\r\n\r\n  switch (runner) {\r\n    case 'vitest':\r\n      args.push('run', '--reporter=verbose');\r\n      if (input.watch) { args[1] = ''; args.push('watch'); }\r\n      if (input.coverage) args.push('--coverage');\r\n      if (input.grep) args.push('--testNamePattern', input.grep);\r\n      args.push('--testTimeout', String(timeout));\r\n      break;\r\n    case 'jest':\r\n      args.push('--verbose');\r\n      if (input.watch) args.push('--watch');\r\n      if (input.coverage) args.push('--coverage');\r\n      if (input.grep) args.push('--testPathPattern', input.grep);\r\n      args.push('--testTimeout', String(timeout));\r\n      break;\r\n    case 'mocha':\r\n      args.push('--reporter', 'spec');\r\n      if (input.grep) args.push('--grep', input.grep);\r\n      args.push('--timeout', String(timeout));\r\n      break;\r\n  }\r\n\r\n  if (input.files) {\r\n    const files = Array.isArray(input.files) ? input.files : input.files.split(',');\r\n    args.push('--', ...files.map((f) => f.trim()));\r\n  }\r\n\r\n  return args;\r\n}\r\n\r\nfunction parseResult(\r\n  runner: string,\r\n  result: { stdout: string; stderr: string; exitCode: number; truncated: boolean; error?: string },\r\n  duration: number,\r\n): TestOutput {\r\n  const out = result.stdout + result.stderr;\r\n\r\n  let tests_run = 0;\r\n  let passed = 0;\r\n  let failed = 0;\r\n\r\n  if (runner === 'vitest') {\r\n    const passedMatch = out.match(/(\\d+) passed/);\r\n    const failedMatch = out.match(/(\\d+) failed/);\r\n    if (passedMatch?.[1]) passed = Number.parseInt(passedMatch[1], 10);\r\n    if (failedMatch?.[1]) failed = Number.parseInt(failedMatch[1], 10);\r\n    tests_run = passed + failed;\r\n  } else if (runner === 'jest') {\r\n    const suitesMatch = out.match(/Test Suites:\\s+(\\d+)\\s+total/);\r\n    const passedMatch = out.match(/Tests:\\s+(\\d+)\\s+passed/);\r\n    const failedMatch = out.match(/Tests:\\s+(\\d+)\\s+failed/);\r\n    tests_run = Number.parseInt(suitesMatch?.[1] ?? '0', 10);\r\n    passed = Number.parseInt(passedMatch?.[1] ?? '0', 10);\r\n    failed = Number.parseInt(failedMatch?.[1] ?? '0', 10);\r\n  }\r\n\r\n  return {\r\n    runner,\r\n    exit_code: result.exitCode,\r\n    tests_run,\r\n    passed,\r\n    failed,\r\n    duration_ms: duration,\r\n    output: result.stdout || result.error || '',\r\n    truncated: result.truncated,\r\n  };\r\n}\r\n"]}

package/dist/todo.d.ts

@@ -0,0 +1,12 @@
+import { Tool, TodoItem } from '@wrongstack/core';
+
+interface TodoInput {
+    todos: TodoItem[];
+}
+interface TodoOutput {
+    count: number;
+    in_progress: number;
+}
+declare const todoTool: Tool<TodoInput, TodoOutput>;
+
+export { todoTool };

package/dist/todo.js

@@ -0,0 +1,53 @@
+// src/todo.ts
+var todoTool = {
+  name: "todo",
+  description: "Replace the current todo list with a new set of items.",
+  usageHint: "Use for multi-step tasks. Replace the full list on each call. At most ONE task may be in_progress at a time. Items have id, content, status (pending|in_progress|completed), and optional activeForm.",
+  permission: "auto",
+  mutating: false,
+  timeoutMs: 1e3,
+  inputSchema: {
+    type: "object",
+    properties: {
+      todos: {
+        type: "array",
+        items: {
+          type: "object",
+          properties: {
+            id: { type: "string" },
+            content: { type: "string" },
+            status: { type: "string", enum: ["pending", "in_progress", "completed"] },
+            activeForm: { type: "string" }
+          },
+          required: ["id", "content", "status"]
+        }
+      }
+    },
+    required: ["todos"]
+  },
+  async execute(input, ctx) {
+    if (!Array.isArray(input?.todos)) {
+      throw new Error("todo: todos must be an array");
+    }
+    const items = input.todos.filter((t) => Boolean(t?.id && t.content));
+    const inProgress = items.filter((t) => t.status === "in_progress");
+    if (inProgress.length > 1) {
+      let seenInProgress = false;
+      for (const item of items) {
+        if (item.status === "in_progress") {
+          if (seenInProgress) item.status = "pending";
+          seenInProgress = true;
+        }
+      }
+    }
+    ctx.todos = items;
+    return {
+      count: items.length,
+      in_progress: items.filter((t) => t.status === "in_progress").length
+    };
+  }
+};
+
+export { todoTool };
+//# sourceMappingURL=todo.js.map
+//# sourceMappingURL=todo.js.map

package/dist/todo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/todo.ts"],"names":[],"mappings":";AAWO,IAAM,QAAA,GAAwC;AAAA,EACnD,IAAA,EAAM,MAAA;AAAA,EACN,WAAA,EAAa,wDAAA;AAAA,EACb,SAAA,EACE,uMAAA;AAAA,EACF,UAAA,EAAY,MAAA;AAAA,EACZ,QAAA,EAAU,KAAA;AAAA,EACV,SAAA,EAAW,GAAA;AAAA,EACX,WAAA,EAAa;AAAA,IACX,IAAA,EAAM,QAAA;AAAA,IACN,UAAA,EAAY;AAAA,MACV,KAAA,EAAO;AAAA,QACL,IAAA,EAAM,OAAA;AAAA,QACN,KAAA,EAAO;AAAA,UACL,IAAA,EAAM,QAAA;AAAA,UACN,UAAA,EAAY;AAAA,YACV,EAAA,EAAI,EAAE,IAAA,EAAM,QAAA,EAAS;AAAA,YACrB,OAAA,EAAS,EAAE,IAAA,EAAM,QAAA,EAAS;AAAA,YAC1B,MAAA,EAAQ,EAAE,IAAA,EAAM,QAAA,EAAU,MAAM,CAAC,SAAA,EAAW,aAAA,EAAe,WAAW,CAAA,EAAE;AAAA,YACxE,UAAA,EAAY,EAAE,IAAA,EAAM,QAAA;AAAS,WAC/B;AAAA,UACA,QAAA,EAAU,CAAC,IAAA,EAAM,SAAA,EAAW,QAAQ;AAAA;AACtC;AACF,KACF;AAAA,IACA,QAAA,EAAU,CAAC,OAAO;AAAA,GACpB;AAAA,EACA,MAAM,OAAA,CAAQ,KAAA,EAAO,GAAA,EAAK;AACxB,IAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,KAAA,EAAO,KAAK,CAAA,EAAG;AAChC,MAAA,MAAM,IAAI,MAAM,8BAA8B,CAAA;AAAA,IAChD;AACA,IAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,KAAA,CAAM,MAAA,CAAO,CAAC,CAAA,KAAqB,OAAA,CAAQ,CAAA,EAAG,EAAA,IAAM,CAAA,CAAE,OAAO,CAAC,CAAA;AAClF,IAAA,MAAM,aAAa,KAAA,CAAM,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,WAAW,aAAa,CAAA;AACjE,IAAA,IAAI,UAAA,CAAW,SAAS,CAAA,EAAG;AAEzB,MAAA,IAAI,cAAA,GAAiB,KAAA;AACrB,MAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,QAAA,IAAI,IAAA,CAAK,WAAW,aAAA,EAAe;AACjC,UAAA,IAAI,cAAA,OAAqB,MAAA,GAAS,SAAA;AAClC,UAAA,cAAA,GAAiB,IAAA;AAAA,QACnB;AAAA,MACF;AAAA,IACF;AACA,IAAA,GAAA,CAAI,KAAA,GAAQ,KAAA;AACZ,IAAA,OAAO;AAAA,MACL,OAAO,KAAA,CAAM,MAAA;AAAA,MACb,WAAA,EAAa,MAAM,MAAA,CAAO,CAAC,MAAM,CAAA,CAAE,MAAA,KAAW,aAAa,CAAA,CAAE;AAAA,KAC/D;AAAA,EACF;AACF","file":"todo.js","sourcesContent":["import type { Tool, TodoItem } from '@wrongstack/core';\n\ninterface TodoInput {\n  todos: TodoItem[];\n}\n\ninterface TodoOutput {\n  count: number;\n  in_progress: number;\n}\n\nexport const todoTool: Tool<TodoInput, TodoOutput> = {\n  name: 'todo',\n  description: 'Replace the current todo list with a new set of items.',\n  usageHint:\n    'Use for multi-step tasks. Replace the full list on each call. At most ONE task may be in_progress at a time. Items have id, content, status (pending|in_progress|completed), and optional activeForm.',\n  permission: 'auto',\n  mutating: false,\n  timeoutMs: 1_000,\n  inputSchema: {\n    type: 'object',\n    properties: {\n      todos: {\n        type: 'array',\n        items: {\n          type: 'object',\n          properties: {\n            id: { type: 'string' },\n            content: { type: 'string' },\n            status: { type: 'string', enum: ['pending', 'in_progress', 'completed'] },\n            activeForm: { type: 'string' },\n          },\n          required: ['id', 'content', 'status'],\n        },\n      },\n    },\n    required: ['todos'],\n  },\n  async execute(input, ctx) {\n    if (!Array.isArray(input?.todos)) {\n      throw new Error('todo: todos must be an array');\n    }\n    const items = input.todos.filter((t): t is TodoItem => Boolean(t?.id && t.content));\n    const inProgress = items.filter((t) => t.status === 'in_progress');\n    if (inProgress.length > 1) {\n      // Keep only the first as in_progress, mark rest pending\n      let seenInProgress = false;\n      for (const item of items) {\n        if (item.status === 'in_progress') {\n          if (seenInProgress) item.status = 'pending';\n          seenInProgress = true;\n        }\n      }\n    }\n    ctx.todos = items;\n    return {\n      count: items.length,\n      in_progress: items.filter((t) => t.status === 'in_progress').length,\n    };\n  },\n};\n"]}

package/dist/tool-help.d.ts

@@ -0,0 +1,23 @@
+import { Tool } from '@wrongstack/core';
+
+interface ToolHelpInput {
+    tool?: string;
+    format?: 'short' | 'full' | 'markdown';
+    include_examples?: boolean;
+}
+interface ToolHelpOutput {
+    tool?: string;
+    help: string;
+    tools: {
+        name: string;
+        description: string;
+        usageHint: string;
+        inputSchema: unknown;
+        permission: string;
+        mutating: boolean;
+    }[];
+    total: number;
+}
+declare const toolHelpTool: Tool<ToolHelpInput, ToolHelpOutput>;
+
+export { toolHelpTool };

package/dist/tool-help.js

@@ -0,0 +1,122 @@
+// src/tool-help.ts
+var toolHelpTool = {
+  name: "tool_help",
+  description: "Get help and usage information for a specific tool or list all available tools.",
+  usageHint: "Set `tool` for specific help. Omit to list all tools. `format`: short (one-liner), full (schema), markdown (formatted).",
+  permission: "auto",
+  mutating: false,
+  timeoutMs: 5e3,
+  inputSchema: {
+    type: "object",
+    properties: {
+      tool: {
+        type: "string",
+        description: "Tool name to get help for (omit for all tools)"
+      },
+      format: {
+        type: "string",
+        enum: ["short", "full", "markdown"],
+        description: "Output format (default: short)"
+      },
+      include_examples: {
+        type: "boolean",
+        description: "Include usage examples in output (default: false)"
+      }
+    }
+  },
+  async execute(input, ctx) {
+    const format = input.format ?? "short";
+    const includeExamples = input.include_examples ?? false;
+    if (input.tool) {
+      const tool = ctx.tools.find((t) => t.name === input.tool);
+      if (!tool) {
+        return {
+          tool: input.tool,
+          help: `No tool found with name "${input.tool}"`,
+          tools: [],
+          total: 0
+        };
+      }
+      return {
+        tool: tool.name,
+        help: formatToolHelp(tool, format, includeExamples),
+        tools: [{
+          name: tool.name,
+          description: tool.description,
+          usageHint: tool.usageHint ?? "",
+          inputSchema: tool.inputSchema,
+          permission: tool.permission,
+          mutating: tool.mutating
+        }],
+        total: 1
+      };
+    }
+    const allTools = ctx.tools.map((t) => ({
+      name: t.name,
+      description: t.description,
+      usageHint: t.usageHint ?? "",
+      inputSchema: format === "full" ? t.inputSchema : void 0,
+      permission: t.permission,
+      mutating: t.mutating
+    }));
+    return {
+      help: format === "markdown" ? formatAllToolsMarkdown(allTools) : formatAllToolsShort(allTools),
+      tools: allTools,
+      total: allTools.length
+    };
+  }
+};
+function formatToolHelp(tool, format, includeExamples) {
+  const lines = [];
+  if (format === "short") {
+    lines.push(`${tool.name}: ${tool.description}`);
+    if (tool.usageHint) lines.push(`Hint: ${tool.usageHint}`);
+    return lines.join("\n");
+  }
+  if (format === "markdown") {
+    lines.push(`## ${tool.name}`);
+    lines.push("");
+    lines.push(tool.description);
+    lines.push("");
+    lines.push("**Permission:** " + tool.permission);
+    lines.push("**Mutating:** " + (tool.mutating ? "yes" : "no"));
+    if (tool.usageHint) {
+      lines.push("");
+      lines.push("### Usage Hint");
+      lines.push(tool.usageHint);
+    }
+    if (includeExamples && tool.inputSchema) {
+      lines.push("");
+      lines.push("### Input Schema");
+      lines.push("```json");
+      lines.push(JSON.stringify(tool.inputSchema, null, 2));
+      lines.push("```");
+    }
+    return lines.join("\n");
+  }
+  lines.push(`Tool: ${tool.name}`);
+  lines.push(`Description: ${tool.description}`);
+  lines.push(`Permission: ${tool.permission}`);
+  lines.push(`Mutating: ${tool.mutating}`);
+  if (tool.usageHint) lines.push(`Usage: ${tool.usageHint}`);
+  if (format === "full" && tool.inputSchema) {
+    lines.push("Schema: " + JSON.stringify(tool.inputSchema, null, 2));
+  }
+  return lines.join("\n");
+}
+function formatAllToolsShort(tools) {
+  return tools.map((t) => `  ${t.name.padEnd(16)} ${t.description}`).join("\n");
+}
+function formatAllToolsMarkdown(tools) {
+  const lines = ["## Available Tools", ""];
+  lines.push("| Tool | Description |");
+  lines.push("|------|-------------|");
+  for (const t of tools) {
+    lines.push(`| \`${t.name}\` | ${t.description} |`);
+  }
+  return lines.join("\n");
+}
+
+export { toolHelpTool };
+//# sourceMappingURL=tool-help.js.map
+//# sourceMappingURL=tool-help.js.map

package/dist/tool-help.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tool-help.ts"],"names":[],"mappings":"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","file":"tool-help.js","sourcesContent":["import type { Tool } from '@wrongstack/core';\n\ninterface ToolHelpInput {\n  tool?: string;\n  format?: 'short' | 'full' | 'markdown';\n  include_examples?: boolean;\n}\n\ninterface ToolHelpOutput {\n  tool?: string;\n  help: string;\n  tools: {\n    name: string;\n    description: string;\n    usageHint: string;\n    inputSchema: unknown;\n    permission: string;\n    mutating: boolean;\n  }[];\n  total: number;\n}\n\nexport const toolHelpTool: Tool<ToolHelpInput, ToolHelpOutput> = {\n  name: 'tool_help',\n  description:\n    'Get help and usage information for a specific tool or list all available tools.',\n  usageHint:\n    'Set `tool` for specific help. Omit to list all tools. `format`: short (one-liner), full (schema), markdown (formatted).',\n  permission: 'auto',\n  mutating: false,\n  timeoutMs: 5_000,\n  inputSchema: {\n    type: 'object',\n    properties: {\n      tool: {\n        type: 'string',\n        description: 'Tool name to get help for (omit for all tools)',\n      },\n      format: {\n        type: 'string',\n        enum: ['short', 'full', 'markdown'],\n        description: 'Output format (default: short)',\n      },\n      include_examples: {\n        type: 'boolean',\n        description: 'Include usage examples in output (default: false)',\n      },\n    },\n  },\n  async execute(input, ctx) {\n    const format = input.format ?? 'short';\n    const includeExamples = input.include_examples ?? false;\n\n    if (input.tool) {\n      const tool = ctx.tools.find((t: Tool) => t.name === input.tool);\n      if (!tool) {\n        return {\n          tool: input.tool,\n          help: `No tool found with name \"${input.tool}\"`,\n          tools: [],\n          total: 0,\n        };\n      }\n\n      return {\n        tool: tool.name,\n        help: formatToolHelp(tool, format, includeExamples),\n        tools: [{\n          name: tool.name,\n          description: tool.description,\n          usageHint: tool.usageHint ?? '',\n          inputSchema: tool.inputSchema,\n          permission: tool.permission,\n          mutating: tool.mutating,\n        }],\n        total: 1,\n      };\n    }\n\n    const allTools = ctx.tools.map((t: Tool) => ({\n      name: t.name,\n      description: t.description,\n      usageHint: t.usageHint ?? '',\n      inputSchema: format === 'full' ? t.inputSchema : undefined,\n      permission: t.permission,\n      mutating: t.mutating,\n    }));\n\n    return {\n      help: format === 'markdown' ? formatAllToolsMarkdown(allTools) : formatAllToolsShort(allTools),\n      tools: allTools,\n      total: allTools.length,\n    };\n  },\n};\n\nfunction formatToolHelp(tool: Tool, format: string, includeExamples: boolean): string {\n  const lines: string[] = [];\n\n  if (format === 'short') {\n    lines.push(`${tool.name}: ${tool.description}`);\n    if (tool.usageHint) lines.push(`Hint: ${tool.usageHint}`);\n    return lines.join('\\n');\n  }\n\n  if (format === 'markdown') {\n    lines.push(`## ${tool.name}`);\n    lines.push('');\n    lines.push(tool.description);\n    lines.push('');\n    lines.push('**Permission:** ' + tool.permission);\n    lines.push('**Mutating:** ' + (tool.mutating ? 'yes' : 'no'));\n    if (tool.usageHint) {\n      lines.push('');\n      lines.push('### Usage Hint');\n      lines.push(tool.usageHint);\n    }\n    if (includeExamples && tool.inputSchema) {\n      lines.push('');\n      lines.push('### Input Schema');\n      lines.push('```json');\n      lines.push(JSON.stringify(tool.inputSchema, null, 2));\n      lines.push('```');\n    }\n    return lines.join('\\n');\n  }\n\n  lines.push(`Tool: ${tool.name}`);\n  lines.push(`Description: ${tool.description}`);\n  lines.push(`Permission: ${tool.permission}`);\n  lines.push(`Mutating: ${tool.mutating}`);\n  if (tool.usageHint) lines.push(`Usage: ${tool.usageHint}`);\n  if (format === 'full' && tool.inputSchema) {\n    lines.push('Schema: ' + JSON.stringify(tool.inputSchema, null, 2));\n  }\n  return lines.join('\\n');\n}\n\nfunction formatAllToolsShort(tools: { name: string; description: string }[]): string {\n  return tools\n    .map((t) => `  ${t.name.padEnd(16)} ${t.description}`)\n    .join('\\n');\n}\n\nfunction formatAllToolsMarkdown(tools: { name: string; description: string; usageHint: string }[]): string {\n  const lines: string[] = ['## Available Tools', ''];\n  lines.push('| Tool | Description |');\n  lines.push('|------|-------------|');\n  for (const t of tools) {\n    lines.push(`| \\`${t.name}\\` | ${t.description} |`);\n  }\n  return lines.join('\\n');\n}"]}

package/dist/tool-search.d.ts

@@ -0,0 +1,22 @@
+import { Tool } from '@wrongstack/core';
+
+interface ToolSearchInput {
+    query?: string;
+    tags?: string[];
+    permission?: 'auto' | 'confirm' | 'deny';
+    mutating?: boolean;
+    limit?: number;
+}
+interface ToolSearchOutput {
+    tools: {
+        name: string;
+        description: string;
+        permission: string;
+        mutating: boolean;
+    }[];
+    total: number;
+    truncated: boolean;
+}
+declare const toolSearchTool: Tool<ToolSearchInput, ToolSearchOutput>;
+
+export { toolSearchTool };

package/dist/tool-search.js

@@ -0,0 +1,70 @@
+// src/tool-search.ts
+var toolSearchTool = {
+  name: "tool_search",
+  description: "Search available tools by name, description, tags, permission level, or mutating flag.",
+  usageHint: "Set `query` for keyword search. `tags` to filter by category. `permission` to filter by required permission. `mutating` to filter by mutating flag.",
+  permission: "auto",
+  mutating: false,
+  timeoutMs: 1e3,
+  inputSchema: {
+    type: "object",
+    properties: {
+      query: {
+        type: "string",
+        description: "Search query for tool name or description"
+      },
+      tags: {
+        type: "array",
+        items: { type: "string" },
+        description: 'Filter by tags (e.g. "filesystem", "network", "dev")'
+      },
+      permission: {
+        type: "string",
+        enum: ["auto", "confirm", "deny"],
+        description: "Filter by required permission level"
+      },
+      mutating: {
+        type: "boolean",
+        description: "Filter by mutating flag (true=filters that modify, false=read-only)"
+      },
+      limit: {
+        type: "integer",
+        description: "Maximum results to return (default: 20)",
+        minimum: 1,
+        maximum: 100
+      }
+    }
+  },
+  async execute(input, ctx) {
+    const limit = Math.min(input.limit ?? 20, 100);
+    const tools = ctx.tools;
+    const query = input.query?.toLowerCase() ?? "";
+    const filtered = tools.filter((t) => {
+      if (query && !t.name.toLowerCase().includes(query) && !t.description.toLowerCase().includes(query)) {
+        return false;
+      }
+      if (input.permission && t.permission !== input.permission) {
+        return false;
+      }
+      if (typeof input.mutating === "boolean" && t.mutating !== input.mutating) {
+        return false;
+      }
+      return true;
+    });
+    const results = filtered.slice(0, limit).map((t) => ({
+      name: t.name,
+      description: t.description,
+      permission: t.permission,
+      mutating: t.mutating
+    }));
+    return {
+      tools: results,
+      total: filtered.length,
+      truncated: filtered.length > limit
+    };
+  }
+};
+
+export { toolSearchTool };
+//# sourceMappingURL=tool-search.js.map
+//# sourceMappingURL=tool-search.js.map

package/dist/tool-search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tool-search.ts"],"names":[],"mappings":";AAqBO,IAAM,cAAA,GAA0D;AAAA,EACrE,IAAA,EAAM,aAAA;AAAA,EACN,WAAA,EACE,wFAAA;AAAA,EACF,SAAA,EACE,qJAAA;AAAA,EACF,UAAA,EAAY,MAAA;AAAA,EACZ,QAAA,EAAU,KAAA;AAAA,EACV,SAAA,EAAW,GAAA;AAAA,EACX,WAAA,EAAa;AAAA,IACX,IAAA,EAAM,QAAA;AAAA,IACN,UAAA,EAAY;AAAA,MACV,KAAA,EAAO;AAAA,QACL,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA,IAAA,EAAM;AAAA,QACJ,IAAA,EAAM,OAAA;AAAA,QACN,KAAA,EAAO,EAAE,IAAA,EAAM,QAAA,EAAS;AAAA,QACxB,WAAA,EAAa;AAAA,OACf;AAAA,MACA,UAAA,EAAY;AAAA,QACV,IAAA,EAAM,QAAA;AAAA,QACN,IAAA,EAAM,CAAC,MAAA,EAAQ,SAAA,EAAW,MAAM,CAAA;AAAA,QAChC,WAAA,EAAa;AAAA,OACf;AAAA,MACA,QAAA,EAAU;AAAA,QACR,IAAA,EAAM,SAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA,KAAA,EAAO;AAAA,QACL,IAAA,EAAM,SAAA;AAAA,QACN,WAAA,EAAa,yCAAA;AAAA,QACb,OAAA,EAAS,CAAA;AAAA,QACT,OAAA,EAAS;AAAA;AACX;AACF,GACF;AAAA,EACA,MAAM,OAAA,CAAQ,KAAA,EAAO,GAAA,EAAK;AACxB,IAAA,MAAM,QAAQ,IAAA,CAAK,GAAA,CAAI,KAAA,CAAM,KAAA,IAAS,IAAI,GAAG,CAAA;AAC7C,IAAA,MAAM,QAAQ,GAAA,CAAI,KAAA;AAClB,IAAA,MAAM,KAAA,GAAQ,KAAA,CAAM,KAAA,EAAO,WAAA,EAAY,IAAK,EAAA;AAE5C,IAAA,MAAM,QAAA,GAAW,KAAA,CAAM,MAAA,CAAO,CAAC,CAAA,KAAY;AACzC,MAAA,IAAI,SAAS,CAAC,CAAA,CAAE,IAAA,CAAK,WAAA,GAAc,QAAA,CAAS,KAAK,CAAA,IAAK,CAAC,EAAE,WAAA,CAAY,WAAA,EAAY,CAAE,QAAA,CAAS,KAAK,CAAA,EAAG;AAClG,QAAA,OAAO,KAAA;AAAA,MACT;AACA,MAAA,IAAI,KAAA,CAAM,UAAA,IAAc,CAAA,CAAE,UAAA,KAAe,MAAM,UAAA,EAAY;AACzD,QAAA,OAAO,KAAA;AAAA,MACT;AACA,MAAA,IAAI,OAAO,KAAA,CAAM,QAAA,KAAa,aAAa,CAAA,CAAE,QAAA,KAAa,MAAM,QAAA,EAAU;AACxE,QAAA,OAAO,KAAA;AAAA,MACT;AACA,MAAA,OAAO,IAAA;AAAA,IACT,CAAC,CAAA;AAED,IAAA,MAAM,OAAA,GAAU,SAAS,KAAA,CAAM,CAAA,EAAG,KAAK,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,MAAa;AAAA,MACzD,MAAM,CAAA,CAAE,IAAA;AAAA,MACR,aAAa,CAAA,CAAE,WAAA;AAAA,MACf,YAAY,CAAA,CAAE,UAAA;AAAA,MACd,UAAU,CAAA,CAAE;AAAA,KACd,CAAE,CAAA;AAEF,IAAA,OAAO;AAAA,MACL,KAAA,EAAO,OAAA;AAAA,MACP,OAAO,QAAA,CAAS,MAAA;AAAA,MAChB,SAAA,EAAW,SAAS,MAAA,GAAS;AAAA,KAC/B;AAAA,EACF;AACF","file":"tool-search.js","sourcesContent":["import type { Tool } from '@wrongstack/core';\r\n\r\ninterface ToolSearchInput {\r\n  query?: string;\r\n  tags?: string[];\r\n  permission?: 'auto' | 'confirm' | 'deny';\r\n  mutating?: boolean;\r\n  limit?: number;\r\n}\r\n\r\ninterface ToolSearchOutput {\r\n  tools: {\r\n    name: string;\r\n    description: string;\r\n    permission: string;\r\n    mutating: boolean;\r\n  }[];\r\n  total: number;\r\n  truncated: boolean;\r\n}\r\n\r\nexport const toolSearchTool: Tool<ToolSearchInput, ToolSearchOutput> = {\r\n  name: 'tool_search',\r\n  description:\r\n    'Search available tools by name, description, tags, permission level, or mutating flag.',\r\n  usageHint:\r\n    'Set `query` for keyword search. `tags` to filter by category. `permission` to filter by required permission. `mutating` to filter by mutating flag.',\r\n  permission: 'auto',\r\n  mutating: false,\r\n  timeoutMs: 1_000,\r\n  inputSchema: {\r\n    type: 'object',\r\n    properties: {\r\n      query: {\r\n        type: 'string',\r\n        description: 'Search query for tool name or description',\r\n      },\r\n      tags: {\r\n        type: 'array',\r\n        items: { type: 'string' },\r\n        description: 'Filter by tags (e.g. \"filesystem\", \"network\", \"dev\")',\r\n      },\r\n      permission: {\r\n        type: 'string',\r\n        enum: ['auto', 'confirm', 'deny'],\r\n        description: 'Filter by required permission level',\r\n      },\r\n      mutating: {\r\n        type: 'boolean',\r\n        description: 'Filter by mutating flag (true=filters that modify, false=read-only)',\r\n      },\r\n      limit: {\r\n        type: 'integer',\r\n        description: 'Maximum results to return (default: 20)',\r\n        minimum: 1,\r\n        maximum: 100,\r\n      },\r\n    },\r\n  },\r\n  async execute(input, ctx) {\r\n    const limit = Math.min(input.limit ?? 20, 100);\r\n    const tools = ctx.tools;\r\n    const query = input.query?.toLowerCase() ?? '';\r\n\r\n    const filtered = tools.filter((t: Tool) => {\r\n      if (query && !t.name.toLowerCase().includes(query) && !t.description.toLowerCase().includes(query)) {\r\n        return false;\r\n      }\r\n      if (input.permission && t.permission !== input.permission) {\r\n        return false;\r\n      }\r\n      if (typeof input.mutating === 'boolean' && t.mutating !== input.mutating) {\r\n        return false;\r\n      }\r\n      return true;\r\n    });\r\n\r\n    const results = filtered.slice(0, limit).map((t: Tool) => ({\r\n      name: t.name,\r\n      description: t.description,\r\n      permission: t.permission,\r\n      mutating: t.mutating,\r\n    }));\r\n\r\n    return {\r\n      tools: results,\r\n      total: filtered.length,\r\n      truncated: filtered.length > limit,\r\n    };\r\n  },\r\n};"]}

package/dist/tool-use.d.ts

@@ -0,0 +1,16 @@
+import { Tool } from '@wrongstack/core';
+
+interface ToolUseInput {
+    tool: string;
+    input: Record<string, unknown>;
+}
+interface ToolUseOutput {
+    tool: string;
+    success: boolean;
+    result?: unknown;
+    error?: string;
+    executionMs: number;
+}
+declare const toolUseTool: Tool<ToolUseInput, ToolUseOutput>;
+
+export { toolUseTool };