@flanksource/clicky-ui 0.3.17 → 0.3.19

package/dist/data/chat/tool-render/summary.cjs

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const ToolArgs = require("./ToolArgs.cjs");
+const shape = require("./shape.cjs");
+const SCALAR_PREVIEW_LIMIT = 60;
+function plural(count, noun) {
+  return `${count} ${noun}${count === 1 ? "" : "s"}`;
+}
+function summarizeToolValue(value) {
+  const classified = shape.classifyToolValue(value);
+  switch (classified.shape) {
+    case "paged":
+      return plural(classified.page.total ?? classified.items.length, "row");
+    case "list":
+      return plural(classified.items.length, classified.rows ? "row" : "item");
+    case "record":
+      return plural(Object.keys(classified.record).length, "field");
+    case "counts":
+      return plural(Object.keys(classified.record).length, "count");
+    case "scalar": {
+      const text = String(classified.value).replace(/\s+/g, " ").trim();
+      return text.length > SCALAR_PREVIEW_LIMIT ? `${text.slice(0, SCALAR_PREVIEW_LIMIT)}…` : text;
+    }
+    case "empty":
+      return "";
+  }
+}
+function defaultToolSummary(ctx) {
+  return react.createElement(ToolArgs.ToolArgs, { input: ctx.input });
+}
+exports.defaultToolSummary = defaultToolSummary;
+exports.summarizeToolValue = summarizeToolValue;
+//# sourceMappingURL=summary.cjs.map

package/dist/data/chat/tool-render/summary.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.cjs","sources":["../../../../src/data/chat/tool-render/summary.ts"],"sourcesContent":["// The collapsed one-line summary shown beside a tool name.\n\nimport { createElement, type ReactNode } from \"react\";\nimport type { ToolRenderAdapterContext } from \"./adapter\";\nimport { ToolArgs } from \"./ToolArgs\";\nimport { classifyToolValue } from \"./shape\";\n\nconst SCALAR_PREVIEW_LIMIT = 60;\n\nfunction plural(count: number, noun: string): string {\n  return `${count} ${noun}${count === 1 ? \"\" : \"s\"}`;\n}\n\n/** A short description of a normalized tool result: \"12 rows\", \"3 fields\", or a\n *  truncated scalar. Empty when there is nothing worth saying. */\nexport function summarizeToolValue(value: unknown): string {\n  const classified = classifyToolValue(value);\n  switch (classified.shape) {\n    case \"paged\":\n      return plural(classified.page.total ?? classified.items.length, \"row\");\n    case \"list\":\n      return plural(classified.items.length, classified.rows ? \"row\" : \"item\");\n    case \"record\":\n      return plural(Object.keys(classified.record).length, \"field\");\n    case \"counts\":\n      return plural(Object.keys(classified.record).length, \"count\");\n    case \"scalar\": {\n      const text = String(classified.value).replace(/\\s+/g, \" \").trim();\n      return text.length > SCALAR_PREVIEW_LIMIT\n        ? `${text.slice(0, SCALAR_PREVIEW_LIMIT)}…`\n        : text;\n    }\n    case \"empty\":\n      return \"\";\n  }\n}\n\n/** Built-in collapsed summary: compact input arguments with muted keys. */\nexport function defaultToolSummary(ctx: ToolRenderAdapterContext): ReactNode {\n  return createElement(ToolArgs, { input: ctx.input });\n}\n"],"names":["classifyToolValue","createElement","ToolArgs"],"mappings":";;;;;AAOA,MAAM,uBAAuB;AAE7B,SAAS,OAAO,OAAe,MAAsB;AACnD,SAAO,GAAG,KAAK,IAAI,IAAI,GAAG,UAAU,IAAI,KAAK,GAAG;AAClD;AAIO,SAAS,mBAAmB,OAAwB;AACzD,QAAM,aAAaA,MAAAA,kBAAkB,KAAK;AAC1C,UAAQ,WAAW,OAAA;AAAA,IACjB,KAAK;AACH,aAAO,OAAO,WAAW,KAAK,SAAS,WAAW,MAAM,QAAQ,KAAK;AAAA,IACvE,KAAK;AACH,aAAO,OAAO,WAAW,MAAM,QAAQ,WAAW,OAAO,QAAQ,MAAM;AAAA,IACzE,KAAK;AACH,aAAO,OAAO,OAAO,KAAK,WAAW,MAAM,EAAE,QAAQ,OAAO;AAAA,IAC9D,KAAK;AACH,aAAO,OAAO,OAAO,KAAK,WAAW,MAAM,EAAE,QAAQ,OAAO;AAAA,IAC9D,KAAK,UAAU;AACb,YAAM,OAAO,OAAO,WAAW,KAAK,EAAE,QAAQ,QAAQ,GAAG,EAAE,KAAA;AAC3D,aAAO,KAAK,SAAS,uBACjB,GAAG,KAAK,MAAM,GAAG,oBAAoB,CAAC,MACtC;AAAA,IACN;AAAA,IACA,KAAK;AACH,aAAO;AAAA,EAAA;AAEb;AAGO,SAAS,mBAAmB,KAA0C;AAC3E,SAAOC,MAAAA,cAAcC,SAAAA,UAAU,EAAE,OAAO,IAAI,OAAO;AACrD;;;"}

package/dist/data/chat/tool-render/summary.d.ts

@@ -0,0 +1,8 @@
+import { ReactNode } from 'react';
+import { ToolRenderAdapterContext } from './adapter';
+/** A short description of a normalized tool result: "12 rows", "3 fields", or a
+ *  truncated scalar. Empty when there is nothing worth saying. */
+export declare function summarizeToolValue(value: unknown): string;
+/** Built-in collapsed summary: compact input arguments with muted keys. */
+export declare function defaultToolSummary(ctx: ToolRenderAdapterContext): ReactNode;
+//# sourceMappingURL=summary.d.ts.map

package/dist/data/chat/tool-render/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../../../src/data/chat/tool-render/summary.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAU1D;kEACkE;AAClE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAoBzD;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,wBAAwB,GAAG,SAAS,CAE3E"}

package/dist/data/chat/tool-render/summary.js

@@ -0,0 +1,34 @@
+import { createElement } from "react";
+import { ToolArgs } from "./ToolArgs.js";
+import { classifyToolValue } from "./shape.js";
+const SCALAR_PREVIEW_LIMIT = 60;
+function plural(count, noun) {
+  return `${count} ${noun}${count === 1 ? "" : "s"}`;
+}
+function summarizeToolValue(value) {
+  const classified = classifyToolValue(value);
+  switch (classified.shape) {
+    case "paged":
+      return plural(classified.page.total ?? classified.items.length, "row");
+    case "list":
+      return plural(classified.items.length, classified.rows ? "row" : "item");
+    case "record":
+      return plural(Object.keys(classified.record).length, "field");
+    case "counts":
+      return plural(Object.keys(classified.record).length, "count");
+    case "scalar": {
+      const text = String(classified.value).replace(/\s+/g, " ").trim();
+      return text.length > SCALAR_PREVIEW_LIMIT ? `${text.slice(0, SCALAR_PREVIEW_LIMIT)}…` : text;
+    }
+    case "empty":
+      return "";
+  }
+}
+function defaultToolSummary(ctx) {
+  return createElement(ToolArgs, { input: ctx.input });
+}
+export {
+  defaultToolSummary,
+  summarizeToolValue
+};
+//# sourceMappingURL=summary.js.map

package/dist/data/chat/tool-render/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sources":["../../../../src/data/chat/tool-render/summary.ts"],"sourcesContent":["// The collapsed one-line summary shown beside a tool name.\n\nimport { createElement, type ReactNode } from \"react\";\nimport type { ToolRenderAdapterContext } from \"./adapter\";\nimport { ToolArgs } from \"./ToolArgs\";\nimport { classifyToolValue } from \"./shape\";\n\nconst SCALAR_PREVIEW_LIMIT = 60;\n\nfunction plural(count: number, noun: string): string {\n  return `${count} ${noun}${count === 1 ? \"\" : \"s\"}`;\n}\n\n/** A short description of a normalized tool result: \"12 rows\", \"3 fields\", or a\n *  truncated scalar. Empty when there is nothing worth saying. */\nexport function summarizeToolValue(value: unknown): string {\n  const classified = classifyToolValue(value);\n  switch (classified.shape) {\n    case \"paged\":\n      return plural(classified.page.total ?? classified.items.length, \"row\");\n    case \"list\":\n      return plural(classified.items.length, classified.rows ? \"row\" : \"item\");\n    case \"record\":\n      return plural(Object.keys(classified.record).length, \"field\");\n    case \"counts\":\n      return plural(Object.keys(classified.record).length, \"count\");\n    case \"scalar\": {\n      const text = String(classified.value).replace(/\\s+/g, \" \").trim();\n      return text.length > SCALAR_PREVIEW_LIMIT\n        ? `${text.slice(0, SCALAR_PREVIEW_LIMIT)}…`\n        : text;\n    }\n    case \"empty\":\n      return \"\";\n  }\n}\n\n/** Built-in collapsed summary: compact input arguments with muted keys. */\nexport function defaultToolSummary(ctx: ToolRenderAdapterContext): ReactNode {\n  return createElement(ToolArgs, { input: ctx.input });\n}\n"],"names":[],"mappings":";;;AAOA,MAAM,uBAAuB;AAE7B,SAAS,OAAO,OAAe,MAAsB;AACnD,SAAO,GAAG,KAAK,IAAI,IAAI,GAAG,UAAU,IAAI,KAAK,GAAG;AAClD;AAIO,SAAS,mBAAmB,OAAwB;AACzD,QAAM,aAAa,kBAAkB,KAAK;AAC1C,UAAQ,WAAW,OAAA;AAAA,IACjB,KAAK;AACH,aAAO,OAAO,WAAW,KAAK,SAAS,WAAW,MAAM,QAAQ,KAAK;AAAA,IACvE,KAAK;AACH,aAAO,OAAO,WAAW,MAAM,QAAQ,WAAW,OAAO,QAAQ,MAAM;AAAA,IACzE,KAAK;AACH,aAAO,OAAO,OAAO,KAAK,WAAW,MAAM,EAAE,QAAQ,OAAO;AAAA,IAC9D,KAAK;AACH,aAAO,OAAO,OAAO,KAAK,WAAW,MAAM,EAAE,QAAQ,OAAO;AAAA,IAC9D,KAAK,UAAU;AACb,YAAM,OAAO,OAAO,WAAW,KAAK,EAAE,QAAQ,QAAQ,GAAG,EAAE,KAAA;AAC3D,aAAO,KAAK,SAAS,uBACjB,GAAG,KAAK,MAAM,GAAG,oBAAoB,CAAC,MACtC;AAAA,IACN;AAAA,IACA,KAAK;AACH,aAAO;AAAA,EAAA;AAEb;AAGO,SAAS,mBAAmB,KAA0C;AAC3E,SAAO,cAAc,UAAU,EAAE,OAAO,IAAI,OAAO;AACrD;"}

package/dist/data/chat/types.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.cjs","sources":["../../../src/data/chat/types.ts"],"sourcesContent":["import type {\n  UIMessage,\n  ToolUIPart,\n  DynamicToolUIPart,\n  ChatStatus,\n  ReasoningUIPart,\n  FileUIPart,\n} from \"ai\";\nimport type { ReactNode } from \"react\";\nimport type {\n  JsonSchemaObject,\n  JsonSchemaProperty as FormJsonSchemaProperty,\n} from \"../../components/json-schema-form-types\";\n\nexport type {\n  UIMessage,\n  ToolUIPart,\n  DynamicToolUIPart,\n  ChatStatus,\n  ReasoningUIPart,\n  FileUIPart,\n};\n\n/** A selectable chat model, as served by the backend's GET /api/chat/models.\n *  `configured` is false for catalogued models whose provider has no API key. */\nexport interface ChatModelRuntime {\n  model?: string;\n  id?: string;\n  backend?: string;\n  mode?: string;\n  temperature?: number;\n  effort?: string;\n  noCache?: boolean;\n  fallbacks?: ChatModelRuntime[];\n}\n\nexport interface ChatModel {\n  id: string;\n  provider: string;\n  label: string;\n  /** Exact Captain Model wire value submitted when this display row is selected. */\n  runtime?: ChatModelRuntime;\n  reasoning: boolean;\n  /** True when backend metadata is authoritative, including explicit unsupported values. */\n  capabilitiesKnown?: boolean;\n  /** Ordered reasoning-effort tiers accepted by this exact model. */\n  supportedEfforts?: string[];\n  /** Backend-recommended effort used when the current selection is invalid. */\n  defaultEffort?: string;\n  /** Whether the model honours the temperature sampling control. */\n  temperature?: boolean;\n  configured?: boolean;\n  /**\n   * The catalog's own declared default — the row a picker seeds with when the\n   * caller names no model. At most one row carries it, and a catalog that\n   * declares none (or whose default is unconfigured) falls back to the first\n   * configured row.\n   */\n  default?: boolean;\n  /** Concrete runtime backends that advertised this model. Empty/omitted means provider-wide. */\n  backends?: string[];\n  /** Max context tokens — the denominator for a usage gauge. */\n  contextWindow?: number;\n  /** MIME patterns accepted as model inputs, e.g. image/* or application/pdf. */\n  inputMediaTypes?: string[];\n}\n\n/** Per-message metadata the backend rides on the SSE `finish` part\n *  (`messageMetadata`), applied by the AI SDK to the assistant `UIMessage`. */\nexport interface ChatMessageMetadata {\n  usage?: ChatUsageBreakdown;\n  costBreakdown?: ChatCostBreakdown;\n  /** This turn's cost in USD. */\n  cost?: number;\n  /** Cumulative thread cost in USD (when the turn is persisted to a thread). */\n  threadCostUsd?: number;\n  /** This turn's input-token count, ≈ current context-window occupancy. */\n  contextTokens?: number;\n}\n\n/** A flattened usage snapshot a chat surfaces for a gauge: tokens used out of the\n *  model's context window, plus cumulative cost. */\nexport interface ChatUsageSummary {\n  usedTokens: number;\n  maxTokens: number;\n  cost?: number;\n  usage?: ChatUsageBreakdown;\n  costBreakdown?: ChatCostBreakdown;\n  messageCount: number;\n  modelLabel?: string;\n}\n\nexport interface ChatBudgetConfig {\n  /** Per-thread/request cost cap in USD. */\n  cost?: number;\n  /** Max output tokens for one model call. */\n  maxTokens?: number;\n}\n\nexport interface ChatUsageBreakdown {\n  inputTokens?: number;\n  outputTokens?: number;\n  reasoningTokens?: number;\n  cacheReadTokens?: number;\n  cacheWriteTokens?: number;\n  totalTokens?: number;\n}\n\nexport interface ChatCostBreakdown {\n  model?: string;\n  inputUsd?: number;\n  outputUsd?: number;\n  reasoningUsd?: number;\n  cacheReadUsd?: number;\n  cacheWriteUsd?: number;\n  totalUsd?: number;\n}\n\n/** A suggested prompt shown on the empty state. A bare string is both the label\n *  and the submitted text; the object form separates them. */\nexport type Suggestion = string | { label: string; prompt: string };\n\n/** The label shown for a suggestion. */\nexport function suggestionLabel(s: Suggestion): string {\n  return typeof s === \"string\" ? s : s.label;\n}\n\n/** The text submitted when a suggestion is clicked. */\nexport function suggestionPrompt(s: Suggestion): string {\n  return typeof s === \"string\" ? s : s.prompt;\n}\n\n/** Returns true for an assistant reasoning (\"thinking\") part. */\nexport function isReasoningPart(part: {\n  type: string;\n}): part is ReasoningUIPart {\n  return part.type === \"reasoning\";\n}\n\n/** Returns true for a file/attachment part. */\nexport function isFilePart(part: { type: string }): part is FileUIPart {\n  return part.type === \"file\";\n}\n\n/** A tool part as it appears in an assistant UIMessage — either a typed\n *  `tool-<name>` part or the generic `dynamic-tool` part. clicky operations\n *  surface as dynamic tools, so the chat UI renders both shapes. */\nexport type AnyToolPart = ToolUIPart | DynamicToolUIPart;\n\n/** Claude Agent SDK permission modes accepted by `permissionMode`. */\nexport const CLAUDE_PERMISSION_MODES = [\n  \"default\",\n  \"acceptEdits\",\n  \"bypassPermissions\",\n  \"plan\",\n  \"dontAsk\",\n  \"auto\",\n] as const;\n\nexport type ClaudePermissionMode = (typeof CLAUDE_PERMISSION_MODES)[number];\n\nexport type ClaudePermissionModeOption = {\n  value: ClaudePermissionMode;\n  label: string;\n  description: string;\n};\n\nexport const CLAUDE_PERMISSION_MODE_OPTIONS: ClaudePermissionModeOption[] = [\n  {\n    value: \"default\",\n    label: \"Default\",\n    description:\n      \"Prompt for dangerous operations using standard Claude behavior.\",\n  },\n  {\n    value: \"auto\",\n    label: \"Auto\",\n    description:\n      \"Use Claude's classifier to approve or deny permission prompts.\",\n  },\n  {\n    value: \"acceptEdits\",\n    label: \"Accept edits\",\n    description: \"Automatically accept file edit operations.\",\n  },\n  {\n    value: \"dontAsk\",\n    label: \"Don't ask\",\n    description: \"Do not prompt; deny actions that are not pre-approved.\",\n  },\n  {\n    value: \"plan\",\n    label: \"Plan\",\n    description: \"Planning mode with no tool execution.\",\n  },\n  {\n    value: \"bypassPermissions\",\n    label: \"Bypass\",\n    description:\n      \"Bypass permission checks when explicitly allowed by the host.\",\n  },\n];\n\n/** Tool metadata shared by the chat shell. It both configures the\n *  tool-preferences popover (`name`/`label`/`group`) and carries the schema\n *  derived from a clicky RPC operation (`description`/`inputSchema`). The Go\n *  backend owns execution; the client uses this only for display and to scope\n *  which tools a request may call (passed in the transport `body`). */\nexport type ToolMode = \"on\" | \"ask\" | \"off\" | \"auto\";\n\nexport interface ToolAnnotations {\n  title?: string;\n  readOnlyHint?: boolean;\n  destructiveHint?: boolean;\n  idempotentHint?: boolean;\n  openWorldHint?: boolean;\n  [key: string]: unknown;\n}\n\nexport interface ToolMeta {\n  /** Stable tool name sent to the model (the operation id). */\n  name: string;\n  /** Human-readable label shown in the tool-preferences popover. */\n  label: string;\n  /** Bucket heading in the popover — the clicky surface for RPC operations. */\n  group?: string;\n  /** Display title of the tool's parent surface/entity (e.g. \"Xero Accounts\").\n   *  Used to nest tools under their entity within a group, and as the\n   *  disambiguating prefix in flat lists so sibling verbs (\"List\", \"Get\") stay\n   *  distinguishable. Resolved from the operation's `x-clicky.surface`. */\n  parent?: string;\n  /** Raw entity name of the tool's surface (e.g. \"accounts\"), when known. */\n  entity?: string;\n  /** Preference key sent to the backend. Defaults to `name`; group-backed\n   *  clicky tools set this to the backend tool group. */\n  preferenceKey?: string;\n  /** Initial backend-owned permission when the chat window first sees this tool. */\n  defaultPermission?: ToolMode;\n  /** Opaque icon name emitted by the backend, resolved by the host UI. */\n  icon?: string;\n  /** Description shown in tool pickers / tool-call headers. */\n  description?: string;\n  /** Short usage hints shown in the tool browser. */\n  hints?: string[];\n  source?: \"clicky\" | \"custom\" | \"mcp\" | string;\n  server?: string;\n  method?: string;\n  path?: string;\n  operationName?: string;\n  title?: string;\n  /** Whether the runtime should treat the tool input schema as strict/closed. */\n  strict?: boolean;\n  /** Runtime tool annotations/hints, e.g. MCP/Genkit well-known hints. */\n  annotations?: ToolAnnotations;\n  /** JSON-Schema for the tool's input, assembled from an operation's\n   *  parameters + request body. Omitted for hand-authored tools. */\n  inputSchema?: ChatToolInputSchema;\n  outputSchema?: ChatToolInputSchema;\n}\n\nexport type ChatToolInputSchema = JsonSchemaObject;\nexport type JsonSchemaProperty = FormJsonSchemaProperty;\nexport type JSONSchemaProperty = FormJsonSchemaProperty;\n\n/** Returns true for a `dynamic-tool` part (clicky operations surface this way). */\nexport function isDynamicToolPart(part: {\n  type: string;\n}): part is DynamicToolUIPart {\n  return part.type === \"dynamic-tool\";\n}\n\n/** Returns true for a typed `tool-<name>` part. */\nexport function isTypedToolPart(part: { type: string }): part is ToolUIPart {\n  return part.type.startsWith(\"tool-\");\n}\n\n/** The display name of a tool part: the explicit `toolName` for dynamic tools,\n *  otherwise the suffix after `tool-`. */\nexport function toolPartName(part: AnyToolPart): string {\n  if (isDynamicToolPart(part)) {\n    return part.toolName;\n  }\n  return part.type.slice(\"tool-\".length);\n}\n\nexport interface ToolResultRenderArgs {\n  part: AnyToolPart;\n  toolName: string;\n  output: unknown;\n}\n\nexport type ToolResultRenderer = (args: ToolResultRenderArgs) => ReactNode;\n"],"names":[],"mappings":";;AA2HO,SAAS,gBAAgB,GAAuB;AACrD,SAAO,OAAO,MAAM,WAAW,IAAI,EAAE;AACvC;AAGO,SAAS,iBAAiB,GAAuB;AACtD,SAAO,OAAO,MAAM,WAAW,IAAI,EAAE;AACvC;AAGO,SAAS,gBAAgB,MAEJ;AAC1B,SAAO,KAAK,SAAS;AACvB;AAGO,SAAS,WAAW,MAA4C;AACrE,SAAO,KAAK,SAAS;AACvB;AAQO,MAAM,0BAA0B;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAUO,MAAM,iCAA+D;AAAA,EAC1E;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aACE;AAAA,EAAA;AAAA,EAEJ;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aACE;AAAA,EAAA;AAAA,EAEJ;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,EAAA;AAAA,EAEf;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,EAAA;AAAA,EAEf;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,EAAA;AAAA,EAEf;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aACE;AAAA,EAAA;AAEN;AAgEO,SAAS,kBAAkB,MAEJ;AAC5B,SAAO,KAAK,SAAS;AACvB;AAGO,SAAS,gBAAgB,MAA4C;AAC1E,SAAO,KAAK,KAAK,WAAW,OAAO;AACrC;AAIO,SAAS,aAAa,MAA2B;AACtD,MAAI,kBAAkB,IAAI,GAAG;AAC3B,WAAO,KAAK;AAAA,EACd;AACA,SAAO,KAAK,KAAK,MAAM,QAAQ,MAAM;AACvC;;;;;;;;;;"}
+{"version":3,"file":"types.cjs","sources":["../../../src/data/chat/types.ts"],"sourcesContent":["import type {\n  UIMessage,\n  ToolUIPart,\n  DynamicToolUIPart,\n  ChatStatus,\n  ReasoningUIPart,\n  FileUIPart,\n} from \"ai\";\nimport type { ReactNode } from \"react\";\nimport type {\n  JsonSchemaObject,\n  JsonSchemaProperty as FormJsonSchemaProperty,\n} from \"../../components/json-schema-form-types\";\n\nexport type {\n  UIMessage,\n  ToolUIPart,\n  DynamicToolUIPart,\n  ChatStatus,\n  ReasoningUIPart,\n  FileUIPart,\n};\n\n/** A selectable chat model, as served by the backend's GET /api/chat/models.\n *  `configured` is false for catalogued models whose provider has no API key. */\nexport interface ChatModelRuntime {\n  model?: string;\n  id?: string;\n  backend?: string;\n  mode?: string;\n  temperature?: number;\n  effort?: string;\n  noCache?: boolean;\n  fallbacks?: ChatModelRuntime[];\n}\n\nexport type RuntimeAvailabilityState =\n  | \"available\"\n  | \"disabled\"\n  | \"missing_credentials\"\n  | \"not_authenticated\"\n  | \"missing_executable\"\n  | \"missing_dependency\"\n  | \"unsupported\"\n  | \"unavailable\";\n\nexport interface RuntimeAvailability {\n  state: RuntimeAvailabilityState;\n  reason?: string;\n  remediation?: string;\n}\n\nexport interface ChatModel {\n  id: string;\n  provider: string;\n  label: string;\n  /** Exact Captain Model wire value submitted when this display row is selected. */\n  runtime?: ChatModelRuntime;\n  reasoning: boolean;\n  /** True when backend metadata is authoritative, including explicit unsupported values. */\n  capabilitiesKnown?: boolean;\n  /** Ordered reasoning-effort tiers accepted by this exact model. */\n  supportedEfforts?: string[];\n  /** Backend-recommended effort used when the current selection is invalid. */\n  defaultEffort?: string;\n  /** Whether the model honours the temperature sampling control. */\n  temperature?: boolean;\n  configured?: boolean;\n  availability?: RuntimeAvailability;\n  /**\n   * The catalog's own declared default — the row a picker seeds with when the\n   * caller names no model. At most one row carries it, and a catalog that\n   * declares none (or whose default is unconfigured) falls back to the first\n   * configured row.\n   */\n  default?: boolean;\n  /** Concrete runtime backends that advertised this model. Empty/omitted means provider-wide. */\n  backends?: string[];\n  /** Max context tokens — the denominator for a usage gauge. */\n  contextWindow?: number;\n  /** MIME patterns accepted as model inputs, e.g. image/* or application/pdf. */\n  inputMediaTypes?: string[];\n}\n\n/** Per-message metadata the backend rides on the SSE `finish` part\n *  (`messageMetadata`), applied by the AI SDK to the assistant `UIMessage`. */\nexport interface ChatMessageMetadata {\n  usage?: ChatUsageBreakdown;\n  costBreakdown?: ChatCostBreakdown;\n  /** This turn's cost in USD. */\n  cost?: number;\n  /** Cumulative thread cost in USD (when the turn is persisted to a thread). */\n  threadCostUsd?: number;\n  /** This turn's input-token count, ≈ current context-window occupancy. */\n  contextTokens?: number;\n}\n\n/** A flattened usage snapshot a chat surfaces for a gauge: tokens used out of the\n *  model's context window, plus cumulative cost. */\nexport interface ChatUsageSummary {\n  usedTokens: number;\n  maxTokens: number;\n  cost?: number;\n  usage?: ChatUsageBreakdown;\n  costBreakdown?: ChatCostBreakdown;\n  messageCount: number;\n  modelLabel?: string;\n}\n\nexport interface ChatBudgetConfig {\n  /** Per-thread/request cost cap in USD. */\n  cost?: number;\n  /** Max output tokens for one model call. */\n  maxTokens?: number;\n}\n\nexport interface ChatUsageBreakdown {\n  inputTokens?: number;\n  outputTokens?: number;\n  reasoningTokens?: number;\n  cacheReadTokens?: number;\n  cacheWriteTokens?: number;\n  totalTokens?: number;\n}\n\nexport interface ChatCostBreakdown {\n  model?: string;\n  inputUsd?: number;\n  outputUsd?: number;\n  reasoningUsd?: number;\n  cacheReadUsd?: number;\n  cacheWriteUsd?: number;\n  totalUsd?: number;\n}\n\n/** A suggested prompt shown on the empty state. A bare string is both the label\n *  and the submitted text; the object form separates them. */\nexport type Suggestion = string | { label: string; prompt: string };\n\n/** The label shown for a suggestion. */\nexport function suggestionLabel(s: Suggestion): string {\n  return typeof s === \"string\" ? s : s.label;\n}\n\n/** The text submitted when a suggestion is clicked. */\nexport function suggestionPrompt(s: Suggestion): string {\n  return typeof s === \"string\" ? s : s.prompt;\n}\n\n/** Returns true for an assistant reasoning (\"thinking\") part. */\nexport function isReasoningPart(part: {\n  type: string;\n}): part is ReasoningUIPart {\n  return part.type === \"reasoning\";\n}\n\n/** Returns true for a file/attachment part. */\nexport function isFilePart(part: { type: string }): part is FileUIPart {\n  return part.type === \"file\";\n}\n\n/** A tool part as it appears in an assistant UIMessage — either a typed\n *  `tool-<name>` part or the generic `dynamic-tool` part. clicky operations\n *  surface as dynamic tools, so the chat UI renders both shapes. */\nexport type AnyToolPart = ToolUIPart | DynamicToolUIPart;\n\n/** Claude Agent SDK permission modes accepted by `permissionMode`. */\nexport const CLAUDE_PERMISSION_MODES = [\n  \"default\",\n  \"acceptEdits\",\n  \"bypassPermissions\",\n  \"plan\",\n  \"dontAsk\",\n  \"auto\",\n] as const;\n\nexport type ClaudePermissionMode = (typeof CLAUDE_PERMISSION_MODES)[number];\n\nexport type ClaudePermissionModeOption = {\n  value: ClaudePermissionMode;\n  label: string;\n  description: string;\n};\n\nexport const CLAUDE_PERMISSION_MODE_OPTIONS: ClaudePermissionModeOption[] = [\n  {\n    value: \"default\",\n    label: \"Default\",\n    description:\n      \"Prompt for dangerous operations using standard Claude behavior.\",\n  },\n  {\n    value: \"auto\",\n    label: \"Auto\",\n    description:\n      \"Use Claude's classifier to approve or deny permission prompts.\",\n  },\n  {\n    value: \"acceptEdits\",\n    label: \"Accept edits\",\n    description: \"Automatically accept file edit operations.\",\n  },\n  {\n    value: \"dontAsk\",\n    label: \"Don't ask\",\n    description: \"Do not prompt; deny actions that are not pre-approved.\",\n  },\n  {\n    value: \"plan\",\n    label: \"Plan\",\n    description: \"Planning mode with no tool execution.\",\n  },\n  {\n    value: \"bypassPermissions\",\n    label: \"Bypass\",\n    description:\n      \"Bypass permission checks when explicitly allowed by the host.\",\n  },\n];\n\n/** Tool metadata shared by the chat shell. It both configures the\n *  tool-preferences popover (`name`/`label`/`group`) and carries the schema\n *  derived from a clicky RPC operation (`description`/`inputSchema`). The Go\n *  backend owns execution; the client uses this only for display and to scope\n *  which tools a request may call (passed in the transport `body`). */\nexport type ToolMode = \"on\" | \"ask\" | \"off\" | \"auto\";\n\nexport interface ToolAnnotations {\n  title?: string;\n  readOnlyHint?: boolean;\n  destructiveHint?: boolean;\n  idempotentHint?: boolean;\n  openWorldHint?: boolean;\n  [key: string]: unknown;\n}\n\nexport interface ToolMeta {\n  /** Stable tool name sent to the model (the operation id). */\n  name: string;\n  /** Human-readable label shown in the tool-preferences popover. */\n  label: string;\n  /** Bucket heading in the popover — the clicky surface for RPC operations. */\n  group?: string;\n  /** Display title of the tool's parent surface/entity (e.g. \"Xero Accounts\").\n   *  Used to nest tools under their entity within a group, and as the\n   *  disambiguating prefix in flat lists so sibling verbs (\"List\", \"Get\") stay\n   *  distinguishable. Resolved from the operation's `x-clicky.surface`. */\n  parent?: string;\n  /** Raw entity name of the tool's surface (e.g. \"accounts\"), when known. */\n  entity?: string;\n  /** Preference key sent to the backend. Defaults to `name`; group-backed\n   *  clicky tools set this to the backend tool group. */\n  preferenceKey?: string;\n  /** Initial backend-owned permission when the chat window first sees this tool. */\n  defaultPermission?: ToolMode;\n  /** Opaque icon name emitted by the backend, resolved by the host UI. */\n  icon?: string;\n  /** Description shown in tool pickers / tool-call headers. */\n  description?: string;\n  /** Short usage hints shown in the tool browser. */\n  hints?: string[];\n  source?: \"clicky\" | \"custom\" | \"mcp\" | string;\n  server?: string;\n  method?: string;\n  path?: string;\n  operationName?: string;\n  title?: string;\n  /** Whether the runtime should treat the tool input schema as strict/closed. */\n  strict?: boolean;\n  /** Runtime tool annotations/hints, e.g. MCP/Genkit well-known hints. */\n  annotations?: ToolAnnotations;\n  /** JSON-Schema for the tool's input, assembled from an operation's\n   *  parameters + request body. Omitted for hand-authored tools. */\n  inputSchema?: ChatToolInputSchema;\n  outputSchema?: ChatToolInputSchema;\n}\n\nexport type ChatToolInputSchema = JsonSchemaObject;\nexport type JsonSchemaProperty = FormJsonSchemaProperty;\nexport type JSONSchemaProperty = FormJsonSchemaProperty;\n\n/** Returns true for a `dynamic-tool` part (clicky operations surface this way). */\nexport function isDynamicToolPart(part: {\n  type: string;\n}): part is DynamicToolUIPart {\n  return part.type === \"dynamic-tool\";\n}\n\n/** Returns true for a typed `tool-<name>` part. */\nexport function isTypedToolPart(part: { type: string }): part is ToolUIPart {\n  return part.type.startsWith(\"tool-\");\n}\n\n/** The display name of a tool part: the explicit `toolName` for dynamic tools,\n *  otherwise the suffix after `tool-`. */\nexport function toolPartName(part: AnyToolPart): string {\n  if (isDynamicToolPart(part)) {\n    return part.toolName;\n  }\n  return part.type.slice(\"tool-\".length);\n}\n\nexport interface ToolResultRenderArgs {\n  part: AnyToolPart;\n  toolName: string;\n  output: unknown;\n}\n\nexport type ToolResultRenderer = (args: ToolResultRenderArgs) => ReactNode;\n"],"names":[],"mappings":";;AA4IO,SAAS,gBAAgB,GAAuB;AACrD,SAAO,OAAO,MAAM,WAAW,IAAI,EAAE;AACvC;AAGO,SAAS,iBAAiB,GAAuB;AACtD,SAAO,OAAO,MAAM,WAAW,IAAI,EAAE;AACvC;AAGO,SAAS,gBAAgB,MAEJ;AAC1B,SAAO,KAAK,SAAS;AACvB;AAGO,SAAS,WAAW,MAA4C;AACrE,SAAO,KAAK,SAAS;AACvB;AAQO,MAAM,0BAA0B;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAUO,MAAM,iCAA+D;AAAA,EAC1E;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aACE;AAAA,EAAA;AAAA,EAEJ;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aACE;AAAA,EAAA;AAAA,EAEJ;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,EAAA;AAAA,EAEf;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,EAAA;AAAA,EAEf;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,EAAA;AAAA,EAEf;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aACE;AAAA,EAAA;AAEN;AAgEO,SAAS,kBAAkB,MAEJ;AAC5B,SAAO,KAAK,SAAS;AACvB;AAGO,SAAS,gBAAgB,MAA4C;AAC1E,SAAO,KAAK,KAAK,WAAW,OAAO;AACrC;AAIO,SAAS,aAAa,MAA2B;AACtD,MAAI,kBAAkB,IAAI,GAAG;AAC3B,WAAO,KAAK;AAAA,EACd;AACA,SAAO,KAAK,KAAK,MAAM,QAAQ,MAAM;AACvC;;;;;;;;;;"}

package/dist/data/chat/types.d.ts

@@ -14,6 +14,12 @@ export interface ChatModelRuntime {
     noCache?: boolean;
     fallbacks?: ChatModelRuntime[];
 }
+export type RuntimeAvailabilityState = "available" | "disabled" | "missing_credentials" | "not_authenticated" | "missing_executable" | "missing_dependency" | "unsupported" | "unavailable";
+export interface RuntimeAvailability {
+    state: RuntimeAvailabilityState;
+    reason?: string;
+    remediation?: string;
+}
 export interface ChatModel {
     id: string;
     provider: string;
@@ -30,6 +36,7 @@ export interface ChatModel {
     /** Whether the model honours the temperature sampling control. */
     temperature?: boolean;
     configured?: boolean;
+    availability?: RuntimeAvailability;
     /**
      * The catalog's own declared default — the row a picker seeds with when the
      * caller names no model. At most one row carries it, and a catalog that

package/dist/data/chat/types.d.ts.map

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

package/dist/data/chat/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../../src/data/chat/types.ts"],"sourcesContent":["import type {\n  UIMessage,\n  ToolUIPart,\n  DynamicToolUIPart,\n  ChatStatus,\n  ReasoningUIPart,\n  FileUIPart,\n} from \"ai\";\nimport type { ReactNode } from \"react\";\nimport type {\n  JsonSchemaObject,\n  JsonSchemaProperty as FormJsonSchemaProperty,\n} from \"../../components/json-schema-form-types\";\n\nexport type {\n  UIMessage,\n  ToolUIPart,\n  DynamicToolUIPart,\n  ChatStatus,\n  ReasoningUIPart,\n  FileUIPart,\n};\n\n/** A selectable chat model, as served by the backend's GET /api/chat/models.\n *  `configured` is false for catalogued models whose provider has no API key. */\nexport interface ChatModelRuntime {\n  model?: string;\n  id?: string;\n  backend?: string;\n  mode?: string;\n  temperature?: number;\n  effort?: string;\n  noCache?: boolean;\n  fallbacks?: ChatModelRuntime[];\n}\n\nexport interface ChatModel {\n  id: string;\n  provider: string;\n  label: string;\n  /** Exact Captain Model wire value submitted when this display row is selected. */\n  runtime?: ChatModelRuntime;\n  reasoning: boolean;\n  /** True when backend metadata is authoritative, including explicit unsupported values. */\n  capabilitiesKnown?: boolean;\n  /** Ordered reasoning-effort tiers accepted by this exact model. */\n  supportedEfforts?: string[];\n  /** Backend-recommended effort used when the current selection is invalid. */\n  defaultEffort?: string;\n  /** Whether the model honours the temperature sampling control. */\n  temperature?: boolean;\n  configured?: boolean;\n  /**\n   * The catalog's own declared default — the row a picker seeds with when the\n   * caller names no model. At most one row carries it, and a catalog that\n   * declares none (or whose default is unconfigured) falls back to the first\n   * configured row.\n   */\n  default?: boolean;\n  /** Concrete runtime backends that advertised this model. Empty/omitted means provider-wide. */\n  backends?: string[];\n  /** Max context tokens — the denominator for a usage gauge. */\n  contextWindow?: number;\n  /** MIME patterns accepted as model inputs, e.g. image/* or application/pdf. */\n  inputMediaTypes?: string[];\n}\n\n/** Per-message metadata the backend rides on the SSE `finish` part\n *  (`messageMetadata`), applied by the AI SDK to the assistant `UIMessage`. */\nexport interface ChatMessageMetadata {\n  usage?: ChatUsageBreakdown;\n  costBreakdown?: ChatCostBreakdown;\n  /** This turn's cost in USD. */\n  cost?: number;\n  /** Cumulative thread cost in USD (when the turn is persisted to a thread). */\n  threadCostUsd?: number;\n  /** This turn's input-token count, ≈ current context-window occupancy. */\n  contextTokens?: number;\n}\n\n/** A flattened usage snapshot a chat surfaces for a gauge: tokens used out of the\n *  model's context window, plus cumulative cost. */\nexport interface ChatUsageSummary {\n  usedTokens: number;\n  maxTokens: number;\n  cost?: number;\n  usage?: ChatUsageBreakdown;\n  costBreakdown?: ChatCostBreakdown;\n  messageCount: number;\n  modelLabel?: string;\n}\n\nexport interface ChatBudgetConfig {\n  /** Per-thread/request cost cap in USD. */\n  cost?: number;\n  /** Max output tokens for one model call. */\n  maxTokens?: number;\n}\n\nexport interface ChatUsageBreakdown {\n  inputTokens?: number;\n  outputTokens?: number;\n  reasoningTokens?: number;\n  cacheReadTokens?: number;\n  cacheWriteTokens?: number;\n  totalTokens?: number;\n}\n\nexport interface ChatCostBreakdown {\n  model?: string;\n  inputUsd?: number;\n  outputUsd?: number;\n  reasoningUsd?: number;\n  cacheReadUsd?: number;\n  cacheWriteUsd?: number;\n  totalUsd?: number;\n}\n\n/** A suggested prompt shown on the empty state. A bare string is both the label\n *  and the submitted text; the object form separates them. */\nexport type Suggestion = string | { label: string; prompt: string };\n\n/** The label shown for a suggestion. */\nexport function suggestionLabel(s: Suggestion): string {\n  return typeof s === \"string\" ? s : s.label;\n}\n\n/** The text submitted when a suggestion is clicked. */\nexport function suggestionPrompt(s: Suggestion): string {\n  return typeof s === \"string\" ? s : s.prompt;\n}\n\n/** Returns true for an assistant reasoning (\"thinking\") part. */\nexport function isReasoningPart(part: {\n  type: string;\n}): part is ReasoningUIPart {\n  return part.type === \"reasoning\";\n}\n\n/** Returns true for a file/attachment part. */\nexport function isFilePart(part: { type: string }): part is FileUIPart {\n  return part.type === \"file\";\n}\n\n/** A tool part as it appears in an assistant UIMessage — either a typed\n *  `tool-<name>` part or the generic `dynamic-tool` part. clicky operations\n *  surface as dynamic tools, so the chat UI renders both shapes. */\nexport type AnyToolPart = ToolUIPart | DynamicToolUIPart;\n\n/** Claude Agent SDK permission modes accepted by `permissionMode`. */\nexport const CLAUDE_PERMISSION_MODES = [\n  \"default\",\n  \"acceptEdits\",\n  \"bypassPermissions\",\n  \"plan\",\n  \"dontAsk\",\n  \"auto\",\n] as const;\n\nexport type ClaudePermissionMode = (typeof CLAUDE_PERMISSION_MODES)[number];\n\nexport type ClaudePermissionModeOption = {\n  value: ClaudePermissionMode;\n  label: string;\n  description: string;\n};\n\nexport const CLAUDE_PERMISSION_MODE_OPTIONS: ClaudePermissionModeOption[] = [\n  {\n    value: \"default\",\n    label: \"Default\",\n    description:\n      \"Prompt for dangerous operations using standard Claude behavior.\",\n  },\n  {\n    value: \"auto\",\n    label: \"Auto\",\n    description:\n      \"Use Claude's classifier to approve or deny permission prompts.\",\n  },\n  {\n    value: \"acceptEdits\",\n    label: \"Accept edits\",\n    description: \"Automatically accept file edit operations.\",\n  },\n  {\n    value: \"dontAsk\",\n    label: \"Don't ask\",\n    description: \"Do not prompt; deny actions that are not pre-approved.\",\n  },\n  {\n    value: \"plan\",\n    label: \"Plan\",\n    description: \"Planning mode with no tool execution.\",\n  },\n  {\n    value: \"bypassPermissions\",\n    label: \"Bypass\",\n    description:\n      \"Bypass permission checks when explicitly allowed by the host.\",\n  },\n];\n\n/** Tool metadata shared by the chat shell. It both configures the\n *  tool-preferences popover (`name`/`label`/`group`) and carries the schema\n *  derived from a clicky RPC operation (`description`/`inputSchema`). The Go\n *  backend owns execution; the client uses this only for display and to scope\n *  which tools a request may call (passed in the transport `body`). */\nexport type ToolMode = \"on\" | \"ask\" | \"off\" | \"auto\";\n\nexport interface ToolAnnotations {\n  title?: string;\n  readOnlyHint?: boolean;\n  destructiveHint?: boolean;\n  idempotentHint?: boolean;\n  openWorldHint?: boolean;\n  [key: string]: unknown;\n}\n\nexport interface ToolMeta {\n  /** Stable tool name sent to the model (the operation id). */\n  name: string;\n  /** Human-readable label shown in the tool-preferences popover. */\n  label: string;\n  /** Bucket heading in the popover — the clicky surface for RPC operations. */\n  group?: string;\n  /** Display title of the tool's parent surface/entity (e.g. \"Xero Accounts\").\n   *  Used to nest tools under their entity within a group, and as the\n   *  disambiguating prefix in flat lists so sibling verbs (\"List\", \"Get\") stay\n   *  distinguishable. Resolved from the operation's `x-clicky.surface`. */\n  parent?: string;\n  /** Raw entity name of the tool's surface (e.g. \"accounts\"), when known. */\n  entity?: string;\n  /** Preference key sent to the backend. Defaults to `name`; group-backed\n   *  clicky tools set this to the backend tool group. */\n  preferenceKey?: string;\n  /** Initial backend-owned permission when the chat window first sees this tool. */\n  defaultPermission?: ToolMode;\n  /** Opaque icon name emitted by the backend, resolved by the host UI. */\n  icon?: string;\n  /** Description shown in tool pickers / tool-call headers. */\n  description?: string;\n  /** Short usage hints shown in the tool browser. */\n  hints?: string[];\n  source?: \"clicky\" | \"custom\" | \"mcp\" | string;\n  server?: string;\n  method?: string;\n  path?: string;\n  operationName?: string;\n  title?: string;\n  /** Whether the runtime should treat the tool input schema as strict/closed. */\n  strict?: boolean;\n  /** Runtime tool annotations/hints, e.g. MCP/Genkit well-known hints. */\n  annotations?: ToolAnnotations;\n  /** JSON-Schema for the tool's input, assembled from an operation's\n   *  parameters + request body. Omitted for hand-authored tools. */\n  inputSchema?: ChatToolInputSchema;\n  outputSchema?: ChatToolInputSchema;\n}\n\nexport type ChatToolInputSchema = JsonSchemaObject;\nexport type JsonSchemaProperty = FormJsonSchemaProperty;\nexport type JSONSchemaProperty = FormJsonSchemaProperty;\n\n/** Returns true for a `dynamic-tool` part (clicky operations surface this way). */\nexport function isDynamicToolPart(part: {\n  type: string;\n}): part is DynamicToolUIPart {\n  return part.type === \"dynamic-tool\";\n}\n\n/** Returns true for a typed `tool-<name>` part. */\nexport function isTypedToolPart(part: { type: string }): part is ToolUIPart {\n  return part.type.startsWith(\"tool-\");\n}\n\n/** The display name of a tool part: the explicit `toolName` for dynamic tools,\n *  otherwise the suffix after `tool-`. */\nexport function toolPartName(part: AnyToolPart): string {\n  if (isDynamicToolPart(part)) {\n    return part.toolName;\n  }\n  return part.type.slice(\"tool-\".length);\n}\n\nexport interface ToolResultRenderArgs {\n  part: AnyToolPart;\n  toolName: string;\n  output: unknown;\n}\n\nexport type ToolResultRenderer = (args: ToolResultRenderArgs) => ReactNode;\n"],"names":[],"mappings":"AA2HO,SAAS,gBAAgB,GAAuB;AACrD,SAAO,OAAO,MAAM,WAAW,IAAI,EAAE;AACvC;AAGO,SAAS,iBAAiB,GAAuB;AACtD,SAAO,OAAO,MAAM,WAAW,IAAI,EAAE;AACvC;AAGO,SAAS,gBAAgB,MAEJ;AAC1B,SAAO,KAAK,SAAS;AACvB;AAGO,SAAS,WAAW,MAA4C;AACrE,SAAO,KAAK,SAAS;AACvB;AAQO,MAAM,0BAA0B;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAUO,MAAM,iCAA+D;AAAA,EAC1E;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aACE;AAAA,EAAA;AAAA,EAEJ;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aACE;AAAA,EAAA;AAAA,EAEJ;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,EAAA;AAAA,EAEf;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,EAAA;AAAA,EAEf;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,EAAA;AAAA,EAEf;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aACE;AAAA,EAAA;AAEN;AAgEO,SAAS,kBAAkB,MAEJ;AAC5B,SAAO,KAAK,SAAS;AACvB;AAGO,SAAS,gBAAgB,MAA4C;AAC1E,SAAO,KAAK,KAAK,WAAW,OAAO;AACrC;AAIO,SAAS,aAAa,MAA2B;AACtD,MAAI,kBAAkB,IAAI,GAAG;AAC3B,WAAO,KAAK;AAAA,EACd;AACA,SAAO,KAAK,KAAK,MAAM,QAAQ,MAAM;AACvC;"}
+{"version":3,"file":"types.js","sources":["../../../src/data/chat/types.ts"],"sourcesContent":["import type {\n  UIMessage,\n  ToolUIPart,\n  DynamicToolUIPart,\n  ChatStatus,\n  ReasoningUIPart,\n  FileUIPart,\n} from \"ai\";\nimport type { ReactNode } from \"react\";\nimport type {\n  JsonSchemaObject,\n  JsonSchemaProperty as FormJsonSchemaProperty,\n} from \"../../components/json-schema-form-types\";\n\nexport type {\n  UIMessage,\n  ToolUIPart,\n  DynamicToolUIPart,\n  ChatStatus,\n  ReasoningUIPart,\n  FileUIPart,\n};\n\n/** A selectable chat model, as served by the backend's GET /api/chat/models.\n *  `configured` is false for catalogued models whose provider has no API key. */\nexport interface ChatModelRuntime {\n  model?: string;\n  id?: string;\n  backend?: string;\n  mode?: string;\n  temperature?: number;\n  effort?: string;\n  noCache?: boolean;\n  fallbacks?: ChatModelRuntime[];\n}\n\nexport type RuntimeAvailabilityState =\n  | \"available\"\n  | \"disabled\"\n  | \"missing_credentials\"\n  | \"not_authenticated\"\n  | \"missing_executable\"\n  | \"missing_dependency\"\n  | \"unsupported\"\n  | \"unavailable\";\n\nexport interface RuntimeAvailability {\n  state: RuntimeAvailabilityState;\n  reason?: string;\n  remediation?: string;\n}\n\nexport interface ChatModel {\n  id: string;\n  provider: string;\n  label: string;\n  /** Exact Captain Model wire value submitted when this display row is selected. */\n  runtime?: ChatModelRuntime;\n  reasoning: boolean;\n  /** True when backend metadata is authoritative, including explicit unsupported values. */\n  capabilitiesKnown?: boolean;\n  /** Ordered reasoning-effort tiers accepted by this exact model. */\n  supportedEfforts?: string[];\n  /** Backend-recommended effort used when the current selection is invalid. */\n  defaultEffort?: string;\n  /** Whether the model honours the temperature sampling control. */\n  temperature?: boolean;\n  configured?: boolean;\n  availability?: RuntimeAvailability;\n  /**\n   * The catalog's own declared default — the row a picker seeds with when the\n   * caller names no model. At most one row carries it, and a catalog that\n   * declares none (or whose default is unconfigured) falls back to the first\n   * configured row.\n   */\n  default?: boolean;\n  /** Concrete runtime backends that advertised this model. Empty/omitted means provider-wide. */\n  backends?: string[];\n  /** Max context tokens — the denominator for a usage gauge. */\n  contextWindow?: number;\n  /** MIME patterns accepted as model inputs, e.g. image/* or application/pdf. */\n  inputMediaTypes?: string[];\n}\n\n/** Per-message metadata the backend rides on the SSE `finish` part\n *  (`messageMetadata`), applied by the AI SDK to the assistant `UIMessage`. */\nexport interface ChatMessageMetadata {\n  usage?: ChatUsageBreakdown;\n  costBreakdown?: ChatCostBreakdown;\n  /** This turn's cost in USD. */\n  cost?: number;\n  /** Cumulative thread cost in USD (when the turn is persisted to a thread). */\n  threadCostUsd?: number;\n  /** This turn's input-token count, ≈ current context-window occupancy. */\n  contextTokens?: number;\n}\n\n/** A flattened usage snapshot a chat surfaces for a gauge: tokens used out of the\n *  model's context window, plus cumulative cost. */\nexport interface ChatUsageSummary {\n  usedTokens: number;\n  maxTokens: number;\n  cost?: number;\n  usage?: ChatUsageBreakdown;\n  costBreakdown?: ChatCostBreakdown;\n  messageCount: number;\n  modelLabel?: string;\n}\n\nexport interface ChatBudgetConfig {\n  /** Per-thread/request cost cap in USD. */\n  cost?: number;\n  /** Max output tokens for one model call. */\n  maxTokens?: number;\n}\n\nexport interface ChatUsageBreakdown {\n  inputTokens?: number;\n  outputTokens?: number;\n  reasoningTokens?: number;\n  cacheReadTokens?: number;\n  cacheWriteTokens?: number;\n  totalTokens?: number;\n}\n\nexport interface ChatCostBreakdown {\n  model?: string;\n  inputUsd?: number;\n  outputUsd?: number;\n  reasoningUsd?: number;\n  cacheReadUsd?: number;\n  cacheWriteUsd?: number;\n  totalUsd?: number;\n}\n\n/** A suggested prompt shown on the empty state. A bare string is both the label\n *  and the submitted text; the object form separates them. */\nexport type Suggestion = string | { label: string; prompt: string };\n\n/** The label shown for a suggestion. */\nexport function suggestionLabel(s: Suggestion): string {\n  return typeof s === \"string\" ? s : s.label;\n}\n\n/** The text submitted when a suggestion is clicked. */\nexport function suggestionPrompt(s: Suggestion): string {\n  return typeof s === \"string\" ? s : s.prompt;\n}\n\n/** Returns true for an assistant reasoning (\"thinking\") part. */\nexport function isReasoningPart(part: {\n  type: string;\n}): part is ReasoningUIPart {\n  return part.type === \"reasoning\";\n}\n\n/** Returns true for a file/attachment part. */\nexport function isFilePart(part: { type: string }): part is FileUIPart {\n  return part.type === \"file\";\n}\n\n/** A tool part as it appears in an assistant UIMessage — either a typed\n *  `tool-<name>` part or the generic `dynamic-tool` part. clicky operations\n *  surface as dynamic tools, so the chat UI renders both shapes. */\nexport type AnyToolPart = ToolUIPart | DynamicToolUIPart;\n\n/** Claude Agent SDK permission modes accepted by `permissionMode`. */\nexport const CLAUDE_PERMISSION_MODES = [\n  \"default\",\n  \"acceptEdits\",\n  \"bypassPermissions\",\n  \"plan\",\n  \"dontAsk\",\n  \"auto\",\n] as const;\n\nexport type ClaudePermissionMode = (typeof CLAUDE_PERMISSION_MODES)[number];\n\nexport type ClaudePermissionModeOption = {\n  value: ClaudePermissionMode;\n  label: string;\n  description: string;\n};\n\nexport const CLAUDE_PERMISSION_MODE_OPTIONS: ClaudePermissionModeOption[] = [\n  {\n    value: \"default\",\n    label: \"Default\",\n    description:\n      \"Prompt for dangerous operations using standard Claude behavior.\",\n  },\n  {\n    value: \"auto\",\n    label: \"Auto\",\n    description:\n      \"Use Claude's classifier to approve or deny permission prompts.\",\n  },\n  {\n    value: \"acceptEdits\",\n    label: \"Accept edits\",\n    description: \"Automatically accept file edit operations.\",\n  },\n  {\n    value: \"dontAsk\",\n    label: \"Don't ask\",\n    description: \"Do not prompt; deny actions that are not pre-approved.\",\n  },\n  {\n    value: \"plan\",\n    label: \"Plan\",\n    description: \"Planning mode with no tool execution.\",\n  },\n  {\n    value: \"bypassPermissions\",\n    label: \"Bypass\",\n    description:\n      \"Bypass permission checks when explicitly allowed by the host.\",\n  },\n];\n\n/** Tool metadata shared by the chat shell. It both configures the\n *  tool-preferences popover (`name`/`label`/`group`) and carries the schema\n *  derived from a clicky RPC operation (`description`/`inputSchema`). The Go\n *  backend owns execution; the client uses this only for display and to scope\n *  which tools a request may call (passed in the transport `body`). */\nexport type ToolMode = \"on\" | \"ask\" | \"off\" | \"auto\";\n\nexport interface ToolAnnotations {\n  title?: string;\n  readOnlyHint?: boolean;\n  destructiveHint?: boolean;\n  idempotentHint?: boolean;\n  openWorldHint?: boolean;\n  [key: string]: unknown;\n}\n\nexport interface ToolMeta {\n  /** Stable tool name sent to the model (the operation id). */\n  name: string;\n  /** Human-readable label shown in the tool-preferences popover. */\n  label: string;\n  /** Bucket heading in the popover — the clicky surface for RPC operations. */\n  group?: string;\n  /** Display title of the tool's parent surface/entity (e.g. \"Xero Accounts\").\n   *  Used to nest tools under their entity within a group, and as the\n   *  disambiguating prefix in flat lists so sibling verbs (\"List\", \"Get\") stay\n   *  distinguishable. Resolved from the operation's `x-clicky.surface`. */\n  parent?: string;\n  /** Raw entity name of the tool's surface (e.g. \"accounts\"), when known. */\n  entity?: string;\n  /** Preference key sent to the backend. Defaults to `name`; group-backed\n   *  clicky tools set this to the backend tool group. */\n  preferenceKey?: string;\n  /** Initial backend-owned permission when the chat window first sees this tool. */\n  defaultPermission?: ToolMode;\n  /** Opaque icon name emitted by the backend, resolved by the host UI. */\n  icon?: string;\n  /** Description shown in tool pickers / tool-call headers. */\n  description?: string;\n  /** Short usage hints shown in the tool browser. */\n  hints?: string[];\n  source?: \"clicky\" | \"custom\" | \"mcp\" | string;\n  server?: string;\n  method?: string;\n  path?: string;\n  operationName?: string;\n  title?: string;\n  /** Whether the runtime should treat the tool input schema as strict/closed. */\n  strict?: boolean;\n  /** Runtime tool annotations/hints, e.g. MCP/Genkit well-known hints. */\n  annotations?: ToolAnnotations;\n  /** JSON-Schema for the tool's input, assembled from an operation's\n   *  parameters + request body. Omitted for hand-authored tools. */\n  inputSchema?: ChatToolInputSchema;\n  outputSchema?: ChatToolInputSchema;\n}\n\nexport type ChatToolInputSchema = JsonSchemaObject;\nexport type JsonSchemaProperty = FormJsonSchemaProperty;\nexport type JSONSchemaProperty = FormJsonSchemaProperty;\n\n/** Returns true for a `dynamic-tool` part (clicky operations surface this way). */\nexport function isDynamicToolPart(part: {\n  type: string;\n}): part is DynamicToolUIPart {\n  return part.type === \"dynamic-tool\";\n}\n\n/** Returns true for a typed `tool-<name>` part. */\nexport function isTypedToolPart(part: { type: string }): part is ToolUIPart {\n  return part.type.startsWith(\"tool-\");\n}\n\n/** The display name of a tool part: the explicit `toolName` for dynamic tools,\n *  otherwise the suffix after `tool-`. */\nexport function toolPartName(part: AnyToolPart): string {\n  if (isDynamicToolPart(part)) {\n    return part.toolName;\n  }\n  return part.type.slice(\"tool-\".length);\n}\n\nexport interface ToolResultRenderArgs {\n  part: AnyToolPart;\n  toolName: string;\n  output: unknown;\n}\n\nexport type ToolResultRenderer = (args: ToolResultRenderArgs) => ReactNode;\n"],"names":[],"mappings":"AA4IO,SAAS,gBAAgB,GAAuB;AACrD,SAAO,OAAO,MAAM,WAAW,IAAI,EAAE;AACvC;AAGO,SAAS,iBAAiB,GAAuB;AACtD,SAAO,OAAO,MAAM,WAAW,IAAI,EAAE;AACvC;AAGO,SAAS,gBAAgB,MAEJ;AAC1B,SAAO,KAAK,SAAS;AACvB;AAGO,SAAS,WAAW,MAA4C;AACrE,SAAO,KAAK,SAAS;AACvB;AAQO,MAAM,0BAA0B;AAAA,EACrC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAUO,MAAM,iCAA+D;AAAA,EAC1E;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aACE;AAAA,EAAA;AAAA,EAEJ;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aACE;AAAA,EAAA;AAAA,EAEJ;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,EAAA;AAAA,EAEf;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,EAAA;AAAA,EAEf;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aAAa;AAAA,EAAA;AAAA,EAEf;AAAA,IACE,OAAO;AAAA,IACP,OAAO;AAAA,IACP,aACE;AAAA,EAAA;AAEN;AAgEO,SAAS,kBAAkB,MAEJ;AAC5B,SAAO,KAAK,SAAS;AACvB;AAGO,SAAS,gBAAgB,MAA4C;AAC1E,SAAO,KAAK,KAAK,WAAW,OAAO;AACrC;AAIO,SAAS,aAAa,MAA2B;AACtD,MAAI,kBAAkB,IAAI,GAAG;AAC3B,WAAO,KAAK;AAAA,EACd;AACA,SAAO,KAAK,KAAK,MAAM,QAAQ,MAAM;AACvC;"}

package/dist/data/chat/usage-snapshot.cjs

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function usageSnapshotFromMetadata(metadata, options) {
+  var _a, _b;
+  const cost = metadata.threadCostUsd ?? ((_a = metadata.costBreakdown) == null ? void 0 : _a.totalUsd) ?? metadata.cost;
+  return {
+    usedTokens: metadata.contextTokens ?? ((_b = metadata.usage) == null ? void 0 : _b.totalTokens) ?? 0,
+    maxTokens: options.contextWindow ?? 0,
+    messageCount: options.messageCount,
+    ...cost != null ? { cost } : {},
+    ...metadata.usage ? { usage: metadata.usage } : {},
+    ...metadata.costBreakdown ? { costBreakdown: metadata.costBreakdown } : {},
+    ...options.modelLabel ? { modelLabel: options.modelLabel } : {}
+  };
+}
+exports.usageSnapshotFromMetadata = usageSnapshotFromMetadata;
+//# sourceMappingURL=usage-snapshot.cjs.map

package/dist/data/chat/usage-snapshot.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-snapshot.cjs","sources":["../../../src/data/chat/usage-snapshot.ts"],"sourcesContent":["import type { ChatMessageMetadata, ChatUsageSummary } from \"./types\";\n\n/**\n * Builds the usage snapshot a chat surfaces (gauge, hover card, config panel)\n * from the last settled assistant turn's metadata.\n *\n * The cost precedence matters: `threadCostUsd` is the conversation's running\n * total, while `cost` is only the turn that just finished. Preferring the\n * cumulative figure is what makes the meter report what the conversation has\n * actually spent — on a multi-turn thread the two differ by roughly the number\n * of turns taken. Backends that do not report a thread total still degrade to\n * the per-turn value rather than showing nothing.\n *\n * Token fields stay per-turn; the whole-conversation breakdown is served\n * separately by the thread costs endpoint.\n */\nexport function usageSnapshotFromMetadata(\n  metadata: ChatMessageMetadata,\n  options: { contextWindow?: number | undefined; modelLabel?: string | undefined; messageCount: number },\n): ChatUsageSummary {\n  const cost =\n    metadata.threadCostUsd ?? metadata.costBreakdown?.totalUsd ?? metadata.cost;\n  return {\n    usedTokens: metadata.contextTokens ?? metadata.usage?.totalTokens ?? 0,\n    maxTokens: options.contextWindow ?? 0,\n    messageCount: options.messageCount,\n    ...(cost != null ? { cost } : {}),\n    ...(metadata.usage ? { usage: metadata.usage } : {}),\n    ...(metadata.costBreakdown ? { costBreakdown: metadata.costBreakdown } : {}),\n    ...(options.modelLabel ? { modelLabel: options.modelLabel } : {}),\n  };\n}\n"],"names":[],"mappings":";;AAgBO,SAAS,0BACd,UACA,SACkB;;AAClB,QAAM,OACJ,SAAS,mBAAiB,cAAS,kBAAT,mBAAwB,aAAY,SAAS;AACzE,SAAO;AAAA,IACL,YAAY,SAAS,mBAAiB,cAAS,UAAT,mBAAgB,gBAAe;AAAA,IACrE,WAAW,QAAQ,iBAAiB;AAAA,IACpC,cAAc,QAAQ;AAAA,IACtB,GAAI,QAAQ,OAAO,EAAE,KAAA,IAAS,CAAA;AAAA,IAC9B,GAAI,SAAS,QAAQ,EAAE,OAAO,SAAS,MAAA,IAAU,CAAA;AAAA,IACjD,GAAI,SAAS,gBAAgB,EAAE,eAAe,SAAS,cAAA,IAAkB,CAAA;AAAA,IACzE,GAAI,QAAQ,aAAa,EAAE,YAAY,QAAQ,WAAA,IAAe,CAAA;AAAA,EAAC;AAEnE;;"}

package/dist/data/chat/usage-snapshot.d.ts

@@ -0,0 +1,21 @@
+import { ChatMessageMetadata, ChatUsageSummary } from './types';
+/**
+ * Builds the usage snapshot a chat surfaces (gauge, hover card, config panel)
+ * from the last settled assistant turn's metadata.
+ *
+ * The cost precedence matters: `threadCostUsd` is the conversation's running
+ * total, while `cost` is only the turn that just finished. Preferring the
+ * cumulative figure is what makes the meter report what the conversation has
+ * actually spent — on a multi-turn thread the two differ by roughly the number
+ * of turns taken. Backends that do not report a thread total still degrade to
+ * the per-turn value rather than showing nothing.
+ *
+ * Token fields stay per-turn; the whole-conversation breakdown is served
+ * separately by the thread costs endpoint.
+ */
+export declare function usageSnapshotFromMetadata(metadata: ChatMessageMetadata, options: {
+    contextWindow?: number | undefined;
+    modelLabel?: string | undefined;
+    messageCount: number;
+}): ChatUsageSummary;
+//# sourceMappingURL=usage-snapshot.d.ts.map

package/dist/data/chat/usage-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-snapshot.d.ts","sourceRoot":"","sources":["../../../src/data/chat/usage-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAErE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACrG,gBAAgB,CAYlB"}

package/dist/data/chat/usage-snapshot.js

@@ -0,0 +1,17 @@
+function usageSnapshotFromMetadata(metadata, options) {
+  var _a, _b;
+  const cost = metadata.threadCostUsd ?? ((_a = metadata.costBreakdown) == null ? void 0 : _a.totalUsd) ?? metadata.cost;
+  return {
+    usedTokens: metadata.contextTokens ?? ((_b = metadata.usage) == null ? void 0 : _b.totalTokens) ?? 0,
+    maxTokens: options.contextWindow ?? 0,
+    messageCount: options.messageCount,
+    ...cost != null ? { cost } : {},
+    ...metadata.usage ? { usage: metadata.usage } : {},
+    ...metadata.costBreakdown ? { costBreakdown: metadata.costBreakdown } : {},
+    ...options.modelLabel ? { modelLabel: options.modelLabel } : {}
+  };
+}
+export {
+  usageSnapshotFromMetadata
+};
+//# sourceMappingURL=usage-snapshot.js.map

package/dist/data/chat/usage-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-snapshot.js","sources":["../../../src/data/chat/usage-snapshot.ts"],"sourcesContent":["import type { ChatMessageMetadata, ChatUsageSummary } from \"./types\";\n\n/**\n * Builds the usage snapshot a chat surfaces (gauge, hover card, config panel)\n * from the last settled assistant turn's metadata.\n *\n * The cost precedence matters: `threadCostUsd` is the conversation's running\n * total, while `cost` is only the turn that just finished. Preferring the\n * cumulative figure is what makes the meter report what the conversation has\n * actually spent — on a multi-turn thread the two differ by roughly the number\n * of turns taken. Backends that do not report a thread total still degrade to\n * the per-turn value rather than showing nothing.\n *\n * Token fields stay per-turn; the whole-conversation breakdown is served\n * separately by the thread costs endpoint.\n */\nexport function usageSnapshotFromMetadata(\n  metadata: ChatMessageMetadata,\n  options: { contextWindow?: number | undefined; modelLabel?: string | undefined; messageCount: number },\n): ChatUsageSummary {\n  const cost =\n    metadata.threadCostUsd ?? metadata.costBreakdown?.totalUsd ?? metadata.cost;\n  return {\n    usedTokens: metadata.contextTokens ?? metadata.usage?.totalTokens ?? 0,\n    maxTokens: options.contextWindow ?? 0,\n    messageCount: options.messageCount,\n    ...(cost != null ? { cost } : {}),\n    ...(metadata.usage ? { usage: metadata.usage } : {}),\n    ...(metadata.costBreakdown ? { costBreakdown: metadata.costBreakdown } : {}),\n    ...(options.modelLabel ? { modelLabel: options.modelLabel } : {}),\n  };\n}\n"],"names":[],"mappings":"AAgBO,SAAS,0BACd,UACA,SACkB;AAHb;AAIL,QAAM,OACJ,SAAS,mBAAiB,cAAS,kBAAT,mBAAwB,aAAY,SAAS;AACzE,SAAO;AAAA,IACL,YAAY,SAAS,mBAAiB,cAAS,UAAT,mBAAgB,gBAAe;AAAA,IACrE,WAAW,QAAQ,iBAAiB;AAAA,IACpC,cAAc,QAAQ;AAAA,IACtB,GAAI,QAAQ,OAAO,EAAE,KAAA,IAAS,CAAA;AAAA,IAC9B,GAAI,SAAS,QAAQ,EAAE,OAAO,SAAS,MAAA,IAAU,CAAA;AAAA,IACjD,GAAI,SAAS,gBAAgB,EAAE,eAAe,SAAS,cAAA,IAAkB,CAAA;AAAA,IACzE,GAAI,QAAQ,aAAa,EAAE,YAAY,QAAQ,WAAA,IAAe,CAAA;AAAA,EAAC;AAEnE;"}

package/dist/data/data-table-filter-values.cjs

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function isMultiFilterEscapable(char) {
+  return char === "\\" || char === "!" || char === "," || /\s/.test(char);
+}
+function isUnescapedSpace(entry) {
+  return !entry.escaped && /\s/.test(entry.char);
+}
+function splitMultiFilterItems(value) {
+  const items = [[]];
+  for (let index = 0; index < value.length; index++) {
+    const char = value[index];
+    const next = value[index + 1];
+    if (char === "\\" && next !== void 0 && isMultiFilterEscapable(next)) {
+      items[items.length - 1].push({ char: next, escaped: true });
+      index++;
+    } else if (char === ",") {
+      items.push([]);
+    } else {
+      items[items.length - 1].push({ char, escaped: false });
+    }
+  }
+  return items.map((item) => {
+    let start = 0;
+    let end = item.length;
+    while (start < end && isUnescapedSpace(item[start])) start++;
+    while (end > start && isUnescapedSpace(item[end - 1])) end--;
+    return item.slice(start, end);
+  });
+}
+function parseMultiFilterValue(value) {
+  const parsed = {};
+  for (const item of splitMultiFilterItems(value)) {
+    if (item.length === 0) continue;
+    const excluded = item.length > 1 && item[0].char === "!" && !item[0].escaped;
+    const key = (excluded ? item.slice(1) : item).map((entry) => entry.char).join("");
+    if (key) parsed[key] = excluded ? "exclude" : "include";
+  }
+  return parsed;
+}
+function escapeMultiFilterKey(key) {
+  let escaped = "";
+  for (let index = 0; index < key.length; index++) {
+    const char = key[index];
+    const isBoundary = index === 0 || index === key.length - 1;
+    if (char === ",") {
+      escaped += "\\,";
+    } else if (char === "\\" && isMultiFilterEscapable(key[index + 1] ?? "")) {
+      escaped += "\\\\";
+    } else if (isBoundary && /\s/.test(char)) {
+      escaped += `\\${char}`;
+    } else {
+      escaped += char;
+    }
+  }
+  return escaped;
+}
+function serializeMultiFilterValue(value) {
+  return Object.entries(value).flatMap(([key, mode]) => {
+    if (!key) return [];
+    const escaped = escapeMultiFilterKey(key);
+    if (mode === "include") return [key.startsWith("!") ? `\\${escaped}` : escaped];
+    if (mode === "exclude") return [`!${escaped}`];
+    return [];
+  }).join(",");
+}
+function splitCommaValues(value) {
+  return value.split(",").map((item) => item.trim()).filter(Boolean);
+}
+function parseBoundsValue(raw) {
+  const bounds = {};
+  for (const token of raw.split(",")) {
+    const trimmed = token.trim();
+    if (trimmed.startsWith(">")) {
+      bounds.min = trimmed.replace(/^>=?/, "");
+    } else if (trimmed.startsWith("<")) {
+      bounds.max = trimmed.replace(/^<=?/, "");
+    }
+  }
+  return bounds;
+}
+function serializeBoundsValue(value) {
+  const tokens = [];
+  if (value.min) tokens.push(`>=${value.min}`);
+  if (value.max) tokens.push(`<=${value.max}`);
+  return tokens.join(",");
+}
+function updateFilterSelection(selection, key, serialized) {
+  const next = { ...selection };
+  if (serialized) {
+    next[key] = serialized;
+  } else {
+    delete next[key];
+  }
+  return next;
+}
+exports.parseBoundsValue = parseBoundsValue;
+exports.parseMultiFilterValue = parseMultiFilterValue;
+exports.serializeBoundsValue = serializeBoundsValue;
+exports.serializeMultiFilterValue = serializeMultiFilterValue;
+exports.splitCommaValues = splitCommaValues;
+exports.updateFilterSelection = updateFilterSelection;
+//# sourceMappingURL=data-table-filter-values.cjs.map

package/dist/data/data-table-filter-values.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-filter-values.cjs","sources":["../../src/data/data-table-filter-values.ts"],"sourcesContent":["import type { FilterBarMultiFilterMode } from \"../components/filter-bar-field-utils\";\n\n/**\n * A filter selection as one flat, URL-safe record: filter key → comma-joined\n * values, each optionally `!`-prefixed to exclude. It is the one encoding the\n * profile catalog (which syncs it to the URL) and the ad-hoc query browser both\n * speak, so a selection means the same thing wherever it is read.\n */\nexport type DataTableFilterSelection = Record<string, string>;\n\n// The serialized multi-filter value is a wire contract, not internal state: it\n// is packed into a query parameter and parsed server-side by clicky's\n// `entity.MultiFilter` (collections.MatchItems semantics — `,` separates\n// patterns, a leading `!` negates). That grammar has no escape sequence, so a\n// value that itself starts with `!` or contains `,` cannot be expressed on the\n// wire at all. Backslash escapes below therefore only ever apply to values the\n// server could never represent, leaving every representable value byte\n// identical, while making the local parse/serialize pair lossless so an\n// *included* \"!failed\" is not read back as an *exclusion* of \"failed\" on the\n// next render.\n//\n// WORKAROUND(no-server-escape-syntax): the escapes are understood by this\n// module only; a backslash sent to the server is matched literally.\n// Correct fix: teach entity.MultiFilter / collections.MatchItems an escape\n// sequence, then drop this note.\n// Ref: PR review, discussed with user 2026-08-05\n//\n// Grammar: `\\\\`, `\\!`, `\\,` and `\\<whitespace>` decode to the bare character; a\n// backslash before anything else is literal. Unescaped whitespace around an\n// item is trimmed (hand-edited URLs), unescaped `,` separates items, and an\n// unescaped leading `!` marks an exclusion. Empty keys are not representable\n// and are dropped.\ntype MultiFilterChar = { char: string; escaped: boolean };\n\nfunction isMultiFilterEscapable(char: string) {\n  return char === \"\\\\\" || char === \"!\" || char === \",\" || /\\s/.test(char);\n}\n\nfunction isUnescapedSpace(entry: MultiFilterChar) {\n  return !entry.escaped && /\\s/.test(entry.char);\n}\n\nfunction splitMultiFilterItems(value: string): MultiFilterChar[][] {\n  const items: MultiFilterChar[][] = [[]];\n  for (let index = 0; index < value.length; index++) {\n    const char = value[index]!;\n    const next = value[index + 1];\n    if (char === \"\\\\\" && next !== undefined && isMultiFilterEscapable(next)) {\n      items[items.length - 1]!.push({ char: next, escaped: true });\n      index++;\n    } else if (char === \",\") {\n      items.push([]);\n    } else {\n      items[items.length - 1]!.push({ char, escaped: false });\n    }\n  }\n  return items.map((item) => {\n    let start = 0;\n    let end = item.length;\n    while (start < end && isUnescapedSpace(item[start]!)) start++;\n    while (end > start && isUnescapedSpace(item[end - 1]!)) end--;\n    return item.slice(start, end);\n  });\n}\n\nexport function parseMultiFilterValue(value: string): Record<string, FilterBarMultiFilterMode> {\n  const parsed: Record<string, FilterBarMultiFilterMode> = {};\n  for (const item of splitMultiFilterItems(value)) {\n    if (item.length === 0) continue;\n    const excluded = item.length > 1 && item[0]!.char === \"!\" && !item[0]!.escaped;\n    const key = (excluded ? item.slice(1) : item).map((entry) => entry.char).join(\"\");\n    if (key) parsed[key] = excluded ? \"exclude\" : \"include\";\n  }\n  return parsed;\n}\n\nfunction escapeMultiFilterKey(key: string): string {\n  let escaped = \"\";\n  for (let index = 0; index < key.length; index++) {\n    const char = key[index]!;\n    const isBoundary = index === 0 || index === key.length - 1;\n    if (char === \",\") {\n      escaped += \"\\\\,\";\n    } else if (char === \"\\\\\" && isMultiFilterEscapable(key[index + 1] ?? \"\")) {\n      escaped += \"\\\\\\\\\";\n    } else if (isBoundary && /\\s/.test(char)) {\n      escaped += `\\\\${char}`;\n    } else {\n      escaped += char;\n    }\n  }\n  return escaped;\n}\n\nexport function serializeMultiFilterValue(value: Record<string, FilterBarMultiFilterMode>): string {\n  return Object.entries(value)\n    .flatMap(([key, mode]) => {\n      if (!key) return [];\n      const escaped = escapeMultiFilterKey(key);\n      if (mode === \"include\") return [key.startsWith(\"!\") ? `\\\\${escaped}` : escaped];\n      if (mode === \"exclude\") return [`!${escaped}`];\n      return [];\n    })\n    .join(\",\");\n}\n\nexport function splitCommaValues(value: string): string[] {\n  return value\n    .split(\",\")\n    .map((item) => item.trim())\n    .filter(Boolean);\n}\n\n/**\n * A bounded selection: both edges under one key, each token carrying its own\n * comparison operator. It is the other half of the selection grammar, and the\n * one a range and a time bound share.\n */\nexport type FilterBoundsValue = {\n  min?: string;\n  max?: string;\n};\n\n/**\n * Reads a bounded selection. The bar's controls are inclusive on both edges, so\n * that is what they write back — but a bound typed by hand or arriving in a URL\n * keeps whatever operator it came with.\n */\nexport function parseBoundsValue(raw: string): FilterBoundsValue {\n  const bounds: FilterBoundsValue = {};\n  for (const token of raw.split(\",\")) {\n    const trimmed = token.trim();\n    if (trimmed.startsWith(\">\")) {\n      bounds.min = trimmed.replace(/^>=?/, \"\");\n    } else if (trimmed.startsWith(\"<\")) {\n      bounds.max = trimmed.replace(/^<=?/, \"\");\n    }\n  }\n  return bounds;\n}\n\nexport function serializeBoundsValue(value: FilterBoundsValue): string {\n  const tokens: string[] = [];\n  if (value.min) tokens.push(`>=${value.min}`);\n  if (value.max) tokens.push(`<=${value.max}`);\n  return tokens.join(\",\");\n}\n\n/**\n * Writes a serialized value into a selection, dropping the key when it is\n * empty. An absent key and a key holding \"\" would send different query strings\n * for the same \"nothing selected\", so only one of them is ever built.\n */\nexport function updateFilterSelection(\n  selection: DataTableFilterSelection,\n  key: string,\n  serialized: string,\n): DataTableFilterSelection {\n  const next = { ...selection };\n  if (serialized) {\n    next[key] = serialized;\n  } else {\n    delete next[key];\n  }\n  return next;\n}\n"],"names":[],"mappings":"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"}

package/dist/data/data-table-filter-values.d.ts

@@ -0,0 +1,34 @@
+import { FilterBarMultiFilterMode } from '../components/filter-bar-field-utils';
+/**
+ * A filter selection as one flat, URL-safe record: filter key → comma-joined
+ * values, each optionally `!`-prefixed to exclude. It is the one encoding the
+ * profile catalog (which syncs it to the URL) and the ad-hoc query browser both
+ * speak, so a selection means the same thing wherever it is read.
+ */
+export type DataTableFilterSelection = Record<string, string>;
+export declare function parseMultiFilterValue(value: string): Record<string, FilterBarMultiFilterMode>;
+export declare function serializeMultiFilterValue(value: Record<string, FilterBarMultiFilterMode>): string;
+export declare function splitCommaValues(value: string): string[];
+/**
+ * A bounded selection: both edges under one key, each token carrying its own
+ * comparison operator. It is the other half of the selection grammar, and the
+ * one a range and a time bound share.
+ */
+export type FilterBoundsValue = {
+    min?: string;
+    max?: string;
+};
+/**
+ * Reads a bounded selection. The bar's controls are inclusive on both edges, so
+ * that is what they write back — but a bound typed by hand or arriving in a URL
+ * keeps whatever operator it came with.
+ */
+export declare function parseBoundsValue(raw: string): FilterBoundsValue;
+export declare function serializeBoundsValue(value: FilterBoundsValue): string;
+/**
+ * Writes a serialized value into a selection, dropping the key when it is
+ * empty. An absent key and a key holding "" would send different query strings
+ * for the same "nothing selected", so only one of them is ever built.
+ */
+export declare function updateFilterSelection(selection: DataTableFilterSelection, key: string, serialized: string): DataTableFilterSelection;
+//# sourceMappingURL=data-table-filter-values.d.ts.map

package/dist/data/data-table-filter-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table-filter-values.d.ts","sourceRoot":"","sources":["../../src/data/data-table-filter-values.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAErF;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAyD9D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAS7F;AAoBD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,GAAG,MAAM,CAUjG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAKxD;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAW/D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAKrE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,wBAAwB,EACnC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,GACjB,wBAAwB,CAQ1B"}

package/dist/data/data-table-filter-values.js

@@ -0,0 +1,103 @@
+function isMultiFilterEscapable(char) {
+  return char === "\\" || char === "!" || char === "," || /\s/.test(char);
+}
+function isUnescapedSpace(entry) {
+  return !entry.escaped && /\s/.test(entry.char);
+}
+function splitMultiFilterItems(value) {
+  const items = [[]];
+  for (let index = 0; index < value.length; index++) {
+    const char = value[index];
+    const next = value[index + 1];
+    if (char === "\\" && next !== void 0 && isMultiFilterEscapable(next)) {
+      items[items.length - 1].push({ char: next, escaped: true });
+      index++;
+    } else if (char === ",") {
+      items.push([]);
+    } else {
+      items[items.length - 1].push({ char, escaped: false });
+    }
+  }
+  return items.map((item) => {
+    let start = 0;
+    let end = item.length;
+    while (start < end && isUnescapedSpace(item[start])) start++;
+    while (end > start && isUnescapedSpace(item[end - 1])) end--;
+    return item.slice(start, end);
+  });
+}
+function parseMultiFilterValue(value) {
+  const parsed = {};
+  for (const item of splitMultiFilterItems(value)) {
+    if (item.length === 0) continue;
+    const excluded = item.length > 1 && item[0].char === "!" && !item[0].escaped;
+    const key = (excluded ? item.slice(1) : item).map((entry) => entry.char).join("");
+    if (key) parsed[key] = excluded ? "exclude" : "include";
+  }
+  return parsed;
+}
+function escapeMultiFilterKey(key) {
+  let escaped = "";
+  for (let index = 0; index < key.length; index++) {
+    const char = key[index];
+    const isBoundary = index === 0 || index === key.length - 1;
+    if (char === ",") {
+      escaped += "\\,";
+    } else if (char === "\\" && isMultiFilterEscapable(key[index + 1] ?? "")) {
+      escaped += "\\\\";
+    } else if (isBoundary && /\s/.test(char)) {
+      escaped += `\\${char}`;
+    } else {
+      escaped += char;
+    }
+  }
+  return escaped;
+}
+function serializeMultiFilterValue(value) {
+  return Object.entries(value).flatMap(([key, mode]) => {
+    if (!key) return [];
+    const escaped = escapeMultiFilterKey(key);
+    if (mode === "include") return [key.startsWith("!") ? `\\${escaped}` : escaped];
+    if (mode === "exclude") return [`!${escaped}`];
+    return [];
+  }).join(",");
+}
+function splitCommaValues(value) {
+  return value.split(",").map((item) => item.trim()).filter(Boolean);
+}
+function parseBoundsValue(raw) {
+  const bounds = {};
+  for (const token of raw.split(",")) {
+    const trimmed = token.trim();
+    if (trimmed.startsWith(">")) {
+      bounds.min = trimmed.replace(/^>=?/, "");
+    } else if (trimmed.startsWith("<")) {
+      bounds.max = trimmed.replace(/^<=?/, "");
+    }
+  }
+  return bounds;
+}
+function serializeBoundsValue(value) {
+  const tokens = [];
+  if (value.min) tokens.push(`>=${value.min}`);
+  if (value.max) tokens.push(`<=${value.max}`);
+  return tokens.join(",");
+}
+function updateFilterSelection(selection, key, serialized) {
+  const next = { ...selection };
+  if (serialized) {
+    next[key] = serialized;
+  } else {
+    delete next[key];
+  }
+  return next;
+}
+export {
+  parseBoundsValue,
+  parseMultiFilterValue,
+  serializeBoundsValue,
+  serializeMultiFilterValue,
+  splitCommaValues,
+  updateFilterSelection
+};
+//# sourceMappingURL=data-table-filter-values.js.map