@flanksource/clicky-ui 0.3.10 → 0.3.11

package/dist/data/chat/clickyOperationsToTools.cjs

@@ -1,30 +1,20 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const DISABLED_TOOL_GROUP = "Disabled";
-const TOOL_GROUP_DEFAULTS = {
-  "Accounting Read": "enabled",
-  "Accounting Transaction Write": "ask",
-  "Accounting Metadata Write": "ask",
-  "Comments Read": "enabled",
-  "Comments Write": "ask",
-  "Xero Read": "disabled",
-  "Xero Write": "disabled",
-  "Takealot Read": "enabled",
-  "Takealot Write": "disabled",
-  "Admin Read": "enabled",
-  "Admin Write": "ask"
-};
-function clickyOperationsToTools(operations) {
+function clickyOperationsToTools(operations, surfaces) {
+  const surfacesByKey = /* @__PURE__ */ new Map();
+  for (const surface of surfaces ?? []) {
+    surfacesByKey.set(surface.key, surface);
+  }
   const tools = [];
   for (const resolved of operations) {
-    const tool = operationToTool(resolved.operation, resolved);
+    const tool = operationToTool(resolved.operation, resolved, surfacesByKey);
     if (tool) {
       tools.push(tool);
     }
   }
   return tools;
 }
-function operationToTool(operation, resolved) {
+function operationToTool(operation, resolved, surfacesByKey) {
   if (!operation.operationId) {
     return null;
   }
@@ -32,23 +22,76 @@ function operationToTool(operation, resolved) {
     return null;
   }
   const meta = operation["x-clicky"];
-  const group = operationToolGroup(operation, resolved);
-  if (group === DISABLED_TOOL_GROUP) {
-    return null;
-  }
+  const hints = meta == null ? void 0 : meta.toolHints;
+  const group = operationToolGroup(operation);
+  const surface = (meta == null ? void 0 : meta.surface) ? surfacesByKey == null ? void 0 : surfacesByKey.get(meta.surface) : void 0;
+  const parent = (surface == null ? void 0 : surface.title) || (hints == null ? void 0 : hints.parent) || (surface == null ? void 0 : surface.entity);
+  const icon = (hints == null ? void 0 : hints.icon) || (surface == null ? void 0 : surface.icon);
+  const defaultPermission = hints == null ? void 0 : hints.defaultPermission;
   const description = operation.description ?? operation.summary;
   return {
     name: operation.operationId,
     label: toolLabel(operation),
-    ...group ? { group, preferenceKey: group, defaultMode: toolDefaultMode(group) } : (meta == null ? void 0 : meta.surface) ? { group: meta.surface } : {},
+    ...group ? { group, preferenceKey: group } : (meta == null ? void 0 : meta.surface) ? { group: meta.surface } : {},
+    ...defaultPermission ? { defaultPermission } : {},
+    ...parent ? { parent } : {},
+    ...(surface == null ? void 0 : surface.entity) ? { entity: surface.entity } : {},
+    ...icon ? { icon } : {},
     ...description ? { description } : {},
+    ...(resolved == null ? void 0 : resolved.method) ? { method: resolved.method.toUpperCase() } : {},
+    ...(resolved == null ? void 0 : resolved.path) ? { path: resolved.path } : {},
+    strict: (hints == null ? void 0 : hints.strict) ?? true,
+    annotations: toolAnnotations(operation, resolved, description),
     inputSchema: buildInputSchema(operation)
   };
 }
-function operationToolGroup(operation, resolved) {
+function toolAnnotations(operation, resolved, description) {
+  var _a, _b, _c, _d;
+  const hints = (_a = operation["x-clicky"]) == null ? void 0 : _a.toolHints;
+  const method = ((_b = resolved == null ? void 0 : resolved.method) == null ? void 0 : _b.toUpperCase()) ?? "";
+  const annotations = {};
+  const title = (hints == null ? void 0 : hints.title) ?? operation.summary ?? ((_c = operation["x-clicky"]) == null ? void 0 : _c.actionName) ?? description;
+  if (title) annotations.title = title;
+  if ((hints == null ? void 0 : hints.readOnlyHint) !== void 0) {
+    annotations.readOnlyHint = hints.readOnlyHint;
+  } else if (((_d = resolved == null ? void 0 : resolved.method) == null ? void 0 : _d.toUpperCase()) === "GET") {
+    annotations.readOnlyHint = true;
+  }
+  if ((hints == null ? void 0 : hints.idempotentHint) !== void 0) {
+    annotations.idempotentHint = hints.idempotentHint;
+  } else if (isIdempotentMethod(method)) {
+    annotations.idempotentHint = true;
+  }
+  if ((hints == null ? void 0 : hints.destructiveHint) !== void 0) {
+    annotations.destructiveHint = hints.destructiveHint;
+  } else if (isDestructiveTool(operation, resolved)) {
+    annotations.destructiveHint = true;
+  }
+  if ((hints == null ? void 0 : hints.openWorldHint) !== void 0) {
+    annotations.openWorldHint = hints.openWorldHint;
+  }
+  return annotations;
+}
+function isIdempotentMethod(method) {
+  return method === "GET" || method === "HEAD" || method === "OPTIONS" || method === "PUT" || method === "DELETE";
+}
+function isDestructiveTool(operation, resolved) {
+  var _a;
+  const method = ((_a = resolved == null ? void 0 : resolved.method) == null ? void 0 : _a.toUpperCase()) ?? "";
+  if (method === "DELETE") return true;
+  if (method === "GET" || method === "HEAD" || method === "OPTIONS")
+    return false;
+  const text = `${(resolved == null ? void 0 : resolved.path) ?? ""} ${operation.operationId ?? ""}`.toLowerCase();
+  return /\b(write|delete|remove|destroy|void|sync|create|update|patch|post)\b/.test(
+    text
+  );
+}
+function operationToolGroup(operation) {
+  var _a;
   const meta = operation["x-clicky"];
+  if ((_a = meta == null ? void 0 : meta.toolHints) == null ? void 0 : _a.group) return meta.toolHints.group;
   if (meta == null ? void 0 : meta.group) return meta.group;
-  return inferToolGroup(operation, resolved);
+  return void 0;
 }
 function isCobraHelpOrCompletionOperation(operation, resolved) {
   var _a;
@@ -67,49 +110,6 @@ function pathContainsCobraBuiltin(path) {
   const first = commandParts[0];
   return first === "completion" || first === "help";
 }
-function inferToolGroup(operation, resolved) {
-  var _a;
-  const id = operation.operationId ?? "";
-  const tags = operation.tags ?? [];
-  const path = (resolved == null ? void 0 : resolved.path) ?? "";
-  const method = ((_a = resolved == null ? void 0 : resolved.method) == null ? void 0 : _a.toUpperCase()) ?? "";
-  const write = isWriteMethod(method);
-  if (path.startsWith("/api/v1/provider/") || id.startsWith("provider")) {
-    return write ? "Xero Write" : "Xero Read";
-  }
-  if (path.startsWith("/api/v1/comments") || path.startsWith("/api/v1/comment-messages") || /^(comments|commentMessages|comment)/.test(id)) {
-    return write ? "Comments Write" : "Comments Read";
-  }
-  if (path === "/api/v1/accounts/mapping" || id.startsWith("accountMapping")) {
-    return write ? "Accounting Metadata Write" : "Accounting Read";
-  }
-  if (path === "/api/v1/entity/metadata" || id.startsWith("entityMetadata")) {
-    return write ? "Accounting Metadata Write" : "Accounting Read";
-  }
-  if (path.startsWith("/api/v1/companies/") || id.startsWith("companyBranding")) {
-    return write ? "Accounting Metadata Write" : "Accounting Read";
-  }
-  if (path.startsWith("/api/v1/transactions") || path.startsWith("/api/v1/journals") || /^(transactions|journals)/.test(id)) {
-    return write ? "Accounting Transaction Write" : "Accounting Read";
-  }
-  if (path.startsWith("/api/v1/rules/") || path.startsWith("/api/v1/rates/") || path.startsWith("/api/v1/template/") || path.startsWith("/api/v1/formula/") || tags.some(
-    (tag) => ["rules", "rates", "template", "formula"].includes(tag)
-  ) || /^(rules|rates|template|formula)/.test(id)) {
-    return write && !isReadLikeOperation(id) ? "Admin Write" : "Admin Read";
-  }
-  return void 0;
-}
-function isWriteMethod(method) {
-  return method === "POST" || method === "PUT" || method === "PATCH" || method === "DELETE";
-}
-function isReadLikeOperation(operationId) {
-  return /(list|load|render|pdf|eval|context|validate|preview|coverage|entries|get|history|export)/i.test(
-    operationId
-  );
-}
-function toolDefaultMode(group) {
-  return TOOL_GROUP_DEFAULTS[group] ?? "ask";
-}
 function toolLabel(operation) {
   var _a, _b;
   const meta = operation["x-clicky"];
@@ -141,7 +141,7 @@ function buildInputSchema(operation) {
       properties[name] = schemaToProperty(schema);
     }
   }
-  return { type: "object", properties, required };
+  return { type: "object", properties, required, additionalProperties: false };
 }
 function parameterToProperty(param) {
   const prop = schemaToProperty(param.schema);
@@ -154,7 +154,7 @@ function schemaToProperty(schema) {
   if (!schema) {
     return { type: "string" };
   }
-  const prop = { type: schema.type ?? "string" };
+  const prop = { type: jsonSchemaType(schema.type) };
   if (schema.description !== void 0) {
     prop.description = schema.description;
   }
@@ -166,6 +166,20 @@ function schemaToProperty(schema) {
   }
   return prop;
 }
+function jsonSchemaType(type) {
+  switch (type) {
+    case "object":
+    case "array":
+    case "string":
+    case "integer":
+    case "number":
+    case "boolean":
+    case "null":
+      return type;
+    default:
+      return "string";
+  }
+}
 function requestBodySchema(operation) {
   var _a, _b, _c;
   const content = (_a = operation.requestBody) == null ? void 0 : _a.content;

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

@@ -1 +1 @@
-{"version":3,"file":"clickyOperationsToTools.cjs","sources":["../../../src/data/chat/clickyOperationsToTools.ts"],"sourcesContent":["import type {\n  OpenAPIOperation,\n  OpenAPIParameter,\n  OpenAPISchema,\n  ResolvedOperation,\n} from \"../../rpc/types\";\nimport type {\n  ChatToolInputSchema,\n  JSONSchemaProperty,\n  ToolMeta,\n  ToolMode,\n} from \"./types\";\n\nconst DISABLED_TOOL_GROUP = \"Disabled\";\n\nconst TOOL_GROUP_DEFAULTS: Record<string, ToolMode> = {\n  \"Accounting Read\": \"enabled\",\n  \"Accounting Transaction Write\": \"ask\",\n  \"Accounting Metadata Write\": \"ask\",\n  \"Comments Read\": \"enabled\",\n  \"Comments Write\": \"ask\",\n  \"Xero Read\": \"disabled\",\n  \"Xero Write\": \"disabled\",\n  \"Takealot Read\": \"enabled\",\n  \"Takealot Write\": \"disabled\",\n  \"Admin Read\": \"enabled\",\n  \"Admin Write\": \"ask\",\n};\n\n/** Converts a clicky RPC operation catalog into AI-tool metadata for display\n *  and request scoping. Execution stays in the Go backend; this maps an\n *  operation's `operationId` → tool name, a short `x-clicky` verb/action →\n *  label, the `x-clicky` surface → group, `summary`/`description` → description,\n *  and `parameters` + `requestBody` → a JSON-Schema input. Operations without an\n *  `operationId` are skipped (a tool needs a stable name). */\nexport function clickyOperationsToTools(\n  operations: ResolvedOperation[],\n): ToolMeta[] {\n  const tools: ToolMeta[] = [];\n  for (const resolved of operations) {\n    const tool = operationToTool(resolved.operation, resolved);\n    if (tool) {\n      tools.push(tool);\n    }\n  }\n  return tools;\n}\n\nexport function operationToTool(\n  operation: OpenAPIOperation,\n  resolved?: Pick<ResolvedOperation, \"path\" | \"method\">,\n): ToolMeta | null {\n  if (!operation.operationId) {\n    return null;\n  }\n  if (isCobraHelpOrCompletionOperation(operation, resolved)) {\n    return null;\n  }\n  const meta = operation[\"x-clicky\"];\n  const group = operationToolGroup(operation, resolved);\n  if (group === DISABLED_TOOL_GROUP) {\n    return null;\n  }\n  const description = operation.description ?? operation.summary;\n  return {\n    name: operation.operationId,\n    label: toolLabel(operation),\n    ...(group\n      ? { group, preferenceKey: group, defaultMode: toolDefaultMode(group) }\n      : meta?.surface\n        ? { group: meta.surface }\n        : {}),\n    ...(description ? { description } : {}),\n    inputSchema: buildInputSchema(operation),\n  };\n}\n\nfunction operationToolGroup(\n  operation: OpenAPIOperation,\n  resolved?: Pick<ResolvedOperation, \"path\" | \"method\">,\n): string | undefined {\n  const meta = operation[\"x-clicky\"];\n  if (meta?.group) return meta.group;\n  return inferToolGroup(operation, resolved);\n}\n\nfunction isCobraHelpOrCompletionOperation(\n  operation: OpenAPIOperation,\n  resolved?: Pick<ResolvedOperation, \"path\" | \"method\">,\n): boolean {\n  return (\n    commandStartsWithCobraBuiltin(operation.operationId) ||\n    commandStartsWithCobraBuiltin(operation[\"x-clicky\"]?.command) ||\n    pathContainsCobraBuiltin(resolved?.path)\n  );\n}\n\nfunction commandStartsWithCobraBuiltin(raw: string | undefined): boolean {\n  if (!raw) return false;\n  const normalized = raw\n    .replace(/([a-z\\d])([A-Z])/g, \"$1 $2\")\n    .replace(/[/_.-]+/g, \" \")\n    .trim()\n    .toLowerCase();\n  const first = normalized.split(/\\s+/)[0];\n  return first === \"completion\" || first === \"help\";\n}\n\nfunction pathContainsCobraBuiltin(path: string | undefined): boolean {\n  if (!path) return false;\n  const parts = path\n    .split(\"/\")\n    .filter(Boolean)\n    .map((part) => part.toLowerCase());\n  const commandParts =\n    parts[0] === \"api\" && /^v\\d+$/.test(parts[1] ?? \"\") ? parts.slice(2) : parts;\n  const first = commandParts[0];\n  return first === \"completion\" || first === \"help\";\n}\n\nfunction inferToolGroup(\n  operation: OpenAPIOperation,\n  resolved?: Pick<ResolvedOperation, \"path\" | \"method\">,\n): string | undefined {\n  const id = operation.operationId ?? \"\";\n  const tags = operation.tags ?? [];\n  const path = resolved?.path ?? \"\";\n  const method = resolved?.method?.toUpperCase() ?? \"\";\n  const write = isWriteMethod(method);\n\n  if (path.startsWith(\"/api/v1/provider/\") || id.startsWith(\"provider\")) {\n    return write ? \"Xero Write\" : \"Xero Read\";\n  }\n  if (\n    path.startsWith(\"/api/v1/comments\") ||\n    path.startsWith(\"/api/v1/comment-messages\") ||\n    /^(comments|commentMessages|comment)/.test(id)\n  ) {\n    return write ? \"Comments Write\" : \"Comments Read\";\n  }\n  if (path === \"/api/v1/accounts/mapping\" || id.startsWith(\"accountMapping\")) {\n    return write ? \"Accounting Metadata Write\" : \"Accounting Read\";\n  }\n  if (path === \"/api/v1/entity/metadata\" || id.startsWith(\"entityMetadata\")) {\n    return write ? \"Accounting Metadata Write\" : \"Accounting Read\";\n  }\n  if (\n    path.startsWith(\"/api/v1/companies/\") ||\n    id.startsWith(\"companyBranding\")\n  ) {\n    return write ? \"Accounting Metadata Write\" : \"Accounting Read\";\n  }\n  if (\n    path.startsWith(\"/api/v1/transactions\") ||\n    path.startsWith(\"/api/v1/journals\") ||\n    /^(transactions|journals)/.test(id)\n  ) {\n    return write ? \"Accounting Transaction Write\" : \"Accounting Read\";\n  }\n  if (\n    path.startsWith(\"/api/v1/rules/\") ||\n    path.startsWith(\"/api/v1/rates/\") ||\n    path.startsWith(\"/api/v1/template/\") ||\n    path.startsWith(\"/api/v1/formula/\") ||\n    tags.some((tag) =>\n      [\"rules\", \"rates\", \"template\", \"formula\"].includes(tag),\n    ) ||\n    /^(rules|rates|template|formula)/.test(id)\n  ) {\n    return write && !isReadLikeOperation(id) ? \"Admin Write\" : \"Admin Read\";\n  }\n  return undefined;\n}\n\nfunction isWriteMethod(method: string): boolean {\n  return (\n    method === \"POST\" ||\n    method === \"PUT\" ||\n    method === \"PATCH\" ||\n    method === \"DELETE\"\n  );\n}\n\nfunction isReadLikeOperation(operationId: string): boolean {\n  return /(list|load|render|pdf|eval|context|validate|preview|coverage|entries|get|history|export)/i.test(\n    operationId,\n  );\n}\n\nfunction toolDefaultMode(group: string): ToolMode {\n  return TOOL_GROUP_DEFAULTS[group] ?? \"ask\";\n}\n\n/** A concise popover label: the clicky action/verb (capitalized) when present,\n *  else the operation summary, else a humanized operationId. Mirrors the intent\n *  of rpc/clickyMetadata.ts `surfaceActionLabel`. */\nfunction toolLabel(operation: OpenAPIOperation): string {\n  const meta = operation[\"x-clicky\"];\n  const short = meta?.actionName?.trim() || meta?.verb?.trim();\n  if (short && short !== \"action\") {\n    return short.charAt(0).toUpperCase() + short.slice(1);\n  }\n  if (operation.summary) {\n    return operation.summary;\n  }\n  return humanize(operation.operationId ?? \"\");\n}\n\nfunction humanize(operationId: string): string {\n  const spaced = operationId\n    .replace(/[_-]+/g, \" \")\n    .replace(/([a-z\\d])([A-Z])/g, \"$1 $2\");\n  return spaced.charAt(0).toUpperCase() + spaced.slice(1);\n}\n\nfunction buildInputSchema(operation: OpenAPIOperation): ChatToolInputSchema {\n  const properties: Record<string, JSONSchemaProperty> = {};\n  const required: string[] = [];\n\n  for (const param of operation.parameters ?? []) {\n    properties[param.name] = parameterToProperty(param);\n    if (param.required) {\n      required.push(param.name);\n    }\n  }\n\n  const body = requestBodySchema(operation);\n  if (body?.properties) {\n    for (const [name, schema] of Object.entries(body.properties)) {\n      properties[name] = schemaToProperty(schema);\n    }\n  }\n\n  return { type: \"object\", properties, required };\n}\n\nfunction parameterToProperty(param: OpenAPIParameter): JSONSchemaProperty {\n  const prop = schemaToProperty(param.schema);\n  if (param.description && !prop.description) {\n    prop.description = param.description;\n  }\n  return prop;\n}\n\nfunction schemaToProperty(\n  schema: OpenAPISchema | undefined,\n): JSONSchemaProperty {\n  if (!schema) {\n    return { type: \"string\" };\n  }\n  const prop: JSONSchemaProperty = { type: schema.type ?? \"string\" };\n  if (schema.description !== undefined) {\n    prop.description = schema.description;\n  }\n  if (schema.enum !== undefined) {\n    prop.enum = schema.enum;\n  }\n  if (schema.default !== undefined) {\n    prop.default = schema.default;\n  }\n  return prop;\n}\n\nfunction requestBodySchema(\n  operation: OpenAPIOperation,\n): OpenAPISchema | undefined {\n  const content = operation.requestBody?.content;\n  if (!content) {\n    return undefined;\n  }\n  return (\n    content[\"application/json\"]?.schema ?? Object.values(content)[0]?.schema\n  );\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"clickyOperationsToTools.cjs","sources":["../../../src/data/chat/clickyOperationsToTools.ts"],"sourcesContent":["import type {\n  ClickySurface,\n  OpenAPIOperation,\n  OpenAPIParameter,\n  OpenAPISchema,\n  ResolvedOperation,\n} from \"../../rpc/types\";\nimport type {\n  ChatToolInputSchema,\n  JSONSchemaProperty,\n  ToolAnnotations,\n  ToolMeta,\n} from \"./types\";\n\n/** Converts a clicky RPC operation catalog into AI-tool metadata for display\n *  and request scoping. Execution stays in the Go backend; this maps an\n *  operation's `operationId` → tool name, a short `x-clicky` verb/action →\n *  label, the `x-clicky` surface → group, `summary`/`description` → description,\n *  and `parameters` + `requestBody` → a JSON-Schema input. Operations without an\n *  `operationId` are skipped (a tool needs a stable name). */\nexport function clickyOperationsToTools(\n  operations: ResolvedOperation[],\n  surfaces?: ClickySurface[],\n): ToolMeta[] {\n  const surfacesByKey = new Map<string, ClickySurface>();\n  for (const surface of surfaces ?? []) {\n    surfacesByKey.set(surface.key, surface);\n  }\n  const tools: ToolMeta[] = [];\n  for (const resolved of operations) {\n    const tool = operationToTool(resolved.operation, resolved, surfacesByKey);\n    if (tool) {\n      tools.push(tool);\n    }\n  }\n  return tools;\n}\n\nexport function operationToTool(\n  operation: OpenAPIOperation,\n  resolved?: Pick<ResolvedOperation, \"path\" | \"method\">,\n  surfacesByKey?: Map<string, ClickySurface>,\n): ToolMeta | null {\n  if (!operation.operationId) {\n    return null;\n  }\n  if (isCobraHelpOrCompletionOperation(operation, resolved)) {\n    return null;\n  }\n  const meta = operation[\"x-clicky\"];\n  const hints = meta?.toolHints;\n  const group = operationToolGroup(operation);\n  const surface = meta?.surface ? surfacesByKey?.get(meta.surface) : undefined;\n  const parent = surface?.title || hints?.parent || surface?.entity;\n  const icon = hints?.icon || surface?.icon;\n  const defaultPermission = hints?.defaultPermission;\n  const description = operation.description ?? operation.summary;\n  return {\n    name: operation.operationId,\n    label: toolLabel(operation),\n    ...(group\n      ? { group, preferenceKey: group }\n      : meta?.surface\n        ? { group: meta.surface }\n        : {}),\n    ...(defaultPermission ? { defaultPermission } : {}),\n    ...(parent ? { parent } : {}),\n    ...(surface?.entity ? { entity: surface.entity } : {}),\n    ...(icon ? { icon } : {}),\n    ...(description ? { description } : {}),\n    ...(resolved?.method ? { method: resolved.method.toUpperCase() } : {}),\n    ...(resolved?.path ? { path: resolved.path } : {}),\n    strict: hints?.strict ?? true,\n    annotations: toolAnnotations(operation, resolved, description),\n    inputSchema: buildInputSchema(operation),\n  };\n}\n\nfunction toolAnnotations(\n  operation: OpenAPIOperation,\n  resolved: Pick<ResolvedOperation, \"path\" | \"method\"> | undefined,\n  description: string | undefined,\n): ToolAnnotations {\n  const hints = operation[\"x-clicky\"]?.toolHints;\n  const method = resolved?.method?.toUpperCase() ?? \"\";\n  const annotations: ToolAnnotations = {};\n  const title =\n    hints?.title ??\n    operation.summary ??\n    operation[\"x-clicky\"]?.actionName ??\n    description;\n  if (title) annotations.title = title;\n  if (hints?.readOnlyHint !== undefined) {\n    annotations.readOnlyHint = hints.readOnlyHint;\n  } else if (resolved?.method?.toUpperCase() === \"GET\") {\n    annotations.readOnlyHint = true;\n  }\n  if (hints?.idempotentHint !== undefined) {\n    annotations.idempotentHint = hints.idempotentHint;\n  } else if (isIdempotentMethod(method)) {\n    annotations.idempotentHint = true;\n  }\n  if (hints?.destructiveHint !== undefined) {\n    annotations.destructiveHint = hints.destructiveHint;\n  } else if (isDestructiveTool(operation, resolved)) {\n    annotations.destructiveHint = true;\n  }\n  if (hints?.openWorldHint !== undefined) {\n    annotations.openWorldHint = hints.openWorldHint;\n  }\n  return annotations;\n}\n\nfunction isIdempotentMethod(method: string): boolean {\n  return (\n    method === \"GET\" ||\n    method === \"HEAD\" ||\n    method === \"OPTIONS\" ||\n    method === \"PUT\" ||\n    method === \"DELETE\"\n  );\n}\n\nfunction isDestructiveTool(\n  operation: OpenAPIOperation,\n  resolved: Pick<ResolvedOperation, \"path\" | \"method\"> | undefined,\n): boolean {\n  const method = resolved?.method?.toUpperCase() ?? \"\";\n  if (method === \"DELETE\") return true;\n  if (method === \"GET\" || method === \"HEAD\" || method === \"OPTIONS\")\n    return false;\n  const text = `${resolved?.path ?? \"\"} ${operation.operationId ?? \"\"}`.toLowerCase();\n  return /\\b(write|delete|remove|destroy|void|sync|create|update|patch|post)\\b/.test(\n    text,\n  );\n}\n\nfunction operationToolGroup(\n  operation: OpenAPIOperation,\n): string | undefined {\n  const meta = operation[\"x-clicky\"];\n  if (meta?.toolHints?.group) return meta.toolHints.group;\n  if (meta?.group) return meta.group;\n  return undefined;\n}\n\nfunction isCobraHelpOrCompletionOperation(\n  operation: OpenAPIOperation,\n  resolved?: Pick<ResolvedOperation, \"path\" | \"method\">,\n): boolean {\n  return (\n    commandStartsWithCobraBuiltin(operation.operationId) ||\n    commandStartsWithCobraBuiltin(operation[\"x-clicky\"]?.command) ||\n    pathContainsCobraBuiltin(resolved?.path)\n  );\n}\n\nfunction commandStartsWithCobraBuiltin(raw: string | undefined): boolean {\n  if (!raw) return false;\n  const normalized = raw\n    .replace(/([a-z\\d])([A-Z])/g, \"$1 $2\")\n    .replace(/[/_.-]+/g, \" \")\n    .trim()\n    .toLowerCase();\n  const first = normalized.split(/\\s+/)[0];\n  return first === \"completion\" || first === \"help\";\n}\n\nfunction pathContainsCobraBuiltin(path: string | undefined): boolean {\n  if (!path) return false;\n  const parts = path\n    .split(\"/\")\n    .filter(Boolean)\n    .map((part) => part.toLowerCase());\n  const commandParts =\n    parts[0] === \"api\" && /^v\\d+$/.test(parts[1] ?? \"\")\n      ? parts.slice(2)\n      : parts;\n  const first = commandParts[0];\n  return first === \"completion\" || first === \"help\";\n}\n\n\n/** A concise popover label: the clicky action/verb (capitalized) when present,\n *  else the operation summary, else a humanized operationId. Mirrors the intent\n *  of rpc/clickyMetadata.ts `surfaceActionLabel`. */\nfunction toolLabel(operation: OpenAPIOperation): string {\n  const meta = operation[\"x-clicky\"];\n  const short = meta?.actionName?.trim() || meta?.verb?.trim();\n  if (short && short !== \"action\") {\n    return short.charAt(0).toUpperCase() + short.slice(1);\n  }\n  if (operation.summary) {\n    return operation.summary;\n  }\n  return humanize(operation.operationId ?? \"\");\n}\n\nfunction humanize(operationId: string): string {\n  const spaced = operationId\n    .replace(/[_-]+/g, \" \")\n    .replace(/([a-z\\d])([A-Z])/g, \"$1 $2\");\n  return spaced.charAt(0).toUpperCase() + spaced.slice(1);\n}\n\nfunction buildInputSchema(operation: OpenAPIOperation): ChatToolInputSchema {\n  const properties: Record<string, JSONSchemaProperty> = {};\n  const required: string[] = [];\n\n  for (const param of operation.parameters ?? []) {\n    properties[param.name] = parameterToProperty(param);\n    if (param.required) {\n      required.push(param.name);\n    }\n  }\n\n  const body = requestBodySchema(operation);\n  if (body?.properties) {\n    for (const [name, schema] of Object.entries(body.properties)) {\n      properties[name] = schemaToProperty(schema);\n    }\n  }\n\n  return { type: \"object\", properties, required, additionalProperties: false };\n}\n\nfunction parameterToProperty(param: OpenAPIParameter): JSONSchemaProperty {\n  const prop = schemaToProperty(param.schema);\n  if (param.description && !prop.description) {\n    prop.description = param.description;\n  }\n  return prop;\n}\n\nfunction schemaToProperty(\n  schema: OpenAPISchema | undefined,\n): JSONSchemaProperty {\n  if (!schema) {\n    return { type: \"string\" };\n  }\n  const prop: JSONSchemaProperty = { type: jsonSchemaType(schema.type) };\n  if (schema.description !== undefined) {\n    prop.description = schema.description;\n  }\n  if (schema.enum !== undefined) {\n    prop.enum = schema.enum;\n  }\n  if (schema.default !== undefined) {\n    prop.default = schema.default;\n  }\n  return prop;\n}\n\nfunction jsonSchemaType(\n  type: string | undefined,\n): NonNullable<JSONSchemaProperty[\"type\"]> {\n  switch (type) {\n    case \"object\":\n    case \"array\":\n    case \"string\":\n    case \"integer\":\n    case \"number\":\n    case \"boolean\":\n    case \"null\":\n      return type;\n    default:\n      return \"string\";\n  }\n}\n\nfunction requestBodySchema(\n  operation: OpenAPIOperation,\n): OpenAPISchema | undefined {\n  const content = operation.requestBody?.content;\n  if (!content) {\n    return undefined;\n  }\n  return (\n    content[\"application/json\"]?.schema ?? Object.values(content)[0]?.schema\n  );\n}\n"],"names":[],"mappings":"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"}

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

@@ -1,4 +1,4 @@
-import { OpenAPIOperation, ResolvedOperation } from '../../rpc/types';
+import { ClickySurface, OpenAPIOperation, ResolvedOperation } from '../../rpc/types';
 import { ToolMeta } from './types';
 /** Converts a clicky RPC operation catalog into AI-tool metadata for display
  *  and request scoping. Execution stays in the Go backend; this maps an
@@ -6,6 +6,6 @@ import { ToolMeta } from './types';
  *  label, the `x-clicky` surface → group, `summary`/`description` → description,
  *  and `parameters` + `requestBody` → a JSON-Schema input. Operations without an
  *  `operationId` are skipped (a tool needs a stable name). */
-export declare function clickyOperationsToTools(operations: ResolvedOperation[]): ToolMeta[];
-export declare function operationToTool(operation: OpenAPIOperation, resolved?: Pick<ResolvedOperation, "path" | "method">): ToolMeta | null;
+export declare function clickyOperationsToTools(operations: ResolvedOperation[], surfaces?: ClickySurface[]): ToolMeta[];
+export declare function operationToTool(operation: OpenAPIOperation, resolved?: Pick<ResolvedOperation, "path" | "method">, surfacesByKey?: Map<string, ClickySurface>): ToolMeta | null;
 //# sourceMappingURL=clickyOperationsToTools.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"clickyOperationsToTools.d.ts","sourceRoot":"","sources":["../../../src/data/chat/clickyOperationsToTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAGhB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAGV,QAAQ,EAET,MAAM,SAAS,CAAC;AAkBjB;;;;;8DAK8D;AAC9D,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,iBAAiB,EAAE,GAC9B,QAAQ,EAAE,CASZ;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,QAAQ,CAAC,GACpD,QAAQ,GAAG,IAAI,CAwBjB"}
+{"version":3,"file":"clickyOperationsToTools.d.ts","sourceRoot":"","sources":["../../../src/data/chat/clickyOperationsToTools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAGhB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAIV,QAAQ,EACT,MAAM,SAAS,CAAC;AAEjB;;;;;8DAK8D;AAC9D,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,iBAAiB,EAAE,EAC/B,QAAQ,CAAC,EAAE,aAAa,EAAE,GACzB,QAAQ,EAAE,CAaZ;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,gBAAgB,EAC3B,QAAQ,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,QAAQ,CAAC,EACrD,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,GACzC,QAAQ,GAAG,IAAI,CAkCjB"}

package/dist/data/chat/clickyOperationsToTools.js

@@ -1,28 +1,18 @@
-const DISABLED_TOOL_GROUP = "Disabled";
-const TOOL_GROUP_DEFAULTS = {
-  "Accounting Read": "enabled",
-  "Accounting Transaction Write": "ask",
-  "Accounting Metadata Write": "ask",
-  "Comments Read": "enabled",
-  "Comments Write": "ask",
-  "Xero Read": "disabled",
-  "Xero Write": "disabled",
-  "Takealot Read": "enabled",
-  "Takealot Write": "disabled",
-  "Admin Read": "enabled",
-  "Admin Write": "ask"
-};
-function clickyOperationsToTools(operations) {
+function clickyOperationsToTools(operations, surfaces) {
+  const surfacesByKey = /* @__PURE__ */ new Map();
+  for (const surface of surfaces ?? []) {
+    surfacesByKey.set(surface.key, surface);
+  }
   const tools = [];
   for (const resolved of operations) {
-    const tool = operationToTool(resolved.operation, resolved);
+    const tool = operationToTool(resolved.operation, resolved, surfacesByKey);
     if (tool) {
       tools.push(tool);
     }
   }
   return tools;
 }
-function operationToTool(operation, resolved) {
+function operationToTool(operation, resolved, surfacesByKey) {
   if (!operation.operationId) {
     return null;
   }
@@ -30,23 +20,76 @@ function operationToTool(operation, resolved) {
     return null;
   }
   const meta = operation["x-clicky"];
-  const group = operationToolGroup(operation, resolved);
-  if (group === DISABLED_TOOL_GROUP) {
-    return null;
-  }
+  const hints = meta == null ? void 0 : meta.toolHints;
+  const group = operationToolGroup(operation);
+  const surface = (meta == null ? void 0 : meta.surface) ? surfacesByKey == null ? void 0 : surfacesByKey.get(meta.surface) : void 0;
+  const parent = (surface == null ? void 0 : surface.title) || (hints == null ? void 0 : hints.parent) || (surface == null ? void 0 : surface.entity);
+  const icon = (hints == null ? void 0 : hints.icon) || (surface == null ? void 0 : surface.icon);
+  const defaultPermission = hints == null ? void 0 : hints.defaultPermission;
   const description = operation.description ?? operation.summary;
   return {
     name: operation.operationId,
     label: toolLabel(operation),
-    ...group ? { group, preferenceKey: group, defaultMode: toolDefaultMode(group) } : (meta == null ? void 0 : meta.surface) ? { group: meta.surface } : {},
+    ...group ? { group, preferenceKey: group } : (meta == null ? void 0 : meta.surface) ? { group: meta.surface } : {},
+    ...defaultPermission ? { defaultPermission } : {},
+    ...parent ? { parent } : {},
+    ...(surface == null ? void 0 : surface.entity) ? { entity: surface.entity } : {},
+    ...icon ? { icon } : {},
     ...description ? { description } : {},
+    ...(resolved == null ? void 0 : resolved.method) ? { method: resolved.method.toUpperCase() } : {},
+    ...(resolved == null ? void 0 : resolved.path) ? { path: resolved.path } : {},
+    strict: (hints == null ? void 0 : hints.strict) ?? true,
+    annotations: toolAnnotations(operation, resolved, description),
     inputSchema: buildInputSchema(operation)
   };
 }
-function operationToolGroup(operation, resolved) {
+function toolAnnotations(operation, resolved, description) {
+  var _a, _b, _c, _d;
+  const hints = (_a = operation["x-clicky"]) == null ? void 0 : _a.toolHints;
+  const method = ((_b = resolved == null ? void 0 : resolved.method) == null ? void 0 : _b.toUpperCase()) ?? "";
+  const annotations = {};
+  const title = (hints == null ? void 0 : hints.title) ?? operation.summary ?? ((_c = operation["x-clicky"]) == null ? void 0 : _c.actionName) ?? description;
+  if (title) annotations.title = title;
+  if ((hints == null ? void 0 : hints.readOnlyHint) !== void 0) {
+    annotations.readOnlyHint = hints.readOnlyHint;
+  } else if (((_d = resolved == null ? void 0 : resolved.method) == null ? void 0 : _d.toUpperCase()) === "GET") {
+    annotations.readOnlyHint = true;
+  }
+  if ((hints == null ? void 0 : hints.idempotentHint) !== void 0) {
+    annotations.idempotentHint = hints.idempotentHint;
+  } else if (isIdempotentMethod(method)) {
+    annotations.idempotentHint = true;
+  }
+  if ((hints == null ? void 0 : hints.destructiveHint) !== void 0) {
+    annotations.destructiveHint = hints.destructiveHint;
+  } else if (isDestructiveTool(operation, resolved)) {
+    annotations.destructiveHint = true;
+  }
+  if ((hints == null ? void 0 : hints.openWorldHint) !== void 0) {
+    annotations.openWorldHint = hints.openWorldHint;
+  }
+  return annotations;
+}
+function isIdempotentMethod(method) {
+  return method === "GET" || method === "HEAD" || method === "OPTIONS" || method === "PUT" || method === "DELETE";
+}
+function isDestructiveTool(operation, resolved) {
+  var _a;
+  const method = ((_a = resolved == null ? void 0 : resolved.method) == null ? void 0 : _a.toUpperCase()) ?? "";
+  if (method === "DELETE") return true;
+  if (method === "GET" || method === "HEAD" || method === "OPTIONS")
+    return false;
+  const text = `${(resolved == null ? void 0 : resolved.path) ?? ""} ${operation.operationId ?? ""}`.toLowerCase();
+  return /\b(write|delete|remove|destroy|void|sync|create|update|patch|post)\b/.test(
+    text
+  );
+}
+function operationToolGroup(operation) {
+  var _a;
   const meta = operation["x-clicky"];
+  if ((_a = meta == null ? void 0 : meta.toolHints) == null ? void 0 : _a.group) return meta.toolHints.group;
   if (meta == null ? void 0 : meta.group) return meta.group;
-  return inferToolGroup(operation, resolved);
+  return void 0;
 }
 function isCobraHelpOrCompletionOperation(operation, resolved) {
   var _a;
@@ -65,49 +108,6 @@ function pathContainsCobraBuiltin(path) {
   const first = commandParts[0];
   return first === "completion" || first === "help";
 }
-function inferToolGroup(operation, resolved) {
-  var _a;
-  const id = operation.operationId ?? "";
-  const tags = operation.tags ?? [];
-  const path = (resolved == null ? void 0 : resolved.path) ?? "";
-  const method = ((_a = resolved == null ? void 0 : resolved.method) == null ? void 0 : _a.toUpperCase()) ?? "";
-  const write = isWriteMethod(method);
-  if (path.startsWith("/api/v1/provider/") || id.startsWith("provider")) {
-    return write ? "Xero Write" : "Xero Read";
-  }
-  if (path.startsWith("/api/v1/comments") || path.startsWith("/api/v1/comment-messages") || /^(comments|commentMessages|comment)/.test(id)) {
-    return write ? "Comments Write" : "Comments Read";
-  }
-  if (path === "/api/v1/accounts/mapping" || id.startsWith("accountMapping")) {
-    return write ? "Accounting Metadata Write" : "Accounting Read";
-  }
-  if (path === "/api/v1/entity/metadata" || id.startsWith("entityMetadata")) {
-    return write ? "Accounting Metadata Write" : "Accounting Read";
-  }
-  if (path.startsWith("/api/v1/companies/") || id.startsWith("companyBranding")) {
-    return write ? "Accounting Metadata Write" : "Accounting Read";
-  }
-  if (path.startsWith("/api/v1/transactions") || path.startsWith("/api/v1/journals") || /^(transactions|journals)/.test(id)) {
-    return write ? "Accounting Transaction Write" : "Accounting Read";
-  }
-  if (path.startsWith("/api/v1/rules/") || path.startsWith("/api/v1/rates/") || path.startsWith("/api/v1/template/") || path.startsWith("/api/v1/formula/") || tags.some(
-    (tag) => ["rules", "rates", "template", "formula"].includes(tag)
-  ) || /^(rules|rates|template|formula)/.test(id)) {
-    return write && !isReadLikeOperation(id) ? "Admin Write" : "Admin Read";
-  }
-  return void 0;
-}
-function isWriteMethod(method) {
-  return method === "POST" || method === "PUT" || method === "PATCH" || method === "DELETE";
-}
-function isReadLikeOperation(operationId) {
-  return /(list|load|render|pdf|eval|context|validate|preview|coverage|entries|get|history|export)/i.test(
-    operationId
-  );
-}
-function toolDefaultMode(group) {
-  return TOOL_GROUP_DEFAULTS[group] ?? "ask";
-}
 function toolLabel(operation) {
   var _a, _b;
   const meta = operation["x-clicky"];
@@ -139,7 +139,7 @@ function buildInputSchema(operation) {
       properties[name] = schemaToProperty(schema);
     }
   }
-  return { type: "object", properties, required };
+  return { type: "object", properties, required, additionalProperties: false };
 }
 function parameterToProperty(param) {
   const prop = schemaToProperty(param.schema);
@@ -152,7 +152,7 @@ function schemaToProperty(schema) {
   if (!schema) {
     return { type: "string" };
   }
-  const prop = { type: schema.type ?? "string" };
+  const prop = { type: jsonSchemaType(schema.type) };
   if (schema.description !== void 0) {
     prop.description = schema.description;
   }
@@ -164,6 +164,20 @@ function schemaToProperty(schema) {
   }
   return prop;
 }
+function jsonSchemaType(type) {
+  switch (type) {
+    case "object":
+    case "array":
+    case "string":
+    case "integer":
+    case "number":
+    case "boolean":
+    case "null":
+      return type;
+    default:
+      return "string";
+  }
+}
 function requestBodySchema(operation) {
   var _a, _b, _c;
   const content = (_a = operation.requestBody) == null ? void 0 : _a.content;

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

@@ -1 +1 @@
-{"version":3,"file":"clickyOperationsToTools.js","sources":["../../../src/data/chat/clickyOperationsToTools.ts"],"sourcesContent":["import type {\n  OpenAPIOperation,\n  OpenAPIParameter,\n  OpenAPISchema,\n  ResolvedOperation,\n} from \"../../rpc/types\";\nimport type {\n  ChatToolInputSchema,\n  JSONSchemaProperty,\n  ToolMeta,\n  ToolMode,\n} from \"./types\";\n\nconst DISABLED_TOOL_GROUP = \"Disabled\";\n\nconst TOOL_GROUP_DEFAULTS: Record<string, ToolMode> = {\n  \"Accounting Read\": \"enabled\",\n  \"Accounting Transaction Write\": \"ask\",\n  \"Accounting Metadata Write\": \"ask\",\n  \"Comments Read\": \"enabled\",\n  \"Comments Write\": \"ask\",\n  \"Xero Read\": \"disabled\",\n  \"Xero Write\": \"disabled\",\n  \"Takealot Read\": \"enabled\",\n  \"Takealot Write\": \"disabled\",\n  \"Admin Read\": \"enabled\",\n  \"Admin Write\": \"ask\",\n};\n\n/** Converts a clicky RPC operation catalog into AI-tool metadata for display\n *  and request scoping. Execution stays in the Go backend; this maps an\n *  operation's `operationId` → tool name, a short `x-clicky` verb/action →\n *  label, the `x-clicky` surface → group, `summary`/`description` → description,\n *  and `parameters` + `requestBody` → a JSON-Schema input. Operations without an\n *  `operationId` are skipped (a tool needs a stable name). */\nexport function clickyOperationsToTools(\n  operations: ResolvedOperation[],\n): ToolMeta[] {\n  const tools: ToolMeta[] = [];\n  for (const resolved of operations) {\n    const tool = operationToTool(resolved.operation, resolved);\n    if (tool) {\n      tools.push(tool);\n    }\n  }\n  return tools;\n}\n\nexport function operationToTool(\n  operation: OpenAPIOperation,\n  resolved?: Pick<ResolvedOperation, \"path\" | \"method\">,\n): ToolMeta | null {\n  if (!operation.operationId) {\n    return null;\n  }\n  if (isCobraHelpOrCompletionOperation(operation, resolved)) {\n    return null;\n  }\n  const meta = operation[\"x-clicky\"];\n  const group = operationToolGroup(operation, resolved);\n  if (group === DISABLED_TOOL_GROUP) {\n    return null;\n  }\n  const description = operation.description ?? operation.summary;\n  return {\n    name: operation.operationId,\n    label: toolLabel(operation),\n    ...(group\n      ? { group, preferenceKey: group, defaultMode: toolDefaultMode(group) }\n      : meta?.surface\n        ? { group: meta.surface }\n        : {}),\n    ...(description ? { description } : {}),\n    inputSchema: buildInputSchema(operation),\n  };\n}\n\nfunction operationToolGroup(\n  operation: OpenAPIOperation,\n  resolved?: Pick<ResolvedOperation, \"path\" | \"method\">,\n): string | undefined {\n  const meta = operation[\"x-clicky\"];\n  if (meta?.group) return meta.group;\n  return inferToolGroup(operation, resolved);\n}\n\nfunction isCobraHelpOrCompletionOperation(\n  operation: OpenAPIOperation,\n  resolved?: Pick<ResolvedOperation, \"path\" | \"method\">,\n): boolean {\n  return (\n    commandStartsWithCobraBuiltin(operation.operationId) ||\n    commandStartsWithCobraBuiltin(operation[\"x-clicky\"]?.command) ||\n    pathContainsCobraBuiltin(resolved?.path)\n  );\n}\n\nfunction commandStartsWithCobraBuiltin(raw: string | undefined): boolean {\n  if (!raw) return false;\n  const normalized = raw\n    .replace(/([a-z\\d])([A-Z])/g, \"$1 $2\")\n    .replace(/[/_.-]+/g, \" \")\n    .trim()\n    .toLowerCase();\n  const first = normalized.split(/\\s+/)[0];\n  return first === \"completion\" || first === \"help\";\n}\n\nfunction pathContainsCobraBuiltin(path: string | undefined): boolean {\n  if (!path) return false;\n  const parts = path\n    .split(\"/\")\n    .filter(Boolean)\n    .map((part) => part.toLowerCase());\n  const commandParts =\n    parts[0] === \"api\" && /^v\\d+$/.test(parts[1] ?? \"\") ? parts.slice(2) : parts;\n  const first = commandParts[0];\n  return first === \"completion\" || first === \"help\";\n}\n\nfunction inferToolGroup(\n  operation: OpenAPIOperation,\n  resolved?: Pick<ResolvedOperation, \"path\" | \"method\">,\n): string | undefined {\n  const id = operation.operationId ?? \"\";\n  const tags = operation.tags ?? [];\n  const path = resolved?.path ?? \"\";\n  const method = resolved?.method?.toUpperCase() ?? \"\";\n  const write = isWriteMethod(method);\n\n  if (path.startsWith(\"/api/v1/provider/\") || id.startsWith(\"provider\")) {\n    return write ? \"Xero Write\" : \"Xero Read\";\n  }\n  if (\n    path.startsWith(\"/api/v1/comments\") ||\n    path.startsWith(\"/api/v1/comment-messages\") ||\n    /^(comments|commentMessages|comment)/.test(id)\n  ) {\n    return write ? \"Comments Write\" : \"Comments Read\";\n  }\n  if (path === \"/api/v1/accounts/mapping\" || id.startsWith(\"accountMapping\")) {\n    return write ? \"Accounting Metadata Write\" : \"Accounting Read\";\n  }\n  if (path === \"/api/v1/entity/metadata\" || id.startsWith(\"entityMetadata\")) {\n    return write ? \"Accounting Metadata Write\" : \"Accounting Read\";\n  }\n  if (\n    path.startsWith(\"/api/v1/companies/\") ||\n    id.startsWith(\"companyBranding\")\n  ) {\n    return write ? \"Accounting Metadata Write\" : \"Accounting Read\";\n  }\n  if (\n    path.startsWith(\"/api/v1/transactions\") ||\n    path.startsWith(\"/api/v1/journals\") ||\n    /^(transactions|journals)/.test(id)\n  ) {\n    return write ? \"Accounting Transaction Write\" : \"Accounting Read\";\n  }\n  if (\n    path.startsWith(\"/api/v1/rules/\") ||\n    path.startsWith(\"/api/v1/rates/\") ||\n    path.startsWith(\"/api/v1/template/\") ||\n    path.startsWith(\"/api/v1/formula/\") ||\n    tags.some((tag) =>\n      [\"rules\", \"rates\", \"template\", \"formula\"].includes(tag),\n    ) ||\n    /^(rules|rates|template|formula)/.test(id)\n  ) {\n    return write && !isReadLikeOperation(id) ? \"Admin Write\" : \"Admin Read\";\n  }\n  return undefined;\n}\n\nfunction isWriteMethod(method: string): boolean {\n  return (\n    method === \"POST\" ||\n    method === \"PUT\" ||\n    method === \"PATCH\" ||\n    method === \"DELETE\"\n  );\n}\n\nfunction isReadLikeOperation(operationId: string): boolean {\n  return /(list|load|render|pdf|eval|context|validate|preview|coverage|entries|get|history|export)/i.test(\n    operationId,\n  );\n}\n\nfunction toolDefaultMode(group: string): ToolMode {\n  return TOOL_GROUP_DEFAULTS[group] ?? \"ask\";\n}\n\n/** A concise popover label: the clicky action/verb (capitalized) when present,\n *  else the operation summary, else a humanized operationId. Mirrors the intent\n *  of rpc/clickyMetadata.ts `surfaceActionLabel`. */\nfunction toolLabel(operation: OpenAPIOperation): string {\n  const meta = operation[\"x-clicky\"];\n  const short = meta?.actionName?.trim() || meta?.verb?.trim();\n  if (short && short !== \"action\") {\n    return short.charAt(0).toUpperCase() + short.slice(1);\n  }\n  if (operation.summary) {\n    return operation.summary;\n  }\n  return humanize(operation.operationId ?? \"\");\n}\n\nfunction humanize(operationId: string): string {\n  const spaced = operationId\n    .replace(/[_-]+/g, \" \")\n    .replace(/([a-z\\d])([A-Z])/g, \"$1 $2\");\n  return spaced.charAt(0).toUpperCase() + spaced.slice(1);\n}\n\nfunction buildInputSchema(operation: OpenAPIOperation): ChatToolInputSchema {\n  const properties: Record<string, JSONSchemaProperty> = {};\n  const required: string[] = [];\n\n  for (const param of operation.parameters ?? []) {\n    properties[param.name] = parameterToProperty(param);\n    if (param.required) {\n      required.push(param.name);\n    }\n  }\n\n  const body = requestBodySchema(operation);\n  if (body?.properties) {\n    for (const [name, schema] of Object.entries(body.properties)) {\n      properties[name] = schemaToProperty(schema);\n    }\n  }\n\n  return { type: \"object\", properties, required };\n}\n\nfunction parameterToProperty(param: OpenAPIParameter): JSONSchemaProperty {\n  const prop = schemaToProperty(param.schema);\n  if (param.description && !prop.description) {\n    prop.description = param.description;\n  }\n  return prop;\n}\n\nfunction schemaToProperty(\n  schema: OpenAPISchema | undefined,\n): JSONSchemaProperty {\n  if (!schema) {\n    return { type: \"string\" };\n  }\n  const prop: JSONSchemaProperty = { type: schema.type ?? \"string\" };\n  if (schema.description !== undefined) {\n    prop.description = schema.description;\n  }\n  if (schema.enum !== undefined) {\n    prop.enum = schema.enum;\n  }\n  if (schema.default !== undefined) {\n    prop.default = schema.default;\n  }\n  return prop;\n}\n\nfunction requestBodySchema(\n  operation: OpenAPIOperation,\n): OpenAPISchema | undefined {\n  const content = operation.requestBody?.content;\n  if (!content) {\n    return undefined;\n  }\n  return (\n    content[\"application/json\"]?.schema ?? Object.values(content)[0]?.schema\n  );\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"clickyOperationsToTools.js","sources":["../../../src/data/chat/clickyOperationsToTools.ts"],"sourcesContent":["import type {\n  ClickySurface,\n  OpenAPIOperation,\n  OpenAPIParameter,\n  OpenAPISchema,\n  ResolvedOperation,\n} from \"../../rpc/types\";\nimport type {\n  ChatToolInputSchema,\n  JSONSchemaProperty,\n  ToolAnnotations,\n  ToolMeta,\n} from \"./types\";\n\n/** Converts a clicky RPC operation catalog into AI-tool metadata for display\n *  and request scoping. Execution stays in the Go backend; this maps an\n *  operation's `operationId` → tool name, a short `x-clicky` verb/action →\n *  label, the `x-clicky` surface → group, `summary`/`description` → description,\n *  and `parameters` + `requestBody` → a JSON-Schema input. Operations without an\n *  `operationId` are skipped (a tool needs a stable name). */\nexport function clickyOperationsToTools(\n  operations: ResolvedOperation[],\n  surfaces?: ClickySurface[],\n): ToolMeta[] {\n  const surfacesByKey = new Map<string, ClickySurface>();\n  for (const surface of surfaces ?? []) {\n    surfacesByKey.set(surface.key, surface);\n  }\n  const tools: ToolMeta[] = [];\n  for (const resolved of operations) {\n    const tool = operationToTool(resolved.operation, resolved, surfacesByKey);\n    if (tool) {\n      tools.push(tool);\n    }\n  }\n  return tools;\n}\n\nexport function operationToTool(\n  operation: OpenAPIOperation,\n  resolved?: Pick<ResolvedOperation, \"path\" | \"method\">,\n  surfacesByKey?: Map<string, ClickySurface>,\n): ToolMeta | null {\n  if (!operation.operationId) {\n    return null;\n  }\n  if (isCobraHelpOrCompletionOperation(operation, resolved)) {\n    return null;\n  }\n  const meta = operation[\"x-clicky\"];\n  const hints = meta?.toolHints;\n  const group = operationToolGroup(operation);\n  const surface = meta?.surface ? surfacesByKey?.get(meta.surface) : undefined;\n  const parent = surface?.title || hints?.parent || surface?.entity;\n  const icon = hints?.icon || surface?.icon;\n  const defaultPermission = hints?.defaultPermission;\n  const description = operation.description ?? operation.summary;\n  return {\n    name: operation.operationId,\n    label: toolLabel(operation),\n    ...(group\n      ? { group, preferenceKey: group }\n      : meta?.surface\n        ? { group: meta.surface }\n        : {}),\n    ...(defaultPermission ? { defaultPermission } : {}),\n    ...(parent ? { parent } : {}),\n    ...(surface?.entity ? { entity: surface.entity } : {}),\n    ...(icon ? { icon } : {}),\n    ...(description ? { description } : {}),\n    ...(resolved?.method ? { method: resolved.method.toUpperCase() } : {}),\n    ...(resolved?.path ? { path: resolved.path } : {}),\n    strict: hints?.strict ?? true,\n    annotations: toolAnnotations(operation, resolved, description),\n    inputSchema: buildInputSchema(operation),\n  };\n}\n\nfunction toolAnnotations(\n  operation: OpenAPIOperation,\n  resolved: Pick<ResolvedOperation, \"path\" | \"method\"> | undefined,\n  description: string | undefined,\n): ToolAnnotations {\n  const hints = operation[\"x-clicky\"]?.toolHints;\n  const method = resolved?.method?.toUpperCase() ?? \"\";\n  const annotations: ToolAnnotations = {};\n  const title =\n    hints?.title ??\n    operation.summary ??\n    operation[\"x-clicky\"]?.actionName ??\n    description;\n  if (title) annotations.title = title;\n  if (hints?.readOnlyHint !== undefined) {\n    annotations.readOnlyHint = hints.readOnlyHint;\n  } else if (resolved?.method?.toUpperCase() === \"GET\") {\n    annotations.readOnlyHint = true;\n  }\n  if (hints?.idempotentHint !== undefined) {\n    annotations.idempotentHint = hints.idempotentHint;\n  } else if (isIdempotentMethod(method)) {\n    annotations.idempotentHint = true;\n  }\n  if (hints?.destructiveHint !== undefined) {\n    annotations.destructiveHint = hints.destructiveHint;\n  } else if (isDestructiveTool(operation, resolved)) {\n    annotations.destructiveHint = true;\n  }\n  if (hints?.openWorldHint !== undefined) {\n    annotations.openWorldHint = hints.openWorldHint;\n  }\n  return annotations;\n}\n\nfunction isIdempotentMethod(method: string): boolean {\n  return (\n    method === \"GET\" ||\n    method === \"HEAD\" ||\n    method === \"OPTIONS\" ||\n    method === \"PUT\" ||\n    method === \"DELETE\"\n  );\n}\n\nfunction isDestructiveTool(\n  operation: OpenAPIOperation,\n  resolved: Pick<ResolvedOperation, \"path\" | \"method\"> | undefined,\n): boolean {\n  const method = resolved?.method?.toUpperCase() ?? \"\";\n  if (method === \"DELETE\") return true;\n  if (method === \"GET\" || method === \"HEAD\" || method === \"OPTIONS\")\n    return false;\n  const text = `${resolved?.path ?? \"\"} ${operation.operationId ?? \"\"}`.toLowerCase();\n  return /\\b(write|delete|remove|destroy|void|sync|create|update|patch|post)\\b/.test(\n    text,\n  );\n}\n\nfunction operationToolGroup(\n  operation: OpenAPIOperation,\n): string | undefined {\n  const meta = operation[\"x-clicky\"];\n  if (meta?.toolHints?.group) return meta.toolHints.group;\n  if (meta?.group) return meta.group;\n  return undefined;\n}\n\nfunction isCobraHelpOrCompletionOperation(\n  operation: OpenAPIOperation,\n  resolved?: Pick<ResolvedOperation, \"path\" | \"method\">,\n): boolean {\n  return (\n    commandStartsWithCobraBuiltin(operation.operationId) ||\n    commandStartsWithCobraBuiltin(operation[\"x-clicky\"]?.command) ||\n    pathContainsCobraBuiltin(resolved?.path)\n  );\n}\n\nfunction commandStartsWithCobraBuiltin(raw: string | undefined): boolean {\n  if (!raw) return false;\n  const normalized = raw\n    .replace(/([a-z\\d])([A-Z])/g, \"$1 $2\")\n    .replace(/[/_.-]+/g, \" \")\n    .trim()\n    .toLowerCase();\n  const first = normalized.split(/\\s+/)[0];\n  return first === \"completion\" || first === \"help\";\n}\n\nfunction pathContainsCobraBuiltin(path: string | undefined): boolean {\n  if (!path) return false;\n  const parts = path\n    .split(\"/\")\n    .filter(Boolean)\n    .map((part) => part.toLowerCase());\n  const commandParts =\n    parts[0] === \"api\" && /^v\\d+$/.test(parts[1] ?? \"\")\n      ? parts.slice(2)\n      : parts;\n  const first = commandParts[0];\n  return first === \"completion\" || first === \"help\";\n}\n\n\n/** A concise popover label: the clicky action/verb (capitalized) when present,\n *  else the operation summary, else a humanized operationId. Mirrors the intent\n *  of rpc/clickyMetadata.ts `surfaceActionLabel`. */\nfunction toolLabel(operation: OpenAPIOperation): string {\n  const meta = operation[\"x-clicky\"];\n  const short = meta?.actionName?.trim() || meta?.verb?.trim();\n  if (short && short !== \"action\") {\n    return short.charAt(0).toUpperCase() + short.slice(1);\n  }\n  if (operation.summary) {\n    return operation.summary;\n  }\n  return humanize(operation.operationId ?? \"\");\n}\n\nfunction humanize(operationId: string): string {\n  const spaced = operationId\n    .replace(/[_-]+/g, \" \")\n    .replace(/([a-z\\d])([A-Z])/g, \"$1 $2\");\n  return spaced.charAt(0).toUpperCase() + spaced.slice(1);\n}\n\nfunction buildInputSchema(operation: OpenAPIOperation): ChatToolInputSchema {\n  const properties: Record<string, JSONSchemaProperty> = {};\n  const required: string[] = [];\n\n  for (const param of operation.parameters ?? []) {\n    properties[param.name] = parameterToProperty(param);\n    if (param.required) {\n      required.push(param.name);\n    }\n  }\n\n  const body = requestBodySchema(operation);\n  if (body?.properties) {\n    for (const [name, schema] of Object.entries(body.properties)) {\n      properties[name] = schemaToProperty(schema);\n    }\n  }\n\n  return { type: \"object\", properties, required, additionalProperties: false };\n}\n\nfunction parameterToProperty(param: OpenAPIParameter): JSONSchemaProperty {\n  const prop = schemaToProperty(param.schema);\n  if (param.description && !prop.description) {\n    prop.description = param.description;\n  }\n  return prop;\n}\n\nfunction schemaToProperty(\n  schema: OpenAPISchema | undefined,\n): JSONSchemaProperty {\n  if (!schema) {\n    return { type: \"string\" };\n  }\n  const prop: JSONSchemaProperty = { type: jsonSchemaType(schema.type) };\n  if (schema.description !== undefined) {\n    prop.description = schema.description;\n  }\n  if (schema.enum !== undefined) {\n    prop.enum = schema.enum;\n  }\n  if (schema.default !== undefined) {\n    prop.default = schema.default;\n  }\n  return prop;\n}\n\nfunction jsonSchemaType(\n  type: string | undefined,\n): NonNullable<JSONSchemaProperty[\"type\"]> {\n  switch (type) {\n    case \"object\":\n    case \"array\":\n    case \"string\":\n    case \"integer\":\n    case \"number\":\n    case \"boolean\":\n    case \"null\":\n      return type;\n    default:\n      return \"string\";\n  }\n}\n\nfunction requestBodySchema(\n  operation: OpenAPIOperation,\n): OpenAPISchema | undefined {\n  const content = operation.requestBody?.content;\n  if (!content) {\n    return undefined;\n  }\n  return (\n    content[\"application/json\"]?.schema ?? Object.values(content)[0]?.schema\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/data/chat/effort-icons.cjs

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const UiBatteryChargingVertical = require("../../icons/components/UiBatteryChargingVertical.cjs");
+const UiBatteryVerticalFull = require("../../icons/components/UiBatteryVerticalFull.cjs");
+const UiBatteryVerticalHigh = require("../../icons/components/UiBatteryVerticalHigh.cjs");
+const UiBatteryVerticalMedium = require("../../icons/components/UiBatteryVerticalMedium.cjs");
+const UiBatteryVerticalLow = require("../../icons/components/UiBatteryVerticalLow.cjs");
+const UiBatteryVerticalEmpty = require("../../icons/components/UiBatteryVerticalEmpty.cjs");
+const EFFORT_LEVEL_ICONS = {
+  minimal: UiBatteryVerticalEmpty.UiBatteryVerticalEmpty,
+  low: UiBatteryVerticalLow.UiBatteryVerticalLow,
+  medium: UiBatteryVerticalMedium.UiBatteryVerticalMedium,
+  high: UiBatteryVerticalHigh.UiBatteryVerticalHigh,
+  max: UiBatteryVerticalFull.UiBatteryVerticalFull,
+  adaptive: UiBatteryChargingVertical.UiBatteryChargingVertical
+};
+const EFFORT_LEVEL_COLOR = {
+  minimal: "text-slate-500 [[data-theme=dark]_&]:text-slate-400",
+  low: "text-sky-500 [[data-theme=dark]_&]:text-sky-400",
+  medium: "text-amber-500 [[data-theme=dark]_&]:text-amber-400",
+  high: "text-orange-500 [[data-theme=dark]_&]:text-orange-400",
+  max: "text-red-500 [[data-theme=dark]_&]:text-red-400",
+  adaptive: "text-indigo-500 [[data-theme=dark]_&]:text-indigo-400"
+};
+function effortKey(value) {
+  const key = value.trim().toLowerCase();
+  if (key in EFFORT_LEVEL_ICONS) return key;
+  if (key === "xhigh") return "high";
+  return void 0;
+}
+function effortLevelIcon(value) {
+  const key = effortKey(value);
+  return key ? EFFORT_LEVEL_ICONS[key] : void 0;
+}
+function effortLevelColor(value) {
+  const key = effortKey(value);
+  return key ? EFFORT_LEVEL_COLOR[key] : void 0;
+}
+exports.EFFORT_LEVEL_COLOR = EFFORT_LEVEL_COLOR;
+exports.EFFORT_LEVEL_ICONS = EFFORT_LEVEL_ICONS;
+exports.effortLevelColor = effortLevelColor;
+exports.effortLevelIcon = effortLevelIcon;
+//# sourceMappingURL=effort-icons.cjs.map

package/dist/data/chat/effort-icons.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"effort-icons.cjs","sources":["../../../src/data/chat/effort-icons.ts"],"sourcesContent":["import type { StaticIconComponent } from \"../Icon\";\nimport {\n  UiBatteryChargingVertical,\n  UiBatteryVerticalEmpty,\n  UiBatteryVerticalFull,\n  UiBatteryVerticalHigh,\n  UiBatteryVerticalLow,\n  UiBatteryVerticalMedium,\n} from \"../../icons\";\n\n// Reasoning / token-budget levels drawn as a filling vertical battery — the\n// glyph reads as \"budget filled\", adaptive charges up or down per step. The\n// icon map is the source of truth (chat layer); the AI session layer composes\n// semantic tone + label on top in agent-action-icons.ts.\n\nexport type EffortLevel =\n  | \"minimal\"\n  | \"low\"\n  | \"medium\"\n  | \"high\"\n  | \"max\"\n  | \"adaptive\";\n\nexport const EFFORT_LEVEL_ICONS: Record<EffortLevel, StaticIconComponent> = {\n  minimal: UiBatteryVerticalEmpty,\n  low: UiBatteryVerticalLow,\n  medium: UiBatteryVerticalMedium,\n  high: UiBatteryVerticalHigh,\n  max: UiBatteryVerticalFull,\n  adaptive: UiBatteryChargingVertical,\n};\n\n// Text-color class per level, climbing the issue-severity ramp (slate → sky →\n// amber → orange → red) with adaptive on indigo. Mirrors the tones the AI layer\n// assigns in agent-action-icons.ts; kept as literal classes so Tailwind scans\n// them and dark mode keys off the `data-theme` attribute (not `dark:`).\nexport const EFFORT_LEVEL_COLOR: Record<EffortLevel, string> = {\n  minimal: \"text-slate-500 [[data-theme=dark]_&]:text-slate-400\",\n  low: \"text-sky-500 [[data-theme=dark]_&]:text-sky-400\",\n  medium: \"text-amber-500 [[data-theme=dark]_&]:text-amber-400\",\n  high: \"text-orange-500 [[data-theme=dark]_&]:text-orange-400\",\n  max: \"text-red-500 [[data-theme=dark]_&]:text-red-400\",\n  adaptive: \"text-indigo-500 [[data-theme=dark]_&]:text-indigo-400\",\n};\n\nfunction effortKey(value: string): EffortLevel | undefined {\n  const key = value.trim().toLowerCase();\n  if (key in EFFORT_LEVEL_ICONS) return key as EffortLevel;\n  if (key === \"xhigh\") return \"high\";\n  return undefined;\n}\n\n/** Battery glyph for an effort value, tolerating aliases (`xhigh` → high).\n *  Returns undefined when the value isn't a known effort level. */\nexport function effortLevelIcon(value: string): StaticIconComponent | undefined {\n  const key = effortKey(value);\n  return key ? EFFORT_LEVEL_ICONS[key] : undefined;\n}\n\n/** Tone text-color class for an effort value, or undefined when unknown. */\nexport function effortLevelColor(value: string): string | undefined {\n  const key = effortKey(value);\n  return key ? EFFORT_LEVEL_COLOR[key] : undefined;\n}\n"],"names":["UiBatteryVerticalEmpty","UiBatteryVerticalLow","UiBatteryVerticalMedium","UiBatteryVerticalHigh","UiBatteryVerticalFull","UiBatteryChargingVertical"],"mappings":";;;;;;;;AAuBO,MAAM,qBAA+D;AAAA,EAC1E,SAASA,uBAAAA;AAAAA,EACT,KAAKC,qBAAAA;AAAAA,EACL,QAAQC,wBAAAA;AAAAA,EACR,MAAMC,sBAAAA;AAAAA,EACN,KAAKC,sBAAAA;AAAAA,EACL,UAAUC,0BAAAA;AACZ;AAMO,MAAM,qBAAkD;AAAA,EAC7D,SAAS;AAAA,EACT,KAAK;AAAA,EACL,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,KAAK;AAAA,EACL,UAAU;AACZ;AAEA,SAAS,UAAU,OAAwC;AACzD,QAAM,MAAM,MAAM,KAAA,EAAO,YAAA;AACzB,MAAI,OAAO,mBAAoB,QAAO;AACtC,MAAI,QAAQ,QAAS,QAAO;AAC5B,SAAO;AACT;AAIO,SAAS,gBAAgB,OAAgD;AAC9E,QAAM,MAAM,UAAU,KAAK;AAC3B,SAAO,MAAM,mBAAmB,GAAG,IAAI;AACzC;AAGO,SAAS,iBAAiB,OAAmC;AAClE,QAAM,MAAM,UAAU,KAAK;AAC3B,SAAO,MAAM,mBAAmB,GAAG,IAAI;AACzC;;;;;"}