@springbrand/agent-runtime 0.2.0-alpha.39 → 0.2.0-alpha.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springbrand/agent-runtime",
-  "version": "0.2.0-alpha.39",
+  "version": "0.2.0-alpha.40",
   "type": "module",
   "files": [
     "src",

package/src/pi/runtime-adapter/assembly.ts

@@ -236,10 +236,10 @@ const IDEMPOTENT_TOOL_NAMES = new Set([
 export function piToolRetryPolicy(
   candidate: PiToolCandidate,
 ): "idempotent" | "non-idempotent" {
-  return IDEMPOTENT_TOOL_NAMES.has(candidate.tool.name) ||
+  return candidate.retry ?? (IDEMPOTENT_TOOL_NAMES.has(candidate.tool.name) ||
       candidate.owner.startsWith("subagent:")
     ? "idempotent"
-    : "non-idempotent";
+    : "non-idempotent");
 }
 
 // 把工具候选整理成版本描述里要保存的稳定字段。

package/src/pi/tool/compiler.ts

@@ -66,6 +66,8 @@ export interface PiToolCandidate {
    * 那是失效不是降级。`deny` 仍然优先，被 deny 的工具根本不会注入。
    */
   readonly alwaysRequiresApproval?: boolean;
+  /** Recovery may replay this Tool Call only when the candidate guarantees convergence. */
+  readonly retry?: "idempotent" | "non-idempotent";
   readonly summary?: string;
   readonly source?: ApprovalReceipt["source"];
   readonly interaction?: PiToolInteractionSpec;

package/src/pi/tool/declared.ts

@@ -50,6 +50,7 @@ export interface PiDeclaredToolPolicy<Reply = unknown> {
   readonly requiredExecutionLevel: PiToolCandidate["requiredExecutionLevel"];
   readonly requiredExecutionLevelForInput?: PiToolCandidate["requiredExecutionLevelForInput"];
   readonly direct?: true;
+  readonly retry?: PiToolCandidate["retry"];
   readonly source?: PiToolCandidate["source"];
   readonly summary?: string;
   /**
@@ -116,6 +117,7 @@ export function createPiDeclaredToolCandidate<Reply = unknown>(
       ? { requiredExecutionLevelForInput: policy.requiredExecutionLevelForInput }
       : {}),
     ...(policy.direct ? { direct: policy.direct } : {}),
+    ...(policy.retry ? { retry: policy.retry } : {}),
     ...(policy.source ? { source: policy.source } : {}),
   };
 }