@m4trix/core 0.5.0

package/README.md

@@ -0,0 +1,72 @@
+
+[![CircleCI](https://dl.circleci.com/status-badge/img/gh/Pascal-Lohscheidt/build-ai/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/Pascal-Lohscheidt/build-ai/tree/main)
+
+# @m4trix/core
+
+A powerful TypeScript library for building AI-driven web applications. This package provides modular entry points like `@m4trix/core`, `@m4trix/core/ui`, and `@m4trix/core/stream`.
+
+## Features
+
+- 🚀 TypeScript-first approach
+- 📦 Tree-shaking support
+- 🎨 Visual components for AI applications
+- 🧪 Comprehensive test coverage
+- 📚 Full TypeScript documentation
+
+## Quick Start
+
+```typescript
+// Coming soon
+```
+
+## Contributing
+
+We welcome contributions! Please follow these guidelines:
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes following our commit conventions (see below)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+### Commit Conventions
+
+We follow [Conventional Commits](https://www.conventionalcommits.org/) for our commit messages. This helps us maintain a clean and consistent git history.
+
+Format:
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+Types:
+- `feat`: A new feature
+- `fix`: A bug fix
+- `docs`: Documentation only changes
+- `style`: Changes that do not affect the meaning of the code
+- `refactor`: A code change that neither fixes a bug nor adds a feature
+- `perf`: A code change that improves performance
+- `test`: Adding missing tests or correcting existing tests
+- `chore`: Changes to the build process or auxiliary tools
+
+Example:
+```
+feat(auth): add OAuth2 authentication
+
+- Add Google OAuth2 provider
+- Implement token refresh flow
+- Add user profile endpoint
+
+Closes #123
+```
+
+## License
+
+MIT
+
+---
+
+Created by the makers of [Stepsailor](https://stepsailor.com) (Pascal Lohscheidt) 

package/dist/api/index.cjs

@@ -0,0 +1,83 @@
+'use strict';
+
+// src/api/socket-handler/SocketIoFactory.ts
+var SocketIoFactory = class _SocketIoFactory {
+  constructor(socket, prefix, hooks) {
+    this.socket = socket;
+    this.prefix = prefix;
+    this.hooks = hooks;
+  }
+  static setupSocketHandlers({
+    enableVoiceEvents,
+    enableChatEvents,
+    enableTranscriptEvents,
+    prefix = "",
+    socket,
+    hooks
+  }) {
+    const factory = new _SocketIoFactory(socket, prefix, hooks);
+    if (enableVoiceEvents) {
+      factory.setupVoiceEvents();
+    }
+    if (enableChatEvents) {
+      factory.setupChatEvents(socket);
+    }
+    if (enableTranscriptEvents) {
+      factory.setupTranscriptEvents(socket);
+    }
+  }
+  setupVoiceEvents() {
+    const {
+      onVoiceInputFile,
+      onVoiceInputChunk,
+      onVoiceInputCommit,
+      onVoiceOutputDelta,
+      onVoiceOutputCommit,
+      onVoiceOutputFile,
+      onVoiceOutputTranscriptDelta,
+      onVoiceOutputTranscriptFull
+    } = this.hooks;
+    const prefix = this.prefixEvent;
+    if (onVoiceInputFile) {
+      this.socket.on(prefix("voice:input_file"), onVoiceInputFile);
+    }
+    if (onVoiceInputChunk) {
+      this.socket.on(prefix("voice:input_chunk"), onVoiceInputChunk);
+    }
+    if (onVoiceInputCommit) {
+      this.socket.on(prefix("voice:input_commit"), onVoiceInputCommit);
+    }
+    if (onVoiceOutputDelta) {
+      this.socket.on(prefix("voice:output_delta"), onVoiceOutputDelta);
+    }
+    if (onVoiceOutputCommit) {
+      this.socket.on(prefix("voice:output_commit"), onVoiceOutputCommit);
+    }
+    if (onVoiceOutputFile) {
+      this.socket.on(prefix("voice:output_file"), onVoiceOutputFile);
+    }
+    if (onVoiceOutputTranscriptDelta) {
+      this.socket.on(
+        prefix("voice:output_transcript_delta"),
+        onVoiceOutputTranscriptDelta
+      );
+    }
+    if (onVoiceOutputTranscriptFull) {
+      this.socket.on(
+        prefix("voice:output_transcript_full"),
+        onVoiceOutputTranscriptFull
+      );
+    }
+  }
+  setupChatEvents(_socket) {
+  }
+  setupTranscriptEvents(_socket) {
+  }
+  prefixEvent(event) {
+    return this.prefix ? `${this.prefix}:${event}` : event;
+  }
+};
+
+exports.SocketIoFactory = SocketIoFactory;
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.cjs.map

package/dist/api/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/socket-handler/SocketIoFactory.ts"],"names":[],"mappings":";AAGO,IAAM,kBAAN,MAAM,iBAAgB;AAAA,EAKnB,YAAY,QAAgB,QAAgB,OAAsB;AACxE,SAAK,SAAS;AACd,SAAK,SAAS;AACd,SAAK,QAAQ;AAAA,EACf;AAAA,EAEA,OAAO,oBAAoB;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT;AAAA,IACA;AAAA,EACF,GAKS;AAGP,UAAM,UAAU,IAAI,iBAAgB,QAAQ,QAAQ,KAAM;AAC1D,QAAI,mBAAmB;AACrB,cAAQ,iBAAiB;AAAA,IAC3B;AAEA,QAAI,kBAAkB;AACpB,cAAQ,gBAAgB,MAAM;AAAA,IAChC;AAEA,QAAI,wBAAwB;AAC1B,cAAQ,sBAAsB,MAAM;AAAA,IACtC;AAAA,EACF;AAAA,EAEQ,mBAAyB;AAC/B,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,IAAI,KAAK;AAET,UAAM,SAAS,KAAK;AAEpB,QAAI,kBAAkB;AACpB,WAAK,OAAO,GAAG,OAAO,kBAAkB,GAAG,gBAAgB;AAAA,IAC7D;AAEA,QAAI,mBAAmB;AACrB,WAAK,OAAO,GAAG,OAAO,mBAAmB,GAAG,iBAAiB;AAAA,IAC/D;AAEA,QAAI,oBAAoB;AACtB,WAAK,OAAO,GAAG,OAAO,oBAAoB,GAAG,kBAAkB;AAAA,IACjE;AAEA,QAAI,oBAAoB;AACtB,WAAK,OAAO,GAAG,OAAO,oBAAoB,GAAG,kBAAkB;AAAA,IACjE;AAEA,QAAI,qBAAqB;AACvB,WAAK,OAAO,GAAG,OAAO,qBAAqB,GAAG,mBAAmB;AAAA,IACnE;AAEA,QAAI,mBAAmB;AACrB,WAAK,OAAO,GAAG,OAAO,mBAAmB,GAAG,iBAAiB;AAAA,IAC/D;AAEA,QAAI,8BAA8B;AAChC,WAAK,OAAO;AAAA,QACV,OAAO,+BAA+B;AAAA,QACtC;AAAA,MACF;AAAA,IACF;AAEA,QAAI,6BAA6B;AAC/B,WAAK,OAAO;AAAA,QACV,OAAO,8BAA8B;AAAA,QACrC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,gBAAgB,SAAuB;AAAA,EAE/C;AAAA,EAEQ,sBAAsB,SAAuB;AAAA,EAErD;AAAA,EAEQ,YAAY,OAAuB;AACzC,WAAO,KAAK,SAAS,GAAG,KAAK,MAAM,IAAI,KAAK,KAAK;AAAA,EACnD;AACF","sourcesContent":["import { Socket } from 'socket.io';\nimport { Hooks, SetupSocketHandlersParams } from './socket-factory-types';\n\nexport class SocketIoFactory {\n  private socket: Socket;\n  private prefix: string;\n  private hooks: Hooks<Socket>;\n\n  private constructor(socket: Socket, prefix: string, hooks: Hooks<Socket>) {\n    this.socket = socket;\n    this.prefix = prefix;\n    this.hooks = hooks;\n  }\n\n  static setupSocketHandlers({\n    enableVoiceEvents,\n    enableChatEvents,\n    enableTranscriptEvents,\n    prefix = '',\n    socket,\n    hooks,\n  }: SetupSocketHandlersParams<\n    Socket,\n    {\n      socket: Socket;\n    }\n  >): void {\n    // Adapter will override the hooks\n\n    const factory = new SocketIoFactory(socket, prefix, hooks!);\n    if (enableVoiceEvents) {\n      factory.setupVoiceEvents();\n    }\n\n    if (enableChatEvents) {\n      factory.setupChatEvents(socket);\n    }\n\n    if (enableTranscriptEvents) {\n      factory.setupTranscriptEvents(socket);\n    }\n  }\n\n  private setupVoiceEvents(): void {\n    const {\n      onVoiceInputFile,\n      onVoiceInputChunk,\n      onVoiceInputCommit,\n      onVoiceOutputDelta,\n      onVoiceOutputCommit,\n      onVoiceOutputFile,\n      onVoiceOutputTranscriptDelta,\n      onVoiceOutputTranscriptFull,\n    } = this.hooks;\n\n    const prefix = this.prefixEvent;\n\n    if (onVoiceInputFile) {\n      this.socket.on(prefix('voice:input_file'), onVoiceInputFile);\n    }\n\n    if (onVoiceInputChunk) {\n      this.socket.on(prefix('voice:input_chunk'), onVoiceInputChunk);\n    }\n\n    if (onVoiceInputCommit) {\n      this.socket.on(prefix('voice:input_commit'), onVoiceInputCommit);\n    }\n\n    if (onVoiceOutputDelta) {\n      this.socket.on(prefix('voice:output_delta'), onVoiceOutputDelta);\n    }\n\n    if (onVoiceOutputCommit) {\n      this.socket.on(prefix('voice:output_commit'), onVoiceOutputCommit);\n    }\n\n    if (onVoiceOutputFile) {\n      this.socket.on(prefix('voice:output_file'), onVoiceOutputFile);\n    }\n\n    if (onVoiceOutputTranscriptDelta) {\n      this.socket.on(\n        prefix('voice:output_transcript_delta'),\n        onVoiceOutputTranscriptDelta\n      );\n    }\n\n    if (onVoiceOutputTranscriptFull) {\n      this.socket.on(\n        prefix('voice:output_transcript_full'),\n        onVoiceOutputTranscriptFull\n      );\n    }\n  }\n\n  private setupChatEvents(_socket: Socket): void {\n    // TODO: Implement chat event handler\n  }\n\n  private setupTranscriptEvents(_socket: Socket): void {\n    // TODO: Implement transcript event handlers\n  }\n\n  private prefixEvent(event: string): string {\n    return this.prefix ? `${this.prefix}:${event}` : event;\n  }\n}\n"]}

package/dist/api/index.d.cts

@@ -0,0 +1,74 @@
+import { Socket } from 'socket.io';
+
+type Role = 'system' | 'user' | 'assistant' | string;
+interface BaseMessage {
+    /** Unique across the conversation */
+    id: string;
+    role: Role;
+    /** ISO string or Date; normalized when you receive it */
+    timestamp: string;
+}
+interface TextMessage extends BaseMessage {
+    kind: 'text';
+    /** two modes: plain vs. structured */
+    content: string | {
+        format: 'markdown' | 'html';
+        body: string;
+    };
+}
+interface VoiceMessage extends BaseMessage {
+    kind: 'voice';
+    /** raw bytes or reference */
+    data: ArrayBuffer | Blob;
+    format: 'mp3' | 'wav' | string;
+    durationMs: number;
+    /** optional transcript if you run speech-to-text */
+    transcript?: string;
+}
+type Message = TextMessage | VoiceMessage;
+
+type SocketEventName = 'conversation:create' | 'voice:input_file' | 'voice:input_chunk' | 'voice:input_commit' | 'voice:output_delta' | 'voice:output_commit' | 'voice:output_file' | 'voice:output_transcript_delta' | 'voice:output_transcript_full';
+
+type HookContext<T> = {
+    socket: T;
+    hooks: Hooks<T>;
+};
+type Hooks<SocketType> = {
+    onConversationCreated?: (conversationId: string, context: HookContext<SocketType>) => void;
+    onVoiceInputFile?: (file: Blob | Uint8Array, context: HookContext<SocketType>) => void;
+    onVoiceInputChunk?: (chunk: Uint8Array, context: HookContext<SocketType>) => void;
+    onVoiceInputCommit?: (context: HookContext<SocketType>) => void;
+    onVoiceOutputDelta?: (chunk: Uint8Array, context: HookContext<SocketType>) => void;
+    onVoiceOutputCommit?: (context: HookContext<SocketType>) => void;
+    onVoiceOutputFile?: (file: Blob | Uint8Array, context: HookContext<SocketType>) => void;
+    onVoiceOutputTranscriptDelta?: (transcriptChunk: string, context: HookContext<SocketType>) => void;
+    onVoiceOutputTranscriptFull?: (transcript: string, context: HookContext<SocketType>) => void;
+};
+type BaseSetupSocketHandlersParams<SocketType> = {
+    enableVoiceEvents: boolean;
+    enableChatEvents: boolean;
+    enableTranscriptEvents: boolean;
+    prefix?: string;
+    hooks?: Hooks<SocketType>;
+};
+/**
+ * Extra keys supplied by the caller are kept,
+ * but if they collide with a base key the base type wins.
+ */
+type SetupSocketHandlersParams<SocketType, Extra = Record<string, never>> = Omit<Extra, keyof BaseSetupSocketHandlersParams<SocketType>> & BaseSetupSocketHandlersParams<SocketType>;
+
+declare class SocketIoFactory {
+    private socket;
+    private prefix;
+    private hooks;
+    private constructor();
+    static setupSocketHandlers({ enableVoiceEvents, enableChatEvents, enableTranscriptEvents, prefix, socket, hooks, }: SetupSocketHandlersParams<Socket, {
+        socket: Socket;
+    }>): void;
+    private setupVoiceEvents;
+    private setupChatEvents;
+    private setupTranscriptEvents;
+    private prefixEvent;
+}
+
+export { type BaseMessage, type Message, type Role, type SocketEventName, SocketIoFactory, type TextMessage, type VoiceMessage };

package/dist/api/index.d.ts

@@ -0,0 +1,74 @@
+import { Socket } from 'socket.io';
+
+type Role = 'system' | 'user' | 'assistant' | string;
+interface BaseMessage {
+    /** Unique across the conversation */
+    id: string;
+    role: Role;
+    /** ISO string or Date; normalized when you receive it */
+    timestamp: string;
+}
+interface TextMessage extends BaseMessage {
+    kind: 'text';
+    /** two modes: plain vs. structured */
+    content: string | {
+        format: 'markdown' | 'html';
+        body: string;
+    };
+}
+interface VoiceMessage extends BaseMessage {
+    kind: 'voice';
+    /** raw bytes or reference */
+    data: ArrayBuffer | Blob;
+    format: 'mp3' | 'wav' | string;
+    durationMs: number;
+    /** optional transcript if you run speech-to-text */
+    transcript?: string;
+}
+type Message = TextMessage | VoiceMessage;
+
+type SocketEventName = 'conversation:create' | 'voice:input_file' | 'voice:input_chunk' | 'voice:input_commit' | 'voice:output_delta' | 'voice:output_commit' | 'voice:output_file' | 'voice:output_transcript_delta' | 'voice:output_transcript_full';
+
+type HookContext<T> = {
+    socket: T;
+    hooks: Hooks<T>;
+};
+type Hooks<SocketType> = {
+    onConversationCreated?: (conversationId: string, context: HookContext<SocketType>) => void;
+    onVoiceInputFile?: (file: Blob | Uint8Array, context: HookContext<SocketType>) => void;
+    onVoiceInputChunk?: (chunk: Uint8Array, context: HookContext<SocketType>) => void;
+    onVoiceInputCommit?: (context: HookContext<SocketType>) => void;
+    onVoiceOutputDelta?: (chunk: Uint8Array, context: HookContext<SocketType>) => void;
+    onVoiceOutputCommit?: (context: HookContext<SocketType>) => void;
+    onVoiceOutputFile?: (file: Blob | Uint8Array, context: HookContext<SocketType>) => void;
+    onVoiceOutputTranscriptDelta?: (transcriptChunk: string, context: HookContext<SocketType>) => void;
+    onVoiceOutputTranscriptFull?: (transcript: string, context: HookContext<SocketType>) => void;
+};
+type BaseSetupSocketHandlersParams<SocketType> = {
+    enableVoiceEvents: boolean;
+    enableChatEvents: boolean;
+    enableTranscriptEvents: boolean;
+    prefix?: string;
+    hooks?: Hooks<SocketType>;
+};
+/**
+ * Extra keys supplied by the caller are kept,
+ * but if they collide with a base key the base type wins.
+ */
+type SetupSocketHandlersParams<SocketType, Extra = Record<string, never>> = Omit<Extra, keyof BaseSetupSocketHandlersParams<SocketType>> & BaseSetupSocketHandlersParams<SocketType>;
+
+declare class SocketIoFactory {
+    private socket;
+    private prefix;
+    private hooks;
+    private constructor();
+    static setupSocketHandlers({ enableVoiceEvents, enableChatEvents, enableTranscriptEvents, prefix, socket, hooks, }: SetupSocketHandlersParams<Socket, {
+        socket: Socket;
+    }>): void;
+    private setupVoiceEvents;
+    private setupChatEvents;
+    private setupTranscriptEvents;
+    private prefixEvent;
+}
+
+export { type BaseMessage, type Message, type Role, type SocketEventName, SocketIoFactory, type TextMessage, type VoiceMessage };

package/dist/api/index.js

@@ -0,0 +1,81 @@
+// src/api/socket-handler/SocketIoFactory.ts
+var SocketIoFactory = class _SocketIoFactory {
+  constructor(socket, prefix, hooks) {
+    this.socket = socket;
+    this.prefix = prefix;
+    this.hooks = hooks;
+  }
+  static setupSocketHandlers({
+    enableVoiceEvents,
+    enableChatEvents,
+    enableTranscriptEvents,
+    prefix = "",
+    socket,
+    hooks
+  }) {
+    const factory = new _SocketIoFactory(socket, prefix, hooks);
+    if (enableVoiceEvents) {
+      factory.setupVoiceEvents();
+    }
+    if (enableChatEvents) {
+      factory.setupChatEvents(socket);
+    }
+    if (enableTranscriptEvents) {
+      factory.setupTranscriptEvents(socket);
+    }
+  }
+  setupVoiceEvents() {
+    const {
+      onVoiceInputFile,
+      onVoiceInputChunk,
+      onVoiceInputCommit,
+      onVoiceOutputDelta,
+      onVoiceOutputCommit,
+      onVoiceOutputFile,
+      onVoiceOutputTranscriptDelta,
+      onVoiceOutputTranscriptFull
+    } = this.hooks;
+    const prefix = this.prefixEvent;
+    if (onVoiceInputFile) {
+      this.socket.on(prefix("voice:input_file"), onVoiceInputFile);
+    }
+    if (onVoiceInputChunk) {
+      this.socket.on(prefix("voice:input_chunk"), onVoiceInputChunk);
+    }
+    if (onVoiceInputCommit) {
+      this.socket.on(prefix("voice:input_commit"), onVoiceInputCommit);
+    }
+    if (onVoiceOutputDelta) {
+      this.socket.on(prefix("voice:output_delta"), onVoiceOutputDelta);
+    }
+    if (onVoiceOutputCommit) {
+      this.socket.on(prefix("voice:output_commit"), onVoiceOutputCommit);
+    }
+    if (onVoiceOutputFile) {
+      this.socket.on(prefix("voice:output_file"), onVoiceOutputFile);
+    }
+    if (onVoiceOutputTranscriptDelta) {
+      this.socket.on(
+        prefix("voice:output_transcript_delta"),
+        onVoiceOutputTranscriptDelta
+      );
+    }
+    if (onVoiceOutputTranscriptFull) {
+      this.socket.on(
+        prefix("voice:output_transcript_full"),
+        onVoiceOutputTranscriptFull
+      );
+    }
+  }
+  setupChatEvents(_socket) {
+  }
+  setupTranscriptEvents(_socket) {
+  }
+  prefixEvent(event) {
+    return this.prefix ? `${this.prefix}:${event}` : event;
+  }
+};
+
+export { SocketIoFactory };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/socket-handler/SocketIoFactory.ts"],"names":[],"mappings":";AAGO,IAAM,kBAAN,MAAM,iBAAgB;AAAA,EAKnB,YAAY,QAAgB,QAAgB,OAAsB;AACxE,SAAK,SAAS;AACd,SAAK,SAAS;AACd,SAAK,QAAQ;AAAA,EACf;AAAA,EAEA,OAAO,oBAAoB;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT;AAAA,IACA;AAAA,EACF,GAKS;AAGP,UAAM,UAAU,IAAI,iBAAgB,QAAQ,QAAQ,KAAM;AAC1D,QAAI,mBAAmB;AACrB,cAAQ,iBAAiB;AAAA,IAC3B;AAEA,QAAI,kBAAkB;AACpB,cAAQ,gBAAgB,MAAM;AAAA,IAChC;AAEA,QAAI,wBAAwB;AAC1B,cAAQ,sBAAsB,MAAM;AAAA,IACtC;AAAA,EACF;AAAA,EAEQ,mBAAyB;AAC/B,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,IAAI,KAAK;AAET,UAAM,SAAS,KAAK;AAEpB,QAAI,kBAAkB;AACpB,WAAK,OAAO,GAAG,OAAO,kBAAkB,GAAG,gBAAgB;AAAA,IAC7D;AAEA,QAAI,mBAAmB;AACrB,WAAK,OAAO,GAAG,OAAO,mBAAmB,GAAG,iBAAiB;AAAA,IAC/D;AAEA,QAAI,oBAAoB;AACtB,WAAK,OAAO,GAAG,OAAO,oBAAoB,GAAG,kBAAkB;AAAA,IACjE;AAEA,QAAI,oBAAoB;AACtB,WAAK,OAAO,GAAG,OAAO,oBAAoB,GAAG,kBAAkB;AAAA,IACjE;AAEA,QAAI,qBAAqB;AACvB,WAAK,OAAO,GAAG,OAAO,qBAAqB,GAAG,mBAAmB;AAAA,IACnE;AAEA,QAAI,mBAAmB;AACrB,WAAK,OAAO,GAAG,OAAO,mBAAmB,GAAG,iBAAiB;AAAA,IAC/D;AAEA,QAAI,8BAA8B;AAChC,WAAK,OAAO;AAAA,QACV,OAAO,+BAA+B;AAAA,QACtC;AAAA,MACF;AAAA,IACF;AAEA,QAAI,6BAA6B;AAC/B,WAAK,OAAO;AAAA,QACV,OAAO,8BAA8B;AAAA,QACrC;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEQ,gBAAgB,SAAuB;AAAA,EAE/C;AAAA,EAEQ,sBAAsB,SAAuB;AAAA,EAErD;AAAA,EAEQ,YAAY,OAAuB;AACzC,WAAO,KAAK,SAAS,GAAG,KAAK,MAAM,IAAI,KAAK,KAAK;AAAA,EACnD;AACF","sourcesContent":["import { Socket } from 'socket.io';\nimport { Hooks, SetupSocketHandlersParams } from './socket-factory-types';\n\nexport class SocketIoFactory {\n  private socket: Socket;\n  private prefix: string;\n  private hooks: Hooks<Socket>;\n\n  private constructor(socket: Socket, prefix: string, hooks: Hooks<Socket>) {\n    this.socket = socket;\n    this.prefix = prefix;\n    this.hooks = hooks;\n  }\n\n  static setupSocketHandlers({\n    enableVoiceEvents,\n    enableChatEvents,\n    enableTranscriptEvents,\n    prefix = '',\n    socket,\n    hooks,\n  }: SetupSocketHandlersParams<\n    Socket,\n    {\n      socket: Socket;\n    }\n  >): void {\n    // Adapter will override the hooks\n\n    const factory = new SocketIoFactory(socket, prefix, hooks!);\n    if (enableVoiceEvents) {\n      factory.setupVoiceEvents();\n    }\n\n    if (enableChatEvents) {\n      factory.setupChatEvents(socket);\n    }\n\n    if (enableTranscriptEvents) {\n      factory.setupTranscriptEvents(socket);\n    }\n  }\n\n  private setupVoiceEvents(): void {\n    const {\n      onVoiceInputFile,\n      onVoiceInputChunk,\n      onVoiceInputCommit,\n      onVoiceOutputDelta,\n      onVoiceOutputCommit,\n      onVoiceOutputFile,\n      onVoiceOutputTranscriptDelta,\n      onVoiceOutputTranscriptFull,\n    } = this.hooks;\n\n    const prefix = this.prefixEvent;\n\n    if (onVoiceInputFile) {\n      this.socket.on(prefix('voice:input_file'), onVoiceInputFile);\n    }\n\n    if (onVoiceInputChunk) {\n      this.socket.on(prefix('voice:input_chunk'), onVoiceInputChunk);\n    }\n\n    if (onVoiceInputCommit) {\n      this.socket.on(prefix('voice:input_commit'), onVoiceInputCommit);\n    }\n\n    if (onVoiceOutputDelta) {\n      this.socket.on(prefix('voice:output_delta'), onVoiceOutputDelta);\n    }\n\n    if (onVoiceOutputCommit) {\n      this.socket.on(prefix('voice:output_commit'), onVoiceOutputCommit);\n    }\n\n    if (onVoiceOutputFile) {\n      this.socket.on(prefix('voice:output_file'), onVoiceOutputFile);\n    }\n\n    if (onVoiceOutputTranscriptDelta) {\n      this.socket.on(\n        prefix('voice:output_transcript_delta'),\n        onVoiceOutputTranscriptDelta\n      );\n    }\n\n    if (onVoiceOutputTranscriptFull) {\n      this.socket.on(\n        prefix('voice:output_transcript_full'),\n        onVoiceOutputTranscriptFull\n      );\n    }\n  }\n\n  private setupChatEvents(_socket: Socket): void {\n    // TODO: Implement chat event handler\n  }\n\n  private setupTranscriptEvents(_socket: Socket): void {\n    // TODO: Implement transcript event handlers\n  }\n\n  private prefixEvent(event: string): string {\n    return this.prefix ? `${this.prefix}:${event}` : event;\n  }\n}\n"]}

package/dist/helper/index.cjs

@@ -0,0 +1,253 @@
+'use strict';
+
+var messages = require('@langchain/core/messages');
+var effect = require('effect');
+
+// src/helper/transform-messages/TransformMessages.ts
+var humanAndAI = (message) => message instanceof messages.HumanMessage || message instanceof messages.AIMessage;
+var humanOnly = (message) => message instanceof messages.HumanMessage;
+var aiOnly = (message) => message instanceof messages.AIMessage;
+var includingTags = (message, tags) => {
+  if (tags) {
+    return tags.some(
+      (tag) => Array.isArray(message.additional_kwargs?.tags) ? message.additional_kwargs?.tags.includes(tag) : false
+    );
+  }
+  return true;
+};
+var excludingTags = (message, tags) => {
+  if (tags) {
+    return !tags.some(
+      (tag) => Array.isArray(message.additional_kwargs?.tags) ? message.additional_kwargs?.tags.includes(tag) : false
+    );
+  }
+  return true;
+};
+var typeOnFilter = {
+  ["HumanAndAI" /* HumanAndAI */]: humanAndAI,
+  ["HumanOnly" /* HumanOnly */]: humanOnly,
+  ["AIOnly" /* AIOnly */]: aiOnly,
+  ["IncludingTags" /* IncludingTags */]: includingTags,
+  ["ExcludingTags" /* ExcludingTags */]: excludingTags
+};
+function concise(messages$1) {
+  return messages$1.map((message) => {
+    const prefix = message instanceof messages.AIMessage ? "AI" : "Human";
+    return `${prefix}: ${message.content}`;
+  }).join("\n");
+}
+function verbose(messages$1) {
+  return messages$1.map((message) => {
+    const prefix = message instanceof messages.AIMessage ? "AI" : "Human";
+    return `${prefix}:
+${message.content}`;
+  }).join("\n-------------------\n");
+}
+function redactAi(messages$1) {
+  return messages$1.map((message) => {
+    const prefix = message instanceof messages.AIMessage ? "AI" : "Human";
+    const content = message instanceof messages.AIMessage ? "[...]" : message.content;
+    return `${prefix}: ${content}`;
+  }).join("\n");
+}
+function redactHuman(messages$1) {
+  return messages$1.map((message) => {
+    const prefix = message instanceof messages.AIMessage ? "AI" : "Human";
+    const content = message instanceof messages.AIMessage ? "[...]" : message.content;
+    return `${prefix}: ${content}`;
+  }).join("\n");
+}
+var typeOnFormatter = {
+  ["concise" /* Concise */]: concise,
+  ["verbose" /* Verbose */]: verbose,
+  ["redact-ai" /* RedactAi */]: redactAi,
+  ["redact-human" /* RedactHuman */]: redactHuman
+};
+
+// src/helper/transform-messages/TransformMessages.ts
+var TransformMessages = class _TransformMessages {
+  constructor(effect) {
+    this.effect = effect;
+  }
+  /**
+   * Create a new TransformMessages from an array of messages.
+   */
+  static from(messages) {
+    return new _TransformMessages(effect.Effect.succeed(messages));
+  }
+  /**
+   * Filter messages based on a predicate function
+   */
+  filter(predicate, tags) {
+    let finalPredicate;
+    if (typeof predicate === "string") {
+      finalPredicate = typeOnFilter[predicate];
+    } else {
+      finalPredicate = predicate;
+    }
+    return new _TransformMessages(
+      effect.pipe(
+        this.effect,
+        effect.Effect.map(
+          (messages) => messages.filter((message) => finalPredicate(message, tags))
+        )
+      )
+    );
+  }
+  /**
+   * Take only the last n messages, but safely.
+   * Tool calls should not be separated from the last human message.
+   * Ensures all tool call conversations in the last n messages are complete.
+   */
+  safelyTakeLast(n, pruneAfterNOvershootingMessages = 0) {
+    return new _TransformMessages(
+      effect.pipe(
+        this.effect,
+        effect.Effect.map((messages$1) => {
+          const total = messages$1.length;
+          if (n <= 0 || total === 0)
+            return [];
+          const start = Math.max(0, total - n);
+          const end = total;
+          const lastSlice = messages$1.slice(start, end);
+          if (lastSlice[0] instanceof messages.ToolMessage && lastSlice[0].tool_call_id) {
+            let messagesToInclude = [];
+            const remainingMessages = messages$1.slice(0, start);
+            for (let i = remainingMessages.length - 1; i >= 0; i--) {
+              const msg = remainingMessages[i];
+              if (pruneAfterNOvershootingMessages > 0 && messagesToInclude.length - 1 >= pruneAfterNOvershootingMessages) {
+                messagesToInclude = [];
+                const filteredSlice = [];
+                let foundFirstNonToolMessage = false;
+                for (let i2 = 0; i2 < lastSlice.length; i2++) {
+                  const msg2 = lastSlice[i2];
+                  if (msg2 instanceof messages.ToolMessage) {
+                    if (foundFirstNonToolMessage) {
+                      filteredSlice.push(msg2);
+                    }
+                  } else {
+                    foundFirstNonToolMessage = true;
+                    filteredSlice.push(msg2);
+                  }
+                }
+                return filteredSlice;
+              }
+              if (msg instanceof messages.AIMessage && Array.isArray(msg.tool_calls)) {
+                messagesToInclude.push(msg);
+                break;
+              } else if (msg instanceof messages.ToolMessage) {
+                messagesToInclude.push(msg);
+              } else {
+                throw new Error(
+                  "Messages array invalid no adjacent AI message found"
+                );
+              }
+            }
+            return [...messagesToInclude.reverse(), ...lastSlice];
+          } else {
+            return lastSlice;
+          }
+        })
+      )
+    );
+  }
+  /**
+   * Take only the last n messages
+   */
+  last(n) {
+    return new _TransformMessages(
+      effect.pipe(
+        this.effect,
+        effect.Effect.map((messages) => messages.slice(-n))
+      )
+    );
+  }
+  /**
+   * Take only the first n messages
+   */
+  first(n) {
+    return new _TransformMessages(
+      effect.pipe(
+        this.effect,
+        effect.Effect.map((messages) => messages.slice(0, n))
+      )
+    );
+  }
+  /**
+   * Skip the first n messages
+   */
+  skip(n) {
+    return new _TransformMessages(
+      effect.pipe(
+        this.effect,
+        effect.Effect.map((messages) => messages.slice(n))
+      )
+    );
+  }
+  /**
+   * Reverse the order of messages
+   */
+  reverse() {
+    return new _TransformMessages(
+      effect.pipe(
+        this.effect,
+        effect.Effect.map((messages) => [...messages].reverse())
+      )
+    );
+  }
+  /**
+   * Map over messages with a transformation function
+   */
+  map(fn) {
+    return new _TransformMessages(
+      effect.pipe(
+        this.effect,
+        effect.Effect.map((messages) => messages.map(fn))
+      )
+    );
+  }
+  /**
+   * Format messages according to the specified format type
+   */
+  format(formatType) {
+    return effect.pipe(
+      this.effect,
+      effect.Effect.map((messages) => {
+        if (formatType === "json" /* JSON */) {
+          return JSON.stringify(messages, null, 2);
+        }
+        const formatter = typeOnFormatter[formatType];
+        return formatter(messages);
+      })
+    );
+  }
+  // Sink methods
+  /**
+   * Convert to array - runs the effect and returns the result
+   */
+  toArray() {
+    return this.effect;
+  }
+  /**
+   * Convert to string - runs the effect and returns JSON string
+   */
+  toString() {
+    return effect.pipe(
+      this.effect,
+      effect.Effect.map((messages) => JSON.stringify(messages, null, 2))
+    );
+  }
+  /**
+   * Get the count of messages
+   */
+  count() {
+    return effect.pipe(
+      this.effect,
+      effect.Effect.map((messages) => messages.length)
+    );
+  }
+};
+
+exports.TransformMessages = TransformMessages;
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=index.cjs.map