codai-sdk 0.4.0 → 0.6.0

package/dist/index.js

@@ -1219,6 +1219,213 @@ var Projects = class {
   }
 };
 
+// src/resources/resolve.ts
+function verifyResolveWebhook(secret, rawBody, signatureHeader, opts = {}) {
+  if (!secret || !signatureHeader) return false;
+  let t;
+  const v1s = [];
+  for (const part of signatureHeader.split(",")) {
+    const eq = part.indexOf("=");
+    if (eq === -1) continue;
+    const k = part.slice(0, eq).trim();
+    const v = part.slice(eq + 1).trim();
+    if (k === "t") t = v;
+    else if (k === "v1") v1s.push(v.toLowerCase());
+  }
+  if (!t || !/^\d+$/.test(t) || v1s.length === 0) return false;
+  const tolerance = opts.toleranceSeconds ?? 300;
+  const now = opts.nowSeconds ?? Math.floor(Date.now() / 1e3);
+  if (Math.abs(now - Number(t)) > tolerance) return false;
+  const { createHmac, timingSafeEqual } = nodeCrypto();
+  const enc2 = new TextEncoder();
+  const body = typeof rawBody === "string" ? enc2.encode(rawBody) : rawBody;
+  const expected = createHmac("sha256", secret).update(enc2.encode(`${t}.`)).update(body).digest();
+  return v1s.some((v1) => {
+    if (!/^[0-9a-f]{64}$/.test(v1)) return false;
+    return timingSafeEqual(hexToBytes(v1), expected);
+  });
+}
+function nodeCrypto() {
+  const proc = globalThis.process;
+  const mod = proc?.getBuiltinModule?.("node:crypto");
+  if (!mod) {
+    throw new Error(
+      "verifyResolveWebhook needs node:crypto (Node 20.16+/22.3+, Bun or Deno); run it server-side"
+    );
+  }
+  return mod;
+}
+function hexToBytes(hex) {
+  const out = new Uint8Array(hex.length / 2);
+  for (let i = 0; i < out.length; i++) out[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+  return out;
+}
+var RESOLVE_TERMINAL_STATUSES = /* @__PURE__ */ new Set([
+  "resolved",
+  "failed",
+  "declined",
+  "error"
+]);
+var ResolveError = class extends CodaiError {
+  /** The `error` field of the body: a message, or Zod `flatten()` details on a 400. */
+  detail;
+  constructor(message, status, body, meta = {}) {
+    super(message, status, body, meta);
+    this.name = "ResolveError";
+    this.detail = extractDetail(body);
+  }
+};
+var ResolveInsufficientFundsError = class extends ResolveError {
+  /** Wallet balance, in `currency` units (EUR micros). */
+  balance;
+  /** Amount the hold needs, in `currency` units (EUR micros). */
+  required;
+  currency;
+  /** pay.codai.ro checkout link for the shortfall — open it, then retry `accept()`. */
+  topupUrl;
+  constructor(message, body, meta = {}) {
+    super(message, 402, body, meta);
+    this.name = "ResolveInsufficientFundsError";
+    this.balance = body.balance;
+    this.required = body.required;
+    this.currency = body.currency;
+    this.topupUrl = body.topup_url;
+  }
+};
+var Resolve = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * `POST /v1/resolve/jobs` — submit a public GitHub repo + issue for triage.
+   * Returns a quote (`status: 'quoted'`), a free-tier auto-accept
+   * (`status: 'accepted'`) or a decline (`status: 'declined'`). Never retried:
+   * a retry could create a second job.
+   */
+  submit(body, opts = {}) {
+    if (!body.issue_url && !body.issue_text)
+      throw new TypeError("resolve.submit: one of issue_url or issue_text is required");
+    return this.call("/v1/resolve/jobs", {
+      method: "POST",
+      body,
+      noRetry: true,
+      signal: opts.signal
+    });
+  }
+  /** `GET /v1/resolve/jobs/{id}` — status, quote, reasons, cost and attestation pointer. */
+  get(id, opts = {}) {
+    return this.call(`/v1/resolve/jobs/${encodeURIComponent(id)}`, {
+      signal: opts.signal
+    });
+  }
+  /**
+   * `POST /v1/resolve/jobs/{id}/accept` — accept a paid quote and start the job.
+   * Throws `ResolveInsufficientFundsError` (402, carries `topupUrl`) when the
+   * wallet is short, `ResolveError` 409 when the job is not `quoted`.
+   */
+  accept(id, opts = {}) {
+    return this.call(`/v1/resolve/jobs/${encodeURIComponent(id)}/accept`, {
+      method: "POST",
+      rawBody: "",
+      // no body — sent with content-length: 0
+      noRetry: true,
+      signal: opts.signal
+    });
+  }
+  /**
+   * `GET /v1/resolve/attestations/{id}` — public execution proof (no auth needed
+   * server-side). Accepts the attestation id or the job's `attestation_url`.
+   */
+  attestation(idOrUrl, opts = {}) {
+    const id = idOrUrl.replace(/^.*\/v1\/resolve\/attestations\//, "");
+    return this.call(`/v1/resolve/attestations/${encodeURIComponent(id)}`, {
+      signal: opts.signal
+    });
+  }
+  /** `GET /health` — liveness of the Resolve service. */
+  health(opts = {}) {
+    return this.call("/health", { signal: opts.signal });
+  }
+  /**
+   * Poll `get(id)` until the job reaches a terminal status (`resolved`,
+   * `failed`, `declined`, `error`) or one of `opts.until`. A `quoted` job
+   * does not move until you `accept()` it.
+   */
+  async waitFor(id, opts = {}) {
+    const intervalMs = opts.intervalMs ?? 5e3;
+    const timeoutMs = opts.timeoutMs ?? 18e5;
+    const until = new Set(opts.until ?? RESOLVE_TERMINAL_STATUSES);
+    const deadline = Date.now() + timeoutMs;
+    for (; ; ) {
+      const job = await this.get(id, { signal: opts.signal });
+      opts.onPoll?.(job);
+      if (until.has(job.status)) return job;
+      const left = deadline - Date.now();
+      if (left <= 0)
+        throw new ResolveError(
+          `codai-resolve job ${id} still ${job.status} after ${timeoutMs} ms`,
+          0,
+          job
+        );
+      await abortableSleep(Math.min(intervalMs, left), opts.signal);
+    }
+  }
+  async call(path, init) {
+    try {
+      return await this.http.json(path, init);
+    } catch (err) {
+      throw toResolveError(path, err);
+    }
+  }
+};
+function extractDetail(body) {
+  if (body && typeof body === "object" && "error" in body) {
+    const e = body.error;
+    if (typeof e === "string") return e;
+    if (e && typeof e === "object") return e;
+  }
+  return null;
+}
+function isInsufficientFunds(body) {
+  return !!body && typeof body === "object" && body.error === "insufficient_funds" && typeof body.topup_url === "string";
+}
+function toResolveError(path, err) {
+  if (!(err instanceof CodaiError) || err instanceof ResolveError) return err;
+  if (err.status === 0) return err;
+  const meta = { requestId: err.requestId, retryAfter: err.retryAfter };
+  if (err.status === 402 && isInsufficientFunds(err.body)) {
+    const b = err.body;
+    return new ResolveInsufficientFundsError(
+      `codai-resolve ${path} \u2192 402: insufficient funds (balance ${b.balance}, required ${b.required} ${b.currency}); top up at ${b.topup_url}`,
+      b,
+      meta
+    );
+  }
+  const detail = extractDetail(err.body);
+  const text = detail === null ? "" : `: ${typeof detail === "string" ? detail : JSON.stringify(detail)}`;
+  return new ResolveError(
+    `codai-resolve ${path} \u2192 ${err.status}${text}`,
+    err.status,
+    err.body,
+    meta
+  );
+}
+function abortableSleep(ms, signal) {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted) return reject(signal.reason);
+    const onAbort = () => {
+      clearTimeout(t);
+      reject(signal?.reason);
+    };
+    const t = setTimeout(() => {
+      signal?.removeEventListener("abort", onAbort);
+      resolve();
+    }, ms);
+    signal?.addEventListener("abort", onAbort, { once: true });
+  });
+}
+
 // src/resources/responses.ts
 var Responses = class {
   constructor(http) {
@@ -1663,6 +1870,14 @@ var Notifications = class {
   markRead(ids, opts = {}) {
     return this.http.json("/v1/notifications/read", { method: "POST", body: ids ? { ids } : {}, ext: opts.ext, signal: opts.signal });
   }
+  /** `DELETE /v1/notifications/:id` — `{ deleted: 0 }` when the id is missing or not yours. */
+  delete(id, opts = {}) {
+    return this.http.json(`/v1/notifications/${encodeURIComponent(String(id))}`, { method: "DELETE", ext: opts.ext, signal: opts.signal });
+  }
+  /** `POST /v1/notifications/delete` — 1..200 ids; ids of other users are skipped. */
+  deleteMany(ids, opts = {}) {
+    return this.http.json("/v1/notifications/delete", { method: "POST", body: { ids }, ext: opts.ext, signal: opts.signal });
+  }
 };
 
 // src/resources/tokens.ts
@@ -1756,6 +1971,8 @@ var OPERATION_METHODS = {
   receiveTriggerHook: "triggers.fireHook",
   listNotifications: "notifications.list",
   markNotificationsRead: "notifications.markRead",
+  deleteNotification: "notifications.delete",
+  deleteNotifications: "notifications.deleteMany",
   // Sessions
   createSession: "sessions.create",
   listSessions: "sessions.list",
@@ -1837,6 +2054,13 @@ var STREAMING_OPERATIONS = /* @__PURE__ */ new Set([
   "streamSession",
   "streamHost"
 ]);
+var RESOLVE_OPERATION_METHODS = {
+  resolveHealth: "resolve.health",
+  createResolveJob: "resolve.submit",
+  getResolveJob: "resolve.get",
+  acceptResolveJob: "resolve.accept",
+  getResolveAttestation: "resolve.attestation"
+};
 
 // src/index.ts
 var Codai = class {
@@ -1869,6 +2093,8 @@ var Codai = class {
   receipt;
   feedback;
   phoneModels;
+  /** codai Resolve — execution-verified bug fixes (separate host, `resolveBaseUrl`). */
+  resolve;
   constructor(opts) {
     if (!opts.apiKey) throw new Error("Codai: apiKey is required");
     this.http = new HttpClient({
@@ -1907,6 +2133,16 @@ var Codai = class {
     this.account = new Account(http);
     this.receipt = new Receipts(http);
     this.phoneModels = new PhoneModels(http);
+    this.resolve = new Resolve(
+      new HttpClient({
+        apiKey: opts.apiKey,
+        baseUrl: opts.resolveBaseUrl ?? "https://resolve.codai.ro",
+        timeoutMs: opts.timeoutMs ?? 12e4,
+        maxRetries: opts.maxRetries ?? 2,
+        fetch: opts.fetch,
+        defaults: opts.client ? { client: opts.client } : {}
+      })
+    );
     this.chat = callable(
       new Chat(http),
       (o) => this.chat.completions.create(this.legacyBody(o), {
@@ -1991,6 +2227,6 @@ function allKeys(obj) {
 }
 var index_default = Codai;
 
-export { Account, AgentRuns, Agents, Audio, Chat, ChatCompletions, Codai, CodaiError, Devices, Embeddings, EnvironmentMembers, EnvironmentPorts, EnvironmentSecrets, EnvironmentTasks, Environments, Feedback, Health, Hosts, HttpClient, Messages, Models, Notifications, OPERATION_METHODS, OrgMembers, Orgs, PhoneModels, Projects, Receipts, Responses, STREAMING_OPERATIONS, SessionControls, SessionEvents, SessionLease, SessionShares, Sessions, Tasks, Tokens, Tools, Triggers, index_default as default, extensionHeaders, frameJson, mergeToolCall, readSse };
+export { Account, AgentRuns, Agents, Audio, Chat, ChatCompletions, Codai, CodaiError, Devices, Embeddings, EnvironmentMembers, EnvironmentPorts, EnvironmentSecrets, EnvironmentTasks, Environments, Feedback, Health, Hosts, HttpClient, Messages, Models, Notifications, OPERATION_METHODS, OrgMembers, Orgs, PhoneModels, Projects, RESOLVE_OPERATION_METHODS, RESOLVE_TERMINAL_STATUSES, Receipts, Resolve, ResolveError, ResolveInsufficientFundsError, Responses, STREAMING_OPERATIONS, SessionControls, SessionEvents, SessionLease, SessionShares, Sessions, Tasks, Tokens, Tools, Triggers, index_default as default, extensionHeaders, frameJson, mergeToolCall, readSse, verifyResolveWebhook };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map