@wopr-network/platform-core 1.74.0 → 1.75.0

package/dist/fleet/drizzle-bot-instance-repository.d.ts

@@ -24,7 +24,9 @@ export declare class DrizzleBotInstanceRepository implements IBotInstanceReposit
     suspend(botId: string, graceDays: number): Promise<void>;
     reactivate(botId: string): Promise<void>;
     markDestroyed(botId: string): Promise<void>;
-    register(botId: string, tenantId: string, name: string): Promise<void>;
+    register(botId: string, tenantId: string, name: string, billingState?: BillingState): Promise<void>;
+    startBilling(botId: string): Promise<void>;
+    stopBilling(botId: string): Promise<void>;
     getStorageTier(botId: string): Promise<string | null>;
     setStorageTier(botId: string, tier: string): Promise<void>;
     listActiveStorageTiers(tenantId: string): Promise<string[]>;

package/dist/fleet/drizzle-bot-instance-repository.js

@@ -194,14 +194,20 @@ export class DrizzleBotInstanceRepository {
         })
             .where(eq(botInstances.id, botId));
     }
-    async register(botId, tenantId, name) {
+    async register(botId, tenantId, name, billingState = "inactive") {
         await this.db.insert(botInstances).values({
             id: botId,
             tenantId,
             name,
-            billingState: "active",
+            billingState,
         });
     }
+    async startBilling(botId) {
+        await this.db.update(botInstances).set({ billingState: "active" }).where(eq(botInstances.id, botId));
+    }
+    async stopBilling(botId) {
+        await this.db.update(botInstances).set({ billingState: "inactive" }).where(eq(botInstances.id, botId));
+    }
     async getStorageTier(botId) {
         const row = (await this.db
             .select({ storageTier: botInstances.storageTier })

package/dist/fleet/instance.d.ts

@@ -51,6 +51,14 @@ export declare class Instance {
     private withLock;
     /** Emit bot.created — call only from FleetManager.create(), not getInstance() */
     emitCreated(): void;
+    /**
+     * Start billing for this instance ($5/month prorated daily).
+     * Call after creation for persistent, billable instances (e.g., Paperclip).
+     * Ephemeral instances (e.g., Holy Ship) skip this — they bill per-token at the gateway.
+     */
+    startBilling(): Promise<void>;
+    /** Stop billing for this instance (e.g., on suspend or downgrade). */
+    stopBilling(): Promise<void>;
     start(): Promise<void>;
     stop(): Promise<void>;
     /**

package/dist/fleet/instance.js

@@ -71,6 +71,26 @@ export class Instance {
     emitCreated() {
         this.emit("bot.created");
     }
+    /**
+     * Start billing for this instance ($5/month prorated daily).
+     * Call after creation for persistent, billable instances (e.g., Paperclip).
+     * Ephemeral instances (e.g., Holy Ship) skip this — they bill per-token at the gateway.
+     */
+    async startBilling() {
+        if (!this.instanceRepo) {
+            logger.warn("startBilling() called but no instanceRepo available", { id: this.id });
+            return;
+        }
+        await this.instanceRepo.setBillingState(this.id, "active");
+        logger.info("Billing started for instance", { id: this.id, name: this.profile.name });
+    }
+    /** Stop billing for this instance (e.g., on suspend or downgrade). */
+    async stopBilling() {
+        if (!this.instanceRepo)
+            return;
+        await this.instanceRepo.setBillingState(this.id, "suspended");
+        logger.info("Billing stopped for instance", { id: this.id, name: this.profile.name });
+    }
     async start() {
         this.assertLocal("start()");
         return this.withLock(async () => {

package/dist/fleet/repository-types.d.ts

@@ -48,7 +48,7 @@ export interface SelfHostedNodeRegistration extends NodeRegistration {
     nodeSecretHash: string;
 }
 /** Billing lifecycle states for a bot instance. */
-export type BillingState = "active" | "suspended" | "destroyed";
+export type BillingState = "active" | "inactive" | "suspended" | "destroyed";
 /** Plain domain object for a bot instance — mirrors `bot_instances` table. */
 export interface BotInstance {
     id: string;

package/dist/gateway/proxy.js

@@ -19,7 +19,11 @@ import { creditBalanceCheck, debitCredits } from "./credit-gate.js";
 import { mapBudgetError, mapProviderError } from "./error-mapping.js";
 import { resolveTokenRates } from "./rate-lookup.js";
 import { proxySSEStream } from "./streaming.js";
-const DEFAULT_MARGIN = 1.3;
+/**
+ * Fallback only used when resolveMargin is not provided (tests only).
+ * Production MUST provide resolveMargin — mountRoutes enforces this.
+ */
+const TEST_ONLY_MARGIN = 1.3;
 /** Max call duration cap: 4 hours = 240 minutes. */
 const MAX_CALL_DURATION_MINUTES = 240;
 const phoneInboundBodySchema = z.object({
@@ -54,7 +58,11 @@ export function buildProxyDeps(config) {
         providers: config.providers,
         defaultModel: config.defaultModel,
         resolveDefaultModel: config.resolveDefaultModel,
-        defaultMargin: config.defaultMargin ?? DEFAULT_MARGIN,
+        get defaultMargin() {
+            if (config.resolveMargin)
+                return config.resolveMargin();
+            return config.defaultMargin ?? TEST_ONLY_MARGIN;
+        },
         fetchFn: config.fetchFn ?? fetch,
         arbitrageRouter: config.arbitrageRouter,
         rateLookupFn: config.rateLookupFn,

package/dist/gateway/types.d.ts

@@ -119,8 +119,10 @@ export interface GatewayConfig {
     graceBufferCents?: number;
     /** Upstream provider credentials */
     providers: ProviderConfig;
-    /** Default margin multiplier (default: 1.3 = 30%) */
+    /** Static margin (for tests only). Production should use resolveMargin. */
     defaultMargin?: number;
+    /** Live margin resolver — called per-request, reads from DB. Takes priority over defaultMargin. */
+    resolveMargin?: () => number;
     /** Optional arbitrage router for multi-provider cost optimization (WOP-463) */
     arbitrageRouter?: import("../monetization/arbitrage/router.js").ArbitrageRouter;
     /** Injectable fetch for testing */

package/dist/index.js

@@ -24,3 +24,7 @@ export * from "./security/index.js";
 export * from "./tenancy/index.js";
 // tRPC
 export * from "./trpc/index.js";
+// monorepo e2e cutover test
+// hybrid dockerfile e2e
+// sequential build test
+// lockfile build

package/dist/monetization/credits/bot-billing.test.js

@@ -50,6 +50,7 @@ function createMockDeps(nodeId = "node-1") {
 describe("BotBilling", () => {
     let pool;
     let db;
+    let repo;
     let billing;
     let ledger;
     beforeAll(async () => {
@@ -60,13 +61,15 @@ describe("BotBilling", () => {
     });
     beforeEach(async () => {
         await truncateAllTables(pool);
-        billing = new BotBilling(new DrizzleBotInstanceRepository(db));
+        repo = new DrizzleBotInstanceRepository(db);
+        billing = new BotBilling(repo);
         ledger = new DrizzleLedger(db);
         await ledger.seedSystemAccounts();
     });
     describe("registerBot", () => {
         it("registers a bot in active billing state", async () => {
             await billing.registerBot("bot-1", "tenant-1", "my-bot");
+            await repo.startBilling("bot-1");
             const info = await billing.getBotBilling("bot-1");
             expect(info).not.toBeNull();
             // biome-ignore lint/suspicious/noExplicitAny: intentional test cast
@@ -87,19 +90,25 @@ describe("BotBilling", () => {
         });
         it("counts only active bots for the tenant", async () => {
             await billing.registerBot("bot-1", "tenant-1", "bot-a");
+            await repo.startBilling("bot-1");
             await billing.registerBot("bot-2", "tenant-1", "bot-b");
+            await repo.startBilling("bot-2");
             await billing.registerBot("bot-3", "tenant-2", "bot-c");
+            await repo.startBilling("bot-3");
             expect(await billing.getActiveBotCount("tenant-1")).toBe(2);
             expect(await billing.getActiveBotCount("tenant-2")).toBe(1);
         });
         it("does not count suspended bots", async () => {
             await billing.registerBot("bot-1", "tenant-1", "bot-a");
+            await repo.startBilling("bot-1");
             await billing.registerBot("bot-2", "tenant-1", "bot-b");
+            await repo.startBilling("bot-2");
             await billing.suspendBot("bot-1");
             expect(await billing.getActiveBotCount("tenant-1")).toBe(1);
         });
         it("does not count destroyed bots", async () => {
             await billing.registerBot("bot-1", "tenant-1", "bot-a");
+            await repo.startBilling("bot-1");
             await billing.destroyBot("bot-1");
             expect(await billing.getActiveBotCount("tenant-1")).toBe(0);
         });
@@ -107,6 +116,7 @@ describe("BotBilling", () => {
     describe("suspendBot", () => {
         it("transitions bot from active to suspended", async () => {
             await billing.registerBot("bot-1", "tenant-1", "my-bot");
+            await repo.startBilling("bot-1");
             await billing.suspendBot("bot-1");
             const info = await billing.getBotBilling("bot-1");
             // biome-ignore lint/suspicious/noExplicitAny: intentional test cast
@@ -118,6 +128,7 @@ describe("BotBilling", () => {
         });
         it("sets destroyAfter to 30 days after suspension", async () => {
             await billing.registerBot("bot-1", "tenant-1", "my-bot");
+            await repo.startBilling("bot-1");
             await billing.suspendBot("bot-1");
             const info = await billing.getBotBilling("bot-1");
             expect(info).not.toBeNull();
@@ -132,8 +143,11 @@ describe("BotBilling", () => {
     describe("suspendAllForTenant", () => {
         it("suspends all active bots for a tenant", async () => {
             await billing.registerBot("bot-1", "tenant-1", "bot-a");
+            await repo.startBilling("bot-1");
             await billing.registerBot("bot-2", "tenant-1", "bot-b");
+            await repo.startBilling("bot-2");
             await billing.registerBot("bot-3", "tenant-2", "bot-c");
+            await repo.startBilling("bot-3");
             const suspended = await billing.suspendAllForTenant("tenant-1");
             expect(suspended.sort()).toEqual(["bot-1", "bot-2"]);
             expect(await billing.getActiveBotCount("tenant-1")).toBe(0);
@@ -147,6 +161,7 @@ describe("BotBilling", () => {
     describe("reactivateBot", () => {
         it("transitions bot from suspended to active", async () => {
             await billing.registerBot("bot-1", "tenant-1", "my-bot");
+            await repo.startBilling("bot-1");
             await billing.suspendBot("bot-1");
             await billing.reactivateBot("bot-1");
             const info = await billing.getBotBilling("bot-1");
@@ -159,6 +174,7 @@ describe("BotBilling", () => {
         });
         it("does not reactivate a destroyed bot", async () => {
             await billing.registerBot("bot-1", "tenant-1", "my-bot");
+            await repo.startBilling("bot-1");
             await billing.destroyBot("bot-1");
             await billing.reactivateBot("bot-1");
             const info = await billing.getBotBilling("bot-1");
@@ -167,6 +183,7 @@ describe("BotBilling", () => {
         });
         it("does not affect already-active bots", async () => {
             await billing.registerBot("bot-1", "tenant-1", "my-bot");
+            await repo.startBilling("bot-1");
             await billing.reactivateBot("bot-1");
             const info = await billing.getBotBilling("bot-1");
             // biome-ignore lint/suspicious/noExplicitAny: intentional test cast
@@ -176,7 +193,9 @@ describe("BotBilling", () => {
     describe("checkReactivation", () => {
         it("reactivates suspended bots when balance is positive", async () => {
             await billing.registerBot("bot-1", "tenant-1", "bot-a");
+            await repo.startBilling("bot-1");
             await billing.registerBot("bot-2", "tenant-1", "bot-b");
+            await repo.startBilling("bot-2");
             await billing.suspendBot("bot-1");
             await billing.suspendBot("bot-2");
             await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", {
@@ -190,6 +209,7 @@ describe("BotBilling", () => {
         });
         it("does not reactivate when balance is zero", async () => {
             await billing.registerBot("bot-1", "tenant-1", "bot-a");
+            await repo.startBilling("bot-1");
             await billing.suspendBot("bot-1");
             const reactivated = await billing.checkReactivation("tenant-1", ledger);
             expect(reactivated).toEqual([]);
@@ -197,6 +217,7 @@ describe("BotBilling", () => {
         });
         it("does not reactivate destroyed bots", async () => {
             await billing.registerBot("bot-1", "tenant-1", "bot-a");
+            await repo.startBilling("bot-1");
             await billing.destroyBot("bot-1");
             await ledger.credit("tenant-1", Credit.fromCents(500), "purchase", {
                 description: "test credit",
@@ -219,6 +240,7 @@ describe("BotBilling", () => {
     describe("destroyBot", () => {
         it("marks bot as destroyed", async () => {
             await billing.registerBot("bot-1", "tenant-1", "my-bot");
+            await repo.startBilling("bot-1");
             await billing.destroyBot("bot-1");
             const info = await billing.getBotBilling("bot-1");
             // biome-ignore lint/suspicious/noExplicitAny: intentional test cast
@@ -228,6 +250,7 @@ describe("BotBilling", () => {
     describe("destroyExpiredBots", () => {
         it("destroys bots past their grace period", async () => {
             await billing.registerBot("bot-1", "tenant-1", "bot-a");
+            await repo.startBilling("bot-1");
             // Set destroyAfter to the past using drizzle sql
             await db
                 .update(botInstances)
@@ -245,6 +268,7 @@ describe("BotBilling", () => {
         });
         it("does not destroy bots still within grace period", async () => {
             await billing.registerBot("bot-1", "tenant-1", "bot-a");
+            await repo.startBilling("bot-1");
             await billing.suspendBot("bot-1");
             const destroyed = await billing.destroyExpiredBots();
             expect(destroyed).toEqual([]);
@@ -254,6 +278,7 @@ describe("BotBilling", () => {
         });
         it("does not touch active bots", async () => {
             await billing.registerBot("bot-1", "tenant-1", "bot-a");
+            await repo.startBilling("bot-1");
             const destroyed = await billing.destroyExpiredBots();
             expect(destroyed).toEqual([]);
         });
@@ -316,13 +341,16 @@ describe("BotBilling", () => {
         });
         it("returns correct daily cost for known storage tiers", async () => {
             await billing.registerBot("bot-1", "tenant-1", "bot-a");
+            await repo.startBilling("bot-1");
             await billing.setStorageTier("bot-1", "pro");
             await billing.registerBot("bot-2", "tenant-1", "bot-b");
+            await repo.startBilling("bot-2");
             await billing.setStorageTier("bot-2", "plus");
             expect((await billing.getStorageTierCostsForTenant("tenant-1")).toCents()).toBe(11);
         });
         it("returns 0 for unknown storage tier (fallback branch)", async () => {
             await billing.registerBot("bot-1", "tenant-1", "bot-a");
+            await repo.startBilling("bot-1");
             // Bypass setStorageTier to insert an unrecognized tier value directly
             await pool.query(`UPDATE bot_instances SET storage_tier = 'unknown_tier' WHERE id = 'bot-1'`);
             // STORAGE_TIERS['unknown_tier'] is undefined → Credit.ZERO fallback
@@ -330,6 +358,7 @@ describe("BotBilling", () => {
         });
         it("does not include suspended bots in storage tier cost", async () => {
             await billing.registerBot("bot-1", "tenant-1", "bot-a");
+            await repo.startBilling("bot-1");
             await billing.setStorageTier("bot-1", "pro");
             await billing.suspendBot("bot-1");
             expect((await billing.getStorageTierCostsForTenant("tenant-1")).toCents()).toBe(0);
@@ -338,8 +367,11 @@ describe("BotBilling", () => {
     describe("listForTenant", () => {
         it("lists all bots regardless of billing state", async () => {
             await billing.registerBot("bot-1", "tenant-1", "bot-a");
+            await repo.startBilling("bot-1");
             await billing.registerBot("bot-2", "tenant-1", "bot-b");
+            await repo.startBilling("bot-2");
             await billing.registerBot("bot-3", "tenant-2", "bot-c");
+            await repo.startBilling("bot-3");
             await billing.suspendBot("bot-2");
             const bots = await billing.listForTenant("tenant-1");
             // biome-ignore lint/suspicious/noExplicitAny: intentional test cast
@@ -349,6 +381,7 @@ describe("BotBilling", () => {
     describe("full lifecycle", () => {
         it("active -> suspended -> reactivated -> active", async () => {
             await billing.registerBot("bot-1", "tenant-1", "my-bot");
+            await repo.startBilling("bot-1");
             // biome-ignore lint/suspicious/noExplicitAny: intentional test cast
             expect((await billing.getBotBilling("bot-1"))?.billingState).toBe("active");
             await billing.suspendBot("bot-1");
@@ -365,6 +398,7 @@ describe("BotBilling", () => {
         });
         it("active -> suspended -> destroyed (after grace period)", async () => {
             await billing.registerBot("bot-1", "tenant-1", "my-bot");
+            await repo.startBilling("bot-1");
             await billing.suspendBot("bot-1");
             await db.update(botInstances).set({ destroyAfter: sql `now() - interval '1 day'` }).where(sql `id = 'bot-1'`);
             await billing.destroyExpiredBots();

package/dist/monetization/credits/runtime-cron.d.ts

@@ -1,9 +1,17 @@
 import type { ILedger } from "@wopr-network/platform-core/credits";
 import { Credit } from "@wopr-network/platform-core/credits";
 import type { IBotInstanceRepository } from "../../fleet/bot-instance-repository.js";
+/** Monthly bot cost in dollars. */
+export declare const MONTHLY_BOT_COST_DOLLARS = 5;
 /**
- * Bot runtime cost: $5/bot/month prorated daily.
- * $5.00 / 30 ≈ $0.1667/day, rounded to $0.17.
+ * Compute the daily bot cost for a given date, prorated by the actual
+ * number of days in that month. Uses nano-dollar precision so totals
+ * sum to exactly $5.00/month (no over/under-billing).
+ */
+export declare function dailyBotCost(date: string): Credit;
+/**
+ * @deprecated Use dailyBotCost(date) for accurate per-month proration.
+ * Kept for backwards compat in tests.
  */
 export declare const DAILY_BOT_COST: Credit;
 /** Callback invoked when a tenant's balance hits zero during deduction. */

package/dist/monetization/credits/runtime-cron.js

@@ -1,9 +1,23 @@
 import { Credit, InsufficientBalanceError } from "@wopr-network/platform-core/credits";
 import { logger } from "../../config/logger.js";
 import { RESOURCE_TIERS } from "../../fleet/resource-tiers.js";
+/** Monthly bot cost in dollars. */
+export const MONTHLY_BOT_COST_DOLLARS = 5;
 /**
- * Bot runtime cost: $5/bot/month prorated daily.
- * $5.00 / 30 ≈ $0.1667/day, rounded to $0.17.
+ * Compute the daily bot cost for a given date, prorated by the actual
+ * number of days in that month. Uses nano-dollar precision so totals
+ * sum to exactly $5.00/month (no over/under-billing).
+ */
+export function dailyBotCost(date) {
+    const d = new Date(date);
+    const year = d.getFullYear();
+    const month = d.getMonth();
+    const daysInMonth = new Date(year, month + 1, 0).getDate();
+    return Credit.fromDollars(MONTHLY_BOT_COST_DOLLARS / daysInMonth);
+}
+/**
+ * @deprecated Use dailyBotCost(date) for accurate per-month proration.
+ * Kept for backwards compat in tests.
  */
 export const DAILY_BOT_COST = Credit.fromCents(17);
 /** Low balance threshold ($1.00 = 20% of signup grant). */
@@ -66,14 +80,15 @@ export async function runRuntimeDeductions(cfg) {
                     result.skipped.push(tenantId);
                 continue;
             }
-            const totalCost = DAILY_BOT_COST.multiply(botCount);
+            const dailyCost = dailyBotCost(cfg.date);
+            const totalCost = dailyCost.multiply(botCount);
             let didBillAnything = false;
             // Bill runtime debit (skipped if already billed on a previous run)
             if (!runtimeAlreadyBilled) {
                 if (!balance.lessThan(totalCost)) {
                     // Full deduction
                     await cfg.ledger.debit(tenantId, totalCost, "bot_runtime", {
-                        description: `Daily runtime: ${botCount} bot(s) x $${DAILY_BOT_COST.toDollars().toFixed(2)}`,
+                        description: `Daily runtime: ${botCount} bot(s) x $${dailyCost.toDollars().toFixed(4)}`,
                         referenceId: runtimeRef,
                     });
                 }