runcycles 0.1.0 → 0.1.2

package/dist/index.js

@@ -1,6 +1,7 @@
 // src/constants.ts
 var API_KEY_HEADER = "X-Cycles-API-Key";
 var IDEMPOTENCY_KEY_HEADER = "X-Idempotency-Key";
+var DEFAULT_TTL_MS = 6e4;
 var RESERVATIONS_PATH = "/v1/reservations";
 var DECIDE_PATH = "/v1/decide";
 var BALANCES_PATH = "/v1/balances";
@@ -460,6 +461,8 @@ var CyclesClient = class {
       );
     }
   }
+  async [Symbol.asyncDispose]() {
+  }
   async _handleResponse(resp) {
     let body;
     try {
@@ -708,6 +711,94 @@ function buildProtocolException(prefix, response) {
   }
 }
 
+// src/models.ts
+var Unit = /* @__PURE__ */ ((Unit2) => {
+  Unit2["USD_MICROCENTS"] = "USD_MICROCENTS";
+  Unit2["TOKENS"] = "TOKENS";
+  Unit2["CREDITS"] = "CREDITS";
+  Unit2["RISK_POINTS"] = "RISK_POINTS";
+  return Unit2;
+})(Unit || {});
+var CommitOveragePolicy = /* @__PURE__ */ ((CommitOveragePolicy2) => {
+  CommitOveragePolicy2["REJECT"] = "REJECT";
+  CommitOveragePolicy2["ALLOW_IF_AVAILABLE"] = "ALLOW_IF_AVAILABLE";
+  CommitOveragePolicy2["ALLOW_WITH_OVERDRAFT"] = "ALLOW_WITH_OVERDRAFT";
+  return CommitOveragePolicy2;
+})(CommitOveragePolicy || {});
+var Decision = /* @__PURE__ */ ((Decision2) => {
+  Decision2["ALLOW"] = "ALLOW";
+  Decision2["ALLOW_WITH_CAPS"] = "ALLOW_WITH_CAPS";
+  Decision2["DENY"] = "DENY";
+  return Decision2;
+})(Decision || {});
+var ReservationStatus = /* @__PURE__ */ ((ReservationStatus2) => {
+  ReservationStatus2["ACTIVE"] = "ACTIVE";
+  ReservationStatus2["COMMITTED"] = "COMMITTED";
+  ReservationStatus2["RELEASED"] = "RELEASED";
+  ReservationStatus2["EXPIRED"] = "EXPIRED";
+  return ReservationStatus2;
+})(ReservationStatus || {});
+var CommitStatus = /* @__PURE__ */ ((CommitStatus2) => {
+  CommitStatus2["COMMITTED"] = "COMMITTED";
+  return CommitStatus2;
+})(CommitStatus || {});
+var ReleaseStatus = /* @__PURE__ */ ((ReleaseStatus2) => {
+  ReleaseStatus2["RELEASED"] = "RELEASED";
+  return ReleaseStatus2;
+})(ReleaseStatus || {});
+var ExtendStatus = /* @__PURE__ */ ((ExtendStatus2) => {
+  ExtendStatus2["ACTIVE"] = "ACTIVE";
+  return ExtendStatus2;
+})(ExtendStatus || {});
+var EventStatus = /* @__PURE__ */ ((EventStatus2) => {
+  EventStatus2["APPLIED"] = "APPLIED";
+  return EventStatus2;
+})(EventStatus || {});
+var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
+  ErrorCode2["INVALID_REQUEST"] = "INVALID_REQUEST";
+  ErrorCode2["UNAUTHORIZED"] = "UNAUTHORIZED";
+  ErrorCode2["FORBIDDEN"] = "FORBIDDEN";
+  ErrorCode2["NOT_FOUND"] = "NOT_FOUND";
+  ErrorCode2["BUDGET_EXCEEDED"] = "BUDGET_EXCEEDED";
+  ErrorCode2["RESERVATION_EXPIRED"] = "RESERVATION_EXPIRED";
+  ErrorCode2["RESERVATION_FINALIZED"] = "RESERVATION_FINALIZED";
+  ErrorCode2["IDEMPOTENCY_MISMATCH"] = "IDEMPOTENCY_MISMATCH";
+  ErrorCode2["UNIT_MISMATCH"] = "UNIT_MISMATCH";
+  ErrorCode2["OVERDRAFT_LIMIT_EXCEEDED"] = "OVERDRAFT_LIMIT_EXCEEDED";
+  ErrorCode2["DEBT_OUTSTANDING"] = "DEBT_OUTSTANDING";
+  ErrorCode2["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+  ErrorCode2["UNKNOWN"] = "UNKNOWN";
+  return ErrorCode2;
+})(ErrorCode || {});
+function isAllowed(decision) {
+  return decision === "ALLOW" /* ALLOW */ || decision === "ALLOW_WITH_CAPS" /* ALLOW_WITH_CAPS */;
+}
+function isDenied(decision) {
+  return decision === "DENY" /* DENY */;
+}
+function isRetryableErrorCode(code) {
+  return code === "INTERNAL_ERROR" /* INTERNAL_ERROR */ || code === "UNKNOWN" /* UNKNOWN */;
+}
+function errorCodeFromString(value) {
+  if (value === void 0) return void 0;
+  if (Object.values(ErrorCode).includes(value)) {
+    return value;
+  }
+  return "UNKNOWN" /* UNKNOWN */;
+}
+function isToolAllowed(caps, tool) {
+  if (caps.toolAllowlist && caps.toolAllowlist.length > 0) {
+    return caps.toolAllowlist.includes(tool);
+  }
+  if (caps.toolDenylist && caps.toolDenylist.length > 0) {
+    return !caps.toolDenylist.includes(tool);
+  }
+  return true;
+}
+function isMetricsEmpty(metrics) {
+  return metrics.tokensInput === void 0 && metrics.tokensOutput === void 0 && metrics.latencyMs === void 0 && metrics.modelVersion === void 0 && !metrics.custom;
+}
+
 // src/validation.ts
 function validateSubject(subject) {
   if (subject === void 0) return;
@@ -762,7 +853,7 @@ function evaluateActual(expr, result, estimate, useEstimateFallback) {
 }
 function buildReservationBody(cfg, estimate, defaultSubject) {
   validateNonNegative(estimate, "estimate");
-  const ttlMs = cfg.ttlMs ?? 6e4;
+  const ttlMs = cfg.ttlMs ?? DEFAULT_TTL_MS;
   validateTtlMs(ttlMs);
   const subject = {};
   for (const field of [
@@ -820,9 +911,6 @@ function buildCommitBody(actual, unit, metrics, metadata) {
   }
   return body;
 }
-function isMetricsEmpty(metrics) {
-  return metrics.tokensInput === void 0 && metrics.tokensOutput === void 0 && metrics.latencyMs === void 0 && metrics.modelVersion === void 0 && !metrics.custom;
-}
 function buildReleaseBody(reason) {
   return { idempotency_key: randomUUID(), reason };
 }
@@ -843,7 +931,6 @@ var AsyncCyclesLifecycle = class {
   async execute(fn, args, cfg) {
     const estimate = evaluateAmount(cfg.estimate, args);
     const createBody = buildReservationBody(cfg, estimate, this._defaultSubject);
-    const resT1 = performance.now();
     const resResponse = await this._client.createReservation(createBody);
     if (!resResponse.isSuccess) {
       throw buildProtocolException("Failed to create reservation", resResponse);
@@ -880,7 +967,7 @@ var AsyncCyclesLifecycle = class {
       );
     }
     const unit = cfg.unit ?? "USD_MICROCENTS";
-    const ttlMs = cfg.ttlMs ?? 6e4;
+    const ttlMs = cfg.ttlMs ?? DEFAULT_TTL_MS;
     const ctx = {
       reservationId,
       estimate,
@@ -941,7 +1028,13 @@ var AsyncCyclesLifecycle = class {
         return;
       }
       const errorResp = response.getErrorResponse();
-      const errorCode = errorResp?.error;
+      let errorCode = errorResp?.error;
+      if (errorCode === void 0) {
+        const rawError = response.getBodyAttribute("error");
+        if (typeof rawError === "string") {
+          errorCode = rawError;
+        }
+      }
       if (errorCode === "RESERVATION_FINALIZED" || errorCode === "RESERVATION_EXPIRED") {
         return;
       }
@@ -951,7 +1044,7 @@ var AsyncCyclesLifecycle = class {
       if (response.isClientError) {
         await this._handleRelease(
           reservationId,
-          `commit_rejected_${errorCode}`
+          `commit_rejected_${errorCode ?? "unknown"}`
         );
         return;
       }
@@ -1050,6 +1143,9 @@ var CommitRetryEngine = class {
       } catch {
       }
     }
+    console.warn(
+      `[runcycles] Commit retry exhausted after ${this._maxAttempts} attempts for reservation ${reservationId}`
+    );
   }
 };
 
@@ -1074,24 +1170,26 @@ function getEffectiveClient(explicitClient) {
   );
 }
 function withCycles(options, fn) {
+  let lifecycle;
+  function ensureLifecycle() {
+    if (!lifecycle) {
+      const client = getEffectiveClient(options.client);
+      const config = client.config;
+      const defaultSubject = {
+        tenant: config.tenant,
+        workspace: config.workspace,
+        app: config.app,
+        workflow: config.workflow,
+        agent: config.agent,
+        toolset: config.toolset
+      };
+      const retryEngine = new CommitRetryEngine(config);
+      lifecycle = new AsyncCyclesLifecycle(client, retryEngine, defaultSubject);
+    }
+    return lifecycle;
+  }
   return async (...args) => {
-    const client = getEffectiveClient(options.client);
-    const config = client.config;
-    const defaultSubject = {
-      tenant: config.tenant,
-      workspace: config.workspace,
-      app: config.app,
-      workflow: config.workflow,
-      agent: config.agent,
-      toolset: config.toolset
-    };
-    const retryEngine = new CommitRetryEngine(config);
-    const lifecycle = new AsyncCyclesLifecycle(
-      client,
-      retryEngine,
-      defaultSubject
-    );
-    return lifecycle.execute(
+    return ensureLifecycle().execute(
       fn,
       args,
       options
@@ -1101,96 +1199,6 @@ function withCycles(options, fn) {
 
 // src/streaming.ts
 import { randomUUID as randomUUID2 } from "crypto";
-
-// src/models.ts
-var Unit = /* @__PURE__ */ ((Unit2) => {
-  Unit2["USD_MICROCENTS"] = "USD_MICROCENTS";
-  Unit2["TOKENS"] = "TOKENS";
-  Unit2["CREDITS"] = "CREDITS";
-  Unit2["RISK_POINTS"] = "RISK_POINTS";
-  return Unit2;
-})(Unit || {});
-var CommitOveragePolicy = /* @__PURE__ */ ((CommitOveragePolicy2) => {
-  CommitOveragePolicy2["REJECT"] = "REJECT";
-  CommitOveragePolicy2["ALLOW_IF_AVAILABLE"] = "ALLOW_IF_AVAILABLE";
-  CommitOveragePolicy2["ALLOW_WITH_OVERDRAFT"] = "ALLOW_WITH_OVERDRAFT";
-  return CommitOveragePolicy2;
-})(CommitOveragePolicy || {});
-var Decision = /* @__PURE__ */ ((Decision2) => {
-  Decision2["ALLOW"] = "ALLOW";
-  Decision2["ALLOW_WITH_CAPS"] = "ALLOW_WITH_CAPS";
-  Decision2["DENY"] = "DENY";
-  return Decision2;
-})(Decision || {});
-var ReservationStatus = /* @__PURE__ */ ((ReservationStatus2) => {
-  ReservationStatus2["ACTIVE"] = "ACTIVE";
-  ReservationStatus2["COMMITTED"] = "COMMITTED";
-  ReservationStatus2["RELEASED"] = "RELEASED";
-  ReservationStatus2["EXPIRED"] = "EXPIRED";
-  return ReservationStatus2;
-})(ReservationStatus || {});
-var CommitStatus = /* @__PURE__ */ ((CommitStatus2) => {
-  CommitStatus2["COMMITTED"] = "COMMITTED";
-  return CommitStatus2;
-})(CommitStatus || {});
-var ReleaseStatus = /* @__PURE__ */ ((ReleaseStatus2) => {
-  ReleaseStatus2["RELEASED"] = "RELEASED";
-  return ReleaseStatus2;
-})(ReleaseStatus || {});
-var ExtendStatus = /* @__PURE__ */ ((ExtendStatus2) => {
-  ExtendStatus2["ACTIVE"] = "ACTIVE";
-  return ExtendStatus2;
-})(ExtendStatus || {});
-var EventStatus = /* @__PURE__ */ ((EventStatus2) => {
-  EventStatus2["APPLIED"] = "APPLIED";
-  return EventStatus2;
-})(EventStatus || {});
-var ErrorCode = /* @__PURE__ */ ((ErrorCode2) => {
-  ErrorCode2["INVALID_REQUEST"] = "INVALID_REQUEST";
-  ErrorCode2["UNAUTHORIZED"] = "UNAUTHORIZED";
-  ErrorCode2["FORBIDDEN"] = "FORBIDDEN";
-  ErrorCode2["NOT_FOUND"] = "NOT_FOUND";
-  ErrorCode2["BUDGET_EXCEEDED"] = "BUDGET_EXCEEDED";
-  ErrorCode2["RESERVATION_EXPIRED"] = "RESERVATION_EXPIRED";
-  ErrorCode2["RESERVATION_FINALIZED"] = "RESERVATION_FINALIZED";
-  ErrorCode2["IDEMPOTENCY_MISMATCH"] = "IDEMPOTENCY_MISMATCH";
-  ErrorCode2["UNIT_MISMATCH"] = "UNIT_MISMATCH";
-  ErrorCode2["OVERDRAFT_LIMIT_EXCEEDED"] = "OVERDRAFT_LIMIT_EXCEEDED";
-  ErrorCode2["DEBT_OUTSTANDING"] = "DEBT_OUTSTANDING";
-  ErrorCode2["INTERNAL_ERROR"] = "INTERNAL_ERROR";
-  ErrorCode2["UNKNOWN"] = "UNKNOWN";
-  return ErrorCode2;
-})(ErrorCode || {});
-function isAllowed(decision) {
-  return decision === "ALLOW" /* ALLOW */ || decision === "ALLOW_WITH_CAPS" /* ALLOW_WITH_CAPS */;
-}
-function isDenied(decision) {
-  return decision === "DENY" /* DENY */;
-}
-function isRetryableErrorCode(code) {
-  return code === "INTERNAL_ERROR" /* INTERNAL_ERROR */ || code === "UNKNOWN" /* UNKNOWN */;
-}
-function errorCodeFromString(value) {
-  if (value === void 0) return void 0;
-  if (Object.values(ErrorCode).includes(value)) {
-    return value;
-  }
-  return "UNKNOWN" /* UNKNOWN */;
-}
-function isToolAllowed(caps, tool) {
-  if (caps.toolAllowlist && caps.toolAllowlist.length > 0) {
-    return caps.toolAllowlist.includes(tool);
-  }
-  if (caps.toolDenylist && caps.toolDenylist.length > 0) {
-    return !caps.toolDenylist.includes(tool);
-  }
-  return true;
-}
-function isMetricsEmpty2(metrics) {
-  return metrics.tokensInput === void 0 && metrics.tokensOutput === void 0 && metrics.latencyMs === void 0 && metrics.modelVersion === void 0 && !metrics.custom;
-}
-
-// src/streaming.ts
 async function reserveForStream(options) {
   const {
     client,
@@ -1199,7 +1207,7 @@ async function reserveForStream(options) {
     actionKind = "unknown",
     actionName = "unknown",
     actionTags,
-    ttlMs = 6e4,
+    ttlMs = DEFAULT_TTL_MS,
     gracePeriodMs,
     overagePolicy = "REJECT",
     dimensions
@@ -1295,13 +1303,23 @@ async function reserveForStream(options) {
         idempotency_key: randomUUID2(),
         actual: { unit, amount: actual }
       };
-      if (metrics && !isMetricsEmpty2(metrics)) {
+      if (metrics && !isMetricsEmpty(metrics)) {
         commitBody.metrics = metricsToWire(metrics);
       }
       if (metadata) {
         commitBody.metadata = metadata;
       }
-      await client.commitReservation(reservationId, commitBody);
+      try {
+        const response2 = await client.commitReservation(reservationId, commitBody);
+        if (!response2.isSuccess) {
+          throw new CyclesError(
+            `Commit failed with status ${response2.status}: ${response2.errorMessage ?? "unknown error"}`
+          );
+        }
+      } catch (err) {
+        finalized = false;
+        throw err;
+      }
     },
     async release(reason) {
       if (finalized) return;
@@ -1354,7 +1372,7 @@ export {
   getCyclesContext,
   isAllowed,
   isDenied,
-  isMetricsEmpty2 as isMetricsEmpty,
+  isMetricsEmpty,
   isRetryableErrorCode,
   isToolAllowed,
   metricsToWire,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runcycles",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "TypeScript client for the Cycles budget-management protocol",
   "license": "Apache-2.0",
   "author": "runcycles",
@@ -48,14 +48,19 @@
   },
   "scripts": {
     "build": "tsup",
+    "lint": "eslint src/",
     "test": "vitest run",
     "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit -p tsconfig.typecheck.json",
+    "prepublishOnly": "npm run lint && npm run build"
   },
   "devDependencies": {
     "@types/node": "^22.19.15",
+    "@typescript-eslint/eslint-plugin": "^8.57.0",
+    "@typescript-eslint/parser": "^8.57.0",
     "@vitest/coverage-v8": "^4.1.0",
+    "eslint": "^10.0.3",
     "tsup": "^8.0.0",
     "typescript": "^5.9.3",
     "vite": "^6.4.1",