@opencow-ai/opencow-agent-sdk 0.4.22 → 0.4.24

package/dist/controller/dispatch/permissionPreDecision.d.ts

@@ -0,0 +1,22 @@
+import type { CanonicalToolUseBlock as ToolUseBlock } from '../../session/canonical/index.js';
+import { type CanUseToolFn, type ToolRuntimeContext } from '../../types/toolRuntime.js';
+import type { AssistantMessage } from '../../types/message.js';
+import type { PermissionResult } from '../../types/permissions.js';
+/**
+ * 权限决策前置：runTools() 入口对同批全部 tool_use 并发预调 canUseTool，把
+ * 决策 promise 缓存到 toolUseContext.permissionPreDecisions；工具仍按原顺序
+ * 独占执行，执行时经 consumePermissionPreDecision 消费缓存，避免串行批里
+ * host 审批逐个阻塞弹出。
+ *
+ * 与执行期（checkPermissionsAndCallTool）对齐的规范化：找不到 tool runtime、
+ * zod 校验失败的块跳过（执行期走各自的内联错误路径，本就不该有预决策）；
+ * backfillObservableInput 在浅克隆上调用，与执行期 backfill 后的 observable
+ * input 保持一致，保证消费时深比较有命中机会。
+ */
+export declare function startPermissionPreDecisions(blocks: ToolUseBlock[], assistantMessages: AssistantMessage[], canUseTool: CanUseToolFn, toolUseContext: ToolRuntimeContext): void;
+/**
+ * 一次性消费预决策：无缓存 / input 与执行期不一致（hook 改写等）时回退
+ * fallback 内联询问；命中则返回缓存 promise。无论命中与否，条目取出即删——
+ * 后续同名 tool_use（如 forceDecision 场景）必须重新询问。
+ */
+export declare function consumePermissionPreDecision(toolUseContext: ToolRuntimeContext, toolUseID: string, input: Record<string, unknown>, fallback: () => Promise<PermissionResult>): Promise<PermissionResult>;