@vibe-agent-toolkit/agent-runtime 0.1.2-rc.3

package/dist/session/session-store-helpers.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared helper functions for session store implementations.
+ *
+ * These functions eliminate code duplication between MemorySessionStore
+ * and FileSessionStore by providing common validation and state management logic.
+ */
+import type { RuntimeSession } from './types.js';
+/**
+ * Validate session ID to prevent path traversal and other security issues.
+ * @throws Error if session ID is invalid
+ */
+export declare function validateSessionId(sessionId: string): void;
+/**
+ * Create an initial session with proper metadata.
+ */
+export declare function createInitialSession<TState>(id: string, initialState: TState | undefined, createInitialState: (() => TState) | undefined, ttl: number | undefined): RuntimeSession<TState>;
+/**
+ * Update session access timestamp and extend TTL if configured.
+ * Mutates the session object in place.
+ */
+export declare function updateSessionAccess<TState>(session: RuntimeSession<TState>, ttl: number | undefined): void;
+/**
+ * Check if a session has expired.
+ */
+export declare function isSessionExpired(session: RuntimeSession<unknown>): boolean;
+//# sourceMappingURL=session-store-helpers.d.ts.map

package/dist/session/session-store-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store-helpers.d.ts","sourceRoot":"","sources":["../../src/session/session-store-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CASzD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EACzC,EAAE,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,kBAAkB,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,EAC9C,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,cAAc,CAAC,MAAM,CAAC,CAYxB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EACxC,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,EAC/B,GAAG,EAAE,MAAM,GAAG,SAAS,GACtB,IAAI,CAON;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,OAAO,CAE1E"}

package/dist/session/session-store-helpers.js

@@ -0,0 +1,54 @@
+/**
+ * Shared helper functions for session store implementations.
+ *
+ * These functions eliminate code duplication between MemorySessionStore
+ * and FileSessionStore by providing common validation and state management logic.
+ */
+/**
+ * Validate session ID to prevent path traversal and other security issues.
+ * @throws Error if session ID is invalid
+ */
+export function validateSessionId(sessionId) {
+    // Prevent path traversal attacks
+    if (sessionId.includes('/') || sessionId.includes('\\') || sessionId.includes('..')) {
+        throw new Error(`Invalid session ID: contains path separators`);
+    }
+    // Prevent empty or unreasonably long IDs
+    if (sessionId.length === 0 || sessionId.length > 255) {
+        throw new Error(`Invalid session ID: invalid length`);
+    }
+}
+/**
+ * Create an initial session with proper metadata.
+ */
+export function createInitialSession(id, initialState, createInitialState, ttl) {
+    const now = new Date();
+    return {
+        id,
+        history: [],
+        state: initialState ?? createInitialState?.() ?? {},
+        metadata: {
+            createdAt: now,
+            lastAccessedAt: now,
+            ...(ttl && { expiresAt: new Date(now.getTime() + ttl) }),
+        },
+    };
+}
+/**
+ * Update session access timestamp and extend TTL if configured.
+ * Mutates the session object in place.
+ */
+export function updateSessionAccess(session, ttl) {
+    session.metadata.lastAccessedAt = new Date();
+    // Extend TTL if configured
+    if (ttl) {
+        session.metadata.expiresAt = new Date(Date.now() + ttl);
+    }
+}
+/**
+ * Check if a session has expired.
+ */
+export function isSessionExpired(session) {
+    return !!(session.metadata.expiresAt && session.metadata.expiresAt < new Date());
+}
+//# sourceMappingURL=session-store-helpers.js.map

package/dist/session/session-store-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store-helpers.js","sourceRoot":"","sources":["../../src/session/session-store-helpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,iCAAiC;IACjC,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,yCAAyC;IACzC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,EAAU,EACV,YAAgC,EAChC,kBAA8C,EAC9C,GAAuB;IAEvB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO;QACL,EAAE;QACF,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,YAAY,IAAI,kBAAkB,EAAE,EAAE,IAAK,EAAa;QAC/D,QAAQ,EAAE;YACR,SAAS,EAAE,GAAG;YACd,cAAc,EAAE,GAAG;YACnB,GAAG,CAAC,GAAG,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;SACzD;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAA+B,EAC/B,GAAuB;IAEvB,OAAO,CAAC,QAAQ,CAAC,cAAc,GAAG,IAAI,IAAI,EAAE,CAAC;IAE7C,2BAA2B;IAC3B,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,CAAC,QAAQ,CAAC,SAAS,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAgC;IAC/D,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,CAAC;AACnF,CAAC"}

package/dist/session/test-helpers/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Shared test utilities for session store testing.
+ *
+ * Eliminates duplication between MemorySessionStore and FileSessionStore tests.
+ */
+import type { SessionStore } from '../types.js';
+/**
+ * Test suite state for session store tests
+ */
+export interface SessionStoreTestSuite<TState> {
+    store: SessionStore<TState>;
+    setup: () => Promise<void>;
+    teardown: () => Promise<void>;
+}
+/**
+ * Shared constants for tests
+ */
+export declare const TEST_CONSTANTS: {
+    readonly NON_EXISTENT_SESSION_ID: "non-existent";
+    readonly INVALID_SESSION_MSG: "Invalid session ID";
+    readonly SHORT_TTL: 10;
+    readonly MEDIUM_TTL: 1000;
+    readonly LONG_TTL: 60000;
+};
+/**
+ * Common test cases for create() method
+ */
+export declare function testCreateMethod<TState>(getSuite: () => SessionStoreTestSuite<TState>, expectedInitialState: TState): Record<string, () => Promise<void>>;
+/**
+ * Common test cases for load() method
+ */
+export declare function testLoadMethod<TState>(getSuite: () => SessionStoreTestSuite<TState>, SessionNotFoundError: new (id: string) => Error): Record<string, () => Promise<void>>;
+/**
+ * Common test cases for save() method
+ */
+export declare function testSaveMethod<TState extends {
+    count: number;
+}>(getSuite: () => SessionStoreTestSuite<TState>): Record<string, () => Promise<void>>;
+/**
+ * Common test cases for delete() method
+ */
+export declare function testDeleteMethod<TState>(getSuite: () => SessionStoreTestSuite<TState>, SessionNotFoundError: new (id: string) => Error): Record<string, () => Promise<void>>;
+/**
+ * Common test cases for exists() method
+ */
+export declare function testExistsMethod<TState>(getSuite: () => SessionStoreTestSuite<TState>): Record<string, () => Promise<void>>;
+/**
+ * Common test cases for list() method
+ */
+export declare function testListMethod<TState>(getSuite: () => SessionStoreTestSuite<TState>): Record<string, () => Promise<void>>;
+/**
+ * Helper to register test cases from a test method
+ */
+export declare function registerTests(tests: Record<string, () => Promise<void>>): void;
+/**
+ * Register all common test suites for a SessionStore implementation
+ */
+export declare function registerCommonSessionStoreTests<TState extends {
+    count: number;
+}>(getSuite: () => SessionStoreTestSuite<TState>, _expectedInitialState: TState, SessionNotFoundError: new (id: string) => Error): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/session/test-helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/session/test-helpers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,MAAM;IAC3C,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5B,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;CAMjB,CAAC;AAEX;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EACrC,QAAQ,EAAE,MAAM,qBAAqB,CAAC,MAAM,CAAC,EAC7C,oBAAoB,EAAE,MAAM,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CA0BrC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EACnC,QAAQ,EAAE,MAAM,qBAAqB,CAAC,MAAM,CAAC,EAC7C,oBAAoB,EAAE,KAAK,EAAE,EAAE,MAAM,KAAK,KAAK,GAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAgCrC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAC7D,QAAQ,EAAE,MAAM,qBAAqB,CAAC,MAAM,CAAC,GAC5C,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAiBrC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EACrC,QAAQ,EAAE,MAAM,qBAAqB,CAAC,MAAM,CAAC,EAC7C,oBAAoB,EAAE,KAAK,EAAE,EAAE,MAAM,KAAK,KAAK,GAC9C,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAerC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EACrC,QAAQ,EAAE,MAAM,qBAAqB,CAAC,MAAM,CAAC,GAC5C,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAarC;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EACnC,QAAQ,EAAE,MAAM,qBAAqB,CAAC,MAAM,CAAC,GAC5C,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAqBrC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAI9E;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAC9E,QAAQ,EAAE,MAAM,qBAAqB,CAAC,MAAM,CAAC,EAC7C,qBAAqB,EAAE,MAAM,EAC7B,oBAAoB,EAAE,KAAK,EAAE,EAAE,MAAM,KAAK,KAAK,GAC9C,IAAI,CAYN"}

package/dist/session/test-helpers/index.js

@@ -0,0 +1,167 @@
+/**
+ * Shared test utilities for session store testing.
+ *
+ * Eliminates duplication between MemorySessionStore and FileSessionStore tests.
+ */
+import { describe, expect, it } from 'vitest';
+/**
+ * Shared constants for tests
+ */
+export const TEST_CONSTANTS = {
+    NON_EXISTENT_SESSION_ID: 'non-existent',
+    INVALID_SESSION_MSG: 'Invalid session ID',
+    SHORT_TTL: 10, // milliseconds
+    MEDIUM_TTL: 1000, // 1 second
+    LONG_TTL: 60000, // 1 minute
+};
+/**
+ * Common test cases for create() method
+ */
+export function testCreateMethod(getSuite, expectedInitialState) {
+    return {
+        'should create a new session with default initial state': async () => {
+            const { store } = getSuite();
+            const sessionId = await store.create();
+            expect(sessionId).toBeDefined();
+            expect(typeof sessionId).toBe('string');
+            const session = await store.load(sessionId);
+            expect(session.id).toBe(sessionId);
+            expect(session.history).toEqual([]);
+            expect(session.state).toEqual(expectedInitialState);
+            expect(session.metadata.createdAt).toBeInstanceOf(Date);
+            expect(session.metadata.lastAccessedAt).toBeInstanceOf(Date);
+        },
+        'should create a new session with custom initial state': async () => {
+            const { store } = getSuite();
+            const customState = { count: 10 };
+            const sessionId = await store.create(customState);
+            const session = await store.load(sessionId);
+            expect(session.state).toEqual(customState);
+        },
+    };
+}
+/**
+ * Common test cases for load() method
+ */
+export function testLoadMethod(getSuite, SessionNotFoundError) {
+    return {
+        'should load existing session': async () => {
+            const { store } = getSuite();
+            const sessionId = await store.create();
+            const session = await store.load(sessionId);
+            expect(session.id).toBe(sessionId);
+        },
+        'should throw SessionNotFoundError for non-existent session': async () => {
+            const { store } = getSuite();
+            await expect(store.load(TEST_CONSTANTS.NON_EXISTENT_SESSION_ID)).rejects.toThrow(SessionNotFoundError);
+        },
+        'should update lastAccessedAt on load': async () => {
+            const { store } = getSuite();
+            const sessionId = await store.create();
+            const session1 = await store.load(sessionId);
+            const timestamp1 = session1.metadata.lastAccessedAt.getTime();
+            // Wait enough time to ensure different timestamp
+            await new Promise(resolve => setTimeout(resolve, 50));
+            const session2 = await store.load(sessionId);
+            const timestamp2 = session2.metadata.lastAccessedAt.getTime();
+            expect(timestamp2).toBeGreaterThan(timestamp1);
+        },
+    };
+}
+/**
+ * Common test cases for save() method
+ */
+export function testSaveMethod(getSuite) {
+    return {
+        'should save session changes': async () => {
+            const { store } = getSuite();
+            const sessionId = await store.create();
+            const session = await store.load(sessionId);
+            session.state.count = 5;
+            session.history.push({ role: 'user', content: 'Hello' });
+            await store.save(session);
+            const loaded = await store.load(sessionId);
+            expect(loaded.state.count).toBe(5);
+            expect(loaded.history).toHaveLength(1);
+        },
+    };
+}
+/**
+ * Common test cases for delete() method
+ */
+export function testDeleteMethod(getSuite, SessionNotFoundError) {
+    return {
+        'should delete existing session': async () => {
+            const { store } = getSuite();
+            const sessionId = await store.create();
+            await store.delete(sessionId);
+            await expect(store.load(sessionId)).rejects.toThrow(SessionNotFoundError);
+        },
+        'should not throw error when deleting non-existent session': async () => {
+            const { store } = getSuite();
+            await expect(store.delete(TEST_CONSTANTS.NON_EXISTENT_SESSION_ID)).resolves.toBeUndefined();
+        },
+    };
+}
+/**
+ * Common test cases for exists() method
+ */
+export function testExistsMethod(getSuite) {
+    return {
+        'should return true for existing session': async () => {
+            const { store } = getSuite();
+            const sessionId = await store.create();
+            expect(await store.exists(sessionId)).toBe(true);
+        },
+        'should return false for non-existent session': async () => {
+            const { store } = getSuite();
+            expect(await store.exists(TEST_CONSTANTS.NON_EXISTENT_SESSION_ID)).toBe(false);
+        },
+    };
+}
+/**
+ * Common test cases for list() method
+ */
+export function testListMethod(getSuite) {
+    return {
+        'should return empty array for empty store': async () => {
+            const { store } = getSuite();
+            const sessionIds = await store.list();
+            expect(sessionIds).toEqual([]);
+        },
+        'should list all session IDs': async () => {
+            const { store } = getSuite();
+            const id1 = await store.create();
+            const id2 = await store.create();
+            const id3 = await store.create();
+            const sessionIds = await store.list();
+            expect(sessionIds).toHaveLength(3);
+            expect(sessionIds).toContain(id1);
+            expect(sessionIds).toContain(id2);
+            expect(sessionIds).toContain(id3);
+        },
+    };
+}
+/**
+ * Helper to register test cases from a test method
+ */
+export function registerTests(tests) {
+    for (const [name, testFn] of Object.entries(tests)) {
+        it(name, testFn);
+    }
+}
+/**
+ * Register all common test suites for a SessionStore implementation
+ */
+export function registerCommonSessionStoreTests(getSuite, _expectedInitialState, SessionNotFoundError) {
+    describe('delete', () => {
+        registerTests(testDeleteMethod(getSuite, SessionNotFoundError));
+    });
+    describe('exists', () => {
+        registerTests(testExistsMethod(getSuite));
+    });
+    describe('list', () => {
+        registerTests(testListMethod(getSuite));
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/session/test-helpers/index.js.map

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

package/dist/session/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Session management types for VAT runtime.
+ *
+ * These types enable pluggable session persistence strategies
+ * (memory, file, cloud) independent of transport layer.
+ */
+/**
+ * A message in the conversation history.
+ */
+export type Message = {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+};
+/**
+ * Session data stored by runtime
+ */
+export interface RuntimeSession<TState = unknown> {
+    /** Unique session identifier */
+    id: string;
+    /** Conversation history */
+    history: Message[];
+    /** Application-specific state */
+    state: TState;
+    /** Session metadata */
+    metadata: SessionMetadata;
+}
+/**
+ * Session metadata
+ */
+export interface SessionMetadata {
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Last access timestamp */
+    lastAccessedAt: Date;
+    /** Optional expiration timestamp */
+    expiresAt?: Date;
+    /** Runtime-specific data (checkpoints, etc.) */
+    runtimeData?: Record<string, unknown>;
+}
+/**
+ * Pluggable session storage interface
+ */
+export interface SessionStore<TState = unknown> {
+    /**
+     * Create a new session with optional initial state
+     * @returns Session ID
+     */
+    create(initialState?: TState): Promise<string>;
+    /**
+     * Load session by ID
+     * @throws SessionNotFoundError if session doesn't exist
+     */
+    load(sessionId: string): Promise<RuntimeSession<TState>>;
+    /**
+     * Save session (create or update)
+     */
+    save(session: RuntimeSession<TState>): Promise<void>;
+    /**
+     * Delete session
+     */
+    delete(sessionId: string): Promise<void>;
+    /**
+     * Check if session exists
+     */
+    exists(sessionId: string): Promise<boolean>;
+    /**
+     * List all session IDs (for debugging/admin)
+     */
+    list(): Promise<string[]>;
+    /**
+     * Clean up expired sessions
+     */
+    cleanup(): Promise<number>;
+}
+/**
+ * Session store factory options
+ */
+export interface SessionStoreOptions<TState = unknown> {
+    /** Session TTL in milliseconds (optional) */
+    ttl?: number;
+    /** Custom session ID generator */
+    generateId?: () => string;
+    /** Initial state factory */
+    createInitialState?: () => TState;
+}
+//# 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":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,GAAG,OAAO;IAC9C,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,SAAS,EAAE,IAAI,CAAC;IAChB,4BAA4B;IAC5B,cAAc,EAAE,IAAI,CAAC;IACrB,oCAAoC;IACpC,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,MAAM,GAAG,OAAO;IAC5C;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/C;;;OAGG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAEzD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5C;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE1B;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,MAAM,GAAG,OAAO;IACnD,6CAA6C;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;IAC1B,4BAA4B;IAC5B,kBAAkB,CAAC,EAAE,MAAM,MAAM,CAAC;CACnC"}

package/dist/session/types.js

@@ -0,0 +1,8 @@
+/**
+ * Session management types for VAT runtime.
+ *
+ * These types enable pluggable session persistence strategies
+ * (memory, file, cloud) independent of transport layer.
+ */
+export {};
+//# 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;;;;;GAKG"}

package/dist/shared-validation.d.ts

@@ -0,0 +1,21 @@
+import { type z } from 'zod';
+/**
+ * Converts a Zod schema to JSON Schema
+ */
+export declare function convertToJsonSchema(zodSchema: z.ZodType, name: string): Record<string, unknown>;
+/**
+ * Validates input using a Zod schema
+ * @throws Error if validation fails
+ */
+export declare function validateInput<T>(input: unknown, schema: z.ZodType<T>, agentName: string): T;
+/**
+ * Validates output using a Zod schema
+ * @throws Error if validation fails
+ */
+export declare function validateOutput<T>(output: unknown, schema: z.ZodType<T>, agentName: string): T;
+/**
+ * Creates a validated execute function wrapper
+ * This eliminates duplication across all archetype definitions
+ */
+export declare function createValidatedExecute<TInput, TOutput, TContext>(inputSchema: z.ZodType<TInput>, outputSchema: z.ZodType<TOutput>, agentName: string, handler: (input: TInput, ctx: TContext) => Promise<TOutput>): (input: TInput, ...args: unknown[]) => Promise<TOutput>;
+//# sourceMappingURL=shared-validation.d.ts.map

package/dist/shared-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-validation.d.ts","sourceRoot":"","sources":["../src/shared-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,CAAC,CAAC,OAAO,EACpB,IAAI,EAAE,MAAM,GACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,EAAE,MAAM,GAChB,CAAC,CAMH;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,SAAS,EAAE,MAAM,GAChB,CAAC,CAMH;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAC9D,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAC9B,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,GAC1D,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAOzD"}

package/dist/shared-validation.js

@@ -0,0 +1,45 @@
+import { zodToJsonSchema } from 'zod-to-json-schema';
+/**
+ * Converts a Zod schema to JSON Schema
+ */
+export function convertToJsonSchema(zodSchema, name) {
+    return zodToJsonSchema(zodSchema, {
+        name,
+        $refStrategy: 'none',
+    });
+}
+/**
+ * Validates input using a Zod schema
+ * @throws Error if validation fails
+ */
+export function validateInput(input, schema, agentName) {
+    const result = schema.safeParse(input);
+    if (!result.success) {
+        throw new Error(`Invalid input for agent "${agentName}": ${result.error.message}`);
+    }
+    return result.data;
+}
+/**
+ * Validates output using a Zod schema
+ * @throws Error if validation fails
+ */
+export function validateOutput(output, schema, agentName) {
+    const result = schema.safeParse(output);
+    if (!result.success) {
+        throw new Error(`Invalid output from agent "${agentName}": ${result.error.message}`);
+    }
+    return result.data;
+}
+/**
+ * Creates a validated execute function wrapper
+ * This eliminates duplication across all archetype definitions
+ */
+export function createValidatedExecute(inputSchema, outputSchema, agentName, handler) {
+    return async (input, ...args) => {
+        const ctx = args[0];
+        const validatedInput = validateInput(input, inputSchema, agentName);
+        const output = await handler(validatedInput, ctx);
+        return validateOutput(output, outputSchema, agentName);
+    };
+}
+//# sourceMappingURL=shared-validation.js.map

package/dist/shared-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-validation.js","sourceRoot":"","sources":["../src/shared-validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAoB,EACpB,IAAY;IAEZ,OAAO,eAAe,CAAC,SAAS,EAAE;QAChC,IAAI;QACJ,YAAY,EAAE,MAAM;KACrB,CAA4B,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAc,EACd,MAAoB,EACpB,SAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,4BAA4B,SAAS,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAe,EACf,MAAoB,EACpB,SAAiB;IAEjB,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,8BAA8B,SAAS,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAA8B,EAC9B,YAAgC,EAChC,SAAiB,EACjB,OAA2D;IAE3D,OAAO,KAAK,EAAE,KAAa,EAAE,GAAG,IAAe,EAAoB,EAAE;QACnE,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAa,CAAC;QAChC,MAAM,cAAc,GAAG,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QAClD,OAAO,cAAc,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;IACzD,CAAC,CAAC;AACJ,CAAC"}

package/dist/test-helpers.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Test helpers for asserting on agent results.
+ */
+import type { AgentResult, StatefulAgentResult } from '@vibe-agent-toolkit/agent-schema';
+/**
+ * Test matchers for agent results.
+ *
+ * Provides type-safe assertions that narrow TypeScript types.
+ */
+export declare const resultMatchers: {
+    /**
+     * Assert result is success and extract data.
+     *
+     * @example
+     * const output = await agent.execute(input);
+     * resultMatchers.expectSuccess(output.result);
+     * // TypeScript knows output.result.data exists here
+     * expect(output.result.data.field).toBe('value');
+     */
+    expectSuccess<T, E extends string>(result: AgentResult<T, E>): asserts result is {
+        status: "success";
+        data: T;
+    };
+    /**
+     * Assert result is error and extract error.
+     *
+     * @example
+     * const output = await agent.execute(badInput);
+     * resultMatchers.expectError(output.result);
+     * // TypeScript knows output.result.error exists here
+     * expect(output.result.error).toBe('invalid-input');
+     */
+    expectError<T, E extends string>(result: AgentResult<T, E>): asserts result is {
+        status: "error";
+        error: E;
+    };
+    /**
+     * Assert result is in-progress.
+     *
+     * @example
+     * const output = await conversationalAgent.execute(message);
+     * resultMatchers.expectInProgress(output.result);
+     * // TypeScript knows output.result.metadata might exist
+     */
+    expectInProgress<T, E extends string, M>(result: StatefulAgentResult<T, E, M>): asserts result is {
+        status: "in-progress";
+        metadata?: M;
+    };
+};
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../src/test-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAGzF;;;;GAIG;AACH,eAAO,MAAM,cAAc;IACzB;;;;;;;;OAQG;kBACW,CAAC,EAAE,CAAC,SAAS,MAAM,UACvB,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GACxB,QAAQ,MAAM,IAAI;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE;IAInD;;;;;;;;OAQG;gBACS,CAAC,EAAE,CAAC,SAAS,MAAM,UACrB,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GACxB,QAAQ,MAAM,IAAI;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE;IAIlD;;;;;;;OAOG;qBACc,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,UAC7B,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GACnC,QAAQ,MAAM,IAAI;QAAE,MAAM,EAAE,aAAa,CAAC;QAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;KAAE;CAG7D,CAAC"}

package/dist/test-helpers.js

@@ -0,0 +1,47 @@
+/**
+ * Test helpers for asserting on agent results.
+ */
+import { expect } from 'vitest';
+/**
+ * Test matchers for agent results.
+ *
+ * Provides type-safe assertions that narrow TypeScript types.
+ */
+export const resultMatchers = {
+    /**
+     * Assert result is success and extract data.
+     *
+     * @example
+     * const output = await agent.execute(input);
+     * resultMatchers.expectSuccess(output.result);
+     * // TypeScript knows output.result.data exists here
+     * expect(output.result.data.field).toBe('value');
+     */
+    expectSuccess(result) {
+        expect(result.status).toBe('success');
+    },
+    /**
+     * Assert result is error and extract error.
+     *
+     * @example
+     * const output = await agent.execute(badInput);
+     * resultMatchers.expectError(output.result);
+     * // TypeScript knows output.result.error exists here
+     * expect(output.result.error).toBe('invalid-input');
+     */
+    expectError(result) {
+        expect(result.status).toBe('error');
+    },
+    /**
+     * Assert result is in-progress.
+     *
+     * @example
+     * const output = await conversationalAgent.execute(message);
+     * resultMatchers.expectInProgress(output.result);
+     * // TypeScript knows output.result.metadata might exist
+     */
+    expectInProgress(result) {
+        expect(result.status).toBe('in-progress');
+    },
+};
+//# sourceMappingURL=test-helpers.js.map

package/dist/test-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../src/test-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;;;;;;;;OAQG;IACH,aAAa,CACX,MAAyB;QAEzB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;;;OAQG;IACH,WAAW,CACT,MAAyB;QAEzB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB,CACd,MAAoC;QAEpC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC5C,CAAC;CACF,CAAC"}