robotrock 0.8.4 → 0.9.0

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.d.ts

@@ -1,7 +1,7 @@
-export { C as CreateRobotRockAiToolsOptions, R as RobotRockAiTools, a as approveByHumanTool, c as createRobotRockAiTools, b as createSendToHumanTool, d as createSendUpdateTool } from '../trigger-CsOLTjsH.js';
-import { p as RobotRockToolCallInfo, F as FormatToolApprovalTaskOptions, H as HumanToolResult } from '../tool-approval-bridge-BKDY5NAY.js';
-export { q as APPROVE_BY_HUMAN_ACTIONS, A as ApproveByHumanToolDurableOptions, a as ApproveByHumanToolOptions, e as CreateSendToHumanToolDurableOptions, C as CreateSendToHumanToolOptions, f as CreateSendUpdateToolDurableOptions, c as CreateSendUpdateToolOptions, s as ResolveToolApprovalsOptions, g as RobotRockAiContext, h as RobotRockAiMode, i as RobotRockAiPollingContext, j as RobotRockAiTriggerContext, R as RobotRockAiWorkflowContext, t as RobotRockToolApprovalConfig, u as RobotRockToolApprovalDecision, v as RunWithRobotRockApprovalsOptions, w as SendUpdateToolResult, T as ToolApprovalRequestPart, k as applyRobotRockToolApprovalToTools, x as approveByHumanForAi, y as approveByHumanInputSchema, z as collectApprovalRequests, B as createRobotRockAiTriggerContext, l as createRobotRockAiWorkflowContext, m as createRobotRockNeedsApproval, n as createRobotRockToolApproval, D as normalizeRobotRockAiContext, r as resolveToolApprovalsViaRobotRock, o as runWithRobotRockApprovals, E as sendToHumanForAi, G as sendToHumanToolInputSchema, I as sendUpdateForAi, J as sendUpdateToolInputSchema } from '../tool-approval-bridge-BKDY5NAY.js';
-import { a as SendToHumanInput } from '../client-D-XEBOWd.js';
+export { C as CreateRobotRockAiToolsOptions, R as RobotRockAiTools, a as approveByHumanTool, c as createRobotRockAiTools, b as createSendToHumanTool, d as createSendUpdateTool } from '../trigger-D0shjqk0.js';
+import { p as RobotRockToolCallInfo, F as FormatToolApprovalTaskOptions, H as HumanToolResult } from '../tool-approval-bridge-G765kMJR.js';
+export { q as APPROVE_BY_HUMAN_ACTIONS, A as ApproveByHumanToolDurableOptions, a as ApproveByHumanToolOptions, e as CreateSendToHumanToolDurableOptions, C as CreateSendToHumanToolOptions, f as CreateSendUpdateToolDurableOptions, c as CreateSendUpdateToolOptions, s as ResolveToolApprovalsOptions, g as RobotRockAiContext, h as RobotRockAiMode, i as RobotRockAiPollingContext, j as RobotRockAiTriggerContext, R as RobotRockAiWorkflowContext, t as RobotRockToolApprovalConfig, u as RobotRockToolApprovalDecision, v as RunWithRobotRockApprovalsOptions, w as SendUpdateToolResult, T as ToolApprovalRequestPart, k as applyRobotRockToolApprovalToTools, x as approveByHumanForAi, y as approveByHumanInputSchema, z as collectApprovalRequests, B as createRobotRockAiTriggerContext, l as createRobotRockAiWorkflowContext, m as createRobotRockNeedsApproval, n as createRobotRockToolApproval, D as normalizeRobotRockAiContext, r as resolveToolApprovalsViaRobotRock, o as runWithRobotRockApprovals, E as sendToHumanForAi, G as sendToHumanToolInputSchema, I as sendUpdateForAi, J as sendUpdateToolInputSchema } from '../tool-approval-bridge-G765kMJR.js';
+import { a as SendToHumanInput } from '../client-Cy7YLxms.js';
 import { DiscriminatedApprovalResult } from '../schemas/index.js';
 import 'ai';
 import 'zod';