@object-ui/plugin-chatbot 17.6.0 → 18.0.0

package/dist/mapMessages.d.ts

@@ -1,4 +1,4 @@
-import { ChatMessage, ChatToolInvocation, ChatBuildProgress } from './ChatbotEnhanced';
+import { ChatbotEnhancedMessage as ChatMessage, ChatbotEnhancedToolInvocation as ChatToolInvocation, ChatBuildProgress } from './ChatbotEnhanced.js';
 interface AnyPart {
     type?: string;
     text?: string;
@@ -10,7 +10,29 @@ interface AnyPart {
     args?: unknown;
     result?: unknown;
     errorText?: string;
-    state?: ChatToolInvocation['state'];
+    /**
+     * Free-form on purpose. `AnyPart` absorbs whatever a producer hands the
+     * mapper, and `state` is NOT one namespace: a tool part carries the
+     * tool-invocation lifecycle, while `@ai-sdk/react`'s text and reasoning
+     * parts carry `'streaming' | 'done'`. Typing this member against the
+     * OUTPUT contract made the deliberately-permissive input interface
+     * stricter than the union it exists to absorb, so the SDK's own
+     * `UIMessage[]` — the documented input of the exported mappers — was
+     * refused outright (objectui#8214). `isToolState` below is what keeps the
+     * output checked; this stays open.
+     */
+    state?: string;
+    /**
+     * The chat runtime's approval envelope, as it arrives on a tool part.
+     *
+     * `unknown`, like every other absorbing member here, and deliberately NOT
+     * the envelope's declared shape: this interface exists to take whatever a
+     * producer hands the mapper, and the one time a member was typed against the
+     * OUTPUT contract it made the permissive input interface stricter than the
+     * union it absorbs (objectui#8214, the `state` member). {@link liftApproval}
+     * is what keeps the OUTPUT checked; this stays open.
+     */
+    approval?: unknown;
     url?: string;
     href?: string;
     title?: string;
@@ -45,13 +67,29 @@ interface AnyUIMessage {
  * still-pending proposal as "Completed" (#787 finding B / #2362).
  */
 export declare function parseResultEnvelope(result: unknown): Record<string, unknown> | undefined;
+/**
+ * The ObjectStack HITL envelope a tool result carries when the framework's
+ * `action-tools.ts` proposes a destructive action:
+ * `{ status: 'pending_approval', pendingActionId: 'pa_…', … }`.
+ *
+ * Exported (objectui#8442) so the app-shell's HYDRATION mapper derives the id
+ * from the same parse the live mapper uses. The id is never persisted as a part
+ * key — it exists in rehydrated history only inside this envelope — so a second
+ * hand-rolled reader there would be a second dialect of one contract, which is
+ * exactly what AGENTS.md Commandment #0.1 refuses.
+ */
+export declare function detectPendingApproval(result: unknown): {
+    pendingActionId: string;
+    raw: Record<string, unknown>;
+} | undefined;
 /**
  * Best-effort detector for the framework's ADR-0033 draft envelopes. Metadata
  * authoring tools stage changes as DRAFTS and return one of:
  *   • single — `{ status:'drafted', type, name, summary, changedKeys }`
  *     (create_object / add_field / create_metadata / update_metadata / …)
  *   • batch  — `{ status:'drafted', drafted:[{type,name}], failed, summary }`
- *     (apply_blueprint)
+ *     (apply_blueprint), or the same batch with `kind:'edit'` (apply_edit,
+ *     an INCREMENTAL edit — objectui#10109)
  * We lift the reviewable `{ type, name }` targets so the chat can render a
  * "Review N change(s)" affordance that opens the designer's review/diff.
  * `blueprint_proposed` (propose_blueprint) has no draft yet → not surfaced here.
@@ -63,9 +101,25 @@ export interface DraftReview {
     }>;
     summary?: string;
     packageId?: string;
+    /**
+     * Backend lifecycle intent (from the tool result). `true` for whole-app
+     * builds (apply_blueprint) — eligible for the auto-publish "magic moment".
+     * Omitted for incremental edits, which stay drafts for explicit review.
+     */
     autoPublishable?: boolean;
+    /** Count of artifacts that failed in a partial build, surfaced not hidden. */
     failedCount?: number;
+    /**
+     * ADR-0045: the build was MATERIALIZED in-turn — real tables and seed
+     * rows exist; the app is live but `hidden` (unlisted). Preview should
+     * open the REAL app URL, not the draft overlay.
+     */
     materialized?: boolean;
+    /**
+     * ADR-0038 L1 graph-lint verdict for the staged build. Rendered as a
+     * verified/issues chip so "drafted" and "verified" read as the two
+     * separate statements they are. Absent on older tool output.
+     */
     verification?: {
         errors: number;
         warnings: number;
@@ -90,6 +144,18 @@ export interface DraftReview {
      * status panel, never asserted as done).
      */
     nextSteps?: string[];
+    /**
+     * objectui#10109 — the producer's marker for an INCREMENTAL edit, lifted
+     * from the envelope's own `kind`: `apply_edit` answers `kind: 'edit'`, and a
+     * whole-app `apply_blueprint` build carries no `kind`. An edit's `items` may
+     * honestly include the `app` artifact it re-staged (an `add_object` op
+     * merges the nav), so the readers that infer a whole-app build from a draft
+     * review's staged artifact types check this first: `buildProgressFromDraftReview`
+     * here, and app-shell's built-moment transition (`detectBuiltAppPackage` reads
+     * the envelope's own `kind` instead). Only the value those readers act on is
+     * declared: an envelope that does not say `'edit'` lifts nothing here.
+     */
+    kind?: 'edit';
 }
 /**
  * The lifecycle stage BEFORE a draft. `propose_blueprint` returns
@@ -102,11 +168,37 @@ export interface DraftReview {
  */
 export interface ProposedPlan {
     summary?: string;
-    /** Objects (tables) the build will create — machine name, label, field count. */
+    /**
+     * objectui#12724 — the app's display label (`blueprint.app.label`, the
+     * spec's `BlueprintAppSchema`), for the card's 「方案 · APP」 header. Absent
+     * when the blueprint names no app label.
+     */
+    appLabel?: string;
+    /**
+     * Objects (tables) the build will create — machine name, label, field count.
+     * objectui#12724 — `fields` lifts the name and label of each declared field
+     * (`blueprint.objects[].fields`, the spec's `BlueprintFieldSchema`) so the
+     * card can draw one chip per field. Absent when no entry carries a name (a
+     * cache-fallback reload keeps only the count), and the card then draws the
+     * object chip with its count, as before.
+     */
     objects: Array<{
         name: string;
         label?: string;
         fieldCount: number;
+        fields?: Array<{
+            name: string;
+            label?: string;
+        }>;
+    }>;
+    /**
+     * objectui#12724 — the views the build will create (`blueprint.views`, the
+     * spec's `BlueprintViewSchema`), by name and label. Absent when the
+     * blueprint declares none.
+     */
+    views?: Array<{
+        name: string;
+        label?: string;
     }>;
     /** Totals for a compact "N objects · N views · …" line. */
     counts: {
@@ -127,17 +219,142 @@ export interface ProposedPlan {
         text: string;
         options: string[];
     }>;
-    /** Assumptions the agent made from an underspecified goal (may be empty). */
+    /**
+     * Assumptions the agent made from an underspecified goal (may be empty).
+     * objectui#12724 — read from `planCard.assumptions` when the envelope
+     * carries a plan card, else from `blueprint.assumptions` as before.
+     */
     assumptions: string[];
     /** Extend mode: the existing app the new objects would be added into. */
     targetApp?: string;
+    /**
+     * objectui#12724 — the plan card's v2 rows, from the envelope's `planCard`.
+     * Absent on a producer that predates it, and the card then draws the rows
+     * above as before.
+     */
+    planCard?: ProposedPlanCard;
+    /**
+     * objectui#12724 — one line per view (the envelope's `viewIntents`). The card
+     * reads it only when there is no `planCard`, whose views carry the same line.
+     */
+    viewIntents?: ProposedPlanViewLine[];
+}
+/** One view's intent line: `viewIntents[]` and `planCard.views[]` both carry it. */
+export interface ProposedPlanViewLine {
+    view: string;
+    object: string;
+    label?: string;
+    line: string;
+}
+/**
+ * objectui#12724 — the keys of `propose_blueprint`'s `planCard` that the plan
+ * card draws. The producer's contract is objectstack-ai/cloud's
+ * `ProposeBlueprintCardPayload` (`packages/service-ai-studio/schema/build-cards.schema.json`,
+ * vendored beside this package's tests); keys this card does not draw are not
+ * lifted.
+ */
+export interface ProposedPlanCard {
+    objects: Array<{
+        name: string;
+        label: string;
+        fields: Array<{
+            name: string;
+            label: string;
+            /** The format the sample data is held to, as the chip's words (`format.label`). */
+            format?: {
+                label: string;
+            };
+            /**
+             * objectui#12994 — the stage field's lifecycle, as the chip's words
+             * (`lifecycle.label`, e.g. 「借出 · 已还 ✓完成 · 逾期 ⚠」). The producer's
+             * `options` are not drawn, so they are not lifted.
+             */
+            lifecycle?: {
+                label: string;
+            };
+            /** The model added this field; the user's words did not name it. */
+            suggested?: true;
+        }>;
+        /**
+         * The record's name field, when the plan declares one. `generated`
+         * (objectui#13004) is present when the title is composed for the user, not
+         * typed: the card draws its `line` (e.g. 「名称：自动生成「{图书} · {读者} ·
+         * {借出日期}」，表单里不出现」) in place of 「名称：LABEL」. The producer's
+         * `template` is not drawn, so it is not lifted.
+         */
+        nameField?: {
+            name: string;
+            label: string;
+            generated?: {
+                line: string;
+            };
+        };
+    }>;
+    views: ProposedPlanViewLine[];
+    assumptions: string[];
+    /** The sample data the build stages, as one line. Absent when it stages none. */
+    sampleData?: {
+        line: string;
+    };
+}
+/**
+ * objectui#12724 — the keys of the result card's `checklist` that the card
+ * draws, from `apply_blueprint`'s and `verify_build`'s envelopes
+ * (objectstack-ai/cloud's `BuildResultCardPayload`).
+ */
+export interface BuildResultChecklist {
+    status: 'passed' | 'failed';
+    passed: number;
+    total: number;
+    /** Objects, then views, then the sample data, each measured on the build. */
+    lines: Array<{
+        kind: 'object' | 'view' | 'sampleData';
+        status: 'passed' | 'failed';
+        line: string;
+    }>;
+    /** The app 打开应用 opens. */
+    app?: {
+        name: string;
+        label?: string;
+    };
+    /** The package 在 Studio 中查看 opens. */
+    packageId?: string;
 }
 export declare function detectProposedPlan(result: unknown): ProposedPlan | undefined;
+/**
+ * objectui#12724 — the result card's `checklist`, on `apply_blueprint`'s
+ * envelope (drafted, or published in-turn) and on `verify_build`'s, which
+ * re-measures it after a repair. The schema requires `status`, `passed`,
+ * `total` and `lines`; without all four there is no checklist, and the card
+ * keeps its earlier rows.
+ */
+export declare function detectBuildChecklist(result: unknown): BuildResultChecklist | undefined;
+/**
+ * cloud#2924 — how a copilot change to a package lands, as the change envelopes
+ * carry it (cloud `postureEnvelope`): `draft` when the app is live and its
+ * tables hold `liveRecords` records, so the change is saved as a Studio draft;
+ * `publish` when it goes live in the turn (a first build, an app holding no
+ * records, a platform package).
+ */
+export interface ChangePosture {
+    mode: 'draft' | 'publish';
+    /** Records the package's live tables hold. */
+    liveRecords: number;
+    /** The package is a platform package; the posture by state is not read there. */
+    platformPackage?: true;
+    /** In the turn that applied a blueprint: the rows that build seeded, left out of `liveRecords`. */
+    buildTurnRows?: number;
+}
 /**
  * A granular metadata-change preview (confirm-before-change). A mutating tool
  * that has NOT been approved this turn returns
  * { status: 'changes_proposed', changes: [...], summary? } instead of
  * committing, so the chat renders a "确认修改" card. Mirrors detectProposedPlan.
+ *
+ * objectui#12894 — cloud#2924 adds `posture` and `primaryAction`, read before
+ * the card is shown. Both are absent from an older cloud, and from an
+ * environment that does not publish AI changes in the turn; the card then
+ * draws as it did before.
  */
 export interface ProposedChanges {
     summary?: string;
@@ -147,8 +364,48 @@ export interface ProposedChanges {
         field?: string;
         type?: string;
         name?: string;
+        /** cloud#2924 — the row's parameters in small type (label · default · required), in the user's language. */
         details?: string;
     }>;
+    /** cloud#2924 — how the change will land once confirmed. */
+    posture?: ChangePosture;
+    /** cloud#2924 — the card's primary action: `save_draft` reads 存为草稿, `confirm` keeps the host's label. */
+    primaryAction?: 'save_draft' | 'confirm';
+}
+/** One pending draft, as Studio's 变更 list names it (cloud `PendingDraft`). */
+export interface PendingDraftItem {
+    type: string;
+    name: string;
+}
+/**
+ * cloud#2924 — the package's pending drafts, read after the change landed
+ * through `listDrafts`, the read Studio's 变更 badge makes (cloud `DraftState`).
+ */
+export interface ChangeDraftState {
+    /** Pending drafts in the package — the number Studio's 变更 badge shows. */
+    pending: number;
+    items: PendingDraftItem[];
+    /** Pending drafts this change did not stage (an earlier edit, the user's own). */
+    others: number;
+}
+/**
+ * cloud#2924 — a field the change added to a table that already holds records:
+ * every one of those `rows` has no value for it (cloud `ExistingRowsLine`).
+ */
+export interface ExistingRowsLine {
+    object: string;
+    field: string;
+    label: string;
+    rows: number;
+}
+/**
+ * cloud#2924 — the applied card of a change saved as a draft, in the user's
+ * language: its title (「已存为草稿 · 2 项未发布」) and its lines
+ * (「已有 12 条记录的续借次数为空」, 「核对：结构 ✓」).
+ */
+export interface AppliedCard {
+    title: string;
+    lines: string[];
 }
 /**
  * ADR-0057 P4 — the `ask` agent's `suggest_builder` structured decline. Result
@@ -161,6 +418,23 @@ export interface BuilderHandoff {
     packageId?: string;
 }
 export declare function detectBuilderHandoff(result: unknown): BuilderHandoff | undefined;
+/**
+ * cloud#1658 — the ask agent's `open_record` structured hand-off: the OTHER
+ * ending of a write request. Envelope
+ * `{ status:'record_handoff', handoff:'record', objectName, recordId, label?, reason? }`.
+ * Lifted so the chat renders an explicit "打开这条记录 →" action landing on the
+ * record the agent already resolved — the whole point is that the user never
+ * re-finds a record the agent has in hand. Both ids are REQUIRED: a hand-off
+ * with either missing is dropped here exactly as the server refuses to emit
+ * one, because a card pointing nowhere is worse than the prose it replaces.
+ */
+export interface RecordHandoff {
+    objectName: string;
+    recordId: string;
+    label?: string;
+    reason?: string;
+}
+export declare function detectRecordHandoff(result: unknown): RecordHandoff | undefined;
 export declare function detectProposedChanges(result: unknown): ProposedChanges | undefined;
 /**
  * objectui#5695 — the terminal verdict of a confirm-replay.
@@ -193,6 +467,27 @@ export interface ReplayOutcome {
      * so the card never says 未生效 over a change that actually landed.
      */
     dispatchError?: boolean;
+    /**
+     * objectui#12894 — on a `drafted` outcome only, what cloud#2924's
+     * `describeLandedChange` stamps after the change landed: the package's
+     * pending drafts, the existing rows a new field leaves empty, and the
+     * applied card's title and lines. Each is absent from an older cloud, and
+     * the card then draws the drafted badge as before.
+     */
+    draftState?: ChangeDraftState;
+    existingRows?: ExistingRowsLine[];
+    appliedCard?: AppliedCard;
+    /**
+     * objectui#12968 — on a `drafted` outcome only, the items THIS replay
+     * drafted (the envelope's `drafted[]`, lifted as {@link detectDraftResult}
+     * lifts it), so the applied card can preview them. Not `draftState.items`,
+     * which lists every pending draft of the package. Absent when the envelope
+     * names none.
+     */
+    items?: Array<{
+        type: string;
+        name: string;
+    }>;
 }
 export declare function detectReplayOutcome(toolCallId: string | undefined, result: unknown): ReplayOutcome | undefined;
 /**
@@ -213,6 +508,12 @@ export declare function detectAuthoringVerdict(result: unknown): {
  * `drafted[]` + `packageId`), so keying the built-moment transition on
  * `draftReview` (drafted-only) missed every staging/cloud build — measured
  * live: reopening a built conversation stayed on the full page.
+ *
+ * objectui#10109 — an envelope that says `kind: 'edit'` is an INCREMENTAL
+ * edit (`apply_edit`), never a whole-app build, even when its `drafted[]`
+ * honestly lists the `app` artifact it re-staged (an `add_object` op merges
+ * the nav). The producer declares the difference on the envelope, so it is
+ * read here rather than inferred from which artifact types were staged.
  */
 export declare function detectBuiltAppPackage(result: unknown): string | undefined;
 export declare function detectDraftResult(result: unknown): DraftReview | undefined;
@@ -224,7 +525,9 @@ export declare function detectDraftResult(result: unknown): DraftReview | undefi
  * reconstruct the done-state from the draft result, which IS persisted, so the
  * summary + its preview/open affordances survive a refresh. Only whole-app
  * builds (a draft set that includes an `app`) get a panel — incremental edits
- * keep their draft card but no build tree, matching the live behaviour.
+ * keep their draft card but no build tree, matching the live behaviour. An
+ * edit is known by the producer's `kind: 'edit'`, not by its staged types: it
+ * can re-stage the `app` artifact too (objectui#10109).
  */
 export declare function buildProgressFromDraftReview(draft: DraftReview | undefined): ChatBuildProgress | undefined;
 /**

package/dist/mapMessages.d.ts.map

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

package/dist/recordLink.d.ts

@@ -0,0 +1,34 @@
+import { LinkSafetyConfig } from 'streamdown';
+/** The record a record link names. */
+export type RecordLinkTarget = {
+    objectName: string;
+    recordId: string;
+};
+/** The host's way to open a record (the chat's `onOpenRecord`). */
+export type OpenRecordLink = (target: RecordLinkTarget) => void;
+/**
+ * The one record-link form, as streamdown hands the href to `onLinkCheck`.
+ * (rehype-harden normalises `./record/...` to `/record/...` before that, and
+ * drops a bare `record/...`.)
+ */
+export declare const RECORD_LINK_PATTERN: RegExp;
+/** The record a link names, or `null` when the href is not the record form. */
+export declare function parseRecordLink(href: string | null | undefined): RecordLinkTarget | null;
+/**
+ * The host's record opener for the answers rendered below it. `null` (no
+ * host handler) leaves every link, the record form included, on streamdown's
+ * default link safety.
+ */
+export declare const RecordLinkContext: import('react').Context<OpenRecordLink | null>;
+/**
+ * `linkSafety` for an answer: the caller's config, with the record form routed
+ * to `open`.
+ *
+ * streamdown's link click awaits `onLinkCheck(url)`: `true` opens the url in a
+ * new tab, anything else opens the confirmation dialog. A record link wants
+ * neither, so after handing the record to `open` the check returns a promise
+ * that never settles, and the click ends there (a fresh promise per click, so
+ * nothing accumulates once the click's continuation is dropped).
+ */
+export declare function withRecordLinks(base: LinkSafetyConfig | undefined, open: OpenRecordLink | null): LinkSafetyConfig | undefined;
+//# sourceMappingURL=recordLink.d.ts.map

package/dist/recordLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordLink.d.ts","sourceRoot":"","sources":["../src/recordLink.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiCH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,sCAAsC;AACtC,MAAM,MAAM,gBAAgB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,mEAAmE;AACnE,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAC0B,CAAC;AAE3D,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,gBAAgB,GAAG,IAAI,CAMxF;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,gDAA6C,CAAC;AAE5E;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,IAAI,EAAE,cAAc,GAAG,IAAI,GAC1B,gBAAgB,GAAG,SAAS,CAiB9B"}

package/dist/tool-display.d.ts

@@ -9,15 +9,39 @@
  * peel the envelope, parse the inner JSON when possible, and produce a
  * human-friendly title for snake_case tool names.
  */
+/**
+ * A translator for tool titles. Takes the i18n key and the English fallback
+ * this module would otherwise have produced, and returns whatever the active
+ * locale has — or the fallback when that locale carries no entry.
+ *
+ * Shaped to accept `useSafeTranslate()` directly, so a caller passes the hook's
+ * result and nothing else changes.
+ */
+export type ToolTitleTranslator = (key: string, fallback: string) => string;
+/** The i18n key a tool title is looked up under. */
+export declare function toolTitleKey(name: string): string;
 /**
  * Convert a snake_case / kebab-case tool name into a human-readable title.
  *
+ * With no translator this is what it always was: an ENGLISH title-caser. That
+ * is why a fully Chinese conversation still read
+ * `Describe object 已完成 / Visualize data 已完成` (cloud#1658) — every other
+ * string on the card was localized and the tool name could not be, because the
+ * name never passed through i18n at all. The step the user most needs to read
+ * ("what is it doing right now?") was the one left in a foreign language.
+ *
+ * Pass `translate` (e.g. `useSafeTranslate()`) to look the title up as
+ * `chatbot.tool.<tool_name>`; a locale with no entry for that tool falls back
+ * to the same English title as before, so packs can be filled in gradually and
+ * an unknown//custom tool is never worse off than today.
+ *
  * @example
- *   humanizeToolName('list_objects')        // → 'List objects'
- *   humanizeToolName('query_records')       // → 'Query records'
- *   humanizeToolName('describe-api-tool')   // → 'Describe API tool'
+ *   humanizeToolName('list_objects')                 // → 'List objects'
+ *   humanizeToolName('query_records')                // → 'Query records'
+ *   humanizeToolName('describe-api-tool')            // → 'Describe API tool'
+ *   humanizeToolName('describe_object', tt)          // → '查看对象结构' (zh)
  */
-export declare function humanizeToolName(name: string | undefined | null): string;
+export declare function humanizeToolName(name: string | undefined | null, translate?: ToolTitleTranslator): string;
 /**
  * Detect the MCP-style `{ type: 'text', value: '<json|text>' }` envelope used
  * by `@objectstack/service-ai` tool outputs and peel it. When the inner value
@@ -38,8 +62,17 @@ export declare function summarizeChatError(err: unknown): {
     summary: string;
     details?: string;
 };
-/** AI quota refusal codes emitted by the cloud token guardrail (HTTP 429). */
-export type AiQuotaCode = 'ai_design_quota_exhausted' | 'ai_data_chat_trial_exhausted' | 'ai_allowance_exhausted';
+/**
+ * AI quota refusal codes emitted by the cloud token guardrail (HTTP 429).
+ *
+ * TWO vocabularies, both live. cloud#1238 (the cloud#1168 convergence) landed
+ * the SCREAMING_SNAKE ledger codes — which is what a spec-conformant
+ * `error.code` must be, an `ErrorCode` ledger member. The lowercase trio is
+ * the legacy vocabulary that transition-period producers still emit, so it is
+ * KEPT rather than swapped out: dropping it would silently stop parsing every
+ * producer that has not converged yet (objectui#3804).
+ */
+export type AiQuotaCode = 'AI_DESIGN_QUOTA_EXHAUSTED' | 'AI_DATA_CHAT_TRIAL_EXHAUSTED' | 'AI_ALLOWANCE_EXHAUSTED' | 'ai_design_quota_exhausted' | 'ai_data_chat_trial_exhausted' | 'ai_allowance_exhausted';
 export interface AiQuotaError {
     code: AiQuotaCode;
     /** Localized (zh) message from the backend. */
@@ -50,6 +83,31 @@ export interface AiQuotaError {
     upgrade: boolean;
     /** Paid tier -> buy a credit top-up pack. */
     topUp: boolean;
+    /**
+     * The allowance replenishes at the next daily reset, so "wait" is a real
+     * option alongside the CTA. Only set when the producer sends an actual
+     * boolean: the landed envelope carries this inside `error.details`
+     * (cloud#1238) and that POSITION is measured, but an absent or
+     * otherwise-typed value stays `undefined` rather than being coerced to a
+     * `false` no producer declared.
+     *
+     * ⚠️ objectui#7587 — measured on this tree: NOTHING reads this field once the
+     * parse fills it in. `useAiQuotaCopy` (ChatbotEnhanced), the only consumer of
+     * the parsed shape's fields, builds the banner from `message` / `messageEn` /
+     * `topUp`; the other two `parseAiQuotaError` call sites use the parse as a
+     * yes/no predicate. So cloud PR #1852's free-plan inversion (`true` ->
+     * `false`, the rolling 7-day window) changes nothing on screen, and the ISO
+     * `resetsAt` that producer now sends beside this flag is deliberately NOT
+     * read here: with no renderer for it, a read would pin a wire position this
+     * repo cannot measure (`objectstack-ai/cloud` is out of scope) and would add
+     * a second unread field rather than answer anyone's question. Both halves are
+     * pinned — the flag's inertness by
+     * `__tests__/ChatbotEnhanced.quotaResetPromise-7587.test.tsx`, the parse's
+     * silence about the instant by `tool-display.test.ts`. Wiring reset copy to
+     * this BOOLEAN is the one move to avoid: it is `false` for exactly the plan
+     * that needs the answer.
+     */
+    resetsTonight?: boolean;
 }
 /**
  * Recognize the cloud AI token guardrail's 429 quota refusals so the chat UI can
@@ -60,26 +118,39 @@ export interface AiQuotaError {
  * strip the same retry/format prefixes summarizeChatError handles, locate the
  * JSON object, and find the code in it. Returns null for anything else.
  *
- * ## Three dialects, one code set
- *
- * The two cloud 429 producers fill the same `error` key in OPPOSITE ways, and
- * ADR-0112 declares a third shape they are converging on (objectui#3491,
- * cloud#944). All three are read here so the consumer is ready BEFORE the
- * producers move (cloud#1168) — the alternative is a silent misfit at the
- * moment they converge:
- *
- * | dialect                      | shape                                          |
- * |------------------------------|------------------------------------------------|
- * | declared envelope (ADR-0112) | `{ success: false, error: { code, message } }`  |
- * | flat guardrail               | `{ error: CODE, message, upgrade, topUp }`     |
- * | service-ai sibling key       | `{ error: PROSE, code: CODE }`                 |
- *
- * Only the code's LOCATION widens; the recognized code set is unchanged, so an
- * unknown shape still degrades to today's behavior (null). Note that a
- * spec-conformant `error.code` must be an `ErrorCode` ledger member
- * (SCREAMING_SNAKE) and none of these three codes is registered today, so the
- * nested branch matches the legacy vocabulary only — aligning the vocabulary is
- * cloud#1168's call and needs a follow-up here, not a guess now.
+ * ## Four dialects, two vocabularies
+ *
+ * The two cloud 429 producers fill the same `error` key in OPPOSITE ways
+ * (objectui#3491, cloud#944), and ADR-0112's declared envelope has now LANDED
+ * on the producer side (cloud#1168 -> cloud PR #1238), adding a fourth
+ * dialect: the declared envelope carrying the SCREAMING_SNAKE ledger
+ * vocabulary with its companion fields inside `error.details`. All four are
+ * read here, because the producers converge asymmetrically and the legacy
+ * dialects are still live (objectui#3804):
+ *
+ * | dialect                       | shape                                           |
+ * |-------------------------------|-------------------------------------------------|
+ * | declared envelope + ledger    | `{ error: { code: AI_*, message, details } }`    |
+ * | declared envelope + legacy    | `{ success: false, error: { code, message } }`   |
+ * | flat guardrail                | `{ error: CODE, message, upgrade, topUp }`       |
+ * | service-ai sibling key        | `{ error: PROSE, code: CODE }`                   |
+ *
+ * Both the code's LOCATION and the recognized code SET widen; an unknown shape
+ * still degrades to today's behavior (null).
+ *
+ * ## What this deliberately does NOT recognize: generic `QUOTA_EXCEEDED`
+ *
+ * `POST /api/v1/ai/agents/:name/chat`'s per-turn message cap keeps emitting the
+ * standard `QUOTA_EXCEEDED` (`error.details.resetAt`, `category: 'rate_limit'`)
+ * and did NOT move to the three `AI_*` codes — it has no upgrade / top-up /
+ * trial next step, which is exactly the distinction the 2026-08-11 Option A
+ * ruling drew when it admitted the three codes to the closed ledger.
+ *
+ * It is NOT dropped, it is handled one branch along: `isUnsentSendError` +
+ * `isRateLimitError` route it to the "you're sending too quickly" notice, with
+ * the user's text restored. Returning an `AiQuotaError` for it here would put
+ * an "Upgrade plan" CTA in front of a user whose cap resets in a minute.
+ * `tool-display.test.ts` pins that routing so the split cannot close silently.
  *
  * ## Parse priority (a total order, deliberately)
  *

package/dist/tool-display.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-display.d.ts","sourceRoot":"","sources":["../src/tool-display.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAeH;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAoBxE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAqCxD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAiCA;AAED,8EAA8E;AAC9E,MAAM,MAAM,WAAW,GACnB,2BAA2B,GAC3B,8BAA8B,GAC9B,wBAAwB,CAAC;AAE7B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;CAChB;AAwBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CA8CnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAIvD;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIhE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAItD"}
+{"version":3,"file":"tool-display.d.ts","sourceRoot":"","sources":["../src/tool-display.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAeH;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;AAE5E,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAC/B,SAAS,CAAC,EAAE,mBAAmB,GAC9B,MAAM,CAwBR;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAqCxD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAiCA;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAEnB,2BAA2B,GAC3B,8BAA8B,GAC9B,wBAAwB,GAExB,2BAA2B,GAC3B,8BAA8B,GAC9B,wBAAwB,CAAC;AAE7B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AA+CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAuDnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAIvD;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAIhE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAItD"}