@m4trix/core 0.11.0 → 0.12.0

package/dist/index.d.ts

@@ -1,8 +1,80 @@
 export { HttpStreamOptions, MessageStream, Pump, Source, StreamChunk, StreamTransformer, ensureFullWords, httpStreamResponse } from './stream/index.js';
-export { BaseMessage, Message, Role, SocketEventName, SocketIoFactory, TextMessage, VoiceMessage } from './api/index.js';
+import { Socket } from 'socket.io';
 export { FormatType, MessageFilterType, TransformMessages } from './helper/index.js';
-export { Agent, AgentBinding, AgentFactory, AgentNetwork, AgentNetworkEvent, AgentNetworkEventDef, AnyAgent, AuthResult, Channel, ChannelDef, ChannelName, ConfiguredChannel, ContextEvents, EmitPayload, EnvelopeLike, EventEnvelope, EventMeta, EventMetaSchema, EventPlane, ExposeAuthError, ExposeOptions, ExposeRequest, ExposeSelect, ExposedAPI, ExposedStream, ExpressEndpoint, ExpressEndpointOptions, ExpressHandler, ExpressRequest, ExpressResponse, LayerName, LayersFromDeps, NextEndpoint, NextEndpointOptions, NextGetHandler, OnRequestContext, RunEvents, SetupContext, Sink, SinkDef, Skill, SkillDefineContext, SkillDependency, SkillDependencyDef, SkillInstance, SkillRuntimeOptions, SpawnCallbackContext, SpawnFn, SpawnerBuilder, StreamFactory, UnboundEvent, consoleTracer, consoleTracerLayer, formatSSE, isHttpStreamSink, toSSEStream } from './matrix/index.js';
+export { Agent, AgentBinding, AgentFactory, AgentNetwork, AgentNetworkEvent, AgentNetworkEventDef, AnyAgent, AuthResult, Channel, ChannelDef, ChannelName, ConfiguredChannel, ContextEvents, DepedencyLayer, DepedencyLayerDef, EmitPayload, EnvelopeLike, EventEnvelope, EventMeta, EventMetaSchema, EventPlane, ExposeAuthError, ExposeOptions, ExposeRequest, ExposeSelect, ExposedAPI, ExposedStream, ExpressEndpoint, ExpressEndpointOptions, ExpressHandler, ExpressRequest, ExpressResponse, LayerName, LayersFromDeps, NextEndpoint, NextEndpointOptions, NextGetHandler, OnRequestContext, RunEvents, SetupContext, Sink, SinkDef, Skill, SkillDefineContext, SkillInstance, SkillRuntimeOptions, SpawnCallbackContext, SpawnFn, SpawnerBuilder, StreamFactory, UnboundEvent, consoleTracer, consoleTracerLayer, formatSSE, isHttpStreamSink, toSSEStream } from './matrix/index.js';
 export { Schema as S } from 'effect';
-import 'socket.io';
 import '@langchain/core/messages';
 import 'effect/ParseResult';
+
+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 { BaseMessage, Message, Role, SocketEventName, SocketIoFactory, TextMessage, VoiceMessage };

package/dist/index.js

@@ -1828,7 +1828,7 @@ var LayerName = Brand.refined(
   (s) => typeof s === "string" && CAMEL_CASE_REGEX.test(s),
   (s) => Brand.error(`Expected camelCase (e.g. myLayerFoo), got: ${s}`)
 );
-var SkillDependency = {
+var DepedencyLayer = {
   of(config) {
     const name = LayerName(config.name);
     const decode = Schema.decodeUnknown(config.shape);
@@ -1897,7 +1897,7 @@ var Skill = class _Skill {
       doneSchema: schema
     });
   }
-  use(...layers) {
+  dependsOn(...layers) {
     const normalized = toLayerArray(layers);
     const allLayers = [...this._layers, ...normalized];
     assertUniqueLayerNames(allLayers);
@@ -2184,6 +2184,6 @@ var consoleTracerLayer = Layer.setTracer(
   consoleTracer
 );
 
-export { Agent, AgentFactory, AgentNetwork, AgentNetworkEvent, Channel, ChannelName, ConfiguredChannel, EventMetaSchema, ExposeAuthError, ExpressEndpoint, LayerName, NextEndpoint, Pump, Sink, Skill, SkillDependency, SocketIoFactory, TransformMessages, consoleTracer, consoleTracerLayer, ensureFullWords, formatSSE, httpStreamResponse, isHttpStreamSink, toSSEStream };
+export { Agent, AgentFactory, AgentNetwork, AgentNetworkEvent, Channel, ChannelName, ConfiguredChannel, DepedencyLayer, EventMetaSchema, ExposeAuthError, ExpressEndpoint, LayerName, NextEndpoint, Pump, Sink, Skill, SocketIoFactory, TransformMessages, consoleTracer, consoleTracerLayer, ensureFullWords, formatSSE, httpStreamResponse, isHttpStreamSink, toSSEStream };
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.js.map