@wrongstack/tools 1.0.3 → 1.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wrongstack/tools",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "license": "MIT",
   "description": "WrongStack built-in tools: read/write/edit, bash/exec, grep/glob, git, fetch, test, lint, and more.",
   "repository": {
@@ -160,14 +160,6 @@
       "types": "./dist/logs.d.ts",
       "import": "./dist/logs.js"
     },
-    "./document": {
-      "types": "./dist/document.d.ts",
-      "import": "./dist/document.js"
-    },
-    "./scaffold": {
-      "types": "./dist/scaffold.d.ts",
-      "import": "./dist/scaffold.js"
-    },
     "./tool-search": {
       "types": "./dist/tool-search.d.ts",
       "import": "./dist/tool-search.js"
@@ -176,14 +168,6 @@
       "types": "./dist/tool-use.d.ts",
       "import": "./dist/tool-use.js"
     },
-    "./batch-tool-use": {
-      "types": "./dist/batch-tool-use.d.ts",
-      "import": "./dist/batch-tool-use.js"
-    },
-    "./tool-help": {
-      "types": "./dist/tool-help.d.ts",
-      "import": "./dist/tool-help.js"
-    },
     "./memory": {
       "types": "./dist/memory.d.ts",
       "import": "./dist/memory.js"
@@ -220,6 +204,10 @@
       "types": "./dist/session-kanban.d.ts",
       "import": "./dist/session-kanban.js"
     },
+    "./session-shell": {
+      "types": "./dist/session-shell.d.ts",
+      "import": "./dist/session-shell.js"
+    },
     "./process-registry": {
       "types": "./dist/process-registry.d.ts",
       "import": "./dist/process-registry.js"
@@ -249,10 +237,10 @@
     "@msgpack/msgpack": "^3.1.3",
     "@playwright/test": "^1.62.1",
     "@typescript/typescript6": "^6.0.2",
-    "@wrongstack/core": "1.0.3",
-    "@wrongstack/kanban": "1.0.3",
-    "@wrongstack/persistence": "1.0.3",
-    "@wrongstack/primitives": "1.0.3",
+    "@wrongstack/core": "1.0.5",
+    "@wrongstack/kanban": "1.0.5",
+    "@wrongstack/persistence": "1.0.5",
+    "@wrongstack/primitives": "1.0.5",
     "tree-sitter-wasm": "1.1.4",
     "turndown": "^7.2.4",
     "undici": "^8.10.0",

package/dist/batch-tool-use.d.ts

@@ -1,24 +0,0 @@
-import { type Tool } from '@wrongstack/core/types';
-export interface BatchToolUseInput {
-    calls: {
-        tool: string;
-        input: Record<string, unknown>;
-    }[];
-    stop_on_error?: boolean | undefined;
-    parallel?: boolean | undefined;
-}
-export interface BatchToolUseOutput {
-    results: {
-        tool: string;
-        success: boolean;
-        result?: unknown | undefined;
-        error?: string | undefined;
-        executionMs: number;
-    }[];
-    total: number;
-    succeeded: number;
-    failed: number;
-    stop_on_error: boolean;
-}
-export declare const batchToolUseTool: Tool<BatchToolUseInput, BatchToolUseOutput>;
-//# sourceMappingURL=batch-tool-use.d.ts.map

package/dist/batch-tool-use.js

@@ -1,7 +0,0 @@
-import {
-  batchToolUseTool
-} from "./chunk-VBF2YXUW.js";
-export {
-  batchToolUseTool
-};
-//# sourceMappingURL=batch-tool-use.js.map

package/dist/chunk-7ODZTPCU.js

@@ -1,128 +0,0 @@
-// src/tool-help.ts
-var toolHelpTool = {
-  name: "tool_help",
-  category: "Meta",
-  description: "Get detailed help for a specific tool, including its full input schema and usage guidance. If you do not know which tool to use, search with `tool_search` first, then call this with the tool name.",
-  usageHint: "USE WHEN YOU NEED PRECISE TOOL INFORMATION:\n\n- Call with a specific `tool` name when you want the full schema and current usageHint.\n- Omit `tool` to get an overview of all available tools.\n- Different `format` options give you different levels of detail.\n- Tip: use `tool_search` to find the right tool name, then `tool_help` for the full schema.\nThis tool is extremely valuable for self-correction when you are unsure about a tool's interface.",
-  permission: "auto",
-  mutating: false,
-  timeoutMs: 5e3,
-  capabilities: ["tool.meta"],
-  icon: "meta",
-  inputSchema: {
-    type: "object",
-    properties: {
-      tool: {
-        type: "string",
-        description: "Specific tool name to get detailed help for. Omit to get a list of all tools."
-      },
-      format: {
-        type: "string",
-        enum: ["short", "full", "markdown"],
-        description: 'Level of detail: "short" (summary), "full" (with full schema), "markdown" (human readable).'
-      },
-      include_examples: {
-        type: "boolean",
-        description: "Whether to include example usage in the response."
-      }
-    }
-  },
-  async execute(input, ctx) {
-    const format = input.format ?? "short";
-    const includeExamples = input.include_examples ?? false;
-    if (input.tool) {
-      const tool = (ctx.catalogTools ?? 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.catalogTools ?? 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.replaceAll("|", "\\|")} |`);
-  }
-  return lines.join("\n");
-}
-
-export {
-  toolHelpTool
-};
-//# sourceMappingURL=chunk-7ODZTPCU.js.map

package/dist/chunk-CHEK3ASV.js

@@ -1,183 +0,0 @@
-import {
-  ensureInsideRoot,
-  safeResolveReal
-} from "./chunk-ZUFHAHTE.js";
-
-// src/document.ts
-import * as fs from "node:fs/promises";
-import * as path from "node:path";
-var documentTool = {
-  name: "document",
-  category: "Project",
-  description: "DEPRECATED \u2014 read-only preview stub that lists undocumented symbols as `skipped` candidates. It never writes files and does not generate real docstrings. If the auto-doc plugin is enabled, use its `auto_doc` tool (with `dry_run: true` to preview) instead.",
-  usageHint: "Deprecated: this tool only lists undocumented symbols with placeholder comments \u2014 it does not generate real JSDoc/TSDoc and writes nothing. When the auto-doc plugin is enabled, prefer its `auto_doc` tool (`dry_run: true` for previewing, without it for writing).",
-  permission: "auto",
-  mutating: false,
-  timeoutMs: 3e4,
-  capabilities: ["fs.read"],
-  icon: "document",
-  inputSchema: {
-    type: "object",
-    properties: {
-      target: {
-        type: "string",
-        enum: ["file", "function", "class", "type", "all"],
-        description: "What to document"
-      },
-      path: {
-        type: "string",
-        description: "Specific file path to document"
-      },
-      files: {
-        oneOf: [
-          { type: "string" },
-          { type: "array", items: { type: "string" } }
-        ],
-        description: "File(s) to process: single path, comma-separated list, or glob"
-      },
-      style: {
-        type: "string",
-        enum: ["jsdoc", "tsdoc", "block"],
-        description: "Documentation style (default: jsdoc)"
-      },
-      cwd: { type: "string", description: "Working directory (default: cwd)" }
-    }
-  },
-  async execute(input, ctx, _opts) {
-    const signal = _opts?.signal ?? ctx?.signal;
-    signal?.throwIfAborted();
-    const cwd = input.cwd ? await safeResolveReal(input.cwd, ctx) : ctx.cwd;
-    const style = input.style ?? "jsdoc";
-    const results = [];
-    let filesProcessed = 0;
-    let itemsDocumented = 0;
-    const fileList = input.files ? await resolveFiles(
-      Array.isArray(input.files) ? input.files.join(",") : input.files,
-      cwd,
-      ctx
-    ) : input.path ? [await safeResolveReal(input.path, ctx)] : [];
-    for (const absPath of fileList) {
-      if (signal?.aborted) break;
-      try {
-        const content = await fs.readFile(absPath, "utf8");
-        filesProcessed++;
-        const processed = processFile(
-          content,
-          absPath,
-          style,
-          input.overwrite ?? false,
-          input.target ?? "all"
-        );
-        results.push(...processed);
-        itemsDocumented += processed.filter((r) => r.status === "documented").length;
-      } catch (e) {
-        results.push({
-          path: absPath,
-          name: path.basename(absPath),
-          signature: "",
-          docstring: "",
-          status: "error",
-          error: e instanceof Error ? e.message : String(e)
-        });
-      }
-    }
-    return {
-      files_processed: filesProcessed,
-      items_documented: itemsDocumented,
-      results,
-      style
-    };
-  }
-};
-function getLineNumber(content, index) {
-  let line = 1;
-  for (let i = 0; i < index; i++) {
-    if (content.charCodeAt(i) === 10) line++;
-  }
-  return line;
-}
-async function resolveFiles(filesInput, cwd, ctx) {
-  const files = filesInput.split(",");
-  const resolved = [];
-  for (const f of files) {
-    const entry = f.trim();
-    if (!entry) continue;
-    let absPath;
-    try {
-      absPath = ensureInsideRoot(path.resolve(cwd, entry), ctx);
-    } catch {
-      continue;
-    }
-    try {
-      const stat2 = await fs.stat(absPath);
-      if (stat2.isFile()) resolved.push(absPath);
-    } catch {
-    }
-  }
-  return [...new Set(resolved)];
-}
-function processFile(content, absPath, _style, _overwrite, target) {
-  const results = [];
-  const functionRegex = /(?:async\s+)?function\s+(\w+)\s*\(([^)]*)\)/g;
-  const arrowRegex = /(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s+)?\(([^)]*)\)\s*=>/g;
-  const classRegex = /class\s+(\w+)/g;
-  const typeRegex = /(?:type|interface)\s+(\w+)\s*[=<]/g;
-  const allMatches = [];
-  if (target === "all" || target === "function") {
-    for (const m of content.matchAll(functionRegex)) {
-      if (!m[1]) continue;
-      allMatches.push({
-        name: m[1],
-        sig: m[2] ?? "",
-        type: "function",
-        line: getLineNumber(content, m.index)
-      });
-    }
-    for (const m of content.matchAll(arrowRegex)) {
-      if (!m[1]) continue;
-      allMatches.push({
-        name: m[1],
-        sig: m[2] ?? "",
-        type: "arrow",
-        line: getLineNumber(content, m.index)
-      });
-    }
-  }
-  if (target === "all" || target === "class") {
-    for (const m of content.matchAll(classRegex)) {
-      if (!m[1]) continue;
-      allMatches.push({
-        name: m[1],
-        sig: "",
-        type: "class",
-        line: getLineNumber(content, m.index)
-      });
-    }
-  }
-  if (target === "all" || target === "type") {
-    for (const m of content.matchAll(typeRegex)) {
-      if (!m[1]) continue;
-      allMatches.push({
-        name: m[1],
-        sig: m[0] ?? "",
-        type: "type",
-        line: getLineNumber(content, m.index)
-      });
-    }
-  }
-  for (const m of allMatches) {
-    results.push({
-      path: absPath,
-      name: m.name,
-      signature: m.sig,
-      docstring: `/** ${m.name} - documented at line ${m.line} */`,
-      status: "skipped"
-    });
-  }
-  return results;
-}
-
-export {
-  documentTool
-};
-//# sourceMappingURL=chunk-CHEK3ASV.js.map

package/dist/chunk-KLJZ4WV4.js

@@ -1,213 +0,0 @@
-import {
-  safeResolveReal
-} from "./chunk-ZUFHAHTE.js";
-
-// src/scaffold.ts
-import * as fs from "node:fs/promises";
-import * as path from "node:path";
-import { atomicWrite } from "@wrongstack/core/utils";
-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",
-  category: "Project",
-  description: "Generate or preview files and folder structures from built-in templates or custom definitions. Writes files to disk unless dry_run is set. This is the recommended way to bootstrap new packages, components, or modules instead of creating files one by one with `write`.",
-  usageHint: "PREFERRED FOR SCAFFOLDING:\n\n- Use built-in templates when they match your needs (e.g. react-component, npm-package).\n- Supports `dry_run` so you can preview exactly what will be created.\n- Has the powerful `fs.write.outside-project` capability \u2014 review paths carefully.\nMuch cleaner and safer than manually writing multiple files.",
-  permission: "confirm",
-  mutating: true,
-  subjectKey: "name",
-  capabilities: ["fs.write.outside-project", "fs.write"],
-  icon: "scaffold",
-  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, _opts) {
-    const signal = _opts?.signal ?? ctx?.signal;
-    signal?.throwIfAborted();
-    const cwd = input.cwd ? await safeResolveReal(input.cwd, ctx) : ctx.cwd;
-    const name = input.name;
-    const vars = { name, ...input.vars };
-    const builtIn = BUILT_IN_TEMPLATES[input.template];
-    if (builtIn) {
-      return await handleBuiltIn(
-        name,
-        builtIn.files,
-        cwd,
-        ctx,
-        input.dry_run ?? false,
-        vars,
-        signal
-      );
-    }
-    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(", ")}`
-    };
-  }
-};
-async function handleBuiltIn(name, templateFiles, cwd, ctx, dryRun, vars, signal) {
-  const files = [];
-  let filesCreated = 0;
-  for (const [filePath, content] of Object.entries(templateFiles)) {
-    if (signal?.aborted) break;
-    const resolvedPath = substituteVars(filePath, name, vars);
-    const joinedPath = path.join(cwd, resolvedPath);
-    const root = path.resolve(ctx.projectRoot ?? ctx.cwd ?? process.cwd());
-    const target = path.resolve(joinedPath);
-    const rel = path.relative(root, target);
-    if (rel.startsWith("..") || path.isAbsolute(rel)) {
-      throw new Error(`scaffold: generated path "${resolvedPath}" would escape project root`);
-    }
-    const fullPath = target;
-    if (!dryRun) {
-      await fs.mkdir(path.dirname(fullPath), { recursive: true });
-      await atomicWrite(fullPath, substituteVars(content, name, vars));
-    }
-    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 escapeRegexLiteral(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function substituteVars(content, name, vars) {
-  const kebab = name.toLowerCase().replace(/\s+/g, "-");
-  const pascal = name.replace(/(?:^|[-_\s]+)([a-zA-Z])/g, (_, c) => c.toUpperCase());
-  let result = content;
-  result = result.replace(/\{\{name\}\}/g, () => kebab);
-  result = result.replace(/\{\{Name\}\}/g, () => pascal);
-  for (const [k, v] of Object.entries(vars)) {
-    if (k === "name" || k === "Name") continue;
-    result = result.replace(new RegExp(`\\{\\{${escapeRegexLiteral(k)}\\}\\}`, "g"), () => v);
-  }
-  return result;
-}
-
-export {
-  BUILT_IN_TEMPLATES,
-  scaffoldTool
-};
-//# sourceMappingURL=chunk-KLJZ4WV4.js.map