robotrock 0.4.0 → 0.6.0

package/README.md

@@ -158,6 +158,21 @@ await robotrock.sendToHuman({
 
 `status` is optional and one of: `info` | `queued` | `running` | `waiting` | `succeeded` | `failed` | `cancelled`. The `update` field is top-level (like `threadId` and `assignTo`), not inside `context`.
 
+Updates are fire-and-forget, so the integration packages expose them too:
+
+```typescript
+// Vercel Workflow: durable step, returns immediately (no suspend)
+import { sendUpdateInWorkflow } from "robotrock/workflow";
+await sendUpdateInWorkflow({ threadId, message: "Build started.", status: "running" });
+
+// Vercel AI SDK: let an agent report progress on its thread
+import { createSendUpdateTool } from "robotrock/ai";
+const sendUpdate = createSendUpdateTool(robotrock, { threadId });
+
+// Trigger.dev: no wrapper needed — call the SDK directly inside a task
+await robotrock.sendUpdate({ threadId, message: "Job running.", status: "running" });
+```
+
 ## Other client methods
 
 ```typescript
@@ -248,7 +263,7 @@ const result = await generateText({
 });
 ```
 
-For AI SDK tool execution approval (approve `deleteFile` before it runs), use `createRobotRockToolApproval`, `resolveToolApprovalsViaRobotRock`, and `runWithRobotRockApprovals` from `robotrock/ai`. See the [Vercel AI integration docs](https://github.com/robotrock/robotrock/blob/main/apps/docs/content/docs/integrations/vercel-ai.mdx) in this repo.
+For AI SDK tool execution approval (approve `deleteFile` before it runs), use `createRobotRockToolApproval`, `resolveToolApprovalsViaRobotRock`, and `runWithRobotRockApprovals` from `robotrock/ai`. See the [Vercel AI integration docs](https://docs.robotrock.io/integrations/vercel-ai).
 
 Run long polls inside Trigger.dev or a worker — not short serverless HTTP handlers.
 
@@ -258,7 +273,7 @@ Run long polls inside Trigger.dev or a worker — not short serverless HTTP hand
 |--------|-------------|
 | `robotrock` | `createClient`, `RobotRock`, env helpers, types, schemas |
 | `robotrock/trigger` | `sendToHumanTask`, `approveByHumanTask` for Trigger.dev |
-| `robotrock/workflow` | `sendToHumanInWorkflow`, `approveByHumanInWorkflow` for Vercel Workflow |
+| `robotrock/workflow` | `sendToHumanInWorkflow`, `approveByHumanInWorkflow`, `sendUpdateInWorkflow` for Vercel Workflow |
 | `robotrock/ai` | Vercel AI SDK tools and `toolApproval` bridge (peer: `ai`) |
 | `robotrock/ai/trigger` | Same API, documented for `mode: "trigger"` in Trigger.dev workers |
 | `robotrock/ai/workflow` | Same API, documented for `mode: "workflow"` in Vercel Workflow |

package/dist/ai/index.d.ts

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

package/dist/ai/index.js

@@ -12,15 +12,19 @@ import {
   createRobotRockNeedsApproval,
   createRobotRockToolApproval,
   createSendToHumanTool,
+  createSendUpdateTool,
   defaultFormatToolApprovalTask,
   normalizeRobotRockAiContext,
   resolveToolApprovalsViaRobotRock,
   runWithRobotRockApprovals,
   sendToHumanForAi,
   sendToHumanToolInputSchema,
+  sendUpdateForAi,
+  sendUpdateToolInputSchema,
   toHumanToolResult
-} from "../chunk-RW2CQQZU.js";
-import "../chunk-2KFY7ZJV.js";
+} from "../chunk-7VBBX2HA.js";
+import "../chunk-ZCMXX7IG.js";
+import "../chunk-TAWMIQAM.js";
 export {
   APPROVE_BY_HUMAN_ACTIONS,
   DEFAULT_APPROVE_ACTIONS,
@@ -35,12 +39,15 @@ export {
   createRobotRockNeedsApproval,
   createRobotRockToolApproval,
   createSendToHumanTool,
+  createSendUpdateTool,
   defaultFormatToolApprovalTask,
   normalizeRobotRockAiContext,
   resolveToolApprovalsViaRobotRock,
   runWithRobotRockApprovals,
   sendToHumanForAi,
   sendToHumanToolInputSchema,
+  sendUpdateForAi,
+  sendUpdateToolInputSchema,
   toHumanToolResult
 };
 //# sourceMappingURL=index.js.map

package/dist/ai/trigger.d.ts

@@ -1,5 +1,5 @@
-export { i as RobotRockAiContext, j as RobotRockAiMode, k as RobotRockAiPollingContext, l as RobotRockAiTriggerContext, t as applyRobotRockToolApprovalToTools, a as approveByHumanTool, o as createRobotRockAiTools, p as createRobotRockAiTriggerContext, v as createRobotRockNeedsApproval, w as createRobotRockToolApproval, e as createSendToHumanTool, x as resolveToolApprovalsViaRobotRock, y as runWithRobotRockApprovals } from '../workflow-iDk0Hlyg.js';
+export { o as RobotRockAiContext, p as RobotRockAiMode, q as RobotRockAiPollingContext, r as RobotRockAiTriggerContext, y as applyRobotRockToolApprovalToTools, a as approveByHumanTool, u as createRobotRockAiTools, v as createRobotRockAiTriggerContext, B as createRobotRockNeedsApproval, D as createRobotRockToolApproval, e as createSendToHumanTool, g as createSendUpdateTool, E as resolveToolApprovalsViaRobotRock, G as runWithRobotRockApprovals } from '../workflow-CFcRMNhy.js';
 import 'ai';
 import 'zod';
-import '../client-BOm2Ce2f.js';
+import '../client-CLcHdjOz.js';
 import '../schemas/index.js';

package/dist/ai/trigger.js

@@ -6,10 +6,12 @@ import {
   createRobotRockNeedsApproval,
   createRobotRockToolApproval,
   createSendToHumanTool,
+  createSendUpdateTool,
   resolveToolApprovalsViaRobotRock,
   runWithRobotRockApprovals
-} from "../chunk-RW2CQQZU.js";
-import "../chunk-2KFY7ZJV.js";
+} from "../chunk-7VBBX2HA.js";
+import "../chunk-ZCMXX7IG.js";
+import "../chunk-TAWMIQAM.js";
 export {
   applyRobotRockToolApprovalToTools,
   approveByHumanTool,
@@ -18,6 +20,7 @@ export {
   createRobotRockNeedsApproval,
   createRobotRockToolApproval,
   createSendToHumanTool,
+  createSendUpdateTool,
   resolveToolApprovalsViaRobotRock,
   runWithRobotRockApprovals
 };

package/dist/ai/workflow.d.ts

@@ -1,5 +1,5 @@
-export { i as RobotRockAiContext, j as RobotRockAiMode, k as RobotRockAiPollingContext, l as RobotRockAiTriggerContext, m as RobotRockAiWorkflowContext, t as applyRobotRockToolApprovalToTools, a as approveByHumanTool, o as createRobotRockAiTools, q as createRobotRockAiWorkflowContext, v as createRobotRockNeedsApproval, w as createRobotRockToolApproval, e as createSendToHumanTool, x as resolveToolApprovalsViaRobotRock, y as runWithRobotRockApprovals } from '../workflow-iDk0Hlyg.js';
+export { o as RobotRockAiContext, p as RobotRockAiMode, q as RobotRockAiPollingContext, r as RobotRockAiTriggerContext, t as RobotRockAiWorkflowContext, y as applyRobotRockToolApprovalToTools, a as approveByHumanTool, u as createRobotRockAiTools, w as createRobotRockAiWorkflowContext, B as createRobotRockNeedsApproval, D as createRobotRockToolApproval, e as createSendToHumanTool, g as createSendUpdateTool, E as resolveToolApprovalsViaRobotRock, G as runWithRobotRockApprovals } from '../workflow-CFcRMNhy.js';
 import 'ai';
 import 'zod';
-import '../client-BOm2Ce2f.js';
+import '../client-CLcHdjOz.js';
 import '../schemas/index.js';

package/dist/ai/workflow.js

@@ -6,10 +6,12 @@ import {
   createRobotRockNeedsApproval,
   createRobotRockToolApproval,
   createSendToHumanTool,
+  createSendUpdateTool,
   resolveToolApprovalsViaRobotRock,
   runWithRobotRockApprovals
-} from "../chunk-RW2CQQZU.js";
-import "../chunk-2KFY7ZJV.js";
+} from "../chunk-7VBBX2HA.js";
+import "../chunk-ZCMXX7IG.js";
+import "../chunk-TAWMIQAM.js";
 export {
   applyRobotRockToolApprovalToTools,
   approveByHumanTool,
@@ -18,6 +20,7 @@ export {
   createRobotRockNeedsApproval,
   createRobotRockToolApproval,
   createSendToHumanTool,
+  createSendUpdateTool,
   resolveToolApprovalsViaRobotRock,
   runWithRobotRockApprovals
 };

package/dist/{chunk-RW2CQQZU.js → chunk-7VBBX2HA.js}

@@ -1,6 +1,12 @@
 import {
-  assignToSchema
-} from "./chunk-2KFY7ZJV.js";
+  RobotRockError,
+  createClient,
+  resolveRobotRockConfig
+} from "./chunk-ZCMXX7IG.js";
+import {
+  assignToSchema,
+  threadUpdateStatusSchema
+} from "./chunk-TAWMIQAM.js";
 
 // src/ai/context.ts
 var APPROVE_BY_HUMAN_ACTIONS = [
@@ -59,6 +65,22 @@ async function sendToHumanForAi(context, payload) {
     taskId: result.taskId
   };
 }
+async function sendUpdateForAi(context, payload) {
+  if (context.mode === "workflow") {
+    const { sendUpdateInWorkflow } = await import("./workflow/index.js");
+    return sendUpdateInWorkflow({
+      ...payload,
+      ...context.app ? { app: context.app } : {}
+    });
+  }
+  if (context.mode === "trigger") {
+    const client = createClient(
+      resolveRobotRockConfig(context.app ? { app: context.app } : void 0)
+    );
+    return client.sendUpdate(payload);
+  }
+  return context.client.sendUpdate(payload);
+}
 async function approveByHumanForAi(context, payload) {
   if (context.mode === "trigger") {
     const { approveByHumanTask } = await import("./trigger/index.js");
@@ -201,7 +223,8 @@ function createSendToHumanTool(clientOrOptions, maybeOptions) {
         context: taskContext,
         validUntil: input.validUntil,
         assignTo: input.assignTo,
-        actions: options.actions
+        actions: options.actions,
+        ...options.threadId ? { threadId: options.threadId } : {}
       };
       const result = await sendToHumanForAi(aiContext, payload);
       return toHumanToolResult(result);
@@ -209,6 +232,60 @@ function createSendToHumanTool(clientOrOptions, maybeOptions) {
   });
 }
 
+// src/ai/create-send-update-tool.ts
+import { tool as tool3 } from "ai";
+import { z as z3 } from "zod";
+var sendUpdateToolInputSchema = z3.object({
+  threadId: z3.string().optional().describe(
+    "Thread to post the update to. Use the `threadId` returned by a prior send-to-human task. Omit only when a session threadId is configured on the tool."
+  ),
+  message: z3.string().describe("Short progress update (1-2 sentences) shown in the inbox status bar"),
+  status: threadUpdateStatusSchema.optional().describe(
+    "Lifecycle status driving the status-bar icon/color: info, queued, running, waiting, succeeded, failed, cancelled"
+  )
+});
+function createSendUpdateTool(clientOrOptions, maybeOptions = {}) {
+  const isDurable = typeof clientOrOptions === "object" && clientOrOptions !== null && "mode" in clientOrOptions && (clientOrOptions.mode === "trigger" || clientOrOptions.mode === "workflow");
+  const aiContext = normalizeRobotRockAiContext(
+    isDurable ? {
+      mode: clientOrOptions.mode,
+      app: clientOrOptions.app
+    } : clientOrOptions
+  );
+  const options = isDurable ? clientOrOptions : maybeOptions;
+  const description = options.description ?? "Post a short progress update to the RobotRock thread you are working on. Use to report status changes (running, succeeded, failed) so humans can follow along in the inbox.";
+  return tool3({
+    description,
+    inputSchema: sendUpdateToolInputSchema,
+    execute: async (input) => {
+      const threadId = input.threadId ?? options.threadId;
+      if (!threadId) {
+        throw new Error(
+          "createSendUpdateTool: no threadId. Pass `threadId` from a prior send-to-human result, or configure a session `threadId` in the tool options."
+        );
+      }
+      try {
+        const update = await sendUpdateForAi(aiContext, {
+          threadId,
+          message: input.message,
+          status: input.status
+        });
+        return { posted: true, threadId, update };
+      } catch (error) {
+        if (error instanceof RobotRockError && error.statusCode === 404) {
+          return {
+            posted: false,
+            threadId,
+            reason: "thread_not_found",
+            message: `No task exists for thread "${threadId}" yet, so the update was not posted. Create a task on this thread with send-to-human before reporting progress.`
+          };
+        }
+        throw error;
+      }
+    }
+  });
+}
+
 // src/ai/create-ai-tools.ts
 function createRobotRockAiTools(options) {
   const mode = options.mode ?? (options.client ? "polling" : "trigger");
@@ -221,7 +298,22 @@ function createRobotRockAiTools(options) {
   return {
     context,
     approveByHuman: (toolOptions) => durableContext ? approveByHumanTool({ ...durableContext, ...toolOptions }) : approveByHumanTool(pollingClient, toolOptions),
-    sendToHuman: (toolOptions) => durableContext ? createSendToHumanTool({ ...durableContext, ...toolOptions }) : createSendToHumanTool(pollingClient, toolOptions)
+    sendToHuman: (toolOptions) => durableContext ? createSendToHumanTool({
+      ...durableContext,
+      ...options.threadId ? { threadId: options.threadId } : {},
+      ...toolOptions
+    }) : createSendToHumanTool(pollingClient, {
+      ...options.threadId ? { threadId: options.threadId } : {},
+      ...toolOptions
+    }),
+    sendUpdate: (toolOptions = {}) => durableContext ? createSendUpdateTool({
+      ...durableContext,
+      ...options.threadId ? { threadId: options.threadId } : {},
+      ...toolOptions
+    }) : createSendUpdateTool(pollingClient, {
+      ...options.threadId ? { threadId: options.threadId } : {},
+      ...toolOptions
+    })
   };
 }
 function createRobotRockAiTriggerContext(options = {}) {
@@ -496,6 +588,7 @@ async function runWithRobotRockApprovals(options) {
 export {
   normalizeRobotRockAiContext,
   sendToHumanForAi,
+  sendUpdateForAi,
   approveByHumanForAi,
   toHumanToolResult,
   APPROVE_BY_HUMAN_ACTIONS2 as APPROVE_BY_HUMAN_ACTIONS,
@@ -503,6 +596,8 @@ export {
   approveByHumanTool,
   sendToHumanToolInputSchema,
   createSendToHumanTool,
+  sendUpdateToolInputSchema,
+  createSendUpdateTool,
   createRobotRockAiTools,
   createRobotRockAiTriggerContext,
   createRobotRockAiWorkflowContext,
@@ -515,4 +610,4 @@ export {
   resolveToolApprovalsViaRobotRock,
   runWithRobotRockApprovals
 };
-//# sourceMappingURL=chunk-RW2CQQZU.js.map
+//# sourceMappingURL=chunk-7VBBX2HA.js.map

package/dist/chunk-7VBBX2HA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ai/context.ts","../src/ai/human-tool-result.ts","../src/ai/approve-by-human-tool.ts","../src/ai/create-send-to-human-tool.ts","../src/ai/create-send-update-tool.ts","../src/ai/create-ai-tools.ts","../src/ai/format-tool-approval-task.ts","../src/ai/tool-approval-bridge.ts"],"sourcesContent":["import {\n  createClient,\n  type RobotRock,\n  type SendToHumanActionInput,\n  type SendToHumanInput,\n  type SendUpdateInput,\n} from \"../client.js\";\nimport { resolveRobotRockConfig } from \"../env.js\";\nimport type { DiscriminatedApprovalResult, ThreadUpdate } from \"../schemas/index.js\";\nconst APPROVE_BY_HUMAN_ACTIONS = [\n  { id: \"approve\", title: \"Approve\" },\n  { id: \"decline\", title: \"Decline\" },\n] as const;\n\n/** How RobotRock waits for a human inside AI SDK tool `execute`. */\nexport type RobotRockAiMode = \"polling\" | \"trigger\" | \"workflow\";\n\n/**\n * Polling: `client.sendToHuman()` blocks until handled (scripts, API routes with long timeout).\n * Trigger: `sendToHumanTask.triggerAndWait()` uses wait tokens (Trigger.dev workers).\n * Workflow: `sendToHumanInWorkflow()` uses workflow webhooks (Vercel Workflow).\n */\nexport type RobotRockAiPollingContext = {\n  mode?: \"polling\";\n  client: RobotRock;\n};\n\nexport type RobotRockAiTriggerContext = {\n  mode: \"trigger\";\n  /** Inbox app bucket; falls back to `ROBOTROCK_APP` in the Trigger worker. */\n  app?: string;\n};\n\nexport type RobotRockAiWorkflowContext = {\n  mode: \"workflow\";\n  /** Inbox app bucket; falls back to `ROBOTROCK_APP` in the workflow run. */\n  app?: string;\n};\n\nexport type RobotRockAiContext =\n  | RobotRockAiPollingContext\n  | RobotRockAiTriggerContext\n  | RobotRockAiWorkflowContext;\n\nexport function isRobotRockClient(value: unknown): value is RobotRock {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"sendToHuman\" in value &&\n    typeof (value as RobotRock).sendToHuman === \"function\"\n  );\n}\n\nexport function normalizeRobotRockAiContext(\n  clientOrContext: RobotRock | RobotRockAiContext\n): RobotRockAiContext {\n  if (isRobotRockClient(clientOrContext)) {\n    return { mode: \"polling\", client: clientOrContext };\n  }\n\n  if (clientOrContext.mode === \"trigger\" || clientOrContext.mode === \"workflow\") {\n    return clientOrContext;\n  }\n\n  if (clientOrContext.mode === \"polling\" || clientOrContext.mode === undefined) {\n    if (!(\"client\" in clientOrContext) || !clientOrContext.client) {\n      throw new Error('RobotRock AI polling mode requires `client` on the context object.');\n    }\n    return { mode: \"polling\", client: clientOrContext.client };\n  }\n\n  throw new Error(`Unknown RobotRock AI mode: ${String((clientOrContext as { mode?: string }).mode)}`);\n}\n\nexport async function sendToHumanForAi<\n  A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[],\n>(\n  context: RobotRockAiContext,\n  payload: SendToHumanInput<A>\n): Promise<DiscriminatedApprovalResult<A>> {\n  if (context.mode === \"trigger\") {\n    const { sendToHumanTask } = await import(\"../trigger/index.js\");\n    const waitResult = await sendToHumanTask.triggerAndWait({\n      ...payload,\n      ...(context.app ? { app: context.app } : {}),\n    });\n\n    if (!waitResult.ok) {\n      throw waitResult.error;\n    }\n\n    return waitResult.output as DiscriminatedApprovalResult<A>;\n  }\n\n  if (context.mode === \"workflow\") {\n    const { sendToHumanInWorkflow } = await import(\"../workflow/index.js\");\n    const result = await sendToHumanInWorkflow({\n      ...payload,\n      ...(context.app ? { app: context.app } : {}),\n    });\n    return result as unknown as DiscriminatedApprovalResult<A>;\n  }\n\n  const result = await context.client.sendToHuman(payload);\n\n  if (result.mode !== \"handled\") {\n    throw new Error(\n      \"RobotRock task was created but not handled. Configure client polling or webhook, or use mode: 'trigger' / 'workflow' for durable waits.\"\n    );\n  }\n\n  return {\n    actionId: result.actionId,\n    data: result.data,\n    handledBy: result.handledBy,\n    handledAt: result.handledAt,\n    taskId: result.taskId,\n  } as DiscriminatedApprovalResult<A>;\n}\n\n/**\n * Posts a thread update for an AI tool, routing by execution mode.\n *\n * `sendUpdate` is fire-and-forget (no human wait), so only the workflow path\n * needs durability — it runs inside a `\"use step\"`. Trigger and polling modes\n * issue the request directly.\n */\nexport async function sendUpdateForAi(\n  context: RobotRockAiContext,\n  payload: SendUpdateInput\n): Promise<ThreadUpdate> {\n  if (context.mode === \"workflow\") {\n    const { sendUpdateInWorkflow } = await import(\"../workflow/index.js\");\n    return sendUpdateInWorkflow({\n      ...payload,\n      ...(context.app ? { app: context.app } : {}),\n    });\n  }\n\n  if (context.mode === \"trigger\") {\n    const client = createClient(\n      resolveRobotRockConfig(context.app ? { app: context.app } : undefined)\n    );\n    return client.sendUpdate(payload);\n  }\n\n  return context.client.sendUpdate(payload);\n}\n\nexport async function approveByHumanForAi(\n  context: RobotRockAiContext,\n  payload: Omit<SendToHumanInput, \"actions\"> & { app?: string }\n): Promise<DiscriminatedApprovalResult<typeof APPROVE_BY_HUMAN_ACTIONS>> {\n  if (context.mode === \"trigger\") {\n    const { approveByHumanTask } = await import(\"../trigger/index.js\");\n    const waitResult = await approveByHumanTask.triggerAndWait({\n      ...payload,\n      ...(context.app ? { app: context.app } : {}),\n    });\n\n    if (!waitResult.ok) {\n      throw waitResult.error;\n    }\n\n    return waitResult.output;\n  }\n\n  if (context.mode === \"workflow\") {\n    const { approveByHumanInWorkflow } = await import(\"../workflow/index.js\");\n    return await approveByHumanInWorkflow({\n      ...payload,\n      ...(context.app ? { app: context.app } : {}),\n    });\n  }\n\n  const result = await context.client.sendToHuman({\n    ...payload,\n    actions: APPROVE_BY_HUMAN_ACTIONS,\n  });\n\n  if (result.mode !== \"handled\") {\n    throw new Error(\n      \"RobotRock approval was not handled. Configure client polling or use mode: 'trigger' / 'workflow' for durable waits.\"\n    );\n  }\n\n  return {\n    actionId: result.actionId,\n    data: result.data,\n    handledBy: result.handledBy,\n    handledAt: result.handledAt,\n    taskId: result.taskId,\n  } as DiscriminatedApprovalResult<typeof APPROVE_BY_HUMAN_ACTIONS>;\n}\n","import type { DiscriminatedApprovalResult } from \"../schemas/index.js\";\nimport type { HumanToolResult } from \"./types.js\";\n\nconst APPROVE_IDS = new Set([\"approve\", \"approved\"]);\nconst DECLINE_IDS = new Set([\"decline\", \"reject\", \"deny\", \"denied\"]);\n\nexport function toHumanToolResult(\n  result: DiscriminatedApprovalResult<readonly { id: string }[]>\n): HumanToolResult {\n  const payload: HumanToolResult = {\n    taskId: result.taskId,\n    actionId: result.actionId,\n    data: result.data,\n    handledBy: result.handledBy,\n    handledAt: result.handledAt.toISOString(),\n  };\n\n  if (APPROVE_IDS.has(result.actionId)) {\n    payload.approved = true;\n  } else if (DECLINE_IDS.has(result.actionId)) {\n    payload.approved = false;\n  }\n\n  return payload;\n}\n","import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport type { RobotRock } from \"../client.js\";\nimport { approveByHumanForAi, normalizeRobotRockAiContext, type RobotRockAiContext } from \"./context.js\";\nimport { toHumanToolResult } from \"./human-tool-result.js\";\nimport type { HumanToolResult } from \"./types.js\";\n\nconst APPROVE_BY_HUMAN_ACTIONS = [\n  { id: \"approve\", title: \"Approve\" },\n  { id: \"decline\", title: \"Decline\" },\n] as const;\n\nconst approveByHumanInputSchema = z.object({\n  type: z\n    .string()\n    .optional()\n    .describe(\"Task type slug; defaults to ai-approval\"),\n  name: z.string().describe(\"Short title for the approval request\"),\n  description: z\n    .string()\n    .describe(\"What needs approval and the consequences of approving or declining\"),\n  contextSummary: z\n    .string()\n    .optional()\n    .describe(\"Optional markdown summary shown to the reviewer\"),\n});\n\nexport type ApproveByHumanToolOptions = {\n  defaultType?: string;\n  description?: string;\n  toolName?: string;\n};\n\nexport type ApproveByHumanToolDurableOptions = ApproveByHumanToolOptions &\n  RobotRockAiContext & { mode: \"trigger\" | \"workflow\" };\n\n/**\n * AI SDK tool with fixed approve/decline actions; blocks until a human decides.\n *\n * - `approveByHumanTool(robotrock)` — polling via `client.sendToHuman()` (default).\n * - `approveByHumanTool({ mode: \"trigger\", app?: \"my-agent\" })` — durable wait via Trigger.dev.\n * - `approveByHumanTool({ mode: \"workflow\", app?: \"my-agent\" })` — durable wait via Vercel Workflow.\n */\nexport function approveByHumanTool(\n  clientOrContext: RobotRock | ApproveByHumanToolDurableOptions,\n  maybeOptions: ApproveByHumanToolOptions = {}\n) {\n  const isDurable =\n    typeof clientOrContext === \"object\" &&\n    clientOrContext !== null &&\n    \"mode\" in clientOrContext &&\n    (clientOrContext.mode === \"trigger\" || clientOrContext.mode === \"workflow\");\n\n  const aiContext = normalizeRobotRockAiContext(\n    isDurable\n      ? {\n          mode: (clientOrContext as ApproveByHumanToolDurableOptions).mode,\n          app: (clientOrContext as ApproveByHumanToolDurableOptions).app,\n        }\n      : (clientOrContext as RobotRock)\n  );\n  const options = isDurable\n    ? (clientOrContext as ApproveByHumanToolDurableOptions)\n    : maybeOptions;\n  const description =\n    options.description ??\n    \"Request explicit human approval before a sensitive or irreversible step. Returns whether the human approved or declined.\";\n\n  return tool({\n    description,\n    inputSchema: approveByHumanInputSchema,\n    execute: async (input: z.infer<typeof approveByHumanInputSchema>): Promise<HumanToolResult> => {\n      const taskContext =\n        input.contextSummary !== undefined\n          ? {\n              data: { summary: input.contextSummary },\n              ui: {\n                summary: { \"ui:widget\": \"textarea\", \"ui:options\": { rows: 6 } },\n              },\n            }\n          : undefined;\n\n      const result = await approveByHumanForAi(aiContext, {\n        type: input.type ?? options.defaultType ?? \"ai-approval\",\n        name: input.name,\n        description: input.description,\n        context: taskContext,\n      });\n\n      return toHumanToolResult(result);\n    },\n  });\n}\n\nexport { APPROVE_BY_HUMAN_ACTIONS, approveByHumanInputSchema };\n","import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport { assignToSchema } from \"../schemas/index.js\";\nimport type { RobotRock, SendToHumanActionInput, SendToHumanInput } from \"../client.js\";\nimport type { TaskContextInput } from \"../schemas/index.js\";\nimport {\n  normalizeRobotRockAiContext,\n  sendToHumanForAi,\n  type RobotRockAiContext,\n} from \"./context.js\";\nimport { toHumanToolResult } from \"./human-tool-result.js\";\nimport type { HumanToolResult } from \"./types.js\";\n\nconst contextInputSchema = z\n  .object({\n    data: z.record(z.unknown()).optional(),\n    ui: z.record(z.unknown()).optional(),\n  })\n  .optional();\n\nconst sendToHumanToolInputSchema = z.object({\n  type: z.string().describe(\"Task type slug shown in the RobotRock inbox\"),\n  name: z.string().describe(\"Short title for the human reviewer\"),\n  description: z\n    .string()\n    .optional()\n    .describe(\"What you need from the human and why you cannot proceed alone\"),\n  context: contextInputSchema.describe(\"Optional structured context for the inbox UI\"),\n  validUntil: z\n    .string()\n    .datetime()\n    .optional()\n    .describe(\"Optional ISO deadline for the task\"),\n  assignTo: assignToSchema\n    .optional()\n    .describe(\n      \"Assign to tenant member emails and/or group slugs; narrows who sees the task in the inbox\"\n    ),\n});\n\nexport type CreateSendToHumanToolOptions<\n  A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[],\n> = {\n  actions: A;\n  defaultType?: string;\n  description?: string;\n  toolName?: string;\n  /**\n   * Group every task this tool creates onto a shared thread. Pass the same\n   * value to {@link createSendUpdateTool} so updates land on the same thread.\n   */\n  threadId?: string;\n};\n\nexport type CreateSendToHumanToolDurableOptions<\n  A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[],\n> = CreateSendToHumanToolOptions<A> & RobotRockAiContext & { mode: \"trigger\" | \"workflow\" };\n\n/**\n * AI SDK tool that blocks until a human handles a RobotRock task with developer-defined actions.\n *\n * - `createSendToHumanTool(robotrock, options)` — polling (default).\n * - `createSendToHumanTool({ mode: \"trigger\", actions: [...], app?: \"my-agent\" })` — Trigger.dev wait tokens.\n * - `createSendToHumanTool({ mode: \"workflow\", actions: [...], app?: \"my-agent\" })` — Vercel Workflow webhooks.\n */\nexport function createSendToHumanTool<\n  A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[],\n>(\n  clientOrOptions: RobotRock | CreateSendToHumanToolDurableOptions<A>,\n  maybeOptions?: CreateSendToHumanToolOptions<A>\n) {\n  const isDurable =\n    typeof clientOrOptions === \"object\" &&\n    clientOrOptions !== null &&\n    \"mode\" in clientOrOptions &&\n    (clientOrOptions.mode === \"trigger\" || clientOrOptions.mode === \"workflow\");\n\n  const aiContext = normalizeRobotRockAiContext(\n    isDurable\n      ? {\n          mode: (clientOrOptions as CreateSendToHumanToolDurableOptions<A>).mode,\n          app: (clientOrOptions as CreateSendToHumanToolDurableOptions<A>).app,\n        }\n      : (clientOrOptions as RobotRock)\n  );\n  const options = (isDurable ? clientOrOptions : maybeOptions!) as CreateSendToHumanToolOptions<A>;\n  const description =\n    options.description ??\n    \"Request structured input or a decision from a human in the RobotRock inbox. Use when you lack required information, need policy approval, or must confirm an irreversible step.\";\n\n  return tool({\n    description,\n    inputSchema: sendToHumanToolInputSchema,\n    execute: async (\n      input: z.infer<typeof sendToHumanToolInputSchema>\n    ): Promise<HumanToolResult> => {\n      const taskContext: TaskContextInput[\"context\"] | undefined = input.context\n        ? ({\n            data: input.context.data ?? {},\n            ui: input.context.ui,\n          } as TaskContextInput[\"context\"])\n        : undefined;\n\n      const payload: SendToHumanInput<A> = {\n        type: input.type ?? options.defaultType ?? \"ai-human-input\",\n        name: input.name,\n        description: input.description,\n        context: taskContext,\n        validUntil: input.validUntil,\n        assignTo: input.assignTo,\n        actions: options.actions,\n        ...(options.threadId ? { threadId: options.threadId } : {}),\n      };\n\n      const result = await sendToHumanForAi(aiContext, payload);\n\n      return toHumanToolResult(result);\n    },\n  });\n}\n\nexport { sendToHumanToolInputSchema };\n","import { tool } from \"ai\";\nimport { z } from \"zod\";\nimport { threadUpdateStatusSchema } from \"../schemas/index.js\";\nimport { RobotRockError, type RobotRock } from \"../client.js\";\nimport type { ThreadUpdate } from \"../schemas/index.js\";\nimport {\n  normalizeRobotRockAiContext,\n  sendUpdateForAi,\n  type RobotRockAiContext,\n} from \"./context.js\";\n\n/**\n * Result returned to the model by {@link createSendUpdateTool}.\n *\n * Updates are fire-and-forget, so a missing thread (no task created yet) is\n * reported as `{ posted: false }` instead of throwing — that way an agent loop\n * is never aborted by a non-critical progress update. Genuine failures (auth,\n * validation, server errors) still throw.\n */\nexport type SendUpdateToolResult =\n  | { posted: true; threadId: string; update: ThreadUpdate }\n  | {\n      posted: false;\n      threadId: string;\n      reason: \"thread_not_found\";\n      message: string;\n    };\n\nconst sendUpdateToolInputSchema = z.object({\n  threadId: z\n    .string()\n    .optional()\n    .describe(\n      \"Thread to post the update to. Use the `threadId` returned by a prior send-to-human task. Omit only when a session threadId is configured on the tool.\"\n    ),\n  message: z\n    .string()\n    .describe(\"Short progress update (1-2 sentences) shown in the inbox status bar\"),\n  status: threadUpdateStatusSchema\n    .optional()\n    .describe(\n      \"Lifecycle status driving the status-bar icon/color: info, queued, running, waiting, succeeded, failed, cancelled\"\n    ),\n});\n\nexport type CreateSendUpdateToolOptions = {\n  /**\n   * Session thread to post updates to when the model does not supply `threadId`.\n   * Pass the same value to {@link createSendToHumanTool} to auto-thread tasks\n   * and updates together.\n   */\n  threadId?: string;\n  description?: string;\n};\n\nexport type CreateSendUpdateToolDurableOptions = CreateSendUpdateToolOptions &\n  RobotRockAiContext & { mode: \"trigger\" | \"workflow\" };\n\n/**\n * AI SDK tool that posts a progress update to a RobotRock thread.\n *\n * Fire-and-forget (no human wait): the agent reports status as it works.\n *\n * - `createSendUpdateTool(robotrock, options?)` — polling client (default).\n * - `createSendUpdateTool({ mode: \"trigger\", app?: \"my-agent\" })` — Trigger.dev worker.\n * - `createSendUpdateTool({ mode: \"workflow\", app?: \"my-agent\" })` — Vercel Workflow (durable step).\n *\n * The thread is resolved from the tool input `threadId`, falling back to a\n * session `threadId` in the options. Provide at least one.\n */\nexport function createSendUpdateTool(\n  clientOrOptions: RobotRock | CreateSendUpdateToolDurableOptions,\n  maybeOptions: CreateSendUpdateToolOptions = {}\n) {\n  const isDurable =\n    typeof clientOrOptions === \"object\" &&\n    clientOrOptions !== null &&\n    \"mode\" in clientOrOptions &&\n    (clientOrOptions.mode === \"trigger\" || clientOrOptions.mode === \"workflow\");\n\n  const aiContext: RobotRockAiContext = normalizeRobotRockAiContext(\n    isDurable\n      ? {\n          mode: (clientOrOptions as CreateSendUpdateToolDurableOptions).mode,\n          app: (clientOrOptions as CreateSendUpdateToolDurableOptions).app,\n        }\n      : (clientOrOptions as RobotRock)\n  );\n  const options = isDurable\n    ? (clientOrOptions as CreateSendUpdateToolDurableOptions)\n    : maybeOptions;\n  const description =\n    options.description ??\n    \"Post a short progress update to the RobotRock thread you are working on. Use to report status changes (running, succeeded, failed) so humans can follow along in the inbox.\";\n\n  return tool({\n    description,\n    inputSchema: sendUpdateToolInputSchema,\n    execute: async (\n      input: z.infer<typeof sendUpdateToolInputSchema>\n    ): Promise<SendUpdateToolResult> => {\n      const threadId = input.threadId ?? options.threadId;\n      if (!threadId) {\n        throw new Error(\n          \"createSendUpdateTool: no threadId. Pass `threadId` from a prior send-to-human result, or configure a session `threadId` in the tool options.\"\n        );\n      }\n\n      try {\n        const update = await sendUpdateForAi(aiContext, {\n          threadId,\n          message: input.message,\n          status: input.status,\n        });\n        return { posted: true, threadId, update };\n      } catch (error) {\n        if (error instanceof RobotRockError && error.statusCode === 404) {\n          return {\n            posted: false,\n            threadId,\n            reason: \"thread_not_found\",\n            message: `No task exists for thread \"${threadId}\" yet, so the update was not posted. Create a task on this thread with send-to-human before reporting progress.`,\n          };\n        }\n        throw error;\n      }\n    },\n  });\n}\n\nexport { sendUpdateToolInputSchema };\n","import type { RobotRock, SendToHumanActionInput } from \"../client.js\";\nimport type {\n  RobotRockAiContext,\n  RobotRockAiTriggerContext,\n  RobotRockAiWorkflowContext,\n} from \"./context.js\";\nimport { normalizeRobotRockAiContext } from \"./context.js\";\nimport { approveByHumanTool as buildApproveByHumanTool } from \"./approve-by-human-tool.js\";\nimport {\n  createSendToHumanTool as buildSendToHumanTool,\n  type CreateSendToHumanToolOptions,\n} from \"./create-send-to-human-tool.js\";\nimport {\n  createSendUpdateTool as buildSendUpdateTool,\n  type CreateSendUpdateToolOptions,\n} from \"./create-send-update-tool.js\";\nimport type { ApproveByHumanToolOptions } from \"./approve-by-human-tool.js\";\n\nexport type CreateRobotRockAiToolsOptions = {\n  /** @default \"polling\" when `client` is passed; `\"trigger\"` or `\"workflow\"` for durable waits. */\n  mode?: \"polling\" | \"trigger\" | \"workflow\";\n  client?: RobotRock;\n  app?: string;\n  /**\n   * Shared thread for tasks and updates these tools create. Enables the\n   * `sendUpdate` tool to auto-thread onto tasks made by the `sendToHuman` tool.\n   */\n  threadId?: string;\n};\n\n/**\n * Build AI SDK tools for a given RobotRock execution mode.\n *\n * @example Polling (Next.js route, scripts)\n * ```ts\n * const tools = createRobotRockAiTools({ client: robotrock });\n * ```\n *\n * @example Trigger.dev worker\n * ```ts\n * const tools = createRobotRockAiTools({ mode: \"trigger\", app: \"my-agent\" });\n * ```\n *\n * @example Vercel Workflow + DurableAgent\n * ```ts\n * const tools = createRobotRockAiTools({ mode: \"workflow\", app: \"my-agent\" });\n * ```\n */\nexport function createRobotRockAiTools(options: CreateRobotRockAiToolsOptions) {\n  const mode = options.mode ?? (options.client ? \"polling\" : \"trigger\");\n\n  if (mode === \"polling\" && !options.client) {\n    throw new Error('createRobotRockAiTools: polling mode requires `client`.');\n  }\n\n  const context: RobotRockAiContext =\n    mode === \"trigger\"\n      ? { mode: \"trigger\", app: options.app }\n      : mode === \"workflow\"\n        ? { mode: \"workflow\", app: options.app }\n        : { mode: \"polling\", client: options.client! };\n\n  const durableContext =\n    context.mode === \"trigger\" || context.mode === \"workflow\" ? context : null;\n  const pollingClient = context.mode === \"polling\" ? context.client : undefined;\n\n  return {\n    context,\n    approveByHuman: (toolOptions?: ApproveByHumanToolOptions) =>\n      durableContext\n        ? buildApproveByHumanTool({ ...durableContext, ...toolOptions })\n        : buildApproveByHumanTool(pollingClient!, toolOptions),\n    sendToHuman: <A extends readonly SendToHumanActionInput[]>(\n      toolOptions: CreateSendToHumanToolOptions<A>\n    ) =>\n      durableContext\n        ? buildSendToHumanTool({\n            ...durableContext,\n            ...(options.threadId ? { threadId: options.threadId } : {}),\n            ...toolOptions,\n          })\n        : buildSendToHumanTool(pollingClient!, {\n            ...(options.threadId ? { threadId: options.threadId } : {}),\n            ...toolOptions,\n          }),\n    sendUpdate: (toolOptions: CreateSendUpdateToolOptions = {}) =>\n      durableContext\n        ? buildSendUpdateTool({\n            ...durableContext,\n            ...(options.threadId ? { threadId: options.threadId } : {}),\n            ...toolOptions,\n          })\n        : buildSendUpdateTool(pollingClient!, {\n            ...(options.threadId ? { threadId: options.threadId } : {}),\n            ...toolOptions,\n          }),\n  };\n}\n\n/** Shorthand for `{ mode: \"trigger\", app }`. */\nexport function createRobotRockAiTriggerContext(\n  options: Omit<RobotRockAiTriggerContext, \"mode\"> = {}\n): RobotRockAiContext {\n  return { mode: \"trigger\", ...options };\n}\n\n/** Shorthand for `{ mode: \"workflow\", app }`. */\nexport function createRobotRockAiWorkflowContext(\n  options: Omit<RobotRockAiWorkflowContext, \"mode\"> = {}\n): RobotRockAiContext {\n  return { mode: \"workflow\", ...options };\n}\n\nexport { normalizeRobotRockAiContext };\n","import type { SendToHumanInput } from \"../client.js\";\nimport type { FormatToolApprovalTaskOptions, RobotRockToolCallInfo } from \"./types.js\";\n\nconst DEFAULT_APPROVE_ACTIONS = [\n  { id: \"approve\", title: \"Approve execution\" },\n  { id: \"deny\", title: \"Deny\" },\n] as const;\n\n/**\n * Build a RobotRock task payload for an AI SDK tool approval request.\n */\nexport function defaultFormatToolApprovalTask(\n  toolCall: RobotRockToolCallInfo,\n  options: FormatToolApprovalTaskOptions = {}\n): SendToHumanInput {\n  const approveId = options.approveActionId ?? \"approve\";\n  const denyId = options.denyActionId ?? \"deny\";\n\n  let inputPreview: string;\n  try {\n    inputPreview = JSON.stringify(toolCall.input, null, 2);\n  } catch {\n    inputPreview = String(toolCall.input);\n  }\n\n  return {\n    type: options.type ?? \"ai-tool-approval\",\n    name: `Approve: ${toolCall.toolName}`,\n    description: `Review the proposed \\`${toolCall.toolName}\\` tool call before it runs.`,\n    context: {\n      data: {\n        toolName: toolCall.toolName,\n        toolCallId: toolCall.toolCallId,\n        input: toolCall.input,\n      },\n      ui: {\n        toolName: { \"ui:widget\": \"text\" },\n        toolCallId: { \"ui:widget\": \"text\" },\n        input: { \"ui:widget\": \"textarea\" },\n      },\n    },\n    actions: [\n      { id: approveId, title: \"Approve execution\" },\n      { id: denyId, title: \"Deny\" },\n    ],\n  };\n}\n\nexport { DEFAULT_APPROVE_ACTIONS };\n","import type { ToolApprovalResponse } from \"ai\";\nimport type { RobotRock } from \"../client.js\";\nimport {\n  normalizeRobotRockAiContext,\n  sendToHumanForAi,\n  type RobotRockAiContext,\n} from \"./context.js\";\nimport { defaultFormatToolApprovalTask } from \"./format-tool-approval-task.js\";\nimport type {\n  ResolveToolApprovalsOptions,\n  RobotRockToolApprovalConfig,\n  RobotRockToolCallInfo,\n  RunWithRobotRockApprovalsOptions,\n  ToolApprovalRequestPart,\n} from \"./types.js\";\n\nexport type RobotRockToolApprovalDecision = \"user-approval\" | undefined;\n\nfunction buildToolMatcher(config: RobotRockToolApprovalConfig) {\n  const names = config.tools ? new Set(config.tools) : null;\n\n  return (toolCall: RobotRockToolCallInfo): boolean => {\n    if (config.when?.(toolCall)) {\n      return true;\n    }\n    if (names && names.has(toolCall.toolName)) {\n      return true;\n    }\n    return false;\n  };\n}\n\n/**\n * AI SDK 7+: pass the return value to `toolApproval` on `generateText`, `streamText`, or `ToolLoopAgent`.\n * Returns `'user-approval'` for configured tools so execution pauses until a human responds via RobotRock.\n */\nexport function createRobotRockToolApproval(config: RobotRockToolApprovalConfig) {\n  const matches = buildToolMatcher(config);\n\n  const toolApproval = async (options: {\n    toolCall: RobotRockToolCallInfo;\n  }): Promise<RobotRockToolApprovalDecision> => {\n    return matches(options.toolCall) ? \"user-approval\" : undefined;\n  };\n\n  return toolApproval;\n}\n\n/**\n * AI SDK 5–6: use as `needsApproval` on tool definitions (or via {@link applyRobotRockToolApprovalToTools}).\n */\nexport function createRobotRockNeedsApproval(config: RobotRockToolApprovalConfig) {\n  const matches = buildToolMatcher(config);\n\n  return async (\n    _input: unknown,\n    options: { toolCallId: string; messages?: unknown[] }\n  ): Promise<boolean> => {\n    const toolCall = findToolCallInMessages(options.messages, options.toolCallId);\n    if (!toolCall) {\n      return false;\n    }\n    return matches(toolCall);\n  };\n}\n\n/**\n * AI SDK 5–6: merge `needsApproval` into each matching tool in a tools object.\n */\nexport function applyRobotRockToolApprovalToTools<T extends Record<string, object>>(\n  tools: T,\n  config: RobotRockToolApprovalConfig\n): T {\n  const names = config.tools ? new Set(config.tools) : null;\n  const needsApproval = createRobotRockNeedsApproval(config);\n\n  const next = { ...tools } as T;\n\n  for (const key of Object.keys(tools) as Array<keyof T>) {\n    const name = String(key);\n    const shouldApply =\n      (names && names.has(name)) || (names === null && config.when !== undefined);\n\n    if (!shouldApply) {\n      continue;\n    }\n\n    const existing = tools[key];\n    next[key] = {\n      ...existing,\n      needsApproval,\n    } as T[keyof T];\n  }\n\n  return next;\n}\n\nfunction findToolCallInMessages(\n  messages: unknown[] | undefined,\n  toolCallId: string\n): RobotRockToolCallInfo | undefined {\n  if (!messages) {\n    return undefined;\n  }\n\n  for (const message of messages) {\n    if (typeof message !== \"object\" || message === null) {\n      continue;\n    }\n    const role = (message as { role?: string }).role;\n    if (role !== \"assistant\") {\n      continue;\n    }\n    const content = (message as { content?: unknown }).content;\n    if (!Array.isArray(content)) {\n      continue;\n    }\n\n    for (const part of content) {\n      if (typeof part !== \"object\" || part === null) {\n        continue;\n      }\n      const p = part as Record<string, unknown>;\n      if (p.type === \"tool-call\" && p.toolCallId === toolCallId) {\n        return {\n          toolName: String(p.toolName ?? \"\"),\n          toolCallId,\n          input: p.input,\n        };\n      }\n    }\n  }\n\n  return undefined;\n}\n\nfunction collectApprovalRequests(source: unknown): ToolApprovalRequestPart[] {\n  const requests: ToolApprovalRequestPart[] = [];\n\n  const visit = (value: unknown) => {\n    if (!value) {\n      return;\n    }\n\n    if (Array.isArray(value)) {\n      for (const item of value) {\n        visit(item);\n      }\n      return;\n    }\n\n    if (typeof value !== \"object\") {\n      return;\n    }\n\n    const obj = value as Record<string, unknown>;\n\n    if (obj.type === \"tool-approval-request\" && typeof obj.approvalId === \"string\") {\n      if (obj.isAutomatic === true) {\n        return;\n      }\n\n      const embedded = obj.toolCall as Record<string, unknown> | undefined;\n      const toolCallId =\n        typeof obj.toolCallId === \"string\"\n          ? obj.toolCallId\n          : typeof embedded?.toolCallId === \"string\"\n            ? embedded.toolCallId\n            : undefined;\n\n      let toolCall: RobotRockToolCallInfo | undefined;\n      if (embedded && typeof embedded.toolName === \"string\") {\n        toolCall = {\n          toolName: embedded.toolName,\n          toolCallId: String(embedded.toolCallId ?? toolCallId ?? \"\"),\n          input: embedded.input,\n        };\n      } else if (toolCallId) {\n        toolCall = findToolCallInMessages(\n          (source as { messages?: unknown[] }).messages,\n          toolCallId\n        );\n      }\n\n      requests.push({\n        type: \"tool-approval-request\",\n        approvalId: obj.approvalId,\n        toolCallId,\n        toolCall,\n        isAutomatic: obj.isAutomatic === true,\n      });\n      return;\n    }\n\n    if (Array.isArray(obj.content)) {\n      visit(obj.content);\n    }\n    if (Array.isArray(obj.steps)) {\n      visit(obj.steps);\n    }\n    if (obj.response && typeof obj.response === \"object\") {\n      visit((obj.response as { messages?: unknown[] }).messages);\n    }\n  };\n\n  visit(source);\n\n  if (typeof source === \"object\" && source !== null && Array.isArray((source as { content?: unknown[] }).content)) {\n    visit((source as { content: unknown[] }).content);\n  }\n\n  const seen = new Set<string>();\n  return requests.filter((r) => {\n    if (seen.has(r.approvalId)) {\n      return false;\n    }\n    seen.add(r.approvalId);\n    return true;\n  });\n}\n\nfunction resolveToolCallForRequest(\n  request: ToolApprovalRequestPart,\n  source: unknown,\n  messages: unknown[]\n): RobotRockToolCallInfo {\n  if (request.toolCall) {\n    return request.toolCall;\n  }\n\n  const toolCallId = request.toolCallId;\n  if (toolCallId) {\n    const fromMessages = findToolCallInMessages(messages, toolCallId);\n    if (fromMessages) {\n      return fromMessages;\n    }\n  }\n\n  if (typeof source === \"object\" && source !== null && Array.isArray((source as { toolCalls?: unknown[] }).toolCalls)) {\n    for (const call of (source as { toolCalls: Array<Record<string, unknown>> }).toolCalls) {\n      if (call.toolCallId === toolCallId) {\n        return {\n          toolName: String(call.toolName ?? \"\"),\n          toolCallId: String(call.toolCallId ?? \"\"),\n          input: call.input,\n        };\n      }\n    }\n  }\n\n  throw new Error(\n    `Could not resolve tool call for approval ${request.approvalId}. Pass messages that include the assistant tool-call.`\n  );\n}\n\n/**\n * Create RobotRock tasks for pending AI SDK tool approvals and return `tool-approval-response` parts.\n */\nexport async function resolveToolApprovalsViaRobotRock(\n  clientOrContext: RobotRock | RobotRockAiContext,\n  source: unknown,\n  options: ResolveToolApprovalsOptions = {}\n): Promise<{\n  responses: ToolApprovalResponse[];\n  messages: unknown[];\n}> {\n  const context = normalizeRobotRockAiContext(clientOrContext);\n  const approveId = options.approveActionId ?? \"approve\";\n  const denyId = options.denyActionId ?? \"deny\";\n  const formatTask = options.formatTask ?? defaultFormatToolApprovalTask;\n\n  const baseMessages =\n    typeof source === \"object\" && source !== null && Array.isArray((source as { messages?: unknown[] }).messages)\n      ? [...(source as { messages: unknown[] }).messages]\n      : [];\n\n  const requests = collectApprovalRequests(source);\n  const responses: ToolApprovalResponse[] = [];\n\n  for (const request of requests) {\n    const toolCall = resolveToolCallForRequest(request, source, baseMessages);\n    const taskInput = formatTask(toolCall, {\n      approveActionId: approveId,\n      denyActionId: denyId,\n    });\n\n    const result = await sendToHumanForAi(context, taskInput);\n\n    const approved = result.actionId === approveId;\n    const reason =\n      typeof result.data === \"object\" &&\n      result.data !== null &&\n      \"reason\" in result.data &&\n      typeof (result.data as { reason?: unknown }).reason === \"string\"\n        ? (result.data as { reason: string }).reason\n        : approved\n          ? \"Approved in RobotRock inbox\"\n          : \"Denied in RobotRock inbox\";\n\n    responses.push({\n      type: \"tool-approval-response\",\n      approvalId: request.approvalId,\n      approved,\n      reason,\n    });\n  }\n\n  const messages = [...baseMessages];\n  if (responses.length > 0) {\n    messages.push({ role: \"tool\", content: responses });\n  }\n\n  return { responses, messages };\n}\n\n/**\n * Run `generate` in a loop until manual tool approvals are resolved via RobotRock or `maxRounds` is reached.\n */\nexport async function runWithRobotRockApprovals<T>(\n  options: RunWithRobotRockApprovalsOptions<T>\n): Promise<T> {\n  const clientOrContext =\n    options.context ??\n    (options.client\n      ? options.client\n      : (() => {\n          throw new Error(\"runWithRobotRockApprovals requires `client` or `context`.\");\n        })());\n\n  const maxRounds = options.maxRounds ?? 20;\n  let messages = options.messages ? [...options.messages] : [];\n  let lastResult: T | undefined;\n\n  for (let round = 0; round < maxRounds; round++) {\n    lastResult = await options.generate(messages);\n    const { responses, messages: nextMessages } = await resolveToolApprovalsViaRobotRock(\n      clientOrContext,\n      { ...(lastResult as object), messages },\n      options.resolveOptions\n    );\n\n    if (responses.length === 0) {\n      return lastResult;\n    }\n\n    messages = nextMessages;\n  }\n\n  throw new Error(`RobotRock approval loop exceeded maxRounds (${maxRounds})`);\n}\n\nexport { collectApprovalRequests };\n"],"mappings":"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","names":["result","APPROVE_BY_HUMAN_ACTIONS","tool","z","z","tool","tool","z","z","tool"]}

package/dist/{chunk-2KFY7ZJV.js → chunk-TAWMIQAM.js}

@@ -126,6 +126,16 @@ var threadUpdateInputSchema = z.object({
   message: threadUpdateMessageSchema,
   status: threadUpdateStatusSchema.optional()
 });
+var taskPriorities = ["low", "normal", "high", "urgent"];
+var taskPrioritySchema = z.enum(taskPriorities);
+var DEFAULT_TASK_PRIORITY = "normal";
+var LOWEST_TASK_PRIORITY = "low";
+var TASK_PRIORITY_RANK = {
+  low: 1,
+  normal: 2,
+  high: 3,
+  urgent: 4
+};
 var createTaskBodySchema = taskContextSchema.extend({
   assignTo: assignToSchema.optional(),
   /**
@@ -133,6 +143,11 @@ var createTaskBodySchema = taskContextSchema.extend({
    * returns it so the caller can reuse it on later tasks in the same thread.
    */
   threadId: z.string().min(1).optional(),
+  /**
+   * Optional thread priority. When set, applies to the whole thread and
+   * overwrites any previous priority. Omit on later tasks to leave unchanged.
+   */
+  priority: taskPrioritySchema.optional(),
   /**
    * Optional initial status update logged against the task's thread. Shows in
    * the inbox status bar and the thread update log.
@@ -151,7 +166,12 @@ export {
   threadUpdateStatusSchema,
   DEFAULT_THREAD_UPDATE_STATUS,
   threadUpdateInputSchema,
+  taskPriorities,
+  taskPrioritySchema,
+  DEFAULT_TASK_PRIORITY,
+  LOWEST_TASK_PRIORITY,
+  TASK_PRIORITY_RANK,
   createTaskBodySchema,
   threadUpdateBodySchema
 };
-//# sourceMappingURL=chunk-2KFY7ZJV.js.map
+//# sourceMappingURL=chunk-TAWMIQAM.js.map

package/dist/chunk-TAWMIQAM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/index.ts"],"sourcesContent":["import { z } from \"zod\";\n\nexport interface JSONSchema7 {\n  $id?: string;\n  $ref?: string;\n  $schema?: string;\n  $comment?: string;\n  type?: JSONSchema7TypeName | JSONSchema7TypeName[];\n  enum?: unknown[];\n  const?: unknown;\n  multipleOf?: number;\n  maximum?: number;\n  exclusiveMaximum?: number;\n  minimum?: number;\n  exclusiveMinimum?: number;\n  maxLength?: number;\n  minLength?: number;\n  pattern?: string;\n  format?: string;\n  items?: JSONSchema7 | JSONSchema7[];\n  additionalItems?: JSONSchema7 | boolean;\n  maxItems?: number;\n  minItems?: number;\n  uniqueItems?: boolean;\n  contains?: JSONSchema7;\n  maxProperties?: number;\n  minProperties?: number;\n  required?: string[];\n  properties?: Record<string, JSONSchema7>;\n  patternProperties?: Record<string, JSONSchema7>;\n  additionalProperties?: JSONSchema7 | boolean;\n  dependencies?: Record<string, JSONSchema7 | string[]>;\n  propertyNames?: JSONSchema7;\n  if?: JSONSchema7;\n  then?: JSONSchema7;\n  else?: JSONSchema7;\n  allOf?: JSONSchema7[];\n  anyOf?: JSONSchema7[];\n  oneOf?: JSONSchema7[];\n  not?: JSONSchema7;\n  title?: string;\n  description?: string;\n  default?: unknown;\n  readOnly?: boolean;\n  writeOnly?: boolean;\n  examples?: unknown[];\n}\n\nexport type JSONSchema7TypeName =\n  | \"string\"\n  | \"number\"\n  | \"integer\"\n  | \"boolean\"\n  | \"object\"\n  | \"array\"\n  | \"null\";\n\nexport type ExtendedJSONSchema7 = JSONSchema7 & {\n  enumNames?: string[];\n  [key: string]: unknown;\n};\n\nexport type UiSchema = {\n  \"ui:widget\"?: string;\n  \"ui:title\"?: string;\n  \"ui:description\"?: string;\n  \"ui:placeholder\"?: string;\n  \"ui:options\"?: Record<string, unknown>;\n  [key: string]: unknown;\n};\n\nconst safeUrlSchema = z\n  .string()\n  .refine((url) => url.startsWith(\"http://\") || url.startsWith(\"https://\"), {\n    message: \"URL must start with http:// or https://\",\n  });\n\nconst jsonSchema7Schema = z.custom<ExtendedJSONSchema7>(\n  (val) => typeof val === \"object\" && val !== null,\n  { message: \"Must be a valid JSON Schema object\" }\n);\n\nconst uiSchemaSchema = z.custom<UiSchema>((val) => typeof val === \"object\" && val !== null, {\n  message: \"Must be a valid UiSchema object\",\n});\n\nconst webhookHandlerSchema = z.object({\n  type: z.literal(\"webhook\"),\n  url: safeUrlSchema,\n  headers: z.record(z.string()),\n});\n\nconst triggerHandlerSchema = webhookHandlerSchema.extend({\n  type: z.literal(\"trigger\"),\n  tokenId: z.string().min(1),\n});\n\nconst handlerSchema = z.discriminatedUnion(\"type\", [webhookHandlerSchema, triggerHandlerSchema]);\n\nconst taskActionSchema = z.object({\n  id: z.string().min(1),\n  title: z.string().min(1),\n  description: z.string().optional(),\n  schema: jsonSchema7Schema.optional(),\n  ui: uiSchemaSchema.optional(),\n  data: z.record(z.unknown()).optional(),\n  handlers: z.array(handlerSchema).min(1).optional(),\n});\n\nconst uiFieldSchemaSchema: z.ZodType<Record<string, unknown>> = z\n  .object({\n    \"ui:widget\": z.string().optional(),\n    \"ui:title\": z.string().optional(),\n    \"ui:description\": z.string().optional(),\n    \"ui:options\": z.record(z.unknown()).optional(),\n    items: z.lazy(() => z.record(uiFieldSchemaSchema)).optional(),\n  })\n  .passthrough();\n\nconst contextUiSchema = z.record(uiFieldSchemaSchema).optional();\n\nconst contextDataSchema = z\n  .object({\n    data: z.record(z.unknown()),\n    ui: contextUiSchema,\n  })\n  .optional();\n\nexport const taskContextSchema = z.object({\n  app: z.string().min(1).optional(),\n  type: z.string().min(1),\n  name: z.string().min(1),\n  description: z.string().optional(),\n  validUntil: z.string().optional(),\n  context: contextDataSchema,\n  version: z.literal(2).optional(),\n  actions: z.array(taskActionSchema).min(1, \"At least one action is required\"),\n});\n\n/**\n * Assignment targets at task create (not stored in task context JSON).\n * Unknown user emails are auto-provisioned as assignee memberships (not full team seats).\n */\nexport const assignToSchema = z\n  .object({\n    users: z.array(z.string().email()).optional(),\n    groups: z.array(z.string().min(1)).optional(),\n  })\n  .refine(\n    (data) => {\n      const groups = data.groups ?? [];\n      if (groups.includes(\"all\") && groups.length > 1) {\n        return false;\n      }\n      return true;\n    },\n    { message: 'Cannot combine \"all\" with other group slugs' }\n  );\n\n/** A short thread-scoped status update message (1-2 sentences). */\nexport const threadUpdateMessageSchema = z.string().min(1).max(500);\n\n/**\n * Lifecycle status carried by a thread update. Drives the icon and color shown\n * in the inbox status bar. Defaults to `info` when omitted.\n */\nexport const threadUpdateStatuses = [\n  \"info\",\n  \"queued\",\n  \"running\",\n  \"waiting\",\n  \"succeeded\",\n  \"failed\",\n  \"cancelled\",\n] as const;\n\nexport const threadUpdateStatusSchema = z.enum(threadUpdateStatuses);\n\n/** The default status applied when an update omits one. */\nexport const DEFAULT_THREAD_UPDATE_STATUS: ThreadUpdateStatus = \"info\";\n\n/** Shared shape for a thread update (standalone and at task creation). */\nexport const threadUpdateInputSchema = z.object({\n  message: threadUpdateMessageSchema,\n  status: threadUpdateStatusSchema.optional(),\n});\n\n/** Thread priority levels for inbox ordering and display. */\nexport const taskPriorities = [\"low\", \"normal\", \"high\", \"urgent\"] as const;\n\nexport const taskPrioritySchema = z.enum(taskPriorities);\n\nexport type TaskPriority = (typeof taskPriorities)[number];\n\nexport const DEFAULT_TASK_PRIORITY: TaskPriority = \"normal\";\n\nexport const LOWEST_TASK_PRIORITY: TaskPriority = \"low\";\n\nexport const TASK_PRIORITY_RANK: Record<TaskPriority, number> = {\n  low: 1,\n  normal: 2,\n  high: 3,\n  urgent: 4,\n};\n\nexport const createTaskBodySchema = taskContextSchema.extend({\n  assignTo: assignToSchema.optional(),\n  /**\n   * Groups related tasks together. When omitted, the server generates one and\n   * returns it so the caller can reuse it on later tasks in the same thread.\n   */\n  threadId: z.string().min(1).optional(),\n  /**\n   * Optional thread priority. When set, applies to the whole thread and\n   * overwrites any previous priority. Omit on later tasks to leave unchanged.\n   */\n  priority: taskPrioritySchema.optional(),\n  /**\n   * Optional initial status update logged against the task's thread. Shows in\n   * the inbox status bar and the thread update log.\n   */\n  update: threadUpdateInputSchema.optional(),\n});\n\n/** POST /v1/threads/:threadId/updates body: a standalone thread update. */\nexport const threadUpdateBodySchema = threadUpdateInputSchema;\n\n/** Where a thread update originated. */\nexport type ThreadUpdateSource = \"api\" | \"task_create\" | \"dashboard\";\n\n/** Lifecycle status carried by a thread update. */\nexport type ThreadUpdateStatus = (typeof threadUpdateStatuses)[number];\n\n/** A logged thread update as returned by the API. */\nexport interface ThreadUpdate {\n  id: string;\n  threadId: string;\n  message: string;\n  status: ThreadUpdateStatus;\n  source: ThreadUpdateSource;\n  createdAt: number;\n}\n\nexport type AssignToInput = z.infer<typeof assignToSchema>;\nexport type CreateTaskBodyInput = z.input<typeof createTaskBodySchema>;\nexport type CreateTaskBody = z.output<typeof createTaskBodySchema>;\nexport type ThreadUpdateBodyInput = z.input<typeof threadUpdateBodySchema>;\nexport type ThreadUpdateBody = z.output<typeof threadUpdateBodySchema>;\nexport type ThreadUpdateInput = z.input<typeof threadUpdateInputSchema>;\nexport type TaskContextInput = z.input<typeof taskContextSchema>;\nexport type TaskContextOutput = z.output<typeof taskContextSchema>;\nexport type TaskContext = TaskContextOutput;\nexport type TaskAction = z.infer<typeof taskActionSchema>;\nexport type WebhookHandler = z.infer<typeof webhookHandlerSchema>;\nexport type TriggerHandler = z.infer<typeof triggerHandlerSchema>;\nexport type Handler = z.infer<typeof handlerSchema>;\n\ntype InferObjectProperties<\n  Props,\n  Req extends PropertyKey,\n> = Props extends Record<string, unknown>\n  ? ({\n      [K in keyof Props as K extends Req ? K : never]-?: InferJsonSchema7<Props[K]>;\n    } & {\n      [K in keyof Props as K extends Req ? never : K]?: InferJsonSchema7<Props[K]>;\n    } extends infer O\n      ? { [K in keyof O]: O[K] }\n      : never)\n  : Record<string, unknown>;\n\ntype RequiredKeys<S> =\n  S extends { readonly required: readonly string[] } ? S[\"required\"][number] : never;\n\nexport type InferJsonSchema7<S> = [S] extends [undefined]\n  ? Record<string, never>\n  : S extends { readonly const: infer C }\n    ? C\n    : S extends {\n          readonly enum: readonly (infer E)[];\n        }\n      ? E\n      : S extends {\n            readonly type: \"object\";\n            readonly properties?: infer Props;\n          }\n        ? InferObjectProperties<Props, RequiredKeys<S>>\n        : S extends {\n              readonly type: \"object\";\n              readonly properties?: undefined;\n            }\n          ? Record<string, unknown>\n          : S extends {\n                readonly type: \"array\";\n                readonly items?: infer Items;\n              }\n            ? Items extends readonly unknown[]\n              ? InferJsonSchema7<Items[number]>[]\n              : Items extends object\n                ? InferJsonSchema7<Items>[]\n                : unknown[]\n            : S extends { readonly type: \"string\" }\n              ? string\n              : S extends { readonly type: \"number\" } | { readonly type: \"integer\" }\n                ? number\n                : S extends { readonly type: \"boolean\" }\n                  ? boolean\n                  : unknown;\n\nexport type TaskStatus = \"pending\" | \"open\" | \"handled\" | \"expired\";\n\nexport interface TaskResponse {\n  success: boolean;\n  task: {\n    taskId: string;\n    threadId: string;\n    status: \"pending\" | \"open\";\n    context: TaskContext;\n    validUntil: string;\n    submittedAt: string;\n  };\n  message: string;\n}\n\nexport interface ThreadUpdateResponse {\n  success: boolean;\n  update: ThreadUpdate;\n  message: string;\n}\n\nexport interface Task {\n  id: string;\n  threadId?: string;\n  createdAt: Date;\n  status: TaskStatus;\n  context: TaskContext;\n  validUntil: number;\n  handledAt?: number;\n  handled?: {\n    action: {\n      id: string;\n      data: unknown;\n    };\n    handledBy?: string;\n    userId?: string;\n    token?: string;\n  };\n}\n\nexport type InferActionData<T extends { schema?: unknown }> = [\n  Exclude<T[\"schema\"], undefined>,\n] extends [\n  never,\n]\n  ? Record<string, never>\n  : Exclude<T[\"schema\"], undefined> extends infer S\n    ? InferJsonSchema7<S>\n    : Record<string, never>;\n\nexport type TupleElementIndices<T extends readonly unknown[]> = T extends readonly [\n  unknown,\n  ...unknown[],\n]\n  ? Exclude<keyof T, keyof unknown[]>\n  : number;\n\nexport interface TaskResult<T = Record<string, unknown>> {\n  actionId: string;\n  data: T;\n  handledBy?: string;\n  handledAt: Date;\n}\n\nexport interface ApprovalResult<T = Record<string, unknown>> extends TaskResult<T> {\n  taskId: string;\n}\n\nexport type DiscriminatedApprovalResult<\n  TActions extends readonly { id: string; schema?: unknown }[],\n> = {\n  [I in TupleElementIndices<TActions>]: TActions[I] extends { id: string; schema?: unknown }\n    ? Omit<ApprovalResult<InferActionData<TActions[I]>>, \"actionId\" | \"data\"> & {\n        actionId: TActions[I][\"id\"];\n        data: InferActionData<TActions[I]>;\n      }\n    : never\n}[TupleElementIndices<TActions>];\n"],"mappings":"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","names":[]}

package/dist/{chunk-PZTTI6MW.js → chunk-ZCMXX7IG.js}

@@ -1,7 +1,7 @@
 import {
   createTaskBodySchema,
   threadUpdateBodySchema
-} from "./chunk-2KFY7ZJV.js";
+} from "./chunk-TAWMIQAM.js";
 
 // src/approval-result.ts
 var TaskTimeoutError = class extends Error {
@@ -111,6 +111,7 @@ var RobotRock = class {
       ...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 } : {}
     };
     const validation = createTaskBodySchema.safeParse(bodyPayload);
@@ -289,6 +290,7 @@ function normalizeSendToHumanInput(task, clientDefaults) {
     idempotencyKey: _idempotencyKey,
     assignTo: _assignTo,
     threadId: _threadId,
+    priority: _priority,
     update: _update,
     validUntil,
     app: taskApp,
@@ -369,4 +371,4 @@ export {
   resolveRobotRockConfig,
   resolveRobotRockClient
 };
-//# sourceMappingURL=chunk-PZTTI6MW.js.map
+//# sourceMappingURL=chunk-ZCMXX7IG.js.map

package/dist/chunk-ZCMXX7IG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/approval-result.ts","../src/client.ts","../src/env.ts"],"sourcesContent":["import type { DiscriminatedApprovalResult, Task } from \"./schemas/index.js\";\n\nexport class TaskTimeoutError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"TaskTimeoutError\";\n  }\n}\n\nexport class TaskExpiredError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"TaskExpiredError\";\n  }\n}\n\n/**\n * Map a handled API task to a discriminated approval result.\n * Runtime validation is minimal; TypeScript narrows via `task.actions` at the call site.\n */\nexport function toDiscriminatedApprovalResult<A extends readonly { id: string; schema?: unknown }[]>(\n  actions: A,\n  task: Task\n): DiscriminatedApprovalResult<A> {\n  void actions;\n\n  if (!task.handled) {\n    throw new Error(\"Task has no handled result\");\n  }\n\n  return {\n    actionId: task.handled.action.id,\n    data: task.handled.action.data,\n    handledBy: task.handled.handledBy,\n    handledAt: new Date(task.handledAt ?? Date.now()),\n    taskId: task.id,\n  } as DiscriminatedApprovalResult<A>;\n}\n","import {\n  type AssignToInput,\n  type TaskContextInput,\n  createTaskBodySchema,\n  threadUpdateBodySchema,\n} from \"./schemas/index.js\";\nimport {\n  TaskExpiredError,\n  TaskTimeoutError,\n  toDiscriminatedApprovalResult,\n} from \"./approval-result.js\";\nimport type {\n  DiscriminatedApprovalResult,\n  Task,\n  TaskPriority,\n  TaskResponse,\n  ThreadUpdate,\n  ThreadUpdateResponse,\n  ThreadUpdateStatus,\n} from \"./schemas/index.js\";\n\nexport type RobotRockWebhookConfig = {\n  url: string;\n  headers?: Record<string, string>;\n};\n\nexport interface RobotRockPollingOptions {\n  /** Poll interval when no webhook is configured (ms). @default 2000 */\n  intervalMs?: number;\n  /**\n   * Max time to poll when no webhook is configured (ms).\n   * Polling also stops when the task's `validUntil` passes, whichever is sooner.\n   * @default 86400000 (24h)\n   */\n  timeoutMs?: number;\n}\n\ntype RobotRockClientBaseConfig = {\n  /** Optional override for API key. Falls back to ROBOTROCK_API_KEY. */\n  apiKey?: string;\n  /**\n   * Base URL for the RobotRock API\n   * @default \"https://api.robotrock.io/v1\"\n   */\n  baseUrl?: string;\n  /**\n   * Default inbox app bucket for every task from this client.\n   * When omitted, the API uses your API key name.\n   */\n  app?: string;\n  /**\n   * Task context format version sent on every `sendToHuman` request.\n   * @default 2\n   */\n  version?: 2;\n};\n\n/** Client config with a webhook (mutually exclusive with `polling`). */\nexport type RobotRockWebhookClientConfig = RobotRockClientBaseConfig & {\n  webhook: RobotRockWebhookConfig;\n  polling?: never;\n};\n\n/** Client config without a webhook; optional `polling` controls the wait loop. */\nexport type RobotRockPollingClientConfig = RobotRockClientBaseConfig & {\n  webhook?: never;\n  polling?: RobotRockPollingOptions;\n};\n\nexport type RobotRockConfig = RobotRockWebhookClientConfig | RobotRockPollingClientConfig;\n\nexport type SendToHumanActionInput = Omit<TaskContextInput[\"actions\"][number], \"handlers\">;\n\nexport type SendToHumanValidUntil = Date | string;\n\nexport type SendToHumanInput<\n  A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[],\n> = Omit<TaskContextInput, \"app\" | \"actions\" | \"version\" | \"validUntil\"> & {\n  actions: A;\n  /** Task deadline; serialized to an ISO 8601 string on the wire. */\n  validUntil?: SendToHumanValidUntil;\n  /** Optional idempotency key to prevent duplicate tasks */\n  idempotencyKey?: string;\n  /** Assign to tenant users (email) and/or groups (slug). Narrows inbox visibility. */\n  assignTo?: AssignToInput;\n  /**\n   * Groups related tasks together in the inbox. Omit to let the server generate\n   * one (returned as `task.threadId`) and reuse it on later tasks in the thread.\n   */\n  threadId?: string;\n  /**\n   * Optional thread priority. When set, applies to the whole thread and\n   * overwrites any previous priority. Omit on later tasks to leave unchanged.\n   */\n  priority?: TaskPriority;\n  /**\n   * Optional initial status update logged against the task's thread. Shows in\n   * the inbox status bar and the thread update log.\n   */\n  update?: {\n    /** A short status update (1-2 sentences). */\n    message: string;\n    /** Lifecycle status for the icon/color in the status bar. @default \"info\" */\n    status?: ThreadUpdateStatus;\n  };\n};\n\ntype SendToHumanWithAppInput<\n  A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[],\n> = (SendToHumanInput<A> | Readonly<SendToHumanInput<A>>) & {\n  /** Inbox app bucket. Overrides the client `app` when set. */\n  app?: string;\n};\n\nexport type SendUpdateInput = {\n  /** The thread to log the update against (from `task.threadId`). */\n  threadId: string;\n  /** A short status update (1-2 sentences). */\n  message: string;\n  /** Lifecycle status for the icon/color in the status bar. @default \"info\" */\n  status?: ThreadUpdateStatus;\n};\n\nexport type SendToHumanResult<\n  A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[],\n> =\n  | {\n      mode: \"created\";\n      task: TaskResponse[\"task\"];\n    }\n  | ({\n      mode: \"handled\";\n      task: TaskResponse[\"task\"];\n    } & DiscriminatedApprovalResult<A>);\n\nconst DEFAULT_POLL_INTERVAL_MS = 2_000;\nconst DEFAULT_TIMEOUT_MS = 24 * 60 * 60 * 1_000;\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nfunction parseValidUntilMs(value: string | number | Date | undefined): number | undefined {\n  if (value === undefined) {\n    return undefined;\n  }\n\n  if (value instanceof Date) {\n    const ms = value.getTime();\n    return Number.isNaN(ms) ? undefined : ms;\n  }\n\n  if (typeof value === \"number\") {\n    return Number.isFinite(value) ? value : undefined;\n  }\n\n  const parsed = Date.parse(value);\n  return Number.isNaN(parsed) ? undefined : parsed;\n}\n\nfunction serializeValidUntil(value: SendToHumanValidUntil): string {\n  if (value instanceof Date) {\n    const ms = value.getTime();\n    if (Number.isNaN(ms)) {\n      throw new RobotRockError(\"Invalid validUntil: Date is invalid\", 400);\n    }\n    return value.toISOString();\n  }\n\n  if (typeof value === \"string\" && !Number.isNaN(Date.parse(value))) {\n    return new Date(value).toISOString();\n  }\n\n  throw new RobotRockError(\"Invalid validUntil: expected a Date or parseable date string\", 400);\n}\n\nexport class RobotRockError extends Error {\n  constructor(\n    message: string,\n    public readonly statusCode: number,\n    public readonly response?: unknown\n  ) {\n    super(message);\n    this.name = \"RobotRockError\";\n  }\n}\n\n/**\n * RobotRock API client for creating and querying human-in-the-loop tasks.\n */\nexport class RobotRock {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n  private readonly app?: string;\n  private readonly version: 2;\n  private readonly webhook?: RobotRockWebhookConfig;\n  private readonly polling: RobotRockPollingOptions;\n\n  constructor(config: RobotRockConfig) {\n    if (config.webhook && config.polling) {\n      throw new Error(\n        \"RobotRock client cannot configure both webhook and polling. Use webhook for callbacks or polling to block until handled.\"\n      );\n    }\n\n    const apiKey = config.apiKey ?? process.env.ROBOTROCK_API_KEY;\n    if (!apiKey) {\n      throw new Error(\n        \"RobotRock API key is required. Set ROBOTROCK_API_KEY or pass apiKey when creating the client.\"\n      );\n    }\n    this.apiKey = apiKey;\n    const rawBase = config.baseUrl ?? \"https://api.robotrock.io/v1\";\n    this.baseUrl = rawBase.replace(/\\/+$/, \"\");\n    this.app = config.app;\n    this.version = config.version ?? 2;\n    this.webhook = config.webhook;\n    this.polling = config.polling ?? {};\n  }\n\n  /**\n   * Create a task via POST /v1 without waiting for a human response.\n   */\n  async createTask<const A extends readonly SendToHumanActionInput[]>(\n    task: SendToHumanWithAppInput<A>\n  ): Promise<TaskResponse[\"task\"]> {\n    const normalizedTask = normalizeSendToHumanInput(task, {\n      webhook: this.webhook,\n      app: this.app,\n      version: this.version,\n    });\n    const bodyPayload = {\n      ...normalizedTask,\n      ...(task.assignTo !== undefined ? { assignTo: task.assignTo } : {}),\n      ...(task.threadId !== undefined ? { threadId: task.threadId } : {}),\n      ...(task.priority !== undefined ? { priority: task.priority } : {}),\n      ...(task.update !== undefined ? { update: task.update } : {}),\n    };\n    const validation = createTaskBodySchema.safeParse(bodyPayload);\n    if (!validation.success) {\n      throw new RobotRockError(\n        `Invalid task: ${validation.error.errors[0]?.message}`,\n        400,\n        validation.error.errors\n      );\n    }\n\n    const headers: Record<string, string> = {\n      \"Content-Type\": \"application/json\",\n      \"X-Api-Key\": this.apiKey,\n    };\n\n    if (task.idempotencyKey) {\n      headers[\"Idempotency-Key\"] = task.idempotencyKey;\n    }\n\n    const response = await fetch(`${this.baseUrl}/`, {\n      method: \"POST\",\n      headers,\n      body: JSON.stringify(validation.data),\n    });\n\n    const data = await parseResponseBody(response);\n\n    if (!response.ok) {\n      throw new RobotRockError(\n        getErrorMessage(data, \"Failed to create task\"),\n        response.status,\n        data\n      );\n    }\n\n    return (data as unknown as TaskResponse).task;\n  }\n\n  async sendToHuman<const A extends readonly SendToHumanActionInput[]>(\n    task: SendToHumanWithAppInput<A>\n  ): Promise<SendToHumanResult<A>> {\n    const normalizedTask = normalizeSendToHumanInput(task, {\n      webhook: this.webhook,\n      app: this.app,\n      version: this.version,\n    });\n    const createdTaskTask = await this.createTask(task);\n    const hasHandlers = normalizedTask.actions.some(\n      (action) => Array.isArray(action.handlers) && action.handlers.length > 0\n    );\n\n    if (hasHandlers) {\n      return {\n        mode: \"created\",\n        task: createdTaskTask,\n      };\n    }\n\n    const timeoutMs = this.polling.timeoutMs ?? DEFAULT_TIMEOUT_MS;\n    const pollIntervalMs = this.polling.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;\n    const pollingDeadline = Date.now() + timeoutMs;\n    const validUntilMs = parseValidUntilMs(createdTaskTask.validUntil);\n    const deadline =\n      validUntilMs !== undefined ? Math.min(pollingDeadline, validUntilMs) : pollingDeadline;\n    const taskId = createdTaskTask.taskId;\n\n    while (Date.now() < deadline) {\n      const existing = await this.getTask(taskId);\n\n      if (existing?.status === \"handled\" && existing.handled) {\n        return {\n          mode: \"handled\",\n          task: createdTaskTask,\n          ...(toDiscriminatedApprovalResult(\n            normalizedTask.actions as unknown as A,\n            existing\n          ) as DiscriminatedApprovalResult<A>),\n        };\n      }\n\n      if (existing?.status === \"expired\" || (existing && Date.now() >= existing.validUntil)) {\n        throw new TaskExpiredError(\"Task reached validUntil before a human completed it\");\n      }\n\n      const remainingMs = deadline - Date.now();\n      await sleep(Math.min(pollIntervalMs, Math.max(0, remainingMs)));\n    }\n\n    if (validUntilMs !== undefined && Date.now() >= validUntilMs) {\n      throw new TaskExpiredError(\"Task reached validUntil before a human completed it\");\n    }\n\n    throw new TaskTimeoutError(`No human response within ${timeoutMs}ms`);\n  }\n\n  /**\n   * Get a task by public task id (returned as `task.taskId` from {@link sendToHuman}).\n   */\n  async getTask(taskId: string): Promise<Task | null> {\n    const response = await fetch(`${this.baseUrl}/tasks/${taskId}`, {\n      method: \"GET\",\n      headers: {\n        \"X-Api-Key\": this.apiKey,\n      },\n    });\n\n    if (response.status === 404) {\n      return null;\n    }\n\n    const data = await parseResponseBody(response);\n\n    if (!response.ok) {\n      throw new RobotRockError(\n        getErrorMessage(data, \"Failed to get task\"),\n        response.status,\n        data\n      );\n    }\n\n    return data as unknown as Task;\n  }\n\n  /**\n   * Log a status update against a thread. The update shows in the inbox status\n   * bar and thread update log for every task in the thread.\n   */\n  async sendUpdate({ threadId, message, status }: SendUpdateInput): Promise<ThreadUpdate> {\n    if (!threadId) {\n      throw new RobotRockError(\"threadId is required to send an update\", 400);\n    }\n\n    const validation = threadUpdateBodySchema.safeParse({ message, status });\n    if (!validation.success) {\n      throw new RobotRockError(\n        `Invalid update: ${validation.error.errors[0]?.message}`,\n        400,\n        validation.error.errors\n      );\n    }\n\n    const response = await fetch(\n      `${this.baseUrl}/threads/${encodeURIComponent(threadId)}/updates`,\n      {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"X-Api-Key\": this.apiKey,\n        },\n        body: JSON.stringify(validation.data),\n      }\n    );\n\n    const data = await parseResponseBody(response);\n\n    if (!response.ok) {\n      throw new RobotRockError(\n        getErrorMessage(data, \"Failed to send update\"),\n        response.status,\n        data\n      );\n    }\n\n    return (data as unknown as ThreadUpdateResponse).update;\n  }\n\n  async cancelTask(taskId: string): Promise<void> {\n    const response = await fetch(`${this.baseUrl}/tasks/${taskId}/cancel`, {\n      method: \"POST\",\n      headers: {\n        \"X-Api-Key\": this.apiKey,\n      },\n    });\n\n    if (!response.ok) {\n      const data = await parseResponseBody(response);\n      throw new RobotRockError(\n        getErrorMessage(data, \"Failed to cancel task\"),\n        response.status,\n        data\n      );\n    }\n  }\n}\n\nexport function createClient(config: RobotRockConfig): RobotRock {\n  return new RobotRock(config);\n}\n\nexport function attachWebhookToActions(\n  actions: readonly SendToHumanActionInput[],\n  webhook: RobotRockWebhookConfig\n): TaskContextInput[\"actions\"] {\n  return actions.map((action) => ({\n    ...action,\n    handlers: webhookToHandlers(webhook),\n  }));\n}\n\nfunction webhookToHandlers(\n  webhook: RobotRockWebhookConfig\n): TaskContextInput[\"actions\"][number][\"handlers\"] {\n  return [\n    {\n      type: \"webhook\" as const,\n      url: webhook.url,\n      headers: webhook.headers ?? {},\n    },\n  ];\n}\n\nfunction normalizeSendToHumanInput<\n  A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[],\n>(\n  task: SendToHumanWithAppInput<A>,\n  clientDefaults: { webhook?: RobotRockWebhookConfig; app?: string; version: 2 }\n): TaskContextInput {\n  const {\n    actions,\n    idempotencyKey: _idempotencyKey,\n    assignTo: _assignTo,\n    threadId: _threadId,\n    priority: _priority,\n    update: _update,\n    validUntil,\n    app: taskApp,\n    ...rest\n  } = task;\n\n  const webhook = clientDefaults.webhook;\n  const normalizedActions: TaskContextInput[\"actions\"] = webhook\n    ? attachWebhookToActions(actions, webhook)\n    : (actions as unknown as TaskContextInput[\"actions\"]);\n\n  const app = taskApp ?? clientDefaults.app;\n\n  return {\n    ...rest,\n    version: clientDefaults.version,\n    ...(app ? { app } : {}),\n    ...(validUntil !== undefined ? { validUntil: serializeValidUntil(validUntil) } : {}),\n    actions: normalizedActions,\n  };\n}\n\ntype ParsedResponseBody = Record<string, unknown> | unknown[] | string | null;\n\nasync function parseResponseBody(response: Response): Promise<ParsedResponseBody> {\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\n  const bodyText = await response.text();\n\n  if (!bodyText) {\n    return null;\n  }\n\n  if (contentType.toLowerCase().includes(\"application/json\")) {\n    try {\n      return JSON.parse(bodyText) as ParsedResponseBody;\n    } catch {\n      // Fall through and return text body below so error messages stay useful.\n    }\n  }\n\n  try {\n    return JSON.parse(bodyText) as ParsedResponseBody;\n  } catch {\n    return bodyText;\n  }\n}\n\nfunction getErrorMessage(data: ParsedResponseBody, fallback: string): string {\n  if (data && typeof data === \"object\" && !Array.isArray(data)) {\n    const maybeMessage = (data as Record<string, unknown>).message;\n    if (typeof maybeMessage === \"string\" && maybeMessage.trim()) {\n      return maybeMessage;\n    }\n  }\n\n  if (typeof data === \"string\" && data.trim()) {\n    const compact = data.replace(/\\s+/g, \" \").trim();\n    const snippet = compact.length > 180 ? `${compact.slice(0, 180)}...` : compact;\n    return `${fallback}. Server returned non-JSON response: ${snippet}`;\n  }\n\n  return fallback;\n}\n","import { createClient, type RobotRock, type RobotRockConfig } from \"./client.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.robotrock.io/v1\";\n\n/**\n * Read RobotRock client config from environment variables.\n *\n * - `ROBOTROCK_API_KEY` (required when not passed explicitly)\n * - `ROBOTROCK_BASE_URL` or `ROBOTROCK_API_URL` (optional)\n * - `ROBOTROCK_APP` (optional inbox app bucket)\n */\nexport function resolveRobotRockConfig(\n  overrides?: Partial<RobotRockConfig>\n): RobotRockConfig {\n  const apiKey = overrides?.apiKey ?? process.env.ROBOTROCK_API_KEY;\n  if (!apiKey) {\n    throw new Error(\n      \"RobotRock API key is required. Set ROBOTROCK_API_KEY or pass apiKey when creating the client.\"\n    );\n  }\n\n  const baseUrl =\n    overrides?.baseUrl ??\n    process.env.ROBOTROCK_BASE_URL ??\n    process.env.ROBOTROCK_API_URL ??\n    DEFAULT_BASE_URL;\n\n  const app = overrides?.app ?? process.env.ROBOTROCK_APP;\n\n  return app ? { apiKey, baseUrl, app } : { apiKey, baseUrl };\n}\n\n/** Use an explicit client or create one from env / optional config overrides. */\nexport function resolveRobotRockClient(\n  client?: RobotRock,\n  configOverrides?: Partial<RobotRockConfig>\n): RobotRock {\n  if (client) {\n    return client;\n  }\n  return createClient(resolveRobotRockConfig(configOverrides));\n}\n"],"mappings":"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","names":[]}

package/dist/{client-BOm2Ce2f.d.ts → client-CLcHdjOz.d.ts}

@@ -1,4 +1,4 @@
-import { TaskContextInput, AssignToInput, ThreadUpdateStatus, TaskResponse, DiscriminatedApprovalResult, Task, ThreadUpdate } from './schemas/index.js';
+import { TaskContextInput, AssignToInput, TaskPriority, ThreadUpdateStatus, TaskResponse, DiscriminatedApprovalResult, Task, ThreadUpdate } from './schemas/index.js';
 
 type RobotRockWebhookConfig = {
     url: string;
@@ -59,6 +59,11 @@ type SendToHumanInput<A extends readonly SendToHumanActionInput[] = readonly Sen
      * one (returned as `task.threadId`) and reuse it on later tasks in the thread.
      */
     threadId?: string;
+    /**
+     * Optional thread priority. When set, applies to the whole thread and
+     * overwrites any previous priority. Omit on later tasks to leave unchanged.
+     */
+    priority?: TaskPriority;
     /**
      * Optional initial status update logged against the task's thread. Shows in
      * the inbox status bar and the thread update log.