@ddlqhd/agent-sdk 0.1.1 → 0.2.1

package/dist/{chunk-THKEF32L.js → chunk-TKUPLTGJ.js}

@@ -231,10 +231,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）。
@@ -301,6 +303,14 @@ var ToolRegistry = class {
       ...extra
     };
   }
+  hookObserverCtx(eventType, name, options) {
+    return {
+      eventType,
+      toolName: name,
+      toolCallId: options?.toolCallId,
+      projectDir: options?.projectDir
+    };
+  }
   /**
    * 注册工具
    */
@@ -371,6 +381,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"
@@ -386,6 +401,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,
@@ -396,9 +416,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",
@@ -408,6 +436,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,
@@ -427,6 +458,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,
@@ -444,6 +480,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,
@@ -453,6 +494,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,
@@ -2113,128 +2159,52 @@ var webSearchTool = createTool({
 function getWebTools() {
   return [webFetchTool, webSearchTool];
 }
-var tasks = /* @__PURE__ */ new Map();
-var nextId = 1;
-var taskCreateTool = createTool({
-  name: "TaskCreate",
+var todoStatusEnum = 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: z.object({
-    subject: z.string().describe("A brief title for the task"),
-    description: z.string().describe("What needs to be done"),
-    activeForm: 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: z.object({
-    taskId: z.string().describe("The ID of the task to update"),
-    status: z.enum(["pending", "in_progress", "completed", "deleted"]).optional().describe("New status for the task"),
-    subject: z.string().optional().describe("New subject for the task"),
-    description: z.string().optional().describe("New description for the task"),
-    activeForm: z.string().optional().describe("Present continuous form shown in spinner when in_progress")
+    todos: z.array(
+      z.object({
+        content: z.string().describe('Brief description of the task in imperative form (e.g., "Run tests")'),
+        activeForm: 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: 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 = z.object({
   questions: z.array(
@@ -2390,10 +2360,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 = z.object({
   prompt: z.string().min(1).describe("Task prompt for the subagent. Include all required context."),
   description: z.string().optional().describe("Short 3-5 words task label for logs and metadata."),
-  subagent_type: z.enum(["general-purpose", "explore"]).default("general-purpose").describe("Subagent profile/type to use."),
+  subagent_type: z.enum(SUBAGENT_TYPES).default("general-purpose").describe("Subagent profile/type to use."),
   allowed_tools: z.array(z.string().min(1)).optional().describe("Optional allowlist of tool names for the subagent."),
   max_iterations: z.number().int().min(1).optional().describe("Maximum reasoning iterations for the subagent."),
   timeout_ms: z.number().int().min(1e3).optional().describe("Timeout for this subagent run in milliseconds."),
@@ -2419,7 +2414,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,
@@ -2445,7 +2441,7 @@ function getAllBuiltinTools(skillRegistry, interactionOptions) {
     ...getShellTools(),
     ...getGrepTools(),
     ...getWebTools(),
-    ...getTaskTools(),
+    ...getPlanningTools(),
     ...getInteractionTools(interactionOptions),
     ...getSubagentTools(),
     ...getSkillTools(skillRegistry)
@@ -2856,6 +2852,6 @@ function createFunctionHook(config) {
   };
 }
 
-export { DEFAULT_GREP_HEAD_LIMIT, FileStorageStrategy, HookManager, MAX_LINE_LENGTH2 as MAX_LINE_LENGTH, OUTPUT_CONFIG, OutputHandler, PaginationHintStrategy, SmartTruncateStrategy, ToolRegistry, agentTool, bashTool, buildHookEnv, createAgentTool, createAskUserQuestionTool, createFunctionHook, createOutputHandler, createSkillTool, createTool, editTool, formatAnswerSummary, formatAskUserQuestionPrompt, formatEnvironmentSection, getAllBuiltinTools, getEnvironmentInfo, getFileSystemTools, getGlobalRegistry, getGrepTools, getInteractionTools, getSafeBuiltinTools, getShellTools, getSkillTools, getSubagentTools, getTaskTools, getWebTools, globTool, grepTool, loadHooksSettingsFromProject, loadHooksSettingsFromUser, matchTool, mergeCommandHookLayers, parseHooksSettingsFile, questionTool, readFileTool, subagentRequestSchema, taskCreateTool, taskListTool, taskUpdateTool, truncateMatchLineForDisplay, webFetchTool, webSearchTool, writeFileTool };
-//# sourceMappingURL=chunk-THKEF32L.js.map
-//# sourceMappingURL=chunk-THKEF32L.js.map
+export { DEFAULT_GREP_HEAD_LIMIT, FileStorageStrategy, HookManager, MAX_LINE_LENGTH2 as MAX_LINE_LENGTH, OUTPUT_CONFIG, OutputHandler, PaginationHintStrategy, SUBAGENT_EXPLORE_DEFAULT_TOOL_NAMES, SUBAGENT_TYPES, SmartTruncateStrategy, ToolRegistry, agentTool, bashTool, buildHookEnv, createAgentTool, createAskUserQuestionTool, createFunctionHook, createOutputHandler, createSkillTool, createTool, editTool, formatAnswerSummary, formatAskUserQuestionPrompt, formatEnvironmentSection, getAllBuiltinTools, getEnvironmentInfo, getFileSystemTools, getGlobalRegistry, getGrepTools, getInteractionTools, getPlanningTools, getSafeBuiltinTools, getShellTools, getSkillTools, getSubagentTools, getWebTools, globTool, grepTool, loadHooksSettingsFromProject, loadHooksSettingsFromUser, matchTool, mergeCommandHookLayers, parseHooksSettingsFile, questionTool, readFileTool, resolveSubagentTypeAppend, subagentExploreDefaultsUnavailableMessage, subagentRequestSchema, todoWriteTool, truncateMatchLineForDisplay, webFetchTool, webSearchTool, writeFileTool };
+//# sourceMappingURL=chunk-TKUPLTGJ.js.map
+//# sourceMappingURL=chunk-TKUPLTGJ.js.map