robotrock 1.0.0 → 1.3.0

package/dist/eve/index.js

@@ -0,0 +1,639 @@
+// src/platform-actions.ts
+var PLATFORM_MARK_DONE_ACTION_ID = "robotrock:mark-done";
+var PLATFORM_REJECT_REQUEST_ACTION_ID = "robotrock:reject-request";
+function isPlatformMarkDoneAction(actionId) {
+  return actionId === PLATFORM_MARK_DONE_ACTION_ID;
+}
+function isPlatformRejectRequestAction(actionId) {
+  return actionId === PLATFORM_REJECT_REQUEST_ACTION_ID;
+}
+function isPlatformTerminalAction(actionId) {
+  return isPlatformMarkDoneAction(actionId) || isPlatformRejectRequestAction(actionId);
+}
+function parsePlatformRejectRequestData(data) {
+  if (data == null || typeof data !== "object") {
+    return null;
+  }
+  const feedback = data.feedback;
+  if (typeof feedback !== "string") {
+    return null;
+  }
+  const trimmed = feedback.trim();
+  if (!trimmed) {
+    return null;
+  }
+  return { feedback: trimmed };
+}
+
+// src/eve/input-request.ts
+var EVE_INPUT_SUBMIT_ACTION_ID = "submit";
+var EVE_INPUT_OTHER_CHOICE_ID = "__other__";
+var EVE_INPUT_OTHER_CHOICE_LABEL = "Type your own answer";
+var CONFIRMATION_DEFAULT_OPTIONS = [
+  { id: "approve", label: "Approve", style: "primary" },
+  { id: "deny", label: "Deny", style: "danger" }
+];
+var SELECT_PER_OPTION_THRESHOLD = 6;
+function asRecord(value) {
+  if (value == null || typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+  return value;
+}
+function readStringField(data, key) {
+  const value = data[key];
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+function resolveEveInputDisplay(request, toolName) {
+  if (request.display) {
+    return request.display;
+  }
+  if (toolName === "ask_question") {
+    return request.options && request.options.length > 0 ? "select" : "text";
+  }
+  if (request.options && request.options.length > 0) {
+    return "select";
+  }
+  return "confirmation";
+}
+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 } : {}
+  }));
+}
+function textSubmitAction(prompt) {
+  return {
+    id: EVE_INPUT_SUBMIT_ACTION_ID,
+    title: "Submit",
+    schema: {
+      type: "object",
+      required: ["answer"],
+      properties: {
+        answer: {
+          type: "string",
+          title: "Your answer"
+        }
+      }
+    },
+    ui: {
+      answer: {
+        "ui:title": prompt.trim() || "Your answer",
+        "ui:widget": "textarea"
+      }
+    }
+  };
+}
+function selectPerOptionActions(options) {
+  return options.map((option) => ({
+    id: option.id,
+    title: option.label,
+    ...option.description ? { description: 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);
+  if (allowFreeform) {
+    enumValues.push(EVE_INPUT_OTHER_CHOICE_ID);
+    enumNames.push(EVE_INPUT_OTHER_CHOICE_LABEL);
+  }
+  const properties = {
+    choice: {
+      type: "string",
+      title: "Choose one",
+      enum: enumValues
+    }
+  };
+  if (allowFreeform) {
+    properties.other = {
+      type: "string",
+      title: "Your answer"
+    };
+  }
+  const schema = {
+    type: "object",
+    required: ["choice"],
+    properties
+  };
+  if (allowFreeform) {
+    schema.allOf = [
+      {
+        if: {
+          properties: {
+            choice: { const: EVE_INPUT_OTHER_CHOICE_ID }
+          },
+          required: ["choice"]
+        },
+        then: {
+          required: ["other"],
+          properties: {
+            other: {
+              type: "string",
+              minLength: 1
+            }
+          }
+        }
+      }
+    ];
+  }
+  const ui = {
+    choice: {
+      "ui:widget": "radio",
+      "ui:enumNames": enumNames
+    }
+  };
+  if (allowFreeform) {
+    ui.other = {
+      "ui:placeholder": "Enter your answer"
+    };
+  }
+  return {
+    id: EVE_INPUT_SUBMIT_ACTION_ID,
+    title: "Submit",
+    schema,
+    ui
+  };
+}
+function normalizeEveSelectFormData(data) {
+  const choice = typeof data.choice === "string" ? data.choice.trim() : void 0;
+  if (!choice) {
+    return data;
+  }
+  if (choice === EVE_INPUT_OTHER_CHOICE_ID) {
+    return {
+      choice,
+      ...data.other !== void 0 ? { other: data.other } : {}
+    };
+  }
+  return { choice };
+}
+function eveInputRequestToActions(request, options) {
+  const display = resolveEveInputDisplay(request, options?.toolName);
+  switch (display) {
+    case "confirmation":
+      return confirmationActions(request);
+    case "text":
+      return [textSubmitAction(request.prompt)];
+    case "select": {
+      const selectOptions = request.options ?? [];
+      if (selectOptions.length === 0) {
+        return [textSubmitAction(request.prompt)];
+      }
+      if (selectOptions.length <= SELECT_PER_OPTION_THRESHOLD && request.allowFreeform !== true) {
+        return selectPerOptionActions(selectOptions);
+      }
+      return [selectFormAction(request)];
+    }
+  }
+}
+function eveInputRequestTaskType(request, options) {
+  const display = resolveEveInputDisplay(request, options?.toolName);
+  if (display === "confirmation" && options?.toolName) {
+    return `eve-approval:${options.toolName}`;
+  }
+  return `eve-input:${display}`;
+}
+function taskHandledToEveInputResponse(request, actionId, actionData, options) {
+  const base = { requestId: request.requestId };
+  if (isPlatformTerminalAction(actionId)) {
+    const feedback = parsePlatformRejectRequestData(actionData)?.feedback;
+    return {
+      ...base,
+      optionId: "deny",
+      ...feedback ? { text: feedback } : {}
+    };
+  }
+  const display = resolveEveInputDisplay(request, options?.toolName);
+  const selectOptions = request.options ?? [];
+  const data = asRecord(actionData);
+  if (display === "confirmation") {
+    return { ...base, optionId: actionId };
+  }
+  const matchingOption = selectOptions.find((option) => option.id === actionId);
+  if (matchingOption) {
+    return { ...base, optionId: actionId };
+  }
+  if (actionId === EVE_INPUT_SUBMIT_ACTION_ID && data) {
+    const submissionData = display === "select" && request.allowFreeform === true ? normalizeEveSelectFormData(data) : data;
+    const answer = readStringField(submissionData, "answer");
+    if (answer) {
+      return { ...base, text: answer };
+    }
+    const choice = readStringField(submissionData, "choice");
+    if (choice === EVE_INPUT_OTHER_CHOICE_ID) {
+      const other = readStringField(submissionData, "other");
+      if (other) {
+        return { ...base, text: other };
+      }
+    }
+    if (choice) {
+      if (selectOptions.some((option) => option.id === choice)) {
+        return { ...base, optionId: choice };
+      }
+      return { ...base, text: choice };
+    }
+  }
+  if (data) {
+    const answer = readStringField(data, "answer");
+    if (answer) {
+      return { ...base, text: answer };
+    }
+  }
+  return { ...base, optionId: actionId };
+}
+
+// src/eve/input-audit.ts
+function matchOptionByText(text, options) {
+  const normalized = text.trim().toLowerCase();
+  if (normalized.length === 0) {
+    return void 0;
+  }
+  const byId = options.find((option) => option.id.toLowerCase() === normalized);
+  if (byId) {
+    return byId;
+  }
+  const byLabel = options.find((option) => option.label.toLowerCase() === normalized);
+  if (byLabel) {
+    return byLabel;
+  }
+  const index = Number(normalized);
+  if (Number.isInteger(index) && index > 0 && index <= options.length) {
+    return options[index - 1];
+  }
+  return void 0;
+}
+function resolveEveFreeformTextToInputResponse(request, text) {
+  const trimmed = text.trim();
+  if (trimmed.length === 0) {
+    return void 0;
+  }
+  const options = request.options ?? [];
+  if (options.length > 0) {
+    const matched = matchOptionByText(trimmed, options);
+    if (matched) {
+      return { requestId: request.requestId, optionId: matched.id };
+    }
+  }
+  if (request.allowFreeform === true || options.length === 0) {
+    return { requestId: request.requestId, text: trimmed };
+  }
+  return void 0;
+}
+function isEveApprovalInputRequest(request) {
+  const options = request.options ?? [];
+  return options.length === 2 && options[0]?.id === "approve" && options[1]?.id === "deny";
+}
+function eveInputResponseToActionSubmission(request, response, options) {
+  const display = resolveEveInputDisplay(request, options?.toolName);
+  const actions = eveInputRequestToActions(request, options);
+  if (response.optionId) {
+    const action = actions.find((entry) => entry.id === response.optionId);
+    if (action) {
+      return {
+        actionId: response.optionId,
+        actionTitle: action.title,
+        formData: {}
+      };
+    }
+    const option = request.options?.find((entry) => entry.id === response.optionId);
+    if (option) {
+      return {
+        actionId: response.optionId,
+        actionTitle: option.label,
+        formData: {}
+      };
+    }
+    return {
+      actionId: response.optionId,
+      actionTitle: response.optionId,
+      formData: {}
+    };
+  }
+  const text = response.text?.trim();
+  if (text) {
+    if (display === "text") {
+      return {
+        actionId: EVE_INPUT_SUBMIT_ACTION_ID,
+        actionTitle: text,
+        formData: { answer: text }
+      };
+    }
+    if (display === "select") {
+      const option = request.options?.find((entry) => entry.id === text);
+      if (option) {
+        return {
+          actionId: EVE_INPUT_SUBMIT_ACTION_ID,
+          actionTitle: option.label,
+          formData: { choice: option.id }
+        };
+      }
+      return {
+        actionId: EVE_INPUT_SUBMIT_ACTION_ID,
+        actionTitle: text,
+        formData: { choice: text }
+      };
+    }
+    return {
+      actionId: EVE_INPUT_SUBMIT_ACTION_ID,
+      actionTitle: text,
+      formData: { answer: text }
+    };
+  }
+  return {
+    actionId: EVE_INPUT_SUBMIT_ACTION_ID,
+    actionTitle: "Responded",
+    formData: {}
+  };
+}
+function buildEveInputAuditSubmissionData(context, formData) {
+  return {
+    toolCallId: context.toolCallId,
+    ...context.toolName ? { toolName: context.toolName } : {},
+    ...context.requestId ? { requestId: context.requestId } : {},
+    ...context.display ? { display: context.display } : {},
+    ...context.toolInput !== void 0 ? { toolInput: context.toolInput } : {},
+    ...formData
+  };
+}
+function parseEveAskQuestionToolOutput(output) {
+  if (output == null || typeof output !== "object") {
+    return null;
+  }
+  const record = output;
+  const value = record.type === "json" && record.value != null && typeof record.value === "object" ? record.value : record;
+  const optionId = typeof value.optionId === "string" ? value.optionId : void 0;
+  const text = typeof value.text === "string" ? value.text : void 0;
+  if (!optionId && !text) {
+    return null;
+  }
+  return { ...optionId ? { optionId } : {}, ...text ? { text } : {} };
+}
+
+// src/eve/tool-audit.ts
+var MANAGE_TEAM_MEMBERS_TOOL_NAME = "manage_team_members";
+var MANAGE_GROUPS_TOOL_NAME = "manage_groups";
+var CREATE_INBOX_TASK_TOOL_NAME = "create_robotrock_task";
+var MUTATING_TEAM_MEMBER_ACTIONS = /* @__PURE__ */ new Set([
+  "invite",
+  "update_role",
+  "remove"
+]);
+var MUTATING_GROUP_ACTIONS = /* @__PURE__ */ new Set([
+  "create",
+  "update",
+  "delete",
+  "add_member",
+  "remove_member"
+]);
+var SKIP_TOOL_NAMES = /* @__PURE__ */ new Set([
+  CREATE_INBOX_TASK_TOOL_NAME,
+  "ask_question",
+  "closeChat",
+  "requestActionInput"
+]);
+function readAction(input) {
+  const action = input.action;
+  return typeof action === "string" && action.trim().length > 0 ? action.trim() : void 0;
+}
+function shouldAuditToolExecution(toolName, input) {
+  if (SKIP_TOOL_NAMES.has(toolName)) {
+    return false;
+  }
+  const action = readAction(input);
+  if (toolName === MANAGE_TEAM_MEMBERS_TOOL_NAME) {
+    return action != null && MUTATING_TEAM_MEMBER_ACTIONS.has(action);
+  }
+  if (toolName === MANAGE_GROUPS_TOOL_NAME) {
+    return action != null && MUTATING_GROUP_ACTIONS.has(action);
+  }
+  return false;
+}
+var AUDIT_INPUT_KEYS = /* @__PURE__ */ new Set([
+  "action",
+  "email",
+  "userId",
+  "role",
+  "name",
+  "groupId",
+  "description"
+]);
+function sanitizeToolAuditInput(input) {
+  const sanitized = {};
+  for (const [key, value] of Object.entries(input)) {
+    if (!AUDIT_INPUT_KEYS.has(key)) {
+      continue;
+    }
+    if (value == null || value === "") {
+      continue;
+    }
+    if (typeof value === "string" || typeof value === "boolean") {
+      sanitized[key] = value;
+      continue;
+    }
+    if (typeof value === "number") {
+      sanitized[key] = value;
+    }
+  }
+  return sanitized;
+}
+function buildChatToolAuditPayload(input) {
+  const sanitized = sanitizeToolAuditInput(input.toolInput);
+  if (!shouldAuditToolExecution(input.toolName, sanitized)) {
+    return null;
+  }
+  const success = input.status === "completed" && input.isError !== true;
+  return {
+    toolCallId: input.toolCallId,
+    toolName: input.toolName,
+    input: sanitized,
+    success,
+    status: input.status,
+    ...input.error ? { error: input.error } : {}
+  };
+}
+
+// src/eve/tool-display.ts
+var DEFAULT_TOOL_DISPLAY_LABELS = {
+  refund_charge: "Refund a customer charge",
+  deploy_release: "Deploy a release",
+  get_weather: "Get weather",
+  get_my_access: "Check my access",
+  whoami: "Who am I",
+  create_robotrock_task: "Create a RobotRock task",
+  search_products: "Search products",
+  manage_team_members: "Manage team members",
+  manage_groups: "Manage groups",
+  query_tasks: "Query tasks"
+};
+var toolDisplayLabelOverrides = {};
+function setToolDisplayLabelOverrides(overrides) {
+  toolDisplayLabelOverrides = overrides;
+}
+function formatToolName(toolName) {
+  const spaced = toolName.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[-_]+/g, " ").trim();
+  if (!spaced) {
+    return "Tool";
+  }
+  return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
+function getToolDisplayLabel(toolName) {
+  const trimmed = toolName.trim();
+  if (!trimmed) {
+    return "Tool";
+  }
+  return toolDisplayLabelOverrides[trimmed] ?? DEFAULT_TOOL_DISPLAY_LABELS[trimmed] ?? formatToolName(trimmed);
+}
+function formatEveApprovalTitle(request, toolName) {
+  const display = resolveEveInputDisplay(request, toolName);
+  if (display !== "confirmation" || !toolName) {
+    return request.prompt;
+  }
+  return `Approve: ${getToolDisplayLabel(toolName)}`;
+}
+
+// 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-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).";
+var MY_ACCESS_REPLY_GUIDANCE = "Access details may render in chat UI. Do not restate role, groups, or admin capabilities if already visible. Only explain what the user can or cannot do for their question (e.g. finance group required for refunds \u2265 $10,000). When access.tenantAdmin is false and the user needs manageTeam, manageGroups, or query-tasks capabilities, explain briefly then call ask_question to offer sending an admin request to tenant admins \u2014 do not tell them to find an admin manually without offering delegation first.";
+var CREATE_INBOX_TASK_REPLY_GUIDANCE = "A task card shows title, assignee, and inbox status in chat. Do not restate task ID, assignee, or delegation details from the card. Only mention next steps or answer the user's question.";
+var SEARCH_PRODUCTS_REPLY_GUIDANCE = "Product results render as a list card in chat. Do not restate product names, prices, or SKUs. Only add context not in the list (e.g. no matches, recommendations).";
+var MANAGE_TEAM_MEMBERS_LIST_REPLY_GUIDANCE = "Team members render as a list card in chat. Do not restate names, emails, or roles from the list. Only add context not shown (e.g. duplicates, next admin actions).";
+var MANAGE_TEAM_MEMBERS_DETAIL_REPLY_GUIDANCE = "Team member details render in chat UI. Do not restate name, email, or role from the card. Only add next steps or policy context.";
+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.";
+var MANAGE_GROUPS_DETAIL_REPLY_GUIDANCE = "Group details render in chat UI. Do not restate fields already visible in the card. Only add next steps.";
+var QUERY_TASKS_LIST_REPLY_GUIDANCE = "Tasks render as a list card in chat. Do not restate task names, ids, or statuses from the list. Only add context not shown (e.g. filters applied, recommended next action).";
+var QUERY_TASKS_DETAIL_REPLY_GUIDANCE = "Task details render in chat UI. Do not restate fields already visible in the card. Only add analysis or next steps.";
+var REFUND_CHARGE_REPLY_GUIDANCE = "Refund details render in chat UI. Do not restate charge id, amount, or status from the card. Only add policy context or next steps.";
+var DEPLOY_RELEASE_REPLY_GUIDANCE = "Deploy details render in chat UI. Do not restate service, version, or environment from the card. Only add rollout context or next steps.";
+var GET_WEATHER_REPLY_GUIDANCE = "Weather details render in chat UI. Do not restate city, condition, or temperature from the card. Only add conversational context if needed.";
+var ADMIN_MUTATION_REPLY_GUIDANCE = "The action result renders in chat UI. Do not restate fields already visible in the card. Confirm outcome briefly or add next steps only.";
+function withReplyGuidance(result, guidance) {
+  return {
+    ...result,
+    [TOOL_REPLY_GUIDANCE_FIELD]: guidance
+  };
+}
+function stripAgentOnlyToolFields(output) {
+  if (typeof output !== "object" || output === null || Array.isArray(output)) {
+    return output;
+  }
+  const record = { ...output };
+  delete record[TOOL_REPLY_GUIDANCE_FIELD];
+  return record;
+}
+
+// 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
+  );
+}
+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
+    }
+  );
+}
+function isAgentAdminErrorResult(result) {
+  return typeof result === "object" && result !== null && result.ok === false && typeof result.message === "string";
+}
+
+// src/eve/resume-message.ts
+function buildTaskHandledResumeMessage(payload) {
+  const handledBy = payload.handledBy?.trim() || "someone";
+  const actionTitle = payload.action.title.trim();
+  return `RobotRock task ${payload.taskId} was handled: ${actionTitle} by ${handledBy}. Briefly tell the user what was decided and what happens next.`;
+}
+
+// src/eve/index.ts
+var ROBOTROCK_READY_HOOK_SLUG = "robotrock-ready";
+export {
+  ADMIN_MUTATION_REPLY_GUIDANCE,
+  CREATE_INBOX_TASK_REPLY_GUIDANCE,
+  DEFAULT_TOOL_DISPLAY_LABELS,
+  DEPLOY_RELEASE_REPLY_GUIDANCE,
+  EVE_INPUT_OTHER_CHOICE_ID,
+  EVE_INPUT_OTHER_CHOICE_LABEL,
+  EVE_INPUT_SUBMIT_ACTION_ID,
+  GET_WEATHER_REPLY_GUIDANCE,
+  MANAGE_GROUPS_DETAIL_REPLY_GUIDANCE,
+  MANAGE_GROUPS_LIST_REPLY_GUIDANCE,
+  MANAGE_TEAM_MEMBERS_DETAIL_REPLY_GUIDANCE,
+  MANAGE_TEAM_MEMBERS_LIST_REPLY_GUIDANCE,
+  MY_ACCESS_REPLY_GUIDANCE,
+  QUERY_TASKS_DETAIL_REPLY_GUIDANCE,
+  QUERY_TASKS_LIST_REPLY_GUIDANCE,
+  REFUND_CHARGE_REPLY_GUIDANCE,
+  ROBOTROCK_READY_HOOK_SLUG,
+  SEARCH_PRODUCTS_REPLY_GUIDANCE,
+  TOOL_REPLY_GUIDANCE_FIELD,
+  WHOAMI_REPLY_GUIDANCE,
+  buildChatToolAuditPayload,
+  buildEveInputAuditSubmissionData,
+  buildTaskHandledResumeMessage,
+  eveInputRequestTaskType,
+  eveInputRequestToActions,
+  eveInputResponseToActionSubmission,
+  formatEveApprovalTitle,
+  formatToolListResult,
+  formatToolObjectResult,
+  getToolDisplayLabel,
+  isAgentAdminErrorResult,
+  isEveApprovalInputRequest,
+  normalizeEveSelectFormData,
+  parseEveAskQuestionToolOutput,
+  resolveEveFreeformTextToInputResponse,
+  resolveEveInputDisplay,
+  sanitizeToolAuditInput,
+  setToolDisplayLabelOverrides,
+  shouldAuditToolExecution,
+  stripAgentOnlyToolFields,
+  taskHandledToEveInputResponse,
+  toolDisplayResult,
+  withReplyGuidance
+};
+//# sourceMappingURL=index.js.map