@vibe-agent-toolkit/transports 0.1.2-rc.4

package/README.md

@@ -0,0 +1,281 @@
+# @vibe-agent-toolkit/transports
+
+Transport adapters for VAT conversational agents.
+
+## Overview
+
+Transports connect conversational functions to different interaction channels (CLI, WebSocket, HTTP, etc.) without coupling to specific runtime implementations. This package provides the core transport abstraction and two reference implementations.
+
+## Installation
+
+```bash
+npm install @vibe-agent-toolkit/transports
+```
+
+## Core Concepts
+
+### Conversational Function
+
+A conversational function is any async function that:
+- Takes input and session state
+- Returns output and updated session state
+
+```typescript
+type ConversationalFunction<TInput, TOutput, TState> = (
+  input: TInput,
+  session: Session<TState>
+) => Promise<{
+  output: TOutput;
+  session: Session<TState>;
+}>;
+```
+
+### Session
+
+A session contains conversation history and application-specific state:
+
+```typescript
+type Session<TState> = {
+  history: Message[];
+  state: TState;
+};
+```
+
+### Transport
+
+A transport provides lifecycle management for running conversational functions:
+
+```typescript
+interface Transport {
+  start(): Promise<void>;
+  stop(): Promise<void>;
+}
+```
+
+## CLI Transport
+
+Interactive command-line interface with built-in commands and conversation history.
+
+### Features
+
+- Local session management (single user)
+- Built-in commands: `/quit`, `/state`, `/restart`, `/help`
+- Optional colored output
+- Configurable prompts
+
+### Usage
+
+```typescript
+import { CLITransport } from '@vibe-agent-toolkit/transports';
+
+// Create a simple echo agent
+const echoFn = async (input: string, session: Session<any>) => {
+  const newHistory = [
+    ...session.history,
+    { role: 'user', content: input },
+    { role: 'assistant', content: `Echo: ${input}` },
+  ];
+  return {
+    output: `Echo: ${input}`,
+    session: { ...session, history: newHistory },
+  };
+};
+
+// Run with CLI transport
+const transport = new CLITransport({
+  fn: echoFn,
+  showState: true,
+  colors: true,
+});
+
+await transport.start();
+```
+
+### Options
+
+```typescript
+interface CLITransportOptions<TState> {
+  fn: ConversationalFunction<string, string, TState>;
+  initialSession?: Session<TState>;
+  colors?: boolean; // Default: true
+  showState?: boolean; // Default: false
+  prompt?: string; // Default: "You: "
+  assistantPrefix?: string; // Default: "Assistant: "
+}
+```
+
+### Built-in Commands
+
+- `/help` - Show available commands
+- `/state` - Display current session state
+- `/restart` - Clear history and reset state
+- `/quit` - Exit the CLI
+
+## WebSocket Transport
+
+Real-time bidirectional communication with per-connection session isolation.
+
+### Features
+
+- Per-connection session management
+- JSON message format
+- Automatic session cleanup on disconnect
+- Configurable host and port
+
+### Usage
+
+```typescript
+import { WebSocketTransport } from '@vibe-agent-toolkit/transports';
+
+// Create a stateful counter agent
+const counterFn = async (input: string, session: Session<{ count: number }>) => {
+  const count = (session.state?.count ?? 0) + 1;
+  const newHistory = [
+    ...session.history,
+    { role: 'user', content: input },
+    { role: 'assistant', content: `Message #${count}` },
+  ];
+  return {
+    output: `Message #${count}`,
+    session: { history: newHistory, state: { count } },
+  };
+};
+
+// Run with WebSocket transport
+const transport = new WebSocketTransport({
+  fn: counterFn,
+  port: 8080,
+  createInitialSession: () => ({ history: [], state: { count: 0 } }),
+});
+
+await transport.start();
+// Server listening on ws://localhost:8080
+```
+
+### Options
+
+```typescript
+interface WebSocketTransportOptions<TState> {
+  fn: ConversationalFunction<string, string, TState>;
+  port?: number; // Default: 8080
+  host?: string; // Default: 'localhost'
+  createInitialSession?: () => Session<TState>;
+}
+```
+
+### Message Format
+
+**Client → Server:**
+```json
+{
+  "type": "message",
+  "content": "Hello"
+}
+```
+
+**Server → Client (success):**
+```json
+{
+  "type": "message",
+  "reply": "Response text",
+  "state": { "count": 1 }
+}
+```
+
+**Server → Client (error):**
+```json
+{
+  "type": "error",
+  "error": "Error message"
+}
+```
+
+### Client Example
+
+```typescript
+import { WebSocket } from 'ws';
+
+const ws = new WebSocket('ws://localhost:8080');
+
+ws.on('open', () => {
+  ws.send(JSON.stringify({
+    type: 'message',
+    content: 'Hello, agent!'
+  }));
+});
+
+ws.on('message', (data) => {
+  const response = JSON.parse(data.toString());
+  console.log('Reply:', response.reply);
+  console.log('State:', response.state);
+});
+```
+
+## Using with Runtime Adapters
+
+Transports work with any runtime adapter that implements the conversational function signature:
+
+```typescript
+import { CLITransport } from '@vibe-agent-toolkit/transports';
+import { createClaudeSkillAdapter } from '@vibe-agent-toolkit/runtime-claude-skills';
+
+// Create adapter from Claude skill
+const adapter = createClaudeSkillAdapter({
+  skillDir: './my-skill',
+  apiKey: process.env.ANTHROPIC_API_KEY,
+});
+
+// Run with CLI transport
+const transport = new CLITransport({
+  fn: adapter.conversationalFn,
+});
+
+await transport.start();
+```
+
+## Architecture
+
+### No Session IDs in Core Types
+
+The transport abstraction intentionally excludes session IDs from core types. Session management is transport-specific:
+
+- **CLI Transport**: Single local session (no ID needed)
+- **WebSocket Transport**: Per-connection sessions (WeakMap keyed by socket)
+- **HTTP Transport** (future): Session IDs in cookies/headers
+
+This design keeps the core types simple while allowing each transport to implement session management appropriately.
+
+### Transport Independence
+
+Transports are independent of runtime implementations. The same conversational function can run on any transport:
+
+```typescript
+// Same function, different transports
+const myFn = createMyAgent();
+
+// CLI
+const cliTransport = new CLITransport({ fn: myFn });
+
+// WebSocket
+const wsTransport = new WebSocketTransport({ fn: myFn });
+
+// HTTP (future)
+const httpTransport = new HTTPTransport({ fn: myFn });
+```
+
+## TypeScript
+
+This package is written in TypeScript and provides full type definitions.
+
+```typescript
+import type {
+  Transport,
+  ConversationalFunction,
+  Session,
+  Message,
+} from '@vibe-agent-toolkit/transports';
+```
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,92 @@
+/**
+ * CLI transport for conversational agents.
+ *
+ * Provides an interactive command-line interface with:
+ * - Conversation history
+ * - Local session state
+ * - Built-in commands (/quit, /state, /restart)
+ * - Optional colored output
+ */
+import type { Message, SessionStore } from '@vibe-agent-toolkit/agent-runtime';
+import type { ConversationalFunction, Transport } from './types.js';
+/**
+ * Options for CLI transport.
+ */
+export interface CLITransportOptions<TState = any> {
+    /** The conversational function to run */
+    fn: ConversationalFunction<string, string, TState>;
+    /** Session identifier (default: "cli-singleton") */
+    sessionId?: string;
+    /** Session store for persistence (optional, enables durable sessions) */
+    sessionStore?: SessionStore<TState>;
+    /** Initial conversation history (default: [], fallback if session not found) */
+    initialHistory?: Message[];
+    /** Initial session state (default: undefined, fallback if session not found) */
+    initialState?: TState;
+    /** Enable colored output (default: true) */
+    colors?: boolean;
+    /** Show state after each interaction (default: false) */
+    showState?: boolean;
+    /** Prompt prefix (default: "You: ") */
+    prompt?: string;
+    /** Assistant prefix (default: "Assistant: ") */
+    assistantPrefix?: string;
+}
+/**
+ * CLI transport implementation.
+ *
+ * Manages a single local session and provides an interactive REPL.
+ * Supports pluggable session stores for persistence.
+ */
+export declare class CLITransport<TState = any> implements Transport {
+    private readonly fn;
+    private readonly sessionId;
+    private readonly sessionStore;
+    private sessionLoaded;
+    private conversationHistory;
+    private state;
+    private readonly colors;
+    private readonly showState;
+    private readonly prompt;
+    private readonly assistantPrefix;
+    private rl;
+    constructor(options: CLITransportOptions<TState>);
+    /**
+     * Start the CLI transport.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the CLI transport.
+     */
+    stop(): Promise<void>;
+    /**
+     * Load session from store if available.
+     * Falls back to initial history/state if session not found.
+     */
+    private loadSessionIfNeeded;
+    /**
+     * Save current session to store if available.
+     */
+    private saveSessionIfNeeded;
+    /**
+     * Handle built-in commands.
+     */
+    private handleCommand;
+    /**
+     * Print welcome message.
+     */
+    private printWelcome;
+    /**
+     * Print help message.
+     */
+    private printHelp;
+    /**
+     * Print current session state.
+     */
+    private printState;
+    /**
+     * Colorize text if colors are enabled.
+     */
+    private colorize;
+}
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAkB,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAE/F,OAAO,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAA2B,MAAM,YAAY,CAAC;AAE7F;;GAEG;AAEH,MAAM,WAAW,mBAAmB,CAAC,MAAM,GAAG,GAAG;IAC/C,yCAAyC;IACzC,EAAE,EAAE,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,gFAAgF;IAChF,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AAEH,qBAAa,YAAY,CAAC,MAAM,GAAG,GAAG,CAAE,YAAW,SAAS;IAC1D,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiD;IACpE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmC;IAChE,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,mBAAmB,CAAY;IACvC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,EAAE,CAAmC;gBAEjC,OAAO,EAAE,mBAAmB,CAAC,MAAM,CAAC;IAYhD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwE5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B;;;OAGG;YACW,mBAAmB;IAmBjC;;OAEG;YACW,mBAAmB;IAkCjC;;OAEG;YACW,aAAa;IAuC3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAgBjB"}

package/dist/cli.js

@@ -0,0 +1,250 @@
+/**
+ * CLI transport for conversational agents.
+ *
+ * Provides an interactive command-line interface with:
+ * - Conversation history
+ * - Local session state
+ * - Built-in commands (/quit, /state, /restart)
+ * - Optional colored output
+ */
+import * as readline from 'node:readline';
+/**
+ * CLI transport implementation.
+ *
+ * Manages a single local session and provides an interactive REPL.
+ * Supports pluggable session stores for persistence.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export class CLITransport {
+    fn;
+    sessionId;
+    sessionStore;
+    sessionLoaded = false;
+    conversationHistory;
+    state;
+    colors;
+    showState;
+    prompt;
+    assistantPrefix;
+    rl = null;
+    constructor(options) {
+        this.fn = options.fn;
+        this.sessionId = options.sessionId ?? 'cli-singleton';
+        this.sessionStore = options.sessionStore;
+        this.conversationHistory = options.initialHistory ?? [];
+        this.state = options.initialState ?? undefined;
+        this.colors = options.colors ?? true;
+        this.showState = options.showState ?? false;
+        this.prompt = options.prompt ?? 'You: ';
+        this.assistantPrefix = options.assistantPrefix ?? 'Assistant: ';
+    }
+    /**
+     * Start the CLI transport.
+     */
+    async start() {
+        // Lazy load session from store if available
+        await this.loadSessionIfNeeded();
+        this.rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+            prompt: this.colorize(this.prompt, 'cyan'),
+        });
+        this.printWelcome();
+        this.rl.on('line', (line) => {
+            void (async () => {
+                const input = line.trim();
+                if (!input) {
+                    this.rl?.prompt();
+                    return;
+                }
+                // Handle commands
+                if (input.startsWith('/')) {
+                    await this.handleCommand(input);
+                    this.rl?.prompt();
+                    return;
+                }
+                // Process user input
+                try {
+                    // Add user message to history
+                    this.conversationHistory.push({ role: 'user', content: input });
+                    // Pass session context (just ID and current state)
+                    const context = {
+                        sessionId: this.sessionId,
+                        conversationHistory: this.conversationHistory,
+                        state: this.state,
+                    };
+                    const output = await this.fn(input, context);
+                    // Update session state (function may have mutated context.state)
+                    this.state = context.state;
+                    // Add assistant response to history
+                    this.conversationHistory.push({ role: 'assistant', content: output });
+                    console.log(this.colorize(this.assistantPrefix, 'green') + output);
+                    if (this.showState) {
+                        this.printState();
+                    }
+                    // Save session after successful interaction
+                    await this.saveSessionIfNeeded();
+                }
+                catch (error) {
+                    console.error(this.colorize('Error: ', 'red') + (error instanceof Error ? error.message : String(error)));
+                }
+                this.rl?.prompt();
+            })();
+        });
+        this.rl.on('close', () => {
+            console.log(this.colorize('\nGoodbye!', 'yellow'));
+            process.exit(0);
+        });
+        this.rl.prompt();
+    }
+    /**
+     * Stop the CLI transport.
+     */
+    async stop() {
+        // Save final session state before stopping
+        await this.saveSessionIfNeeded();
+        this.rl?.close();
+        this.rl = null;
+    }
+    /**
+     * Load session from store if available.
+     * Falls back to initial history/state if session not found.
+     */
+    async loadSessionIfNeeded() {
+        if (this.sessionLoaded || !this.sessionStore) {
+            return;
+        }
+        try {
+            const session = await this.sessionStore.load(this.sessionId);
+            this.conversationHistory = session.history;
+            this.state = session.state;
+            console.log(this.colorize(`✓ Resumed session: ${this.sessionId}`, 'green'));
+            console.log(this.colorize(`  ${session.history.length} messages in history`, 'gray'));
+        }
+        catch {
+            // Session not found or error loading - use initial values
+            // This is expected for new sessions
+        }
+        this.sessionLoaded = true;
+    }
+    /**
+     * Save current session to store if available.
+     */
+    async saveSessionIfNeeded() {
+        if (!this.sessionStore) {
+            return;
+        }
+        try {
+            // Check if session exists first
+            const exists = await this.sessionStore.exists(this.sessionId);
+            if (exists) {
+                // Load existing session to preserve metadata
+                const session = await this.sessionStore.load(this.sessionId);
+                session.history = this.conversationHistory;
+                session.state = this.state;
+                await this.sessionStore.save(session);
+            }
+            else {
+                // Create new session with our sessionId (not a generated UUID)
+                const session = {
+                    id: this.sessionId,
+                    history: this.conversationHistory,
+                    state: this.state,
+                    metadata: {
+                        createdAt: new Date(),
+                        lastAccessedAt: new Date(),
+                    },
+                };
+                await this.sessionStore.save(session);
+            }
+        }
+        catch (error) {
+            // Log error but don't crash - session persistence is optional
+            console.error(this.colorize('Warning: Failed to save session: ', 'yellow') + (error instanceof Error ? error.message : String(error)));
+        }
+    }
+    /**
+     * Handle built-in commands.
+     */
+    async handleCommand(cmd) {
+        const command = cmd.toLowerCase();
+        switch (command) {
+            case '/quit':
+            case '/exit':
+                await this.stop();
+                break;
+            case '/state':
+                this.printState();
+                break;
+            case '/clear':
+            case '/restart': // Alias for backward compatibility
+                // Delete session from store if available
+                if (this.sessionStore) {
+                    try {
+                        await this.sessionStore.delete(this.sessionId);
+                        console.log(this.colorize('✓ Session deleted from store', 'green'));
+                    }
+                    catch (error) {
+                        console.error(this.colorize('Warning: Failed to delete session: ', 'yellow') + (error instanceof Error ? error.message : String(error)));
+                    }
+                }
+                this.conversationHistory = [];
+                this.state = undefined;
+                console.log(this.colorize('Session cleared.', 'yellow'));
+                break;
+            case '/help':
+                this.printHelp();
+                break;
+            default:
+                console.log(this.colorize(`Unknown command: ${cmd}`, 'red'));
+                console.log(this.colorize('Type /help for available commands.', 'yellow'));
+        }
+    }
+    /**
+     * Print welcome message.
+     */
+    printWelcome() {
+        console.log(this.colorize('=== CLI Transport ===', 'cyan'));
+        console.log(this.colorize('Commands: /help /state /clear /quit', 'gray'));
+        console.log();
+    }
+    /**
+     * Print help message.
+     */
+    printHelp() {
+        console.log(this.colorize('\nAvailable commands:', 'cyan'));
+        console.log(this.colorize('  /help     ', 'yellow') + '- Show this help message');
+        console.log(this.colorize('  /state    ', 'yellow') + '- Display current session state');
+        console.log(this.colorize('  /clear    ', 'yellow') + '- Clear session (delete history and state)');
+        console.log(this.colorize('  /quit     ', 'yellow') + '- Exit the CLI');
+        console.log();
+    }
+    /**
+     * Print current session state.
+     */
+    printState() {
+        console.log(this.colorize('\n--- Session State ---', 'cyan'));
+        console.log(this.colorize('Session ID: ', 'yellow') + this.sessionId);
+        console.log(this.colorize('History length: ', 'yellow') + this.conversationHistory.length);
+        console.log(this.colorize('State: ', 'yellow') + JSON.stringify(this.state, null, 2));
+        console.log();
+    }
+    /**
+     * Colorize text if colors are enabled.
+     */
+    colorize(text, color) {
+        if (!this.colors) {
+            return text;
+        }
+        const colors = {
+            cyan: '\x1b[36m',
+            green: '\x1b[32m',
+            yellow: '\x1b[33m',
+            red: '\x1b[31m',
+            gray: '\x1b[90m',
+        };
+        const reset = '\x1b[0m';
+        return colors[color] + text + reset;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @vibe-agent-toolkit/transports
+ *
+ * Transport adapters for VAT conversational agents.
+ *
+ * Provides implementations for different interaction channels:
+ * - CLI: Interactive command-line interface
+ * - WebSocket: Real-time bidirectional communication
+ *
+ * @packageDocumentation
+ */
+export type { Session, TransportSessionContext, ConversationalFunction, Transport } from './types.js';
+export { CLITransport, type CLITransportOptions } from './cli.js';
+export { WebSocketTransport, type WebSocketTransportOptions, type WebSocketIncomingMessage, type WebSocketOutgoingMessage } from './websocket.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EAAE,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACtG,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,KAAK,wBAAwB,EAAE,KAAK,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @vibe-agent-toolkit/transports
+ *
+ * Transport adapters for VAT conversational agents.
+ *
+ * Provides implementations for different interaction channels:
+ * - CLI: Interactive command-line interface
+ * - WebSocket: Real-time bidirectional communication
+ *
+ * @packageDocumentation
+ */
+export { CLITransport } from './cli.js';
+export { WebSocketTransport } from './websocket.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,YAAY,EAA4B,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAgG,MAAM,gBAAgB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Core types for VAT transport layer.
+ *
+ * Transports connect conversational functions to different interaction channels
+ * (CLI, WebSocket, HTTP, etc.) without coupling to specific runtime implementations.
+ */
+import type { Message } from '@vibe-agent-toolkit/agent-runtime';
+/**
+ * Transport-level session context.
+ *
+ * Contains session identification only - not storage.
+ * Runtime adapters are responsible for loading/saving session data.
+ *
+ * @template TState - Custom state type (application-specific)
+ */
+export interface TransportSessionContext<TState = unknown> {
+    /** Session identifier (opaque to transport) */
+    sessionId: string;
+    /** Conversation history (loaded by runtime) */
+    conversationHistory: Message[];
+    /** Application-specific state (loaded by runtime) */
+    state: TState;
+}
+/**
+ * A conversational function that uses session context.
+ *
+ * The runtime adapter is responsible for loading/saving session data.
+ *
+ * @template TInput - Input type (e.g., string for text, object for structured)
+ * @template TOutput - Output type (e.g., string for text, object for structured)
+ * @template TState - Session state type
+ */
+export type ConversationalFunction<TInput = any, TOutput = any, TState = any> = (input: TInput, context: TransportSessionContext<TState>) => Promise<TOutput>;
+/**
+ * DEPRECATED: Old Session type for backward compatibility.
+ *
+ * Use RuntimeSession from @vibe-agent-toolkit/agent-runtime instead.
+ *
+ * @deprecated Use TransportSessionContext instead
+ * @template TState - Custom state type (application-specific)
+ */
+export type Session<TState = unknown> = {
+    /** Conversation history */
+    history: Message[];
+    /** Application-specific state */
+    state: TState;
+};
+/**
+ * Transport interface for running conversational agents.
+ *
+ * Transports handle lifecycle and I/O for different interaction channels.
+ */
+export interface Transport {
+    /** Start the transport (e.g., begin listening for connections) */
+    start(): Promise<void>;
+    /** Stop the transport (e.g., close connections and clean up) */
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB,CAAC,MAAM,GAAG,OAAO;IACvD,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,mBAAmB,EAAE,OAAO,EAAE,CAAC;IAC/B,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AAEH,MAAM,MAAM,sBAAsB,CAAC,MAAM,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,CAC9E,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,uBAAuB,CAAC,MAAM,CAAC,KACrC,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,CAAC,MAAM,GAAG,OAAO,IAAI;IACtC,2BAA2B;IAC3B,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,kEAAkE;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,gEAAgE;IAChE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Core types for VAT transport layer.
+ *
+ * Transports connect conversational functions to different interaction channels
+ * (CLI, WebSocket, HTTP, etc.) without coupling to specific runtime implementations.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/websocket.d.ts

@@ -0,0 +1,77 @@
+/**
+ * WebSocket transport for conversational agents.
+ *
+ * Provides a WebSocket server with:
+ * - Per-connection session isolation
+ * - JSON message format
+ * - Automatic session cleanup on disconnect
+ */
+import type { ConversationalFunction, Transport } from './types.js';
+/**
+ * Options for WebSocket transport.
+ */
+export interface WebSocketTransportOptions<TState = any> {
+    /** The conversational function to run */
+    fn: ConversationalFunction<string, string, TState>;
+    /** Port to listen on (default: 8080) */
+    port?: number;
+    /** Host to bind to (default: 'localhost') */
+    host?: string;
+    /** Session ID generator (default: crypto.randomUUID) */
+    generateSessionId?: () => string;
+    /** Factory for initial session state per connection */
+    createInitialState?: () => TState;
+}
+/**
+ * WebSocket message format (client → server).
+ */
+export interface WebSocketIncomingMessage {
+    type: 'message';
+    content: string;
+}
+/**
+ * WebSocket response format (server → client).
+ */
+export interface WebSocketOutgoingMessage<TState = any> {
+    type: 'message' | 'error';
+    reply?: string;
+    state?: TState;
+    error?: string;
+}
+/**
+ * WebSocket transport implementation.
+ *
+ * Each connection maintains its own isolated session.
+ * Uses in-memory session management for MVP.
+ */
+export declare class WebSocketTransport<TState = any> implements Transport {
+    private readonly fn;
+    private readonly port;
+    private readonly host;
+    private readonly generateSessionId;
+    private readonly createInitialState;
+    private server;
+    private readonly sessions;
+    constructor(options: WebSocketTransportOptions<TState>);
+    /**
+     * Start the WebSocket server.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the WebSocket server.
+     */
+    stop(): Promise<void>;
+    /**
+     * Handle a new WebSocket connection.
+     */
+    private handleConnection;
+    /**
+     * Handle an incoming message from a client.
+     */
+    private handleMessage;
+    /**
+     * Send an error message to a client.
+     */
+    private sendError;
+}
+//# sourceMappingURL=websocket.d.ts.map

package/dist/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../src/websocket.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,SAAS,EAA2B,MAAM,YAAY,CAAC;AAE7F;;GAEG;AAEH,MAAM,WAAW,yBAAyB,CAAC,MAAM,GAAG,GAAG;IACrD,yCAAyC;IACzC,EAAE,EAAE,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,MAAM,CAAC;IACjC,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,MAAM,MAAM,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AAEH,MAAM,WAAW,wBAAwB,CAAC,MAAM,GAAG,GAAG;IACpD,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAWD;;;;;GAKG;AAEH,qBAAa,kBAAkB,CAAC,MAAM,GAAG,GAAG,CAAE,YAAW,SAAS;IAChE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiD;IACpE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAe;IACjD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAe;IAClD,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsD;gBAEnE,OAAO,EAAE,yBAAyB,CAAC,MAAM,CAAC;IAQtD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;OAEG;YACW,aAAa;IAmD3B;;OAEG;IACH,OAAO,CAAC,SAAS;CAOlB"}

package/dist/websocket.js

@@ -0,0 +1,155 @@
+/**
+ * WebSocket transport for conversational agents.
+ *
+ * Provides a WebSocket server with:
+ * - Per-connection session isolation
+ * - JSON message format
+ * - Automatic session cleanup on disconnect
+ */
+import { WebSocketServer } from 'ws';
+/**
+ * WebSocket transport implementation.
+ *
+ * Each connection maintains its own isolated session.
+ * Uses in-memory session management for MVP.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export class WebSocketTransport {
+    fn;
+    port;
+    host;
+    generateSessionId;
+    createInitialState;
+    server = null;
+    sessions = new WeakMap();
+    constructor(options) {
+        this.fn = options.fn;
+        this.port = options.port ?? 8080;
+        this.host = options.host ?? 'localhost';
+        this.generateSessionId = options.generateSessionId ?? (() => crypto.randomUUID());
+        this.createInitialState = options.createInitialState ?? (() => undefined);
+    }
+    /**
+     * Start the WebSocket server.
+     */
+    async start() {
+        return new Promise((resolve, reject) => {
+            this.server = new WebSocketServer({ host: this.host, port: this.port });
+            this.server.on('error', reject);
+            this.server.on('listening', () => {
+                console.log(`WebSocket server listening on ws://${this.host}:${this.port}`);
+                resolve();
+            });
+            this.server.on('connection', (ws) => {
+                this.handleConnection(ws);
+            });
+        });
+    }
+    /**
+     * Stop the WebSocket server.
+     */
+    async stop() {
+        return new Promise((resolve, reject) => {
+            if (!this.server) {
+                resolve();
+                return;
+            }
+            // Close all active connections
+            for (const client of this.server.clients) {
+                if (client.readyState === client.OPEN) {
+                    client.close(1000, 'Server shutting down');
+                }
+            }
+            // Close the server
+            this.server.close((err) => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    this.server = null;
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * Handle a new WebSocket connection.
+     */
+    handleConnection(ws) {
+        // Create session for this connection
+        const sessionId = this.generateSessionId();
+        const session = {
+            sessionId,
+            conversationHistory: [],
+            state: this.createInitialState(),
+        };
+        this.sessions.set(ws, session);
+        console.log(`Client connected (session: ${sessionId})`);
+        ws.on('message', (data) => {
+            void this.handleMessage(ws, data);
+        });
+        ws.on('close', () => {
+            // Session cleanup happens automatically via WeakMap
+            console.log(`Client disconnected (session: ${sessionId})`);
+        });
+        ws.on('error', (error) => {
+            console.error('WebSocket error:', error);
+        });
+    }
+    /**
+     * Handle an incoming message from a client.
+     */
+    async handleMessage(ws, data) {
+        try {
+            // Parse message
+            const message = JSON.parse(data.toString());
+            if (message.type !== 'message' || typeof message.content !== 'string') {
+                this.sendError(ws, 'Invalid message format. Expected: { type: "message", content: string }');
+                return;
+            }
+            // Get session for this connection
+            const session = this.sessions.get(ws);
+            if (!session) {
+                // Session lost (shouldn't happen, but handle gracefully)
+                this.sendError(ws, 'Session not found');
+                return;
+            }
+            // Add user message to history
+            session.conversationHistory.push({ role: 'user', content: message.content });
+            // Pass session context
+            const context = {
+                sessionId: session.sessionId,
+                conversationHistory: session.conversationHistory,
+                state: session.state,
+            };
+            // Process message through conversational function
+            const output = await this.fn(message.content, context);
+            // Update session state (function may have mutated context.state)
+            session.state = context.state;
+            // Add assistant response to history
+            session.conversationHistory.push({ role: 'assistant', content: output });
+            // Send response
+            const response = {
+                type: 'message',
+                reply: output,
+                state: session.state,
+            };
+            ws.send(JSON.stringify(response));
+        }
+        catch (error) {
+            console.error('Error processing message:', error);
+            this.sendError(ws, error instanceof Error ? error.message : 'Unknown error');
+        }
+    }
+    /**
+     * Send an error message to a client.
+     */
+    sendError(ws, error) {
+        const response = {
+            type: 'error',
+            error,
+        };
+        ws.send(JSON.stringify(response));
+    }
+}
+//# sourceMappingURL=websocket.js.map

package/dist/websocket.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@vibe-agent-toolkit/transports",
+  "version": "0.1.2-rc.4",
+  "description": "Transport adapters for VAT conversational agents",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@vibe-agent-toolkit/agent-runtime": "0.1.2-rc.4",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "@types/ws": "^8.5.13",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.9"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "transport",
+    "cli",
+    "websocket"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jdutton/vibe-agent-toolkit.git",
+    "directory": "packages/transports"
+  },
+  "author": "Jeff Dutton",
+  "license": "MIT"
+}