@flanksource/clicky-ui 0.3.16 → 0.3.18

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

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const ENVELOPE_KEYS = /* @__PURE__ */ new Set(["output", "isError"]);
+const MAX_UNWRAP_DEPTH = 4;
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isOutputEnvelope(value) {
+  if (!isPlainObject(value)) return false;
+  const keys = Object.keys(value);
+  return keys.includes("output") && keys.every((key) => ENVELOPE_KEYS.has(key));
+}
+function parseJsonish(text) {
+  const trimmed = text.trim();
+  if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return null;
+  try {
+    return { parsed: JSON.parse(trimmed) };
+  } catch {
+    return null;
+  }
+}
+function normalizeToolOutput(raw) {
+  let value = raw;
+  let isError = false;
+  for (let depth = 0; depth < MAX_UNWRAP_DEPTH; depth += 1) {
+    if (isOutputEnvelope(value)) {
+      if (value.isError === true) isError = true;
+      value = value.output;
+      continue;
+    }
+    if (typeof value === "string") {
+      const parsed = parseJsonish(value);
+      if (!parsed) return { value, isError, text: value };
+      value = parsed.parsed;
+      continue;
+    }
+    break;
+  }
+  return { value, isError };
+}
+exports.normalizeToolOutput = normalizeToolOutput;
+//# sourceMappingURL=normalize.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.cjs","sources":["../../../../src/data/chat/tool-render/normalize.ts"],"sourcesContent":["// L0 of the tool-render pipeline: undo the transport envelope before any\n// renderer sees a tool result.\n//\n// The Go backend (captain/pkg/aichat/events.go) emits a completed tool result\n// as `{\"output\": \"<json string>\", \"isError\"?: true}` — the payload is JSON\n// encoded *twice*. Persisted threads store the same shape, so both the live\n// stream and a reloaded thread need the same unwrap. Nothing downstream should\n// ever have to know about the envelope.\n\nexport type NormalizedToolOutput = {\n  /** Envelope-unwrapped, JSON-parsed value. */\n  value: unknown;\n  /** True when the transport envelope carried `isError: true`. */\n  isError: boolean;\n  /** The original text when the payload was a string that is not JSON. */\n  text?: string;\n};\n\nconst ENVELOPE_KEYS = new Set([\"output\", \"isError\"]);\nconst MAX_UNWRAP_DEPTH = 4;\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** True for the transport envelope only: an object carrying `output` and\n *  nothing beyond `isError`. The subset check is what stops a legitimate\n *  record that happens to have an `output` field from being eaten. */\nfunction isOutputEnvelope(value: unknown): value is { output: unknown; isError?: boolean } {\n  if (!isPlainObject(value)) return false;\n  const keys = Object.keys(value);\n  return keys.includes(\"output\") && keys.every((key) => ENVELOPE_KEYS.has(key));\n}\n\nfunction parseJsonish(text: string): { parsed: unknown } | null {\n  const trimmed = text.trim();\n  if (!trimmed.startsWith(\"{\") && !trimmed.startsWith(\"[\")) return null;\n  try {\n    return { parsed: JSON.parse(trimmed) as unknown };\n  } catch {\n    return null;\n  }\n}\n\n/** Unwraps the transport `{output, isError}` envelope and parses JSON-looking\n *  strings. Identity for anything else — a non-JSON string is returned\n *  untouched (and also surfaced as `text`). */\nexport function normalizeToolOutput(raw: unknown): NormalizedToolOutput {\n  let value = raw;\n  let isError = false;\n\n  for (let depth = 0; depth < MAX_UNWRAP_DEPTH; depth += 1) {\n    if (isOutputEnvelope(value)) {\n      if (value.isError === true) isError = true;\n      value = value.output;\n      continue;\n    }\n    if (typeof value === \"string\") {\n      const parsed = parseJsonish(value);\n      if (!parsed) return { value, isError, text: value };\n      value = parsed.parsed;\n      continue;\n    }\n    break;\n  }\n\n  return { value, isError };\n}\n"],"names":[],"mappings":";;AAkBA,MAAM,gBAAgB,oBAAI,IAAI,CAAC,UAAU,SAAS,CAAC;AACnD,MAAM,mBAAmB;AAEzB,SAAS,cAAc,OAAkD;AACvE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAKA,SAAS,iBAAiB,OAAiE;AACzF,MAAI,CAAC,cAAc,KAAK,EAAG,QAAO;AAClC,QAAM,OAAO,OAAO,KAAK,KAAK;AAC9B,SAAO,KAAK,SAAS,QAAQ,KAAK,KAAK,MAAM,CAAC,QAAQ,cAAc,IAAI,GAAG,CAAC;AAC9E;AAEA,SAAS,aAAa,MAA0C;AAC9D,QAAM,UAAU,KAAK,KAAA;AACrB,MAAI,CAAC,QAAQ,WAAW,GAAG,KAAK,CAAC,QAAQ,WAAW,GAAG,EAAG,QAAO;AACjE,MAAI;AACF,WAAO,EAAE,QAAQ,KAAK,MAAM,OAAO,EAAA;AAAA,EACrC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAKO,SAAS,oBAAoB,KAAoC;AACtE,MAAI,QAAQ;AACZ,MAAI,UAAU;AAEd,WAAS,QAAQ,GAAG,QAAQ,kBAAkB,SAAS,GAAG;AACxD,QAAI,iBAAiB,KAAK,GAAG;AAC3B,UAAI,MAAM,YAAY,KAAM,WAAU;AACtC,cAAQ,MAAM;AACd;AAAA,IACF;AACA,QAAI,OAAO,UAAU,UAAU;AAC7B,YAAM,SAAS,aAAa,KAAK;AACjC,UAAI,CAAC,OAAQ,QAAO,EAAE,OAAO,SAAS,MAAM,MAAA;AAC5C,cAAQ,OAAO;AACf;AAAA,IACF;AACA;AAAA,EACF;AAEA,SAAO,EAAE,OAAO,QAAA;AAClB;;"}

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

@@ -0,0 +1,13 @@
+export type NormalizedToolOutput = {
+    /** Envelope-unwrapped, JSON-parsed value. */
+    value: unknown;
+    /** True when the transport envelope carried `isError: true`. */
+    isError: boolean;
+    /** The original text when the payload was a string that is not JSON. */
+    text?: string;
+};
+/** Unwraps the transport `{output, isError}` envelope and parses JSON-looking
+ *  strings. Identity for anything else — a non-JSON string is returned
+ *  untouched (and also surfaced as `text`). */
+export declare function normalizeToolOutput(raw: unknown): NormalizedToolOutput;
+//# sourceMappingURL=normalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../../src/data/chat/tool-render/normalize.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,oBAAoB,GAAG;IACjC,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AA4BF;;+CAE+C;AAC/C,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,CAoBtE"}

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

@@ -0,0 +1,42 @@
+const ENVELOPE_KEYS = /* @__PURE__ */ new Set(["output", "isError"]);
+const MAX_UNWRAP_DEPTH = 4;
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isOutputEnvelope(value) {
+  if (!isPlainObject(value)) return false;
+  const keys = Object.keys(value);
+  return keys.includes("output") && keys.every((key) => ENVELOPE_KEYS.has(key));
+}
+function parseJsonish(text) {
+  const trimmed = text.trim();
+  if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) return null;
+  try {
+    return { parsed: JSON.parse(trimmed) };
+  } catch {
+    return null;
+  }
+}
+function normalizeToolOutput(raw) {
+  let value = raw;
+  let isError = false;
+  for (let depth = 0; depth < MAX_UNWRAP_DEPTH; depth += 1) {
+    if (isOutputEnvelope(value)) {
+      if (value.isError === true) isError = true;
+      value = value.output;
+      continue;
+    }
+    if (typeof value === "string") {
+      const parsed = parseJsonish(value);
+      if (!parsed) return { value, isError, text: value };
+      value = parsed.parsed;
+      continue;
+    }
+    break;
+  }
+  return { value, isError };
+}
+export {
+  normalizeToolOutput
+};
+//# sourceMappingURL=normalize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sources":["../../../../src/data/chat/tool-render/normalize.ts"],"sourcesContent":["// L0 of the tool-render pipeline: undo the transport envelope before any\n// renderer sees a tool result.\n//\n// The Go backend (captain/pkg/aichat/events.go) emits a completed tool result\n// as `{\"output\": \"<json string>\", \"isError\"?: true}` — the payload is JSON\n// encoded *twice*. Persisted threads store the same shape, so both the live\n// stream and a reloaded thread need the same unwrap. Nothing downstream should\n// ever have to know about the envelope.\n\nexport type NormalizedToolOutput = {\n  /** Envelope-unwrapped, JSON-parsed value. */\n  value: unknown;\n  /** True when the transport envelope carried `isError: true`. */\n  isError: boolean;\n  /** The original text when the payload was a string that is not JSON. */\n  text?: string;\n};\n\nconst ENVELOPE_KEYS = new Set([\"output\", \"isError\"]);\nconst MAX_UNWRAP_DEPTH = 4;\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** True for the transport envelope only: an object carrying `output` and\n *  nothing beyond `isError`. The subset check is what stops a legitimate\n *  record that happens to have an `output` field from being eaten. */\nfunction isOutputEnvelope(value: unknown): value is { output: unknown; isError?: boolean } {\n  if (!isPlainObject(value)) return false;\n  const keys = Object.keys(value);\n  return keys.includes(\"output\") && keys.every((key) => ENVELOPE_KEYS.has(key));\n}\n\nfunction parseJsonish(text: string): { parsed: unknown } | null {\n  const trimmed = text.trim();\n  if (!trimmed.startsWith(\"{\") && !trimmed.startsWith(\"[\")) return null;\n  try {\n    return { parsed: JSON.parse(trimmed) as unknown };\n  } catch {\n    return null;\n  }\n}\n\n/** Unwraps the transport `{output, isError}` envelope and parses JSON-looking\n *  strings. Identity for anything else — a non-JSON string is returned\n *  untouched (and also surfaced as `text`). */\nexport function normalizeToolOutput(raw: unknown): NormalizedToolOutput {\n  let value = raw;\n  let isError = false;\n\n  for (let depth = 0; depth < MAX_UNWRAP_DEPTH; depth += 1) {\n    if (isOutputEnvelope(value)) {\n      if (value.isError === true) isError = true;\n      value = value.output;\n      continue;\n    }\n    if (typeof value === \"string\") {\n      const parsed = parseJsonish(value);\n      if (!parsed) return { value, isError, text: value };\n      value = parsed.parsed;\n      continue;\n    }\n    break;\n  }\n\n  return { value, isError };\n}\n"],"names":[],"mappings":"AAkBA,MAAM,gBAAgB,oBAAI,IAAI,CAAC,UAAU,SAAS,CAAC;AACnD,MAAM,mBAAmB;AAEzB,SAAS,cAAc,OAAkD;AACvE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAKA,SAAS,iBAAiB,OAAiE;AACzF,MAAI,CAAC,cAAc,KAAK,EAAG,QAAO;AAClC,QAAM,OAAO,OAAO,KAAK,KAAK;AAC9B,SAAO,KAAK,SAAS,QAAQ,KAAK,KAAK,MAAM,CAAC,QAAQ,cAAc,IAAI,GAAG,CAAC;AAC9E;AAEA,SAAS,aAAa,MAA0C;AAC9D,QAAM,UAAU,KAAK,KAAA;AACrB,MAAI,CAAC,QAAQ,WAAW,GAAG,KAAK,CAAC,QAAQ,WAAW,GAAG,EAAG,QAAO;AACjE,MAAI;AACF,WAAO,EAAE,QAAQ,KAAK,MAAM,OAAO,EAAA;AAAA,EACrC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAKO,SAAS,oBAAoB,KAAoC;AACtE,MAAI,QAAQ;AACZ,MAAI,UAAU;AAEd,WAAS,QAAQ,GAAG,QAAQ,kBAAkB,SAAS,GAAG;AACxD,QAAI,iBAAiB,KAAK,GAAG;AAC3B,UAAI,MAAM,YAAY,KAAM,WAAU;AACtC,cAAQ,MAAM;AACd;AAAA,IACF;AACA,QAAI,OAAO,UAAU,UAAU;AAC7B,YAAM,SAAS,aAAa,KAAK;AACjC,UAAI,CAAC,OAAQ,QAAO,EAAE,OAAO,SAAS,MAAM,MAAA;AAC5C,cAAQ,OAAO;AACf;AAAA,IACF;AACA;AAAA,EACF;AAEA,SAAO,EAAE,OAAO,QAAA;AAClB;"}

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

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const adapter = require("./adapter.cjs");
+const defaults = require("./defaults.cjs");
+function createToolRenderRegistry(adapters = [], options = {}) {
+  return new adapter.ToolRenderRegistry([...adapters, ...defaults.defaultToolRenderAdapters], options);
+}
+function toToolRenderRegistry(input, options = {}) {
+  if (input instanceof adapter.ToolRenderRegistry) return input.with(options);
+  return createToolRenderRegistry(input ?? [], options);
+}
+exports.createToolRenderRegistry = createToolRenderRegistry;
+exports.toToolRenderRegistry = toToolRenderRegistry;
+//# sourceMappingURL=registry.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.cjs","sources":["../../../../src/data/chat/tool-render/registry.ts"],"sourcesContent":["// Registry factories. Kept apart from adapter.ts so the contract file never\n// has to import the built-in renderers (which would close an import cycle).\n\nimport {\n  ToolRenderRegistry,\n  type ToolRenderAdapter,\n  type ToolRenderRegistryOptions,\n} from \"./adapter\";\nimport { defaultToolRenderAdapters } from \"./defaults\";\n\n/** Host adapters first, the built-in heuristics appended after — hosts win and\n *  the defaults are always the floor. */\nexport function createToolRenderRegistry(\n  adapters: ToolRenderAdapter[] = [],\n  options: ToolRenderRegistryOptions = {},\n): ToolRenderRegistry {\n  return new ToolRenderRegistry([...adapters, ...defaultToolRenderAdapters], options);\n}\n\n/** Accepts either form of the `toolRenderers` prop and merges registry options. */\nexport function toToolRenderRegistry(\n  input: ToolRenderAdapter[] | ToolRenderRegistry | undefined,\n  options: ToolRenderRegistryOptions = {},\n): ToolRenderRegistry {\n  if (input instanceof ToolRenderRegistry) return input.with(options);\n  return createToolRenderRegistry(input ?? [], options);\n}\n"],"names":["ToolRenderRegistry","defaultToolRenderAdapters"],"mappings":";;;;AAYO,SAAS,yBACd,WAAgC,IAChC,UAAqC,CAAA,GACjB;AACpB,SAAO,IAAIA,QAAAA,mBAAmB,CAAC,GAAG,UAAU,GAAGC,SAAAA,yBAAyB,GAAG,OAAO;AACpF;AAGO,SAAS,qBACd,OACA,UAAqC,IACjB;AACpB,MAAI,iBAAiBD,QAAAA,mBAAoB,QAAO,MAAM,KAAK,OAAO;AAClE,SAAO,yBAAyB,SAAS,CAAA,GAAI,OAAO;AACtD;;;"}

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

@@ -0,0 +1,7 @@
+import { ToolRenderRegistry, ToolRenderAdapter, ToolRenderRegistryOptions } from './adapter';
+/** Host adapters first, the built-in heuristics appended after — hosts win and
+ *  the defaults are always the floor. */
+export declare function createToolRenderRegistry(adapters?: ToolRenderAdapter[], options?: ToolRenderRegistryOptions): ToolRenderRegistry;
+/** Accepts either form of the `toolRenderers` prop and merges registry options. */
+export declare function toToolRenderRegistry(input: ToolRenderAdapter[] | ToolRenderRegistry | undefined, options?: ToolRenderRegistryOptions): ToolRenderRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/data/chat/tool-render/registry.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,yBAAyB,EAC/B,MAAM,WAAW,CAAC;AAGnB;yCACyC;AACzC,wBAAgB,wBAAwB,CACtC,QAAQ,GAAE,iBAAiB,EAAO,EAClC,OAAO,GAAE,yBAA8B,GACtC,kBAAkB,CAEpB;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,iBAAiB,EAAE,GAAG,kBAAkB,GAAG,SAAS,EAC3D,OAAO,GAAE,yBAA8B,GACtC,kBAAkB,CAGpB"}

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

@@ -0,0 +1,14 @@
+import { ToolRenderRegistry } from "./adapter.js";
+import { defaultToolRenderAdapters } from "./defaults.js";
+function createToolRenderRegistry(adapters = [], options = {}) {
+  return new ToolRenderRegistry([...adapters, ...defaultToolRenderAdapters], options);
+}
+function toToolRenderRegistry(input, options = {}) {
+  if (input instanceof ToolRenderRegistry) return input.with(options);
+  return createToolRenderRegistry(input ?? [], options);
+}
+export {
+  createToolRenderRegistry,
+  toToolRenderRegistry
+};
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sources":["../../../../src/data/chat/tool-render/registry.ts"],"sourcesContent":["// Registry factories. Kept apart from adapter.ts so the contract file never\n// has to import the built-in renderers (which would close an import cycle).\n\nimport {\n  ToolRenderRegistry,\n  type ToolRenderAdapter,\n  type ToolRenderRegistryOptions,\n} from \"./adapter\";\nimport { defaultToolRenderAdapters } from \"./defaults\";\n\n/** Host adapters first, the built-in heuristics appended after — hosts win and\n *  the defaults are always the floor. */\nexport function createToolRenderRegistry(\n  adapters: ToolRenderAdapter[] = [],\n  options: ToolRenderRegistryOptions = {},\n): ToolRenderRegistry {\n  return new ToolRenderRegistry([...adapters, ...defaultToolRenderAdapters], options);\n}\n\n/** Accepts either form of the `toolRenderers` prop and merges registry options. */\nexport function toToolRenderRegistry(\n  input: ToolRenderAdapter[] | ToolRenderRegistry | undefined,\n  options: ToolRenderRegistryOptions = {},\n): ToolRenderRegistry {\n  if (input instanceof ToolRenderRegistry) return input.with(options);\n  return createToolRenderRegistry(input ?? [], options);\n}\n"],"names":[],"mappings":";;AAYO,SAAS,yBACd,WAAgC,IAChC,UAAqC,CAAA,GACjB;AACpB,SAAO,IAAI,mBAAmB,CAAC,GAAG,UAAU,GAAG,yBAAyB,GAAG,OAAO;AACpF;AAGO,SAAS,qBACd,OACA,UAAqC,IACjB;AACpB,MAAI,iBAAiB,mBAAoB,QAAO,MAAM,KAAK,OAAO;AAClE,SAAO,yBAAyB,SAAS,CAAA,GAAI,OAAO;AACtD;"}

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

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function propertyType(property) {
+  const { type } = property;
+  if (typeof type === "string") return type;
+  if (Array.isArray(type)) return type.find((entry) => entry !== "null");
+  return void 0;
+}
+function enumLabelsOf(property) {
+  const labels = property["x-enum-labels"];
+  return labels && Object.keys(labels).length > 0 ? labels : void 0;
+}
+function fieldMetaFromSchema(schema) {
+  const properties = schema == null ? void 0 : schema.properties;
+  if (!properties) return {};
+  const required = new Set((schema == null ? void 0 : schema.required) ?? []);
+  const explicitOrder = (schema == null ? void 0 : schema["x-order"]) ?? [];
+  const fields = {};
+  Object.entries(properties).forEach(([key, property], index) => {
+    const orderIndex = explicitOrder.indexOf(key);
+    const type = propertyType(property);
+    const labels = enumLabelsOf(property);
+    fields[key] = {
+      key,
+      label: property.title ?? key,
+      required: required.has(key),
+      order: orderIndex >= 0 ? orderIndex : explicitOrder.length + index,
+      ...property.description ? { description: property.description } : {},
+      ...type ? { type } : {},
+      ...property.format ? { format: property.format } : {},
+      ...labels ? { enumLabels: labels } : {}
+    };
+  });
+  return fields;
+}
+function orderFieldKeys(keys, fields) {
+  return [...keys].sort((a, b) => {
+    var _a, _b;
+    const left = (_a = fields[a]) == null ? void 0 : _a.order;
+    const right = (_b = fields[b]) == null ? void 0 : _b.order;
+    if (left === void 0 && right === void 0) return 0;
+    if (left === void 0) return 1;
+    if (right === void 0) return -1;
+    return left - right;
+  });
+}
+function listItemsSchema(schema) {
+  var _a;
+  if (!schema) return void 0;
+  const data = (_a = schema.properties) == null ? void 0 : _a["data"];
+  if (data == null ? void 0 : data.items) return data.items;
+  return schema.items;
+}
+exports.fieldMetaFromSchema = fieldMetaFromSchema;
+exports.listItemsSchema = listItemsSchema;
+exports.orderFieldKeys = orderFieldKeys;
+//# sourceMappingURL=schema.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.cjs","sources":["../../../../src/data/chat/tool-render/schema.ts"],"sourcesContent":["// L1 of the tool-render pipeline: per-field metadata mined from a tool's\n// JSON-Schema, when the catalog published one. Every read is optional — tools\n// without a schema (custom, MCP, map-returning ops) fall through to the value\n// heuristics in shape.ts, which is the normal case.\n\nimport type { JsonSchemaObject, JsonSchemaProperty } from \"../../../components/json-schema-form-types\";\nimport type { ChatToolInputSchema } from \"../types\";\n\nexport type ToolFieldMeta = {\n  key: string;\n  /** `schema.title` when present, else the raw key. Raw keys are deliberate:\n   *  these are API field names, and a user approving a write op needs the exact\n   *  name. Humanising them would also break the collapsed/expanded text\n   *  assertions pinned by ToolCall.test.tsx. */\n  label: string;\n  description?: string;\n  type?: string;\n  format?: string;\n  enumLabels?: Record<string, string>;\n  required: boolean;\n  order: number;\n};\n\ntype AnySchema = ChatToolInputSchema | JsonSchemaObject | JsonSchemaProperty;\n\nfunction propertyType(property: JsonSchemaProperty): string | undefined {\n  const { type } = property;\n  if (typeof type === \"string\") return type;\n  if (Array.isArray(type)) return type.find((entry) => entry !== \"null\");\n  return undefined;\n}\n\nfunction enumLabelsOf(property: JsonSchemaProperty): Record<string, string> | undefined {\n  const labels = property[\"x-enum-labels\"];\n  return labels && Object.keys(labels).length > 0 ? labels : undefined;\n}\n\n/** Field metadata keyed by property name. Returns an empty map when no schema\n *  (or a schema with no properties) is supplied. */\nexport function fieldMetaFromSchema(schema: AnySchema | undefined): Record<string, ToolFieldMeta> {\n  const properties = schema?.properties;\n  if (!properties) return {};\n\n  const required = new Set(schema?.required ?? []);\n  const explicitOrder = schema?.[\"x-order\"] ?? [];\n  const fields: Record<string, ToolFieldMeta> = {};\n\n  Object.entries(properties).forEach(([key, property], index) => {\n    const orderIndex = explicitOrder.indexOf(key);\n    const type = propertyType(property);\n    const labels = enumLabelsOf(property);\n    fields[key] = {\n      key,\n      label: property.title ?? key,\n      required: required.has(key),\n      order: orderIndex >= 0 ? orderIndex : explicitOrder.length + index,\n      ...(property.description ? { description: property.description } : {}),\n      ...(type ? { type } : {}),\n      ...(property.format ? { format: property.format } : {}),\n      ...(labels ? { enumLabels: labels } : {}),\n    };\n  });\n\n  return fields;\n}\n\n/** Orders keys by the schema's declared order (`x-order`, then property order),\n *  leaving keys the schema does not know about in their original order after. */\nexport function orderFieldKeys(keys: string[], fields: Record<string, ToolFieldMeta>): string[] {\n  return [...keys].sort((a, b) => {\n    const left = fields[a]?.order;\n    const right = fields[b]?.order;\n    if (left === undefined && right === undefined) return 0;\n    if (left === undefined) return 1;\n    if (right === undefined) return -1;\n    return left - right;\n  });\n}\n\n/** The item schema behind a list result: the clicky `PagedResult` envelope's\n *  `properties.data.items`, or a bare array schema's `items`. */\nexport function listItemsSchema(schema: AnySchema | undefined): JsonSchemaProperty | undefined {\n  if (!schema) return undefined;\n  const data = schema.properties?.[\"data\"];\n  if (data?.items) return data.items;\n  return schema.items;\n}\n"],"names":[],"mappings":";;AAyBA,SAAS,aAAa,UAAkD;AACtE,QAAM,EAAE,SAAS;AACjB,MAAI,OAAO,SAAS,SAAU,QAAO;AACrC,MAAI,MAAM,QAAQ,IAAI,EAAG,QAAO,KAAK,KAAK,CAAC,UAAU,UAAU,MAAM;AACrE,SAAO;AACT;AAEA,SAAS,aAAa,UAAkE;AACtF,QAAM,SAAS,SAAS,eAAe;AACvC,SAAO,UAAU,OAAO,KAAK,MAAM,EAAE,SAAS,IAAI,SAAS;AAC7D;AAIO,SAAS,oBAAoB,QAA8D;AAChG,QAAM,aAAa,iCAAQ;AAC3B,MAAI,CAAC,WAAY,QAAO,CAAA;AAExB,QAAM,WAAW,IAAI,KAAI,iCAAQ,aAAY,CAAA,CAAE;AAC/C,QAAM,iBAAgB,iCAAS,eAAc,CAAA;AAC7C,QAAM,SAAwC,CAAA;AAE9C,SAAO,QAAQ,UAAU,EAAE,QAAQ,CAAC,CAAC,KAAK,QAAQ,GAAG,UAAU;AAC7D,UAAM,aAAa,cAAc,QAAQ,GAAG;AAC5C,UAAM,OAAO,aAAa,QAAQ;AAClC,UAAM,SAAS,aAAa,QAAQ;AACpC,WAAO,GAAG,IAAI;AAAA,MACZ;AAAA,MACA,OAAO,SAAS,SAAS;AAAA,MACzB,UAAU,SAAS,IAAI,GAAG;AAAA,MAC1B,OAAO,cAAc,IAAI,aAAa,cAAc,SAAS;AAAA,MAC7D,GAAI,SAAS,cAAc,EAAE,aAAa,SAAS,YAAA,IAAgB,CAAA;AAAA,MACnE,GAAI,OAAO,EAAE,KAAA,IAAS,CAAA;AAAA,MACtB,GAAI,SAAS,SAAS,EAAE,QAAQ,SAAS,OAAA,IAAW,CAAA;AAAA,MACpD,GAAI,SAAS,EAAE,YAAY,WAAW,CAAA;AAAA,IAAC;AAAA,EAE3C,CAAC;AAED,SAAO;AACT;AAIO,SAAS,eAAe,MAAgB,QAAiD;AAC9F,SAAO,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM;;AAC9B,UAAM,QAAO,YAAO,CAAC,MAAR,mBAAW;AACxB,UAAM,SAAQ,YAAO,CAAC,MAAR,mBAAW;AACzB,QAAI,SAAS,UAAa,UAAU,OAAW,QAAO;AACtD,QAAI,SAAS,OAAW,QAAO;AAC/B,QAAI,UAAU,OAAW,QAAO;AAChC,WAAO,OAAO;AAAA,EAChB,CAAC;AACH;AAIO,SAAS,gBAAgB,QAA+D;;AAC7F,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,QAAO,YAAO,eAAP,mBAAoB;AACjC,MAAI,6BAAM,MAAO,QAAO,KAAK;AAC7B,SAAO,OAAO;AAChB;;;;"}

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

@@ -0,0 +1,28 @@
+import { JsonSchemaObject, JsonSchemaProperty } from '../../../components/json-schema-form-types';
+import { ChatToolInputSchema } from '../types';
+export type ToolFieldMeta = {
+    key: string;
+    /** `schema.title` when present, else the raw key. Raw keys are deliberate:
+     *  these are API field names, and a user approving a write op needs the exact
+     *  name. Humanising them would also break the collapsed/expanded text
+     *  assertions pinned by ToolCall.test.tsx. */
+    label: string;
+    description?: string;
+    type?: string;
+    format?: string;
+    enumLabels?: Record<string, string>;
+    required: boolean;
+    order: number;
+};
+type AnySchema = ChatToolInputSchema | JsonSchemaObject | JsonSchemaProperty;
+/** Field metadata keyed by property name. Returns an empty map when no schema
+ *  (or a schema with no properties) is supplied. */
+export declare function fieldMetaFromSchema(schema: AnySchema | undefined): Record<string, ToolFieldMeta>;
+/** Orders keys by the schema's declared order (`x-order`, then property order),
+ *  leaving keys the schema does not know about in their original order after. */
+export declare function orderFieldKeys(keys: string[], fields: Record<string, ToolFieldMeta>): string[];
+/** The item schema behind a list result: the clicky `PagedResult` envelope's
+ *  `properties.data.items`, or a bare array schema's `items`. */
+export declare function listItemsSchema(schema: AnySchema | undefined): JsonSchemaProperty | undefined;
+export {};
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../../src/data/chat/tool-render/schema.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AACvG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ;;;kDAG8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,SAAS,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;AAc7E;oDACoD;AACpD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAyBhG;AAED;iFACiF;AACjF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,MAAM,EAAE,CAS9F;AAED;iEACiE;AACjE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,kBAAkB,GAAG,SAAS,CAK7F"}

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

@@ -0,0 +1,57 @@
+function propertyType(property) {
+  const { type } = property;
+  if (typeof type === "string") return type;
+  if (Array.isArray(type)) return type.find((entry) => entry !== "null");
+  return void 0;
+}
+function enumLabelsOf(property) {
+  const labels = property["x-enum-labels"];
+  return labels && Object.keys(labels).length > 0 ? labels : void 0;
+}
+function fieldMetaFromSchema(schema) {
+  const properties = schema == null ? void 0 : schema.properties;
+  if (!properties) return {};
+  const required = new Set((schema == null ? void 0 : schema.required) ?? []);
+  const explicitOrder = (schema == null ? void 0 : schema["x-order"]) ?? [];
+  const fields = {};
+  Object.entries(properties).forEach(([key, property], index) => {
+    const orderIndex = explicitOrder.indexOf(key);
+    const type = propertyType(property);
+    const labels = enumLabelsOf(property);
+    fields[key] = {
+      key,
+      label: property.title ?? key,
+      required: required.has(key),
+      order: orderIndex >= 0 ? orderIndex : explicitOrder.length + index,
+      ...property.description ? { description: property.description } : {},
+      ...type ? { type } : {},
+      ...property.format ? { format: property.format } : {},
+      ...labels ? { enumLabels: labels } : {}
+    };
+  });
+  return fields;
+}
+function orderFieldKeys(keys, fields) {
+  return [...keys].sort((a, b) => {
+    var _a, _b;
+    const left = (_a = fields[a]) == null ? void 0 : _a.order;
+    const right = (_b = fields[b]) == null ? void 0 : _b.order;
+    if (left === void 0 && right === void 0) return 0;
+    if (left === void 0) return 1;
+    if (right === void 0) return -1;
+    return left - right;
+  });
+}
+function listItemsSchema(schema) {
+  var _a;
+  if (!schema) return void 0;
+  const data = (_a = schema.properties) == null ? void 0 : _a["data"];
+  if (data == null ? void 0 : data.items) return data.items;
+  return schema.items;
+}
+export {
+  fieldMetaFromSchema,
+  listItemsSchema,
+  orderFieldKeys
+};
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sources":["../../../../src/data/chat/tool-render/schema.ts"],"sourcesContent":["// L1 of the tool-render pipeline: per-field metadata mined from a tool's\n// JSON-Schema, when the catalog published one. Every read is optional — tools\n// without a schema (custom, MCP, map-returning ops) fall through to the value\n// heuristics in shape.ts, which is the normal case.\n\nimport type { JsonSchemaObject, JsonSchemaProperty } from \"../../../components/json-schema-form-types\";\nimport type { ChatToolInputSchema } from \"../types\";\n\nexport type ToolFieldMeta = {\n  key: string;\n  /** `schema.title` when present, else the raw key. Raw keys are deliberate:\n   *  these are API field names, and a user approving a write op needs the exact\n   *  name. Humanising them would also break the collapsed/expanded text\n   *  assertions pinned by ToolCall.test.tsx. */\n  label: string;\n  description?: string;\n  type?: string;\n  format?: string;\n  enumLabels?: Record<string, string>;\n  required: boolean;\n  order: number;\n};\n\ntype AnySchema = ChatToolInputSchema | JsonSchemaObject | JsonSchemaProperty;\n\nfunction propertyType(property: JsonSchemaProperty): string | undefined {\n  const { type } = property;\n  if (typeof type === \"string\") return type;\n  if (Array.isArray(type)) return type.find((entry) => entry !== \"null\");\n  return undefined;\n}\n\nfunction enumLabelsOf(property: JsonSchemaProperty): Record<string, string> | undefined {\n  const labels = property[\"x-enum-labels\"];\n  return labels && Object.keys(labels).length > 0 ? labels : undefined;\n}\n\n/** Field metadata keyed by property name. Returns an empty map when no schema\n *  (or a schema with no properties) is supplied. */\nexport function fieldMetaFromSchema(schema: AnySchema | undefined): Record<string, ToolFieldMeta> {\n  const properties = schema?.properties;\n  if (!properties) return {};\n\n  const required = new Set(schema?.required ?? []);\n  const explicitOrder = schema?.[\"x-order\"] ?? [];\n  const fields: Record<string, ToolFieldMeta> = {};\n\n  Object.entries(properties).forEach(([key, property], index) => {\n    const orderIndex = explicitOrder.indexOf(key);\n    const type = propertyType(property);\n    const labels = enumLabelsOf(property);\n    fields[key] = {\n      key,\n      label: property.title ?? key,\n      required: required.has(key),\n      order: orderIndex >= 0 ? orderIndex : explicitOrder.length + index,\n      ...(property.description ? { description: property.description } : {}),\n      ...(type ? { type } : {}),\n      ...(property.format ? { format: property.format } : {}),\n      ...(labels ? { enumLabels: labels } : {}),\n    };\n  });\n\n  return fields;\n}\n\n/** Orders keys by the schema's declared order (`x-order`, then property order),\n *  leaving keys the schema does not know about in their original order after. */\nexport function orderFieldKeys(keys: string[], fields: Record<string, ToolFieldMeta>): string[] {\n  return [...keys].sort((a, b) => {\n    const left = fields[a]?.order;\n    const right = fields[b]?.order;\n    if (left === undefined && right === undefined) return 0;\n    if (left === undefined) return 1;\n    if (right === undefined) return -1;\n    return left - right;\n  });\n}\n\n/** The item schema behind a list result: the clicky `PagedResult` envelope's\n *  `properties.data.items`, or a bare array schema's `items`. */\nexport function listItemsSchema(schema: AnySchema | undefined): JsonSchemaProperty | undefined {\n  if (!schema) return undefined;\n  const data = schema.properties?.[\"data\"];\n  if (data?.items) return data.items;\n  return schema.items;\n}\n"],"names":[],"mappings":"AAyBA,SAAS,aAAa,UAAkD;AACtE,QAAM,EAAE,SAAS;AACjB,MAAI,OAAO,SAAS,SAAU,QAAO;AACrC,MAAI,MAAM,QAAQ,IAAI,EAAG,QAAO,KAAK,KAAK,CAAC,UAAU,UAAU,MAAM;AACrE,SAAO;AACT;AAEA,SAAS,aAAa,UAAkE;AACtF,QAAM,SAAS,SAAS,eAAe;AACvC,SAAO,UAAU,OAAO,KAAK,MAAM,EAAE,SAAS,IAAI,SAAS;AAC7D;AAIO,SAAS,oBAAoB,QAA8D;AAChG,QAAM,aAAa,iCAAQ;AAC3B,MAAI,CAAC,WAAY,QAAO,CAAA;AAExB,QAAM,WAAW,IAAI,KAAI,iCAAQ,aAAY,CAAA,CAAE;AAC/C,QAAM,iBAAgB,iCAAS,eAAc,CAAA;AAC7C,QAAM,SAAwC,CAAA;AAE9C,SAAO,QAAQ,UAAU,EAAE,QAAQ,CAAC,CAAC,KAAK,QAAQ,GAAG,UAAU;AAC7D,UAAM,aAAa,cAAc,QAAQ,GAAG;AAC5C,UAAM,OAAO,aAAa,QAAQ;AAClC,UAAM,SAAS,aAAa,QAAQ;AACpC,WAAO,GAAG,IAAI;AAAA,MACZ;AAAA,MACA,OAAO,SAAS,SAAS;AAAA,MACzB,UAAU,SAAS,IAAI,GAAG;AAAA,MAC1B,OAAO,cAAc,IAAI,aAAa,cAAc,SAAS;AAAA,MAC7D,GAAI,SAAS,cAAc,EAAE,aAAa,SAAS,YAAA,IAAgB,CAAA;AAAA,MACnE,GAAI,OAAO,EAAE,KAAA,IAAS,CAAA;AAAA,MACtB,GAAI,SAAS,SAAS,EAAE,QAAQ,SAAS,OAAA,IAAW,CAAA;AAAA,MACpD,GAAI,SAAS,EAAE,YAAY,WAAW,CAAA;AAAA,IAAC;AAAA,EAE3C,CAAC;AAED,SAAO;AACT;AAIO,SAAS,eAAe,MAAgB,QAAiD;AAC9F,SAAO,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM;AA5ClC;AA6CI,UAAM,QAAO,YAAO,CAAC,MAAR,mBAAW;AACxB,UAAM,SAAQ,YAAO,CAAC,MAAR,mBAAW;AACzB,QAAI,SAAS,UAAa,UAAU,OAAW,QAAO;AACtD,QAAI,SAAS,OAAW,QAAO;AAC/B,QAAI,UAAU,OAAW,QAAO;AAChC,WAAO,OAAO;AAAA,EAChB,CAAC;AACH;AAIO,SAAS,gBAAgB,QAA+D;AAxD/F;AAyDE,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,QAAO,YAAO,eAAP,mBAAoB;AACjC,MAAI,6BAAM,MAAO,QAAO,KAAK;AAC7B,SAAO,OAAO;AAChB;"}

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

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const COLUMN_SCAN_ROWS = 50;
+const DEFAULT_MAX_COLUMNS = 8;
+const CELL_TEXT_LIMIT = 80;
+const LEADING_KEYS = ["id", "code", "name", "title"];
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function objectRows(items) {
+  return items.every(isPlainObject) ? items : null;
+}
+function numberField(source, key) {
+  const value = source[key];
+  return typeof value === "number" ? value : void 0;
+}
+function pageInfo(value) {
+  const page = isPlainObject(value["page"]) ? value["page"] : value;
+  const limit = numberField(page, "limit");
+  const offset = numberField(page, "offset");
+  const total = numberField(page, "total");
+  if (limit === void 0 && offset === void 0 && total === void 0) return null;
+  return {
+    ...limit !== void 0 ? { limit } : {},
+    ...offset !== void 0 ? { offset } : {},
+    ...total !== void 0 ? { total } : {}
+  };
+}
+function classifyToolValue(value) {
+  if (value === void 0 || value === null) return { shape: "empty" };
+  if (typeof value === "string") {
+    return value.trim() === "" ? { shape: "empty" } : { shape: "scalar", value };
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return { shape: "scalar", value };
+  }
+  if (Array.isArray(value)) {
+    if (value.length === 0) return { shape: "empty" };
+    return { shape: "list", items: value, rows: objectRows(value) };
+  }
+  if (!isPlainObject(value)) return { shape: "empty" };
+  const keys = Object.keys(value);
+  if (keys.length === 0) return { shape: "empty" };
+  const data = value["data"];
+  if (Array.isArray(data)) {
+    const page = pageInfo(value);
+    if (page) return { shape: "paged", items: data, rows: objectRows(data), page };
+    return { shape: "list", items: data, rows: objectRows(data) };
+  }
+  if (keys.every((key) => typeof value[key] === "number")) {
+    return { shape: "counts", record: value };
+  }
+  return { shape: "record", record: value };
+}
+function cellText(value) {
+  if (value === null || value === void 0) return "";
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  const text = JSON.stringify(value) ?? "";
+  return text.length > CELL_TEXT_LIMIT ? `${text.slice(0, CELL_TEXT_LIMIT)}…` : text;
+}
+function isTimestampKey(key, field) {
+  if ((field == null ? void 0 : field.format) === "date-time" || (field == null ? void 0 : field.format) === "date") return true;
+  return /(_at|At|date|Date)$/.test(key);
+}
+function columnRank(key) {
+  const index = LEADING_KEYS.indexOf(key);
+  return index >= 0 ? index : LEADING_KEYS.length;
+}
+function deriveColumns(rows, options = {}) {
+  const fields = options.fields ?? {};
+  const max = options.max ?? DEFAULT_MAX_COLUMNS;
+  const keys = [];
+  for (const row of rows.slice(0, COLUMN_SCAN_ROWS)) {
+    for (const key of Object.keys(row)) {
+      if (!keys.includes(key)) keys.push(key);
+    }
+  }
+  return keys.sort((a, b) => columnRank(a) - columnRank(b)).slice(0, max).map((key) => {
+    const field = fields[key];
+    const timestamp = isTimestampKey(key, field);
+    const allNumeric = rows.every((row) => row[key] === void 0 || typeof row[key] === "number");
+    return {
+      key,
+      label: (field == null ? void 0 : field.label) ?? key,
+      // `kind` supplies DataTable's own renderer, so only stringify otherwise.
+      ...timestamp ? { kind: "timestamp" } : { render: (value) => cellText(value) },
+      ...allNumeric ? { align: "right" } : {}
+    };
+  });
+}
+exports.classifyToolValue = classifyToolValue;
+exports.deriveColumns = deriveColumns;
+//# sourceMappingURL=shape.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shape.cjs","sources":["../../../../src/data/chat/tool-render/shape.ts"],"sourcesContent":["// L2 of the tool-render pipeline: classify a tool result by its value alone,\n// so tools with no published schema still render as something better than a\n// JSON blob. The shapes mirror what clicky operations actually return: a\n// PagedResult envelope, a bare list, one record, a bag of counts, or a scalar.\n\nimport type { DataTableColumn } from \"../../DataTable\";\nimport type { ToolFieldMeta } from \"./schema\";\n\nexport type ToolValueShape = \"paged\" | \"list\" | \"record\" | \"counts\" | \"scalar\" | \"empty\";\n\nexport type ToolPageInfo = { limit?: number; offset?: number; total?: number };\n\nexport type ClassifiedToolValue =\n  | { shape: \"empty\" }\n  | { shape: \"scalar\"; value: string | number | boolean }\n  | { shape: \"counts\"; record: Record<string, number> }\n  | { shape: \"record\"; record: Record<string, unknown> }\n  | { shape: \"list\"; items: unknown[]; rows: Record<string, unknown>[] | null }\n  | { shape: \"paged\"; items: unknown[]; rows: Record<string, unknown>[] | null; page: ToolPageInfo };\n\nconst COLUMN_SCAN_ROWS = 50;\nconst DEFAULT_MAX_COLUMNS = 8;\nconst CELL_TEXT_LIMIT = 80;\nconst LEADING_KEYS = [\"id\", \"code\", \"name\", \"title\"];\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction objectRows(items: unknown[]): Record<string, unknown>[] | null {\n  return items.every(isPlainObject) ? (items as Record<string, unknown>[]) : null;\n}\n\nfunction numberField(source: Record<string, unknown>, key: string): number | undefined {\n  const value = source[key];\n  return typeof value === \"number\" ? value : undefined;\n}\n\nfunction pageInfo(value: Record<string, unknown>): ToolPageInfo | null {\n  const page = isPlainObject(value[\"page\"]) ? value[\"page\"] : value;\n  const limit = numberField(page, \"limit\");\n  const offset = numberField(page, \"offset\");\n  const total = numberField(page, \"total\");\n  if (limit === undefined && offset === undefined && total === undefined) return null;\n  return {\n    ...(limit !== undefined ? { limit } : {}),\n    ...(offset !== undefined ? { offset } : {}),\n    ...(total !== undefined ? { total } : {}),\n  };\n}\n\n/** Classify a normalized tool result. Ordering matters: the paged envelope is\n *  checked before the generic record, and an all-numeric record before it. */\nexport function classifyToolValue(value: unknown): ClassifiedToolValue {\n  if (value === undefined || value === null) return { shape: \"empty\" };\n\n  if (typeof value === \"string\") {\n    return value.trim() === \"\" ? { shape: \"empty\" } : { shape: \"scalar\", value };\n  }\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return { shape: \"scalar\", value };\n  }\n\n  if (Array.isArray(value)) {\n    if (value.length === 0) return { shape: \"empty\" };\n    return { shape: \"list\", items: value, rows: objectRows(value) };\n  }\n\n  if (!isPlainObject(value)) return { shape: \"empty\" };\n\n  const keys = Object.keys(value);\n  if (keys.length === 0) return { shape: \"empty\" };\n\n  const data = value[\"data\"];\n  if (Array.isArray(data)) {\n    const page = pageInfo(value);\n    if (page) return { shape: \"paged\", items: data, rows: objectRows(data), page };\n    return { shape: \"list\", items: data, rows: objectRows(data) };\n  }\n\n  if (keys.every((key) => typeof value[key] === \"number\")) {\n    return { shape: \"counts\", record: value as Record<string, number> };\n  }\n\n  return { shape: \"record\", record: value };\n}\n\nfunction cellText(value: unknown): string {\n  if (value === null || value === undefined) return \"\";\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"boolean\") return String(value);\n  const text = JSON.stringify(value) ?? \"\";\n  return text.length > CELL_TEXT_LIMIT ? `${text.slice(0, CELL_TEXT_LIMIT)}…` : text;\n}\n\nfunction isTimestampKey(key: string, field?: ToolFieldMeta): boolean {\n  if (field?.format === \"date-time\" || field?.format === \"date\") return true;\n  return /(_at|At|date|Date)$/.test(key);\n}\n\nfunction columnRank(key: string): number {\n  const index = LEADING_KEYS.indexOf(key);\n  return index >= 0 ? index : LEADING_KEYS.length;\n}\n\n/** Columns derived from the union of row keys, capped so a wide record does not\n *  blow out a chat bubble. Labels come from the schema when one was published. */\nexport function deriveColumns(\n  rows: Record<string, unknown>[],\n  options: { fields?: Record<string, ToolFieldMeta> | undefined; max?: number | undefined } = {},\n): DataTableColumn<Record<string, unknown>>[] {\n  const fields = options.fields ?? {};\n  const max = options.max ?? DEFAULT_MAX_COLUMNS;\n\n  const keys: string[] = [];\n  for (const row of rows.slice(0, COLUMN_SCAN_ROWS)) {\n    for (const key of Object.keys(row)) {\n      if (!keys.includes(key)) keys.push(key);\n    }\n  }\n\n  return keys\n    .sort((a, b) => columnRank(a) - columnRank(b))\n    .slice(0, max)\n    .map((key) => {\n      const field = fields[key];\n      const timestamp = isTimestampKey(key, field);\n      const allNumeric = rows.every((row) => row[key] === undefined || typeof row[key] === \"number\");\n      return {\n        key,\n        label: field?.label ?? key,\n        // `kind` supplies DataTable's own renderer, so only stringify otherwise.\n        ...(timestamp\n          ? { kind: \"timestamp\" as const }\n          : { render: (value: unknown) => cellText(value) }),\n        ...(allNumeric ? { align: \"right\" as const } : {}),\n      };\n    });\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,39 @@
+import { DataTableColumn } from '../../DataTable';
+import { ToolFieldMeta } from './schema';
+export type ToolValueShape = "paged" | "list" | "record" | "counts" | "scalar" | "empty";
+export type ToolPageInfo = {
+    limit?: number;
+    offset?: number;
+    total?: number;
+};
+export type ClassifiedToolValue = {
+    shape: "empty";
+} | {
+    shape: "scalar";
+    value: string | number | boolean;
+} | {
+    shape: "counts";
+    record: Record<string, number>;
+} | {
+    shape: "record";
+    record: Record<string, unknown>;
+} | {
+    shape: "list";
+    items: unknown[];
+    rows: Record<string, unknown>[] | null;
+} | {
+    shape: "paged";
+    items: unknown[];
+    rows: Record<string, unknown>[] | null;
+    page: ToolPageInfo;
+};
+/** Classify a normalized tool result. Ordering matters: the paged envelope is
+ *  checked before the generic record, and an all-numeric record before it. */
+export declare function classifyToolValue(value: unknown): ClassifiedToolValue;
+/** Columns derived from the union of row keys, capped so a wide record does not
+ *  blow out a chat bubble. Labels come from the schema when one was published. */
+export declare function deriveColumns(rows: Record<string, unknown>[], options?: {
+    fields?: Record<string, ToolFieldMeta> | undefined;
+    max?: number | undefined;
+}): DataTableColumn<Record<string, unknown>>[];
+//# sourceMappingURL=shape.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shape.d.ts","sourceRoot":"","sources":["../../../../src/data/chat/tool-render/shape.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEzF,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,MAAM,MAAM,mBAAmB,GAC3B;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAClB;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CAAE,GACrD;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACnD;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACpD;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAA;CAAE,GAC3E;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAiCrG;8EAC8E;AAC9E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAgCrE;AAoBD;kFACkF;AAClF,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,SAAS,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAO,GAC7F,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CA4B5C"}

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

@@ -0,0 +1,94 @@
+const COLUMN_SCAN_ROWS = 50;
+const DEFAULT_MAX_COLUMNS = 8;
+const CELL_TEXT_LIMIT = 80;
+const LEADING_KEYS = ["id", "code", "name", "title"];
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function objectRows(items) {
+  return items.every(isPlainObject) ? items : null;
+}
+function numberField(source, key) {
+  const value = source[key];
+  return typeof value === "number" ? value : void 0;
+}
+function pageInfo(value) {
+  const page = isPlainObject(value["page"]) ? value["page"] : value;
+  const limit = numberField(page, "limit");
+  const offset = numberField(page, "offset");
+  const total = numberField(page, "total");
+  if (limit === void 0 && offset === void 0 && total === void 0) return null;
+  return {
+    ...limit !== void 0 ? { limit } : {},
+    ...offset !== void 0 ? { offset } : {},
+    ...total !== void 0 ? { total } : {}
+  };
+}
+function classifyToolValue(value) {
+  if (value === void 0 || value === null) return { shape: "empty" };
+  if (typeof value === "string") {
+    return value.trim() === "" ? { shape: "empty" } : { shape: "scalar", value };
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return { shape: "scalar", value };
+  }
+  if (Array.isArray(value)) {
+    if (value.length === 0) return { shape: "empty" };
+    return { shape: "list", items: value, rows: objectRows(value) };
+  }
+  if (!isPlainObject(value)) return { shape: "empty" };
+  const keys = Object.keys(value);
+  if (keys.length === 0) return { shape: "empty" };
+  const data = value["data"];
+  if (Array.isArray(data)) {
+    const page = pageInfo(value);
+    if (page) return { shape: "paged", items: data, rows: objectRows(data), page };
+    return { shape: "list", items: data, rows: objectRows(data) };
+  }
+  if (keys.every((key) => typeof value[key] === "number")) {
+    return { shape: "counts", record: value };
+  }
+  return { shape: "record", record: value };
+}
+function cellText(value) {
+  if (value === null || value === void 0) return "";
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  const text = JSON.stringify(value) ?? "";
+  return text.length > CELL_TEXT_LIMIT ? `${text.slice(0, CELL_TEXT_LIMIT)}…` : text;
+}
+function isTimestampKey(key, field) {
+  if ((field == null ? void 0 : field.format) === "date-time" || (field == null ? void 0 : field.format) === "date") return true;
+  return /(_at|At|date|Date)$/.test(key);
+}
+function columnRank(key) {
+  const index = LEADING_KEYS.indexOf(key);
+  return index >= 0 ? index : LEADING_KEYS.length;
+}
+function deriveColumns(rows, options = {}) {
+  const fields = options.fields ?? {};
+  const max = options.max ?? DEFAULT_MAX_COLUMNS;
+  const keys = [];
+  for (const row of rows.slice(0, COLUMN_SCAN_ROWS)) {
+    for (const key of Object.keys(row)) {
+      if (!keys.includes(key)) keys.push(key);
+    }
+  }
+  return keys.sort((a, b) => columnRank(a) - columnRank(b)).slice(0, max).map((key) => {
+    const field = fields[key];
+    const timestamp = isTimestampKey(key, field);
+    const allNumeric = rows.every((row) => row[key] === void 0 || typeof row[key] === "number");
+    return {
+      key,
+      label: (field == null ? void 0 : field.label) ?? key,
+      // `kind` supplies DataTable's own renderer, so only stringify otherwise.
+      ...timestamp ? { kind: "timestamp" } : { render: (value) => cellText(value) },
+      ...allNumeric ? { align: "right" } : {}
+    };
+  });
+}
+export {
+  classifyToolValue,
+  deriveColumns
+};
+//# sourceMappingURL=shape.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shape.js","sources":["../../../../src/data/chat/tool-render/shape.ts"],"sourcesContent":["// L2 of the tool-render pipeline: classify a tool result by its value alone,\n// so tools with no published schema still render as something better than a\n// JSON blob. The shapes mirror what clicky operations actually return: a\n// PagedResult envelope, a bare list, one record, a bag of counts, or a scalar.\n\nimport type { DataTableColumn } from \"../../DataTable\";\nimport type { ToolFieldMeta } from \"./schema\";\n\nexport type ToolValueShape = \"paged\" | \"list\" | \"record\" | \"counts\" | \"scalar\" | \"empty\";\n\nexport type ToolPageInfo = { limit?: number; offset?: number; total?: number };\n\nexport type ClassifiedToolValue =\n  | { shape: \"empty\" }\n  | { shape: \"scalar\"; value: string | number | boolean }\n  | { shape: \"counts\"; record: Record<string, number> }\n  | { shape: \"record\"; record: Record<string, unknown> }\n  | { shape: \"list\"; items: unknown[]; rows: Record<string, unknown>[] | null }\n  | { shape: \"paged\"; items: unknown[]; rows: Record<string, unknown>[] | null; page: ToolPageInfo };\n\nconst COLUMN_SCAN_ROWS = 50;\nconst DEFAULT_MAX_COLUMNS = 8;\nconst CELL_TEXT_LIMIT = 80;\nconst LEADING_KEYS = [\"id\", \"code\", \"name\", \"title\"];\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction objectRows(items: unknown[]): Record<string, unknown>[] | null {\n  return items.every(isPlainObject) ? (items as Record<string, unknown>[]) : null;\n}\n\nfunction numberField(source: Record<string, unknown>, key: string): number | undefined {\n  const value = source[key];\n  return typeof value === \"number\" ? value : undefined;\n}\n\nfunction pageInfo(value: Record<string, unknown>): ToolPageInfo | null {\n  const page = isPlainObject(value[\"page\"]) ? value[\"page\"] : value;\n  const limit = numberField(page, \"limit\");\n  const offset = numberField(page, \"offset\");\n  const total = numberField(page, \"total\");\n  if (limit === undefined && offset === undefined && total === undefined) return null;\n  return {\n    ...(limit !== undefined ? { limit } : {}),\n    ...(offset !== undefined ? { offset } : {}),\n    ...(total !== undefined ? { total } : {}),\n  };\n}\n\n/** Classify a normalized tool result. Ordering matters: the paged envelope is\n *  checked before the generic record, and an all-numeric record before it. */\nexport function classifyToolValue(value: unknown): ClassifiedToolValue {\n  if (value === undefined || value === null) return { shape: \"empty\" };\n\n  if (typeof value === \"string\") {\n    return value.trim() === \"\" ? { shape: \"empty\" } : { shape: \"scalar\", value };\n  }\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return { shape: \"scalar\", value };\n  }\n\n  if (Array.isArray(value)) {\n    if (value.length === 0) return { shape: \"empty\" };\n    return { shape: \"list\", items: value, rows: objectRows(value) };\n  }\n\n  if (!isPlainObject(value)) return { shape: \"empty\" };\n\n  const keys = Object.keys(value);\n  if (keys.length === 0) return { shape: \"empty\" };\n\n  const data = value[\"data\"];\n  if (Array.isArray(data)) {\n    const page = pageInfo(value);\n    if (page) return { shape: \"paged\", items: data, rows: objectRows(data), page };\n    return { shape: \"list\", items: data, rows: objectRows(data) };\n  }\n\n  if (keys.every((key) => typeof value[key] === \"number\")) {\n    return { shape: \"counts\", record: value as Record<string, number> };\n  }\n\n  return { shape: \"record\", record: value };\n}\n\nfunction cellText(value: unknown): string {\n  if (value === null || value === undefined) return \"\";\n  if (typeof value === \"string\") return value;\n  if (typeof value === \"number\" || typeof value === \"boolean\") return String(value);\n  const text = JSON.stringify(value) ?? \"\";\n  return text.length > CELL_TEXT_LIMIT ? `${text.slice(0, CELL_TEXT_LIMIT)}…` : text;\n}\n\nfunction isTimestampKey(key: string, field?: ToolFieldMeta): boolean {\n  if (field?.format === \"date-time\" || field?.format === \"date\") return true;\n  return /(_at|At|date|Date)$/.test(key);\n}\n\nfunction columnRank(key: string): number {\n  const index = LEADING_KEYS.indexOf(key);\n  return index >= 0 ? index : LEADING_KEYS.length;\n}\n\n/** Columns derived from the union of row keys, capped so a wide record does not\n *  blow out a chat bubble. Labels come from the schema when one was published. */\nexport function deriveColumns(\n  rows: Record<string, unknown>[],\n  options: { fields?: Record<string, ToolFieldMeta> | undefined; max?: number | undefined } = {},\n): DataTableColumn<Record<string, unknown>>[] {\n  const fields = options.fields ?? {};\n  const max = options.max ?? DEFAULT_MAX_COLUMNS;\n\n  const keys: string[] = [];\n  for (const row of rows.slice(0, COLUMN_SCAN_ROWS)) {\n    for (const key of Object.keys(row)) {\n      if (!keys.includes(key)) keys.push(key);\n    }\n  }\n\n  return keys\n    .sort((a, b) => columnRank(a) - columnRank(b))\n    .slice(0, max)\n    .map((key) => {\n      const field = fields[key];\n      const timestamp = isTimestampKey(key, field);\n      const allNumeric = rows.every((row) => row[key] === undefined || typeof row[key] === \"number\");\n      return {\n        key,\n        label: field?.label ?? key,\n        // `kind` supplies DataTable's own renderer, so only stringify otherwise.\n        ...(timestamp\n          ? { kind: \"timestamp\" as const }\n          : { render: (value: unknown) => cellText(value) }),\n        ...(allNumeric ? { align: \"right\" as const } : {}),\n      };\n    });\n}\n"],"names":[],"mappings":"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"}