@kolisachint/hoocode-agent-core 0.4.47 → 0.4.49

package/dist/index.d.ts

@@ -16,5 +16,7 @@ export * from "./harness/types.js";
 export * from "./harness/utils/shell-output.js";
 export * from "./harness/utils/truncate.js";
 export * from "./proxy.js";
+export * from "./tools/default-tools.js";
+export * from "./tools/mcp-tools.js";
 export * from "./types.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAE3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EACN,8BAA8B,EAC9B,qBAAqB,EACrB,oBAAoB,GACpB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACN,sBAAsB,EACtB,OAAO,EACP,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GACb,MAAM,oCAAoC,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAE5C,cAAc,YAAY,CAAC;AAE3B,cAAc,YAAY,CAAC","sourcesContent":["// Core Agent\nexport * from \"./agent.js\";\n// Loop functions\nexport * from \"./agent-loop.js\";\nexport * from \"./harness/agent-harness.js\";\nexport {\n\tcollectEntriesForBranchSummary,\n\tgenerateBranchSummary,\n\tprepareBranchEntries,\n} from \"./harness/compaction/branch-summarization.js\";\nexport {\n\tcalculateContextTokens,\n\tcompact,\n\tDEFAULT_COMPACTION_SETTINGS,\n\testimateContextTokens,\n\testimateTokens,\n\tfindCutPoint,\n\tfindTurnStartIndex,\n\tgenerateSummary,\n\tgetLastAssistantUsage,\n\tprepareCompaction,\n\tserializeConversation,\n\tshouldCompact,\n} from \"./harness/compaction/compaction.js\";\nexport * from \"./harness/execution-env.js\";\nexport * from \"./harness/messages.js\";\nexport * from \"./harness/prompt-templates.js\";\nexport * from \"./harness/session/repo/jsonl.js\";\nexport * from \"./harness/session/repo/memory.js\";\nexport * from \"./harness/session/repo/shared.js\";\nexport * from \"./harness/session/session.js\";\nexport * from \"./harness/skills.js\";\nexport * from \"./harness/system-prompt.js\";\n// Harness\nexport * from \"./harness/types.js\";\nexport * from \"./harness/utils/shell-output.js\";\nexport * from \"./harness/utils/truncate.js\";\n// Proxy utilities\nexport * from \"./proxy.js\";\n// Types\nexport * from \"./types.js\";\n"]}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAE3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EACN,8BAA8B,EAC9B,qBAAqB,EACrB,oBAAoB,GACpB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACN,sBAAsB,EACtB,OAAO,EACP,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GACb,MAAM,oCAAoC,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAE5C,cAAc,YAAY,CAAC;AAE3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AAErC,cAAc,YAAY,CAAC","sourcesContent":["// Core Agent\nexport * from \"./agent.js\";\n// Loop functions\nexport * from \"./agent-loop.js\";\nexport * from \"./harness/agent-harness.js\";\nexport {\n\tcollectEntriesForBranchSummary,\n\tgenerateBranchSummary,\n\tprepareBranchEntries,\n} from \"./harness/compaction/branch-summarization.js\";\nexport {\n\tcalculateContextTokens,\n\tcompact,\n\tDEFAULT_COMPACTION_SETTINGS,\n\testimateContextTokens,\n\testimateTokens,\n\tfindCutPoint,\n\tfindTurnStartIndex,\n\tgenerateSummary,\n\tgetLastAssistantUsage,\n\tprepareCompaction,\n\tserializeConversation,\n\tshouldCompact,\n} from \"./harness/compaction/compaction.js\";\nexport * from \"./harness/execution-env.js\";\nexport * from \"./harness/messages.js\";\nexport * from \"./harness/prompt-templates.js\";\nexport * from \"./harness/session/repo/jsonl.js\";\nexport * from \"./harness/session/repo/memory.js\";\nexport * from \"./harness/session/repo/shared.js\";\nexport * from \"./harness/session/session.js\";\nexport * from \"./harness/skills.js\";\nexport * from \"./harness/system-prompt.js\";\n// Harness\nexport * from \"./harness/types.js\";\nexport * from \"./harness/utils/shell-output.js\";\nexport * from \"./harness/utils/truncate.js\";\n// Proxy utilities\nexport * from \"./proxy.js\";\n// Headless tool bundles\nexport * from \"./tools/default-tools.js\";\nexport * from \"./tools/mcp-tools.js\";\n// Types\nexport * from \"./types.js\";\n"]}

package/dist/index.js

@@ -20,6 +20,9 @@ export * from "./harness/utils/shell-output.js";
 export * from "./harness/utils/truncate.js";
 // Proxy utilities
 export * from "./proxy.js";
+// Headless tool bundles
+export * from "./tools/default-tools.js";
+export * from "./tools/mcp-tools.js";
 // Types
 export * from "./types.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,cAAc,YAAY,CAAC;AAC3B,iBAAiB;AACjB,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EACN,8BAA8B,EAC9B,qBAAqB,EACrB,oBAAoB,GACpB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACN,sBAAsB,EACtB,OAAO,EACP,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GACb,MAAM,oCAAoC,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,UAAU;AACV,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,kBAAkB;AAClB,cAAc,YAAY,CAAC;AAC3B,QAAQ;AACR,cAAc,YAAY,CAAC","sourcesContent":["// Core Agent\nexport * from \"./agent.js\";\n// Loop functions\nexport * from \"./agent-loop.js\";\nexport * from \"./harness/agent-harness.js\";\nexport {\n\tcollectEntriesForBranchSummary,\n\tgenerateBranchSummary,\n\tprepareBranchEntries,\n} from \"./harness/compaction/branch-summarization.js\";\nexport {\n\tcalculateContextTokens,\n\tcompact,\n\tDEFAULT_COMPACTION_SETTINGS,\n\testimateContextTokens,\n\testimateTokens,\n\tfindCutPoint,\n\tfindTurnStartIndex,\n\tgenerateSummary,\n\tgetLastAssistantUsage,\n\tprepareCompaction,\n\tserializeConversation,\n\tshouldCompact,\n} from \"./harness/compaction/compaction.js\";\nexport * from \"./harness/execution-env.js\";\nexport * from \"./harness/messages.js\";\nexport * from \"./harness/prompt-templates.js\";\nexport * from \"./harness/session/repo/jsonl.js\";\nexport * from \"./harness/session/repo/memory.js\";\nexport * from \"./harness/session/repo/shared.js\";\nexport * from \"./harness/session/session.js\";\nexport * from \"./harness/skills.js\";\nexport * from \"./harness/system-prompt.js\";\n// Harness\nexport * from \"./harness/types.js\";\nexport * from \"./harness/utils/shell-output.js\";\nexport * from \"./harness/utils/truncate.js\";\n// Proxy utilities\nexport * from \"./proxy.js\";\n// Types\nexport * from \"./types.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,cAAc,YAAY,CAAC;AAC3B,iBAAiB;AACjB,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EACN,8BAA8B,EAC9B,qBAAqB,EACrB,oBAAoB,GACpB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACN,sBAAsB,EACtB,OAAO,EACP,2BAA2B,EAC3B,qBAAqB,EACrB,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GACb,MAAM,oCAAoC,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,UAAU;AACV,cAAc,oBAAoB,CAAC;AACnC,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,kBAAkB;AAClB,cAAc,YAAY,CAAC;AAC3B,wBAAwB;AACxB,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,QAAQ;AACR,cAAc,YAAY,CAAC","sourcesContent":["// Core Agent\nexport * from \"./agent.js\";\n// Loop functions\nexport * from \"./agent-loop.js\";\nexport * from \"./harness/agent-harness.js\";\nexport {\n\tcollectEntriesForBranchSummary,\n\tgenerateBranchSummary,\n\tprepareBranchEntries,\n} from \"./harness/compaction/branch-summarization.js\";\nexport {\n\tcalculateContextTokens,\n\tcompact,\n\tDEFAULT_COMPACTION_SETTINGS,\n\testimateContextTokens,\n\testimateTokens,\n\tfindCutPoint,\n\tfindTurnStartIndex,\n\tgenerateSummary,\n\tgetLastAssistantUsage,\n\tprepareCompaction,\n\tserializeConversation,\n\tshouldCompact,\n} from \"./harness/compaction/compaction.js\";\nexport * from \"./harness/execution-env.js\";\nexport * from \"./harness/messages.js\";\nexport * from \"./harness/prompt-templates.js\";\nexport * from \"./harness/session/repo/jsonl.js\";\nexport * from \"./harness/session/repo/memory.js\";\nexport * from \"./harness/session/repo/shared.js\";\nexport * from \"./harness/session/session.js\";\nexport * from \"./harness/skills.js\";\nexport * from \"./harness/system-prompt.js\";\n// Harness\nexport * from \"./harness/types.js\";\nexport * from \"./harness/utils/shell-output.js\";\nexport * from \"./harness/utils/truncate.js\";\n// Proxy utilities\nexport * from \"./proxy.js\";\n// Headless tool bundles\nexport * from \"./tools/default-tools.js\";\nexport * from \"./tools/mcp-tools.js\";\n// Types\nexport * from \"./types.js\";\n"]}

package/dist/tools/default-tools.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Headless default tool bundle: the same built-in tools the hoocode CLI
+ * registers (bash/read/edit/write/grep/find/ls), implemented without any
+ * CLI or TUI dependency so they can run in a separate process (for example
+ * a hooteams worker). The CLI keeps its own richer implementations with
+ * interactive rendering; these share the tool names and parameter contracts.
+ *
+ * No singletons, no top-level side effects: every call to getDefaultTools()
+ * builds a fresh bundle bound to the given cwd.
+ */
+import type { AgentTool } from "../types.js";
+export interface DefaultToolsOptions {
+    /** Working directory the tools operate in. Defaults to process.cwd(). */
+    cwd?: string;
+}
+/** Convert a glob pattern to a regular expression over `/`-separated paths. */
+export declare function globToRegExp(pattern: string): RegExp;
+/**
+ * Build the default headless tool bundle (bash/read/edit/write/grep/find/ls)
+ * bound to the given working directory.
+ *
+ * The CLI's Task tool is intentionally not part of this bundle: it requires
+ * the CLI's subagent runtime (agent registry, subagent pool, session
+ * services), which does not exist in a standalone process.
+ */
+export declare function getDefaultTools(opts?: DefaultToolsOptions): AgentTool<any>[];
+//# sourceMappingURL=default-tools.d.ts.map

package/dist/tools/default-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-tools.d.ts","sourceRoot":"","sources":["../../src/tools/default-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAgBH,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAC;AAE9D,MAAM,WAAW,mBAAmB;IACnC,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAwMD,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA0BpD;AA+ND;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAY5E","sourcesContent":["/**\n * Headless default tool bundle: the same built-in tools the hoocode CLI\n * registers (bash/read/edit/write/grep/find/ls), implemented without any\n * CLI or TUI dependency so they can run in a separate process (for example\n * a hooteams worker). The CLI keeps its own richer implementations with\n * interactive rendering; these share the tool names and parameter contracts.\n *\n * No singletons, no top-level side effects: every call to getDefaultTools()\n * builds a fresh bundle bound to the given cwd.\n */\n\nimport { readFile } from \"node:fs/promises\";\nimport { isAbsolute, join, relative, resolve } from \"node:path\";\nimport ignore from \"ignore\";\nimport { type Static, Type } from \"typebox\";\nimport { NodeExecutionEnv } from \"../harness/env/nodejs.js\";\nimport { FileError } from \"../harness/types.js\";\nimport {\n\tDEFAULT_MAX_BYTES,\n\tDEFAULT_MAX_LINES,\n\tformatSize,\n\ttruncateHead,\n\ttruncateLine,\n\ttruncateTail,\n} from \"../harness/utils/truncate.js\";\nimport type { AgentTool, AgentToolResult } from \"../types.js\";\n\nexport interface DefaultToolsOptions {\n\t/** Working directory the tools operate in. Defaults to process.cwd(). */\n\tcwd?: string;\n}\n\nfunction textResult(text: string): AgentToolResult<undefined> {\n\treturn { content: [{ type: \"text\", text }], details: undefined };\n}\n\nfunction resolveToCwd(cwd: string, path: string): string {\n\treturn isAbsolute(path) ? path : resolve(cwd, path);\n}\n\n// ---------------------------------------------------------------------------\n// bash\n// ---------------------------------------------------------------------------\n\nconst bashSchema = Type.Object({\n\tcommand: Type.String({ description: \"Bash command to execute\" }),\n\ttimeout: Type.Optional(Type.Number({ description: \"Timeout in seconds (optional, no default timeout)\" })),\n});\n\nfunction createBashTool(env: NodeExecutionEnv): AgentTool<typeof bashSchema> {\n\treturn {\n\t\tname: \"bash\",\n\t\tlabel: \"bash\",\n\t\tdescription: `Execute a bash command in the current working directory. Returns stdout and stderr. Output is truncated to last ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). Optionally provide a timeout in seconds.`,\n\t\tparameters: bashSchema,\n\t\texecute: async (_toolCallId, params: Static<typeof bashSchema>, signal) => {\n\t\t\tlet combined = \"\";\n\t\t\tlet exitCode: number;\n\t\t\ttry {\n\t\t\t\tconst result = await env.exec(params.command, {\n\t\t\t\t\ttimeout: params.timeout,\n\t\t\t\t\tsignal,\n\t\t\t\t\tonStdout: (chunk) => {\n\t\t\t\t\t\tcombined += chunk;\n\t\t\t\t\t},\n\t\t\t\t\tonStderr: (chunk) => {\n\t\t\t\t\t\tcombined += chunk;\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t\texitCode = result.exitCode;\n\t\t\t} catch (error) {\n\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\t\tif (message.startsWith(\"timeout:\")) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`Command timed out after ${params.timeout}s${combined ? `\\nOutput so far:\\n${combined}` : \"\"}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tconst truncation = truncateTail(combined);\n\t\t\tlet text = truncation.content;\n\t\t\tif (truncation.truncated) {\n\t\t\t\ttext = `[Output truncated: showing last ${truncation.outputLines} of ${truncation.totalLines} lines (${formatSize(truncation.totalBytes)})]\\n${text}`;\n\t\t\t}\n\t\t\tif (exitCode !== 0) {\n\t\t\t\ttext = text.length > 0 ? `${text}\\nExit code: ${exitCode}` : `Exit code: ${exitCode}`;\n\t\t\t}\n\t\t\treturn textResult(text.length > 0 ? text : \"(no output)\");\n\t\t},\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// read\n// ---------------------------------------------------------------------------\n\nconst readSchema = Type.Object({\n\tpath: Type.String({ description: \"Path to the file to read (relative or absolute)\" }),\n\toffset: Type.Optional(Type.Number({ description: \"Line number to start reading from (1-indexed)\" })),\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of lines to read\" })),\n});\n\nfunction createReadTool(env: NodeExecutionEnv): AgentTool<typeof readSchema> {\n\treturn {\n\t\tname: \"read\",\n\t\tlabel: \"read\",\n\t\tdescription: `Read the contents of a text file. Output is truncated to ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). Use offset/limit for large files. When you need the full file, continue with offset until complete.`,\n\t\tparameters: readSchema,\n\t\texecute: async (_toolCallId, params: Static<typeof readSchema>) => {\n\t\t\tconst content = await env.readTextFile(params.path);\n\t\t\tlet lines = content.split(\"\\n\");\n\t\t\tconst totalLines = lines.length;\n\t\t\tconst offset = params.offset !== undefined ? Math.max(1, Math.floor(params.offset)) : 1;\n\t\t\tif (offset > totalLines) {\n\t\t\t\tthrow new Error(`Offset ${offset} is past the end of the file (${totalLines} lines)`);\n\t\t\t}\n\t\t\tlines = lines.slice(offset - 1);\n\t\t\tif (params.limit !== undefined) {\n\t\t\t\tlines = lines.slice(0, Math.max(0, Math.floor(params.limit)));\n\t\t\t}\n\t\t\tconst truncation = truncateHead(lines.join(\"\\n\"));\n\t\t\tlet text = truncation.content;\n\t\t\tif (truncation.truncated) {\n\t\t\t\tconst lastShown = offset - 1 + truncation.outputLines;\n\t\t\t\ttext = `${text}\\n[Truncated: showing lines ${offset}-${lastShown} of ${totalLines}. Continue with offset=${lastShown + 1}]`;\n\t\t\t}\n\t\t\treturn textResult(text);\n\t\t},\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// edit\n// ---------------------------------------------------------------------------\n\nconst replaceEditSchema = Type.Object(\n\t{\n\t\toldText: Type.String({\n\t\t\tdescription:\n\t\t\t\t\"Exact text for one targeted replacement. It must be unique in the original file and must not overlap with any other edits[].oldText in the same call.\",\n\t\t}),\n\t\tnewText: Type.String({ description: \"Replacement text for this targeted edit.\" }),\n\t},\n\t{ additionalProperties: false },\n);\n\nconst editSchema = Type.Object(\n\t{\n\t\tpath: Type.String({ description: \"Path to the file to edit (relative or absolute)\" }),\n\t\tedits: Type.Array(replaceEditSchema, {\n\t\t\tdescription:\n\t\t\t\t\"One or more targeted replacements. Each edit is matched against the original file, not incrementally. Do not include overlapping or nested edits.\",\n\t\t}),\n\t},\n\t{ additionalProperties: false },\n);\n\nfunction countOccurrences(haystack: string, needle: string): number {\n\tif (needle.length === 0) return 0;\n\tlet count = 0;\n\tlet index = haystack.indexOf(needle);\n\twhile (index !== -1) {\n\t\tcount++;\n\t\tindex = haystack.indexOf(needle, index + needle.length);\n\t}\n\treturn count;\n}\n\nfunction createEditTool(env: NodeExecutionEnv): AgentTool<typeof editSchema> {\n\treturn {\n\t\tname: \"edit\",\n\t\tlabel: \"edit\",\n\t\tdescription:\n\t\t\t\"Edit a file by replacing exact text. Each edit's oldText must appear exactly once in the file. Provide multiple edits to make several targeted replacements in one call.\",\n\t\tparameters: editSchema,\n\t\texecute: async (_toolCallId, params: Static<typeof editSchema>) => {\n\t\t\tconst original = await env.readTextFile(params.path);\n\t\t\tif (params.edits.length === 0) {\n\t\t\t\tthrow new Error(\"No edits provided\");\n\t\t\t}\n\t\t\tlet content = original;\n\t\t\tfor (const [index, edit] of params.edits.entries()) {\n\t\t\t\tconst occurrences = countOccurrences(original, edit.oldText);\n\t\t\t\tif (occurrences === 0) {\n\t\t\t\t\tthrow new Error(`edits[${index}].oldText not found in ${params.path}`);\n\t\t\t\t}\n\t\t\t\tif (occurrences > 1) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`edits[${index}].oldText matches ${occurrences} locations in ${params.path}; add surrounding context to make it unique`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tif (!content.includes(edit.oldText)) {\n\t\t\t\t\tthrow new Error(`edits[${index}].oldText overlaps with an earlier edit in the same call`);\n\t\t\t\t}\n\t\t\t\tcontent = content.replace(edit.oldText, edit.newText);\n\t\t\t}\n\t\t\tawait env.writeFile(params.path, content);\n\t\t\treturn textResult(\n\t\t\t\t`Applied ${params.edits.length} edit${params.edits.length === 1 ? \"\" : \"s\"} to ${params.path}`,\n\t\t\t);\n\t\t},\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// write\n// ---------------------------------------------------------------------------\n\nconst writeSchema = Type.Object({\n\tpath: Type.String({ description: \"Path to the file to write (relative or absolute)\" }),\n\tcontent: Type.String({ description: \"Content to write to the file\" }),\n});\n\nfunction createWriteTool(env: NodeExecutionEnv): AgentTool<typeof writeSchema> {\n\treturn {\n\t\tname: \"write\",\n\t\tlabel: \"write\",\n\t\tdescription: \"Write content to a file, creating parent directories as needed. Overwrites existing files.\",\n\t\tparameters: writeSchema,\n\t\texecute: async (_toolCallId, params: Static<typeof writeSchema>) => {\n\t\t\tawait env.writeFile(params.path, params.content);\n\t\t\treturn textResult(`Wrote ${formatSize(Buffer.byteLength(params.content, \"utf-8\"))} to ${params.path}`);\n\t\t},\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// shared file walking for grep/find\n// ---------------------------------------------------------------------------\n\n/** Convert a glob pattern to a regular expression over `/`-separated paths. */\nexport function globToRegExp(pattern: string): RegExp {\n\tlet regex = \"\";\n\tfor (let i = 0; i < pattern.length; i++) {\n\t\tconst char = pattern[i];\n\t\tif (char === \"*\") {\n\t\t\tif (pattern[i + 1] === \"*\") {\n\t\t\t\t// `**/` and `**` cross directory boundaries\n\t\t\t\tif (pattern[i + 2] === \"/\") {\n\t\t\t\t\tregex += \"(?:[^/]+/)*\";\n\t\t\t\t\ti += 2;\n\t\t\t\t} else {\n\t\t\t\t\tregex += \".*\";\n\t\t\t\t\ti += 1;\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tregex += \"[^/]*\";\n\t\t\t}\n\t\t} else if (char === \"?\") {\n\t\t\tregex += \"[^/]\";\n\t\t} else if (\"\\\\^$.|+()[]{}\".includes(char)) {\n\t\t\tregex += `\\\\${char}`;\n\t\t} else {\n\t\t\tregex += char;\n\t\t}\n\t}\n\treturn new RegExp(`^${regex}$`);\n}\n\n/** Match a relative path against a glob; patterns without `/` match the basename at any depth. */\nfunction matchGlob(relPath: string, pattern: string): boolean {\n\tconst normalized = relPath.split(\"\\\\\").join(\"/\");\n\tif (!pattern.includes(\"/\")) {\n\t\tconst base = normalized.split(\"/\").pop() ?? normalized;\n\t\treturn globToRegExp(pattern).test(base);\n\t}\n\treturn globToRegExp(pattern).test(normalized);\n}\n\nconst ALWAYS_IGNORED = new Set([\".git\", \"node_modules\"]);\n\n/**\n * Walk files under root depth-first, honoring the root .gitignore (nested\n * .gitignore files are not consulted) and always skipping .git/node_modules.\n * Yields paths relative to root with `/` separators.\n */\nasync function collectFiles(env: NodeExecutionEnv, root: string, limit: number): Promise<string[]> {\n\tconst ig = ignore();\n\ttry {\n\t\tig.add(await readFile(join(root, \".gitignore\"), \"utf-8\"));\n\t} catch {\n\t\t// no .gitignore at the search root\n\t}\n\tconst results: string[] = [];\n\tconst stack: string[] = [\"\"];\n\twhile (stack.length > 0 && results.length < limit) {\n\t\tconst dir = stack.pop()!;\n\t\tlet entries: Awaited<ReturnType<NodeExecutionEnv[\"listDir\"]>>;\n\t\ttry {\n\t\t\tentries = await env.listDir(dir === \"\" ? root : join(root, dir));\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t\tentries.sort((a, b) => a.name.localeCompare(b.name));\n\t\tfor (const entry of entries) {\n\t\t\tif (ALWAYS_IGNORED.has(entry.name)) continue;\n\t\t\tconst relPath = dir === \"\" ? entry.name : `${dir}/${entry.name}`;\n\t\t\tif (entry.kind === \"directory\") {\n\t\t\t\tif (ig.ignores(`${relPath}/`)) continue;\n\t\t\t\tstack.push(relPath);\n\t\t\t} else if (entry.kind === \"file\") {\n\t\t\t\tif (ig.ignores(relPath)) continue;\n\t\t\t\tresults.push(relPath);\n\t\t\t\tif (results.length >= limit) break;\n\t\t\t}\n\t\t}\n\t}\n\treturn results;\n}\n\n// ---------------------------------------------------------------------------\n// grep\n// ---------------------------------------------------------------------------\n\nconst grepSchema = Type.Object({\n\tpattern: Type.String({ description: \"Search pattern (regex or literal string)\" }),\n\tpath: Type.Optional(Type.String({ description: \"Directory or file to search (default: current directory)\" })),\n\tglob: Type.Optional(Type.String({ description: \"Filter files by glob pattern, e.g. '*.ts' or '**/*.spec.ts'\" })),\n\tignoreCase: Type.Optional(Type.Boolean({ description: \"Case-insensitive search (default: false)\" })),\n\tliteral: Type.Optional(\n\t\tType.Boolean({ description: \"Treat pattern as literal string instead of regex (default: false)\" }),\n\t),\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of matches to return (default: 100)\" })),\n});\n\nconst GREP_DEFAULT_LIMIT = 100;\nconst GREP_FILE_SCAN_LIMIT = 50_000;\n\nfunction escapeRegExp(text: string): string {\n\treturn text.replace(/[\\\\^$.|?*+()[\\]{}]/g, \"\\\\$&\");\n}\n\nfunction looksBinary(content: string): boolean {\n\treturn content.includes(\"\\0\");\n}\n\nfunction createGrepTool(env: NodeExecutionEnv, cwd: string): AgentTool<typeof grepSchema> {\n\treturn {\n\t\tname: \"grep\",\n\t\tlabel: \"grep\",\n\t\tdescription: `Search file contents for a pattern. Returns matching lines with file paths and line numbers. Respects the root .gitignore. Output is truncated to ${GREP_DEFAULT_LIMIT} matches by default.`,\n\t\tparameters: grepSchema,\n\t\texecute: async (_toolCallId, params: Static<typeof grepSchema>, signal) => {\n\t\t\tconst source = params.literal ? escapeRegExp(params.pattern) : params.pattern;\n\t\t\tconst regex = new RegExp(source, params.ignoreCase ? \"i\" : \"\");\n\t\t\tconst limit = params.limit ?? GREP_DEFAULT_LIMIT;\n\t\t\tconst searchRoot = resolveToCwd(cwd, params.path ?? \".\");\n\n\t\t\tconst rootInfo = await env.fileInfo(searchRoot);\n\t\t\tconst files =\n\t\t\t\trootInfo.kind === \"file\"\n\t\t\t\t\t? [relative(cwd, searchRoot).split(\"\\\\\").join(\"/\") || rootInfo.name]\n\t\t\t\t\t: await collectFiles(env, searchRoot, GREP_FILE_SCAN_LIMIT);\n\n\t\t\tconst matches: string[] = [];\n\t\t\tlet limitReached = false;\n\t\t\touter: for (const file of files) {\n\t\t\t\tif (signal?.aborted) throw new Error(\"aborted\");\n\t\t\t\tif (params.glob && !matchGlob(file, params.glob)) continue;\n\t\t\t\tconst absolute = rootInfo.kind === \"file\" ? searchRoot : join(searchRoot, file);\n\t\t\t\tlet content: string;\n\t\t\t\ttry {\n\t\t\t\t\tcontent = await env.readTextFile(absolute);\n\t\t\t\t} catch {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tif (looksBinary(content)) continue;\n\t\t\t\tconst displayPath = rootInfo.kind === \"file\" ? file : relative(cwd, absolute).split(\"\\\\\").join(\"/\");\n\t\t\t\tconst lines = content.split(\"\\n\");\n\t\t\t\tfor (let i = 0; i < lines.length; i++) {\n\t\t\t\t\tif (!regex.test(lines[i])) continue;\n\t\t\t\t\tmatches.push(`${displayPath}:${i + 1}: ${truncateLine(lines[i]).text}`);\n\t\t\t\t\tif (matches.length >= limit) {\n\t\t\t\t\t\tlimitReached = true;\n\t\t\t\t\t\tbreak outer;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (matches.length === 0) {\n\t\t\t\treturn textResult(\"No matches found\");\n\t\t\t}\n\t\t\tconst truncation = truncateHead(matches.join(\"\\n\"));\n\t\t\tlet text = truncation.content;\n\t\t\tif (limitReached) {\n\t\t\t\ttext = `${text}\\n[Match limit of ${limit} reached; refine the pattern or raise limit]`;\n\t\t\t} else if (truncation.truncated) {\n\t\t\t\ttext = `${text}\\n[Output truncated at ${formatSize(truncation.maxBytes)}]`;\n\t\t\t}\n\t\t\treturn textResult(text);\n\t\t},\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// find\n// ---------------------------------------------------------------------------\n\nconst findSchema = Type.Object({\n\tpattern: Type.String({\n\t\tdescription: \"Glob pattern to match files, e.g. '*.ts', '**/*.json', or 'src/**/*.spec.ts'\",\n\t}),\n\tpath: Type.Optional(Type.String({ description: \"Directory to search in (default: current directory)\" })),\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of results (default: 1000)\" })),\n});\n\nconst FIND_DEFAULT_LIMIT = 1000;\n\nfunction createFindTool(env: NodeExecutionEnv, cwd: string): AgentTool<typeof findSchema> {\n\treturn {\n\t\tname: \"find\",\n\t\tlabel: \"find\",\n\t\tdescription: `Search for files by glob pattern. Returns matching file paths relative to the search directory. Respects the root .gitignore. Output is truncated to ${FIND_DEFAULT_LIMIT} results by default.`,\n\t\tparameters: findSchema,\n\t\texecute: async (_toolCallId, params: Static<typeof findSchema>) => {\n\t\t\tconst limit = params.limit ?? FIND_DEFAULT_LIMIT;\n\t\t\tconst searchRoot = resolveToCwd(cwd, params.path ?? \".\");\n\t\t\tconst files = await collectFiles(env, searchRoot, GREP_FILE_SCAN_LIMIT);\n\t\t\tconst matched: string[] = [];\n\t\t\tlet limitReached = false;\n\t\t\tfor (const file of files) {\n\t\t\t\tif (!matchGlob(file, params.pattern)) continue;\n\t\t\t\tmatched.push(file);\n\t\t\t\tif (matched.length >= limit) {\n\t\t\t\t\tlimitReached = true;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (matched.length === 0) {\n\t\t\t\treturn textResult(\"No files found\");\n\t\t\t}\n\t\t\tlet text = matched.join(\"\\n\");\n\t\t\tif (limitReached) {\n\t\t\t\ttext = `${text}\\n[Result limit of ${limit} reached]`;\n\t\t\t}\n\t\t\treturn textResult(text);\n\t\t},\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// ls\n// ---------------------------------------------------------------------------\n\nconst lsSchema = Type.Object({\n\tpath: Type.Optional(Type.String({ description: \"Directory to list (default: current directory)\" })),\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of entries to return (default: 500)\" })),\n});\n\nconst LS_DEFAULT_LIMIT = 500;\n\nfunction createLsTool(env: NodeExecutionEnv, cwd: string): AgentTool<typeof lsSchema> {\n\treturn {\n\t\tname: \"ls\",\n\t\tlabel: \"ls\",\n\t\tdescription: `List directory contents. Returns entries sorted alphabetically, with '/' suffix for directories. Includes dotfiles. Output is truncated to ${LS_DEFAULT_LIMIT} entries by default.`,\n\t\tparameters: lsSchema,\n\t\texecute: async (_toolCallId, params: Static<typeof lsSchema>) => {\n\t\t\tconst target = resolveToCwd(cwd, params.path ?? \".\");\n\t\t\tconst limit = params.limit ?? LS_DEFAULT_LIMIT;\n\t\t\tconst info = await env.fileInfo(target);\n\t\t\tif (info.kind !== \"directory\") {\n\t\t\t\tthrow new FileError(\"not_directory\", `Not a directory: ${target}`, target);\n\t\t\t}\n\t\t\tconst entries = await env.listDir(target);\n\t\t\tentries.sort((a, b) => a.name.localeCompare(b.name));\n\t\t\tconst shown = entries.slice(0, limit);\n\t\t\tlet text = shown.map((entry) => (entry.kind === \"directory\" ? `${entry.name}/` : entry.name)).join(\"\\n\");\n\t\t\tif (entries.length > limit) {\n\t\t\t\ttext = `${text}\\n[Entry limit of ${limit} reached; ${entries.length - limit} more entries]`;\n\t\t\t}\n\t\t\treturn textResult(text.length > 0 ? text : \"(empty directory)\");\n\t\t},\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// bundle\n// ---------------------------------------------------------------------------\n\n/**\n * Build the default headless tool bundle (bash/read/edit/write/grep/find/ls)\n * bound to the given working directory.\n *\n * The CLI's Task tool is intentionally not part of this bundle: it requires\n * the CLI's subagent runtime (agent registry, subagent pool, session\n * services), which does not exist in a standalone process.\n */\nexport function getDefaultTools(opts?: DefaultToolsOptions): AgentTool<any>[] {\n\tconst cwd = resolve(opts?.cwd ?? process.cwd());\n\tconst env = new NodeExecutionEnv({ cwd });\n\treturn [\n\t\tcreateBashTool(env),\n\t\tcreateReadTool(env),\n\t\tcreateEditTool(env),\n\t\tcreateWriteTool(env),\n\t\tcreateGrepTool(env, cwd),\n\t\tcreateFindTool(env, cwd),\n\t\tcreateLsTool(env, cwd),\n\t];\n}\n"]}

package/dist/tools/default-tools.js

@@ -0,0 +1,451 @@
+/**
+ * Headless default tool bundle: the same built-in tools the hoocode CLI
+ * registers (bash/read/edit/write/grep/find/ls), implemented without any
+ * CLI or TUI dependency so they can run in a separate process (for example
+ * a hooteams worker). The CLI keeps its own richer implementations with
+ * interactive rendering; these share the tool names and parameter contracts.
+ *
+ * No singletons, no top-level side effects: every call to getDefaultTools()
+ * builds a fresh bundle bound to the given cwd.
+ */
+import { readFile } from "node:fs/promises";
+import { isAbsolute, join, relative, resolve } from "node:path";
+import ignore from "ignore";
+import { Type } from "typebox";
+import { NodeExecutionEnv } from "../harness/env/nodejs.js";
+import { FileError } from "../harness/types.js";
+import { DEFAULT_MAX_BYTES, DEFAULT_MAX_LINES, formatSize, truncateHead, truncateLine, truncateTail, } from "../harness/utils/truncate.js";
+function textResult(text) {
+    return { content: [{ type: "text", text }], details: undefined };
+}
+function resolveToCwd(cwd, path) {
+    return isAbsolute(path) ? path : resolve(cwd, path);
+}
+// ---------------------------------------------------------------------------
+// bash
+// ---------------------------------------------------------------------------
+const bashSchema = Type.Object({
+    command: Type.String({ description: "Bash command to execute" }),
+    timeout: Type.Optional(Type.Number({ description: "Timeout in seconds (optional, no default timeout)" })),
+});
+function createBashTool(env) {
+    return {
+        name: "bash",
+        label: "bash",
+        description: `Execute a bash command in the current working directory. Returns stdout and stderr. Output is truncated to last ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). Optionally provide a timeout in seconds.`,
+        parameters: bashSchema,
+        execute: async (_toolCallId, params, signal) => {
+            let combined = "";
+            let exitCode;
+            try {
+                const result = await env.exec(params.command, {
+                    timeout: params.timeout,
+                    signal,
+                    onStdout: (chunk) => {
+                        combined += chunk;
+                    },
+                    onStderr: (chunk) => {
+                        combined += chunk;
+                    },
+                });
+                exitCode = result.exitCode;
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                if (message.startsWith("timeout:")) {
+                    throw new Error(`Command timed out after ${params.timeout}s${combined ? `\nOutput so far:\n${combined}` : ""}`);
+                }
+                throw error;
+            }
+            const truncation = truncateTail(combined);
+            let text = truncation.content;
+            if (truncation.truncated) {
+                text = `[Output truncated: showing last ${truncation.outputLines} of ${truncation.totalLines} lines (${formatSize(truncation.totalBytes)})]\n${text}`;
+            }
+            if (exitCode !== 0) {
+                text = text.length > 0 ? `${text}\nExit code: ${exitCode}` : `Exit code: ${exitCode}`;
+            }
+            return textResult(text.length > 0 ? text : "(no output)");
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// read
+// ---------------------------------------------------------------------------
+const readSchema = Type.Object({
+    path: Type.String({ description: "Path to the file to read (relative or absolute)" }),
+    offset: Type.Optional(Type.Number({ description: "Line number to start reading from (1-indexed)" })),
+    limit: Type.Optional(Type.Number({ description: "Maximum number of lines to read" })),
+});
+function createReadTool(env) {
+    return {
+        name: "read",
+        label: "read",
+        description: `Read the contents of a text file. Output is truncated to ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). Use offset/limit for large files. When you need the full file, continue with offset until complete.`,
+        parameters: readSchema,
+        execute: async (_toolCallId, params) => {
+            const content = await env.readTextFile(params.path);
+            let lines = content.split("\n");
+            const totalLines = lines.length;
+            const offset = params.offset !== undefined ? Math.max(1, Math.floor(params.offset)) : 1;
+            if (offset > totalLines) {
+                throw new Error(`Offset ${offset} is past the end of the file (${totalLines} lines)`);
+            }
+            lines = lines.slice(offset - 1);
+            if (params.limit !== undefined) {
+                lines = lines.slice(0, Math.max(0, Math.floor(params.limit)));
+            }
+            const truncation = truncateHead(lines.join("\n"));
+            let text = truncation.content;
+            if (truncation.truncated) {
+                const lastShown = offset - 1 + truncation.outputLines;
+                text = `${text}\n[Truncated: showing lines ${offset}-${lastShown} of ${totalLines}. Continue with offset=${lastShown + 1}]`;
+            }
+            return textResult(text);
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// edit
+// ---------------------------------------------------------------------------
+const replaceEditSchema = Type.Object({
+    oldText: Type.String({
+        description: "Exact text for one targeted replacement. It must be unique in the original file and must not overlap with any other edits[].oldText in the same call.",
+    }),
+    newText: Type.String({ description: "Replacement text for this targeted edit." }),
+}, { additionalProperties: false });
+const editSchema = Type.Object({
+    path: Type.String({ description: "Path to the file to edit (relative or absolute)" }),
+    edits: Type.Array(replaceEditSchema, {
+        description: "One or more targeted replacements. Each edit is matched against the original file, not incrementally. Do not include overlapping or nested edits.",
+    }),
+}, { additionalProperties: false });
+function countOccurrences(haystack, needle) {
+    if (needle.length === 0)
+        return 0;
+    let count = 0;
+    let index = haystack.indexOf(needle);
+    while (index !== -1) {
+        count++;
+        index = haystack.indexOf(needle, index + needle.length);
+    }
+    return count;
+}
+function createEditTool(env) {
+    return {
+        name: "edit",
+        label: "edit",
+        description: "Edit a file by replacing exact text. Each edit's oldText must appear exactly once in the file. Provide multiple edits to make several targeted replacements in one call.",
+        parameters: editSchema,
+        execute: async (_toolCallId, params) => {
+            const original = await env.readTextFile(params.path);
+            if (params.edits.length === 0) {
+                throw new Error("No edits provided");
+            }
+            let content = original;
+            for (const [index, edit] of params.edits.entries()) {
+                const occurrences = countOccurrences(original, edit.oldText);
+                if (occurrences === 0) {
+                    throw new Error(`edits[${index}].oldText not found in ${params.path}`);
+                }
+                if (occurrences > 1) {
+                    throw new Error(`edits[${index}].oldText matches ${occurrences} locations in ${params.path}; add surrounding context to make it unique`);
+                }
+                if (!content.includes(edit.oldText)) {
+                    throw new Error(`edits[${index}].oldText overlaps with an earlier edit in the same call`);
+                }
+                content = content.replace(edit.oldText, edit.newText);
+            }
+            await env.writeFile(params.path, content);
+            return textResult(`Applied ${params.edits.length} edit${params.edits.length === 1 ? "" : "s"} to ${params.path}`);
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// write
+// ---------------------------------------------------------------------------
+const writeSchema = Type.Object({
+    path: Type.String({ description: "Path to the file to write (relative or absolute)" }),
+    content: Type.String({ description: "Content to write to the file" }),
+});
+function createWriteTool(env) {
+    return {
+        name: "write",
+        label: "write",
+        description: "Write content to a file, creating parent directories as needed. Overwrites existing files.",
+        parameters: writeSchema,
+        execute: async (_toolCallId, params) => {
+            await env.writeFile(params.path, params.content);
+            return textResult(`Wrote ${formatSize(Buffer.byteLength(params.content, "utf-8"))} to ${params.path}`);
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// shared file walking for grep/find
+// ---------------------------------------------------------------------------
+/** Convert a glob pattern to a regular expression over `/`-separated paths. */
+export function globToRegExp(pattern) {
+    let regex = "";
+    for (let i = 0; i < pattern.length; i++) {
+        const char = pattern[i];
+        if (char === "*") {
+            if (pattern[i + 1] === "*") {
+                // `**/` and `**` cross directory boundaries
+                if (pattern[i + 2] === "/") {
+                    regex += "(?:[^/]+/)*";
+                    i += 2;
+                }
+                else {
+                    regex += ".*";
+                    i += 1;
+                }
+            }
+            else {
+                regex += "[^/]*";
+            }
+        }
+        else if (char === "?") {
+            regex += "[^/]";
+        }
+        else if ("\\^$.|+()[]{}".includes(char)) {
+            regex += `\\${char}`;
+        }
+        else {
+            regex += char;
+        }
+    }
+    return new RegExp(`^${regex}$`);
+}
+/** Match a relative path against a glob; patterns without `/` match the basename at any depth. */
+function matchGlob(relPath, pattern) {
+    const normalized = relPath.split("\\").join("/");
+    if (!pattern.includes("/")) {
+        const base = normalized.split("/").pop() ?? normalized;
+        return globToRegExp(pattern).test(base);
+    }
+    return globToRegExp(pattern).test(normalized);
+}
+const ALWAYS_IGNORED = new Set([".git", "node_modules"]);
+/**
+ * Walk files under root depth-first, honoring the root .gitignore (nested
+ * .gitignore files are not consulted) and always skipping .git/node_modules.
+ * Yields paths relative to root with `/` separators.
+ */
+async function collectFiles(env, root, limit) {
+    const ig = ignore();
+    try {
+        ig.add(await readFile(join(root, ".gitignore"), "utf-8"));
+    }
+    catch {
+        // no .gitignore at the search root
+    }
+    const results = [];
+    const stack = [""];
+    while (stack.length > 0 && results.length < limit) {
+        const dir = stack.pop();
+        let entries;
+        try {
+            entries = await env.listDir(dir === "" ? root : join(root, dir));
+        }
+        catch {
+            continue;
+        }
+        entries.sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of entries) {
+            if (ALWAYS_IGNORED.has(entry.name))
+                continue;
+            const relPath = dir === "" ? entry.name : `${dir}/${entry.name}`;
+            if (entry.kind === "directory") {
+                if (ig.ignores(`${relPath}/`))
+                    continue;
+                stack.push(relPath);
+            }
+            else if (entry.kind === "file") {
+                if (ig.ignores(relPath))
+                    continue;
+                results.push(relPath);
+                if (results.length >= limit)
+                    break;
+            }
+        }
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// grep
+// ---------------------------------------------------------------------------
+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' or '**/*.spec.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)" })),
+    limit: Type.Optional(Type.Number({ description: "Maximum number of matches to return (default: 100)" })),
+});
+const GREP_DEFAULT_LIMIT = 100;
+const GREP_FILE_SCAN_LIMIT = 50_000;
+function escapeRegExp(text) {
+    return text.replace(/[\\^$.|?*+()[\]{}]/g, "\\$&");
+}
+function looksBinary(content) {
+    return content.includes("\0");
+}
+function createGrepTool(env, cwd) {
+    return {
+        name: "grep",
+        label: "grep",
+        description: `Search file contents for a pattern. Returns matching lines with file paths and line numbers. Respects the root .gitignore. Output is truncated to ${GREP_DEFAULT_LIMIT} matches by default.`,
+        parameters: grepSchema,
+        execute: async (_toolCallId, params, signal) => {
+            const source = params.literal ? escapeRegExp(params.pattern) : params.pattern;
+            const regex = new RegExp(source, params.ignoreCase ? "i" : "");
+            const limit = params.limit ?? GREP_DEFAULT_LIMIT;
+            const searchRoot = resolveToCwd(cwd, params.path ?? ".");
+            const rootInfo = await env.fileInfo(searchRoot);
+            const files = rootInfo.kind === "file"
+                ? [relative(cwd, searchRoot).split("\\").join("/") || rootInfo.name]
+                : await collectFiles(env, searchRoot, GREP_FILE_SCAN_LIMIT);
+            const matches = [];
+            let limitReached = false;
+            outer: for (const file of files) {
+                if (signal?.aborted)
+                    throw new Error("aborted");
+                if (params.glob && !matchGlob(file, params.glob))
+                    continue;
+                const absolute = rootInfo.kind === "file" ? searchRoot : join(searchRoot, file);
+                let content;
+                try {
+                    content = await env.readTextFile(absolute);
+                }
+                catch {
+                    continue;
+                }
+                if (looksBinary(content))
+                    continue;
+                const displayPath = rootInfo.kind === "file" ? file : relative(cwd, absolute).split("\\").join("/");
+                const lines = content.split("\n");
+                for (let i = 0; i < lines.length; i++) {
+                    if (!regex.test(lines[i]))
+                        continue;
+                    matches.push(`${displayPath}:${i + 1}: ${truncateLine(lines[i]).text}`);
+                    if (matches.length >= limit) {
+                        limitReached = true;
+                        break outer;
+                    }
+                }
+            }
+            if (matches.length === 0) {
+                return textResult("No matches found");
+            }
+            const truncation = truncateHead(matches.join("\n"));
+            let text = truncation.content;
+            if (limitReached) {
+                text = `${text}\n[Match limit of ${limit} reached; refine the pattern or raise limit]`;
+            }
+            else if (truncation.truncated) {
+                text = `${text}\n[Output truncated at ${formatSize(truncation.maxBytes)}]`;
+            }
+            return textResult(text);
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// find
+// ---------------------------------------------------------------------------
+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 FIND_DEFAULT_LIMIT = 1000;
+function createFindTool(env, cwd) {
+    return {
+        name: "find",
+        label: "find",
+        description: `Search for files by glob pattern. Returns matching file paths relative to the search directory. Respects the root .gitignore. Output is truncated to ${FIND_DEFAULT_LIMIT} results by default.`,
+        parameters: findSchema,
+        execute: async (_toolCallId, params) => {
+            const limit = params.limit ?? FIND_DEFAULT_LIMIT;
+            const searchRoot = resolveToCwd(cwd, params.path ?? ".");
+            const files = await collectFiles(env, searchRoot, GREP_FILE_SCAN_LIMIT);
+            const matched = [];
+            let limitReached = false;
+            for (const file of files) {
+                if (!matchGlob(file, params.pattern))
+                    continue;
+                matched.push(file);
+                if (matched.length >= limit) {
+                    limitReached = true;
+                    break;
+                }
+            }
+            if (matched.length === 0) {
+                return textResult("No files found");
+            }
+            let text = matched.join("\n");
+            if (limitReached) {
+                text = `${text}\n[Result limit of ${limit} reached]`;
+            }
+            return textResult(text);
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// ls
+// ---------------------------------------------------------------------------
+const lsSchema = Type.Object({
+    path: Type.Optional(Type.String({ description: "Directory to list (default: current directory)" })),
+    limit: Type.Optional(Type.Number({ description: "Maximum number of entries to return (default: 500)" })),
+});
+const LS_DEFAULT_LIMIT = 500;
+function createLsTool(env, cwd) {
+    return {
+        name: "ls",
+        label: "ls",
+        description: `List directory contents. Returns entries sorted alphabetically, with '/' suffix for directories. Includes dotfiles. Output is truncated to ${LS_DEFAULT_LIMIT} entries by default.`,
+        parameters: lsSchema,
+        execute: async (_toolCallId, params) => {
+            const target = resolveToCwd(cwd, params.path ?? ".");
+            const limit = params.limit ?? LS_DEFAULT_LIMIT;
+            const info = await env.fileInfo(target);
+            if (info.kind !== "directory") {
+                throw new FileError("not_directory", `Not a directory: ${target}`, target);
+            }
+            const entries = await env.listDir(target);
+            entries.sort((a, b) => a.name.localeCompare(b.name));
+            const shown = entries.slice(0, limit);
+            let text = shown.map((entry) => (entry.kind === "directory" ? `${entry.name}/` : entry.name)).join("\n");
+            if (entries.length > limit) {
+                text = `${text}\n[Entry limit of ${limit} reached; ${entries.length - limit} more entries]`;
+            }
+            return textResult(text.length > 0 ? text : "(empty directory)");
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// bundle
+// ---------------------------------------------------------------------------
+/**
+ * Build the default headless tool bundle (bash/read/edit/write/grep/find/ls)
+ * bound to the given working directory.
+ *
+ * The CLI's Task tool is intentionally not part of this bundle: it requires
+ * the CLI's subagent runtime (agent registry, subagent pool, session
+ * services), which does not exist in a standalone process.
+ */
+export function getDefaultTools(opts) {
+    const cwd = resolve(opts?.cwd ?? process.cwd());
+    const env = new NodeExecutionEnv({ cwd });
+    return [
+        createBashTool(env),
+        createReadTool(env),
+        createEditTool(env),
+        createWriteTool(env),
+        createGrepTool(env, cwd),
+        createFindTool(env, cwd),
+        createLsTool(env, cwd),
+    ];
+}
+//# sourceMappingURL=default-tools.js.map

package/dist/tools/default-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-tools.js","sourceRoot":"","sources":["../../src/tools/default-tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Headless default tool bundle: the same built-in tools the hoocode CLI\n * registers (bash/read/edit/write/grep/find/ls), implemented without any\n * CLI or TUI dependency so they can run in a separate process (for example\n * a hooteams worker). The CLI keeps its own richer implementations with\n * interactive rendering; these share the tool names and parameter contracts.\n *\n * No singletons, no top-level side effects: every call to getDefaultTools()\n * builds a fresh bundle bound to the given cwd.\n */\n\nimport { readFile } from \"node:fs/promises\";\nimport { isAbsolute, join, relative, resolve } from \"node:path\";\nimport ignore from \"ignore\";\nimport { type Static, Type } from \"typebox\";\nimport { NodeExecutionEnv } from \"../harness/env/nodejs.js\";\nimport { FileError } from \"../harness/types.js\";\nimport {\n\tDEFAULT_MAX_BYTES,\n\tDEFAULT_MAX_LINES,\n\tformatSize,\n\ttruncateHead,\n\ttruncateLine,\n\ttruncateTail,\n} from \"../harness/utils/truncate.js\";\nimport type { AgentTool, AgentToolResult } from \"../types.js\";\n\nexport interface DefaultToolsOptions {\n\t/** Working directory the tools operate in. Defaults to process.cwd(). */\n\tcwd?: string;\n}\n\nfunction textResult(text: string): AgentToolResult<undefined> {\n\treturn { content: [{ type: \"text\", text }], details: undefined };\n}\n\nfunction resolveToCwd(cwd: string, path: string): string {\n\treturn isAbsolute(path) ? path : resolve(cwd, path);\n}\n\n// ---------------------------------------------------------------------------\n// bash\n// ---------------------------------------------------------------------------\n\nconst bashSchema = Type.Object({\n\tcommand: Type.String({ description: \"Bash command to execute\" }),\n\ttimeout: Type.Optional(Type.Number({ description: \"Timeout in seconds (optional, no default timeout)\" })),\n});\n\nfunction createBashTool(env: NodeExecutionEnv): AgentTool<typeof bashSchema> {\n\treturn {\n\t\tname: \"bash\",\n\t\tlabel: \"bash\",\n\t\tdescription: `Execute a bash command in the current working directory. Returns stdout and stderr. Output is truncated to last ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). Optionally provide a timeout in seconds.`,\n\t\tparameters: bashSchema,\n\t\texecute: async (_toolCallId, params: Static<typeof bashSchema>, signal) => {\n\t\t\tlet combined = \"\";\n\t\t\tlet exitCode: number;\n\t\t\ttry {\n\t\t\t\tconst result = await env.exec(params.command, {\n\t\t\t\t\ttimeout: params.timeout,\n\t\t\t\t\tsignal,\n\t\t\t\t\tonStdout: (chunk) => {\n\t\t\t\t\t\tcombined += chunk;\n\t\t\t\t\t},\n\t\t\t\t\tonStderr: (chunk) => {\n\t\t\t\t\t\tcombined += chunk;\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t\texitCode = result.exitCode;\n\t\t\t} catch (error) {\n\t\t\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\t\t\tif (message.startsWith(\"timeout:\")) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`Command timed out after ${params.timeout}s${combined ? `\\nOutput so far:\\n${combined}` : \"\"}`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tthrow error;\n\t\t\t}\n\t\t\tconst truncation = truncateTail(combined);\n\t\t\tlet text = truncation.content;\n\t\t\tif (truncation.truncated) {\n\t\t\t\ttext = `[Output truncated: showing last ${truncation.outputLines} of ${truncation.totalLines} lines (${formatSize(truncation.totalBytes)})]\\n${text}`;\n\t\t\t}\n\t\t\tif (exitCode !== 0) {\n\t\t\t\ttext = text.length > 0 ? `${text}\\nExit code: ${exitCode}` : `Exit code: ${exitCode}`;\n\t\t\t}\n\t\t\treturn textResult(text.length > 0 ? text : \"(no output)\");\n\t\t},\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// read\n// ---------------------------------------------------------------------------\n\nconst readSchema = Type.Object({\n\tpath: Type.String({ description: \"Path to the file to read (relative or absolute)\" }),\n\toffset: Type.Optional(Type.Number({ description: \"Line number to start reading from (1-indexed)\" })),\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of lines to read\" })),\n});\n\nfunction createReadTool(env: NodeExecutionEnv): AgentTool<typeof readSchema> {\n\treturn {\n\t\tname: \"read\",\n\t\tlabel: \"read\",\n\t\tdescription: `Read the contents of a text file. Output is truncated to ${DEFAULT_MAX_LINES} lines or ${DEFAULT_MAX_BYTES / 1024}KB (whichever is hit first). Use offset/limit for large files. When you need the full file, continue with offset until complete.`,\n\t\tparameters: readSchema,\n\t\texecute: async (_toolCallId, params: Static<typeof readSchema>) => {\n\t\t\tconst content = await env.readTextFile(params.path);\n\t\t\tlet lines = content.split(\"\\n\");\n\t\t\tconst totalLines = lines.length;\n\t\t\tconst offset = params.offset !== undefined ? Math.max(1, Math.floor(params.offset)) : 1;\n\t\t\tif (offset > totalLines) {\n\t\t\t\tthrow new Error(`Offset ${offset} is past the end of the file (${totalLines} lines)`);\n\t\t\t}\n\t\t\tlines = lines.slice(offset - 1);\n\t\t\tif (params.limit !== undefined) {\n\t\t\t\tlines = lines.slice(0, Math.max(0, Math.floor(params.limit)));\n\t\t\t}\n\t\t\tconst truncation = truncateHead(lines.join(\"\\n\"));\n\t\t\tlet text = truncation.content;\n\t\t\tif (truncation.truncated) {\n\t\t\t\tconst lastShown = offset - 1 + truncation.outputLines;\n\t\t\t\ttext = `${text}\\n[Truncated: showing lines ${offset}-${lastShown} of ${totalLines}. Continue with offset=${lastShown + 1}]`;\n\t\t\t}\n\t\t\treturn textResult(text);\n\t\t},\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// edit\n// ---------------------------------------------------------------------------\n\nconst replaceEditSchema = Type.Object(\n\t{\n\t\toldText: Type.String({\n\t\t\tdescription:\n\t\t\t\t\"Exact text for one targeted replacement. It must be unique in the original file and must not overlap with any other edits[].oldText in the same call.\",\n\t\t}),\n\t\tnewText: Type.String({ description: \"Replacement text for this targeted edit.\" }),\n\t},\n\t{ additionalProperties: false },\n);\n\nconst editSchema = Type.Object(\n\t{\n\t\tpath: Type.String({ description: \"Path to the file to edit (relative or absolute)\" }),\n\t\tedits: Type.Array(replaceEditSchema, {\n\t\t\tdescription:\n\t\t\t\t\"One or more targeted replacements. Each edit is matched against the original file, not incrementally. Do not include overlapping or nested edits.\",\n\t\t}),\n\t},\n\t{ additionalProperties: false },\n);\n\nfunction countOccurrences(haystack: string, needle: string): number {\n\tif (needle.length === 0) return 0;\n\tlet count = 0;\n\tlet index = haystack.indexOf(needle);\n\twhile (index !== -1) {\n\t\tcount++;\n\t\tindex = haystack.indexOf(needle, index + needle.length);\n\t}\n\treturn count;\n}\n\nfunction createEditTool(env: NodeExecutionEnv): AgentTool<typeof editSchema> {\n\treturn {\n\t\tname: \"edit\",\n\t\tlabel: \"edit\",\n\t\tdescription:\n\t\t\t\"Edit a file by replacing exact text. Each edit's oldText must appear exactly once in the file. Provide multiple edits to make several targeted replacements in one call.\",\n\t\tparameters: editSchema,\n\t\texecute: async (_toolCallId, params: Static<typeof editSchema>) => {\n\t\t\tconst original = await env.readTextFile(params.path);\n\t\t\tif (params.edits.length === 0) {\n\t\t\t\tthrow new Error(\"No edits provided\");\n\t\t\t}\n\t\t\tlet content = original;\n\t\t\tfor (const [index, edit] of params.edits.entries()) {\n\t\t\t\tconst occurrences = countOccurrences(original, edit.oldText);\n\t\t\t\tif (occurrences === 0) {\n\t\t\t\t\tthrow new Error(`edits[${index}].oldText not found in ${params.path}`);\n\t\t\t\t}\n\t\t\t\tif (occurrences > 1) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`edits[${index}].oldText matches ${occurrences} locations in ${params.path}; add surrounding context to make it unique`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tif (!content.includes(edit.oldText)) {\n\t\t\t\t\tthrow new Error(`edits[${index}].oldText overlaps with an earlier edit in the same call`);\n\t\t\t\t}\n\t\t\t\tcontent = content.replace(edit.oldText, edit.newText);\n\t\t\t}\n\t\t\tawait env.writeFile(params.path, content);\n\t\t\treturn textResult(\n\t\t\t\t`Applied ${params.edits.length} edit${params.edits.length === 1 ? \"\" : \"s\"} to ${params.path}`,\n\t\t\t);\n\t\t},\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// write\n// ---------------------------------------------------------------------------\n\nconst writeSchema = Type.Object({\n\tpath: Type.String({ description: \"Path to the file to write (relative or absolute)\" }),\n\tcontent: Type.String({ description: \"Content to write to the file\" }),\n});\n\nfunction createWriteTool(env: NodeExecutionEnv): AgentTool<typeof writeSchema> {\n\treturn {\n\t\tname: \"write\",\n\t\tlabel: \"write\",\n\t\tdescription: \"Write content to a file, creating parent directories as needed. Overwrites existing files.\",\n\t\tparameters: writeSchema,\n\t\texecute: async (_toolCallId, params: Static<typeof writeSchema>) => {\n\t\t\tawait env.writeFile(params.path, params.content);\n\t\t\treturn textResult(`Wrote ${formatSize(Buffer.byteLength(params.content, \"utf-8\"))} to ${params.path}`);\n\t\t},\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// shared file walking for grep/find\n// ---------------------------------------------------------------------------\n\n/** Convert a glob pattern to a regular expression over `/`-separated paths. */\nexport function globToRegExp(pattern: string): RegExp {\n\tlet regex = \"\";\n\tfor (let i = 0; i < pattern.length; i++) {\n\t\tconst char = pattern[i];\n\t\tif (char === \"*\") {\n\t\t\tif (pattern[i + 1] === \"*\") {\n\t\t\t\t// `**/` and `**` cross directory boundaries\n\t\t\t\tif (pattern[i + 2] === \"/\") {\n\t\t\t\t\tregex += \"(?:[^/]+/)*\";\n\t\t\t\t\ti += 2;\n\t\t\t\t} else {\n\t\t\t\t\tregex += \".*\";\n\t\t\t\t\ti += 1;\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tregex += \"[^/]*\";\n\t\t\t}\n\t\t} else if (char === \"?\") {\n\t\t\tregex += \"[^/]\";\n\t\t} else if (\"\\\\^$.|+()[]{}\".includes(char)) {\n\t\t\tregex += `\\\\${char}`;\n\t\t} else {\n\t\t\tregex += char;\n\t\t}\n\t}\n\treturn new RegExp(`^${regex}$`);\n}\n\n/** Match a relative path against a glob; patterns without `/` match the basename at any depth. */\nfunction matchGlob(relPath: string, pattern: string): boolean {\n\tconst normalized = relPath.split(\"\\\\\").join(\"/\");\n\tif (!pattern.includes(\"/\")) {\n\t\tconst base = normalized.split(\"/\").pop() ?? normalized;\n\t\treturn globToRegExp(pattern).test(base);\n\t}\n\treturn globToRegExp(pattern).test(normalized);\n}\n\nconst ALWAYS_IGNORED = new Set([\".git\", \"node_modules\"]);\n\n/**\n * Walk files under root depth-first, honoring the root .gitignore (nested\n * .gitignore files are not consulted) and always skipping .git/node_modules.\n * Yields paths relative to root with `/` separators.\n */\nasync function collectFiles(env: NodeExecutionEnv, root: string, limit: number): Promise<string[]> {\n\tconst ig = ignore();\n\ttry {\n\t\tig.add(await readFile(join(root, \".gitignore\"), \"utf-8\"));\n\t} catch {\n\t\t// no .gitignore at the search root\n\t}\n\tconst results: string[] = [];\n\tconst stack: string[] = [\"\"];\n\twhile (stack.length > 0 && results.length < limit) {\n\t\tconst dir = stack.pop()!;\n\t\tlet entries: Awaited<ReturnType<NodeExecutionEnv[\"listDir\"]>>;\n\t\ttry {\n\t\t\tentries = await env.listDir(dir === \"\" ? root : join(root, dir));\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t\tentries.sort((a, b) => a.name.localeCompare(b.name));\n\t\tfor (const entry of entries) {\n\t\t\tif (ALWAYS_IGNORED.has(entry.name)) continue;\n\t\t\tconst relPath = dir === \"\" ? entry.name : `${dir}/${entry.name}`;\n\t\t\tif (entry.kind === \"directory\") {\n\t\t\t\tif (ig.ignores(`${relPath}/`)) continue;\n\t\t\t\tstack.push(relPath);\n\t\t\t} else if (entry.kind === \"file\") {\n\t\t\t\tif (ig.ignores(relPath)) continue;\n\t\t\t\tresults.push(relPath);\n\t\t\t\tif (results.length >= limit) break;\n\t\t\t}\n\t\t}\n\t}\n\treturn results;\n}\n\n// ---------------------------------------------------------------------------\n// grep\n// ---------------------------------------------------------------------------\n\nconst grepSchema = Type.Object({\n\tpattern: Type.String({ description: \"Search pattern (regex or literal string)\" }),\n\tpath: Type.Optional(Type.String({ description: \"Directory or file to search (default: current directory)\" })),\n\tglob: Type.Optional(Type.String({ description: \"Filter files by glob pattern, e.g. '*.ts' or '**/*.spec.ts'\" })),\n\tignoreCase: Type.Optional(Type.Boolean({ description: \"Case-insensitive search (default: false)\" })),\n\tliteral: Type.Optional(\n\t\tType.Boolean({ description: \"Treat pattern as literal string instead of regex (default: false)\" }),\n\t),\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of matches to return (default: 100)\" })),\n});\n\nconst GREP_DEFAULT_LIMIT = 100;\nconst GREP_FILE_SCAN_LIMIT = 50_000;\n\nfunction escapeRegExp(text: string): string {\n\treturn text.replace(/[\\\\^$.|?*+()[\\]{}]/g, \"\\\\$&\");\n}\n\nfunction looksBinary(content: string): boolean {\n\treturn content.includes(\"\\0\");\n}\n\nfunction createGrepTool(env: NodeExecutionEnv, cwd: string): AgentTool<typeof grepSchema> {\n\treturn {\n\t\tname: \"grep\",\n\t\tlabel: \"grep\",\n\t\tdescription: `Search file contents for a pattern. Returns matching lines with file paths and line numbers. Respects the root .gitignore. Output is truncated to ${GREP_DEFAULT_LIMIT} matches by default.`,\n\t\tparameters: grepSchema,\n\t\texecute: async (_toolCallId, params: Static<typeof grepSchema>, signal) => {\n\t\t\tconst source = params.literal ? escapeRegExp(params.pattern) : params.pattern;\n\t\t\tconst regex = new RegExp(source, params.ignoreCase ? \"i\" : \"\");\n\t\t\tconst limit = params.limit ?? GREP_DEFAULT_LIMIT;\n\t\t\tconst searchRoot = resolveToCwd(cwd, params.path ?? \".\");\n\n\t\t\tconst rootInfo = await env.fileInfo(searchRoot);\n\t\t\tconst files =\n\t\t\t\trootInfo.kind === \"file\"\n\t\t\t\t\t? [relative(cwd, searchRoot).split(\"\\\\\").join(\"/\") || rootInfo.name]\n\t\t\t\t\t: await collectFiles(env, searchRoot, GREP_FILE_SCAN_LIMIT);\n\n\t\t\tconst matches: string[] = [];\n\t\t\tlet limitReached = false;\n\t\t\touter: for (const file of files) {\n\t\t\t\tif (signal?.aborted) throw new Error(\"aborted\");\n\t\t\t\tif (params.glob && !matchGlob(file, params.glob)) continue;\n\t\t\t\tconst absolute = rootInfo.kind === \"file\" ? searchRoot : join(searchRoot, file);\n\t\t\t\tlet content: string;\n\t\t\t\ttry {\n\t\t\t\t\tcontent = await env.readTextFile(absolute);\n\t\t\t\t} catch {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tif (looksBinary(content)) continue;\n\t\t\t\tconst displayPath = rootInfo.kind === \"file\" ? file : relative(cwd, absolute).split(\"\\\\\").join(\"/\");\n\t\t\t\tconst lines = content.split(\"\\n\");\n\t\t\t\tfor (let i = 0; i < lines.length; i++) {\n\t\t\t\t\tif (!regex.test(lines[i])) continue;\n\t\t\t\t\tmatches.push(`${displayPath}:${i + 1}: ${truncateLine(lines[i]).text}`);\n\t\t\t\t\tif (matches.length >= limit) {\n\t\t\t\t\t\tlimitReached = true;\n\t\t\t\t\t\tbreak outer;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (matches.length === 0) {\n\t\t\t\treturn textResult(\"No matches found\");\n\t\t\t}\n\t\t\tconst truncation = truncateHead(matches.join(\"\\n\"));\n\t\t\tlet text = truncation.content;\n\t\t\tif (limitReached) {\n\t\t\t\ttext = `${text}\\n[Match limit of ${limit} reached; refine the pattern or raise limit]`;\n\t\t\t} else if (truncation.truncated) {\n\t\t\t\ttext = `${text}\\n[Output truncated at ${formatSize(truncation.maxBytes)}]`;\n\t\t\t}\n\t\t\treturn textResult(text);\n\t\t},\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// find\n// ---------------------------------------------------------------------------\n\nconst findSchema = Type.Object({\n\tpattern: Type.String({\n\t\tdescription: \"Glob pattern to match files, e.g. '*.ts', '**/*.json', or 'src/**/*.spec.ts'\",\n\t}),\n\tpath: Type.Optional(Type.String({ description: \"Directory to search in (default: current directory)\" })),\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of results (default: 1000)\" })),\n});\n\nconst FIND_DEFAULT_LIMIT = 1000;\n\nfunction createFindTool(env: NodeExecutionEnv, cwd: string): AgentTool<typeof findSchema> {\n\treturn {\n\t\tname: \"find\",\n\t\tlabel: \"find\",\n\t\tdescription: `Search for files by glob pattern. Returns matching file paths relative to the search directory. Respects the root .gitignore. Output is truncated to ${FIND_DEFAULT_LIMIT} results by default.`,\n\t\tparameters: findSchema,\n\t\texecute: async (_toolCallId, params: Static<typeof findSchema>) => {\n\t\t\tconst limit = params.limit ?? FIND_DEFAULT_LIMIT;\n\t\t\tconst searchRoot = resolveToCwd(cwd, params.path ?? \".\");\n\t\t\tconst files = await collectFiles(env, searchRoot, GREP_FILE_SCAN_LIMIT);\n\t\t\tconst matched: string[] = [];\n\t\t\tlet limitReached = false;\n\t\t\tfor (const file of files) {\n\t\t\t\tif (!matchGlob(file, params.pattern)) continue;\n\t\t\t\tmatched.push(file);\n\t\t\t\tif (matched.length >= limit) {\n\t\t\t\t\tlimitReached = true;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\t\t\tif (matched.length === 0) {\n\t\t\t\treturn textResult(\"No files found\");\n\t\t\t}\n\t\t\tlet text = matched.join(\"\\n\");\n\t\t\tif (limitReached) {\n\t\t\t\ttext = `${text}\\n[Result limit of ${limit} reached]`;\n\t\t\t}\n\t\t\treturn textResult(text);\n\t\t},\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// ls\n// ---------------------------------------------------------------------------\n\nconst lsSchema = Type.Object({\n\tpath: Type.Optional(Type.String({ description: \"Directory to list (default: current directory)\" })),\n\tlimit: Type.Optional(Type.Number({ description: \"Maximum number of entries to return (default: 500)\" })),\n});\n\nconst LS_DEFAULT_LIMIT = 500;\n\nfunction createLsTool(env: NodeExecutionEnv, cwd: string): AgentTool<typeof lsSchema> {\n\treturn {\n\t\tname: \"ls\",\n\t\tlabel: \"ls\",\n\t\tdescription: `List directory contents. Returns entries sorted alphabetically, with '/' suffix for directories. Includes dotfiles. Output is truncated to ${LS_DEFAULT_LIMIT} entries by default.`,\n\t\tparameters: lsSchema,\n\t\texecute: async (_toolCallId, params: Static<typeof lsSchema>) => {\n\t\t\tconst target = resolveToCwd(cwd, params.path ?? \".\");\n\t\t\tconst limit = params.limit ?? LS_DEFAULT_LIMIT;\n\t\t\tconst info = await env.fileInfo(target);\n\t\t\tif (info.kind !== \"directory\") {\n\t\t\t\tthrow new FileError(\"not_directory\", `Not a directory: ${target}`, target);\n\t\t\t}\n\t\t\tconst entries = await env.listDir(target);\n\t\t\tentries.sort((a, b) => a.name.localeCompare(b.name));\n\t\t\tconst shown = entries.slice(0, limit);\n\t\t\tlet text = shown.map((entry) => (entry.kind === \"directory\" ? `${entry.name}/` : entry.name)).join(\"\\n\");\n\t\t\tif (entries.length > limit) {\n\t\t\t\ttext = `${text}\\n[Entry limit of ${limit} reached; ${entries.length - limit} more entries]`;\n\t\t\t}\n\t\t\treturn textResult(text.length > 0 ? text : \"(empty directory)\");\n\t\t},\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// bundle\n// ---------------------------------------------------------------------------\n\n/**\n * Build the default headless tool bundle (bash/read/edit/write/grep/find/ls)\n * bound to the given working directory.\n *\n * The CLI's Task tool is intentionally not part of this bundle: it requires\n * the CLI's subagent runtime (agent registry, subagent pool, session\n * services), which does not exist in a standalone process.\n */\nexport function getDefaultTools(opts?: DefaultToolsOptions): AgentTool<any>[] {\n\tconst cwd = resolve(opts?.cwd ?? process.cwd());\n\tconst env = new NodeExecutionEnv({ cwd });\n\treturn [\n\t\tcreateBashTool(env),\n\t\tcreateReadTool(env),\n\t\tcreateEditTool(env),\n\t\tcreateWriteTool(env),\n\t\tcreateGrepTool(env, cwd),\n\t\tcreateFindTool(env, cwd),\n\t\tcreateLsTool(env, cwd),\n\t];\n}\n"]}

package/dist/tools/mcp-tools.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Headless MCP tool loader: parse a standard mcp.json file (the
+ * `{ "mcpServers": { ... } }` format used by Claude Desktop, VS Code, and the
+ * hoocode CLI), spawn the declared stdio servers, and expose their tools as
+ * AgentTool instances usable by any Agent in any process.
+ *
+ * Spawned servers are tracked per loader call and reaped on process exit so
+ * they never linger as orphans. Call closeMcpTools() to terminate them
+ * earlier (tests, graceful shutdown).
+ */
+import type { AgentTool } from "../types.js";
+export interface McpToolsServerConfig {
+    /** Unique server identifier used as prefix for tool names. */
+    name: string;
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+/** Terminate every MCP server spawned by loadMcpTools() in this process. */
+export declare function closeMcpTools(): void;
+/**
+ * Parse a standard mcp.json file, start every declared stdio server, and
+ * return their tools as AgentTool instances (named `mcp_<server>_<tool>`).
+ *
+ * An empty or server-less config resolves to []. A missing or malformed file,
+ * or a server that fails its handshake, rejects — callers decide whether MCP
+ * is optional. Spawned servers are terminated automatically on process exit.
+ */
+export declare function loadMcpTools(mcpJsonPath: string): Promise<AgentTool<any>[]>;
+//# sourceMappingURL=mcp-tools.d.ts.map

package/dist/tools/mcp-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAC;AAE9D,MAAM,WAAW,oBAAoB;IACpC,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAmCD,4EAA4E;AAC5E,wBAAgB,aAAa,IAAI,IAAI,CASpC;AAuJD;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAwBjF","sourcesContent":["/**\n * Headless MCP tool loader: parse a standard mcp.json file (the\n * `{ \"mcpServers\": { ... } }` format used by Claude Desktop, VS Code, and the\n * hoocode CLI), spawn the declared stdio servers, and expose their tools as\n * AgentTool instances usable by any Agent in any process.\n *\n * Spawned servers are tracked per loader call and reaped on process exit so\n * they never linger as orphans. Call closeMcpTools() to terminate them\n * earlier (tests, graceful shutdown).\n */\n\nimport { type ChildProcess, spawn } from \"node:child_process\";\nimport { readFile } from \"node:fs/promises\";\nimport { createInterface } from \"node:readline\";\nimport { type TObject, Type } from \"typebox\";\nimport type { AgentTool, AgentToolResult } from \"../types.js\";\n\nexport interface McpToolsServerConfig {\n\t/** Unique server identifier used as prefix for tool names. */\n\tname: string;\n\tcommand: string;\n\targs?: string[];\n\tenv?: Record<string, string>;\n}\n\ninterface McpToolDef {\n\tname: string;\n\tdescription?: string;\n\tinputSchema?: {\n\t\ttype?: string;\n\t\tproperties?: Record<string, { type?: string; description?: string }>;\n\t\trequired?: string[];\n\t};\n}\n\ninterface McpConnection {\n\trpc(method: string, params?: unknown, timeoutMs?: number): Promise<unknown>;\n\tnotify(method: string, params?: unknown): void;\n\tterminate(): void;\n}\n\n/** Timeout for the connection handshake (initialize / tools/list). Tool calls\n *  themselves are left untimed since MCP tools can be long-running. */\nconst MCP_HANDSHAKE_TIMEOUT_MS = 15000;\n\nconst liveConnections = new Set<McpConnection>();\nlet exitCleanupInstalled = false;\n\n/** Kill spawned MCP servers when the host process exits so they don't linger\n *  as orphans (their stdin merely goes idle, which doesn't terminate them). */\nfunction installExitCleanup(): void {\n\tif (exitCleanupInstalled) return;\n\texitCleanupInstalled = true;\n\tprocess.once(\"exit\", () => {\n\t\tcloseMcpTools();\n\t});\n}\n\n/** Terminate every MCP server spawned by loadMcpTools() in this process. */\nexport function closeMcpTools(): void {\n\tfor (const conn of liveConnections) {\n\t\ttry {\n\t\t\tconn.terminate();\n\t\t} catch {\n\t\t\t// best-effort cleanup\n\t\t}\n\t}\n\tliveConnections.clear();\n}\n\nfunction spawnMcpServer(config: McpToolsServerConfig): McpConnection {\n\tconst proc: ChildProcess = spawn(config.command, config.args ?? [], {\n\t\tenv: { ...process.env, ...(config.env ?? {}) },\n\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t});\n\n\tlet nextId = 1;\n\tconst pending = new Map<number, { resolve: (r: unknown) => void; reject: (e: Error) => void }>();\n\n\tconst rl = createInterface({ input: proc.stdout! });\n\trl.on(\"line\", (line) => {\n\t\tif (!line.trim()) return;\n\t\ttry {\n\t\t\tconst msg = JSON.parse(line) as { id?: number; result?: unknown; error?: { message: string } };\n\t\t\tif (msg.id === undefined) return;\n\t\t\tconst cb = pending.get(msg.id);\n\t\t\tif (!cb) return;\n\t\t\tpending.delete(msg.id);\n\t\t\tif (msg.error) cb.reject(new Error(msg.error.message));\n\t\t\telse cb.resolve(msg.result);\n\t\t} catch {\n\t\t\t// ignore non-JSON server startup output\n\t\t}\n\t});\n\n\tproc.on(\"exit\", () => {\n\t\tfor (const cb of pending.values()) cb.reject(new Error(`MCP server \"${config.name}\" exited unexpectedly`));\n\t\tpending.clear();\n\t});\n\n\tfunction rpc(method: string, params?: unknown, timeoutMs?: number): Promise<unknown> {\n\t\tconst id = nextId++;\n\t\treturn new Promise<unknown>((resolve, reject) => {\n\t\t\tlet timer: NodeJS.Timeout | undefined;\n\t\t\tif (timeoutMs && timeoutMs > 0) {\n\t\t\t\ttimer = setTimeout(() => {\n\t\t\t\t\tif (pending.delete(id)) {\n\t\t\t\t\t\treject(new Error(`MCP server \"${config.name}\" timed out after ${timeoutMs}ms on ${method}`));\n\t\t\t\t\t}\n\t\t\t\t}, timeoutMs);\n\t\t\t\ttimer.unref?.();\n\t\t\t}\n\t\t\tpending.set(id, {\n\t\t\t\tresolve: (r) => {\n\t\t\t\t\tif (timer) clearTimeout(timer);\n\t\t\t\t\tresolve(r);\n\t\t\t\t},\n\t\t\t\treject: (e) => {\n\t\t\t\t\tif (timer) clearTimeout(timer);\n\t\t\t\t\treject(e);\n\t\t\t\t},\n\t\t\t});\n\t\t\tproc.stdin!.write(`${JSON.stringify({ jsonrpc: \"2.0\", id, method, params })}\\n`);\n\t\t});\n\t}\n\n\tfunction notify(method: string, params?: unknown): void {\n\t\tproc.stdin!.write(`${JSON.stringify({ jsonrpc: \"2.0\", method, params })}\\n`);\n\t}\n\n\treturn {\n\t\trpc,\n\t\tnotify,\n\t\tterminate: () => {\n\t\t\trl.close();\n\t\t\tproc.kill();\n\t\t},\n\t};\n}\n\nasync function connectMcpServer(config: McpToolsServerConfig): Promise<{ conn: McpConnection; tools: McpToolDef[] }> {\n\tconst conn = spawnMcpServer(config);\n\ttry {\n\t\tawait conn.rpc(\n\t\t\t\"initialize\",\n\t\t\t{\n\t\t\t\tprotocolVersion: \"2024-11-05\",\n\t\t\t\tcapabilities: { tools: {} },\n\t\t\t\tclientInfo: { name: \"hoocode-agent-core\", version: \"1.0.0\" },\n\t\t\t},\n\t\t\tMCP_HANDSHAKE_TIMEOUT_MS,\n\t\t);\n\t\t// Per the MCP spec the client must acknowledge a successful initialize with\n\t\t// the initialized notification before issuing further requests; strict\n\t\t// servers gate tools/call on it.\n\t\tconn.notify(\"notifications/initialized\");\n\t\tconst toolsResult = (await conn.rpc(\"tools/list\", {}, MCP_HANDSHAKE_TIMEOUT_MS)) as { tools?: McpToolDef[] };\n\t\treturn { conn, tools: toolsResult.tools ?? [] };\n\t} catch (error) {\n\t\tconn.terminate();\n\t\tthrow error;\n\t}\n}\n\nfunction buildMcpSchema(tool: McpToolDef): TObject {\n\tconst props = tool.inputSchema?.properties ?? {};\n\tconst required = new Set(tool.inputSchema?.required ?? []);\n\tconst shape: Record<string, ReturnType<typeof Type.String>> = {};\n\n\tfor (const [key, prop] of Object.entries(props)) {\n\t\tlet field: ReturnType<typeof Type.String>;\n\t\tswitch (prop.type) {\n\t\t\tcase \"number\":\n\t\t\tcase \"integer\":\n\t\t\t\tfield = Type.Number({ description: prop.description }) as unknown as ReturnType<typeof Type.String>;\n\t\t\t\tbreak;\n\t\t\tcase \"boolean\":\n\t\t\t\tfield = Type.Boolean({ description: prop.description }) as unknown as ReturnType<typeof Type.String>;\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tfield = Type.String({ description: prop.description });\n\t\t}\n\t\tshape[key] = required.has(key) ? field : (Type.Optional(field) as unknown as ReturnType<typeof Type.String>);\n\t}\n\n\treturn Type.Object(shape);\n}\n\nfunction createMcpAgentTool(serverName: string, conn: McpConnection, tool: McpToolDef): AgentTool<any> {\n\tconst schema = buildMcpSchema(tool);\n\treturn {\n\t\tname: `mcp_${serverName}_${tool.name}`,\n\t\tlabel: `[MCP] ${serverName} › ${tool.name}`,\n\t\tdescription: tool.description ?? `MCP tool ${tool.name} from server ${serverName}`,\n\t\tparameters: schema,\n\t\texecute: async (_toolCallId, params, signal): Promise<AgentToolResult<undefined>> => {\n\t\t\tconst abortPromise = new Promise<never>((_, reject) => {\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\treject(new Error(\"Aborted\"));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tsignal?.addEventListener(\"abort\", () => reject(new Error(\"Aborted\")), { once: true });\n\t\t\t});\n\t\t\tconst result = await Promise.race([\n\t\t\t\tconn.rpc(\"tools/call\", { name: tool.name, arguments: params }),\n\t\t\t\tabortPromise,\n\t\t\t]);\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: JSON.stringify(result, null, 2) }],\n\t\t\t\tdetails: undefined,\n\t\t\t};\n\t\t},\n\t};\n}\n\ninterface StandardMcpConfig {\n\tmcpServers?: Record<string, { command: string; args?: string[]; env?: Record<string, string> }>;\n}\n\n/**\n * Parse a standard mcp.json file, start every declared stdio server, and\n * return their tools as AgentTool instances (named `mcp_<server>_<tool>`).\n *\n * An empty or server-less config resolves to []. A missing or malformed file,\n * or a server that fails its handshake, rejects — callers decide whether MCP\n * is optional. Spawned servers are terminated automatically on process exit.\n */\nexport async function loadMcpTools(mcpJsonPath: string): Promise<AgentTool<any>[]> {\n\tconst raw = await readFile(mcpJsonPath, \"utf-8\");\n\tconst parsed = JSON.parse(raw) as StandardMcpConfig;\n\tconst servers = Object.entries(parsed.mcpServers ?? {});\n\tif (servers.length === 0) return [];\n\n\tinstallExitCleanup();\n\tconst tools: AgentTool<any>[] = [];\n\tfor (const [name, serverConfig] of servers) {\n\t\tif (!serverConfig || typeof serverConfig.command !== \"string\") {\n\t\t\tthrow new Error(`${mcpJsonPath}: mcpServers[\"${name}\"] is missing a \"command\"`);\n\t\t}\n\t\tconst { conn, tools: toolDefs } = await connectMcpServer({\n\t\t\tname,\n\t\t\tcommand: serverConfig.command,\n\t\t\targs: serverConfig.args,\n\t\t\tenv: serverConfig.env,\n\t\t});\n\t\tliveConnections.add(conn);\n\t\tfor (const toolDef of toolDefs) {\n\t\t\ttools.push(createMcpAgentTool(name, conn, toolDef));\n\t\t}\n\t}\n\treturn tools;\n}\n"]}

package/dist/tools/mcp-tools.js

@@ -0,0 +1,214 @@
+/**
+ * Headless MCP tool loader: parse a standard mcp.json file (the
+ * `{ "mcpServers": { ... } }` format used by Claude Desktop, VS Code, and the
+ * hoocode CLI), spawn the declared stdio servers, and expose their tools as
+ * AgentTool instances usable by any Agent in any process.
+ *
+ * Spawned servers are tracked per loader call and reaped on process exit so
+ * they never linger as orphans. Call closeMcpTools() to terminate them
+ * earlier (tests, graceful shutdown).
+ */
+import { spawn } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { createInterface } from "node:readline";
+import { Type } from "typebox";
+/** Timeout for the connection handshake (initialize / tools/list). Tool calls
+ *  themselves are left untimed since MCP tools can be long-running. */
+const MCP_HANDSHAKE_TIMEOUT_MS = 15000;
+const liveConnections = new Set();
+let exitCleanupInstalled = false;
+/** Kill spawned MCP servers when the host process exits so they don't linger
+ *  as orphans (their stdin merely goes idle, which doesn't terminate them). */
+function installExitCleanup() {
+    if (exitCleanupInstalled)
+        return;
+    exitCleanupInstalled = true;
+    process.once("exit", () => {
+        closeMcpTools();
+    });
+}
+/** Terminate every MCP server spawned by loadMcpTools() in this process. */
+export function closeMcpTools() {
+    for (const conn of liveConnections) {
+        try {
+            conn.terminate();
+        }
+        catch {
+            // best-effort cleanup
+        }
+    }
+    liveConnections.clear();
+}
+function spawnMcpServer(config) {
+    const proc = spawn(config.command, config.args ?? [], {
+        env: { ...process.env, ...(config.env ?? {}) },
+        stdio: ["pipe", "pipe", "pipe"],
+    });
+    let nextId = 1;
+    const pending = new Map();
+    const rl = createInterface({ input: proc.stdout });
+    rl.on("line", (line) => {
+        if (!line.trim())
+            return;
+        try {
+            const msg = JSON.parse(line);
+            if (msg.id === undefined)
+                return;
+            const cb = pending.get(msg.id);
+            if (!cb)
+                return;
+            pending.delete(msg.id);
+            if (msg.error)
+                cb.reject(new Error(msg.error.message));
+            else
+                cb.resolve(msg.result);
+        }
+        catch {
+            // ignore non-JSON server startup output
+        }
+    });
+    proc.on("exit", () => {
+        for (const cb of pending.values())
+            cb.reject(new Error(`MCP server "${config.name}" exited unexpectedly`));
+        pending.clear();
+    });
+    function rpc(method, params, timeoutMs) {
+        const id = nextId++;
+        return new Promise((resolve, reject) => {
+            let timer;
+            if (timeoutMs && timeoutMs > 0) {
+                timer = setTimeout(() => {
+                    if (pending.delete(id)) {
+                        reject(new Error(`MCP server "${config.name}" timed out after ${timeoutMs}ms on ${method}`));
+                    }
+                }, timeoutMs);
+                timer.unref?.();
+            }
+            pending.set(id, {
+                resolve: (r) => {
+                    if (timer)
+                        clearTimeout(timer);
+                    resolve(r);
+                },
+                reject: (e) => {
+                    if (timer)
+                        clearTimeout(timer);
+                    reject(e);
+                },
+            });
+            proc.stdin.write(`${JSON.stringify({ jsonrpc: "2.0", id, method, params })}\n`);
+        });
+    }
+    function notify(method, params) {
+        proc.stdin.write(`${JSON.stringify({ jsonrpc: "2.0", method, params })}\n`);
+    }
+    return {
+        rpc,
+        notify,
+        terminate: () => {
+            rl.close();
+            proc.kill();
+        },
+    };
+}
+async function connectMcpServer(config) {
+    const conn = spawnMcpServer(config);
+    try {
+        await conn.rpc("initialize", {
+            protocolVersion: "2024-11-05",
+            capabilities: { tools: {} },
+            clientInfo: { name: "hoocode-agent-core", version: "1.0.0" },
+        }, MCP_HANDSHAKE_TIMEOUT_MS);
+        // Per the MCP spec the client must acknowledge a successful initialize with
+        // the initialized notification before issuing further requests; strict
+        // servers gate tools/call on it.
+        conn.notify("notifications/initialized");
+        const toolsResult = (await conn.rpc("tools/list", {}, MCP_HANDSHAKE_TIMEOUT_MS));
+        return { conn, tools: toolsResult.tools ?? [] };
+    }
+    catch (error) {
+        conn.terminate();
+        throw error;
+    }
+}
+function buildMcpSchema(tool) {
+    const props = tool.inputSchema?.properties ?? {};
+    const required = new Set(tool.inputSchema?.required ?? []);
+    const shape = {};
+    for (const [key, prop] of Object.entries(props)) {
+        let field;
+        switch (prop.type) {
+            case "number":
+            case "integer":
+                field = Type.Number({ description: prop.description });
+                break;
+            case "boolean":
+                field = Type.Boolean({ description: prop.description });
+                break;
+            default:
+                field = Type.String({ description: prop.description });
+        }
+        shape[key] = required.has(key) ? field : Type.Optional(field);
+    }
+    return Type.Object(shape);
+}
+function createMcpAgentTool(serverName, conn, tool) {
+    const schema = buildMcpSchema(tool);
+    return {
+        name: `mcp_${serverName}_${tool.name}`,
+        label: `[MCP] ${serverName} › ${tool.name}`,
+        description: tool.description ?? `MCP tool ${tool.name} from server ${serverName}`,
+        parameters: schema,
+        execute: async (_toolCallId, params, signal) => {
+            const abortPromise = new Promise((_, reject) => {
+                if (signal?.aborted) {
+                    reject(new Error("Aborted"));
+                    return;
+                }
+                signal?.addEventListener("abort", () => reject(new Error("Aborted")), { once: true });
+            });
+            const result = await Promise.race([
+                conn.rpc("tools/call", { name: tool.name, arguments: params }),
+                abortPromise,
+            ]);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+                details: undefined,
+            };
+        },
+    };
+}
+/**
+ * Parse a standard mcp.json file, start every declared stdio server, and
+ * return their tools as AgentTool instances (named `mcp_<server>_<tool>`).
+ *
+ * An empty or server-less config resolves to []. A missing or malformed file,
+ * or a server that fails its handshake, rejects — callers decide whether MCP
+ * is optional. Spawned servers are terminated automatically on process exit.
+ */
+export async function loadMcpTools(mcpJsonPath) {
+    const raw = await readFile(mcpJsonPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    const servers = Object.entries(parsed.mcpServers ?? {});
+    if (servers.length === 0)
+        return [];
+    installExitCleanup();
+    const tools = [];
+    for (const [name, serverConfig] of servers) {
+        if (!serverConfig || typeof serverConfig.command !== "string") {
+            throw new Error(`${mcpJsonPath}: mcpServers["${name}"] is missing a "command"`);
+        }
+        const { conn, tools: toolDefs } = await connectMcpServer({
+            name,
+            command: serverConfig.command,
+            args: serverConfig.args,
+            env: serverConfig.env,
+        });
+        liveConnections.add(conn);
+        for (const toolDef of toolDefs) {
+            tools.push(createMcpAgentTool(name, conn, toolDef));
+        }
+    }
+    return tools;
+}
+//# sourceMappingURL=mcp-tools.js.map

package/dist/tools/mcp-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tools.js","sourceRoot":"","sources":["../../src/tools/mcp-tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Headless MCP tool loader: parse a standard mcp.json file (the\n * `{ \"mcpServers\": { ... } }` format used by Claude Desktop, VS Code, and the\n * hoocode CLI), spawn the declared stdio servers, and expose their tools as\n * AgentTool instances usable by any Agent in any process.\n *\n * Spawned servers are tracked per loader call and reaped on process exit so\n * they never linger as orphans. Call closeMcpTools() to terminate them\n * earlier (tests, graceful shutdown).\n */\n\nimport { type ChildProcess, spawn } from \"node:child_process\";\nimport { readFile } from \"node:fs/promises\";\nimport { createInterface } from \"node:readline\";\nimport { type TObject, Type } from \"typebox\";\nimport type { AgentTool, AgentToolResult } from \"../types.js\";\n\nexport interface McpToolsServerConfig {\n\t/** Unique server identifier used as prefix for tool names. */\n\tname: string;\n\tcommand: string;\n\targs?: string[];\n\tenv?: Record<string, string>;\n}\n\ninterface McpToolDef {\n\tname: string;\n\tdescription?: string;\n\tinputSchema?: {\n\t\ttype?: string;\n\t\tproperties?: Record<string, { type?: string; description?: string }>;\n\t\trequired?: string[];\n\t};\n}\n\ninterface McpConnection {\n\trpc(method: string, params?: unknown, timeoutMs?: number): Promise<unknown>;\n\tnotify(method: string, params?: unknown): void;\n\tterminate(): void;\n}\n\n/** Timeout for the connection handshake (initialize / tools/list). Tool calls\n *  themselves are left untimed since MCP tools can be long-running. */\nconst MCP_HANDSHAKE_TIMEOUT_MS = 15000;\n\nconst liveConnections = new Set<McpConnection>();\nlet exitCleanupInstalled = false;\n\n/** Kill spawned MCP servers when the host process exits so they don't linger\n *  as orphans (their stdin merely goes idle, which doesn't terminate them). */\nfunction installExitCleanup(): void {\n\tif (exitCleanupInstalled) return;\n\texitCleanupInstalled = true;\n\tprocess.once(\"exit\", () => {\n\t\tcloseMcpTools();\n\t});\n}\n\n/** Terminate every MCP server spawned by loadMcpTools() in this process. */\nexport function closeMcpTools(): void {\n\tfor (const conn of liveConnections) {\n\t\ttry {\n\t\t\tconn.terminate();\n\t\t} catch {\n\t\t\t// best-effort cleanup\n\t\t}\n\t}\n\tliveConnections.clear();\n}\n\nfunction spawnMcpServer(config: McpToolsServerConfig): McpConnection {\n\tconst proc: ChildProcess = spawn(config.command, config.args ?? [], {\n\t\tenv: { ...process.env, ...(config.env ?? {}) },\n\t\tstdio: [\"pipe\", \"pipe\", \"pipe\"],\n\t});\n\n\tlet nextId = 1;\n\tconst pending = new Map<number, { resolve: (r: unknown) => void; reject: (e: Error) => void }>();\n\n\tconst rl = createInterface({ input: proc.stdout! });\n\trl.on(\"line\", (line) => {\n\t\tif (!line.trim()) return;\n\t\ttry {\n\t\t\tconst msg = JSON.parse(line) as { id?: number; result?: unknown; error?: { message: string } };\n\t\t\tif (msg.id === undefined) return;\n\t\t\tconst cb = pending.get(msg.id);\n\t\t\tif (!cb) return;\n\t\t\tpending.delete(msg.id);\n\t\t\tif (msg.error) cb.reject(new Error(msg.error.message));\n\t\t\telse cb.resolve(msg.result);\n\t\t} catch {\n\t\t\t// ignore non-JSON server startup output\n\t\t}\n\t});\n\n\tproc.on(\"exit\", () => {\n\t\tfor (const cb of pending.values()) cb.reject(new Error(`MCP server \"${config.name}\" exited unexpectedly`));\n\t\tpending.clear();\n\t});\n\n\tfunction rpc(method: string, params?: unknown, timeoutMs?: number): Promise<unknown> {\n\t\tconst id = nextId++;\n\t\treturn new Promise<unknown>((resolve, reject) => {\n\t\t\tlet timer: NodeJS.Timeout | undefined;\n\t\t\tif (timeoutMs && timeoutMs > 0) {\n\t\t\t\ttimer = setTimeout(() => {\n\t\t\t\t\tif (pending.delete(id)) {\n\t\t\t\t\t\treject(new Error(`MCP server \"${config.name}\" timed out after ${timeoutMs}ms on ${method}`));\n\t\t\t\t\t}\n\t\t\t\t}, timeoutMs);\n\t\t\t\ttimer.unref?.();\n\t\t\t}\n\t\t\tpending.set(id, {\n\t\t\t\tresolve: (r) => {\n\t\t\t\t\tif (timer) clearTimeout(timer);\n\t\t\t\t\tresolve(r);\n\t\t\t\t},\n\t\t\t\treject: (e) => {\n\t\t\t\t\tif (timer) clearTimeout(timer);\n\t\t\t\t\treject(e);\n\t\t\t\t},\n\t\t\t});\n\t\t\tproc.stdin!.write(`${JSON.stringify({ jsonrpc: \"2.0\", id, method, params })}\\n`);\n\t\t});\n\t}\n\n\tfunction notify(method: string, params?: unknown): void {\n\t\tproc.stdin!.write(`${JSON.stringify({ jsonrpc: \"2.0\", method, params })}\\n`);\n\t}\n\n\treturn {\n\t\trpc,\n\t\tnotify,\n\t\tterminate: () => {\n\t\t\trl.close();\n\t\t\tproc.kill();\n\t\t},\n\t};\n}\n\nasync function connectMcpServer(config: McpToolsServerConfig): Promise<{ conn: McpConnection; tools: McpToolDef[] }> {\n\tconst conn = spawnMcpServer(config);\n\ttry {\n\t\tawait conn.rpc(\n\t\t\t\"initialize\",\n\t\t\t{\n\t\t\t\tprotocolVersion: \"2024-11-05\",\n\t\t\t\tcapabilities: { tools: {} },\n\t\t\t\tclientInfo: { name: \"hoocode-agent-core\", version: \"1.0.0\" },\n\t\t\t},\n\t\t\tMCP_HANDSHAKE_TIMEOUT_MS,\n\t\t);\n\t\t// Per the MCP spec the client must acknowledge a successful initialize with\n\t\t// the initialized notification before issuing further requests; strict\n\t\t// servers gate tools/call on it.\n\t\tconn.notify(\"notifications/initialized\");\n\t\tconst toolsResult = (await conn.rpc(\"tools/list\", {}, MCP_HANDSHAKE_TIMEOUT_MS)) as { tools?: McpToolDef[] };\n\t\treturn { conn, tools: toolsResult.tools ?? [] };\n\t} catch (error) {\n\t\tconn.terminate();\n\t\tthrow error;\n\t}\n}\n\nfunction buildMcpSchema(tool: McpToolDef): TObject {\n\tconst props = tool.inputSchema?.properties ?? {};\n\tconst required = new Set(tool.inputSchema?.required ?? []);\n\tconst shape: Record<string, ReturnType<typeof Type.String>> = {};\n\n\tfor (const [key, prop] of Object.entries(props)) {\n\t\tlet field: ReturnType<typeof Type.String>;\n\t\tswitch (prop.type) {\n\t\t\tcase \"number\":\n\t\t\tcase \"integer\":\n\t\t\t\tfield = Type.Number({ description: prop.description }) as unknown as ReturnType<typeof Type.String>;\n\t\t\t\tbreak;\n\t\t\tcase \"boolean\":\n\t\t\t\tfield = Type.Boolean({ description: prop.description }) as unknown as ReturnType<typeof Type.String>;\n\t\t\t\tbreak;\n\t\t\tdefault:\n\t\t\t\tfield = Type.String({ description: prop.description });\n\t\t}\n\t\tshape[key] = required.has(key) ? field : (Type.Optional(field) as unknown as ReturnType<typeof Type.String>);\n\t}\n\n\treturn Type.Object(shape);\n}\n\nfunction createMcpAgentTool(serverName: string, conn: McpConnection, tool: McpToolDef): AgentTool<any> {\n\tconst schema = buildMcpSchema(tool);\n\treturn {\n\t\tname: `mcp_${serverName}_${tool.name}`,\n\t\tlabel: `[MCP] ${serverName} › ${tool.name}`,\n\t\tdescription: tool.description ?? `MCP tool ${tool.name} from server ${serverName}`,\n\t\tparameters: schema,\n\t\texecute: async (_toolCallId, params, signal): Promise<AgentToolResult<undefined>> => {\n\t\t\tconst abortPromise = new Promise<never>((_, reject) => {\n\t\t\t\tif (signal?.aborted) {\n\t\t\t\t\treject(new Error(\"Aborted\"));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tsignal?.addEventListener(\"abort\", () => reject(new Error(\"Aborted\")), { once: true });\n\t\t\t});\n\t\t\tconst result = await Promise.race([\n\t\t\t\tconn.rpc(\"tools/call\", { name: tool.name, arguments: params }),\n\t\t\t\tabortPromise,\n\t\t\t]);\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: \"text\", text: JSON.stringify(result, null, 2) }],\n\t\t\t\tdetails: undefined,\n\t\t\t};\n\t\t},\n\t};\n}\n\ninterface StandardMcpConfig {\n\tmcpServers?: Record<string, { command: string; args?: string[]; env?: Record<string, string> }>;\n}\n\n/**\n * Parse a standard mcp.json file, start every declared stdio server, and\n * return their tools as AgentTool instances (named `mcp_<server>_<tool>`).\n *\n * An empty or server-less config resolves to []. A missing or malformed file,\n * or a server that fails its handshake, rejects — callers decide whether MCP\n * is optional. Spawned servers are terminated automatically on process exit.\n */\nexport async function loadMcpTools(mcpJsonPath: string): Promise<AgentTool<any>[]> {\n\tconst raw = await readFile(mcpJsonPath, \"utf-8\");\n\tconst parsed = JSON.parse(raw) as StandardMcpConfig;\n\tconst servers = Object.entries(parsed.mcpServers ?? {});\n\tif (servers.length === 0) return [];\n\n\tinstallExitCleanup();\n\tconst tools: AgentTool<any>[] = [];\n\tfor (const [name, serverConfig] of servers) {\n\t\tif (!serverConfig || typeof serverConfig.command !== \"string\") {\n\t\t\tthrow new Error(`${mcpJsonPath}: mcpServers[\"${name}\"] is missing a \"command\"`);\n\t\t}\n\t\tconst { conn, tools: toolDefs } = await connectMcpServer({\n\t\t\tname,\n\t\t\tcommand: serverConfig.command,\n\t\t\targs: serverConfig.args,\n\t\t\tenv: serverConfig.env,\n\t\t});\n\t\tliveConnections.add(conn);\n\t\tfor (const toolDef of toolDefs) {\n\t\t\ttools.push(createMcpAgentTool(name, conn, toolDef));\n\t\t}\n\t}\n\treturn tools;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kolisachint/hoocode-agent-core",
-	"version": "0.4.47",
+	"version": "0.4.49",
 	"description": "General-purpose agent with transport abstraction, state management, and attachment support",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -17,7 +17,7 @@
 		"prepublishOnly": "npm run clean && npm run build"
 	},
 	"dependencies": {
-		"@kolisachint/hoocode-ai": "^0.4.47",
+		"@kolisachint/hoocode-ai": "^0.4.49",
 		"ignore": "^7.0.5",
 		"typebox": "^1.1.24",
 		"uuid": "^14.0.0",