@object-ui/plugin-chatbot 17.5.0 → 17.7.0

package/dist/mapMessages.d.ts

@@ -1,4 +1,4 @@
-import { ChatMessage, ChatToolInvocation, ChatBuildProgress } from './ChatbotEnhanced';
+import { ChatMessage, 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
@@ -161,7 +227,83 @@ 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.
+ *
+ * When the user approves a 确认修改 card, the runtime re-dispatches the
+ * proposal deterministically and appends the result under a synthetic
+ * `replay_<turn>_<i>` tool-call id (cloud `runApprovedProposalReplay`). The
+ * envelope is the ordinary authoring envelope — `status:'published'`,
+ * or `status:'drafted'` optionally stamped `publishFailed:true` +
+ * `publishOutcome`/`publishError` when the in-turn publish rolled back
+ * (cloud#1467). Lifted into a dedicated shape so the confirm card can render
+ * a UI-owned terminal state — the layer a model cannot narrate over.
+ */
+export interface ReplayOutcome {
+    kind: 'published' | 'drafted' | 'failed';
+    /** Machine verdict of a failed publish (`rejected` / `rolled_back` / `nothing_published`). */
+    outcome?: string;
+    /** First line of `publishError`, for the 未生效 headline. */
+    error?: string;
+    /** Owning package of a drafted outcome, for the inline publish affordance. */
+    packageId?: string;
+    /**
+     * The replay DISPATCH itself errored (bare `{error: …}` envelope) rather
+     * than the publish being refused — measured live 2026-08-24: an apply_edit
+     * replay carrying a blueprint-local object name errored `object "task" not
+     * found`, after which the MODEL self-repaired with different tool calls
+     * that succeeded. A dispatch error is therefore only provisionally
+     * `failed`: the card walk may supersede it with a later successful
+     * authoring verdict from the same turn (see `detectAuthoringVerdict`),
+     * so the card never says 未生效 over a change that actually landed.
+     */
+    dispatchError?: boolean;
+}
+export declare function detectReplayOutcome(toolCallId: string | undefined, result: unknown): ReplayOutcome | undefined;
+/**
+ * objectui#5695 — classify ANY tool result as an authoring verdict, for the
+ * confirm card's self-repair supersede: after a replay DISPATCH error, the
+ * model may land the same change through different tool calls; those results
+ * carry the ordinary authoring envelope, and the latest one in the turn is
+ * the truthful terminal state for the card.
+ */
+export declare function detectAuthoringVerdict(result: unknown): {
+    kind: 'published' | 'drafted' | 'failed';
+    packageId?: string;
+} | undefined;
+/**
+ * objectui#5799 — did this tool result finish a WHOLE-APP build, and for which
+ * package? Posture-independent on purpose: an auto-publish environment
+ * rewrites the apply_blueprint envelope to `status:'published'` (keeping
+ * `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;
 /**
  * Synthesize a COMPLETED build-progress summary from a persisted apply_blueprint
@@ -171,7 +313,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":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAc,iBAAiB,EAAoC,MAAM,mBAAmB,CAAC;AAE1I,UAAU,OAAO;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,YAAY;IACpB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACvC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAmBD;;;;;;;GAOG;AACH;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CA4BxF;AAcD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD;;;;OAIG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/F;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,2DAA2D;IAC3D,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACjF,iFAAiF;IACjF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC7D,6EAA6E;IAC7E,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AASD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAkE5E;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAQhF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAqBlF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CA4E1E;AAWD;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,WAAW,GAAG,SAAS,GAC7B,iBAAiB,GAAG,SAAS,CAW/B;AA4LD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,YAAY,EACjB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,WAAW,CAiCb;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,YAAY,EAAE,EACxB,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACnC,WAAW,EAAE,CASf"}
+{"version":3,"file":"mapMessages.d.ts","sourceRoot":"","sources":["../src/mapMessages.ts"],"names":[],"mappings":"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"}

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"}

package/dist/useAiApprovalsTranslation.d.ts

@@ -0,0 +1,76 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Locale wiring for `AiPendingActionsInbox` — objectui#7173.
+ *
+ * A module of its own, the shape `plugin-detail`'s `useDetailTranslation.ts`
+ * already uses: the defaults map has to be importable by the test that compares
+ * it against the `en` pack, and exporting a non-component from the component
+ * file trips `react-refresh/only-export-components`.
+ *
+ * @module
+ */
+/**
+ * English fallbacks for every key the inbox reads.
+ *
+ * `createSafeTranslation` serves these when no `I18nProvider` is mounted — a
+ * standalone Studio panel, a host that embeds the inbox without the provider,
+ * this package's own tests — so a provider-less render shows English rather
+ * than raw keys. Every row here is byte-identical to its `en` pack value: the
+ * pack is what the console renders and this map is its stand-in, so the two
+ * must not disagree.
+ *
+ * The four relative-time rows are BORROWED from `detail.*` rather than minted
+ * under this namespace. They already existed, translated, in all ten packs, and
+ * cross-package borrowing is this repo's settled convention — `ObjectGrid`,
+ * `ObjectKanban`, `ObjectTree`, `ListView`, `ObjectView`, `NavigationOverlay`
+ * and `RecordAttachmentsPanel` all resolve `detail.*` from outside
+ * `plugin-detail`. One phrase on one kind of control should not get a second
+ * translation that can drift from the first.
+ *
+ * ⛔ The five relative-time helpers in this repo are NOT unified (objectui#7173's
+ * triage ruling): they differ in real behaviour — `Math.round` in this inbox vs
+ * `Math.floor` in `plugin-detail`, 45s/30d vs 60s/7d, different tails — and
+ * normalising them is a behaviour change that needs its own card. Only the
+ * OUTPUT is translated; `AiPendingActionsInbox.formatRelative` keeps its own
+ * arithmetic, pinned by `__tests__/AiPendingActionsInbox.i18n.test.tsx`.
+ *
+ * Exported from this MODULE, not from the package barrel (`src/index.tsx`
+ * names its exports one by one), so it stays off the published API surface
+ * while `__tests__/AiPendingActionsInbox.i18n.test.tsx` can compare it row by
+ * row against the `en` pack — the invariant
+ * `app-shell/src/__tests__/defaults-maps-mirror-en-pack.test.tsx` holds the
+ * detail / list / designer maps to. A row that disagrees with the pack renders
+ * two different labels for one control and nothing else would see it.
+ */
+export declare const AI_APPROVALS_DEFAULT_TRANSLATIONS: Record<string, string>;
+/**
+ * Safe wrapper for `useObjectTranslation` that falls back to the map above when
+ * no `I18nProvider` is mounted. Delegates to `@object-ui/i18n`'s
+ * `createSafeTranslation` — the factory form, not the per-call
+ * `useSafeTranslate(key, fallback)`: the inbox interpolates `{{count}}`,
+ * `{{id}}`, `{{message}}`, `{{tool}}` and `{{object}}`, and `useSafeTranslate`
+ * has no options argument, so those holes would reach the DOM raw. No inline
+ * `defaultValue` anywhere either (objectui#3517).
+ */
+export declare const useAiApprovalsTranslation: () => {
+    t: (key: string, options?: Record<string, unknown>) => string;
+    language: string;
+} | {
+    t: import('i18next').TFunction<string, undefined>;
+    language: string;
+};
+/**
+ * The `t` the inbox's module-level helpers take.
+ *
+ * `formatRelative` and `statusLabel` are plain functions, not hooks, so the
+ * component reads the hook once and passes `t` down — the same shape
+ * `ActivityTimeline` uses for its own formatter.
+ */
+export type InboxTranslate = (key: string, options?: Record<string, unknown>) => string;
+//# sourceMappingURL=useAiApprovalsTranslation.d.ts.map

package/dist/useAiApprovalsTranslation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAiApprovalsTranslation.d.ts","sourceRoot":"","sources":["../src/useAiApprovalsTranslation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,iCAAiC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAqDpE,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB;4BAjHrC,CAAC;;;;;CAoHD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC"}

package/dist/useAiModels.d.ts

@@ -1,4 +1,4 @@
-import { ChatbotModelOption } from './ChatbotEnhanced';
+import { ChatbotModelOption } from './ChatbotEnhanced.js';
 export interface UseAiModelsOptions {
     /** Base URL of the AI service, e.g. "http://localhost:3000/api/v1/ai". */
     apiBase?: string;

package/dist/useHitlInChat.d.ts

@@ -1,5 +1,5 @@
-import { ChatMessage, ToolDecisionState } from './ChatbotEnhanced';
-import { ApproveOutcome, RejectOutcome } from './usePendingActions';
+import { ChatMessage, ToolDecisionState } from './ChatbotEnhanced.js';
+import { ApproveOutcome, RejectOutcome } from './usePendingActions.js';
 export type { ToolDecisionState };
 export interface UseHitlInChatOptions {
     /**