@substrate-ai/core 0.19.54

package/dist/config/version-utils.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Version utility functions for config and task graph format versioning.
+ *
+ * Provides pure utility functions for parsing, comparing, and formatting
+ * version strings used in config and task graph format versioning (FR60, NFR12).
+ */
+/**
+ * Parse an integer version string into a number.
+ *
+ * @param version - A string like "1", "2", "10"
+ * @returns The integer value
+ * @throws {ConfigError} if the string is not a valid positive integer version
+ */
+export declare function parseVersion(version: string): number;
+/**
+ * Check whether a version string is in a list of supported versions.
+ *
+ * @param version - Version string to check
+ * @param supported - List of supported version strings
+ * @returns true if version is in the supported list
+ */
+export declare function isVersionSupported(version: string, supported: readonly string[]): boolean;
+/**
+ * Return the next integer version string.
+ *
+ * @param version - Current version string like "1"
+ * @returns Next version string like "2"
+ */
+export declare function getNextVersion(version: string): string;
+/**
+ * Format the standard "unsupported version" error message.
+ *
+ * @param formatType - 'config' or 'task_graph'
+ * @param version - The unsupported version string found
+ * @param supported - List of supported version strings
+ * @returns Formatted error message string
+ */
+export declare function formatUnsupportedVersionError(formatType: 'config' | 'task_graph', version: string, supported: readonly string[]): string;
+//# sourceMappingURL=version-utils.d.ts.map

package/dist/config/version-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-utils.d.ts","sourceRoot":"","sources":["../../src/config/version-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA0BpD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAEzF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,QAAQ,GAAG,YAAY,EACnC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,MAAM,CAaR"}

package/dist/config/version-utils.js

@@ -0,0 +1,66 @@
+/**
+ * Version utility functions for config and task graph format versioning.
+ *
+ * Provides pure utility functions for parsing, comparing, and formatting
+ * version strings used in config and task graph format versioning (FR60, NFR12).
+ */
+import { ConfigError } from './errors.js';
+/**
+ * Parse an integer version string into a number.
+ *
+ * @param version - A string like "1", "2", "10"
+ * @returns The integer value
+ * @throws {ConfigError} if the string is not a valid positive integer version
+ */
+export function parseVersion(version) {
+    if (version === '' || version === null || version === undefined) {
+        throw new ConfigError(`Invalid version string: "${version}". Version must be a positive integer string (e.g. "1", "2").`, { version });
+    }
+    // Must be a string of digits only (no dots, no signs, no decimals)
+    if (!/^\d+$/.test(version)) {
+        throw new ConfigError(`Invalid version string: "${version}". Version must be a positive integer string (e.g. "1", "2").`, { version });
+    }
+    const num = parseInt(version, 10);
+    if (num <= 0) {
+        throw new ConfigError(`Invalid version string: "${version}". Version must be a positive integer (greater than 0).`, { version });
+    }
+    return num;
+}
+/**
+ * Check whether a version string is in a list of supported versions.
+ *
+ * @param version - Version string to check
+ * @param supported - List of supported version strings
+ * @returns true if version is in the supported list
+ */
+export function isVersionSupported(version, supported) {
+    return supported.includes(version);
+}
+/**
+ * Return the next integer version string.
+ *
+ * @param version - Current version string like "1"
+ * @returns Next version string like "2"
+ */
+export function getNextVersion(version) {
+    return String(parseInt(version, 10) + 1);
+}
+/**
+ * Format the standard "unsupported version" error message.
+ *
+ * @param formatType - 'config' or 'task_graph'
+ * @param version - The unsupported version string found
+ * @param supported - List of supported version strings
+ * @returns Formatted error message string
+ */
+export function formatUnsupportedVersionError(formatType, version, supported) {
+    if (formatType === 'config') {
+        return (`Configuration format version "${version}" is not supported. ` +
+            `This toolkit supports: ${supported.join(', ')}. ` +
+            `Please upgrade the toolkit: npm install -g substrate@latest`);
+    }
+    return (`Task graph format version "${version}" is not supported. ` +
+        `This toolkit supports: ${supported.join(', ')}. ` +
+        `Please upgrade the toolkit: npm install -g substrate@latest`);
+}
+//# sourceMappingURL=version-utils.js.map

package/dist/config/version-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-utils.js","sourceRoot":"","sources":["../../src/config/version-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,IAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAChE,MAAM,IAAI,WAAW,CACnB,4BAA4B,OAAO,+DAA+D,EAClG,EAAE,OAAO,EAAE,CACZ,CAAA;IACH,CAAC;IAED,mEAAmE;IACnE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,WAAW,CACnB,4BAA4B,OAAO,+DAA+D,EAClG,EAAE,OAAO,EAAE,CACZ,CAAA;IACH,CAAC;IAED,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;IAEjC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACb,MAAM,IAAI,WAAW,CACnB,4BAA4B,OAAO,yDAAyD,EAC5F,EAAE,OAAO,EAAE,CACZ,CAAA;IACH,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,SAA4B;IAC9E,OAAO,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;AAC1C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAC3C,UAAmC,EACnC,OAAe,EACf,SAA4B;IAE5B,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,CACL,iCAAiC,OAAO,sBAAsB;YAC9D,0BAA0B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YAClD,6DAA6D,CAC9D,CAAA;IACH,CAAC;IACD,OAAO,CACL,8BAA8B,OAAO,sBAAsB;QAC3D,0BAA0B,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QAClD,6DAA6D,CAC9D,CAAA;AACH,CAAC"}

package/dist/context/index.d.ts

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

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

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

package/dist/context/index.js

@@ -0,0 +1,2 @@
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/context/index.js.map

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

package/dist/context/types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Types and Zod schemas for the context-compiler module.
+ *
+ * Provides all data structures used to describe task descriptors,
+ * context templates, section definitions, store queries, and compile results.
+ */
+import { z } from 'zod';
+export declare const StoreQuerySchema: z.ZodObject<{
+    table: z.ZodEnum<{
+        decisions: "decisions";
+        requirements: "requirements";
+        constraints: "constraints";
+        artifacts: "artifacts";
+    }>;
+    filters: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+}, z.core.$strip>;
+export type StoreQuery = z.infer<typeof StoreQuerySchema>;
+export declare const TemplateSectionSchema: z.ZodObject<{
+    name: z.ZodString;
+    priority: z.ZodEnum<{
+        optional: "optional";
+        required: "required";
+        important: "important";
+    }>;
+    query: z.ZodObject<{
+        table: z.ZodEnum<{
+            decisions: "decisions";
+            requirements: "requirements";
+            constraints: "constraints";
+            artifacts: "artifacts";
+        }>;
+        filters: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    }, z.core.$strip>;
+    format: z.ZodCustom<(items: unknown[]) => string, (items: unknown[]) => string>;
+}, z.core.$strip>;
+export type TemplateSection = z.infer<typeof TemplateSectionSchema>;
+export declare const ContextTemplateSchema: z.ZodObject<{
+    taskType: z.ZodString;
+    sections: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        priority: z.ZodEnum<{
+            optional: "optional";
+            required: "required";
+            important: "important";
+        }>;
+        query: z.ZodObject<{
+            table: z.ZodEnum<{
+                decisions: "decisions";
+                requirements: "requirements";
+                constraints: "constraints";
+                artifacts: "artifacts";
+            }>;
+            filters: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+        }, z.core.$strip>;
+        format: z.ZodCustom<(items: unknown[]) => string, (items: unknown[]) => string>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ContextTemplate = z.infer<typeof ContextTemplateSchema>;
+export declare const TaskDescriptorSchema: z.ZodObject<{
+    taskType: z.ZodString;
+    pipelineRunId: z.ZodString;
+    tokenBudget: z.ZodNumber;
+    overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type TaskDescriptor = z.infer<typeof TaskDescriptorSchema>;
+export declare const SectionReportSchema: z.ZodObject<{
+    name: z.ZodString;
+    priority: z.ZodString;
+    tokens: z.ZodNumber;
+    included: z.ZodBoolean;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>;
+export type SectionReport = z.infer<typeof SectionReportSchema>;
+export declare const CompileResultSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    tokenCount: z.ZodNumber;
+    sections: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        priority: z.ZodString;
+        tokens: z.ZodNumber;
+        included: z.ZodBoolean;
+        truncated: z.ZodBoolean;
+    }, z.core.$strip>>;
+    truncated: z.ZodBoolean;
+}, z.core.$strip>;
+export type CompileResult = z.infer<typeof CompileResultSchema>;
+/**
+ * ContextCompiler — public interface for the context-compiler module.
+ *
+ * Defines the contract that all context compiler implementations must satisfy.
+ */
+export interface ContextCompiler {
+    /**
+     * Compile a minimal prompt from the decision store for the given task
+     * descriptor. Returns a CompileResult containing the assembled prompt,
+     * its token count, per-section reports, and a flag indicating whether
+     * any sections were truncated or omitted.
+     *
+     * @throws {Error} if no template is registered for `descriptor.taskType`
+     */
+    compile(descriptor: TaskDescriptor): Promise<CompileResult>;
+    /**
+     * Register a context template for a given task type. Overwrites any
+     * previously registered template for the same task type.
+     */
+    registerTemplate(template: ContextTemplate): void;
+    /**
+     * Retrieve the registered template for a task type.
+     * Returns `undefined` if no template has been registered for that type.
+     */
+    getTemplate(taskType: string): ContextTemplate | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/context/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,eAAO,MAAM,gBAAgB;;;;;;;;iBAG3B,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAMzD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;gCAIP,OAAO,EAAE,KAAK,MAAM,UAApB,OAAO,EAAE,KAAK,MAAM;iBAC7C,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAMnE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;oCARP,OAAO,EAAE,KAAK,MAAM,UAApB,OAAO,EAAE,KAAK,MAAM;;iBAW7C,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAMnE,eAAO,MAAM,oBAAoB;;;;;iBAK/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAMjE,eAAO,MAAM,mBAAmB;;;;;;iBAM9B,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAM/D,eAAO,MAAM,mBAAmB;;;;;;;;;;;iBAK9B,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAM/D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;IAE3D;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAA;IAEjD;;;OAGG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAA;CAC3D"}

package/dist/context/types.js

@@ -0,0 +1,59 @@
+/**
+ * Types and Zod schemas for the context-compiler module.
+ *
+ * Provides all data structures used to describe task descriptors,
+ * context templates, section definitions, store queries, and compile results.
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// StoreQuery
+// ---------------------------------------------------------------------------
+export const StoreQuerySchema = z.object({
+    table: z.enum(['decisions', 'requirements', 'constraints', 'artifacts']),
+    filters: z.record(z.string(), z.union([z.string(), z.array(z.string())])),
+});
+// ---------------------------------------------------------------------------
+// TemplateSection
+// ---------------------------------------------------------------------------
+export const TemplateSectionSchema = z.object({
+    name: z.string().min(1),
+    priority: z.enum(['required', 'important', 'optional']),
+    query: StoreQuerySchema,
+    format: z.custom((val) => typeof val === 'function'),
+});
+// ---------------------------------------------------------------------------
+// ContextTemplate
+// ---------------------------------------------------------------------------
+export const ContextTemplateSchema = z.object({
+    taskType: z.string().min(1),
+    sections: z.array(TemplateSectionSchema),
+});
+// ---------------------------------------------------------------------------
+// TaskDescriptor
+// ---------------------------------------------------------------------------
+export const TaskDescriptorSchema = z.object({
+    taskType: z.string().min(1),
+    pipelineRunId: z.string().min(1),
+    tokenBudget: z.number().int().positive(),
+    overrides: z.record(z.string(), z.string()).optional(),
+});
+// ---------------------------------------------------------------------------
+// SectionReport
+// ---------------------------------------------------------------------------
+export const SectionReportSchema = z.object({
+    name: z.string(),
+    priority: z.string(),
+    tokens: z.number().int().min(0),
+    included: z.boolean(),
+    truncated: z.boolean(),
+});
+// ---------------------------------------------------------------------------
+// CompileResult
+// ---------------------------------------------------------------------------
+export const CompileResultSchema = z.object({
+    prompt: z.string(),
+    tokenCount: z.number().int().min(0),
+    sections: z.array(SectionReportSchema),
+    truncated: z.boolean(),
+});
+//# sourceMappingURL=types.js.map

package/dist/context/types.js.map

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

package/dist/cost-tracker/cost-tracker-impl.d.ts

@@ -0,0 +1,51 @@
+/**
+ * CostTrackerImpl — concrete implementation of the CostTracker interface.
+ * Migrated to @substrate-ai/core (Story 41-7)
+ */
+import type { DatabaseAdapter } from '../persistence/types.js';
+import type { TypedEventBus, CoreEvents } from '../events/index.js';
+import type { CostEntry, TaskCostSummary, SessionCostSummary } from './types.js';
+import type { TokenRates } from './token-rates.js';
+import type { ILogger } from '../dispatch/types.js';
+export interface CostTracker {
+    recordTaskCost(sessionId: string, taskId: string, agentUsed: string, providerUsed: string, modelUsed: string, tokensInput: number, tokensOutput: number, billingMode: 'subscription' | 'api'): Promise<CostEntry>;
+    getTaskCost(taskId: string): Promise<TaskCostSummary>;
+    getSessionCost(sessionId: string): Promise<SessionCostSummary>;
+    getAgentCostBreakdown(sessionId: string, agent: string): Promise<{
+        cost_usd: number;
+        task_count: number;
+        billing_breakdown: {
+            subscription: number;
+            api: number;
+        };
+    }>;
+    getAllCosts(sessionId: string, limit?: number): Promise<CostEntry[]>;
+}
+export declare class CostTrackerImpl implements CostTracker {
+    private readonly _db;
+    private readonly _eventBus;
+    private readonly _tokenRates;
+    private readonly _logger;
+    constructor(db: DatabaseAdapter, eventBus: TypedEventBus<CoreEvents>, tokenRates: TokenRates, logger?: ILogger);
+    recordTaskCost(sessionId: string, taskId: string, agentUsed: string, providerUsed: string, modelUsed: string, tokensInput: number, tokensOutput: number, billingMode: 'subscription' | 'api'): Promise<CostEntry>;
+    getTaskCost(taskId: string): Promise<TaskCostSummary>;
+    getSessionCost(sessionId: string): Promise<SessionCostSummary>;
+    getAgentCostBreakdown(sessionId: string, agent: string): Promise<{
+        cost_usd: number;
+        task_count: number;
+        billing_breakdown: {
+            subscription: number;
+            api: number;
+        };
+    }>;
+    getAllCosts(sessionId: string, limit?: number): Promise<CostEntry[]>;
+    getTokenRate(provider: string, model: string): import("./token-rates.js").ModelRates | null;
+}
+export interface CostTrackerOptions {
+    db: DatabaseAdapter;
+    eventBus: TypedEventBus<CoreEvents>;
+    tokenRates?: TokenRates;
+    logger?: ILogger;
+}
+export declare function createCostTracker(options: CostTrackerOptions): CostTracker;
+//# sourceMappingURL=cost-tracker-impl.d.ts.map

package/dist/cost-tracker/cost-tracker-impl.d.ts.map

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

package/dist/cost-tracker/cost-tracker-impl.js

@@ -0,0 +1,85 @@
+/**
+ * CostTrackerImpl — concrete implementation of the CostTracker interface.
+ * Migrated to @substrate-ai/core (Story 41-7)
+ */
+import { TOKEN_RATES, getTokenRate, estimateCostSafe } from './token-rates.js';
+import { recordCostEntry, incrementTaskCost, getCostEntryById, getSessionCostSummary, getTaskCostSummary, getAgentCostBreakdown, getAllCostEntries, } from '../persistence/queries/cost.js';
+// ---------------------------------------------------------------------------
+// CostTrackerImpl
+// ---------------------------------------------------------------------------
+export class CostTrackerImpl {
+    _db;
+    _eventBus;
+    _tokenRates;
+    _logger;
+    constructor(db, eventBus, tokenRates, logger) {
+        this._db = db;
+        this._eventBus = eventBus;
+        this._tokenRates = tokenRates;
+        this._logger = logger ?? console;
+    }
+    async recordTaskCost(sessionId, taskId, agentUsed, providerUsed, modelUsed, tokensInput, tokensOutput, billingMode) {
+        const equivalentApiCost = estimateCostSafe(providerUsed, modelUsed, tokensInput, tokensOutput, this._tokenRates);
+        const costUsd = billingMode === 'subscription' ? 0 : equivalentApiCost;
+        const savingsUsd = billingMode === 'subscription' ? equivalentApiCost : 0;
+        const insertedId = await this._db.transaction(async () => {
+            const newId = await recordCostEntry(this._db, {
+                session_id: sessionId,
+                task_id: taskId,
+                agent: agentUsed,
+                provider: providerUsed,
+                model: modelUsed,
+                billing_mode: billingMode,
+                tokens_input: tokensInput,
+                tokens_output: tokensOutput,
+                cost_usd: costUsd,
+                savings_usd: savingsUsd,
+            });
+            await incrementTaskCost(this._db, taskId, costUsd);
+            return newId;
+        });
+        if (!insertedId) {
+            throw new Error(`Cost entry insert failed: transaction returned id=${insertedId}`);
+        }
+        const entry = await getCostEntryById(this._db, insertedId);
+        if (!entry) {
+            throw new Error(`Cost entry not found after insert: id=${insertedId}`);
+        }
+        this._eventBus.emit('cost:recorded', {
+            taskId,
+            sessionId,
+            costUsd: entry.cost_usd,
+            savingsUsd: entry.savings_usd,
+            billingMode: entry.billing_mode,
+        });
+        this._logger.debug({ taskId, billingMode, costUsd: entry.cost_usd, savingsUsd: entry.savings_usd, tokensInput, tokensOutput }, 'Cost recorded');
+        return entry;
+    }
+    async getTaskCost(taskId) {
+        return getTaskCostSummary(this._db, taskId);
+    }
+    async getSessionCost(sessionId) {
+        return getSessionCostSummary(this._db, sessionId);
+    }
+    async getAgentCostBreakdown(sessionId, agent) {
+        const breakdown = await getAgentCostBreakdown(this._db, sessionId, agent);
+        return {
+            cost_usd: breakdown.cost_usd,
+            task_count: breakdown.task_count,
+            billing_breakdown: {
+                subscription: breakdown.subscription_tasks,
+                api: breakdown.api_tasks,
+            },
+        };
+    }
+    async getAllCosts(sessionId, limit) {
+        return getAllCostEntries(this._db, sessionId, limit);
+    }
+    getTokenRate(provider, model) {
+        return getTokenRate(provider, model, this._tokenRates);
+    }
+}
+export function createCostTracker(options) {
+    return new CostTrackerImpl(options.db, options.eventBus, options.tokenRates ?? TOKEN_RATES, options.logger);
+}
+//# sourceMappingURL=cost-tracker-impl.js.map

package/dist/cost-tracker/cost-tracker-impl.js.map

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

package/dist/cost-tracker/cost-tracker-subscriber.d.ts

@@ -0,0 +1,31 @@
+/**
+ * CostTrackerSubscriber — subscribes to task lifecycle events and records
+ * cost data via the CostTracker module.
+ * Migrated to @substrate-ai/core (Story 41-7)
+ */
+import type { IBaseService } from '../types.js';
+import type { TypedEventBus, CoreEvents } from '../events/index.js';
+import type { CostTracker } from './cost-tracker-impl.js';
+import type { ILogger } from '../dispatch/types.js';
+export declare class CostTrackerSubscriber implements IBaseService {
+    private readonly _eventBus;
+    private readonly _costTracker;
+    private readonly _routingCache;
+    private _defaultSessionId;
+    private readonly _logger;
+    private readonly _onTaskRouted;
+    private readonly _onTaskComplete;
+    private readonly _onTaskFailed;
+    constructor(eventBus: TypedEventBus<CoreEvents>, costTracker: CostTracker, sessionId?: string, logger?: ILogger);
+    setDefaultSessionId(sessionId: string): void;
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export interface CostTrackerSubscriberOptions {
+    eventBus: TypedEventBus<CoreEvents>;
+    costTracker: CostTracker;
+    sessionId?: string;
+    logger?: ILogger;
+}
+export declare function createCostTrackerSubscriber(options: CostTrackerSubscriberOptions): CostTrackerSubscriber;
+//# sourceMappingURL=cost-tracker-subscriber.d.ts.map

package/dist/cost-tracker/cost-tracker-subscriber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker-subscriber.d.ts","sourceRoot":"","sources":["../../src/cost-tracker/cost-tracker-subscriber.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAkBnD,qBAAa,qBAAsB,YAAW,YAAY;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IACrD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAa;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoC;IAClE,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CASpB;IAEV,OAAO,CAAC,QAAQ,CAAC,eAAe,CAQtB;IAEV,OAAO,CAAC,QAAQ,CAAC,aAAa,CAGpB;gBAEE,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO;IA2F/G,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAItC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAOhC;AAuBD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAA;IACnC,WAAW,EAAE,WAAW,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,4BAA4B,GAAG,qBAAqB,CAExG"}

package/dist/cost-tracker/cost-tracker-subscriber.js

@@ -0,0 +1,116 @@
+/**
+ * CostTrackerSubscriber — subscribes to task lifecycle events and records
+ * cost data via the CostTracker module.
+ * Migrated to @substrate-ai/core (Story 41-7)
+ */
+import { PROVIDER_ALIASES } from './token-rates.js';
+// ---------------------------------------------------------------------------
+// CostTrackerSubscriber
+// ---------------------------------------------------------------------------
+export class CostTrackerSubscriber {
+    _eventBus;
+    _costTracker;
+    _routingCache = new Map();
+    _defaultSessionId;
+    _logger;
+    _onTaskRouted;
+    _onTaskComplete;
+    _onTaskFailed;
+    constructor(eventBus, costTracker, sessionId, logger) {
+        this._eventBus = eventBus;
+        this._costTracker = costTracker;
+        this._defaultSessionId = sessionId ?? 'default';
+        this._logger = logger ?? console;
+        this._onTaskRouted = (payload) => {
+            const { taskId, decision } = payload;
+            if (decision.billingMode === 'unavailable') {
+                this._logger.debug({ taskId }, 'Billing mode is "unavailable" — skipping cost tracking for unrouted task');
+                return;
+            }
+            const billingMode = decision.billingMode === 'subscription' ? 'subscription' : 'api';
+            const provider = resolveProviderFromAgent(decision.agent);
+            const model = decision.model ?? resolveDefaultModel(decision.agent);
+            this._routingCache.set(taskId, {
+                sessionId: this._defaultSessionId,
+                agent: decision.agent,
+                provider,
+                model,
+                billingMode,
+            });
+            this._logger.debug({ taskId, billingMode, provider, model }, 'Cached routing context for cost tracking');
+        };
+        this._onTaskComplete = (payload) => {
+            const { taskId, result } = payload;
+            const routing = this._routingCache.get(taskId);
+            if (!routing) {
+                this._logger.debug({ taskId }, 'No routing context cached — skipping cost recording');
+                return;
+            }
+            const totalTokens = result.tokensUsed ?? 0;
+            const tokensInput = Math.round(totalTokens * 0.25);
+            const tokensOutput = totalTokens - tokensInput;
+            try {
+                this._costTracker.recordTaskCost(routing.sessionId, taskId, routing.agent, routing.provider, routing.model, tokensInput, tokensOutput, routing.billingMode);
+                this._logger.debug({ taskId, billingMode: routing.billingMode }, 'Cost recorded on task:complete');
+            }
+            catch (err) {
+                this._logger.warn({ err, taskId }, 'Failed to record cost on task:complete (non-fatal)');
+            }
+            finally {
+                this._routingCache.delete(taskId);
+            }
+        };
+        this._onTaskFailed = (payload) => {
+            const { taskId } = payload;
+            const routing = this._routingCache.get(taskId);
+            if (!routing) {
+                this._logger.debug({ taskId }, 'No routing context cached for failed task — skipping cost recording');
+                return;
+            }
+            try {
+                this._costTracker.recordTaskCost(routing.sessionId, taskId, routing.agent, routing.provider, routing.model, 0, 0, routing.billingMode);
+                this._logger.debug({ taskId }, 'Zero-cost entry recorded for failed task');
+            }
+            catch (err) {
+                this._logger.warn({ err, taskId }, 'Failed to record cost on task:failed (non-fatal)');
+            }
+            finally {
+                this._routingCache.delete(taskId);
+            }
+        };
+    }
+    setDefaultSessionId(sessionId) {
+        this._defaultSessionId = sessionId;
+    }
+    async initialize() {
+        this._eventBus.on('task:routed', this._onTaskRouted);
+        this._eventBus.on('task:complete', this._onTaskComplete);
+        this._eventBus.on('task:failed', this._onTaskFailed);
+        this._logger.info('CostTrackerSubscriber initialized — subscribed to task events');
+    }
+    async shutdown() {
+        this._eventBus.off('task:routed', this._onTaskRouted);
+        this._eventBus.off('task:complete', this._onTaskComplete);
+        this._eventBus.off('task:failed', this._onTaskFailed);
+        this._routingCache.clear();
+        this._logger.info('CostTrackerSubscriber shutdown complete');
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function resolveProviderFromAgent(agent) {
+    return PROVIDER_ALIASES[agent.toLowerCase()] ?? agent.toLowerCase();
+}
+function resolveDefaultModel(agent) {
+    const defaults = {
+        claude: 'claude-3-sonnet',
+        codex: 'gpt-4o',
+        gemini: 'gemini-1.5-pro',
+    };
+    return defaults[agent.toLowerCase()] ?? agent.toLowerCase();
+}
+export function createCostTrackerSubscriber(options) {
+    return new CostTrackerSubscriber(options.eventBus, options.costTracker, options.sessionId, options.logger);
+}
+//# sourceMappingURL=cost-tracker-subscriber.js.map

package/dist/cost-tracker/cost-tracker-subscriber.js.map

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

package/dist/cost-tracker/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Cost-tracker module barrel export — @substrate-ai/core (Story 41-7)
+ */
+export type { CostTracker, CostTrackerOptions } from './cost-tracker-impl.js';
+export { CostTrackerImpl, createCostTracker } from './cost-tracker-impl.js';
+export { CostTrackerSubscriber, createCostTrackerSubscriber } from './cost-tracker-subscriber.js';
+export type { CostTrackerSubscriberOptions } from './cost-tracker-subscriber.js';
+export type { CostEntry, TaskCostSummary, SessionCostSummary, AgentCostBreakdown, } from './types.js';
+export type { TokenRates, ModelRates } from './token-rates.js';
+export { TOKEN_RATES, PROVIDER_ALIASES, getTokenRate, estimateCost, estimateCostSafe, } from './token-rates.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cost-tracker/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC7E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAE3E,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAA;AACjG,YAAY,EAAE,4BAA4B,EAAE,MAAM,8BAA8B,CAAA;AAEhF,YAAY,EACV,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAA;AAEnB,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC9D,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,gBAAgB,GACjB,MAAM,kBAAkB,CAAA"}