@nehanahmed/forge 0.1.0

package/dist/tools/definitions.js

@@ -0,0 +1,89 @@
+// tools.ts — Agent SDK style
+import { tool } from '@openrouter/agent';
+import { z } from 'zod';
+import { runBash, readFile, writeFile, editFile, spawnSubAgent, searchCodebase } from './implementations.js';
+import { RISKY_TOOLS } from '../core/constants.js';
+export function createTools(onConfirm) {
+    const runBashTool = tool({
+        name: 'run_bash',
+        description: 'Execute a shell command in the current working directory. Use this for listing files, searching code (grep/find), checking git status, running scripts, or any other shell operation. Returns combined stdout/stderr. Prefer read_file over `cat` for reading a single file, and prefer replace_string_in_file over shell text-manipulation (sed/awk) for editing.',
+        inputSchema: z.object({
+            command: z.string().describe('A single shell command to execute, e.g. "ls -la" or "grep -rn TODO src/"'),
+        }),
+        execute: async ({ command }) => {
+            const allowed = await onConfirm(`run_bash(${command})`);
+            if (!allowed)
+                return { error: 'User denied this action.' };
+            return { output: runBash(command) };
+        },
+    });
+    const readFileTool = tool({
+        name: 'read_file',
+        description: 'Read the full contents of a single file at the given path and return it as text. Use this before editing a file to see its exact current content.',
+        inputSchema: z.object({
+            path: z.string().describe('Relative or absolute path to the file to read.'),
+        }),
+        execute: async ({ path }) => ({ content: readFile(path) }),
+    });
+    const writeFileTool = tool({
+        name: 'write_file',
+        description: 'Create a new file or completely overwrite an existing file with the given content. Use this only for creating new files or when the entire file content should be replaced. For modifying part of an existing file, use replace_string_in_file instead — it is safer and preserves everything else in the file.',
+        inputSchema: z.object({
+            path: z.string().describe('Relative or absolute path to the file to write.'),
+            content: z.string().describe('The full content to write to the file, replacing anything already there.'),
+        }),
+        execute: async ({ path, content }) => {
+            const allowed = await onConfirm(`write_file(${path})`);
+            if (!allowed)
+                return { error: 'User denied this action.' };
+            return { result: writeFile(path, content) };
+        },
+    });
+    const replaceStringInFileTool = tool({
+        name: 'replace_string_in_file',
+        description: 'Make a precise, surgical edit to an existing file by replacing one exact occurrence of a string with a new string. This is the preferred way to modify part of a file — it leaves the rest of the file untouched. stringToReplace must match EXACTLY ONE location in the file, character-for-character (including whitespace/indentation). Keep stringToReplace as SHORT as possible: include only the specific text being changed plus the minimum surrounding context needed to make the match unique (e.g. a variable name plus one line of context, not an entire function). If the string appears zero times or multiple times, this tool will fail — read the file first with read_file if unsure of exact formatting, and widen the match only as much as needed to make it unique.',
+        inputSchema: z.object({
+            path: z.string().describe('Relative or absolute path to the file to edit.'),
+            stringToReplace: z.string().describe('The exact existing text to find and replace. Must match exactly one location in the file.'),
+            newString: z.string().describe('The text to replace it with.'),
+        }),
+        execute: async ({ path, stringToReplace, newString }) => {
+            const allowed = await onConfirm(`replace_string_in_file(${path})`);
+            if (!allowed)
+                return { error: 'User denied this action.' };
+            return { result: editFile(path, stringToReplace, newString) };
+        },
+    });
+    const spawnSubAgentTool = tool({
+        name: 'spawn_sub_agent',
+        description: "Delegate a self-contained investigative task to a sub-agent with a fresh, isolated context. Use this for tasks that would pollute your context with a lot of intermediate noise — e.g. 'search the codebase for all usages of X', 'read through these 5 files and summarize the auth flow', 'find where Y is configured'. The sub-agent has read-only tools (read_file, run_bash) and returns a single summarized answer — you will NOT see its intermediate steps. Do not use this for tasks that require writing/editing files, or for simple single-file lookups you can do directly.",
+        inputSchema: z.object({
+            task: z.string().describe('A clear, self-contained description of what the sub-agent should find/do and report back. It has no knowledge of the current conversation, so include all necessary context.'),
+        }),
+        execute: async ({ task }) => ({ result: await spawnSubAgent(task) }),
+    });
+    const searchCodeTool = tool({
+        name: 'search_code',
+        description: 'Search the codebase for a text pattern using ripgrep (regex supported). Automatically excludes node_modules, dist, build output, and lockfiles — you do not need to add exclusions yourself. Use this instead of grep/rg via run_bash. Returns matching file paths and line numbers with surrounding context.',
+        inputSchema: z.object({
+            pattern: z.string().describe('Text or regex pattern to search for.'),
+            path: z.string().optional().describe('Directory to search in. Defaults to current directory.'),
+            maxResults: z
+                .number()
+                .optional()
+                .describe("Maximum total matches to return (default 60, hard cap 150). Prefer narrowing your search pattern or path over raising this — only increase it if you've confirmed the results are truncated and a narrower search isn't feasible."),
+        }),
+        execute: async ({ pattern, path, maxResults }) => ({
+            result: searchCodebase(pattern, path ?? '.', maxResults ?? 60),
+        }),
+    });
+    return [
+        runBashTool,
+        readFileTool,
+        writeFileTool,
+        replaceStringInFileTool,
+        spawnSubAgentTool,
+        searchCodeTool,
+    ];
+}
+//# sourceMappingURL=definitions.js.map

package/dist/tools/definitions.js.map

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

package/dist/tools/helpers.d.ts

@@ -0,0 +1,4 @@
+export declare function deriveSessionTitle(firstMessage: string): string;
+export declare function resolveSafePath(inputPath: string, cwd?: string): string;
+export declare const formatRgOutput: (output: string, maxTotalMatches?: number) => string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/tools/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/tools/helpers.ts"],"names":[],"mappings":"AAWA,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAMtF;AACD,eAAO,MAAM,cAAc,WAAY,MAAM,+BAAyB,MA4CrE,CAAC"}

package/dist/tools/helpers.js

@@ -0,0 +1,53 @@
+import path from "path";
+export function deriveSessionTitle(firstMessage) {
+    const cleaned = firstMessage.trim().replace(/\s+/g, ' ');
+    return cleaned.length > 50 ? cleaned.slice(0, 50) + '…' : cleaned;
+}
+export function resolveSafePath(inputPath, cwd = process.cwd()) {
+    const resolved = path.resolve(cwd, inputPath);
+    if (!resolved.startsWith(path.resolve(cwd) + path.sep) && resolved !== path.resolve(cwd)) {
+        throw new Error(`Path "${inputPath}" resolves outside the working directory and is not allowed.`);
+    }
+    return resolved;
+}
+export const formatRgOutput = (output, maxTotalMatches = 60) => {
+    const lines = output.trim().split('\n').filter(Boolean);
+    const fileGroups = new Map();
+    let totalMatches = 0;
+    let truncated = false;
+    for (const line of lines) {
+        const event = JSON.parse(line);
+        if (event.type !== 'match' && event.type !== 'context')
+            continue;
+        if (event.type === 'match') {
+            if (totalMatches >= maxTotalMatches) {
+                truncated = true;
+                continue;
+            }
+            totalMatches++;
+        }
+        const path = event.data.path.text;
+        const lineNumber = event.data?.line_number ?? 0;
+        const text = event.data?.lines?.text ?? '';
+        const isMatch = event.type === 'match';
+        if (!fileGroups.has(path))
+            fileGroups.set(path, []);
+        fileGroups.get(path).push({ lineNumber, text, isMatch });
+    }
+    if (fileGroups.size === 0)
+        return 'No matches found.';
+    const outputs = [];
+    for (const [filePath, entries] of fileGroups) {
+        entries.sort((a, b) => a.lineNumber - b.lineNumber);
+        outputs.push(`\n📄 ${filePath}`);
+        for (const { lineNumber, text, isMatch } of entries) {
+            const marker = isMatch ? '→' : ' ';
+            outputs.push(`  ${marker} ${lineNumber}: ${text}`);
+        }
+    }
+    if (truncated) {
+        outputs.push(`\n[Results truncated at ${maxTotalMatches} matches — refine your search pattern (e.g. narrow the path or use a more specific pattern) for complete results.]`);
+    }
+    return outputs.join('\n').trim();
+};
+//# sourceMappingURL=helpers.js.map

package/dist/tools/helpers.js.map

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

package/dist/tools/implementations.d.ts

@@ -0,0 +1,8 @@
+export declare function runBash(command: string): string;
+export declare function readFile(path: string): string;
+export declare function writeFile(path: string, content: string): string;
+export declare function editFile(path: string, oldContent: string, newContent: string): string;
+export declare function spawnSubAgent(task: string): Promise<string>;
+export declare function searchCodebase(pattern: string, path?: string, maxResults?: number): string;
+export declare const toolExecutors: Record<string, (args: any) => string | Promise<string>>;
+//# sourceMappingURL=implementations.d.ts.map

package/dist/tools/implementations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementations.d.ts","sourceRoot":"","sources":["../../src/tools/implementations.ts"],"names":[],"mappings":"AAQA,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAW/C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAO7C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ/D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAcrF;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBjE;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAY,EAAE,UAAU,GAAE,MAAW,GAAG,MAAM,CA4BnG;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOjF,CAAC"}

package/dist/tools/implementations.js

@@ -0,0 +1,115 @@
+import fs from 'fs';
+import { execFileSync, execSync } from 'child_process';
+import { createTools } from './definitions.js';
+import { MODEL, SUBAGENT_MAX_ITERATIONS, SUBAGENT_TOOLS, SYSTEM_PROMPT } from '../core/constants.js';
+import { getClient } from '../core/client.js';
+import { formatRgOutput, resolveSafePath } from './helpers.js';
+import { stepCountIs } from '@openrouter/agent';
+export function runBash(command) {
+    // NOTE: run_bash is NOT path-sandboxed — a shell command can `cd`, use
+    // absolute paths, or chain commands in ways resolveSafePath can't
+    // intercept. It stays a RISKY_TOOL requiring confirmation; true sandboxing
+    // would need a real subprocess jail (e.g. a restricted PATH/cwd + denylist
+    // of dangerous patterns), which is a separate, bigger piece of work.
+    try {
+        return execSync(command, { encoding: 'utf-8', timeout: 10_000, cwd: process.cwd() });
+    }
+    catch (err) {
+        return `ERROR: ${err.stdout ?? ''}${err.stderr ?? err.message}`;
+    }
+}
+export function readFile(path) {
+    try {
+        const safePath = resolveSafePath(path);
+        return fs.readFileSync(safePath, 'utf-8');
+    }
+    catch (err) {
+        return `ERROR: ${err.message}`;
+    }
+}
+export function writeFile(path, content) {
+    try {
+        const safePath = resolveSafePath(path);
+        fs.writeFileSync(safePath, content, 'utf-8');
+        return `File written successfully to ${path}`;
+    }
+    catch (err) {
+        return `ERROR: ${err.message}`;
+    }
+}
+export function editFile(path, oldContent, newContent) {
+    try {
+        const safePath = resolveSafePath(path);
+        const content = fs.readFileSync(safePath, 'utf-8');
+        const occurences = content.split(oldContent).length - 1;
+        if (occurences === 0) {
+            return `ERROR: The string "${oldContent}" was not found in the file.`;
+        }
+        const updatedContent = content.replace(oldContent, newContent);
+        fs.writeFileSync(safePath, updatedContent, 'utf-8');
+        return `Successfully replaced ${occurences} occurence(s) of "${oldContent}" with "${newContent}" in ${path}`;
+    }
+    catch (err) {
+        return `ERROR: ${err.message}`;
+    }
+}
+export async function spawnSubAgent(task) {
+    const readOnlyTools = createTools(async () => false)
+        .filter(t => SUBAGENT_TOOLS.includes(t.function.name));
+    let result;
+    try {
+        result = getClient().callModel({
+            model: MODEL,
+            instructions: SYSTEM_PROMPT,
+            input: task,
+            tools: readOnlyTools,
+            stopWhen: [stepCountIs(SUBAGENT_MAX_ITERATIONS)],
+        });
+    }
+    catch (err) {
+        return `ERROR: sub-agent model call failed — ${err?.error?.message ?? err?.message ?? String(err)}`;
+    }
+    try {
+        return await result.getText();
+    }
+    catch (err) {
+        return `ERROR: sub-agent stream failed — ${err?.error?.message ?? err?.message ?? String(err)}`;
+    }
+}
+export function searchCodebase(pattern, path = '.', maxResults = 60) {
+    const inputPath = path && path.trim() ? path : '.';
+    const cappedMax = Math.min(maxResults, 150);
+    let resolvedPath;
+    try {
+        resolvedPath = resolveSafePath(inputPath);
+    }
+    catch (err) {
+        return `ERROR: ${err.message}`;
+    }
+    try {
+        const output = execFileSync('rg', [
+            '--json', '-n', '-C', '2', '--max-count', String(cappedMax),
+            '--glob', '!node_modules',
+            '--glob', '!dist',
+            '--glob', '!.git',
+            '--glob', '!*.lock',
+            '--glob', '!package-lock.json',
+            '--', pattern, resolvedPath,
+        ], { encoding: 'utf-8', timeout: 10_000, maxBuffer: 10 * 1024 * 1024 });
+        return formatRgOutput(output, cappedMax);
+    }
+    catch (err) {
+        if (err.status === 1)
+            return 'No matches found.';
+        return `ERROR: ${err.stderr ?? err.message}`;
+    }
+}
+export const toolExecutors = {
+    run_bash: (args) => runBash(args.command),
+    read_file: (args) => readFile(args.path),
+    write_file: (args) => writeFile(args.path, args.content),
+    replace_string_in_file: (args) => editFile(args.path, args.stringToReplace, args.newString),
+    spawn_sub_agent: (args) => spawnSubAgent(args.task),
+    search_code: (args) => searchCodebase(args.pattern, args.path, args.maxResults),
+};
+//# sourceMappingURL=implementations.js.map

package/dist/tools/implementations.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,4 @@
+export { createTools } from './definitions.js';
+export { runBash, readFile, writeFile, editFile, spawnSubAgent, searchCodebase, toolExecutors, } from './implementations.js';
+export { formatRgOutput } from './helpers.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,OAAO,EACP,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,4 @@
+export { createTools } from './definitions.js';
+export { runBash, readFile, writeFile, editFile, spawnSubAgent, searchCodebase, toolExecutors, } from './implementations.js';
+export { formatRgOutput } from './helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,OAAO,EACP,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,51 @@
+export type Message = {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | null;
+    reasoning?: string;
+    toolCalls?: Array<{
+        id: string;
+        type: 'function';
+        function: {
+            name: string;
+            arguments: string;
+        };
+    }>;
+    toolCallId?: string;
+};
+export type DisplayEntry = {
+    id: number;
+    kind: 'user' | 'reasoning' | 'tool_call' | 'tool_result' | 'assistant' | 'info';
+    text: string;
+};
+export type LogEvent = {
+    type: 'reasoning_delta';
+    content: string;
+} | {
+    type: 'tool_call';
+    name: string;
+    args: any;
+} | {
+    type: 'tool_result';
+    content: string;
+} | {
+    type: 'assistant_delta';
+    content: string;
+} | {
+    type: 'info';
+    content: string;
+} | {
+    type: 'sub_agent';
+    content: string;
+};
+export type Callbacks = {
+    onLog: (event: LogEvent) => void;
+    onConfirm: (description: string) => Promise<boolean>;
+};
+export type SessionSummary = {
+    id: string;
+    updatedAt: number;
+    createdAt: number;
+    status: string;
+};
+export type OnConfirm = (description: string) => Promise<boolean>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,UAAU,CAAC;QACjB,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/C,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;IAChF,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACjC,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@nehanahmed/forge",
+  "version": "0.1.0",
+  "description": "A Terminal-based AI agent that can perform tasks and interact with the user.",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsc && npm run postbuild",
+    "postbuild": "node ./scripts/add-shebang.js",
+    "prepare": "npm run build",
+    "eval": "tsx evals/runner.ts"
+  },
+  "bin": {
+    "forge": "./dist/cli/app.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "cli",
+    "coding-agent",
+    "mutli-model"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/NehanAhmed/forge-agent.git"
+  },
+  "author": "Nehan Ahmed",
+  "files": [
+    "dist",
+    "README.MD",
+    "LICENSE"
+  ],
+  "type": "module",
+  "dependencies": {
+    "@openrouter/agent": "^0.11.0",
+    "dotenv": "^17.4.2",
+    "ink": "^7.1.1",
+    "ink-big-text": "^2.0.0",
+    "ink-gradient": "^4.0.1",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "react": "^19.2.8",
+    "tsx": "^4.23.12",
+    "typescript": "^7.0.2",
+    "zod": "^4.6.5"
+  },
+  "devDependencies": {
+    "@types/node": "^26.2.0",
+    "@types/react": "^19.2.18"
+  }
+}