@intx/inference 0.1.2 → 0.3.0

package/dist/reactor.d.ts

@@ -0,0 +1,50 @@
+import type { InboundMessage, InferenceEvent, InferenceSource, ReactorDirector, ContextStore, ToolRunner, AbortReason, BeforeToolExtension, ToolResultTransform, ContextTransform, Compactor } from "@intx/types/runtime";
+import type { Dependencies, InferenceHarnessOptions } from "./harness.js";
+import type { CorrelationValidator } from "./correlation.js";
+export type ReactorEmittedEvent = InferenceEvent | {
+    type: "message.received";
+    seq: number;
+    data: {
+        message: InboundMessage;
+    };
+};
+export type ReactorConfig = {
+    sessionId: string;
+    director: ReactorDirector;
+    source: InferenceSource;
+    /**
+     * Fail over `source` to the next entry in the priority-ordered source
+     * list, in place, returning false at the end of the list. When omitted the
+     * reactor runs the single active source with no failover.
+     */
+    failOverToNextSource?: () => boolean;
+    /** Reset `source` to the most-preferred source, in place. */
+    resetToPreferredSource?: () => void;
+    toolRunner: ToolRunner;
+    contextStore: ContextStore;
+    correlationValidator?: CorrelationValidator;
+    onEvent: (event: ReactorEmittedEvent) => void;
+    deps: Dependencies;
+    inferenceRunner?: (opts: InferenceHarnessOptions) => AsyncGenerator<InferenceEvent>;
+    beforeToolExtensions?: BeforeToolExtension[];
+    toolResultTransforms?: ToolResultTransform[];
+    contextTransforms?: ContextTransform[];
+    compactors?: Record<string, Compactor>;
+    afterCheckpoint?: () => Promise<void>;
+    onShutdown?: () => Promise<void>;
+    gateTimeout?: number;
+    shutdownTimeoutMs?: number;
+};
+export type Reactor = {
+    /** Begin processing. Emits reactor.start. Must be called exactly once. */
+    start(): void;
+    /** Inject an inbound message into the reactor. */
+    deliver(message: InboundMessage): void;
+    /** Initiate graceful shutdown with a reason. */
+    abort(reason: AbortReason): void;
+};
+/**
+ * Creates a reactor instance bound to the given configuration.
+ * Call `start()` to begin the event loop.
+ */
+export declare function createReactor(config: ReactorConfig): Reactor;