@elytracms/studio 0.0.56 → 0.0.57

package/dist/lib/ai/chat-loop.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Chat loop policy cores (EC-334) — the pure pieces the `useChat` panel wires up.
+ *
+ * `useChat` owns messages, streaming, and busy-state; what the SDK does NOT own
+ * lives here as deterministic, node-testable functions (house pattern — no jsdom):
+ *
+ *  - {@link withStepCap}: the `sendAutomaticallyWhen` wrapper. The SDK's
+ *    auto-continuation is unbounded by default — it re-posts as long as the model
+ *    keeps requesting tools. This wraps the base predicate
+ *    (`lastAssistantMessageIsCompleteWithToolCalls`, imported by the panel from
+ *    `ai` inside the lazy chunk) with a per-user-turn step budget carried over
+ *    from the retired orchestrator's `DEFAULT_MAX_STEPS`. A capped turn stops
+ *    cleanly and `onCap` lets the panel surface a VISIBLE message — never a
+ *    silent stall.
+ *  - {@link clearConversation}: EC-380's busy-safe clear core. Clearing while a
+ *    response is in flight aborts it first (`useChat`'s `stop()`), THEN resets —
+ *    so no background continuation survives into the fresh conversation.
+ *
+ * Bundle discipline: only single-line `import type` from `ai` (erased at
+ * compile) — this module adds no runtime SDK edge to the barrel (pinned in
+ * `bundle.test.ts`).
+ */
+import type { UIMessage } from 'ai';
+/**
+ * Max tool invocations the assistant may chain per user turn before the loop
+ * stops auto-continuing (the retired orchestrator's budget, carried over).
+ */
+export declare const DEFAULT_MAX_STEPS = 6;
+/**
+ * Count the tool invocations in one UIMessage. With client-executed tools the
+ * whole turn accumulates into ONE assistant message (continuations re-post with
+ * its `messageId`), so this is the per-user-turn step count. Structural on the
+ * part `type` (`tool-<name>` / `dynamic-tool`) — no SDK runtime import.
+ */
+export declare function countToolInvocations(message: Pick<UIMessage, 'parts'>): number;
+/** The `sendAutomaticallyWhen` predicate shape (`ChatInit.sendAutomaticallyWhen`). */
+export type SendAutomaticallyPredicate = (options: {
+    messages: UIMessage[];
+}) => boolean | PromiseLike<boolean>;
+export interface StepCapOptions {
+    /** Step budget per user turn (default {@link DEFAULT_MAX_STEPS}). */
+    maxSteps?: number;
+    /**
+     * Called when the cap blocks a continuation the base predicate wanted —
+     * the panel surfaces a visible "stopped after N steps" message. May fire
+     * more than once per capped turn (the SDK re-evaluates the predicate);
+     * the surfaced message is idempotent.
+     */
+    onCap?: () => void;
+}
+/**
+ * Wrap a `sendAutomaticallyWhen` predicate with a per-user-turn step cap:
+ * delegate first (only a continuation the base predicate WANTS can be capped),
+ * then refuse once the last assistant message carries `maxSteps`+ tool calls.
+ */
+export declare function withStepCap(base: SendAutomaticallyPredicate, options?: StepCapOptions): SendAutomaticallyPredicate;
+/** The slice of `useChat` the clear core needs (structural — test with fakes). */
+export interface ClearableChat {
+    /** `useChat`'s status: busy while `submitted` or `streaming`. */
+    status: 'submitted' | 'streaming' | 'ready' | 'error';
+    /** Abort the in-flight response (`useChat`'s `stop`). */
+    stop: () => Promise<void> | void;
+}
+/**
+ * EC-380 — clear / new-topic, busy-state safe: abort any in-flight response
+ * FIRST (otherwise a background tool continuation could re-post into the void),
+ * then run `reset` (new chat id + proposal-map reset — pending proposals are
+ * discarded with reject semantics; nothing half-applied survives).
+ */
+export declare function clearConversation(chat: ClearableChat, reset: () => void): Promise<void>;

package/dist/lib/ai/chat-loop.js

@@ -0,0 +1,46 @@
+/**
+ * Max tool invocations the assistant may chain per user turn before the loop
+ * stops auto-continuing (the retired orchestrator's budget, carried over).
+ */
+export const DEFAULT_MAX_STEPS = 6;
+/**
+ * Count the tool invocations in one UIMessage. With client-executed tools the
+ * whole turn accumulates into ONE assistant message (continuations re-post with
+ * its `messageId`), so this is the per-user-turn step count. Structural on the
+ * part `type` (`tool-<name>` / `dynamic-tool`) — no SDK runtime import.
+ */
+export function countToolInvocations(message) {
+    return message.parts.filter((part) => part.type === 'dynamic-tool' || part.type.startsWith('tool-')).length;
+}
+/**
+ * Wrap a `sendAutomaticallyWhen` predicate with a per-user-turn step cap:
+ * delegate first (only a continuation the base predicate WANTS can be capped),
+ * then refuse once the last assistant message carries `maxSteps`+ tool calls.
+ */
+export function withStepCap(base, options = {}) {
+    const maxSteps = options.maxSteps ?? DEFAULT_MAX_STEPS;
+    return async ({ messages }) => {
+        if (!(await base({ messages })))
+            return false;
+        const last = messages.at(-1);
+        const steps = last && last.role === 'assistant' ? countToolInvocations(last) : 0;
+        if (steps >= maxSteps) {
+            options.onCap?.();
+            return false;
+        }
+        return true;
+    };
+}
+/**
+ * EC-380 — clear / new-topic, busy-state safe: abort any in-flight response
+ * FIRST (otherwise a background tool continuation could re-post into the void),
+ * then run `reset` (new chat id + proposal-map reset — pending proposals are
+ * discarded with reject semantics; nothing half-applied survives).
+ */
+export async function clearConversation(chat, reset) {
+    if (chat.status === 'submitted' || chat.status === 'streaming') {
+        await chat.stop();
+    }
+    reset();
+}
+//# sourceMappingURL=chat-loop.js.map

package/dist/lib/ai/chat-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-loop.js","sourceRoot":"","sources":["../../../src/lib/ai/chat-loop.ts"],"names":[],"mappings":"AAwBA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAA;AAElC;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAiC;IACpE,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,CACzB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CACxE,CAAC,MAAM,CAAA;AACV,CAAC;AAmBD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,IAAgC,EAChC,UAA0B,EAAE;IAE5B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,iBAAiB,CAAA;IACtD,OAAO,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC5B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YAAE,OAAO,KAAK,CAAA;QAC7C,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QAC5B,MAAM,KAAK,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAChF,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAA;YACjB,OAAO,KAAK,CAAA;QACd,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC,CAAA;AACH,CAAC;AAUD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAmB,EAAE,KAAiB;IAC5E,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;QAC/D,MAAM,IAAI,CAAC,IAAI,EAAE,CAAA;IACnB,CAAC;IACD,KAAK,EAAE,CAAA;AACT,CAAC","sourcesContent":["/**\n * Chat loop policy cores (EC-334) — the pure pieces the `useChat` panel wires up.\n *\n * `useChat` owns messages, streaming, and busy-state; what the SDK does NOT own\n * lives here as deterministic, node-testable functions (house pattern — no jsdom):\n *\n *  - {@link withStepCap}: the `sendAutomaticallyWhen` wrapper. The SDK's\n *    auto-continuation is unbounded by default — it re-posts as long as the model\n *    keeps requesting tools. This wraps the base predicate\n *    (`lastAssistantMessageIsCompleteWithToolCalls`, imported by the panel from\n *    `ai` inside the lazy chunk) with a per-user-turn step budget carried over\n *    from the retired orchestrator's `DEFAULT_MAX_STEPS`. A capped turn stops\n *    cleanly and `onCap` lets the panel surface a VISIBLE message — never a\n *    silent stall.\n *  - {@link clearConversation}: EC-380's busy-safe clear core. Clearing while a\n *    response is in flight aborts it first (`useChat`'s `stop()`), THEN resets —\n *    so no background continuation survives into the fresh conversation.\n *\n * Bundle discipline: only single-line `import type` from `ai` (erased at\n * compile) — this module adds no runtime SDK edge to the barrel (pinned in\n * `bundle.test.ts`).\n */\nimport type { UIMessage } from 'ai'\n\n/**\n * Max tool invocations the assistant may chain per user turn before the loop\n * stops auto-continuing (the retired orchestrator's budget, carried over).\n */\nexport const DEFAULT_MAX_STEPS = 6\n\n/**\n * Count the tool invocations in one UIMessage. With client-executed tools the\n * whole turn accumulates into ONE assistant message (continuations re-post with\n * its `messageId`), so this is the per-user-turn step count. Structural on the\n * part `type` (`tool-<name>` / `dynamic-tool`) — no SDK runtime import.\n */\nexport function countToolInvocations(message: Pick<UIMessage, 'parts'>): number {\n  return message.parts.filter(\n    (part) => part.type === 'dynamic-tool' || part.type.startsWith('tool-'),\n  ).length\n}\n\n/** The `sendAutomaticallyWhen` predicate shape (`ChatInit.sendAutomaticallyWhen`). */\nexport type SendAutomaticallyPredicate = (options: {\n  messages: UIMessage[]\n}) => boolean | PromiseLike<boolean>\n\nexport interface StepCapOptions {\n  /** Step budget per user turn (default {@link DEFAULT_MAX_STEPS}). */\n  maxSteps?: number\n  /**\n   * Called when the cap blocks a continuation the base predicate wanted —\n   * the panel surfaces a visible \"stopped after N steps\" message. May fire\n   * more than once per capped turn (the SDK re-evaluates the predicate);\n   * the surfaced message is idempotent.\n   */\n  onCap?: () => void\n}\n\n/**\n * Wrap a `sendAutomaticallyWhen` predicate with a per-user-turn step cap:\n * delegate first (only a continuation the base predicate WANTS can be capped),\n * then refuse once the last assistant message carries `maxSteps`+ tool calls.\n */\nexport function withStepCap(\n  base: SendAutomaticallyPredicate,\n  options: StepCapOptions = {},\n): SendAutomaticallyPredicate {\n  const maxSteps = options.maxSteps ?? DEFAULT_MAX_STEPS\n  return async ({ messages }) => {\n    if (!(await base({ messages }))) return false\n    const last = messages.at(-1)\n    const steps = last && last.role === 'assistant' ? countToolInvocations(last) : 0\n    if (steps >= maxSteps) {\n      options.onCap?.()\n      return false\n    }\n    return true\n  }\n}\n\n/** The slice of `useChat` the clear core needs (structural — test with fakes). */\nexport interface ClearableChat {\n  /** `useChat`'s status: busy while `submitted` or `streaming`. */\n  status: 'submitted' | 'streaming' | 'ready' | 'error'\n  /** Abort the in-flight response (`useChat`'s `stop`). */\n  stop: () => Promise<void> | void\n}\n\n/**\n * EC-380 — clear / new-topic, busy-state safe: abort any in-flight response\n * FIRST (otherwise a background tool continuation could re-post into the void),\n * then run `reset` (new chat id + proposal-map reset — pending proposals are\n * discarded with reject semantics; nothing half-applied survives).\n */\nexport async function clearConversation(chat: ClearableChat, reset: () => void): Promise<void> {\n  if (chat.status === 'submitted' || chat.status === 'streaming') {\n    await chat.stop()\n  }\n  reset()\n}\n"]}

package/dist/lib/ai/chat-state.d.ts

@@ -1,81 +1,94 @@
 /**
- * The chat panel's pure state core (EC-199).
+ * The chat panel's proposal-review state (EC-199, reshaped by EC-334).
  *
- * House testing pattern (AGENTS.md): no jsdom / renderHook — the panel's behaviour
- * lives in this deterministic reducer (submit → busy + activity, tool steps append,
- * a result becomes a message or a reviewable proposal, apply/reject transition the
- * proposal), tested directly; the React component is a thin shell over it. Ids are a
- * monotonic counter in state, so a scripted action sequence yields identical output
- * every run (determinism principle).
+ * `useChat` (the AI SDK) owns the conversation: messages, streaming text, tool
+ * parts, busy-status. This reducer keeps ONLY what the SDK does not own:
+ *
+ *  - the proposal review map — the FULL proposals the terminal tools
+ *    (`createDocument` / `translateDocument`) produce, keyed by `toolCallId`
+ *    (the model receives only a compact summary as the tool output; the editor
+ *    reviews the real patch here), each `pending` → `applied` | `rejected`;
+ *  - the last blocking error (route/provider/step-cap failure), surfaced as a
+ *    visible note and cleared on the next submit.
+ *
+ * EC-380 (`clear`): a new conversation resets this state entirely — pending
+ * proposals are discarded with REJECT semantics (they were never applied and
+ * nothing half-applied survives; an applied draft already lives in the CMS and
+ * is untouched). The panel pairs the dispatch with a fresh `useChat` id.
+ *
+ * House testing pattern (AGENTS.md): the panel's behaviour lives in this
+ * deterministic reducer, tested directly; the React component is a thin shell.
  */
-import type { FieldValues } from '@elytracms/core/cms-core';
+import type { CmsDocument, CmsValidationIssue, FieldValues } from '@elytracms/core/cms-core';
 import type { AiProvenance, ContentPatch } from './types.js';
-import type { CreateFlowResult, CreateFlowStep, ProposalOrigin } from './create-flow.js';
-/** A proposal the editor reviews as a diff and then applies (as a draft) or rejects. */
-export interface ProposalReview {
-    id: string;
-    /** Fresh authoring ('create') vs a fill-empty translation ('translate') of an existing doc. */
+/** A proposal's kind: fresh authoring, or a fill-empty translation of an existing doc. */
+export type ProposalOrigin = 'create' | 'translate';
+/**
+ * The full proposal payload a terminal tool hands to the review UI (via
+ * `onProposal` on the executor — see `tools.ts`). The model never sees this;
+ * it gets a compact summary as the tool output.
+ */
+export interface ChatProposal {
     origin: ProposalOrigin;
     collection: string;
     documentId: string;
     patch: ContentPatch;
     provenance: AiProvenance;
-    /** For a translation: the existing values the diff renders "before". */
+    /** Generation attempts made (1 = happy path, >1 = repaired). */
+    attempts: number;
+    /** Non-error issues on the accepted content (warnings). */
+    issues: CmsValidationIssue[];
+    /** For a translation: the existing document values the diff renders "before". */
     before?: {
         values?: FieldValues;
         localized?: Record<string, FieldValues>;
     };
-    status: 'pending' | 'applied' | 'rejected';
 }
-/** One rendered turn in the conversation. */
-export type ChatMessage = {
-    id: string;
-    role: 'user';
-    text: string;
-} | {
-    id: string;
-    role: 'assistant';
-    kind: 'text';
-    text: string;
-} | {
-    id: string;
-    role: 'assistant';
-    kind: 'activity';
-    steps: CreateFlowStep[];
-} | {
+/** A proposal under review: {@link ChatProposal} + its review status. */
+export interface ProposalReview extends ChatProposal {
+    /** The tool call that produced it (`toolCallId`) — the review key. */
     id: string;
-    role: 'assistant';
-    kind: 'proposal';
-    proposal: ProposalReview;
-};
-export interface ChatState {
-    status: 'idle' | 'busy';
-    messages: ChatMessage[];
-    /** Id of the live activity message the current turn appends tool steps to. */
-    activityId: string | null;
-    /** Last blocking error (route/provider failure), surfaced then cleared on next submit. */
+    status: 'pending' | 'applied' | 'rejected';
+}
+export interface ChatReviewState {
+    /** Proposals keyed by `toolCallId`. */
+    proposals: Record<string, ProposalReview>;
+    /** Last blocking error (route/provider/step-cap), surfaced then cleared on submit. */
     error: string | null;
-    /** Monotonic id source — keeps the reducer pure + deterministic. */
-    seq: number;
 }
-export declare const initialChatState: ChatState;
-export type ChatAction = {
-    type: 'submit';
-    text: string;
+export declare const initialChatReviewState: ChatReviewState;
+export type ChatReviewAction = {
+    type: 'propose';
+    toolCallId: string;
+    proposal: ChatProposal;
 } | {
-    type: 'step';
-    step: CreateFlowStep;
+    type: 'apply';
+    toolCallId: string;
 } | {
-    type: 'result';
-    result: CreateFlowResult;
+    type: 'reject';
+    toolCallId: string;
 } | {
     type: 'fail';
     message: string;
 } | {
-    type: 'apply';
-    proposalId: string;
-} | {
-    type: 'reject';
-    proposalId: string;
+    type: 'clear-error';
+}
+/** EC-380: new conversation — full reset; pending proposals discarded (reject semantics). */
+ | {
+    type: 'clear';
+};
+export declare function chatReviewReducer(state: ChatReviewState, action: ChatReviewAction): ChatReviewState;
+/**
+ * Turn a proposal patch into the before/after document pair the EC-317 diff
+ * engine (`diffDocuments`) compares. For a fresh document `before` is empty
+ * (the whole proposal reads as "added"); for a translation pass the existing
+ * document's values. Pure — the reviewable diff is a straight
+ * `diffDocuments(collection, before, after)`.
+ */
+export declare function proposalDocuments(patch: ContentPatch, before?: {
+    values?: FieldValues;
+    localized?: Record<string, FieldValues>;
+}): {
+    before: CmsDocument;
+    after: CmsDocument;
 };
-export declare function chatReducer(state: ChatState, action: ChatAction): ChatState;

package/dist/lib/ai/chat-state.js

@@ -1,103 +1,62 @@
-export const initialChatState = {
-    status: 'idle',
-    messages: [],
-    activityId: null,
+export const initialChatReviewState = {
+    proposals: {},
     error: null,
-    seq: 0,
 };
-function id(state) {
-    return [`m${state.seq}`, state.seq + 1];
+function transition(state, toolCallId, status) {
+    const existing = state.proposals[toolCallId];
+    // Only a PENDING proposal transitions — apply/reject are one-shot.
+    if (!existing || existing.status !== 'pending')
+        return state;
+    return {
+        ...state,
+        proposals: { ...state.proposals, [toolCallId]: { ...existing, status } },
+    };
 }
-/** Drop a still-empty activity message (a turn that produced no tool steps). */
-function pruneEmptyActivity(messages, activityId) {
-    if (!activityId)
-        return messages;
-    return messages.filter((m) => !(m.id === activityId &&
-        m.role === 'assistant' &&
-        m.kind === 'activity' &&
-        m.steps.length === 0));
-}
-export function chatReducer(state, action) {
+export function chatReviewReducer(state, action) {
     switch (action.type) {
-        case 'submit': {
-            const text = action.text.trim();
-            if (text.length === 0 || state.status === 'busy')
-                return state;
-            const [userId, s1] = id(state);
-            const activityId = `m${s1}`;
-            const messages = [
-                ...state.messages,
-                { id: userId, role: 'user', text },
-                { id: activityId, role: 'assistant', kind: 'activity', steps: [] },
-            ];
-            return { ...state, status: 'busy', error: null, messages, activityId, seq: s1 + 1 };
-        }
-        case 'step': {
-            if (!state.activityId)
-                return state;
-            return {
-                ...state,
-                messages: state.messages.map((m) => m.id === state.activityId && m.role === 'assistant' && m.kind === 'activity'
-                    ? { ...m, steps: [...m.steps, action.step] }
-                    : m),
-            };
-        }
-        case 'result': {
-            const messages = pruneEmptyActivity(state.messages, state.activityId);
-            const [msgId, nextSeq] = id({ ...state, seq: state.seq });
-            if (action.result.kind === 'proposal') {
-                const proposal = {
-                    id: msgId,
-                    origin: action.result.origin,
-                    collection: action.result.collection,
-                    documentId: action.result.documentId,
-                    patch: action.result.patch,
-                    provenance: action.result.provenance,
-                    ...(action.result.before ? { before: action.result.before } : {}),
-                    status: 'pending',
-                };
-                return {
-                    ...state,
-                    status: 'idle',
-                    activityId: null,
-                    seq: nextSeq,
-                    messages: [...messages, { id: msgId, role: 'assistant', kind: 'proposal', proposal }],
-                };
-            }
-            const text = action.result.kind === 'message' ? action.result.text : action.result.message;
+        case 'propose':
             return {
                 ...state,
-                status: 'idle',
-                activityId: null,
-                seq: nextSeq,
-                error: action.result.kind === 'error' ? text : null,
-                messages: [...messages, { id: msgId, role: 'assistant', kind: 'text', text }],
+                proposals: {
+                    ...state.proposals,
+                    [action.toolCallId]: { ...action.proposal, id: action.toolCallId, status: 'pending' },
+                },
             };
-        }
-        case 'fail': {
-            const messages = pruneEmptyActivity(state.messages, state.activityId);
-            const [msgId, nextSeq] = id(state);
-            return {
-                ...state,
-                status: 'idle',
-                activityId: null,
-                error: action.message,
-                seq: nextSeq,
-                messages: [...messages, { id: msgId, role: 'assistant', kind: 'text', text: action.message }],
-            };
-        }
         case 'apply':
-        case 'reject': {
-            const next = action.type === 'apply' ? 'applied' : 'rejected';
-            return {
-                ...state,
-                messages: state.messages.map((m) => m.role === 'assistant' && m.kind === 'proposal' && m.proposal.id === action.proposalId
-                    ? { ...m, proposal: { ...m.proposal, status: next } }
-                    : m),
-            };
-        }
+            return transition(state, action.toolCallId, 'applied');
+        case 'reject':
+            return transition(state, action.toolCallId, 'rejected');
+        case 'fail':
+            return state.error === action.message ? state : { ...state, error: action.message };
+        case 'clear-error':
+            return state.error === null ? state : { ...state, error: null };
+        case 'clear':
+            return initialChatReviewState;
         default:
             return state;
     }
 }
+/**
+ * Turn a proposal patch into the before/after document pair the EC-317 diff
+ * engine (`diffDocuments`) compares. For a fresh document `before` is empty
+ * (the whole proposal reads as "added"); for a translation pass the existing
+ * document's values. Pure — the reviewable diff is a straight
+ * `diffDocuments(collection, before, after)`.
+ */
+export function proposalDocuments(patch, before) {
+    return {
+        before: {
+            collection: patch.collection,
+            id: patch.id,
+            values: before?.values ?? {},
+            ...(before?.localized ? { localized: before.localized } : {}),
+        },
+        after: {
+            collection: patch.collection,
+            id: patch.id,
+            values: patch.values,
+            ...(patch.localized ? { localized: patch.localized } : {}),
+        },
+    };
+}
 //# sourceMappingURL=chat-state.js.map

package/dist/lib/ai/chat-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-state.js","sourceRoot":"","sources":["../../../src/lib/ai/chat-state.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The chat panel's pure state core (EC-199).\n *\n * House testing pattern (AGENTS.md): no jsdom / renderHook — the panel's behaviour\n * lives in this deterministic reducer (submit → busy + activity, tool steps append,\n * a result becomes a message or a reviewable proposal, apply/reject transition the\n * proposal), tested directly; the React component is a thin shell over it. Ids are a\n * monotonic counter in state, so a scripted action sequence yields identical output\n * every run (determinism principle).\n */\nimport type { FieldValues } from '@elytracms/core/cms-core'\nimport type { AiProvenance, ContentPatch } from './types'\nimport type { CreateFlowResult, CreateFlowStep, ProposalOrigin } from './create-flow'\n\n/** A proposal the editor reviews as a diff and then applies (as a draft) or rejects. */\nexport interface ProposalReview {\n  id: string\n  /** Fresh authoring ('create') vs a fill-empty translation ('translate') of an existing doc. */\n  origin: ProposalOrigin\n  collection: string\n  documentId: string\n  patch: ContentPatch\n  provenance: AiProvenance\n  /** For a translation: the existing values the diff renders \"before\". */\n  before?: { values?: FieldValues; localized?: Record<string, FieldValues> }\n  status: 'pending' | 'applied' | 'rejected'\n}\n\n/** One rendered turn in the conversation. */\nexport type ChatMessage =\n  | { id: string; role: 'user'; text: string }\n  | { id: string; role: 'assistant'; kind: 'text'; text: string }\n  | { id: string; role: 'assistant'; kind: 'activity'; steps: CreateFlowStep[] }\n  | { id: string; role: 'assistant'; kind: 'proposal'; proposal: ProposalReview }\n\nexport interface ChatState {\n  status: 'idle' | 'busy'\n  messages: ChatMessage[]\n  /** Id of the live activity message the current turn appends tool steps to. */\n  activityId: string | null\n  /** Last blocking error (route/provider failure), surfaced then cleared on next submit. */\n  error: string | null\n  /** Monotonic id source — keeps the reducer pure + deterministic. */\n  seq: number\n}\n\nexport const initialChatState: ChatState = {\n  status: 'idle',\n  messages: [],\n  activityId: null,\n  error: null,\n  seq: 0,\n}\n\nexport type ChatAction =\n  | { type: 'submit'; text: string }\n  | { type: 'step'; step: CreateFlowStep }\n  | { type: 'result'; result: CreateFlowResult }\n  | { type: 'fail'; message: string }\n  | { type: 'apply'; proposalId: string }\n  | { type: 'reject'; proposalId: string }\n\nfunction id(state: ChatState): [string, number] {\n  return [`m${state.seq}`, state.seq + 1]\n}\n\n/** Drop a still-empty activity message (a turn that produced no tool steps). */\nfunction pruneEmptyActivity(messages: ChatMessage[], activityId: string | null): ChatMessage[] {\n  if (!activityId) return messages\n  return messages.filter(\n    (m) =>\n      !(\n        m.id === activityId &&\n        m.role === 'assistant' &&\n        m.kind === 'activity' &&\n        m.steps.length === 0\n      ),\n  )\n}\n\nexport function chatReducer(state: ChatState, action: ChatAction): ChatState {\n  switch (action.type) {\n    case 'submit': {\n      const text = action.text.trim()\n      if (text.length === 0 || state.status === 'busy') return state\n      const [userId, s1] = id(state)\n      const activityId = `m${s1}`\n      const messages: ChatMessage[] = [\n        ...state.messages,\n        { id: userId, role: 'user', text },\n        { id: activityId, role: 'assistant', kind: 'activity', steps: [] },\n      ]\n      return { ...state, status: 'busy', error: null, messages, activityId, seq: s1 + 1 }\n    }\n    case 'step': {\n      if (!state.activityId) return state\n      return {\n        ...state,\n        messages: state.messages.map((m) =>\n          m.id === state.activityId && m.role === 'assistant' && m.kind === 'activity'\n            ? { ...m, steps: [...m.steps, action.step] }\n            : m,\n        ),\n      }\n    }\n    case 'result': {\n      const messages = pruneEmptyActivity(state.messages, state.activityId)\n      const [msgId, nextSeq] = id({ ...state, seq: state.seq })\n      if (action.result.kind === 'proposal') {\n        const proposal: ProposalReview = {\n          id: msgId,\n          origin: action.result.origin,\n          collection: action.result.collection,\n          documentId: action.result.documentId,\n          patch: action.result.patch,\n          provenance: action.result.provenance,\n          ...(action.result.before ? { before: action.result.before } : {}),\n          status: 'pending',\n        }\n        return {\n          ...state,\n          status: 'idle',\n          activityId: null,\n          seq: nextSeq,\n          messages: [...messages, { id: msgId, role: 'assistant', kind: 'proposal', proposal }],\n        }\n      }\n      const text =\n        action.result.kind === 'message' ? action.result.text : action.result.message\n      return {\n        ...state,\n        status: 'idle',\n        activityId: null,\n        seq: nextSeq,\n        error: action.result.kind === 'error' ? text : null,\n        messages: [...messages, { id: msgId, role: 'assistant', kind: 'text', text }],\n      }\n    }\n    case 'fail': {\n      const messages = pruneEmptyActivity(state.messages, state.activityId)\n      const [msgId, nextSeq] = id(state)\n      return {\n        ...state,\n        status: 'idle',\n        activityId: null,\n        error: action.message,\n        seq: nextSeq,\n        messages: [...messages, { id: msgId, role: 'assistant', kind: 'text', text: action.message }],\n      }\n    }\n    case 'apply':\n    case 'reject': {\n      const next = action.type === 'apply' ? 'applied' : 'rejected'\n      return {\n        ...state,\n        messages: state.messages.map((m) =>\n          m.role === 'assistant' && m.kind === 'proposal' && m.proposal.id === action.proposalId\n            ? { ...m, proposal: { ...m.proposal, status: next } }\n            : m,\n        ),\n      }\n    }\n    default:\n      return state\n  }\n}\n"]}
+{"version":3,"file":"chat-state.js","sourceRoot":"","sources":["../../../src/lib/ai/chat-state.ts"],"names":[],"mappings":"AA4DA,MAAM,CAAC,MAAM,sBAAsB,GAAoB;IACrD,SAAS,EAAE,EAAE;IACb,KAAK,EAAE,IAAI;CACZ,CAAA;AAWD,SAAS,UAAU,CACjB,KAAsB,EACtB,UAAkB,EAClB,MAA8B;IAE9B,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;IAC5C,mEAAmE;IACnE,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IAC5D,OAAO;QACL,GAAG,KAAK;QACR,SAAS,EAAE,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,EAAE;KACzE,CAAA;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,KAAsB,EACtB,MAAwB;IAExB,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO;gBACL,GAAG,KAAK;gBACR,SAAS,EAAE;oBACT,GAAG,KAAK,CAAC,SAAS;oBAClB,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE;iBACtF;aACF,CAAA;QACH,KAAK,OAAO;YACV,OAAO,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;QACxD,KAAK,QAAQ;YACX,OAAO,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;QACzD,KAAK,MAAM;YACT,OAAO,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAAA;QACrF,KAAK,aAAa;YAChB,OAAO,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;QACjE,KAAK,OAAO;YACV,OAAO,sBAAsB,CAAA;QAC/B;YACE,OAAO,KAAK,CAAA;IAChB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAmB,EACnB,MAA0E;IAE1E,OAAO;QACL,MAAM,EAAE;YACN,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE;YAC5B,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D;QACD,KAAK,EAAE;YACL,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,EAAE,EAAE,KAAK,CAAC,EAAE;YACZ,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3D;KACF,CAAA;AACH,CAAC","sourcesContent":["/**\n * The chat panel's proposal-review state (EC-199, reshaped by EC-334).\n *\n * `useChat` (the AI SDK) owns the conversation: messages, streaming text, tool\n * parts, busy-status. This reducer keeps ONLY what the SDK does not own:\n *\n *  - the proposal review map — the FULL proposals the terminal tools\n *    (`createDocument` / `translateDocument`) produce, keyed by `toolCallId`\n *    (the model receives only a compact summary as the tool output; the editor\n *    reviews the real patch here), each `pending` → `applied` | `rejected`;\n *  - the last blocking error (route/provider/step-cap failure), surfaced as a\n *    visible note and cleared on the next submit.\n *\n * EC-380 (`clear`): a new conversation resets this state entirely — pending\n * proposals are discarded with REJECT semantics (they were never applied and\n * nothing half-applied survives; an applied draft already lives in the CMS and\n * is untouched). The panel pairs the dispatch with a fresh `useChat` id.\n *\n * House testing pattern (AGENTS.md): the panel's behaviour lives in this\n * deterministic reducer, tested directly; the React component is a thin shell.\n */\nimport type { CmsDocument, CmsValidationIssue, FieldValues } from '@elytracms/core/cms-core'\nimport type { AiProvenance, ContentPatch } from './types'\n\n/** A proposal's kind: fresh authoring, or a fill-empty translation of an existing doc. */\nexport type ProposalOrigin = 'create' | 'translate'\n\n/**\n * The full proposal payload a terminal tool hands to the review UI (via\n * `onProposal` on the executor — see `tools.ts`). The model never sees this;\n * it gets a compact summary as the tool output.\n */\nexport interface ChatProposal {\n  origin: ProposalOrigin\n  collection: string\n  documentId: string\n  patch: ContentPatch\n  provenance: AiProvenance\n  /** Generation attempts made (1 = happy path, >1 = repaired). */\n  attempts: number\n  /** Non-error issues on the accepted content (warnings). */\n  issues: CmsValidationIssue[]\n  /** For a translation: the existing document values the diff renders \"before\". */\n  before?: { values?: FieldValues; localized?: Record<string, FieldValues> }\n}\n\n/** A proposal under review: {@link ChatProposal} + its review status. */\nexport interface ProposalReview extends ChatProposal {\n  /** The tool call that produced it (`toolCallId`) — the review key. */\n  id: string\n  status: 'pending' | 'applied' | 'rejected'\n}\n\nexport interface ChatReviewState {\n  /** Proposals keyed by `toolCallId`. */\n  proposals: Record<string, ProposalReview>\n  /** Last blocking error (route/provider/step-cap), surfaced then cleared on submit. */\n  error: string | null\n}\n\nexport const initialChatReviewState: ChatReviewState = {\n  proposals: {},\n  error: null,\n}\n\nexport type ChatReviewAction =\n  | { type: 'propose'; toolCallId: string; proposal: ChatProposal }\n  | { type: 'apply'; toolCallId: string }\n  | { type: 'reject'; toolCallId: string }\n  | { type: 'fail'; message: string }\n  | { type: 'clear-error' }\n  /** EC-380: new conversation — full reset; pending proposals discarded (reject semantics). */\n  | { type: 'clear' }\n\nfunction transition(\n  state: ChatReviewState,\n  toolCallId: string,\n  status: 'applied' | 'rejected',\n): ChatReviewState {\n  const existing = state.proposals[toolCallId]\n  // Only a PENDING proposal transitions — apply/reject are one-shot.\n  if (!existing || existing.status !== 'pending') return state\n  return {\n    ...state,\n    proposals: { ...state.proposals, [toolCallId]: { ...existing, status } },\n  }\n}\n\nexport function chatReviewReducer(\n  state: ChatReviewState,\n  action: ChatReviewAction,\n): ChatReviewState {\n  switch (action.type) {\n    case 'propose':\n      return {\n        ...state,\n        proposals: {\n          ...state.proposals,\n          [action.toolCallId]: { ...action.proposal, id: action.toolCallId, status: 'pending' },\n        },\n      }\n    case 'apply':\n      return transition(state, action.toolCallId, 'applied')\n    case 'reject':\n      return transition(state, action.toolCallId, 'rejected')\n    case 'fail':\n      return state.error === action.message ? state : { ...state, error: action.message }\n    case 'clear-error':\n      return state.error === null ? state : { ...state, error: null }\n    case 'clear':\n      return initialChatReviewState\n    default:\n      return state\n  }\n}\n\n/**\n * Turn a proposal patch into the before/after document pair the EC-317 diff\n * engine (`diffDocuments`) compares. For a fresh document `before` is empty\n * (the whole proposal reads as \"added\"); for a translation pass the existing\n * document's values. Pure — the reviewable diff is a straight\n * `diffDocuments(collection, before, after)`.\n */\nexport function proposalDocuments(\n  patch: ContentPatch,\n  before?: { values?: FieldValues; localized?: Record<string, FieldValues> },\n): { before: CmsDocument; after: CmsDocument } {\n  return {\n    before: {\n      collection: patch.collection,\n      id: patch.id,\n      values: before?.values ?? {},\n      ...(before?.localized ? { localized: before.localized } : {}),\n    },\n    after: {\n      collection: patch.collection,\n      id: patch.id,\n      values: patch.values,\n      ...(patch.localized ? { localized: patch.localized } : {}),\n    },\n  }\n}\n"]}

package/dist/lib/ai/fake-provider.d.ts

@@ -3,13 +3,91 @@
  * implements the same interface as the Anthropic provider, so playground / demo /
  * tests run the WHOLE loop (config gate → shape → generate → validate → repair →
  * patch) without a key. Determinism is a project principle: the same fixtures always
- * yield the same result. Imports no AI SDK.
+ * yield the same result. Imports no AI SDK at runtime — the `LanguageModelV4` spec
+ * below is implemented STRUCTURALLY from type-only imports (erased at compile;
+ * pinned in `bundle.test.ts`).
  *
  * For the repair loop, pass `objects: [invalidDoc, validDoc]` — the provider returns
  * them in call order (the last is reused once the script is exhausted). Or pass
  * `respond` to compute the object from the request.
+ *
+ * EC-334 adds {@link createFakeChatModel}: a scripted fake `LanguageModel` served by
+ * the ROUTE's native chat branch, so the keyless playground / CI drive the FULL
+ * `streamText` → SSE wire → client-tool loop. It is a STATELESS prompt-inspecting
+ * responder (state read from the prompt, the FakeProvider trick): a prompt without a
+ * tool result emits a tool call; a prompt carrying one streams a text answer.
+ */
+import type { LanguageModel } from 'ai';
+import type { AiProvider, AiProviderCapabilities, GenerateStructuredRequest } from './types.js';
+/** The SDK's v4 language-model spec, extracted structurally from the type-only union. */
+export type FakeLanguageModelV4 = Extract<LanguageModel, {
+    specificationVersion: 'v4';
+}>;
+/** The call options a fake chat model receives (`LanguageModelV4CallOptions`). */
+export type FakeChatModelCallOptions = Parameters<FakeLanguageModelV4['doGenerate']>[0];
+/** One provider-spec stream part the fake emits (`LanguageModelV4StreamPart`). */
+export type FakeChatModelStreamPart = Awaited<ReturnType<FakeLanguageModelV4['doStream']>>['stream'] extends ReadableStream<infer PART> ? PART : never;
+/** Default preamble streamed before the scripted tool call. */
+export declare const FAKE_CHAT_PREAMBLE = "Let me look that up. ";
+/** Default final answer streamed once the prompt carries a tool result. */
+export declare const FAKE_CHAT_ANSWER = "Found it \u2014 the tool result is in, and this is the answer.";
+export interface FakeChatModelOptions {
+    /** Model id reported to the SDK (default `fake-chat-model`). */
+    modelId?: string;
+    /** Text streamed before the tool call on the first (tool-result-free) turn. */
+    preambleText?: string;
+    /** The tool the first turn requests (default `searchDocuments`). */
+    toolName?: string;
+    /** The tool-call input (default `{ collection: 'post' }`). */
+    toolInput?: Record<string, unknown>;
+    /** The answer streamed word-by-word once the prompt carries a tool result. */
+    answerText?: string;
+    /**
+     * Full override: script the exact provider-spec stream parts for a call
+     * (zero-based call index). The default prompt-inspecting behavior is skipped.
+     */
+    script?: (options: FakeChatModelCallOptions, callIndex: number) => FakeChatModelStreamPart[];
+}
+/** A fake chat model that also records the calls it received, for assertions. */
+export type FakeChatModel = FakeLanguageModelV4 & {
+    /** Every `doStream` / `doGenerate` call options received, in order. */
+    readonly calls: FakeChatModelCallOptions[];
+};
+/**
+ * Build a scripted, stateless fake `LanguageModel` (the `LanguageModelV4` spec,
+ * implemented structurally — zero SDK runtime import). Default behavior:
+ *   - prompt WITHOUT a tool result → preamble text, then a `tool-call` for
+ *     {@link FakeChatModelOptions.toolName} (finish reason `tool-calls`);
+ *   - prompt WITH a tool result → the answer text streamed word-by-word (`stop`).
+ * Chunk shapes follow the v4 spec: `finishReason` is `{ unified, raw }`, tool chunks
+ * are `tool-input-start/delta/end` + `tool-call`.
+ */
+export declare function createFakeChatModel(options?: FakeChatModelOptions): FakeChatModel;
+export interface FakeCreateFlowChatModelOptions {
+    /** Model id reported to the SDK (default `fake-create-flow-model`). */
+    modelId?: string;
+    /** The collection the first stage searches (a relation target; default `author`). */
+    searchCollection?: string;
+    /** The collection the terminal stage creates in (default `post`). */
+    createCollection?: string;
+    /** The final answer streamed word-by-word after the proposal lands. */
+    answerText?: string;
+}
+/** Default final answer of the scripted create flow. */
+export declare const FAKE_CREATE_FLOW_ANSWER = "Done \u2014 review the proposal below and apply it as a draft.";
+/**
+ * A scripted, STATELESS fake chat model that drives the FULL create flow over the
+ * native loop (EC-334): keyless playground / CI exercise user message → search
+ * tool → `createDocument` terminal tool (the client runs `applyContentWithShape`)
+ * → streamed final answer. Stage is read from the CURRENT user turn's tool
+ * results (prompt suffix after the last user message), so every follow-up turn
+ * starts a fresh flow — multi-turn works without model state:
+ *
+ *  1. no tool result yet          → `searchDocuments({ collection: searchCollection })`
+ *  2. search result, no create    → `createDocument({ collection, instruction: <last user text> })`
+ *  3. create result present       → the answer text, word by word.
  */
-import type { AiProvider, AiProviderCapabilities, GenerateStructuredRequest, StreamChatRequest } from './types.js';
+export declare function createFakeCreateFlowChatModel(options?: FakeCreateFlowChatModelOptions): FakeChatModel;
 export interface FakeProviderOptions {
     /** Provider id (default `fake`). */
     id?: string;
@@ -21,14 +99,14 @@ export interface FakeProviderOptions {
     objects?: unknown[];
     /** Compute the object from the request + zero-based call index (overrides `objects`). */
     respond?: (request: GenerateStructuredRequest, callIndex: number) => unknown;
-    /** Fixed text `streamChat` streams back (default: echoes the last user message). */
-    streamText?: string;
+    /** The scripted chat model `languageModel()` serves (default {@link createFakeChatModel}). */
+    chatModel?: FakeChatModel;
 }
 /** A FakeProvider that also records the requests it received, for assertions. */
 export interface FakeProvider extends AiProvider {
     /** Every `generateStructured` request received, in order. */
     readonly calls: GenerateStructuredRequest[];
-    /** Every `streamChat` request received, in order. */
-    readonly streamCalls: StreamChatRequest[];
+    /** The scripted fake chat model behind `languageModel()` (records its calls). */
+    readonly chatModel: FakeChatModel;
 }
 export declare function createFakeProvider(options?: FakeProviderOptions): FakeProvider;