Skip to main content

Digital Persona API — Sancio runtime + Cerno 7-step cycle (AGPL v3 / Commercial dual)

Project description

persona-api (Sancio)

Digital Persona API — private deployment for VPS.

Sancio is the runtime that serves the Claude-powered digital persona behind munio.ai-king.dev. It wraps Anthropic's Claude API with:

  • Bearer auth (JWT HS256) on every RCE-capable endpoint.
  • Per-user daily + monthly USD budget caps (persona.budget).
  • Tenant workspace sandbox for tool calls.
  • GDPR Art 15/17 data-subject endpoints (/v1/gdpr/*).
  • U.S. EAR geo-block middleware (returns HTTP 451 for embargoed regions).
  • A2A (agent-to-agent) protocol for peer invocations.

See CHANGELOG.md for the version history.

Export Control Notice

This software dispatches requests to the Anthropic Claude API, which is subject to U.S. Export Administration Regulations (EAR) and OFAC sanctions. Users are responsible for compliance with applicable export control laws. This software is not for use in embargoed or sanctioned jurisdictions, including but not limited to Cuba, Iran, North Korea, Syria, and mainland China. The default GeoBlockMiddleware blocks requests from these regions at the ASGI layer; operators are expected to add a matching Cloudflare WAF firewall rule as the primary gate. See docs/export-control.md for the runbook.

Privacy

Sancio is designed to comply with GDPR as a data controller for EU users under Art 3(2) territorial scope. The machine- readable privacy policy is served at GET /v1/privacy; the Record of Processing Activities lives at docs/ropa.md.

Data-subject rights:

  • Art 15 access — POST /v1/gdpr/export
  • Art 17 erasure — POST /v1/gdpr/delete

Contact: privacy@ai-king.dev.

Deploy

VPS 5.104.83.69 is the single source of truth. No local Docker. See RELEASE_COORDINATION.md for the upgrade protocol.

License

persona-api (Sancio) is dual-licensed under:

  1. GNU Affero General Public License v3.0 or later (AGPL-3.0-or-later) — the default. Use, modify, and redistribute freely, including over a network, provided you comply with §13 (network-use disclosure of complete corresponding source). See LICENSE.
  2. Commercial License — for organizations that cannot or will not comply with AGPL §13 (most commercial SaaS deployments) or whose internal policy bans AGPL-licensed dependencies. See COMMERCIAL_LICENSE.md for tiers, pricing, and contact.

Differentiation note. persona-api hosts the Cerno 7-step maternal-agent cycle that does not exist in upstream Concinno — sense → orient → guard-budget → think → act → verify → consolidate. The Cerno cycle is a separate trade-secret-protected derivative work; commercial licensees of persona-api also receive the right to deploy the Cerno cycle in production. See COMMERCIAL_LICENSE.md § "What's Included" for the full delta.

L6 PostToolUse — observation-channel deny + Pre-hook escalation. Sancio 2.0.0 closes the CC SDK April 2026 surface gap (updatedToolOutput

  • ConfigChange) and reframes the long-standing "L6 hard deny" promise. CC's L6 ceiling — "PostToolUse cannot block tool execution" — is a physics constraint, not an implementation choice (see anthropics/claude-code#32105). Once tool.execute() returns, side effects exist; no runtime can magic-undo them. What Sancio uniquely owns is observation-channel deny + Pre-hook escalation: a post-hook can replace the LLM-visible tool result with is_error=True (CC's updatedToolOutput rewrites silently — no error flag) AND mutate the pre-hook policy state so iteration N+1 hits a real PreToolUse hard-deny on the next attempt. Both mechanisms compose with the new ConfigChangeEvent watcher for live-reload of policy DSL. See docs/migration-1.3-to-2.0.md for the migration guide and _AI_BRAIN/05_Planning/2026-05-01-l6-posttooluse-design-conflict-options.md for the Option C verdict.

Trademarks. "Sancio", "Cerno", "Concinno", "ZIQ", "FieldRead", "PSYCHE", and "TACB" are trademarks of Chen Syuan Wang (王晨宣 / AI King). AGPL grant does not include trademark rights.

Sole copyright. All persona-api / Sancio / Cerno copyright is held by Chen Syuan Wang as sole author. For acquisition or strategic partnership discussions: me@ai-king.dev.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

persona_api-2.1.0.tar.gz (463.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

persona_api-2.1.0-py3-none-any.whl (350.6 kB view details)

Uploaded Python 3

File details

Details for the file persona_api-2.1.0.tar.gz.

File metadata

  • Download URL: persona_api-2.1.0.tar.gz
  • Upload date:
  • Size: 463.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for persona_api-2.1.0.tar.gz
Algorithm Hash digest
SHA256 8800eb30f7b72b3ddff1399f202f8f57f6e7e41703e2d4c9577c370ba79463e4
MD5 74fdcdc6fa6fe4ab5ddee74c1c82355f
BLAKE2b-256 e21849881f16471ad5df4d293f47c286a263e15c4c5f9a7e581d64a514ba021b

See more details on using hashes here.

File details

Details for the file persona_api-2.1.0-py3-none-any.whl.

File metadata

  • Download URL: persona_api-2.1.0-py3-none-any.whl
  • Upload date:
  • Size: 350.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for persona_api-2.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 b6738577fbb9d2a3669369cc15561f138e55b43814f1742fbd0d82eda9a7c0e6
MD5 3f807ce9e8a5ce11051a474e94cc910f
BLAKE2b-256 36eaf0f600b853909b7d2fdc731add71f9f2894e2c1bc962b40117a6b0d3c0de

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page