Skip to content

SignedPendingRequest

Defined in: packages/sdk/src/vendor/agent-safety/pending.ts:18

A pause waiting for a person: an approval of one tool call, or a question about it. signature signs id, kind, callId, tool, inputHash and policyVersion under the key keyId names. question, reason and createdAt are shown to people and aren’t signed, so never let them decide anything.

optional appHash?: string

Defined in: packages/sdk/src/vendor/agent-safety/pending.ts:38

A MAC of the app data the run held when it paused, such as the signed-in customer, when it held any: the signer’s signature over the app’s canonical JSON, under the key keyId names and a domain tag of its own. The request’s signature covers it, so the call runs only for the caller whose app data the host passes back. It is keyed, so reading it reveals nothing about a small value such as a customer id. A request without it, such as one signed before this field existed, binds no app data.


callId: string

Defined in: packages/sdk/src/vendor/agent-safety/pending.ts:24

The id of the tool call that waits.


createdAt: string

Defined in: packages/sdk/src/vendor/agent-safety/pending.ts:48

When the request was signed, as an ISO 8601 timestamp.


id: string

Defined in: packages/sdk/src/vendor/agent-safety/pending.ts:20

The request’s own id, which a Resolution names.


inputHash: string

Defined in: packages/sdk/src/vendor/agent-safety/pending.ts:28

canonicalInputHash() of the call’s input.


keyId: string

Defined in: packages/sdk/src/vendor/agent-safety/pending.ts:44

The id of the key that made signature.


kind: "approval" | "clarification"

Defined in: packages/sdk/src/vendor/agent-safety/pending.ts:22

approval waits for allow or deny; clarification waits for an answer.


optional policyVersion?: string

Defined in: packages/sdk/src/vendor/agent-safety/pending.ts:30

The version of the policy that asked for the pause, if the host versions its policy.


optional question?: string

Defined in: packages/sdk/src/vendor/agent-safety/pending.ts:40

The question a clarification asks.


optional reason?: string

Defined in: packages/sdk/src/vendor/agent-safety/pending.ts:42

Why the call needs a person, as shown to the approver.


signature: string

Defined in: packages/sdk/src/vendor/agent-safety/pending.ts:46

The signature, as base64url.


tool: string

Defined in: packages/sdk/src/vendor/agent-safety/pending.ts:26

The tool’s name.

These docs are licensedCC BY 4.0. Thelicence text is in the repository.