@yuaone/tools 0.1.0

package/dist/__tests__/file-edit.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @yuaone/tools — FileEditTool unit tests
+ *
+ * Tests file editing: replacement, ambiguity, replace_all,
+ * deletion, whitespace sensitivity, large files, fuzzy suggestions.
+ */
+export {};
+//# sourceMappingURL=file-edit.test.d.ts.map

package/dist/__tests__/file-edit.test.d.ts.map

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

package/dist/__tests__/file-edit.test.js

@@ -0,0 +1,125 @@
+/**
+ * @yuaone/tools — FileEditTool unit tests
+ *
+ * Tests file editing: replacement, ambiguity, replace_all,
+ * deletion, whitespace sensitivity, large files, fuzzy suggestions.
+ */
+import { describe, it, beforeEach, afterEach } from 'node:test';
+import assert from 'node:assert/strict';
+import { join } from 'node:path';
+import { mkdtempSync, writeFileSync, readFileSync, mkdirSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { FileEditTool } from '../file-edit.js';
+let tool;
+let tmpDir;
+function setup() {
+    tool = new FileEditTool();
+    tmpDir = mkdtempSync(join(tmpdir(), 'yuan-edit-test-'));
+}
+function teardown() {
+    rmSync(tmpDir, { recursive: true, force: true });
+}
+// Helper to write a temp file and return its relative path
+function writeTempFile(name, content) {
+    const absPath = join(tmpDir, name);
+    const dir = absPath.substring(0, absPath.lastIndexOf('/'));
+    if (dir !== tmpDir) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(absPath, content, 'utf-8');
+    return name;
+}
+function readTempFile(name) {
+    return readFileSync(join(tmpDir, name), 'utf-8');
+}
+describe('FileEditTool', () => {
+    beforeEach(() => setup());
+    afterEach(() => teardown());
+    it('should have correct name and risk level', () => {
+        assert.equal(tool.name, 'file_edit');
+        assert.equal(tool.riskLevel, 'medium');
+    });
+    // 1. Simple replacement
+    it('should perform simple replacement when exact match found', async () => {
+        const file = writeTempFile('app.ts', 'const x = 1;\nconst y = 2;\n');
+        const result = await tool.execute({ path: file, old_string: 'const x = 1;', new_string: 'const x = 42;', _toolCallId: 't1' }, tmpDir);
+        assert.equal(result.success, true);
+        assert.ok(result.output.includes('1 replacement'));
+        assert.equal(readTempFile(file), 'const x = 42;\nconst y = 2;\n');
+    });
+    // 2. No match → error with suggestion
+    it('should return error when old_string not found', async () => {
+        const file = writeTempFile('app.ts', 'const x = 1;\n');
+        const result = await tool.execute({ path: file, old_string: 'const z = 99;', new_string: 'replaced', _toolCallId: 't2' }, tmpDir);
+        assert.equal(result.success, false);
+        assert.ok(result.output.includes('not found'));
+    });
+    // 3. Multiple matches without replace_all → error (ambiguous)
+    it('should return error when old_string matches multiple times without replace_all', async () => {
+        const file = writeTempFile('app.ts', 'foo\nbar\nfoo\nbaz\n');
+        const result = await tool.execute({ path: file, old_string: 'foo', new_string: 'qux', _toolCallId: 't3' }, tmpDir);
+        assert.equal(result.success, false);
+        assert.ok(result.output.includes('matches 2 times'));
+    });
+    // 4. replace_all: multiple matches → all replaced
+    it('should replace all occurrences when replace_all=true', async () => {
+        const file = writeTempFile('app.ts', 'foo\nbar\nfoo\nbaz\n');
+        const result = await tool.execute({ path: file, old_string: 'foo', new_string: 'qux', replace_all: true, _toolCallId: 't4' }, tmpDir);
+        assert.equal(result.success, true);
+        assert.ok(result.output.includes('2 replacement'));
+        assert.equal(readTempFile(file), 'qux\nbar\nqux\nbaz\n');
+    });
+    // 5. Empty new_string → deletion
+    it('should delete when new_string is empty', async () => {
+        const file = writeTempFile('app.ts', 'keep\ndelete-me\nkeep\n');
+        const result = await tool.execute({ path: file, old_string: 'delete-me\n', new_string: '', _toolCallId: 't5' }, tmpDir);
+        assert.equal(result.success, true);
+        assert.equal(readTempFile(file), 'keep\nkeep\n');
+    });
+    // 6. Whitespace sensitivity: exact whitespace match required
+    it('should require exact whitespace match', async () => {
+        const file = writeTempFile('app.ts', '  const x = 1;\n');
+        // Missing leading spaces → should not match
+        const result = await tool.execute({ path: file, old_string: 'const x = 1;', new_string: 'const x = 2;', _toolCallId: 't6' }, tmpDir);
+        // It should find it (substring match), but the replacement is exact
+        // Actually 'const x = 1;' IS found as substring of '  const x = 1;'
+        assert.equal(result.success, true);
+        // The leading spaces should be preserved since only the matching portion is replaced
+        assert.equal(readTempFile(file), '  const x = 2;\n');
+    });
+    // 7. Large file: handle 10K+ lines
+    it('should handle large files with 10K+ lines', async () => {
+        const lines = [];
+        for (let i = 0; i < 12000; i++) {
+            lines.push(`line ${i}: content here`);
+        }
+        // Put a unique string at line 6000
+        lines[6000] = 'UNIQUE_MARKER_HERE';
+        const file = writeTempFile('large.ts', lines.join('\n'));
+        const result = await tool.execute({ path: file, old_string: 'UNIQUE_MARKER_HERE', new_string: 'REPLACED_MARKER', _toolCallId: 't7' }, tmpDir);
+        assert.equal(result.success, true);
+        const content = readTempFile(file);
+        assert.ok(content.includes('REPLACED_MARKER'));
+        assert.ok(!content.includes('UNIQUE_MARKER_HERE'));
+    });
+    // 8. Missing path parameter
+    it('should fail when path is missing', async () => {
+        const result = await tool.execute({ old_string: 'x', new_string: 'y', _toolCallId: 't8' }, tmpDir);
+        assert.equal(result.success, false);
+        assert.ok(result.output.includes('Missing'));
+    });
+    // 9. File not found
+    it('should fail when file does not exist', async () => {
+        const result = await tool.execute({ path: 'nonexistent.ts', old_string: 'x', new_string: 'y', _toolCallId: 't9' }, tmpDir);
+        assert.equal(result.success, false);
+        assert.ok(result.output.includes('not found'));
+    });
+    // 10. Sensitive file blocked
+    it('should block editing sensitive files', async () => {
+        writeTempFile('.env', 'SECRET=value');
+        const result = await tool.execute({ path: '.env', old_string: 'SECRET=value', new_string: 'SECRET=new', _toolCallId: 't10' }, tmpDir);
+        assert.equal(result.success, false);
+        assert.ok(result.output.includes('Sensitive'));
+    });
+});
+//# sourceMappingURL=file-edit.test.js.map

package/dist/__tests__/file-edit.test.js.map

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

package/dist/__tests__/registry.test.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @yuaone/tools — ToolRegistry unit tests
+ *
+ * Tests registry: default tools, get/has, definitions, executor.
+ */
+export {};
+//# sourceMappingURL=registry.test.d.ts.map

package/dist/__tests__/registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/registry.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/__tests__/registry.test.js

@@ -0,0 +1,83 @@
+/**
+ * @yuaone/tools — ToolRegistry unit tests
+ *
+ * Tests registry: default tools, get/has, definitions, executor.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { ToolRegistry, createDefaultRegistry } from '../tool-registry.js';
+import { FileReadTool } from '../file-read.js';
+const EXPECTED_TOOL_NAMES = [
+    'file_read',
+    'file_write',
+    'file_edit',
+    'shell_exec',
+    'grep',
+    'glob',
+    'git_ops',
+    'test_run',
+    'code_search',
+    'security_scan',
+];
+describe('ToolRegistry', () => {
+    // 1. Default registry has 9 tools registered
+    it('should create default registry with 10 tools', () => {
+        const registry = createDefaultRegistry();
+        assert.equal(registry.size, 10);
+    });
+    // 2. All expected tool names present
+    it('should contain all expected tool names', () => {
+        const registry = createDefaultRegistry();
+        const names = registry.listNames();
+        for (const name of EXPECTED_TOOL_NAMES) {
+            assert.ok(names.includes(name), `Missing tool: ${name}`);
+        }
+    });
+    // 3. Get tool returns correct tool by name
+    it('should return correct tool by name', () => {
+        const registry = createDefaultRegistry();
+        const tool = registry.get('file_read');
+        assert.ok(tool !== undefined);
+        assert.equal(tool.name, 'file_read');
+    });
+    // 4. Unknown tool returns undefined
+    it('should return undefined for unknown tool', () => {
+        const registry = createDefaultRegistry();
+        const tool = registry.get('nonexistent_tool');
+        assert.equal(tool, undefined);
+    });
+    // 5. Each tool has valid input_schema (parameters with type: 'object')
+    it('should generate valid definitions for each tool', () => {
+        const registry = createDefaultRegistry();
+        const definitions = registry.toDefinitions();
+        assert.equal(definitions.length, 10);
+        for (const def of definitions) {
+            assert.ok(typeof def.name === 'string' && def.name.length > 0);
+            assert.ok(typeof def.description === 'string' && def.description.length > 0);
+            assert.ok(def.parameters !== undefined);
+            assert.equal(def.parameters.type, 'object');
+            assert.ok(def.parameters.properties !== undefined);
+        }
+    });
+    // 6. toExecutor returns a function-based executor
+    it('should create executor with definitions and execute function', () => {
+        const registry = createDefaultRegistry();
+        const executor = registry.toExecutor('/tmp/test');
+        assert.ok(executor.definitions.length === 10);
+        assert.ok(typeof executor.execute === 'function');
+    });
+    // 7. Duplicate registration throws
+    it('should throw on duplicate tool registration', () => {
+        const registry = new ToolRegistry();
+        registry.register(new FileReadTool());
+        assert.throws(() => registry.register(new FileReadTool()), /already registered/);
+    });
+    // 8. Execute unknown tool returns error result
+    it('should return error result for unknown tool execution', async () => {
+        const registry = createDefaultRegistry();
+        const result = await registry.execute('nonexistent', { _toolCallId: 'x' }, '/tmp');
+        assert.equal(result.success, false);
+        assert.ok(result.output.includes('Unknown tool'));
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/dist/__tests__/registry.test.js.map

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

package/dist/__tests__/validators.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @yuaone/tools — Validator unit tests
+ *
+ * Tests security validators: command blocking, path traversal,
+ * shell metacharacters, sensitive file detection, binary detection.
+ */
+export {};
+//# sourceMappingURL=validators.test.d.ts.map

package/dist/__tests__/validators.test.d.ts.map

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

package/dist/__tests__/validators.test.js

@@ -0,0 +1,189 @@
+/**
+ * @yuaone/tools — Validator unit tests
+ *
+ * Tests security validators: command blocking, path traversal,
+ * shell metacharacters, sensitive file detection, binary detection.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { join } from 'node:path';
+import { mkdtempSync, writeFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { validatePath, validateNoShellMeta, validateCommand, isSensitiveFile, isBinaryFile, isImageFile, truncateOutput, detectLanguage, } from '../validators.js';
+// ─── Path Traversal Defence ─────────────────────────────────────────
+describe('validatePath', () => {
+    const workDir = '/home/user/project';
+    it('should resolve a valid relative path', () => {
+        const result = validatePath('src/app.ts', workDir);
+        assert.equal(result, join(workDir, 'src/app.ts'));
+    });
+    it('should throw on path traversal via ../../../etc/passwd', () => {
+        assert.throws(() => validatePath('../../../etc/passwd', workDir), /Path traversal detected/);
+    });
+    it('should throw on path traversal via ../', () => {
+        assert.throws(() => validatePath('../../outside', workDir), /Path traversal detected/);
+    });
+    it('should throw on null byte in path', () => {
+        assert.throws(() => validatePath('src/app\0.ts', workDir), /null byte/);
+    });
+    it('should allow nested valid paths', () => {
+        const result = validatePath('src/deep/nested/file.ts', workDir);
+        assert.equal(result, join(workDir, 'src/deep/nested/file.ts'));
+    });
+});
+// ─── Shell Metacharacter Defence ────────────────────────────────────
+describe('validateNoShellMeta', () => {
+    it('should pass for clean executable and args', () => {
+        assert.doesNotThrow(() => validateNoShellMeta('node', ['index.js']));
+    });
+    it('should throw on semicolon in arg', () => {
+        assert.throws(() => validateNoShellMeta('ls', ['; rm -rf /']), /Shell metacharacter in arg/);
+    });
+    it('should throw on pipe in executable', () => {
+        assert.throws(() => validateNoShellMeta('ls | cat', []), /Shell metacharacter in executable/);
+    });
+    it('should throw on backtick in arg', () => {
+        assert.throws(() => validateNoShellMeta('echo', ['`whoami`']), /Shell metacharacter in arg/);
+    });
+    it('should throw on && in arg', () => {
+        assert.throws(() => validateNoShellMeta('echo', ['hello && rm -rf /']), /Shell metacharacter in arg/);
+    });
+    it('should throw on $() in arg', () => {
+        assert.throws(() => validateNoShellMeta('echo', ['$(cat /etc/passwd)']), /Shell metacharacter in arg/);
+    });
+});
+// ─── Command Validation (delegates to @yuaone/core) ───────────────────
+describe('validateCommand', () => {
+    it('should allow safe commands: ls', () => {
+        assert.doesNotThrow(() => validateCommand('ls', ['-la']));
+    });
+    it('should allow safe commands: node', () => {
+        assert.doesNotThrow(() => validateCommand('node', ['index.js']));
+    });
+    it('should allow safe commands: pnpm', () => {
+        assert.doesNotThrow(() => validateCommand('pnpm', ['install']));
+    });
+    it('should allow safe commands: git status', () => {
+        assert.doesNotThrow(() => validateCommand('git', ['status']));
+    });
+    it('should block rm -rf /', () => {
+        assert.throws(() => validateCommand('rm', ['-rf', '/']), /blocked|Destructive/i);
+    });
+    it('should block interactive commands: vim', () => {
+        assert.throws(() => validateCommand('vim', ['file.txt']), /blocked|Interactive|TTY/i);
+    });
+    it('should block interactive commands: nano', () => {
+        assert.throws(() => validateCommand('nano', ['file.txt']), /blocked|Interactive|TTY/i);
+    });
+    it('should block sudo', () => {
+        assert.throws(() => validateCommand('sudo', ['ls']), /blocked|Blocked/i);
+    });
+    it('should block su', () => {
+        assert.throws(() => validateCommand('su', ['-']), /blocked|Blocked/i);
+    });
+});
+// ─── Sensitive File Detection ───────────────────────────────────────
+describe('isSensitiveFile', () => {
+    it('should detect .env as sensitive', () => {
+        assert.equal(isSensitiveFile('.env'), true);
+    });
+    it('should detect .env.local as sensitive', () => {
+        assert.equal(isSensitiveFile('.env.local'), true);
+    });
+    it('should detect credentials.json as sensitive', () => {
+        assert.equal(isSensitiveFile('credentials.json'), true);
+    });
+    it('should detect .pem files as sensitive', () => {
+        assert.equal(isSensitiveFile('server.pem'), true);
+    });
+    it('should detect id_rsa as sensitive', () => {
+        assert.equal(isSensitiveFile('id_rsa'), true);
+    });
+    it('should NOT detect src/app.ts as sensitive', () => {
+        assert.equal(isSensitiveFile('src/app.ts'), false);
+    });
+    it('should NOT detect package.json as sensitive', () => {
+        assert.equal(isSensitiveFile('package.json'), false);
+    });
+    it('should NOT detect README.md as sensitive', () => {
+        assert.equal(isSensitiveFile('README.md'), false);
+    });
+});
+// ─── Binary File Detection ──────────────────────────────────────────
+describe('isBinaryFile', () => {
+    let tmpDir;
+    it('should detect .png as binary (image)', async () => {
+        const result = await isBinaryFile('image.png');
+        assert.equal(result, true);
+    });
+    it('should detect .jpg as binary (image)', async () => {
+        const result = await isBinaryFile('photo.jpg');
+        assert.equal(result, true);
+    });
+    it('should detect .ts as text (by extension)', async () => {
+        const result = await isBinaryFile('src/app.ts');
+        assert.equal(result, false);
+    });
+    it('should detect .json as text (by extension)', async () => {
+        const result = await isBinaryFile('config.json');
+        assert.equal(result, false);
+    });
+    it('should sniff binary content via null bytes', async () => {
+        tmpDir = mkdtempSync(join(tmpdir(), 'yuan-test-'));
+        const binFile = join(tmpDir, 'data.bin');
+        const buf = Buffer.from([0x48, 0x65, 0x6c, 0x00, 0x6f]); // "Hel\0o"
+        writeFileSync(binFile, buf);
+        const result = await isBinaryFile(binFile);
+        assert.equal(result, true);
+        rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('should sniff text content without null bytes', async () => {
+        tmpDir = mkdtempSync(join(tmpdir(), 'yuan-test-'));
+        const textFile = join(tmpDir, 'data.unknown');
+        writeFileSync(textFile, 'Hello, this is plain text');
+        const result = await isBinaryFile(textFile);
+        assert.equal(result, false);
+        rmSync(tmpDir, { recursive: true, force: true });
+    });
+});
+// ─── Image File Detection ───────────────────────────────────────────
+describe('isImageFile', () => {
+    it('should detect .png as image', () => {
+        assert.equal(isImageFile('logo.png'), true);
+    });
+    it('should detect .svg as image', () => {
+        assert.equal(isImageFile('icon.svg'), true);
+    });
+    it('should NOT detect .ts as image', () => {
+        assert.equal(isImageFile('src/app.ts'), false);
+    });
+});
+// ─── Output Truncation ─────────────────────────────────────────────
+describe('truncateOutput', () => {
+    it('should not truncate short output', () => {
+        const output = 'Hello, world!';
+        assert.equal(truncateOutput(output), output);
+    });
+    it('should truncate long output with head/tail', () => {
+        const output = 'x'.repeat(100_000);
+        const result = truncateOutput(output, 1000);
+        assert.ok(result.length < output.length);
+        assert.ok(result.includes('truncated'));
+    });
+});
+// ─── Language Detection ─────────────────────────────────────────────
+describe('detectLanguage', () => {
+    it('should detect TypeScript', () => {
+        assert.equal(detectLanguage('src/app.ts'), 'typescript');
+    });
+    it('should detect Python', () => {
+        assert.equal(detectLanguage('main.py'), 'python');
+    });
+    it('should detect Dockerfile', () => {
+        assert.equal(detectLanguage('Dockerfile'), 'dockerfile');
+    });
+    it('should return plaintext for unknown', () => {
+        assert.equal(detectLanguage('file.xyz'), 'plaintext');
+    });
+});
+//# sourceMappingURL=validators.test.js.map

package/dist/__tests__/validators.test.js.map

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

package/dist/base-tool.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @yuaone/tools — BaseTool abstract class
+ *
+ * Every tool inherits from BaseTool which provides:
+ * - Tool definition metadata
+ * - Path validation (path traversal defence)
+ * - Output truncation
+ * - Common execute contract
+ *
+ * ToolResult now uses @yuaone/core's format:
+ *   { tool_call_id, name, output, success, durationMs }
+ */
+import type { ToolResult, ToolDefinition } from '@yuaone/core';
+import type { ParameterDef, RiskLevel } from './types.js';
+export declare abstract class BaseTool {
+    abstract readonly name: string;
+    abstract readonly description: string;
+    abstract readonly parameters: Record<string, ParameterDef>;
+    abstract readonly riskLevel: RiskLevel;
+    /** Tools with riskLevel !== 'low' require user approval by default. */
+    get requiresApproval(): boolean;
+    /**
+     * Execute the tool with the given arguments and workDir.
+     * @param args - Tool arguments
+     * @param workDir - Working directory
+     * @param abortSignal - Optional AbortSignal for interrupt-based cancellation
+     */
+    abstract execute(args: Record<string, unknown>, workDir: string, abortSignal?: AbortSignal): Promise<ToolResult>;
+    /** Validate and resolve a path within workDir. Throws on traversal. */
+    protected validatePath(path: string, workDir: string): string;
+    /** Truncate output to maxBytes. */
+    protected truncateOutput(output: string, maxBytes?: number): string;
+    /**
+     * Convert ParameterDef map to JSON Schema for LLM consumption.
+     * This bridges the tools' ParameterDef format to core's ToolParameterSchema.
+     */
+    private toJsonSchema;
+    /** Generate a ToolDefinition (core-compatible) for LLM consumption. */
+    toDefinition(): ToolDefinition;
+    /** Helper to build a success ToolResult (core-compatible). */
+    protected ok(toolCallId: string, output: string, metadata?: Record<string, unknown>): ToolResult;
+    /** Helper to build a failure ToolResult (core-compatible). */
+    protected fail(toolCallId: string, error: string): ToolResult;
+}
+//# sourceMappingURL=base-tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-tool.d.ts","sourceRoot":"","sources":["../src/base-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAuB,MAAM,cAAc,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG1D,8BAAsB,QAAQ;IAC5B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC3D,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAEvC,uEAAuE;IACvE,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAEhH,uEAAuE;IACvE,SAAS,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAI7D,mCAAmC;IACnC,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAInE;;;OAGG;IACH,OAAO,CAAC,YAAY;IA4BpB,uEAAuE;IACvE,YAAY,IAAI,cAAc;IAQ9B,8DAA8D;IAC9D,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU;IAUhG,8DAA8D;IAC9D,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU;CAS9D"}

package/dist/base-tool.js

@@ -0,0 +1,87 @@
+/**
+ * @yuaone/tools — BaseTool abstract class
+ *
+ * Every tool inherits from BaseTool which provides:
+ * - Tool definition metadata
+ * - Path validation (path traversal defence)
+ * - Output truncation
+ * - Common execute contract
+ *
+ * ToolResult now uses @yuaone/core's format:
+ *   { tool_call_id, name, output, success, durationMs }
+ */
+import { validatePath as _validatePath, truncateOutput as _truncateOutput } from './validators.js';
+export class BaseTool {
+    /** Tools with riskLevel !== 'low' require user approval by default. */
+    get requiresApproval() {
+        return this.riskLevel !== 'low';
+    }
+    /** Validate and resolve a path within workDir. Throws on traversal. */
+    validatePath(path, workDir) {
+        return _validatePath(path, workDir);
+    }
+    /** Truncate output to maxBytes. */
+    truncateOutput(output, maxBytes) {
+        return _truncateOutput(output, maxBytes);
+    }
+    /**
+     * Convert ParameterDef map to JSON Schema for LLM consumption.
+     * This bridges the tools' ParameterDef format to core's ToolParameterSchema.
+     */
+    toJsonSchema() {
+        const properties = {};
+        const required = [];
+        for (const [key, param] of Object.entries(this.parameters)) {
+            const prop = {
+                type: param.type,
+                description: param.description,
+            };
+            if (param.enum)
+                prop.enum = param.enum;
+            if (param.default !== undefined)
+                prop.default = param.default;
+            if (param.items) {
+                prop.items = { type: param.items.type, description: param.items.description };
+            }
+            properties[key] = prop;
+            if (param.required) {
+                required.push(key);
+            }
+        }
+        return {
+            type: 'object',
+            properties,
+            required: required.length > 0 ? required : undefined,
+            additionalProperties: false,
+        };
+    }
+    /** Generate a ToolDefinition (core-compatible) for LLM consumption. */
+    toDefinition() {
+        return {
+            name: this.name,
+            description: this.description,
+            parameters: this.toJsonSchema(),
+        };
+    }
+    /** Helper to build a success ToolResult (core-compatible). */
+    ok(toolCallId, output, metadata) {
+        return {
+            tool_call_id: toolCallId,
+            name: this.name,
+            output: this.truncateOutput(output),
+            success: true,
+            durationMs: 0, // Caller can override via wrapper
+        };
+    }
+    /** Helper to build a failure ToolResult (core-compatible). */
+    fail(toolCallId, error) {
+        return {
+            tool_call_id: toolCallId,
+            name: this.name,
+            output: `Error: ${error}`,
+            success: false,
+            durationMs: 0,
+        };
+    }
+}
+//# sourceMappingURL=base-tool.js.map

package/dist/base-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-tool.js","sourceRoot":"","sources":["../src/base-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,YAAY,IAAI,aAAa,EAAE,cAAc,IAAI,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEnG,MAAM,OAAgB,QAAQ;IAM5B,uEAAuE;IACvE,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC;IAClC,CAAC;IAUD,uEAAuE;IAC7D,YAAY,CAAC,IAAY,EAAE,OAAe;QAClD,OAAO,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,mCAAmC;IACzB,cAAc,CAAC,MAAc,EAAE,QAAiB;QACxD,OAAO,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACK,YAAY;QAClB,MAAM,UAAU,GAA4B,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,GAA4B;gBACpC,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,WAAW,EAAE,KAAK,CAAC,WAAW;aAC/B,CAAC;YACF,IAAI,KAAK,CAAC,IAAI;gBAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YACvC,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;gBAAE,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YAC9D,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,IAAI,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAChF,CAAC;YACD,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACvB,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,UAAU;YACV,QAAQ,EAAE,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YACpD,oBAAoB,EAAE,KAAK;SAC5B,CAAC;IACJ,CAAC;IAED,uEAAuE;IACvE,YAAY;QACV,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,UAAU,EAAE,IAAI,CAAC,YAAY,EAAE;SAChC,CAAC;IACJ,CAAC;IAED,8DAA8D;IACpD,EAAE,CAAC,UAAkB,EAAE,MAAc,EAAE,QAAkC;QACjF,OAAO;YACL,YAAY,EAAE,UAAU;YACxB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;YACnC,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,CAAC,EAAE,kCAAkC;SAClD,CAAC;IACJ,CAAC;IAED,8DAA8D;IACpD,IAAI,CAAC,UAAkB,EAAE,KAAa;QAC9C,OAAO;YACL,YAAY,EAAE,UAAU;YACxB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,UAAU,KAAK,EAAE;YACzB,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,CAAC;SACd,CAAC;IACJ,CAAC;CACF"}