@standardagents/spec 0.38.1 → 0.39.0

package/dist/index.d.ts

@@ -3809,6 +3809,15 @@ interface PromptToolConfig {
  * a non-empty human-readable `name` argument and runtimes SHOULD persist it as
  * a child thread display name.
  *
+ * Lifecycle tools manage resumable relationships exclusively: runtimes MUST
+ * reject a `subagent_create` invocation that targets a relationship without
+ * `resumable` configuration, without creating a child, and the rejection
+ * SHOULD direct the model to invoke that tool directly instead. Runtimes
+ * SHOULD constrain the injected tool's target argument to the exposed names
+ * of the prompt's resumable relationships. Lifecycle tool references use the
+ * relationship's exposed tool `name`, never an internal agent identifier that
+ * differs from it.
+ *
  * ### Pull-based child visibility
  *
  * Whenever resumable subagent configs exist, runtimes MUST also inject a
@@ -3851,14 +3860,39 @@ interface PromptToolConfig {
  *   },
  * }
  * ```
+ *
+ * @example
+ * ```typescript
+ * // The same agent exposed under a task-specific tool name.
+ * {
+ *   name: 'summarize_document',
+ *   agent: 'document_agent',
+ *   blocking: true,
+ *   initUserMessageProperty: 'message',
+ * }
+ * ```
  */
 interface SubagentToolConfig<T extends string = StandardAgentSpec.Callables> {
     /**
-     * Agent callable name.
+     * Exposed tool name — the name the model invokes this subagent by.
      *
-     * Must reference a `dual_ai` agent with `exposeAsTool: true`.
+     * When `agent` is absent, this MUST reference a `dual_ai` agent with
+     * `exposeAsTool: true` directly. When `agent` is present, this may be any
+     * valid tool identifier; the runtime MUST expose the tool under this name
+     * and MUST resolve invocations to the agent named by `agent`.
      */
-    name: T;
+    name: T | (string & {});
+    /**
+     * The `dual_ai` agent this tool invokes, when the tool is exposed under a
+     * name other than the agent's own. Must reference a `dual_ai` agent with
+     * `exposeAsTool: true`. Defaults to `name`.
+     *
+     * The same agent may be exposed under different tool names by different
+     * prompts. Everything model-facing — the tool schema, instance registries,
+     * and subagent lifecycle tool references — uses the exposed `name`;
+     * runtimes resolve the implementing agent internally as `agent ?? name`.
+     */
+    agent?: T;
     /**
      * Whether parent execution blocks until the subagent returns a result.
      *