@m4trix/core 0.15.1 → 0.16.0

package/dist/matrix/index.d.ts

@@ -336,8 +336,8 @@ type SpawnerBuilder<TRegistry extends Record<string, AgentFactory> = Record<stri
     }): SpawnerBuilder<TRegistry>;
     onSpawn(fn: (ctx: SpawnCallbackContext<TRegistry>) => AnyAgent): SpawnerBuilder<TRegistry>;
 };
-type SetupContext = {
-    mainChannel: (name: string) => ConfiguredChannel;
+type AgentNetworkSetupContext = {
+    mainChannel: ConfiguredChannel;
     createChannel: (name: string) => ConfiguredChannel;
     sink: typeof Sink;
     registerAgent: (agent: AnyAgent) => AgentBinding;
@@ -369,7 +369,7 @@ declare class AgentNetwork {
     private spawnerRegistrations;
     private _store;
     private constructor();
-    static setup(callback: (ctx: SetupContext) => void): AgentNetwork;
+    static setup(callback: (ctx: AgentNetworkSetupContext) => void): AgentNetwork;
     private addChannel;
     private setMainChannel;
     private registerAgentInternal;
@@ -452,6 +452,106 @@ declare class EventAggregatorInstance<TTriggerEvent, TEmitEvent> {
     }): Promise<void>;
 }
 
+/**
+ * A Tracer that logs spans to console when they end. No optional dependencies
+ * required. Use `consoleTracerLayer` when running your program to enable.
+ *
+ * @example
+ * ```ts
+ * import { Effect } from 'effect';
+ * import { AgentNetwork, consoleTracerLayer } from '@m4trix/core/matrix';
+ *
+ * const network = AgentNetwork.setup(({ ... }) => { ... });
+ * const program = network.run().pipe(
+ *   Effect.provide(consoleTracerLayer),
+ *   Effect.scoped
+ * );
+ * Effect.runPromise(program);
+ * ```
+ */
+declare const consoleTracer: Tracer.Tracer;
+/**
+ * Layer that provides the console tracer. Pipe your program with
+ * `Effect.provide(consoleTracerLayer)` before running to see spans in stdout.
+ */
+declare const consoleTracerLayer: Layer.Layer<never>;
+
+/** Thrown when auth denies the request */
+declare class ExposeAuthError extends Error {
+    readonly status: number;
+    constructor(message: string, status?: number);
+}
+
+/** Format a single SSE message (event + data) */
+declare function formatSSE(envelope: Envelope): string;
+/** Create a ReadableStream that encodes envelopes as SSE */
+declare function toSSEStream(source: AsyncIterable<Envelope>, signal?: AbortSignal | null): ReadableStream<Uint8Array>;
+
+/** Next.js App Router GET/POST handler signature */
+type NextGetHandler = (request: Request) => Promise<Response>;
+/** Options for NextEndpoint.from() - required to define how request maps to contextId and runId */
+type NextEndpointOptions = {
+    requestToContextId: (request: Request) => string;
+    requestToRunId: (request: Request) => string;
+};
+/**
+ * Adapter for Next.js App Router. Maps an ExposedAPI to a route handler
+ * that streams events as SSE. Use for both GET and POST; POST with JSON body
+ * is recommended for passing the start event payload.
+ *
+ * @example
+ * const api = agentNetwork.expose({ protocol: "sse", auth, select });
+ * const handler = NextEndpoint.from(api, {
+ *   requestToContextId: (req) => req.headers.get('x-correlation-id') ?? crypto.randomUUID(),
+ *   requestToRunId: () => crypto.randomUUID(),
+ * }).handler();
+ * export const GET = handler;
+ * export const POST = handler;
+ */
+declare const NextEndpoint: {
+    from(api: ExposedAPI, options: NextEndpointOptions): {
+        handler(): NextGetHandler;
+    };
+};
+
+/** Minimal Express-like request (compatible with express.Request) */
+type ExpressRequest = {
+    on(event: 'close', fn: () => void): void;
+};
+/** Options for ExpressEndpoint.from() - required to define how request maps to contextId and runId */
+type ExpressEndpointOptions = {
+    requestToContextId: (req: ExpressRequest) => string;
+    requestToRunId: (req: ExpressRequest) => string;
+};
+/** Minimal Express-like response (compatible with express.Response) */
+type ExpressResponse = {
+    setHeader(name: string, value: string | number): void;
+    flushHeaders?(): void;
+    write(chunk: Uint8Array): void;
+    flush?(): void;
+    end(): void;
+    status(code: number): ExpressResponse;
+    send(body: string): void;
+};
+/** Express route handler signature */
+type ExpressHandler = (req: ExpressRequest, res: ExpressResponse) => void | Promise<void>;
+/**
+ * Adapter for Express. Maps an ExposedAPI to an Express route handler
+ * that streams events as SSE.
+ *
+ * @example
+ * const api = agentNetwork.expose({ protocol: "sse", auth, select });
+ * app.get("/events", ExpressEndpoint.from(api, {
+ *   requestToContextId: (req) => req.headers?.['x-correlation-id'] ?? crypto.randomUUID(),
+ *   requestToRunId: () => crypto.randomUUID(),
+ * }).handler());
+ */
+declare const ExpressEndpoint: {
+    from(api: ExposedAPI, options: ExpressEndpointOptions): {
+        handler(): ExpressHandler;
+    };
+};
+
 /**
  * Branded type for layer/dependency names. Enforces camelCase at runtime via refinement.
  * Used internally for parsing, validation, and uniqueness enforcement across layers.
@@ -543,104 +643,4 @@ declare class Skill<TInput = unknown, TChunk = unknown, TDone = unknown, TDeps e
     define(fn: DefineFn<TInput, TChunk, TDone, LayersFromDeps<TDeps>>): SkillInstance<TInput, TChunk, TDone, LayersFromDeps<TDeps>>;
 }
 
-/** Thrown when auth denies the request */
-declare class ExposeAuthError extends Error {
-    readonly status: number;
-    constructor(message: string, status?: number);
-}
-
-/** Format a single SSE message (event + data) */
-declare function formatSSE(envelope: Envelope): string;
-/** Create a ReadableStream that encodes envelopes as SSE */
-declare function toSSEStream(source: AsyncIterable<Envelope>, signal?: AbortSignal | null): ReadableStream<Uint8Array>;
-
-/** Next.js App Router GET/POST handler signature */
-type NextGetHandler = (request: Request) => Promise<Response>;
-/** Options for NextEndpoint.from() - required to define how request maps to contextId and runId */
-type NextEndpointOptions = {
-    requestToContextId: (request: Request) => string;
-    requestToRunId: (request: Request) => string;
-};
-/**
- * Adapter for Next.js App Router. Maps an ExposedAPI to a route handler
- * that streams events as SSE. Use for both GET and POST; POST with JSON body
- * is recommended for passing the start event payload.
- *
- * @example
- * const api = agentNetwork.expose({ protocol: "sse", auth, select });
- * const handler = NextEndpoint.from(api, {
- *   requestToContextId: (req) => req.headers.get('x-correlation-id') ?? crypto.randomUUID(),
- *   requestToRunId: () => crypto.randomUUID(),
- * }).handler();
- * export const GET = handler;
- * export const POST = handler;
- */
-declare const NextEndpoint: {
-    from(api: ExposedAPI, options: NextEndpointOptions): {
-        handler(): NextGetHandler;
-    };
-};
-
-/** Minimal Express-like request (compatible with express.Request) */
-type ExpressRequest = {
-    on(event: 'close', fn: () => void): void;
-};
-/** Options for ExpressEndpoint.from() - required to define how request maps to contextId and runId */
-type ExpressEndpointOptions = {
-    requestToContextId: (req: ExpressRequest) => string;
-    requestToRunId: (req: ExpressRequest) => string;
-};
-/** Minimal Express-like response (compatible with express.Response) */
-type ExpressResponse = {
-    setHeader(name: string, value: string | number): void;
-    flushHeaders?(): void;
-    write(chunk: Uint8Array): void;
-    flush?(): void;
-    end(): void;
-    status(code: number): ExpressResponse;
-    send(body: string): void;
-};
-/** Express route handler signature */
-type ExpressHandler = (req: ExpressRequest, res: ExpressResponse) => void | Promise<void>;
-/**
- * Adapter for Express. Maps an ExposedAPI to an Express route handler
- * that streams events as SSE.
- *
- * @example
- * const api = agentNetwork.expose({ protocol: "sse", auth, select });
- * app.get("/events", ExpressEndpoint.from(api, {
- *   requestToContextId: (req) => req.headers?.['x-correlation-id'] ?? crypto.randomUUID(),
- *   requestToRunId: () => crypto.randomUUID(),
- * }).handler());
- */
-declare const ExpressEndpoint: {
-    from(api: ExposedAPI, options: ExpressEndpointOptions): {
-        handler(): ExpressHandler;
-    };
-};
-
-/**
- * A Tracer that logs spans to console when they end. No optional dependencies
- * required. Use `consoleTracerLayer` when running your program to enable.
- *
- * @example
- * ```ts
- * import { Effect } from 'effect';
- * import { AgentNetwork, consoleTracerLayer } from '@m4trix/core/matrix';
- *
- * const network = AgentNetwork.setup(({ ... }) => { ... });
- * const program = network.run().pipe(
- *   Effect.provide(consoleTracerLayer),
- *   Effect.scoped
- * );
- * Effect.runPromise(program);
- * ```
- */
-declare const consoleTracer: Tracer.Tracer;
-/**
- * Layer that provides the console tracer. Pipe your program with
- * `Effect.provide(consoleTracerLayer)` before running to see spans in stdout.
- */
-declare const consoleTracerLayer: Layer.Layer<never>;
-
-export { Agent, AgentBinding, AgentFactory, AgentNetwork, AgentNetworkEvent, AgentNetworkEventDef, AnyAgent, AuthResult, Channel, ChannelDef, ChannelName, ConfiguredChannel, ContextEvents, DepedencyLayer, DepedencyLayerDef, Done, EmitPayload$1 as EmitPayload, EnvelopeLike, EventAggregator, EventAggregatorInstance, EventEnvelope$1 as 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 };
+export { Agent, AgentBinding, AgentFactory, AgentNetwork, AgentNetworkEvent, AgentNetworkEventDef, AgentNetworkSetupContext, AnyAgent, AuthResult, Channel, ChannelDef, ChannelName, ConfiguredChannel, ContextEvents, DepedencyLayer, DepedencyLayerDef, Done, EmitPayload$1 as EmitPayload, EnvelopeLike, EventAggregator, EventAggregatorInstance, EventEnvelope$1 as EventEnvelope, EventMeta, EventMetaSchema, EventPlane, ExposeAuthError, ExposeOptions, ExposeRequest, ExposeSelect, ExposedAPI, ExposedStream, ExpressEndpoint, ExpressEndpointOptions, ExpressHandler, ExpressRequest, ExpressResponse, LayerName, LayersFromDeps, NextEndpoint, NextEndpointOptions, NextGetHandler, OnRequestContext, RunEvents, Sink, SinkDef, Skill, SkillDefineContext, SkillInstance, SkillRuntimeOptions, SpawnCallbackContext, SpawnFn, SpawnerBuilder, StreamFactory, UnboundEvent, consoleTracer, consoleTracerLayer, formatSSE, isHttpStreamSink, toSSEStream };