robotrock 1.3.2 → 1.3.4

package/dist/{index-DePyAbTI.d.ts → index-Blq0XoAr.d.ts}

@@ -1,7 +1,7 @@
 import { S as SendToHumanActionInput } from './client-CZ5eWH5v.js';
-import { UiSchema, ToolDisplayEnvelope } from '@robotrock/core/schemas';
+import { UiSchema } from '@robotrock/core/schemas';
 import { T as ToolResultWithReplyGuidance } from './tool-reply-guidance-C3qrT1In.js';
-import * as _robotrock_core from '@robotrock/core';
+import { T as ToolUiHint } from './tool-ui-hint-CMpug5sC.js';
 import { z } from 'zod';
 
 /** One selectable option in an Eve HITL input request. */
@@ -127,28 +127,29 @@ type ToolDisplayResultOptions = {
     ui?: Record<string, UiSchema>;
 };
 /**
- * Wrap tool execute output with optional dashboard display hints.
- * Agents return plain JSON by default; use this when schema-driven widgets help.
+ * @deprecated Tool results should return plain JSON. Display envelopes are ignored
+ * by the dashboard TRL renderer. Kept for backwards-compatible call sites.
  */
-declare function toolDisplayResult<T extends Record<string, unknown>>(data: T, options?: ToolDisplayResultOptions): ToolDisplayEnvelope<T>;
+declare function toolDisplayResult<T extends Record<string, unknown>>(data: T, _options?: ToolDisplayResultOptions): T;
 
 type FormatToolObjectResultOptions = {
-    title?: string;
-    description?: string;
-    ui?: Record<string, UiSchema>;
     replyGuidance: string;
+    /** Optional layout hint for TRL rendering. Omit to let the dashboard infer. */
+    uiHint?: ToolUiHint;
 };
 type FormatToolListResultOptions = {
-    title: string;
-    itemUi?: UiSchema;
-    /** Composite widget for each row (uses list layout instead of table). */
-    itemWidget?: string;
     replyGuidance: string;
 };
-/** Wrap a flat object for schema-driven chat rendering. */
-declare function formatToolObjectResult(data: Record<string, unknown>, options: FormatToolObjectResultOptions): ToolResultWithReplyGuidance<_robotrock_core.ToolDisplayEnvelope<Record<string, unknown>>>;
-/** Wrap an array field as a list widget inside a display envelope. */
-declare function formatToolListResult(listKey: string, items: Record<string, unknown>[], options: FormatToolListResultOptions): ToolResultWithReplyGuidance<_robotrock_core.ToolDisplayEnvelope<Record<string, unknown>>>;
+/** Attach agent narration hints to plain tool JSON. No display/ui envelope. */
+declare function formatToolObjectResult(data: Record<string, unknown>, options: FormatToolObjectResultOptions): ToolResultWithReplyGuidance<Record<string, unknown>>;
+/** Wrap an array field as plain tool JSON with reply guidance and list layout hint. */
+declare function formatToolListResult(listKey: string, items: Record<string, unknown>[], options: FormatToolListResultOptions): {
+    [listKey]: Record<string, unknown>[];
+} & {
+    replyGuidance: string;
+} & {
+    uiHint: ToolUiHint;
+};
 declare function isAgentAdminErrorResult(result: unknown): result is {
     ok: false;
     message: string;

package/dist/index.d.ts

@@ -3,12 +3,13 @@ export { C as ChatsApi, c as CloseChatOptions, d as CreateChatInput, e as Create
 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-Blq0XoAr.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-ui-hint-CMpug5sC.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",
@@ -1574,6 +1582,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 +1601,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 +1622,7 @@ function textSubmitAction(prompt) {
     },
     ui: {
       answer: {
-        "ui:title": prompt.trim() || "Your answer",
+        "ui:title": decodedPrompt.trim() || "Your answer",
         "ui:widget": "textarea"
       }
     }
@@ -1619,15 +1631,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);
@@ -1811,7 +1823,7 @@ 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)}`;
 }