@agent-relay/factory 0.1.56 → 0.1.57

package/README.md

@@ -434,12 +434,20 @@ import {
 const state = new DurableObjectHostedFactoryStateStore(durableObjectState.storage)
 const factory = createHostedFactory(
   { workspaceId, ownerId: isolateId, config },
-  { state, discovery, fleet, completions, mergeGate, writeback },
+  { state, discovery, fleet, completions, mergeGate, writeback, reporter },
 )
 
 await factory.runOnce() // invoke from cron/alarm and safe webhook wakeups
 ```
 
+The optional `reporter` implements the canonical `FactoryEventReporter`.
+Hosted runs persist a deterministic run ID per workspace and issue, then emit
+lifecycle events only after the corresponding fenced state write. Worker hosts
+that only need the Factory-owned wire schema, event creator, and reporter types
+should import `@agent-relay/factory/telemetry`; unlike the broader
+`@agent-relay/factory/observability` surface, it does not export the
+filesystem-backed outbox or instance identity helpers.
+
 The Durable Object adapter stores each workspace independently and performs
 lease claims plus lifecycle writes in storage transactions. Every mutation is
 checked against the current owner and monotonically increasing lease epoch; an

package/dist/cost/index.d.ts

@@ -0,0 +1,3 @@
+export * from './ledger.js';
+export * from './pricing.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cost/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cost/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}

package/dist/cost/index.js

@@ -0,0 +1,3 @@
+export * from './ledger.js';
+export * from './pricing.js';
+//# sourceMappingURL=index.js.map

package/dist/cost/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cost/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA"}

package/dist/cost/ledger.d.ts

@@ -0,0 +1,69 @@
+export declare const COST_LEDGER_ROLES: readonly ["implementer", "reviewer", "babysitter", "triage", "workflow"];
+export type CostLedgerRole = (typeof COST_LEDGER_ROLES)[number];
+/** Matches the closed cloud-event bound for one role's model breakdown. */
+export declare const MAX_RUN_COST_MODELS_PER_ROLE = 32;
+export declare const RUN_COST_OTHER_MODELS_ID = "factory/other-models";
+export interface CostLedgerRecord {
+    runId: string;
+    role: CostLedgerRole;
+    model: string;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    usd: number | null;
+}
+export type CostLedgerRecordInput = Omit<CostLedgerRecord, 'usd'>;
+export interface CostModelBreakdown {
+    model: string;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    usd: number | null;
+}
+export interface CostRoleBreakdown {
+    role: CostLedgerRole;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    usd: number | null;
+    byModel: CostModelBreakdown[];
+}
+export interface RunCostTotal {
+    runId: string;
+    inputTokens: number | null;
+    outputTokens: number | null;
+    usd: number | null;
+    byRole: CostRoleBreakdown[];
+}
+export interface UnpricedModelCostRecord extends CostLedgerRecord {
+    usd: null;
+}
+export type UnpricedModelListener = (record: UnpricedModelCostRecord) => void;
+export interface CostLedgerRecordOptions {
+    /**
+     * Deterministic logical identity for cumulative runtime updates. Factory uses
+     * run id + agent name, so a later usage report replaces rather than doubles
+     * the same spawned agent.
+     */
+    entryId?: string;
+    /** Rehydrating durable usage must not emit a duplicate unpriced-model notice. */
+    notifyUnpriced?: boolean;
+}
+/**
+ * In-memory accounting seam for one Factory process. Durable run records retain
+ * the completion aggregate; this ledger keeps the detailed live attribution.
+ */
+export declare class CostLedger {
+    #private;
+    record(input: CostLedgerRecordInput, options?: CostLedgerRecordOptions): CostLedgerRecord;
+    hasEntry(entryId: string): boolean;
+    getRunRecords(runId: string): CostLedgerRecord[];
+    getRunTotal(runId: string): RunCostTotal;
+    getRunByRole(runId: string): CostRoleBreakdown[];
+    onUnpricedModel(listener: UnpricedModelListener): () => void;
+}
+/**
+ * Produces the deterministic, privacy-safe shape persisted and emitted when a
+ * run completes. The detailed ledger remains available through
+ * getRunRecords(); excess model buckets are folded into one aggregate instead
+ * of making the bounded observability event invalid.
+ */
+export declare const boundedRunCostTotal: (total: RunCostTotal) => RunCostTotal;
+//# sourceMappingURL=ledger.d.ts.map

package/dist/cost/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../src/cost/ledger.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB,0EAMpB,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/D,2EAA2E;AAC3E,eAAO,MAAM,4BAA4B,KAAK,CAAA;AAC9C,eAAO,MAAM,wBAAwB,yBAAyB,CAAA;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,cAAc,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CACnB;AAED,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAA;AAEjE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,CAAA;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,MAAM,EAAE,iBAAiB,EAAE,CAAA;CAC5B;AAED,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC/D,GAAG,EAAE,IAAI,CAAA;CACV;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,CAAA;AAE7E,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iFAAiF;IACjF,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;;GAGG;AACH,qBAAa,UAAU;;IAMrB,MAAM,CAAC,KAAK,EAAE,qBAAqB,EAAE,OAAO,GAAE,uBAA4B,GAAG,gBAAgB;IAc7F,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIlC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAMhD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;IAWxC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAkBhD,eAAe,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI;CAiB7D;AAiBD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,YAAY,KAAG,YAKxD,CAAA"}

package/dist/cost/ledger.js

@@ -0,0 +1,162 @@
+import { estimateCostUsd, hasModelPricing, roundUsd } from './pricing.js';
+export const COST_LEDGER_ROLES = [
+    'implementer',
+    'reviewer',
+    'babysitter',
+    'triage',
+    'workflow',
+];
+/** Matches the closed cloud-event bound for one role's model breakdown. */
+export const MAX_RUN_COST_MODELS_PER_ROLE = 32;
+export const RUN_COST_OTHER_MODELS_ID = 'factory/other-models';
+/**
+ * In-memory accounting seam for one Factory process. Durable run records retain
+ * the completion aggregate; this ledger keeps the detailed live attribution.
+ */
+export class CostLedger {
+    #records = new Map();
+    #unpricedListeners = new Set();
+    #reportedUnpricedModels = new Set();
+    #nextEntry = 0;
+    record(input, options = {}) {
+        const normalized = normalizeRecordInput(input);
+        const unpriced = !hasModelPricing(normalized.model);
+        const usd = normalized.inputTokens === null || normalized.outputTokens === null
+            ? null
+            : estimateCostUsd(normalized.model, normalized.inputTokens, normalized.outputTokens);
+        const record = { ...normalized, usd };
+        const entryId = options.entryId ?? `entry:${this.#nextEntry++}`;
+        this.#records.set(entryId, record);
+        if (unpriced && options.notifyUnpriced !== false)
+            this.#emitUnpriced(record);
+        return structuredClone(record);
+    }
+    hasEntry(entryId) {
+        return this.#records.has(entryId);
+    }
+    getRunRecords(runId) {
+        return [...this.#records.values()]
+            .filter((record) => record.runId === runId)
+            .map((record) => structuredClone(record));
+    }
+    getRunTotal(runId) {
+        const byRole = this.getRunByRole(runId);
+        return {
+            runId,
+            inputTokens: nullableSum(byRole.map((entry) => entry.inputTokens)),
+            outputTokens: nullableSum(byRole.map((entry) => entry.outputTokens)),
+            usd: nullableUsdSum(byRole.map((entry) => entry.usd)),
+            byRole,
+        };
+    }
+    getRunByRole(runId) {
+        const records = this.getRunRecords(runId);
+        const roles = new Map();
+        for (const record of records) {
+            const current = roles.get(record.role) ?? [];
+            current.push(record);
+            roles.set(record.role, current);
+        }
+        return [...roles].map(([role, roleRecords]) => ({
+            role,
+            inputTokens: nullableSum(roleRecords.map((record) => record.inputTokens)),
+            outputTokens: nullableSum(roleRecords.map((record) => record.outputTokens)),
+            usd: nullableUsdSum(roleRecords.map((record) => record.usd)),
+            byModel: modelBreakdowns(roleRecords),
+        })).sort((left, right) => roleIndex(left.role) - roleIndex(right.role));
+    }
+    onUnpricedModel(listener) {
+        this.#unpricedListeners.add(listener);
+        return () => this.#unpricedListeners.delete(listener);
+    }
+    #emitUnpriced(record) {
+        const key = `${record.runId}\0${record.model}`;
+        if (this.#reportedUnpricedModels.has(key))
+            return;
+        this.#reportedUnpricedModels.add(key);
+        for (const listener of this.#unpricedListeners) {
+            try {
+                listener(structuredClone(record));
+            }
+            catch {
+                // Cost accounting is an observability aid, never a run dependency.
+            }
+        }
+    }
+}
+const modelBreakdowns = (records) => {
+    const models = new Map();
+    for (const record of records) {
+        const current = models.get(record.model) ?? [];
+        current.push(record);
+        models.set(record.model, current);
+    }
+    return [...models].map(([model, modelRecords]) => ({
+        model,
+        inputTokens: nullableSum(modelRecords.map((record) => record.inputTokens)),
+        outputTokens: nullableSum(modelRecords.map((record) => record.outputTokens)),
+        usd: nullableUsdSum(modelRecords.map((record) => record.usd)),
+    })).sort((left, right) => compareModelIds(left.model, right.model));
+};
+/**
+ * Produces the deterministic, privacy-safe shape persisted and emitted when a
+ * run completes. The detailed ledger remains available through
+ * getRunRecords(); excess model buckets are folded into one aggregate instead
+ * of making the bounded observability event invalid.
+ */
+export const boundedRunCostTotal = (total) => ({
+    ...structuredClone(total),
+    byRole: total.byRole
+        .map((role) => ({ ...structuredClone(role), byModel: boundedModels(role.byModel) }))
+        .sort((left, right) => roleIndex(left.role) - roleIndex(right.role)),
+});
+const boundedModels = (models) => {
+    const sorted = structuredClone(models).sort((left, right) => compareModelIds(left.model, right.model));
+    if (sorted.length <= MAX_RUN_COST_MODELS_PER_ROLE)
+        return sorted;
+    const candidates = sorted.filter((entry) => entry.model !== RUN_COST_OTHER_MODELS_ID);
+    const overflow = [
+        ...sorted.filter((entry) => entry.model === RUN_COST_OTHER_MODELS_ID),
+        ...candidates.slice(MAX_RUN_COST_MODELS_PER_ROLE - 1),
+    ];
+    return [
+        ...candidates.slice(0, MAX_RUN_COST_MODELS_PER_ROLE - 1),
+        {
+            model: RUN_COST_OTHER_MODELS_ID,
+            inputTokens: nullableSum(overflow.map((entry) => entry.inputTokens)),
+            outputTokens: nullableSum(overflow.map((entry) => entry.outputTokens)),
+            usd: nullableUsdSum(overflow.map((entry) => entry.usd)),
+        },
+    ];
+};
+const roleIndex = (role) => COST_LEDGER_ROLES.indexOf(role);
+const compareModelIds = (left, right) => left < right ? -1 : left > right ? 1 : 0;
+const normalizeRecordInput = (input) => ({
+    runId: boundedIdentifier(input.runId, 'unknown-run'),
+    role: COST_LEDGER_ROLES.includes(input.role) ? input.role : 'triage',
+    model: boundedModelId(input.model),
+    inputTokens: tokenCount(input.inputTokens),
+    outputTokens: tokenCount(input.outputTokens),
+});
+const boundedIdentifier = (value, fallback) => {
+    const normalized = typeof value === 'string' ? value.trim() : '';
+    return (normalized || fallback).slice(0, 256);
+};
+const boundedModelId = (value) => {
+    const normalized = boundedIdentifier(value, 'unknown');
+    return /^[a-zA-Z0-9][a-zA-Z0-9._:/-]{0,119}$/u.test(normalized)
+        ? normalized
+        : 'unknown';
+};
+const tokenCount = (value) => value !== null && Number.isSafeInteger(value) && value >= 0 ? value : null;
+const nullableSum = (values) => {
+    const known = values.filter((value) => value !== null);
+    if (known.length === 0)
+        return null;
+    return known.reduce((sum, value) => sum >= Number.MAX_SAFE_INTEGER - value ? Number.MAX_SAFE_INTEGER : sum + value, 0);
+};
+const nullableUsdSum = (values) => {
+    const total = nullableSum(values);
+    return total === null ? null : roundUsd(total);
+};
+//# sourceMappingURL=ledger.js.map

package/dist/cost/ledger.js.map

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

package/dist/cost/pricing.d.ts

@@ -0,0 +1,18 @@
+export interface ModelPricing {
+    costPer1MInput: number;
+    costPer1MOutput: number;
+}
+/**
+ * Factory's metered model catalog. Keep the shape aligned with NightCTO's
+ * openrouter-client model ladder so model-routing work can share prices later.
+ */
+export declare const MODEL_PRICING: Readonly<Record<string, ModelPricing>>;
+export interface EstimateCostUsdOptions {
+    /** A bounded accounting notice; callback failures are deliberately ignored. */
+    onUnpricedModel?: (model: string) => void;
+}
+export declare function hasModelPricing(model: string): boolean;
+/** Estimate a metered model cost without ever making accounting control flow fatal. */
+export declare function estimateCostUsd(model: string, inputTokens: number, outputTokens: number, options?: EstimateCostUsdOptions): number | null;
+export declare const roundUsd: (value: number) => number;
+//# sourceMappingURL=pricing.d.ts.map

package/dist/cost/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../../src/cost/pricing.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAA;IACtB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAyB/D,CAAA;AAEF,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAC1C;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,sBAA2B,GACnC,MAAM,GAAG,IAAI,CAef;AAED,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,KAAG,MAAkC,CAAA"}

package/dist/cost/pricing.js

@@ -0,0 +1,54 @@
+/**
+ * Factory's metered model catalog. Keep the shape aligned with NightCTO's
+ * openrouter-client model ladder so model-routing work can share prices later.
+ */
+export const MODEL_PRICING = Object.freeze({
+    'deepseek/deepseek-chat-v3-0324': {
+        costPer1MInput: 0.27,
+        costPer1MOutput: 1.1,
+    },
+    'openai/gpt-4o-mini': {
+        costPer1MInput: 0.15,
+        costPer1MOutput: 0.6,
+    },
+    'anthropic/claude-haiku-4.5': {
+        costPer1MInput: 1,
+        costPer1MOutput: 5,
+    },
+    'anthropic/claude-sonnet-4.5': {
+        costPer1MInput: 3,
+        costPer1MOutput: 15,
+    },
+    'openai/gpt-5.4': {
+        costPer1MInput: 5,
+        costPer1MOutput: 15,
+    },
+    'openai/gpt-5.4-pro': {
+        costPer1MInput: 15,
+        costPer1MOutput: 60,
+    },
+});
+export function hasModelPricing(model) {
+    return Object.prototype.hasOwnProperty.call(MODEL_PRICING, model);
+}
+/** Estimate a metered model cost without ever making accounting control flow fatal. */
+export function estimateCostUsd(model, inputTokens, outputTokens, options = {}) {
+    if (!hasModelPricing(model)) {
+        try {
+            options.onUnpricedModel?.(model);
+        }
+        catch {
+            // Observability and accounting callbacks must never affect a run.
+        }
+        return null;
+    }
+    const pricing = MODEL_PRICING[model];
+    if (!validTokenCount(inputTokens) || !validTokenCount(outputTokens))
+        return null;
+    const inputCost = (inputTokens / 1_000_000) * pricing.costPer1MInput;
+    const outputCost = (outputTokens / 1_000_000) * pricing.costPer1MOutput;
+    return roundUsd(inputCost + outputCost);
+}
+export const roundUsd = (value) => Number(value.toFixed(6));
+const validTokenCount = (value) => Number.isSafeInteger(value) && value >= 0;
+//# sourceMappingURL=pricing.js.map

package/dist/cost/pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../../src/cost/pricing.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAA2C,MAAM,CAAC,MAAM,CAAC;IACjF,gCAAgC,EAAE;QAChC,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,GAAG;KACrB;IACD,oBAAoB,EAAE;QACpB,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,GAAG;KACrB;IACD,4BAA4B,EAAE;QAC5B,cAAc,EAAE,CAAC;QACjB,eAAe,EAAE,CAAC;KACnB;IACD,6BAA6B,EAAE;QAC7B,cAAc,EAAE,CAAC;QACjB,eAAe,EAAE,EAAE;KACpB;IACD,gBAAgB,EAAE;QAChB,cAAc,EAAE,CAAC;QACjB,eAAe,EAAE,EAAE;KACpB;IACD,oBAAoB,EAAE;QACpB,cAAc,EAAE,EAAE;QAClB,eAAe,EAAE,EAAE;KACpB;CACF,CAAC,CAAA;AAOF,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;AACnE,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAC7B,KAAa,EACb,WAAmB,EACnB,YAAoB,EACpB,UAAkC,EAAE;IAEpC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,OAAO,CAAC,eAAe,EAAE,CAAC,KAAK,CAAC,CAAA;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,kEAAkE;QACpE,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAE,CAAA;IACrC,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAA;IAEhF,MAAM,SAAS,GAAG,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,cAAc,CAAA;IACpE,MAAM,UAAU,GAAG,CAAC,YAAY,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,eAAe,CAAA;IACvE,OAAO,QAAQ,CAAC,SAAS,GAAG,UAAU,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;AAE3E,MAAM,eAAe,GAAG,CAAC,KAAa,EAAW,EAAE,CACjD,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA"}

package/dist/fleet/internal-fleet-client.d.ts

@@ -1,6 +1,6 @@
 import type { BrokerEvent, ListAgent, SendMessageInput, SpawnPtyInput } from '@agent-relay/harness-driver';
 import type { PreviewConfig } from '../config/schema.js';
-import type { AgentMessage, AgentPidResolution, Capability, FleetClient, FleetTrackedAgent, PreviewReference, PreviewStartInput, PreviewSweepInput, PreviewSweepResult, RosterEntry, SendInput, SpawnInput, SpawnResult } from '../ports/fleet.js';
+import type { AgentMessage, AgentPidResolution, AgentUsage, Capability, FleetClient, FleetTrackedAgent, PreviewReference, PreviewStartInput, PreviewSweepInput, PreviewSweepResult, RosterEntry, SendInput, SpawnInput, SpawnResult } from '../ports/fleet.js';
 import type { Logger } from '../ports/system.js';
 import { type PreviewManager } from '../node/tailscale-preview.js';
 type SpawnedHandleLike = {
@@ -70,6 +70,7 @@ type DeliveryFailedListener = (info: {
     reason?: string;
 }) => void;
 type AgentMessageListener = (message: AgentMessage) => void;
+type AgentUsageListener = (usage: AgentUsage) => void | Promise<void>;
 export declare const capabilityCli: Record<Capability, string>;
 export declare class InternalFleetClient implements FleetClient {
     #private;
@@ -111,6 +112,7 @@ export declare class InternalFleetClient implements FleetClient {
     sendInput(name: string, data: string): Promise<void>;
     onDeliveryFailed(listener: DeliveryFailedListener): () => void;
     onAgentMessage(listener: AgentMessageListener): () => void;
+    onAgentUsage(listener: AgentUsageListener): () => void;
     onAgentExit(listener: AgentExitListener): () => void;
     preserveInfrastructureOnDispose(): void;
     dispose(): Promise<void>;

package/dist/fleet/internal-fleet-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal-fleet-client.d.ts","sourceRoot":"","sources":["../../src/fleet/internal-fleet-client.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAE1G,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC/O,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAE7C,OAAO,EAA2B,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAKxF,KAAK,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AACtH,KAAK,oBAAoB,GAAG,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;AACxD,KAAK,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AACzE,KAAK,uBAAuB,GAAG,WAAW,CAAA;AAC1C,MAAM,MAAM,oBAAoB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAEtE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,SAAS,CAAC,IAAI,OAAO,CAAC;QAAE,aAAa,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;IACrF,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC1D,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACjE,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;IACrE,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;IACvF,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACvD,aAAa,CAAC,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,UAAU,CAAC,IAAI,IAAI,CAAA;IAGnB,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACjC,OAAO,CAAC,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAAA;IACpD,WAAW,CAAC,CAAC,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;IAC1F,WAAW,CAAC,CAAC,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;CACtG;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,uBAAuB,CAAA;IAGhC,UAAU,CAAC,EAAE,OAAO,CAAA;IAGpB,6BAA6B,CAAC,EAAE,MAAM,CAAA;IACtC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,mGAAmG;IACnG,6BAA6B,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAA;IAChE,+GAA+G;IAC/G,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAA;IACzC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,gBAAgB,CAAC,EAAE,UAAU,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2BAA2B,CAAC,EAAE,MAAM,oBAAoB,GAAG,SAAS,CAAA;IACpE,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,cAAc,CAAC,EAAE,cAAc,CAAA;CAChC;AAED,KAAK,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;AAChE,KAAK,sBAAsB,GAAG,CAAC,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KAAK,IAAI,CAAA;AAC7F,KAAK,oBAAoB,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAA;AAe3D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAIpD,CAAA;AAiBD,qBAAa,mBAAoB,YAAW,WAAW;;IACrD,QAAQ,CAAC,iBAAiB,EAAG,OAAO,CAAS;IAC7C,QAAQ,CAAC,gBAAgB,QAAO;gBAyCpB,OAAO,GAAE,0BAA+B;IAyB9C,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAuC9C,MAAM,CAAC,KAAK,EAAE;QAClB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,UAAU,EAAE,MAAM,CAAA;QAClB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;QACtB,UAAU,CAAC,EAAE,UAAU,CAAA;QACvB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,GAAG,OAAO,CAAC,WAAW,CAAC;IAgDlB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3D,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAkEhD,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;IAiB9B,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAMlE,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAK1D,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAKzE,aAAa,IAAI,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAIvD,cAAc,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAarF,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAYvC,aAAa,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAYlC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkC1D,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAqEjH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D,gBAAgB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,IAAI;IAQ9D,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI;IAQ1D,WAAW,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAQpD,+BAA+B,IAAI,IAAI;IAIjC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAme/B;AA4CD,wBAAgB,2BAA2B,IAAI,oBAAoB,GAAG,SAAS,CAS9E;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,oBAAoB,EAC7B,YAAY,CAAC,EAAE,MAAM,GACpB,WAAW,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,CAgB7C"}
+{"version":3,"file":"internal-fleet-client.d.ts","sourceRoot":"","sources":["../../src/fleet/internal-fleet-client.ts"],"names":[],"mappings":"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"}

package/dist/fleet/internal-fleet-client.js

@@ -46,6 +46,7 @@ export class InternalFleetClient {
     #agentExitListeners = new Set();
     #deliveryFailedListeners = new Set();
     #agentMessageListeners = new Set();
+    #agentUsageListeners = new Set();
     #eventUnsubscribers = [];
     #seenEvents = [];
     #seenEventKeys = new Set();
@@ -436,6 +437,13 @@ export class InternalFleetClient {
             this.#agentMessageListeners.delete(listener);
         };
     }
+    onAgentUsage(listener) {
+        this.#ensureEventSubscription();
+        this.#agentUsageListeners.add(listener);
+        return () => {
+            this.#agentUsageListeners.delete(listener);
+        };
+    }
     onAgentExit(listener) {
         this.#ensureEventSubscription();
         this.#agentExitListeners.add(listener);
@@ -474,6 +482,7 @@ export class InternalFleetClient {
         this.#agentExitListeners.clear();
         this.#deliveryFailedListeners.clear();
         this.#agentMessageListeners.clear();
+        this.#agentUsageListeners.clear();
         this.#failedDeliveries.clear();
         this.#failedDeliveryIds.length = 0;
         this.#readyAgentNames.clear();
@@ -521,6 +530,11 @@ export class InternalFleetClient {
         this.#client.connectEvents?.();
     }
     #handleBrokerEvent(event) {
+        const usage = agentUsageFromRuntimeEvent(event);
+        if (usage) {
+            this.#emitAgentUsage(usage, eventIdentity(event));
+            return;
+        }
         if (event.kind === 'worker_ready') {
             this.#markAgentReady(event.name);
             return;
@@ -723,6 +737,26 @@ export class InternalFleetClient {
             listener(message);
         }
     }
+    #emitAgentUsage(usage, identity) {
+        if (this.#rememberEvent(identity))
+            return;
+        for (const listener of this.#agentUsageListeners) {
+            try {
+                void Promise.resolve(listener({ ...usage })).catch((error) => {
+                    this.#logger?.warn?.('[factory-sdk] agent usage listener rejected an update', {
+                        name: usage.name,
+                        error,
+                    });
+                });
+            }
+            catch (error) {
+                this.#logger?.warn?.('[factory-sdk] agent usage listener rejected an update', {
+                    name: usage.name,
+                    error,
+                });
+            }
+        }
+    }
     #emitAgentExit(name, reason, identity) {
         if (this.#rememberEvent(identity)) {
             return;
@@ -1062,6 +1096,53 @@ function messageInputFrom(input) {
         ...(input.mode ? { mode: input.mode } : {}),
     };
 }
+/**
+ * Harness Driver versions predating the typed usage event still forward
+ * provider events through onEvent. Normalize the stable field aliases here so
+ * upgrading the runtime does not require an orchestration rewrite.
+ */
+function agentUsageFromRuntimeEvent(event) {
+    const record = runtimeRecord(event);
+    const kind = runtimeString(record, 'kind', 'type');
+    if (!kind || !['agent_usage', 'usage_updated', 'usage.updated', 'token_usage'].includes(kind)) {
+        return undefined;
+    }
+    const agent = runtimeRecord(record?.agent);
+    const usage = runtimeRecord(record?.usage);
+    const name = runtimeString(record, 'name', 'agent_name', 'agentName')
+        ?? runtimeString(agent, 'name', 'agent_name', 'agentName');
+    if (!name)
+        return undefined;
+    const model = runtimeString(record, 'model', 'model_id', 'modelId')
+        ?? runtimeString(usage, 'model', 'model_id', 'modelId');
+    return {
+        name,
+        ...(model ? { model } : {}),
+        inputTokens: runtimeTokenCount(runtimeValue(record, 'inputTokens', 'input_tokens', 'promptTokens', 'prompt_tokens')
+            ?? runtimeValue(usage, 'inputTokens', 'input_tokens', 'promptTokens', 'prompt_tokens')),
+        outputTokens: runtimeTokenCount(runtimeValue(record, 'outputTokens', 'output_tokens', 'completionTokens', 'completion_tokens')
+            ?? runtimeValue(usage, 'outputTokens', 'output_tokens', 'completionTokens', 'completion_tokens')),
+    };
+}
+const runtimeRecord = (value) => value !== null && typeof value === 'object' && !Array.isArray(value)
+    ? value
+    : undefined;
+const runtimeString = (record, ...keys) => {
+    for (const key of keys) {
+        const value = record?.[key];
+        if (typeof value === 'string' && value.trim())
+            return value.trim();
+    }
+    return undefined;
+};
+const runtimeValue = (record, ...keys) => {
+    for (const key of keys) {
+        if (record && Object.prototype.hasOwnProperty.call(record, key))
+            return record[key];
+    }
+    return undefined;
+};
+const runtimeTokenCount = (value) => typeof value === 'number' && Number.isSafeInteger(value) && value >= 0 ? value : null;
 function eventIdentity(event) {
     const record = event;
     const stable = record.event_id ?? record.delivery_id;