@xopcai/xopcbot 0.1.0

package/dist/agent/tools/find.js

@@ -0,0 +1,99 @@
+import { Type } from '@sinclair/typebox';
+import { existsSync } from 'fs';
+import { globSync } from 'glob';
+import path from 'path';
+import { DEFAULT_MAX_BYTES, formatSize, truncateHead } from './truncate.js';
+import { resolveToCwd } from './path-utils.js';
+const findSchema = Type.Object({
+    pattern: Type.String({
+        description: "Glob pattern to match files, e.g. '*.ts', '**/*.json', or 'src/**/*.spec.ts'",
+    }),
+    path: Type.Optional(Type.String({ description: 'Directory to search in (default: current directory)' })),
+    limit: Type.Optional(Type.Number({ description: 'Maximum number of results (default: 1000)' })),
+});
+const DEFAULT_LIMIT = 1000;
+/**
+ * Find tool - Search for files by glob pattern
+ */
+export function createFindTool(cwd) {
+    return {
+        name: 'find',
+        label: '📁 find',
+        description: 'Find files by glob pattern (e.g., *.ts, **/*.json).',
+        parameters: findSchema,
+        execute: async (_toolCallId, params, signal) => {
+            try {
+                const searchPath = resolveToCwd(params.path || '.', cwd);
+                const effectiveLimit = params.limit || DEFAULT_LIMIT;
+                if (!existsSync(searchPath)) {
+                    return {
+                        content: [{ type: 'text', text: `Error: Path not found: ${searchPath}` }],
+                        details: {},
+                    };
+                }
+                if (signal?.aborted) {
+                    return {
+                        content: [{ type: 'text', text: 'Operation aborted' }],
+                        details: {},
+                    };
+                }
+                const filePaths = globSync(params.pattern, {
+                    cwd: searchPath,
+                    dot: true,
+                    ignore: ['**/node_modules/**', '**/.git/**'],
+                });
+                if (filePaths.length === 0) {
+                    return {
+                        content: [{ type: 'text', text: 'No files found matching pattern' }],
+                        details: {},
+                    };
+                }
+                // Relativize paths
+                const relativized = filePaths.map((p) => {
+                    if (p.startsWith(searchPath)) {
+                        return p.slice(searchPath.length + 1);
+                    }
+                    return path.relative(searchPath, p);
+                });
+                // Sort results
+                relativized.sort();
+                const resultLimitReached = relativized.length >= effectiveLimit;
+                const outputLines = resultLimitReached ? relativized.slice(0, effectiveLimit) : relativized;
+                const rawOutput = outputLines.join('\n');
+                const truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });
+                let resultOutput = truncation.content;
+                const details = {};
+                const notices = [];
+                if (resultLimitReached) {
+                    notices.push(`${effectiveLimit} results limit reached`);
+                    details.resultLimitReached = effectiveLimit;
+                }
+                if (truncation.truncated) {
+                    notices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);
+                    details.truncation = truncation;
+                }
+                if (notices.length > 0) {
+                    resultOutput += `\n\n[${notices.join('. ')}]`;
+                }
+                return {
+                    content: [{ type: 'text', text: resultOutput }],
+                    details: Object.keys(details).length > 0 ? details : undefined,
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error during find: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                    details: {},
+                };
+            }
+        },
+    };
+}
+/** Default find tool using process.cwd() */
+export const findTool = createFindTool(process.cwd());
+//# sourceMappingURL=find.js.map

package/dist/agent/tools/find.js.map

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

package/dist/agent/tools/grep.d.ts

@@ -0,0 +1,33 @@
+import { type Static } from '@sinclair/typebox';
+import type { AgentTool } from '@mariozechner/pi-agent-core';
+import { type TruncationResult } from './truncate.js';
+declare const grepSchema: import("@sinclair/typebox/build/cjs/index.js").TObject<{
+    pattern: import("@sinclair/typebox/build/cjs/index.js").TString;
+    path: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TString>;
+    glob: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TString>;
+    ignoreCase: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TBoolean>;
+    literal: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TBoolean>;
+    context: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TNumber>;
+    limit: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TNumber>;
+}>;
+export type GrepToolInput = Static<typeof grepSchema>;
+export interface GrepToolDetails {
+    truncation?: TruncationResult;
+    matchLimitReached?: number;
+    linesTruncated?: boolean;
+}
+/**
+ * Grep tool - Search file contents for a pattern
+ */
+export declare function createGrepTool(cwd: string): AgentTool<typeof grepSchema>;
+/** Default grep tool using process.cwd() */
+export declare const grepTool: AgentTool<import("@sinclair/typebox/build/cjs/index.js").TObject<{
+    pattern: import("@sinclair/typebox/build/cjs/index.js").TString;
+    path: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TString>;
+    glob: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TString>;
+    ignoreCase: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TBoolean>;
+    literal: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TBoolean>;
+    context: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TNumber>;
+    limit: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TNumber>;
+}>, any>;
+export {};

package/dist/agent/tools/grep.js

@@ -0,0 +1,183 @@
+import { Type } from '@sinclair/typebox';
+import { readFileSync, existsSync, statSync } from 'fs';
+import { globSync } from 'glob';
+import path from 'path';
+import { DEFAULT_MAX_BYTES, formatSize, GREP_MAX_LINE_LENGTH, truncateHead, truncateLine, } from './truncate.js';
+import { resolveToCwd } from './path-utils.js';
+const grepSchema = Type.Object({
+    pattern: Type.String({ description: 'Search pattern (regex or literal string)' }),
+    path: Type.Optional(Type.String({ description: 'Directory or file to search (default: current directory)' })),
+    glob: Type.Optional(Type.String({ description: "Filter files by glob pattern, e.g. '*.ts'" })),
+    ignoreCase: Type.Optional(Type.Boolean({ description: 'Case-insensitive search (default: false)' })),
+    literal: Type.Optional(Type.Boolean({ description: 'Treat pattern as literal string instead of regex (default: false)' })),
+    context: Type.Optional(Type.Number({ description: 'Number of lines to show before and after each match (default: 0)' })),
+    limit: Type.Optional(Type.Number({ description: 'Maximum number of matches to return (default: 100)' })),
+});
+const DEFAULT_LIMIT = 100;
+/**
+ * Simple grep implementation using Node.js regex
+ */
+function simpleGrep(content, pattern, options) {
+    const matches = [];
+    const lines = content.split('\n');
+    const regexPattern = options.literal
+        ? pattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+        : pattern;
+    const flags = options.ignoreCase ? 'i' : '';
+    const regex = new RegExp(regexPattern, flags);
+    for (let i = 0; i < lines.length; i++) {
+        if (regex.test(lines[i])) {
+            matches.push({ lineNumber: i + 1, line: lines[i] });
+        }
+    }
+    return matches;
+}
+/**
+ * Grep tool - Search file contents for a pattern
+ */
+export function createGrepTool(cwd) {
+    return {
+        name: 'grep',
+        label: '🔍 grep',
+        description: 'Search file contents for a pattern (regex or literal).',
+        parameters: grepSchema,
+        execute: async (_toolCallId, params, signal) => {
+            try {
+                const searchPath = resolveToCwd(params.path || '.', cwd);
+                if (!existsSync(searchPath)) {
+                    return {
+                        content: [{ type: 'text', text: `Error: Path not found: ${searchPath}` }],
+                        details: {},
+                    };
+                }
+                const isDirectory = statSync(searchPath).isDirectory();
+                const context = params.context || 0;
+                const effectiveLimit = params.limit || DEFAULT_LIMIT;
+                const files = [];
+                // Collect files to search
+                if (isDirectory) {
+                    const globPattern = params.glob || '**/*';
+                    const filePaths = globSync(globPattern, {
+                        cwd: searchPath,
+                        dot: true,
+                        ignore: ['**/node_modules/**', '**/.git/**'],
+                    });
+                    files.push(...filePaths.map(f => path.join(searchPath, f)));
+                }
+                else {
+                    files.push(searchPath);
+                }
+                const matches = [];
+                let matchCount = 0;
+                let linesTruncated = false;
+                // Search each file
+                for (const filePath of files) {
+                    if (signal?.aborted) {
+                        return {
+                            content: [{ type: 'text', text: 'Operation aborted' }],
+                            details: {},
+                        };
+                    }
+                    try {
+                        if (!existsSync(filePath))
+                            continue;
+                        const content = readFileSync(filePath, 'utf-8');
+                        const fileMatches = simpleGrep(content, params.pattern, {
+                            ignoreCase: params.ignoreCase || false,
+                            literal: params.literal || false,
+                        });
+                        for (const match of fileMatches) {
+                            if (matchCount >= effectiveLimit)
+                                break;
+                            matches.push({ file: filePath, ...match });
+                            matchCount++;
+                        }
+                    }
+                    catch {
+                        // Skip files that can't be read
+                    }
+                    if (matchCount >= effectiveLimit)
+                        break;
+                }
+                if (matches.length === 0) {
+                    return {
+                        content: [{ type: 'text', text: 'No matches found' }],
+                        details: {},
+                    };
+                }
+                // Format output
+                const outputLines = [];
+                const basePath = isDirectory ? searchPath : path.dirname(searchPath);
+                for (const match of matches) {
+                    const relativePath = path.relative(basePath, match.file);
+                    const { text: truncatedLine, wasTruncated } = truncateLine(match.line);
+                    if (wasTruncated)
+                        linesTruncated = true;
+                    if (context > 0) {
+                        // Add context lines
+                        try {
+                            const content = readFileSync(match.file, 'utf-8');
+                            const allLines = content.split('\n');
+                            const start = Math.max(1, match.lineNumber - context);
+                            const end = Math.min(allLines.length, match.lineNumber + context);
+                            for (let i = start; i <= end; i++) {
+                                const lineText = allLines[i - 1] || '';
+                                const { text: truncatedContextLine } = truncateLine(lineText);
+                                if (i === match.lineNumber) {
+                                    outputLines.push(`${relativePath}:${i}: ${truncatedContextLine}`);
+                                }
+                                else {
+                                    outputLines.push(`${relativePath}-${i}- ${truncatedContextLine}`);
+                                }
+                            }
+                        }
+                        catch {
+                            outputLines.push(`${relativePath}:${match.lineNumber}: ${truncatedLine}`);
+                        }
+                    }
+                    else {
+                        outputLines.push(`${relativePath}:${match.lineNumber}: ${truncatedLine}`);
+                    }
+                }
+                const rawOutput = outputLines.join('\n');
+                const truncation = truncateHead(rawOutput, { maxLines: Number.MAX_SAFE_INTEGER });
+                let output = truncation.content;
+                const details = {};
+                const notices = [];
+                if (matches.length >= effectiveLimit) {
+                    notices.push(`${effectiveLimit} matches limit reached`);
+                    details.matchLimitReached = effectiveLimit;
+                }
+                if (truncation.truncated) {
+                    notices.push(`${formatSize(DEFAULT_MAX_BYTES)} limit reached`);
+                    details.truncation = truncation;
+                }
+                if (linesTruncated) {
+                    notices.push(`Some lines truncated to ${GREP_MAX_LINE_LENGTH} chars`);
+                    details.linesTruncated = true;
+                }
+                if (notices.length > 0) {
+                    output += `\n\n[${notices.join('. ')}]`;
+                }
+                return {
+                    content: [{ type: 'text', text: output }],
+                    details: Object.keys(details).length > 0 ? details : undefined,
+                };
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error during grep: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                    details: {},
+                };
+            }
+        },
+    };
+}
+/** Default grep tool using process.cwd() */
+export const grepTool = createGrepTool(process.cwd());
+//# sourceMappingURL=grep.js.map

package/dist/agent/tools/grep.js.map

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

package/dist/agent/tools/index.d.ts

@@ -0,0 +1,13 @@
+export { readFileTool } from './read.js';
+export { writeFileTool } from './write.js';
+export { editFileTool, type EditToolDetails } from './edit.js';
+export { listDirTool } from './list-dir.js';
+export { createShellTool } from './shell.js';
+export { createMemorySearchTool, createMemoryGetTool } from './memory-tool.js';
+export { grepTool, createGrepTool, type GrepToolInput, type GrepToolDetails, } from './grep.js';
+export { findTool, createFindTool, type FindToolInput, type FindToolDetails, } from './find.js';
+export { createWebSearchTool, webFetchTool } from './web.js';
+export { createMessageTool } from './communication.js';
+export { createSendMediaTool } from './send-media.js';
+export { truncateHead, truncateTail, truncateLine, formatSize, type TruncationResult, type TruncationOptions, DEFAULT_MAX_LINES, DEFAULT_MAX_BYTES, GREP_MAX_LINE_LENGTH, } from './truncate.js';
+export { normalizeToLF, restoreLineEndings, normalizeForFuzzyMatch, fuzzyFindText, stripBom, generateDiffString, type FuzzyMatchResult, } from './edit-diff.js';

package/dist/agent/tools/index.js

@@ -0,0 +1,18 @@
+// Export all agent tools
+export { readFileTool } from './read.js';
+export { writeFileTool } from './write.js';
+export { editFileTool } from './edit.js';
+export { listDirTool } from './list-dir.js';
+export { createShellTool } from './shell.js';
+// Memory tools
+export { createMemorySearchTool, createMemoryGetTool } from './memory-tool.js';
+// Grep and Find tools
+export { grepTool, createGrepTool, } from './grep.js';
+export { findTool, createFindTool, } from './find.js';
+export { createWebSearchTool, webFetchTool } from './web.js';
+export { createMessageTool } from './communication.js';
+export { createSendMediaTool } from './send-media.js';
+// Utility exports
+export { truncateHead, truncateTail, truncateLine, formatSize, DEFAULT_MAX_LINES, DEFAULT_MAX_BYTES, GREP_MAX_LINE_LENGTH, } from './truncate.js';
+export { normalizeToLF, restoreLineEndings, normalizeForFuzzyMatch, fuzzyFindText, stripBom, generateDiffString, } from './edit-diff.js';
+//# sourceMappingURL=index.js.map

package/dist/agent/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/tools/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAwB,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAe;AACf,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE/E,sBAAsB;AACtB,OAAO,EACL,QAAQ,EACR,cAAc,GAGf,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,QAAQ,EACR,cAAc,GAGf,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,kBAAkB;AAClB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,UAAU,EAGV,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,aAAa,EACb,QAAQ,EACR,kBAAkB,GAEnB,MAAM,gBAAgB,CAAC"}

package/dist/agent/tools/list-dir.d.ts

@@ -0,0 +1,6 @@
+import type { AgentTool } from '@mariozechner/pi-agent-core';
+declare const ListDirSchema: import("@sinclair/typebox/build/cjs").TObject<{
+    path: import("@sinclair/typebox/build/cjs").TString;
+}>;
+export declare const listDirTool: AgentTool<typeof ListDirSchema, {}>;
+export {};

package/dist/agent/tools/list-dir.js

@@ -0,0 +1,37 @@
+// List Directory Tool
+import { Type } from '@sinclair/typebox';
+import { readdir } from 'fs/promises';
+const ListDirSchema = Type.Object({
+    path: Type.String({ description: 'The directory path to list' }),
+});
+export const listDirTool = {
+    name: 'list_dir',
+    description: 'List the contents of a directory.',
+    parameters: ListDirSchema,
+    label: '📁 List Directory',
+    async execute(toolCallId, params, _signal) {
+        try {
+            const entries = await readdir(params.path, { withFileTypes: true });
+            const lines = entries.map((e) => {
+                const type = e.isDirectory() ? 'd' : e.isFile() ? 'f' : '?';
+                return `${type} ${e.name}`;
+            });
+            return {
+                content: [{ type: 'text', text: lines.join('\n') || '(empty)' }],
+                details: {},
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error listing directory: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                details: {},
+            };
+        }
+    },
+};
+//# sourceMappingURL=list-dir.js.map

package/dist/agent/tools/list-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-dir.js","sourceRoot":"","sources":["../../../src/agent/tools/list-dir.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC;IAChC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4BAA4B,EAAE,CAAC;CACjE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAyC;IAC/D,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,mCAAmC;IAChD,UAAU,EAAE,aAAa;IACzB,KAAK,EAAE,mBAAmB;IAE1B,KAAK,CAAC,OAAO,CACX,UAAkB,EAClB,MAAoC,EACpC,OAAqB;QAErB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YACpE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAC9B,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC5D,OAAO,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7B,CAAC,CAAC,CAAC;YACH,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;gBAChE,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,4BAA4B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAC3F;iBACF;gBACD,OAAO,EAAE,EAAE;aACZ,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/agent/tools/memory-tool.d.ts

@@ -0,0 +1,14 @@
+import type { AgentTool } from '@mariozechner/pi-agent-core';
+declare const MemorySearchSchema: import("@sinclair/typebox/build/cjs/index.js").TObject<{
+    query: import("@sinclair/typebox/build/cjs/index.js").TString;
+    maxResults: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TNumber>;
+    minScore: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TNumber>;
+}>;
+export declare function createMemorySearchTool(workspaceDir: string): AgentTool<typeof MemorySearchSchema, {}>;
+declare const MemoryGetSchema: import("@sinclair/typebox/build/cjs/index.js").TObject<{
+    path: import("@sinclair/typebox/build/cjs/index.js").TString;
+    from: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TNumber>;
+    lines: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TNumber>;
+}>;
+export declare function createMemoryGetTool(workspaceDir: string): AgentTool<typeof MemoryGetSchema, {}>;
+export {};

package/dist/agent/tools/memory-tool.js

@@ -0,0 +1,81 @@
+// Memory search tools for xopcbot agent
+import { Type } from '@sinclair/typebox';
+import { memorySearch, memoryGet } from '../prompt/memory/index.js';
+// =============================================================================
+// Memory Search Tool
+// =============================================================================
+const MemorySearchSchema = Type.Object({
+    query: Type.String(),
+    maxResults: Type.Optional(Type.Number()),
+    minScore: Type.Optional(Type.Number()),
+});
+export function createMemorySearchTool(workspaceDir) {
+    return {
+        name: 'memory_search',
+        label: '🔍 Memory Search',
+        description: 'Mandatory recall step: semantically search MEMORY.md + memory/*.md before answering questions about prior work, decisions, dates, people, preferences, or todos; returns top snippets with path + lines.',
+        parameters: MemorySearchSchema,
+        async execute(_toolCallId, params, _signal) {
+            const { query, maxResults } = params;
+            try {
+                const results = await memorySearch(workspaceDir, query, { maxResults });
+                const withCitations = results.map(entry => ({
+                    ...entry,
+                    citation: `${entry.file}#L${entry.lineNumbers[0]}${entry.lineNumbers.length > 1 ? `-L${entry.lineNumbers[entry.lineNumbers.length - 1]}` : ''}`,
+                    snippet: `${entry.lines.trim()}\n\nSource: ${entry.file}#L${entry.lineNumbers[0]}${entry.lineNumbers.length > 1 ? `-L${entry.lineNumbers[entry.lineNumbers.length - 1]}` : ''}`,
+                }));
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ results: withCitations, provider: 'simple' }, null, 2) }],
+                    details: { results: withCitations },
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{ type: 'text', text: `Search error: ${message}` }],
+                    details: { error: message },
+                };
+            }
+        },
+    };
+}
+// =============================================================================
+// Memory Get Tool
+// =============================================================================
+const MemoryGetSchema = Type.Object({
+    path: Type.String(),
+    from: Type.Optional(Type.Number()),
+    lines: Type.Optional(Type.Number()),
+});
+export function createMemoryGetTool(workspaceDir) {
+    return {
+        name: 'memory_get',
+        label: '📄 Memory Get',
+        description: 'Safe snippet read from MEMORY.md or memory/*.md with optional from/lines; use after memory_search to pull only the needed lines and keep context small.',
+        parameters: MemoryGetSchema,
+        async execute(_toolCallId, params, _signal) {
+            const { path, from, lines } = params;
+            try {
+                const result = memoryGet(workspaceDir, path, from, lines);
+                if (!result) {
+                    return {
+                        content: [{ type: 'text', text: `File not found: ${path}` }],
+                        details: { path, text: '' },
+                    };
+                }
+                return {
+                    content: [{ type: 'text', text: result.content }],
+                    details: { path, text: result.content, lineNumbers: result.lineNumbers },
+                };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return {
+                    content: [{ type: 'text', text: `Read error: ${message}` }],
+                    details: { error: message },
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=memory-tool.js.map

package/dist/agent/tools/memory-tool.js.map

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

package/dist/agent/tools/path-utils.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Resolve a path to absolute path relative to cwd, supporting ~ home directory.
+ */
+export declare function resolveToCwd(path: string, cwd: string): string;

package/dist/agent/tools/path-utils.js

@@ -0,0 +1,13 @@
+/**
+ * Resolve a path to absolute path relative to cwd, supporting ~ home directory.
+ */
+export function resolveToCwd(path, cwd) {
+    if (path.startsWith('~')) {
+        return path.replace(/^~/, process.env.HOME || process.env.USERPROFILE || '');
+    }
+    if (path.startsWith('/')) {
+        return path;
+    }
+    return `${cwd}/${path}`;
+}
+//# sourceMappingURL=path-utils.js.map

package/dist/agent/tools/path-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-utils.js","sourceRoot":"","sources":["../../../src/agent/tools/path-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,GAAW;IACrD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;AACzB,CAAC"}

package/dist/agent/tools/read.d.ts

@@ -0,0 +1,7 @@
+import type { AgentTool } from '@mariozechner/pi-agent-core';
+declare const ReadFileSchema: import("@sinclair/typebox/build/cjs/index.js").TObject<{
+    path: import("@sinclair/typebox/build/cjs/index.js").TString;
+    limit: import("@sinclair/typebox/build/cjs/index.js").TOptional<import("@sinclair/typebox/build/cjs/index.js").TNumber>;
+}>;
+export declare const readFileTool: AgentTool<typeof ReadFileSchema, {}>;
+export {};

package/dist/agent/tools/read.js

@@ -0,0 +1,47 @@
+// Read file tool
+import { Type } from '@sinclair/typebox';
+import { readFile, stat } from 'fs/promises';
+import { normalize } from 'path';
+import { checkFileSafety } from '../prompt/safety.js';
+import { truncateHead, formatSize, DEFAULT_MAX_BYTES } from './truncate.js';
+const MAX_FILE_SIZE = 10 * 1024 * 1024;
+const DEFAULT_MAX_LINES = 500;
+const ReadFileSchema = Type.Object({
+    path: Type.String({ description: 'File path to read' }),
+    limit: Type.Optional(Type.Number({ description: 'Max lines (default: 500)' })),
+});
+export const readFileTool = {
+    name: 'read_file',
+    description: 'Read file contents.',
+    parameters: ReadFileSchema,
+    label: '📄 Read',
+    async execute(toolCallId, params, _signal) {
+        try {
+            const safety = checkFileSafety('read', params.path);
+            if (!safety.allowed) {
+                return { content: [{ type: 'text', text: `🚫 ${safety.message}` }], details: {} };
+            }
+            const normalized = normalize(params.path);
+            const stats = await stat(normalized);
+            if (stats.size > MAX_FILE_SIZE) {
+                return { content: [{ type: 'text', text: `🚫 File too large: ${formatSize(stats.size)}` }], details: {} };
+            }
+            const content = await readFile(normalized, 'utf-8');
+            const truncation = truncateHead(content, { maxLines: params.limit || DEFAULT_MAX_LINES, maxBytes: DEFAULT_MAX_BYTES });
+            let outputText = truncation.content;
+            if (truncation.truncated) {
+                if (truncation.firstLineExceedsLimit) {
+                    outputText = `(Line exceeds ${formatSize(DEFAULT_MAX_BYTES)})`;
+                }
+                else {
+                    outputText += `\n\n[${truncation.outputLines}/${truncation.totalLines} lines]`;
+                }
+            }
+            return { content: [{ type: 'text', text: outputText }], details: {} };
+        }
+        catch (error) {
+            return { content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }], details: {} };
+        }
+    },
+};
+//# sourceMappingURL=read.js.map

package/dist/agent/tools/read.js.map

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