robotrock 0.8.3 → 0.8.5

package/README.md

@@ -186,6 +186,9 @@ await robotrock.cancelTask("task_...");
 import {
   verifyRobotRockWebhook,
   RobotRockWebhookError,
+  isPlatformTerminalAction,
+  isPlatformRejectRequestAction,
+  parsePlatformRejectRequestData,
   type RobotRockWebhookPayload,
 } from "robotrock";
 
@@ -193,6 +196,19 @@ export async function POST(request: Request) {
   try {
     const payload: RobotRockWebhookPayload = await verifyRobotRockWebhook(request);
     console.log(payload.action.id, payload.headers["x-request-id"]);
+
+    // Always stop the agent for inbox platform actions (not your task's approve/reject ids)
+    if (isPlatformRejectRequestAction(payload.action.id)) {
+      const { feedback } = parsePlatformRejectRequestData(payload.action.data) ?? {
+        feedback: "",
+      };
+      // log and abort — do not continue the workflow
+      return Response.json({ ok: true, stopped: true, feedback });
+    }
+    if (isPlatformTerminalAction(payload.action.id)) {
+      return Response.json({ ok: true, stopped: true });
+    }
+
     return Response.json({ ok: true });
   } catch (error) {
     if (error instanceof RobotRockWebhookError) {
@@ -203,6 +219,46 @@ export async function POST(request: Request) {
 }
 ```
 
+## Platform terminal actions
+
+Reviewers can close a task from the inbox **without** choosing one of your defined actions. These reserved `action.id` values arrive on webhooks, polling, and `getTask()` — **always stop your agent** when you see them:
+
+| Constant | Action ID | Meaning |
+|----------|-----------|---------|
+| `PLATFORM_MARK_DONE_ACTION_ID` | `robotrock:mark-done` | Closed manually; `data` is `{}` |
+| `PLATFORM_REJECT_REQUEST_ACTION_ID` | `robotrock:reject-request` | Bad request; `data.feedback` is required |
+
+```typescript
+import {
+  isPlatformTerminalAction,
+  parseHandledOutcome,
+  assertNotPlatformRejectRequest,
+  shouldStopAgentForHandledAction,
+} from "robotrock";
+
+const result = await robotrock.sendToHuman({ ... });
+
+if (result.mode === "handled") {
+  assertNotPlatformRejectRequest(result.actionId, result.data); // throws PlatformRejectRequestError
+
+  if (shouldStopAgentForHandledAction(result.actionId)) {
+    return; // mark-done or reject-request — do not continue
+  }
+
+  const outcome = parseHandledOutcome({
+    actionId: result.actionId,
+    data: result.data,
+    handledBy: result.handledBy,
+    handledAt: result.handledAt,
+  });
+  if (outcome.source === "platform") {
+    return;
+  }
+}
+```
+
+See [Platform actions](https://docs.robotrock.io/webhooks#platform-action-ids) in the docs.
+
 ## Trigger.dev
 
 Install `@trigger.dev/sdk`, re-export SDK tasks from your `trigger/` directory, and call them with `triggerAndWait()`:

package/dist/ai/index.js

@@ -294,7 +294,7 @@ function refineContextPublicUrls(data, ctx) {
     });
   }
 }
-var safeUrlSchema, jsonSchema7Schema, uiSchemaSchema, webhookHandlerSchema, triggerHandlerSchema, handlerSchema, taskActionSchema, uiFieldSchemaSchema, contextUiSchema, contextDataSchema, taskContextObjectSchema, taskContextSchema, assignToSchema, threadUpdateMessageSchema, threadUpdateStatuses, threadUpdateStatusSchema, threadUpdateInputSchema, taskPriorities, taskPrioritySchema, nonNegativeInt, agentCostTokensSchema, agentCostSchema, AGENT_INFO_MAX_KEYS, AGENT_TOOL_CALLS_MAX_KEYS, agentToolCallsSchema, agentTelemetrySchema, createTaskBodySchema;
+var safeUrlSchema, jsonSchema7Schema, uiSchemaSchema, webhookHandlerSchema, triggerHandlerSchema, handlerSchema, taskActionSchema, uiFieldSchemaSchema, contextUiSchema, contextDataSchema, taskContextObjectSchema, taskContextSchema, assignToSchema, threadUpdateMessageSchema, threadUpdateStatuses, threadUpdateStatusSchema, threadUpdateInputSchema, taskPriorities, taskPrioritySchema, nonNegativeInt, agentCostTokensSchema, agentCostSchema, AGENT_INFO_MAX_KEYS, AGENT_TOOL_CALLS_MAX_KEYS, AGENT_OTEL_SPANS_MAX, agentToolCallsSchema, agentOtelSpanStatusSchema, agentOtelSpanSummarySchema, agentOtelSchema, agentTelemetrySchema, createTaskBodySchema;
 var init_task = __esm({
   "../core/src/schemas/task.ts"() {
     "use strict";
@@ -399,7 +399,20 @@ var init_task = __esm({
     });
     AGENT_INFO_MAX_KEYS = 32;
     AGENT_TOOL_CALLS_MAX_KEYS = 64;
+    AGENT_OTEL_SPANS_MAX = 32;
     agentToolCallsSchema = z.record(z.string().min(1), nonNegativeInt);
+    agentOtelSpanStatusSchema = z.enum(["ok", "error"]);
+    agentOtelSpanSummarySchema = z.object({
+      name: z.string().min(1),
+      durationMs: z.number().nonnegative(),
+      status: agentOtelSpanStatusSchema
+    });
+    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()
+    });
     agentTelemetrySchema = z.object({
       /** Agent or app version (semver, git SHA, deploy tag — caller-defined). */
       version: z.string().min(1).optional(),
@@ -409,7 +422,9 @@ var init_task = __esm({
       toolCalls: agentToolCallsSchema.optional(),
       cost: agentCostSchema.optional(),
       /** Free-form metadata for experiments (model, prompt variant, etc.). */
-      info: z.record(z.string(), z.unknown()).optional()
+      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) : [];
@@ -477,7 +492,7 @@ function refineContextPublicUrls2(data, ctx) {
     });
   }
 }
-var safeUrlSchema2, jsonSchema7Schema2, uiSchemaSchema2, webhookHandlerSchema2, triggerHandlerSchema2, handlerSchema2, taskActionSchema2, uiFieldSchemaSchema2, contextUiSchema2, contextDataSchema2, taskContextObjectSchema2, taskContextSchema2, assignToSchema2, threadUpdateMessageSchema2, threadUpdateStatuses2, threadUpdateStatusSchema2, threadUpdateInputSchema2, taskPriorities2, taskPrioritySchema2, nonNegativeInt2, agentCostTokensSchema2, agentCostSchema2, AGENT_INFO_MAX_KEYS2, AGENT_TOOL_CALLS_MAX_KEYS2, agentToolCallsSchema2, agentTelemetrySchema2, createTaskBodySchema2, threadUpdateBodySchema;
+var safeUrlSchema2, jsonSchema7Schema2, uiSchemaSchema2, webhookHandlerSchema2, triggerHandlerSchema2, handlerSchema2, taskActionSchema2, uiFieldSchemaSchema2, contextUiSchema2, contextDataSchema2, taskContextObjectSchema2, taskContextSchema2, assignToSchema2, threadUpdateMessageSchema2, threadUpdateStatuses2, threadUpdateStatusSchema2, threadUpdateInputSchema2, taskPriorities2, taskPrioritySchema2, nonNegativeInt2, agentCostTokensSchema2, agentCostSchema2, AGENT_INFO_MAX_KEYS2, AGENT_TOOL_CALLS_MAX_KEYS2, AGENT_OTEL_SPANS_MAX2, agentToolCallsSchema2, agentOtelSpanStatusSchema2, agentOtelSpanSummarySchema2, agentOtelSchema2, agentTelemetrySchema2, createTaskBodySchema2, threadUpdateBodySchema;
 var init_schemas2 = __esm({
   "src/schemas/index.ts"() {
     "use strict";
@@ -580,13 +595,27 @@ var init_schemas2 = __esm({
     });
     AGENT_INFO_MAX_KEYS2 = 32;
     AGENT_TOOL_CALLS_MAX_KEYS2 = 64;
+    AGENT_OTEL_SPANS_MAX2 = 32;
     agentToolCallsSchema2 = z2.record(z2.string().min(1), nonNegativeInt2);
+    agentOtelSpanStatusSchema2 = z2.enum(["ok", "error"]);
+    agentOtelSpanSummarySchema2 = z2.object({
+      name: z2.string().min(1),
+      durationMs: z2.number().nonnegative(),
+      status: agentOtelSpanStatusSchema2
+    });
+    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()
+    });
     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()
+      info: z2.record(z2.string(), z2.unknown()).optional(),
+      otel: agentOtelSchema2.optional()
     }).refine(
       (data) => {
         const keys = data.info ? Object.keys(data.info) : [];