@wildo-ai/saas-frontend-lib 1.1.9 → 1.1.11

package/dist/esm/components/ai-elements/decision/approval.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import type { HumanDecision_AnswerValue, HumanDecision_Field, HumanDecision_ResponseIntent, HumanInputForm, ResourceOperationRiskLevel } from '@wildo-ai/saas-models';
 import type { SerializableZodSchema } from '@wildo-ai/zod-decorators';
 import { ComponentPresetProps } from '../../../core/components-registry/component-registry.frontend.schemas';
 import type { ComponentProps } from 'react';
@@ -21,6 +22,38 @@ export type AI_ApprovalReasonCodeOption = {
     value: string;
     label: string;
 };
+/**
+ * One answer a decision offers by NAME (#2526): a decision raised with options of its own rather than approve and deny —
+ * an actor system's question, for one. `label` and `description` are the words the host that raised it authored, shown
+ * as given; `intent` says what giving it means for the waiting work, so a surface asks for the fields only when the
+ * answer proceeds with them.
+ */
+export type AI_DecisionAnswerOption = {
+    ref: string;
+    label: string;
+    description?: string;
+    intent: HumanDecision_ResponseIntent;
+};
+/**
+ * A decision answered by one of its own named options, and the fields an answer that proceeds with values fills (#2526).
+ * `description` is what answering will cause and what happens if nobody does, in the host's words; the card's lead line
+ * (`actionDescription`) carries the request's title. `form` is how the fields are asked (#2720); absent, they are
+ * asked through the request's default form.
+ */
+export type AI_DecisionQuestion = {
+    description: string;
+    options: readonly AI_DecisionAnswerOption[];
+    fields: readonly HumanDecision_Field[];
+    form?: HumanInputForm;
+};
+/**
+ * One answered field, by the field's `ref`, as its JSON (#2720): text for a question asked without a form, the form's
+ * answer type otherwise. A CONFIRM field answers with a `HumanDecision_ConfirmAnswer`.
+ */
+export type AI_DecisionAnswerValue = {
+    ref: string;
+    value: HumanDecision_AnswerValue;
+};
 /**
  * What else a person may do with a decision besides answering it (#1594 D12). Each is offered only when its
  * callback is supplied, so a surface shows exactly the acts its owner can carry out — never a button that
@@ -52,6 +85,11 @@ export type AI_ApprovalRoutingProps = {
     /** Set while its deadlines are paused: why, as LOCALIZED text the surface's owner resolved. */
     clockPausedNotice?: string;
 };
+/** One argument as the server presented it (#2903): its key verbatim, its value already the string shown. */
+export interface AI_ApprovalPresentedArgument {
+    readonly key: string;
+    readonly value: string;
+}
 export type AI_ApprovalRequestProps = ComponentProps<"div"> & AI_ApprovalRoutingProps & {
     /**
      * Whether THIS viewer may answer it (#1594). `false` renders the request with no actions and shows
@@ -61,14 +99,28 @@ export type AI_ApprovalRequestProps = ComponentProps<"div"> & AI_ApprovalRouting
     approvalId: string;
     actionDescription: string;
     /**
-     * OPTIONAL, because nothing populates it — see the preset implementation's note. Absent means no
-     * risk badge; a default would assert a severity nobody declared (#528).
+     * The risk of the call being decided, as its approval gate declares it (`humanApproval.riskLevel`, #2526), carried on
+     * the inbox card and the paused turn's announcement. Absent means no risk badge and no confirmation; a default would
+     * assert a severity nobody declared (#528). High and critical ask the approver to confirm before an answer that
+     * proceeds takes effect.
      */
-    riskLevel?: "low" | "medium" | "high" | "critical";
+    riskLevel?: ResourceOperationRiskLevel;
     executionId: string;
+    /** The actor system, as an IDENTIFIER. Never shown: `systemName` is what a reader sees. */
     systemRef?: string;
+    /** The actor system's display name, as its own chat shows it (#2526). Absent: no assistant line. */
+    systemName?: string;
+    /**
+     * Who holds the decision now, as LOCALIZED text the surface's owner resolved (#2526) — "you claimed it", "anyone who is
+     * a finance approver". The surface shows it as given.
+     */
+    holderNotice?: string;
+    /**
+     * Who raised it, as LOCALIZED text the surface's owner resolved (#2526) — most usefully that an autonomous agent did,
+     * with no person behind the request. Absent when there is nothing worth saying.
+     */
+    requesterNotice?: string;
     expiresAt?: Date;
-    requiredRoles?: string[];
     /**
      * The gated tool call, and the arguments proposed for it.
      *
@@ -78,6 +130,11 @@ export type AI_ApprovalRequestProps = ComponentProps<"div"> & AI_ApprovalRouting
      */
     toolName?: string;
     executionContext?: Record<string, unknown>;
+    /**
+     * The arguments as the SERVER presented them (#2903): each key with its value already a string. When given, the card
+     * renders these verbatim and formats nothing itself, so what the approver reads is what their answer is sealed over.
+     */
+    presentedArguments?: readonly AI_ApprovalPresentedArgument[];
     /**
      * Offer the approver an EDITOR over the proposed arguments (#566) — see the preset implementation
      * for why this is opt-in per surface: turning it on changes what an approval MEANS, from assenting
@@ -119,6 +176,18 @@ export type AI_ApprovalRequestProps = ComponentProps<"div"> & AI_ApprovalRouting
     /** `reasonCode` is present only when the approver gave a reason for the rejection (#1921). */
     onDeny?: (approvalId: string, comment?: string, reasonCode?: string) => void;
     onEscalate?: (approvalId: string, comment?: string) => void;
+    /**
+     * The decision's own named options (#2526). Present, they REPLACE Approve and Deny: the person picks one of them, and
+     * fills the fields first when it proceeds with values. No argument editor is offered then — there is no proposed call
+     * to edit. Reasons are offered when the question is a REVIEW of an agent's work (#2539): the card then carries
+     * `reasonCodeOptions`, and the chosen reason rides on the answer.
+     */
+    question?: AI_DecisionQuestion;
+    /**
+     * The answer to a `question`: the option chosen and, when it proceeds with values, one value per field. `reasonCode`
+     * only when the reviewer chose a reason (#2539); the server keeps it only when the answer corrected the agent.
+     */
+    onAnswer?: (approvalId: string, optionRef: string, values: readonly AI_DecisionAnswerValue[], comment?: string, reasonCode?: string) => void;
     isProcessing?: boolean;
     createdAt?: Date;
 };
@@ -127,11 +196,20 @@ export type AI_ApprovalQueueItem = {
     executionId: string;
     systemRef: string;
     actionDescription: string;
-    /** OPTIONAL for the same reason as on a single request — nothing populates it (#528). */
-    riskLevel?: "low" | "medium" | "high" | "critical";
+    /** See {@link AI_ApprovalRequestProps.riskLevel}: the gate's declaration, absent when none. */
+    riskLevel?: ResourceOperationRiskLevel;
+    /** See {@link AI_ApprovalRequestProps.question}: the decision's own named options, when it has them. */
+    question?: AI_DecisionQuestion;
+    /** See {@link AI_ApprovalRequestProps.systemName}. */
+    systemName?: string;
+    /** See {@link AI_ApprovalRequestProps.holderNotice}. */
+    holderNotice?: string;
+    /** See {@link AI_ApprovalRequestProps.requesterNotice}. */
+    requesterNotice?: string;
     expiresAt?: Date;
-    requiredRoles?: string[];
     executionContext?: Record<string, unknown>;
+    /** See {@link AI_ApprovalRequestProps.presentedArguments}: the values as the server presented them (#2903). */
+    presentedArguments?: readonly AI_ApprovalPresentedArgument[];
     createdAt?: Date;
     /** The gated tool, rendered as authored (#455). */
     toolName?: string;
@@ -164,9 +242,27 @@ export type AI_ApprovalQueueProps = ComponentProps<"div"> & Omit<AI_ApprovalRout
     onApprove?: (approvalId: string, comment?: string, modifiedToolArgs?: Record<string, unknown>, reasonCode?: string) => void;
     onDeny?: (approvalId: string, comment?: string, reasonCode?: string) => void;
     onEscalate?: (approvalId: string, comment?: string) => void;
+    /** See {@link AI_ApprovalRequestProps.onAnswer}: the answer to an item carrying a `question`. */
+    onAnswer?: (approvalId: string, optionRef: string, values: readonly AI_DecisionAnswerValue[], comment?: string, reasonCode?: string) => void;
     processingIds?: Set<string>;
+    /**
+     * The text the list is narrowed by. Controlled when given — the queue then renders the filter field bound to it and
+     * reports edits through `onFilterChange`; uncontrolled otherwise.
+     */
     filter?: string;
     onFilterChange?: (filter: string) => void;
+    /**
+     * No read of the list has settled yet (#2526). With no items the queue shows a placeholder, never "nothing pending":
+     * an inbox that is still loading and one that is empty must not look alike.
+     */
+    isLoading?: boolean;
+    /**
+     * The last read of the list failed (#2526). The queue says so and offers `onRetry`; items an earlier read listed stay
+     * shown beneath, since every act on them is re-checked by the server.
+     */
+    loadFailed?: boolean;
+    /** Read the list again. Offered beside `loadFailed`. */
+    onRetry?: () => void;
 };
 export type AI_DecisionOption = {
     id: string;

package/dist/esm/components/ai-elements/decision/approval.d.ts.map

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

package/dist/esm/components/ai-elements/decision/approval.js.map

@@ -1 +1 @@
-{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../../../../../src/components/ai-elements/decision/approval.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAE5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AAsMzH,mBAAmB;AAEnB,MAAM,UAAU,kBAAkB,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAkD;IAC/H,MAAM,SAAS,GAAG,uBAAuB,CAA0B,qBAAqB,CAAC,6BAA6B,EAAE,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;IACrJ,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAgD;IAC3H,MAAM,SAAS,GAAG,uBAAuB,CAAwB,qBAAqB,CAAC,2BAA2B,EAAE,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;IAC/I,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAkD;IAC/H,MAAM,SAAS,GAAG,uBAAuB,CAA0B,qBAAqB,CAAC,6BAA6B,EAAE,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;IACrJ,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAoD;IACnI,MAAM,SAAS,GAAG,uBAAuB,CAA4B,qBAAqB,CAAC,gCAAgC,EAAE,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAA;IAC5J,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC","sourcesContent":["import React from 'react'\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models'\nimport type { SerializableZodSchema } from '@wildo-ai/zod-decorators'\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\nimport type { ComponentProps } from 'react'\n\n// --- Contracts ---\n\n/** One person a decision may be moved to, as the surface shows them. `value` is their id. */\nexport type AI_ApprovalReassignCandidate = { value: string; label: string }\n\n/** One reason a decision's clocks may be paused for (#1628). `value` is the gate's pause-state identifier. */\nexport type AI_ApprovalPauseStateOption = { value: string; label: string }\n\n/**\n * One reason an approver may give for changing or rejecting an agent's proposal (#1921). `value` is a code of the\n * application's declared vocabulary (`agentWorkReview.reasonCodes`); `label` is its word, as LOCALIZED text the\n * surface's owner resolved from `system_enums.AgentWorkReasonCode.<code>` — the code itself when no word is authored.\n */\nexport type AI_ApprovalReasonCodeOption = { value: string; label: string }\n\n/**\n * What else a person may do with a decision besides answering it (#1594 D12). Each is offered only when its\n * callback is supplied, so a surface shows exactly the acts its owner can carry out — never a button that\n * submits into nothing. Declared here as well as on the preset: this module is the contract consumers import.\n */\nexport type AI_ApprovalRoutingProps = {\n  /** Take a decision routed to a role you hold for yourself. */\n  onClaim?: (approvalId: string) => void\n  /** Give a decision you claimed back to its role. */\n  onUnclaim?: (approvalId: string) => void\n  /** The reassign picker opened: load who it may go to, and pass them back as `reassignCandidates`. */\n  onReassignOpen?: (approvalId: string) => void\n  /** Only people who could answer it. Absent while loading; empty when nobody else can. */\n  reassignCandidates?: readonly AI_ApprovalReassignCandidate[]\n  onReassign?: (approvalId: string, targetUserId: string, comment?: string) => void\n  /** What the last act came to, as LOCALIZED text the surface's owner resolved. Absent when there is nothing to say. */\n  actionNotice?: string\n  /**\n   * Stop the decision's CLAIM and DECISION deadlines, naming one of `pauseStateOptions` (#1628). Offered only\n   * with at least one option. Pausing never stops the decision from expiring.\n   */\n  onPauseClock?: (approvalId: string, pauseStateRef: string) => void\n  /** Restart paused deadlines; the paused time is added to them. */\n  onResumeClock?: (approvalId: string) => void\n  /** The reasons the gate allows its deadlines to be paused for. */\n  pauseStateOptions?: readonly AI_ApprovalPauseStateOption[]\n  /** The next deadline ahead of the decision, as LOCALIZED text the surface's owner resolved. */\n  deadlineNotice?: string\n  /** Set while its deadlines are paused: why, as LOCALIZED text the surface's owner resolved. */\n  clockPausedNotice?: string\n}\n\nexport type AI_ApprovalRequestProps = ComponentProps<\"div\"> & AI_ApprovalRoutingProps & {\n  /**\n   * Whether THIS viewer may answer it (#1594). `false` renders the request with no actions and shows\n   * `actionNotice` instead — a question a reviewer answers. Default `true`.\n   */\n  answerable?: boolean\n  approvalId: string\n  actionDescription: string\n  /**\n   * OPTIONAL, because nothing populates it — see the preset implementation's note. Absent means no\n   * risk badge; a default would assert a severity nobody declared (#528).\n   */\n  riskLevel?: \"low\" | \"medium\" | \"high\" | \"critical\"\n  executionId: string\n  systemRef?: string\n  expiresAt?: Date\n  requiredRoles?: string[]\n  /**\n   * The gated tool call, and the arguments proposed for it.\n   *\n   * `toolName` is an IDENTIFIER, rendered as authored — it is the thing the agent asked to run,\n   * and humanizing it here would invent display text no i18n tree owns.\n   * `executionContext` carries the arguments (#455).\n   */\n  toolName?: string\n  executionContext?: Record<string, unknown>\n  /**\n   * Offer the approver an EDITOR over the proposed arguments (#566) — see the preset implementation\n   * for why this is opt-in per surface: turning it on changes what an approval MEANS, from assenting\n   * to the agent's call to authoring one.\n   *\n   * Declared HERE as well as on the preset because this module is the CONTRACT every consumer\n   * imports; the preset behind it is reached through the registry. A prop added only to the preset\n   * is invisible to callers and rejected by this type — which is exactly what happened while adding\n   * it, and is the resolver hop `positive-evidence-must-name-its-target.md` records.\n   */\n  allowArgumentModification?: boolean\n  /**\n   * The gated tool's input schema as a `SerializableZodSchema` descriptor (#587). When present and\n   * renderable, the argument editor offers the tool's fields instead of raw JSON; the raw editor stays\n   * reachable, and is the fallback for any shape the fields cannot express.\n   */\n  argumentsSchema?: SerializableZodSchema\n  /**\n   * The server's refusal of the last submitted edit (#587). The approval is still pending, so the\n   * editor stays open and shows why.\n   */\n  argumentModificationError?: string\n  /**\n   * The arguments the approver submitted when that edit was refused (#587), so the reopened editor starts\n   * from their edit rather than from the model's proposal.\n   */\n  rejectedArguments?: Record<string, unknown>\n  /**\n   * The reasons an approver may give when they CHANGE or REJECT the proposal (#1921). Offered only then — approving\n   * the call as proposed is not a correction and needs no reason — and never required: a reason is optional evidence\n   * for the override rate's breakdown, not a gate on answering. Absent or empty: no picker.\n   */\n  reasonCodeOptions?: readonly AI_ApprovalReasonCodeOption[]\n  /**\n   * `modifiedToolArgs` is present only when the approver EDITED the arguments (#566); `reasonCode` only when they gave a\n   * reason for that edit (#1921).\n   */\n  onApprove?: (approvalId: string, comment?: string, modifiedToolArgs?: Record<string, unknown>, reasonCode?: string) => void\n  /** `reasonCode` is present only when the approver gave a reason for the rejection (#1921). */\n  onDeny?: (approvalId: string, comment?: string, reasonCode?: string) => void\n  onEscalate?: (approvalId: string, comment?: string) => void\n  isProcessing?: boolean\n  createdAt?: Date\n}\n\nexport type AI_ApprovalQueueItem = {\n  approvalId: string\n  executionId: string\n  systemRef: string\n  actionDescription: string\n  /** OPTIONAL for the same reason as on a single request — nothing populates it (#528). */\n  riskLevel?: \"low\" | \"medium\" | \"high\" | \"critical\"\n  expiresAt?: Date\n  requiredRoles?: string[]\n  executionContext?: Record<string, unknown>\n  createdAt?: Date\n  /** The gated tool, rendered as authored (#455). */\n  toolName?: string\n  /** Which routing acts THIS item offers (#1594). Unset means none. */\n  canEscalate?: boolean\n  canClaim?: boolean\n  canUnclaim?: boolean\n  canReassign?: boolean\n  reassignCandidates?: readonly AI_ApprovalReassignCandidate[]\n  actionNotice?: string\n  /** #1628: whether this item offers Pause / Resume, the reasons it may be paused for, and its deadline lines. */\n  canPauseClock?: boolean\n  canResumeClock?: boolean\n  pauseStateOptions?: readonly AI_ApprovalPauseStateOption[]\n  deadlineNotice?: string\n  clockPausedNotice?: string\n  /** #1921: the reasons a reviewer may give when changing or rejecting this item's proposal. */\n  reasonCodeOptions?: readonly AI_ApprovalReasonCodeOption[]\n  /**\n   * #1921: offer the argument editor on this item — a reviewer may CHANGE the proposed call, not only approve or reject\n   * it. Only for an item whose answer door carries `modifiedToolArgs`; see `AI_ApprovalRequestProps`.\n   */\n  allowArgumentModification?: boolean\n  /** The gated tool's input-schema descriptor, so the editor offers the tool's fields (#587). */\n  argumentsSchema?: SerializableZodSchema\n}\n\nexport type AI_ApprovalQueueProps = ComponentProps<\"div\"> & Omit<AI_ApprovalRoutingProps, 'reassignCandidates' | 'actionNotice' | 'pauseStateOptions' | 'deadlineNotice' | 'clockPausedNotice'> & {\n  items: AI_ApprovalQueueItem[]\n  /** `modifiedToolArgs` only when the reviewer edited the call; `reasonCode` only when they gave a reason (#1921). */\n  onApprove?: (approvalId: string, comment?: string, modifiedToolArgs?: Record<string, unknown>, reasonCode?: string) => void\n  onDeny?: (approvalId: string, comment?: string, reasonCode?: string) => void\n  onEscalate?: (approvalId: string, comment?: string) => void\n  processingIds?: Set<string>\n  filter?: string\n  onFilterChange?: (filter: string) => void\n}\n\nexport type AI_DecisionOption = {\n  id: string\n  label: string\n  description?: string\n  variant?: \"default\" | \"destructive\" | \"outline\"\n}\n\nexport type AI_DecisionRequestProps = Omit<ComponentProps<\"div\">, \"onSelect\"> & {\n  decisionId: string\n  title: string\n  description: string\n  options: AI_DecisionOption[]\n  riskLevel?: string\n  deadline?: string\n  undoGracePeriodMs?: number\n  onSelect?: (decisionId: string, optionId: string) => void\n}\n\nexport type AI_HumanInputRequestProps = Omit<ComponentProps<\"div\">, \"onSubmit\"> & {\n  requestId: string\n  prompt: string\n  inputType?: \"text\" | \"textarea\"\n  placeholder?: string\n  maxLength?: number\n  deadline?: string\n  onSubmit?: (requestId: string, value: string) => void\n}\n\n// --- Wrappers ---\n\nexport function AI_ApprovalRequest({ preset = CorePresetNames.DEFAULT, ...props }: AI_ApprovalRequestProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<AI_ApprovalRequestProps>(FrontendComponentType.LOW_LEVEL_AI_APPROVAL_REQUEST, 'AI_ApprovalRequest')(preset)\n  return <Component {...props} />\n}\n\nexport function AI_ApprovalQueue({ preset = CorePresetNames.DEFAULT, ...props }: AI_ApprovalQueueProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<AI_ApprovalQueueProps>(FrontendComponentType.LOW_LEVEL_AI_APPROVAL_QUEUE, 'AI_ApprovalQueue')(preset)\n  return <Component {...props} />\n}\n\nexport function AI_DecisionRequest({ preset = CorePresetNames.DEFAULT, ...props }: AI_DecisionRequestProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<AI_DecisionRequestProps>(FrontendComponentType.LOW_LEVEL_AI_DECISION_REQUEST, 'AI_DecisionRequest')(preset)\n  return <Component {...props} />\n}\n\nexport function AI_HumanInputRequest({ preset = CorePresetNames.DEFAULT, ...props }: AI_HumanInputRequestProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<AI_HumanInputRequestProps>(FrontendComponentType.LOW_LEVEL_AI_HUMAN_INPUT_REQUEST, 'AI_HumanInputRequest')(preset)\n  return <Component {...props} />\n}\n"]}
+{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../../../../../src/components/ai-elements/decision/approval.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAG5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AA4RzH,mBAAmB;AAEnB,MAAM,UAAU,kBAAkB,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAkD;IAC/H,MAAM,SAAS,GAAG,uBAAuB,CAA0B,qBAAqB,CAAC,6BAA6B,EAAE,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;IACrJ,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAgD;IAC3H,MAAM,SAAS,GAAG,uBAAuB,CAAwB,qBAAqB,CAAC,2BAA2B,EAAE,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAA;IAC/I,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAkD;IAC/H,MAAM,SAAS,GAAG,uBAAuB,CAA0B,qBAAqB,CAAC,6BAA6B,EAAE,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;IACrJ,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAoD;IACnI,MAAM,SAAS,GAAG,uBAAuB,CAA4B,qBAAqB,CAAC,gCAAgC,EAAE,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAA;IAC5J,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC","sourcesContent":["import React from 'react'\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models'\nimport type { HumanDecision_AnswerValue, HumanDecision_Field, HumanDecision_ResponseIntent, HumanInputForm, ResourceOperationRiskLevel } from '@wildo-ai/saas-models'\nimport type { SerializableZodSchema } from '@wildo-ai/zod-decorators'\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\nimport type { ComponentProps } from 'react'\n\n// --- Contracts ---\n\n/** One person a decision may be moved to, as the surface shows them. `value` is their id. */\nexport type AI_ApprovalReassignCandidate = { value: string; label: string }\n\n/** One reason a decision's clocks may be paused for (#1628). `value` is the gate's pause-state identifier. */\nexport type AI_ApprovalPauseStateOption = { value: string; label: string }\n\n/**\n * One reason an approver may give for changing or rejecting an agent's proposal (#1921). `value` is a code of the\n * application's declared vocabulary (`agentWorkReview.reasonCodes`); `label` is its word, as LOCALIZED text the\n * surface's owner resolved from `system_enums.AgentWorkReasonCode.<code>` — the code itself when no word is authored.\n */\nexport type AI_ApprovalReasonCodeOption = { value: string; label: string }\n\n/**\n * One answer a decision offers by NAME (#2526): a decision raised with options of its own rather than approve and deny —\n * an actor system's question, for one. `label` and `description` are the words the host that raised it authored, shown\n * as given; `intent` says what giving it means for the waiting work, so a surface asks for the fields only when the\n * answer proceeds with them.\n */\nexport type AI_DecisionAnswerOption = { ref: string; label: string; description?: string; intent: HumanDecision_ResponseIntent }\n\n/**\n * A decision answered by one of its own named options, and the fields an answer that proceeds with values fills (#2526).\n * `description` is what answering will cause and what happens if nobody does, in the host's words; the card's lead line\n * (`actionDescription`) carries the request's title. `form` is how the fields are asked (#2720); absent, they are\n * asked through the request's default form.\n */\nexport type AI_DecisionQuestion = { description: string; options: readonly AI_DecisionAnswerOption[]; fields: readonly HumanDecision_Field[]; form?: HumanInputForm }\n\n/**\n * One answered field, by the field's `ref`, as its JSON (#2720): text for a question asked without a form, the form's\n * answer type otherwise. A CONFIRM field answers with a `HumanDecision_ConfirmAnswer`.\n */\nexport type AI_DecisionAnswerValue = { ref: string; value: HumanDecision_AnswerValue }\n\n/**\n * What else a person may do with a decision besides answering it (#1594 D12). Each is offered only when its\n * callback is supplied, so a surface shows exactly the acts its owner can carry out — never a button that\n * submits into nothing. Declared here as well as on the preset: this module is the contract consumers import.\n */\nexport type AI_ApprovalRoutingProps = {\n  /** Take a decision routed to a role you hold for yourself. */\n  onClaim?: (approvalId: string) => void\n  /** Give a decision you claimed back to its role. */\n  onUnclaim?: (approvalId: string) => void\n  /** The reassign picker opened: load who it may go to, and pass them back as `reassignCandidates`. */\n  onReassignOpen?: (approvalId: string) => void\n  /** Only people who could answer it. Absent while loading; empty when nobody else can. */\n  reassignCandidates?: readonly AI_ApprovalReassignCandidate[]\n  onReassign?: (approvalId: string, targetUserId: string, comment?: string) => void\n  /** What the last act came to, as LOCALIZED text the surface's owner resolved. Absent when there is nothing to say. */\n  actionNotice?: string\n  /**\n   * Stop the decision's CLAIM and DECISION deadlines, naming one of `pauseStateOptions` (#1628). Offered only\n   * with at least one option. Pausing never stops the decision from expiring.\n   */\n  onPauseClock?: (approvalId: string, pauseStateRef: string) => void\n  /** Restart paused deadlines; the paused time is added to them. */\n  onResumeClock?: (approvalId: string) => void\n  /** The reasons the gate allows its deadlines to be paused for. */\n  pauseStateOptions?: readonly AI_ApprovalPauseStateOption[]\n  /** The next deadline ahead of the decision, as LOCALIZED text the surface's owner resolved. */\n  deadlineNotice?: string\n  /** Set while its deadlines are paused: why, as LOCALIZED text the surface's owner resolved. */\n  clockPausedNotice?: string\n}\n\n/** One argument as the server presented it (#2903): its key verbatim, its value already the string shown. */\nexport interface AI_ApprovalPresentedArgument {\n  readonly key: string\n  readonly value: string\n}\n\nexport type AI_ApprovalRequestProps = ComponentProps<\"div\"> & AI_ApprovalRoutingProps & {\n  /**\n   * Whether THIS viewer may answer it (#1594). `false` renders the request with no actions and shows\n   * `actionNotice` instead — a question a reviewer answers. Default `true`.\n   */\n  answerable?: boolean\n  approvalId: string\n  actionDescription: string\n  /**\n   * The risk of the call being decided, as its approval gate declares it (`humanApproval.riskLevel`, #2526), carried on\n   * the inbox card and the paused turn's announcement. Absent means no risk badge and no confirmation; a default would\n   * assert a severity nobody declared (#528). High and critical ask the approver to confirm before an answer that\n   * proceeds takes effect.\n   */\n  riskLevel?: ResourceOperationRiskLevel\n  executionId: string\n  /** The actor system, as an IDENTIFIER. Never shown: `systemName` is what a reader sees. */\n  systemRef?: string\n  /** The actor system's display name, as its own chat shows it (#2526). Absent: no assistant line. */\n  systemName?: string\n  /**\n   * Who holds the decision now, as LOCALIZED text the surface's owner resolved (#2526) — \"you claimed it\", \"anyone who is\n   * a finance approver\". The surface shows it as given.\n   */\n  holderNotice?: string\n  /**\n   * Who raised it, as LOCALIZED text the surface's owner resolved (#2526) — most usefully that an autonomous agent did,\n   * with no person behind the request. Absent when there is nothing worth saying.\n   */\n  requesterNotice?: string\n  expiresAt?: Date\n  /**\n   * The gated tool call, and the arguments proposed for it.\n   *\n   * `toolName` is an IDENTIFIER, rendered as authored — it is the thing the agent asked to run,\n   * and humanizing it here would invent display text no i18n tree owns.\n   * `executionContext` carries the arguments (#455).\n   */\n  toolName?: string\n  executionContext?: Record<string, unknown>\n  /**\n   * The arguments as the SERVER presented them (#2903): each key with its value already a string. When given, the card\n   * renders these verbatim and formats nothing itself, so what the approver reads is what their answer is sealed over.\n   */\n  presentedArguments?: readonly AI_ApprovalPresentedArgument[]\n  /**\n   * Offer the approver an EDITOR over the proposed arguments (#566) — see the preset implementation\n   * for why this is opt-in per surface: turning it on changes what an approval MEANS, from assenting\n   * to the agent's call to authoring one.\n   *\n   * Declared HERE as well as on the preset because this module is the CONTRACT every consumer\n   * imports; the preset behind it is reached through the registry. A prop added only to the preset\n   * is invisible to callers and rejected by this type — which is exactly what happened while adding\n   * it, and is the resolver hop `positive-evidence-must-name-its-target.md` records.\n   */\n  allowArgumentModification?: boolean\n  /**\n   * The gated tool's input schema as a `SerializableZodSchema` descriptor (#587). When present and\n   * renderable, the argument editor offers the tool's fields instead of raw JSON; the raw editor stays\n   * reachable, and is the fallback for any shape the fields cannot express.\n   */\n  argumentsSchema?: SerializableZodSchema\n  /**\n   * The server's refusal of the last submitted edit (#587). The approval is still pending, so the\n   * editor stays open and shows why.\n   */\n  argumentModificationError?: string\n  /**\n   * The arguments the approver submitted when that edit was refused (#587), so the reopened editor starts\n   * from their edit rather than from the model's proposal.\n   */\n  rejectedArguments?: Record<string, unknown>\n  /**\n   * The reasons an approver may give when they CHANGE or REJECT the proposal (#1921). Offered only then — approving\n   * the call as proposed is not a correction and needs no reason — and never required: a reason is optional evidence\n   * for the override rate's breakdown, not a gate on answering. Absent or empty: no picker.\n   */\n  reasonCodeOptions?: readonly AI_ApprovalReasonCodeOption[]\n  /**\n   * `modifiedToolArgs` is present only when the approver EDITED the arguments (#566); `reasonCode` only when they gave a\n   * reason for that edit (#1921).\n   */\n  onApprove?: (approvalId: string, comment?: string, modifiedToolArgs?: Record<string, unknown>, reasonCode?: string) => void\n  /** `reasonCode` is present only when the approver gave a reason for the rejection (#1921). */\n  onDeny?: (approvalId: string, comment?: string, reasonCode?: string) => void\n  onEscalate?: (approvalId: string, comment?: string) => void\n  /**\n   * The decision's own named options (#2526). Present, they REPLACE Approve and Deny: the person picks one of them, and\n   * fills the fields first when it proceeds with values. No argument editor is offered then — there is no proposed call\n   * to edit. Reasons are offered when the question is a REVIEW of an agent's work (#2539): the card then carries\n   * `reasonCodeOptions`, and the chosen reason rides on the answer.\n   */\n  question?: AI_DecisionQuestion\n  /**\n   * The answer to a `question`: the option chosen and, when it proceeds with values, one value per field. `reasonCode`\n   * only when the reviewer chose a reason (#2539); the server keeps it only when the answer corrected the agent.\n   */\n  onAnswer?: (approvalId: string, optionRef: string, values: readonly AI_DecisionAnswerValue[], comment?: string, reasonCode?: string) => void\n  isProcessing?: boolean\n  createdAt?: Date\n}\n\nexport type AI_ApprovalQueueItem = {\n  approvalId: string\n  executionId: string\n  systemRef: string\n  actionDescription: string\n  /** See {@link AI_ApprovalRequestProps.riskLevel}: the gate's declaration, absent when none. */\n  riskLevel?: ResourceOperationRiskLevel\n  /** See {@link AI_ApprovalRequestProps.question}: the decision's own named options, when it has them. */\n  question?: AI_DecisionQuestion\n  /** See {@link AI_ApprovalRequestProps.systemName}. */\n  systemName?: string\n  /** See {@link AI_ApprovalRequestProps.holderNotice}. */\n  holderNotice?: string\n  /** See {@link AI_ApprovalRequestProps.requesterNotice}. */\n  requesterNotice?: string\n  expiresAt?: Date\n  executionContext?: Record<string, unknown>\n  /** See {@link AI_ApprovalRequestProps.presentedArguments}: the values as the server presented them (#2903). */\n  presentedArguments?: readonly AI_ApprovalPresentedArgument[]\n  createdAt?: Date\n  /** The gated tool, rendered as authored (#455). */\n  toolName?: string\n  /** Which routing acts THIS item offers (#1594). Unset means none. */\n  canEscalate?: boolean\n  canClaim?: boolean\n  canUnclaim?: boolean\n  canReassign?: boolean\n  reassignCandidates?: readonly AI_ApprovalReassignCandidate[]\n  actionNotice?: string\n  /** #1628: whether this item offers Pause / Resume, the reasons it may be paused for, and its deadline lines. */\n  canPauseClock?: boolean\n  canResumeClock?: boolean\n  pauseStateOptions?: readonly AI_ApprovalPauseStateOption[]\n  deadlineNotice?: string\n  clockPausedNotice?: string\n  /** #1921: the reasons a reviewer may give when changing or rejecting this item's proposal. */\n  reasonCodeOptions?: readonly AI_ApprovalReasonCodeOption[]\n  /**\n   * #1921: offer the argument editor on this item — a reviewer may CHANGE the proposed call, not only approve or reject\n   * it. Only for an item whose answer door carries `modifiedToolArgs`; see `AI_ApprovalRequestProps`.\n   */\n  allowArgumentModification?: boolean\n  /** The gated tool's input-schema descriptor, so the editor offers the tool's fields (#587). */\n  argumentsSchema?: SerializableZodSchema\n}\n\nexport type AI_ApprovalQueueProps = ComponentProps<\"div\"> & Omit<AI_ApprovalRoutingProps, 'reassignCandidates' | 'actionNotice' | 'pauseStateOptions' | 'deadlineNotice' | 'clockPausedNotice'> & {\n  items: AI_ApprovalQueueItem[]\n  /** `modifiedToolArgs` only when the reviewer edited the call; `reasonCode` only when they gave a reason (#1921). */\n  onApprove?: (approvalId: string, comment?: string, modifiedToolArgs?: Record<string, unknown>, reasonCode?: string) => void\n  onDeny?: (approvalId: string, comment?: string, reasonCode?: string) => void\n  onEscalate?: (approvalId: string, comment?: string) => void\n  /** See {@link AI_ApprovalRequestProps.onAnswer}: the answer to an item carrying a `question`. */\n  onAnswer?: (approvalId: string, optionRef: string, values: readonly AI_DecisionAnswerValue[], comment?: string, reasonCode?: string) => void\n  processingIds?: Set<string>\n  /**\n   * The text the list is narrowed by. Controlled when given — the queue then renders the filter field bound to it and\n   * reports edits through `onFilterChange`; uncontrolled otherwise.\n   */\n  filter?: string\n  onFilterChange?: (filter: string) => void\n  /**\n   * No read of the list has settled yet (#2526). With no items the queue shows a placeholder, never \"nothing pending\":\n   * an inbox that is still loading and one that is empty must not look alike.\n   */\n  isLoading?: boolean\n  /**\n   * The last read of the list failed (#2526). The queue says so and offers `onRetry`; items an earlier read listed stay\n   * shown beneath, since every act on them is re-checked by the server.\n   */\n  loadFailed?: boolean\n  /** Read the list again. Offered beside `loadFailed`. */\n  onRetry?: () => void\n}\n\nexport type AI_DecisionOption = {\n  id: string\n  label: string\n  description?: string\n  variant?: \"default\" | \"destructive\" | \"outline\"\n}\n\nexport type AI_DecisionRequestProps = Omit<ComponentProps<\"div\">, \"onSelect\"> & {\n  decisionId: string\n  title: string\n  description: string\n  options: AI_DecisionOption[]\n  riskLevel?: string\n  deadline?: string\n  undoGracePeriodMs?: number\n  onSelect?: (decisionId: string, optionId: string) => void\n}\n\nexport type AI_HumanInputRequestProps = Omit<ComponentProps<\"div\">, \"onSubmit\"> & {\n  requestId: string\n  prompt: string\n  inputType?: \"text\" | \"textarea\"\n  placeholder?: string\n  maxLength?: number\n  deadline?: string\n  onSubmit?: (requestId: string, value: string) => void\n}\n\n// --- Wrappers ---\n\nexport function AI_ApprovalRequest({ preset = CorePresetNames.DEFAULT, ...props }: AI_ApprovalRequestProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<AI_ApprovalRequestProps>(FrontendComponentType.LOW_LEVEL_AI_APPROVAL_REQUEST, 'AI_ApprovalRequest')(preset)\n  return <Component {...props} />\n}\n\nexport function AI_ApprovalQueue({ preset = CorePresetNames.DEFAULT, ...props }: AI_ApprovalQueueProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<AI_ApprovalQueueProps>(FrontendComponentType.LOW_LEVEL_AI_APPROVAL_QUEUE, 'AI_ApprovalQueue')(preset)\n  return <Component {...props} />\n}\n\nexport function AI_DecisionRequest({ preset = CorePresetNames.DEFAULT, ...props }: AI_DecisionRequestProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<AI_DecisionRequestProps>(FrontendComponentType.LOW_LEVEL_AI_DECISION_REQUEST, 'AI_DecisionRequest')(preset)\n  return <Component {...props} />\n}\n\nexport function AI_HumanInputRequest({ preset = CorePresetNames.DEFAULT, ...props }: AI_HumanInputRequestProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<AI_HumanInputRequestProps>(FrontendComponentType.LOW_LEVEL_AI_HUMAN_INPUT_REQUEST, 'AI_HumanInputRequest')(preset)\n  return <Component {...props} />\n}\n"]}

package/dist/esm/components/ai-elements/execution/tool.d.ts

@@ -5,6 +5,12 @@ export type AI_ToolUIPartState = "input-streaming" | "input-available" | "output
 export type AI_ToolProps = CollapsibleProps;
 export type AI_ToolHeaderProps = {
     title?: string;
+    /**
+     * One line under the title saying what the call did, in words: what it asked for and what it found ("Searched for
+     * “invoice” · 2 found"). The details below the header stay the call's raw arguments; this line is for a reader who
+     * does not open them.
+     */
+    description?: string;
     type: string;
     state: AI_ToolUIPartState;
     className?: string;

package/dist/esm/components/ai-elements/execution/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ai-elements/execution/tool.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AACvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qDAAqD,CAAA;AAG3F,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,cAAc,GAAG,oBAAoB,GAAG,oBAAoB,GAAG,eAAe,CAAA;AAE5K,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAA;AAE3C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,kBAAkB,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC9D,UAAU,CAAC,EAAE,IAAI,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC5D,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC7D,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAID,MAAM,WAAW,eAAe;IAC9B,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAA;IACxC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAA;IACpC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAA;IACtC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAA;IAClC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAA;CACrC;AAYD,wBAAgB,OAAO,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG9H;AAED,wBAAgB,aAAa,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,kBAAkB,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG1I;AAED,wBAAgB,cAAc,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,mBAAmB,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG5I;AAED,wBAAgB,YAAY,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGxI;AAED,wBAAgB,aAAa,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,kBAAkB,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG1I"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ai-elements/execution/tool.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AACvH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qDAAqD,CAAA;AAG3F,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,cAAc,GAAG,oBAAoB,GAAG,oBAAoB,GAAG,eAAe,CAAA;AAE5K,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAA;AAE3C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,kBAAkB,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC9D,UAAU,CAAC,EAAE,IAAI,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC5D,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC7D,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAID,MAAM,WAAW,eAAe;IAC9B,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAA;IACxC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAA;IACpC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAA;IACtC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAA;IAClC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAA;CACrC;AAYD,wBAAgB,OAAO,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG9H;AAED,wBAAgB,aAAa,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,kBAAkB,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG1I;AAED,wBAAgB,cAAc,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,mBAAmB,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG5I;AAED,wBAAgB,YAAY,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGxI;AAED,wBAAgB,aAAa,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,kBAAkB,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG1I"}

package/dist/esm/components/ai-elements/execution/tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../../../src/components/ai-elements/execution/tool.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,iFAAiF,CAAA;AACjI,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAuC5F,mBAAmB;AAEnB,MAAM,OAAO,GAAG,+BAA+B,CAC7C,qBAAqB,CAAC,iBAAiB,EACvC,SAAS,EACT,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CACzC,CAAA;AAED,mBAAmB;AAEnB,MAAM,UAAU,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAuC;IACzG,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACzB,OAAO,KAAC,CAAC,OAAK,KAAK,GAAI,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAA6C;IACrH,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACzB,OAAO,KAAC,CAAC,CAAC,MAAM,OAAK,KAAK,GAAI,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAA8C;IACvH,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACzB,OAAO,KAAC,CAAC,CAAC,OAAO,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAA4C;IACnH,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACzB,OAAO,KAAC,CAAC,CAAC,KAAK,OAAK,KAAK,GAAI,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAA6C;IACrH,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACzB,OAAO,KAAC,CAAC,CAAC,MAAM,OAAK,KAAK,GAAI,CAAA;AAChC,CAAC","sourcesContent":["import React from 'react'\nimport { createCompoundComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models'\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\nimport type { CollapsibleProps } from '~wildo-frontend-lib/components/sections/collapsible'\n\n// --- Contract ---\nexport type AI_ToolUIPartState = \"input-streaming\" | \"input-available\" | \"output-available\" | \"output-error\" | \"approval-requested\" | \"approval-responded\" | \"output-denied\"\n\nexport type AI_ToolProps = CollapsibleProps\n\nexport type AI_ToolHeaderProps = {\n  title?: string\n  type: string\n  state: AI_ToolUIPartState\n  className?: string\n}\n\nexport type AI_ToolContentProps = React.ComponentProps<\"div\"> & {\n  forceMount?: true\n}\n\nexport type AI_ToolInputProps = React.ComponentProps<\"div\"> & {\n  input: unknown\n}\n\nexport type AI_ToolOutputProps = React.ComponentProps<\"div\"> & {\n  output: unknown\n  errorText?: string\n}\n\n// --- Compound type ---\n\nexport interface AI_ToolCompound {\n  (props: AI_ToolProps): React.JSX.Element\n  Header: React.FC<AI_ToolHeaderProps>\n  Content: React.FC<AI_ToolContentProps>\n  Input: React.FC<AI_ToolInputProps>\n  Output: React.FC<AI_ToolOutputProps>\n}\n\n// --- Resolver ---\n\nconst resolve = createCompoundComponentResolver<AI_ToolCompound>(\n  FrontendComponentType.LOW_LEVEL_AI_TOOL,\n  'AI_Tool',\n  ['Header', 'Content', 'Input', 'Output']\n)\n\n// --- Wrappers ---\n\nexport function AI_Tool({ preset = CorePresetNames.DEFAULT, ...props }: AI_ToolProps & ComponentPresetProps): React.JSX.Element {\n  const C = resolve(preset)\n  return <C {...props} />\n}\n\nexport function AI_ToolHeader({ preset = CorePresetNames.DEFAULT, ...props }: AI_ToolHeaderProps & ComponentPresetProps): React.JSX.Element {\n  const C = resolve(preset)\n  return <C.Header {...props} />\n}\n\nexport function AI_ToolContent({ preset = CorePresetNames.DEFAULT, ...props }: AI_ToolContentProps & ComponentPresetProps): React.JSX.Element {\n  const C = resolve(preset)\n  return <C.Content {...props} />\n}\n\nexport function AI_ToolInput({ preset = CorePresetNames.DEFAULT, ...props }: AI_ToolInputProps & ComponentPresetProps): React.JSX.Element {\n  const C = resolve(preset)\n  return <C.Input {...props} />\n}\n\nexport function AI_ToolOutput({ preset = CorePresetNames.DEFAULT, ...props }: AI_ToolOutputProps & ComponentPresetProps): React.JSX.Element {\n  const C = resolve(preset)\n  return <C.Output {...props} />\n}\n"]}
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../../../../src/components/ai-elements/execution/tool.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,iFAAiF,CAAA;AACjI,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AA6C5F,mBAAmB;AAEnB,MAAM,OAAO,GAAG,+BAA+B,CAC7C,qBAAqB,CAAC,iBAAiB,EACvC,SAAS,EACT,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CACzC,CAAA;AAED,mBAAmB;AAEnB,MAAM,UAAU,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAuC;IACzG,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACzB,OAAO,KAAC,CAAC,OAAK,KAAK,GAAI,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAA6C;IACrH,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACzB,OAAO,KAAC,CAAC,CAAC,MAAM,OAAK,KAAK,GAAI,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAA8C;IACvH,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACzB,OAAO,KAAC,CAAC,CAAC,OAAO,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAA4C;IACnH,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACzB,OAAO,KAAC,CAAC,CAAC,KAAK,OAAK,KAAK,GAAI,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAA6C;IACrH,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACzB,OAAO,KAAC,CAAC,CAAC,MAAM,OAAK,KAAK,GAAI,CAAA;AAChC,CAAC","sourcesContent":["import React from 'react'\nimport { createCompoundComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models'\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\nimport type { CollapsibleProps } from '~wildo-frontend-lib/components/sections/collapsible'\n\n// --- Contract ---\nexport type AI_ToolUIPartState = \"input-streaming\" | \"input-available\" | \"output-available\" | \"output-error\" | \"approval-requested\" | \"approval-responded\" | \"output-denied\"\n\nexport type AI_ToolProps = CollapsibleProps\n\nexport type AI_ToolHeaderProps = {\n  title?: string\n  /**\n   * One line under the title saying what the call did, in words: what it asked for and what it found (\"Searched for\n   * “invoice” · 2 found\"). The details below the header stay the call's raw arguments; this line is for a reader who\n   * does not open them.\n   */\n  description?: string\n  type: string\n  state: AI_ToolUIPartState\n  className?: string\n}\n\nexport type AI_ToolContentProps = React.ComponentProps<\"div\"> & {\n  forceMount?: true\n}\n\nexport type AI_ToolInputProps = React.ComponentProps<\"div\"> & {\n  input: unknown\n}\n\nexport type AI_ToolOutputProps = React.ComponentProps<\"div\"> & {\n  output: unknown\n  errorText?: string\n}\n\n// --- Compound type ---\n\nexport interface AI_ToolCompound {\n  (props: AI_ToolProps): React.JSX.Element\n  Header: React.FC<AI_ToolHeaderProps>\n  Content: React.FC<AI_ToolContentProps>\n  Input: React.FC<AI_ToolInputProps>\n  Output: React.FC<AI_ToolOutputProps>\n}\n\n// --- Resolver ---\n\nconst resolve = createCompoundComponentResolver<AI_ToolCompound>(\n  FrontendComponentType.LOW_LEVEL_AI_TOOL,\n  'AI_Tool',\n  ['Header', 'Content', 'Input', 'Output']\n)\n\n// --- Wrappers ---\n\nexport function AI_Tool({ preset = CorePresetNames.DEFAULT, ...props }: AI_ToolProps & ComponentPresetProps): React.JSX.Element {\n  const C = resolve(preset)\n  return <C {...props} />\n}\n\nexport function AI_ToolHeader({ preset = CorePresetNames.DEFAULT, ...props }: AI_ToolHeaderProps & ComponentPresetProps): React.JSX.Element {\n  const C = resolve(preset)\n  return <C.Header {...props} />\n}\n\nexport function AI_ToolContent({ preset = CorePresetNames.DEFAULT, ...props }: AI_ToolContentProps & ComponentPresetProps): React.JSX.Element {\n  const C = resolve(preset)\n  return <C.Content {...props} />\n}\n\nexport function AI_ToolInput({ preset = CorePresetNames.DEFAULT, ...props }: AI_ToolInputProps & ComponentPresetProps): React.JSX.Element {\n  const C = resolve(preset)\n  return <C.Input {...props} />\n}\n\nexport function AI_ToolOutput({ preset = CorePresetNames.DEFAULT, ...props }: AI_ToolOutputProps & ComponentPresetProps): React.JSX.Element {\n  const C = resolve(preset)\n  return <C.Output {...props} />\n}\n"]}

package/dist/esm/components/ai-elements/graph/canvas.d.ts

@@ -1,8 +1,67 @@
 import React from 'react';
-import type { ReactFlowProps } from '@xyflow/react';
+import type { Node, ReactFlowProps, Viewport } from '@xyflow/react';
 import { ComponentPresetProps } from '../../../core/components-registry/component-registry.frontend.schemas';
+/**
+ * What a person does with a canvas. Every canvas states it, because the two need opposite defaults and getting them
+ * wrong is silent: an editor canvas shown read-only deletes a node on Backspace and rubber-band selects on drag, and
+ * each read-only surface used to undo those defaults one prop at a time (#2529).
+ */
+export declare enum GraphCanvasInteraction {
+    /**
+     * Read a graph. Dragging pans, the wheel zooms, nodes can be focused and selected; nothing moves, connects or is
+     * deleted. The view refits when the canvas's frame is resized, since that is not the reader moving the map.
+     */
+    VIEW = "view",
+    /** Build a graph: nodes drag, handles connect, a drag selects a region, Backspace and Delete remove, the wheel pans. */
+    EDIT = "edit"
+}
+/** The mark a legend entry is drawn with. */
+export declare enum GraphLegendMark {
+    /** A dot: a node's state. */
+    DOT = "dot",
+    /** A solid line: an edge. */
+    LINE = "line",
+    /** A dashed line: an edge drawn dashed. */
+    DASHED_LINE = "dashed_line"
+}
+/** One entry of a canvas legend: what a mark means, in the host's words. */
+export interface GraphCanvasLegendEntry {
+    readonly id: string;
+    readonly label: string;
+    readonly mark: GraphLegendMark;
+    /** The classes that colour the mark: a tone fill for a dot, a stroke colour for a line. */
+    readonly markClassName: string;
+}
+export interface GraphCanvasLegend {
+    /** The legend's heading, in the host's words. */
+    readonly title: string;
+    readonly entries: readonly GraphCanvasLegendEntry[];
+}
+/** A miniature of the whole graph, for finding one's way around a large one. */
+export interface GraphCanvasMinimap {
+    /**
+     * The CSS colour a node is filled with in the miniature, for instance its status tone (`var(--warning)`).
+     *
+     * A colour and not a class: React Flow fills a miniature node from an inline `fill`, which wins over any class, so a
+     * `bg-*` or `fill-*` class passed for it drew every node in the default colour (#2529 review).
+     */
+    readonly nodeColor?: (node: Node) => string;
+}
 export type AI_CanvasProps = ReactFlowProps & {
     children?: React.ReactNode;
+    interaction: GraphCanvasInteraction;
+    /** Drawn in the canvas's lower right when given. */
+    minimap?: GraphCanvasMinimap;
+    /** Drawn in the canvas's lower left when given. */
+    legend?: GraphCanvasLegend;
+    /**
+     * Called with the viewport once a VIEW canvas has refitted the map BY ITSELF, after its frame changed size.
+     *
+     * A host that keeps a reader's zoom compares the viewport with where the last fit left it; a refit it did not make
+     * reads, without this, as the reader moving the map. Told where the canvas's refit left the view, the host records
+     * it as the last fit, so a reader who zooms after a resize keeps the zoom (#2529 re-review F7).
+     */
+    onRefit?: (viewport: Viewport) => void;
 };
 export declare function AI_Canvas({ preset, ...props }: AI_CanvasProps & ComponentPresetProps): React.JSX.Element;
 //# sourceMappingURL=canvas.d.ts.map

package/dist/esm/components/ai-elements/graph/canvas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ai-elements/graph/canvas.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAGnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAGvH,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG;IAC5C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B,CAAA;AAGD,wBAAgB,SAAS,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGlI"}
+{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ai-elements/graph/canvas.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAGnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AAIvH;;;;GAIG;AACH,oBAAY,sBAAsB;IAChC;;;OAGG;IACH,IAAI,SAAS;IACb,wHAAwH;IACxH,IAAI,SAAS;CACd;AAED,6CAA6C;AAC7C,oBAAY,eAAe;IACzB,6BAA6B;IAC7B,GAAG,QAAQ;IACX,6BAA6B;IAC7B,IAAI,SAAS;IACb,2CAA2C;IAC3C,WAAW,gBAAgB;CAC5B;AAED,4EAA4E;AAC5E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,2FAA2F;IAC3F,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAA;CACpD;AAED,gFAAgF;AAChF,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,CAAA;CAC5C;AAED,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG;IAC5C,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,WAAW,EAAE,sBAAsB,CAAA;IACnC,oDAAoD;IACpD,OAAO,CAAC,EAAE,kBAAkB,CAAA;IAC5B,mDAAmD;IACnD,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAA;CACvC,CAAA;AAGD,wBAAgB,SAAS,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,cAAc,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAGlI"}

package/dist/esm/components/ai-elements/graph/canvas.js

@@ -1,6 +1,32 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createComponentResolver } from '../../../core/components-registry/component-resolver.frontend.helper.js';
 import { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models';
+// --- Contract ---
+/**
+ * What a person does with a canvas. Every canvas states it, because the two need opposite defaults and getting them
+ * wrong is silent: an editor canvas shown read-only deletes a node on Backspace and rubber-band selects on drag, and
+ * each read-only surface used to undo those defaults one prop at a time (#2529).
+ */
+export var GraphCanvasInteraction;
+(function (GraphCanvasInteraction) {
+    /**
+     * Read a graph. Dragging pans, the wheel zooms, nodes can be focused and selected; nothing moves, connects or is
+     * deleted. The view refits when the canvas's frame is resized, since that is not the reader moving the map.
+     */
+    GraphCanvasInteraction["VIEW"] = "view";
+    /** Build a graph: nodes drag, handles connect, a drag selects a region, Backspace and Delete remove, the wheel pans. */
+    GraphCanvasInteraction["EDIT"] = "edit";
+})(GraphCanvasInteraction || (GraphCanvasInteraction = {}));
+/** The mark a legend entry is drawn with. */
+export var GraphLegendMark;
+(function (GraphLegendMark) {
+    /** A dot: a node's state. */
+    GraphLegendMark["DOT"] = "dot";
+    /** A solid line: an edge. */
+    GraphLegendMark["LINE"] = "line";
+    /** A dashed line: an edge drawn dashed. */
+    GraphLegendMark["DASHED_LINE"] = "dashed_line";
+})(GraphLegendMark || (GraphLegendMark = {}));
 // --- Wrapper ---
 export function AI_Canvas({ preset = CorePresetNames.DEFAULT, ...props }) {
     const Component = createComponentResolver(FrontendComponentType.LOW_LEVEL_AI_CANVAS, 'AI_Canvas')(preset);

package/dist/esm/components/ai-elements/graph/canvas.js.map

@@ -1 +1 @@
-{"version":3,"file":"canvas.js","sourceRoot":"","sources":["../../../../../../src/components/ai-elements/graph/canvas.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AACzH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAQ5F,kBAAkB;AAClB,MAAM,UAAU,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAyC;IAC7G,MAAM,SAAS,GAAG,uBAAuB,CAAiB,qBAAqB,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;IACzH,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC","sourcesContent":["import React from 'react'\nimport type { ReactFlowProps } from '@xyflow/react'\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models'\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\n\n// --- Contract ---\nexport type AI_CanvasProps = ReactFlowProps & {\n  children?: React.ReactNode\n}\n\n// --- Wrapper ---\nexport function AI_Canvas({ preset = CorePresetNames.DEFAULT, ...props }: AI_CanvasProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<AI_CanvasProps>(FrontendComponentType.LOW_LEVEL_AI_CANVAS, 'AI_Canvas')(preset)\n  return <Component {...props} />\n}\n"]}
+{"version":3,"file":"canvas.js","sourceRoot":"","sources":["../../../../../../src/components/ai-elements/graph/canvas.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AACzH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAG5F,mBAAmB;AAEnB;;;;GAIG;AACH,MAAM,CAAN,IAAY,sBAQX;AARD,WAAY,sBAAsB;IAChC;;;OAGG;IACH,uCAAa,CAAA;IACb,wHAAwH;IACxH,uCAAa,CAAA;AACf,CAAC,EARW,sBAAsB,KAAtB,sBAAsB,QAQjC;AAED,6CAA6C;AAC7C,MAAM,CAAN,IAAY,eAOX;AAPD,WAAY,eAAe;IACzB,6BAA6B;IAC7B,8BAAW,CAAA;IACX,6BAA6B;IAC7B,gCAAa,CAAA;IACb,2CAA2C;IAC3C,8CAA2B,CAAA;AAC7B,CAAC,EAPW,eAAe,KAAf,eAAe,QAO1B;AA6CD,kBAAkB;AAClB,MAAM,UAAU,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAyC;IAC7G,MAAM,SAAS,GAAG,uBAAuB,CAAiB,qBAAqB,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;IACzH,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC","sourcesContent":["import React from 'react'\nimport type { Node, ReactFlowProps, Viewport } from '@xyflow/react'\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models'\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\n\n// --- Contract ---\n\n/**\n * What a person does with a canvas. Every canvas states it, because the two need opposite defaults and getting them\n * wrong is silent: an editor canvas shown read-only deletes a node on Backspace and rubber-band selects on drag, and\n * each read-only surface used to undo those defaults one prop at a time (#2529).\n */\nexport enum GraphCanvasInteraction {\n  /**\n   * Read a graph. Dragging pans, the wheel zooms, nodes can be focused and selected; nothing moves, connects or is\n   * deleted. The view refits when the canvas's frame is resized, since that is not the reader moving the map.\n   */\n  VIEW = 'view',\n  /** Build a graph: nodes drag, handles connect, a drag selects a region, Backspace and Delete remove, the wheel pans. */\n  EDIT = 'edit',\n}\n\n/** The mark a legend entry is drawn with. */\nexport enum GraphLegendMark {\n  /** A dot: a node's state. */\n  DOT = 'dot',\n  /** A solid line: an edge. */\n  LINE = 'line',\n  /** A dashed line: an edge drawn dashed. */\n  DASHED_LINE = 'dashed_line',\n}\n\n/** One entry of a canvas legend: what a mark means, in the host's words. */\nexport interface GraphCanvasLegendEntry {\n  readonly id: string\n  readonly label: string\n  readonly mark: GraphLegendMark\n  /** The classes that colour the mark: a tone fill for a dot, a stroke colour for a line. */\n  readonly markClassName: string\n}\n\nexport interface GraphCanvasLegend {\n  /** The legend's heading, in the host's words. */\n  readonly title: string\n  readonly entries: readonly GraphCanvasLegendEntry[]\n}\n\n/** A miniature of the whole graph, for finding one's way around a large one. */\nexport interface GraphCanvasMinimap {\n  /**\n   * The CSS colour a node is filled with in the miniature, for instance its status tone (`var(--warning)`).\n   *\n   * A colour and not a class: React Flow fills a miniature node from an inline `fill`, which wins over any class, so a\n   * `bg-*` or `fill-*` class passed for it drew every node in the default colour (#2529 review).\n   */\n  readonly nodeColor?: (node: Node) => string\n}\n\nexport type AI_CanvasProps = ReactFlowProps & {\n  children?: React.ReactNode\n  interaction: GraphCanvasInteraction\n  /** Drawn in the canvas's lower right when given. */\n  minimap?: GraphCanvasMinimap\n  /** Drawn in the canvas's lower left when given. */\n  legend?: GraphCanvasLegend\n  /**\n   * Called with the viewport once a VIEW canvas has refitted the map BY ITSELF, after its frame changed size.\n   *\n   * A host that keeps a reader's zoom compares the viewport with where the last fit left it; a refit it did not make\n   * reads, without this, as the reader moving the map. Told where the canvas's refit left the view, the host records\n   * it as the last fit, so a reader who zooms after a resize keeps the zoom (#2529 re-review F7).\n   */\n  onRefit?: (viewport: Viewport) => void\n}\n\n// --- Wrapper ---\nexport function AI_Canvas({ preset = CorePresetNames.DEFAULT, ...props }: AI_CanvasProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<AI_CanvasProps>(FrontendComponentType.LOW_LEVEL_AI_CANVAS, 'AI_Canvas')(preset)\n  return <Component {...props} />\n}\n"]}

package/dist/esm/components/ai-elements/graph/node.d.ts

@@ -1,11 +1,46 @@
 import React from 'react';
 import { ComponentPresetProps } from '../../../core/components-registry/component-registry.frontend.schemas';
 import type { CardProps, CardHeaderProps, CardTitleProps, CardDescriptionProps, CardActionProps, CardContentProps, CardFooterProps } from '../../../components/sections/card';
+/**
+ * A side of a graph node. The values are React Flow's own `Position` strings, so the preset passes them straight
+ * through, while this contract, which sits in the eager graph, imports nothing from the graph library.
+ */
+export declare enum GraphNodeSide {
+    LEFT = "left",
+    RIGHT = "right",
+    TOP = "top",
+    BOTTOM = "bottom"
+}
+/** Whether an edge ENDS at a handle (target) or LEAVES from it (source). The values are React Flow's `HandleType`. */
+export declare enum GraphHandleRole {
+    TARGET = "target",
+    SOURCE = "source"
+}
+/**
+ * One point an edge attaches to.
+ *
+ * A node declares exactly the handles its edges need: a left-to-right flow wants one target on the left and one source
+ * on the right, a branch one source PER OUTGOING EDGE, and a grid all four sides. Before #2529 the node took two
+ * booleans and always put the target left and the source right, so a branch's edges all left from one point and every
+ * other arrangement had to suppress the node's handles and draw its own.
+ */
+export interface AI_NodeHandle {
+    /**
+     * The id an edge names as its `sourceHandle` / `targetHandle`. Omit it only where the node has one handle of that
+     * role: an edge naming no handle attaches to the first one.
+     */
+    readonly id?: string;
+    readonly role: GraphHandleRole;
+    readonly side: GraphNodeSide;
+    /**
+     * Where along its side the handle sits, from 0 (top or left end) to 1. When omitted, the handles of one role on one
+     * side are spread evenly along it, in the order given.
+     */
+    readonly offset?: number;
+}
 export type AI_NodeProps = CardProps & {
-    handles: {
-        target: boolean;
-        source: boolean;
-    };
+    /** Every handle the node draws; none for a node no edge touches. */
+    handles: readonly AI_NodeHandle[];
 };
 export type AI_NodeHeaderProps = CardHeaderProps;
 export type AI_NodeTitleProps = CardTitleProps;

package/dist/esm/components/ai-elements/graph/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ai-elements/graph/node.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AACvH,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,eAAe,EAChB,MAAM,8CAA8C,CAAA;AAGrD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG;IACrC,OAAO,EAAE;QACP,MAAM,EAAE,OAAO,CAAA;QACf,MAAM,EAAE,OAAO,CAAA;KAChB,CAAA;CACF,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAA;AAEhD,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAE9C,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,CAAA;AAE1D,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAA;AAEhD,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAA;AAElD,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAA;AAGhD,wBAAgB,OAAO,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG9H"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ai-elements/graph/node.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kFAAkF,CAAA;AACvH,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,eAAe,EAChB,MAAM,8CAA8C,CAAA;AAIrD;;;GAGG;AACH,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,MAAM,WAAW;CAClB;AAED,sHAAsH;AACtH,oBAAY,eAAe;IACzB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;IAC5B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG;IACrC,oEAAoE;IACpE,OAAO,EAAE,SAAS,aAAa,EAAE,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAA;AAEhD,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAA;AAE9C,MAAM,MAAM,uBAAuB,GAAG,oBAAoB,CAAA;AAE1D,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAA;AAEhD,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAA;AAElD,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAA;AAGhD,wBAAgB,OAAO,CAAC,EAAE,MAAgC,EAAE,GAAG,KAAK,EAAE,EAAE,YAAY,GAAG,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAG9H"}

package/dist/esm/components/ai-elements/graph/node.js

@@ -1,6 +1,24 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createComponentResolver } from '../../../core/components-registry/component-resolver.frontend.helper.js';
 import { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models';
+// --- Contract ---
+/**
+ * A side of a graph node. The values are React Flow's own `Position` strings, so the preset passes them straight
+ * through, while this contract, which sits in the eager graph, imports nothing from the graph library.
+ */
+export var GraphNodeSide;
+(function (GraphNodeSide) {
+    GraphNodeSide["LEFT"] = "left";
+    GraphNodeSide["RIGHT"] = "right";
+    GraphNodeSide["TOP"] = "top";
+    GraphNodeSide["BOTTOM"] = "bottom";
+})(GraphNodeSide || (GraphNodeSide = {}));
+/** Whether an edge ENDS at a handle (target) or LEAVES from it (source). The values are React Flow's `HandleType`. */
+export var GraphHandleRole;
+(function (GraphHandleRole) {
+    GraphHandleRole["TARGET"] = "target";
+    GraphHandleRole["SOURCE"] = "source";
+})(GraphHandleRole || (GraphHandleRole = {}));
 // --- Wrapper ---
 export function AI_Node({ preset = CorePresetNames.DEFAULT, ...props }) {
     const Component = createComponentResolver(FrontendComponentType.LOW_LEVEL_AI_NODE, 'AI_Node')(preset);

package/dist/esm/components/ai-elements/graph/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../../../../src/components/ai-elements/graph/node.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AACzH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAgC5F,kBAAkB;AAClB,MAAM,UAAU,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAuC;IACzG,MAAM,SAAS,GAAG,uBAAuB,CAAe,qBAAqB,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,CAAA;IACnH,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC","sourcesContent":["import React from 'react'\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models'\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\nimport type {\n  CardProps,\n  CardHeaderProps,\n  CardTitleProps,\n  CardDescriptionProps,\n  CardActionProps,\n  CardContentProps,\n  CardFooterProps,\n} from '~wildo-frontend-lib/components/sections/card'\n\n// --- Contract ---\nexport type AI_NodeProps = CardProps & {\n  handles: {\n    target: boolean\n    source: boolean\n  }\n}\n\nexport type AI_NodeHeaderProps = CardHeaderProps\n\nexport type AI_NodeTitleProps = CardTitleProps\n\nexport type AI_NodeDescriptionProps = CardDescriptionProps\n\nexport type AI_NodeActionProps = CardActionProps\n\nexport type AI_NodeContentProps = CardContentProps\n\nexport type AI_NodeFooterProps = CardFooterProps\n\n// --- Wrapper ---\nexport function AI_Node({ preset = CorePresetNames.DEFAULT, ...props }: AI_NodeProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<AI_NodeProps>(FrontendComponentType.LOW_LEVEL_AI_NODE, 'AI_Node')(preset)\n  return <Component {...props} />\n}\n"]}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../../../../src/components/ai-elements/graph/node.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iFAAiF,CAAA;AACzH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAY5F,mBAAmB;AAEnB;;;GAGG;AACH,MAAM,CAAN,IAAY,aAKX;AALD,WAAY,aAAa;IACvB,8BAAa,CAAA;IACb,gCAAe,CAAA;IACf,4BAAW,CAAA;IACX,kCAAiB,CAAA;AACnB,CAAC,EALW,aAAa,KAAb,aAAa,QAKxB;AAED,sHAAsH;AACtH,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,oCAAiB,CAAA;AACnB,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AA0CD,kBAAkB;AAClB,MAAM,UAAU,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,GAAG,KAAK,EAAuC;IACzG,MAAM,SAAS,GAAG,uBAAuB,CAAe,qBAAqB,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,CAAA;IACnH,OAAO,KAAC,SAAS,OAAK,KAAK,GAAI,CAAA;AACjC,CAAC","sourcesContent":["import React from 'react'\nimport { createComponentResolver } from '~wildo-frontend-lib/core/components-registry/component-resolver.frontend.helper'\nimport { FrontendComponentType, CorePresetNames } from '@wildo-ai/presets-components-models'\nimport { ComponentPresetProps } from '~wildo-frontend-lib/core/components-registry/component-registry.frontend.schemas'\nimport type {\n  CardProps,\n  CardHeaderProps,\n  CardTitleProps,\n  CardDescriptionProps,\n  CardActionProps,\n  CardContentProps,\n  CardFooterProps,\n} from '~wildo-frontend-lib/components/sections/card'\n\n// --- Contract ---\n\n/**\n * A side of a graph node. The values are React Flow's own `Position` strings, so the preset passes them straight\n * through, while this contract, which sits in the eager graph, imports nothing from the graph library.\n */\nexport enum GraphNodeSide {\n  LEFT = 'left',\n  RIGHT = 'right',\n  TOP = 'top',\n  BOTTOM = 'bottom',\n}\n\n/** Whether an edge ENDS at a handle (target) or LEAVES from it (source). The values are React Flow's `HandleType`. */\nexport enum GraphHandleRole {\n  TARGET = 'target',\n  SOURCE = 'source',\n}\n\n/**\n * One point an edge attaches to.\n *\n * A node declares exactly the handles its edges need: a left-to-right flow wants one target on the left and one source\n * on the right, a branch one source PER OUTGOING EDGE, and a grid all four sides. Before #2529 the node took two\n * booleans and always put the target left and the source right, so a branch's edges all left from one point and every\n * other arrangement had to suppress the node's handles and draw its own.\n */\nexport interface AI_NodeHandle {\n  /**\n   * The id an edge names as its `sourceHandle` / `targetHandle`. Omit it only where the node has one handle of that\n   * role: an edge naming no handle attaches to the first one.\n   */\n  readonly id?: string\n  readonly role: GraphHandleRole\n  readonly side: GraphNodeSide\n  /**\n   * Where along its side the handle sits, from 0 (top or left end) to 1. When omitted, the handles of one role on one\n   * side are spread evenly along it, in the order given.\n   */\n  readonly offset?: number\n}\n\nexport type AI_NodeProps = CardProps & {\n  /** Every handle the node draws; none for a node no edge touches. */\n  handles: readonly AI_NodeHandle[]\n}\n\nexport type AI_NodeHeaderProps = CardHeaderProps\n\nexport type AI_NodeTitleProps = CardTitleProps\n\nexport type AI_NodeDescriptionProps = CardDescriptionProps\n\nexport type AI_NodeActionProps = CardActionProps\n\nexport type AI_NodeContentProps = CardContentProps\n\nexport type AI_NodeFooterProps = CardFooterProps\n\n// --- Wrapper ---\nexport function AI_Node({ preset = CorePresetNames.DEFAULT, ...props }: AI_NodeProps & ComponentPresetProps): React.JSX.Element {\n  const Component = createComponentResolver<AI_NodeProps>(FrontendComponentType.LOW_LEVEL_AI_NODE, 'AI_Node')(preset)\n  return <Component {...props} />\n}\n"]}

package/dist/esm/components/app/AppLayout_AuthenticatedRoute.d.ts

@@ -24,6 +24,12 @@ interface AppLayout_AuthenticatedRouteProps {
  * {@link RouteOrganizationAccess}). This is the one layout every signed-in route
  * renders through, so resource, composite, chart, custom, flows and execution
  * routes are all covered, whatever path brought the person there.
+ *
+ * A route addressing an organization this account IS an active member of makes it the session's current
+ * organization before the page renders (see {@link RouteOrganizationFollow}, #2247), so every request and every
+ * reader of the current organization agrees with the organization the page shows. The decision is also published
+ * to the navigation zones, which hold their own entries by it (#2276): in session the page is a zone entry, and the
+ * entry is pushed before the route moves.
  */
 export declare const AppLayout_AuthenticatedRoute: React.FC<AppLayout_AuthenticatedRouteProps>;
 export {};

package/dist/esm/components/app/AppLayout_AuthenticatedRoute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppLayout_AuthenticatedRoute.d.ts","sourceRoot":"","sources":["../../../../../src/components/app/AppLayout_AuthenticatedRoute.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAwC,MAAM,OAAO,CAAC;AAqB7D,UAAU,iCAAiC;IACzC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA+CD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,4BAA4B,EAAE,KAAK,CAAC,EAAE,CAAC,iCAAiC,CAgEpF,CAAC"}
+{"version":3,"file":"AppLayout_AuthenticatedRoute.d.ts","sourceRoot":"","sources":["../../../../../src/components/app/AppLayout_AuthenticatedRoute.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAiD,MAAM,OAAO,CAAC;AA2BtE,UAAU,iCAAiC;IACzC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA+CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,4BAA4B,EAAE,KAAK,CAAC,EAAE,CAAC,iCAAiC,CAkFpF,CAAC"}