@eon-risk-services/personality-sdk

Portable personality layer for EON appliances. A bonded personality.json document that remembers its owner across products.

Status: alpha, schema v1.0.0, not yet on npm. First publish ships in BuildMySite v2 Phase 1 Task 1.6.

What this is

One JSON file that holds who the owner is — their voice, audience, taboos, visual tokens, and content patterns — plus an append-only learning log that accumulates as EON appliances watch them work.

Every current and future EON appliance reads from and writes to the same personality file, so the owner's tools get more them the longer they're used.

What ships in v0.1 (Task 1.2)

• PersonalityV1Schema — Zod runtime validator
• PersonalityV1 — TypeScript type (inferred from schema, single source of truth)
• validatePersonality(input) — strict parse, throws on invalid input
• safeValidatePersonality(input) — non-throwing parse, returns { success, data | error }
• createEmptyPersonality(id, name, kind) — bootstrap a fresh personality with safe defaults

What's coming

• v0.2 — Vercel Blob storage layer with optimistic concurrency (Task 1.3)
• v0.3 — recordLearning() append-only with decay model (Task 1.4)
• v0.4 — vitest coverage (Task 1.5)
• v0.1.0-alpha.0 — first npm publish (Task 1.6)

Schema reference

See docs/architecture.md §5.1 in the BuildMySite v2 monorepo for the full schema definition, rationale, and storage model.

Design principles

1. Append-only. Learning entries are never deleted — contradicted entries are soft-marked superseded: true so the history survives.
2. Portable-first. The SDK is a pure library. It has no service dependency beyond Vercel Blob (added in v0.2), and could swap storage backends without changing the type surface.
3. Schema is the contract. The Zod schema is the single source of truth. TypeScript types are inferred, never hand-maintained.
4. No PII beyond what the owner provides. The personality stores what the owner explicitly entered about themselves — no analytics, no derived PII, no telemetry.

License

MIT.