robotrock 1.0.0 → 1.3.0

package/dist/index-DoQN48Bm.d.ts

@@ -0,0 +1,200 @@
+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. */
+type EveInputOption = {
+    readonly id: string;
+    readonly label: string;
+    readonly description?: string;
+    readonly style?: "danger" | "default" | "primary";
+};
+/** Eve HITL display mode — mirrors `InputRequest.display` from the eve runtime. */
+type EveInputRequestDisplay = "confirmation" | "select" | "text";
+/**
+ * Minimal Eve `InputRequest` shape for RobotRock bridging. Intentionally
+ * self-contained so the SDK does not depend on the `eve` package.
+ */
+type EveInputRequest = {
+    readonly requestId: string;
+    readonly prompt: string;
+    readonly display?: EveInputRequestDisplay;
+    readonly allowFreeform?: boolean;
+    readonly options?: readonly EveInputOption[];
+};
+/** Eve `InputResponse` shape returned when resuming a parked session. */
+type EveInputResponse = {
+    readonly requestId: string;
+    readonly optionId?: string;
+    readonly text?: string;
+};
+declare const EVE_INPUT_SUBMIT_ACTION_ID: "submit";
+declare const EVE_INPUT_OTHER_CHOICE_ID: "__other__";
+declare const EVE_INPUT_OTHER_CHOICE_LABEL: "Type your own answer";
+/** Resolve the effective display mode when Eve omits `display`. */
+declare function resolveEveInputDisplay(request: EveInputRequest, toolName?: string): EveInputRequestDisplay;
+/** Keep select-form submissions mutually exclusive between preset choice and freeform other. */
+declare function normalizeEveSelectFormData(data: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Map an Eve `InputRequest` to RobotRock inbox actions.
+ */
+declare function eveInputRequestToActions(request: EveInputRequest, options?: {
+    toolName?: string;
+}): readonly SendToHumanActionInput[];
+/** Task type slug for an Eve input request. */
+declare function eveInputRequestTaskType(request: EveInputRequest, options?: {
+    toolName?: string;
+}): string;
+/**
+ * Map a handled RobotRock task action back to an Eve `InputResponse`.
+ */
+declare function taskHandledToEveInputResponse(request: EveInputRequest, actionId: string, actionData: unknown, options?: {
+    toolName?: string;
+}): EveInputResponse;
+
+type EveInputAuditContext = {
+    toolCallId: string;
+    toolName?: string;
+    requestId?: string;
+    display?: EveInputRequestDisplay;
+    toolInput?: unknown;
+};
+/**
+ * Map freeform composer text to an Eve `InputResponse`, mirroring Eve's
+ * `resolveTextToResponse` rules (option id/label, numeric index, freeform text).
+ */
+declare function resolveEveFreeformTextToInputResponse(request: EveInputRequest, text: string): EveInputResponse | undefined;
+/** Returns true for Eve's default approval gate (approve / deny options). */
+declare function isEveApprovalInputRequest(request: EveInputRequest): boolean;
+type EveInputActionSubmission = {
+    actionId: string;
+    actionTitle: string;
+    formData: Record<string, unknown>;
+};
+/**
+ * Map a resolved Eve `InputResponse` to RobotRock audit fields (action id/title).
+ */
+declare function eveInputResponseToActionSubmission(request: EveInputRequest, response: EveInputResponse, options?: {
+    toolName?: string;
+}): EveInputActionSubmission;
+/** Audit payload for `chat_action_input_submitted`. */
+declare function buildEveInputAuditSubmissionData(context: EveInputAuditContext, formData: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Parse an `ask_question` tool result output into an Eve input response shape.
+ */
+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. */
+declare function setToolDisplayLabelOverrides(overrides: Readonly<Record<string, string>>): void;
+/** Resolve a user-facing label for a tool slug. */
+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<{
+        id: z.ZodString;
+        title: z.ZodString;
+        data: z.ZodUnknown;
+    }, z.core.$strip>;
+    handledBy: z.ZodOptional<z.ZodString>;
+    handledAt: z.ZodString;
+    handlerType: z.ZodString;
+}, z.core.$strip>;
+type RobotRockWebhookPayload = z.infer<typeof robotRockWebhookPayloadBodySchema> & {
+    headers: Record<string, string>;
+};
+type RobotRockWebhookErrorCode = "MISSING_WEBHOOK_SECRET" | "MISSING_SIGNATURE" | "INVALID_SIGNATURE" | "INVALID_JSON" | "INVALID_PAYLOAD";
+declare class RobotRockWebhookError extends Error {
+    readonly code: RobotRockWebhookErrorCode;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: RobotRockWebhookErrorCode, details?: unknown | undefined);
+}
+interface VerifyRobotRockWebhookOptions {
+    /**
+     * Override shared secret (defaults to ROBOTROCK_WEBHOOK_SECRET).
+     * Keep undefined in production to enforce the canonical env var.
+     */
+    secret?: string;
+    /**
+     * Resolve the tenant signing secret by public task id (hosted MCP uses Convex).
+     * Used when secret is not passed explicitly.
+     */
+    resolveSecret?: (taskId: string) => Promise<string | undefined>;
+    /** Signature header to read. @default "x-robotrock-signature" */
+    signatureHeader?: string;
+}
+/**
+ * Verify a RobotRock webhook request and return a validated payload.
+ * Throws RobotRockWebhookError with machine-readable `code` for audit logging.
+ */
+declare function verifyRobotRockWebhook(request: Request, options?: VerifyRobotRockWebhookOptions): Promise<RobotRockWebhookPayload>;
+
+/** Build the assistant resume prompt when an inbox task linked to a chat is handled. */
+declare function buildTaskHandledResumeMessage(payload: RobotRockWebhookPayload): string;
+
+/** Hook slug advertised in GET /eve/v1/info for RobotRock-ready auto-detection. */
+declare const ROBOTROCK_READY_HOOK_SLUG = "robotrock-ready";
+
+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,10 +1,14 @@
-import { R as RobotRock, b as RobotRockConfig } from './client-CzVmjXpz.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, T as TasksApi, o as attachWebhookToActions, p as createChatsApi, q as createClient } from './client-CzVmjXpz.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';
-import { z } from 'zod';
+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 {
@@ -105,44 +109,4 @@ declare function assertNotPlatformRejectRequest(actionId: string, data?: unknown
  */
 declare function shouldStopAgentForHandledAction(actionId: string | undefined): boolean;
 
-declare const robotRockWebhookPayloadBodySchema: z.ZodObject<{
-    taskId: z.ZodString;
-    action: z.ZodObject<{
-        id: z.ZodString;
-        title: z.ZodString;
-        data: z.ZodUnknown;
-    }, z.core.$strip>;
-    handledBy: z.ZodOptional<z.ZodString>;
-    handledAt: z.ZodString;
-    handlerType: z.ZodString;
-}, z.core.$strip>;
-type RobotRockWebhookPayload = z.infer<typeof robotRockWebhookPayloadBodySchema> & {
-    headers: Record<string, string>;
-};
-type RobotRockWebhookErrorCode = "MISSING_WEBHOOK_SECRET" | "MISSING_SIGNATURE" | "INVALID_SIGNATURE" | "INVALID_JSON" | "INVALID_PAYLOAD";
-declare class RobotRockWebhookError extends Error {
-    readonly code: RobotRockWebhookErrorCode;
-    readonly details?: unknown | undefined;
-    constructor(message: string, code: RobotRockWebhookErrorCode, details?: unknown | undefined);
-}
-interface VerifyRobotRockWebhookOptions {
-    /**
-     * Override shared secret (defaults to ROBOTROCK_WEBHOOK_SECRET).
-     * Keep undefined in production to enforce the canonical env var.
-     */
-    secret?: string;
-    /**
-     * Resolve the tenant signing secret by public task id (hosted MCP uses Convex).
-     * Used when secret is not passed explicitly.
-     */
-    resolveSecret?: (taskId: string) => Promise<string | undefined>;
-    /** Signature header to read. @default "x-robotrock-signature" */
-    signatureHeader?: string;
-}
-/**
- * Verify a RobotRock webhook request and return a validated payload.
- * Throws RobotRockWebhookError with machine-readable `code` for audit logging.
- */
-declare function verifyRobotRockWebhook(request: Request, options?: VerifyRobotRockWebhookOptions): Promise<RobotRockWebhookPayload>;
-
-export { DiscriminatedApprovalResult, type HandledActionInput, type HandledOutcome, PLATFORM_MARK_DONE_ACTION_ID, PLATFORM_MARK_DONE_ACTION_TITLE, PLATFORM_REJECT_REQUEST_ACTION_ID, PLATFORM_REJECT_REQUEST_ACTION_TITLE, PLATFORM_TERMINAL_ACTION_IDS, type PlatformMarkDoneOutcome, type PlatformRejectRequestData, PlatformRejectRequestError, type PlatformRejectRequestOutcome, type PlatformTerminalActionId, RobotRock, RobotRockConfig, RobotRockError, RobotRockWebhookError, type RobotRockWebhookErrorCode, type RobotRockWebhookPayload, Task, type TaskActionOutcome, TaskExpiredError, TaskTimeoutError, type VerifyRobotRockWebhookOptions, assertNotPlatformRejectRequest, isPlatformMarkDoneAction, isPlatformRejectRequestAction, isPlatformTerminalAction, parseHandledOutcome, parsePlatformRejectRequestData, resolveRobotRockClient, resolveRobotRockConfig, shouldStopAgentForHandledAction, toDiscriminatedApprovalResult, verifyRobotRockWebhook };
+export { DiscriminatedApprovalResult, type HandledActionInput, type HandledOutcome, PLATFORM_MARK_DONE_ACTION_ID, PLATFORM_MARK_DONE_ACTION_TITLE, PLATFORM_REJECT_REQUEST_ACTION_ID, PLATFORM_REJECT_REQUEST_ACTION_TITLE, PLATFORM_TERMINAL_ACTION_IDS, type PlatformMarkDoneOutcome, type PlatformRejectRequestData, PlatformRejectRequestError, type PlatformRejectRequestOutcome, type PlatformTerminalActionId, RobotRock, RobotRockConfig, RobotRockError, Task, type TaskActionOutcome, TaskExpiredError, TaskTimeoutError, assertNotPlatformRejectRequest, isPlatformMarkDoneAction, isPlatformRejectRequestAction, isPlatformTerminalAction, parseHandledOutcome, parsePlatformRejectRequestData, resolveRobotRockClient, resolveRobotRockConfig, shouldStopAgentForHandledAction, toDiscriminatedApprovalResult };