robotrock 0.8.5 → 1.0.0

package/dist/otel-platform-DzHyHkGk.d.ts

@@ -0,0 +1,108 @@
+import { Span } from '@opentelemetry/api';
+import { ApprovalResult, DiscriminatedApprovalResult } from './schemas/index.js';
+
+/**
+ * JSON body posted when a RobotRock action handler runs (webhook or Trigger wait token).
+ */
+interface RobotRockHandlerWebhookPayload {
+    taskId: string;
+    action: {
+        id: string;
+        title: string;
+        data: unknown;
+    };
+    handledBy?: string;
+    handledAt: string;
+    handlerType: string;
+}
+
+/** Minimal span surface used by handle-time OTel recording. */
+type OtelSpanLike = Pick<Span, "spanContext" | "setAttribute" | "addEvent" | "setStatus" | "end">;
+type RobotRockOtelHandle = {
+    traceId: string;
+    spanId: string;
+    taskId: string;
+    taskCreatedAt: number;
+    threadId?: string;
+};
+type RobotRockOtelRecordOptions = {
+    handle?: RobotRockOtelHandle;
+    span?: OtelSpanLike | Span | null;
+    includeActionData?: boolean;
+    tracerName?: string;
+};
+type RobotRockHandledOtelInput = {
+    taskId: string;
+    threadId?: string;
+    action: {
+        id: string;
+        title?: string;
+        data: unknown;
+    };
+    handledBy?: string;
+    handledAt: string | number | Date;
+};
+type RobotRockHandledRecordInput = RobotRockHandlerWebhookPayload | ApprovalResult | DiscriminatedApprovalResult<readonly {
+    id: string;
+    schema?: unknown;
+}[]>;
+/** Normalize handled payloads from Trigger, Workflow, or polling. */
+declare function toRobotRockHandledOtelInput(handled: RobotRockHandledRecordInput): RobotRockHandledOtelInput;
+/**
+ * Capture trace + task metadata after RobotRock task create (before human wait).
+ * Used by Trigger.dev and Vercel Workflow durable integrations.
+ */
+declare function captureRobotRockOtelHandle(task: {
+    taskId: string;
+    threadId?: string;
+    submittedAt?: string;
+}, options?: {
+    span?: OtelSpanLike | Span | null;
+}): RobotRockOtelHandle;
+/**
+ * Start a child span for the human-wait phase on the active trace.
+ */
+declare function startRobotRockHumanWaitSpan(handle: RobotRockOtelHandle, options?: {
+    tracerName?: string;
+    span?: OtelSpanLike | Span | null;
+}): Span | undefined;
+/**
+ * Record human action attributes and a span event on the active or wait span.
+ */
+declare function recordRobotRockHandledToOtel(handled: RobotRockHandledRecordInput, options?: RobotRockOtelRecordOptions): void;
+type EndRobotRockHumanWaitSpanOptions = {
+    handle?: RobotRockOtelHandle;
+    outcome?: "handled" | "timeout" | "error";
+    includeActionData?: boolean;
+};
+/**
+ * End the human-wait child span, recording handled data or a timeout/error outcome.
+ */
+declare function endRobotRockHumanWaitSpan(span: Span | undefined, handled: RobotRockHandledRecordInput | null, options?: EndRobotRockHumanWaitSpanOptions): void;
+
+type RobotRockPlatformOtelFields = {
+    /**
+     * Record human handle result on the active OTel span (Trigger / Workflow).
+     * Defaults to `ROBOTROCK_OTEL_RECORD_HANDLED` env (`true` / `1`).
+     */
+    recordOtel?: boolean;
+    /** Include truncated action feedback data on OTel spans (off by default). */
+    otelIncludeActionData?: boolean;
+};
+declare function shouldRecordRobotRockOtel(recordOtel?: boolean): boolean;
+declare function stripPlatformOtelFields<T extends RobotRockPlatformOtelFields & Record<string, unknown>>(payload: T): Omit<T, "recordOtel" | "otelIncludeActionData">;
+type RobotRockCreatedTask = {
+    taskId: string;
+    threadId?: string;
+    submittedAt?: string;
+};
+type RobotRockHumanWaitOtelSession = {
+    recordOtel: boolean;
+    handle?: RobotRockOtelHandle;
+    waitSpan?: Span;
+    includeActionData?: boolean;
+};
+declare function beginRobotRockHumanWaitOtel(task: RobotRockCreatedTask, options?: Pick<RobotRockPlatformOtelFields, "recordOtel" | "otelIncludeActionData">): RobotRockHumanWaitOtelSession;
+declare function finishRobotRockHumanWaitOtel(session: RobotRockHumanWaitOtelSession, handled: Parameters<typeof endRobotRockHumanWaitSpan>[1], outcome: "handled" | "timeout" | "error"): void;
+
+export { type EndRobotRockHumanWaitSpanOptions as E, type RobotRockPlatformOtelFields as R, type RobotRockHandlerWebhookPayload as a, type RobotRockCreatedTask as b, type RobotRockHandledOtelInput as c, type RobotRockHumanWaitOtelSession as d, type RobotRockOtelHandle as e, type RobotRockOtelRecordOptions as f, beginRobotRockHumanWaitOtel as g, captureRobotRockOtelHandle as h, endRobotRockHumanWaitSpan as i, finishRobotRockHumanWaitOtel as j, startRobotRockHumanWaitSpan as k, stripPlatformOtelFields as l, recordRobotRockHandledToOtel as r, shouldRecordRobotRockOtel as s, toRobotRockHandledOtelInput as t };

package/dist/schemas/index.d.ts

@@ -79,6 +79,15 @@ declare const handlerSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     type: z.ZodLiteral<"trigger">;
     tokenId: z.ZodString;
 }, z.core.$strip>], "type">;
+/** Action config without handlers — used for chat widgets and agent tool input. */
+declare const taskActionInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodCustom<ExtendedJSONSchema7, ExtendedJSONSchema7>>;
+    ui: z.ZodOptional<z.ZodCustom<UiSchema, UiSchema>>;
+    data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
 declare const taskActionSchema: z.ZodObject<{
     id: z.ZodString;
     title: z.ZodString;
@@ -97,7 +106,10 @@ declare const taskActionSchema: z.ZodObject<{
         tokenId: z.ZodString;
     }, z.core.$strip>], "type">>>;
 }, z.core.$strip>;
-declare const taskContextSchema: z.ZodObject<{
+/** Task context wire format version (always `2` today). */
+declare const TASK_CONTEXT_FORMAT_VERSION: 2;
+type TaskContextFormatVersion = typeof TASK_CONTEXT_FORMAT_VERSION;
+declare const taskContextSchema: z.ZodPipe<z.ZodObject<{
     app: z.ZodOptional<z.ZodString>;
     type: z.ZodString;
     name: z.ZodString;
@@ -107,6 +119,7 @@ declare const taskContextSchema: z.ZodObject<{
         data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<Record<string, unknown>, unknown, z.core.$ZodTypeInternals<Record<string, unknown>, unknown>>>>;
     }, z.core.$strip>>;
+    contextVersion: z.ZodOptional<z.ZodLiteral<2>>;
     version: z.ZodOptional<z.ZodLiteral<2>>;
     actions: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -126,7 +139,69 @@ declare const taskContextSchema: z.ZodObject<{
             tokenId: z.ZodString;
         }, z.core.$strip>], "type">>>;
     }, z.core.$strip>>;
-}, z.core.$strip>;
+}, z.core.$strip>, z.ZodTransform<Omit<{
+    type: string;
+    name: string;
+    actions: {
+        id: string;
+        title: string;
+        description?: string | undefined;
+        schema?: ExtendedJSONSchema7 | undefined;
+        ui?: UiSchema | undefined;
+        data?: Record<string, unknown> | undefined;
+        handlers?: ({
+            type: "webhook";
+            url: string;
+            headers: Record<string, string>;
+        } | {
+            url: string;
+            headers: Record<string, string>;
+            type: "trigger";
+            tokenId: string;
+        })[] | undefined;
+    }[];
+    app?: string | undefined;
+    description?: string | undefined;
+    validUntil?: string | undefined;
+    context?: {
+        data: Record<string, unknown>;
+        ui?: Record<string, Record<string, unknown>> | undefined;
+    } | undefined;
+    contextVersion?: 2 | undefined;
+    version?: 2 | undefined;
+}, "contextVersion" | "version"> & {
+    contextVersion: 2;
+}, {
+    type: string;
+    name: string;
+    actions: {
+        id: string;
+        title: string;
+        description?: string | undefined;
+        schema?: ExtendedJSONSchema7 | undefined;
+        ui?: UiSchema | undefined;
+        data?: Record<string, unknown> | undefined;
+        handlers?: ({
+            type: "webhook";
+            url: string;
+            headers: Record<string, string>;
+        } | {
+            url: string;
+            headers: Record<string, string>;
+            type: "trigger";
+            tokenId: string;
+        })[] | undefined;
+    }[];
+    app?: string | undefined;
+    description?: string | undefined;
+    validUntil?: string | undefined;
+    context?: {
+        data: Record<string, unknown>;
+        ui?: Record<string, Record<string, unknown>> | undefined;
+    } | undefined;
+    contextVersion?: 2 | undefined;
+    version?: 2 | undefined;
+}>>;
 /**
  * Assignment targets at task create (not stored in task context JSON).
  * Unknown user emails are auto-provisioned as assignee memberships (count toward seat limits).
@@ -178,76 +253,10 @@ type TaskPriority = (typeof taskPriorities)[number];
 declare const DEFAULT_TASK_PRIORITY: TaskPriority;
 declare const LOWEST_TASK_PRIORITY: TaskPriority;
 declare const TASK_PRIORITY_RANK: Record<TaskPriority, number>;
-declare const agentCostTokensSchema: z.ZodObject<{
-    input: z.ZodOptional<z.ZodNumber>;
-    output: z.ZodOptional<z.ZodNumber>;
-    total: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-declare const agentCostSchema: z.ZodObject<{
-    tokens: z.ZodOptional<z.ZodObject<{
-        input: z.ZodOptional<z.ZodNumber>;
-        output: z.ZodOptional<z.ZodNumber>;
-        total: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
-    eur: z.ZodOptional<z.ZodNumber>;
-    usd: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-declare const AGENT_OTEL_SPANS_MAX = 32;
-declare const agentToolCallsSchema: z.ZodRecord<z.ZodString, z.ZodNumber>;
-declare const agentOtelSpanStatusSchema: z.ZodEnum<{
-    error: "error";
-    ok: "ok";
-}>;
-declare const agentOtelSpanSummarySchema: z.ZodObject<{
-    name: z.ZodString;
-    durationMs: z.ZodNumber;
-    status: z.ZodEnum<{
-        error: "error";
-        ok: "ok";
-    }>;
-}, z.core.$strip>;
-declare const agentOtelSchema: z.ZodObject<{
-    traceId: z.ZodString;
-    spanId: z.ZodOptional<z.ZodString>;
-    rootDurationMs: z.ZodOptional<z.ZodNumber>;
-    spans: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        name: z.ZodString;
-        durationMs: z.ZodNumber;
-        status: z.ZodEnum<{
-            error: "error";
-            ok: "ok";
-        }>;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
 declare const agentTelemetrySchema: z.ZodObject<{
-    version: z.ZodOptional<z.ZodString>;
-    toolCallCount: z.ZodOptional<z.ZodNumber>;
-    toolCalls: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-    cost: z.ZodOptional<z.ZodObject<{
-        tokens: z.ZodOptional<z.ZodObject<{
-            input: z.ZodOptional<z.ZodNumber>;
-            output: z.ZodOptional<z.ZodNumber>;
-            total: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
-        eur: z.ZodOptional<z.ZodNumber>;
-        usd: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
-    info: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    otel: z.ZodOptional<z.ZodObject<{
-        traceId: z.ZodString;
-        spanId: z.ZodOptional<z.ZodString>;
-        rootDurationMs: z.ZodOptional<z.ZodNumber>;
-        spans: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            name: z.ZodString;
-            durationMs: z.ZodNumber;
-            status: z.ZodEnum<{
-                error: "error";
-                ok: "ok";
-            }>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
+    version: z.ZodString;
 }, z.core.$strip>;
-declare const createTaskBodySchema: z.ZodObject<{
+declare const createTaskBodySchema: z.ZodPipe<z.ZodObject<{
     app: z.ZodOptional<z.ZodString>;
     type: z.ZodString;
     name: z.ZodString;
@@ -257,6 +266,7 @@ declare const createTaskBodySchema: z.ZodObject<{
         data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         ui: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<Record<string, unknown>, unknown, z.core.$ZodTypeInternals<Record<string, unknown>, unknown>>>>;
     }, z.core.$strip>>;
+    contextVersion: z.ZodOptional<z.ZodLiteral<2>>;
     version: z.ZodOptional<z.ZodLiteral<2>>;
     actions: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -300,34 +310,97 @@ declare const createTaskBodySchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>>;
     agent: z.ZodOptional<z.ZodObject<{
-        version: z.ZodOptional<z.ZodString>;
-        toolCallCount: z.ZodOptional<z.ZodNumber>;
-        toolCalls: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
-        cost: z.ZodOptional<z.ZodObject<{
-            tokens: z.ZodOptional<z.ZodObject<{
-                input: z.ZodOptional<z.ZodNumber>;
-                output: z.ZodOptional<z.ZodNumber>;
-                total: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>>;
-            eur: z.ZodOptional<z.ZodNumber>;
-            usd: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>>;
-        info: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        otel: z.ZodOptional<z.ZodObject<{
-            traceId: z.ZodString;
-            spanId: z.ZodOptional<z.ZodString>;
-            rootDurationMs: z.ZodOptional<z.ZodNumber>;
-            spans: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                name: z.ZodString;
-                durationMs: z.ZodNumber;
-                status: z.ZodEnum<{
-                    error: "error";
-                    ok: "ok";
-                }>;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>>;
+        version: z.ZodString;
     }, z.core.$strip>>;
-}, z.core.$strip>;
+}, z.core.$strip>, z.ZodTransform<Omit<{
+    type: string;
+    name: string;
+    actions: {
+        id: string;
+        title: string;
+        description?: string | undefined;
+        schema?: ExtendedJSONSchema7 | undefined;
+        ui?: UiSchema | undefined;
+        data?: Record<string, unknown> | undefined;
+        handlers?: ({
+            type: "webhook";
+            url: string;
+            headers: Record<string, string>;
+        } | {
+            url: string;
+            headers: Record<string, string>;
+            type: "trigger";
+            tokenId: string;
+        })[] | undefined;
+    }[];
+    app?: string | undefined;
+    description?: string | undefined;
+    validUntil?: string | undefined;
+    context?: {
+        data: Record<string, unknown>;
+        ui?: Record<string, Record<string, unknown>> | undefined;
+    } | undefined;
+    contextVersion?: 2 | undefined;
+    version?: 2 | undefined;
+    assignTo?: {
+        users?: string[] | undefined;
+        groups?: string[] | undefined;
+    } | undefined;
+    threadId?: string | undefined;
+    priority?: "low" | "normal" | "high" | "urgent" | undefined;
+    update?: {
+        message: string;
+        status?: "info" | "queued" | "running" | "waiting" | "succeeded" | "failed" | "cancelled" | undefined;
+    } | undefined;
+    agent?: {
+        version: string;
+    } | undefined;
+}, "contextVersion" | "version"> & {
+    contextVersion: 2;
+}, {
+    type: string;
+    name: string;
+    actions: {
+        id: string;
+        title: string;
+        description?: string | undefined;
+        schema?: ExtendedJSONSchema7 | undefined;
+        ui?: UiSchema | undefined;
+        data?: Record<string, unknown> | undefined;
+        handlers?: ({
+            type: "webhook";
+            url: string;
+            headers: Record<string, string>;
+        } | {
+            url: string;
+            headers: Record<string, string>;
+            type: "trigger";
+            tokenId: string;
+        })[] | undefined;
+    }[];
+    app?: string | undefined;
+    description?: string | undefined;
+    validUntil?: string | undefined;
+    context?: {
+        data: Record<string, unknown>;
+        ui?: Record<string, Record<string, unknown>> | undefined;
+    } | undefined;
+    contextVersion?: 2 | undefined;
+    version?: 2 | undefined;
+    assignTo?: {
+        users?: string[] | undefined;
+        groups?: string[] | undefined;
+    } | undefined;
+    threadId?: string | undefined;
+    priority?: "low" | "normal" | "high" | "urgent" | undefined;
+    update?: {
+        message: string;
+        status?: "info" | "queued" | "running" | "waiting" | "succeeded" | "failed" | "cancelled" | undefined;
+    } | undefined;
+    agent?: {
+        version: string;
+    } | undefined;
+}>>;
 /** POST /v1/threads/:threadId/updates body: a standalone thread update. */
 declare const threadUpdateBodySchema: z.ZodObject<{
     message: z.ZodString;
@@ -363,16 +436,11 @@ type ThreadUpdateInput = z.input<typeof threadUpdateInputSchema>;
 type TaskContextInput = z.input<typeof taskContextSchema>;
 type TaskContextOutput = z.output<typeof taskContextSchema>;
 type TaskContext = TaskContextOutput;
+type TaskActionInput = z.infer<typeof taskActionInputSchema>;
 type TaskAction = z.infer<typeof taskActionSchema>;
 type WebhookHandler = z.infer<typeof webhookHandlerSchema>;
 type TriggerHandler = z.infer<typeof triggerHandlerSchema>;
 type Handler = z.infer<typeof handlerSchema>;
-type AgentCostTokens = z.infer<typeof agentCostTokensSchema>;
-type AgentCost = z.infer<typeof agentCostSchema>;
-type AgentToolCalls = z.infer<typeof agentToolCallsSchema>;
-type AgentOtelSpanStatus = z.infer<typeof agentOtelSpanStatusSchema>;
-type AgentOtelSpanSummary = z.infer<typeof agentOtelSpanSummarySchema>;
-type AgentOtel = z.infer<typeof agentOtelSchema>;
 type AgentTelemetry = z.infer<typeof agentTelemetrySchema>;
 type AgentTelemetryInput = z.input<typeof agentTelemetrySchema>;
 type InferObjectProperties<Props, Req extends PropertyKey> = Props extends Record<string, unknown> ? ({
@@ -476,4 +544,4 @@ type DiscriminatedApprovalResult<TActions extends readonly {
     } : never;
 }[TupleElementIndices<TActions>];
 
-export { AGENT_OTEL_SPANS_MAX, type AgentCost, type AgentCostTokens, type AgentOtel, type AgentOtelSpanStatus, type AgentOtelSpanSummary, type AgentTelemetry, type AgentTelemetryInput, type AgentToolCalls, type ApprovalResult, type AssignToInput, type CreateTaskBody, type CreateTaskBodyInput, DEFAULT_TASK_PRIORITY, DEFAULT_THREAD_UPDATE_STATUS, type DiscriminatedApprovalResult, type ExtendedJSONSchema7, type Handler, type InferActionData, type InferJsonSchema7, type JSONSchema7, type JSONSchema7TypeName, LOWEST_TASK_PRIORITY, TASK_PRIORITY_RANK, type Task, type TaskAction, type TaskContext, type TaskContextInput, type TaskContextOutput, type TaskPriority, type TaskResponse, type TaskResult, type TaskStatus, type ThreadUpdate, type ThreadUpdateBody, type ThreadUpdateBodyInput, type ThreadUpdateInput, type ThreadUpdateResponse, type ThreadUpdateSource, type ThreadUpdateStatus, type TriggerHandler, type TupleElementIndices, type UiSchema, type WebhookHandler, agentCostSchema, agentCostTokensSchema, agentOtelSchema, agentOtelSpanStatusSchema, agentOtelSpanSummarySchema, agentTelemetrySchema, agentToolCallsSchema, assignToSchema, createTaskBodySchema, taskContextSchema, taskPriorities, taskPrioritySchema, threadUpdateBodySchema, threadUpdateInputSchema, threadUpdateMessageSchema, threadUpdateStatusSchema, threadUpdateStatuses };
+export { type AgentTelemetry, type AgentTelemetryInput, type ApprovalResult, type AssignToInput, type CreateTaskBody, type CreateTaskBodyInput, DEFAULT_TASK_PRIORITY, DEFAULT_THREAD_UPDATE_STATUS, type DiscriminatedApprovalResult, type ExtendedJSONSchema7, type Handler, type InferActionData, type InferJsonSchema7, type JSONSchema7, type JSONSchema7TypeName, LOWEST_TASK_PRIORITY, TASK_CONTEXT_FORMAT_VERSION, TASK_PRIORITY_RANK, type Task, type TaskAction, type TaskActionInput, type TaskContext, type TaskContextFormatVersion, type TaskContextInput, type TaskContextOutput, type TaskPriority, type TaskResponse, type TaskResult, type TaskStatus, type ThreadUpdate, type ThreadUpdateBody, type ThreadUpdateBodyInput, type ThreadUpdateInput, type ThreadUpdateResponse, type ThreadUpdateSource, type ThreadUpdateStatus, type TriggerHandler, type TupleElementIndices, type UiSchema, type WebhookHandler, agentTelemetrySchema, assignToSchema, createTaskBodySchema, taskActionInputSchema, taskContextSchema, taskPriorities, taskPrioritySchema, threadUpdateBodySchema, threadUpdateInputSchema, threadUpdateMessageSchema, threadUpdateStatusSchema, threadUpdateStatuses };