adaptive-bitmask 1.0.0-rc.1

package/dist/ai/index.d.ts

@@ -0,0 +1,123 @@
+import { S as SchemaManager, C as Coordinator, A as Arbiter, b as CoordinatorConfig, c as ArbiterConfig, D as Decision, d as ArbiterResult } from '../coordinator-Df48t6yJ.js';
+import * as ai from 'ai';
+import { LanguageModelV1Middleware } from 'ai';
+import { z } from 'zod';
+
+/**
+ * CoordinationSession — Lifecycle manager for bitmask-based agent coordination.
+ *
+ * Wraps SchemaManager + Coordinator + Arbiter into a single object
+ * that AI SDK tools and middleware can reference.
+ */
+
+interface CoordinationSessionConfig {
+    /** Initial feature vocabulary to register. */
+    features: string[];
+    /** Prefix for emergency features. Default: 'EMERGENCY_' */
+    emergencyPrefix?: string;
+    /** Explicit emergency features (alternative to prefix). */
+    emergencyFeatures?: string[];
+    /** Coordinator configuration overrides. */
+    coordinatorConfig?: Partial<CoordinatorConfig>;
+    /** Arbiter configuration overrides. */
+    arbiterConfig?: Partial<ArbiterConfig>;
+}
+interface ReportResult {
+    accepted: boolean;
+    mapped: number;
+    unmapped: number;
+}
+interface DecisionResult {
+    decision: Decision;
+    aggregatedFeatures: string[];
+    confidence: Map<number, number>;
+    result: ArbiterResult;
+}
+declare class CoordinationSession {
+    readonly schema: SchemaManager;
+    readonly coordinator: Coordinator;
+    readonly arbiter: Arbiter;
+    private readonly _agentIds;
+    constructor(config: CoordinationSessionConfig);
+    /** Deterministic agent ID: FNV-1a hash of name → uint32. */
+    agentId(name: string): number;
+    /** Start a new coordination round. Clears the coordinator buffer. */
+    startRound(): void;
+    /** Encode features + create message + receive in one call. */
+    report(agentName: string, features: string[]): ReportResult;
+    /** Aggregate current buffer + score via arbiter. */
+    decide(): DecisionResult;
+}
+
+declare function createCoordinationTools(session: CoordinationSession): {
+    reportObservation: ai.Tool<z.ZodObject<{
+        agentName: z.ZodString;
+        features: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        agentName: string;
+        features: string[];
+    }, {
+        agentName: string;
+        features: string[];
+    }>, {
+        accepted: boolean;
+        mapped: number;
+        unmapped: number;
+    }> & {
+        execute: (args: {
+            agentName: string;
+            features: string[];
+        }, options: ai.ToolExecutionOptions) => PromiseLike<{
+            accepted: boolean;
+            mapped: number;
+            unmapped: number;
+        }>;
+    };
+    getConsensus: ai.Tool<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>, {
+        features: string[];
+        confidence: Record<string, number>;
+        agentCount: number;
+    }> & {
+        execute: (args: {}, options: ai.ToolExecutionOptions) => PromiseLike<{
+            features: string[];
+            confidence: Record<string, number>;
+            agentCount: number;
+        }>;
+    };
+    requestDecision: ai.Tool<z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>, {
+        decision: Decision;
+        score: number;
+        features: string[];
+        hasEmergency: boolean;
+    }> & {
+        execute: (args: {}, options: ai.ToolExecutionOptions) => PromiseLike<{
+            decision: Decision;
+            score: number;
+            features: string[];
+            hasEmergency: boolean;
+        }>;
+    };
+};
+
+/**
+ * Coordination middleware for the Vercel AI SDK.
+ *
+ * Optionally injects consensus state into the system prompt and/or
+ * auto-encodes tool call names as bitmask observations.
+ */
+
+interface CoordinationMiddlewareOptions {
+    /** Inject current consensus into system prompt before each LLM call. Default: false. */
+    injectConsensus?: boolean;
+    /**
+     * Auto-encode tool call names as bitmask observations after generation. Default: false.
+     * When enabled, tool calls whose names match registered schema features are
+     * automatically reported to the coordinator. Requires agentName.
+     */
+    autoEncodeToolCalls?: boolean;
+    /** Required when autoEncodeToolCalls is true. Identifies this agent in the coordinator. */
+    agentName?: string;
+}
+declare function createCoordinationMiddleware(session: CoordinationSession, options?: CoordinationMiddlewareOptions): LanguageModelV1Middleware;
+
+export { type CoordinationMiddlewareOptions, CoordinationSession, type CoordinationSessionConfig, type DecisionResult, type ReportResult, createCoordinationMiddleware, createCoordinationTools };