@ddlqhd/agent-sdk 0.1.1 → 0.2.1

package/dist/{chunk-Q3L4GIBG.cjs → chunk-P2X3AMDK.cjs}

@@ -261,10 +261,12 @@ var ToolRegistry = class {
   outputHandler;
   hookManager = null;
   executionPolicy;
+  hookObserver;
   constructor(config) {
     const enableOutputHandler = config?.enableOutputHandler !== false;
     this.outputHandler = enableOutputHandler ? createOutputHandler(config?.userBasePath) : null;
     this.executionPolicy = config?.executionPolicy;
+    this.hookObserver = config?.hookObserver;
   }
   /**
    * 工具名是否在 {@link ToolExecutionPolicy.disallowedTools} 中（无策略时为 false）。
@@ -331,6 +333,14 @@ var ToolRegistry = class {
       ...extra
     };
   }
+  hookObserverCtx(eventType, name, options) {
+    return {
+      eventType,
+      toolName: name,
+      toolCallId: options?.toolCallId,
+      projectDir: options?.projectDir
+    };
+  }
   /**
    * 注册工具
    */
@@ -401,6 +411,11 @@ var ToolRegistry = class {
     }
     const tool = this.tools.get(name);
     if (!tool) {
+      if (hookMgr) {
+        this.hookObserver?.onHookStart?.(
+          this.hookObserverCtx("postToolUseFailure", name, options)
+        );
+      }
       const ctx = this.buildHookContext("postToolUseFailure", name, rawArgsObj, options, {
         errorMessage: `Tool "${name}" not found`,
         failureKind: "tool_error"
@@ -416,6 +431,11 @@ var ToolRegistry = class {
       const initial = tool.parameters.safeParse(args);
       if (!initial.success) {
         const msg = `Invalid arguments for tool "${name}": ${initial.error.issues.map((i) => i.message).join(", ")}`;
+        if (hookMgr) {
+          this.hookObserver?.onHookStart?.(
+            this.hookObserverCtx("postToolUseFailure", name, options)
+          );
+        }
         await hookMgr?.executePostToolUseFailure(
           this.buildHookContext("postToolUseFailure", name, rawArgsObj, options, {
             errorMessage: msg,
@@ -426,9 +446,17 @@ var ToolRegistry = class {
       }
       workingInput = initial.data;
       if (hookMgr) {
+        this.hookObserver?.onHookStart?.(
+          this.hookObserverCtx("preToolUse", name, options)
+        );
         const pre = await hookMgr.executePreToolUse(
           this.buildHookContext("preToolUse", name, workingInput, options)
         );
+        this.hookObserver?.onHookDecision?.({
+          ...this.hookObserverCtx("preToolUse", name, options),
+          allowed: pre.allowed,
+          reason: pre.reason
+        });
         if (!pre.allowed) {
           return {
             content: pre.reason ?? "Blocked by hook",
@@ -438,6 +466,9 @@ var ToolRegistry = class {
         const merged = tool.parameters.safeParse(pre.updatedInput ?? workingInput);
         if (!merged.success) {
           const msg = `Invalid arguments after hook merge for tool "${name}": ${merged.error.issues.map((i) => i.message).join(", ")}`;
+          this.hookObserver?.onHookStart?.(
+            this.hookObserverCtx("postToolUseFailure", name, options)
+          );
           await hookMgr.executePostToolUseFailure(
             this.buildHookContext("postToolUseFailure", name, workingInput, options, {
               errorMessage: msg,
@@ -457,6 +488,11 @@ var ToolRegistry = class {
       const result = await tool.handler(handlerArgs, executionContext);
       const toolResultRaw = result;
       if (result.isError) {
+        if (hookMgr) {
+          this.hookObserver?.onHookStart?.(
+            this.hookObserverCtx("postToolUseFailure", name, options)
+          );
+        }
         await hookMgr?.executePostToolUseFailure(
           this.buildHookContext("postToolUseFailure", name, workingInput, options, {
             errorMessage: result.content,
@@ -474,6 +510,11 @@ var ToolRegistry = class {
           { args: handlerArgs }
         );
       }
+      if (hookMgr) {
+        this.hookObserver?.onHookStart?.(
+          this.hookObserverCtx("postToolUse", name, options)
+        );
+      }
       await hookMgr?.executePostToolUse(
         this.buildHookContext("postToolUse", name, workingInput, options, {
           toolResultRaw,
@@ -483,6 +524,11 @@ var ToolRegistry = class {
       return finalResult;
     } catch (error) {
       const msg = `Error executing tool "${name}": ${error instanceof Error ? error.message : String(error)}`;
+      if (hookMgr) {
+        this.hookObserver?.onHookStart?.(
+          this.hookObserverCtx("postToolUseFailure", name, options)
+        );
+      }
       await hookMgr?.executePostToolUseFailure(
         this.buildHookContext("postToolUseFailure", name, workingInput, options, {
           errorMessage: msg,
@@ -2143,128 +2189,52 @@ var webSearchTool = createTool({
 function getWebTools() {
   return [webFetchTool, webSearchTool];
 }
-var tasks = /* @__PURE__ */ new Map();
-var nextId = 1;
-var taskCreateTool = createTool({
-  name: "TaskCreate",
+var todoStatusEnum = zod.z.enum(["pending", "in_progress", "completed"]);
+var todoWriteTool = createTool({
+  name: "TodoWrite",
   category: "planning",
-  description: `Use this tool to create a structured task list for your current coding session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user.
+  description: `MUST USE for multi-step tasks. Creates a structured task list to track progress. Call this tool FIRST before executing any complex task.
 
-## When to Use This Tool
+Any number of tasks may be "in_progress" when work runs in parallel. Zero in_progress is fine (e.g. all pending or all completed).
 
-- Complex multi-step tasks - When a task requires 3 or more distinct steps or actions
-- Non-trivial and complex tasks - Tasks that require careful planning or multiple operations
-- User explicitly requests todo list - When the user directly asks you to use the task list
-- User provides multiple tasks - When users provide a list of things to be done
+**Before you finish your assistant response for a multi-step request**, call \`TodoWrite\` again so **every** item in the list has status \`completed\`, unless you are explicitly pausing mid-work for a follow-up turn. Do not leave dangling \`pending\` or \`in_progress\` items when the work for this request is done.
 
-## When NOT to Use
+**Replanning:** If execution shows the earlier plan was wrong, incomplete, or no longer fits (wrong order, missing steps, obsolete items), call \`TodoWrite\` anytime with an updated full list\u2014add, remove, merge, or rewrite steps as needed.
 
-- There is only a single, straightforward task
-- The task is trivial and tracking it provides no organizational benefit
-- The task can be completed in less than 3 trivial steps
-
-All tasks are created with status pending.`,
+Triggers: multi-step tasks, multiple files/components, user provides task list.
+Skip: single simple task, informational questions.`,
   parameters: zod.z.object({
-    subject: zod.z.string().describe("A brief title for the task"),
-    description: zod.z.string().describe("What needs to be done"),
-    activeForm: zod.z.string().optional().describe('Present continuous form shown in spinner when in_progress (e.g., "Running tests")')
-  }),
-  handler: async ({ subject, description, activeForm }) => {
-    const id = String(nextId++);
-    const task = {
-      id,
-      subject,
-      description,
-      status: "pending",
-      ...activeForm && { activeForm }
-    };
-    tasks.set(id, task);
-    return {
-      content: `Task created [${id}]: ${subject}`,
-      metadata: { task }
-    };
-  }
-});
-var taskUpdateTool = createTool({
-  name: "TaskUpdate",
-  category: "planning",
-  description: `Use this tool to update a task in the task list.
-
-## When to Use This Tool
-
-**Mark tasks as completed:**
-- When you have completed the work described in a task
-- IMPORTANT: Always mark your assigned tasks as completed when you finish them
-
-**Delete tasks:**
-- When a task is no longer relevant or was created in error
-
-## Status Workflow
-
-Status progresses: pending \u2192 in_progress \u2192 completed`,
-  parameters: zod.z.object({
-    taskId: zod.z.string().describe("The ID of the task to update"),
-    status: zod.z.enum(["pending", "in_progress", "completed", "deleted"]).optional().describe("New status for the task"),
-    subject: zod.z.string().optional().describe("New subject for the task"),
-    description: zod.z.string().optional().describe("New description for the task"),
-    activeForm: zod.z.string().optional().describe("Present continuous form shown in spinner when in_progress")
+    todos: zod.z.array(
+      zod.z.object({
+        content: zod.z.string().describe('Brief description of the task in imperative form (e.g., "Run tests")'),
+        activeForm: zod.z.string().optional().describe(
+          'Optional present-continuous label for in-progress UI (e.g., "Running tests"). Omit if not needed.'
+        ),
+        status: todoStatusEnum.describe("Task status: pending, in_progress, or completed")
+      })
+    ).min(1).describe(
+      "Full updated todo list. Refresh this whenever progress or the plan changes. When finishing the multi-step work, all entries should be completed."
+    )
   }),
-  handler: async ({ taskId, status, subject, description, activeForm }) => {
-    const task = tasks.get(taskId);
-    if (!task) {
-      return {
-        content: `Task ${taskId} not found`,
-        isError: true
-      };
-    }
-    if (status === "deleted") {
-      tasks.delete(taskId);
-      return { content: `Task ${taskId} deleted` };
-    }
-    if (status) task.status = status;
-    if (subject) task.subject = subject;
-    if (description) task.description = description;
-    if (activeForm) task.activeForm = activeForm;
-    const icon = task.status === "completed" ? "x" : task.status === "in_progress" ? ">" : " ";
-    return {
-      content: `Task [${taskId}] updated: [${icon}] ${task.subject}`,
-      metadata: { task }
-    };
-  }
-});
-var taskListTool = createTool({
-  name: "TaskList",
-  category: "planning",
-  description: `Use this tool to list all tasks in the task list.
-
-## Output
-
-Returns a summary of each task:
-- id: Task identifier (use with TaskUpdate)
-- subject: Brief description of the task
-- status: pending, in_progress, or completed`,
-  parameters: zod.z.object({}),
-  handler: async () => {
-    if (tasks.size === 0) {
-      return { content: "No tasks in the list." };
-    }
+  handler: async ({ todos }) => {
     const lines = [];
-    for (const [, task] of tasks) {
-      const icon = task.status === "completed" ? "x" : task.status === "in_progress" ? ">" : " ";
-      lines.push(`[${icon}] [${task.id}] ${task.subject}`);
+    for (const todo of todos) {
+      const icon = todo.status === "completed" ? "x" : todo.status === "in_progress" ? ">" : " ";
+      lines.push(`[${icon}] ${todo.content}`);
     }
-    const pending = [...tasks.values()].filter((t) => t.status === "pending").length;
-    const inProgress = [...tasks.values()].filter((t) => t.status === "in_progress").length;
-    const completed = [...tasks.values()].filter((t) => t.status === "completed").length;
+    const pending = todos.filter((todo) => todo.status === "pending").length;
+    const inProgress = todos.filter((todo) => todo.status === "in_progress").length;
+    const completed = todos.filter((todo) => todo.status === "completed").length;
     return {
-      content: `Tasks (${completed} completed, ${inProgress} in progress, ${pending} pending):
+      content: `Task list updated (${completed} completed, ${inProgress} in progress, ${pending} pending):
 
-${lines.join("\n")}`
+${lines.join("\n")}`,
+      metadata: { todos }
     };
   }
 });
-function getTaskTools() {
-  return [taskCreateTool, taskUpdateTool, taskListTool];
+function getPlanningTools() {
+  return [todoWriteTool];
 }
 var questionsSchema = zod.z.object({
   questions: zod.z.array(
@@ -2420,10 +2390,35 @@ ${availableList}`,
 function getSkillTools(skillRegistry) {
   return [createSkillTool(skillRegistry)];
 }
+
+// src/tools/builtin/subagent-profiles.ts
+var SUBAGENT_TYPES = ["general-purpose", "explore"];
+var EXPLORE_SYSTEM_APPEND = `## Subagent role: explore
+
+You are running as a read-focused subagent. Prefer **Read**, **Glob**, and **Grep** to locate and cite evidence; use **WebFetch** / **WebSearch** when external facts are needed. Summarize findings with file paths and short excerpts. If your tool list includes editing or shell (for example when the parent set \`allowed_tools\` explicitly), use those only when strictly necessary for the delegated task.`;
+var SUBAGENT_EXPLORE_DEFAULT_TOOL_NAMES = [
+  "Read",
+  "Glob",
+  "Grep",
+  "WebFetch",
+  "WebSearch"
+];
+function subagentExploreDefaultsUnavailableMessage() {
+  const listed = SUBAGENT_EXPLORE_DEFAULT_TOOL_NAMES.join(", ");
+  return `Explore subagent: none of the default tools (${listed}) are available from the parent agent. Register them on the parent, widen parent tools, or pass allowed_tools.`;
+}
+function resolveSubagentTypeAppend(type, subagent) {
+  const custom = subagent?.subagentTypePrompts?.[type];
+  if (custom !== void 0) {
+    const trimmed = custom.trim();
+    return trimmed === "" ? void 0 : custom;
+  }
+  return type === "explore" ? EXPLORE_SYSTEM_APPEND : void 0;
+}
 var subagentRequestSchema = zod.z.object({
   prompt: zod.z.string().min(1).describe("Task prompt for the subagent. Include all required context."),
   description: zod.z.string().optional().describe("Short 3-5 words task label for logs and metadata."),
-  subagent_type: zod.z.enum(["general-purpose", "explore"]).default("general-purpose").describe("Subagent profile/type to use."),
+  subagent_type: zod.z.enum(SUBAGENT_TYPES).default("general-purpose").describe("Subagent profile/type to use."),
   allowed_tools: zod.z.array(zod.z.string().min(1)).optional().describe("Optional allowlist of tool names for the subagent."),
   max_iterations: zod.z.number().int().min(1).optional().describe("Maximum reasoning iterations for the subagent."),
   timeout_ms: zod.z.number().int().min(1e3).optional().describe("Timeout for this subagent run in milliseconds."),
@@ -2449,7 +2444,8 @@ When NOT to use this tool:
 
 Usage notes:
 - Always pass a short description and a complete prompt with all required context
-- Use subagent_type to select behavior; default is general-purpose
+- Use subagent_type: **general-purpose** (default) for balanced work, or **explore** for read-focused runs (SDK appends explore instructions; if you omit allowed_tools and subagent.defaultAllowedTools, tools default to Read/Glob/Grep/WebFetch/WebSearch)
+- Optional system_prompt is merged after the type-specific fragment; override per-type text via AgentConfig.subagent.subagentTypePrompts if needed
 - Subagents do not inherit parent conversation history, only the prompt you provide
 - Subagents cannot spawn other subagents (no nested Agent calls)`,
     parameters: subagentRequestSchema,
@@ -2475,7 +2471,7 @@ function getAllBuiltinTools(skillRegistry, interactionOptions) {
     ...getShellTools(),
     ...getGrepTools(),
     ...getWebTools(),
-    ...getTaskTools(),
+    ...getPlanningTools(),
     ...getInteractionTools(interactionOptions),
     ...getSubagentTools(),
     ...getSkillTools(skillRegistry)
@@ -2893,6 +2889,8 @@ exports.MAX_LINE_LENGTH = MAX_LINE_LENGTH2;
 exports.OUTPUT_CONFIG = OUTPUT_CONFIG;
 exports.OutputHandler = OutputHandler;
 exports.PaginationHintStrategy = PaginationHintStrategy;
+exports.SUBAGENT_EXPLORE_DEFAULT_TOOL_NAMES = SUBAGENT_EXPLORE_DEFAULT_TOOL_NAMES;
+exports.SUBAGENT_TYPES = SUBAGENT_TYPES;
 exports.SmartTruncateStrategy = SmartTruncateStrategy;
 exports.ToolRegistry = ToolRegistry;
 exports.agentTool = agentTool;
@@ -2914,11 +2912,11 @@ exports.getFileSystemTools = getFileSystemTools;
 exports.getGlobalRegistry = getGlobalRegistry;
 exports.getGrepTools = getGrepTools;
 exports.getInteractionTools = getInteractionTools;
+exports.getPlanningTools = getPlanningTools;
 exports.getSafeBuiltinTools = getSafeBuiltinTools;
 exports.getShellTools = getShellTools;
 exports.getSkillTools = getSkillTools;
 exports.getSubagentTools = getSubagentTools;
-exports.getTaskTools = getTaskTools;
 exports.getWebTools = getWebTools;
 exports.globTool = globTool;
 exports.grepTool = grepTool;
@@ -2929,13 +2927,13 @@ exports.mergeCommandHookLayers = mergeCommandHookLayers;
 exports.parseHooksSettingsFile = parseHooksSettingsFile;
 exports.questionTool = questionTool;
 exports.readFileTool = readFileTool;
+exports.resolveSubagentTypeAppend = resolveSubagentTypeAppend;
+exports.subagentExploreDefaultsUnavailableMessage = subagentExploreDefaultsUnavailableMessage;
 exports.subagentRequestSchema = subagentRequestSchema;
-exports.taskCreateTool = taskCreateTool;
-exports.taskListTool = taskListTool;
-exports.taskUpdateTool = taskUpdateTool;
+exports.todoWriteTool = todoWriteTool;
 exports.truncateMatchLineForDisplay = truncateMatchLineForDisplay;
 exports.webFetchTool = webFetchTool;
 exports.webSearchTool = webSearchTool;
 exports.writeFileTool = writeFileTool;
-//# sourceMappingURL=chunk-Q3L4GIBG.cjs.map
-//# sourceMappingURL=chunk-Q3L4GIBG.cjs.map
+//# sourceMappingURL=chunk-P2X3AMDK.cjs.map
+//# sourceMappingURL=chunk-P2X3AMDK.cjs.map