@agtlantis/core 0.5.0 → 0.6.0

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":"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"}

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;IACtD,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;AACJ,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,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;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,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;AACnB,CAAC"}

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;IACnE,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;AACN,CAAC;AAcD,MAAM,UAAU,eAAe,CAC3B,IAAY,EACZ,SAAgD;IAEhD,OAAO;QACH,IAAI;QACJ,GAAG,SAAS;KACf,CAAC;AACN,CAAC;AAoBD,SAAS,kBAAkB;IACvB,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;AACN,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,SAAqC;IAC1E,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;AACP,CAAC"}

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"}

package/dist/testing/helpers.js

@@ -0,0 +1,32 @@
+export async function collectEvents(execution) {
+    const events = [];
+    // Check if it's a StreamingExecution (has stream method)
+    const iterable = 'stream' in execution && typeof execution.stream === 'function'
+        ? execution.stream()
+        : execution;
+    for await (const event of iterable) {
+        events.push(event);
+    }
+    return events;
+}
+/**
+ * Drains a StreamingExecution or AsyncIterable without storing events.
+ */
+export async function consumeExecution(execution) {
+    const iterable = 'stream' in execution && typeof execution.stream === 'function'
+        ? execution.stream()
+        : execution;
+    for await (const _event of iterable) {
+        // intentionally empty - drains the async iterator
+    }
+}
+export function expectFileManagerInterface(obj) {
+    const fm = obj;
+    const requiredMethods = ['upload', 'delete', 'clear', 'getUploadedFiles'];
+    for (const method of requiredMethods) {
+        if (typeof fm[method] !== 'function') {
+            throw new Error(`Expected FileManager.${method} to be a function, got ${typeof fm[method]}`);
+        }
+    }
+}
+//# sourceMappingURL=helpers.js.map

package/dist/testing/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/testing/helpers.ts"],"names":[],"mappings":"AAaA,MAAM,CAAC,KAAK,UAAU,aAAa,CAC/B,SAAiE;IAEjE,MAAM,MAAM,GAAwC,EAAE,CAAC;IAEvD,yDAAyD;IACzD,MAAM,QAAQ,GACV,QAAQ,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,MAAM,KAAK,UAAU;QAC3D,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE;QACpB,CAAC,CAAE,SAAyD,CAAC;IAErE,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,SAAiE;IAEjE,MAAM,QAAQ,GACV,QAAQ,IAAI,SAAS,IAAI,OAAO,SAAS,CAAC,MAAM,KAAK,UAAU;QAC3D,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE;QACpB,CAAC,CAAE,SAA4C,CAAC;IAExD,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;QAClC,kDAAkD;IACtD,CAAC;AACL,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,GAAY;IACnD,MAAM,EAAE,GAAG,GAAkB,CAAC;IAC9B,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,CAAU,CAAC;IAEnF,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;QACnC,IAAI,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACX,wBAAwB,MAAM,0BAA0B,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAC9E,CAAC;QACN,CAAC;IACL,CAAC;AACL,CAAC"}