@ddlqhd/agent-sdk 0.2.0 → 0.2.1

package/README.md

@@ -33,10 +33,11 @@ pnpm add @ddlqhd/agent-sdk zod
 
 ## Documentation
 
-Factual guides and API references live under **`docs/`** (single source of truth). Start here:
+Factual guides and API references live under **`docs/`** (single source of truth). For a **goal-oriented index** (Chinese), see [`docs/README.md`](docs/README.md). Start here:
 
 | Topic | Document |
 |--------|----------|
+| Docs hub (goal-oriented index, Chinese) | [`docs/README.md`](docs/README.md) |
 | Overview, export boundaries, integration rules | [`docs/sdk-overview.md`](docs/sdk-overview.md) |
 | Quick start | [`docs/sdk-quickstart.md`](docs/sdk-quickstart.md) |
 | Agent loop (`iteration`, tool cycles) | [`docs/sdk-agent-loop.md`](docs/sdk-agent-loop.md) |

package/dist/{chunk-6X7EYQLS.cjs → chunk-JXAJQGV5.cjs}

@@ -2,7 +2,7 @@
 'use strict';
 
 var chunkNYZD3THB_cjs = require('./chunk-NYZD3THB.cjs');
-var chunkZ45DHTDX_cjs = require('./chunk-Z45DHTDX.cjs');
+var chunkP2X3AMDK_cjs = require('./chunk-P2X3AMDK.cjs');
 var fs = require('fs');
 var path = require('path');
 var url = require('url');
@@ -16,7 +16,7 @@ var child_process = require('child_process');
 var util = require('util');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
-var pkgDir = path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-6X7EYQLS.cjs', document.baseURI).href))));
+var pkgDir = path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('chunk-JXAJQGV5.cjs', document.baseURI).href))));
 var pkgPath = path.join(pkgDir, "..", "package.json");
 var PACKAGE_VERSION = JSON.parse(fs.readFileSync(pkgPath, "utf-8")).version;
 
@@ -2007,7 +2007,7 @@ var Agent = class _Agent {
       cwd: this.config.cwd,
       userBasePath: this.config.userBasePath
     });
-    this.toolRegistry = new chunkZ45DHTDX_cjs.ToolRegistry({
+    this.toolRegistry = new chunkP2X3AMDK_cjs.ToolRegistry({
       executionPolicy: {
         disallowedTools: this.config.disallowedTools,
         allowedTools: this.config.allowedTools,
@@ -2021,7 +2021,7 @@ var Agent = class _Agent {
       if (this.toolRegistry.has("Agent")) {
         this.toolRegistry.unregister("Agent");
       }
-      this.toolRegistry.register(chunkZ45DHTDX_cjs.createAgentTool({
+      this.toolRegistry.register(chunkP2X3AMDK_cjs.createAgentTool({
         runner: (request, context) => this.runSubagent(request, context)
       }));
     } else if (this.toolRegistry.has("Agent")) {
@@ -2030,7 +2030,7 @@ var Agent = class _Agent {
     if (this.config.hookManager) {
       this.toolRegistry.setHookManager(this.config.hookManager);
     } else if (this.config.hookConfigDir !== void 0) {
-      const hm = chunkZ45DHTDX_cjs.HookManager.create();
+      const hm = chunkP2X3AMDK_cjs.HookManager.create();
       this.toolRegistry.setHookManager(hm);
       this.hookDiscoverPromise = hm.discoverAndLoad(this.config.hookConfigDir);
     }
@@ -2074,7 +2074,7 @@ var Agent = class _Agent {
       }
       return;
     }
-    const builtins = chunkZ45DHTDX_cjs.getAllBuiltinTools(this.skillRegistry, {
+    const builtins = chunkP2X3AMDK_cjs.getAllBuiltinTools(this.skillRegistry, {
       resolve: this.config.askUserQuestion
     }).filter((t) => !this.toolRegistry.isDisallowed(t.name));
     this.toolRegistry.registerMany(builtins);
@@ -2244,8 +2244,8 @@ var Agent = class _Agent {
     let envSection = "";
     if (shouldIncludeEnv) {
       const cwd = this.config.cwd || process.cwd();
-      const envInfo = chunkZ45DHTDX_cjs.getEnvironmentInfo(cwd);
-      envSection = chunkZ45DHTDX_cjs.formatEnvironmentSection(envInfo);
+      const envInfo = chunkP2X3AMDK_cjs.getEnvironmentInfo(cwd);
+      envSection = chunkP2X3AMDK_cjs.formatEnvironmentSection(envInfo);
     }
     if (!customPrompt) {
       let basePrompt = DEFAULT_SYSTEM_PROMPT;
@@ -3124,12 +3124,20 @@ ${additionalContent}`;
       defaultAllowedTools: this.config.subagent?.defaultAllowedTools
     };
   }
-  resolveSubagentTools(request) {
+  resolveSubagentTools(request, subagentType) {
     const subagentConfig = this.getSubagentConfig();
     const parentTools = this.toolRegistry.getAll();
     const byName = new Map(parentTools.map((tool) => [tool.name, tool]));
-    const requestedNames = request.allowed_tools ?? subagentConfig.defaultAllowedTools;
+    let requestedNames = request.allowed_tools ?? subagentConfig.defaultAllowedTools;
+    let usedExploreDefaultNames = false;
+    if (requestedNames === void 0 && subagentType === "explore") {
+      requestedNames = [...chunkP2X3AMDK_cjs.SUBAGENT_EXPLORE_DEFAULT_TOOL_NAMES];
+      usedExploreDefaultNames = true;
+    }
     let selected = requestedNames ? requestedNames.map((name) => byName.get(name)).filter((tool) => tool !== void 0) : parentTools.filter((tool) => !tool.isDangerous);
+    if (usedExploreDefaultNames && selected.length === 0) {
+      return { error: chunkP2X3AMDK_cjs.subagentExploreDefaultsUnavailableMessage() };
+    }
     selected = selected.filter((tool) => tool.name !== "Agent");
     selected = selected.filter((tool) => tool.name !== "AskUserQuestion");
     if (!subagentConfig.allowDangerousTools) {
@@ -3165,7 +3173,7 @@ ${additionalContent}`;
       1,
       request.max_iterations ?? this.config.maxIterations ?? DEFAULT_MAX_ITERATIONS
     );
-    const resolved = this.resolveSubagentTools(request);
+    const resolved = this.resolveSubagentTools(request, normalizedType);
     if (!resolved.tools) {
       return {
         content: resolved.error ?? "Unable to resolve subagent tools",
@@ -3189,8 +3197,10 @@ ${additionalContent}`;
     this.activeSubagentRuns += 1;
     try {
       await child.waitForInit();
+      const typeAppend = chunkP2X3AMDK_cjs.resolveSubagentTypeAppend(normalizedType, this.config.subagent);
+      const mergedSystem = [typeAppend, request.system_prompt].filter((s) => typeof s === "string" && s.trim().length > 0).join("\n\n");
       const runPromise = child.run(request.prompt, {
-        systemPrompt: request.system_prompt
+        systemPrompt: mergedSystem || void 0
       });
       const timeoutPromise = new Promise((_, reject) => {
         const timer = setTimeout(() => {
@@ -3544,5 +3554,5 @@ exports.isModelStreamEventType = isModelStreamEventType;
 exports.loadMCPConfig = loadMCPConfig;
 exports.parseSkillMd = parseSkillMd;
 exports.validateMCPConfig = validateMCPConfig;
-//# sourceMappingURL=chunk-6X7EYQLS.cjs.map
-//# sourceMappingURL=chunk-6X7EYQLS.cjs.map
+//# sourceMappingURL=chunk-JXAJQGV5.cjs.map
+//# sourceMappingURL=chunk-JXAJQGV5.cjs.map