robotrock 1.1.0 → 1.3.0

package/dist/{index-BL9qKHA8.d.ts → index-DoQN48Bm.d.ts}

@@ -1,4 +1,7 @@
-import { S as SendToHumanActionInput } from './client-XTnFHGFE.js';
+import { S as SendToHumanActionInput } from './client-YO9Y1rkH.js';
+import { UiSchema, ToolDisplayEnvelope } from '@robotrock/core/schemas';
+import { T as ToolResultWithReplyGuidance } from './tool-reply-guidance-C3qrT1In.js';
+import * as _robotrock_core from '@robotrock/core';
 import { z } from 'zod';
 
 /** One selectable option in an Eve HITL input request. */
@@ -83,6 +86,28 @@ declare function buildEveInputAuditSubmissionData(context: EveInputAuditContext,
  */
 declare function parseEveAskQuestionToolOutput(output: unknown): Pick<EveInputResponse, "optionId" | "text"> | null;
 
+type ChatToolAuditInput = Record<string, unknown>;
+type ChatToolAuditPayload = {
+    toolCallId: string;
+    toolName: string;
+    input: ChatToolAuditInput;
+    success: boolean;
+    status: "completed" | "failed" | "rejected";
+    error?: string;
+};
+/** Whether a completed tool call should appear on the RobotRock audit trail. */
+declare function shouldAuditToolExecution(toolName: string, input: ChatToolAuditInput): boolean;
+/** Keep only fields useful for audit display (no secrets or large blobs). */
+declare function sanitizeToolAuditInput(input: ChatToolAuditInput): ChatToolAuditInput;
+declare function buildChatToolAuditPayload(input: {
+    toolCallId: string;
+    toolName: string;
+    toolInput: ChatToolAuditInput;
+    status: "completed" | "failed" | "rejected";
+    error?: string;
+    isError?: boolean;
+}): ChatToolAuditPayload | null;
+
 /** Default per-tool labels for common Eve demo/integration tools. */
 declare const DEFAULT_TOOL_DISPLAY_LABELS: Readonly<Record<string, string>>;
 /** Register additional or overriding tool display labels at runtime. */
@@ -92,6 +117,40 @@ declare function getToolDisplayLabel(toolName: string): string;
 /** Format an Eve input request prompt for human-facing approval UIs. */
 declare function formatEveApprovalTitle(request: EveInputRequest, toolName?: string): string;
 
+type ToolDisplayResultOptions = {
+    widget?: string;
+    title?: string;
+    description?: string;
+    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.
+ */
+declare function toolDisplayResult<T extends Record<string, unknown>>(data: T, options?: ToolDisplayResultOptions): ToolDisplayEnvelope<T>;
+
+type FormatToolObjectResultOptions = {
+    title?: string;
+    description?: string;
+    ui?: Record<string, UiSchema>;
+    replyGuidance: string;
+};
+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>>>;
+declare function isAgentAdminErrorResult(result: unknown): result is {
+    ok: false;
+    message: string;
+};
+
 declare const robotRockWebhookPayloadBodySchema: z.ZodObject<{
     taskId: z.ZodString;
     action: z.ZodObject<{
@@ -138,4 +197,4 @@ declare function buildTaskHandledResumeMessage(payload: RobotRockWebhookPayload)
 /** Hook slug advertised in GET /eve/v1/info for RobotRock-ready auto-detection. */
 declare const ROBOTROCK_READY_HOOK_SLUG = "robotrock-ready";
 
-export { DEFAULT_TOOL_DISPLAY_LABELS as D, EVE_INPUT_OTHER_CHOICE_ID as E, ROBOTROCK_READY_HOOK_SLUG as R, type VerifyRobotRockWebhookOptions as V, EVE_INPUT_OTHER_CHOICE_LABEL as a, EVE_INPUT_SUBMIT_ACTION_ID as b, type EveInputOption as c, type EveInputRequest as d, type EveInputRequestDisplay as e, type EveInputResponse as f, RobotRockWebhookError as g, type RobotRockWebhookErrorCode as h, type RobotRockWebhookPayload as i, buildTaskHandledResumeMessage as j, eveInputRequestTaskType as k, eveInputRequestToActions as l, formatEveApprovalTitle as m, getToolDisplayLabel as n, normalizeEveSelectFormData as o, type EveInputActionSubmission as p, type EveInputAuditContext as q, resolveEveInputDisplay as r, setToolDisplayLabelOverrides as s, taskHandledToEveInputResponse as t, buildEveInputAuditSubmissionData as u, verifyRobotRockWebhook as v, eveInputResponseToActionSubmission as w, isEveApprovalInputRequest as x, parseEveAskQuestionToolOutput as y, resolveEveFreeformTextToInputResponse as z };
+export { formatToolListResult as A, formatToolObjectResult as B, type ChatToolAuditInput as C, DEFAULT_TOOL_DISPLAY_LABELS as D, EVE_INPUT_OTHER_CHOICE_ID as E, type FormatToolListResultOptions as F, isAgentAdminErrorResult as G, isEveApprovalInputRequest as H, parseEveAskQuestionToolOutput as I, resolveEveFreeformTextToInputResponse as J, sanitizeToolAuditInput as K, shouldAuditToolExecution as L, toolDisplayResult as M, ROBOTROCK_READY_HOOK_SLUG as R, type ToolDisplayResultOptions as T, type VerifyRobotRockWebhookOptions as V, EVE_INPUT_OTHER_CHOICE_LABEL as a, EVE_INPUT_SUBMIT_ACTION_ID as b, type EveInputOption as c, type EveInputRequest as d, type EveInputRequestDisplay as e, type EveInputResponse as f, RobotRockWebhookError as g, type RobotRockWebhookErrorCode as h, type RobotRockWebhookPayload as i, buildTaskHandledResumeMessage as j, eveInputRequestTaskType as k, eveInputRequestToActions as l, formatEveApprovalTitle as m, getToolDisplayLabel as n, normalizeEveSelectFormData as o, type ChatToolAuditPayload as p, type EveInputActionSubmission as q, resolveEveInputDisplay as r, setToolDisplayLabelOverrides as s, taskHandledToEveInputResponse as t, type EveInputAuditContext as u, verifyRobotRockWebhook as v, type FormatToolObjectResultOptions as w, buildChatToolAuditPayload as x, buildEveInputAuditSubmissionData as y, eveInputResponseToActionSubmission as z };

package/dist/index.d.ts

@@ -1,11 +1,14 @@
-import { R as RobotRock, b as RobotRockConfig } from './client-XTnFHGFE.js';
-export { C as ChatsApi, c as CloseChatOptions, d as CreateChatInput, e as CreateChatResult, f as CreatedChat, g as RobotRockAdvancedConfig, h as RobotRockPollingClientConfig, i as RobotRockPollingOptions, j as RobotRockWebhookClientConfig, k as RobotRockWebhookConfig, S as SendToHumanActionInput, a as SendToHumanInput, l as SendToHumanResult, m as SendToHumanValidUntil, n as SendUpdateInput, o as StageChatHitlRequestsInput, p as StagedChatHitlRequest, T as TasksApi, q as attachWebhookToActions, r as createChatsApi, s as createClient } from './client-XTnFHGFE.js';
+import { R as RobotRock, b as RobotRockConfig } from './client-YO9Y1rkH.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-YO9Y1rkH.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-BL9qKHA8.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-DoQN48Bm.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 './auth-headers-qL-ZeEtd.js';
+import '@robotrock/core/schemas';
+import './tool-reply-guidance-C3qrT1In.js';
 import '@opentelemetry/api';
 
 declare class RobotRockError extends Error {