@elytracms/studio 0.0.42 → 0.0.44

package/dist/lib/ai/shape.js

@@ -0,0 +1,113 @@
+/**
+ * Target-shape derivation for `applyContentWithShape` (EC-331).
+ *
+ * Reuses the existing collection→JSON-Schema derivation (`collectionJsonSchema`,
+ * cms-core) rather than writing a new one, then applies the three leashes the AI
+ * engine adds on top:
+ *
+ *  - `ai.exclude` fields are removed entirely (the model never sees them → cannot
+ *    write them).
+ *  - relation fields become an ENUM over the provided candidate ids (or are omitted
+ *    when no candidates exist) — so a hallucinated relation id is not representable
+ *    as valid structured output.
+ *  - rich-text fields are emitted in the `{ version, doc }` ProseMirror storage shape
+ *    (the `allow` leash on embeds is enforced later by `validateRichTextEmbeds`).
+ *
+ * Localized fields stay flat in the shape (the model authors one locale at a time);
+ * the engine routes their values under `localized[locale]`.
+ */
+import { collectionJsonSchema, resolveLabel } from '@elytracms/core/cms-core';
+/** The rich-text `{ version, doc }` storage envelope, as a JSON Schema. */
+function richTextEnvelopeSchema() {
+    return {
+        type: 'object',
+        description: 'Rich text in the ProseMirror storage shape: { version, doc: { type: "doc", content: [...] } }.',
+        properties: {
+            version: { type: 'number' },
+            doc: {
+                type: 'object',
+                properties: {
+                    type: { type: 'string', const: 'doc' },
+                    content: { type: 'array', items: { type: 'object' } },
+                },
+                required: ['type', 'content'],
+            },
+        },
+        required: ['version', 'doc'],
+    };
+}
+/** A field's model-facing description: resolved label + optional `ai.hint`. */
+function describe(field, locale) {
+    const label = resolveLabel(field.form?.label, locale) ?? field.name;
+    const hint = field.ai?.hint;
+    const parts = [label, hint].filter((p) => typeof p === 'string' && p.length > 0);
+    return parts.length > 0 ? parts.join(' — ') : undefined;
+}
+/**
+ * Build the leash-aware target shape from a collection + candidates. Deterministic;
+ * never throws. Reuses `collectionJsonSchema` as the base, then rewrites relations /
+ * rich text and strips excluded fields.
+ */
+export function buildTargetShape(input) {
+    const base = collectionJsonSchema(input.collection);
+    const properties = {
+        ...(base.properties ?? {}),
+    };
+    const excluded = [];
+    const localizedFields = [];
+    const relationFields = [];
+    for (const field of input.collection.fields) {
+        if (field.localized)
+            localizedFields.push(field.name);
+        if (field.ai?.exclude) {
+            excluded.push(field.name);
+            delete properties[field.name];
+            continue;
+        }
+        if (field.type === 'relation') {
+            const candidates = input.candidates?.[field.name] ?? [];
+            if (candidates.length === 0) {
+                // No candidate ids ⇒ omit the field: the model cannot emit a relation value
+                // at all, so a hallucinated id is structurally impossible.
+                delete properties[field.name];
+                continue;
+            }
+            const ids = candidates.map((c) => c.id);
+            const label = candidates
+                .map((c) => (c.label ? `${c.id} (${c.label})` : c.id))
+                .join(', ');
+            const idSchema = {
+                type: 'string',
+                enum: ids,
+                description: `Choose one of: ${label}`,
+            };
+            properties[field.name] = field.multiple ? { type: 'array', items: idSchema } : idSchema;
+            relationFields.push({
+                fieldName: field.name,
+                target: field.target,
+                multiple: field.multiple,
+                candidateIds: ids,
+            });
+        }
+        else if (field.type === 'richText') {
+            properties[field.name] = richTextEnvelopeSchema();
+        }
+        const prop = properties[field.name];
+        if (prop) {
+            const desc = describe(field, input.locale);
+            // Preserve an existing description (e.g. relation enum / rich-text note).
+            if (desc && typeof prop.description !== 'string')
+                prop.description = desc;
+        }
+    }
+    const requiredIn = Array.isArray(base.required) ? base.required : [];
+    const required = requiredIn.filter((n) => !excluded.includes(n) && properties[n] !== undefined);
+    const schema = {
+        type: 'object',
+        properties,
+        additionalProperties: false,
+        ...(required.length > 0 ? { required } : {}),
+    };
+    return { schema, excluded, localizedFields, relationFields };
+}
+//# sourceMappingURL=shape.js.map

package/dist/lib/ai/shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.js","sourceRoot":"","sources":["../../../src/lib/ai/shape.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Target-shape derivation for `applyContentWithShape` (EC-331).\n *\n * Reuses the existing collection→JSON-Schema derivation (`collectionJsonSchema`,\n * cms-core) rather than writing a new one, then applies the three leashes the AI\n * engine adds on top:\n *\n *  - `ai.exclude` fields are removed entirely (the model never sees them → cannot\n *    write them).\n *  - relation fields become an ENUM over the provided candidate ids (or are omitted\n *    when no candidates exist) — so a hallucinated relation id is not representable\n *    as valid structured output.\n *  - rich-text fields are emitted in the `{ version, doc }` ProseMirror storage shape\n *    (the `allow` leash on embeds is enforced later by `validateRichTextEmbeds`).\n *\n * Localized fields stay flat in the shape (the model authors one locale at a time);\n * the engine routes their values under `localized[locale]`.\n */\nimport { collectionJsonSchema, resolveLabel } from '@elytracms/core/cms-core'\nimport type { CollectionDef, FieldDef, JsonSchema } from '@elytracms/core/cms-core'\nimport type { RelationCandidates } from './types'\n\n/** A relation field's resolved candidate set — how the engine maps ids → reference envelopes. */\nexport interface TargetRelationField {\n  fieldName: string\n  /** The relation's target collection id. */\n  target: string\n  multiple: boolean\n  /** The allowed candidate ids (the enum the model chose from). */\n  candidateIds: string[]\n}\n\n/** The derived target shape + the metadata the engine needs to post-process the output. */\nexport interface TargetShape {\n  /** The JSON Schema the structured output must satisfy. */\n  schema: JsonSchema\n  /** Field names removed by `ai.exclude` (untouchable). */\n  excluded: string[]\n  /** Field names whose values route under `localized[locale]`. */\n  localizedFields: string[]\n  /** Relation fields with their candidate enums. */\n  relationFields: TargetRelationField[]\n}\n\nexport interface BuildTargetShapeInput {\n  collection: CollectionDef\n  /** Relation candidate ids by field — a relation field with none is omitted from the shape. */\n  candidates?: RelationCandidates\n  /** UI locale for resolving field labels into descriptions. */\n  locale?: string\n}\n\n/** The rich-text `{ version, doc }` storage envelope, as a JSON Schema. */\nfunction richTextEnvelopeSchema(): JsonSchema {\n  return {\n    type: 'object',\n    description:\n      'Rich text in the ProseMirror storage shape: { version, doc: { type: \"doc\", content: [...] } }.',\n    properties: {\n      version: { type: 'number' },\n      doc: {\n        type: 'object',\n        properties: {\n          type: { type: 'string', const: 'doc' },\n          content: { type: 'array', items: { type: 'object' } },\n        },\n        required: ['type', 'content'],\n      },\n    },\n    required: ['version', 'doc'],\n  }\n}\n\n/** A field's model-facing description: resolved label + optional `ai.hint`. */\nfunction describe(field: FieldDef, locale?: string): string | undefined {\n  const label = resolveLabel(field.form?.label, locale) ?? field.name\n  const hint = field.ai?.hint\n  const parts = [label, hint].filter((p): p is string => typeof p === 'string' && p.length > 0)\n  return parts.length > 0 ? parts.join(' — ') : undefined\n}\n\n/**\n * Build the leash-aware target shape from a collection + candidates. Deterministic;\n * never throws. Reuses `collectionJsonSchema` as the base, then rewrites relations /\n * rich text and strips excluded fields.\n */\nexport function buildTargetShape(input: BuildTargetShapeInput): TargetShape {\n  const base = collectionJsonSchema(input.collection)\n  const properties: Record<string, JsonSchema> = {\n    ...((base.properties as Record<string, JsonSchema>) ?? {}),\n  }\n  const excluded: string[] = []\n  const localizedFields: string[] = []\n  const relationFields: TargetRelationField[] = []\n\n  for (const field of input.collection.fields) {\n    if (field.localized) localizedFields.push(field.name)\n\n    if (field.ai?.exclude) {\n      excluded.push(field.name)\n      delete properties[field.name]\n      continue\n    }\n\n    if (field.type === 'relation') {\n      const candidates = input.candidates?.[field.name] ?? []\n      if (candidates.length === 0) {\n        // No candidate ids ⇒ omit the field: the model cannot emit a relation value\n        // at all, so a hallucinated id is structurally impossible.\n        delete properties[field.name]\n        continue\n      }\n      const ids = candidates.map((c) => c.id)\n      const label = candidates\n        .map((c) => (c.label ? `${c.id} (${c.label})` : c.id))\n        .join(', ')\n      const idSchema: JsonSchema = {\n        type: 'string',\n        enum: ids,\n        description: `Choose one of: ${label}`,\n      }\n      properties[field.name] = field.multiple ? { type: 'array', items: idSchema } : idSchema\n      relationFields.push({\n        fieldName: field.name,\n        target: field.target,\n        multiple: field.multiple,\n        candidateIds: ids,\n      })\n    } else if (field.type === 'richText') {\n      properties[field.name] = richTextEnvelopeSchema()\n    }\n\n    const prop = properties[field.name]\n    if (prop) {\n      const desc = describe(field, input.locale)\n      // Preserve an existing description (e.g. relation enum / rich-text note).\n      if (desc && typeof prop.description !== 'string') prop.description = desc\n    }\n  }\n\n  const requiredIn = Array.isArray(base.required) ? (base.required as string[]) : []\n  const required = requiredIn.filter((n) => !excluded.includes(n) && properties[n] !== undefined)\n\n  const schema: JsonSchema = {\n    type: 'object',\n    properties,\n    additionalProperties: false,\n    ...(required.length > 0 ? { required } : {}),\n  }\n  return { schema, excluded, localizedFields, relationFields }\n}\n"]}

package/dist/lib/ai/types.d.ts

@@ -0,0 +1,227 @@
+/**
+ * `@elytracms/studio/lib/ai` — headless AI platform seam types (EC-331, phase 1).
+ *
+ * Pure types only: this module imports nothing at runtime (every import is
+ * `import type`), so referencing `StudioAiConfig` from the studio-config type does
+ * NOT pull the `ai` / `@ai-sdk/*` runtime onto the critical path. The runtime lives
+ * in the sibling modules (`config`, `anthropic-provider`, `fake-provider`,
+ * `knowledge`, `shape`, `apply-content`, `route`, `provenance`), reached only when
+ * the `ai` block is configured and the AI subsystem actually boots. The Anthropic
+ * provider additionally loads `ai`/`@ai-sdk/anthropic` via dynamic `import()`, so
+ * even importing this barrel never eagerly loads the SDK.
+ */
+import type { CollectionDef, CollectionRegistry, CmsValidationIssue, FieldValues, JsonSchema, ValidateDocumentOptions } from '@elytracms/core/cms-core';
+import type { ComponentManifest } from '@elytracms/core/component-registry';
+/**
+ * The capabilities the engine requires of a provider. Both must be `true` — the
+ * capability gate (`resolveAiConfig`) fails loud otherwise (tool-calling +
+ * structured output are the non-negotiable floor for schema-guaranteed authoring).
+ */
+export interface AiProviderCapabilities {
+    /** The provider can call tools (function/tool calling). */
+    toolCalling: boolean;
+    /** The provider can return schema-constrained structured output. */
+    structuredOutput: boolean;
+}
+/** A request for one schema-constrained structured object — the engine's core primitive. */
+export interface GenerateStructuredRequest {
+    /** System prompt: rules, injection stance, closed-world constraints. */
+    system?: string;
+    /** The task prompt plus assembled context (knowledge, existing values, prior issues). */
+    prompt: string;
+    /** The target shape as a JSON Schema (draft 2020-12 subset) the output must satisfy. */
+    schema: JsonSchema;
+    /** A short name for the schema (some providers surface it as the tool/output name). */
+    schemaName?: string;
+    /** A one-line description of what the schema represents. */
+    schemaDescription?: string;
+}
+/** Token usage a provider may report (best-effort; recorded for soft spend counters). */
+export interface AiUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+}
+export interface GenerateStructuredResult {
+    /** The structured object the provider produced (best-effort match to the request schema). */
+    object: unknown;
+    usage?: AiUsage;
+}
+/** One chat message the streaming route relays to the provider. */
+export interface AiChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/** A streaming chat/completion request the server-route factory forwards to the provider. */
+export interface StreamChatRequest {
+    system?: string;
+    messages: AiChatMessage[];
+}
+/**
+ * A provider adapter over a tool-calling, structured-output model. Anthropic in
+ * production, {@link FakeProvider} (deterministic, keyless) in tests/playground —
+ * both implement this identical surface so the whole loop runs without a key.
+ */
+export interface AiProvider {
+    /** Stable provider id (e.g. `anthropic`, `fake`); recorded in provenance. */
+    readonly id: string;
+    /** The model id the provider targets, when fixed; recorded in provenance. */
+    readonly model?: string;
+    /** The provider's capabilities — validated by the capability gate at config load. */
+    capabilities(): AiProviderCapabilities;
+    /** Produce a single schema-constrained structured object. */
+    generateStructured(request: GenerateStructuredRequest): Promise<GenerateStructuredResult>;
+    /**
+     * Stream a chat/completion response as a Web `Response` — the server-route body.
+     * Optional: headless callers may only use {@link generateStructured}.
+     */
+    streamChat?(request: StreamChatRequest): Promise<Response>;
+}
+/** Soft, advisory limits for the route counter and the engine repair loop. */
+export interface AiLimits {
+    /** Soft per-project ceiling on route requests per minute (advisory; route-enforced). */
+    maxRequestsPerMinute?: number;
+    /** Cap on repair attempts after the first generation (engine default when omitted). */
+    maxRepairAttempts?: number;
+}
+/**
+ * The `ai` block of `defineStudio({ ai })` (EC-331). Studio-only live code — like
+ * `fieldRenderers` / `i18n`, it never reaches the delivery bundle. The block's
+ * ABSENCE means the feature is fully absent (no AI UI, no AI deps on the critical
+ * path); `enabled: false` is a temporary kill-switch that keeps the config.
+ */
+export interface StudioAiConfig {
+    /**
+     * Temporary kill-switch. Presence of the whole `ai` block enables the feature;
+     * `enabled: false` disables it without removing the config. Omitted ⇒ enabled.
+     */
+    enabled?: boolean;
+    /** The provider adapter (live code): Anthropic in production, FakeProvider in tests/playground. */
+    provider: AiProvider;
+    /** Project knowledge sources assembled into the model's context. */
+    knowledge?: KnowledgeSource[];
+    /** Soft rate / repair limits. */
+    limits?: AiLimits;
+}
+/** An inline knowledge literal (markdown prose versioned with the repo). */
+export interface KnowledgeItem {
+    title?: string;
+    content: string;
+}
+/**
+ * A `fromCollection('<id>')` source: studio-editable knowledge whose *content* is
+ * prose held in the DB (data), while the mechanism stays code. Resolved by a
+ * caller-supplied collection reader (starter-kit / studio wires it to operations).
+ */
+export interface KnowledgeCollectionSource {
+    readonly kind: 'collection';
+    /** Collection id whose documents supply editable knowledge prose. */
+    readonly collectionId: string;
+    /** Field carrying the prose; when omitted the reader picks the collection's title/first text field. */
+    readonly field?: string;
+}
+/** An async (or sync) function producing knowledge items at resolve time. */
+export type KnowledgeFn = () => KnowledgeItem | KnowledgeItem[] | Promise<KnowledgeItem | KnowledgeItem[]>;
+/** A knowledge source: inline literal, async function, or `fromCollection(...)` sugar. */
+export type KnowledgeSource = KnowledgeItem | KnowledgeFn | KnowledgeCollectionSource;
+/** The assembled knowledge context — a flat, deterministic list of resolved items. */
+export interface ResolvedKnowledge {
+    items: KnowledgeItem[];
+}
+/** Reads knowledge prose out of a `fromCollection` source (wired to the operations layer). */
+export type KnowledgeCollectionReader = (source: KnowledgeCollectionSource) => KnowledgeItem[] | Promise<KnowledgeItem[]>;
+/**
+ * A relation candidate id (from a `searchDocuments`/tool result). Relation fields may
+ * ONLY use ids present here — the target shape emits them as an enum, so a
+ * hallucinated id is not even representable as valid structured output.
+ */
+export interface RelationCandidate {
+    id: string;
+    /** Human label (title) for the model to choose against. */
+    label?: string;
+}
+/** Relation candidate ids keyed by field name. A field absent here is omitted from the shape. */
+export type RelationCandidates = Record<string, RelationCandidate[]>;
+/** The typed draft-values patch the engine emits — applied by the draft-write path. */
+export interface ContentPatch {
+    collection: string;
+    id: string;
+    /** Non-localized field values. */
+    values: FieldValues;
+    /** Per-locale field values (localized fields, under the target locale). */
+    localized?: Record<string, FieldValues>;
+}
+/** Origin marker the draft-write path records so an AI-authored draft is attributable. */
+export interface AiProvenance {
+    origin: 'assistant';
+    /** Provider id (e.g. `anthropic`, `fake`). */
+    provider: string;
+    /** Model id, when the provider fixes one. */
+    model?: string;
+    /** ISO timestamp when the content was generated. */
+    at: string;
+}
+export interface ApplyContentInput {
+    provider: AiProvider;
+    registry: CollectionRegistry;
+    collection: CollectionDef;
+    /** Document id the patch targets (an existing doc for updates, or a fresh id for creation). */
+    documentId: string;
+    /** The author's instruction / prompt. */
+    instruction: string;
+    /** Assembled knowledge context (from `resolveKnowledge`). */
+    knowledge?: ResolvedKnowledge;
+    /** Component manifests — context for `allow`-leashed richText/blocks fields. */
+    components?: readonly ComponentManifest[];
+    /** Relation candidate ids by field — the ONLY ids a relation field may use. */
+    candidates?: RelationCandidates;
+    /** Existing draft values (updates): the model output merges over these before validation. */
+    existing?: FieldValues;
+    /** Target locale for localized fields (their values land under `localized[locale]`). */
+    locale?: string;
+    /** Injected rich-text embed leash (studio-wired); enforced when present. */
+    validateRichTextEmbeds?: ValidateDocumentOptions['validateRichTextEmbeds'];
+    /** Injected blocks composition leash (studio-wired); enforced when present. */
+    validateComposition?: ValidateDocumentOptions['validateComposition'];
+    /** Document store for relation/asset existence checks (optional). */
+    store?: ValidateDocumentOptions['store'];
+    /** Max repair attempts after the first generation (default {@link DEFAULT_MAX_REPAIR_ATTEMPTS}). */
+    maxRepairAttempts?: number;
+}
+/** The engine's outcome: a valid, leash-compliant patch, or the blocking issues. */
+export type ApplyContentResult = {
+    ok: true;
+    patch: ContentPatch;
+    provenance: AiProvenance;
+    /** Total generation attempts made (1 = happy path, >1 = repaired). */
+    attempts: number;
+    /** Non-error issues surfaced by the accepted document (e.g. warnings). */
+    issues: CmsValidationIssue[];
+} | {
+    ok: false;
+    /** The error-severity issues from the final failed attempt. */
+    issues: CmsValidationIssue[];
+    attempts: number;
+    provenance: AiProvenance;
+};
+/** A validated studio session, from the host-wired `getSession`. Opaque beyond `userId`. */
+export interface AiSession {
+    /** Authenticated principal id. */
+    userId: string;
+    [key: string]: unknown;
+}
+export interface AiRouteHandlerOptions {
+    /** The provider (holds the host-env key). The route is a thin proxy over it. */
+    provider: AiProvider;
+    /**
+     * Server-side session check (reject anonymous callers). Returns a session for an
+     * authenticated caller, `null` otherwise. Wired by the host to its own auth — the
+     * route consumes it, never re-implements it.
+     */
+    getSession: (request: Request) => AiSession | null | Promise<AiSession | null>;
+    /** Soft per-project rate limit (advisory spend guard). */
+    limits?: AiLimits;
+    /** Derive the per-project rate-bucket key from a request (default: one global bucket). */
+    projectKey?: (request: Request) => string;
+}
+/** The mounted route handler: a framework-agnostic Web `Request → Response`. */
+export type AiRouteHandler = (request: Request) => Promise<Response>;

package/dist/lib/ai/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lib/ai/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/ai/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * `@elytracms/studio/lib/ai` — headless AI platform seam types (EC-331, phase 1).\n *\n * Pure types only: this module imports nothing at runtime (every import is\n * `import type`), so referencing `StudioAiConfig` from the studio-config type does\n * NOT pull the `ai` / `@ai-sdk/*` runtime onto the critical path. The runtime lives\n * in the sibling modules (`config`, `anthropic-provider`, `fake-provider`,\n * `knowledge`, `shape`, `apply-content`, `route`, `provenance`), reached only when\n * the `ai` block is configured and the AI subsystem actually boots. The Anthropic\n * provider additionally loads `ai`/`@ai-sdk/anthropic` via dynamic `import()`, so\n * even importing this barrel never eagerly loads the SDK.\n */\nimport type {\n  CollectionDef,\n  CollectionRegistry,\n  CmsValidationIssue,\n  FieldValues,\n  JsonSchema,\n  ValidateDocumentOptions,\n} from '@elytracms/core/cms-core'\nimport type { ComponentManifest } from '@elytracms/core/component-registry'\n\n// --- Provider seam ----------------------------------------------------------------\n\n/**\n * The capabilities the engine requires of a provider. Both must be `true` — the\n * capability gate (`resolveAiConfig`) fails loud otherwise (tool-calling +\n * structured output are the non-negotiable floor for schema-guaranteed authoring).\n */\nexport interface AiProviderCapabilities {\n  /** The provider can call tools (function/tool calling). */\n  toolCalling: boolean\n  /** The provider can return schema-constrained structured output. */\n  structuredOutput: boolean\n}\n\n/** A request for one schema-constrained structured object — the engine's core primitive. */\nexport interface GenerateStructuredRequest {\n  /** System prompt: rules, injection stance, closed-world constraints. */\n  system?: string\n  /** The task prompt plus assembled context (knowledge, existing values, prior issues). */\n  prompt: string\n  /** The target shape as a JSON Schema (draft 2020-12 subset) the output must satisfy. */\n  schema: JsonSchema\n  /** A short name for the schema (some providers surface it as the tool/output name). */\n  schemaName?: string\n  /** A one-line description of what the schema represents. */\n  schemaDescription?: string\n}\n\n/** Token usage a provider may report (best-effort; recorded for soft spend counters). */\nexport interface AiUsage {\n  inputTokens?: number\n  outputTokens?: number\n}\n\nexport interface GenerateStructuredResult {\n  /** The structured object the provider produced (best-effort match to the request schema). */\n  object: unknown\n  usage?: AiUsage\n}\n\n/** One chat message the streaming route relays to the provider. */\nexport interface AiChatMessage {\n  role: 'system' | 'user' | 'assistant'\n  content: string\n}\n\n/** A streaming chat/completion request the server-route factory forwards to the provider. */\nexport interface StreamChatRequest {\n  system?: string\n  messages: AiChatMessage[]\n}\n\n/**\n * A provider adapter over a tool-calling, structured-output model. Anthropic in\n * production, {@link FakeProvider} (deterministic, keyless) in tests/playground —\n * both implement this identical surface so the whole loop runs without a key.\n */\nexport interface AiProvider {\n  /** Stable provider id (e.g. `anthropic`, `fake`); recorded in provenance. */\n  readonly id: string\n  /** The model id the provider targets, when fixed; recorded in provenance. */\n  readonly model?: string\n  /** The provider's capabilities — validated by the capability gate at config load. */\n  capabilities(): AiProviderCapabilities\n  /** Produce a single schema-constrained structured object. */\n  generateStructured(request: GenerateStructuredRequest): Promise<GenerateStructuredResult>\n  /**\n   * Stream a chat/completion response as a Web `Response` — the server-route body.\n   * Optional: headless callers may only use {@link generateStructured}.\n   */\n  streamChat?(request: StreamChatRequest): Promise<Response>\n}\n\n// --- Config seam ------------------------------------------------------------------\n\n/** Soft, advisory limits for the route counter and the engine repair loop. */\nexport interface AiLimits {\n  /** Soft per-project ceiling on route requests per minute (advisory; route-enforced). */\n  maxRequestsPerMinute?: number\n  /** Cap on repair attempts after the first generation (engine default when omitted). */\n  maxRepairAttempts?: number\n}\n\n/**\n * The `ai` block of `defineStudio({ ai })` (EC-331). Studio-only live code — like\n * `fieldRenderers` / `i18n`, it never reaches the delivery bundle. The block's\n * ABSENCE means the feature is fully absent (no AI UI, no AI deps on the critical\n * path); `enabled: false` is a temporary kill-switch that keeps the config.\n */\nexport interface StudioAiConfig {\n  /**\n   * Temporary kill-switch. Presence of the whole `ai` block enables the feature;\n   * `enabled: false` disables it without removing the config. Omitted ⇒ enabled.\n   */\n  enabled?: boolean\n  /** The provider adapter (live code): Anthropic in production, FakeProvider in tests/playground. */\n  provider: AiProvider\n  /** Project knowledge sources assembled into the model's context. */\n  knowledge?: KnowledgeSource[]\n  /** Soft rate / repair limits. */\n  limits?: AiLimits\n}\n\n// --- Knowledge seam ---------------------------------------------------------------\n\n/** An inline knowledge literal (markdown prose versioned with the repo). */\nexport interface KnowledgeItem {\n  title?: string\n  content: string\n}\n\n/**\n * A `fromCollection('<id>')` source: studio-editable knowledge whose *content* is\n * prose held in the DB (data), while the mechanism stays code. Resolved by a\n * caller-supplied collection reader (starter-kit / studio wires it to operations).\n */\nexport interface KnowledgeCollectionSource {\n  readonly kind: 'collection'\n  /** Collection id whose documents supply editable knowledge prose. */\n  readonly collectionId: string\n  /** Field carrying the prose; when omitted the reader picks the collection's title/first text field. */\n  readonly field?: string\n}\n\n/** An async (or sync) function producing knowledge items at resolve time. */\nexport type KnowledgeFn = () =>\n  | KnowledgeItem\n  | KnowledgeItem[]\n  | Promise<KnowledgeItem | KnowledgeItem[]>\n\n/** A knowledge source: inline literal, async function, or `fromCollection(...)` sugar. */\nexport type KnowledgeSource = KnowledgeItem | KnowledgeFn | KnowledgeCollectionSource\n\n/** The assembled knowledge context — a flat, deterministic list of resolved items. */\nexport interface ResolvedKnowledge {\n  items: KnowledgeItem[]\n}\n\n/** Reads knowledge prose out of a `fromCollection` source (wired to the operations layer). */\nexport type KnowledgeCollectionReader = (\n  source: KnowledgeCollectionSource,\n) => KnowledgeItem[] | Promise<KnowledgeItem[]>\n\n// --- Engine seam ------------------------------------------------------------------\n\n/**\n * A relation candidate id (from a `searchDocuments`/tool result). Relation fields may\n * ONLY use ids present here — the target shape emits them as an enum, so a\n * hallucinated id is not even representable as valid structured output.\n */\nexport interface RelationCandidate {\n  id: string\n  /** Human label (title) for the model to choose against. */\n  label?: string\n}\n\n/** Relation candidate ids keyed by field name. A field absent here is omitted from the shape. */\nexport type RelationCandidates = Record<string, RelationCandidate[]>\n\n/** The typed draft-values patch the engine emits — applied by the draft-write path. */\nexport interface ContentPatch {\n  collection: string\n  id: string\n  /** Non-localized field values. */\n  values: FieldValues\n  /** Per-locale field values (localized fields, under the target locale). */\n  localized?: Record<string, FieldValues>\n}\n\n/** Origin marker the draft-write path records so an AI-authored draft is attributable. */\nexport interface AiProvenance {\n  origin: 'assistant'\n  /** Provider id (e.g. `anthropic`, `fake`). */\n  provider: string\n  /** Model id, when the provider fixes one. */\n  model?: string\n  /** ISO timestamp when the content was generated. */\n  at: string\n}\n\nexport interface ApplyContentInput {\n  provider: AiProvider\n  registry: CollectionRegistry\n  collection: CollectionDef\n  /** Document id the patch targets (an existing doc for updates, or a fresh id for creation). */\n  documentId: string\n  /** The author's instruction / prompt. */\n  instruction: string\n  /** Assembled knowledge context (from `resolveKnowledge`). */\n  knowledge?: ResolvedKnowledge\n  /** Component manifests — context for `allow`-leashed richText/blocks fields. */\n  components?: readonly ComponentManifest[]\n  /** Relation candidate ids by field — the ONLY ids a relation field may use. */\n  candidates?: RelationCandidates\n  /** Existing draft values (updates): the model output merges over these before validation. */\n  existing?: FieldValues\n  /** Target locale for localized fields (their values land under `localized[locale]`). */\n  locale?: string\n  /** Injected rich-text embed leash (studio-wired); enforced when present. */\n  validateRichTextEmbeds?: ValidateDocumentOptions['validateRichTextEmbeds']\n  /** Injected blocks composition leash (studio-wired); enforced when present. */\n  validateComposition?: ValidateDocumentOptions['validateComposition']\n  /** Document store for relation/asset existence checks (optional). */\n  store?: ValidateDocumentOptions['store']\n  /** Max repair attempts after the first generation (default {@link DEFAULT_MAX_REPAIR_ATTEMPTS}). */\n  maxRepairAttempts?: number\n}\n\n/** The engine's outcome: a valid, leash-compliant patch, or the blocking issues. */\nexport type ApplyContentResult =\n  | {\n      ok: true\n      patch: ContentPatch\n      provenance: AiProvenance\n      /** Total generation attempts made (1 = happy path, >1 = repaired). */\n      attempts: number\n      /** Non-error issues surfaced by the accepted document (e.g. warnings). */\n      issues: CmsValidationIssue[]\n    }\n  | {\n      ok: false\n      /** The error-severity issues from the final failed attempt. */\n      issues: CmsValidationIssue[]\n      attempts: number\n      provenance: AiProvenance\n    }\n\n// --- Route seam -------------------------------------------------------------------\n\n/** A validated studio session, from the host-wired `getSession`. Opaque beyond `userId`. */\nexport interface AiSession {\n  /** Authenticated principal id. */\n  userId: string\n  [key: string]: unknown\n}\n\nexport interface AiRouteHandlerOptions {\n  /** The provider (holds the host-env key). The route is a thin proxy over it. */\n  provider: AiProvider\n  /**\n   * Server-side session check (reject anonymous callers). Returns a session for an\n   * authenticated caller, `null` otherwise. Wired by the host to its own auth — the\n   * route consumes it, never re-implements it.\n   */\n  getSession: (request: Request) => AiSession | null | Promise<AiSession | null>\n  /** Soft per-project rate limit (advisory spend guard). */\n  limits?: AiLimits\n  /** Derive the per-project rate-bucket key from a request (default: one global bucket). */\n  projectKey?: (request: Request) => string\n}\n\n/** The mounted route handler: a framework-agnostic Web `Request → Response`. */\nexport type AiRouteHandler = (request: Request) => Promise<Response>\n"]}

package/dist/lib/data/data-store.d.ts

@@ -78,6 +78,7 @@ export type DataAction = {
  * live here and the app's test harness has no DOM to drive effects through.
  */
 export declare function dataStateReducer(state: DataState, action: DataAction): DataState;
+declare const useData: () => DataStore;
 /**
  * The session's starting state: EMPTY. The studio seeds no sample sources (Oli,
  * 2026-06-19) — real sources arrive from the project's config collections (the
@@ -94,4 +95,4 @@ export interface DataProviderProps {
     projectId?: string;
 }
 export declare function DataProvider({ children, projectId }: DataProviderProps): import("react").JSX.Element;
-export declare function useData(): DataStore;
+export { useData };

package/dist/lib/data/data-store.js

@@ -1,8 +1,9 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, useCallback, useContext, useEffect, useMemo, useReducer, useState } from 'react';
+import { useCallback, useEffect, useMemo, useReducer, useState } from 'react';
 import { SourceRegistry, captureSample, inferSchema, resolveBinding, resolveCondition, tokensForSchema, } from '@elytracms/core/data-binding';
 import { getStudioOperations } from '../operations';
 import { useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query';
+import { createRequiredContext } from '@elytracms/studio/lib/required-context';
 import { STUDIO_SYSTEM_COLLECTION_IDS } from '../operations/session-hydration';
 import { resolveDeploymentCollections } from '../workspace';
 import { hasContentSession } from './collection-content';
@@ -67,7 +68,7 @@ export function dataStateReducer(state, action) {
             return state;
     }
 }
-const DataContext = createContext(null);
+const { Context: DataContext, useRequired: useData } = createRequiredContext('Data');
 /**
  * The session's starting state: EMPTY. The studio seeds no sample sources (Oli,
  * 2026-06-19) — real sources arrive from the project's config collections (the
@@ -206,10 +207,5 @@ export function DataProvider({ children, projectId }) {
     }, [state, persist, persistError]);
     return _jsx(DataContext.Provider, { value: store, children: children });
 }
-export function useData() {
-    const store = useContext(DataContext);
-    if (!store)
-        throw new Error('useData must be used within a <DataProvider>.');
-    return store;
-}
+export { useData };
 //# sourceMappingURL=data-store.js.map

package/dist/lib/data/data-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-store.js","sourceRoot":"","sources":["../../../src/lib/data/data-store.tsx"],"names":[],"mappings":"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","sourcesContent":["import { createContext, useCallback, useContext, useEffect, useMemo, useReducer, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport {\n  SourceRegistry,\n  captureSample,\n  inferSchema,\n  resolveBinding,\n  resolveCondition,\n  tokensForSchema,\n} from '@elytracms/core/data-binding'\nimport type {\n  BindingResolution,\n  ConditionResolution,\n  DataSource,\n  InferredSchema,\n  PayloadStore,\n  RepeaterItemContext,\n} from '@elytracms/core/data-binding'\nimport type { BindingReference, Condition, JsonValue } from '@elytracms/core/project-graph'\nimport { getStudioOperations } from '../operations'\nimport type { OperationResult, OperationsClient } from '../operations'\nimport { useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query'\nimport { STUDIO_SYSTEM_COLLECTION_IDS } from '../operations/session-hydration'\nimport { resolveDeploymentCollections } from '../workspace'\nimport { hasContentSession } from './collection-content'\nimport { captureSourceSample, cmsSourceForCollection } from './sample-capture'\nimport { deleteDataSource, loadDataSources, saveDataSource } from './sources-store'\n\n/**\n * The project's live data layer (brief §4.6, §7.5, EC-167). Holds the source\n * registry the Builder's Content tab binds through, plus the captured payloads\n * that drive binding resolution. One uniform model across CMS queries, data\n * providers, and the built-in REST/Convex kinds — resolution, sampling,\n * inference and tokenization treat them all identically.\n *\n * There is no source-authoring UI (EC-167): sources exist because code declared\n * them (registered data providers), the schema implied them (per-collection CMS\n * queries), or an editor flow provisioned them (repeating sections, template\n * pages).\n *\n * Persistence: when mounted with a `projectId`, the store hydrates the\n * project's persisted source records (the `cms-data-sources` system collection,\n * see `sources-store.ts`) over the deterministic playground seeds — persisted\n * wins by id, but never over a source provisioned/removed in THIS session —\n * and every provision/remove writes through `@elytracms/core/operations`. Without a\n * `projectId` (tests, fixtures) the store is pure session state, exactly as\n * before.\n */\nexport interface DataStore {\n  sources: DataSource[]\n  registry: SourceRegistry\n  payloads: PayloadStore\n  knownSourceIds: ReadonlySet<string>\n\n  getSource: (id: string) => DataSource | undefined\n  removeSource: (id: string) => void\n  /**\n   * Create or replace a source with a known id + config and capture its sample\n   * immediately (EC-166/EC-167): repeating sections and template pages\n   * provision their per-scope CMS query / provider sources through this.\n   */\n  provisionSource: (source: DataSource) => void\n\n  /**\n   * The latest persistence failure in plain language, or `null`. Persistence\n   * is best-effort on top of the live session (the canvas keeps working on\n   * session state), but a failure is recorded here — visible, never silent.\n   */\n  persistError: string | null\n\n  /** The stable path tokens a source exposes from its inferred schema (EC-085). */\n  tokensOf: (id: string) => string[]\n  schemaOf: (id: string) => InferredSchema | undefined\n  sampleOf: (id: string) => JsonValue | undefined\n\n  /** Resolve a binding to a renderer-ready resolution (value/props/condition/issue). */\n  resolve: (ref: BindingReference, item?: RepeaterItemContext) => BindingResolution\n  /** Resolve a binding to the concrete value the renderer injects (EC-086–089). */\n  resolveValue: (ref: BindingReference, item?: RepeaterItemContext) => JsonValue | undefined\n  /** Evaluate a condition against the captured payloads (EC-088). */\n  resolveCondition: (condition: Condition, item?: RepeaterItemContext) => ConditionResolution\n}\n\nexport interface DataState {\n  sources: DataSource[]\n  /**\n   * Ids provisioned or removed in THIS session. Hydration (which resolves\n   * asynchronously) never overrides them — the editor's latest action wins\n   * over whatever was persisted before it.\n   */\n  sessionIds: ReadonlySet<string>\n}\n\nexport type DataAction =\n  | { type: 'remove'; id: string }\n  | { type: 'provision'; source: DataSource }\n  /** Merge the project's persisted source records in (persisted wins over seeds). */\n  | { type: 'hydrate'; sources: DataSource[] }\n\nfunction upsert(sources: DataSource[], source: DataSource): DataSource[] {\n  const exists = sources.some((s) => s.id === source.id)\n  return exists ? sources.map((s) => (s.id === source.id ? source : s)) : [...sources, source]\n}\n\n/**\n * A persisted record hydrates as-is when it carries its captured sample;\n * otherwise recapture. Exception (EC-177 gap 1): with a hydrated content\n * session configured (Convex mode), CMS sources ALWAYS recapture by replaying\n * their stored query over the live documents — a sample captured by an earlier\n * session may carry stale (or fixture-derived) entries.\n */\nfunction withSample(source: DataSource): DataSource {\n  if (source.kind === 'cms' && hasContentSession()) {\n    const sample = captureSourceSample(source)\n    return sample !== undefined ? captureSample(source, sample) : source\n  }\n  if (source.sample !== undefined) return source\n  // No persisted sample: try an honest capture (a provider runs; anything the\n  // studio can't fetch returns undefined) — never fabricate.\n  const sample = captureSourceSample(source)\n  return sample !== undefined ? captureSample(source, sample) : source\n}\n\n/**\n * The store's reducer, exported because hydration/session-precedence semantics\n * live here and the app's test harness has no DOM to drive effects through.\n */\nexport function dataStateReducer(state: DataState, action: DataAction): DataState {\n  switch (action.type) {\n    case 'remove':\n      return {\n        ...state,\n        sources: state.sources.filter((s) => s.id !== action.id),\n        sessionIds: new Set([...state.sessionIds, action.id]),\n      }\n    case 'provision': {\n      // Upsert by id; attach a sample only if one can be captured honestly (a\n      // provider run, or live CMS content) — otherwise the source carries none.\n      const sample = captureSourceSample(action.source)\n      const provisioned = sample !== undefined ? captureSample(action.source, sample) : action.source\n      return {\n        ...state,\n        sources: upsert(state.sources, provisioned),\n        sessionIds: new Set([...state.sessionIds, provisioned.id]),\n      }\n    }\n    case 'hydrate': {\n      let sources = state.sources\n      for (const source of action.sources) {\n        if (state.sessionIds.has(source.id)) continue // this session already decided\n        sources = upsert(sources, withSample(source))\n      }\n      return sources === state.sources ? state : { ...state, sources }\n    }\n    default:\n      return state\n  }\n}\n\nconst DataContext = createContext<DataStore | null>(null)\n\n/**\n * The session's starting state: EMPTY. The studio seeds no sample sources (Oli,\n * 2026-06-19) — real sources arrive from the project's config collections (the\n * hydrate effect, Convex mode) or are added by the author. Nothing is faked.\n */\nexport function initialDataState(): DataState {\n  return { sources: [], sessionIds: new Set() }\n}\n\nexport interface DataProviderProps {\n  children: ReactNode\n  /**\n   * When set, the store hydrates from and persists to this project's\n   * `cms-data-sources` system collection (through `@elytracms/core/operations`).\n   * Without it the store is pure session state (tests, fixtures).\n   */\n  projectId?: string\n}\n\nexport function DataProvider({ children, projectId }: DataProviderProps) {\n  const [state, dispatch] = useReducer(dataStateReducer, undefined, initialDataState)\n  const [persistError, setPersistError] = useState<string | null>(null)\n\n  // EC-192: surface every config-driven content collection as a pickable CMS\n  // source, so the binding/condition pickers list what actually exists — the\n  // same collection set the CMS uses (`resolveDeploymentCollections`) — rather\n  // than only the demo fixture sources. Merged additively (the `hydrate` upsert\n  // skips session-decided ids and recaptures live samples in Convex mode); studio\n  // SYSTEM collections (routes/redirects/saved views/data sources) are excluded.\n  useEffect(() => {\n    if (projectId === undefined) return\n    const collections = resolveDeploymentCollections().filter(\n      (collection) => !STUDIO_SYSTEM_COLLECTION_IDS.has(collection.id),\n    )\n    if (collections.length === 0) return\n    dispatch({ type: 'hydrate', sources: collections.map(cmsSourceForCollection) })\n  }, [projectId])\n\n  // Hydrate the project's persisted sources through the one operations-backed\n  // query cache (EC-308/AD-17). Sources provisioned by other sessions on the\n  // same project show up here; the playground seeds stay for everything not\n  // persisted. The reducer's `hydrate` keeps session precedence — a source\n  // provisioned/removed in THIS session always wins over the hydrated list.\n  const cache = useOperationCache()\n  const sourcesQuery = useOperationQuery<DataSource[]>({\n    queryKey: ['dataSources', projectId ?? '∅'],\n    loader: async (operations) => {\n      const result = await loadDataSources(operations, projectId as string)\n      if (!result.ok) throw new Error(result.error.message)\n      return result.value\n    },\n    enabled: projectId !== undefined,\n  })\n  const hydratedSources = sourcesQuery.data\n  useEffect(() => {\n    if (hydratedSources) dispatch({ type: 'hydrate', sources: hydratedSources })\n  }, [hydratedSources])\n  const sourcesError = sourcesQuery.isError ? sourcesQuery.error : null\n  useEffect(() => {\n    if (sourcesError)\n      setPersistError(sourcesError instanceof Error ? sourcesError.message : 'Loading data sources failed.')\n  }, [sourcesError])\n\n  // Best-effort persistence on top of the live session: the canvas keeps\n  // working on session state; a failed write surfaces via `persistError`. On a\n  // confirmed write, invalidate the hydration query so a later remount\n  // re-hydrates the provisioned/removed source rather than a stale list.\n  const persist = useCallback(\n    (write: (operations: OperationsClient, projectId: string) => Promise<OperationResult<void>>) => {\n      if (projectId === undefined) return\n      void getStudioOperations()\n        .then(({ operations }) => write(operations, projectId))\n        .then((result) => {\n          if (!result.ok) {\n            setPersistError(result.error.message)\n            return\n          }\n          void cache.invalidate(['dataSources', projectId])\n        })\n        .catch((error: unknown) => {\n          setPersistError(error instanceof Error ? error.message : 'Saving the data source failed.')\n        })\n    },\n    [projectId, cache],\n  )\n\n  const store = useMemo<DataStore>(() => {\n    const registry = SourceRegistry.from(state.sources)\n    const payloads: Record<string, JsonValue> = {}\n    for (const source of state.sources) {\n      if (source.sample !== undefined) payloads[source.id] = source.sample\n    }\n    const knownSourceIds = registry.knownSourceIds()\n    const ctx = { payloads, registry }\n\n    const getSource = (id: string) => registry.get(id)\n    const resolve = (ref: BindingReference, item?: RepeaterItemContext) =>\n      resolveBinding(ref, ctx, item)\n\n    return {\n      sources: state.sources,\n      registry,\n      payloads,\n      knownSourceIds,\n      getSource,\n      removeSource: (id) => {\n        dispatch({ type: 'remove', id })\n        persist((operations, pid) => deleteDataSource(operations, pid, id))\n      },\n      provisionSource: (source) => {\n        dispatch({ type: 'provision', source })\n        // Persist exactly what the session resolves: the source plus any sample\n        // that can be captured honestly (a provider run / live CMS content) —\n        // never a fabricated one. Matches the `provision` reducer.\n        const sample = captureSourceSample(source)\n        const provisioned = sample !== undefined ? captureSample(source, sample) : source\n        persist((operations, pid) => saveDataSource(operations, pid, provisioned))\n      },\n      persistError,\n      tokensOf: (id) => {\n        const schema = getSource(id)?.schema\n        return schema ? tokensForSchema(schema) : []\n      },\n      schemaOf: (id) => {\n        const source = getSource(id)\n        if (source?.schema) return source.schema\n        if (source?.sample !== undefined) return inferSchema(source.sample)\n        return undefined\n      },\n      sampleOf: (id) => getSource(id)?.sample,\n      resolve,\n      resolveValue: (ref, item) => {\n        const r = resolve(ref, item)\n        switch (r.kind) {\n          case 'value':\n            return r.value\n          case 'props':\n            return r.props\n          case 'condition':\n            return r.pass\n          case 'issue':\n            return undefined\n          default: {\n            const never: never = r\n            return never\n          }\n        }\n      },\n      resolveCondition: (condition, item) => resolveCondition(condition, ctx, item),\n    }\n  }, [state, persist, persistError])\n\n  return <DataContext.Provider value={store}>{children}</DataContext.Provider>\n}\n\nexport function useData(): DataStore {\n  const store = useContext(DataContext)\n  if (!store) throw new Error('useData must be used within a <DataProvider>.')\n  return store\n}\n"]}
+{"version":3,"file":"data-store.js","sourceRoot":"","sources":["../../../src/lib/data/data-store.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useMemo, useReducer, useState } from 'react'\nimport type { ReactNode } from 'react'\nimport {\n  SourceRegistry,\n  captureSample,\n  inferSchema,\n  resolveBinding,\n  resolveCondition,\n  tokensForSchema,\n} from '@elytracms/core/data-binding'\nimport type {\n  BindingResolution,\n  ConditionResolution,\n  DataSource,\n  InferredSchema,\n  PayloadStore,\n  RepeaterItemContext,\n} from '@elytracms/core/data-binding'\nimport type { BindingReference, Condition, JsonValue } from '@elytracms/core/project-graph'\nimport { getStudioOperations } from '../operations'\nimport type { OperationResult, OperationsClient } from '../operations'\nimport { useOperationCache, useOperationQuery } from '@elytracms/studio/lib/query'\nimport { createRequiredContext } from '@elytracms/studio/lib/required-context'\nimport { STUDIO_SYSTEM_COLLECTION_IDS } from '../operations/session-hydration'\nimport { resolveDeploymentCollections } from '../workspace'\nimport { hasContentSession } from './collection-content'\nimport { captureSourceSample, cmsSourceForCollection } from './sample-capture'\nimport { deleteDataSource, loadDataSources, saveDataSource } from './sources-store'\n\n/**\n * The project's live data layer (brief §4.6, §7.5, EC-167). Holds the source\n * registry the Builder's Content tab binds through, plus the captured payloads\n * that drive binding resolution. One uniform model across CMS queries, data\n * providers, and the built-in REST/Convex kinds — resolution, sampling,\n * inference and tokenization treat them all identically.\n *\n * There is no source-authoring UI (EC-167): sources exist because code declared\n * them (registered data providers), the schema implied them (per-collection CMS\n * queries), or an editor flow provisioned them (repeating sections, template\n * pages).\n *\n * Persistence: when mounted with a `projectId`, the store hydrates the\n * project's persisted source records (the `cms-data-sources` system collection,\n * see `sources-store.ts`) over the deterministic playground seeds — persisted\n * wins by id, but never over a source provisioned/removed in THIS session —\n * and every provision/remove writes through `@elytracms/core/operations`. Without a\n * `projectId` (tests, fixtures) the store is pure session state, exactly as\n * before.\n */\nexport interface DataStore {\n  sources: DataSource[]\n  registry: SourceRegistry\n  payloads: PayloadStore\n  knownSourceIds: ReadonlySet<string>\n\n  getSource: (id: string) => DataSource | undefined\n  removeSource: (id: string) => void\n  /**\n   * Create or replace a source with a known id + config and capture its sample\n   * immediately (EC-166/EC-167): repeating sections and template pages\n   * provision their per-scope CMS query / provider sources through this.\n   */\n  provisionSource: (source: DataSource) => void\n\n  /**\n   * The latest persistence failure in plain language, or `null`. Persistence\n   * is best-effort on top of the live session (the canvas keeps working on\n   * session state), but a failure is recorded here — visible, never silent.\n   */\n  persistError: string | null\n\n  /** The stable path tokens a source exposes from its inferred schema (EC-085). */\n  tokensOf: (id: string) => string[]\n  schemaOf: (id: string) => InferredSchema | undefined\n  sampleOf: (id: string) => JsonValue | undefined\n\n  /** Resolve a binding to a renderer-ready resolution (value/props/condition/issue). */\n  resolve: (ref: BindingReference, item?: RepeaterItemContext) => BindingResolution\n  /** Resolve a binding to the concrete value the renderer injects (EC-086–089). */\n  resolveValue: (ref: BindingReference, item?: RepeaterItemContext) => JsonValue | undefined\n  /** Evaluate a condition against the captured payloads (EC-088). */\n  resolveCondition: (condition: Condition, item?: RepeaterItemContext) => ConditionResolution\n}\n\nexport interface DataState {\n  sources: DataSource[]\n  /**\n   * Ids provisioned or removed in THIS session. Hydration (which resolves\n   * asynchronously) never overrides them — the editor's latest action wins\n   * over whatever was persisted before it.\n   */\n  sessionIds: ReadonlySet<string>\n}\n\nexport type DataAction =\n  | { type: 'remove'; id: string }\n  | { type: 'provision'; source: DataSource }\n  /** Merge the project's persisted source records in (persisted wins over seeds). */\n  | { type: 'hydrate'; sources: DataSource[] }\n\nfunction upsert(sources: DataSource[], source: DataSource): DataSource[] {\n  const exists = sources.some((s) => s.id === source.id)\n  return exists ? sources.map((s) => (s.id === source.id ? source : s)) : [...sources, source]\n}\n\n/**\n * A persisted record hydrates as-is when it carries its captured sample;\n * otherwise recapture. Exception (EC-177 gap 1): with a hydrated content\n * session configured (Convex mode), CMS sources ALWAYS recapture by replaying\n * their stored query over the live documents — a sample captured by an earlier\n * session may carry stale (or fixture-derived) entries.\n */\nfunction withSample(source: DataSource): DataSource {\n  if (source.kind === 'cms' && hasContentSession()) {\n    const sample = captureSourceSample(source)\n    return sample !== undefined ? captureSample(source, sample) : source\n  }\n  if (source.sample !== undefined) return source\n  // No persisted sample: try an honest capture (a provider runs; anything the\n  // studio can't fetch returns undefined) — never fabricate.\n  const sample = captureSourceSample(source)\n  return sample !== undefined ? captureSample(source, sample) : source\n}\n\n/**\n * The store's reducer, exported because hydration/session-precedence semantics\n * live here and the app's test harness has no DOM to drive effects through.\n */\nexport function dataStateReducer(state: DataState, action: DataAction): DataState {\n  switch (action.type) {\n    case 'remove':\n      return {\n        ...state,\n        sources: state.sources.filter((s) => s.id !== action.id),\n        sessionIds: new Set([...state.sessionIds, action.id]),\n      }\n    case 'provision': {\n      // Upsert by id; attach a sample only if one can be captured honestly (a\n      // provider run, or live CMS content) — otherwise the source carries none.\n      const sample = captureSourceSample(action.source)\n      const provisioned = sample !== undefined ? captureSample(action.source, sample) : action.source\n      return {\n        ...state,\n        sources: upsert(state.sources, provisioned),\n        sessionIds: new Set([...state.sessionIds, provisioned.id]),\n      }\n    }\n    case 'hydrate': {\n      let sources = state.sources\n      for (const source of action.sources) {\n        if (state.sessionIds.has(source.id)) continue // this session already decided\n        sources = upsert(sources, withSample(source))\n      }\n      return sources === state.sources ? state : { ...state, sources }\n    }\n    default:\n      return state\n  }\n}\n\nconst { Context: DataContext, useRequired: useData } = createRequiredContext<DataStore>('Data')\n\n/**\n * The session's starting state: EMPTY. The studio seeds no sample sources (Oli,\n * 2026-06-19) — real sources arrive from the project's config collections (the\n * hydrate effect, Convex mode) or are added by the author. Nothing is faked.\n */\nexport function initialDataState(): DataState {\n  return { sources: [], sessionIds: new Set() }\n}\n\nexport interface DataProviderProps {\n  children: ReactNode\n  /**\n   * When set, the store hydrates from and persists to this project's\n   * `cms-data-sources` system collection (through `@elytracms/core/operations`).\n   * Without it the store is pure session state (tests, fixtures).\n   */\n  projectId?: string\n}\n\nexport function DataProvider({ children, projectId }: DataProviderProps) {\n  const [state, dispatch] = useReducer(dataStateReducer, undefined, initialDataState)\n  const [persistError, setPersistError] = useState<string | null>(null)\n\n  // EC-192: surface every config-driven content collection as a pickable CMS\n  // source, so the binding/condition pickers list what actually exists — the\n  // same collection set the CMS uses (`resolveDeploymentCollections`) — rather\n  // than only the demo fixture sources. Merged additively (the `hydrate` upsert\n  // skips session-decided ids and recaptures live samples in Convex mode); studio\n  // SYSTEM collections (routes/redirects/saved views/data sources) are excluded.\n  useEffect(() => {\n    if (projectId === undefined) return\n    const collections = resolveDeploymentCollections().filter(\n      (collection) => !STUDIO_SYSTEM_COLLECTION_IDS.has(collection.id),\n    )\n    if (collections.length === 0) return\n    dispatch({ type: 'hydrate', sources: collections.map(cmsSourceForCollection) })\n  }, [projectId])\n\n  // Hydrate the project's persisted sources through the one operations-backed\n  // query cache (EC-308/AD-17). Sources provisioned by other sessions on the\n  // same project show up here; the playground seeds stay for everything not\n  // persisted. The reducer's `hydrate` keeps session precedence — a source\n  // provisioned/removed in THIS session always wins over the hydrated list.\n  const cache = useOperationCache()\n  const sourcesQuery = useOperationQuery<DataSource[]>({\n    queryKey: ['dataSources', projectId ?? '∅'],\n    loader: async (operations) => {\n      const result = await loadDataSources(operations, projectId as string)\n      if (!result.ok) throw new Error(result.error.message)\n      return result.value\n    },\n    enabled: projectId !== undefined,\n  })\n  const hydratedSources = sourcesQuery.data\n  useEffect(() => {\n    if (hydratedSources) dispatch({ type: 'hydrate', sources: hydratedSources })\n  }, [hydratedSources])\n  const sourcesError = sourcesQuery.isError ? sourcesQuery.error : null\n  useEffect(() => {\n    if (sourcesError)\n      setPersistError(sourcesError instanceof Error ? sourcesError.message : 'Loading data sources failed.')\n  }, [sourcesError])\n\n  // Best-effort persistence on top of the live session: the canvas keeps\n  // working on session state; a failed write surfaces via `persistError`. On a\n  // confirmed write, invalidate the hydration query so a later remount\n  // re-hydrates the provisioned/removed source rather than a stale list.\n  const persist = useCallback(\n    (write: (operations: OperationsClient, projectId: string) => Promise<OperationResult<void>>) => {\n      if (projectId === undefined) return\n      void getStudioOperations()\n        .then(({ operations }) => write(operations, projectId))\n        .then((result) => {\n          if (!result.ok) {\n            setPersistError(result.error.message)\n            return\n          }\n          void cache.invalidate(['dataSources', projectId])\n        })\n        .catch((error: unknown) => {\n          setPersistError(error instanceof Error ? error.message : 'Saving the data source failed.')\n        })\n    },\n    [projectId, cache],\n  )\n\n  const store = useMemo<DataStore>(() => {\n    const registry = SourceRegistry.from(state.sources)\n    const payloads: Record<string, JsonValue> = {}\n    for (const source of state.sources) {\n      if (source.sample !== undefined) payloads[source.id] = source.sample\n    }\n    const knownSourceIds = registry.knownSourceIds()\n    const ctx = { payloads, registry }\n\n    const getSource = (id: string) => registry.get(id)\n    const resolve = (ref: BindingReference, item?: RepeaterItemContext) =>\n      resolveBinding(ref, ctx, item)\n\n    return {\n      sources: state.sources,\n      registry,\n      payloads,\n      knownSourceIds,\n      getSource,\n      removeSource: (id) => {\n        dispatch({ type: 'remove', id })\n        persist((operations, pid) => deleteDataSource(operations, pid, id))\n      },\n      provisionSource: (source) => {\n        dispatch({ type: 'provision', source })\n        // Persist exactly what the session resolves: the source plus any sample\n        // that can be captured honestly (a provider run / live CMS content) —\n        // never a fabricated one. Matches the `provision` reducer.\n        const sample = captureSourceSample(source)\n        const provisioned = sample !== undefined ? captureSample(source, sample) : source\n        persist((operations, pid) => saveDataSource(operations, pid, provisioned))\n      },\n      persistError,\n      tokensOf: (id) => {\n        const schema = getSource(id)?.schema\n        return schema ? tokensForSchema(schema) : []\n      },\n      schemaOf: (id) => {\n        const source = getSource(id)\n        if (source?.schema) return source.schema\n        if (source?.sample !== undefined) return inferSchema(source.sample)\n        return undefined\n      },\n      sampleOf: (id) => getSource(id)?.sample,\n      resolve,\n      resolveValue: (ref, item) => {\n        const r = resolve(ref, item)\n        switch (r.kind) {\n          case 'value':\n            return r.value\n          case 'props':\n            return r.props\n          case 'condition':\n            return r.pass\n          case 'issue':\n            return undefined\n          default: {\n            const never: never = r\n            return never\n          }\n        }\n      },\n      resolveCondition: (condition, item) => resolveCondition(condition, ctx, item),\n    }\n  }, [state, persist, persistError])\n\n  return <DataContext.Provider value={store}>{children}</DataContext.Provider>\n}\n\nexport { useData }\n"]}

package/dist/lib/delivery/instant-publish.d.ts

@@ -1,18 +1,14 @@
 /**
- * EC-268: instant-publish (EC-146) configuration health, studio-side. The Convex
- * `delivery:deliveryConfig` query reports whether each delivery env var is set
- * (booleans only — never the values); these helpers turn that into the list the
- * health banner shows. Kept pure + React-free so it is unit-testable and reusable
- * (a future `elytra doctor`, EC-259, can format the same status).
+ * EC-268: instant-publish (EC-146) configuration health, studio-side. Reads
+ * through `operations.delivery.config` (EC-329 — the operations seam, not a
+ * raw Convex client) to `PersistenceAdapter.delivery`, reporting whether each
+ * delivery env var is set (booleans only — never the values); these helpers
+ * turn that into the list the health banner shows. Kept pure + React-free so
+ * it is unit-testable and reusable (a future `elytra doctor`, EC-259, can
+ * format the same status).
  */
-export interface DeliveryConfigStatus {
-    /** `CANVAS_PROJECT_SCOPE` — without it `publishing.publish` never schedules the webhook. */
-    projectScope: boolean;
-    /** `CANVAS_REVALIDATE_ENDPOINT` — the host route the webhook POSTs to. */
-    revalidateEndpoint: boolean;
-    /** `CANVAS_REVALIDATE_SECRET` — shared HMAC secret (= host `REVALIDATE_SECRET`). */
-    revalidateSecret: boolean;
-}
+import type { DeliveryConfigStatus } from '@elytracms/core/persistence';
+export type { DeliveryConfigStatus };
 /** The pipeline env vars, in setup order, paired with the status key each maps to. */
 export declare const INSTANT_PUBLISH_VARS: readonly [{
     readonly key: "projectScope";

package/dist/lib/delivery/instant-publish.js

@@ -1,10 +1,3 @@
-/**
- * EC-268: instant-publish (EC-146) configuration health, studio-side. The Convex
- * `delivery:deliveryConfig` query reports whether each delivery env var is set
- * (booleans only — never the values); these helpers turn that into the list the
- * health banner shows. Kept pure + React-free so it is unit-testable and reusable
- * (a future `elytra doctor`, EC-259, can format the same status).
- */
 /** The pipeline env vars, in setup order, paired with the status key each maps to. */
 export const INSTANT_PUBLISH_VARS = [
     { key: 'projectScope', env: 'CANVAS_PROJECT_SCOPE' },

package/dist/lib/delivery/instant-publish.js.map

@@ -1 +1 @@
-{"version":3,"file":"instant-publish.js","sourceRoot":"","sources":["../../../src/lib/delivery/instant-publish.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,sFAAsF;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,sBAAsB,EAAE;IACpD,EAAE,GAAG,EAAE,oBAAoB,EAAE,GAAG,EAAE,4BAA4B,EAAE;IAChE,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,0BAA0B,EAAE;CACsB,CAAA;AAEpF,qFAAqF;AACrF,MAAM,UAAU,yBAAyB,CAAC,MAA4B;IACpE,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AAC7F,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,0BAA0B,CAAC,MAA4B;IACrE,OAAO,yBAAyB,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAA;AACvD,CAAC","sourcesContent":["/**\n * EC-268: instant-publish (EC-146) configuration health, studio-side. The Convex\n * `delivery:deliveryConfig` query reports whether each delivery env var is set\n * (booleans only — never the values); these helpers turn that into the list the\n * health banner shows. Kept pure + React-free so it is unit-testable and reusable\n * (a future `elytra doctor`, EC-259, can format the same status).\n */\n\nexport interface DeliveryConfigStatus {\n  /** `CANVAS_PROJECT_SCOPE` — without it `publishing.publish` never schedules the webhook. */\n  projectScope: boolean\n  /** `CANVAS_REVALIDATE_ENDPOINT` — the host route the webhook POSTs to. */\n  revalidateEndpoint: boolean\n  /** `CANVAS_REVALIDATE_SECRET` — shared HMAC secret (= host `REVALIDATE_SECRET`). */\n  revalidateSecret: boolean\n}\n\n/** The pipeline env vars, in setup order, paired with the status key each maps to. */\nexport const INSTANT_PUBLISH_VARS = [\n  { key: 'projectScope', env: 'CANVAS_PROJECT_SCOPE' },\n  { key: 'revalidateEndpoint', env: 'CANVAS_REVALIDATE_ENDPOINT' },\n  { key: 'revalidateSecret', env: 'CANVAS_REVALIDATE_SECRET' },\n] as const satisfies ReadonlyArray<{ key: keyof DeliveryConfigStatus; env: string }>\n\n/** The env var names that are NOT set, in setup order (empty = fully configured). */\nexport function missingInstantPublishVars(status: DeliveryConfigStatus): string[] {\n  return INSTANT_PUBLISH_VARS.filter((entry) => !status[entry.key]).map((entry) => entry.env)\n}\n\n/** True when every instant-publish env var is set. */\nexport function isInstantPublishConfigured(status: DeliveryConfigStatus): boolean {\n  return missingInstantPublishVars(status).length === 0\n}\n"]}
+{"version":3,"file":"instant-publish.js","sourceRoot":"","sources":["../../../src/lib/delivery/instant-publish.ts"],"names":[],"mappings":"AAYA,sFAAsF;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,sBAAsB,EAAE;IACpD,EAAE,GAAG,EAAE,oBAAoB,EAAE,GAAG,EAAE,4BAA4B,EAAE;IAChE,EAAE,GAAG,EAAE,kBAAkB,EAAE,GAAG,EAAE,0BAA0B,EAAE;CACsB,CAAA;AAEpF,qFAAqF;AACrF,MAAM,UAAU,yBAAyB,CAAC,MAA4B;IACpE,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AAC7F,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,0BAA0B,CAAC,MAA4B;IACrE,OAAO,yBAAyB,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAA;AACvD,CAAC","sourcesContent":["/**\n * EC-268: instant-publish (EC-146) configuration health, studio-side. Reads\n * through `operations.delivery.config` (EC-329 — the operations seam, not a\n * raw Convex client) to `PersistenceAdapter.delivery`, reporting whether each\n * delivery env var is set (booleans only — never the values); these helpers\n * turn that into the list the health banner shows. Kept pure + React-free so\n * it is unit-testable and reusable (a future `elytra doctor`, EC-259, can\n * format the same status).\n */\nimport type { DeliveryConfigStatus } from '@elytracms/core/persistence'\nexport type { DeliveryConfigStatus }\n\n/** The pipeline env vars, in setup order, paired with the status key each maps to. */\nexport const INSTANT_PUBLISH_VARS = [\n  { key: 'projectScope', env: 'CANVAS_PROJECT_SCOPE' },\n  { key: 'revalidateEndpoint', env: 'CANVAS_REVALIDATE_ENDPOINT' },\n  { key: 'revalidateSecret', env: 'CANVAS_REVALIDATE_SECRET' },\n] as const satisfies ReadonlyArray<{ key: keyof DeliveryConfigStatus; env: string }>\n\n/** The env var names that are NOT set, in setup order (empty = fully configured). */\nexport function missingInstantPublishVars(status: DeliveryConfigStatus): string[] {\n  return INSTANT_PUBLISH_VARS.filter((entry) => !status[entry.key]).map((entry) => entry.env)\n}\n\n/** True when every instant-publish env var is set. */\nexport function isInstantPublishConfigured(status: DeliveryConfigStatus): boolean {\n  return missingInstantPublishVars(status).length === 0\n}\n"]}

package/dist/lib/diff-view-preference.js

@@ -6,16 +6,16 @@
  * best-effort instead of a new persistence mechanism. Unavailable storage (SSR,
  * privacy mode) degrades to the default every session — never a crash.
  */
-import { safeReadStorage, safeWriteStorage } from './local-preference';
+import { createEnumPreference } from './local-preference';
 export const DIFF_VIEW_STORAGE_KEY = 'elytra-version-diff-view';
 export const DEFAULT_DIFF_VIEW_MODE = 'sideBySide';
+const preference = createEnumPreference(DIFF_VIEW_STORAGE_KEY, ['sideBySide', 'unified'], DEFAULT_DIFF_VIEW_MODE);
 /** Read the persisted preference, or the default when unset/unavailable/invalid. */
 export function readDiffViewMode() {
-    const value = safeReadStorage(DIFF_VIEW_STORAGE_KEY);
-    return value === 'sideBySide' || value === 'unified' ? value : DEFAULT_DIFF_VIEW_MODE;
+    return preference.read();
 }
 /** Persist the preference (best-effort; storage may be unavailable). */
 export function storeDiffViewMode(mode) {
-    safeWriteStorage(DIFF_VIEW_STORAGE_KEY, mode);
+    preference.store(mode);
 }
 //# sourceMappingURL=diff-view-preference.js.map