@assemblyline-agents/runtime 0.1.0

package/dist/usage-budget.js

@@ -0,0 +1,145 @@
+import { UsageAccountingError, usdToMicros } from "./usage-records.js";
+const FOREVER = "9999-12-31T23:59:59.999Z";
+export class UsageBudgetExceededError extends Error {
+    rejection;
+    code = "usage_budget_exceeded";
+    constructor(rejection) {
+        super(`Usage budget exceeded for ${rejection.limit.scope} (${rejection.limit.key}).`);
+        this.rejection = rejection;
+        this.name = "UsageBudgetExceededError";
+    }
+}
+export function resolveUsageBudget(configured, env, stableAgentId) {
+    const request = {
+        ...configured?.request,
+        ...reservationFromEnv(env)
+    };
+    const budget = { request };
+    assignPeriod(budget, "run", configured?.run, limitFromEnv(env, "OPENEVE_RUN_BUDGET"));
+    assignPeriod(budget, "daily", configured?.daily, limitFromEnv(env, "OPENEVE_DAILY_BUDGET"));
+    assignPeriod(budget, "monthly", configured?.monthly, limitFromEnv(env, "OPENEVE_MONTHLY_BUDGET"));
+    if (!budget.run && !budget.daily && !budget.monthly)
+        return undefined;
+    validateReservationCoverage(budget);
+    if ((budget.daily || budget.monthly) && !stableAgentId?.trim()) {
+        throw new UsageAccountingError("Daily and monthly usage budgets require agent.id so redeploying cannot reset the enforcement identity.", "usage_budget_unstable_agent_identity");
+    }
+    return budget;
+}
+export function usageAgentId(manifest, run) {
+    const root = manifest.agent.id?.trim() ? `agent:${manifest.agent.id.trim()}` : manifest.agentRevision;
+    const subagent = typeof run.input.subagent === "string" ? run.input.subagent : undefined;
+    const identity = subagent ? `${root}/subagent:${subagent}` : root;
+    const result = { agentId: identity };
+    if (subagent)
+        result.subagent = subagent;
+    if (typeof run.input.parentRunId === "string")
+        result.parentRunId = run.input.parentRunId;
+    return result;
+}
+export function usageReservationInput(input) {
+    const now = input.now ?? new Date();
+    const limits = budgetLimits(input.budget, input.run, input.agentId, now);
+    const reservation = {
+        idempotencyKey: input.idempotencyKey,
+        runId: input.run.id,
+        agentId: input.agentId,
+        reserveCostMicros: input.budget.request.costUsd === undefined
+            ? "0"
+            : usdToMicros(input.budget.request.costUsd),
+        reserveInputTokens: input.budget.request.inputTokens ?? 0,
+        reserveOutputTokens: input.budget.request.outputTokens ?? 0,
+        limits
+    };
+    if (input.provider)
+        reservation.provider = input.provider;
+    if (input.model)
+        reservation.model = input.model;
+    if (input.billingMode)
+        reservation.billingMode = input.billingMode;
+    return reservation;
+}
+function budgetLimits(budget, run, agentId, now) {
+    const limits = [];
+    if (budget.run) {
+        limits.push(limitSnapshot("run", `run:${run.id}`, run.createdAt, FOREVER, budget.run, {
+            runId: run.id,
+            agentId
+        }));
+    }
+    if (budget.daily) {
+        const start = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate()));
+        const end = new Date(start);
+        end.setUTCDate(end.getUTCDate() + 1);
+        limits.push(limitSnapshot("agent_day", `agent:${agentId}:day:${start.toISOString().slice(0, 10)}`, start.toISOString(), end.toISOString(), budget.daily, { agentId }));
+    }
+    if (budget.monthly) {
+        const start = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), 1));
+        const end = new Date(Date.UTC(now.getUTCFullYear(), now.getUTCMonth() + 1, 1));
+        limits.push(limitSnapshot("agent_month", `agent:${agentId}:month:${start.toISOString().slice(0, 7)}`, start.toISOString(), end.toISOString(), budget.monthly, { agentId }));
+    }
+    return limits;
+}
+function limitSnapshot(scope, key, windowStart, windowEnd, limit, identity) {
+    const snapshot = { scope, key, windowStart, windowEnd };
+    if (identity.runId)
+        snapshot.runId = identity.runId;
+    if (identity.agentId)
+        snapshot.agentId = identity.agentId;
+    if (limit.costUsd !== undefined)
+        snapshot.maxCostMicros = usdToMicros(limit.costUsd);
+    if (limit.inputTokens !== undefined)
+        snapshot.maxInputTokens = limit.inputTokens;
+    if (limit.outputTokens !== undefined)
+        snapshot.maxOutputTokens = limit.outputTokens;
+    return snapshot;
+}
+function validateReservationCoverage(budget) {
+    const periods = [budget.run, budget.daily, budget.monthly].filter(Boolean);
+    for (const dimension of ["costUsd", "inputTokens", "outputTokens"]) {
+        const limited = periods.some((period) => period?.[dimension] !== undefined);
+        if (limited && budget.request[dimension] === undefined) {
+            throw new Error(`Usage budgets limiting ${dimension} require budget.request.${dimension}.`);
+        }
+    }
+}
+function reservationFromEnv(env) {
+    return compactLimit({
+        costUsd: positiveNumber(env.OPENEVE_MODEL_REQUEST_RESERVE_USD),
+        inputTokens: positiveInteger(env.OPENEVE_MODEL_REQUEST_RESERVE_INPUT_TOKENS),
+        outputTokens: positiveInteger(env.OPENEVE_MODEL_REQUEST_RESERVE_OUTPUT_TOKENS)
+    });
+}
+function limitFromEnv(env, prefix) {
+    const limit = compactLimit({
+        costUsd: positiveNumber(env[`${prefix}_USD`]),
+        inputTokens: positiveInteger(env[`${prefix}_INPUT_TOKENS`]),
+        outputTokens: positiveInteger(env[`${prefix}_OUTPUT_TOKENS`])
+    });
+    return Object.keys(limit).length > 0 ? limit : undefined;
+}
+function compactLimit(value) {
+    return Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
+}
+function assignPeriod(budget, key, configured, fromEnv) {
+    const merged = { ...configured, ...fromEnv };
+    if (Object.keys(merged).length > 0)
+        budget[key] = merged;
+}
+function positiveNumber(value) {
+    if (value === undefined || value.trim() === "")
+        return undefined;
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        throw new Error(`Invalid positive number: ${value}.`);
+    return parsed;
+}
+function positiveInteger(value) {
+    const parsed = positiveNumber(value);
+    if (parsed === undefined)
+        return undefined;
+    if (!Number.isSafeInteger(parsed))
+        throw new Error(`Invalid positive integer: ${value}.`);
+    return parsed;
+}
+//# sourceMappingURL=usage-budget.js.map

package/dist/usage-budget.js.map

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

package/dist/usage-reconciliation.d.ts

@@ -0,0 +1,76 @@
+import type { UsageAggregate, UsageStore } from "./state.js";
+export interface UsageReconciliationReport {
+    provider: string;
+    from: string;
+    to: string;
+    transactions: UsageAggregate;
+    controlTotals: UsageAggregate;
+    variance: {
+        inputTokens: string;
+        outputTokens: string;
+        cachedTokens: string;
+        reasoningTokens: string;
+        actualCostMicros: string;
+    };
+    coverage: {
+        transactionRecords: string;
+        unreconciledTransactionTokenRecords: string;
+        unreconciledTransactionRecords: string;
+        controlTotalRecords: string;
+        exactRunTokenCoverage: boolean;
+        exactRunCostCoverage: boolean;
+        providerControlTotalsAvailable: boolean;
+    };
+}
+export interface ProviderReconciliationResult {
+    provider: string;
+    from: string;
+    to: string;
+    recordedControlTotals: number;
+    reconciledTransactions: number;
+    report: UsageReconciliationReport;
+}
+export interface OpenAIOrganizationReconciliationOptions {
+    state: UsageStore;
+    adminKey: string;
+    from: string;
+    to?: string;
+    provider?: string;
+    projectIds?: string[];
+    apiKeyIds?: string[];
+    agentByProjectId?: Record<string, string>;
+    agentByApiKeyId?: Record<string, string>;
+    settlementLagHours?: number;
+    now?: Date;
+    fetch?: typeof fetch;
+    baseUrl?: string;
+}
+/**
+ * Import settled OpenAI organization token and cash control totals.
+ *
+ * Control totals are deliberately separate from transaction records. A
+ * project/API-key mapping is the only way they receive an agentId; OpenEve
+ * never invents per-run cost attribution from aggregate provider invoices.
+ */
+export declare function reconcileOpenAIOrganization(options: OpenAIOrganizationReconciliationOptions): Promise<ProviderReconciliationResult>;
+export interface OpenRouterReconciliationOptions {
+    state: UsageStore;
+    apiKey?: string;
+    managementKey?: string;
+    from: string;
+    to?: string;
+    provider?: string;
+    apiKeyHash?: string;
+    agentId?: string;
+    now?: Date;
+    fetch?: typeof fetch;
+    baseUrl?: string;
+}
+/** Retry missing generation receipts and import completed OpenRouter activity totals. */
+export declare function reconcileOpenRouterUsage(options: OpenRouterReconciliationOptions): Promise<ProviderReconciliationResult>;
+export declare function usageReconciliationReport(state: UsageStore, input: {
+    provider: string;
+    from: string;
+    to: string;
+}): Promise<UsageReconciliationReport>;
+//# sourceMappingURL=usage-reconciliation.d.ts.map

package/dist/usage-reconciliation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-reconciliation.d.ts","sourceRoot":"","sources":["../src/usage-reconciliation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EAGd,UAAU,EACX,MAAM,YAAY,CAAC;AAyBpB,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,cAAc,CAAC;IAC7B,aAAa,EAAE,cAAc,CAAC;IAC9B,QAAQ,EAAE;QACR,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,QAAQ,EAAE;QACR,kBAAkB,EAAE,MAAM,CAAC;QAC3B,mCAAmC,EAAE,MAAM,CAAC;QAC5C,8BAA8B,EAAE,MAAM,CAAC;QACvC,mBAAmB,EAAE,MAAM,CAAC;QAC5B,qBAAqB,EAAE,OAAO,CAAC;QAC/B,oBAAoB,EAAE,OAAO,CAAC;QAC9B,8BAA8B,EAAE,OAAO,CAAC;KACzC,CAAC;CACH;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,MAAM,EAAE,yBAAyB,CAAC;CACnC;AAED,MAAM,WAAW,uCAAuC;IACtD,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,uCAAuC,GAC/C,OAAO,CAAC,4BAA4B,CAAC,CA4GvC;AAED,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,yFAAyF;AACzF,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,4BAA4B,CAAC,CA0FvC;AAED,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACpD,OAAO,CAAC,yBAAyB,CAAC,CAsCpC"}