@axiastudio/aioc 0.1.0-beta.6 → 0.1.0

package/dist/run-record.d.ts

@@ -10,10 +10,13 @@ export interface PolicyDecisionRecord {
     timestamp: string;
     turn: number;
     callId: string;
-    decision: "allow" | "deny";
+    decision: "allow" | "deny" | "require_approval";
     reason: string;
+    publicReason?: string;
+    resultMode?: "throw" | "tool_result";
     policyVersion?: string;
     resource: PolicyResourceSnapshot;
+    expiresAt?: string;
     metadata?: Record<string, unknown>;
 }
 export interface GuardrailDecisionRecord {
@@ -49,6 +52,34 @@ export interface RequestFingerprintRecord {
     messageCount: number;
     toolCount: number;
 }
+export interface SuspendedProposalBase {
+    timestamp: string;
+    runId: string;
+    turn: number;
+    callId: string;
+    agentName: string;
+    proposalHash: string;
+    reason: string;
+    publicReason?: string;
+    policyVersion?: string;
+    expiresAt?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface SuspendedToolProposal extends SuspendedProposalBase {
+    kind: "tool";
+    toolName: string;
+    rawArguments: string;
+    parsedArguments: unknown;
+    argsCanonicalJson: string;
+}
+export interface SuspendedHandoffProposal extends SuspendedProposalBase {
+    kind: "handoff";
+    fromAgentName: string;
+    toAgentName: string;
+    handoffPayload: unknown;
+    payloadCanonicalJson: string;
+}
+export type SuspendedProposal = SuspendedToolProposal | SuspendedHandoffProposal;
 export interface RunRecord<TContext = unknown> {
     runId: string;
     startedAt: string;
@@ -65,6 +96,7 @@ export interface RunRecord<TContext = unknown> {
     promptSnapshots: PromptSnapshotRecord[];
     requestFingerprints: RequestFingerprintRecord[];
     policyDecisions: PolicyDecisionRecord[];
+    suspendedProposals?: SuspendedProposal[];
     guardrailDecisions?: GuardrailDecisionRecord[];
     errorName?: string;
     errorMessage?: string;

package/dist/run-record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-record.d.ts","sourceRoot":"","sources":["../src/run-record.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-record.d.ts","sourceRoot":"","sources":["../src/run-record.ts"],"names":[],"mappings":"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"}

package/dist/run-recorder-runtime.d.ts

@@ -1,4 +1,4 @@
-import type { GuardrailDecisionRecord, PolicyDecisionRecord, PromptSnapshotRecord, RequestFingerprintRecord, RunRecordOptions } from "./run-record";
+import type { GuardrailDecisionRecord, PolicyDecisionRecord, PromptSnapshotRecord, RequestFingerprintRecord, RunRecordOptions, SuspendedProposal } from "./run-record";
 import type { AgentInputItem } from "./types";
 export type PendingPolicyDecisionRecord = Omit<PolicyDecisionRecord, "timestamp">;
 export type PendingGuardrailDecisionRecord = Omit<GuardrailDecisionRecord, "timestamp">;
@@ -36,6 +36,7 @@ export declare class RunRecorder<TContext = unknown> {
     private readonly contextSnapshot;
     private readonly includePromptText;
     private readonly policyDecisions;
+    private readonly suspendedProposals;
     private readonly guardrailDecisions;
     private readonly promptSnapshots;
     private readonly requestFingerprints;
@@ -43,7 +44,9 @@ export declare class RunRecorder<TContext = unknown> {
     private runRecordWritten;
     private constructor();
     static create<TContext = unknown>(options: RunRecorderCreateOptions<TContext>): Promise<RunRecorder<TContext>>;
+    get runId(): string;
     onPolicyDecision: (decision: PendingPolicyDecisionRecord) => void;
+    onSuspendedProposal: (proposal: SuspendedProposal) => void;
     onGuardrailDecision: (decision: PendingGuardrailDecisionRecord) => void;
     onPromptSnapshot: (snapshot: PendingPromptSnapshotRecord) => void;
     onRequestFingerprint: (fingerprint: PendingRequestFingerprintRecord) => void;

package/dist/run-recorder-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-recorder-runtime.d.ts","sourceRoot":"","sources":["../src/run-recorder-runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-recorder-runtime.d.ts","sourceRoot":"","sources":["../src/run-recorder-runtime.ts"],"names":[],"mappings":"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"}

package/dist/run-recorder-runtime.js

@@ -99,6 +99,7 @@ class RunRecorder {
     contextSnapshot;
     includePromptText;
     policyDecisions = [];
+    suspendedProposals = [];
     guardrailDecisions = [];
     promptSnapshots = [];
     requestFingerprints = [];
@@ -122,12 +123,18 @@ class RunRecorder {
         const contextSnapshot = await resolveContextSnapshot(options.context, options.recordOptions);
         return new RunRecorder(runRecordWriter, runRecordId, startedAt, question, options.providerName, options.recordOptions?.metadata, contextSnapshot, options.recordOptions?.includePromptText ?? false);
     }
+    get runId() {
+        return this.runRecordId;
+    }
     onPolicyDecision = (decision) => {
         this.policyDecisions.push({
             timestamp: new Date().toISOString(),
             ...decision,
         });
     };
+    onSuspendedProposal = (proposal) => {
+        this.suspendedProposals.push(proposal);
+    };
     onGuardrailDecision = (decision) => {
         this.guardrailDecisions.push({
             timestamp: new Date().toISOString(),
@@ -209,6 +216,9 @@ class RunRecorder {
             promptSnapshots: [...this.promptSnapshots],
             requestFingerprints: [...this.requestFingerprints],
             policyDecisions: [...this.policyDecisions],
+            suspendedProposals: this.suspendedProposals.length > 0
+                ? [...this.suspendedProposals]
+                : undefined,
             guardrailDecisions: this.guardrailDecisions.length > 0
                 ? [...this.guardrailDecisions]
                 : undefined,

package/dist/run.d.ts

@@ -4,13 +4,7 @@ type MutableRunState<TContext> = {
     history: AgentInputItem[];
     lastAgent: Agent<TContext>;
 };
-export type ToolResultEnvelopeStatus = "ok" | "denied";
-export interface ToolResultEnvelope {
-    status: ToolResultEnvelopeStatus;
-    code: string | null;
-    publicReason: string | null;
-    data: unknown | null;
-}
+export type { ToolResultEnvelope, ToolResultEnvelopeStatus, } from "./policy-outcomes";
 export declare class StreamedRunResult<TContext = unknown> {
     private consumed;
     private stream;
@@ -22,5 +16,4 @@ export declare class StreamedRunResult<TContext = unknown> {
 }
 export declare function run<TContext = unknown>(startingAgent: Agent<TContext>, input: string | AgentInputItem[], options: StreamRunOptions<TContext>): Promise<StreamedRunResult<TContext>>;
 export declare function run<TContext = unknown>(startingAgent: Agent<TContext>, input: string | AgentInputItem[], options?: NonStreamRunOptions<TContext>): Promise<RunResult<TContext>>;
-export {};
 //# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAuBhC,OAAO,EACL,cAAc,EAEd,mBAAmB,EAGnB,SAAS,EACT,cAAc,EACd,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAUjB,KAAK,eAAe,CAAC,QAAQ,IAAI;IAC/B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;CAC5B,CAAC;AAGF,MAAM,MAAM,wBAAwB,GAAG,IAAI,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,wBAAwB,CAAC;IACjC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;CACtB;AA8oBD,qBAAa,iBAAiB,CAAC,QAAQ,GAAG,OAAO;IAC/C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,KAAK,CAA4B;gBAGvC,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,EAC/C,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC;IAMlC,QAAQ,IAAI,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAQnD,IAAI,OAAO,IAAI,cAAc,EAAE,CAE9B;IAED,IAAI,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,CAE/B;CACF;AAED,wBAAsB,GAAG,CAAC,QAAQ,GAAG,OAAO,EAC1C,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,EAC9B,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,EAChC,OAAO,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAClC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAExC,wBAAsB,GAAG,CAAC,QAAQ,GAAG,OAAO,EAC1C,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,EAC9B,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,EAChC,OAAO,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GACtC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAsChC,OAAO,EACL,cAAc,EAEd,mBAAmB,EAGnB,SAAS,EACT,cAAc,EACd,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAUjB,KAAK,eAAe,CAAC,QAAQ,IAAI;IAC/B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;CAC5B,CAAC;AAGF,YAAY,EACV,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,mBAAmB,CAAC;AAuwB3B,qBAAa,iBAAiB,CAAC,QAAQ,GAAG,OAAO;IAC/C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,KAAK,CAA4B;gBAGvC,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,EAC/C,KAAK,EAAE,eAAe,CAAC,QAAQ,CAAC;IAMlC,QAAQ,IAAI,aAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAQnD,IAAI,OAAO,IAAI,cAAc,EAAE,CAE9B;IAED,IAAI,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,CAE/B;CACF;AAED,wBAAsB,GAAG,CAAC,QAAQ,GAAG,OAAO,EAC1C,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,EAC9B,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,EAChC,OAAO,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAClC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAExC,wBAAsB,GAAG,CAAC,QAAQ,GAAG,OAAO,EAC1C,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,EAC9B,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,EAChC,OAAO,CAAC,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GACtC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC"}

package/dist/run.js

@@ -5,9 +5,12 @@ exports.run = run;
 const config_1 = require("./config");
 const errors_1 = require("./errors");
 const messages_1 = require("./messages");
+const policy_outcomes_1 = require("./policy-outcomes");
+const proposal_hashing_1 = require("./proposal-hashing");
 const run_log_emitter_1 = require("./run-log-emitter");
 const run_recorder_runtime_1 = require("./run-recorder-runtime");
 const run_context_1 = require("./run-context");
+const suspended_proposals_1 = require("./suspended-proposals");
 const zod_1 = require("zod");
 const zod_to_json_schema_1 = require("zod-to-json-schema");
 function toToolParameterSchema(schema) {
@@ -99,54 +102,89 @@ function toErrorMetadata(error) {
         errorMessage: String(error),
     };
 }
-function createDeniedPolicyResult(reason, metadata) {
-    return {
-        decision: "deny",
-        reason,
-        metadata,
-    };
-}
-function shouldReturnDeniedAsToolResult(policyResult) {
-    return (policyResult.decision === "deny" && policyResult.denyMode === "tool_result");
-}
-function toAllowedToolResultEnvelope(data) {
-    return {
-        status: "ok",
-        code: null,
-        publicReason: null,
-        data,
-    };
-}
-function toDeniedToolResultEnvelope(policyResult) {
-    return {
-        status: "denied",
-        code: policyResult.reason,
-        publicReason: policyResult.publicReason?.trim() || "Action not allowed.",
-        data: null,
-    };
-}
-function isPolicyResult(value) {
+function isPolicyResultShape(value) {
     if (typeof value !== "object" || value === null) {
         return false;
     }
     const candidate = value;
-    const validDecision = candidate.decision === "allow" || candidate.decision === "deny";
+    const validDecision = candidate.decision === "allow" ||
+        candidate.decision === "deny" ||
+        candidate.decision === "require_approval";
     const validPublicReason = typeof candidate.publicReason === "undefined" ||
         typeof candidate.publicReason === "string";
-    const validDenyMode = typeof candidate.denyMode === "undefined" ||
-        candidate.denyMode === "throw" ||
-        candidate.denyMode === "tool_result";
+    const validResultMode = typeof candidate.resultMode === "undefined" ||
+        candidate.resultMode === "throw" ||
+        candidate.resultMode === "tool_result";
+    const validExpiresAt = typeof candidate.expiresAt === "undefined" ||
+        typeof candidate.expiresAt === "string";
     return (validDecision &&
         typeof candidate.reason === "string" &&
         candidate.reason.trim().length > 0 &&
         validPublicReason &&
-        validDenyMode);
+        validResultMode &&
+        validExpiresAt);
+}
+function hasDeprecatedDenyMode(value) {
+    return typeof value === "object" && value !== null && "denyMode" in value;
+}
+function createDeprecatedDenyModeResult(receivedValue) {
+    return (0, policy_outcomes_1.createDeniedPolicyResult)("deprecated_policy_field_denyMode", {
+        deprecatedField: "denyMode",
+        replacementField: "resultMode",
+        receivedValue,
+    });
+}
+async function emitPolicyDecision(params) {
+    const { agentName, turn, callId, policyResult, logEmitter, onPolicyDecision, } = params;
+    const resultMode = policyResult.decision === "allow"
+        ? undefined
+        : (0, policy_outcomes_1.resolveResultMode)(policyResult);
+    if (params.kind === "tool") {
+        await logEmitter.toolPolicyEvaluated(agentName, turn, params.toolName, callId, policyResult.decision, policyResult.reason, policyResult.publicReason, resultMode, policyResult.policyVersion, policyResult.expiresAt, policyResult.metadata);
+        onPolicyDecision?.({
+            turn,
+            callId,
+            decision: policyResult.decision,
+            reason: policyResult.reason,
+            publicReason: policyResult.publicReason,
+            resultMode,
+            policyVersion: policyResult.policyVersion,
+            resource: {
+                kind: "tool",
+                name: params.toolName,
+            },
+            expiresAt: policyResult.expiresAt,
+            metadata: policyResult.metadata,
+        });
+        return;
+    }
+    await logEmitter.handoffPolicyEvaluated(agentName, turn, params.handoffName, callId, params.toAgentName, policyResult.decision, policyResult.reason, policyResult.publicReason, resultMode, policyResult.policyVersion, policyResult.expiresAt, policyResult.metadata);
+    onPolicyDecision?.({
+        turn,
+        callId,
+        decision: policyResult.decision,
+        reason: policyResult.reason,
+        publicReason: policyResult.publicReason,
+        resultMode,
+        policyVersion: policyResult.policyVersion,
+        resource: {
+            kind: "handoff",
+            name: params.toAgentName,
+        },
+        expiresAt: policyResult.expiresAt,
+        metadata: policyResult.metadata,
+    });
 }
 async function evaluateToolPolicy(agent, call, parsedArguments, runContext, turn, policies) {
     const policy = policies?.toolPolicy;
     if (!policy) {
-        return createDeniedPolicyResult("policy_not_configured");
+        return (0, policy_outcomes_1.createDeniedPolicyResult)("policy_not_configured");
     }
+    const { proposalHash, argsCanonicalJson } = (0, proposal_hashing_1.createToolProposalFingerprint)({
+        agentName: agent.name,
+        toolName: call.name,
+        parsedArguments,
+    });
     let rawResult;
     try {
         rawResult = await policy({
@@ -154,72 +192,98 @@ async function evaluateToolPolicy(agent, call, parsedArguments, runContext, turn
             toolName: call.name,
             rawArguments: call.arguments,
             parsedArguments,
+            proposalHash,
+            argsCanonicalJson,
             runContext,
             turn,
         });
     }
     catch (error) {
-        return createDeniedPolicyResult("policy_error", toErrorMetadata(error));
+        return (0, policy_outcomes_1.createDeniedPolicyResult)("policy_error", toErrorMetadata(error));
+    }
+    if (hasDeprecatedDenyMode(rawResult)) {
+        return createDeprecatedDenyModeResult(rawResult.denyMode);
     }
-    if (!isPolicyResult(rawResult)) {
-        return createDeniedPolicyResult("invalid_policy_result");
+    if (!isPolicyResultShape(rawResult)) {
+        return (0, policy_outcomes_1.createDeniedPolicyResult)("invalid_policy_result");
     }
-    return rawResult;
+    return (0, policy_outcomes_1.materializePolicyResult)(rawResult);
 }
 async function evaluateHandoffPolicy(fromAgent, toAgent, call, handoffPayload, runContext, turn, policies) {
     const policy = policies?.handoffPolicy;
     if (!policy) {
-        return createDeniedPolicyResult("policy_not_configured");
+        return (0, policy_outcomes_1.createDeniedPolicyResult)("policy_not_configured");
     }
+    const { proposalHash, payloadCanonicalJson } = (0, proposal_hashing_1.createHandoffProposalFingerprint)({
+        fromAgentName: fromAgent.name,
+        toAgentName: toAgent.name,
+        handoffPayload,
+    });
     let rawResult;
     try {
         rawResult = await policy({
             fromAgentName: fromAgent.name,
             toAgentName: toAgent.name,
             handoffPayload,
+            proposalHash,
+            payloadCanonicalJson,
             runContext,
             turn,
         });
     }
     catch (error) {
-        return createDeniedPolicyResult("policy_error", toErrorMetadata(error));
+        return (0, policy_outcomes_1.createDeniedPolicyResult)("policy_error", toErrorMetadata(error));
+    }
+    if (hasDeprecatedDenyMode(rawResult)) {
+        return createDeprecatedDenyModeResult(rawResult.denyMode);
     }
-    if (!isPolicyResult(rawResult)) {
-        return createDeniedPolicyResult("invalid_policy_result");
+    if (!isPolicyResultShape(rawResult)) {
+        return (0, policy_outcomes_1.createDeniedPolicyResult)("invalid_policy_result");
     }
-    return rawResult;
+    return (0, policy_outcomes_1.materializePolicyResult)(rawResult);
 }
-async function executeToolCall(agent, call, parsedArguments, runContext, turn, logEmitter, policies, onPolicyDecision) {
+async function executeToolCall(agent, runId, call, parsedArguments, runContext, turn, logEmitter, policies, onPolicyDecision, onSuspendedProposal) {
     const definition = agent.tools.find((tool) => tool.name === call.name);
     if (!definition) {
         throw new errors_1.ToolCallError(`Tool "${call.name}" is not registered.`);
     }
     const policyResult = await evaluateToolPolicy(agent, call, parsedArguments, runContext, turn, policies);
-    await logEmitter.toolPolicyEvaluated(agent.name, turn, call.name, call.callId, policyResult.decision, policyResult.reason, policyResult.policyVersion, policyResult.metadata);
-    onPolicyDecision?.({
+    await emitPolicyDecision({
+        kind: "tool",
+        agentName: agent.name,
         turn,
         callId: call.callId,
-        decision: policyResult.decision,
-        reason: policyResult.reason,
-        policyVersion: policyResult.policyVersion,
-        resource: {
-            kind: "tool",
-            name: call.name,
-        },
-        metadata: policyResult.metadata,
+        toolName: call.name,
+        policyResult,
+        logEmitter,
+        onPolicyDecision,
     });
     if (policyResult.decision !== "allow") {
-        if (shouldReturnDeniedAsToolResult(policyResult)) {
-            return toDeniedToolResultEnvelope(policyResult);
+        const suspendedProposal = policyResult.decision === "require_approval"
+            ? (0, suspended_proposals_1.buildSuspendedToolProposal)({
+                runId,
+                agentName: agent.name,
+                turn,
+                callId: call.callId,
+                toolName: call.name,
+                rawArguments: call.arguments,
+                parsedArguments,
+                policyResult,
+            })
+            : undefined;
+        if (suspendedProposal) {
+            onSuspendedProposal?.(suspendedProposal);
         }
-        throw new errors_1.ToolCallPolicyDeniedError({
+        return (0, policy_outcomes_1.handleBlockedPolicyResult)({
+            kind: "tool",
             toolName: call.name,
             policyResult,
+            suspendedProposal,
         });
     }
     const validated = definition.parameters.parse(parsedArguments);
     const toolOutput = await definition.execute(validated, runContext);
-    return toAllowedToolResultEnvelope(toolOutput);
+    return (0, policy_outcomes_1.toAllowedToolResultEnvelope)(toolOutput);
 }
 async function evaluateOutputGuardrails(agent, runContext, history, outputText, logEmitter, turn, onGuardrailDecision) {
     for (const guardrail of agent.outputGuardrails) {
@@ -253,7 +317,7 @@ async function evaluateOutputGuardrails(agent, runContext, history, outputText,
         await logEmitter.outputGuardrailPassed(agent.name, turn, guardrail.name);
     }
 }
-async function* runLoop(state, provider, runContext, maxTurns, logger, policies, onPolicyDecision, onGuardrailDecision, onPromptSnapshot, onRequestFingerprint) {
+async function* runLoop(state, runId, provider, runContext, maxTurns, logger, policies, onPolicyDecision, onSuspendedProposal, onGuardrailDecision, onPromptSnapshot, onRequestFingerprint) {
     const logEmitter = new run_log_emitter_1.RunLogEmitter(logger);
     await logEmitter.runStarted(state.lastAgent.name, maxTurns, state.history.length);
     yield {
@@ -366,33 +430,42 @@ async function* runLoop(state, provider, runContext, maxTurns, logger, policies,
                     try {
                         if (handoffTarget) {
                             const handoffPolicyResult = await evaluateHandoffPolicy(currentAgent, handoffTarget, call, callItemArguments, runContext, activeTurn, policies);
-                            await logEmitter.handoffPolicyEvaluated(currentAgent.name, activeTurn, call.name, call.callId, handoffTarget.name, handoffPolicyResult.decision, handoffPolicyResult.reason, handoffPolicyResult.policyVersion, handoffPolicyResult.metadata);
-                            onPolicyDecision?.({
+                            await emitPolicyDecision({
+                                kind: "handoff",
+                                agentName: currentAgent.name,
                                 turn: activeTurn,
                                 callId: call.callId,
-                                decision: handoffPolicyResult.decision,
-                                reason: handoffPolicyResult.reason,
-                                policyVersion: handoffPolicyResult.policyVersion,
-                                resource: {
-                                    kind: "handoff",
-                                    name: handoffTarget.name,
-                                },
-                                metadata: handoffPolicyResult.metadata,
+                                handoffName: call.name,
+                                toAgentName: handoffTarget.name,
+                                policyResult: handoffPolicyResult,
+                                logEmitter,
+                                onPolicyDecision,
                             });
                             if (handoffPolicyResult.decision !== "allow") {
-                                if (shouldReturnDeniedAsToolResult(handoffPolicyResult)) {
-                                    toolOutput = toDeniedToolResultEnvelope(handoffPolicyResult);
-                                }
-                                else {
-                                    throw new errors_1.HandoffPolicyDeniedError({
-                                        fromAgent: currentAgent.name,
-                                        toAgent: handoffTarget.name,
+                                const suspendedProposal = handoffPolicyResult.decision === "require_approval"
+                                    ? (0, suspended_proposals_1.buildSuspendedHandoffProposal)({
+                                        runId,
+                                        fromAgentName: currentAgent.name,
+                                        toAgentName: handoffTarget.name,
+                                        turn: activeTurn,
+                                        callId: call.callId,
+                                        handoffPayload: callItemArguments,
                                         policyResult: handoffPolicyResult,
-                                    });
+                                    })
+                                    : undefined;
+                                if (suspendedProposal) {
+                                    onSuspendedProposal?.(suspendedProposal);
                                 }
+                                toolOutput = (0, policy_outcomes_1.handleBlockedPolicyResult)({
+                                    kind: "handoff",
+                                    fromAgent: currentAgent.name,
+                                    toAgent: handoffTarget.name,
+                                    policyResult: handoffPolicyResult,
+                                    suspendedProposal,
+                                });
                             }
                             else {
-                                toolOutput = toAllowedToolResultEnvelope({
+                                toolOutput = (0, policy_outcomes_1.toAllowedToolResultEnvelope)({
                                     handoffTo: handoffTarget.name,
                                     accepted: true,
                                     payload: callItemArguments,
@@ -402,7 +475,7 @@ async function* runLoop(state, provider, runContext, maxTurns, logger, policies,
                             }
                         }
                         else {
-                            toolOutput = await executeToolCall(currentAgent, call, callItemArguments, runContext, activeTurn, logEmitter, policies, onPolicyDecision);
+                            toolOutput = await executeToolCall(currentAgent, runId, call, callItemArguments, runContext, activeTurn, logEmitter, policies, onPolicyDecision, onSuspendedProposal);
                         }
                     }
                     catch (error) {
@@ -495,7 +568,7 @@ async function run(startingAgent, input, options = {}) {
         providerName: provider.constructor.name,
         recordOptions: options.record,
     });
-    const rawStream = runLoop(state, provider, runContext, maxTurns, options.logger, options.policies, runRecorder.onPolicyDecision, runRecorder.onGuardrailDecision, runRecorder.onPromptSnapshot, runRecorder.onRequestFingerprint);
+    const rawStream = runLoop(state, runRecorder.runId, provider, runContext, maxTurns, options.logger, options.policies, runRecorder.onPolicyDecision, runRecorder.onSuspendedProposal, runRecorder.onGuardrailDecision, runRecorder.onPromptSnapshot, runRecorder.onRequestFingerprint);
     const runRecordSnapshot = () => ({
         agentName: state.lastAgent.name,
         model: state.lastAgent.model,

package/dist/suspended-proposals.d.ts

@@ -0,0 +1,22 @@
+import type { PolicyResult } from "./policy";
+import type { SuspendedProposal } from "./run-record";
+export declare function buildSuspendedToolProposal(params: {
+    runId: string;
+    agentName: string;
+    turn: number;
+    callId: string;
+    toolName: string;
+    rawArguments: string;
+    parsedArguments: unknown;
+    policyResult: PolicyResult;
+}): SuspendedProposal;
+export declare function buildSuspendedHandoffProposal(params: {
+    runId: string;
+    fromAgentName: string;
+    toAgentName: string;
+    turn: number;
+    callId: string;
+    handoffPayload: unknown;
+    policyResult: PolicyResult;
+}): SuspendedProposal;
+//# sourceMappingURL=suspended-proposals.d.ts.map

package/dist/suspended-proposals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suspended-proposals.d.ts","sourceRoot":"","sources":["../src/suspended-proposals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAK7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,YAAY,CAAC;CAC5B,GAAG,iBAAiB,CAyBpB;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,YAAY,CAAC;CAC5B,GAAG,iBAAiB,CA0BpB"}

package/dist/suspended-proposals.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSuspendedToolProposal = buildSuspendedToolProposal;
+exports.buildSuspendedHandoffProposal = buildSuspendedHandoffProposal;
+const proposal_hashing_1 = require("./proposal-hashing");
+function buildSuspendedToolProposal(params) {
+    const { argsCanonicalJson, proposalHash } = (0, proposal_hashing_1.createToolProposalFingerprint)({
+        agentName: params.agentName,
+        toolName: params.toolName,
+        parsedArguments: params.parsedArguments,
+    });
+    return {
+        timestamp: new Date().toISOString(),
+        kind: "tool",
+        runId: params.runId,
+        turn: params.turn,
+        callId: params.callId,
+        agentName: params.agentName,
+        proposalHash,
+        reason: params.policyResult.reason,
+        publicReason: params.policyResult.publicReason,
+        policyVersion: params.policyResult.policyVersion,
+        expiresAt: params.policyResult.expiresAt,
+        metadata: params.policyResult.metadata,
+        toolName: params.toolName,
+        rawArguments: params.rawArguments,
+        parsedArguments: params.parsedArguments,
+        argsCanonicalJson,
+    };
+}
+function buildSuspendedHandoffProposal(params) {
+    const { payloadCanonicalJson, proposalHash } = (0, proposal_hashing_1.createHandoffProposalFingerprint)({
+        fromAgentName: params.fromAgentName,
+        toAgentName: params.toAgentName,
+        handoffPayload: params.handoffPayload,
+    });
+    return {
+        timestamp: new Date().toISOString(),
+        kind: "handoff",
+        runId: params.runId,
+        turn: params.turn,
+        callId: params.callId,
+        agentName: params.fromAgentName,
+        proposalHash,
+        reason: params.policyResult.reason,
+        publicReason: params.policyResult.publicReason,
+        policyVersion: params.policyResult.policyVersion,
+        expiresAt: params.policyResult.expiresAt,
+        metadata: params.policyResult.metadata,
+        fromAgentName: params.fromAgentName,
+        toAgentName: params.toAgentName,
+        handoffPayload: params.handoffPayload,
+        payloadCanonicalJson,
+    };
+}

package/dist/tool.d.ts

@@ -6,11 +6,20 @@ export interface Tool<TContext = unknown, TOutput = unknown> {
     parameters: z.ZodTypeAny;
     execute: (input: unknown, runContext?: RunContext<TContext>) => Promise<TOutput> | TOutput;
 }
-export type ToolConfig<TContext = unknown, TSchema extends z.ZodTypeAny = z.ZodTypeAny, TOutput = unknown> = {
+type ToolConfigWithParameters<TContext = unknown, TSchema extends z.ZodTypeAny = z.ZodTypeAny, TOutput = unknown> = {
     name: string;
     description: string;
     parameters: TSchema;
     execute: (input: z.infer<TSchema>, runContext?: RunContext<TContext>) => Promise<TOutput> | TOutput;
 };
-export declare function tool<TContext = unknown, TSchema extends z.ZodTypeAny = z.ZodTypeAny, TOutput = unknown>(config: ToolConfig<TContext, TSchema, TOutput>): Tool<TContext, TOutput>;
+type ToolConfigWithoutParameters<TContext = unknown, TOutput = unknown> = {
+    name: string;
+    description: string;
+    parameters?: undefined;
+    execute: (input: Record<string, never>, runContext?: RunContext<TContext>) => Promise<TOutput> | TOutput;
+};
+export type ToolConfig<TContext = unknown, TSchema extends z.ZodTypeAny = z.ZodTypeAny, TOutput = unknown> = ToolConfigWithParameters<TContext, TSchema, TOutput> | ToolConfigWithoutParameters<TContext, TOutput>;
+export declare function tool<TContext = unknown, TOutput = unknown>(config: ToolConfigWithoutParameters<TContext, TOutput>): Tool<TContext, TOutput>;
+export declare function tool<TContext = unknown, TSchema extends z.ZodTypeAny = z.ZodTypeAny, TOutput = unknown>(config: ToolConfigWithParameters<TContext, TSchema, TOutput>): Tool<TContext, TOutput>;
+export {};
 //# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,WAAW,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC;IACzB,OAAO,EAAE,CACP,KAAK,EAAE,OAAO,EACd,UAAU,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,KAC9B,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjC;AAED,MAAM,MAAM,UAAU,CACpB,QAAQ,GAAG,OAAO,EAClB,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,EAC3C,OAAO,GAAG,OAAO,IACf;IACF,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CACP,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EACvB,UAAU,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,KAC9B,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,wBAAgB,IAAI,CAClB,QAAQ,GAAG,OAAO,EAClB,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,EAC3C,OAAO,GAAG,OAAO,EACjB,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAEzE"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,WAAW,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC;IACzB,OAAO,EAAE,CACP,KAAK,EAAE,OAAO,EACd,UAAU,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,KAC9B,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjC;AAED,KAAK,wBAAwB,CAC3B,QAAQ,GAAG,OAAO,EAClB,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,EAC3C,OAAO,GAAG,OAAO,IACf;IACF,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CACP,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EACvB,UAAU,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,KAC9B,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,KAAK,2BAA2B,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,OAAO,EAAE,CACP,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAC5B,UAAU,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,KAC9B,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,UAAU,CACpB,QAAQ,GAAG,OAAO,EAClB,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,EAC3C,OAAO,GAAG,OAAO,IAEf,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,GACpD,2BAA2B,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAEnD,wBAAgB,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACxD,MAAM,EAAE,2BAA2B,CAAC,QAAQ,EAAE,OAAO,CAAC,GACrD,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAE3B,wBAAgB,IAAI,CAClB,QAAQ,GAAG,OAAO,EAClB,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,EAC3C,OAAO,GAAG,OAAO,EAEjB,MAAM,EAAE,wBAAwB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,GAC3D,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC"}