robotrock 0.1.0 → 0.2.0

package/dist/chunk-THVGHUTX.js

@@ -0,0 +1,330 @@
+import {
+  createTaskBodySchema
+} from "./chunk-7FVE6OYZ.js";
+
+// src/approval-result.ts
+var TaskTimeoutError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "TaskTimeoutError";
+  }
+};
+var TaskExpiredError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "TaskExpiredError";
+  }
+};
+function toDiscriminatedApprovalResult(actions, task) {
+  void actions;
+  if (!task.handled) {
+    throw new Error("Task has no handled result");
+  }
+  return {
+    actionId: task.handled.action.id,
+    data: task.handled.action.data,
+    handledBy: task.handled.handledBy,
+    handledAt: new Date(task.handledAt ?? Date.now()),
+    taskId: task.id
+  };
+}
+
+// src/client.ts
+var DEFAULT_POLL_INTERVAL_MS = 2e3;
+var DEFAULT_TIMEOUT_MS = 24 * 60 * 60 * 1e3;
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function parseValidUntilMs(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (value instanceof Date) {
+    const ms = value.getTime();
+    return Number.isNaN(ms) ? void 0 : ms;
+  }
+  if (typeof value === "number") {
+    return Number.isFinite(value) ? value : void 0;
+  }
+  const parsed = Date.parse(value);
+  return Number.isNaN(parsed) ? void 0 : parsed;
+}
+function serializeValidUntil(value) {
+  if (value instanceof Date) {
+    const ms = value.getTime();
+    if (Number.isNaN(ms)) {
+      throw new RobotRockError("Invalid validUntil: Date is invalid", 400);
+    }
+    return value.toISOString();
+  }
+  if (typeof value === "string" && !Number.isNaN(Date.parse(value))) {
+    return new Date(value).toISOString();
+  }
+  throw new RobotRockError("Invalid validUntil: expected a Date or parseable date string", 400);
+}
+var RobotRockError = class extends Error {
+  constructor(message, statusCode, response) {
+    super(message);
+    this.statusCode = statusCode;
+    this.response = response;
+    this.name = "RobotRockError";
+  }
+};
+var RobotRock = class {
+  apiKey;
+  baseUrl;
+  app;
+  version;
+  webhook;
+  polling;
+  constructor(config) {
+    if (config.webhook && config.polling) {
+      throw new Error(
+        "RobotRock client cannot configure both webhook and polling. Use webhook for callbacks or polling to block until handled."
+      );
+    }
+    const apiKey = config.apiKey ?? process.env.ROBOTROCK_API_KEY;
+    if (!apiKey) {
+      throw new Error(
+        "RobotRock API key is required. Set ROBOTROCK_API_KEY or pass apiKey when creating the client."
+      );
+    }
+    this.apiKey = apiKey;
+    const rawBase = config.baseUrl ?? "https://api.robotrock.com/v1";
+    this.baseUrl = rawBase.replace(/\/+$/, "");
+    this.app = config.app;
+    this.version = config.version ?? 2;
+    this.webhook = config.webhook;
+    this.polling = config.polling ?? {};
+  }
+  /**
+   * Create a task via POST /v1 without waiting for a human response.
+   */
+  async createTask(task) {
+    const normalizedTask = normalizeSendToHumanInput(task, {
+      webhook: this.webhook,
+      app: this.app,
+      version: this.version
+    });
+    const bodyPayload = {
+      ...normalizedTask,
+      ...task.assignTo !== void 0 ? { assignTo: task.assignTo } : {}
+    };
+    const validation = createTaskBodySchema.safeParse(bodyPayload);
+    if (!validation.success) {
+      throw new RobotRockError(
+        `Invalid task: ${validation.error.errors[0]?.message}`,
+        400,
+        validation.error.errors
+      );
+    }
+    const headers = {
+      "Content-Type": "application/json",
+      "X-Api-Key": this.apiKey
+    };
+    if (task.idempotencyKey) {
+      headers["Idempotency-Key"] = task.idempotencyKey;
+    }
+    const response = await fetch(`${this.baseUrl}/`, {
+      method: "POST",
+      headers,
+      body: JSON.stringify(validation.data)
+    });
+    const data = await parseResponseBody(response);
+    if (!response.ok) {
+      throw new RobotRockError(
+        getErrorMessage(data, "Failed to create task"),
+        response.status,
+        data
+      );
+    }
+    return data.task;
+  }
+  async sendToHuman(task) {
+    const normalizedTask = normalizeSendToHumanInput(task, {
+      webhook: this.webhook,
+      app: this.app,
+      version: this.version
+    });
+    const createdTaskTask = await this.createTask(task);
+    const hasHandlers = normalizedTask.actions.some(
+      (action) => Array.isArray(action.handlers) && action.handlers.length > 0
+    );
+    if (hasHandlers) {
+      return {
+        mode: "created",
+        task: createdTaskTask
+      };
+    }
+    const timeoutMs = this.polling.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const pollIntervalMs = this.polling.intervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const pollingDeadline = Date.now() + timeoutMs;
+    const validUntilMs = parseValidUntilMs(createdTaskTask.validUntil);
+    const deadline = validUntilMs !== void 0 ? Math.min(pollingDeadline, validUntilMs) : pollingDeadline;
+    const taskId = createdTaskTask.taskId;
+    while (Date.now() < deadline) {
+      const existing = await this.getTask(taskId);
+      if (existing?.status === "handled" && existing.handled) {
+        return {
+          mode: "handled",
+          task: createdTaskTask,
+          ...toDiscriminatedApprovalResult(
+            normalizedTask.actions,
+            existing
+          )
+        };
+      }
+      if (existing?.status === "expired" || existing && Date.now() >= existing.validUntil) {
+        throw new TaskExpiredError("Task reached validUntil before a human completed it");
+      }
+      const remainingMs = deadline - Date.now();
+      await sleep(Math.min(pollIntervalMs, Math.max(0, remainingMs)));
+    }
+    if (validUntilMs !== void 0 && Date.now() >= validUntilMs) {
+      throw new TaskExpiredError("Task reached validUntil before a human completed it");
+    }
+    throw new TaskTimeoutError(`No human response within ${timeoutMs}ms`);
+  }
+  /**
+   * Get a task by public task id (returned as `task.taskId` from {@link sendToHuman}).
+   */
+  async getTask(taskId) {
+    const response = await fetch(`${this.baseUrl}/tasks/${taskId}`, {
+      method: "GET",
+      headers: {
+        "X-Api-Key": this.apiKey
+      }
+    });
+    if (response.status === 404) {
+      return null;
+    }
+    const data = await parseResponseBody(response);
+    if (!response.ok) {
+      throw new RobotRockError(
+        getErrorMessage(data, "Failed to get task"),
+        response.status,
+        data
+      );
+    }
+    return data;
+  }
+  async cancelTask(taskId) {
+    const response = await fetch(`${this.baseUrl}/tasks/${taskId}/cancel`, {
+      method: "POST",
+      headers: {
+        "X-Api-Key": this.apiKey
+      }
+    });
+    if (!response.ok) {
+      const data = await parseResponseBody(response);
+      throw new RobotRockError(
+        getErrorMessage(data, "Failed to cancel task"),
+        response.status,
+        data
+      );
+    }
+  }
+};
+function createClient(config) {
+  return new RobotRock(config);
+}
+function attachWebhookToActions(actions, webhook) {
+  return actions.map((action) => ({
+    ...action,
+    handlers: webhookToHandlers(webhook)
+  }));
+}
+function webhookToHandlers(webhook) {
+  return [
+    {
+      type: "webhook",
+      url: webhook.url,
+      headers: webhook.headers ?? {}
+    }
+  ];
+}
+function normalizeSendToHumanInput(task, clientDefaults) {
+  const {
+    actions,
+    idempotencyKey: _idempotencyKey,
+    assignTo: _assignTo,
+    validUntil,
+    app: taskApp,
+    ...rest
+  } = task;
+  const webhook = clientDefaults.webhook;
+  const normalizedActions = webhook ? attachWebhookToActions(actions, webhook) : actions;
+  const app = taskApp ?? clientDefaults.app;
+  return {
+    ...rest,
+    version: clientDefaults.version,
+    ...app ? { app } : {},
+    ...validUntil !== void 0 ? { validUntil: serializeValidUntil(validUntil) } : {},
+    actions: normalizedActions
+  };
+}
+async function parseResponseBody(response) {
+  const contentType = response.headers.get("content-type") ?? "";
+  const bodyText = await response.text();
+  if (!bodyText) {
+    return null;
+  }
+  if (contentType.toLowerCase().includes("application/json")) {
+    try {
+      return JSON.parse(bodyText);
+    } catch {
+    }
+  }
+  try {
+    return JSON.parse(bodyText);
+  } catch {
+    return bodyText;
+  }
+}
+function getErrorMessage(data, fallback) {
+  if (data && typeof data === "object" && !Array.isArray(data)) {
+    const maybeMessage = data.message;
+    if (typeof maybeMessage === "string" && maybeMessage.trim()) {
+      return maybeMessage;
+    }
+  }
+  if (typeof data === "string" && data.trim()) {
+    const compact = data.replace(/\s+/g, " ").trim();
+    const snippet = compact.length > 180 ? `${compact.slice(0, 180)}...` : compact;
+    return `${fallback}. Server returned non-JSON response: ${snippet}`;
+  }
+  return fallback;
+}
+
+// src/env.ts
+var DEFAULT_BASE_URL = "https://api.robotrock.com/v1";
+function resolveRobotRockConfig(overrides) {
+  const apiKey = overrides?.apiKey ?? process.env.ROBOTROCK_API_KEY;
+  if (!apiKey) {
+    throw new Error(
+      "RobotRock API key is required. Set ROBOTROCK_API_KEY or pass apiKey when creating the client."
+    );
+  }
+  const baseUrl = overrides?.baseUrl ?? process.env.ROBOTROCK_BASE_URL ?? process.env.ROBOTROCK_API_URL ?? DEFAULT_BASE_URL;
+  const app = overrides?.app ?? process.env.ROBOTROCK_APP;
+  return app ? { apiKey, baseUrl, app } : { apiKey, baseUrl };
+}
+function resolveRobotRockClient(client, configOverrides) {
+  if (client) {
+    return client;
+  }
+  return createClient(resolveRobotRockConfig(configOverrides));
+}
+
+export {
+  TaskTimeoutError,
+  TaskExpiredError,
+  toDiscriminatedApprovalResult,
+  RobotRockError,
+  RobotRock,
+  createClient,
+  attachWebhookToActions,
+  resolveRobotRockConfig,
+  resolveRobotRockClient
+};
+//# sourceMappingURL=chunk-THVGHUTX.js.map

package/dist/chunk-THVGHUTX.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} from \"./schemas/index.js\";\nimport {\n  TaskExpiredError,\n  TaskTimeoutError,\n  toDiscriminatedApprovalResult,\n} from \"./approval-result.js\";\nimport type { DiscriminatedApprovalResult, Task, TaskResponse } 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.com/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\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 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.com/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    };\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  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    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.com/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-agOgTJob.d.ts

@@ -0,0 +1,99 @@
+import { TaskContextInput, AssignToInput, TaskResponse, DiscriminatedApprovalResult, Task } from './schemas/index.js';
+
+type RobotRockWebhookConfig = {
+    url: string;
+    headers?: Record<string, string>;
+};
+interface RobotRockPollingOptions {
+    /** Poll interval when no webhook is configured (ms). @default 2000 */
+    intervalMs?: number;
+    /**
+     * Max time to poll when no webhook is configured (ms).
+     * Polling also stops when the task's `validUntil` passes, whichever is sooner.
+     * @default 86400000 (24h)
+     */
+    timeoutMs?: number;
+}
+type RobotRockClientBaseConfig = {
+    /** Optional override for API key. Falls back to ROBOTROCK_API_KEY. */
+    apiKey?: string;
+    /**
+     * Base URL for the RobotRock API
+     * @default "https://api.robotrock.com/v1"
+     */
+    baseUrl?: string;
+    /**
+     * Default inbox app bucket for every task from this client.
+     * When omitted, the API uses your API key name.
+     */
+    app?: string;
+    /**
+     * Task context format version sent on every `sendToHuman` request.
+     * @default 2
+     */
+    version?: 2;
+};
+/** Client config with a webhook (mutually exclusive with `polling`). */
+type RobotRockWebhookClientConfig = RobotRockClientBaseConfig & {
+    webhook: RobotRockWebhookConfig;
+    polling?: never;
+};
+/** Client config without a webhook; optional `polling` controls the wait loop. */
+type RobotRockPollingClientConfig = RobotRockClientBaseConfig & {
+    webhook?: never;
+    polling?: RobotRockPollingOptions;
+};
+type RobotRockConfig = RobotRockWebhookClientConfig | RobotRockPollingClientConfig;
+type SendToHumanActionInput = Omit<TaskContextInput["actions"][number], "handlers">;
+type SendToHumanValidUntil = Date | string;
+type SendToHumanInput<A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[]> = Omit<TaskContextInput, "app" | "actions" | "version" | "validUntil"> & {
+    actions: A;
+    /** Task deadline; serialized to an ISO 8601 string on the wire. */
+    validUntil?: SendToHumanValidUntil;
+    /** Optional idempotency key to prevent duplicate tasks */
+    idempotencyKey?: string;
+    /** Assign to tenant users (email) and/or groups (slug). Narrows inbox visibility. */
+    assignTo?: AssignToInput;
+};
+type SendToHumanWithAppInput<A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[]> = (SendToHumanInput<A> | Readonly<SendToHumanInput<A>>) & {
+    /** Inbox app bucket. Overrides the client `app` when set. */
+    app?: string;
+};
+type SendToHumanResult<A extends readonly SendToHumanActionInput[] = readonly SendToHumanActionInput[]> = {
+    mode: "created";
+    task: TaskResponse["task"];
+} | ({
+    mode: "handled";
+    task: TaskResponse["task"];
+} & DiscriminatedApprovalResult<A>);
+declare class RobotRockError extends Error {
+    readonly statusCode: number;
+    readonly response?: unknown | undefined;
+    constructor(message: string, statusCode: number, response?: unknown | undefined);
+}
+/**
+ * RobotRock API client for creating and querying human-in-the-loop tasks.
+ */
+declare class RobotRock {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly app?;
+    private readonly version;
+    private readonly webhook?;
+    private readonly polling;
+    constructor(config: RobotRockConfig);
+    /**
+     * Create a task via POST /v1 without waiting for a human response.
+     */
+    createTask<const A extends readonly SendToHumanActionInput[]>(task: SendToHumanWithAppInput<A>): Promise<TaskResponse["task"]>;
+    sendToHuman<const A extends readonly SendToHumanActionInput[]>(task: SendToHumanWithAppInput<A>): Promise<SendToHumanResult<A>>;
+    /**
+     * Get a task by public task id (returned as `task.taskId` from {@link sendToHuman}).
+     */
+    getTask(taskId: string): Promise<Task | null>;
+    cancelTask(taskId: string): Promise<void>;
+}
+declare function createClient(config: RobotRockConfig): RobotRock;
+declare function attachWebhookToActions(actions: readonly SendToHumanActionInput[], webhook: RobotRockWebhookConfig): TaskContextInput["actions"];
+
+export { type RobotRockConfig as R, type SendToHumanActionInput as S, type SendToHumanInput as a, RobotRock as b, RobotRockError as c, attachWebhookToActions as d, createClient as e, type RobotRockWebhookClientConfig as f, type RobotRockPollingClientConfig as g, type RobotRockWebhookConfig as h, type RobotRockPollingOptions as i, type SendToHumanValidUntil as j, type SendToHumanResult as k };

package/dist/handler-webhook-BqEi6Bk-.d.ts

@@ -0,0 +1,16 @@
+/**
+ * JSON body posted when a RobotRock action handler runs (webhook or Trigger wait token).
+ */
+interface RobotRockHandlerWebhookPayload {
+    taskId: string;
+    action: {
+        id: string;
+        title: string;
+        data: unknown;
+    };
+    handledBy?: string;
+    handledAt: string;
+    handlerType: string;
+}
+
+export type { RobotRockHandlerWebhookPayload as R };

package/dist/index.d.ts

@@ -1,53 +1,99 @@
-import { R as RobotRockConfig, a as RobotRock, C as CreateTaskOptions } from './client-BQ-j7q68.js';
-export { b as RobotRockError, c as createClient } from './client-BQ-j7q68.js';
-import { TaskAction, TaskContextInput, DiscriminatedApprovalResult, Task } from '@robotrock/core';
-export { ApprovalResult, DiscriminatedApprovalResult, Handler, InferActionData, Task, TaskAction, TaskContext, TaskContextInput, TaskResponse, TaskResult, TaskStatus, TriggerHandler, TupleElementIndices, WebhookHandler, taskContextSchema } from '@robotrock/core';
+import { R as RobotRockConfig, b as RobotRock } from './client-agOgTJob.js';
+export { c as RobotRockError, g as RobotRockPollingClientConfig, i as RobotRockPollingOptions, f as RobotRockWebhookClientConfig, h as RobotRockWebhookConfig, S as SendToHumanActionInput, a as SendToHumanInput, k as SendToHumanResult, j as SendToHumanValidUntil, d as attachWebhookToActions, e as createClient } from './client-agOgTJob.js';
+import { Task, DiscriminatedApprovalResult } from './schemas/index.js';
+export { ApprovalResult, AssignToInput, CreateTaskBody, CreateTaskBodyInput, Handler, InferActionData, TaskAction, TaskContext, TaskContextInput, TaskResponse, TaskResult, TaskStatus, TriggerHandler, TupleElementIndices, WebhookHandler, assignToSchema, createTaskBodySchema, taskContextSchema } from './schemas/index.js';
+import { z } from 'zod';
+export { R as RobotRockHandlerWebhookPayload } from './handler-webhook-BqEi6Bk-.js';
 
 /**
  * Read RobotRock client config from environment variables.
  *
  * - `ROBOTROCK_API_KEY` (required when not passed explicitly)
  * - `ROBOTROCK_BASE_URL` or `ROBOTROCK_API_URL` (optional)
+ * - `ROBOTROCK_APP` (optional inbox app bucket)
  */
 declare function resolveRobotRockConfig(overrides?: Partial<RobotRockConfig>): RobotRockConfig;
 /** Use an explicit client or create one from env / optional config overrides. */
 declare function resolveRobotRockClient(client?: RobotRock, configOverrides?: Partial<RobotRockConfig>): RobotRock;
 
-/** Task payload for {@link askHuman}; `actions` must stay a literal tuple for inference. */
-type AskHumanTask<A extends readonly TaskAction[]> = Omit<TaskContextInput, "actions"> & {
-    readonly actions: A;
-};
-type AskHumanParams<A extends readonly TaskAction[]> = {
-    task: AskHumanTask<A>;
-    /** Pre-configured client; when omitted, one is created from env / `apiKey` / `baseUrl`. */
-    client?: RobotRock;
-    apiKey?: string;
-    baseUrl?: string;
-    /** Poll interval while waiting for a human (ms). @default 2000 */
-    pollInterval?: number;
-    /** Max wait time (ms). @default 86400000 (24h) */
-    timeout?: number;
-} & Pick<CreateTaskOptions, "idempotencyKey">;
-/**
- * Create a human-in-the-loop task and block until someone completes it.
- *
- * Uses polling against the RobotRock API. For durable waits inside Trigger.dev,
- * use `robotrock/trigger` instead.
- *
- * The return type is inferred from `task.actions`: `actionId` narrows `data`.
- */
-declare function askHuman<const A extends readonly TaskAction[]>(params: AskHumanParams<A>): Promise<DiscriminatedApprovalResult<A>>;
-
-declare class AskHumanTimeoutError extends Error {
+declare class TaskTimeoutError extends Error {
     constructor(message: string);
 }
-declare class AskHumanExpiredError extends Error {
+declare class TaskExpiredError extends Error {
     constructor(message: string);
 }
 /**
  * Map a handled API task to a discriminated approval result.
  * Runtime validation is minimal; TypeScript narrows via `task.actions` at the call site.
  */
-declare function toDiscriminatedApprovalResult<A extends readonly TaskAction[]>(actions: A, task: Task, streamEntryId: string): DiscriminatedApprovalResult<A>;
+declare function toDiscriminatedApprovalResult<A extends readonly {
+    id: string;
+    schema?: unknown;
+}[]>(actions: A, task: Task): DiscriminatedApprovalResult<A>;
+
+declare const robotRockWebhookPayloadSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    action: z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        data: z.ZodUnknown;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        data?: unknown;
+    }, {
+        id: string;
+        title: string;
+        data?: unknown;
+    }>;
+    handledBy: z.ZodOptional<z.ZodString>;
+    handledAt: z.ZodString;
+    handlerType: z.ZodString;
+} & {
+    headers: z.ZodRecord<z.ZodString, z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    headers: Record<string, string>;
+    taskId: string;
+    handledAt: string;
+    action: {
+        id: string;
+        title: string;
+        data?: unknown;
+    };
+    handlerType: string;
+    handledBy?: string | undefined;
+}, {
+    headers: Record<string, string>;
+    taskId: string;
+    handledAt: string;
+    action: {
+        id: string;
+        title: string;
+        data?: unknown;
+    };
+    handlerType: string;
+    handledBy?: string | undefined;
+}>;
+type RobotRockWebhookErrorCode = "MISSING_WEBHOOK_SECRET" | "MISSING_SIGNATURE" | "INVALID_SIGNATURE" | "INVALID_JSON" | "INVALID_PAYLOAD";
+declare class RobotRockWebhookError extends Error {
+    readonly code: RobotRockWebhookErrorCode;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: RobotRockWebhookErrorCode, details?: unknown | undefined);
+}
+type RobotRockWebhookPayload = z.infer<typeof robotRockWebhookPayloadSchema>;
+interface VerifyRobotRockWebhookOptions {
+    /**
+     * Override shared secret (defaults to ROBOTROCK_WEBHOOK_SECRET).
+     * Keep undefined in production to enforce the canonical env var.
+     */
+    secret?: string;
+    /** Signature header to read. @default "x-robotrock-signature" */
+    signatureHeader?: string;
+}
+/**
+ * Verify a RobotRock webhook request and return a validated payload.
+ * Throws RobotRockWebhookError with machine-readable `code` for audit logging.
+ */
+declare function verifyRobotRockWebhook(request: Request, options?: VerifyRobotRockWebhookOptions): Promise<RobotRockWebhookPayload>;
 
-export { AskHumanExpiredError, type AskHumanParams, type AskHumanTask, AskHumanTimeoutError, CreateTaskOptions, RobotRock, RobotRockConfig, askHuman, resolveRobotRockClient, resolveRobotRockConfig, toDiscriminatedApprovalResult };
+export { DiscriminatedApprovalResult, RobotRock, RobotRockConfig, RobotRockWebhookError, type RobotRockWebhookErrorCode, type RobotRockWebhookPayload, Task, TaskExpiredError, TaskTimeoutError, type VerifyRobotRockWebhookOptions, resolveRobotRockClient, resolveRobotRockConfig, toDiscriminatedApprovalResult, verifyRobotRockWebhook };