robotrock 0.8.5 → 1.0.0

package/dist/index.js

@@ -164,12 +164,12 @@ function validateUrlValue(value, widget) {
   }
   return null;
 }
-function validateContextPublicUrls(context) {
-  if (!context?.data) {
+function validateContextPublicUrls(context2) {
+  if (!context2?.data) {
     return null;
   }
-  for (const [field, value] of Object.entries(context.data)) {
-    const widget = widgetType(context.ui, field);
+  for (const [field, value] of Object.entries(context2.data)) {
+    const widget = widgetType(context2.ui, field);
     if (!widget) {
       continue;
     }
@@ -202,13 +202,15 @@ var triggerHandlerSchema = webhookHandlerSchema.extend({
   tokenId: z.string().min(1)
 });
 var handlerSchema = z.discriminatedUnion("type", [webhookHandlerSchema, triggerHandlerSchema]);
-var taskActionSchema = z.object({
+var taskActionInputSchema = z.object({
   id: z.string().min(1),
   title: z.string().min(1),
   description: z.string().optional(),
   schema: jsonSchema7Schema.optional(),
   ui: uiSchemaSchema.optional(),
-  data: z.record(z.string(), z.unknown()).optional(),
+  data: z.record(z.string(), z.unknown()).optional()
+});
+var taskActionSchema = taskActionInputSchema.extend({
   // Optional handlers for this action - if present, must have at least 1
   handlers: z.array(handlerSchema).min(1).optional()
 });
@@ -224,7 +226,8 @@ var contextDataSchema = z.object({
   data: z.record(z.string(), z.unknown()),
   ui: contextUiSchema
 }).optional();
-var taskContextObjectSchema = z.object({
+var TASK_CONTEXT_FORMAT_VERSION = 2;
+var taskContextObjectBaseSchema = z.object({
   /** Source application id; omitted tasks are grouped in the default inbox. */
   app: z.string().min(1).optional(),
   type: z.string().min(1),
@@ -232,9 +235,22 @@ var taskContextObjectSchema = z.object({
   description: z.string().optional(),
   validUntil: z.string().optional(),
   context: contextDataSchema,
+  /** Task context wire format version. @default 2 */
+  contextVersion: z.literal(2).optional(),
+  /** @deprecated Use `contextVersion`. Accepted on ingest only. */
   version: z.literal(2).optional(),
   actions: z.array(taskActionSchema).min(1, "At least one action is required")
 });
+function normalizeTaskContextVersion(data) {
+  const { version: legacyVersion, contextVersion, ...rest } = data;
+  return {
+    ...rest,
+    contextVersion: contextVersion ?? legacyVersion ?? TASK_CONTEXT_FORMAT_VERSION
+  };
+}
+var taskContextObjectSchema = taskContextObjectBaseSchema.transform(
+  normalizeTaskContextVersion
+);
 function refineContextPublicUrls(data, ctx) {
   const error = validateContextPublicUrls(data.context);
   if (error) {
@@ -278,61 +294,11 @@ var threadUpdateInputSchema = z.object({
 });
 var taskPriorities = ["low", "normal", "high", "urgent"];
 var taskPrioritySchema = z.enum(taskPriorities);
-var nonNegativeInt = z.number().int().nonnegative();
-var agentCostTokensSchema = z.object({
-  input: nonNegativeInt.optional(),
-  output: nonNegativeInt.optional(),
-  total: nonNegativeInt.optional()
-});
-var agentCostSchema = z.object({
-  tokens: agentCostTokensSchema.optional(),
-  eur: z.number().nonnegative().optional(),
-  usd: z.number().nonnegative().optional()
-});
-var AGENT_INFO_MAX_KEYS = 32;
-var AGENT_TOOL_CALLS_MAX_KEYS = 64;
-var AGENT_OTEL_SPANS_MAX = 32;
-var agentToolCallsSchema = z.record(z.string().min(1), nonNegativeInt);
-var agentOtelSpanStatusSchema = z.enum(["ok", "error"]);
-var agentOtelSpanSummarySchema = z.object({
-  name: z.string().min(1),
-  durationMs: z.number().nonnegative(),
-  status: agentOtelSpanStatusSchema
-});
-var agentOtelSchema = z.object({
-  traceId: z.string().min(1),
-  spanId: z.string().min(1).optional(),
-  rootDurationMs: z.number().nonnegative().optional(),
-  spans: z.array(agentOtelSpanSummarySchema).max(AGENT_OTEL_SPANS_MAX).optional()
-});
 var agentTelemetrySchema = z.object({
   /** Agent or app version (semver, git SHA, deploy tag — caller-defined). */
-  version: z.string().min(1).optional(),
-  /** Total tool invocations. When omitted but `toolCalls` is set, the sum of counts is used. */
-  toolCallCount: nonNegativeInt.optional(),
-  /** Per-tool invocation counts keyed by tool name. */
-  toolCalls: agentToolCallsSchema.optional(),
-  cost: agentCostSchema.optional(),
-  /** Free-form metadata for experiments (model, prompt variant, etc.). */
-  info: z.record(z.string(), z.unknown()).optional(),
-  /** Structured OpenTelemetry span snapshot for feedback analysis. */
-  otel: agentOtelSchema.optional()
-}).refine(
-  (data) => {
-    const keys = data.info ? Object.keys(data.info) : [];
-    return keys.length <= AGENT_INFO_MAX_KEYS;
-  },
-  { message: `agent.info may contain at most ${AGENT_INFO_MAX_KEYS} keys` }
-).refine(
-  (data) => {
-    const keys = data.toolCalls ? Object.keys(data.toolCalls) : [];
-    return keys.length <= AGENT_TOOL_CALLS_MAX_KEYS;
-  },
-  {
-    message: `agent.toolCalls may contain at most ${AGENT_TOOL_CALLS_MAX_KEYS} tool names`
-  }
-);
-var createTaskBodySchema = taskContextObjectSchema.extend({
+  version: z.string().min(1)
+});
+var createTaskBodySchema = taskContextObjectBaseSchema.extend({
   assignTo: assignToSchema.optional(),
   /**
    * Groups related tasks together. When omitted, the server generates one and
@@ -349,9 +315,59 @@ var createTaskBodySchema = taskContextObjectSchema.extend({
    * the inbox status bar and the thread update log.
    */
   update: threadUpdateInputSchema.optional(),
-  /** Agent telemetry (version, cost, tool calls) — not shown in inbox UI. */
+  /** Agent release version — not shown in inbox UI. */
   agent: agentTelemetrySchema.optional()
-}).superRefine(refineContextPublicUrls);
+}).transform(normalizeTaskContextVersion).superRefine(refineContextPublicUrls);
+var agentChatSeedActionSchema = z.object({
+  /** Stable action id echoed back on submit; auto-derived from title when omitted. */
+  id: z.string().min(1).optional(),
+  title: z.string().min(1),
+  description: z.string().optional(),
+  /** JSON Schema object for the form fields. */
+  schema: z.record(z.string(), z.unknown()).optional(),
+  /** RJSF ui schema overrides (ui:widget, ui:enumNames, etc.). */
+  ui: z.record(z.string(), z.unknown()).optional(),
+  /** Optional default field values. */
+  data: z.record(z.string(), z.unknown()).optional()
+});
+var agentChatSeedMessageSchema = z.object({
+  role: z.enum(["user", "assistant"]),
+  text: z.string().min(1),
+  /** Optional display-name override for the message sender. */
+  senderName: z.string().min(1).optional(),
+  /**
+   * Optional structured input request rendered as a styled RobotRock action
+   * widget below the message text. Use this instead of asking the user to reply
+   * in plain text so the request is always a proper action form.
+   */
+  requestActionInput: z.object({
+    prompt: z.string().optional(),
+    action: agentChatSeedActionSchema
+  }).optional()
+});
+var createAgentChatBodySchema = z.object({
+  /** Trigger chat agent id (task slug). Required unless `parentChatId` is set. */
+  agentIdentifier: z.string().min(1).optional(),
+  /** Inherit tenant/connection/agent from an existing chat (agent-spawned chats). */
+  parentChatId: z.string().min(1).optional(),
+  /** Convex tenantTriggerConnections id; resolved from the tenant when omitted. */
+  connectionId: z.string().min(1).optional(),
+  /** Source application id; groups the chat under an inbox section. */
+  app: z.string().min(1).optional(),
+  assignTo: assignToSchema.optional(),
+  title: z.string().min(1),
+  messages: z.array(agentChatSeedMessageSchema).default([]),
+  /** Provenance label stored on the session ("cron" | "agent" | ...). */
+  source: z.string().min(1).optional()
+}).refine((data) => Boolean(data.agentIdentifier || data.parentChatId), {
+  message: "Provide either agentIdentifier or parentChatId"
+});
+var agentChatTransportBodySchema = z.object({
+  chatId: z.string().min(1),
+  publicAccessToken: z.string().min(1),
+  lastEventId: z.string().optional(),
+  isStreaming: z.boolean().optional()
+});
 
 // src/schemas/index.ts
 var safeUrlSchema2 = z2.string().refine((url) => isPublicHttpUrl(url), {
@@ -374,13 +390,15 @@ var triggerHandlerSchema2 = webhookHandlerSchema2.extend({
   tokenId: z2.string().min(1)
 });
 var handlerSchema2 = z2.discriminatedUnion("type", [webhookHandlerSchema2, triggerHandlerSchema2]);
-var taskActionSchema2 = z2.object({
+var taskActionInputSchema2 = z2.object({
   id: z2.string().min(1),
   title: z2.string().min(1),
   description: z2.string().optional(),
   schema: jsonSchema7Schema2.optional(),
   ui: uiSchemaSchema2.optional(),
-  data: z2.record(z2.string(), z2.unknown()).optional(),
+  data: z2.record(z2.string(), z2.unknown()).optional()
+});
+var taskActionSchema2 = taskActionInputSchema2.extend({
   handlers: z2.array(handlerSchema2).min(1).optional()
 });
 var uiFieldSchemaSchema2 = z2.object({
@@ -395,16 +413,29 @@ var contextDataSchema2 = z2.object({
   data: z2.record(z2.string(), z2.unknown()),
   ui: contextUiSchema2
 }).optional();
-var taskContextObjectSchema2 = z2.object({
+var TASK_CONTEXT_FORMAT_VERSION2 = 2;
+var taskContextObjectBaseSchema2 = z2.object({
   app: z2.string().min(1).optional(),
   type: z2.string().min(1),
   name: z2.string().min(1),
   description: z2.string().optional(),
   validUntil: z2.string().optional(),
   context: contextDataSchema2,
+  contextVersion: z2.literal(2).optional(),
+  /** @deprecated Use `contextVersion`. Accepted on ingest only. */
   version: z2.literal(2).optional(),
   actions: z2.array(taskActionSchema2).min(1, "At least one action is required")
 });
+function normalizeTaskContextVersion2(data) {
+  const { version: legacyVersion, contextVersion, ...rest } = data;
+  return {
+    ...rest,
+    contextVersion: contextVersion ?? legacyVersion ?? TASK_CONTEXT_FORMAT_VERSION2
+  };
+}
+var taskContextObjectSchema2 = taskContextObjectBaseSchema2.transform(
+  normalizeTaskContextVersion2
+);
 function refineContextPublicUrls2(data, ctx) {
   const error = validateContextPublicUrls(data.context);
   if (error) {
@@ -457,56 +488,10 @@ var TASK_PRIORITY_RANK = {
   high: 3,
   urgent: 4
 };
-var nonNegativeInt2 = z2.number().int().nonnegative();
-var agentCostTokensSchema2 = z2.object({
-  input: nonNegativeInt2.optional(),
-  output: nonNegativeInt2.optional(),
-  total: nonNegativeInt2.optional()
-});
-var agentCostSchema2 = z2.object({
-  tokens: agentCostTokensSchema2.optional(),
-  eur: z2.number().nonnegative().optional(),
-  usd: z2.number().nonnegative().optional()
-});
-var AGENT_INFO_MAX_KEYS2 = 32;
-var AGENT_TOOL_CALLS_MAX_KEYS2 = 64;
-var AGENT_OTEL_SPANS_MAX2 = 32;
-var agentToolCallsSchema2 = z2.record(z2.string().min(1), nonNegativeInt2);
-var agentOtelSpanStatusSchema2 = z2.enum(["ok", "error"]);
-var agentOtelSpanSummarySchema2 = z2.object({
-  name: z2.string().min(1),
-  durationMs: z2.number().nonnegative(),
-  status: agentOtelSpanStatusSchema2
-});
-var agentOtelSchema2 = z2.object({
-  traceId: z2.string().min(1),
-  spanId: z2.string().min(1).optional(),
-  rootDurationMs: z2.number().nonnegative().optional(),
-  spans: z2.array(agentOtelSpanSummarySchema2).max(AGENT_OTEL_SPANS_MAX2).optional()
-});
 var agentTelemetrySchema2 = z2.object({
-  version: z2.string().min(1).optional(),
-  toolCallCount: nonNegativeInt2.optional(),
-  toolCalls: agentToolCallsSchema2.optional(),
-  cost: agentCostSchema2.optional(),
-  info: z2.record(z2.string(), z2.unknown()).optional(),
-  otel: agentOtelSchema2.optional()
-}).refine(
-  (data) => {
-    const keys = data.info ? Object.keys(data.info) : [];
-    return keys.length <= AGENT_INFO_MAX_KEYS2;
-  },
-  { message: `agent.info may contain at most ${AGENT_INFO_MAX_KEYS2} keys` }
-).refine(
-  (data) => {
-    const keys = data.toolCalls ? Object.keys(data.toolCalls) : [];
-    return keys.length <= AGENT_TOOL_CALLS_MAX_KEYS2;
-  },
-  {
-    message: `agent.toolCalls may contain at most ${AGENT_TOOL_CALLS_MAX_KEYS2} tool names`
-  }
-);
-var createTaskBodySchema2 = taskContextObjectSchema2.extend({
+  version: z2.string().min(1)
+});
+var createTaskBodySchema2 = taskContextObjectBaseSchema2.extend({
   assignTo: assignToSchema2.optional(),
   /**
    * Groups related tasks together. When omitted, the server generates one and
@@ -524,7 +509,7 @@ var createTaskBodySchema2 = taskContextObjectSchema2.extend({
    */
   update: threadUpdateInputSchema2.optional(),
   agent: agentTelemetrySchema2.optional()
-}).superRefine(refineContextPublicUrls2);
+}).transform(normalizeTaskContextVersion2).superRefine(refineContextPublicUrls2);
 var threadUpdateBodySchema = threadUpdateInputSchema2;
 
 // src/approval-result.ts
@@ -554,12 +539,159 @@ function toDiscriminatedApprovalResult(actions, task) {
   };
 }
 
+// src/http.ts
+var RobotRockError = class extends Error {
+  constructor(message, statusCode, response) {
+    super(message);
+    this.statusCode = statusCode;
+    this.response = response;
+    this.name = "RobotRockError";
+  }
+};
+async function parseResponseBody(response) {
+  const contentType = response.headers.get("content-type") ?? "";
+  const bodyText = await response.text();
+  if (!bodyText) {
+    return null;
+  }
+  if (contentType.toLowerCase().includes("application/json")) {
+    try {
+      return JSON.parse(bodyText);
+    } catch {
+    }
+  }
+  try {
+    return JSON.parse(bodyText);
+  } catch {
+    return bodyText;
+  }
+}
+function getErrorMessage(data, fallback) {
+  if (data && typeof data === "object" && !Array.isArray(data)) {
+    const maybeMessage = data.message;
+    if (typeof maybeMessage === "string" && maybeMessage.trim()) {
+      return maybeMessage;
+    }
+  }
+  if (typeof data === "string" && data.trim()) {
+    const compact = data.replace(/\s+/g, " ").trim();
+    const snippet = compact.length > 180 ? `${compact.slice(0, 180)}...` : compact;
+    return `${fallback}. Server returned non-JSON response: ${snippet}`;
+  }
+  return fallback;
+}
+
+// ../core/src/handler-retry.ts
+var HANDLER_RETRY_DELAYS_MS = [
+  6e4,
+  // 1m
+  3e5,
+  // 5m
+  18e5,
+  // 30m
+  36e5,
+  // 1h
+  216e5,
+  // 6h
+  864e5,
+  // 24h
+  1728e5
+  // 48h
+];
+var HANDLER_MAX_ATTEMPTS = HANDLER_RETRY_DELAYS_MS.length + 1;
+
+// ../core/src/attribution/index.ts
+import { z as z3 } from "zod";
+
+// ../core/src/app-url.ts
+var PRODUCTION_APP_URL = "https://app.robotrock.io";
+var APP_SIGNUP_URL = `${PRODUCTION_APP_URL}/sign-up`;
+
+// ../core/src/attribution/index.ts
+var ATTRIBUTION_COOKIE_MAX_AGE = 60 * 60 * 24 * 90;
+var attributionSchema = z3.object({
+  utmSource: z3.string().optional(),
+  utmMedium: z3.string().optional(),
+  utmCampaign: z3.string().optional(),
+  utmContent: z3.string().optional(),
+  utmTerm: z3.string().optional(),
+  gclid: z3.string().optional(),
+  landingUrl: z3.string().optional(),
+  referrer: z3.string().optional(),
+  capturedAt: z3.number()
+});
+
+// src/chats.ts
+function createChatsApi(config) {
+  const headers = () => ({
+    "Content-Type": "application/json",
+    "X-Api-Key": config.apiKey
+  });
+  return {
+    async create(input) {
+      const bodyPayload = {
+        ...input,
+        app: input.app ?? config.app,
+        messages: input.messages ?? []
+      };
+      const validation = createAgentChatBodySchema.safeParse(bodyPayload);
+      if (!validation.success) {
+        throw new RobotRockError(
+          `Invalid chat: ${validation.error.issues[0]?.message}`,
+          400,
+          validation.error.issues
+        );
+      }
+      const response = await fetch(`${config.baseUrl}/agent-chats`, {
+        method: "POST",
+        headers: headers(),
+        body: JSON.stringify(validation.data)
+      });
+      const data = await parseResponseBody(response);
+      if (!response.ok) {
+        throw new RobotRockError(
+          getErrorMessage(data, "Failed to create chat"),
+          response.status,
+          data
+        );
+      }
+      const result = data;
+      return { tenantSlug: result.tenantSlug, chats: result.chats };
+    },
+    async close(chatId, options) {
+      if (!chatId) {
+        throw new RobotRockError("chatId is required to close a chat", 400);
+      }
+      const response = await fetch(
+        `${config.baseUrl}/agent-chats/${encodeURIComponent(chatId)}/close`,
+        {
+          method: "POST",
+          headers: headers(),
+          body: JSON.stringify({ reason: options?.reason })
+        }
+      );
+      if (!response.ok) {
+        const data = await parseResponseBody(response);
+        throw new RobotRockError(
+          getErrorMessage(data, "Failed to close chat"),
+          response.status,
+          data
+        );
+      }
+    }
+  };
+}
+
 // src/client.ts
 var DEFAULT_POLL_INTERVAL_MS = 2e3;
 var DEFAULT_TIMEOUT_MS = 24 * 60 * 60 * 1e3;
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function resolveAgentVersionFromEnv() {
+  const fromEnv = process.env.AGENT_VERSION?.trim() || process.env.ROBOTROCK_AGENT_VERSION?.trim();
+  return fromEnv || void 0;
+}
 function parseValidUntilMs(value) {
   if (value === void 0) {
     return void 0;
@@ -587,21 +719,18 @@ function serializeValidUntil(value) {
   }
   throw new RobotRockError("Invalid validUntil: expected a Date or parseable date string", 400);
 }
-var RobotRockError = class extends Error {
-  constructor(message, statusCode, response) {
-    super(message);
-    this.statusCode = statusCode;
-    this.response = response;
-    this.name = "RobotRockError";
-  }
-};
 var RobotRock = class {
   apiKey;
   baseUrl;
   app;
-  version;
+  agentVersion;
+  contextVersion;
   webhook;
   polling;
+  /** Task CRUD: `create`, `get`, `cancel`, `sendUpdate`. */
+  tasks;
+  /** Chat CRUD: `create`, `close`. */
+  chats;
   constructor(config) {
     if (config.webhook && config.polling) {
       throw new Error(
@@ -618,26 +747,37 @@ var RobotRock = class {
     const rawBase = config.baseUrl ?? "https://api.robotrock.io/v1";
     this.baseUrl = rawBase.replace(/\/+$/, "");
     this.app = config.app;
-    this.version = config.version ?? 2;
+    this.agentVersion = config.version ?? resolveAgentVersionFromEnv();
+    this.contextVersion = config.advanced?.contextVersion ?? TASK_CONTEXT_FORMAT_VERSION2;
     this.webhook = config.webhook;
     this.polling = config.polling ?? {};
+    this.tasks = {
+      create: (task) => this.createTaskRequest(task),
+      get: (taskId) => this.getTaskById(taskId),
+      cancel: (taskId) => this.cancelTaskRequest(taskId),
+      sendUpdate: (input) => this.sendThreadUpdate(input)
+    };
+    this.chats = createChatsApi({
+      baseUrl: this.baseUrl,
+      apiKey: this.apiKey,
+      app: this.app
+    });
   }
-  /**
-   * Create a task via POST /v1 without waiting for a human response.
-   */
-  async createTask(task) {
+  async createTaskRequest(task) {
     const normalizedTask = normalizeSendToHumanInput(task, {
       webhook: this.webhook,
       app: this.app,
-      version: this.version
+      contextVersion: this.contextVersion,
+      agentVersion: this.agentVersion
     });
+    const agentVersion = task.version ?? this.agentVersion;
     const bodyPayload = {
       ...normalizedTask,
       ...task.assignTo !== void 0 ? { assignTo: task.assignTo } : {},
       ...task.threadId !== void 0 ? { threadId: task.threadId } : {},
       ...task.priority !== void 0 ? { priority: task.priority } : {},
       ...task.update !== void 0 ? { update: task.update } : {},
-      ...task.agent !== void 0 ? { agent: task.agent } : {}
+      ...agentVersion !== void 0 ? { agent: { version: agentVersion } } : {}
     };
     const validation = createTaskBodySchema2.safeParse(bodyPayload);
     if (!validation.success) {
@@ -673,9 +813,10 @@ var RobotRock = class {
     const normalizedTask = normalizeSendToHumanInput(task, {
       webhook: this.webhook,
       app: this.app,
-      version: this.version
+      contextVersion: this.contextVersion,
+      agentVersion: this.agentVersion
     });
-    const createdTaskTask = await this.createTask(task);
+    const createdTaskTask = await this.createTaskRequest(task);
     const hasHandlers = normalizedTask.actions.some(
       (action) => Array.isArray(action.handlers) && action.handlers.length > 0
     );
@@ -692,7 +833,7 @@ var RobotRock = class {
     const deadline = validUntilMs !== void 0 ? Math.min(pollingDeadline, validUntilMs) : pollingDeadline;
     const taskId = createdTaskTask.taskId;
     while (Date.now() < deadline) {
-      const existing = await this.getTask(taskId);
+      const existing = await this.getTaskById(taskId);
       if (existing?.status === "handled" && existing.handled) {
         return {
           mode: "handled",
@@ -714,10 +855,35 @@ var RobotRock = class {
     }
     throw new TaskTimeoutError(`No human response within ${timeoutMs}ms`);
   }
+  /**
+   * Create a task via POST /v1 without waiting for a human response.
+   * @deprecated Use `client.tasks.create()` instead.
+   */
+  async createTask(task) {
+    return this.tasks.create(task);
+  }
   /**
    * Get a task by public task id (returned as `task.taskId` from {@link sendToHuman}).
+   * @deprecated Use `client.tasks.get()` instead.
    */
   async getTask(taskId) {
+    return this.tasks.get(taskId);
+  }
+  /**
+   * Log a status update against a thread.
+   * @deprecated Use `client.tasks.sendUpdate()` instead.
+   */
+  async sendUpdate(input) {
+    return this.tasks.sendUpdate(input);
+  }
+  /**
+   * Cancel a task by public task id.
+   * @deprecated Use `client.tasks.cancel()` instead.
+   */
+  async cancelTask(taskId) {
+    return this.tasks.cancel(taskId);
+  }
+  async getTaskById(taskId) {
     const response = await fetch(`${this.baseUrl}/tasks/${taskId}`, {
       method: "GET",
       headers: {
@@ -737,11 +903,11 @@ var RobotRock = class {
     }
     return data;
   }
-  /**
-   * Log a status update against a thread. The update shows in the inbox status
-   * bar and thread update log for every task in the thread.
-   */
-  async sendUpdate({ threadId, message, status }) {
+  async sendThreadUpdate({
+    threadId,
+    message,
+    status
+  }) {
     if (!threadId) {
       throw new RobotRockError("threadId is required to send an update", 400);
     }
@@ -774,7 +940,7 @@ var RobotRock = class {
     }
     return data.update;
   }
-  async cancelTask(taskId) {
+  async cancelTaskRequest(taskId) {
     const response = await fetch(`${this.baseUrl}/tasks/${taskId}/cancel`, {
       method: "POST",
       headers: {
@@ -817,6 +983,7 @@ function normalizeSendToHumanInput(task, clientDefaults) {
     threadId: _threadId,
     priority: _priority,
     update: _update,
+    version: _version,
     validUntil,
     app: taskApp,
     ...rest
@@ -826,44 +993,12 @@ function normalizeSendToHumanInput(task, clientDefaults) {
   const app = taskApp ?? clientDefaults.app;
   return {
     ...rest,
-    version: clientDefaults.version,
+    contextVersion: clientDefaults.contextVersion,
     ...app ? { app } : {},
     ...validUntil !== void 0 ? { validUntil: serializeValidUntil(validUntil) } : {},
     actions: normalizedActions
   };
 }
-async function parseResponseBody(response) {
-  const contentType = response.headers.get("content-type") ?? "";
-  const bodyText = await response.text();
-  if (!bodyText) {
-    return null;
-  }
-  if (contentType.toLowerCase().includes("application/json")) {
-    try {
-      return JSON.parse(bodyText);
-    } catch {
-    }
-  }
-  try {
-    return JSON.parse(bodyText);
-  } catch {
-    return bodyText;
-  }
-}
-function getErrorMessage(data, fallback) {
-  if (data && typeof data === "object" && !Array.isArray(data)) {
-    const maybeMessage = data.message;
-    if (typeof maybeMessage === "string" && maybeMessage.trim()) {
-      return maybeMessage;
-    }
-  }
-  if (typeof data === "string" && data.trim()) {
-    const compact = data.replace(/\s+/g, " ").trim();
-    const snippet = compact.length > 180 ? `${compact.slice(0, 180)}...` : compact;
-    return `${fallback}. Server returned non-JSON response: ${snippet}`;
-  }
-  return fallback;
-}
 
 // src/env.ts
 var DEFAULT_BASE_URL = "https://api.robotrock.io/v1";
@@ -978,21 +1113,18 @@ function shouldStopAgentForHandledAction(actionId) {
 
 // src/webhook.ts
 import { createHmac, timingSafeEqual } from "crypto";
-import { z as z3 } from "zod";
+import { z as z4 } from "zod";
 var ROBOTROCK_SIGNATURE_HEADER = "x-robotrock-signature";
-var robotRockWebhookPayloadBodySchema = z3.object({
-  taskId: z3.string().min(1),
-  action: z3.object({
-    id: z3.string().min(1),
-    title: z3.string().min(1),
-    data: z3.unknown()
+var robotRockWebhookPayloadBodySchema = z4.object({
+  taskId: z4.string().min(1),
+  action: z4.object({
+    id: z4.string().min(1),
+    title: z4.string().min(1),
+    data: z4.unknown()
   }),
-  handledBy: z3.string().min(1).optional(),
-  handledAt: z3.string().min(1),
-  handlerType: z3.string().min(1)
-});
-var robotRockWebhookPayloadSchema = robotRockWebhookPayloadBodySchema.extend({
-  headers: z3.record(z3.string(), z3.string())
+  handledBy: z4.string().min(1).optional(),
+  handledAt: z4.string().min(1),
+  handlerType: z4.string().min(1)
 });
 var RobotRockWebhookError = class extends Error {
   constructor(message, code, details) {
@@ -1082,14 +1214,18 @@ function normalizeHeaders(headers) {
   return result;
 }
 
-// src/agent-telemetry-from-otel.ts
-import { trace } from "@opentelemetry/api";
-var AGENT_INFO_MAX_KEYS3 = 32;
-function sumToolCalls(toolCalls) {
-  return Object.values(toolCalls).reduce((sum, count) => sum + count, 0);
-}
+// src/record-handled-to-otel.ts
+import {
+  context,
+  trace,
+  SpanStatusCode
+} from "@opentelemetry/api";
+var TRACER_NAME = "robotrock";
+var WAIT_SPAN_NAME = "robotrock.wait_for_human";
+var HANDLED_EVENT_NAME = "robotrock.task_handled";
+var INVALID_TRACE_ID = "00000000000000000000000000000000";
 function isValidTraceId(traceId) {
-  return typeof traceId === "string" && traceId.length > 0 && traceId !== "00000000000000000000000000000000";
+  return typeof traceId === "string" && traceId.length > 0 && traceId !== INVALID_TRACE_ID;
 }
 function resolveSpanContext(span) {
   const active = span ?? trace.getActiveSpan();
@@ -1099,98 +1235,179 @@ function resolveSpanContext(span) {
   }
   return { traceId: ctx.traceId, spanId: ctx.spanId };
 }
-function countErrorSpans(spans) {
-  if (!spans) return 0;
-  return spans.filter((entry) => entry.status === "error").length;
-}
-function buildInfo(options, spanCtx) {
-  const info = { ...options.extraInfo };
-  if (spanCtx) {
-    info.traceId = spanCtx.traceId;
-    info.spanId = spanCtx.spanId;
-  }
-  if (options.runStartedAt != null) {
-    const durationMs = Date.now() - options.runStartedAt;
-    if (durationMs >= 0) {
-      info.durationMs = durationMs;
+function parseTaskCreatedAt(submittedAt) {
+  if (submittedAt) {
+    const parsed = Date.parse(submittedAt);
+    if (!Number.isNaN(parsed)) {
+      return parsed;
     }
   }
-  const errorCount = countErrorSpans(options.otel?.spans);
-  if (errorCount > 0) {
-    info.errorCount = errorCount;
+  return Date.now();
+}
+function parseHandledAtMs(handledAt) {
+  if (handledAt instanceof Date) {
+    return handledAt.getTime();
   }
-  const keys = Object.keys(info);
-  if (keys.length === 0) {
-    return void 0;
+  if (typeof handledAt === "number") {
+    return handledAt;
   }
-  if (keys.length > AGENT_INFO_MAX_KEYS3) {
-    const trimmed = {};
-    for (const key of keys.slice(0, AGENT_INFO_MAX_KEYS3)) {
-      trimmed[key] = info[key];
-    }
-    return trimmed;
+  const parsed = Date.parse(handledAt);
+  return Number.isNaN(parsed) ? Date.now() : parsed;
+}
+function toRobotRockHandledOtelInput(handled) {
+  if ("actionId" in handled) {
+    return {
+      taskId: handled.taskId,
+      action: {
+        id: handled.actionId,
+        data: handled.data
+      },
+      handledBy: handled.handledBy,
+      handledAt: handled.handledAt
+    };
   }
-  return info;
+  return {
+    taskId: handled.taskId,
+    action: {
+      id: handled.action.id,
+      title: handled.action.title,
+      data: handled.action.data
+    },
+    handledBy: handled.handledBy,
+    handledAt: handled.handledAt
+  };
 }
-function buildOtelBlock(options, spanCtx) {
-  const traceId = options.otel?.traceId ?? spanCtx?.traceId;
-  if (!isValidTraceId(traceId)) {
+function captureRobotRockOtelHandle(task, options) {
+  const spanCtx = resolveSpanContext(options?.span);
+  return {
+    traceId: spanCtx?.traceId ?? "",
+    spanId: spanCtx?.spanId ?? "",
+    taskId: task.taskId,
+    threadId: task.threadId,
+    taskCreatedAt: parseTaskCreatedAt(task.submittedAt)
+  };
+}
+function startRobotRockHumanWaitSpan(handle, options) {
+  const parent = options?.span ?? trace.getActiveSpan();
+  if (!parent) {
     return void 0;
   }
-  const spans = options.otel?.spans;
-  const rootDurationMs = options.otel?.rootDurationMs ?? (options.runStartedAt != null ? Math.max(0, Date.now() - options.runStartedAt) : void 0);
-  const block = { traceId };
-  const spanId = options.otel?.spanId ?? spanCtx?.spanId;
-  if (spanId) {
-    block.spanId = spanId;
+  const tracer = trace.getTracer(options?.tracerName ?? TRACER_NAME);
+  const span = tracer.startSpan(
+    WAIT_SPAN_NAME,
+    {},
+    trace.setSpan(context.active(), parent)
+  );
+  span.setAttribute("robotrock.task_id", handle.taskId);
+  if (handle.threadId) {
+    span.setAttribute("robotrock.thread_id", handle.threadId);
+  }
+  return span;
+}
+function recordRobotRockHandledToOtel(handled, options = {}) {
+  const span = options.span ?? trace.getActiveSpan();
+  if (!span) {
+    return;
+  }
+  const input = toRobotRockHandledOtelInput(handled);
+  const handledAtMs = parseHandledAtMs(input.handledAt);
+  const handle = options.handle;
+  const humanWaitMs = handle != null ? Math.max(0, handledAtMs - handle.taskCreatedAt) : void 0;
+  span.setAttribute("robotrock.task_id", input.taskId);
+  span.setAttribute("robotrock.action.id", input.action.id);
+  if (input.action.title) {
+    span.setAttribute("robotrock.action.title", input.action.title);
+  }
+  if (input.handledBy) {
+    span.setAttribute("robotrock.handled_by", input.handledBy);
   }
-  if (rootDurationMs != null) {
-    block.rootDurationMs = rootDurationMs;
+  span.setAttribute("robotrock.handled_at", new Date(handledAtMs).toISOString());
+  if (humanWaitMs != null) {
+    span.setAttribute("robotrock.human_wait_ms", humanWaitMs);
   }
-  if (spans && spans.length > 0) {
-    block.spans = spans;
+  if (input.threadId) {
+    span.setAttribute("robotrock.thread_id", input.threadId);
   }
-  return block;
+  const eventAttributes = {
+    "robotrock.task_id": input.taskId,
+    "robotrock.action.id": input.action.id
+  };
+  if (input.handledBy) {
+    eventAttributes["robotrock.handled_by"] = input.handledBy;
+  }
+  if (humanWaitMs != null) {
+    eventAttributes["robotrock.human_wait_ms"] = humanWaitMs;
+  }
+  if (options.includeActionData && input.action.data != null) {
+    const serialized = JSON.stringify(input.action.data);
+    const truncated = serialized.length > 512 ? `${serialized.slice(0, 512)}\u2026` : serialized;
+    span.setAttribute("robotrock.action.data", truncated);
+    eventAttributes["robotrock.action.data"] = truncated;
+  }
+  span.addEvent(HANDLED_EVENT_NAME, eventAttributes);
 }
-function agentTelemetryFromOtel(options = {}) {
-  const spanCtx = resolveSpanContext(options.span);
-  const telemetry = {};
-  if (options.version) {
-    telemetry.version = options.version;
-  }
-  if (options.toolCalls && Object.keys(options.toolCalls).length > 0) {
-    telemetry.toolCalls = options.toolCalls;
-  }
-  if (options.toolCallCount !== void 0) {
-    telemetry.toolCallCount = options.toolCallCount;
-  } else if (telemetry.toolCalls) {
-    const sum = sumToolCalls(telemetry.toolCalls);
-    if (sum > 0) {
-      telemetry.toolCallCount = sum;
-    }
+function endRobotRockHumanWaitSpan(span, handled, options = {}) {
+  if (!span) {
+    return;
   }
-  if (options.cost) {
-    telemetry.cost = options.cost;
+  const outcome = options.outcome ?? (handled ? "handled" : "timeout");
+  if (handled && outcome === "handled") {
+    recordRobotRockHandledToOtel(handled, {
+      span,
+      handle: options.handle,
+      includeActionData: options.includeActionData
+    });
+    span.setStatus({ code: SpanStatusCode.OK });
+  } else {
+    span.setAttribute("robotrock.outcome", outcome);
+    span.setStatus({
+      code: SpanStatusCode.ERROR,
+      message: outcome === "timeout" ? "Human response timed out before validUntil" : "Human wait failed"
+    });
   }
-  const info = buildInfo(options, spanCtx);
-  if (info) {
-    telemetry.info = info;
+  span.end();
+}
+
+// src/otel-platform.ts
+function shouldRecordRobotRockOtel(recordOtel) {
+  if (recordOtel === true) {
+    return true;
   }
-  const otel = buildOtelBlock(options, spanCtx);
-  if (otel) {
-    telemetry.otel = otel;
+  if (recordOtel === false) {
+    return false;
   }
-  return agentTelemetrySchema2.parse(telemetry);
+  const env = process.env.ROBOTROCK_OTEL_RECORD_HANDLED;
+  return env === "true" || env === "1";
+}
+function stripPlatformOtelFields(payload) {
+  const { recordOtel: _recordOtel, otelIncludeActionData: _otelIncludeActionData, ...rest } = payload;
+  return rest;
 }
-function toolCallsFromOtelSpans(spans) {
-  const counts = {};
-  for (const span of spans) {
-    counts[span.name] = (counts[span.name] ?? 0) + 1;
+function beginRobotRockHumanWaitOtel(task, options = {}) {
+  const recordOtel = shouldRecordRobotRockOtel(options.recordOtel);
+  if (!recordOtel) {
+    return { recordOtel: false };
   }
-  return counts;
+  const handle = captureRobotRockOtelHandle(task);
+  const waitSpan = startRobotRockHumanWaitSpan(handle);
+  return {
+    recordOtel: true,
+    handle,
+    waitSpan,
+    includeActionData: options.otelIncludeActionData
+  };
+}
+function finishRobotRockHumanWaitOtel(session, handled, outcome) {
+  if (!session.recordOtel) {
+    return;
+  }
+  endRobotRockHumanWaitSpan(session.waitSpan, handled, {
+    handle: session.handle,
+    outcome,
+    includeActionData: session.includeActionData
+  });
 }
 export {
-  AGENT_OTEL_SPANS_MAX2 as AGENT_OTEL_SPANS_MAX,
   DEFAULT_TASK_PRIORITY,
   DEFAULT_THREAD_UPDATE_STATUS,
   LOWEST_TASK_PRIORITY,
@@ -1203,30 +1420,35 @@ export {
   RobotRock,
   RobotRockError,
   RobotRockWebhookError,
+  TASK_CONTEXT_FORMAT_VERSION2 as TASK_CONTEXT_FORMAT_VERSION,
   TASK_PRIORITY_RANK,
   TaskExpiredError,
   TaskTimeoutError,
-  agentCostSchema2 as agentCostSchema,
-  agentCostTokensSchema2 as agentCostTokensSchema,
-  agentOtelSchema2 as agentOtelSchema,
-  agentOtelSpanStatusSchema2 as agentOtelSpanStatusSchema,
-  agentOtelSpanSummarySchema2 as agentOtelSpanSummarySchema,
-  agentTelemetryFromOtel,
+  agentChatSeedMessageSchema,
   agentTelemetrySchema2 as agentTelemetrySchema,
-  agentToolCallsSchema2 as agentToolCallsSchema,
   assertNotPlatformRejectRequest,
   assignToSchema2 as assignToSchema,
   attachWebhookToActions,
+  beginRobotRockHumanWaitOtel,
+  captureRobotRockOtelHandle,
+  createAgentChatBodySchema,
+  createChatsApi,
   createClient,
   createTaskBodySchema2 as createTaskBodySchema,
+  endRobotRockHumanWaitSpan,
+  finishRobotRockHumanWaitOtel,
   isPlatformMarkDoneAction,
   isPlatformRejectRequestAction,
   isPlatformTerminalAction,
   parseHandledOutcome,
   parsePlatformRejectRequestData,
+  recordRobotRockHandledToOtel,
   resolveRobotRockClient,
   resolveRobotRockConfig,
+  shouldRecordRobotRockOtel,
   shouldStopAgentForHandledAction,
+  startRobotRockHumanWaitSpan,
+  stripPlatformOtelFields,
   taskContextSchema2 as taskContextSchema,
   taskPriorities2 as taskPriorities,
   taskPrioritySchema2 as taskPrioritySchema,
@@ -1235,7 +1457,7 @@ export {
   threadUpdateStatusSchema2 as threadUpdateStatusSchema,
   threadUpdateStatuses2 as threadUpdateStatuses,
   toDiscriminatedApprovalResult,
-  toolCallsFromOtelSpans,
+  toRobotRockHandledOtelInput,
   verifyRobotRockWebhook
 };
 //# sourceMappingURL=index.js.map