robotrock 0.1.0 → 0.2.0

package/dist/trigger/index.d.ts

@@ -1,44 +1,41 @@
-import { TaskAction, TaskContextInput, DiscriminatedApprovalResult } from '@robotrock/core';
-export { ApprovalResult, DiscriminatedApprovalResult, TaskContextInput, TaskResult } from '@robotrock/core';
-import { a as RobotRock, R as RobotRockConfig } from '../client-BQ-j7q68.js';
+import * as _trigger_dev_sdk from '@trigger.dev/sdk';
+import { S as SendToHumanActionInput, a as SendToHumanInput } from '../client-agOgTJob.js';
+export { R as RobotRockHandlerWebhookPayload } from '../handler-webhook-BqEi6Bk-.js';
+export { ApprovalResult, DiscriminatedApprovalResult, TaskContextInput, TaskResult } from '../schemas/index.js';
+import 'zod';
 
+type SendToHumanPayload<A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[]> = SendToHumanInput<A> & {
+    /** Inbox app bucket. Overrides `ROBOTROCK_APP` when set. */
+    app?: string;
+};
+type ApproveByHumanPayload = Omit<SendToHumanPayload, "actions">;
 /**
- * JSON body posted by Convex when an action handler runs.
- * POSTing this to Trigger's `token.url` completes `wait.forToken`.
+ * Durable human-in-the-loop task for Trigger.dev.
+ * Re-export from your `trigger/` directory so Trigger.dev discovers it on deploy.
  */
-interface RobotRockHandlerWebhookPayload {
+declare const sendToHumanTask: _trigger_dev_sdk.Task<"robotrock/send-to-human", SendToHumanPayload<readonly SendToHumanActionInput[]>, {
     taskId: string;
-    action: {
-        id: string;
-        title: string;
-        data: unknown;
-    };
-    handledBy?: string;
-    handledAt: string;
-    handlerType: string;
-}
-interface AskHumanTriggerOptions {
-    app?: string;
-    /** Trigger waitpoint timeout (e.g. "1h", "30m", "7d"). @default "24h" */
-    timeout?: string;
-    /** Optional side-channel webhook URL (same payload as the wait token). */
-    callbackUrl?: string;
-}
-type AskHumanTriggerParams<A extends readonly TaskAction[]> = AskHumanTriggerOptions & {
-    task: Omit<TaskContextInput, "actions"> & {
-        readonly actions: A;
-    };
-    client?: RobotRock;
-    apiKey?: string;
-    baseUrl?: string;
-};
-declare function createTriggerClient(config: RobotRockConfig): RobotRock;
+    handledBy?: string | undefined;
+    handledAt: Date;
+    actionId: string;
+    data: unknown;
+}>;
 /**
- * Ask a human inside a Trigger.dev task run (waitpoint token + RobotRock handlers).
- *
- * Return type is inferred from `task.actions` (`actionId` narrows `data`).
- * Must run inside `task({ run })` with `@trigger.dev/sdk` installed.
+ * Simple approve/decline human gate for Trigger.dev.
+ * Re-export from your `trigger/` directory so Trigger.dev discovers it on deploy.
  */
-declare function askHuman<const A extends readonly TaskAction[]>(params: AskHumanTriggerParams<A>): Promise<DiscriminatedApprovalResult<A>>;
+declare const approveByHumanTask: _trigger_dev_sdk.Task<"robotrock/approve-by-human", ApproveByHumanPayload, {
+    taskId: string;
+    handledBy?: string | undefined;
+    handledAt: Date;
+    actionId: "approve";
+    data: unknown;
+} | {
+    taskId: string;
+    handledBy?: string | undefined;
+    handledAt: Date;
+    actionId: "decline";
+    data: unknown;
+}>;
 
-export { type AskHumanTriggerOptions, type AskHumanTriggerParams, RobotRockConfig, type RobotRockHandlerWebhookPayload, askHuman, createTriggerClient };
+export { type ApproveByHumanPayload, type SendToHumanPayload, approveByHumanTask, sendToHumanTask };

package/dist/trigger/index.js

@@ -1,56 +1,39 @@
+import {
+  isRobotRockHandlerWebhookPayload,
+  resolveWaitTiming
+} from "../chunk-D2FBSEZK.js";
 import {
   createClient,
-  resolveRobotRockClient,
+  resolveRobotRockConfig,
   toDiscriminatedApprovalResult
-} from "../chunk-TUQXDKV6.js";
+} from "../chunk-THVGHUTX.js";
+import "../chunk-7FVE6OYZ.js";
 
 // src/trigger/index.ts
-import { wait } from "@trigger.dev/sdk/v3";
-function createTriggerClient(config) {
-  return createClient(config);
-}
-async function askHuman(params) {
-  const {
-    task,
-    app,
-    timeout = "24h",
-    callbackUrl,
-    client: explicitClient,
-    apiKey,
-    baseUrl
-  } = params;
-  assertTriggerTimeoutFormat(timeout);
-  const client = resolveRobotRockClient(explicitClient, { apiKey, baseUrl });
+import { task, wait } from "@trigger.dev/sdk";
+var APPROVE_BY_HUMAN_ACTIONS = [
+  { id: "approve", title: "Approve" },
+  { id: "decline", title: "Decline" }
+];
+async function runSendToHuman(payload) {
+  const { validUntil: validUntilInput, ...taskInput } = payload;
+  const { validUntil, timeout } = resolveWaitTiming(validUntilInput);
   const token = await wait.createToken({ timeout });
-  const resolvedApp = app ?? task.app;
-  const taskWithHandlers = {
-    ...task,
-    ...resolvedApp !== void 0 ? { app: resolvedApp } : {},
-    actions: task.actions.map((action) => {
-      const waitHandler = {
-        type: "trigger",
-        url: token.url,
-        headers: {},
-        tokenId: token.id
-      };
-      const callbackHandlers = callbackUrl ? [
-        {
-          type: "trigger",
-          url: callbackUrl,
-          headers: {},
-          tokenId: crypto.randomUUID()
-        }
-      ] : [];
-      return {
-        ...action,
-        handlers: [waitHandler, ...action.handlers ?? [], ...callbackHandlers]
-      };
-    })
-  };
-  await client.createTask(taskWithHandlers);
+  const baseConfig = resolveRobotRockConfig();
+  const client = createClient({
+    apiKey: baseConfig.apiKey,
+    baseUrl: baseConfig.baseUrl,
+    ...baseConfig.app ? { app: baseConfig.app } : {},
+    ...baseConfig.version ? { version: baseConfig.version } : {},
+    webhook: { url: token.url }
+  });
+  const sendResult = await client.sendToHuman({
+    ...taskInput,
+    validUntil
+  });
   const outcome = await wait.forToken(token.id);
   if (!outcome.ok) {
-    throw new Error(`Human response timeout after ${timeout}`);
+    throw new Error(`Human response timed out before validUntil (${timeout})`);
   }
   const output = outcome.output;
   if (!isRobotRockHandlerWebhookPayload(output)) {
@@ -59,12 +42,12 @@ async function askHuman(params) {
     );
   }
   return toDiscriminatedApprovalResult(
-    task.actions,
+    payload.actions,
     {
       id: output.taskId,
       createdAt: /* @__PURE__ */ new Date(),
       status: "handled",
-      context: taskWithHandlers,
+      context: sendResult.task.context,
       validUntil: Date.now(),
       handledAt: new Date(output.handledAt).getTime(),
       handled: {
@@ -74,33 +57,22 @@ async function askHuman(params) {
         },
         handledBy: output.handledBy
       }
-    },
-    output.taskId
+    }
   );
 }
-function assertTriggerTimeoutFormat(timeout) {
-  const match = timeout.match(/^(\d+)(s|m|h|d)$/);
-  if (!match) {
-    throw new Error(`Invalid timeout format: ${timeout}. Use format like "1h", "30m", "7d"`);
-  }
-}
-function isRobotRockHandlerWebhookPayload(value) {
-  if (typeof value !== "object" || value === null) {
-    return false;
-  }
-  const v = value;
-  if (typeof v.taskId !== "string" || typeof v.handledAt !== "string") {
-    return false;
-  }
-  const action = v.action;
-  if (typeof action !== "object" || action === null) {
-    return false;
-  }
-  const a = action;
-  return typeof a.id === "string" && "data" in a;
-}
+var sendToHumanTask = task({
+  id: "robotrock/send-to-human",
+  run: async (payload) => runSendToHuman(payload)
+});
+var approveByHumanTask = task({
+  id: "robotrock/approve-by-human",
+  run: async (payload) => runSendToHuman({
+    ...payload,
+    actions: APPROVE_BY_HUMAN_ACTIONS
+  })
+});
 export {
-  askHuman,
-  createTriggerClient
+  approveByHumanTask,
+  sendToHumanTask
 };
 //# sourceMappingURL=index.js.map

package/dist/trigger/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/trigger/index.ts"],"sourcesContent":["import type {\n  DiscriminatedApprovalResult,\n  TaskAction,\n  TaskContextInput,\n} from \"@robotrock/core\";\nimport { wait } from \"@trigger.dev/sdk/v3\";\nimport { createClient, type RobotRock, type RobotRockConfig } from \"../client.js\";\nimport { resolveRobotRockClient } from \"../env.js\";\nimport { toDiscriminatedApprovalResult } from \"../approval-result.js\";\n\n/**\n * JSON body posted by Convex when an action handler runs.\n * POSTing this to Trigger's `token.url` completes `wait.forToken`.\n */\nexport interface RobotRockHandlerWebhookPayload {\n  taskId: string;\n  action: {\n    id: string;\n    title: string;\n    data: unknown;\n  };\n  handledBy?: string;\n  handledAt: string;\n  handlerType: string;\n}\n\nexport interface AskHumanTriggerOptions {\n  app?: string;\n  /** Trigger waitpoint timeout (e.g. \"1h\", \"30m\", \"7d\"). @default \"24h\" */\n  timeout?: string;\n  /** Optional side-channel webhook URL (same payload as the wait token). */\n  callbackUrl?: string;\n}\n\nexport type AskHumanTriggerParams<A extends readonly TaskAction[]> = AskHumanTriggerOptions & {\n  task: Omit<TaskContextInput, \"actions\"> & { readonly actions: A };\n  client?: RobotRock;\n  apiKey?: string;\n  baseUrl?: string;\n};\n\nexport function createTriggerClient(config: RobotRockConfig): RobotRock {\n  return createClient(config);\n}\n\n/**\n * Ask a human inside a Trigger.dev task run (waitpoint token + RobotRock handlers).\n *\n * Return type is inferred from `task.actions` (`actionId` narrows `data`).\n * Must run inside `task({ run })` with `@trigger.dev/sdk` installed.\n */\nexport async function askHuman<const A extends readonly TaskAction[]>(\n  params: AskHumanTriggerParams<A>\n): Promise<DiscriminatedApprovalResult<A>> {\n  const {\n    task,\n    app,\n    timeout = \"24h\",\n    callbackUrl,\n    client: explicitClient,\n    apiKey,\n    baseUrl,\n  } = params;\n\n  assertTriggerTimeoutFormat(timeout);\n\n  const client = resolveRobotRockClient(explicitClient, { apiKey, baseUrl });\n\n  const token = await wait.createToken({ timeout });\n\n  const resolvedApp = app ?? task.app;\n  const taskWithHandlers: TaskContextInput = {\n    ...task,\n    ...(resolvedApp !== undefined ? { app: resolvedApp } : {}),\n    actions: task.actions.map((action: TaskAction) => {\n      const waitHandler = {\n        type: \"trigger\" as const,\n        url: token.url,\n        headers: {} as Record<string, string>,\n        tokenId: token.id,\n      };\n      const callbackHandlers = callbackUrl\n        ? [\n            {\n              type: \"trigger\" as const,\n              url: callbackUrl,\n              headers: {} as Record<string, string>,\n              tokenId: crypto.randomUUID(),\n            },\n          ]\n        : [];\n\n      return {\n        ...action,\n        handlers: [waitHandler, ...(action.handlers ?? []), ...callbackHandlers],\n      };\n    }),\n  };\n\n  await client.createTask(taskWithHandlers);\n\n  const outcome = await wait.forToken<RobotRockHandlerWebhookPayload>(token.id);\n\n  if (!outcome.ok) {\n    throw new Error(`Human response timeout after ${timeout}`);\n  }\n\n  const output = outcome.output;\n  if (!isRobotRockHandlerWebhookPayload(output)) {\n    throw new Error(\n      \"Wait token completed with unexpected payload; expected RobotRock handler body (taskId, action.id, action.data).\"\n    );\n  }\n\n  return toDiscriminatedApprovalResult(\n    task.actions,\n    {\n      id: output.taskId,\n      createdAt: new Date(),\n      status: \"handled\",\n      context: taskWithHandlers,\n      validUntil: Date.now(),\n      handledAt: new Date(output.handledAt).getTime(),\n      handled: {\n        action: {\n          id: output.action.id,\n          data: output.action.data,\n        },\n        handledBy: output.handledBy,\n      },\n    },\n    output.taskId\n  );\n}\n\nfunction assertTriggerTimeoutFormat(timeout: string): void {\n  const match = timeout.match(/^(\\d+)(s|m|h|d)$/);\n  if (!match) {\n    throw new Error(`Invalid timeout format: ${timeout}. Use format like \"1h\", \"30m\", \"7d\"`);\n  }\n}\n\nfunction isRobotRockHandlerWebhookPayload(\n  value: unknown\n): value is RobotRockHandlerWebhookPayload {\n  if (typeof value !== \"object\" || value === null) {\n    return false;\n  }\n  const v = value as Record<string, unknown>;\n  if (typeof v.taskId !== \"string\" || typeof v.handledAt !== \"string\") {\n    return false;\n  }\n  const action = v.action;\n  if (typeof action !== \"object\" || action === null) {\n    return false;\n  }\n  const a = action as Record<string, unknown>;\n  return typeof a.id === \"string\" && \"data\" in a;\n}\n\nexport type {\n  ApprovalResult,\n  DiscriminatedApprovalResult,\n  TaskContextInput,\n  TaskResult,\n} from \"@robotrock/core\";\nexport type { RobotRockConfig } from \"../client.js\";\n"],"mappings":";;;;;;;AAKA,SAAS,YAAY;AAoCd,SAAS,oBAAoB,QAAoC;AACtE,SAAO,aAAa,MAAM;AAC5B;AAQA,eAAsB,SACpB,QACyC;AACzC,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA,UAAU;AAAA,IACV;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,EACF,IAAI;AAEJ,6BAA2B,OAAO;AAElC,QAAM,SAAS,uBAAuB,gBAAgB,EAAE,QAAQ,QAAQ,CAAC;AAEzE,QAAM,QAAQ,MAAM,KAAK,YAAY,EAAE,QAAQ,CAAC;AAEhD,QAAM,cAAc,OAAO,KAAK;AAChC,QAAM,mBAAqC;AAAA,IACzC,GAAG;AAAA,IACH,GAAI,gBAAgB,SAAY,EAAE,KAAK,YAAY,IAAI,CAAC;AAAA,IACxD,SAAS,KAAK,QAAQ,IAAI,CAAC,WAAuB;AAChD,YAAM,cAAc;AAAA,QAClB,MAAM;AAAA,QACN,KAAK,MAAM;AAAA,QACX,SAAS,CAAC;AAAA,QACV,SAAS,MAAM;AAAA,MACjB;AACA,YAAM,mBAAmB,cACrB;AAAA,QACE;AAAA,UACE,MAAM;AAAA,UACN,KAAK;AAAA,UACL,SAAS,CAAC;AAAA,UACV,SAAS,OAAO,WAAW;AAAA,QAC7B;AAAA,MACF,IACA,CAAC;AAEL,aAAO;AAAA,QACL,GAAG;AAAA,QACH,UAAU,CAAC,aAAa,GAAI,OAAO,YAAY,CAAC,GAAI,GAAG,gBAAgB;AAAA,MACzE;AAAA,IACF,CAAC;AAAA,EACH;AAEA,QAAM,OAAO,WAAW,gBAAgB;AAExC,QAAM,UAAU,MAAM,KAAK,SAAyC,MAAM,EAAE;AAE5E,MAAI,CAAC,QAAQ,IAAI;AACf,UAAM,IAAI,MAAM,gCAAgC,OAAO,EAAE;AAAA,EAC3D;AAEA,QAAM,SAAS,QAAQ;AACvB,MAAI,CAAC,iCAAiC,MAAM,GAAG;AAC7C,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,KAAK;AAAA,IACL;AAAA,MACE,IAAI,OAAO;AAAA,MACX,WAAW,oBAAI,KAAK;AAAA,MACpB,QAAQ;AAAA,MACR,SAAS;AAAA,MACT,YAAY,KAAK,IAAI;AAAA,MACrB,WAAW,IAAI,KAAK,OAAO,SAAS,EAAE,QAAQ;AAAA,MAC9C,SAAS;AAAA,QACP,QAAQ;AAAA,UACN,IAAI,OAAO,OAAO;AAAA,UAClB,MAAM,OAAO,OAAO;AAAA,QACtB;AAAA,QACA,WAAW,OAAO;AAAA,MACpB;AAAA,IACF;AAAA,IACA,OAAO;AAAA,EACT;AACF;AAEA,SAAS,2BAA2B,SAAuB;AACzD,QAAM,QAAQ,QAAQ,MAAM,kBAAkB;AAC9C,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,2BAA2B,OAAO,qCAAqC;AAAA,EACzF;AACF;AAEA,SAAS,iCACP,OACyC;AACzC,MAAI,OAAO,UAAU,YAAY,UAAU,MAAM;AAC/C,WAAO;AAAA,EACT;AACA,QAAM,IAAI;AACV,MAAI,OAAO,EAAE,WAAW,YAAY,OAAO,EAAE,cAAc,UAAU;AACnE,WAAO;AAAA,EACT;AACA,QAAM,SAAS,EAAE;AACjB,MAAI,OAAO,WAAW,YAAY,WAAW,MAAM;AACjD,WAAO;AAAA,EACT;AACA,QAAM,IAAI;AACV,SAAO,OAAO,EAAE,OAAO,YAAY,UAAU;AAC/C;","names":[]}
+{"version":3,"sources":["../../src/trigger/index.ts"],"sourcesContent":["import type { DiscriminatedApprovalResult } from \"../schemas/index.js\";\nimport { task, wait } from \"@trigger.dev/sdk\";\nimport {\n  createClient,\n  type SendToHumanActionInput,\n  type SendToHumanInput,\n} from \"../client.js\";\nimport { resolveRobotRockConfig } from \"../env.js\";\nimport { toDiscriminatedApprovalResult } from \"../approval-result.js\";\nimport {\n  isRobotRockHandlerWebhookPayload,\n  type RobotRockHandlerWebhookPayload,\n} from \"../handler-webhook.js\";\nimport { resolveWaitTiming } from \"../wait-timing.js\";\n\nexport type { RobotRockHandlerWebhookPayload } from \"../handler-webhook.js\";\n\nexport type SendToHumanPayload<\n  A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[],\n> = SendToHumanInput<A> & {\n  /** Inbox app bucket. Overrides `ROBOTROCK_APP` when set. */\n  app?: string;\n};\n\nexport type ApproveByHumanPayload = Omit<SendToHumanPayload, \"actions\">;\n\ntype Expand<T> = T extends unknown ? { [K in keyof T]: T[K] } : never;\n\nconst APPROVE_BY_HUMAN_ACTIONS = [\n  { id: \"approve\", title: \"Approve\" },\n  { id: \"decline\", title: \"Decline\" },\n] as const;\n\nasync function runSendToHuman<const A extends readonly SendToHumanActionInput[]>(\n  payload: SendToHumanPayload<A>\n): Promise<Expand<DiscriminatedApprovalResult<A>>> {\n  const { validUntil: validUntilInput, ...taskInput } = payload;\n  const { validUntil, timeout } = resolveWaitTiming(validUntilInput);\n\n  const token = await wait.createToken({ timeout });\n\n  const baseConfig = resolveRobotRockConfig();\n  const client = createClient({\n    apiKey: baseConfig.apiKey,\n    baseUrl: baseConfig.baseUrl,\n    ...(baseConfig.app ? { app: baseConfig.app } : {}),\n    ...(baseConfig.version ? { version: baseConfig.version } : {}),\n    webhook: { url: token.url },\n  });\n\n  const sendResult = await client.sendToHuman({\n    ...taskInput,\n    validUntil,\n  });\n\n  const outcome = await wait.forToken<RobotRockHandlerWebhookPayload>(token.id);\n\n  if (!outcome.ok) {\n    throw new Error(`Human response timed out before validUntil (${timeout})`);\n  }\n\n  const output = outcome.output;\n  if (!isRobotRockHandlerWebhookPayload(output)) {\n    throw new Error(\n      \"Wait token completed with unexpected payload; expected RobotRock handler body (taskId, action.id, action.data).\"\n    );\n  }\n\n  return toDiscriminatedApprovalResult(\n    payload.actions,\n    {\n      id: output.taskId,\n      createdAt: new Date(),\n      status: \"handled\",\n      context: sendResult.task.context,\n      validUntil: Date.now(),\n      handledAt: new Date(output.handledAt).getTime(),\n      handled: {\n        action: {\n          id: output.action.id,\n          data: output.action.data,\n        },\n        handledBy: output.handledBy,\n      },\n    }\n  ) as unknown as Expand<DiscriminatedApprovalResult<A>>;\n}\n\n/**\n * Durable human-in-the-loop task for Trigger.dev.\n * Re-export from your `trigger/` directory so Trigger.dev discovers it on deploy.\n */\nexport const sendToHumanTask = task({\n  id: \"robotrock/send-to-human\",\n  run: async (payload: SendToHumanPayload) => runSendToHuman(payload),\n});\n\n/**\n * Simple approve/decline human gate for Trigger.dev.\n * Re-export from your `trigger/` directory so Trigger.dev discovers it on deploy.\n */\nexport const approveByHumanTask = task({\n  id: \"robotrock/approve-by-human\",\n  run: async (payload: ApproveByHumanPayload) =>\n    runSendToHuman({\n      ...payload,\n      actions: APPROVE_BY_HUMAN_ACTIONS,\n    }),\n});\n\nexport type {\n  ApprovalResult,\n  DiscriminatedApprovalResult,\n  TaskContextInput,\n  TaskResult,\n} from \"../schemas/index.js\";\n"],"mappings":";;;;;;;;;;;;AACA,SAAS,MAAM,YAAY;AA2B3B,IAAM,2BAA2B;AAAA,EAC/B,EAAE,IAAI,WAAW,OAAO,UAAU;AAAA,EAClC,EAAE,IAAI,WAAW,OAAO,UAAU;AACpC;AAEA,eAAe,eACb,SACiD;AACjD,QAAM,EAAE,YAAY,iBAAiB,GAAG,UAAU,IAAI;AACtD,QAAM,EAAE,YAAY,QAAQ,IAAI,kBAAkB,eAAe;AAEjE,QAAM,QAAQ,MAAM,KAAK,YAAY,EAAE,QAAQ,CAAC;AAEhD,QAAM,aAAa,uBAAuB;AAC1C,QAAM,SAAS,aAAa;AAAA,IAC1B,QAAQ,WAAW;AAAA,IACnB,SAAS,WAAW;AAAA,IACpB,GAAI,WAAW,MAAM,EAAE,KAAK,WAAW,IAAI,IAAI,CAAC;AAAA,IAChD,GAAI,WAAW,UAAU,EAAE,SAAS,WAAW,QAAQ,IAAI,CAAC;AAAA,IAC5D,SAAS,EAAE,KAAK,MAAM,IAAI;AAAA,EAC5B,CAAC;AAED,QAAM,aAAa,MAAM,OAAO,YAAY;AAAA,IAC1C,GAAG;AAAA,IACH;AAAA,EACF,CAAC;AAED,QAAM,UAAU,MAAM,KAAK,SAAyC,MAAM,EAAE;AAE5E,MAAI,CAAC,QAAQ,IAAI;AACf,UAAM,IAAI,MAAM,+CAA+C,OAAO,GAAG;AAAA,EAC3E;AAEA,QAAM,SAAS,QAAQ;AACvB,MAAI,CAAC,iCAAiC,MAAM,GAAG;AAC7C,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,QAAQ;AAAA,IACR;AAAA,MACE,IAAI,OAAO;AAAA,MACX,WAAW,oBAAI,KAAK;AAAA,MACpB,QAAQ;AAAA,MACR,SAAS,WAAW,KAAK;AAAA,MACzB,YAAY,KAAK,IAAI;AAAA,MACrB,WAAW,IAAI,KAAK,OAAO,SAAS,EAAE,QAAQ;AAAA,MAC9C,SAAS;AAAA,QACP,QAAQ;AAAA,UACN,IAAI,OAAO,OAAO;AAAA,UAClB,MAAM,OAAO,OAAO;AAAA,QACtB;AAAA,QACA,WAAW,OAAO;AAAA,MACpB;AAAA,IACF;AAAA,EACF;AACF;AAMO,IAAM,kBAAkB,KAAK;AAAA,EAClC,IAAI;AAAA,EACJ,KAAK,OAAO,YAAgC,eAAe,OAAO;AACpE,CAAC;AAMM,IAAM,qBAAqB,KAAK;AAAA,EACrC,IAAI;AAAA,EACJ,KAAK,OAAO,YACV,eAAe;AAAA,IACb,GAAG;AAAA,IACH,SAAS;AAAA,EACX,CAAC;AACL,CAAC;","names":[]}

package/dist/workflow/index.d.ts

@@ -0,0 +1,35 @@
+import { DiscriminatedApprovalResult } from '../schemas/index.js';
+export { ApprovalResult, TaskContextInput, TaskResult } from '../schemas/index.js';
+import { S as SendToHumanActionInput, a as SendToHumanInput } from '../client-agOgTJob.js';
+export { R as RobotRockHandlerWebhookPayload } from '../handler-webhook-BqEi6Bk-.js';
+import 'zod';
+
+type SendToHumanWorkflowPayload<A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[]> = SendToHumanInput<A> & {
+    /** Inbox app bucket. Overrides `ROBOTROCK_APP` when set. */
+    app?: string;
+};
+type ApproveByHumanWorkflowPayload = Omit<SendToHumanWorkflowPayload, "actions">;
+type Expand<T> = T extends unknown ? {
+    [K in keyof T]: T[K];
+} : never;
+declare const APPROVE_BY_HUMAN_ACTIONS: readonly [{
+    readonly id: "approve";
+    readonly title: "Approve";
+}, {
+    readonly id: "decline";
+    readonly title: "Decline";
+}];
+/**
+ * Durable human-in-the-loop wait for Vercel Workflow.
+ *
+ * Call from a function with `"use workflow"` as its first statement. Creates a
+ * {@link createWebhook} URL, registers it as the RobotRock task webhook, and
+ * suspends until a human handles an action or `validUntil` passes.
+ */
+declare function sendToHumanInWorkflow<const A extends readonly SendToHumanActionInput[]>(payload: SendToHumanWorkflowPayload<A>): Promise<Expand<DiscriminatedApprovalResult<A>>>;
+/**
+ * Approve / decline gate for Vercel Workflow (`sendToHumanInWorkflow` with fixed actions).
+ */
+declare function approveByHumanInWorkflow(payload: ApproveByHumanWorkflowPayload): Promise<Expand<DiscriminatedApprovalResult<typeof APPROVE_BY_HUMAN_ACTIONS>>>;
+
+export { type ApproveByHumanWorkflowPayload, DiscriminatedApprovalResult, type SendToHumanWorkflowPayload, approveByHumanInWorkflow, sendToHumanInWorkflow };

package/dist/workflow/index.js

@@ -0,0 +1,99 @@
+import {
+  isRobotRockHandlerWebhookPayload,
+  parseValidUntilMs,
+  resolveWaitTiming
+} from "../chunk-D2FBSEZK.js";
+import {
+  createClient,
+  resolveRobotRockConfig,
+  toDiscriminatedApprovalResult
+} from "../chunk-THVGHUTX.js";
+import {
+  __callDispose,
+  __using
+} from "../chunk-7FVE6OYZ.js";
+
+// src/workflow/index.ts
+import { createWebhook, sleep } from "workflow";
+var APPROVE_BY_HUMAN_ACTIONS = [
+  { id: "approve", title: "Approve" },
+  { id: "decline", title: "Decline" }
+];
+async function createRobotRockTaskForWebhook(input) {
+  "use step";
+  const baseConfig = resolveRobotRockConfig();
+  const client = createClient({
+    apiKey: baseConfig.apiKey,
+    baseUrl: baseConfig.baseUrl,
+    ...input.app ?? baseConfig.app ? { app: input.app ?? baseConfig.app } : {},
+    ...baseConfig.version ? { version: baseConfig.version } : {},
+    webhook: { url: input.webhookUrl }
+  });
+  return client.sendToHuman({
+    ...input.taskInput,
+    validUntil: input.validUntil
+  });
+}
+async function parseRobotRockWebhookRequest(request) {
+  "use step";
+  const body = await request.json();
+  if (!isRobotRockHandlerWebhookPayload(body)) {
+    throw new Error(
+      "Workflow webhook completed with unexpected payload; expected RobotRock handler body (taskId, action.id, action.data)."
+    );
+  }
+  return body;
+}
+async function sendToHumanInWorkflow(payload) {
+  var _stack = [];
+  try {
+    const { validUntil: validUntilInput, app, ...taskInput } = payload;
+    const { validUntil, timeout } = resolveWaitTiming(validUntilInput);
+    const timeoutMs = parseValidUntilMs(validUntil) - Date.now();
+    const webhook = __using(_stack, createWebhook());
+    const sendResult = await createRobotRockTaskForWebhook({
+      webhookUrl: webhook.url,
+      app,
+      validUntil,
+      taskInput
+    });
+    const outcome = await Promise.race([
+      webhook.then((request) => parseRobotRockWebhookRequest(request)),
+      sleep(timeoutMs).then(() => ({ timedOut: true }))
+    ]);
+    if ("timedOut" in outcome) {
+      throw new Error(`Human response timed out before validUntil (${timeout})`);
+    }
+    const output = outcome;
+    return toDiscriminatedApprovalResult(payload.actions, {
+      id: output.taskId,
+      createdAt: /* @__PURE__ */ new Date(),
+      status: "handled",
+      context: sendResult.task.context,
+      validUntil: Date.now(),
+      handledAt: new Date(output.handledAt).getTime(),
+      handled: {
+        action: {
+          id: output.action.id,
+          data: output.action.data
+        },
+        handledBy: output.handledBy
+      }
+    });
+  } catch (_) {
+    var _error = _, _hasError = true;
+  } finally {
+    __callDispose(_stack, _error, _hasError);
+  }
+}
+async function approveByHumanInWorkflow(payload) {
+  return sendToHumanInWorkflow({
+    ...payload,
+    actions: APPROVE_BY_HUMAN_ACTIONS
+  });
+}
+export {
+  approveByHumanInWorkflow,
+  sendToHumanInWorkflow
+};
+//# sourceMappingURL=index.js.map

package/dist/workflow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/workflow/index.ts"],"sourcesContent":["import { createWebhook, sleep } from \"workflow\";\nimport type { DiscriminatedApprovalResult } from \"../schemas/index.js\";\nimport {\n  createClient,\n  type SendToHumanActionInput,\n  type SendToHumanInput,\n} from \"../client.js\";\nimport { resolveRobotRockConfig } from \"../env.js\";\nimport { toDiscriminatedApprovalResult } from \"../approval-result.js\";\nimport {\n  isRobotRockHandlerWebhookPayload,\n  type RobotRockHandlerWebhookPayload,\n} from \"../handler-webhook.js\";\nimport { parseValidUntilMs, resolveWaitTiming } from \"../wait-timing.js\";\n\nexport type SendToHumanWorkflowPayload<\n  A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[],\n> = SendToHumanInput<A> & {\n  /** Inbox app bucket. Overrides `ROBOTROCK_APP` when set. */\n  app?: string;\n};\n\nexport type ApproveByHumanWorkflowPayload = Omit<SendToHumanWorkflowPayload, \"actions\">;\n\ntype Expand<T> = T extends unknown ? { [K in keyof T]: T[K] } : never;\n\nconst APPROVE_BY_HUMAN_ACTIONS = [\n  { id: \"approve\", title: \"Approve\" },\n  { id: \"decline\", title: \"Decline\" },\n] as const;\n\ntype CreateTaskStepInput = {\n  webhookUrl: string;\n  app?: string;\n  validUntil: Date | string;\n  taskInput: Omit<SendToHumanWorkflowPayload, \"validUntil\" | \"app\">;\n};\n\n/**\n * Creates the RobotRock inbox task with the workflow webhook URL as the handler.\n * Marked as a step so API calls run in full Node.js with retries.\n */\nasync function createRobotRockTaskForWebhook(input: CreateTaskStepInput) {\n  \"use step\";\n\n  const baseConfig = resolveRobotRockConfig();\n  const client = createClient({\n    apiKey: baseConfig.apiKey,\n    baseUrl: baseConfig.baseUrl,\n    ...((input.app ?? baseConfig.app) ? { app: input.app ?? baseConfig.app } : {}),\n    ...(baseConfig.version ? { version: baseConfig.version } : {}),\n    webhook: { url: input.webhookUrl },\n  });\n\n  return client.sendToHuman({\n    ...input.taskInput,\n    validUntil: input.validUntil,\n  });\n}\n\nasync function parseRobotRockWebhookRequest(request: Request) {\n  \"use step\";\n\n  const body: unknown = await request.json();\n  if (!isRobotRockHandlerWebhookPayload(body)) {\n    throw new Error(\n      \"Workflow webhook completed with unexpected payload; expected RobotRock handler body (taskId, action.id, action.data).\"\n    );\n  }\n\n  return body;\n}\n\n/**\n * Durable human-in-the-loop wait for Vercel Workflow.\n *\n * Call from a function with `\"use workflow\"` as its first statement. Creates a\n * {@link createWebhook} URL, registers it as the RobotRock task webhook, and\n * suspends until a human handles an action or `validUntil` passes.\n */\nexport async function sendToHumanInWorkflow<\n  const A extends readonly SendToHumanActionInput[],\n>(\n  payload: SendToHumanWorkflowPayload<A>\n): Promise<Expand<DiscriminatedApprovalResult<A>>> {\n  const { validUntil: validUntilInput, app, ...taskInput } = payload;\n  const { validUntil, timeout } = resolveWaitTiming(validUntilInput);\n  const timeoutMs = parseValidUntilMs(validUntil) - Date.now();\n\n  using webhook = createWebhook();\n\n  const sendResult = await createRobotRockTaskForWebhook({\n    webhookUrl: webhook.url,\n    app,\n    validUntil,\n    taskInput,\n  });\n\n  const outcome = await Promise.race([\n    webhook.then((request) => parseRobotRockWebhookRequest(request)),\n    sleep(timeoutMs).then(() => ({ timedOut: true }) as const),\n  ]);\n\n  if (\"timedOut\" in outcome) {\n    throw new Error(`Human response timed out before validUntil (${timeout})`);\n  }\n\n  const output: RobotRockHandlerWebhookPayload = outcome;\n\n  return toDiscriminatedApprovalResult(payload.actions, {\n    id: output.taskId,\n    createdAt: new Date(),\n    status: \"handled\",\n    context: sendResult.task.context,\n    validUntil: Date.now(),\n    handledAt: new Date(output.handledAt).getTime(),\n    handled: {\n      action: {\n        id: output.action.id,\n        data: output.action.data,\n      },\n      handledBy: output.handledBy,\n    },\n  }) as unknown as Expand<DiscriminatedApprovalResult<A>>;\n}\n\n/**\n * Approve / decline gate for Vercel Workflow (`sendToHumanInWorkflow` with fixed actions).\n */\nexport async function approveByHumanInWorkflow(\n  payload: ApproveByHumanWorkflowPayload\n): Promise<Expand<DiscriminatedApprovalResult<typeof APPROVE_BY_HUMAN_ACTIONS>>> {\n  return sendToHumanInWorkflow({\n    ...payload,\n    actions: APPROVE_BY_HUMAN_ACTIONS,\n  });\n}\n\nexport type { RobotRockHandlerWebhookPayload } from \"../handler-webhook.js\";\nexport type {\n  ApprovalResult,\n  DiscriminatedApprovalResult,\n  TaskContextInput,\n  TaskResult,\n} from \"../schemas/index.js\";\n"],"mappings":";;;;;;;;;;;;;;;;AAAA,SAAS,eAAe,aAAa;AA0BrC,IAAM,2BAA2B;AAAA,EAC/B,EAAE,IAAI,WAAW,OAAO,UAAU;AAAA,EAClC,EAAE,IAAI,WAAW,OAAO,UAAU;AACpC;AAaA,eAAe,8BAA8B,OAA4B;AACvE;AAEA,QAAM,aAAa,uBAAuB;AAC1C,QAAM,SAAS,aAAa;AAAA,IAC1B,QAAQ,WAAW;AAAA,IACnB,SAAS,WAAW;AAAA,IACpB,GAAK,MAAM,OAAO,WAAW,MAAO,EAAE,KAAK,MAAM,OAAO,WAAW,IAAI,IAAI,CAAC;AAAA,IAC5E,GAAI,WAAW,UAAU,EAAE,SAAS,WAAW,QAAQ,IAAI,CAAC;AAAA,IAC5D,SAAS,EAAE,KAAK,MAAM,WAAW;AAAA,EACnC,CAAC;AAED,SAAO,OAAO,YAAY;AAAA,IACxB,GAAG,MAAM;AAAA,IACT,YAAY,MAAM;AAAA,EACpB,CAAC;AACH;AAEA,eAAe,6BAA6B,SAAkB;AAC5D;AAEA,QAAM,OAAgB,MAAM,QAAQ,KAAK;AACzC,MAAI,CAAC,iCAAiC,IAAI,GAAG;AAC3C,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AASA,eAAsB,sBAGpB,SACiD;AAKjD;AAAA;AAJA,UAAM,EAAE,YAAY,iBAAiB,KAAK,GAAG,UAAU,IAAI;AAC3D,UAAM,EAAE,YAAY,QAAQ,IAAI,kBAAkB,eAAe;AACjE,UAAM,YAAY,kBAAkB,UAAU,IAAI,KAAK,IAAI;AAE3D,UAAM,UAAU,8BAAc;AAE9B,UAAM,aAAa,MAAM,8BAA8B;AAAA,MACrD,YAAY,QAAQ;AAAA,MACpB;AAAA,MACA;AAAA,MACA;AAAA,IACF,CAAC;AAED,UAAM,UAAU,MAAM,QAAQ,KAAK;AAAA,MACjC,QAAQ,KAAK,CAAC,YAAY,6BAA6B,OAAO,CAAC;AAAA,MAC/D,MAAM,SAAS,EAAE,KAAK,OAAO,EAAE,UAAU,KAAK,EAAW;AAAA,IAC3D,CAAC;AAED,QAAI,cAAc,SAAS;AACzB,YAAM,IAAI,MAAM,+CAA+C,OAAO,GAAG;AAAA,IAC3E;AAEA,UAAM,SAAyC;AAE/C,WAAO,8BAA8B,QAAQ,SAAS;AAAA,MACpD,IAAI,OAAO;AAAA,MACX,WAAW,oBAAI,KAAK;AAAA,MACpB,QAAQ;AAAA,MACR,SAAS,WAAW,KAAK;AAAA,MACzB,YAAY,KAAK,IAAI;AAAA,MACrB,WAAW,IAAI,KAAK,OAAO,SAAS,EAAE,QAAQ;AAAA,MAC9C,SAAS;AAAA,QACP,QAAQ;AAAA,UACN,IAAI,OAAO,OAAO;AAAA,UAClB,MAAM,OAAO,OAAO;AAAA,QACtB;AAAA,QACA,WAAW,OAAO;AAAA,MACpB;AAAA,IACF,CAAC;AAAA,WAlCD;AAAA;AAAA;AAAA;AAAA;AAmCF;AAKA,eAAsB,yBACpB,SAC+E;AAC/E,SAAO,sBAAsB;AAAA,IAC3B,GAAG;AAAA,IACH,SAAS;AAAA,EACX,CAAC;AACH;","names":[]}