@tokenfactory/acc-runner 0.40.1 → 0.40.2

package/dist/capacity-plugin.d.ts

@@ -0,0 +1,54 @@
+import { type ClaudeUsage } from "./cost-pricing.js";
+/** Claude subscription capacity window: 5 hours, rolling. // keep in sync */
+export declare const CLAUDE_WINDOW_MS: number;
+/** Tokens per capacity unit (window-pressure measure, not price). // keep in sync */
+export declare const CAPACITY_UNIT_TOKENS = 1000;
+export type CapacityLimitKind = "none" | "rate_limit" | "session_limit" | "usage_limit";
+export interface RunnerCapacityWindow {
+    kind: "rolling" | "fixed";
+    windowMs: number;
+    label: string;
+}
+export interface RunnerLimitInput {
+    exitCode?: number | null;
+    stdout?: string;
+    stderr?: string;
+}
+export interface RunnerLimitSignal {
+    hitLimit: boolean;
+    kind: CapacityLimitKind;
+    status: number | null;
+    /** Absolute reset instant (epoch ms) when derivable, else null. */
+    resetAtMs: number | null;
+    detail: string;
+}
+export interface RunnerMeterInput {
+    usage: ClaudeUsage | null | undefined;
+}
+export interface RunnerCapacityPlugin {
+    readonly provider: string;
+    window(): RunnerCapacityWindow;
+    classifyLimit(input: RunnerLimitInput, nowMs?: number): RunnerLimitSignal;
+    estimateResetAt(signal: RunnerLimitSignal, nowMs: number): number | null;
+    /** Capacity units this turn drew against the window. */
+    capacityUnits(input: RunnerMeterInput): number;
+}
+export declare const claudeRunnerCapacityPlugin: RunnerCapacityPlugin;
+/** The wire payload the runner reports to the server capacity endpoint. */
+export interface CapacityReport {
+    identity_id: string;
+    provider: string;
+    hit_limit: boolean;
+    kind: CapacityLimitKind;
+    status: number | null;
+    /** ISO reset instant when known, else null. */
+    reset_at: string | null;
+    detail: string;
+}
+/**
+ * Build the capacity report the runner POSTs when it hits (or clears) a limit.
+ * `estimateResetAt` fills a window-projected reset when Claude stated none, so
+ * the server always has a concrete probe-again time for an exhausted window.
+ */
+export declare function buildCapacityReport(identityId: string, signal: RunnerLimitSignal, plugin: RunnerCapacityPlugin, nowMs?: number): CapacityReport;
+//# sourceMappingURL=capacity-plugin.d.ts.map

package/dist/capacity-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacity-plugin.d.ts","sourceRoot":"","sources":["../src/capacity-plugin.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErE,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,QAAqB,CAAC;AACnD,qFAAqF;AACrF,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAE1C,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,YAAY,GAAG,eAAe,GAAG,aAAa,CAAC;AAExF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,mEAAmE;IACnE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;CACvC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,MAAM,IAAI,oBAAoB,CAAC;IAC/B,aAAa,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAC1E,eAAe,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACzE,wDAAwD;IACxD,aAAa,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAAC;CAChD;AAQD,eAAO,MAAM,0BAA0B,EAAE,oBAwCxC,CAAC;AAEF,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,oBAAoB,EAC5B,KAAK,SAAa,GACjB,cAAc,CAWhB"}

package/dist/capacity-plugin.js

@@ -0,0 +1,79 @@
+/**
+ * CC-3A CAPACITY-PLUGINS — the runner side of the per-provider capacity plugin.
+ *
+ * The runner is where a Claude 429 / session-limit is first SEEN, so it owns the
+ * 429/limit classifier that "feeds capacity_state" (the server folds the report
+ * through the capacity_state machine — see api/_lib/capacity/apply-capacity-signal.ts).
+ *
+ * This module wraps the runner's existing failure-classifier (isCapacityExhausted /
+ * parseApiErrorStatus / extractResetTime) in the CapacityPlugin shape. The shape
+ * is DUPLICATED from api/_lib/capacity/provider-plugin.ts on purpose: the runner
+ * is a standalone published package and MUST NOT import from api/_lib (the
+ * cost-pricing.ts precedent). The two shapes are kept in sync by hand. // keep in sync
+ */
+import { extractResetTime, isCapacityExhausted, parseApiErrorStatus, } from "./failure-classifier.js";
+import { normalizeUsage } from "./cost-pricing.js";
+/** Claude subscription capacity window: 5 hours, rolling. // keep in sync */
+export const CLAUDE_WINDOW_MS = 5 * 60 * 60 * 1000;
+/** Tokens per capacity unit (window-pressure measure, not price). // keep in sync */
+export const CAPACITY_UNIT_TOKENS = 1_000;
+// Hard billing wall = quarantine, never a recoverable window. Kept disjoint from
+// the recoverable-capacity path, mirroring failure-classifier. // keep in sync
+const HARD_BILLING_WALL = /out of credits|credit balance (?:is )?too low|monthly spend limit|insufficient_quota|quota exceeded|check your (?:plan and )?billing|billing (?:hard )?limit|payment required/i;
+const SESSION_LIMIT = /hit your (?:session|usage|account) limit|session limit|(?:session|usage|account|limit).*resets?\b/i;
+export const claudeRunnerCapacityPlugin = {
+    provider: "anthropic",
+    window() {
+        return { kind: "rolling", windowMs: CLAUDE_WINDOW_MS, label: "5h rolling subscription window" };
+    },
+    classifyLimit(input, nowMs = Date.now()) {
+        const stdout = input.stdout ?? "";
+        const stderr = input.stderr ?? "";
+        const combined = `${stderr}\n${stdout}`;
+        const status = parseApiErrorStatus(stdout);
+        if (HARD_BILLING_WALL.test(combined)) {
+            return { hitLimit: false, kind: "usage_limit", status, resetAtMs: null, detail: "hard billing/quota wall — not recoverable" };
+        }
+        if (isCapacityExhausted(stdout, stderr)) {
+            const isSession = SESSION_LIMIT.test(combined);
+            return {
+                hitLimit: true,
+                kind: isSession ? "session_limit" : "rate_limit",
+                status: status === 429 ? 429 : status,
+                resetAtMs: extractResetTime(combined, nowMs),
+                detail: isSession ? "Claude session/usage capacity reached" : "Claude 429 rate limit",
+            };
+        }
+        return { hitLimit: false, kind: "none", status, resetAtMs: null, detail: "no capacity limit" };
+    },
+    estimateResetAt(signal, nowMs) {
+        if (!signal.hitLimit)
+            return null;
+        if (signal.resetAtMs !== null && signal.resetAtMs > nowMs)
+            return signal.resetAtMs;
+        return nowMs + CLAUDE_WINDOW_MS;
+    },
+    capacityUnits(input) {
+        const u = normalizeUsage(input.usage);
+        const tokens = u.input_tokens + u.output_tokens + u.cache_read_tokens + u.cache_write_tokens;
+        return tokens / CAPACITY_UNIT_TOKENS;
+    },
+};
+/**
+ * Build the capacity report the runner POSTs when it hits (or clears) a limit.
+ * `estimateResetAt` fills a window-projected reset when Claude stated none, so
+ * the server always has a concrete probe-again time for an exhausted window.
+ */
+export function buildCapacityReport(identityId, signal, plugin, nowMs = Date.now()) {
+    const resetMs = plugin.estimateResetAt(signal, nowMs);
+    return {
+        identity_id: identityId,
+        provider: plugin.provider,
+        hit_limit: signal.hitLimit,
+        kind: signal.kind,
+        status: signal.status,
+        reset_at: resetMs === null ? null : new Date(resetMs).toISOString(),
+        detail: signal.detail,
+    };
+}
+//# sourceMappingURL=capacity-plugin.js.map

package/dist/capacity-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacity-plugin.js","sourceRoot":"","sources":["../src/capacity-plugin.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokenfactory/acc-runner",
-  "version": "0.40.1",
+  "version": "0.40.2",
   "description": "Agent Control Center local runner. Spawns Claude Code sessions assigned via ACC.",
   "license": "UNLICENSED",
   "private": false,