robotrock 0.8.5 → 0.9.0

package/dist/{client-D-XEBOWd.d.ts → client-Cy7YLxms.d.ts}

@@ -1,4 +1,4 @@
-import { TaskContextInput, AssignToInput, TaskPriority, ThreadUpdateStatus, AgentTelemetryInput, TaskResponse, DiscriminatedApprovalResult, Task, ThreadUpdate } from './schemas/index.js';
+import { TaskContextFormatVersion, TaskContextInput, AssignToInput, TaskPriority, ThreadUpdateStatus, TaskResponse, DiscriminatedApprovalResult, Task, ThreadUpdate } from './schemas/index.js';
 
 type RobotRockWebhookConfig = {
     url: string;
@@ -14,6 +14,11 @@ interface RobotRockPollingOptions {
      */
     timeoutMs?: number;
 }
+/** Advanced client settings rarely changed by integrators. */
+type RobotRockAdvancedConfig = {
+    /** Task context wire format version sent on every request. @default 2 */
+    contextVersion?: TaskContextFormatVersion;
+};
 type RobotRockClientBaseConfig = {
     /** Optional override for API key. Falls back to ROBOTROCK_API_KEY. */
     apiKey?: string;
@@ -28,10 +33,12 @@ type RobotRockClientBaseConfig = {
      */
     app?: string;
     /**
-     * Task context format version sent on every `sendToHuman` request.
-     * @default 2
+     * Agent release version (semver, git SHA, deploy tag).
+     * Defaults to `AGENT_VERSION` or `ROBOTROCK_AGENT_VERSION` from env when omitted.
      */
-    version?: 2;
+    version?: string;
+    /** Advanced settings (context wire format, etc.). */
+    advanced?: RobotRockAdvancedConfig;
 };
 /** Client config with a webhook (mutually exclusive with `polling`). */
 type RobotRockWebhookClientConfig = RobotRockClientBaseConfig & {
@@ -46,7 +53,7 @@ type RobotRockPollingClientConfig = RobotRockClientBaseConfig & {
 type RobotRockConfig = RobotRockWebhookClientConfig | RobotRockPollingClientConfig;
 type SendToHumanActionInput = Omit<TaskContextInput["actions"][number], "handlers">;
 type SendToHumanValidUntil = Date | string;
-type SendToHumanInput<A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[]> = Omit<TaskContextInput, "app" | "actions" | "version" | "validUntil"> & {
+type SendToHumanInput<A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[]> = Omit<TaskContextInput, "app" | "actions" | "contextVersion" | "version" | "validUntil"> & {
     actions: A;
     /** Task deadline; serialized to an ISO 8601 string on the wire. */
     validUntil?: SendToHumanValidUntil;
@@ -75,10 +82,10 @@ type SendToHumanInput<A extends readonly SendToHumanActionInput[] = readonly Sen
         status?: ThreadUpdateStatus;
     };
     /**
-     * Agent telemetry (version, cost, tool calls) — not shown in inbox UI.
+     * Agent release version override. When omitted, uses the client `version`.
      * Used for statistics and feedback analysis.
      */
-    agent?: AgentTelemetryInput;
+    version?: string;
 };
 type SendToHumanWithAppInput<A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[]> = (SendToHumanInput<A> | Readonly<SendToHumanInput<A>>) & {
     /** Inbox app bucket. Overrides the client `app` when set. */
@@ -111,7 +118,8 @@ declare class RobotRock {
     private readonly apiKey;
     private readonly baseUrl;
     private readonly app?;
-    private readonly version;
+    private readonly agentVersion?;
+    private readonly contextVersion;
     private readonly webhook?;
     private readonly polling;
     constructor(config: RobotRockConfig);
@@ -134,4 +142,4 @@ declare class RobotRock {
 declare function createClient(config: RobotRockConfig): RobotRock;
 declare function attachWebhookToActions(actions: readonly SendToHumanActionInput[], webhook: RobotRockWebhookConfig): TaskContextInput["actions"];
 
-export { RobotRock as R, type SendToHumanActionInput as S, type SendToHumanInput as a, type RobotRockConfig as b, RobotRockError as c, type RobotRockPollingClientConfig as d, type RobotRockPollingOptions as e, type RobotRockWebhookClientConfig as f, type RobotRockWebhookConfig as g, type SendToHumanResult as h, type SendToHumanValidUntil as i, type SendUpdateInput as j, attachWebhookToActions as k, createClient as l };
+export { RobotRock as R, type SendToHumanActionInput as S, type SendToHumanInput as a, type RobotRockConfig as b, type RobotRockAdvancedConfig as c, RobotRockError as d, type RobotRockPollingClientConfig as e, type RobotRockPollingOptions as f, type RobotRockWebhookClientConfig as g, type RobotRockWebhookConfig as h, type SendToHumanResult as i, type SendToHumanValidUntil as j, type SendUpdateInput as k, attachWebhookToActions as l, createClient as m };

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-import { R as RobotRock, b as RobotRockConfig } from './client-D-XEBOWd.js';
-export { c as RobotRockError, d as RobotRockPollingClientConfig, e as RobotRockPollingOptions, f as RobotRockWebhookClientConfig, g as RobotRockWebhookConfig, S as SendToHumanActionInput, a as SendToHumanInput, h as SendToHumanResult, i as SendToHumanValidUntil, j as SendUpdateInput, k as attachWebhookToActions, l as createClient } from './client-D-XEBOWd.js';
+import { R as RobotRock, b as RobotRockConfig } from './client-Cy7YLxms.js';
+export { c as RobotRockAdvancedConfig, d as RobotRockError, e as RobotRockPollingClientConfig, f as RobotRockPollingOptions, g as RobotRockWebhookClientConfig, h as RobotRockWebhookConfig, S as SendToHumanActionInput, a as SendToHumanInput, i as SendToHumanResult, j as SendToHumanValidUntil, k as SendUpdateInput, l as attachWebhookToActions, m as createClient } from './client-Cy7YLxms.js';
 import { Task, DiscriminatedApprovalResult } from './schemas/index.js';
-export { AGENT_OTEL_SPANS_MAX, AgentCost, AgentCostTokens, AgentOtel, AgentOtelSpanStatus, AgentOtelSpanSummary, AgentTelemetry, AgentTelemetryInput, AgentToolCalls, ApprovalResult, AssignToInput, CreateTaskBody, CreateTaskBodyInput, DEFAULT_TASK_PRIORITY, DEFAULT_THREAD_UPDATE_STATUS, Handler, InferActionData, LOWEST_TASK_PRIORITY, TASK_PRIORITY_RANK, TaskAction, TaskContext, TaskContextInput, TaskPriority, TaskResponse, TaskResult, TaskStatus, ThreadUpdate, ThreadUpdateBody, ThreadUpdateBodyInput, ThreadUpdateInput, ThreadUpdateResponse, ThreadUpdateSource, ThreadUpdateStatus, TriggerHandler, TupleElementIndices, WebhookHandler, agentCostSchema, agentCostTokensSchema, agentOtelSchema, agentOtelSpanStatusSchema, agentOtelSpanSummarySchema, agentTelemetrySchema, agentToolCallsSchema, assignToSchema, createTaskBodySchema, taskContextSchema, taskPriorities, taskPrioritySchema, threadUpdateBodySchema, threadUpdateInputSchema, threadUpdateStatusSchema, threadUpdateStatuses } 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 { R as RobotRockHandlerWebhookPayload } from './handler-webhook-BqEi6Bk-.js';
-export { AgentTelemetryFromOtelOptions, OtelSpanLike, OtelSpanSummaryInput, agentTelemetryFromOtel, toolCallsFromOtelSpans } from './otel/index.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 '@opentelemetry/api';
 
 /**
  * Read RobotRock client config from environment variables.
@@ -98,7 +98,7 @@ declare function assertNotPlatformRejectRequest(actionId: string, data?: unknown
  */
 declare function shouldStopAgentForHandledAction(actionId: string | undefined): boolean;
 
-declare const robotRockWebhookPayloadSchema: z.ZodObject<{
+declare const robotRockWebhookPayloadBodySchema: z.ZodObject<{
     taskId: z.ZodString;
     action: z.ZodObject<{
         id: z.ZodString;
@@ -108,15 +108,16 @@ declare const robotRockWebhookPayloadSchema: z.ZodObject<{
     handledBy: z.ZodOptional<z.ZodString>;
     handledAt: z.ZodString;
     handlerType: z.ZodString;
-    headers: z.ZodRecord<z.ZodString, 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);
 }
-type RobotRockWebhookPayload = z.infer<typeof robotRockWebhookPayloadSchema>;
 interface VerifyRobotRockWebhookOptions {
     /**
      * Override shared secret (defaults to ROBOTROCK_WEBHOOK_SECRET).