Tools
SDK Cheat Sheet
| Operation | Python | TypeScript |
|---|
| Initialise | CreedClient(api_key=...) | createClient({ apiKey: ... }) |
| Evaluate | await client.decide(tool_name, arguments, constitution_id) | await client.decide({ toolName, arguments, constitutionId }) |
| Verify token | await client.authorize(decision_token, tool_name, args_hash) | await client.authorize({ decisionToken, toolName, argsHash }) |
| Audit trail | await client.audit(run_id) | await client.audit({ runId }) |
| Args hash | compute_args_hash(args) | await computeArgsHash(args) |
| Token expiry | is_token_expired(token) | isTokenExpired(token) |
| Service status | await client.status() | await client.status() |
Decision Types
| Decision | Meaning | Your Action |
|---|
ALLOW | Action permitted by constitution | Proceed; store decision token for downstream authorisation |
DENY | Action violates constitution | Show reasons and guidance to user; suggest modifications |
REQUIRE_HUMAN | Constitution requires human review | Route to reviewer; await decision (planned feature) |
Verification States (Grouped)
| Category | States | Response |
|---|
| Success | VALID | Apply the bundle |
| Security | INVALID_SIGNATURE, HASH_MISMATCH, REPLAY_DETECTED, INVALID_ATTESTATION, UNTRUSTED_ISSUER, UNTRUSTED_AUDITOR | Reject immediately |
| Temporal | EXPIRED, NOT_YET_VALID, REVOKED, FUTURE_TIMESTAMP | Fetch fresh bundle |
| Configuration | INVALID_SCHEMA, SIZE_EXCEEDED, SCOPE_MISMATCH, BUDGET_EXCEEDED, TOKEN_MISMATCH | Fix configuration |
| Transient | FETCH_FAILED, VERIFICATION_TIMEOUT | Retry or use fallback |
CSM-1 Quick Reference
Format: {persona}{level}[+scopes][:namespace][@version]
Personas: N(anny), Z(sentinel), G(odparent), A(mbassador), M(use), D(mediator), C(ustom)
Levels: 0 (disabled) to 5 (maximum)
Scopes: F(amily), W(ork), E(ducation), H(ealth), I(nance), L(egal), P(rivacy), S(afety), A(ccessibility), V(environment), G(eneral)
Prosaic Context Dimensions
| Dimension | Values | Intensity |
|---|
| Cognitive State | focused, distracted, overloaded, foggy, reflective | 1–5 |
| Emotional Tone | calm, tense, frustrated, neutral, uplifted | 1–5 |
| Energy Level | rested, low_energy, fatigued, wired, depleted | 1–5 |
| Perceived Urgency | unhurried, time_aware, pressured, critical | 1–5 |
| Body Signals | neutral, discomfort, pain, unwell, recovering | 1–5 |
Attestation Types
| Type | Purpose |
|---|
INJECTION_SAFE | Content scanned for prompt injection |
CONTENT_SAFE | General content safety review |
FULL_AUDIT | Comprehensive audit of all claims |
METTLE_VERIFICATION | METTLE inverse Turing test verification |
METTLE_GEOMETRIC | METTLE + KV-cache geometry (open-weight only) |
BILATERAL_VERIFIED | Bilateral alignment verification |