codai-sdk 0.4.0 → 0.5.0

package/dist/index.js

@@ -1219,6 +1219,173 @@ var Projects = class {
   }
 };
 
+// src/resources/resolve.ts
+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 +1830,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 +1931,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 +2014,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 +2053,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 +2093,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 +2187,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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map