@wrongstack/tools 0.1.1 → 0.1.3

package/dist/scaffold.js

@@ -0,0 +1,185 @@
+import * as path from 'path';
+import * as fsSync from 'fs';
+import 'child_process';
+
+// src/scaffold.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);
+}
+
+// src/scaffold.ts
+var BUILT_IN_TEMPLATES = {
+  "npm-package": {
+    description: "Basic npm package with ESM",
+    files: {
+      "package.json": JSON.stringify({
+        name: "{{name}}",
+        version: "0.1.1",
+        type: "module",
+        main: "./dist/index.js",
+        scripts: { build: "tsc", test: "vitest run" },
+        devDependencies: { typescript: "^5.0.0" }
+      }, null, 2),
+      "tsconfig.json": JSON.stringify({
+        compilerOptions: { target: "ES2022", module: "ESNext", strict: true },
+        include: ["src"]
+      }, null, 2),
+      "src/index.ts": `export function hello() {
+  return 'Hello from {{name}}';
+}
+`,
+      "src/index.test.ts": `import { hello } from './index';
+import { describe, it, expect } from 'vitest';
+
+describe('hello', () => {
+  it('returns greeting', () => {
+    expect(hello()).toBe('Hello from {{name}}');
+  });
+});
+`
+    }
+  },
+  "cli-tool": {
+    description: "CLI tool with argparse",
+    files: {
+      "package.json": JSON.stringify({
+        name: "{{name}}",
+        version: "0.1.1",
+        type: "module",
+        bin: { "{{name}}": "./src/index.js" },
+        scripts: { build: "tsc", start: "node dist/index.js" }
+      }, null, 2),
+      "src/index.ts": `#!/usr/bin/env node
+
+async function main() {
+  console.log('Hello from {{name}}');
+}
+
+main();
+`
+    }
+  },
+  "react-component": {
+    description: "React component with TypeScript",
+    files: {
+      "{{name}}.tsx": `interface {{Name}}Props {
+  className?: string;
+}
+
+export function {{Name}}({ className }: {{Name}}Props) {
+  return (
+    <div className={className}>
+      {{Name}} Component
+    </div>
+  );
+}
+`,
+      "{{name}}.test.tsx": `import { render, screen } from '@testing-library/react';
+import { {{Name}} } from './{{Name}}';
+
+describe('{{Name}}', () => {
+  it('renders', () => {
+    render(<{{Name}} />);
+    expect(screen.getByText('{{Name}} Component')).toBeInTheDocument();
+  });
+});
+`
+    }
+  }
+};
+var scaffoldTool = {
+  name: "scaffold",
+  description: "Generate boilerplate code from built-in templates or paths. Creates package.json, source files, tests.",
+  usageHint: "Set `template` (npm-package, cli-tool, react-component) and `name`. `vars` for template variables. `dry_run` preview.",
+  permission: "confirm",
+  mutating: true,
+  timeoutMs: 3e4,
+  inputSchema: {
+    type: "object",
+    properties: {
+      template: {
+        type: "string",
+        description: "Template name (npm-package, cli-tool, react-component) or path to template directory"
+      },
+      name: {
+        type: "string",
+        description: "Project/component name (used in generated files)"
+      },
+      cwd: { type: "string", description: "Working directory (default: cwd)" },
+      vars: {
+        type: "object",
+        additionalProperties: { type: "string" },
+        description: "Template variables for custom templates"
+      },
+      dry_run: {
+        type: "boolean",
+        description: "Preview generated files without creating (default: false)"
+      }
+    },
+    required: ["template", "name"]
+  },
+  async execute(input, ctx) {
+    const cwd = input.cwd ? safeResolve(input.cwd, ctx) : ctx.cwd;
+    const name = input.name;
+    const vars = { name, ...input.vars };
+    const builtIn = BUILT_IN_TEMPLATES[input.template];
+    if (builtIn) {
+      return handleBuiltIn(name, builtIn.files, cwd, input.dry_run ?? false, vars);
+    }
+    return {
+      template: input.template,
+      name,
+      files_created: 0,
+      files: [],
+      dry_run: input.dry_run ?? false,
+      output: `Template "${input.template}" not found. Available: ${Object.keys(BUILT_IN_TEMPLATES).join(", ")}`
+    };
+  }
+};
+function handleBuiltIn(name, templateFiles, cwd, dryRun, vars) {
+  const files = [];
+  let filesCreated = 0;
+  for (const [filePath, content] of Object.entries(templateFiles)) {
+    const resolvedPath = substituteVars(filePath, name, vars);
+    const fullPath = path.join(cwd, resolvedPath);
+    if (!dryRun) {
+      fsSync.mkdirSync(path.dirname(fullPath), { recursive: true });
+      fsSync.writeFileSync(fullPath, substituteVars(content, name, vars), "utf8");
+    }
+    files.push(resolvedPath);
+    filesCreated++;
+  }
+  return {
+    template: "built-in",
+    name,
+    files_created: filesCreated,
+    files,
+    dry_run: dryRun,
+    output: dryRun ? `Would create ${filesCreated} files: ${files.join(", ")}` : `Created ${filesCreated} files: ${files.join(", ")}`
+  };
+}
+function substituteVars(content, name, vars) {
+  let result = content;
+  result = result.replace(/\{\{name\}\}/g, name.toLowerCase().replace(/\s+/g, "-"));
+  result = result.replace(/\{\{Name\}\}/g, name.replace(/(?:^|[-_\s]+)([a-z])/g, (_, c) => c.toUpperCase()));
+  for (const [k, v] of Object.entries(vars)) {
+    result = result.replace(new RegExp(`\\{\\{${k}\\}\\}`, "g"), v);
+  }
+  return result;
+}
+
+export { scaffoldTool };
+//# sourceMappingURL=scaffold.js.map
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/_util.ts","../src/scaffold.ts"],"names":["path2"],"mappings":"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","file":"scaffold.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 fs from 'node:fs/promises';\nimport * as path from 'node:path';\nimport * as fsSync from 'node:fs';\nimport type { Tool } from '@wrongstack/core';\nimport { safeResolve } from './_util.js';\n\ninterface ScaffoldInput {\n  template: string;\n  name: string;\n  cwd?: string;\n  vars?: Record<string, string>;\n  dry_run?: boolean;\n}\n\ninterface ScaffoldOutput {\n  template: string;\n  name: string;\n  files_created: number;\n  files: string[];\n  dry_run: boolean;\n  output: string;\n}\n\nconst BUILT_IN_TEMPLATES: Record<string, { description: string; files: Record<string, string> }> = {\n  'npm-package': {\n    description: 'Basic npm package with ESM',\n    files: {\n      'package.json': JSON.stringify({\n        name: '{{name}}',\n        version: '0.1.1',\n        type: 'module',\n        main: './dist/index.js',\n        scripts: { build: 'tsc', test: 'vitest run' },\n        devDependencies: { typescript: '^5.0.0' },\n      }, null, 2),\n      'tsconfig.json': JSON.stringify({\n        compilerOptions: { target: 'ES2022', module: 'ESNext', strict: true },\n        include: ['src'],\n      }, null, 2),\n      'src/index.ts': `export function hello() {\\n  return 'Hello from {{name}}';\\n}\\n`,\n      'src/index.test.ts': `import { hello } from './index';\\nimport { describe, it, expect } from 'vitest';\\n\\ndescribe('hello', () => {\\n  it('returns greeting', () => {\\n    expect(hello()).toBe('Hello from {{name}}');\\n  });\\n});\\n`,\n    },\n  },\n  'cli-tool': {\n    description: 'CLI tool with argparse',\n    files: {\n      'package.json': JSON.stringify({\n        name: '{{name}}',\n        version: '0.1.1',\n        type: 'module',\n        bin: { '{{name}}': './src/index.js' },\n        scripts: { build: 'tsc', start: 'node dist/index.js' },\n      }, null, 2),\n      'src/index.ts': `#!/usr/bin/env node\\n\\nasync function main() {\\n  console.log('Hello from {{name}}');\\n}\\n\\nmain();\\n`,\n    },\n  },\n  'react-component': {\n    description: 'React component with TypeScript',\n    files: {\n      '{{name}}.tsx': `interface {{Name}}Props {\\n  className?: string;\\n}\\n\\nexport function {{Name}}({ className }: {{Name}}Props) {\\n  return (\\n    <div className={className}>\\n      {{Name}} Component\\n    </div>\\n  );\\n}\\n`,\n      '{{name}}.test.tsx': `import { render, screen } from '@testing-library/react';\\nimport { {{Name}} } from './{{Name}}';\\n\\ndescribe('{{Name}}', () => {\\n  it('renders', () => {\\n    render(<{{Name}} />);\\n    expect(screen.getByText('{{Name}} Component')).toBeInTheDocument();\\n  });\\n});\\n`,\n    },\n  },\n};\n\nexport const scaffoldTool: Tool<ScaffoldInput, ScaffoldOutput> = {\n  name: 'scaffold',\n  description:\n    'Generate boilerplate code from built-in templates or paths. Creates package.json, source files, tests.',\n  usageHint:\n    'Set `template` (npm-package, cli-tool, react-component) and `name`. `vars` for template variables. `dry_run` preview.',\n  permission: 'confirm',\n  mutating: true,\n  timeoutMs: 30_000,\n  inputSchema: {\n    type: 'object',\n    properties: {\n      template: {\n        type: 'string',\n        description: 'Template name (npm-package, cli-tool, react-component) or path to template directory',\n      },\n      name: {\n        type: 'string',\n        description: 'Project/component name (used in generated files)',\n      },\n      cwd: { type: 'string', description: 'Working directory (default: cwd)' },\n      vars: {\n        type: 'object',\n        additionalProperties: { type: 'string' },\n        description: 'Template variables for custom templates',\n      },\n      dry_run: {\n        type: 'boolean',\n        description: 'Preview generated files without creating (default: false)',\n      },\n    },\n    required: ['template', 'name'],\n  },\n  async execute(input, ctx) {\n    const cwd = input.cwd ? safeResolve(input.cwd, ctx) : ctx.cwd;\n    const name = input.name;\n    const vars = { name, ...input.vars };\n\n    const builtIn = BUILT_IN_TEMPLATES[input.template];\n    if (builtIn) {\n      return handleBuiltIn(name, builtIn.files, cwd, input.dry_run ?? false, vars);\n    }\n\n    return {\n      template: input.template,\n      name,\n      files_created: 0,\n      files: [],\n      dry_run: input.dry_run ?? false,\n      output: `Template \"${input.template}\" not found. Available: ${Object.keys(BUILT_IN_TEMPLATES).join(', ')}`,\n    };\n  },\n};\n\nfunction handleBuiltIn(\n  name: string,\n  templateFiles: Record<string, string>,\n  cwd: string,\n  dryRun: boolean,\n  vars: Record<string, string>,\n): ScaffoldOutput {\n  const files: string[] = [];\n  let filesCreated = 0;\n\n  for (const [filePath, content] of Object.entries(templateFiles)) {\n    const resolvedPath = substituteVars(filePath, name, vars);\n    const fullPath = path.join(cwd, resolvedPath);\n\n    if (!dryRun) {\n      fsSync.mkdirSync(path.dirname(fullPath), { recursive: true });\n      fsSync.writeFileSync(fullPath, substituteVars(content, name, vars), 'utf8');\n    }\n    files.push(resolvedPath);\n    filesCreated++;\n  }\n\n  return {\n    template: 'built-in',\n    name,\n    files_created: filesCreated,\n    files,\n    dry_run: dryRun,\n    output: dryRun\n      ? `Would create ${filesCreated} files: ${files.join(', ')}`\n      : `Created ${filesCreated} files: ${files.join(', ')}`,\n  };\n}\n\nfunction substituteVars(content: string, name: string, vars: Record<string, string>): string {\n  let result = content;\n  result = result.replace(/\\{\\{name\\}\\}/g, name.toLowerCase().replace(/\\s+/g, '-'));\n  result = result.replace(/\\{\\{Name\\}\\}/g, name.replace(/(?:^|[-_\\s]+)([a-z])/g, (_, c) => c.toUpperCase()));\n  for (const [k, v] of Object.entries(vars)) {\n    result = result.replace(new RegExp(`\\\\{\\\\{${k}\\\\}\\\\}`, 'g'), v);\n  }\n  return result;\n}"]}

package/dist/search.d.ts

@@ -0,0 +1,20 @@
+import { Tool } from '@wrongstack/core';
+
+interface SearchInput {
+    query: string;
+    num_results?: number;
+    source?: 'duckduckgo' | 'google' | 'bing';
+}
+interface SearchOutput {
+    query: string;
+    results: {
+        title: string;
+        url: string;
+        snippet: string;
+    }[];
+    source: string;
+    truncated: boolean;
+}
+declare const searchTool: Tool<SearchInput, SearchOutput>;
+
+export { searchTool };

package/dist/search.js

@@ -0,0 +1,212 @@
+// src/search.ts
+var DEFAULT_NUM = 10;
+var MAX_RESULTS = 50;
+var TIMEOUT_MS = 15e3;
+var searchTool = {
+  name: "search",
+  description: "Search the web for information. Returns title, URL, and snippet for each result.",
+  usageHint: "Set `num_results` (1-50, default 10). Use `source` to pick engine: duckduckgo (default), google, bing.",
+  permission: "confirm",
+  mutating: false,
+  timeoutMs: TIMEOUT_MS,
+  inputSchema: {
+    type: "object",
+    properties: {
+      query: { type: "string", description: "Search query" },
+      num_results: {
+        type: "integer",
+        description: "Number of results (1-50, default 10)",
+        minimum: 1,
+        maximum: MAX_RESULTS
+      },
+      source: {
+        type: "string",
+        enum: ["duckduckgo", "google", "bing"],
+        description: "Search engine to use (default: duckduckgo)"
+      }
+    },
+    required: ["query"]
+  },
+  async execute(input, ctx, opts) {
+    let final;
+    for await (const ev of searchTool.executeStream(input, ctx, opts)) {
+      if (ev.type === "final") final = ev.output;
+    }
+    if (!final) throw new Error("search: stream ended without final event");
+    return final;
+  },
+  async *executeStream(input, _ctx, opts) {
+    if (!input?.query) throw new Error("search: query is required");
+    const num = Math.max(1, Math.min(input.num_results ?? DEFAULT_NUM, MAX_RESULTS));
+    const source = input.source ?? "duckduckgo";
+    yield { type: "log", text: `Querying ${source} for "${input.query}"\u2026`, data: { source, query: input.query } };
+    let output;
+    switch (source) {
+      case "duckduckgo":
+        output = await duckduckgoSearch(input.query, num, opts.signal);
+        break;
+      case "google":
+        output = await googleSearch(input.query, num, opts.signal);
+        break;
+      case "bing":
+        output = await bingSearch(input.query, num, opts.signal);
+        break;
+      default:
+        throw new Error(`search: unknown source "${source}"`);
+    }
+    yield {
+      type: "partial_output",
+      text: `${output.results.length} results from ${output.source}`,
+      data: { count: output.results.length }
+    };
+    yield { type: "final", output };
+  }
+};
+async function duckduckgoSearch(query, num, signal) {
+  const encoded = encodeURIComponent(query);
+  const url = `https://lite.duckduckgo.com/lite/?q=${encoded}&kd=-1&kl=wt-wt`;
+  const results = await fetchWithTimeout(url, signal, TIMEOUT_MS).then((r) => r.text()).then((html) => parseDuckDuckGo(html, num)).catch(() => [{ title: "Search unavailable", url: "", snippet: "Could not reach DuckDuckGo" }]);
+  return {
+    query,
+    results,
+    source: "duckduckgo",
+    truncated: results.length >= num
+  };
+}
+function takeFrom(iter, max) {
+  const out = [];
+  for (const item of iter) {
+    if (out.length >= max) break;
+    out.push(item);
+  }
+  return out;
+}
+function parseDuckDuckGo(html, num) {
+  const results = [];
+  const snippetRegex = /<a class="result-link"[^>]+href="([^"]+)"[^>]*>([^<]+)<\/a>/gi;
+  const snippet2Regex = /<a class="result-snippet"[^>]*>([^<]+)<\/a>/gi;
+  const linkMatches = takeFrom(
+    [...html.matchAll(snippetRegex)].filter((m) => m[1] && m[2]).map((m) => ({ url: m[1], title: stripTags(m[2]) })),
+    num
+  );
+  const snippetMatches = takeFrom(
+    [...html.matchAll(snippet2Regex)].filter((m) => m[1]).map((m) => stripTags(m[1])),
+    num
+  );
+  for (let i = 0; i < linkMatches.length && i < num; i++) {
+    const entry = linkMatches[i];
+    results.push({
+      title: entry?.title ?? "",
+      url: entry?.url ?? "",
+      snippet: snippetMatches[i] ?? ""
+    });
+  }
+  return results;
+}
+async function googleSearch(query, num, signal) {
+  const encoded = encodeURIComponent(query);
+  const url = `https://www.google.com/search?q=${encoded}&hl=en`;
+  const html = await fetchWithTimeout(url, signal, TIMEOUT_MS).then((r) => r.text()).catch(() => "");
+  const results = parseGoogleResults(html, num);
+  return {
+    query,
+    results,
+    source: "google",
+    truncated: results.length >= num
+  };
+}
+function parseGoogleResults(html, num) {
+  const results = [];
+  const titleRegex = /<h3[^>]*class="[^"]*DKV84"[^>]*>([^<]+)<\/h3>/gi;
+  const urlRegex = /<cite[^>]*>([^<]+)<\/cite>/gi;
+  const snippetRegex = /<span[^>]*class="[^"]*aXCZ0b[^>]*>([^<]+)<\/span>/gi;
+  const titles = takeFrom(
+    [...html.matchAll(titleRegex)].filter((m) => m[1]).map((m) => stripTags(m[1])),
+    num
+  );
+  const urls = takeFrom(
+    [...html.matchAll(urlRegex)].filter((m) => m[1]).map((m) => stripTags(m[1]).replace(/^\*(https?:\/\/[^\s]+).*$/, "$1")).filter((u) => u.startsWith("http")),
+    num
+  );
+  const snippets = takeFrom(
+    [...html.matchAll(snippetRegex)].filter((m) => m[1]).map((m) => stripTags(m[1])),
+    num
+  );
+  for (let i = 0; i < Math.min(titles.length, num); i++) {
+    results.push({
+      title: titles[i] ?? "",
+      url: urls[i] ?? "",
+      snippet: snippets[i] ?? ""
+    });
+  }
+  return results;
+}
+async function bingSearch(query, num, signal) {
+  const encoded = encodeURIComponent(query);
+  const url = `https://www.bing.com/search?q=${encoded}`;
+  const html = await fetchWithTimeout(url, signal, TIMEOUT_MS).then((r) => r.text()).catch(() => "");
+  const results = parseBingResults(html, num);
+  return {
+    query,
+    results,
+    source: "bing",
+    truncated: results.length >= num
+  };
+}
+function parseBingResults(html, num) {
+  const results = [];
+  const titleRegex = /<h2[^>]*>\s*<a[^>]+href="([^"]+)"[^>]*>([^<]+)<\/a>\s*<\/h2>/gi;
+  const snippetRegex = /<p[^>]*class="[^"]*b_paractl[^"]*"[^>]*>([^<]+)<\/p>/gi;
+  const entries = takeFrom(
+    [...html.matchAll(titleRegex)].filter((m) => m[1] && m[2]).map((m) => ({ url: m[1], title: stripTags(m[2]) })),
+    num
+  );
+  const snippets = takeFrom(
+    [...html.matchAll(snippetRegex)].filter((m) => m[1]).map((m) => stripTags(m[1])),
+    num
+  );
+  for (let i = 0; i < entries.length; i++) {
+    results.push({
+      title: entries[i]?.title ?? "",
+      url: entries[i]?.url ?? "",
+      snippet: snippets[i] ?? ""
+    });
+  }
+  return results;
+}
+async function fetchWithTimeout(url, signal, timeoutMs) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  const fetchSignal = anySignal(signal, controller.signal);
+  try {
+    const res = await fetch(url, {
+      headers: {
+        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
+      },
+      signal: fetchSignal
+    });
+    clearTimeout(timer);
+    return res;
+  } catch (e) {
+    clearTimeout(timer);
+    throw e;
+  }
+}
+function anySignal(...signals) {
+  const controller = new AbortController();
+  for (const s of signals) {
+    if (s.aborted) {
+      controller.abort();
+      break;
+    }
+    s.addEventListener("abort", () => controller.abort());
+  }
+  return controller.signal;
+}
+function stripTags(html) {
+  return html.replace(/<[^>]+>/g, "").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'").trim();
+}
+
+export { searchTool };
+//# sourceMappingURL=search.js.map
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/search.ts"],"names":[],"mappings":"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","file":"search.js","sourcesContent":["import type { Tool, ToolStreamEvent } from '@wrongstack/core';\r\n\r\ninterface SearchInput {\r\n  query: string;\r\n  num_results?: number;\r\n  source?: 'duckduckgo' | 'google' | 'bing';\r\n}\r\n\r\ninterface SearchOutput {\r\n  query: string;\r\n  results: { title: string; url: string; snippet: string }[];\r\n  source: string;\r\n  truncated: boolean;\r\n}\r\n\r\nconst DEFAULT_NUM = 10;\r\nconst MAX_RESULTS = 50;\r\nconst TIMEOUT_MS = 15_000;\r\n\r\nexport const searchTool: Tool<SearchInput, SearchOutput> = {\r\n  name: 'search',\r\n  description:\r\n    'Search the web for information. Returns title, URL, and snippet for each result.',\r\n  usageHint:\r\n    'Set `num_results` (1-50, default 10). Use `source` to pick engine: duckduckgo (default), google, bing.',\r\n  permission: 'confirm',\r\n  mutating: false,\r\n  timeoutMs: TIMEOUT_MS,\r\n  inputSchema: {\r\n    type: 'object',\r\n    properties: {\r\n      query: { type: 'string', description: 'Search query' },\r\n      num_results: {\r\n        type: 'integer',\r\n        description: 'Number of results (1-50, default 10)',\r\n        minimum: 1,\r\n        maximum: MAX_RESULTS,\r\n      },\r\n      source: {\r\n        type: 'string',\r\n        enum: ['duckduckgo', 'google', 'bing'],\r\n        description: 'Search engine to use (default: duckduckgo)',\r\n      },\r\n    },\r\n    required: ['query'],\r\n  },\r\n  async execute(input, ctx, opts) {\r\n    let final: SearchOutput | undefined;\r\n    for await (const ev of searchTool.executeStream!(input, ctx, opts)) {\r\n      if (ev.type === 'final') final = ev.output;\r\n    }\r\n    if (!final) throw new Error('search: stream ended without final event');\r\n    return final;\r\n  },\r\n  async *executeStream(input, _ctx, opts): AsyncGenerator<ToolStreamEvent<SearchOutput>> {\r\n    if (!input?.query) throw new Error('search: query is required');\r\n\r\n    const num = Math.max(1, Math.min(input.num_results ?? DEFAULT_NUM, MAX_RESULTS));\r\n    const source = input.source ?? 'duckduckgo';\r\n\r\n    yield { type: 'log', text: `Querying ${source} for \"${input.query}\"…`, data: { source, query: input.query } };\r\n\r\n    let output: SearchOutput;\r\n    switch (source) {\r\n      case 'duckduckgo':\r\n        output = await duckduckgoSearch(input.query, num, opts.signal);\r\n        break;\r\n      case 'google':\r\n        output = await googleSearch(input.query, num, opts.signal);\r\n        break;\r\n      case 'bing':\r\n        output = await bingSearch(input.query, num, opts.signal);\r\n        break;\r\n      default:\r\n        throw new Error(`search: unknown source \"${source}\"`);\r\n    }\r\n\r\n    yield {\r\n      type: 'partial_output',\r\n      text: `${output.results.length} results from ${output.source}`,\r\n      data: { count: output.results.length },\r\n    };\r\n    yield { type: 'final', output };\r\n  },\r\n};\r\n\r\nasync function duckduckgoSearch(\r\n  query: string,\r\n  num: number,\r\n  signal: AbortSignal,\r\n): Promise<SearchOutput> {\r\n  const encoded = encodeURIComponent(query);\r\n  const url = `https://lite.duckduckgo.com/lite/?q=${encoded}&kd=-1&kl=wt-wt`;\r\n\r\n  const results = await fetchWithTimeout(url, signal, TIMEOUT_MS)\r\n    .then((r) => r.text())\r\n    .then((html) => parseDuckDuckGo(html, num))\r\n    .catch(() => [{ title: 'Search unavailable', url: '', snippet: 'Could not reach DuckDuckGo' }]);\r\n\r\n  return {\r\n    query,\r\n    results,\r\n    source: 'duckduckgo',\r\n    truncated: results.length >= num,\r\n  };\r\n}\r\n\r\nfunction takeFrom<T>(iter: Iterable<T>, max: number): T[] {\r\n  const out: T[] = [];\r\n  for (const item of iter) {\r\n    if (out.length >= max) break;\r\n    out.push(item);\r\n  }\r\n  return out;\r\n}\r\n\r\nfunction parseDuckDuckGo(html: string, num: number): SearchOutput['results'] {\r\n  const results: SearchOutput['results'] = [];\r\n  const snippetRegex = /<a class=\"result-link\"[^>]+href=\"([^\"]+)\"[^>]*>([^<]+)<\\/a>/gi;\r\n  const snippet2Regex = /<a class=\"result-snippet\"[^>]*>([^<]+)<\\/a>/gi;\r\n\r\n  const linkMatches = takeFrom(\r\n    [...html.matchAll(snippetRegex)]\r\n      .filter((m) => m[1] && m[2])\r\n      .map((m) => ({ url: m[1]!, title: stripTags(m[2]!) })),\r\n    num,\r\n  );\r\n\r\n  const snippetMatches = takeFrom(\r\n    [...html.matchAll(snippet2Regex)]\r\n      .filter((m) => m[1])\r\n      .map((m) => stripTags(m[1]!)),\r\n    num,\r\n  );\r\n\r\n  for (let i = 0; i < linkMatches.length && i < num; i++) {\r\n    const entry = linkMatches[i];\r\n    results.push({\r\n      title: entry?.title ?? '',\r\n      url: entry?.url ?? '',\r\n      snippet: snippetMatches[i] ?? '',\r\n    });\r\n  }\r\n\r\n  return results;\r\n}\r\n\r\nasync function googleSearch(\r\n  query: string,\r\n  num: number,\r\n  signal: AbortSignal,\r\n): Promise<SearchOutput> {\r\n  const encoded = encodeURIComponent(query);\r\n  const url = `https://www.google.com/search?q=${encoded}&hl=en`;\r\n\r\n  const html = await fetchWithTimeout(url, signal, TIMEOUT_MS)\r\n    .then((r) => r.text())\r\n    .catch(() => '');\r\n\r\n  const results = parseGoogleResults(html, num);\r\n\r\n  return {\r\n    query,\r\n    results,\r\n    source: 'google',\r\n    truncated: results.length >= num,\r\n  };\r\n}\r\n\r\nfunction parseGoogleResults(html: string, num: number): SearchOutput['results'] {\r\n  const results: SearchOutput['results'] = [];\r\n  const titleRegex = /<h3[^>]*class=\"[^\"]*DKV84\"[^>]*>([^<]+)<\\/h3>/gi;\r\n  const urlRegex = /<cite[^>]*>([^<]+)<\\/cite>/gi;\r\n  const snippetRegex = /<span[^>]*class=\"[^\"]*aXCZ0b[^>]*>([^<]+)<\\/span>/gi;\r\n\r\n  const titles = takeFrom(\r\n    [...html.matchAll(titleRegex)].filter((m) => m[1]).map((m) => stripTags(m[1]!)),\r\n    num,\r\n  );\r\n\r\n  const urls = takeFrom(\r\n    [...html.matchAll(urlRegex)]\r\n      .filter((m) => m[1])\r\n      .map((m) => stripTags(m[1]!).replace(/^\\*(https?:\\/\\/[^\\s]+).*$/, '$1'))\r\n      .filter((u) => u.startsWith('http')),\r\n    num,\r\n  );\r\n\r\n  const snippets = takeFrom(\r\n    [...html.matchAll(snippetRegex)].filter((m) => m[1]).map((m) => stripTags(m[1]!)),\r\n    num,\r\n  );\r\n\r\n  for (let i = 0; i < Math.min(titles.length, num); i++) {\r\n    results.push({\r\n      title: titles[i] ?? '',\r\n      url: urls[i] ?? '',\r\n      snippet: snippets[i] ?? '',\r\n    });\r\n  }\r\n\r\n  return results;\r\n}\r\n\r\nasync function bingSearch(\r\n  query: string,\r\n  num: number,\r\n  signal: AbortSignal,\r\n): Promise<SearchOutput> {\r\n  const encoded = encodeURIComponent(query);\r\n  const url = `https://www.bing.com/search?q=${encoded}`;\r\n\r\n  const html = await fetchWithTimeout(url, signal, TIMEOUT_MS)\r\n    .then((r) => r.text())\r\n    .catch(() => '');\r\n\r\n  const results = parseBingResults(html, num);\r\n\r\n  return {\r\n    query,\r\n    results,\r\n    source: 'bing',\r\n    truncated: results.length >= num,\r\n  };\r\n}\r\n\r\nfunction parseBingResults(html: string, num: number): SearchOutput['results'] {\r\n  const results: SearchOutput['results'] = [];\r\n  const titleRegex = /<h2[^>]*>\\s*<a[^>]+href=\"([^\"]+)\"[^>]*>([^<]+)<\\/a>\\s*<\\/h2>/gi;\r\n  const snippetRegex = /<p[^>]*class=\"[^\"]*b_paractl[^\"]*\"[^>]*>([^<]+)<\\/p>/gi;\r\n\r\n  const entries = takeFrom(\r\n    [...html.matchAll(titleRegex)]\r\n      .filter((m) => m[1] && m[2])\r\n      .map((m) => ({ url: m[1]!, title: stripTags(m[2]!) })),\r\n    num,\r\n  );\r\n\r\n  const snippets = takeFrom(\r\n    [...html.matchAll(snippetRegex)].filter((m) => m[1]).map((m) => stripTags(m[1]!)),\r\n    num,\r\n  );\r\n\r\n  for (let i = 0; i < entries.length; i++) {\r\n    results.push({\r\n      title: entries[i]?.title ?? '',\r\n      url: entries[i]?.url ?? '',\r\n      snippet: snippets[i] ?? '',\r\n    });\r\n  }\r\n\r\n  return results;\r\n}\r\n\r\nasync function fetchWithTimeout(\r\n  url: string,\r\n  signal: AbortSignal,\r\n  timeoutMs: number,\r\n): Promise<Response> {\r\n  const controller = new AbortController();\r\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\r\n\r\n  const fetchSignal = anySignal(signal, controller.signal);\r\n  try {\r\n    const res = await fetch(url, {\r\n      headers: {\r\n        'User-Agent':\r\n          'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',\r\n      },\r\n      signal: fetchSignal,\r\n    });\r\n    clearTimeout(timer);\r\n    return res;\r\n  } catch (e) {\r\n    clearTimeout(timer);\r\n    throw e;\r\n  }\r\n}\r\n\r\nfunction anySignal(...signals: AbortSignal[]): AbortSignal {\r\n  const controller = new AbortController();\r\n  for (const s of signals) {\r\n    if (s.aborted) { controller.abort(); break; }\r\n    s.addEventListener('abort', () => controller.abort());\r\n  }\r\n  return controller.signal;\r\n}\r\n\r\nfunction stripTags(html: string): string {\r\n  return html.replace(/<[^>]+>/g, '').replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '\"').replace(/&#39;/g, \"'\").trim();\r\n}"]}

package/dist/test.d.ts

@@ -0,0 +1,24 @@
+import { Tool } from '@wrongstack/core';
+
+interface TestInput {
+    files?: string | string[];
+    runner?: 'vitest' | 'jest' | 'mocha' | 'auto';
+    watch?: boolean;
+    coverage?: boolean;
+    cwd?: string;
+    grep?: string;
+    timeout?: number;
+}
+interface TestOutput {
+    runner: string;
+    exit_code: number;
+    tests_run: number;
+    passed: number;
+    failed: number;
+    duration_ms: number;
+    output: string;
+    truncated: boolean;
+}
+declare const testTool: Tool<TestInput, TestOutput>;
+
+export { testTool };