@yuaone/tools 0.1.0

package/dist/tool-registry.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @yuaone/tools — Tool Registry
+ *
+ * Central registry for all YUAN agent tools.
+ * - Register/retrieve tools by name
+ * - Generate LLM-ready tool definitions
+ * - Execute tools by name
+ * - toExecutor() bridges to @yuaone/core's ToolExecutor interface
+ */
+import type { ToolDefinition, ToolResult, ToolExecutor } from '@yuaone/core';
+import type { BaseTool } from './base-tool.js';
+export declare class ToolRegistry {
+    private tools;
+    /** Register a tool instance. */
+    register(tool: BaseTool): void;
+    /** Register multiple tools at once. */
+    registerAll(tools: BaseTool[]): void;
+    /** Get a tool by name. */
+    get(name: string): BaseTool | undefined;
+    /** Check if a tool is registered. */
+    has(name: string): boolean;
+    /** List all registered tool names. */
+    listNames(): string[];
+    /** Generate tool definitions for LLM consumption (core-compatible JSON Schema). */
+    toDefinitions(): ToolDefinition[];
+    /**
+     * Execute a tool by name (internal use).
+     * @param name - Tool name
+     * @param args - Tool arguments (must include _toolCallId)
+     * @param workDir - Project working directory
+     */
+    execute(name: string, args: Record<string, unknown>, workDir: string): Promise<ToolResult>;
+    /**
+     * Execute a tool by name, passing an optional AbortSignal for interrupt support.
+     * @param name - Tool name
+     * @param args - Tool arguments
+     * @param workDir - Project working directory
+     * @param abortSignal - Optional AbortSignal for cancellation
+     */
+    executeWithSignal(name: string, args: Record<string, unknown>, workDir: string, abortSignal?: AbortSignal): Promise<ToolResult>;
+    /**
+     * Create a ToolExecutor adapter that implements @yuaone/core's ToolExecutor interface.
+     *
+     * The adapter:
+     * - Provides tool definitions in JSON Schema format
+     * - Parses ToolCall.arguments (string → object if needed)
+     * - Injects _toolCallId into args
+     * - Measures execution duration
+     * - Returns core-compatible ToolResult
+     *
+     * @param workDir - Project working directory for tool execution
+     */
+    toExecutor(workDir: string): ToolExecutor;
+    /** Get the number of registered tools. */
+    get size(): number;
+}
+/**
+ * Create a ToolRegistry pre-loaded with all built-in YUAN tools.
+ */
+export declare function createDefaultRegistry(): ToolRegistry;
+/**
+ * Create a ToolRegistry with all standard tools + design mode tools.
+ *
+ * Design tools (snapshot, screenshot, navigate, resize, inspect, scroll)
+ * are loaded via dynamic import to avoid circular dependencies.
+ *
+ * @param workDir - Project working directory (reserved for future use)
+ */
+export declare function createDesignRegistry(workDir: string): Promise<ToolRegistry>;
+//# sourceMappingURL=tool-registry.d.ts.map

package/dist/tool-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.d.ts","sourceRoot":"","sources":["../src/tool-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAY,YAAY,EAAE,MAAM,cAAc,CAAC;AACvF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAA+B;IAE5C,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAO9B,uCAAuC;IACvC,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI;IAMpC,0BAA0B;IAC1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIvC,qCAAqC;IACrC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,sCAAsC;IACtC,SAAS,IAAI,MAAM,EAAE;IAIrB,mFAAmF;IACnF,aAAa,IAAI,cAAc,EAAE;IAIjC;;;;;OAKG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,CAAC;IAetB;;;;;;OAMG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,WAAW,GACxB,OAAO,CAAC,UAAU,CAAC;IAetB;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY;IA0CzC,0CAA0C;IAC1C,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAeD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,YAAY,CAepD;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAOjF"}

package/dist/tool-registry.js

@@ -0,0 +1,181 @@
+/**
+ * @yuaone/tools — Tool Registry
+ *
+ * Central registry for all YUAN agent tools.
+ * - Register/retrieve tools by name
+ * - Generate LLM-ready tool definitions
+ * - Execute tools by name
+ * - toExecutor() bridges to @yuaone/core's ToolExecutor interface
+ */
+export class ToolRegistry {
+    tools = new Map();
+    /** Register a tool instance. */
+    register(tool) {
+        if (this.tools.has(tool.name)) {
+            throw new Error(`Tool already registered: ${tool.name}`);
+        }
+        this.tools.set(tool.name, tool);
+    }
+    /** Register multiple tools at once. */
+    registerAll(tools) {
+        for (const tool of tools) {
+            this.register(tool);
+        }
+    }
+    /** Get a tool by name. */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /** Check if a tool is registered. */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /** List all registered tool names. */
+    listNames() {
+        return [...this.tools.keys()];
+    }
+    /** Generate tool definitions for LLM consumption (core-compatible JSON Schema). */
+    toDefinitions() {
+        return [...this.tools.values()].map((t) => t.toDefinition());
+    }
+    /**
+     * Execute a tool by name (internal use).
+     * @param name - Tool name
+     * @param args - Tool arguments (must include _toolCallId)
+     * @param workDir - Project working directory
+     */
+    async execute(name, args, workDir) {
+        const tool = this.tools.get(name);
+        if (!tool) {
+            return {
+                tool_call_id: args._toolCallId ?? '',
+                name,
+                success: false,
+                output: `Error: Unknown tool: ${name}. Available tools: ${this.listNames().join(', ')}`,
+                durationMs: 0,
+            };
+        }
+        return tool.execute(args, workDir);
+    }
+    /**
+     * Execute a tool by name, passing an optional AbortSignal for interrupt support.
+     * @param name - Tool name
+     * @param args - Tool arguments
+     * @param workDir - Project working directory
+     * @param abortSignal - Optional AbortSignal for cancellation
+     */
+    async executeWithSignal(name, args, workDir, abortSignal) {
+        const tool = this.tools.get(name);
+        if (!tool) {
+            return {
+                tool_call_id: args._toolCallId ?? '',
+                name,
+                success: false,
+                output: `Error: Unknown tool: ${name}. Available tools: ${this.listNames().join(', ')}`,
+                durationMs: 0,
+            };
+        }
+        return tool.execute(args, workDir, abortSignal);
+    }
+    /**
+     * Create a ToolExecutor adapter that implements @yuaone/core's ToolExecutor interface.
+     *
+     * The adapter:
+     * - Provides tool definitions in JSON Schema format
+     * - Parses ToolCall.arguments (string → object if needed)
+     * - Injects _toolCallId into args
+     * - Measures execution duration
+     * - Returns core-compatible ToolResult
+     *
+     * @param workDir - Project working directory for tool execution
+     */
+    toExecutor(workDir) {
+        const registry = this;
+        const definitions = this.toDefinitions();
+        return {
+            definitions,
+            async execute(call, abortSignal) {
+                // Parse arguments: core ToolCall.arguments can be string or object
+                let args;
+                if (typeof call.arguments === 'string') {
+                    try {
+                        args = JSON.parse(call.arguments);
+                    }
+                    catch {
+                        return {
+                            tool_call_id: call.id,
+                            name: call.name,
+                            output: `Error: Failed to parse tool arguments as JSON: ${call.arguments}`,
+                            success: false,
+                            durationMs: 0,
+                        };
+                    }
+                }
+                else {
+                    args = { ...call.arguments };
+                }
+                // Inject toolCallId for BaseTool.execute
+                args._toolCallId = call.id;
+                const startTime = Date.now();
+                const result = await registry.executeWithSignal(call.name, args, workDir, abortSignal);
+                const durationMs = Date.now() - startTime;
+                // Ensure result has correct durationMs
+                return {
+                    ...result,
+                    durationMs,
+                };
+            },
+        };
+    }
+    /** Get the number of registered tools. */
+    get size() {
+        return this.tools.size;
+    }
+}
+// ─── Factory: create a registry with all built-in tools ──────────────
+import { FileReadTool } from './file-read.js';
+import { FileWriteTool } from './file-write.js';
+import { FileEditTool } from './file-edit.js';
+import { ShellExecTool } from './shell-exec.js';
+import { GrepTool } from './grep.js';
+import { GlobTool } from './glob.js';
+import { GitOpsTool } from './git-ops.js';
+import { TestRunTool } from './test-run.js';
+import { CodeSearchTool } from './code-search.js';
+import { SecurityScanTool } from './security-scan.js';
+/**
+ * Create a ToolRegistry pre-loaded with all built-in YUAN tools.
+ */
+export function createDefaultRegistry() {
+    const registry = new ToolRegistry();
+    registry.registerAll([
+        new FileReadTool(),
+        new FileWriteTool(),
+        new FileEditTool(),
+        new ShellExecTool(),
+        new GrepTool(),
+        new GlobTool(),
+        new GitOpsTool(),
+        new TestRunTool(),
+        new CodeSearchTool(),
+        new SecurityScanTool(),
+    ]);
+    return registry;
+}
+/**
+ * Create a ToolRegistry with all standard tools + design mode tools.
+ *
+ * Design tools (snapshot, screenshot, navigate, resize, inspect, scroll)
+ * are loaded via dynamic import to avoid circular dependencies.
+ *
+ * @param workDir - Project working directory (reserved for future use)
+ */
+export async function createDesignRegistry(workDir) {
+    const registry = createDefaultRegistry();
+    const { createDesignTools } = await import('./design-tools.js');
+    for (const tool of createDesignTools()) {
+        registry.register(tool);
+    }
+    return registry;
+}
+//# sourceMappingURL=tool-registry.js.map

package/dist/tool-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-registry.js","sourceRoot":"","sources":["../src/tool-registry.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,137 @@
+/**
+ * @yuaone/tools — Type definitions
+ *
+ * Core types (ToolDefinition, ToolCall, ToolResult, etc.) are re-exported from @yuaone/core.
+ * Tool-specific I/O types remain here.
+ */
+export type { ToolDefinition, ToolCall, ToolResult, ToolParameterSchema, } from '@yuaone/core';
+export interface ParameterDef {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    description: string;
+    required?: boolean;
+    default?: unknown;
+    enum?: string[];
+    items?: ParameterDef;
+}
+export type RiskLevel = 'low' | 'medium' | 'high' | 'critical';
+export interface FileReadInput {
+    path: string;
+    offset?: number;
+    limit?: number;
+}
+export interface FileReadOutput {
+    content: string;
+    totalLines: number;
+    language: string;
+    truncated: boolean;
+}
+export interface FileWriteInput {
+    path: string;
+    content: string;
+    createDirectories?: boolean;
+}
+export interface FileWriteOutput {
+    bytesWritten: number;
+    created: boolean;
+}
+export interface FileEditInput {
+    path: string;
+    old_string: string;
+    new_string: string;
+    replace_all?: boolean;
+}
+export interface FileEditOutput {
+    replacements: number;
+    preview: string;
+}
+export interface ShellExecInput {
+    executable: string;
+    args: string[];
+    cwd?: string;
+    timeout?: number;
+    env?: Record<string, string>;
+}
+export interface ShellExecOutput {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+    durationMs: number;
+}
+export interface GrepInput {
+    pattern: string;
+    path?: string;
+    glob?: string;
+    maxResults?: number;
+    context?: number;
+}
+export interface GrepMatch {
+    file: string;
+    line: number;
+    content: string;
+    contextBefore?: string[];
+    contextAfter?: string[];
+}
+export interface GrepOutput {
+    matches: GrepMatch[];
+    totalMatches: number;
+    truncated: boolean;
+}
+export interface GlobInput {
+    pattern: string;
+    path?: string;
+    maxResults?: number;
+}
+export interface GlobOutput {
+    files: string[];
+    totalMatches: number;
+    truncated: boolean;
+}
+export type GitOperation = 'status' | 'diff' | 'log' | 'add' | 'commit' | 'create_branch' | 'stash' | 'restore';
+export interface GitOpsInput {
+    operation: GitOperation;
+    message?: string;
+    files?: string[];
+    count?: number;
+    branch?: string;
+}
+export interface GitOpsOutput {
+    result: string;
+    success: boolean;
+}
+export interface TestRunInput {
+    testPath?: string;
+    framework?: 'jest' | 'vitest' | 'pytest' | 'auto';
+    coverage?: boolean;
+}
+export interface TestRunOutput {
+    passed: number;
+    failed: number;
+    skipped: number;
+    coverage?: number;
+    failedTests: Array<{
+        name: string;
+        error: string;
+    }>;
+    stdout: string;
+}
+export type CodeSearchMode = 'symbol' | 'reference' | 'definition';
+export interface CodeSearchInput {
+    query: string;
+    mode?: CodeSearchMode;
+    path?: string;
+    language?: string;
+    maxResults?: number;
+}
+export interface CodeSearchResult {
+    file: string;
+    line: number;
+    column: number;
+    content: string;
+    kind: string;
+}
+export interface CodeSearchOutput {
+    results: CodeSearchResult[];
+    totalCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * @yuaone/tools — Type definitions
+ *
+ * Core types (ToolDefinition, ToolCall, ToolResult, etc.) are re-exported from @yuaone/core.
+ * Tool-specific I/O types remain here.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/validators.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @yuaone/tools — Common validation utilities
+ *
+ * Security-first validators for path traversal, shell injection,
+ * sensitive file detection, binary detection, and output truncation.
+ *
+ * Security rules SSOT: @yuaone/core/security.ts
+ * This module delegates to the SSOT and provides tool-specific wrappers.
+ */
+/**
+ * Resolve a path and verify that it (and its symlink target) stays within the
+ * allowed project directory. Defends against symlink-based path traversal.
+ *
+ * @returns `{ valid, resolved, reason? }` — `resolved` is the real path if valid.
+ */
+export declare function resolveAndValidatePath(filePath: string, projectRoot: string): {
+    valid: boolean;
+    resolved: string;
+    reason?: string;
+};
+/**
+ * Resolve and validate a path to ensure it stays within workDir.
+ * Returns the resolved absolute path.
+ * Throws on path traversal attempts (including symlink-based).
+ */
+export declare function validatePath(inputPath: string, workDir: string): string;
+/**
+ * Validate that neither executable nor args contain shell metacharacters.
+ * Prevents shell injection when using execFile.
+ * Delegates to SHELL_META_PATTERN from @yuaone/core/security (SSOT).
+ */
+export declare function validateNoShellMeta(executable: string, args: string[]): void;
+/**
+ * Check whether an executable + args combination is blocked.
+ * Throws with explanation if blocked.
+ * Delegates to @yuaone/core/security.validateCommand (SSOT).
+ */
+export declare function validateCommand(executable: string, args: string[]): void;
+/**
+ * Check whether a file path matches known sensitive file patterns.
+ * Delegates to @yuaone/core/security.isSensitiveFile (SSOT).
+ */
+export declare function isSensitiveFile(filePath: string): boolean;
+/**
+ * Check whether a file is likely binary by extension and (optionally) content sniffing.
+ */
+export declare function isBinaryFile(filePath: string): Promise<boolean>;
+/**
+ * Check whether a file is an image.
+ */
+export declare function isImageFile(filePath: string): boolean;
+/**
+ * Truncate output to maxBytes. Uses head/tail strategy.
+ */
+export declare function truncateOutput(output: string, maxBytes?: number): string;
+export declare function detectLanguage(filePath: string): string;
+//# sourceMappingURL=validators.d.ts.map

package/dist/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAyCvD;AAID;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAyBvE;AAID;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAS5E;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAKxE;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAwBD;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAuBrE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGrD;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAA0B,GAAG,MAAM,CAY3F;AAqBD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQvD"}