@tashiscool/agents 0.1.0

package/dist/session.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Chat Session Management
+ * Manage chat session state, context, and lifecycle
+ */
+/**
+ * Session status
+ */
+export type SessionStatus = 'active' | 'idle' | 'expired' | 'closed';
+/**
+ * Session configuration
+ */
+export interface SessionConfig {
+    /** Session timeout in milliseconds */
+    timeoutMs?: number;
+    /** Maximum messages before auto-summarization */
+    maxMessages?: number;
+    /** Auto-save interval in milliseconds */
+    autoSaveIntervalMs?: number;
+    /** Session metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Session state
+ */
+export interface SessionState {
+    /** Session ID */
+    id: string;
+    /** User ID */
+    userId?: string;
+    /** Session status */
+    status: SessionStatus;
+    /** Creation timestamp */
+    createdAt: Date;
+    /** Last activity timestamp */
+    lastActivityAt: Date;
+    /** Expiration timestamp */
+    expiresAt?: Date;
+    /** Session configuration */
+    config: SessionConfig;
+    /** Custom context data */
+    context: Record<string, unknown>;
+    /** Message count */
+    messageCount: number;
+    /** Token usage */
+    tokenUsage: {
+        input: number;
+        output: number;
+        total: number;
+    };
+}
+/**
+ * Session event types
+ */
+export type SessionEventType = 'created' | 'updated' | 'expired' | 'closed' | 'message_added' | 'context_changed';
+/**
+ * Session event
+ */
+export interface SessionEvent {
+    type: SessionEventType;
+    sessionId: string;
+    timestamp: Date;
+    data?: unknown;
+}
+/**
+ * Session event handler
+ */
+export type SessionEventHandler = (event: SessionEvent) => void | Promise<void>;
+/**
+ * Session storage interface
+ */
+export interface SessionStorage {
+    save(session: SessionState): Promise<void>;
+    load(sessionId: string): Promise<SessionState | null>;
+    delete(sessionId: string): Promise<void>;
+    listByUser(userId: string): Promise<SessionState[]>;
+    listActive(): Promise<SessionState[]>;
+}
+/**
+ * In-memory session storage
+ */
+export declare class InMemorySessionStorage implements SessionStorage {
+    private sessions;
+    save(session: SessionState): Promise<void>;
+    load(sessionId: string): Promise<SessionState | null>;
+    delete(sessionId: string): Promise<void>;
+    listByUser(userId: string): Promise<SessionState[]>;
+    listActive(): Promise<SessionState[]>;
+}
+/**
+ * Chat session manager
+ */
+export declare class ChatSession {
+    private state;
+    private storage;
+    private eventHandlers;
+    private autoSaveTimer?;
+    private expirationTimer?;
+    constructor(config?: SessionConfig, storage?: SessionStorage, existingState?: SessionState);
+    private setupTimers;
+    private clearTimers;
+    private emit;
+    /**
+     * Get session ID
+     */
+    get id(): string;
+    /**
+     * Get session status
+     */
+    get status(): SessionStatus;
+    /**
+     * Check if session is active
+     */
+    get isActive(): boolean;
+    /**
+     * Get session state
+     */
+    getState(): SessionState;
+    /**
+     * Update last activity timestamp
+     */
+    touch(): void;
+    /**
+     * Set context value
+     */
+    setContext(key: string, value: unknown): void;
+    /**
+     * Get context value
+     */
+    getContext<T>(key: string): T | undefined;
+    /**
+     * Get all context
+     */
+    getAllContext(): Record<string, unknown>;
+    /**
+     * Clear context
+     */
+    clearContext(): void;
+    /**
+     * Record message added
+     */
+    recordMessage(inputTokens?: number, outputTokens?: number): void;
+    /**
+     * Set user ID
+     */
+    setUserId(userId: string): void;
+    /**
+     * Subscribe to session events
+     */
+    on(handler: SessionEventHandler): () => void;
+    /**
+     * Save session to storage
+     */
+    save(): Promise<void>;
+    /**
+     * Mark session as expired
+     */
+    expire(): Promise<void>;
+    /**
+     * Close session
+     */
+    close(): Promise<void>;
+    /**
+     * Delete session
+     */
+    delete(): Promise<void>;
+}
+/**
+ * Session manager for handling multiple sessions
+ */
+export declare class SessionManager {
+    private storage;
+    private activeSessions;
+    private defaultConfig;
+    constructor(storage?: SessionStorage, defaultConfig?: SessionConfig);
+    /**
+     * Create a new session
+     */
+    create(config?: SessionConfig, userId?: string): Promise<ChatSession>;
+    /**
+     * Load an existing session
+     */
+    load(sessionId: string): Promise<ChatSession | null>;
+    /**
+     * Get or create session for user
+     */
+    getOrCreate(userId: string, config?: SessionConfig): Promise<ChatSession>;
+    /**
+     * List active sessions
+     */
+    listActive(): Promise<SessionState[]>;
+    /**
+     * List sessions for user
+     */
+    listByUser(userId: string): Promise<SessionState[]>;
+    /**
+     * Close all sessions for user
+     */
+    closeAllForUser(userId: string): Promise<void>;
+    /**
+     * Cleanup expired sessions
+     */
+    cleanup(): Promise<number>;
+}
+/**
+ * Create a session manager
+ */
+export declare function createSessionManager(storage?: SessionStorage, defaultConfig?: SessionConfig): SessionManager;
+/**
+ * Create a single chat session
+ */
+export declare function createChatSession(config?: SessionConfig, storage?: SessionStorage): ChatSession;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

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

package/dist/session.js

@@ -0,0 +1,347 @@
+/**
+ * Chat Session Management
+ * Manage chat session state, context, and lifecycle
+ */
+/**
+ * In-memory session storage
+ */
+export class InMemorySessionStorage {
+    sessions = new Map();
+    async save(session) {
+        this.sessions.set(session.id, { ...session });
+    }
+    async load(sessionId) {
+        const session = this.sessions.get(sessionId);
+        return session ? { ...session } : null;
+    }
+    async delete(sessionId) {
+        this.sessions.delete(sessionId);
+    }
+    async listByUser(userId) {
+        const result = [];
+        for (const session of this.sessions.values()) {
+            if (session.userId === userId) {
+                result.push({ ...session });
+            }
+        }
+        return result;
+    }
+    async listActive() {
+        const result = [];
+        for (const session of this.sessions.values()) {
+            if (session.status === 'active') {
+                result.push({ ...session });
+            }
+        }
+        return result;
+    }
+}
+/**
+ * Generate session ID
+ */
+function generateSessionId() {
+    return `sess_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+}
+/**
+ * Chat session manager
+ */
+export class ChatSession {
+    state;
+    storage;
+    eventHandlers = [];
+    autoSaveTimer;
+    expirationTimer;
+    constructor(config = {}, storage, existingState) {
+        this.storage = storage || new InMemorySessionStorage();
+        if (existingState) {
+            this.state = existingState;
+        }
+        else {
+            const now = new Date();
+            this.state = {
+                id: generateSessionId(),
+                status: 'active',
+                createdAt: now,
+                lastActivityAt: now,
+                config,
+                context: {},
+                messageCount: 0,
+                tokenUsage: { input: 0, output: 0, total: 0 },
+            };
+            if (config.timeoutMs) {
+                this.state.expiresAt = new Date(now.getTime() + config.timeoutMs);
+            }
+        }
+        this.setupTimers();
+    }
+    setupTimers() {
+        // Auto-save timer
+        if (this.state.config.autoSaveIntervalMs) {
+            this.autoSaveTimer = setInterval(() => this.save(), this.state.config.autoSaveIntervalMs);
+        }
+        // Expiration timer
+        if (this.state.expiresAt) {
+            const timeUntilExpiry = this.state.expiresAt.getTime() - Date.now();
+            if (timeUntilExpiry > 0) {
+                this.expirationTimer = setTimeout(() => this.expire(), timeUntilExpiry);
+            }
+        }
+    }
+    clearTimers() {
+        if (this.autoSaveTimer) {
+            clearInterval(this.autoSaveTimer);
+        }
+        if (this.expirationTimer) {
+            clearTimeout(this.expirationTimer);
+        }
+    }
+    async emit(type, data) {
+        const event = {
+            type,
+            sessionId: this.state.id,
+            timestamp: new Date(),
+            data,
+        };
+        for (const handler of this.eventHandlers) {
+            await handler(event);
+        }
+    }
+    /**
+     * Get session ID
+     */
+    get id() {
+        return this.state.id;
+    }
+    /**
+     * Get session status
+     */
+    get status() {
+        return this.state.status;
+    }
+    /**
+     * Check if session is active
+     */
+    get isActive() {
+        return this.state.status === 'active';
+    }
+    /**
+     * Get session state
+     */
+    getState() {
+        return { ...this.state };
+    }
+    /**
+     * Update last activity timestamp
+     */
+    touch() {
+        this.state.lastActivityAt = new Date();
+        // Reset expiration timer
+        if (this.state.config.timeoutMs) {
+            this.clearTimers();
+            this.state.expiresAt = new Date(Date.now() + this.state.config.timeoutMs);
+            this.setupTimers();
+        }
+    }
+    /**
+     * Set context value
+     */
+    setContext(key, value) {
+        this.state.context[key] = value;
+        this.touch();
+        this.emit('context_changed', { key, value });
+    }
+    /**
+     * Get context value
+     */
+    getContext(key) {
+        return this.state.context[key];
+    }
+    /**
+     * Get all context
+     */
+    getAllContext() {
+        return { ...this.state.context };
+    }
+    /**
+     * Clear context
+     */
+    clearContext() {
+        this.state.context = {};
+        this.emit('context_changed', { cleared: true });
+    }
+    /**
+     * Record message added
+     */
+    recordMessage(inputTokens = 0, outputTokens = 0) {
+        this.state.messageCount++;
+        this.state.tokenUsage.input += inputTokens;
+        this.state.tokenUsage.output += outputTokens;
+        this.state.tokenUsage.total += inputTokens + outputTokens;
+        this.touch();
+        this.emit('message_added', {
+            messageCount: this.state.messageCount,
+            tokenUsage: this.state.tokenUsage,
+        });
+    }
+    /**
+     * Set user ID
+     */
+    setUserId(userId) {
+        this.state.userId = userId;
+    }
+    /**
+     * Subscribe to session events
+     */
+    on(handler) {
+        this.eventHandlers.push(handler);
+        return () => {
+            const index = this.eventHandlers.indexOf(handler);
+            if (index !== -1) {
+                this.eventHandlers.splice(index, 1);
+            }
+        };
+    }
+    /**
+     * Save session to storage
+     */
+    async save() {
+        await this.storage.save(this.state);
+    }
+    /**
+     * Mark session as expired
+     */
+    async expire() {
+        this.state.status = 'expired';
+        this.clearTimers();
+        await this.save();
+        await this.emit('expired');
+    }
+    /**
+     * Close session
+     */
+    async close() {
+        this.state.status = 'closed';
+        this.clearTimers();
+        await this.save();
+        await this.emit('closed');
+    }
+    /**
+     * Delete session
+     */
+    async delete() {
+        this.clearTimers();
+        await this.storage.delete(this.state.id);
+    }
+}
+/**
+ * Session manager for handling multiple sessions
+ */
+export class SessionManager {
+    storage;
+    activeSessions = new Map();
+    defaultConfig;
+    constructor(storage, defaultConfig = {}) {
+        this.storage = storage || new InMemorySessionStorage();
+        this.defaultConfig = defaultConfig;
+    }
+    /**
+     * Create a new session
+     */
+    async create(config, userId) {
+        const mergedConfig = { ...this.defaultConfig, ...config };
+        const session = new ChatSession(mergedConfig, this.storage);
+        if (userId) {
+            session.setUserId(userId);
+        }
+        await session.save();
+        this.activeSessions.set(session.id, session);
+        return session;
+    }
+    /**
+     * Load an existing session
+     */
+    async load(sessionId) {
+        // Check active cache
+        if (this.activeSessions.has(sessionId)) {
+            return this.activeSessions.get(sessionId);
+        }
+        // Load from storage
+        const state = await this.storage.load(sessionId);
+        if (!state)
+            return null;
+        const session = new ChatSession(state.config, this.storage, state);
+        if (session.isActive) {
+            this.activeSessions.set(sessionId, session);
+        }
+        return session;
+    }
+    /**
+     * Get or create session for user
+     */
+    async getOrCreate(userId, config) {
+        // Find existing active session
+        const userSessions = await this.storage.listByUser(userId);
+        const activeSession = userSessions.find((s) => s.status === 'active');
+        if (activeSession) {
+            return this.load(activeSession.id);
+        }
+        // Create new session
+        return this.create(config, userId);
+    }
+    /**
+     * List active sessions
+     */
+    async listActive() {
+        return this.storage.listActive();
+    }
+    /**
+     * List sessions for user
+     */
+    async listByUser(userId) {
+        return this.storage.listByUser(userId);
+    }
+    /**
+     * Close all sessions for user
+     */
+    async closeAllForUser(userId) {
+        const sessions = await this.storage.listByUser(userId);
+        for (const state of sessions) {
+            if (state.status === 'active') {
+                const session = await this.load(state.id);
+                if (session) {
+                    await session.close();
+                }
+            }
+        }
+    }
+    /**
+     * Cleanup expired sessions
+     */
+    async cleanup() {
+        const active = await this.storage.listActive();
+        let cleaned = 0;
+        for (const state of active) {
+            if (state.expiresAt && state.expiresAt < new Date()) {
+                const session = await this.load(state.id);
+                if (session) {
+                    await session.expire();
+                    cleaned++;
+                }
+            }
+        }
+        return cleaned;
+    }
+}
+/**
+ * Create a session manager
+ */
+export function createSessionManager(storage, defaultConfig) {
+    return new SessionManager(storage, defaultConfig);
+}
+/**
+ * Create a single chat session
+ */
+export function createChatSession(config, storage) {
+    return new ChatSession(config, storage);
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/tools.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Tool Definition
+ * Define and manage LLM tools/functions in a type-safe way
+ */
+import { type ZodSchema } from 'zod';
+/**
+ * JSON Schema representation for tool parameters
+ */
+export interface JsonSchema {
+    type: string;
+    properties?: Record<string, JsonSchema>;
+    required?: string[];
+    items?: JsonSchema;
+    enum?: string[];
+    description?: string;
+    default?: unknown;
+}
+/**
+ * Tool definition
+ */
+export interface ToolDefinition<TParams = unknown, TResult = unknown> {
+    /** Tool name */
+    name: string;
+    /** Tool description for the LLM */
+    description: string;
+    /** Zod schema for parameters */
+    parameters: ZodSchema<TParams>;
+    /** Tool execution function */
+    execute: (params: TParams) => Promise<TResult>;
+}
+/**
+ * Tool in OpenAI function calling format
+ */
+export interface OpenAITool {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: JsonSchema;
+    };
+}
+/**
+ * Tool in Anthropic format
+ */
+export interface AnthropicTool {
+    name: string;
+    description: string;
+    input_schema: JsonSchema;
+}
+/**
+ * Tool call from LLM response
+ */
+export interface ToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/**
+ * Tool execution result
+ */
+export interface ToolResult {
+    toolCallId: string;
+    name: string;
+    result: unknown;
+    error?: string;
+}
+/**
+ * Convert Zod schema to JSON Schema
+ */
+export declare function zodToJsonSchema(schema: ZodSchema): JsonSchema;
+/**
+ * Define a tool with type-safe parameters
+ */
+export declare function defineTool<TParams, TResult>(config: ToolDefinition<TParams, TResult>): ToolDefinition<TParams, TResult>;
+/**
+ * Convert tool definition to OpenAI format
+ */
+export declare function toOpenAITool(tool: ToolDefinition): OpenAITool;
+/**
+ * Convert tool definition to Anthropic format
+ */
+export declare function toAnthropicTool(tool: ToolDefinition): AnthropicTool;
+/**
+ * Tool executor for handling tool calls
+ */
+export declare class ToolExecutor {
+    private tools;
+    /**
+     * Register a tool
+     */
+    register<TParams, TResult>(tool: ToolDefinition<TParams, TResult>): void;
+    /**
+     * Register multiple tools
+     */
+    registerAll(tools: ToolDefinition[]): void;
+    /**
+     * Get a tool by name
+     */
+    get(name: string): ToolDefinition | undefined;
+    /**
+     * List all registered tools
+     */
+    list(): ToolDefinition[];
+    /**
+     * Get tools in OpenAI format
+     */
+    toOpenAI(): OpenAITool[];
+    /**
+     * Get tools in Anthropic format
+     */
+    toAnthropic(): AnthropicTool[];
+    /**
+     * Execute a tool call
+     */
+    execute(call: ToolCall): Promise<ToolResult>;
+    /**
+     * Execute multiple tool calls
+     */
+    executeAll(calls: ToolCall[]): Promise<ToolResult[]>;
+}
+/**
+ * Create a new tool executor
+ */
+export declare function createToolExecutor(tools?: ToolDefinition[]): ToolExecutor;
+//# sourceMappingURL=tools.d.ts.map