robotrock 1.3.3 → 1.4.0

package/dist/index.d.ts

@@ -1,14 +1,15 @@
-import { R as RobotRock, b as RobotRockConfig } from './client-CZ5eWH5v.js';
-export { C as ChatsApi, c as CloseChatOptions, d as CreateChatInput, e as CreateChatResult, f as CreatedChat, L as ListTasksInput, g as RobotRockAdvancedConfig, h as RobotRockPollingClientConfig, i as RobotRockPollingOptions, j as RobotRockWebhookClientConfig, k as RobotRockWebhookConfig, l as SearchTasksInput, S as SendToHumanActionInput, a as SendToHumanInput, m as SendToHumanResult, n as SendToHumanValidUntil, o as SendUpdateInput, p as StageChatHitlRequestsInput, q as StagedChatHitlRequest, T as TasksApi, r as attachWebhookToActions, s as createChatsApi, t as createClient } from './client-CZ5eWH5v.js';
+import { R as RobotRock, b as RobotRockConfig } from './client-BxbxttFH.js';
+export { C as ChatsApi, c as CloseChatOptions, d as CreateChatInput, e as CreateChatResult, f as CreatedChat, L as ListTasksInput, g as RobotRockAdvancedConfig, h as RobotRockPollingClientConfig, i as RobotRockPollingOptions, j as RobotRockWebhookClientConfig, k as RobotRockWebhookConfig, l as SearchTasksInput, S as SendToHumanActionInput, a as SendToHumanInput, m as SendToHumanResult, n as SendToHumanValidUntil, o as SendUpdateInput, p as StageChatHitlRequestsInput, q as StagedChatHitlRequest, T as TasksApi, r as attachWebhookToActions, s as createChatsApi, t as createClient } from './client-BxbxttFH.js';
 export { AgentChatSeedMessage, CreateAgentChatBody, CreateAgentChatBodyInput, agentChatSeedMessageSchema, createAgentChatBodySchema } from '@robotrock/core';
 import { Task, DiscriminatedApprovalResult } from './schemas/index.js';
 export { AgentTelemetry, AgentTelemetryInput, ApprovalResult, AssignToInput, CreateTaskBody, CreateTaskBodyInput, DEFAULT_TASK_PRIORITY, DEFAULT_THREAD_UPDATE_STATUS, Handler, InferActionData, LOWEST_TASK_PRIORITY, TASK_CONTEXT_FORMAT_VERSION, TASK_PRIORITY_RANK, TaskAction, TaskContext, TaskContextFormatVersion, TaskContextInput, TaskPriority, TaskResponse, TaskResult, TaskStatus, ThreadUpdate, ThreadUpdateBody, ThreadUpdateBodyInput, ThreadUpdateInput, ThreadUpdateResponse, ThreadUpdateSource, ThreadUpdateStatus, TriggerHandler, TupleElementIndices, WebhookHandler, agentTelemetrySchema, assignToSchema, createTaskBodySchema, taskContextSchema, taskPriorities, taskPrioritySchema, threadUpdateBodySchema, threadUpdateInputSchema, threadUpdateStatusSchema, threadUpdateStatuses } from './schemas/index.js';
-export { D as DEFAULT_TOOL_DISPLAY_LABELS, E as EVE_INPUT_OTHER_CHOICE_ID, a as EVE_INPUT_OTHER_CHOICE_LABEL, b as EVE_INPUT_SUBMIT_ACTION_ID, c as EveInputOption, d as EveInputRequest, e as EveInputRequestDisplay, f as EveInputResponse, R as ROBOTROCK_READY_HOOK_SLUG, g as RobotRockWebhookError, h as RobotRockWebhookErrorCode, i as RobotRockWebhookPayload, V as VerifyRobotRockWebhookOptions, j as buildTaskHandledResumeMessage, k as eveInputRequestTaskType, l as eveInputRequestToActions, m as formatEveApprovalTitle, n as getToolDisplayLabel, o as normalizeEveSelectFormData, r as resolveEveInputDisplay, s as setToolDisplayLabelOverrides, t as taskHandledToEveInputResponse, v as verifyRobotRockWebhook } from './index-DePyAbTI.js';
+export { D as DEFAULT_TOOL_DISPLAY_LABELS, E as EVE_INPUT_OTHER_CHOICE_ID, a as EVE_INPUT_OTHER_CHOICE_LABEL, b as EVE_INPUT_SUBMIT_ACTION_ID, c as EveInputOption, d as EveInputRequest, e as EveInputRequestDisplay, f as EveInputResponse, R as ROBOTROCK_READY_HOOK_SLUG, g as RobotRockWebhookError, h as RobotRockWebhookErrorCode, i as RobotRockWebhookPayload, V as VerifyRobotRockWebhookOptions, j as buildTaskHandledResumeMessage, k as eveInputRequestTaskType, l as eveInputRequestToActions, m as formatEveApprovalTitle, n as getToolDisplayLabel, o as normalizeEveSelectFormData, r as resolveEveInputDisplay, s as setToolDisplayLabelOverrides, t as taskHandledToEveInputResponse, v as verifyRobotRockWebhook } from './index-Drj0Rzf_.js';
 export { E as EndRobotRockHumanWaitSpanOptions, b as RobotRockCreatedTask, c as RobotRockHandledOtelInput, a as RobotRockHandlerWebhookPayload, d as RobotRockHumanWaitOtelSession, e as RobotRockOtelHandle, f as RobotRockOtelRecordOptions, R as RobotRockPlatformOtelFields, g as beginRobotRockHumanWaitOtel, h as captureRobotRockOtelHandle, i as endRobotRockHumanWaitSpan, j as finishRobotRockHumanWaitOtel, r as recordRobotRockHandledToOtel, s as shouldRecordRobotRockOtel, k as startRobotRockHumanWaitSpan, l as stripPlatformOtelFields, t as toRobotRockHandledOtelInput } from './otel-platform-DzHyHkGk.js';
 import 'zod';
 import './chat-correlation-BsHD-tOQ.js';
 import '@robotrock/core/schemas';
-import './tool-reply-guidance-C3qrT1In.js';
+import './tool-result-ui-meta-KT0VafEO.js';
+import './tool-reply-guidance-CJko9liH.js';
 import '@opentelemetry/api';
 
 declare class RobotRockError extends Error {

package/dist/index.js

@@ -1,6 +1,14 @@
 // src/schemas/index.ts
 import { z as z4 } from "zod";
 
+// ../core/src/utils/decode-html-entities.ts
+function decodeHtmlEntities(value) {
+  return value.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#039;/g, "'").replace(/&apos;/g, "'").replace(/&#(\d+);/g, (_, code) => String.fromCharCode(Number(code))).replace(
+    /&#x([0-9a-f]+);/gi,
+    (_, code) => String.fromCharCode(parseInt(code, 16))
+  );
+}
+
 // ../core/src/utils/safe-url.ts
 var BLOCKED_HOSTNAMES = /* @__PURE__ */ new Set([
   "localhost",
@@ -445,6 +453,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";
@@ -473,7 +515,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(),
@@ -558,6 +601,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
+});
 
 // src/schemas/index.ts
 var handlerUrlSchema2 = z4.string().refine((url) => isAllowedHandlerUrl(url), {
@@ -870,7 +944,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/chat-correlation.ts
@@ -1064,6 +1142,51 @@ function createChatsApi(config) {
           data
         );
       }
+    },
+    async uploadImage(input) {
+      const validation = agentChatUploadImageBodySchema.safeParse(input);
+      if (!validation.success) {
+        throw new RobotRockError(
+          `Invalid image upload: ${validation.error.issues[0]?.message}`,
+          400,
+          validation.error.issues
+        );
+      }
+      const response = await fetch(`${config.baseUrl}/agent-chats/images`, {
+        method: "POST",
+        headers: headers(),
+        body: JSON.stringify(validation.data)
+      });
+      const data = await parseResponseBody(response);
+      if (!response.ok) {
+        throw new RobotRockError(
+          getErrorMessage(data, "Failed to upload chat image"),
+          response.status,
+          data
+        );
+      }
+      const uploaded = data;
+      if (typeof uploaded.storageId !== "string" || typeof uploaded.url !== "string" || typeof uploaded.mediaType !== "string") {
+        throw new RobotRockError(
+          "Image upload returned an invalid response",
+          500,
+          data
+        );
+      }
+      return {
+        storageId: uploaded.storageId,
+        url: uploaded.url,
+        mediaType: uploaded.mediaType,
+        ...typeof uploaded.chatId === "string" ? { chatId: uploaded.chatId } : {},
+        ...typeof uploaded.publicTaskId === "string" ? { publicTaskId: uploaded.publicTaskId } : {},
+        ...typeof uploaded.filename === "string" ? { filename: uploaded.filename } : {},
+        ...typeof uploaded.description === "string" ? { description: uploaded.description } : {},
+        ...Array.isArray(uploaded.tags) ? {
+          tags: uploaded.tags.filter(
+            (tag) => typeof tag === "string"
+          )
+        } : {}
+      };
     }
   };
 }
@@ -1133,6 +1256,7 @@ var RobotRock = class {
     }
     this.auth = resolveRobotRockAuthConfig({
       ...apiKey ? { apiKey } : {},
+      ...config.actingUserId ? { actingUserId: config.actingUserId } : {},
       ...agentService ? { agentService } : {}
     });
     this.chatCorrelation = config.chatCorrelation;
@@ -1574,6 +1698,9 @@ function readStringField(data, key) {
   const trimmed = value.trim();
   return trimmed.length > 0 ? trimmed : void 0;
 }
+function decodeDisplayText(value) {
+  return decodeHtmlEntities(value);
+}
 function resolveEveInputDisplay(request, toolName) {
   if (request.display) {
     return request.display;
@@ -1590,11 +1717,12 @@ function confirmationActions(request) {
   const options = request.options && request.options.length > 0 ? request.options : CONFIRMATION_DEFAULT_OPTIONS;
   return options.map((option) => ({
     id: option.id,
-    title: option.label,
-    ...option.description ? { description: option.description } : {}
+    title: decodeDisplayText(option.label),
+    ...option.description ? { description: decodeDisplayText(option.description) } : {}
   }));
 }
 function textSubmitAction(prompt) {
+  const decodedPrompt = decodeDisplayText(prompt);
   return {
     id: EVE_INPUT_SUBMIT_ACTION_ID,
     title: "Submit",
@@ -1610,7 +1738,7 @@ function textSubmitAction(prompt) {
     },
     ui: {
       answer: {
-        "ui:title": prompt.trim() || "Your answer",
+        "ui:title": decodedPrompt.trim() || "Your answer",
         "ui:widget": "textarea"
       }
     }
@@ -1619,15 +1747,15 @@ function textSubmitAction(prompt) {
 function selectPerOptionActions(options) {
   return options.map((option) => ({
     id: option.id,
-    title: option.label,
-    ...option.description ? { description: option.description } : {}
+    title: decodeDisplayText(option.label),
+    ...option.description ? { description: decodeDisplayText(option.description) } : {}
   }));
 }
 function selectFormAction(request) {
   const options = request.options ?? [];
   const allowFreeform = request.allowFreeform === true;
   const enumValues = options.map((option) => option.id);
-  const enumNames = options.map((option) => option.label);
+  const enumNames = options.map((option) => decodeDisplayText(option.label));
   if (allowFreeform) {
     enumValues.push(EVE_INPUT_OTHER_CHOICE_ID);
     enumNames.push(EVE_INPUT_OTHER_CHOICE_LABEL);
@@ -1786,9 +1914,12 @@ var DEFAULT_TOOL_DISPLAY_LABELS = {
   whoami: "Who am I",
   create_robotrock_task: "Create a RobotRock task",
   search_products: "Search products",
+  generate_random_chart: "Generate random chart",
+  generate_image: "Generate image",
   manage_team_members: "Manage team members",
   manage_groups: "Manage groups",
-  query_tasks: "Query tasks"
+  query_tasks: "Query tasks",
+  get_workspace_usage: "Get workspace usage"
 };
 var toolDisplayLabelOverrides = {};
 function setToolDisplayLabelOverrides(overrides) {
@@ -1811,11 +1942,195 @@ function getToolDisplayLabel(toolName) {
 function formatEveApprovalTitle(request, toolName) {
   const display = resolveEveInputDisplay(request, toolName);
   if (display !== "confirmation" || !toolName) {
-    return request.prompt;
+    return decodeHtmlEntities(request.prompt);
   }
   return `Approve: ${getToolDisplayLabel(toolName)}`;
 }
 
+// src/eve/tool-result-ui-meta.ts
+var TOOL_RESULT_UI_ENTITY_ID_RE = /^[a-z][a-z0-9_]{0,63}$/;
+
+// src/eve/entity-schemas.ts
+import { z as z6 } from "zod";
+var toolResultUiMetaSchema = z6.object({
+  present: z6.boolean().optional(),
+  entity: z6.string().regex(TOOL_RESULT_UI_ENTITY_ID_RE).optional(),
+  rowsPath: z6.string().min(1).optional(),
+  layout: z6.enum(["list", "chart", "table"]).optional()
+}).strict();
+var agentOnlyFields = {
+  replyGuidance: z6.string().optional(),
+  ui: toolResultUiMetaSchema.optional(),
+  uiHint: z6.enum(["list", "chart", "table"]).optional()
+};
+function withAgentOnlyFields(shape) {
+  return z6.object({
+    ...shape,
+    ...agentOnlyFields
+  });
+}
+var productEntityRowSchema = z6.object({
+  id: z6.string().min(1),
+  name: z6.string().min(1),
+  price: z6.number(),
+  currency: z6.string().min(1),
+  inStock: z6.boolean(),
+  url: z6.string().min(1)
+});
+var metricPointEntityRowSchema = z6.object({
+  date: z6.string().optional(),
+  category: z6.string().optional(),
+  label: z6.string().optional()
+}).catchall(z6.union([z6.string(), z6.number()]));
+var memberEntityRowSchema = z6.object({
+  name: z6.string(),
+  email: z6.string(),
+  role: z6.string(),
+  membershipKind: z6.string(),
+  profilePictureUrl: z6.string().nullable()
+});
+var taskEntityRowSchema = z6.object({
+  id: z6.string().min(1),
+  name: z6.string().min(1),
+  status: z6.string().min(1),
+  type: z6.string().nullable(),
+  description: z6.string().nullable(),
+  validUntil: z6.number(),
+  createdAt: z6.number(),
+  url: z6.string().min(1),
+  threadPriority: z6.string().nullable().optional()
+});
+var groupEntityRowSchema = z6.object({
+  name: z6.string().min(1),
+  slug: z6.string().min(1),
+  description: z6.string().nullable(),
+  memberCount: z6.number().nullable(),
+  url: z6.string().min(1)
+});
+var groupDetailEntitySchema = z6.object({
+  name: z6.string().min(1),
+  slug: z6.string().min(1),
+  description: z6.string().nullable(),
+  url: z6.string().min(1),
+  members: z6.array(
+    z6.object({
+      name: z6.string(),
+      email: z6.string(),
+      profilePictureUrl: z6.string().nullable()
+    })
+  )
+});
+var statusEntityRowSchema = z6.object({
+  id: z6.string().min(1),
+  name: z6.string().min(1),
+  status: z6.string().min(1),
+  url: z6.string().min(1),
+  type: z6.string().nullable().optional(),
+  description: z6.string().nullable().optional()
+});
+var agentAdminErrorResultSchema = z6.object({
+  ok: z6.literal(false),
+  status: z6.number().optional(),
+  message: z6.string(),
+  response: z6.unknown().optional()
+});
+var agentAdminMutationResultSchema = z6.object({
+  ...agentOnlyFields
+}).passthrough();
+var searchProductsOutputSchema = withAgentOnlyFields({
+  items: z6.array(productEntityRowSchema)
+});
+var generateRandomChartOutputSchema = withAgentOnlyFields({
+  title: z6.string().min(1),
+  axis: z6.enum(["time", "category"]),
+  series: z6.array(metricPointEntityRowSchema)
+});
+var generateImageOutputSchema = withAgentOnlyFields({
+  prompt: z6.string().min(1),
+  mediaType: z6.string().min(1),
+  model: z6.string().min(1),
+  storageId: z6.string().min(1),
+  url: z6.string().min(1),
+  /** @deprecated Legacy sessions only — prefer storageId/url. */
+  base64: z6.string().min(1).optional()
+});
+var manageTeamMembersListOutputSchema = withAgentOnlyFields({
+  members: z6.array(memberEntityRowSchema)
+});
+var manageTeamMembersDetailOutputSchema = withAgentOnlyFields(
+  memberEntityRowSchema.shape
+);
+var manageTeamMembersOutputSchema = z6.union([
+  manageTeamMembersListOutputSchema,
+  manageTeamMembersDetailOutputSchema,
+  agentAdminMutationResultSchema,
+  agentAdminErrorResultSchema
+]);
+var manageGroupsListOutputSchema = withAgentOnlyFields({
+  groups: z6.array(groupEntityRowSchema)
+});
+var manageGroupsDetailOutputSchema = withAgentOnlyFields(
+  groupDetailEntitySchema.shape
+);
+var manageGroupsSummaryOutputSchema = withAgentOnlyFields(
+  groupEntityRowSchema.shape
+);
+var manageGroupsOutputSchema = z6.union([
+  manageGroupsListOutputSchema,
+  manageGroupsDetailOutputSchema,
+  manageGroupsSummaryOutputSchema,
+  agentAdminMutationResultSchema,
+  agentAdminErrorResultSchema
+]);
+var queryTasksListOutputSchema = withAgentOnlyFields({
+  items: z6.array(taskEntityRowSchema),
+  nextCursor: z6.string().nullable().optional()
+});
+var queryTasksDetailOutputSchema = withAgentOnlyFields({
+  id: z6.string().nullable(),
+  status: z6.string().nullable(),
+  type: z6.string().nullable(),
+  name: z6.string().nullable(),
+  description: z6.string().nullable(),
+  validUntil: z6.number().nullable(),
+  createdAt: z6.number().nullable(),
+  url: z6.string().min(1).nullable()
+});
+var queryTasksOutputSchema = z6.union([
+  queryTasksListOutputSchema,
+  queryTasksDetailOutputSchema,
+  agentAdminErrorResultSchema
+]);
+var assignTasksOutputSchema = z6.union([
+  withAgentOnlyFields({
+    results: z6.array(statusEntityRowSchema)
+  }),
+  agentAdminErrorResultSchema
+]);
+var workspaceUsageEntitySchema = z6.object({
+  workspace: z6.string(),
+  plan: z6.string(),
+  planType: z6.string(),
+  trialState: z6.string(),
+  daysRemaining: z6.number().nullable(),
+  isPaidPro: z6.boolean(),
+  subscriptionStatus: z6.string(),
+  tasksToday: z6.string(),
+  tasksResetAt: z6.string(),
+  openTasks: z6.number(),
+  totalTasks: z6.number(),
+  seats: z6.string(),
+  groups: z6.string(),
+  apiKeys: z6.string(),
+  rateLimitPerSecond: z6.number()
+});
+var getWorkspaceUsageOutputSchema = z6.union([
+  withAgentOnlyFields({
+    usage: workspaceUsageEntitySchema
+  }),
+  agentAdminErrorResultSchema
+]);
+
 // src/eve/resume-message.ts
 function buildTaskHandledResumeMessage(payload) {
   const handledBy = payload.handledBy?.trim() || "someone";
@@ -1828,18 +2143,18 @@ var ROBOTROCK_READY_HOOK_SLUG = "robotrock-ready";
 
 // src/webhook.ts
 import { createHmac, timingSafeEqual } from "crypto";
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 var ROBOTROCK_SIGNATURE_HEADER = "x-robotrock-signature";
-var robotRockWebhookPayloadBodySchema = z6.object({
-  taskId: z6.string().min(1),
-  action: z6.object({
-    id: z6.string().min(1),
-    title: z6.string().min(1),
-    data: z6.unknown()
+var robotRockWebhookPayloadBodySchema = z7.object({
+  taskId: z7.string().min(1),
+  action: z7.object({
+    id: z7.string().min(1),
+    title: z7.string().min(1),
+    data: z7.unknown()
   }),
-  handledBy: z6.string().min(1).optional(),
-  handledAt: z6.string().min(1),
-  handlerType: z6.string().min(1)
+  handledBy: z7.string().min(1).optional(),
+  handledAt: z7.string().min(1),
+  handlerType: z7.string().min(1)
 });
 var RobotRockWebhookError = class extends Error {
   constructor(message, code, details) {