@agi-cli/sdk 0.1.49 → 0.1.51

package/src/tools/builtin/edit.ts

@@ -1,145 +0,0 @@
-import { tool, type Tool } from 'ai';
-import { z } from 'zod';
-import DESCRIPTION from './edit.txt' with { type: 'text' };
-
-const replaceOp = z.object({
-	type: z.literal('replace'),
-	find: z.string().describe('String or regex (when regex=true)'),
-	replace: z.string().default(''),
-	regex: z.boolean().optional().default(false),
-	flags: z.string().optional().default('g'),
-	count: z
-		.number()
-		.int()
-		.min(1)
-		.optional()
-		.describe('Limit number of replacements'),
-});
-
-const insertOp = z.object({
-	type: z.literal('insert'),
-	position: z.enum(['before', 'after', 'start', 'end']).default('after'),
-	pattern: z.string().optional().describe('Anchor pattern for before/after'),
-	content: z.string(),
-	once: z.boolean().optional().default(true),
-});
-
-const deleteRangeOp = z.object({
-	type: z.literal('delete_range'),
-	start: z.string().describe('Start marker (first occurrence)'),
-	end: z.string().describe('End marker (first occurrence after start)'),
-	includeBoundaries: z.boolean().optional().default(false),
-});
-
-const opSchema = z.discriminatedUnion('type', [
-	replaceOp,
-	insertOp,
-	deleteRangeOp,
-]);
-
-export const editTool: Tool = tool({
-	description: DESCRIPTION,
-	inputSchema: z.object({
-		path: z.string().min(1),
-		ops: z.array(opSchema).min(1),
-		create: z.boolean().optional().default(false),
-	}),
-	async execute({
-		path,
-		ops,
-		create,
-	}: {
-		path: string;
-		ops: z.infer<typeof opSchema>[];
-		create?: boolean;
-	}) {
-		const file = Bun.file(path);
-		if (!(await file.exists())) {
-			if (!create) throw new Error(`File not found: ${path}`);
-			await Bun.write(path, '');
-		}
-		let text = await Bun.file(path).text();
-		let applied = 0;
-
-		for (const op of ops) {
-			if (op.type === 'replace') {
-				const originalText = text;
-				if (op.regex) {
-					const re = new RegExp(op.find, op.flags || 'g');
-					if (op.count && op.count > 0) {
-						let n = 0;
-						text = text.replace(re, (m) => {
-							if (n < (op.count as number)) {
-								n += 1;
-								return op.replace;
-							}
-							return m;
-						});
-					} else text = text.replace(re, op.replace);
-				} else {
-					// Check if the text to find exists
-					if (!text.includes(op.find)) {
-						console.warn(
-							`Warning: Text not found for replace operation: "${op.find.substring(0, 50)}${op.find.length > 50 ? '...' : ''}"`,
-						);
-					}
-					if (op.count && op.count > 0) {
-						let remaining = op.count as number;
-						let idx = text.indexOf(op.find);
-						while (idx !== -1 && remaining > 0) {
-							text =
-								text.slice(0, idx) +
-								op.replace +
-								text.slice(idx + op.find.length);
-							remaining -= 1;
-							idx = text.indexOf(op.find, idx + op.replace.length);
-						}
-					} else {
-						text = text.split(op.find).join(op.replace);
-					}
-				}
-				// Only count as applied if text actually changed
-				if (text !== originalText) {
-					applied += 1;
-				}
-			} else if (op.type === 'insert') {
-				if (op.position === 'start') {
-					text = `${op.content}${text}`;
-					applied += 1;
-					continue;
-				}
-				if (op.position === 'end') {
-					text = `${text}${op.content}`;
-					applied += 1;
-					continue;
-				}
-				if (!op.pattern)
-					throw new Error('insert requires pattern for before/after');
-				const idx = text.indexOf(op.pattern);
-				if (idx === -1) continue;
-				if (op.position === 'before')
-					text = text.slice(0, idx) + op.content + text.slice(idx);
-				else
-					text =
-						text.slice(0, idx + op.pattern.length) +
-						op.content +
-						text.slice(idx + op.pattern.length);
-				applied += 1;
-				if (op.once) continue;
-			} else if (op.type === 'delete_range') {
-				const startIdx = text.indexOf(op.start);
-				if (startIdx === -1) continue;
-				const after = startIdx + op.start.length;
-				const endIdx = text.indexOf(op.end, after);
-				if (endIdx === -1) continue;
-				const from = op.includeBoundaries ? startIdx : after;
-				const to = op.includeBoundaries ? endIdx + op.end.length : endIdx;
-				text = text.slice(0, from) + text.slice(to);
-				applied += 1;
-			}
-		}
-
-		await Bun.write(path, text);
-		return { path, opsApplied: applied, bytes: text.length };
-	},
-});

package/src/tools/builtin/edit.txt

@@ -1,7 +0,0 @@
-- Edit a file using structured operations
-- Supported ops: `replace`, `insert`, `delete_range`
-- Paths are relative to the project root; can create files if flagged
-
-Usage tips:
-- Prefer minimal, targeted changes for clarity
-- For sweeping refactors, consider Write or Patch to replace full content

package/src/tools/builtin/file-cache.ts

@@ -1,39 +0,0 @@
-/**
- * File content cache to track modifications during a session/step
- * This helps ensure tools always work with the latest file content
- */
-
-const fileContentCache = new Map<string, Map<string, string>>();
-
-export function getFileCache(sessionId: string): Map<string, string> {
-	if (!fileContentCache.has(sessionId)) {
-		fileContentCache.set(sessionId, new Map());
-	}
-	return fileContentCache.get(sessionId) as Map<string, string>;
-}
-
-export function updateFileCache(
-	sessionId: string,
-	filePath: string,
-	content: string,
-): void {
-	const cache = getFileCache(sessionId);
-	cache.set(filePath, content);
-}
-
-export function getCachedContent(
-	sessionId: string,
-	filePath: string,
-): string | undefined {
-	const cache = getFileCache(sessionId);
-	return cache.get(filePath);
-}
-
-export function clearFileCache(sessionId: string): void {
-	fileContentCache.delete(sessionId);
-}
-
-export function clearFileCacheEntry(sessionId: string, filePath: string): void {
-	const cache = getFileCache(sessionId);
-	cache.delete(filePath);
-}

package/src/tools/builtin/finish.ts

@@ -1,11 +0,0 @@
-import { z } from 'zod';
-import { tool } from 'ai';
-import DESCRIPTION from './finish.txt' with { type: 'text' };
-
-export const finishTool = tool({
-	description: DESCRIPTION,
-	inputSchema: z.object({}),
-	async execute() {
-		return { done: true } as const;
-	},
-});

package/src/tools/builtin/finish.txt

@@ -1,5 +0,0 @@
-- Signal that the task is complete
-- Agent should stream the summary directly as assistant message not using the finish tool
-
-Usage tips:
-- Ensure all necessary outputs are already saved/emitted before finishing

package/src/tools/builtin/fs/cd.ts

@@ -1,19 +0,0 @@
-import { tool, type Tool } from 'ai';
-import { z } from 'zod';
-import DESCRIPTION from './cd.txt' with { type: 'text' };
-
-// description imported above
-
-export function buildCdTool(): { name: string; tool: Tool } {
-	const cd = tool({
-		description: DESCRIPTION,
-		inputSchema: z.object({
-			path: z.string().describe('Relative directory path'),
-		}),
-		async execute({ path }: { path: string }) {
-			// Actual cwd update is handled in the adapter; this is a placeholder schema
-			return { cwd: path };
-		},
-	});
-	return { name: 'cd', tool: cd };
-}

package/src/tools/builtin/fs/cd.txt

@@ -1,5 +0,0 @@
-- Change the current working directory (relative to the project root)
-- The runner enforces boundaries; this tool only requests a new cwd
-
-Usage tip:
-- Use PWD to verify the current directory

package/src/tools/builtin/fs/index.ts

@@ -1,20 +0,0 @@
-import type { Tool } from 'ai';
-import { buildReadTool } from './read.ts';
-import { buildWriteTool } from './write.ts';
-import { buildLsTool } from './ls.ts';
-import { buildTreeTool } from './tree.ts';
-import { buildPwdTool } from './pwd.ts';
-import { buildCdTool } from './cd.ts';
-
-export function buildFsTools(
-	projectRoot: string,
-): Array<{ name: string; tool: Tool }> {
-	const out: Array<{ name: string; tool: Tool }> = [];
-	out.push(buildReadTool(projectRoot));
-	out.push(buildWriteTool(projectRoot));
-	out.push(buildLsTool(projectRoot));
-	out.push(buildTreeTool(projectRoot));
-	out.push(buildPwdTool());
-	out.push(buildCdTool());
-	return out;
-}

package/src/tools/builtin/fs/ls.ts

@@ -1,57 +0,0 @@
-import { tool, type Tool } from 'ai';
-import { z } from 'zod';
-import { spawn } from 'bun';
-import { expandTilde, isAbsoluteLike, resolveSafePath } from './util.ts';
-import DESCRIPTION from './ls.txt' with { type: 'text' };
-import { toIgnoredBasenames } from '../ignore.ts';
-
-// description imported above
-
-export function buildLsTool(projectRoot: string): { name: string; tool: Tool } {
-	const ls = tool({
-		description: DESCRIPTION,
-		inputSchema: z.object({
-			path: z
-				.string()
-				.default('.')
-				.describe(
-					"Directory path. Relative to project root by default; absolute ('/...') and home ('~/...') paths are allowed.",
-				),
-			ignore: z
-				.array(z.string())
-				.optional()
-				.describe('List of directory names/globs to ignore'),
-		}),
-		async execute({ path, ignore }: { path: string; ignore?: string[] }) {
-			const req = expandTilde(path || '.');
-			const abs = isAbsoluteLike(req)
-				? req
-				: resolveSafePath(projectRoot, req || '.');
-			const ignored = toIgnoredBasenames(ignore);
-			const proc = spawn({
-				cmd: ['ls', '-1p'],
-				cwd: abs,
-				stdout: 'pipe',
-				stderr: 'pipe',
-			});
-			const exitCode = await proc.exited;
-			const stdout = await new Response(proc.stdout).text();
-			const stderr = await new Response(proc.stderr).text();
-			if (exitCode !== 0) {
-				const message = (stderr || stdout || 'ls failed').trim();
-				throw new Error(`ls failed for ${req}: ${message}`);
-			}
-			const entries = stdout
-				.split('\n')
-				.map((line) => line.trim())
-				.filter((line) => line.length > 0 && !line.startsWith('.'))
-				.map((line) => ({
-					name: line.replace(/\/$/, ''),
-					type: line.endsWith('/') ? 'dir' : 'file',
-				}))
-				.filter((entry) => !(entry.type === 'dir' && ignored.has(entry.name)));
-			return { path: req, entries };
-		},
-	});
-	return { name: 'ls', tool: ls };
-}

package/src/tools/builtin/fs/ls.txt

@@ -1,8 +0,0 @@
-- Lists files and directories in a given path (non-recursive)
-- Accepts absolute ('/...'), home ('~/...'), or project-relative paths
-- Hides common build and cache folders by default (node_modules, dist, .git, etc.)
-- Optional ignore patterns allow further filtering of directory names
-
-Usage tips:
-- Prefer the Glob tool for pattern-based discovery and Grep for content search
-- Use the Tree tool for a hierarchical view with limited depth

package/src/tools/builtin/fs/pwd.ts

@@ -1,17 +0,0 @@
-import { tool, type Tool } from 'ai';
-import { z } from 'zod';
-import DESCRIPTION from './pwd.txt' with { type: 'text' };
-
-// description imported above
-
-export function buildPwdTool(): { name: string; tool: Tool } {
-	const pwd = tool({
-		description: DESCRIPTION,
-		inputSchema: z.object({}).optional(),
-		async execute() {
-			// Actual cwd resolution is handled in the adapter; this is a placeholder schema
-			return { cwd: '.' };
-		},
-	});
-	return { name: 'pwd', tool: pwd };
-}

package/src/tools/builtin/fs/pwd.txt

@@ -1,5 +0,0 @@
-- Return the current working directory (relative to the project root)
-- The runner maintains a per-session cwd; this tool reports it
-
-Usage tip:
-- Combine with the CD tool to navigate within the workspace

package/src/tools/builtin/fs/read.ts

@@ -1,49 +0,0 @@
-import { tool, type Tool } from 'ai';
-import { z } from 'zod';
-import { expandTilde, isAbsoluteLike, resolveSafePath } from './util.ts';
-import DESCRIPTION from './read.txt' with { type: 'text' };
-
-const embeddedTextAssets: Record<string, string> = {};
-
-// description imported above
-
-export function buildReadTool(projectRoot: string): {
-	name: string;
-	tool: Tool;
-} {
-	const read = tool({
-		description: DESCRIPTION,
-		inputSchema: z.object({
-			path: z
-				.string()
-				.describe(
-					"File path. Relative to project root by default; absolute ('/...') and home ('~/...') paths are allowed.",
-				),
-		}),
-		async execute({ path }: { path: string }) {
-			const req = expandTilde(path);
-			if (isAbsoluteLike(req)) {
-				const f = Bun.file(req);
-				if (await f.exists()) {
-					const content = await f.text();
-					return { path: req, content, size: content.length };
-				}
-				throw new Error(`File not found: ${req}`);
-			}
-			const abs = resolveSafePath(projectRoot, req);
-			const f = Bun.file(abs);
-			if (await f.exists()) {
-				const content = await f.text();
-				return { path: req, content, size: content.length };
-			}
-			const embedded = embeddedTextAssets[req];
-			if (embedded) {
-				const ef = Bun.file(embedded);
-				const content = await ef.text();
-				return { path: req, content, size: content.length };
-			}
-			throw new Error(`File not found: ${req}`);
-		},
-	});
-	return { name: 'read', tool: read };
-}

package/src/tools/builtin/fs/read.txt

@@ -1,8 +0,0 @@
-- Read a text file from the workspace
-- Accepts absolute ('/...'), home ('~/...'), or project-relative paths
-- Returns file text and size in bytes
-- May serve embedded text assets for some paths (internal optimization)
-
-Usage tips:
-- Prefer relative project paths when possible (more portable)
-- For large files or searches, use the Grep or Ripgrep tool

package/src/tools/builtin/fs/tree.ts

@@ -1,67 +0,0 @@
-import { tool, type Tool } from 'ai';
-import { z } from 'zod';
-import { spawn } from 'bun';
-import { expandTilde, isAbsoluteLike, resolveSafePath } from './util.ts';
-import DESCRIPTION from './tree.txt' with { type: 'text' };
-import { toIgnoredBasenames } from '../ignore.ts';
-
-// description imported above
-
-export function buildTreeTool(projectRoot: string): {
-	name: string;
-	tool: Tool;
-} {
-	const tree = tool({
-		description: DESCRIPTION,
-		inputSchema: z.object({
-			path: z.string().default('.'),
-			depth: z
-				.number()
-				.int()
-				.min(1)
-				.max(20)
-				.optional()
-				.describe('Optional depth limit (defaults to full depth).'),
-			ignore: z
-				.array(z.string())
-				.optional()
-				.describe('List of directory names/globs to ignore'),
-		}),
-		async execute({
-			path,
-			depth,
-			ignore,
-		}: {
-			path: string;
-			depth?: number;
-			ignore?: string[];
-		}) {
-			const req = expandTilde(path || '.');
-			const start = isAbsoluteLike(req)
-				? req
-				: resolveSafePath(projectRoot, req || '.');
-			const ignored = toIgnoredBasenames(ignore);
-			const args = ['tree'];
-			if (typeof depth === 'number') args.push('-L', String(depth));
-			if (ignored.size) args.push('-I', Array.from(ignored).join('|'));
-			args.push('.');
-
-			const proc = spawn({
-				cmd: args,
-				cwd: start,
-				stdout: 'pipe',
-				stderr: 'pipe',
-			});
-			const exitCode = await proc.exited;
-			const stdout = await new Response(proc.stdout).text();
-			const stderr = await new Response(proc.stderr).text();
-			if (exitCode !== 0) {
-				const message = (stderr || stdout || 'tree failed').trim();
-				throw new Error(`tree failed for ${req}: ${message}`);
-			}
-			const output = stdout.trimEnd();
-			return { path: req, depth: depth ?? null, tree: output };
-		},
-	});
-	return { name: 'tree', tool: tree };
-}

package/src/tools/builtin/fs/tree.txt

@@ -1,8 +0,0 @@
-- Render a shallow directory tree from a starting path
-- Accepts absolute, home, or project-relative paths
-- Skips common build/cache folders (node_modules, dist, .git, etc.) by default
-- Depth is capped to avoid excessive output (1–5)
-
-Usage tips:
-- Use the LS tool for a flat listing of one directory
-- Use the Glob and Grep tools for file pattern and content searches respectively

package/src/tools/builtin/fs/util.ts

@@ -1,95 +0,0 @@
-import { createTwoFilesPatch } from 'diff';
-import { resolve as resolvePath } from 'node:path';
-
-function normalizeForComparison(value: string) {
-	const withForwardSlashes = value.replace(/\\/g, '/');
-	return process.platform === 'win32'
-		? withForwardSlashes.toLowerCase()
-		: withForwardSlashes;
-}
-
-export function resolveSafePath(projectRoot: string, p: string) {
-	const root = resolvePath(projectRoot);
-	const target = resolvePath(root, p || '.');
-	const rootNorm = (() => {
-		const normalized = normalizeForComparison(root);
-		if (normalized === '/') return '/';
-		return normalized.replace(/[\\/]+$/, '');
-	})();
-	const targetNorm = normalizeForComparison(target);
-	const rootWithSlash = rootNorm === '/' ? '/' : `${rootNorm}/`;
-	const inProject =
-		targetNorm === rootNorm || targetNorm.startsWith(rootWithSlash);
-	if (!inProject) throw new Error(`Path escapes project root: ${p}`);
-	return target;
-}
-
-export function expandTilde(p: string): string {
-	const home = process.env.HOME || process.env.USERPROFILE || '';
-	if (!home) return p;
-	if (p === '~') return home;
-	if (p.startsWith('~/')) return `${home}/${p.slice(2)}`;
-	return p;
-}
-
-export function isAbsoluteLike(p: string): boolean {
-	return p.startsWith('/') || /^[A-Za-z]:[\\/]/.test(p);
-}
-
-export async function buildWriteArtifact(
-	relPath: string,
-	existed: boolean,
-	oldText: string,
-	newText: string,
-) {
-	let patch = '';
-	try {
-		patch = createTwoFilesPatch(
-			`a/${relPath}`,
-			`b/${relPath}`,
-			String(oldText ?? ''),
-			String(newText ?? ''),
-			'',
-			'',
-			{ context: 3 },
-		);
-	} catch {}
-	if (!patch || !patch.trim().length) {
-		const header = existed ? 'Update File' : 'Add File';
-		const oldLines = String(oldText ?? '').split('\n');
-		const newLines = String(newText ?? '').split('\n');
-		const lines: string[] = [];
-		lines.push('*** Begin Patch');
-		lines.push(`*** ${header}: ${relPath}`);
-		lines.push('@@');
-		if (existed) for (const l of oldLines) lines.push(`-${l}`);
-		for (const l of newLines) lines.push(`+${l}`);
-		lines.push('*** End Patch');
-		patch = lines.join('\n');
-	}
-	const { additions, deletions } = summarizePatchCounts(patch);
-	return {
-		kind: 'file_diff',
-		patch,
-		summary: { files: 1, additions, deletions },
-	} as const;
-}
-
-export function summarizePatchCounts(patch: string): {
-	additions: number;
-	deletions: number;
-} {
-	let adds = 0;
-	let dels = 0;
-	for (const line of String(patch || '').split('\n')) {
-		if (
-			line.startsWith('+++') ||
-			line.startsWith('---') ||
-			line.startsWith('diff ')
-		)
-			continue;
-		if (line.startsWith('+')) adds += 1;
-		else if (line.startsWith('-')) dels += 1;
-	}
-	return { additions: adds, deletions: dels };
-}

package/src/tools/builtin/fs/write.ts

@@ -1,61 +0,0 @@
-import { tool, type Tool } from 'ai';
-import { z } from 'zod';
-import { $ } from 'bun';
-import {
-	buildWriteArtifact,
-	resolveSafePath,
-	expandTilde,
-	isAbsoluteLike,
-} from './util.ts';
-import DESCRIPTION from './write.txt' with { type: 'text' };
-
-// description imported above
-
-export function buildWriteTool(projectRoot: string): {
-	name: string;
-	tool: Tool;
-} {
-	const write = tool({
-		description: DESCRIPTION,
-		inputSchema: z.object({
-			path: z
-				.string()
-				.describe(
-					'Relative file path within the project. Writes outside the project are not allowed.',
-				),
-			content: z.string().describe('Text content to write'),
-			createDirs: z.boolean().optional().default(true),
-		}),
-		async execute({
-			path,
-			content,
-			createDirs,
-		}: {
-			path: string;
-			content: string;
-			createDirs?: boolean;
-		}) {
-			const req = expandTilde(path);
-			if (isAbsoluteLike(req)) {
-				throw new Error(
-					`Refusing to write outside project root: ${req}. Use a relative path within the project.`,
-				);
-			}
-			const abs = resolveSafePath(projectRoot, req);
-			if (createDirs) {
-				await $`mkdir -p ${abs.slice(0, abs.lastIndexOf('/'))}`;
-			}
-			let existed = false;
-			let oldText = '';
-			try {
-				const f = Bun.file(abs);
-				existed = await f.exists();
-				if (existed) oldText = await f.text();
-			} catch {}
-			await Bun.write(abs, content);
-			const artifact = await buildWriteArtifact(req, existed, oldText, content);
-			return { path: req, bytes: content.length, artifact } as const;
-		},
-	});
-	return { name: 'write', tool: write };
-}

package/src/tools/builtin/fs/write.txt

@@ -1,8 +0,0 @@
-- Write text to a file in the workspace
-- Creates the file if it does not exist (when allowed)
-- Only writes within the project root; absolute paths are rejected
-- Returns a compact patch artifact summarizing the change
-
-Usage tips:
-- Prefer idempotent writes by providing the full intended content
-- For localized edits, consider the Edit tool with structured operations

package/src/tools/builtin/git.commit.txt

@@ -1,6 +0,0 @@
-- Create a git commit with the provided message
-- Supports `amend` and `signoff` flags
-
-Usage tips:
-- Only commit after explicit user approval
-- Consider including scope and brief rationale in the message

package/src/tools/builtin/git.diff.txt

@@ -1,5 +0,0 @@
-- Show git diff
-- By default shows staged changes; set `all=true` for full working tree diff
-
-Usage tips:
-- Use with `git_status` to preview changes before committing

package/src/tools/builtin/git.status.txt

@@ -1,5 +0,0 @@
-- Show git status in porcelain v1 format summary
-- Reports staged and unstaged counts and a capped raw list
-
-Usage tips:
-- Use before committing to understand working tree changes