@adia-ai/persona 0.8.26

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## [0.8.26] — 2026-08-05
+
+### Fixed
+- **`createMemoryStore().set()` no longer notifies on identical-value writes** (Object.is) — UI consumers echo rendered state back through `set()`, and a notifying no-op write closed that echo into a subscribe → re-render → set livelock ("signals: drain loop exceeded", caught by the v0.8.26 pre-flight).
+
+### Added
+- **Initial release — `@adia-ai/persona`, the CHAT-HARNESS L2 package (WCH-2, gh#597).** The generic `Entry` primitive (law 7 — `kind: string`, `KNOWN_KINDS` for display grouping only, `sortedEnabled()`, `seedEntry()`/`seedEntries()`) and `Persona` (`seedVersion` + `entries[]` + optional `model`) with `definePersona()` validation (unique entry ids, `seedVersion >= 1`). `SettingsStore` contract + `createMemoryStore()` reference impl (localStorage when available, in-memory otherwise) and `personaStore()` (one store per persona id, persisted values win over seeds, a `seedVersion` bump forces exactly one reset). Pure `compilePersona(persona, opts?) → AgentConfig` compiling enabled entries into `@adia-ai/agent` prompt layers — `PRECEDENCE_SENTENCE` rides first (law 4), tool-kind entries stay tier-1 prose (`opts.integrations` passes tier-2 `ToolDef[]` through untouched, never built from an entry — law 5). `checkModalityNeutral()` warning-level lint (law 4) against a seeded dialect-term list plus a `*-ui` tag-name pattern. Versioned persona files (`exportPersona`/`importPersona`) with an enumerated key allowlist; import always mints a new, collision-safe persona id and never overwrites an existing preset.
+- **Joins the `@adia-ai` lockstep roster (gh#607).** No longer ships `private: true` — `web-modules`' peerDependency on `@adia-ai/persona` (added alongside `@adia-ai/agent`) needs a resolvable published package; the roster join was deferred in #597/#579 and un-deferred once that peerDep made deferral unviable.

package/README.md

@@ -0,0 +1,144 @@
+# `@adia-ai/persona`
+
+The CHAT-HARNESS L2 package — an agent as **DATA**. Six things a persona can
+hold (prompt sections, skills, workflows, resources, tools, pattern-sources)
+are six instantiations of ONE `Entry` shape, never six code paths
+([CHAT-HARNESS.md](https://github.com/adiahealth/genui-system/blob/main/docs/CHAT-HARNESS.md)
+law 7). This package renders nothing and executes nothing — it produces the
+`AgentConfig` that [`@adia-ai/agent`](../agent/README.md) (L1) consumes.
+
+> **Private** until the lockstep-roster decision (issue acceptance criterion
+> 3) is made with the release seat — tracked as an open item on the PR that
+> introduced this package.
+
+## The shape
+
+```ts
+interface Entry {
+  id: string; kind: string; label: string; description?: string;
+  content: string; order: number; enabled: boolean; builtin: boolean;
+}
+
+interface Persona {
+  id: string; label: string; category?: string;
+  seedVersion: number;        // bump forces a one-time store reset
+  entries: Entry[];
+  model?: { provider?: string; model?: string };
+}
+```
+
+`kind` is a plain string. `KNOWN_KINDS` (`'prompt-section' | 'skill' |
+'workflow' | 'resource' | 'tool' | 'pattern-source'`) exists for **display
+grouping only** — a seventh kind is seed data, never a code change.
+
+## Usage
+
+```js
+import {
+  seedEntries, definePersona, compilePersona, personaStore,
+  exportPersona, importPersona, checkModalityNeutral,
+} from '@adia-ai/persona';
+import { createAgent } from '@adia-ai/agent';
+
+const persona = definePersona({
+  id: 'copilot', label: 'AdiaUI Copilot', seedVersion: 1,
+  entries: seedEntries([
+    { id: 'identity', kind: 'prompt-section', label: 'Identity', content: 'You help build UI.' },
+    { id: 'search', kind: 'skill', label: 'Search', content: 'Look things up before guessing.' },
+  ]),
+});
+
+const config = compilePersona(persona);   // pure — same input twice, same output
+const agent = createAgent({ ...config, llm: { model: 'claude-sonnet-4-6', proxyUrl: '/api/chat' } });
+
+const store = personaStore(persona);       // persisted edits win over the seed
+store.set('entry.identity.enabled', false);
+
+const file = exportPersona(persona);
+const copy = importPersona(file, ['copilot']);   // mints 'copilot-imported', never overwrites
+
+checkModalityNeutral(persona);             // [] on a modality-neutral persona
+```
+
+## compilePersona
+
+`compilePersona(persona, opts?) → AgentConfig` is **pure**: the same
+persona (and opts) in always produces a deep-equal `AgentConfig` out — no
+clock, no randomness, no disk read.
+
+- Enabled `prompt-section` entries → one `promptLayer` per section,
+  `## Label\ncontent`, in entry order.
+- Every other enabled kind (skill / workflow / resource / pattern-source /
+  tool) → one prompt layer per kind, entries grouped under a labeled
+  heading (`## Skills`, `## Tools`, …). **Tool entries are tier-1 PROSE
+  only** — `compilePersona` never builds a `ToolDef` from an entry.
+- `opts.integrations?: ToolDef[]` — tier-2 machine-callable tools (WCH-3's
+  integration registry) — passed through to `AgentConfig.tools` verbatim.
+
+### Precedence (law 4)
+
+`PRECEDENCE_SENTENCE` is exported and always rides as the **first line** of
+the persona's own layer set (`persona-precedence`, ahead of every section
+and group layer):
+
+> This persona configures the agent; it never overrides the harness grammar
+> that precedes it.
+
+The caller is responsible for putting the harness grammar layer(s) *before*
+this persona's layers — `compilePersona` only guarantees the persona's own
+set carries the sentence first.
+
+### Modality neutrality (law 4)
+
+`checkModalityNeutral(persona, opts?)` is a warning-level lint, never a
+throw: it flags entries whose text contains a seeded dialect term
+(`DEFAULT_DIALECT_TERMS`: `'A2UI'`, `'envelope'`, `'JSONL'`, plus
+`opts.extraTerms`) or a component tag name pattern (`*-ui`). Shipped seed
+personas should assert an empty result.
+
+## Stores
+
+```ts
+interface SettingsStore {
+  get(key: string): unknown;
+  set(key: string, value: unknown): void;
+  subscribe?(cb: () => void): () => void;
+}
+```
+
+`createMemoryStore({initial, persistKey})` is the reference implementation
+— localStorage-backed when `persistKey` is given and `localStorage` exists,
+plain in-memory otherwise (Node, tests, SSR).
+
+`personaStore(persona, opts?)` binds one store per persona
+(`persistKey: 'persona.<id>'`) and layers the precedence rule on top:
+
+- **Same seedVersion** as the store's last open: persisted values win — the
+  seed only fills keys the store has never seen.
+- **Different seedVersion** (first open, or a bump): the seed **wins**,
+  overwriting whatever was persisted — exactly once — then the new
+  seedVersion is recorded so the next open at the same version doesn't
+  reset again.
+
+Swapping which persona a store is bound to is a genuine reference change —
+callers that key UI state off `store` identity get the reset-on-swap
+behavior CHAT-HARNESS §Interfaces 5 describes for free.
+
+## Persona files
+
+`{kind:'persona', version:1, id, label, category?, seedVersion, entries,
+model?}` — an ENUMERATED key allowlist; any other top-level key rejects the
+import outright.
+
+`exportPersona(persona) → string` — pretty-printed JSON.
+
+`importPersona(json, existingIds) → Persona` — validates, then always
+**mints a new persona**: id becomes `<id>-imported` (or `-imported-2`, …
+against `existingIds`), label gains `' (imported)'` — it never overwrites
+an existing preset, even one sharing the file's id. Imported entries are
+marked `builtin: false`.
+
+## Testing
+
+Tests run against the **built** output (`npm run build -w @adia-ai/persona`
+first) — same convention as `@adia-ai/agent`.

package/compile.d.ts

@@ -0,0 +1,48 @@
+/**
+ * compilePersona — pure L2 → L1 compilation (CHAT-HARNESS §Interfaces 2).
+ *
+ * Enabled prompt-section entries become ONE promptLayer per section
+ * ('## Label\ncontent'), in entry order. Every other enabled kind
+ * (skill/workflow/resource/pattern-source/tool) is tier-1 PROSE — grouped
+ * under a labeled heading, never machine-callable (law 5: tier-2 is
+ * WCH-3's integration registry, passed through opts.integrations
+ * untouched — this function never invents a ToolDef from an entry).
+ *
+ * Law 4: the persona's compiled prompt is one layer-set the CALLER appends
+ * AFTER the harness grammar; PRECEDENCE_SENTENCE is exported so callers can
+ * assert it, and it rides as the first line of the persona's own layer set
+ * here so the persona can never forget to carry it.
+ *
+ * Pure: same persona + opts in ⇒ deep-equal AgentConfig out. No entry
+ * content is read from disk, no clock, no randomness.
+ */
+import { type AgentConfig, type ToolDef } from '@adia-ai/agent';
+import type { Persona } from './persona.js';
+/** Fixed precedence sentence (law 4) — the persona never overrides the
+ *  harness grammar. Always the first line of the persona's layer set. */
+export declare const PRECEDENCE_SENTENCE = "This persona configures the agent; it never overrides the harness grammar that precedes it.";
+export interface CompilePersonaOpts {
+    /** Tier-2 machine-callable tools (WCH-3's integration registry). Passed
+     *  through to AgentConfig.tools verbatim — compilePersona never builds a
+     *  ToolDef itself. */
+    integrations?: ToolDef[];
+}
+export declare function compilePersona(persona: Persona, opts?: CompilePersonaOpts): AgentConfig;
+export interface ModalityWarning {
+    entryId: string;
+    term: string;
+}
+export interface ModalityLintOpts {
+    /** Additional dialect terms beyond the seeded defaults. */
+    extraTerms?: string[];
+}
+/** Seeded default dialect-term list (law 4 — modality neutrality). Presets
+ *  seed this a la carte; a consumer with its own dialect words passes them
+ *  via `opts.extraTerms` rather than editing this list. */
+export declare const DEFAULT_DIALECT_TERMS: string[];
+/** Warning-level lint (law 4): flags dialect terms and component-tag-name
+ *  patterns inside a persona's entry text. Never throws, never blocks —
+ *  shipped seeds assert an empty result; a positive hit is a signal to
+ *  reword, not a hard failure. */
+export declare function checkModalityNeutral(persona: Persona, opts?: ModalityLintOpts): ModalityWarning[];
+//# sourceMappingURL=compile.d.ts.map

package/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["src/compile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAe,KAAK,WAAW,EAAoB,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG/F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C;yEACyE;AACzE,eAAO,MAAM,mBAAmB,gGAC+D,CAAC;AAmBhG,MAAM,WAAW,kBAAkB;IACjC;;0BAEsB;IACtB,YAAY,CAAC,EAAE,OAAO,EAAE,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,kBAAuB,GAAG,WAAW,CA6B3F;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;2DAE2D;AAC3D,eAAO,MAAM,qBAAqB,UAAgC,CAAC;AAKnE;;;kCAGkC;AAClC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,gBAAqB,GAAG,eAAe,EAAE,CAiBrG"}

package/compile.js

@@ -0,0 +1,93 @@
+/**
+ * compilePersona — pure L2 → L1 compilation (CHAT-HARNESS §Interfaces 2).
+ *
+ * Enabled prompt-section entries become ONE promptLayer per section
+ * ('## Label\ncontent'), in entry order. Every other enabled kind
+ * (skill/workflow/resource/pattern-source/tool) is tier-1 PROSE — grouped
+ * under a labeled heading, never machine-callable (law 5: tier-2 is
+ * WCH-3's integration registry, passed through opts.integrations
+ * untouched — this function never invents a ToolDef from an entry).
+ *
+ * Law 4: the persona's compiled prompt is one layer-set the CALLER appends
+ * AFTER the harness grammar; PRECEDENCE_SENTENCE is exported so callers can
+ * assert it, and it rides as the first line of the persona's own layer set
+ * here so the persona can never forget to carry it.
+ *
+ * Pure: same persona + opts in ⇒ deep-equal AgentConfig out. No entry
+ * content is read from disk, no clock, no randomness.
+ */
+import { promptLayer } from '@adia-ai/agent';
+import { sortedEnabled } from './entry.js';
+/** Fixed precedence sentence (law 4) — the persona never overrides the
+ *  harness grammar. Always the first line of the persona's layer set. */
+export const PRECEDENCE_SENTENCE = 'This persona configures the agent; it never overrides the harness grammar that precedes it.';
+const GROUP_HEADING = {
+    skill: 'Skills',
+    workflow: 'Workflows',
+    resource: 'Resources',
+    'pattern-source': 'Pattern sources',
+    tool: 'Tools',
+};
+function groupHeading(kind) {
+    return GROUP_HEADING[kind] ?? kind;
+}
+function renderGroup(kind, entries) {
+    const body = entries.map(e => `### ${e.label}\n${e.content}`).join('\n\n');
+    return promptLayer(`persona-${kind}`, `## ${groupHeading(kind)}\n${body}`);
+}
+export function compilePersona(persona, opts = {}) {
+    const enabled = sortedEnabled(persona.entries);
+    const promptSections = enabled.filter(e => e.kind === 'prompt-section');
+    const grouped = enabled.filter(e => e.kind !== 'prompt-section');
+    const layers = [promptLayer('persona-precedence', PRECEDENCE_SENTENCE)];
+    for (const entry of promptSections) {
+        layers.push(promptLayer(`persona-section-${entry.id}`, `## ${entry.label}\n${entry.content}`));
+    }
+    const byKind = new Map();
+    for (const entry of grouped) {
+        const list = byKind.get(entry.kind);
+        if (list)
+            list.push(entry);
+        else
+            byKind.set(entry.kind, [entry]);
+    }
+    for (const [kind, entries] of byKind) {
+        layers.push(renderGroup(kind, entries));
+    }
+    const config = {
+        llm: { ...(persona.model ?? {}) },
+        prompt: layers,
+    };
+    if (opts.integrations && opts.integrations.length > 0) {
+        config.tools = opts.integrations;
+    }
+    return config;
+}
+/** Seeded default dialect-term list (law 4 — modality neutrality). Presets
+ *  seed this a la carte; a consumer with its own dialect words passes them
+ *  via `opts.extraTerms` rather than editing this list. */
+export const DEFAULT_DIALECT_TERMS = ['A2UI', 'envelope', 'JSONL'];
+/** Component tag names — `foo-ui`, `data-table-ui`, … */
+const TAG_PATTERN = /\b[a-z][a-z0-9]*-ui\b/gi;
+/** Warning-level lint (law 4): flags dialect terms and component-tag-name
+ *  patterns inside a persona's entry text. Never throws, never blocks —
+ *  shipped seeds assert an empty result; a positive hit is a signal to
+ *  reword, not a hard failure. */
+export function checkModalityNeutral(persona, opts = {}) {
+    const terms = [...DEFAULT_DIALECT_TERMS, ...(opts.extraTerms ?? [])];
+    const warnings = [];
+    for (const entry of persona.entries) {
+        const haystack = `${entry.label}\n${entry.description ?? ''}\n${entry.content}`;
+        const lower = haystack.toLowerCase();
+        for (const term of terms) {
+            if (lower.includes(term.toLowerCase())) {
+                warnings.push({ entryId: entry.id, term });
+            }
+        }
+        for (const match of haystack.matchAll(TAG_PATTERN)) {
+            warnings.push({ entryId: entry.id, term: match[0] });
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=compile.js.map

package/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["src/compile.ts"],"names":[],"mappings":"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"}

package/entry.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Entry — the ONE generic primitive (CHAT-HARNESS law 7).
+ *
+ * Prompt sections, skills, workflows, resources, tools, pattern-sources are
+ * six INSTANTIATIONS of this one shape, not six code paths. `kind` is a
+ * plain string — KNOWN_KINDS exists for display grouping only; nothing in
+ * this package (or its caller) is allowed to switch on it for logic. A
+ * seventh kind is seed data, never a code change.
+ */
+export interface Entry {
+    id: string;
+    kind: string;
+    label: string;
+    description?: string;
+    content: string;
+    order: number;
+    enabled: boolean;
+    builtin: boolean;
+}
+/** The six kinds this suite ships today — DISPLAY grouping only. */
+export declare const KNOWN_KINDS: readonly ["prompt-section", "skill", "workflow", "resource", "tool", "pattern-source"];
+export type KnownKind = (typeof KNOWN_KINDS)[number];
+/** Enabled entries, in composition order. The only order compilePersona
+ *  (or any consumer) should ever read entries in. */
+export declare function sortedEnabled(entries: Entry[]): Entry[];
+export type SeedEntryInput = Omit<Entry, 'order' | 'enabled' | 'builtin'> & Partial<Pick<Entry, 'order' | 'enabled' | 'builtin'>>;
+/** One seed entry with sane defaults: enabled, builtin, order 0 unless
+ *  given. Presets author entries with this rather than the raw shape. */
+export declare function seedEntry(entry: SeedEntryInput): Entry;
+/** A whole seed list at once — entries that omit `order` get one assigned
+ *  by their position in the array, so a preset author never hand-numbers a
+ *  long list. Entries that DO specify `order` keep it untouched. */
+export declare function seedEntries(entries: SeedEntryInput[]): Entry[];
+//# sourceMappingURL=entry.d.ts.map

package/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["src/entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,oEAAoE;AACpE,eAAO,MAAM,WAAW,wFAOd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;qDACqD;AACrD,wBAAgB,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAEvD;AAED,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC,GACvE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC;AAExD;yEACyE;AACzE,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,KAAK,CAOtD;AAED;;oEAEoE;AACpE,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,KAAK,EAAE,CAE9D"}

package/entry.js

@@ -0,0 +1,40 @@
+/**
+ * Entry — the ONE generic primitive (CHAT-HARNESS law 7).
+ *
+ * Prompt sections, skills, workflows, resources, tools, pattern-sources are
+ * six INSTANTIATIONS of this one shape, not six code paths. `kind` is a
+ * plain string — KNOWN_KINDS exists for display grouping only; nothing in
+ * this package (or its caller) is allowed to switch on it for logic. A
+ * seventh kind is seed data, never a code change.
+ */
+/** The six kinds this suite ships today — DISPLAY grouping only. */
+export const KNOWN_KINDS = [
+    'prompt-section',
+    'skill',
+    'workflow',
+    'resource',
+    'tool',
+    'pattern-source',
+];
+/** Enabled entries, in composition order. The only order compilePersona
+ *  (or any consumer) should ever read entries in. */
+export function sortedEnabled(entries) {
+    return entries.filter(e => e.enabled).sort((a, b) => a.order - b.order);
+}
+/** One seed entry with sane defaults: enabled, builtin, order 0 unless
+ *  given. Presets author entries with this rather than the raw shape. */
+export function seedEntry(entry) {
+    return {
+        order: 0,
+        enabled: true,
+        builtin: true,
+        ...entry,
+    };
+}
+/** A whole seed list at once — entries that omit `order` get one assigned
+ *  by their position in the array, so a preset author never hand-numbers a
+ *  long list. Entries that DO specify `order` keep it untouched. */
+export function seedEntries(entries) {
+    return entries.map((entry, i) => seedEntry({ order: i, ...entry }));
+}
+//# sourceMappingURL=entry.js.map

package/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["src/entry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,oEAAoE;AACpE,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,gBAAgB;IAChB,OAAO;IACP,UAAU;IACV,UAAU;IACV,MAAM;IACN,gBAAgB;CACR,CAAC;AAIX;qDACqD;AACrD,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC;AAKD;yEACyE;AACzE,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,OAAO;QACL,KAAK,EAAE,CAAC;QACR,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,GAAG,KAAK;KACT,CAAC;AACJ,CAAC;AAED;;oEAEoE;AACpE,MAAM,UAAU,WAAW,CAAC,OAAyB;IACnD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @adia-ai/persona — CHAT-HARNESS L2: an agent as DATA.
+ *
+ * Entry (six kinds, one shape) + Persona (seedVersion + entries) +
+ * SettingsStore (per-persona persistence) + compilePersona (pure, →
+ * @adia-ai/agent's AgentConfig) + versioned persona files. Renders
+ * nothing, executes nothing — L1 (@adia-ai/agent) and L4 (an admin
+ * composite) are the consumers.
+ */
+export { KNOWN_KINDS, seedEntry, seedEntries, sortedEnabled } from './entry.js';
+export type { Entry, KnownKind, SeedEntryInput } from './entry.js';
+export { definePersona } from './persona.js';
+export type { Persona } from './persona.js';
+export { createMemoryStore, personaStore } from './store.js';
+export type { MemoryStoreOpts, PersonaStoreOpts, SettingsStore } from './store.js';
+export { checkModalityNeutral, compilePersona, DEFAULT_DIALECT_TERMS, PRECEDENCE_SENTENCE } from './compile.js';
+export type { CompilePersonaOpts, ModalityLintOpts, ModalityWarning } from './compile.js';
+export { exportPersona, importPersona, PERSONA_FILE_KIND, PERSONA_FILE_VERSION } from './persona-file.js';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChF,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEnF,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAChH,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE1F,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/index.js

@@ -0,0 +1,15 @@
+/**
+ * @adia-ai/persona — CHAT-HARNESS L2: an agent as DATA.
+ *
+ * Entry (six kinds, one shape) + Persona (seedVersion + entries) +
+ * SettingsStore (per-persona persistence) + compilePersona (pure, →
+ * @adia-ai/agent's AgentConfig) + versioned persona files. Renders
+ * nothing, executes nothing — L1 (@adia-ai/agent) and L4 (an admin
+ * composite) are the consumers.
+ */
+export { KNOWN_KINDS, seedEntry, seedEntries, sortedEnabled } from './entry.js';
+export { definePersona } from './persona.js';
+export { createMemoryStore, personaStore } from './store.js';
+export { checkModalityNeutral, compilePersona, DEFAULT_DIALECT_TERMS, PRECEDENCE_SENTENCE } from './compile.js';
+export { exportPersona, importPersona, PERSONA_FILE_KIND, PERSONA_FILE_VERSION } from './persona-file.js';
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhF,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG7D,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGhH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@adia-ai/persona",
+  "version": "0.8.26",
+  "description": "Agent-as-data (CHAT-HARNESS L2): Entry primitive, Persona + SettingsStore contracts, pure compilePersona → @adia-ai/agent AgentConfig, versioned persona file import/export.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "*.js",
+    "*.d.ts",
+    "*.d.ts.map",
+    "*.js.map",
+    "README.md",
+    "CHANGELOG.md",
+    "!**/*.test.js"
+  ],
+  "scripts": {
+    "build": "tsc --build tsconfig.build.json",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@adia-ai/agent": "^0.8.0"
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adiahealth/gen-ui-kit.git",
+    "directory": "packages/persona"
+  },
+  "license": "MIT"
+}

package/persona-file.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Persona files — versioned export/import (CHAT-HARNESS §Interfaces 1).
+ *
+ * `{kind:'persona', version:1, ...}` with an ENUMERATED key allowlist:
+ * anything else in the JSON is a rejection, not a silently-dropped field.
+ * Import always MINTS a new persona (collision-safe id suffix, label
+ * " (imported)") — it never overwrites an existing preset, even one with
+ * the same id in the file.
+ */
+import { type Persona } from './persona.js';
+export declare const PERSONA_FILE_KIND = "persona";
+export declare const PERSONA_FILE_VERSION = 1;
+export declare function exportPersona(persona: Persona): string;
+export declare function importPersona(json: string, existingIds: Iterable<string>): Persona;
+//# sourceMappingURL=persona-file.d.ts.map

package/persona-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-file.d.ts","sourceRoot":"","sources":["src/persona-file.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAE3D,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAItC,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAYtD;AAcD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAsDlF"}

package/persona-file.js

@@ -0,0 +1,93 @@
+/**
+ * Persona files — versioned export/import (CHAT-HARNESS §Interfaces 1).
+ *
+ * `{kind:'persona', version:1, ...}` with an ENUMERATED key allowlist:
+ * anything else in the JSON is a rejection, not a silently-dropped field.
+ * Import always MINTS a new persona (collision-safe id suffix, label
+ * " (imported)") — it never overwrites an existing preset, even one with
+ * the same id in the file.
+ */
+import { definePersona } from './persona.js';
+export const PERSONA_FILE_KIND = 'persona';
+export const PERSONA_FILE_VERSION = 1;
+const ALLOWED_KEYS = new Set(['kind', 'version', 'id', 'label', 'category', 'seedVersion', 'entries', 'model']);
+export function exportPersona(persona) {
+    const file = {
+        kind: PERSONA_FILE_KIND,
+        version: PERSONA_FILE_VERSION,
+        id: persona.id,
+        label: persona.label,
+        seedVersion: persona.seedVersion,
+        entries: persona.entries,
+    };
+    if (persona.category !== undefined)
+        file['category'] = persona.category;
+    if (persona.model !== undefined)
+        file['model'] = persona.model;
+    return JSON.stringify(file, null, 2);
+}
+/** Mint a collision-safe id: `<base>-imported`, then `<base>-imported-2`,
+ *  `-3`, … against the given existing id set. */
+function mintImportedId(baseId, existingIds) {
+    let candidate = `${baseId}-imported`;
+    let n = 2;
+    while (existingIds.has(candidate)) {
+        candidate = `${baseId}-imported-${n}`;
+        n += 1;
+    }
+    return candidate;
+}
+export function importPersona(json, existingIds) {
+    let parsed;
+    try {
+        parsed = JSON.parse(json);
+    }
+    catch (err) {
+        throw new Error(`importPersona: invalid JSON — ${err.message}`);
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw new Error('importPersona: expected a JSON object');
+    }
+    const obj = parsed;
+    const unknownKeys = Object.keys(obj).filter(k => !ALLOWED_KEYS.has(k));
+    if (unknownKeys.length > 0) {
+        throw new Error(`importPersona: unknown key(s): ${unknownKeys.join(', ')}`);
+    }
+    if (obj['kind'] !== PERSONA_FILE_KIND) {
+        throw new Error(`importPersona: expected kind "${PERSONA_FILE_KIND}", got ${JSON.stringify(obj['kind'])}`);
+    }
+    if (obj['version'] !== PERSONA_FILE_VERSION) {
+        throw new Error(`importPersona: unsupported version ${JSON.stringify(obj['version'])}`);
+    }
+    if (typeof obj['id'] !== 'string' || !obj['id']) {
+        throw new Error('importPersona: "id" must be a non-empty string');
+    }
+    if (typeof obj['label'] !== 'string' || !obj['label']) {
+        throw new Error('importPersona: "label" must be a non-empty string');
+    }
+    if (typeof obj['seedVersion'] !== 'number') {
+        throw new Error('importPersona: "seedVersion" must be a number');
+    }
+    if (!Array.isArray(obj['entries'])) {
+        throw new Error('importPersona: "entries" must be an array');
+    }
+    const existing = new Set(existingIds);
+    const id = mintImportedId(obj['id'], existing);
+    const persona = {
+        id,
+        label: `${obj['label']} (imported)`,
+        seedVersion: obj['seedVersion'],
+        // Imported entries are never builtin — they came from a file, not a
+        // shipped preset — everything else on each entry rides through as-is.
+        entries: obj['entries'].map(entry => ({ ...entry, builtin: false })),
+    };
+    const category = obj['category'];
+    if (typeof category === 'string')
+        persona.category = category;
+    const model = obj['model'];
+    if (model && typeof model === 'object' && !Array.isArray(model)) {
+        persona.model = model;
+    }
+    return definePersona(persona);
+}
+//# sourceMappingURL=persona-file.js.map

package/persona-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-file.js","sourceRoot":"","sources":["src/persona-file.ts"],"names":[],"mappings":"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"}

package/persona.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Persona — an agent as DATA (CHAT-HARNESS §Interfaces 1).
+ *
+ * A persona is a bag of Entry rows plus the two axes that aren't entries:
+ * seedVersion (forces a one-time store reset — see store.ts) and an
+ * optional model hint. `definePersona` validates the invariants a bad seed
+ * would otherwise violate silently: unique entry ids, seedVersion >= 1.
+ */
+import type { Entry } from './entry.js';
+export interface Persona {
+    id: string;
+    label: string;
+    category?: string;
+    /** Bumping this forces every per-persona store to reset persisted edits
+     *  back to the seed once (store.ts personaStore). */
+    seedVersion: number;
+    entries: Entry[];
+    model?: {
+        provider?: string;
+        model?: string;
+    };
+}
+export declare function definePersona(persona: Persona): Persona;
+//# sourceMappingURL=persona.d.ts.map

package/persona.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona.d.ts","sourceRoot":"","sources":["src/persona.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;yDACqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAevD"}

package/persona.js

@@ -0,0 +1,25 @@
+/**
+ * Persona — an agent as DATA (CHAT-HARNESS §Interfaces 1).
+ *
+ * A persona is a bag of Entry rows plus the two axes that aren't entries:
+ * seedVersion (forces a one-time store reset — see store.ts) and an
+ * optional model hint. `definePersona` validates the invariants a bad seed
+ * would otherwise violate silently: unique entry ids, seedVersion >= 1.
+ */
+export function definePersona(persona) {
+    if (!persona.id) {
+        throw new Error('definePersona: "id" is required');
+    }
+    if (!Number.isInteger(persona.seedVersion) || persona.seedVersion < 1) {
+        throw new Error(`definePersona "${persona.id}": seedVersion must be an integer >= 1, got ${persona.seedVersion}`);
+    }
+    const seen = new Set();
+    for (const entry of persona.entries) {
+        if (seen.has(entry.id)) {
+            throw new Error(`definePersona "${persona.id}": duplicate entry id "${entry.id}"`);
+        }
+        seen.add(entry.id);
+    }
+    return persona;
+}
+//# sourceMappingURL=persona.js.map

package/persona.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona.js","sourceRoot":"","sources":["src/persona.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,MAAM,UAAU,aAAa,CAAC,OAAgB;IAC5C,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,CAAC,EAAE,+CAA+C,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACpH,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,CAAC,EAAE,0BAA0B,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/store.d.ts

@@ -0,0 +1,42 @@
+/**
+ * SettingsStore — the L2 persistence seam (CHAT-HARNESS §Interfaces 5).
+ *
+ * `createMemoryStore` is the reference implementation: localStorage-backed
+ * when available (browser), plain in-memory otherwise (Node, tests, SSR).
+ * `personaStore` layers the per-persona precedence rule on top of any
+ * SettingsStore factory: persisted values win over seed data across round
+ * trips, and a seedVersion bump forces exactly one reset back to the seed.
+ */
+import type { Persona } from './persona.js';
+export interface SettingsStore {
+    get(key: string): unknown;
+    set(key: string, value: unknown): void;
+    subscribe?(cb: () => void): () => void;
+}
+export interface MemoryStoreOpts {
+    initial?: Record<string, unknown>;
+    /** When set and `localStorage` exists, reads/writes persist there under
+     *  this key (one JSON blob). Absent — or no localStorage — stays in
+     *  memory for the life of the store object. */
+    persistKey?: string;
+}
+/** Reference SettingsStore: localStorage when available and a persistKey is
+ *  given, in-memory otherwise. `subscribe` fires on every `set`, including
+ *  ones that don't change the value — callers debounce if they need to. */
+export declare function createMemoryStore(opts?: MemoryStoreOpts): SettingsStore;
+export interface PersonaStoreOpts {
+    /** Store factory to bind — defaults to createMemoryStore. Tests inject a
+     *  bare in-memory factory to avoid localStorage entirely. */
+    createStore?: (opts: MemoryStoreOpts) => SettingsStore;
+}
+/** One SettingsStore bound to one persona (persistKey `persona.<id>`).
+ *
+ * Precedence (CHAT-HARNESS §Interfaces 5):
+ *  - Same seedVersion as last time this store was opened: persisted values
+ *    win — the seed only fills keys the store has never seen.
+ *  - Different seedVersion (first open, or a bump): the seed WINS — every
+ *    seed key is written, overwriting whatever was persisted — exactly
+ *    once, then the new seedVersion is recorded so the next open at the
+ *    same version doesn't reset again. */
+export declare function personaStore(persona: Persona, opts?: PersonaStoreOpts): SettingsStore;
+//# sourceMappingURL=store.d.ts.map

package/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["src/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,SAAS,CAAC,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC;;mDAE+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAUD;;2EAE2E;AAC3E,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,eAAoB,GAAG,aAAa,CA+C3E;AAED,MAAM,WAAW,gBAAgB;IAC/B;iEAC6D;IAC7D,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,aAAa,CAAC;CACxD;AAiBD;;;;;;;;0CAQ0C;AAC1C,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,GAAE,gBAAqB,GAAG,aAAa,CAezF"}

package/store.js

@@ -0,0 +1,110 @@
+/**
+ * SettingsStore — the L2 persistence seam (CHAT-HARNESS §Interfaces 5).
+ *
+ * `createMemoryStore` is the reference implementation: localStorage-backed
+ * when available (browser), plain in-memory otherwise (Node, tests, SSR).
+ * `personaStore` layers the per-persona precedence rule on top of any
+ * SettingsStore factory: persisted values win over seed data across round
+ * trips, and a seedVersion bump forces exactly one reset back to the seed.
+ */
+function hasLocalStorage() {
+    try {
+        return typeof localStorage !== 'undefined';
+    }
+    catch {
+        return false;
+    }
+}
+/** Reference SettingsStore: localStorage when available and a persistKey is
+ *  given, in-memory otherwise. `subscribe` fires on every `set`, including
+ *  ones that don't change the value — callers debounce if they need to. */
+export function createMemoryStore(opts = {}) {
+    const persistKey = opts.persistKey;
+    const persistent = !!persistKey && hasLocalStorage();
+    let data = { ...(opts.initial ?? {}) };
+    if (persistent) {
+        try {
+            const raw = localStorage.getItem(persistKey);
+            if (raw)
+                data = { ...data, ...JSON.parse(raw) };
+        }
+        catch {
+            // Corrupt or inaccessible storage — fall back to `initial` only.
+        }
+    }
+    const subscribers = new Set();
+    function persist() {
+        if (!persistent)
+            return;
+        try {
+            localStorage.setItem(persistKey, JSON.stringify(data));
+        }
+        catch {
+            // Quota/denied — the in-memory copy still holds for this session.
+        }
+    }
+    return {
+        get(key) {
+            return data[key];
+        },
+        set(key, value) {
+            // A write of the identical value must NOT notify: UI consumers echo
+            // rendered state back through set() (a render assigns .checked, the
+            // primitive emits change, the handler writes the same value) — and a
+            // notifying no-op write closes that echo into a subscribe → re-render
+            // → set loop (the v0.8.26 pre-flight's "signals: drain loop exceeded"
+            // livelock in admin-settings). Object.is matches the reactive kernel's
+            // own equality cutoff.
+            if (key in data && Object.is(data[key], value))
+                return;
+            data = { ...data, [key]: value };
+            persist();
+            for (const cb of subscribers)
+                cb();
+        },
+        subscribe(cb) {
+            subscribers.add(cb);
+            return () => subscribers.delete(cb);
+        },
+    };
+}
+const SEED_VERSION_KEY = '__seedVersion';
+function entryKey(entryId, field) {
+    return `entry.${entryId}.${field}`;
+}
+function seedFromPersona(persona) {
+    const seed = {};
+    for (const entry of persona.entries) {
+        seed[entryKey(entry.id, 'enabled')] = entry.enabled;
+        seed[entryKey(entry.id, 'order')] = entry.order;
+    }
+    return seed;
+}
+/** One SettingsStore bound to one persona (persistKey `persona.<id>`).
+ *
+ * Precedence (CHAT-HARNESS §Interfaces 5):
+ *  - Same seedVersion as last time this store was opened: persisted values
+ *    win — the seed only fills keys the store has never seen.
+ *  - Different seedVersion (first open, or a bump): the seed WINS — every
+ *    seed key is written, overwriting whatever was persisted — exactly
+ *    once, then the new seedVersion is recorded so the next open at the
+ *    same version doesn't reset again. */
+export function personaStore(persona, opts = {}) {
+    const createStore = opts.createStore ?? createMemoryStore;
+    const store = createStore({ persistKey: `persona.${persona.id}` });
+    const seed = seedFromPersona(persona);
+    const storedVersion = store.get(SEED_VERSION_KEY);
+    if (storedVersion !== persona.seedVersion) {
+        for (const [key, value] of Object.entries(seed))
+            store.set(key, value);
+        store.set(SEED_VERSION_KEY, persona.seedVersion);
+    }
+    else {
+        for (const [key, value] of Object.entries(seed)) {
+            if (store.get(key) === undefined)
+                store.set(key, value);
+        }
+    }
+    return store;
+}
+//# sourceMappingURL=store.js.map

package/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["src/store.ts"],"names":[],"mappings":"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"}