robotrock 1.3.2 → 1.3.4

package/dist/eve/tools/index.d.ts

@@ -12,7 +12,7 @@ import '../../tool-reply-guidance-C3qrT1In.js';
 import 'zod';
 import '../../tenant-DmN0MMyC.js';
 import 'eve/context';
-import '@robotrock/core';
+import '../../tool-ui-hint-CMpug5sC.js';
 
 type CreateRobotrockToolsOptions = {
     inbox?: false | DefineCreateInboxTaskToolOptions;

package/dist/eve/tools/index.js

@@ -1710,6 +1710,15 @@ async function postRobotRockLinkChatTask(ctx, input) {
   }
 }
 
+// src/eve/tool-ui-hint.ts
+var TOOL_UI_HINT_FIELD = "uiHint";
+function withUiHint(result, hint) {
+  return {
+    ...result,
+    [TOOL_UI_HINT_FIELD]: hint
+  };
+}
+
 // src/eve/tool-reply-guidance.ts
 var TOOL_REPLY_GUIDANCE_FIELD = "replyGuidance";
 var WHOAMI_REPLY_GUIDANCE = "The dashboard shows a profile card with name, email, workspace, role, and groups. Do not restate those in your reply. Only add context not in the card (e.g. permissions, refund approval rules, missing group membership).";
@@ -1824,69 +1833,22 @@ var createInboxTaskTool = defineCreateInboxTaskTool();
 import { defineTool as defineTool2 } from "eve/tools";
 import { z as z7 } from "zod";
 
-// src/eve/tool-result-display.ts
-function toolDisplayResult(data, options) {
-  const display = options?.widget || options?.title || options?.description ? {
-    ...options.widget ? { widget: options.widget } : {},
-    ...options.title ? { title: options.title } : {},
-    ...options.description ? { description: options.description } : {}
-  } : void 0;
-  return {
-    ...display ? { display } : {},
-    data,
-    ...options?.ui ? { ui: options.ui } : {}
-  };
-}
-
 // src/eve/tool-display-format.ts
 function formatToolObjectResult(data, options) {
-  return withReplyGuidance(
-    toolDisplayResult(data, {
-      title: options.title,
-      description: options.description,
-      ui: options.ui
-    }),
-    options.replyGuidance
-  );
+  const withGuidance = withReplyGuidance(data, options.replyGuidance);
+  if (options.uiHint) {
+    return withUiHint(withGuidance, options.uiHint);
+  }
+  return withGuidance;
 }
 function formatToolListResult(listKey, items, options) {
-  const listFieldUi = options.itemWidget ? {
-    "ui:widget": "list",
-    items: {
-      "ui:widget": options.itemWidget,
-      ...options.itemUi ?? {}
-    }
-  } : {
-    "ui:widget": "table",
-    ...options.itemUi ? { items: options.itemUi } : {}
-  };
-  return formatToolObjectResult(
-    { [listKey]: items },
-    {
-      title: options.title,
-      ui: {
-        [listKey]: listFieldUi
-      },
-      replyGuidance: options.replyGuidance
-    }
+  return withUiHint(
+    withReplyGuidance({ [listKey]: items }, options.replyGuidance),
+    "list"
   );
 }
 
 // src/eve/tools/identity/format-my-access.ts
-var ACCESS_FIELD_UI = {
-  workspace: { "ui:title": "Workspace" },
-  role: { "ui:title": "Role" },
-  tenantAdmin: { "ui:title": "Tenant admin", "ui:widget": "boolean" },
-  groups: { "ui:title": "Groups" },
-  manageSettings: { "ui:title": "Manage settings", "ui:widget": "boolean" },
-  manageBilling: { "ui:title": "Manage billing", "ui:widget": "boolean" },
-  manageTeam: { "ui:title": "Manage team", "ui:widget": "boolean" },
-  manageIntegrations: {
-    "ui:title": "Manage integrations",
-    "ui:widget": "boolean"
-  },
-  email: { "ui:title": "Email" }
-};
 function formatMyAccessResult(input) {
   return formatToolObjectResult(
     {
@@ -1903,13 +1865,6 @@ function formatMyAccessResult(input) {
       }
     },
     {
-      ui: {
-        access: {
-          "ui:widget": "access",
-          "ui:title": "Your access",
-          items: ACCESS_FIELD_UI
-        }
-      },
       replyGuidance: MY_ACCESS_REPLY_GUIDANCE
     }
   );
@@ -1928,7 +1883,7 @@ function tenantCapabilities(isAdmin) {
 }
 function defineMyAccessTool() {
   return defineTool2({
-    description: "Check the authenticated user's tenant role, group memberships, and admin capabilities in RobotRock. Results render as an access card in chat \u2014 do not restate role, groups, or capabilities in your reply.",
+    description: "Check the authenticated user's tenant role, group memberships, and admin capabilities in RobotRock. Always call this before tenant-admin tools (manage_team_members, manage_groups, query_tasks) in the same turn \u2014 including read-only requests like listing users. Results render as a visible access tool card in chat like other tools; do not restate role, groups, or capabilities in your reply.",
     inputSchema: myAccessInputSchema,
     async execute(_input, ctx) {
       const caller = tryResolveTenantCaller(ctx);
@@ -2026,31 +1981,14 @@ var DEMO_PRODUCTS = [
 ];
 function defineSearchProductsTool() {
   return defineTool4({
-    description: "Search the product catalog and return matching items with rich list UI. Results render as a product list card \u2014 do not restate product names, prices, or SKUs in your reply.",
+    description: "Search the product catalog and return matching items. Results render in chat UI \u2014 do not restate product names, prices, or SKUs in your reply.",
     inputSchema: searchProductsInputSchema,
     async execute({ query }) {
       const normalized = query.trim().toLowerCase();
       const items = DEMO_PRODUCTS.filter(
         (product) => product.name.toLowerCase().includes(normalized) || product.id.toLowerCase().includes(normalized)
       );
-      return withReplyGuidance(
-        toolDisplayResult(
-          { items: [...items] },
-          {
-            title: items.length === 1 ? "1 product" : `${items.length} products`,
-            ui: {
-              items: {
-                "ui:widget": "list",
-                "ui:title": "Results",
-                items: {
-                  "ui:widget": "productInfo"
-                }
-              }
-            }
-          }
-        ),
-        SEARCH_PRODUCTS_REPLY_GUIDANCE
-      );
+      return withReplyGuidance({ items: [...items] }, SEARCH_PRODUCTS_REPLY_GUIDANCE);
     }
   });
 }
@@ -2227,12 +2165,6 @@ function requireBoundAgentAdminClient(ctx) {
 }
 
 // src/eve/tools/admin/format-team-members-list.ts
-var MEMBER_DETAIL_UI = {
-  name: { "ui:title": "Name" },
-  email: { "ui:title": "Email" },
-  role: { "ui:title": "Role" },
-  membershipKind: { "ui:title": "Membership" }
-};
 function serializeMemberRow(member) {
   return {
     name: member.user.name,
@@ -2242,21 +2174,16 @@ function serializeMemberRow(member) {
   };
 }
 function formatTeamMembersListResult(members) {
-  const countLabel = members.length === 1 ? "1 team member" : `${members.length} team members`;
   return formatToolListResult(
     "members",
     members.map(serializeMemberRow),
     {
-      title: countLabel,
-      itemWidget: "tenantMember",
       replyGuidance: MANAGE_TEAM_MEMBERS_LIST_REPLY_GUIDANCE
     }
   );
 }
-function formatTeamMemberDetailResult(member, options) {
+function formatTeamMemberDetailResult(member) {
   return formatToolObjectResult(serializeMemberRow(member), {
-    title: options?.title ?? member.user.name,
-    ui: MEMBER_DETAIL_UI,
     replyGuidance: MANAGE_TEAM_MEMBERS_DETAIL_REPLY_GUIDANCE
   });
 }
@@ -2308,19 +2235,14 @@ var manageTeamMembersInputSchema = z10.object({
 function resolveMemberRef(input) {
   return input.userId ?? input.email;
 }
-function formatMemberMutationResult(payload, title) {
+function formatMemberMutationResult(payload) {
   return formatToolObjectResult(payload, {
-    title,
-    ui: {
-      success: { "ui:title": "Success", "ui:widget": "boolean" },
-      promoted: { "ui:title": "Promoted existing user", "ui:widget": "boolean" }
-    },
     replyGuidance: ADMIN_MUTATION_REPLY_GUIDANCE
   });
 }
 function defineManageTeamMembersTool() {
   return defineTool5({
-    description: "Tenant-admin tool for workspace team members: list, get, invite, change role, or remove. Requires tenant admin access. Use member email from list results for get, update_role, and remove \u2014 internal ids are optional. Results render as chat UI cards \u2014 do not restate member names, emails, or roles in your reply.",
+    description: "Tenant-admin tool for workspace team members: list, get, invite, change role, or remove. Requires tenant admin access. Call get_my_access in the same turn before this tool to verify admin access (the check renders as its own chat tool card). Use member email from list results for get, update_role, and remove \u2014 internal ids are optional. Results render as chat UI cards \u2014 do not restate member names, emails, or roles in your reply.",
     inputSchema: manageTeamMembersInputSchema,
     async execute(input, ctx) {
       const api = requireBoundAgentAdminClient(ctx);
@@ -2343,13 +2265,11 @@ function defineManageTeamMembersTool() {
             });
             if (result.member) {
               return formatTeamMemberDetailResult(
-                result.member,
-                { title: "Member invited" }
+                result.member
               );
             }
             return formatMemberMutationResult(
-              result,
-              "Invitation sent"
+              result
             );
           }
           case "update_role": {
@@ -2358,16 +2278,14 @@ function defineManageTeamMembersTool() {
               input.role
             );
             return formatMemberMutationResult(
-              result,
-              "Member role updated"
+              result
             );
           }
           case "remove": {
             const memberId = resolveMemberRef(input);
             const result = await api.members.remove(memberId);
             return formatMemberMutationResult(
-              result,
-              "Member removed"
+              result
             );
           }
         }
@@ -2392,12 +2310,6 @@ import { defineTool as defineTool6 } from "eve/tools";
 import { z as z11 } from "zod";
 
 // src/eve/tools/admin/format-groups-list.ts
-var GROUP_ITEM_UI = {
-  name: { "ui:title": "Name" },
-  slug: { "ui:title": "Slug" },
-  description: { "ui:title": "Description" },
-  memberCount: { "ui:title": "Members", "ui:widget": "number" }
-};
 function serializeGroupRow(group) {
   return {
     name: group.name,
@@ -2407,13 +2319,10 @@ function serializeGroupRow(group) {
   };
 }
 function formatGroupsListResult(groups) {
-  const countLabel = groups.length === 1 ? "1 group" : `${groups.length} groups`;
   return formatToolListResult(
     "groups",
     groups.map(serializeGroupRow),
     {
-      title: countLabel,
-      itemWidget: "tenantGroup",
       replyGuidance: MANAGE_GROUPS_LIST_REPLY_GUIDANCE
     }
   );
@@ -2430,28 +2339,12 @@ function formatGroupDetailResult(group) {
       }))
     },
     {
-      title: group.name,
-      ui: {
-        name: { "ui:title": "Name" },
-        slug: { "ui:title": "Slug" },
-        description: { "ui:title": "Description" },
-        members: {
-          "ui:widget": "list",
-          "ui:title": "Members",
-          items: {
-            name: { "ui:title": "Name" },
-            email: { "ui:title": "Email" }
-          }
-        }
-      },
       replyGuidance: MANAGE_GROUPS_DETAIL_REPLY_GUIDANCE
     }
   );
 }
 function formatGroupSummaryResult(group) {
   return formatToolObjectResult(serializeGroupRow(group), {
-    title: group.name,
-    ui: GROUP_ITEM_UI,
     replyGuidance: MANAGE_GROUPS_DETAIL_REPLY_GUIDANCE
   });
 }
@@ -2520,9 +2413,8 @@ var manageGroupsInputSchema = z11.object({
       break;
   }
 });
-function formatGroupMutationResult(payload, title) {
+function formatGroupMutationResult(payload) {
   return formatToolObjectResult(payload, {
-    title,
     replyGuidance: ADMIN_MUTATION_REPLY_GUIDANCE
   });
 }
@@ -2534,7 +2426,7 @@ function resolveMemberRef2(input) {
 }
 function defineManageGroupsTool() {
   return defineTool6({
-    description: "Tenant-admin tool for workspace groups: list, get, create, update, delete, and manage group membership. Requires tenant admin access. Use group slug (e.g. finance) from list results for get and membership actions \u2014 internal ids are optional. Use member email for add_member and remove_member when user ids are unknown. Results render as chat UI cards \u2014 do not restate group or member fields in your reply.",
+    description: "Tenant-admin tool for workspace groups: list, get, create, update, delete, and manage group membership. Requires tenant admin access. Call get_my_access in the same turn before this tool to verify admin access (the check renders as its own chat tool card). Use group slug (e.g. finance) from list results for get and membership actions \u2014 internal ids are optional. Use member email for add_member and remove_member when user ids are unknown. Results render as chat UI cards \u2014 do not restate group or member fields in your reply.",
     inputSchema: manageGroupsInputSchema,
     async execute(input, ctx) {
       const api = requireBoundAgentAdminClient(ctx);
@@ -2565,8 +2457,7 @@ function defineManageGroupsTool() {
           case "delete": {
             const result = await api.groups.delete(resolveGroupRef(input));
             return formatGroupMutationResult(
-              result,
-              "Group deleted"
+              result
             );
           }
           case "add_member": {
@@ -2575,8 +2466,7 @@ function defineManageGroupsTool() {
               resolveMemberRef2(input)
             );
             return formatGroupMutationResult(
-              result,
-              "Group member added"
+              result
             );
           }
           case "remove_member": {
@@ -2585,8 +2475,7 @@ function defineManageGroupsTool() {
               resolveMemberRef2(input)
             );
             return formatGroupMutationResult(
-              result,
-              "Group member removed"
+              result
             );
           }
         }
@@ -2615,49 +2504,26 @@ function resolveTaskCardLabel(task) {
   return task.name?.trim() || task.description?.trim() || task.type?.trim() || task.id?.trim() || "Untitled task";
 }
 function formatTasksListResult(items, options) {
-  const title = options?.title ?? (items.length === 1 ? "1 task" : `${items.length} tasks`);
-  const result = formatToolListResult(
-    "items",
-    items.map((task) => ({
+  const payload = {
+    items: items.map((task) => ({
       id: task.id,
       name: resolveTaskCardLabel(task),
       status: task.status,
       type: task.type,
       description: task.description
-    })),
-    {
-      title,
-      itemWidget: "tenantTask",
-      replyGuidance: QUERY_TASKS_LIST_REPLY_GUIDANCE
-    }
-  );
+    }))
+  };
   if (options?.nextCursor) {
-    return {
-      ...result,
-      data: {
-        ...result.data,
-        nextCursor: options.nextCursor
-      },
-      display: {
-        ...result.display,
-        description: "More tasks available \u2014 pass nextCursor to list again."
-      }
-    };
+    payload.nextCursor = options.nextCursor;
   }
-  return result;
-}
-function formatTaskSearchResult(items, total) {
-  return formatTasksListResult(items, {
-    title: total === 1 ? "1 matching task" : `${total} matching tasks`
+  return formatToolObjectResult(payload, {
+    replyGuidance: QUERY_TASKS_LIST_REPLY_GUIDANCE
   });
 }
+function formatTaskSearchResult(items) {
+  return formatTasksListResult(items);
+}
 function formatTaskDetailResult(task) {
-  const title = resolveTaskCardLabel({
-    name: typeof task.name === "string" ? task.name : null,
-    description: typeof task.description === "string" ? task.description : null,
-    type: typeof task.type === "string" ? task.type : null,
-    id: typeof task.id === "string" ? task.id : null
-  });
   return formatToolObjectResult(
     {
       id: task.id ?? null,
@@ -2669,23 +2535,11 @@ function formatTaskDetailResult(task) {
       createdAt: task.createdAt ?? null
     },
     {
-      title,
-      ui: {
-        id: { "ui:title": "Task ID" },
-        status: { "ui:title": "Status" },
-        type: { "ui:title": "Type" },
-        name: { "ui:title": "Name" },
-        description: { "ui:title": "Description" },
-        validUntil: { "ui:title": "Valid until", "ui:widget": "date" },
-        createdAt: { "ui:title": "Created", "ui:widget": "date" }
-      },
       replyGuidance: QUERY_TASKS_DETAIL_REPLY_GUIDANCE
     }
   );
 }
 function formatAssignTasksResult(results, _assignTo) {
-  const succeeded = results.filter((row) => row.success).length;
-  const title = succeeded === results.length ? `${succeeded === 1 ? "1 task" : `${succeeded} tasks`} reassigned` : `${succeeded}/${results.length} tasks reassigned`;
   return formatToolListResult(
     "results",
     results.map((row) => ({
@@ -2701,8 +2555,6 @@ function formatAssignTasksResult(results, _assignTo) {
       status: row.success ? "reassigned" : "failed"
     })),
     {
-      title,
-      itemWidget: "tenantTask",
       replyGuidance: ASSIGN_TASKS_REPLY_GUIDANCE
     }
   );
@@ -2745,7 +2597,7 @@ var queryTasksInputSchema = z12.object({
 });
 function defineQueryTasksTool() {
   return defineTool7({
-    description: "Tenant-admin tool to list, fetch detail, or search inbox tasks in the workspace. Requires tenant admin access. Results render as chat UI cards \u2014 do not restate task names, ids, or statuses in your reply.",
+    description: "Tenant-admin tool to list, fetch detail, or search inbox tasks in the workspace. Requires tenant admin access. Call get_my_access in the same turn before this tool to verify admin access (the check renders as its own chat tool card). Results render as chat UI cards \u2014 do not restate task names, ids, or statuses in your reply.",
     inputSchema: queryTasksInputSchema,
     async execute(input, ctx) {
       const api = requireBoundAgentAdminClient(ctx);
@@ -2772,8 +2624,7 @@ function defineQueryTasksTool() {
           case "search": {
             const result = await api.tasks.search(input.query, input.limit);
             return formatTaskSearchResult(
-              result.items,
-              result.total
+              result.items
             );
           }
         }