robotrock 1.3.3 → 1.4.0

package/dist/eve/tools/admin/manage-groups.js

@@ -1,6 +1,6 @@
 // src/eve/tools/admin/manage-groups.ts
 import { defineTool } from "eve/tools";
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 
 // src/http.ts
 var RobotRockError = class extends Error {
@@ -493,6 +493,40 @@ var agentChatLinkTaskBodySchema = z.object({
   publicTaskId: z.string().min(1),
   toolCallId: z.string().min(1)
 });
+var AGENT_FILE_TAGS_MAX = 20;
+var AGENT_FILE_TAG_MAX_LENGTH = 64;
+function normalizeAgentFileTags(tags) {
+  if (!tags?.length) return void 0;
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const raw of tags) {
+    const tag = raw.trim().toLowerCase().slice(0, AGENT_FILE_TAG_MAX_LENGTH);
+    if (!tag || seen.has(tag)) continue;
+    seen.add(tag);
+    out.push(tag);
+    if (out.length >= AGENT_FILE_TAGS_MAX) break;
+  }
+  return out.length > 0 ? out : void 0;
+}
+var agentChatUploadImageBodySchema = z.object({
+  mediaType: z.string().min(1),
+  /** Raw base64 (no data: URL prefix). */
+  base64: z.string().min(1),
+  chatId: z.string().min(1).optional(),
+  publicTaskId: z.string().min(1).optional(),
+  source: z.string().min(1).optional(),
+  /** Display / search name (e.g. `sunset-robot.png`). */
+  filename: z.string().min(1).max(255).optional(),
+  /** Human-readable description (e.g. generation prompt). */
+  description: z.string().min(1).max(2e3).optional(),
+  /**
+   * Optional labels for later grouping/filtering.
+   * Normalized to lowercase trimmed unique strings (max 20, 64 chars each).
+   */
+  tags: z.array(z.string().min(1).max(AGENT_FILE_TAG_MAX_LENGTH)).max(AGENT_FILE_TAGS_MAX).optional().transform((tags) => normalizeAgentFileTags(tags))
+}).refine((data) => Boolean(data.chatId || data.publicTaskId), {
+  message: "Provide chatId and/or publicTaskId"
+});
 
 // ../core/src/schemas/tool-result-display.ts
 import { z as z2 } from "zod";
@@ -521,7 +555,8 @@ var tenantRoleSchema = z3.enum(["admin", "member"]);
 var agentAdminUserSchema = z3.object({
   id: z3.string(),
   email: z3.string().email(),
-  name: z3.string()
+  name: z3.string(),
+  profilePictureUrl: z3.string().nullable().optional()
 });
 var agentAdminMemberSchema = z3.object({
   userId: z3.string(),
@@ -606,6 +641,37 @@ var assignTasksBodySchema = z3.object({
     { message: "assignTo needs at least one user email or group slug." }
   )
 });
+var agentAdminPlanLimitsSchema = z3.object({
+  tasksPerDay: z3.number(),
+  members: z3.number(),
+  apiKeys: z3.number(),
+  groups: z3.number(),
+  auditLogRetention: z3.number(),
+  rateLimitPerSecond: z3.number(),
+  taskRetentionDays: z3.number()
+});
+var agentAdminUsageSchema = z3.object({
+  workspace: z3.string(),
+  planName: z3.string(),
+  planType: z3.string(),
+  trialState: z3.enum(["none", "active", "expired"]),
+  daysRemaining: z3.number().nullable(),
+  isPaidPro: z3.boolean(),
+  subscriptionStatus: z3.string().nullable(),
+  tasksToday: z3.number(),
+  maxTasksPerDay: z3.number().nullable(),
+  tasksResetAt: z3.number(),
+  openTasks: z3.number(),
+  totalTasks: z3.number(),
+  seatsCurrent: z3.number(),
+  seatsMax: z3.number().nullable(),
+  groupsCurrent: z3.number(),
+  groupsMax: z3.number().nullable(),
+  apiKeysCurrent: z3.number(),
+  apiKeysMax: z3.number().nullable(),
+  rateLimitPerSecond: z3.number(),
+  limits: agentAdminPlanLimitsSchema
+});
 
 // ../core/src/handler-retry.ts
 var HANDLER_RETRY_DELAYS_MS = [
@@ -701,7 +767,11 @@ function resolveRobotRockAuthConfig(overrides) {
       "RobotRock auth is required. Set ROBOTROCK_API_KEY, ROBOTROCK_AGENT_SERVICE_TOKEN with tenant context, or pass auth when creating the client."
     );
   }
-  return { kind: "apiKey", apiKey };
+  return {
+    kind: "apiKey",
+    apiKey,
+    ...overrides?.actingUserId?.trim() ? { actingUserId: overrides.actingUserId.trim() } : {}
+  };
 }
 
 // src/eve/agent/attributes.ts
@@ -837,6 +907,9 @@ async function agentAdminFetch(config, path, init) {
 }
 function createAgentAdminApi(config) {
   return {
+    usage: {
+      get: () => agentAdminFetch(config, "/usage")
+    },
     members: {
       list: () => agentAdminFetch(config, "/members"),
       get: (memberRef) => agentAdminFetch(config, `/members/${encodeURIComponent(memberRef)}`),
@@ -979,20 +1052,215 @@ function requireBoundAgentAdminClient(ctx) {
   return createBoundAgentAdminClient(ctx);
 }
 
-// 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;
+// src/eve/entity-schemas.ts
+import { z as z5 } from "zod";
+
+// src/eve/tool-ui-hint.ts
+var TOOL_UI_HINT_FIELD = "uiHint";
+function withUiHint(result, hint) {
   return {
-    ...display ? { display } : {},
-    data,
-    ...options?.ui ? { ui: options.ui } : {}
+    ...result,
+    [TOOL_UI_HINT_FIELD]: hint
   };
 }
 
+// src/eve/tool-result-ui-meta.ts
+var TOOL_UI_FIELD = "ui";
+var TOOL_RESULT_UI_ENTITY_ID_RE = /^[a-z][a-z0-9_]{0,63}$/;
+function withToolUi(result, ui) {
+  const existing = typeof result[TOOL_UI_FIELD] === "object" && result[TOOL_UI_FIELD] !== null && !Array.isArray(result[TOOL_UI_FIELD]) ? result[TOOL_UI_FIELD] : {};
+  return {
+    ...result,
+    [TOOL_UI_FIELD]: {
+      ...existing,
+      ...ui
+    }
+  };
+}
+
+// src/eve/entity-schemas.ts
+function buildTenantGroupUrl(tenantSlug, slug) {
+  return `/${tenantSlug}/team/groups/${slug}`;
+}
+var toolResultUiMetaSchema = z5.object({
+  present: z5.boolean().optional(),
+  entity: z5.string().regex(TOOL_RESULT_UI_ENTITY_ID_RE).optional(),
+  rowsPath: z5.string().min(1).optional(),
+  layout: z5.enum(["list", "chart", "table"]).optional()
+}).strict();
+var agentOnlyFields = {
+  replyGuidance: z5.string().optional(),
+  ui: toolResultUiMetaSchema.optional(),
+  uiHint: z5.enum(["list", "chart", "table"]).optional()
+};
+function withAgentOnlyFields(shape) {
+  return z5.object({
+    ...shape,
+    ...agentOnlyFields
+  });
+}
+var productEntityRowSchema = z5.object({
+  id: z5.string().min(1),
+  name: z5.string().min(1),
+  price: z5.number(),
+  currency: z5.string().min(1),
+  inStock: z5.boolean(),
+  url: z5.string().min(1)
+});
+var metricPointEntityRowSchema = z5.object({
+  date: z5.string().optional(),
+  category: z5.string().optional(),
+  label: z5.string().optional()
+}).catchall(z5.union([z5.string(), z5.number()]));
+var memberEntityRowSchema = z5.object({
+  name: z5.string(),
+  email: z5.string(),
+  role: z5.string(),
+  membershipKind: z5.string(),
+  profilePictureUrl: z5.string().nullable()
+});
+var taskEntityRowSchema = z5.object({
+  id: z5.string().min(1),
+  name: z5.string().min(1),
+  status: z5.string().min(1),
+  type: z5.string().nullable(),
+  description: z5.string().nullable(),
+  validUntil: z5.number(),
+  createdAt: z5.number(),
+  url: z5.string().min(1),
+  threadPriority: z5.string().nullable().optional()
+});
+var groupEntityRowSchema = z5.object({
+  name: z5.string().min(1),
+  slug: z5.string().min(1),
+  description: z5.string().nullable(),
+  memberCount: z5.number().nullable(),
+  url: z5.string().min(1)
+});
+var groupDetailEntitySchema = z5.object({
+  name: z5.string().min(1),
+  slug: z5.string().min(1),
+  description: z5.string().nullable(),
+  url: z5.string().min(1),
+  members: z5.array(
+    z5.object({
+      name: z5.string(),
+      email: z5.string(),
+      profilePictureUrl: z5.string().nullable()
+    })
+  )
+});
+var statusEntityRowSchema = z5.object({
+  id: z5.string().min(1),
+  name: z5.string().min(1),
+  status: z5.string().min(1),
+  url: z5.string().min(1),
+  type: z5.string().nullable().optional(),
+  description: z5.string().nullable().optional()
+});
+var agentAdminErrorResultSchema = z5.object({
+  ok: z5.literal(false),
+  status: z5.number().optional(),
+  message: z5.string(),
+  response: z5.unknown().optional()
+});
+var agentAdminMutationResultSchema = z5.object({
+  ...agentOnlyFields
+}).passthrough();
+var searchProductsOutputSchema = withAgentOnlyFields({
+  items: z5.array(productEntityRowSchema)
+});
+var generateRandomChartOutputSchema = withAgentOnlyFields({
+  title: z5.string().min(1),
+  axis: z5.enum(["time", "category"]),
+  series: z5.array(metricPointEntityRowSchema)
+});
+var generateImageOutputSchema = withAgentOnlyFields({
+  prompt: z5.string().min(1),
+  mediaType: z5.string().min(1),
+  model: z5.string().min(1),
+  storageId: z5.string().min(1),
+  url: z5.string().min(1),
+  /** @deprecated Legacy sessions only — prefer storageId/url. */
+  base64: z5.string().min(1).optional()
+});
+var manageTeamMembersListOutputSchema = withAgentOnlyFields({
+  members: z5.array(memberEntityRowSchema)
+});
+var manageTeamMembersDetailOutputSchema = withAgentOnlyFields(
+  memberEntityRowSchema.shape
+);
+var manageTeamMembersOutputSchema = z5.union([
+  manageTeamMembersListOutputSchema,
+  manageTeamMembersDetailOutputSchema,
+  agentAdminMutationResultSchema,
+  agentAdminErrorResultSchema
+]);
+var manageGroupsListOutputSchema = withAgentOnlyFields({
+  groups: z5.array(groupEntityRowSchema)
+});
+var manageGroupsDetailOutputSchema = withAgentOnlyFields(
+  groupDetailEntitySchema.shape
+);
+var manageGroupsSummaryOutputSchema = withAgentOnlyFields(
+  groupEntityRowSchema.shape
+);
+var manageGroupsOutputSchema = z5.union([
+  manageGroupsListOutputSchema,
+  manageGroupsDetailOutputSchema,
+  manageGroupsSummaryOutputSchema,
+  agentAdminMutationResultSchema,
+  agentAdminErrorResultSchema
+]);
+var queryTasksListOutputSchema = withAgentOnlyFields({
+  items: z5.array(taskEntityRowSchema),
+  nextCursor: z5.string().nullable().optional()
+});
+var queryTasksDetailOutputSchema = withAgentOnlyFields({
+  id: z5.string().nullable(),
+  status: z5.string().nullable(),
+  type: z5.string().nullable(),
+  name: z5.string().nullable(),
+  description: z5.string().nullable(),
+  validUntil: z5.number().nullable(),
+  createdAt: z5.number().nullable(),
+  url: z5.string().min(1).nullable()
+});
+var queryTasksOutputSchema = z5.union([
+  queryTasksListOutputSchema,
+  queryTasksDetailOutputSchema,
+  agentAdminErrorResultSchema
+]);
+var assignTasksOutputSchema = z5.union([
+  withAgentOnlyFields({
+    results: z5.array(statusEntityRowSchema)
+  }),
+  agentAdminErrorResultSchema
+]);
+var workspaceUsageEntitySchema = z5.object({
+  workspace: z5.string(),
+  plan: z5.string(),
+  planType: z5.string(),
+  trialState: z5.string(),
+  daysRemaining: z5.number().nullable(),
+  isPaidPro: z5.boolean(),
+  subscriptionStatus: z5.string(),
+  tasksToday: z5.string(),
+  tasksResetAt: z5.string(),
+  openTasks: z5.number(),
+  totalTasks: z5.number(),
+  seats: z5.string(),
+  groups: z5.string(),
+  apiKeys: z5.string(),
+  rateLimitPerSecond: z5.number()
+});
+var getWorkspaceUsageOutputSchema = z5.union([
+  withAgentOnlyFields({
+    usage: workspaceUsageEntitySchema
+  }),
+  agentAdminErrorResultSchema
+]);
+
 // src/eve/tool-reply-guidance.ts
 var TOOL_REPLY_GUIDANCE_FIELD = "replyGuidance";
 var MANAGE_GROUPS_LIST_REPLY_GUIDANCE = "Groups render as a list card in chat. Do not restate group names, slugs, or descriptions from the list. Use slug (not internal id) for get, update, delete, and membership actions. Only add context not shown.";
@@ -1007,107 +1275,85 @@ function withReplyGuidance(result, guidance) {
 
 // src/eve/tool-display-format.ts
 function formatToolObjectResult(data, options) {
-  return withReplyGuidance(
-    toolDisplayResult(data, {
-      title: options.title,
-      description: options.description,
-      ui: options.ui
-    }),
+  let result = withReplyGuidance(
+    data,
     options.replyGuidance
   );
+  if (options.ui) {
+    result = withToolUi(result, options.ui);
+  }
+  if (options.uiHint) {
+    result = withUiHint(result, options.uiHint);
+  }
+  return result;
 }
 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 } : {}
+  const ui = {
+    ...options.ui,
+    layout: "list",
+    rowsPath: listKey,
+    ...options.entity ? { entity: options.entity } : {},
+    ...options.present !== void 0 ? { present: options.present } : {}
   };
-  return formatToolObjectResult(
-    { [listKey]: items },
-    {
-      title: options.title,
-      ui: {
-        [listKey]: listFieldUi
-      },
-      replyGuidance: options.replyGuidance
-    }
+  return withUiHint(
+    withToolUi(
+      withReplyGuidance({ [listKey]: items }, options.replyGuidance),
+      ui
+    ),
+    "list"
   );
 }
 
 // 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) {
+function serializeGroupRow(group, tenantSlug) {
   return {
     name: group.name,
     slug: group.slug,
     description: group.description,
-    memberCount: group.memberCount ?? null
+    memberCount: group.memberCount ?? null,
+    url: buildTenantGroupUrl(tenantSlug, group.slug)
   };
 }
-function formatGroupsListResult(groups) {
-  const countLabel = groups.length === 1 ? "1 group" : `${groups.length} groups`;
+function formatGroupsListResult(groups, options) {
   return formatToolListResult(
     "groups",
-    groups.map(serializeGroupRow),
+    groups.map((group) => serializeGroupRow(group, options.tenantSlug)),
     {
-      title: countLabel,
-      itemWidget: "tenantGroup",
-      replyGuidance: MANAGE_GROUPS_LIST_REPLY_GUIDANCE
+      replyGuidance: MANAGE_GROUPS_LIST_REPLY_GUIDANCE,
+      entity: "group"
     }
   );
 }
-function formatGroupDetailResult(group) {
+function formatGroupDetailResult(group, options) {
   return formatToolObjectResult(
     {
       name: group.name,
       slug: group.slug,
       description: group.description,
+      url: buildTenantGroupUrl(options.tenantSlug, group.slug),
       members: group.members.map((member) => ({
         name: member.user.name,
-        email: member.user.email
+        email: member.user.email,
+        profilePictureUrl: member.user.profilePictureUrl ?? null
       }))
     },
     {
-      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
+      replyGuidance: MANAGE_GROUPS_DETAIL_REPLY_GUIDANCE,
+      ui: { entity: "group" }
     }
   );
 }
-function formatGroupSummaryResult(group) {
-  return formatToolObjectResult(serializeGroupRow(group), {
-    title: group.name,
-    ui: GROUP_ITEM_UI,
-    replyGuidance: MANAGE_GROUPS_DETAIL_REPLY_GUIDANCE
+function formatGroupSummaryResult(group, options) {
+  return formatToolObjectResult(serializeGroupRow(group, options.tenantSlug), {
+    replyGuidance: MANAGE_GROUPS_DETAIL_REPLY_GUIDANCE,
+    ui: { entity: "group" }
   });
 }
 
 // src/eve/tools/admin/manage-groups.ts
 var MANAGE_GROUPS_TOOL_NAME = "manage_groups";
-var manageGroupsInputSchema = z5.object({
-  action: z5.enum([
+var manageGroupsInputSchema = z6.object({
+  action: z6.enum([
     "list",
     "get",
     "create",
@@ -1116,18 +1362,18 @@ var manageGroupsInputSchema = z5.object({
     "add_member",
     "remove_member"
   ]),
-  groupId: z5.string().min(1).optional().describe(
+  groupId: z6.string().min(1).optional().describe(
     "Convex group id for get, update, delete, and membership actions. Prefer slug when the group list only shows slug."
   ),
-  slug: z5.string().min(1).optional().describe(
+  slug: z6.string().min(1).optional().describe(
     "Group slug (e.g. finance) for get, update, delete, and membership actions."
   ),
-  userId: z5.string().min(1).optional().describe(
+  userId: z6.string().min(1).optional().describe(
     "User id for add_member and remove_member. Prefer email when the member list only shows email."
   ),
-  email: z5.string().email().optional().describe("Member email for add_member and remove_member."),
-  name: z5.string().min(1).optional().describe("Group name for create and update."),
-  description: z5.string().optional().describe("Group description for create and update.")
+  email: z6.string().email().optional().describe("Member email for add_member and remove_member."),
+  name: z6.string().min(1).optional().describe("Group name for create and update."),
+  description: z6.string().optional().describe("Group description for create and update.")
 }).superRefine((input, ctx) => {
   const requireField = (field, message) => {
     if (!input[field]) {
@@ -1168,9 +1414,8 @@ var manageGroupsInputSchema = z5.object({
       break;
   }
 });
-function formatGroupMutationResult(payload, title) {
+function formatGroupMutationResult(payload) {
   return formatToolObjectResult(payload, {
-    title,
     replyGuidance: ADMIN_MUTATION_REPLY_GUIDANCE
   });
 }
@@ -1182,39 +1427,50 @@ function resolveMemberRef(input) {
 }
 function defineManageGroupsTool() {
   return defineTool({
-    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 stays a compact success marker unless it is the only presentable result). 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,
+    outputSchema: manageGroupsOutputSchema,
     async execute(input, ctx) {
+      const caller = requireAdminCaller(ctx);
       const api = requireBoundAgentAdminClient(ctx);
+      const tenantSlug = caller.tenantSlug;
       try {
         switch (input.action) {
           case "list": {
             const result = await api.groups.list();
-            return formatGroupsListResult(result.groups);
+            return formatGroupsListResult(result.groups, {
+              tenantSlug
+            });
           }
           case "get": {
             const result = await api.groups.get(resolveGroupRef(input));
-            return formatGroupDetailResult(result.group);
+            return formatGroupDetailResult(
+              result.group,
+              { tenantSlug }
+            );
           }
           case "create": {
             const result = await api.groups.create({
               name: input.name,
               description: input.description
             });
-            return formatGroupSummaryResult(result.group);
+            return formatGroupSummaryResult(result.group, {
+              tenantSlug
+            });
           }
           case "update": {
             const result = await api.groups.update(resolveGroupRef(input), {
               name: input.name,
               description: input.description
             });
-            return formatGroupSummaryResult(result.group);
+            return formatGroupSummaryResult(result.group, {
+              tenantSlug
+            });
           }
           case "delete": {
             const result = await api.groups.delete(resolveGroupRef(input));
             return formatGroupMutationResult(
-              result,
-              "Group deleted"
+              result
             );
           }
           case "add_member": {
@@ -1223,8 +1479,7 @@ function defineManageGroupsTool() {
               resolveMemberRef(input)
             );
             return formatGroupMutationResult(
-              result,
-              "Group member added"
+              result
             );
           }
           case "remove_member": {
@@ -1233,8 +1488,7 @@ function defineManageGroupsTool() {
               resolveMemberRef(input)
             );
             return formatGroupMutationResult(
-              result,
-              "Group member removed"
+              result
             );
           }
         }