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.
Properties
Section titled “Properties”appHash?
Section titled “appHash?”
optionalappHash?: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
Section titled “callId”callId:
string
Defined in: packages/sdk/src/vendor/agent-safety/pending.ts:24
The id of the tool call that waits.
createdAt
Section titled “createdAt”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
Section titled “inputHash”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.
policyVersion?
Section titled “policyVersion?”
optionalpolicyVersion?: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.
question?
Section titled “question?”
optionalquestion?:string
Defined in: packages/sdk/src/vendor/agent-safety/pending.ts:40
The question a clarification asks.
reason?
Section titled “reason?”
optionalreason?:string
Defined in: packages/sdk/src/vendor/agent-safety/pending.ts:42
Why the call needs a person, as shown to the approver.
signature
Section titled “signature”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.