robotrock 0.1.0 → 0.3.0

package/dist/chunk-KOXJCIST.js

@@ -0,0 +1,332 @@
+import {
+  createTaskBodySchema
+} from "./chunk-LXM7VS4Q.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.io/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 } : {},
+      ...task.threadId !== void 0 ? { threadId: task.threadId } : {}
+    };
+    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,
+    threadId: _threadId,
+    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.io/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-KOXJCIST.js.map

package/dist/chunk-KOXJCIST.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.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\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.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    };\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    threadId: _threadId,\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/chunk-LXM7VS4Q.js

@@ -0,0 +1,129 @@
+var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __using = (stack, value, async) => {
+  if (value != null) {
+    if (typeof value !== "object" && typeof value !== "function") __typeError("Object expected");
+    var dispose, inner;
+    if (async) dispose = value[__knownSymbol("asyncDispose")];
+    if (dispose === void 0) {
+      dispose = value[__knownSymbol("dispose")];
+      if (async) inner = dispose;
+    }
+    if (typeof dispose !== "function") __typeError("Object not disposable");
+    if (inner) dispose = function() {
+      try {
+        inner.call(this);
+      } catch (e) {
+        return Promise.reject(e);
+      }
+    };
+    stack.push([async, dispose, value]);
+  } else if (async) {
+    stack.push([async]);
+  }
+  return value;
+};
+var __callDispose = (stack, error, hasError) => {
+  var E = typeof SuppressedError === "function" ? SuppressedError : function(e, s, m, _) {
+    return _ = Error(m), _.name = "SuppressedError", _.error = e, _.suppressed = s, _;
+  };
+  var fail = (e) => error = hasError ? new E(e, error, "An error was suppressed during disposal") : (hasError = true, e);
+  var next = (it) => {
+    while (it = stack.pop()) {
+      try {
+        var result = it[1] && it[1].call(it[2]);
+        if (it[0]) return Promise.resolve(result).then(next, (e) => (fail(e), next()));
+      } catch (e) {
+        fail(e);
+      }
+    }
+    if (hasError) throw error;
+  };
+  return next();
+};
+
+// src/schemas/index.ts
+import { z } from "zod";
+var safeUrlSchema = z.string().refine((url) => url.startsWith("http://") || url.startsWith("https://"), {
+  message: "URL must start with http:// or https://"
+});
+var jsonSchema7Schema = z.custom(
+  (val) => typeof val === "object" && val !== null,
+  { message: "Must be a valid JSON Schema object" }
+);
+var uiSchemaSchema = z.custom((val) => typeof val === "object" && val !== null, {
+  message: "Must be a valid UiSchema object"
+});
+var webhookHandlerSchema = z.object({
+  type: z.literal("webhook"),
+  url: safeUrlSchema,
+  headers: z.record(z.string())
+});
+var triggerHandlerSchema = webhookHandlerSchema.extend({
+  type: z.literal("trigger"),
+  tokenId: z.string().min(1)
+});
+var handlerSchema = z.discriminatedUnion("type", [webhookHandlerSchema, triggerHandlerSchema]);
+var taskActionSchema = z.object({
+  id: z.string().min(1),
+  title: z.string().min(1),
+  description: z.string().optional(),
+  schema: jsonSchema7Schema.optional(),
+  ui: uiSchemaSchema.optional(),
+  data: z.record(z.unknown()).optional(),
+  handlers: z.array(handlerSchema).min(1).optional()
+});
+var uiFieldSchemaSchema = z.object({
+  "ui:widget": z.string().optional(),
+  "ui:title": z.string().optional(),
+  "ui:description": z.string().optional(),
+  "ui:options": z.record(z.unknown()).optional(),
+  items: z.lazy(() => z.record(uiFieldSchemaSchema)).optional()
+}).passthrough();
+var contextUiSchema = z.record(uiFieldSchemaSchema).optional();
+var contextDataSchema = z.object({
+  data: z.record(z.unknown()),
+  ui: contextUiSchema
+}).optional();
+var taskContextSchema = z.object({
+  app: z.string().min(1).optional(),
+  type: z.string().min(1),
+  name: z.string().min(1),
+  description: z.string().optional(),
+  validUntil: z.string().optional(),
+  context: contextDataSchema,
+  version: z.literal(2).optional(),
+  actions: z.array(taskActionSchema).min(1, "At least one action is required")
+});
+var assignToSchema = z.object({
+  users: z.array(z.string().email()).optional(),
+  groups: z.array(z.string().min(1)).optional()
+}).refine(
+  (data) => {
+    const groups = data.groups ?? [];
+    if (groups.includes("all") && groups.length > 1) {
+      return false;
+    }
+    return true;
+  },
+  { message: 'Cannot combine "all" with other group slugs' }
+);
+var createTaskBodySchema = taskContextSchema.extend({
+  assignTo: assignToSchema.optional(),
+  /**
+   * Groups related tasks together. When omitted, the server generates one and
+   * returns it so the caller can reuse it on later tasks in the same thread.
+   */
+  threadId: z.string().min(1).optional()
+});
+
+export {
+  __using,
+  __callDispose,
+  taskContextSchema,
+  assignToSchema,
+  createTaskBodySchema
+};
+//# sourceMappingURL=chunk-LXM7VS4Q.js.map

package/dist/chunk-LXM7VS4Q.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\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\nexport type AssignToInput = z.infer<typeof assignToSchema>;\nexport type CreateTaskBodyInput = z.input<typeof createTaskBodySchema>;\nexport type CreateTaskBody = z.output<typeof createTaskBodySchema>;\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 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/client-Dhk9qxhL.d.ts

@@ -0,0 +1,104 @@
+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.io/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;
+    /**
+     * Groups related tasks together in the inbox. Omit to let the server generate
+     * one (returned as `task.threadId`) and reuse it on later tasks in the thread.
+     */
+    threadId?: string;
+};
+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 };