@intx/inference 0.1.2 → 0.2.2

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+export { parseSSE } from "./sse.js";
+export { encodeToolName, decodeToolName } from "./tool-name.js";
+export type { ToolNameLimit } from "./tool-name.js";
+export { runInference, createDependencies, createDefaultScheduler, HarnessId, } from "./harness.js";
+export type { Dependencies, InferenceHarnessOptions, Scheduler, } from "./harness.js";
+export type { ProviderAdapter, RequestBuilder, ResponseParser, BuiltRequest, AdapterRegistry, AdapterFactory, } from "./adapter.js";
+export { AdapterManifest, AdapterManifestEntry } from "./manifest.js";
+export { CREDENTIAL_SENTINEL, BEARER_CREDENTIAL_SENTINEL } from "./auth.js";
+export { classifyHTTPError, classifyNetworkError, classifyAbortError, classifyStreamError, classifyProtocolMismatch, ProtocolMismatchError, } from "./errors.js";
+export { transformMessages, createIDNormalizer } from "./transform.js";
+export type { TransformOptions, IDNormalizer } from "./transform.js";
+export { createDefaultRetryPolicy } from "./retry-policy.js";
+export type { RetryPolicy, RetrySituation, RetryDecision, } from "@intx/types/runtime";
+export { uploadGoogleGenAIFile } from "./providers/google-genai-files.js";
+export type { UploadGoogleGenAIFileOpts, UploadGoogleGenAIFileFetch, UploadedGoogleGenAIFile, } from "./providers/google-genai-files.js";
+export { createInboundTurn } from "./turns.js";
+export { createReactor } from "./reactor.js";
+export type { Reactor, ReactorConfig, ReactorEmittedEvent } from "./reactor.js";
+export { validateActions } from "./actions.js";
+export type { ValidationResult } from "./actions.js";
+export { createGateManager } from "./gates.js";
+export type { GateManager, GateRecord, GateSnapshot } from "./gates.js";
+export { createCorrelationRegistry } from "./correlation.js";
+export type { CorrelationRegistry, CorrelationValidator } from "./correlation.js";
+export { createStateManager } from "./state.js";
+export type { ReactorStateManager } from "./state.js";
+export { createCapabilities } from "./director.js";
+export { DefaultDirector, createDefaultDirector } from "./default-director.js";
+export type { DefaultDirectorPolicy } from "./default-director.js";
+export { createAuthzExtension } from "./authz-extension.js";
+export type { AuthzCallResult, AuthzDecision, AuthzExtensionOptions, AuthzMatchedGrant, } from "./authz-extension.js";
+export { createAuditCollector } from "./audit-collector.js";
+export type { AuditCollector } from "./audit-collector.js";
+export { createSizeCapTransform } from "./transforms/index.js";
+export type { SizeCapTransformOptions } from "./transforms/index.js";
+export { createReactorAssembly } from "./assembly.js";
+export type { ReactorAssembly, ReactorAssemblyConfig } from "./assembly.js";

package/dist/index.js

@@ -0,0 +1,21 @@
+export { parseSSE } from "./sse.js";
+export { encodeToolName, decodeToolName } from "./tool-name.js";
+export { runInference, createDependencies, createDefaultScheduler, HarnessId, } from "./harness.js";
+export { AdapterManifest, AdapterManifestEntry } from "./manifest.js";
+export { CREDENTIAL_SENTINEL, BEARER_CREDENTIAL_SENTINEL } from "./auth.js";
+export { classifyHTTPError, classifyNetworkError, classifyAbortError, classifyStreamError, classifyProtocolMismatch, ProtocolMismatchError, } from "./errors.js";
+export { transformMessages, createIDNormalizer } from "./transform.js";
+export { createDefaultRetryPolicy } from "./retry-policy.js";
+export { uploadGoogleGenAIFile } from "./providers/google-genai-files.js";
+export { createInboundTurn } from "./turns.js";
+export { createReactor } from "./reactor.js";
+export { validateActions } from "./actions.js";
+export { createGateManager } from "./gates.js";
+export { createCorrelationRegistry } from "./correlation.js";
+export { createStateManager } from "./state.js";
+export { createCapabilities } from "./director.js";
+export { DefaultDirector, createDefaultDirector } from "./default-director.js";
+export { createAuthzExtension } from "./authz-extension.js";
+export { createAuditCollector } from "./audit-collector.js";
+export { createSizeCapTransform } from "./transforms/index.js";
+export { createReactorAssembly } from "./assembly.js";

package/dist/manifest.d.ts

@@ -0,0 +1,31 @@
+import type { AdapterFactory } from "./adapter.js";
+export declare const AdapterManifestEntry: import("arktype/internal/variants/object.ts").ObjectType<{
+    provider: string;
+    specifier: string;
+    export: string;
+}, {}>;
+export type AdapterManifestEntry = typeof AdapterManifestEntry.infer;
+export declare const AdapterManifest: import("arktype/internal/variants/array.ts").ArrayType<{
+    provider: string;
+    specifier: string;
+    export: string;
+}[], {}>;
+export type AdapterManifest = typeof AdapterManifest.infer;
+export type ModuleImporter = (specifier: string) => Promise<unknown>;
+/**
+ * Imports each manifest entry's module and narrows its named export to an
+ * {@link AdapterFactory}, returning a record keyed by provider identifier.
+ * Later entries override earlier ones sharing a provider key.
+ *
+ * Fails loud (naming the specifier, and the export where relevant) when a
+ * module does not resolve to an object, the named export is missing, or the
+ * named export is not a function. The importer seam defaults to `import()` and
+ * is injectable for testing.
+ *
+ * @param manifest - Validated manifest entries to load
+ * @param opts - Optional injected module importer
+ * @returns A record of provider identifier to adapter factory
+ */
+export declare function loadAdapterFactories(manifest: AdapterManifest, opts?: {
+    import?: ModuleImporter;
+}): Promise<Record<string, AdapterFactory>>;

package/dist/manifest.js

@@ -0,0 +1,44 @@
+import { type } from "arktype";
+// Describes one custom adapter: the provider identifier it serves, the module
+// specifier to import, and the named export within that module to use as its
+// factory. Specifiers are operator-config-only and resolve to arbitrary code
+// via `import()`, so they must originate solely from trusted operator
+// configuration, never from tenant or deploy data. The shape is validated at
+// every deserialization boundary; the value is trusted operator input.
+export const AdapterManifestEntry = type({
+    provider: "string",
+    specifier: "string",
+    export: "string",
+});
+export const AdapterManifest = AdapterManifestEntry.array();
+/**
+ * Imports each manifest entry's module and narrows its named export to an
+ * {@link AdapterFactory}, returning a record keyed by provider identifier.
+ * Later entries override earlier ones sharing a provider key.
+ *
+ * Fails loud (naming the specifier, and the export where relevant) when a
+ * module does not resolve to an object, the named export is missing, or the
+ * named export is not a function. The importer seam defaults to `import()` and
+ * is injectable for testing.
+ *
+ * @param manifest - Validated manifest entries to load
+ * @param opts - Optional injected module importer
+ * @returns A record of provider identifier to adapter factory
+ */
+export async function loadAdapterFactories(manifest, opts) {
+    const importer = opts?.import ?? ((specifier) => import(specifier));
+    const factories = {};
+    for (const entry of manifest) {
+        const mod = await importer(entry.specifier);
+        if (typeof mod !== "object" || mod === null) {
+            throw new Error(`Adapter module did not resolve to an object: ${entry.specifier}`);
+        }
+        const exported = Reflect.get(mod, entry.export);
+        if (typeof exported !== "function") {
+            throw new Error(`Adapter export is not a function: ${entry.export} from ${entry.specifier}`);
+        }
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- dynamically imported factory; the call signature cannot be verified at runtime, enforced by the AdapterFactory contract
+        factories[entry.provider] = exported;
+    }
+    return factories;
+}

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,33 @@
+import type { LastCycleSource } from "@intx/types/runtime";
+import type { ProviderAdapter } from "../adapter.js";
+export type AnthropicRawEvent = {
+    kind: "text_delta";
+    token: string;
+} | {
+    kind: "thinking_delta";
+    token: string;
+} | {
+    kind: "tool_call_start";
+    index: number;
+    callId: string;
+    name: string;
+} | {
+    kind: "tool_call_delta";
+    index: number;
+    argumentFragment: string;
+} | {
+    kind: "tool_call_end";
+    index: number;
+} | {
+    kind: "usage";
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens: number;
+    cacheWriteTokens: number;
+    thinkingTokens: number;
+} | {
+    kind: "message_stop";
+} | {
+    kind: "skip";
+};
+export declare function createAnthropicAdapter(source: LastCycleSource): ProviderAdapter;