@agi-cli/sdk 0.1.49 → 0.1.50

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

package/src/tools/builtin/git.ts

@@ -1,112 +0,0 @@
-import { tool, type Tool } from 'ai';
-import { z } from 'zod';
-import { $ } from 'bun';
-import GIT_STATUS_DESCRIPTION from './git.status.txt' with { type: 'text' };
-import GIT_DIFF_DESCRIPTION from './git.diff.txt' with { type: 'text' };
-import GIT_COMMIT_DESCRIPTION from './git.commit.txt' with { type: 'text' };
-
-export function buildGitTools(
-	projectRoot: string,
-): Array<{ name: string; tool: Tool }> {
-	// Helper to find git root directory
-	async function findGitRoot(): Promise<string> {
-		try {
-			const res = await $`git -C ${projectRoot} rev-parse --show-toplevel`
-				.quiet()
-				.text()
-				.catch(() => '');
-			return res.trim() || projectRoot;
-		} catch {
-			return projectRoot;
-		}
-	}
-
-	async function inRepo(): Promise<boolean> {
-		const res = await $`git -C ${projectRoot} rev-parse --is-inside-work-tree`
-			.quiet()
-			.text()
-			.catch(() => '');
-		return res.trim() === 'true';
-	}
-
-	const git_status = tool({
-		description: GIT_STATUS_DESCRIPTION,
-		inputSchema: z.object({}).optional(),
-		async execute() {
-			if (!(await inRepo())) throw new Error('Not a git repository');
-			const gitRoot = await findGitRoot();
-			const out = await $`git -C ${gitRoot} status --porcelain=v1`.text();
-			const lines = out.split('\n').filter(Boolean);
-			let staged = 0;
-			let unstaged = 0;
-			for (const line of lines) {
-				const x = line[0];
-				const y = line[1];
-				if (!x || !y) continue;
-				if (x === '!' && y === '!') continue; // ignored files
-				const isUntracked = x === '?' && y === '?';
-				if (x !== ' ' && !isUntracked) staged += 1;
-				if (isUntracked || y !== ' ') unstaged += 1;
-			}
-			return {
-				staged,
-				unstaged,
-				raw: lines.slice(0, 200),
-			};
-		},
-	});
-
-	const git_diff = tool({
-		description: GIT_DIFF_DESCRIPTION,
-		inputSchema: z.object({ all: z.boolean().optional().default(false) }),
-		async execute({ all }: { all?: boolean }) {
-			if (!(await inRepo())) throw new Error('Not a git repository');
-			const gitRoot = await findGitRoot();
-			// When all=true, show full working tree diff relative to HEAD
-			// so both staged and unstaged changes are included. Otherwise,
-			// show only the staged diff (index vs HEAD).
-			const args = all ? ['diff', 'HEAD'] : ['diff', '--staged'];
-			const out = await $`git -C ${gitRoot} ${args}`.text();
-			const limited = out.split('\n').slice(0, 5000).join('\n');
-			return { all: !!all, patch: limited };
-		},
-	});
-
-	const git_commit = tool({
-		description: GIT_COMMIT_DESCRIPTION,
-		inputSchema: z.object({
-			message: z.string().min(5),
-			amend: z.boolean().optional().default(false),
-			signoff: z.boolean().optional().default(false),
-		}),
-		async execute({
-			message,
-			amend,
-			signoff,
-		}: {
-			message: string;
-			amend?: boolean;
-			signoff?: boolean;
-		}) {
-			if (!(await inRepo())) throw new Error('Not a git repository');
-			const gitRoot = await findGitRoot();
-			const args = ['commit', '-m', message];
-			if (amend) args.push('--amend');
-			if (signoff) args.push('--signoff');
-			const res = await $`git -C ${gitRoot} ${args}`
-				.quiet()
-				.text()
-				.catch(async (e) => {
-					const txt = typeof e?.stderr === 'string' ? e.stderr : String(e);
-					throw new Error(txt || 'git commit failed');
-				});
-			return { result: res.trim() };
-		},
-	});
-
-	return [
-		{ name: 'git_status', tool: git_status },
-		{ name: 'git_diff', tool: git_diff },
-		{ name: 'git_commit', tool: git_commit },
-	];
-}

package/src/tools/builtin/glob.ts

@@ -1,82 +0,0 @@
-import { tool, type Tool } from 'ai';
-import { z } from 'zod';
-import { $ } from 'bun';
-import { join, isAbsolute, resolve } from 'node:path';
-import DESCRIPTION from './glob.txt' with { type: 'text' };
-import { defaultIgnoreGlobs } from './ignore.ts';
-
-// description imported above
-
-export function buildGlobTool(projectRoot: string): {
-	name: string;
-	tool: Tool;
-} {
-	const glob = tool({
-		description: DESCRIPTION,
-		inputSchema: z.object({
-			pattern: z
-				.string()
-				.describe('Glob pattern to match files (e.g., "**/*.ts")'),
-			path: z
-				.string()
-				.optional()
-				.describe('Directory to search in. Defaults to the project root.'),
-			ignore: z
-				.array(z.string())
-				.optional()
-				.describe('Glob patterns to exclude from results'),
-		}),
-		async execute(params) {
-			const limit = 100;
-			const search = params.path
-				? isAbsolute(params.path)
-					? params.path
-					: join(projectRoot, params.path)
-				: projectRoot;
-			const args = ['--files', '--color', 'never', '-g', params.pattern];
-			for (const g of defaultIgnoreGlobs(params.ignore)) {
-				args.push('-g', g);
-			}
-			const { exitCode, stdout, stderr } = await $`rg ${args}`
-				.cwd(search)
-				.nothrow();
-			if (exitCode !== 0) {
-				const msg = (stderr || stdout || 'rg failed').toString().trim();
-				throw new Error(`glob failed: ${msg}`);
-			}
-			const lines = stdout.split('\n').filter(Boolean);
-			const items: Array<{ path: string; mtime: number }> = [];
-			let truncated = false;
-			for (const rel of lines) {
-				if (items.length >= limit) {
-					truncated = true;
-					break;
-				}
-				const full = resolve(search, rel);
-				const mtime = await Bun.file(full)
-					.stat()
-					.then((s) => s.mtime.getTime())
-					.catch(() => 0);
-				items.push({ path: full, mtime });
-			}
-			items.sort((a, b) => b.mtime - a.mtime);
-			const output: string[] = [];
-			if (items.length === 0) output.push('No files found');
-			else {
-				output.push(...items.map((i) => i.path));
-				if (truncated) {
-					output.push('');
-					output.push(
-						'(Results are truncated. Consider using a more specific path or pattern.)',
-					);
-				}
-			}
-			return {
-				title: isAbsolute(search) ? search : join(projectRoot, search),
-				metadata: { count: items.length, truncated },
-				output: output.join('\n'),
-			};
-		},
-	});
-	return { name: 'glob', tool: glob };
-}

package/src/tools/builtin/glob.txt

@@ -1,8 +0,0 @@
-- Fast file pattern matching powered by ripgrep (rg)
-- Supports glob patterns like "**/*.js" or "src/**/*.ts"
-- Returns absolute file paths sorted by modification time
-- Skips common build and cache folders by default; add 'ignore' patterns to refine
-
-Usage tips:
-- Use the Grep tool for content searches
-- Omit 'path' to search from the project root; set a subdirectory to narrow results