@open-autonomy/sdk 2.3.1 → 2.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-autonomy/sdk",
-  "version": "2.3.1",
+  "version": "2.3.2",
   "description": "The Open Autonomy SDK: the roadmap model and its codec, the development-stream client (sessions, turns, updates), and the key helpers. Everything it does is a documented HTTP wire any language can speak without it.",
   "license": "Apache-2.0",
   "repository": {

package/src/rails.ts

@@ -72,21 +72,56 @@ export function parseModelsBound(yaml: string): string[] {
   return out;
 }
 
-// The most the project's funds may spend on the model rail in a day (UTC), from the same file:
+// The limits the project's funds run under on the model rail, from the same file — the shape a provider's rate
+// limits and a budget's period share: each limit is one measure over one window, rolling.
 //   spend:
-//     daily_usd_cents: 500
-// 0 or absent: no bound of the project's own beyond the platform's global rail.
-export function parseSpendBound(yaml: string): { daily_usd_cents: number } {
-  let block = '';
-  let daily = 0;
+//     limits:
+//       - { window: 1d, usd_cents: 500 }                    # the money: cents over the window
+//       - { window: 30d, usd_cents: 6000 }
+//       - { window: 1m, calls: 60 }                         # the pace: requests over the window
+//       - { window: 1h, tokens: 2000000 }                   # the volume: tokens in and out over the window
+//       - { window: 1d, usd_cents: 100, model: openai/gpt-5 } # one model's own budget
+// Windows: N m (minutes, up to 60), N h (hours, up to 24), N d (days, up to 31). Every limit holds at once; the platform
+// refuses the call that would cross one and says which. None: no bound of the project's own beyond the platform's rail.
+export interface SpendLimit { window: string; window_seconds: number; usd_cents?: number; calls?: number; tokens?: number; model?: string }
+export function parseWindow(spec: string): number | undefined {
+  const m = /^(\d+)\s*(m|h|d)$/.exec(spec.trim());
+  if (!m) return undefined;
+  const n = Number(m[1]); const unit = { m: 60, h: 3600, d: 86400 }[m[2] as 'm' | 'h' | 'd'];
+  const max = { m: 60, h: 24, d: 31 }[m[2] as 'm' | 'h' | 'd'];
+  return n >= 1 && n <= max ? n * unit : undefined;
+}
+export function parseSpendLimits(yaml: string): SpendLimit[] {
+  const out: SpendLimit[] = [];
+  let block = ''; let inLimits = false; let item: Record<string, string> | null = null;
+  const flush = () => {
+    if (!item) return;
+    const seconds = item.window ? parseWindow(item.window) : undefined;
+    const num = (k: string) => (item![k] !== undefined && /^\d+$/.test(item![k]) ? Number(item![k]) : undefined);
+    const limit: SpendLimit = { window: (item.window ?? '').trim(), window_seconds: seconds ?? 0 };
+    if (num('usd_cents') !== undefined) limit.usd_cents = num('usd_cents');
+    if (num('calls') !== undefined) limit.calls = num('calls');
+    if (num('tokens') !== undefined) limit.tokens = num('tokens');
+    if (item.model) limit.model = item.model.trim().replace(/^["']|["']$/g, '');
+    if (seconds && (limit.usd_cents !== undefined || limit.calls !== undefined || limit.tokens !== undefined)) out.push(limit);
+    item = null;
+  };
+  const pairs = (text: string): Record<string, string> => Object.fromEntries(text.split(',').map((kv) => kv.split(':')).filter((kv) => kv.length >= 2).map(([k, ...v]) => [k.trim(), v.join(':').trim().replace(/^["']|["']$/g, '')]));
   for (const raw of yaml.split('\n')) {
     const line = raw.replace(/\s+#.*$/, '').trimEnd();
     if (!line.trim() || line.trim().startsWith('#')) continue;
     const top = /^([a-z_]+):\s*(.*)$/.exec(line);
-    if (top) { block = top[2] === '' ? top[1] : ''; continue; }
+    if (top) { flush(); block = top[2] === '' ? top[1] : ''; inLimits = false; continue; }
     if (block !== 'spend') continue;
-    const kv = /^\s+daily_usd_cents:\s*(\d+)\s*$/.exec(line);
-    if (kv) daily = Math.max(0, Math.floor(Number(kv[1])));
+    if (/^  limits:\s*$/.test(line)) { flush(); inLimits = true; continue; }
+    if (!inLimits) continue;
+    const flow = /^\s+-\s*\{(.*)\}\s*$/.exec(line);
+    if (flow) { flush(); item = pairs(flow[1]); flush(); continue; }
+    const start = /^\s+-\s+([a-z_]+):\s*(.+)$/.exec(line);
+    if (start) { flush(); item = { [start[1]]: start[2].trim() }; continue; }
+    const more = item ? /^\s+([a-z_]+):\s*(.+)$/.exec(line) : null;
+    if (more) item![more[1]] = more[2].trim();
   }
-  return { daily_usd_cents: daily };
+  flush();
+  return out;
 }