@wtfalch/foundry 0.19.0 → 0.20.0

package/dist/plan/providers-readers.d.ts

@@ -3,7 +3,7 @@ import type { CoolifyClient } from '@wtfalch/providers/coolify';
 import { type ZitadelClient } from '@wtfalch/providers/zitadel';
 import type { OrgId } from '../org.js';
 import type { DeclaredOrgStore } from '../store.js';
-import type { CloudflareReader, CmsReader, CoolifyReader, LiveResource, ZitadelReader } from './live.js';
+import type { AiReader, CloudflareReader, CmsReader, CoolifyReader, LiveResource, ZitadelReader } from './live.js';
 /**
  * Real `CoolifyReader`, `CloudflareReader` and `ZitadelReader` implementations
  * (`live.ts:31-45`), backed by `@wtfalch/providers`' HTTP clients instead of
@@ -144,6 +144,28 @@ export declare class ProvidersZitadelReader implements ZitadelReader {
      */
     private liveIssuer;
 }
+/**
+ * Reads the org's applied AI budget limit back, so `diff.ts`'s `planAiBudget`
+ * stops re-proposing "set the AI budget" once it has already landed (#515).
+ * AI's own API offers no read for this (`live.ts`'s `AiReader` doc comment:
+ * wiring a real budget read is #20, a non-goal of #27 -- unlike
+ * {@link ProvidersZitadelReader}/{@link ProvidersCloudflareReader}, which both
+ * call a real provider client), so `executor.ts`'s `aiBudget` recording the
+ * limit it just applied under the flat `ai_budget_limit_micros` scope key is
+ * the only evidence there is -- the same "nothing live yet" shape
+ * {@link storeScopeResolver}'s own doc comment describes for `cloudflare_zone`
+ * before #510 fixed it.
+ *
+ * Nothing recorded yet reads as `[]`, never a default: a never-applied org
+ * must still plan its first `ai:budget` step, and inventing the declared (or
+ * default) limit here would make a budget that actually drifted out of band
+ * read as converged.
+ */
+export declare class ProvidersAiReader implements AiReader {
+    private readonly resolveLimit;
+    constructor(resolveLimit: ScopeResolver);
+    listResources(orgId: OrgId): Promise<LiveResource[]>;
+}
 /**
  * Backed by the same `@wtfalch/providers/coolify`'s `CoolifyClient.listResources`
  * call {@link ProvidersCoolifyReader} makes, not a real cms admin API --

package/dist/plan/providers-readers.js

@@ -358,6 +358,35 @@ export class ProvidersZitadelReader {
         return { system: 'zitadel', kind: 'issuer', key: orgId, config: {} };
     }
 }
+/**
+ * Reads the org's applied AI budget limit back, so `diff.ts`'s `planAiBudget`
+ * stops re-proposing "set the AI budget" once it has already landed (#515).
+ * AI's own API offers no read for this (`live.ts`'s `AiReader` doc comment:
+ * wiring a real budget read is #20, a non-goal of #27 -- unlike
+ * {@link ProvidersZitadelReader}/{@link ProvidersCloudflareReader}, which both
+ * call a real provider client), so `executor.ts`'s `aiBudget` recording the
+ * limit it just applied under the flat `ai_budget_limit_micros` scope key is
+ * the only evidence there is -- the same "nothing live yet" shape
+ * {@link storeScopeResolver}'s own doc comment describes for `cloudflare_zone`
+ * before #510 fixed it.
+ *
+ * Nothing recorded yet reads as `[]`, never a default: a never-applied org
+ * must still plan its first `ai:budget` step, and inventing the declared (or
+ * default) limit here would make a budget that actually drifted out of band
+ * read as converged.
+ */
+export class ProvidersAiReader {
+    resolveLimit;
+    constructor(resolveLimit) {
+        this.resolveLimit = resolveLimit;
+    }
+    async listResources(orgId) {
+        const limitMicros = await this.resolveLimit(orgId);
+        if (!limitMicros)
+            return [];
+        return [{ system: 'ai', kind: 'budget', key: orgId, config: { limitMicros } }];
+    }
+}
 /**
  * Whether an application counts as up, or on its way there, from its own
  * Coolify `status` (`` `running:healthy`, `running:unknown`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wtfalch/foundry",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Foundry's SDK: the declared org's types, the plan and apply contracts, and the state store's interface.",
   "repository": {
     "type": "git",
@@ -42,6 +42,7 @@
   "dependencies": {
     "@wtfalch/audit": "0.6.0",
     "@wtfalch/auth": "0.16.0",
+    "@wtfalch/edge": "0.9.0",
     "@wtfalch/email": "^0.17.0",
     "@wtfalch/providers": "0.7.3",
     "ssh2": "1.17.0",