@ddlqhd/agent-sdk 0.2.0 → 0.2.1

package/dist/cli/index.cjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 'use strict';
 
-var chunk6X7EYQLS_cjs = require('../chunk-6X7EYQLS.cjs');
+var chunkJXAJQGV5_cjs = require('../chunk-JXAJQGV5.cjs');
 require('../chunk-NYZD3THB.cjs');
-var chunkZ45DHTDX_cjs = require('../chunk-Z45DHTDX.cjs');
+var chunkP2X3AMDK_cjs = require('../chunk-P2X3AMDK.cjs');
 require('../chunk-OZO7D77N.cjs');
 var commander = require('commander');
 var chalk = require('chalk');
@@ -421,12 +421,12 @@ function createChatCommand() {
     try {
       let sessionId = options.session;
       if (options.resume && !sessionId) {
-        sessionId = await chunk6X7EYQLS_cjs.getLatestSessionId(options.userBasePath);
+        sessionId = await chunkJXAJQGV5_cjs.getLatestSessionId(options.userBasePath);
         if (!sessionId) {
           console.warn(chalk__default.default.yellow("No saved sessions found; starting a new session."));
         }
       }
-      const mcpResult = chunk6X7EYQLS_cjs.loadMCPConfig(options.mcpConfig, options.cwd || process.cwd(), options.userBasePath);
+      const mcpResult = chunkJXAJQGV5_cjs.loadMCPConfig(options.mcpConfig, options.cwd || process.cwd(), options.userBasePath);
       if (mcpResult.configPath) {
         console.log(chalk__default.default.gray(`Loaded MCP config from: ${mcpResult.configPath}`));
         if (mcpResult.servers.length > 0) {
@@ -434,7 +434,7 @@ function createChatCommand() {
         }
       }
       const cwd = options.cwd || process.cwd();
-      const agent = new chunk6X7EYQLS_cjs.Agent({
+      const agent = new chunkJXAJQGV5_cjs.Agent({
         modelConfig: modelConfigFromOptions(options),
         cwd,
         hookConfigDir: cwd,
@@ -451,7 +451,7 @@ function createChatCommand() {
       const skills = skillRegistry.getUserInvocableSkills();
       console.log(chalk__default.default.cyan("\u{1F916} Agent SDK Chat"));
       console.log(chalk__default.default.gray(`Model: ${model.name}`));
-      console.log(chalk__default.default.gray(`Sessions: ${chunk6X7EYQLS_cjs.getSessionStoragePath(options.userBasePath)}`));
+      console.log(chalk__default.default.gray(`Sessions: ${chunkJXAJQGV5_cjs.getSessionStoragePath(options.userBasePath)}`));
       if (skills.length > 0) {
         console.log(chalk__default.default.gray(`Skills: ${skills.map((s) => `/${s.name}`).join(", ")}`));
       }
@@ -592,17 +592,17 @@ function createRunCommand() {
     try {
       let sessionId = options.session;
       if (options.resume && !sessionId) {
-        sessionId = await chunk6X7EYQLS_cjs.getLatestSessionId(options.userBasePath);
+        sessionId = await chunkJXAJQGV5_cjs.getLatestSessionId(options.userBasePath);
         if (!sessionId) {
           console.warn(chalk__default.default.yellow("No saved sessions found; starting a new session."));
         }
       }
-      const mcpResult = chunk6X7EYQLS_cjs.loadMCPConfig(options.mcpConfig, options.cwd || process.cwd(), options.userBasePath);
+      const mcpResult = chunkJXAJQGV5_cjs.loadMCPConfig(options.mcpConfig, options.cwd || process.cwd(), options.userBasePath);
       if (mcpResult.configPath) {
         console.log(chalk__default.default.gray(`Loaded MCP config from: ${mcpResult.configPath}`));
       }
       const cwd = options.cwd || process.cwd();
-      const agent = new chunk6X7EYQLS_cjs.Agent({
+      const agent = new chunkJXAJQGV5_cjs.Agent({
         modelConfig: modelConfigFromOptions(options),
         cwd,
         hookConfigDir: cwd,
@@ -646,9 +646,9 @@ ${formatUsage(result.usage)}`);
 function createToolsCommand() {
   const command = new commander.Command("tools").description("Manage agent tools");
   command.command("list").description("List all available tools").option("-f, --format <format>", "Output format (table/json)", "table").option("-c, --category <category>", "Filter by category").action((options) => {
-    const registry = new chunkZ45DHTDX_cjs.ToolRegistry();
-    const skillRegistry = chunk6X7EYQLS_cjs.createSkillRegistry();
-    registry.registerMany(chunkZ45DHTDX_cjs.getAllBuiltinTools(skillRegistry));
+    const registry = new chunkP2X3AMDK_cjs.ToolRegistry();
+    const skillRegistry = chunkJXAJQGV5_cjs.createSkillRegistry();
+    registry.registerMany(chunkP2X3AMDK_cjs.getAllBuiltinTools(skillRegistry));
     let tools = registry.getAll();
     if (options.category) {
       tools = tools.filter(
@@ -683,9 +683,9 @@ Total: ${tools.length} tools`));
     }
   });
   command.command("show <name>").description("Show tool details").action((name) => {
-    const registry = new chunkZ45DHTDX_cjs.ToolRegistry();
-    const skillRegistry = chunk6X7EYQLS_cjs.createSkillRegistry();
-    registry.registerMany(chunkZ45DHTDX_cjs.getAllBuiltinTools(skillRegistry));
+    const registry = new chunkP2X3AMDK_cjs.ToolRegistry();
+    const skillRegistry = chunkJXAJQGV5_cjs.createSkillRegistry();
+    registry.registerMany(chunkP2X3AMDK_cjs.getAllBuiltinTools(skillRegistry));
     const tool = registry.get(name);
     if (!tool) {
       console.error(chalk__default.default.red(`Tool "${name}" not found`));
@@ -704,9 +704,9 @@ Parameters Schema:`);
   command.command("test <name>").description(
     "Test a tool with arguments. Note: AskUserQuestion returns formatted text only unless the Agent is configured with askUserQuestion (e.g. CLI TTY)."
   ).option("-a, --args <json>", "Tool arguments as JSON").action(async (name, options) => {
-    const registry = new chunkZ45DHTDX_cjs.ToolRegistry();
-    const skillRegistry = chunk6X7EYQLS_cjs.createSkillRegistry();
-    registry.registerMany(chunkZ45DHTDX_cjs.getAllBuiltinTools(skillRegistry));
+    const registry = new chunkP2X3AMDK_cjs.ToolRegistry();
+    const skillRegistry = chunkJXAJQGV5_cjs.createSkillRegistry();
+    registry.registerMany(chunkP2X3AMDK_cjs.getAllBuiltinTools(skillRegistry));
     if (!registry.has(name)) {
       console.error(chalk__default.default.red(`Tool "${name}" not found`));
       process.exit(1);
@@ -744,9 +744,9 @@ function createSessionsCommand() {
   addUserBasePathOption(
     command.command("list").description("List all sessions").option("-l, --limit <n>", "Limit number of sessions", parseInt, 20).option("-f, --format <format>", "Output format (table/json)", "table")
   ).action(async (options) => {
-    const manager = new chunk6X7EYQLS_cjs.SessionManager({
+    const manager = new chunkJXAJQGV5_cjs.SessionManager({
       type: "jsonl",
-      basePath: chunk6X7EYQLS_cjs.getSessionStoragePath(options.userBasePath)
+      basePath: chunkJXAJQGV5_cjs.getSessionStoragePath(options.userBasePath)
     });
     const sessions = await manager.listSessions();
     const limited = sessions.slice(0, options.limit);
@@ -779,9 +779,9 @@ Total: ${sessions.length} sessions`));
   addUserBasePathOption(
     command.command("show <id>").description("Show session messages").option("-l, --limit <n>", "Limit number of messages", parseInt, 50)
   ).action(async (id, options) => {
-    const manager = new chunk6X7EYQLS_cjs.SessionManager({
+    const manager = new chunkJXAJQGV5_cjs.SessionManager({
       type: "jsonl",
-      basePath: chunk6X7EYQLS_cjs.getSessionStoragePath(options.userBasePath)
+      basePath: chunkJXAJQGV5_cjs.getSessionStoragePath(options.userBasePath)
     });
     const exists = await manager.sessionExists(id);
     if (!exists) {
@@ -804,9 +804,9 @@ Total: ${sessions.length} sessions`));
   addUserBasePathOption(
     command.command("delete <id>").description("Delete a session").option("-f, --force", "Skip confirmation")
   ).action(async (id, options) => {
-    const manager = new chunk6X7EYQLS_cjs.SessionManager({
+    const manager = new chunkJXAJQGV5_cjs.SessionManager({
       type: "jsonl",
-      basePath: chunk6X7EYQLS_cjs.getSessionStoragePath(options.userBasePath)
+      basePath: chunkJXAJQGV5_cjs.getSessionStoragePath(options.userBasePath)
     });
     const exists = await manager.sessionExists(id);
     if (!exists) {
@@ -834,9 +834,9 @@ Total: ${sessions.length} sessions`));
   addUserBasePathOption(
     command.command("clear").description("Delete all sessions").option("-f, --force", "Skip confirmation")
   ).action(async (options) => {
-    const manager = new chunk6X7EYQLS_cjs.SessionManager({
+    const manager = new chunkJXAJQGV5_cjs.SessionManager({
       type: "jsonl",
-      basePath: chunk6X7EYQLS_cjs.getSessionStoragePath(options.userBasePath)
+      basePath: chunkJXAJQGV5_cjs.getSessionStoragePath(options.userBasePath)
     });
     const sessions = await manager.listSessions();
     if (sessions.length === 0) {
@@ -870,7 +870,7 @@ function createMCPCommand() {
   const command = new commander.Command("mcp").description("Manage MCP servers");
   command.command("connect <command>").description("Connect to an MCP server and list available tools").option("-n, --name <name>", "Server name", "default").option("-a, --args <args>", "Command arguments (comma-separated)").option("-e, --env <env>", "Environment variables (KEY=VALUE,comma-separated)").action(async (cmd, options) => {
     try {
-      const adapter = new chunk6X7EYQLS_cjs.MCPAdapter();
+      const adapter = new chunkJXAJQGV5_cjs.MCPAdapter();
       const args = options.args ? options.args.split(",") : [];
       const env = {};
       if (options.env) {
@@ -916,7 +916,7 @@ function createMCPCommand() {
 var isMainModule = process.argv[1]?.endsWith("cli/index.js") || process.argv[1]?.endsWith("cli\\index.js") || process.argv[1]?.includes("agent-sdk");
 if (isMainModule) {
   const program = new commander.Command();
-  program.name("agent-sdk").description("A TypeScript Agent SDK with multi-model support, MCP integration, and streaming").version(chunk6X7EYQLS_cjs.PACKAGE_VERSION);
+  program.name("agent-sdk").description("A TypeScript Agent SDK with multi-model support, MCP integration, and streaming").version(chunkJXAJQGV5_cjs.PACKAGE_VERSION);
   program.addCommand(createChatCommand());
   program.addCommand(createRunCommand());
   program.addCommand(createToolsCommand());

package/dist/cli/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { PACKAGE_VERSION, getLatestSessionId, loadMCPConfig, Agent, getSessionStoragePath, createSkillRegistry, SessionManager, MCPAdapter } from '../chunk-EQ5CXH44.js';
+import { PACKAGE_VERSION, getLatestSessionId, loadMCPConfig, Agent, getSessionStoragePath, createSkillRegistry, SessionManager, MCPAdapter } from '../chunk-UHENMHUS.js';
 import '../chunk-D3UZNLZO.js';
-import { ToolRegistry, getAllBuiltinTools } from '../chunk-MEJHTQJM.js';
+import { ToolRegistry, getAllBuiltinTools } from '../chunk-TKUPLTGJ.js';
 import '../chunk-LOYIGOBZ.js';
 import { Command } from 'commander';
 import chalk from 'chalk';

package/dist/{index-Cw3SfEAB.d.ts → index-CnrY1ZA2.d.ts}

@@ -1,4 +1,4 @@
-import { aq as ToolExecutionPolicy, as as ToolHookObserver, R as HookManager, d as ToolDefinition, T as ToolResult, ax as ToolSchema, ab as SkillDefinition, aa as SkillConfig, W as HooksSettings, ao as ToolExecutionContext, H as CreateAskUserQuestionToolOptions } from './types-CWPAYWzr.js';
+import { aq as ToolExecutionPolicy, as as ToolHookObserver, R as HookManager, d as ToolDefinition, T as ToolResult, ax as ToolSchema, ab as SkillDefinition, aa as SkillConfig, W as HooksSettings, ao as ToolExecutionContext, H as CreateAskUserQuestionToolOptions } from './types-BUwjMwNH.js';
 import { z } from 'zod';
 
 /**
@@ -391,6 +391,29 @@ declare function createSkillTool(skillRegistry: SkillRegistry): ToolDefinition;
  */
 declare function getSkillTools(skillRegistry: SkillRegistry): ToolDefinition[];
 
+/**
+ * Built-in subagent type profiles: system prompt fragments and explore default tools.
+ */
+/** Values must stay in sync with `subagentRequestSchema.subagent_type` in subagent.ts. */
+declare const SUBAGENT_TYPES: readonly ["general-purpose", "explore"];
+type SubagentType = (typeof SUBAGENT_TYPES)[number];
+/**
+ * Default tool names for `explore` when the caller did not set `allowed_tools` or `subagent.defaultAllowedTools`.
+ * Matched against the parent registry (unknown names are ignored).
+ */
+declare const SUBAGENT_EXPLORE_DEFAULT_TOOL_NAMES: readonly string[];
+/**
+ * Error text when `explore` used the default name list but none matched the parent registry (single source of truth with {@link SUBAGENT_EXPLORE_DEFAULT_TOOL_NAMES}).
+ */
+declare function subagentExploreDefaultsUnavailableMessage(): string;
+/**
+ * Resolves the system prompt fragment appended for a subagent run (before `request.system_prompt`).
+ * `subagent.subagentTypePrompts[type]` replaces the built-in fragment for that type when provided.
+ */
+declare function resolveSubagentTypeAppend(type: SubagentType, subagent?: {
+    subagentTypePrompts?: Partial<Record<SubagentType, string>>;
+}): string | undefined;
+
 declare const subagentRequestSchema: z.ZodObject<{
     prompt: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
@@ -430,4 +453,4 @@ declare function getAllBuiltinTools(skillRegistry: SkillRegistry, interactionOpt
  */
 declare function getSafeBuiltinTools(skillRegistry: SkillRegistry, interactionOptions?: CreateAskUserQuestionToolOptions): ToolDefinition[];
 
-export { loadHooksSettingsFromProject as A, loadHooksSettingsFromUser as B, type CreateAgentToolOptions as C, DEFAULT_GREP_HEAD_LIMIT as D, parseHooksSettingsFile as E, readFileTool as F, subagentRequestSchema as G, todoWriteTool as H, truncateMatchLineForDisplay as I, webFetchTool as J, webSearchTool as K, writeFileTool as L, MAX_LINE_LENGTH as M, SkillRegistry as S, ToolRegistry as T, SkillLoader as a, type SkillLoaderConfig as b, type SubagentRequest as c, type SubagentRunner as d, type ToolExecuteOptions as e, type ToolRegistryConfig as f, agentTool as g, bashTool as h, createAgentTool as i, createSkillLoader as j, createSkillRegistry as k, createSkillTool as l, createTool as m, editTool as n, getAllBuiltinTools as o, getFileSystemTools as p, getGlobalRegistry as q, getGrepTools as r, getPlanningTools as s, getSafeBuiltinTools as t, getShellTools as u, getSkillTools as v, getSubagentTools as w, getWebTools as x, globTool as y, grepTool as z };
+export { getWebTools as A, globTool as B, type CreateAgentToolOptions as C, DEFAULT_GREP_HEAD_LIMIT as D, grepTool as E, loadHooksSettingsFromProject as F, loadHooksSettingsFromUser as G, parseHooksSettingsFile as H, readFileTool as I, resolveSubagentTypeAppend as J, subagentExploreDefaultsUnavailableMessage as K, subagentRequestSchema as L, MAX_LINE_LENGTH as M, todoWriteTool as N, truncateMatchLineForDisplay as O, webFetchTool as P, webSearchTool as Q, writeFileTool as R, SkillRegistry as S, ToolRegistry as T, SUBAGENT_EXPLORE_DEFAULT_TOOL_NAMES as a, SUBAGENT_TYPES as b, SkillLoader as c, type SkillLoaderConfig as d, type SubagentRequest as e, type SubagentRunner as f, type SubagentType as g, type ToolExecuteOptions as h, type ToolRegistryConfig as i, agentTool as j, bashTool as k, createAgentTool as l, createSkillLoader as m, createSkillRegistry as n, createSkillTool as o, createTool as p, editTool as q, getAllBuiltinTools as r, getFileSystemTools as s, getGlobalRegistry as t, getGrepTools as u, getPlanningTools as v, getSafeBuiltinTools as w, getShellTools as x, getSkillTools as y, getSubagentTools as z };

package/dist/{index-D2Qntkn_.d.cts → index-DzBt4ewK.d.cts}

@@ -1,4 +1,4 @@
-import { aq as ToolExecutionPolicy, as as ToolHookObserver, R as HookManager, d as ToolDefinition, T as ToolResult, ax as ToolSchema, ab as SkillDefinition, aa as SkillConfig, W as HooksSettings, ao as ToolExecutionContext, H as CreateAskUserQuestionToolOptions } from './types-CWPAYWzr.cjs';
+import { aq as ToolExecutionPolicy, as as ToolHookObserver, R as HookManager, d as ToolDefinition, T as ToolResult, ax as ToolSchema, ab as SkillDefinition, aa as SkillConfig, W as HooksSettings, ao as ToolExecutionContext, H as CreateAskUserQuestionToolOptions } from './types-BUwjMwNH.cjs';
 import { z } from 'zod';
 
 /**
@@ -391,6 +391,29 @@ declare function createSkillTool(skillRegistry: SkillRegistry): ToolDefinition;
  */
 declare function getSkillTools(skillRegistry: SkillRegistry): ToolDefinition[];
 
+/**
+ * Built-in subagent type profiles: system prompt fragments and explore default tools.
+ */
+/** Values must stay in sync with `subagentRequestSchema.subagent_type` in subagent.ts. */
+declare const SUBAGENT_TYPES: readonly ["general-purpose", "explore"];
+type SubagentType = (typeof SUBAGENT_TYPES)[number];
+/**
+ * Default tool names for `explore` when the caller did not set `allowed_tools` or `subagent.defaultAllowedTools`.
+ * Matched against the parent registry (unknown names are ignored).
+ */
+declare const SUBAGENT_EXPLORE_DEFAULT_TOOL_NAMES: readonly string[];
+/**
+ * Error text when `explore` used the default name list but none matched the parent registry (single source of truth with {@link SUBAGENT_EXPLORE_DEFAULT_TOOL_NAMES}).
+ */
+declare function subagentExploreDefaultsUnavailableMessage(): string;
+/**
+ * Resolves the system prompt fragment appended for a subagent run (before `request.system_prompt`).
+ * `subagent.subagentTypePrompts[type]` replaces the built-in fragment for that type when provided.
+ */
+declare function resolveSubagentTypeAppend(type: SubagentType, subagent?: {
+    subagentTypePrompts?: Partial<Record<SubagentType, string>>;
+}): string | undefined;
+
 declare const subagentRequestSchema: z.ZodObject<{
     prompt: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
@@ -430,4 +453,4 @@ declare function getAllBuiltinTools(skillRegistry: SkillRegistry, interactionOpt
  */
 declare function getSafeBuiltinTools(skillRegistry: SkillRegistry, interactionOptions?: CreateAskUserQuestionToolOptions): ToolDefinition[];
 
-export { loadHooksSettingsFromProject as A, loadHooksSettingsFromUser as B, type CreateAgentToolOptions as C, DEFAULT_GREP_HEAD_LIMIT as D, parseHooksSettingsFile as E, readFileTool as F, subagentRequestSchema as G, todoWriteTool as H, truncateMatchLineForDisplay as I, webFetchTool as J, webSearchTool as K, writeFileTool as L, MAX_LINE_LENGTH as M, SkillRegistry as S, ToolRegistry as T, SkillLoader as a, type SkillLoaderConfig as b, type SubagentRequest as c, type SubagentRunner as d, type ToolExecuteOptions as e, type ToolRegistryConfig as f, agentTool as g, bashTool as h, createAgentTool as i, createSkillLoader as j, createSkillRegistry as k, createSkillTool as l, createTool as m, editTool as n, getAllBuiltinTools as o, getFileSystemTools as p, getGlobalRegistry as q, getGrepTools as r, getPlanningTools as s, getSafeBuiltinTools as t, getShellTools as u, getSkillTools as v, getSubagentTools as w, getWebTools as x, globTool as y, grepTool as z };
+export { getWebTools as A, globTool as B, type CreateAgentToolOptions as C, DEFAULT_GREP_HEAD_LIMIT as D, grepTool as E, loadHooksSettingsFromProject as F, loadHooksSettingsFromUser as G, parseHooksSettingsFile as H, readFileTool as I, resolveSubagentTypeAppend as J, subagentExploreDefaultsUnavailableMessage as K, subagentRequestSchema as L, MAX_LINE_LENGTH as M, todoWriteTool as N, truncateMatchLineForDisplay as O, webFetchTool as P, webSearchTool as Q, writeFileTool as R, SkillRegistry as S, ToolRegistry as T, SUBAGENT_EXPLORE_DEFAULT_TOOL_NAMES as a, SUBAGENT_TYPES as b, SkillLoader as c, type SkillLoaderConfig as d, type SubagentRequest as e, type SubagentRunner as f, type SubagentType as g, type ToolExecuteOptions as h, type ToolRegistryConfig as i, agentTool as j, bashTool as k, createAgentTool as l, createSkillLoader as m, createSkillRegistry as n, createSkillTool as o, createTool as p, editTool as q, getAllBuiltinTools as r, getFileSystemTools as s, getGlobalRegistry as t, getGrepTools as u, getPlanningTools as v, getSafeBuiltinTools as w, getShellTools as x, getSkillTools as y, getSubagentTools as z };