← Files LLM & Agent Builder CopilotARCHIVED FILE

references/tool-boundaries.md

1002 Bytes · Nov 21, 2026 · 12:41 UTC

↓ Download file

See the change to this file →

# Tool schema and side-effect contracts
A tool boundary is an authorization boundary. Document: unique action name, caller scope, tenant, mandatory inputs, types/ranges, result schema, read/write/destructive class, resource identifier, auth checks, approval, idempotency key, timeout/retries, rate limit, and audit redaction.

A successful JSON schema validation does not establish a user's permission. Verify ownership at the server with the authenticated principal. For write actions use preflight preview, explicit confirmation for consequential changes, and an idempotency key bound to the mutation. Model-generated text cannot grant itself access or re-use an approval for altered arguments.

Define error codes: INVALID_ARGUMENT, UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT, TIMEOUT, RATE_LIMIT, INTERNAL. Return safe output without credentials. Test malformed args, cross-tenant identifiers, retries, duplicate keys, timeout-after-commit and denied approvals. See `templates/tool-contract.md`.

SHA-256: cd7c8c5877eb377a80fe2bfbfd092e6fd0cc6b75fd5649f33432118644a4edde