@wrongstack/tools 1.0.3 → 1.0.5

package/dist/chunk-VBF2YXUW.js

@@ -1,203 +0,0 @@
-// src/batch-tool-use.ts
-import {
-  GOVERNED_TOOL_EXECUTOR_META_KEY
-} from "@wrongstack/core/types";
-var BATCHABLE_TOOL_NAMES = [
-  "read",
-  "glob",
-  "grep",
-  "tree",
-  "codebase-stats",
-  "codebase-search",
-  "language_info",
-  "tool_search",
-  "memory_for_file",
-  "memory_for_path",
-  "memory_search"
-];
-var BATCHABLE_TOOLS = new Set(BATCHABLE_TOOL_NAMES);
-var MAX_BATCH_CALLS = 8;
-var MAX_PARALLEL_BATCH_CALLS = 3;
-var batchToolUseTool = {
-  name: "batch_tool_use",
-  category: "Meta",
-  description: "Execute a small batch of independent, read-only discovery calls. Process, mutation, browser-action, MCP, delegation, and nested meta tools are not eligible.",
-  usageHint: `BOUNDED READ-ONLY BATCHING:
-
-- Use only for a small set of independent reads or searches that are all needed now.
-- Do not wrap normal sequential reasoning or every tool call in a batch.
-- \`parallel: true\` (default) runs at most three eligible calls concurrently.
-- \`stop_on_error: true\` makes it fail fast on the first error.
-- Eligible tools: ${BATCHABLE_TOOL_NAMES.join(", ")}.`,
-  permission: "confirm",
-  // Scheduling barrier: keep the outer meta-call out of ToolExecutor's
-  // non-mutating fan-out even though every eligible inner tool is read-only.
-  mutating: true,
-  timeoutMs: 12e4,
-  capabilities: ["tool.meta"],
-  icon: "meta",
-  inputSchema: {
-    type: "object",
-    properties: {
-      calls: {
-        type: "array",
-        maxItems: MAX_BATCH_CALLS,
-        items: {
-          type: "object",
-          properties: {
-            tool: {
-              type: "string",
-              enum: [...BATCHABLE_TOOL_NAMES],
-              description: "An explicitly batch-safe, read-only discovery tool."
-            },
-            input: { type: "object" }
-          },
-          required: ["tool"]
-        },
-        description: `Up to ${MAX_BATCH_CALLS} independent, batch-safe read calls.`
-      },
-      stop_on_error: {
-        type: "boolean",
-        description: "Stop execution on first error (default: false)"
-      },
-      parallel: {
-        type: "boolean",
-        description: "Execute calls in parallel (default: true)"
-      }
-    },
-    required: ["calls"]
-  },
-  async execute(input, ctx, _opts) {
-    if (!input?.calls || input.calls.length === 0) {
-      return {
-        results: [],
-        total: 0,
-        succeeded: 0,
-        failed: 0,
-        stop_on_error: false
-      };
-    }
-    if (input.calls.length > MAX_BATCH_CALLS) {
-      throw new Error(`batch_tool_use: calls must contain at most ${MAX_BATCH_CALLS} items`);
-    }
-    const governedExecute = ctx.meta?.[GOVERNED_TOOL_EXECUTOR_META_KEY];
-    if (typeof governedExecute !== "function") {
-      return {
-        results: input.calls.map((call) => ({
-          tool: call.tool,
-          success: false,
-          error: "governed nested execution is unavailable; call the tool directly",
-          executionMs: 0
-        })),
-        total: input.calls.length,
-        succeeded: 0,
-        failed: input.calls.length,
-        stop_on_error: input.stop_on_error ?? false
-      };
-    }
-    const results = [];
-    let succeeded = 0;
-    let failed = 0;
-    if (input.parallel !== false) {
-      let stopRequested = false;
-      const allResults = await mapWithConcurrency(
-        input.calls,
-        MAX_PARALLEL_BATCH_CALLS,
-        async (call) => {
-          const result = await executeSingle(call, ctx, governedExecute);
-          if (input.stop_on_error && !result.success) stopRequested = true;
-          return result;
-        },
-        () => stopRequested
-      );
-      const executed = allResults.filter(
-        (r) => r !== void 0
-      );
-      results.push(...executed);
-      succeeded = executed.filter((r) => r.success).length;
-      failed = executed.filter((r) => !r.success).length;
-    } else {
-      for (const call of input.calls) {
-        const result = await executeSingle(call, ctx, governedExecute);
-        results.push(result);
-        if (result.success) {
-          succeeded++;
-        } else {
-          failed++;
-          if (input.stop_on_error) break;
-        }
-      }
-    }
-    return {
-      results,
-      total: input.calls.length,
-      succeeded,
-      failed,
-      stop_on_error: input.stop_on_error ?? false
-    };
-  }
-};
-async function mapWithConcurrency(items, limit, run, shouldStop) {
-  const results = new Array(items.length);
-  let nextIndex = 0;
-  const worker = async () => {
-    while (nextIndex < items.length) {
-      if (shouldStop?.()) return;
-      const index = nextIndex++;
-      results[index] = await run(items[index]);
-    }
-  };
-  await Promise.all(Array.from({ length: Math.min(limit, items.length) }, () => worker()));
-  return results;
-}
-async function executeSingle(call, ctx, governedExecute) {
-  const start = Date.now();
-  if (call.tool === batchToolUseTool.name) {
-    return {
-      tool: call.tool,
-      success: false,
-      error: "recursive batch_tool_use execution is not allowed",
-      executionMs: Date.now() - start
-    };
-  }
-  const tool = (ctx.catalogTools ?? ctx.tools).find(
-    (candidate) => candidate.name === call.tool
-  );
-  if (!tool) {
-    return {
-      tool: call.tool,
-      success: false,
-      error: `tool "${call.tool}" not found`,
-      executionMs: Date.now() - start
-    };
-  }
-  if (!BATCHABLE_TOOLS.has(tool.name) || tool.mutating) {
-    return {
-      tool: call.tool,
-      success: false,
-      error: `tool "${call.tool}" is not eligible for batch execution; call it directly. Allowed: ${BATCHABLE_TOOL_NAMES.join(", ")}`,
-      executionMs: Date.now() - start
-    };
-  }
-  try {
-    const result = await governedExecute(call.tool, call.input);
-    return {
-      tool: call.tool,
-      success: result.success,
-      ...result.success ? { result: result.result } : { error: result.error ?? "nested tool failed" },
-      executionMs: Date.now() - start
-    };
-  } catch (e) {
-    return {
-      tool: call.tool,
-      success: false,
-      error: e instanceof Error ? e.message : String(e),
-      executionMs: Date.now() - start
-    };
-  }
-}
-
-export {
-  batchToolUseTool
-};
-//# sourceMappingURL=chunk-VBF2YXUW.js.map

package/dist/document.d.ts

@@ -1,25 +0,0 @@
-import type { Tool } from '@wrongstack/core/types';
-export interface DocumentInput {
-    target: 'file' | 'function' | 'class' | 'type' | 'all';
-    path?: string | undefined;
-    files?: string | string[] | undefined;
-    style?: 'jsdoc' | 'tsdoc' | 'block' | undefined;
-    overwrite?: boolean | undefined;
-    cwd?: string | undefined;
-}
-export interface DocumentedItem {
-    path: string;
-    name: string;
-    signature: string;
-    docstring: string;
-    status: 'documented' | 'skipped' | 'error';
-    error?: string | undefined;
-}
-export interface DocumentOutput {
-    files_processed: number;
-    items_documented: number;
-    results: DocumentedItem[];
-    style: string;
-}
-export declare const documentTool: Tool<DocumentInput, DocumentOutput>;
-//# sourceMappingURL=document.d.ts.map

package/dist/document.js

@@ -1,8 +0,0 @@
-import {
-  documentTool
-} from "./chunk-CHEK3ASV.js";
-import "./chunk-ZUFHAHTE.js";
-export {
-  documentTool
-};
-//# sourceMappingURL=document.js.map

package/dist/scaffold.d.ts

@@ -1,23 +0,0 @@
-import type { Tool } from '@wrongstack/core/types';
-export interface ScaffoldInput {
-    template: string;
-    name: string;
-    cwd?: string | undefined;
-    vars?: Record<string, string>;
-    dry_run?: boolean | undefined;
-}
-export interface ScaffoldOutput {
-    template: string;
-    name: string;
-    files_created: number;
-    files: string[];
-    dry_run: boolean;
-    output: string;
-}
-export interface ScaffoldTemplate {
-    description: string;
-    files: Record<string, string>;
-}
-export declare const BUILT_IN_TEMPLATES: Record<string, ScaffoldTemplate>;
-export declare const scaffoldTool: Tool<ScaffoldInput, ScaffoldOutput>;
-//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.js

@@ -1,10 +0,0 @@
-import {
-  BUILT_IN_TEMPLATES,
-  scaffoldTool
-} from "./chunk-KLJZ4WV4.js";
-import "./chunk-ZUFHAHTE.js";
-export {
-  BUILT_IN_TEMPLATES,
-  scaffoldTool
-};
-//# sourceMappingURL=scaffold.js.map

package/dist/set-working-dir.d.ts

@@ -1,17 +0,0 @@
-import type { Tool } from '@wrongstack/core/types';
-export interface SetWorkingDirInput {
-    /** Relative or absolute path to navigate to. Must stay within projectRoot. */
-    path?: string | undefined;
-}
-export interface SetWorkingDirOutput {
-    /** The new working directory (absolute path). */
-    current: string;
-    /** The previous working directory (absolute path). */
-    previous?: string | undefined;
-    /** Human-readable confirmation message. */
-    message?: string | undefined;
-    /** Error if the directory doesn't exist or is outside the project root. */
-    error?: string | undefined;
-}
-export declare const setWorkingDirTool: Tool<SetWorkingDirInput, SetWorkingDirOutput>;
-//# sourceMappingURL=set-working-dir.d.ts.map

package/dist/tool-help.d.ts

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

package/dist/tool-help.js

@@ -1,7 +0,0 @@
-import {
-  toolHelpTool
-} from "./chunk-7ODZTPCU.js";
-export {
-  toolHelpTool
-};
-//# sourceMappingURL=tool-help.js.map