@agtlantis/core 0.5.0 → 0.5.1

package/dist/session/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.js","sourceRoot":"","sources":["../../src/session/test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAK5B,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAiB,CAAC;AAEpD,MAAM,UAAU,eAAe,GAAkB;IAC/C,OAAO;QACL,oBAAoB,EAAE,IAAI;QAC1B,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,YAAY;QACrB,2BAA2B,EAAE,MAAM;QACnC,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;QACnB,QAAQ,EAAE,EAAE,CAAC,EAAE,EAAE;KACU,CAAC;AAAA,CAC/B;AAED,MAAM,UAAU,qBAAqB,GAAgB;IACnD,OAAO;QACL,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACrC,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAC5C,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;QAC3C,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC;KAC9C,CAAC;AAAA,CACH;AAWD,MAAM,UAAU,gBAAgB,GAAe;IAC7C,OAAO;QACL,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE;QACvB,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE;QACrB,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE;QACzB,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE;QACxB,eAAe,EAAE,EAAE,CAAC,EAAE,EAAE;QACxB,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE;KACZ,CAAC;AAAA,CACjB;AAED,MAAM,UAAU,eAAe,CAAC,SAAS,GAAgC,EAAE,EAAsB;IAC/F,OAAO;QACL,WAAW,EAAE,GAAG;QAChB,YAAY,EAAE,EAAE;QAChB,WAAW,EAAE,GAAG;QAChB,iBAAiB,EAAE;YACjB,aAAa,EAAE,GAAG;YAClB,eAAe,EAAE,CAAC;YAClB,gBAAgB,EAAE,CAAC;SACpB;QACD,kBAAkB,EAAE;YAClB,UAAU,EAAE,EAAE;YACd,eAAe,EAAE,CAAC;SACnB;QACD,GAAG,SAAS;KACb,CAAC;AAAA,CACH;AAED,MAAM,UAAU,eAAe,CAAC,OAAoC,EAAsB;IACxF,OAAO;QACL,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,CAAC;QACd,iBAAiB,EAAE;YACjB,aAAa,EAAE,CAAC;YAChB,eAAe,EAAE,CAAC;YAClB,gBAAgB,EAAE,CAAC;SACpB;QACD,kBAAkB,EAAE;YAClB,UAAU,EAAE,CAAC;YACb,eAAe,EAAE,CAAC;SACnB;QACD,GAAG,OAAO;KACX,CAAC;AAAA,CACH"}

package/dist/session/types.d.ts

@@ -0,0 +1,219 @@
+/**
+ * Session module types for @agtlantis/core.
+ * Provides interfaces for tracking LLM calls, tool calls, and session summaries.
+ */
+import type { CallSettings, LanguageModelUsage, generateText as aiGenerateText, streamText as aiStreamText, generateObject as aiGenerateObject, GenerateTextResult, StreamTextResult, ToolSet } from 'ai';
+import type { ExecutionMetadata } from '../observability/types.js';
+import type { ProviderType } from '../pricing/types.js';
+/**
+ * Standard AI SDK generation parameters that can be set as defaults at the Provider level.
+ * Per-call parameters override these defaults via simple spread merge.
+ */
+export type GenerationOptions = Pick<CallSettings, 'maxOutputTokens' | 'temperature' | 'topP' | 'topK' | 'presencePenalty' | 'frequencyPenalty' | 'stopSequences' | 'seed'>;
+/**
+ * Structural interface matching AI SDK's internal Output<OUTPUT, PARTIAL>.
+ *
+ * AI SDK exports `output as Output` (runtime value), not the interface directly.
+ * We define this compatible interface to enable structural typing.
+ *
+ * CRITICAL: Method signatures MUST exactly match AI SDK's internal interface
+ * for generic type inference to work.
+ *
+ * @see AI SDK source: node_modules/ai/dist/index.d.ts lines 572-596
+ */
+export interface OutputSpec<OUTPUT = unknown, PARTIAL = unknown> {
+    responseFormat: PromiseLike<unknown>;
+    parseCompleteOutput(options: {
+        text: string;
+    }, context: {
+        response: unknown;
+        usage: unknown;
+        finishReason: unknown;
+    }): Promise<OUTPUT>;
+    parsePartialOutput(options: {
+        text: string;
+    }): Promise<{
+        partial: PARTIAL;
+    } | undefined>;
+}
+export type DefaultOutput = OutputSpec<string, string>;
+export type InferOutputComplete<T> = T extends OutputSpec<infer O, unknown> ? O : string;
+export type GenerateTextResultTyped<TOOLS extends ToolSet, OUTPUT extends OutputSpec> = Awaited<ReturnType<typeof aiGenerateText<TOOLS>>> & {
+    output: InferOutputComplete<OUTPUT> | undefined;
+};
+export type StreamTextResultTyped<TOOLS extends ToolSet, OUTPUT extends OutputSpec> = ReturnType<typeof aiStreamText<TOOLS>> & {
+    output: Promise<InferOutputComplete<OUTPUT> | undefined>;
+};
+/**
+ * Parameters for session.generateText().
+ * Mirrors AI SDK's generateText() with 'model' excluded (injected by session).
+ */
+export type GenerateTextParams<TOOLS extends ToolSet = {}, OUTPUT extends OutputSpec = DefaultOutput> = Omit<Parameters<typeof aiGenerateText<TOOLS>>[0], 'model' | 'output'> & {
+    model?: string;
+    output?: OUTPUT;
+};
+export type { GenerateTextResult };
+/**
+ * Parameters for session.streamText().
+ * Mirrors AI SDK's streamText() with 'model' excluded (injected by session).
+ */
+export type StreamTextParams<TOOLS extends ToolSet = {}, OUTPUT extends OutputSpec = DefaultOutput> = Omit<Parameters<typeof aiStreamText<TOOLS>>[0], 'model' | 'output'> & {
+    model?: string;
+    output?: OUTPUT;
+};
+export type { StreamTextResult };
+/**
+ * @deprecated Use generateText with Output.object instead
+ */
+export type GenerateObjectParams = Omit<Parameters<typeof aiGenerateObject>[0], 'model'>;
+export type { ToolSet };
+export interface ToolCallSummary {
+    name: string;
+    duration?: number;
+    success: boolean;
+    error?: string;
+}
+export type LLMCallType = 'generateText' | 'streamText' | 'generateObject' | 'manual';
+export interface LLMCallRecord {
+    startTime: number;
+    endTime: number;
+    duration: number;
+    usage: LanguageModelUsage;
+    type: LLMCallType;
+    model: string;
+    provider: ProviderType;
+}
+/**
+ * Aggregated summary of all activity within an execution session.
+ * Used for cost tracking, performance analysis, and metadata reporting.
+ */
+export interface AdditionalCost {
+    type: string;
+    cost: number;
+    label?: string;
+    metadata?: Record<string, unknown>;
+    timestamp: number;
+}
+/**
+ * Internal data structure for SessionSummary constructor.
+ */
+interface SessionSummaryData {
+    totalLLMUsage: LanguageModelUsage;
+    llmCalls: LLMCallRecord[];
+    toolCalls: ToolCallSummary[];
+    customRecords: Record<string, unknown>[];
+    llmCost: number;
+    additionalCosts: AdditionalCost[];
+    metadata: Record<string, unknown>;
+    costByModel: Record<string, number>;
+}
+/**
+ * Aggregated summary of all activity within an execution session.
+ * Used for cost tracking, performance analysis, and metadata reporting.
+ *
+ * This is an immutable Value Object. All mutation methods return new instances.
+ */
+export declare class SessionSummary {
+    readonly totalLLMUsage: LanguageModelUsage;
+    readonly llmCallCount: number;
+    readonly llmCalls: readonly LLMCallRecord[];
+    readonly toolCalls: readonly ToolCallSummary[];
+    readonly customRecords: readonly Record<string, unknown>[];
+    readonly llmCost: number;
+    readonly additionalCosts: readonly AdditionalCost[];
+    readonly metadata: Readonly<Record<string, unknown>>;
+    /** Cost breakdown by model. Key format: `${provider}/${model}` */
+    readonly costByModel: Readonly<Record<string, number>>;
+    private readonly startTime;
+    private constructor();
+    /**
+     * Total duration from session start to now (computed dynamically).
+     */
+    get totalDuration(): number;
+    /**
+     * Creates an empty SessionSummary.
+     */
+    static empty(startTime: number): SessionSummary;
+    /**
+     * Creates a SessionSummary with custom data for testing purposes.
+     * @internal For testing only - do not use in production code.
+     */
+    static forTest(data: Partial<SessionSummaryData> & {
+        startTime?: number;
+    }): SessionSummary;
+    /**
+     * Total cost of all additional (non-LLM) operations.
+     */
+    get totalAdditionalCost(): number;
+    /**
+     * Total cost including LLM and additional costs.
+     */
+    get totalCost(): number;
+    /**
+     * Returns a new SessionSummary with an LLM call added.
+     */
+    withLLMCall(call: LLMCallRecord, newLlmCost: number, newCostByModel: Record<string, number>, newTotalUsage: LanguageModelUsage): SessionSummary;
+    /**
+     * Returns a new SessionSummary with an additional cost recorded.
+     */
+    withAdditionalCost(cost: AdditionalCost): SessionSummary;
+    /**
+     * Returns a new SessionSummary with metadata updated.
+     */
+    withMetadata(key: string, value: unknown): SessionSummary;
+    /**
+     * Returns a new SessionSummary with a tool call added.
+     */
+    withToolCall(call: ToolCallSummary): SessionSummary;
+    /**
+     * Returns a new SessionSummary with a custom record added.
+     */
+    withCustomRecord(record: Record<string, unknown>): SessionSummary;
+    /**
+     * Serializes to plain JSON object for database storage.
+     */
+    toJSON(): SessionSummaryJSON;
+}
+/**
+ * JSON representation of SessionSummary for database storage.
+ */
+export interface SessionSummaryJSON {
+    totalDuration: number;
+    totalLLMUsage: LanguageModelUsage;
+    llmCallCount: number;
+    llmCalls: LLMCallRecord[];
+    toolCalls: ToolCallSummary[];
+    customRecords: Record<string, unknown>[];
+    llmCost: number;
+    additionalCosts: AdditionalCost[];
+    metadata: Record<string, unknown>;
+    costByModel: Record<string, number>;
+    totalCost: number;
+    totalAdditionalCost: number;
+}
+/**
+ * Session for tracking LLM calls, tool calls, and custom records.
+ * Provides AI SDK wrappers with auto-tracking and manual recording methods.
+ */
+export interface ExecutionSession {
+    generateText(params: GenerateTextParams): Promise<Awaited<ReturnType<typeof aiGenerateText>>>;
+    streamText(params: StreamTextParams): ReturnType<typeof aiStreamText>;
+    generateObject<T>(params: GenerateObjectParams & {
+        schema: import('zod').ZodType<T>;
+    }): Promise<Awaited<ReturnType<typeof aiGenerateObject>>>;
+    recordToolCall(summary: ToolCallSummary): void;
+    recordLLMCall(record: Omit<LLMCallRecord, 'type'> & {
+        type?: LLMCallType;
+    }): void;
+    record(data: Record<string, unknown>): void;
+    recordAdditionalCost(cost: Omit<AdditionalCost, 'timestamp'>): void;
+    setMetadata(key: string, value: unknown): void;
+    setMetadata(data: Record<string, unknown>): void;
+    summary(): Promise<SessionSummary>;
+}
+/**
+ * Metadata passed to done() and fail() in StreamGeneratorControl.
+ * Union of SessionSummary and ExecutionMetadata for flexible usage.
+ */
+export type DoneMetadata = SessionSummary | ExecutionMetadata;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/session/types.js

@@ -0,0 +1,181 @@
+/**
+ * Session module types for @agtlantis/core.
+ * Provides interfaces for tracking LLM calls, tool calls, and session summaries.
+ */
+import { createZeroUsage } from './usage-extractors.js';
+/**
+ * Aggregated summary of all activity within an execution session.
+ * Used for cost tracking, performance analysis, and metadata reporting.
+ *
+ * This is an immutable Value Object. All mutation methods return new instances.
+ */
+export class SessionSummary {
+    totalLLMUsage;
+    llmCallCount;
+    llmCalls;
+    toolCalls;
+    customRecords;
+    llmCost;
+    additionalCosts;
+    metadata;
+    /** Cost breakdown by model. Key format: `${provider}/${model}` */
+    costByModel;
+    startTime;
+    constructor(data, startTime) {
+        this.startTime = startTime;
+        this.totalLLMUsage = data.totalLLMUsage;
+        this.llmCallCount = data.llmCalls.length;
+        this.llmCalls = Object.freeze([...data.llmCalls]);
+        this.toolCalls = Object.freeze([...data.toolCalls]);
+        this.customRecords = Object.freeze([...data.customRecords]);
+        this.llmCost = data.llmCost;
+        this.additionalCosts = Object.freeze([...data.additionalCosts]);
+        this.metadata = Object.freeze({ ...data.metadata });
+        this.costByModel = Object.freeze({ ...data.costByModel });
+    }
+    /**
+     * Total duration from session start to now (computed dynamically).
+     */
+    get totalDuration() {
+        return Date.now() - this.startTime;
+    }
+    /**
+     * Creates an empty SessionSummary.
+     */
+    static empty(startTime) {
+        return new SessionSummary({
+            totalLLMUsage: createZeroUsage(),
+            llmCalls: [],
+            toolCalls: [],
+            customRecords: [],
+            llmCost: 0,
+            additionalCosts: [],
+            metadata: {},
+            costByModel: {},
+        }, startTime);
+    }
+    /**
+     * Creates a SessionSummary with custom data for testing purposes.
+     * @internal For testing only - do not use in production code.
+     */
+    static forTest(data) {
+        const startTime = data.startTime ?? Date.now() - 1000;
+        return new SessionSummary({
+            totalLLMUsage: data.totalLLMUsage ?? createZeroUsage(),
+            llmCalls: data.llmCalls ?? [],
+            toolCalls: data.toolCalls ?? [],
+            customRecords: data.customRecords ?? [],
+            llmCost: data.llmCost ?? 0,
+            additionalCosts: data.additionalCosts ?? [],
+            metadata: data.metadata ?? {},
+            costByModel: data.costByModel ?? {},
+        }, startTime);
+    }
+    /**
+     * Total cost of all additional (non-LLM) operations.
+     */
+    get totalAdditionalCost() {
+        return this.additionalCosts.reduce((sum, c) => sum + c.cost, 0);
+    }
+    /**
+     * Total cost including LLM and additional costs.
+     */
+    get totalCost() {
+        return this.llmCost + this.totalAdditionalCost;
+    }
+    /**
+     * Returns a new SessionSummary with an LLM call added.
+     */
+    withLLMCall(call, newLlmCost, newCostByModel, newTotalUsage) {
+        return new SessionSummary({
+            totalLLMUsage: newTotalUsage,
+            llmCalls: [...this.llmCalls, call],
+            toolCalls: [...this.toolCalls],
+            customRecords: [...this.customRecords],
+            llmCost: newLlmCost,
+            additionalCosts: [...this.additionalCosts],
+            metadata: { ...this.metadata },
+            costByModel: newCostByModel,
+        }, this.startTime);
+    }
+    /**
+     * Returns a new SessionSummary with an additional cost recorded.
+     */
+    withAdditionalCost(cost) {
+        return new SessionSummary({
+            totalLLMUsage: this.totalLLMUsage,
+            llmCalls: [...this.llmCalls],
+            toolCalls: [...this.toolCalls],
+            customRecords: [...this.customRecords],
+            llmCost: this.llmCost,
+            additionalCosts: [...this.additionalCosts, cost],
+            metadata: { ...this.metadata },
+            costByModel: { ...this.costByModel },
+        }, this.startTime);
+    }
+    /**
+     * Returns a new SessionSummary with metadata updated.
+     */
+    withMetadata(key, value) {
+        return new SessionSummary({
+            totalLLMUsage: this.totalLLMUsage,
+            llmCalls: [...this.llmCalls],
+            toolCalls: [...this.toolCalls],
+            customRecords: [...this.customRecords],
+            llmCost: this.llmCost,
+            additionalCosts: [...this.additionalCosts],
+            metadata: { ...this.metadata, [key]: value },
+            costByModel: { ...this.costByModel },
+        }, this.startTime);
+    }
+    /**
+     * Returns a new SessionSummary with a tool call added.
+     */
+    withToolCall(call) {
+        return new SessionSummary({
+            totalLLMUsage: this.totalLLMUsage,
+            llmCalls: [...this.llmCalls],
+            toolCalls: [...this.toolCalls, call],
+            customRecords: [...this.customRecords],
+            llmCost: this.llmCost,
+            additionalCosts: [...this.additionalCosts],
+            metadata: { ...this.metadata },
+            costByModel: { ...this.costByModel },
+        }, this.startTime);
+    }
+    /**
+     * Returns a new SessionSummary with a custom record added.
+     */
+    withCustomRecord(record) {
+        return new SessionSummary({
+            totalLLMUsage: this.totalLLMUsage,
+            llmCalls: [...this.llmCalls],
+            toolCalls: [...this.toolCalls],
+            customRecords: [...this.customRecords, record],
+            llmCost: this.llmCost,
+            additionalCosts: [...this.additionalCosts],
+            metadata: { ...this.metadata },
+            costByModel: { ...this.costByModel },
+        }, this.startTime);
+    }
+    /**
+     * Serializes to plain JSON object for database storage.
+     */
+    toJSON() {
+        return {
+            totalDuration: this.totalDuration,
+            totalLLMUsage: this.totalLLMUsage,
+            llmCallCount: this.llmCallCount,
+            llmCalls: [...this.llmCalls],
+            toolCalls: [...this.toolCalls],
+            customRecords: [...this.customRecords],
+            llmCost: this.llmCost,
+            additionalCosts: [...this.additionalCosts],
+            metadata: { ...this.metadata },
+            costByModel: { ...this.costByModel },
+            totalCost: this.totalCost,
+            totalAdditionalCost: this.totalAdditionalCost,
+        };
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/session/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/session/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAeH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AA0IxD;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IAChB,aAAa,CAAqB;IAClC,YAAY,CAAS;IACrB,QAAQ,CAA2B;IACnC,SAAS,CAA6B;IACtC,aAAa,CAAqC;IAClD,OAAO,CAAS;IAChB,eAAe,CAA4B;IAC3C,QAAQ,CAAoC;IACrD,kEAAkE;IACzD,WAAW,CAAmC;IAEtC,SAAS,CAAS;IAEnC,YAAoB,IAAwB,EAAE,SAAiB,EAAE;QAC/D,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAAA,CAC3D;IAED;;OAEG;IACH,IAAI,aAAa,GAAW;QAC1B,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;IAAA,CACpC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,SAAiB,EAAkB;QAC9C,OAAO,IAAI,cAAc,CACvB;YACE,aAAa,EAAE,eAAe,EAAE;YAChC,QAAQ,EAAE,EAAE;YACZ,SAAS,EAAE,EAAE;YACb,aAAa,EAAE,EAAE;YACjB,OAAO,EAAE,CAAC;YACV,eAAe,EAAE,EAAE;YACnB,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,EAAE;SAChB,EACD,SAAS,CACV,CAAC;IAAA,CACH;IAED;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,IAA0D,EAAkB;QACzF,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;QACtD,OAAO,IAAI,cAAc,CACvB;YACE,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,eAAe,EAAE;YACtD,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;YAC/B,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,CAAC;YAC1B,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,EAAE;YAC3C,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;SACpC,EACD,SAAS,CACV,CAAC;IAAA,CACH;IAED;;OAEG;IACH,IAAI,mBAAmB,GAAW;QAChC,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAAA,CACjE;IAED;;OAEG;IACH,IAAI,SAAS,GAAW;QACtB,OAAO,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC;IAAA,CAChD;IAED;;OAEG;IACH,WAAW,CACT,IAAmB,EACnB,UAAkB,EAClB,cAAsC,EACtC,aAAiC,EACjB;QAChB,OAAO,IAAI,cAAc,CACvB;YACE,aAAa,EAAE,aAAa;YAC5B,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC;YAClC,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YAC9B,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC;YACtC,OAAO,EAAE,UAAU;YACnB,eAAe,EAAE,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC;YAC1C,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE;YAC9B,WAAW,EAAE,cAAc;SAC5B,EACD,IAAI,CAAC,SAAS,CACf,CAAC;IAAA,CACH;IAED;;OAEG;IACH,kBAAkB,CAAC,IAAoB,EAAkB;QACvD,OAAO,IAAI,cAAc,CACvB;YACE,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC5B,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YAC9B,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC;YACtC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,eAAe,EAAE,CAAC,GAAG,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC;YAChD,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE;YAC9B,WAAW,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE;SACrC,EACD,IAAI,CAAC,SAAS,CACf,CAAC;IAAA,CACH;IAED;;OAEG;IACH,YAAY,CAAC,GAAW,EAAE,KAAc,EAAkB;QACxD,OAAO,IAAI,cAAc,CACvB;YACE,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC5B,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YAC9B,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC;YACtC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,eAAe,EAAE,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC;YAC1C,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE;YAC5C,WAAW,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE;SACrC,EACD,IAAI,CAAC,SAAS,CACf,CAAC;IAAA,CACH;IAED;;OAEG;IACH,YAAY,CAAC,IAAqB,EAAkB;QAClD,OAAO,IAAI,cAAc,CACvB;YACE,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC5B,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC;YACpC,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC;YACtC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,eAAe,EAAE,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC;YAC1C,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE;YAC9B,WAAW,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE;SACrC,EACD,IAAI,CAAC,SAAS,CACf,CAAC;IAAA,CACH;IAED;;OAEG;IACH,gBAAgB,CAAC,MAA+B,EAAkB;QAChE,OAAO,IAAI,cAAc,CACvB;YACE,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC5B,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YAC9B,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC;YAC9C,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,eAAe,EAAE,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC;YAC1C,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE;YAC9B,WAAW,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE;SACrC,EACD,IAAI,CAAC,SAAS,CACf,CAAC;IAAA,CACH;IAED;;OAEG;IACH,MAAM,GAAuB;QAC3B,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,QAAQ,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC5B,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YAC9B,aAAa,EAAE,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC;YACtC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,eAAe,EAAE,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC;YAC1C,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE;YAC9B,WAAW,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,EAAE;YACpC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;SAC9C,CAAC;IAAA,CACH;CACF"}

package/dist/session/usage-extractors.d.ts

@@ -0,0 +1,7 @@
+import type { LanguageModelUsage } from 'ai';
+import type { ProviderType } from '../pricing/types.js';
+export type { ProviderType } from '../pricing/types.js';
+export declare function mergeUsages(usages: LanguageModelUsage[]): LanguageModelUsage;
+export declare function createZeroUsage(): LanguageModelUsage;
+export declare function detectProviderType(modelId: string): ProviderType | undefined;
+//# sourceMappingURL=usage-extractors.d.ts.map

package/dist/session/usage-extractors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-extractors.d.ts","sourceRoot":"","sources":["../../src/session/usage-extractors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,wBAAgB,WAAW,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,CAyC5E;AAED,wBAAgB,eAAe,IAAI,kBAAkB,CAepD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAsB5E"}

package/dist/session/usage-extractors.js

@@ -0,0 +1,71 @@
+export function mergeUsages(usages) {
+    if (usages.length === 0) {
+        return createZeroUsage();
+    }
+    let inputTokens = 0;
+    let outputTokens = 0;
+    let totalTokens = 0;
+    let noCacheTokens = 0;
+    let cacheReadTokens = 0;
+    let cacheWriteTokens = 0;
+    let textTokens = 0;
+    let reasoningTokens = 0;
+    for (const usage of usages) {
+        inputTokens += usage.inputTokens ?? 0;
+        outputTokens += usage.outputTokens ?? 0;
+        totalTokens += usage.totalTokens ?? 0;
+        noCacheTokens += usage.inputTokenDetails?.noCacheTokens ?? 0;
+        cacheReadTokens += usage.inputTokenDetails?.cacheReadTokens ?? 0;
+        cacheWriteTokens += usage.inputTokenDetails?.cacheWriteTokens ?? 0;
+        textTokens += usage.outputTokenDetails?.textTokens ?? 0;
+        reasoningTokens += usage.outputTokenDetails?.reasoningTokens ?? 0;
+    }
+    return {
+        inputTokens,
+        outputTokens,
+        totalTokens,
+        inputTokenDetails: {
+            noCacheTokens,
+            cacheReadTokens,
+            cacheWriteTokens,
+        },
+        outputTokenDetails: {
+            textTokens,
+            reasoningTokens,
+        },
+    };
+}
+export function createZeroUsage() {
+    return {
+        inputTokens: 0,
+        outputTokens: 0,
+        totalTokens: 0,
+        inputTokenDetails: {
+            noCacheTokens: 0,
+            cacheReadTokens: 0,
+            cacheWriteTokens: 0,
+        },
+        outputTokenDetails: {
+            textTokens: 0,
+            reasoningTokens: 0,
+        },
+    };
+}
+export function detectProviderType(modelId) {
+    const lowerModel = modelId.toLowerCase();
+    if (lowerModel.startsWith('gpt-') ||
+        lowerModel === 'o1' ||
+        lowerModel.startsWith('o1-') ||
+        lowerModel === 'o3' ||
+        lowerModel.startsWith('o3-')) {
+        return 'openai';
+    }
+    if (lowerModel.startsWith('gemini')) {
+        return 'google';
+    }
+    if (lowerModel.startsWith('claude')) {
+        return 'anthropic';
+    }
+    return undefined;
+}
+//# sourceMappingURL=usage-extractors.js.map

package/dist/session/usage-extractors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-extractors.js","sourceRoot":"","sources":["../../src/session/usage-extractors.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,WAAW,CAAC,MAA4B,EAAsB;IAC5E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,eAAe,EAAE,CAAC;IAC3B,CAAC;IAED,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,WAAW,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;QACtC,YAAY,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;QACxC,WAAW,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC;QAEtC,aAAa,IAAI,KAAK,CAAC,iBAAiB,EAAE,aAAa,IAAI,CAAC,CAAC;QAC7D,eAAe,IAAI,KAAK,CAAC,iBAAiB,EAAE,eAAe,IAAI,CAAC,CAAC;QACjE,gBAAgB,IAAI,KAAK,CAAC,iBAAiB,EAAE,gBAAgB,IAAI,CAAC,CAAC;QAEnE,UAAU,IAAI,KAAK,CAAC,kBAAkB,EAAE,UAAU,IAAI,CAAC,CAAC;QACxD,eAAe,IAAI,KAAK,CAAC,kBAAkB,EAAE,eAAe,IAAI,CAAC,CAAC;IACpE,CAAC;IAED,OAAO;QACL,WAAW;QACX,YAAY;QACZ,WAAW;QACX,iBAAiB,EAAE;YACjB,aAAa;YACb,eAAe;YACf,gBAAgB;SACjB;QACD,kBAAkB,EAAE;YAClB,UAAU;YACV,eAAe;SAChB;KACF,CAAC;AAAA,CACH;AAED,MAAM,UAAU,eAAe,GAAuB;IACpD,OAAO;QACL,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC;QACf,WAAW,EAAE,CAAC;QACd,iBAAiB,EAAE;YACjB,aAAa,EAAE,CAAC;YAChB,eAAe,EAAE,CAAC;YAClB,gBAAgB,EAAE,CAAC;SACpB;QACD,kBAAkB,EAAE;YAClB,UAAU,EAAE,CAAC;YACb,eAAe,EAAE,CAAC;SACnB;KACF,CAAC;AAAA,CACH;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAA4B;IAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAEzC,IACE,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC;QAC7B,UAAU,KAAK,IAAI;QACnB,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC;QAC5B,UAAU,KAAK,IAAI;QACnB,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,EAC5B,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,SAAS,CAAC;AAAA,CAClB"}

package/dist/testing/fixtures.d.ts

@@ -0,0 +1,34 @@
+import type { CompletionEvent } from '../execution/types.js';
+import type { LanguageModelUsage } from '../observability/index.js';
+import { SessionSummary, type LLMCallRecord, type ToolCallSummary, type AdditionalCost } from '../session/types.js';
+export declare const TEST_API_KEY = "test-api-key";
+export declare function createMockUsage(overrides?: Partial<LanguageModelUsage>): LanguageModelUsage;
+export interface TestBaseEvent {
+    type: string;
+    message?: string;
+    data?: string;
+}
+export type TestEvent = TestBaseEvent | CompletionEvent<string>;
+export interface TestResult {
+    value: string;
+}
+export declare function createTestEvent(type: string, overrides?: Partial<Omit<TestBaseEvent, 'type'>>): TestBaseEvent;
+export interface MockSessionSummaryOptions {
+    /** @deprecated Use startTime instead. totalDuration is computed from startTime. */
+    totalDuration?: number;
+    startTime?: number;
+    totalLLMUsage?: LanguageModelUsage;
+    /** @deprecated Provide llmCalls array instead. llmCallCount creates dummy records. */
+    llmCallCount?: number;
+    llmCalls?: LLMCallRecord[];
+    toolCalls?: ToolCallSummary[];
+    customRecords?: Record<string, unknown>[];
+    /** @deprecated Use llmCost instead */
+    totalCost?: number;
+    llmCost?: number;
+    additionalCosts?: AdditionalCost[];
+    metadata?: Record<string, unknown>;
+    costByModel?: Record<string, number>;
+}
+export declare function createMockSessionSummary(overrides?: MockSessionSummaryOptions): SessionSummary;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/testing/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/testing/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEpH,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,wBAAgB,eAAe,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAoB3F;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;AAEhE,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,GACjD,aAAa,CAKf;AAED,MAAM,WAAW,yBAAyB;IACtC,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAC1C,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAcD,wBAAgB,wBAAwB,CAAC,SAAS,CAAC,EAAE,yBAAyB,GAAG,cAAc,CA2B9F"}

package/dist/testing/fixtures.js

@@ -0,0 +1,65 @@
+import { SessionSummary } from '../session/types.js';
+export const TEST_API_KEY = 'test-api-key';
+export function createMockUsage(overrides) {
+    const inputTokens = overrides?.inputTokens ?? 10;
+    const outputTokens = overrides?.outputTokens ?? 5;
+    return {
+        inputTokens,
+        outputTokens,
+        totalTokens: overrides?.totalTokens ?? inputTokens + outputTokens,
+        inputTokenDetails: {
+            cacheReadTokens: undefined,
+            cacheWriteTokens: undefined,
+            noCacheTokens: undefined,
+            ...overrides?.inputTokenDetails,
+        },
+        outputTokenDetails: {
+            textTokens: undefined,
+            reasoningTokens: undefined,
+            ...overrides?.outputTokenDetails,
+        },
+    };
+}
+export function createTestEvent(type, overrides) {
+    return {
+        type,
+        ...overrides,
+    };
+}
+function createDummyLLMCall() {
+    return {
+        startTime: Date.now() - 100,
+        endTime: Date.now(),
+        duration: 100,
+        usage: createMockUsage(),
+        type: 'generateText',
+        model: 'test-model',
+        provider: 'openai',
+    };
+}
+export function createMockSessionSummary(overrides) {
+    // Compute startTime from totalDuration for backward compatibility
+    let startTime = overrides?.startTime;
+    if (startTime === undefined && overrides?.totalDuration !== undefined) {
+        startTime = Date.now() - overrides.totalDuration;
+    }
+    // Support both llmCost and deprecated totalCost
+    const llmCost = overrides?.llmCost ?? overrides?.totalCost ?? 0;
+    // Support deprecated llmCallCount by creating dummy records
+    let llmCalls = overrides?.llmCalls;
+    if (!llmCalls && overrides?.llmCallCount !== undefined) {
+        llmCalls = Array.from({ length: overrides.llmCallCount }, () => createDummyLLMCall());
+    }
+    return SessionSummary.forTest({
+        startTime,
+        totalLLMUsage: overrides?.totalLLMUsage ?? createMockUsage(),
+        llmCalls: llmCalls ?? [],
+        toolCalls: overrides?.toolCalls ?? [],
+        customRecords: overrides?.customRecords ?? [],
+        llmCost,
+        additionalCosts: overrides?.additionalCosts ?? [],
+        metadata: overrides?.metadata ?? {},
+        costByModel: overrides?.costByModel ?? {},
+    });
+}
+//# sourceMappingURL=fixtures.js.map

package/dist/testing/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../src/testing/fixtures.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAiE,MAAM,qBAAqB,CAAC;AAEpH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C,MAAM,UAAU,eAAe,CAAC,SAAuC,EAAsB;IACzF,MAAM,WAAW,GAAG,SAAS,EAAE,WAAW,IAAI,EAAE,CAAC;IACjD,MAAM,YAAY,GAAG,SAAS,EAAE,YAAY,IAAI,CAAC,CAAC;IAElD,OAAO;QACH,WAAW;QACX,YAAY;QACZ,WAAW,EAAE,SAAS,EAAE,WAAW,IAAI,WAAW,GAAG,YAAY;QACjE,iBAAiB,EAAE;YACf,eAAe,EAAE,SAAS;YAC1B,gBAAgB,EAAE,SAAS;YAC3B,aAAa,EAAE,SAAS;YACxB,GAAG,SAAS,EAAE,iBAAiB;SAClC;QACD,kBAAkB,EAAE;YAChB,UAAU,EAAE,SAAS;YACrB,eAAe,EAAE,SAAS;YAC1B,GAAG,SAAS,EAAE,kBAAkB;SACnC;KACJ,CAAC;AAAA,CACL;AAcD,MAAM,UAAU,eAAe,CAC3B,IAAY,EACZ,SAAgD,EACnC;IACb,OAAO;QACH,IAAI;QACJ,GAAG,SAAS;KACf,CAAC;AAAA,CACL;AAoBD,SAAS,kBAAkB,GAAkB;IACzC,OAAO;QACH,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG;QAC3B,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE;QACnB,QAAQ,EAAE,GAAG;QACb,KAAK,EAAE,eAAe,EAAE;QACxB,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,YAAY;QACnB,QAAQ,EAAE,QAAQ;KACrB,CAAC;AAAA,CACL;AAED,MAAM,UAAU,wBAAwB,CAAC,SAAqC,EAAkB;IAC5F,kEAAkE;IAClE,IAAI,SAAS,GAAG,SAAS,EAAE,SAAS,CAAC;IACrC,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,EAAE,aAAa,KAAK,SAAS,EAAE,CAAC;QACpE,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,aAAa,CAAC;IACrD,CAAC;IAED,gDAAgD;IAChD,MAAM,OAAO,GAAG,SAAS,EAAE,OAAO,IAAI,SAAS,EAAE,SAAS,IAAI,CAAC,CAAC;IAEhE,4DAA4D;IAC5D,IAAI,QAAQ,GAAG,SAAS,EAAE,QAAQ,CAAC;IACnC,IAAI,CAAC,QAAQ,IAAI,SAAS,EAAE,YAAY,KAAK,SAAS,EAAE,CAAC;QACrD,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,OAAO,cAAc,CAAC,OAAO,CAAC;QAC1B,SAAS;QACT,aAAa,EAAE,SAAS,EAAE,aAAa,IAAI,eAAe,EAAE;QAC5D,QAAQ,EAAE,QAAQ,IAAI,EAAE;QACxB,SAAS,EAAE,SAAS,EAAE,SAAS,IAAI,EAAE;QACrC,aAAa,EAAE,SAAS,EAAE,aAAa,IAAI,EAAE;QAC7C,OAAO;QACP,eAAe,EAAE,SAAS,EAAE,eAAe,IAAI,EAAE;QACjD,QAAQ,EAAE,SAAS,EAAE,QAAQ,IAAI,EAAE;QACnC,WAAW,EAAE,SAAS,EAAE,WAAW,IAAI,EAAE;KAC5C,CAAC,CAAC;AAAA,CACN"}

package/dist/testing/helpers.d.ts

@@ -0,0 +1,20 @@
+import type { FileManager } from '../provider/index.js';
+import type { ErrorEvent, SessionEvent, StreamingExecution } from '../execution/types.js';
+/**
+ * Collects all events from a StreamingExecution into an array.
+ * Works with both StreamingExecution (via .stream()) and raw AsyncIterable.
+ */
+export declare function collectEvents<T extends {
+    type: string;
+}>(execution: StreamingExecution<T>): Promise<SessionEvent<T | ErrorEvent>[]>;
+export declare function collectEvents<T extends {
+    type: string;
+}>(execution: AsyncIterable<SessionEvent<T>>): Promise<SessionEvent<T>[]>;
+/**
+ * Drains a StreamingExecution or AsyncIterable without storing events.
+ */
+export declare function consumeExecution<T extends {
+    type: string;
+}>(execution: StreamingExecution<T> | AsyncIterable<SessionEvent<T>>): Promise<void>;
+export declare function expectFileManagerInterface(obj: unknown): asserts obj is FileManager;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/testing/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/testing/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE1F;;;GAGG;AACH,wBAAsB,aAAa,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC1D,SAAS,EAAE,kBAAkB,CAAC,CAAC,CAAC,GACjC,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;AAC3C,wBAAsB,aAAa,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC1D,SAAS,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAkB9B;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAC7D,SAAS,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,GAClE,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,IAAI,WAAW,CAWnF"}