@beacon-build/sdk 2.18.0 → 3.1.0

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # @beacon-build/sdk Changelog
 
+## 3.1.0
+
+### Patch Changes
+
+- 7fb17e4: F716 AC-15: server-side quota-account attribution for oauth_quota entries from local producers (claude/antigravity/opencode) via a 3-step session-trigger/agent-controller resolution.
+- ec57e48: B1009: createTenantAgentClient presents the AS token directly — no /v1/oauth/token-exchange round trip
+- Updated dependencies [e0b06d7]
+- Updated dependencies [3004194]
+- Updated dependencies [1d4d63b]
+- Updated dependencies [89fb227]
+- Updated dependencies [74c4d19]
+- Updated dependencies [e9d671e]
+- Updated dependencies [338f526]
+- Updated dependencies [c88c742]
+- Updated dependencies [35cca5c]
+- Updated dependencies [51e8a8b]
+    - @beacon-build/core@3.1.0
+
+## 3.0.0
+
+### Minor Changes
+
+- b32af03: F564 seat fees & gating (FS64-B): seat tiers from the role history (highest role held in the month), fee-bearing periods (trial free, pro-rata start/reactivation month, deploy-backfill start), company/personal seat fees with forecast and cost-centre allocation, invoice positions (first, monthly, reactivation; credits carried), write-once seat snapshots with the billing-tier-snapshot / billing-start-snapshot workers, GET /api/v1/billing/seat-fees and /billing/entities (scoped) + SDK, company-wide contributor gating on every org-role write path with ceiling degradation, onboarding Solo/Community choice, readable gating errors in the org administration. The SDK reads apiCode also from the nested { error: { code } } envelope. `@beacon-build/ops`'s `clean-completed-jobs.mjs` gains the new `billing-tier-snapshot`/`billing-start-snapshot` queue names to its known-queues cleanup list.
+- 14ea748: FS64 billing read side and model spend. C907: billable windows (activation periods ∩ metering start ∩ inactive cut) shared by seat fees, the new GET /api/v1/billing/requests read API (+ SDK `billing.getBillableRequests`) and a fail-closed monthly request compaction (`billing_request_months`, 35-day minute detail, 10-year aggregate). F567: Cost Cockpit with two tabs — "Platform-Gebühr" (default; tier/segment, billable requests human vs agents, seat fee to date + forecast, collar band, seat table, read-only price table editable by vendors, requests drilldown person → agent → project, org-admin link) and "Modell-Spend (BYOK)" with spend-vs-budget; seat-fee read carries the period price version and the company-fee forecast. F706: payment method per turn (`api_key | oauth_quota | unknown`) and quota account on messages, ledger and rollup; reconcile never treats OAuth-quota turns as unpriced; BYOK payment split, quota cards and quota settings (`quota.config`), GET /api/v1/usage/quota; budget DM notifier, user/org budgets and weekly periods.
+
+### Patch Changes
+
+- 23d25e1: F709: add the new public asset read route and asset content route to the API<->SDK negative list — both are browser byte streams with no SDK method, verified by the INV-3 drift test.
+- Updated dependencies [27eb246]
+- Updated dependencies [55a8d7d]
+- Updated dependencies [b32af03]
+- Updated dependencies [e952551]
+- Updated dependencies [9514f22]
+- Updated dependencies [14ea748]
+- Updated dependencies [02227ba]
+- Updated dependencies [23d25e1]
+- Updated dependencies [b1cb09c]
+    - @beacon-build/core@3.0.0
+
 ## 2.18.0
 
 ### Minor Changes

package/dist/clients/billing-requests.types.d.ts

@@ -0,0 +1,48 @@
+/**
+ * C907 AC-6 — wire types of `GET /api/v1/billing/requests`: billable requests of one billing
+ * entity × UTC month, final (reconciled) vs. provisional, per person / agent / project / cost
+ * centre, plus the coverage gap (`unattributed`).
+ */
+import type { SeatFeesQuery } from './billing-seat-fees.types.js';
+/** Same addressing as the seat-fee read (C907 D7 default without billingOrgId / userId). */
+export type BillableRequestsQuery = SeatFeesQuery;
+export interface ProjectRequestsDto {
+    project: string;
+    requests: number;
+}
+export interface BillableRequestsPersonDto {
+    userId: string;
+    billableFinal: number;
+    billableProvisional: number;
+    human: number;
+    agents: Array<{
+        agentId: string;
+        name: string;
+        requests: number;
+        byProject: ProjectRequestsDto[];
+    }>;
+    byProject: ProjectRequestsDto[];
+    byCostCenter: Array<{
+        orgId: string;
+        requests: number;
+    }>;
+}
+export interface BillableRequestsDto {
+    period: string;
+    billingEntity: {
+        type: 'org' | 'user';
+        id: string;
+    };
+    isFinal: boolean;
+    reconciledThrough: string | null;
+    persons: BillableRequestsPersonDto[];
+    unattributed: {
+        requests: number;
+    };
+    totals: {
+        billableFinal: number;
+        billableProvisional: number;
+        unattributed: number;
+    };
+}
+//# sourceMappingURL=billing-requests.types.d.ts.map

package/dist/clients/billing-requests.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-requests.types.d.ts","sourceRoot":"","sources":["../../src/clients/billing-requests.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAEjE,4FAA4F;AAC5F,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAA;AAEjD,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,yBAAyB;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE,MAAM,CAAA;IACrB,mBAAmB,EAAE,MAAM,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,KAAK,CAAC;QACV,OAAO,EAAE,MAAM,CAAA;QACf,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,kBAAkB,EAAE,CAAA;KAClC,CAAC,CAAA;IACF,SAAS,EAAE,kBAAkB,EAAE,CAAA;IAC/B,YAAY,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC3D;AAED,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,aAAa,EAAE;QAAE,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IACnD,OAAO,EAAE,OAAO,CAAA;IAChB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,OAAO,EAAE,yBAAyB,EAAE,CAAA;IACpC,YAAY,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IAClC,MAAM,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,mBAAmB,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAA;CACvF"}

package/dist/clients/billing-requests.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=billing-requests.types.js.map

package/dist/clients/billing-requests.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-requests.types.js","sourceRoot":"","sources":["../../src/clients/billing-requests.types.ts"],"names":[],"mappings":""}

package/dist/clients/billing-seat-fees.types.d.ts

@@ -0,0 +1,105 @@
+/**
+ * F564 Scope 8 — wire types of `GET /api/v1/billing/seat-fees` and `GET /api/v1/billing/entities`
+ * (canonical field names, amounts as 2-digit decimal strings, ISO instants).
+ */
+import type { BillingStatusValue, InactiveReasonValue } from './billing.client.js';
+export type LadderRoleDto = 'viewer' | 'reviewer' | 'contributor';
+export type BillingTierDto = 'viewer' | 'community' | 'solo' | 'org_contributor' | 'org_reviewer';
+export interface InvoiceDto {
+    invoiceDate: string | null;
+    isFirstInvoice: boolean;
+    isReactivationInvoice: boolean;
+    hasPositions: boolean;
+    advanceFloorChf: string | null;
+    trueUpChf: string | null;
+    creditBroughtForwardChf: string;
+    amountDueChf: string;
+    creditCarriedChf: string;
+}
+export interface SeatFeePersonDto {
+    userId: string;
+    name: string;
+    tier: BillingTierDto;
+    highestRoleSource: Array<{
+        orgId: string;
+        role: LadderRoleDto;
+    }>;
+    departmentRoles: Array<{
+        orgId: string;
+        orgName: string | null;
+        role: LadderRoleDto;
+        heldUntil: string | null;
+    }>;
+    requests: number;
+    feeChf: string;
+    forecastFeeChf: string | null;
+    byCostCenter: Array<{
+        orgId: string;
+        requests: number;
+        feeShareChf: string;
+    }>;
+}
+export interface SeatFeesDto {
+    period: string;
+    isFinal: boolean;
+    billingEntity: {
+        type: 'org' | 'user';
+        id: string;
+        name: string;
+        billingStatus: BillingStatusValue;
+        inactiveReason: InactiveReasonValue | null;
+        trialEndsAt: string | null;
+        billingStartsAt: string | null;
+        reactivatedAt: string | null;
+        proRataDays: number | null;
+        proRataFactor: string | null;
+        firstInvoiceChf: string | null;
+        cancelEffectiveAt: string | null;
+    };
+    orgFee: {
+        sum: string;
+        total: string;
+        floorApplied: boolean;
+        /** Company fee at month end — running month only, else `null`. */
+        forecastTotal: string | null;
+    } | null;
+    /** The price version in effect for this period (collar formula / band). */
+    pricing: {
+        version: number;
+        unitPriceChf: string;
+        tiers: Array<{
+            tier: BillingTierDto;
+            floorChf: string;
+            capChf: string;
+        }>;
+    };
+    invoice: InvoiceDto | null;
+    reactivationInvoice: InvoiceDto | null;
+    persons: SeatFeePersonDto[];
+}
+export interface SeatFeesQuery {
+    period: string;
+    billingOrgId?: string;
+    userId?: string;
+    costCenterOrgId?: string;
+}
+export interface BillingEntityRowDto {
+    id: string;
+    type: 'org' | 'user';
+    name: string;
+    segment: string | null;
+    billingStatus: BillingStatusValue;
+    inactiveReason: InactiveReasonValue | null;
+    trialEndsAt: string | null;
+    billingStartsAt: string | null;
+    firstInvoiceChf: string | null;
+    cancelEffectiveAt: string | null;
+    persons: number;
+    requests: number;
+    feeSoFarChf: string | null;
+    feeError: {
+        code: string;
+        message: string;
+    } | null;
+}
+//# sourceMappingURL=billing-seat-fees.types.d.ts.map

package/dist/clients/billing-seat-fees.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-seat-fees.types.d.ts","sourceRoot":"","sources":["../../src/clients/billing-seat-fees.types.ts"],"names":[],"mappings":"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"}

package/dist/clients/billing-seat-fees.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=billing-seat-fees.types.js.map

package/dist/clients/billing-seat-fees.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-seat-fees.types.js","sourceRoot":"","sources":["../../src/clients/billing-seat-fees.types.ts"],"names":[],"mappings":""}

package/dist/clients/billing.client.d.ts

@@ -0,0 +1,121 @@
+/**
+ * billing.client.ts — FS64: typed SDK client for pricing (F564) and the subscription lifecycle
+ * (F705). `pricing()` is PUBLIC (no token needed) — beacon-web reads the same values as the
+ * cockpit (one source, no drift). Billing errors surface as typed subclasses of SdkError.
+ */
+import type { HttpClient } from '../transport/http-client.js';
+import { SdkError } from '../transport/errors.js';
+import type { BillingEntityRowDto, SeatFeesDto, SeatFeesQuery } from './billing-seat-fees.types.js';
+import type { BillableRequestsDto, BillableRequestsQuery } from './billing-requests.types.js';
+export type BillingStatusValue = 'trialing' | 'active' | 'cancelling' | 'past_due' | 'inactive';
+export type InactiveReasonValue = 'cancelled' | 'payment_overdue' | 'payment_required';
+export interface PricingTierDto {
+    tier: 'community' | 'solo' | 'org_contributor' | 'org_reviewer' | 'viewer';
+    segment: 'individual' | 'org' | 'any';
+    floorChf: string;
+    capChf: string;
+    condition: 'osi_public_repo' | 'requires_active_contributor' | null;
+}
+export interface PricingDto {
+    version: number;
+    effectiveFrom: string;
+    unitPriceChf: string;
+    trialDays: number;
+    tiers: PricingTierDto[];
+}
+export interface PricingVersionDto extends PricingDto {
+    id: string;
+    createdAt: string;
+    createdBy: string;
+    isEffective: boolean;
+    isPending: boolean;
+}
+export interface PricingInputDto {
+    unitPriceChf: string;
+    trialDays: number;
+    tiers: Array<{
+        tier: 'community' | 'solo' | 'org_contributor' | 'org_reviewer';
+        floorChf: string;
+        capChf: string;
+    }>;
+}
+export interface BillingStatusDto {
+    status: BillingStatusValue;
+    inactiveReason: InactiveReasonValue | null;
+    subscribedAt: string | null;
+    trialEndsAt: string | null;
+    billingStartsAt: string | null;
+    cancelledAt: string | null;
+    cancelEffectiveAt: string | null;
+    reactivatedAt: string | null;
+    pastDueAt: string | null;
+}
+export interface CompanyBillingStatusDto {
+    rootOrgId: string;
+    rootOrgName: string;
+    status: BillingStatusValue;
+    inactiveReason: InactiveReasonValue | null;
+    trialEndsAt: string | null;
+    billingStartsAt: string | null;
+    cancelEffectiveAt: string | null;
+}
+export interface UserBillingStatusDto {
+    personal: (BillingStatusDto & {
+        segment: 'solo' | 'community' | null;
+    }) | null;
+    companies: CompanyBillingStatusDto[];
+}
+/** 403/409 BILLING_ENTITY_INACTIVE — writes to a resource of an inactive entity. */
+export declare class BillingEntityInactiveError extends SdkError {
+    readonly entity: 'company' | 'personal';
+    readonly rootOrgId: string | null;
+    readonly inactiveReason: InactiveReasonValue | null;
+    constructor(e: SdkError);
+}
+export declare class PersonalSubscriptionRequiredError extends SdkError {
+}
+export declare class ProjectOwnerRequiredError extends SdkError {
+}
+export declare class PaymentOverdueError extends SdkError {
+}
+export declare class PaymentRequiredError extends SdkError {
+}
+/** Maps a raw SdkError to its typed billing subclass (unchanged when not a billing code). */
+export declare function toTypedBillingError(err: unknown): unknown;
+export declare class BillingClient {
+    private http;
+    constructor(http: HttpClient);
+    /** GET /pricing — the currently effective price version (public, F564 AC-3). */
+    pricing(): Promise<PricingDto>;
+    /** GET /pricing/versions — history + pending version (vendor-only). */
+    pricingVersions(): Promise<PricingVersionDto[]>;
+    /** PUT /pricing — new version effective next UTC month (vendor-only). */
+    updatePricing(input: PricingInputDto): Promise<{
+        version: number;
+        effectiveFrom: string;
+    }>;
+    /** GET /users/me/billing/status — personal subscription + companies (banner source). */
+    myStatus(): Promise<UserBillingStatusDto>;
+    /** POST /users/me/billing/subscribe — take out the personal subscription. */
+    subscribe(input: {
+        segment: 'solo' | 'community';
+        repoUrl?: string | null;
+    }): Promise<BillingStatusDto & {
+        segment: 'solo' | 'community';
+    }>;
+    cancelPersonal(): Promise<BillingStatusDto>;
+    revokePersonalCancellation(): Promise<BillingStatusDto>;
+    reactivatePersonal(): Promise<BillingStatusDto>;
+    /** Company (root org) subscription — root-org admin for writes, any member for status. */
+    orgStatus(orgId: string): Promise<BillingStatusDto>;
+    cancelOrg(orgId: string): Promise<BillingStatusDto>;
+    revokeOrgCancellation(orgId: string): Promise<BillingStatusDto>;
+    reactivateOrg(orgId: string): Promise<BillingStatusDto>;
+    /** GET /billing/seat-fees — seat fees of one entity × month, scoped by the caller (F564). */
+    seatFees(query: SeatFeesQuery): Promise<SeatFeesDto>;
+    /** GET /billing/requests — billable requests of one entity × month, scoped (C907 AC-6). */
+    getBillableRequests(query: BillableRequestsQuery): Promise<BillableRequestsDto>;
+    /** GET /billing/entities — every billing entity with status and fees so far (vendor-only). */
+    entities(period?: string): Promise<BillingEntityRowDto[]>;
+}
+//# sourceMappingURL=billing.client.d.ts.map

package/dist/clients/billing.client.d.ts.map

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

package/dist/clients/billing.client.js

@@ -0,0 +1,116 @@
+import { SdkError } from '../transport/errors.js';
+/** 403/409 BILLING_ENTITY_INACTIVE — writes to a resource of an inactive entity. */
+export class BillingEntityInactiveError extends SdkError {
+    entity;
+    rootOrgId;
+    inactiveReason;
+    constructor(e) {
+        super(e.code, e.message, e.status, e.apiCode, e.details);
+        this.name = 'BillingEntityInactiveError';
+        this.entity = e.details?.entity ?? 'company';
+        this.rootOrgId = e.details?.rootOrgId ?? null;
+        this.inactiveReason = e.details?.inactiveReason ?? null;
+    }
+}
+export class PersonalSubscriptionRequiredError extends SdkError {
+}
+export class ProjectOwnerRequiredError extends SdkError {
+}
+export class PaymentOverdueError extends SdkError {
+}
+export class PaymentRequiredError extends SdkError {
+}
+const TYPED = {
+    BILLING_ENTITY_INACTIVE: (e) => new BillingEntityInactiveError(e),
+    PERSONAL_SUBSCRIPTION_REQUIRED: (e) => new PersonalSubscriptionRequiredError(e.code, e.message, e.status, e.apiCode, e.details),
+    PROJECT_OWNER_REQUIRED: (e) => new ProjectOwnerRequiredError(e.code, e.message, e.status, e.apiCode, e.details),
+    PAYMENT_OVERDUE: (e) => new PaymentOverdueError(e.code, e.message, e.status, e.apiCode, e.details),
+    PAYMENT_REQUIRED: (e) => new PaymentRequiredError(e.code, e.message, e.status, e.apiCode, e.details),
+};
+/** Maps a raw SdkError to its typed billing subclass (unchanged when not a billing code). */
+export function toTypedBillingError(err) {
+    if (err instanceof SdkError && err.apiCode && TYPED[err.apiCode])
+        return TYPED[err.apiCode](err);
+    return err;
+}
+async function typed(p) {
+    try {
+        return await p;
+    }
+    catch (err) {
+        throw toTypedBillingError(err);
+    }
+}
+/** Query string of the billing read endpoints (seat fees, requests). */
+function readQuery(query) {
+    const params = new URLSearchParams({ period: query.period });
+    if (query.billingOrgId)
+        params.set('billingOrgId', query.billingOrgId);
+    if (query.userId)
+        params.set('userId', query.userId);
+    if (query.costCenterOrgId)
+        params.set('costCenterOrgId', query.costCenterOrgId);
+    return params.toString();
+}
+export class BillingClient {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** GET /pricing — the currently effective price version (public, F564 AC-3). */
+    pricing() {
+        return this.http.get('/pricing');
+    }
+    /** GET /pricing/versions — history + pending version (vendor-only). */
+    pricingVersions() {
+        return this.http.get('/pricing/versions');
+    }
+    /** PUT /pricing — new version effective next UTC month (vendor-only). */
+    updatePricing(input) {
+        return this.http.put('/pricing', input);
+    }
+    /** GET /users/me/billing/status — personal subscription + companies (banner source). */
+    myStatus() {
+        return typed(this.http.get('/users/me/billing/status'));
+    }
+    /** POST /users/me/billing/subscribe — take out the personal subscription. */
+    subscribe(input) {
+        return typed(this.http.post('/users/me/billing/subscribe', input));
+    }
+    cancelPersonal() {
+        return typed(this.http.post('/users/me/billing/cancel', {}));
+    }
+    revokePersonalCancellation() {
+        return typed(this.http.post('/users/me/billing/cancel/revoke', {}));
+    }
+    reactivatePersonal() {
+        return typed(this.http.post('/users/me/billing/reactivate', {}));
+    }
+    /** Company (root org) subscription — root-org admin for writes, any member for status. */
+    orgStatus(orgId) {
+        return typed(this.http.get(`/organizations/${encodeURIComponent(orgId)}/billing/status`));
+    }
+    cancelOrg(orgId) {
+        return typed(this.http.post(`/organizations/${encodeURIComponent(orgId)}/billing/cancel`, {}));
+    }
+    revokeOrgCancellation(orgId) {
+        return typed(this.http.post(`/organizations/${encodeURIComponent(orgId)}/billing/cancel/revoke`, {}));
+    }
+    reactivateOrg(orgId) {
+        return typed(this.http.post(`/organizations/${encodeURIComponent(orgId)}/billing/reactivate`, {}));
+    }
+    /** GET /billing/seat-fees — seat fees of one entity × month, scoped by the caller (F564). */
+    seatFees(query) {
+        return typed(this.http.get(`/billing/seat-fees?${readQuery(query)}`));
+    }
+    /** GET /billing/requests — billable requests of one entity × month, scoped (C907 AC-6). */
+    getBillableRequests(query) {
+        return typed(this.http.get(`/billing/requests?${readQuery(query)}`));
+    }
+    /** GET /billing/entities — every billing entity with status and fees so far (vendor-only). */
+    entities(period) {
+        const qs = period ? `?period=${encodeURIComponent(period)}` : '';
+        return typed(this.http.get(`/billing/entities${qs}`));
+    }
+}
+//# sourceMappingURL=billing.client.js.map

package/dist/clients/billing.client.js.map

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

package/dist/clients/capture.client.d.ts

@@ -13,7 +13,7 @@
  * Retry: on 503/network failure the caller retains the batch and retries on the
  * next flush cycle (max 3 attempts, then log.warn + discard).
  */
-import type { SessionClient } from '@beacon-build/core';
+import type { PaymentMethod, SessionClient } from '@beacon-build/core';
 export interface CapturedToolUse {
     id: string;
     name: string;
@@ -52,6 +52,17 @@ export interface CapturedEntry {
     isSidechain: boolean;
     subagentSessionId?: string | null;
     agentType?: string | null;
+    /** F706: how this turn was paid (missing ⇒ server stores 'unknown'). */
+    paymentMethod?: PaymentMethod;
+    /** F706: `<provider>:user:<userId>` — only meaningful for `oauth_quota`. */
+    quotaAccount?: string | null;
+    /**
+     * F716/AC-15: the OpenCode provider id for this turn (P3/P5 only) — see the worker
+     * contract's own doc comment (`packages/worker/src/conversation-capture.contract.ts`) for
+     * why the server needs it (synthesizing a `quotaAccount` for an unattributed `oauth_quota`
+     * OpenCode turn).
+     */
+    providerID?: string | null;
     toolUses: CapturedToolUse[];
 }
 export interface CaptureJob {

package/dist/clients/capture.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture.client.d.ts","sourceRoot":"","sources":["../../src/clients/capture.client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAOvD,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,EAAE,OAAO,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,QAAQ,EAAE,eAAe,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,UAAU;IACvB,iBAAiB,EAAE,MAAM,CAAA;IACzB,MAAM,EAAE,aAAa,CAAA;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAA;IAC7B,OAAO,EAAE,aAAa,EAAE,CAAA;CAC3B;AAED,qBAAa,aAAa;IAYlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAQlC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgC;gBAGxC,OAAO,EAAE,MAAM,EAChC,SAAS,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAS1E,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAoB/D"}
+{"version":3,"file":"capture.client.d.ts","sourceRoot":"","sources":["../../src/clients/capture.client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAOtE,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,6FAA6F;IAC7F,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAA;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,WAAW,EAAE,OAAO,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,wEAAwE;IACxE,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,UAAU;IACvB,iBAAiB,EAAE,MAAM,CAAA;IACzB,MAAM,EAAE,aAAa,CAAA;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAAA;IAC7B,OAAO,EAAE,aAAa,EAAE,CAAA;CAC3B;AAED,qBAAa,aAAa;IAYlB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAX5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAQlC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgC;gBAGxC,OAAO,EAAE,MAAM,EAChC,SAAS,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAS1E,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAoB/D"}

package/dist/clients/capture.client.js.map

@@ -1 +1 @@
-{"version":3,"file":"capture.client.js","sourceRoot":"","sources":["../../src/clients/capture.client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA6DH,MAAM,OAAO,aAAa;IAYD;IAXJ,SAAS,CAAQ;IAClC,2FAA2F;IAC3F,4FAA4F;IAC5F,yEAAyE;IACzE,yFAAyF;IACzF,+EAA+E;IAC/E,yFAAyF;IACzF,qBAAqB;IACJ,YAAY,CAAgC;IAE7D,YACqB,OAAe,EAChC,SAA4E;QAD3D,YAAO,GAAP,OAAO,CAAQ;QAGhC,IAAI,CAAC,SAAS,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,qCAAqC,CAAA;QACnF,IAAI,CAAC,YAAY;YACb,OAAO,SAAS,KAAK,UAAU;gBAC3B,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC,IAAI,EAAE;gBACvC,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS,CAAA;IAC7B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAe;QACxB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE;YACpC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACL,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,MAAM,IAAI,CAAC,YAAY,EAAE,EAAE;aACvD;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;SAC5B,CAAC,CAAA;QAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACV,wEAAwE;YACxE,0EAA0E;YAC1E,uEAAuE;YACvE,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAA;QAC7E,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAqC,CAAA;QACrF,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAA;IAClE,CAAC;CACJ"}
+{"version":3,"file":"capture.client.js","sourceRoot":"","sources":["../../src/clients/capture.client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAwEH,MAAM,OAAO,aAAa;IAYD;IAXJ,SAAS,CAAQ;IAClC,2FAA2F;IAC3F,4FAA4F;IAC5F,yEAAyE;IACzE,yFAAyF;IACzF,+EAA+E;IAC/E,yFAAyF;IACzF,qBAAqB;IACJ,YAAY,CAAgC;IAE7D,YACqB,OAAe,EAChC,SAA4E;QAD3D,YAAO,GAAP,OAAO,CAAQ;QAGhC,IAAI,CAAC,SAAS,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,qCAAqC,CAAA;QACnF,IAAI,CAAC,YAAY;YACb,OAAO,SAAS,KAAK,UAAU;gBAC3B,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,SAAS,EAAE,CAAC,IAAI,EAAE;gBACvC,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS,CAAA;IAC7B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAe;QACxB,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE;YACpC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACL,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,MAAM,IAAI,CAAC,YAAY,EAAE,EAAE;aACvD;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;SAC5B,CAAC,CAAA;QAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACV,wEAAwE;YACxE,0EAA0E;YAC1E,uEAAuE;YACvE,MAAM,IAAI,KAAK,CAAC,0BAA0B,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAA;QAC7E,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAqC,CAAA;QACrF,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAA;IAClE,CAAC;CACJ"}

package/dist/factory/tenant-agent-sdk.d.ts

@@ -16,12 +16,12 @@ export interface TenantAgentSdkConfig {
     refreshSkewSeconds?: number;
 }
 export interface TenantAgentTokenProvider {
-    /** A current internal agent token (exchanging/re-obtaining when needed). */
+    /** A current AS access token — the credential itself, or re-obtained via client_credentials. */
     getToken(): Promise<string>;
     /** Drop every cached token and obtain a fresh one (what a 401 triggers). */
     refresh(): Promise<string>;
 }
 export declare function createTenantAgentTokenProvider(config: TenantAgentSdkConfig): TenantAgentTokenProvider;
-/** An Agent SDK authenticated with a tenant credential (exchange + refresh transparent). */
+/** An Agent SDK authenticated with a tenant credential (token refresh transparent). */
 export declare function createTenantAgentClient(config: TenantAgentSdkConfig): AgentSdk;
 //# sourceMappingURL=tenant-agent-sdk.d.ts.map

package/dist/factory/tenant-agent-sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tenant-agent-sdk.d.ts","sourceRoot":"","sources":["../../src/factory/tenant-agent-sdk.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEjE,MAAM,MAAM,gBAAgB,GACtB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjE,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,gBAAgB,CAAA;IAC5B,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,wFAAwF;IACxF,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACrC,4EAA4E;IAC5E,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3B,4EAA4E;IAC5E,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CAC7B;AA2CD,wBAAgB,8BAA8B,CAC1C,MAAM,EAAE,oBAAoB,GAC7B,wBAAwB,CA4E1B;AAED,4FAA4F;AAC5F,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,oBAAoB,GAAG,QAAQ,CAQ9E"}
+{"version":3,"file":"tenant-agent-sdk.d.ts","sourceRoot":"","sources":["../../src/factory/tenant-agent-sdk.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEjE,MAAM,MAAM,gBAAgB,GACtB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjE,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,gBAAgB,CAAA;IAC5B,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,wFAAwF;IACxF,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACrC,gGAAgG;IAChG,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3B,4EAA4E;IAC5E,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CAC7B;AA2CD,wBAAgB,8BAA8B,CAC1C,MAAM,EAAE,oBAAoB,GAC7B,wBAAwB,CA0D1B;AAED,uFAAuF;AACvF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,oBAAoB,GAAG,QAAQ,CAQ9E"}

package/dist/factory/tenant-agent-sdk.js

@@ -1,16 +1,16 @@
 /**
  * B987 (F712 AC-7, D1) — `createTenantAgentClient`: an Agent SDK authenticated with a TENANT
- * credential (an owner-minted token, or a tenant API key). `services/api` never accepts the
- * AS-issued token directly, so this client performs, transparently:
+ * credential (an owner-minted token, or a tenant API key):
  *
  *   api_key:      client_credentials at POST /api/oauth/token (client_secret_basic) → AS token
+ *                 (cached until shortly before its expiry, re-obtained on expiry or on a 401 —
+ *                 HttpClient's onUnauthorized hook, one retry, single-flight)
  *   minted_token: the AS token is the credential itself
- *   both:         POST /api/v1/oauth/token-exchange → internal agent token (cached until shortly
- *                 before its expiry), re-obtained on expiry or on a 401 (HttpClient's
- *                 onUnauthorized hook — one retry, single-flight).
  *
- * The secret/token never leaves this module except in the Authorization header of those two
- * requests. Raw fetch is deliberate here: these are the bootstrap calls that PRODUCE the bearer
+ * B1009: the AS token is presented DIRECTLY as the Bearer — `services/api` verifies that token
+ * class itself (same rules as `/v1/oauth/token-exchange`, incl. the tenant-credential branch), so
+ * this client no longer exchanges it first. The secret/token never leaves this module except in
+ * the Authorization header. Raw fetch is deliberate here: these are the bootstrap calls that PRODUCE the bearer
  * every other SDK method uses (same rationale as the mcp-core OAuth client).
  */
 import { SdkError, statusToSdkCode } from '../transport/errors.js';
@@ -49,7 +49,6 @@ export function createTenantAgentTokenProvider(config) {
     const skewMs = (config.refreshSkewSeconds ?? 30) * 1000;
     const base = config.baseUrl.replace(/\/+$/, '');
     let asToken;
-    let internal;
     let inFlight;
     const fresh = (c) => !!c && c.expiresAtMs - skewMs > Date.now();
     async function obtainAsToken() {
@@ -84,27 +83,9 @@ export function createTenantAgentTokenProvider(config) {
         };
         return asToken.token;
     }
-    async function exchange() {
-        const federated = await obtainAsToken();
-        let res;
-        try {
-            res = await doFetch(`${base}/api/v1/oauth/token-exchange`, {
-                method: 'POST',
-                headers: { authorization: `Bearer ${federated}` },
-            });
-        }
-        catch (err) {
-            throw new SdkError('network_error', `token exchange failed: ${String(err)}`);
-        }
-        if (!res.ok)
-            return failFrom(res, 'token exchange');
-        const body = (await res.json());
-        internal = { token: body.data.token, expiresAtMs: Date.parse(body.data.expiresAt) };
-        return internal.token;
-    }
     function singleFlight() {
         if (!inFlight) {
-            inFlight = exchange().finally(() => {
+            inFlight = obtainAsToken().finally(() => {
                 inFlight = undefined;
             });
         }
@@ -112,18 +93,19 @@ export function createTenantAgentTokenProvider(config) {
     }
     return {
         async getToken() {
-            if (fresh(internal))
-                return internal.token;
+            if (config.credential.kind === 'minted_token')
+                return config.credential.token;
+            if (fresh(asToken))
+                return asToken.token;
             return singleFlight();
         },
         async refresh() {
-            internal = undefined;
             asToken = undefined;
             return singleFlight();
         },
     };
 }
-/** An Agent SDK authenticated with a tenant credential (exchange + refresh transparent). */
+/** An Agent SDK authenticated with a tenant credential (token refresh transparent). */
 export function createTenantAgentClient(config) {
     const provider = createTenantAgentTokenProvider(config);
     return createAgentClient({