@indexnetwork/protocol 22.0.0-rc.499.1 → 64.0.0

package/dist/{shared → internal/shared}/agent/model.config.d.ts

@@ -9,162 +9,103 @@ export interface ModelSettings {
     temperature?: number;
     maxTokens?: number;
     reasoning?: {
-        effort?: 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
+        effort?: 'low' | 'medium' | 'high';
         exclude?: boolean;
     };
 }
 /**
  * Runtime configuration for the protocol package.
- * When passed via `ToolContext.modelConfig`, all fields (`apiKey`, `baseURL`, `chatModel`,
+ * When passed explicitly, all fields (`apiKey`, `baseURL`, `chatModel`,
  * `chatReasoningEffort`) are honored by `ChatAgent` when the chat graph runs.
- * Other protocol agents don't read from `ToolContext` but may accept an explicit `ModelConfig`
+ * Other protocol agents may accept an explicit `ModelConfig`
  * as a direct parameter to `createModel()`.
  * All fields fall back to environment variables if not provided.
  */
 export interface ModelConfig {
     /** OpenRouter API key. Falls back to OPENROUTER_API_KEY env var. */
     apiKey?: string;
-    /** OpenRouter base URL. Falls back to OPENROUTER_BASE_URL env var. */
+    /** OpenRouter base URL. Defaults to {@link OPENROUTER_BASE_URL}. */
     baseURL?: string;
     /** Override the chat agent model. Falls back to CHAT_MODEL env var. */
     chatModel?: string;
     /** Override the chat reasoning effort. Falls back to CHAT_REASONING_EFFORT env var. */
-    chatReasoningEffort?: 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
+    chatReasoningEffort?: 'low' | 'medium' | 'high';
 }
 /** Per-agent model settings before canonical assignments are applied. */
-declare function getBaseModelConfig(config?: ModelConfig): { [Agent in "intentInferrer" | "intentIndexer" | "intentVerifier" | "intentReconciler" | "intentClarifier" | "profileGenerator" | "hydeGenerator" | "hydeValidator" | "lensInferrer" | "opportunityEvaluator" | "opportunityPresenter" | "negotiator" | "negotiationScreener" | "negotiationReflector" | "homeCategorizer" | "suggestionGenerator" | "chatTitleGenerator" | "negotiationInsights" | "chatContextSummarizer" | "questioner" | "signalIntakePack" | "negotiationSummarizer" | "poolDiscriminatorMiner" | "poolDiscriminatorAssigner" | "negotiationEvidenceMiner" | "inviteGenerator" | "premiseAnalyzer" | "premiseDecomposer" | "premiseIndexer" | "userContextGenerator" | "networkRecommender" | "interruptClassifier" | "chat"]: Omit<{
+declare function getBaseModelConfig(config?: ModelConfig): { [Agent in "intentInferrer" | "intentVerifier" | "intentClarifier" | "profileGenerator" | "opportunityPresenter" | "negotiator" | "negotiationReflector" | "homeCategorizer" | "suggestionGenerator" | "chatTitleGenerator" | "negotiationInsights" | "chatContextSummarizer" | "negotiationSummarizer" | "inviteGenerator" | "userContextGenerator" | "networkRecommender" | "interruptClassifier" | "chat"]: Omit<{
     readonly intentInferrer: {
-        readonly model: "google/gemini-2.5-flash";
-    };
-    readonly intentIndexer: {
-        readonly model: "google/gemini-2.5-flash";
+        readonly model: "google/gemini-3.7-flash";
     };
     readonly intentVerifier: {
-        readonly model: "google/gemini-2.5-flash";
-    };
-    readonly intentReconciler: {
-        readonly model: "google/gemini-2.5-flash";
+        readonly model: "google/gemini-3.7-flash";
     };
     readonly intentClarifier: {
-        readonly model: "google/gemini-2.5-flash";
+        readonly model: "google/gemini-3.7-flash";
     };
     readonly profileGenerator: {
-        readonly model: "google/gemini-2.5-flash";
-    };
-    readonly hydeGenerator: {
-        readonly model: "google/gemini-2.5-flash";
-    };
-    readonly hydeValidator: {
-        readonly model: "google/gemini-2.5-flash";
-        readonly temperature: 0;
-        readonly maxTokens: 2048;
-    };
-    readonly lensInferrer: {
-        readonly model: "google/gemini-2.5-flash";
-    };
-    readonly opportunityEvaluator: {
-        readonly model: "google/gemini-2.5-flash";
+        readonly model: "google/gemini-3.7-flash";
     };
     readonly opportunityPresenter: {
-        readonly model: "google/gemini-2.5-flash";
+        readonly model: "google/gemini-3.7-flash";
     };
     readonly negotiator: {
-        readonly model: "google/gemini-2.5-flash";
-    };
-    readonly negotiationScreener: {
-        readonly model: "google/gemini-2.5-flash";
-        readonly temperature: 0.2;
-        readonly maxTokens: 1024;
+        readonly model: "google/gemini-3.7-flash";
     };
     readonly negotiationReflector: {
-        readonly model: "google/gemini-2.5-flash";
+        readonly model: "google/gemini-3.7-flash";
         readonly temperature: 0.3;
         readonly maxTokens: 2048;
     };
     readonly homeCategorizer: {
-        readonly model: "google/gemini-2.5-flash";
+        readonly model: "google/gemini-3.7-flash";
     };
     readonly suggestionGenerator: {
-        readonly model: "google/gemini-2.5-flash";
+        readonly model: "google/gemini-3.7-flash";
         readonly temperature: 0.4;
         readonly maxTokens: 512;
     };
     readonly chatTitleGenerator: {
-        readonly model: "google/gemini-2.5-flash";
+        readonly model: "google/gemini-3.7-flash";
         readonly temperature: 0.3;
         readonly maxTokens: 32;
     };
     readonly negotiationInsights: {
-        readonly model: "google/gemini-2.5-flash";
+        readonly model: "google/gemini-3.7-flash";
         readonly temperature: 0.4;
         readonly maxTokens: 512;
     };
     readonly chatContextSummarizer: {
-        readonly model: "google/gemini-2.5-flash";
+        readonly model: "google/gemini-3.7-flash";
         readonly temperature: 0.2;
         readonly maxTokens: 512;
     };
-    readonly questioner: {
-        readonly model: "google/gemini-2.5-flash";
-        readonly temperature: 0.5;
-        readonly maxTokens: 1024;
-    };
-    readonly signalIntakePack: {
-        readonly model: "google/gemini-2.5-flash";
-        readonly temperature: 0.3;
-        readonly maxTokens: 1024;
-    };
     readonly negotiationSummarizer: {
-        readonly model: "google/gemini-2.5-flash";
+        readonly model: "google/gemini-3.7-flash";
         readonly temperature: 0.2;
         readonly maxTokens: 256;
     };
-    readonly poolDiscriminatorMiner: {
-        readonly model: "google/gemini-2.5-flash";
-        readonly temperature: 0.2;
-        readonly maxTokens: 4096;
-    };
-    readonly poolDiscriminatorAssigner: {
-        readonly model: "google/gemini-2.5-flash";
-        readonly temperature: 0.1;
-        readonly maxTokens: 16384;
-    };
-    readonly negotiationEvidenceMiner: {
-        readonly model: "google/gemini-2.5-flash";
-        readonly temperature: 0.2;
-        readonly maxTokens: 4096;
-    };
     readonly inviteGenerator: {
-        readonly model: "google/gemini-2.5-flash";
+        readonly model: "google/gemini-3.7-flash";
         readonly temperature: 0.3;
         readonly maxTokens: 512;
     };
-    readonly premiseAnalyzer: {
-        readonly model: "google/gemini-2.5-flash";
-    };
-    readonly premiseDecomposer: {
-        readonly model: "google/gemini-2.5-flash";
-    };
-    readonly premiseIndexer: {
-        readonly model: "google/gemini-2.5-flash";
-    };
     readonly userContextGenerator: {
-        readonly model: "google/gemini-2.5-flash";
+        readonly model: "google/gemini-3.7-flash";
         readonly temperature: 0.3;
         readonly maxTokens: 512;
     };
     readonly networkRecommender: {
-        readonly model: "google/gemini-2.5-flash";
+        readonly model: "google/gemini-3.7-flash";
         readonly temperature: 0.2;
         readonly maxTokens: 512;
     };
     readonly interruptClassifier: {
-        readonly model: "google/gemini-2.5-flash";
+        readonly model: "google/gemini-3.7-flash";
         readonly temperature: 0;
         readonly maxTokens: 16;
     };
     readonly chat: {
-        readonly model: "google/gemini-3-pro-preview";
+        readonly model: "google/gemini-3.7-flash";
         readonly maxTokens: 8192;
         readonly reasoning: {
             readonly effort: NonNullable<ModelSettings["reasoning"]>["effort"];
@@ -201,9 +142,10 @@ export declare function createFallbackModel(agent: ModelAgent, config?: ModelCon
  * plus `.withRetry(...)` and `.withFallbacks([...])`.
  *
  * Retry covers transient provider errors *and* schema parse/validation
- * failures; the fallback model (see OPENROUTER_FALLBACK_MODEL) is bound to the
- * same schema so a provider outage degrades to a different vendor instead of
- * failing the call. Abort signals pass through: aborts are never retried and
+ * failures; the fallback model (see FALLBACK_MODEL_BY_TIER) is bound to the
+ * same schema so a provider outage or rate limit degrades to the previous
+ * generation of the same tier instead of failing the call. Abort signals
+ * pass through: aborts are never retried and
  * skip the fallback.
  *
  * @param agent - Key identifying which agent's model settings to use.

package/dist/{shared → internal/shared}/agent/model.config.js

@@ -1,42 +1,28 @@
 import { ChatOpenAI } from "@langchain/openai";
 import { resolveCanonicalAllAgentModels } from "./model.resolver.js";
+const GEMINI_3_7_FLASH_MODEL = "google/gemini-3.7-flash";
 /** Per-agent model settings before canonical assignments are applied. */
 function getBaseModelConfig(config) {
     const settings = {
-        intentInferrer: { model: "google/gemini-2.5-flash" },
-        intentIndexer: { model: "google/gemini-2.5-flash" },
-        intentVerifier: { model: "google/gemini-2.5-flash" },
-        intentReconciler: { model: "google/gemini-2.5-flash" },
-        intentClarifier: { model: "google/gemini-2.5-flash" },
-        profileGenerator: { model: "google/gemini-2.5-flash" },
-        hydeGenerator: { model: "google/gemini-2.5-flash" },
-        hydeValidator: { model: "google/gemini-2.5-flash", temperature: 0.0, maxTokens: 2048 },
-        lensInferrer: { model: "google/gemini-2.5-flash" },
-        opportunityEvaluator: { model: "google/gemini-2.5-flash" },
-        opportunityPresenter: { model: "google/gemini-2.5-flash" },
-        negotiator: { model: "google/gemini-2.5-flash" },
-        negotiationScreener: { model: "google/gemini-2.5-flash", temperature: 0.2, maxTokens: 1024 },
-        negotiationReflector: { model: "google/gemini-2.5-flash", temperature: 0.3, maxTokens: 2048 },
-        homeCategorizer: { model: "google/gemini-2.5-flash" },
-        suggestionGenerator: { model: "google/gemini-2.5-flash", temperature: 0.4, maxTokens: 512 },
-        chatTitleGenerator: { model: "google/gemini-2.5-flash", temperature: 0.3, maxTokens: 32 },
-        negotiationInsights: { model: "google/gemini-2.5-flash", temperature: 0.4, maxTokens: 512 },
-        chatContextSummarizer: { model: "google/gemini-2.5-flash", temperature: 0.2, maxTokens: 512 },
-        questioner: { model: "google/gemini-2.5-flash", temperature: 0.5, maxTokens: 1024 },
-        signalIntakePack: { model: "google/gemini-2.5-flash", temperature: 0.3, maxTokens: 1024 },
-        negotiationSummarizer: { model: "google/gemini-2.5-flash", temperature: 0.2, maxTokens: 256 },
-        poolDiscriminatorMiner: { model: "google/gemini-2.5-flash", temperature: 0.2, maxTokens: 4096 },
-        poolDiscriminatorAssigner: { model: "google/gemini-2.5-flash", temperature: 0.1, maxTokens: 16384 },
-        negotiationEvidenceMiner: { model: "google/gemini-2.5-flash", temperature: 0.2, maxTokens: 4096 },
-        inviteGenerator: { model: "google/gemini-2.5-flash", temperature: 0.3, maxTokens: 512 },
-        premiseAnalyzer: { model: "google/gemini-2.5-flash" },
-        premiseDecomposer: { model: "google/gemini-2.5-flash" },
-        premiseIndexer: { model: "google/gemini-2.5-flash" },
-        userContextGenerator: { model: "google/gemini-2.5-flash", temperature: 0.3, maxTokens: 512 },
-        networkRecommender: { model: "google/gemini-2.5-flash", temperature: 0.2, maxTokens: 512 },
-        interruptClassifier: { model: "google/gemini-2.5-flash", temperature: 0.0, maxTokens: 16 },
+        intentInferrer: { model: "google/gemini-3.7-flash" },
+        intentVerifier: { model: "google/gemini-3.7-flash" },
+        intentClarifier: { model: "google/gemini-3.7-flash" },
+        profileGenerator: { model: "google/gemini-3.7-flash" },
+        opportunityPresenter: { model: "google/gemini-3.7-flash" },
+        negotiator: { model: "google/gemini-3.7-flash" },
+        negotiationReflector: { model: "google/gemini-3.7-flash", temperature: 0.3, maxTokens: 2048 },
+        homeCategorizer: { model: "google/gemini-3.7-flash" },
+        suggestionGenerator: { model: "google/gemini-3.7-flash", temperature: 0.4, maxTokens: 512 },
+        chatTitleGenerator: { model: "google/gemini-3.7-flash", temperature: 0.3, maxTokens: 32 },
+        negotiationInsights: { model: "google/gemini-3.7-flash", temperature: 0.4, maxTokens: 512 },
+        chatContextSummarizer: { model: "google/gemini-3.7-flash", temperature: 0.2, maxTokens: 512 },
+        negotiationSummarizer: { model: "google/gemini-3.7-flash", temperature: 0.2, maxTokens: 256 },
+        inviteGenerator: { model: "google/gemini-3.7-flash", temperature: 0.3, maxTokens: 512 },
+        userContextGenerator: { model: "google/gemini-3.7-flash", temperature: 0.3, maxTokens: 512 },
+        networkRecommender: { model: "google/gemini-3.7-flash", temperature: 0.2, maxTokens: 512 },
+        interruptClassifier: { model: "google/gemini-3.7-flash", temperature: 0.0, maxTokens: 16 },
         chat: {
-            model: "google/gemini-3-pro-preview",
+            model: "google/gemini-3.7-flash",
             maxTokens: 8192,
             reasoning: {
                 effort: (config?.chatReasoningEffort ?? process.env.CHAT_REASONING_EFFORT ?? "low"),
@@ -48,7 +34,16 @@ function getBaseModelConfig(config) {
         CHAT_MODEL: config?.chatModel ?? process.env.CHAT_MODEL,
         EVAL_MODEL_OVERRIDES: process.env.EVAL_MODEL_OVERRIDES,
     }, { applyEvalOverrides: process.env.NODE_ENV !== "production" });
-    return Object.fromEntries(Object.entries(settings).map(([agent, value]) => [agent, { ...value, model: assignments[agent] }]));
+    return Object.fromEntries(Object.entries(settings).map(([agent, value]) => {
+        const model = assignments[agent];
+        return [agent, {
+                ...value,
+                model,
+                reasoning: model === GEMINI_3_7_FLASH_MODEL
+                    ? ("reasoning" in value ? value.reasoning : { effort: "low" })
+                    : undefined,
+            }];
+    }));
 }
 /** Canonical assignments preserve sampling, token, and reasoning settings. */
 function getModelConfig(config) {
@@ -72,28 +67,27 @@ export function createModel(agent, config) {
     return instantiateModel(agent, cfg, config);
 }
 /** Instantiates a ChatOpenAI from explicit settings (shared by primary + fallback creation). */
+/** OpenRouter API root. */
+const OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
 function instantiateModel(agent, cfg, config) {
     const apiKey = config?.apiKey ?? process.env.OPENROUTER_API_KEY;
     if (!apiKey?.trim()) {
-        throw new Error(`createModel(${agent}): OPENROUTER_API_KEY is required. Pass via the config argument, ToolContext.modelConfig.apiKey, or set the OPENROUTER_API_KEY environment variable.`);
+        throw new Error(`createModel(${agent}): OPENROUTER_API_KEY is required. Pass via the config argument or set the OPENROUTER_API_KEY environment variable.`);
     }
     // Hard upper bound on a single LLM call. Without this, langchain's HTTP
     // client waits until the upstream cuts the socket (~3 minutes via
     // OpenRouter), blocking the entire chat response. 60 s is generous enough
     // for slow providers but bounds the worst case.
-    const timeoutEnv = Number.parseInt(process.env.OPENROUTER_REQUEST_TIMEOUT_MS ?? "", 10);
-    const timeout = Number.isFinite(timeoutEnv) && timeoutEnv > 0 ? timeoutEnv : 60000;
+    const timeout = 60000;
     // ChatOpenAI defaults to maxRetries=2. That means a single hung upstream
     // provider gets retried up to 2 more times, each waiting `timeout` before
     // failing — so worst-case latency becomes timeout * 3. Cap retries at 1
-    // so the worst case stays bounded at ~2 * timeout. Configurable via
-    // OPENROUTER_MAX_RETRIES.
-    const retriesEnv = Number.parseInt(process.env.OPENROUTER_MAX_RETRIES ?? "", 10);
-    const maxRetries = Number.isFinite(retriesEnv) && retriesEnv >= 0 ? retriesEnv : 1;
+    // so the worst case stays bounded at ~2 * timeout.
+    const maxRetries = 1;
     return new ChatOpenAI({
         model: cfg.model,
         configuration: {
-            baseURL: config?.baseURL ?? process.env.OPENROUTER_BASE_URL ?? "https://openrouter.ai/api/v1",
+            baseURL: config?.baseURL ?? OPENROUTER_BASE_URL,
             apiKey,
         },
         temperature: cfg.temperature,
@@ -104,20 +98,19 @@ function instantiateModel(agent, cfg, config) {
     });
 }
 /**
- * Default cross-vendor fallback model. The per-agent primaries run on Google's
- * provider lane (gemini-2.5-flash); a same-key OpenRouter fallback on a
- * different vendor survives Google-side outages.
- * Override via OPENROUTER_FALLBACK_MODEL; set it to "none" (or "off") to disable.
+ * Same-tier, previous-generation fallback: a "pro" primary falls back to the
+ * previous pro model, a "flash" primary to the previous flash model — the
+ * fallback is meant to survive a provider-side outage or rate limit on the
+ * exact primary, not to trade away the tier's capability. Every current
+ * primary is a flash model, but this stays tier-aware for when a pro model
+ * is added.
  */
-const DEFAULT_FALLBACK_MODEL = "openai/gpt-4o-mini";
-function getFallbackModelName() {
-    const raw = process.env.OPENROUTER_FALLBACK_MODEL;
-    if (raw === undefined)
-        return DEFAULT_FALLBACK_MODEL;
-    const value = raw.trim();
-    if (!value || value.toLowerCase() === "none" || value.toLowerCase() === "off")
-        return undefined;
-    return value;
+const FALLBACK_MODEL_BY_TIER = {
+    pro: "google/gemini-2.5-pro",
+    flash: "google/gemini-2.5-flash",
+};
+function fallbackModelFor(primaryModel) {
+    return primaryModel.includes("pro") ? FALLBACK_MODEL_BY_TIER.pro : FALLBACK_MODEL_BY_TIER.flash;
 }
 /**
  * Creates the fallback ChatOpenAI for an agent, or undefined when fallbacks
@@ -126,24 +119,19 @@ function getFallbackModelName() {
  * primary-model specific.
  */
 export function createFallbackModel(agent, config) {
-    const fallbackName = getFallbackModelName();
-    if (!fallbackName)
-        return undefined;
     const cfg = getModelConfig(config)[agent];
-    if (cfg.model === fallbackName)
+    const fallbackModel = fallbackModelFor(cfg.model);
+    if (cfg.model === fallbackModel)
         return undefined;
-    return instantiateModel(agent, { ...cfg, model: fallbackName, reasoning: undefined }, config);
+    return instantiateModel(agent, { ...cfg, model: fallbackModel, reasoning: undefined }, config);
 }
 /**
  * Number of attempts (1 = no retry) for runnable-level retries added by
  * `createStructuredModel` / `createResilientModel`. These wrap ChatOpenAI's
  * own HTTP-level `maxRetries` and additionally cover structured-output
- * parse/validation failures. Configurable via OPENROUTER_RUNNABLE_MAX_ATTEMPTS.
+ * parse/validation failures.
  */
-function getRunnableMaxAttempts() {
-    const env = Number.parseInt(process.env.OPENROUTER_RUNNABLE_MAX_ATTEMPTS ?? "", 10);
-    return Number.isFinite(env) && env >= 1 ? env : 2;
-}
+const RUNNABLE_MAX_ATTEMPTS = 2;
 /**
  * Stops runnable-level retries when the failure was a caller abort —
  * retrying a cancelled request only delays cancellation. Thrown errors from
@@ -154,7 +142,7 @@ function abortAwareFailedAttemptHandler(error) {
         throw error;
 }
 function withResilience(primary, fallback) {
-    const attempts = getRunnableMaxAttempts();
+    const attempts = RUNNABLE_MAX_ATTEMPTS;
     let runnable = attempts > 1
         ? primary.withRetry({ stopAfterAttempt: attempts, onFailedAttempt: abortAwareFailedAttemptHandler })
         : primary;
@@ -168,9 +156,10 @@ function withResilience(primary, fallback) {
  * plus `.withRetry(...)` and `.withFallbacks([...])`.
  *
  * Retry covers transient provider errors *and* schema parse/validation
- * failures; the fallback model (see OPENROUTER_FALLBACK_MODEL) is bound to the
- * same schema so a provider outage degrades to a different vendor instead of
- * failing the call. Abort signals pass through: aborts are never retried and
+ * failures; the fallback model (see FALLBACK_MODEL_BY_TIER) is bound to the
+ * same schema so a provider outage or rate limit degrades to the previous
+ * generation of the same tier instead of failing the call. Abort signals
+ * pass through: aborts are never retried and
  * skip the fallback.
  *
  * @param agent - Key identifying which agent's model settings to use.

package/dist/internal/shared/agent/model.resolver.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Canonical model-assignment authority for every protocol agent.
+ *
+ * The resolver is pure: callers provide the complete environment projection it
+ * may read. Historical eval planning uses the returned all-agent map so an
+ * unmentioned agent cannot drift behind an implicit runtime default.
+ */
+export declare const CANONICAL_AGENT_MODEL_DEFAULTS: Readonly<{
+    readonly intentInferrer: "google/gemini-3.7-flash";
+    readonly intentVerifier: "google/gemini-3.7-flash";
+    readonly intentClarifier: "google/gemini-3.7-flash";
+    readonly profileGenerator: "google/gemini-3.7-flash";
+    readonly opportunityPresenter: "google/gemini-3.7-flash";
+    readonly negotiator: "google/gemini-3.7-flash";
+    readonly negotiationReflector: "google/gemini-3.7-flash";
+    readonly homeCategorizer: "google/gemini-3.7-flash";
+    readonly suggestionGenerator: "google/gemini-3.7-flash";
+    readonly chatTitleGenerator: "google/gemini-3.7-flash";
+    readonly negotiationInsights: "google/gemini-3.7-flash";
+    readonly chatContextSummarizer: "google/gemini-3.7-flash";
+    readonly negotiationSummarizer: "google/gemini-3.7-flash";
+    readonly inviteGenerator: "google/gemini-3.7-flash";
+    readonly userContextGenerator: "google/gemini-3.7-flash";
+    readonly networkRecommender: "google/gemini-3.7-flash";
+    readonly interruptClassifier: "google/gemini-3.7-flash";
+    readonly chat: "google/gemini-3.7-flash";
+}>;
+export type CanonicalModelAgent = keyof typeof CANONICAL_AGENT_MODEL_DEFAULTS;
+export type CanonicalAllAgentModels = Readonly<Record<CanonicalModelAgent, string>>;
+export declare const CANONICAL_MODEL_AGENTS: readonly ("intentInferrer" | "intentVerifier" | "intentClarifier" | "profileGenerator" | "opportunityPresenter" | "negotiator" | "negotiationReflector" | "homeCategorizer" | "suggestionGenerator" | "chatTitleGenerator" | "negotiationInsights" | "chatContextSummarizer" | "negotiationSummarizer" | "inviteGenerator" | "userContextGenerator" | "networkRecommender" | "interruptClassifier" | "chat")[];
+export declare function resolveCanonicalAllAgentModels(environment: Readonly<Record<string, string | undefined>>, options?: {
+    applyEvalOverrides?: boolean;
+}): CanonicalAllAgentModels;

package/dist/{shared → internal/shared}/agent/model.resolver.js

@@ -6,39 +6,24 @@
  * unmentioned agent cannot drift behind an implicit runtime default.
  */
 export const CANONICAL_AGENT_MODEL_DEFAULTS = Object.freeze({
-    intentInferrer: "google/gemini-2.5-flash",
-    intentIndexer: "google/gemini-2.5-flash",
-    intentVerifier: "google/gemini-2.5-flash",
-    intentReconciler: "google/gemini-2.5-flash",
-    intentClarifier: "google/gemini-2.5-flash",
-    profileGenerator: "google/gemini-2.5-flash",
-    hydeGenerator: "google/gemini-2.5-flash",
-    hydeValidator: "google/gemini-2.5-flash",
-    lensInferrer: "google/gemini-2.5-flash",
-    opportunityEvaluator: "google/gemini-2.5-flash",
-    opportunityPresenter: "google/gemini-2.5-flash",
-    negotiator: "google/gemini-2.5-flash",
-    negotiationScreener: "google/gemini-2.5-flash",
-    negotiationReflector: "google/gemini-2.5-flash",
-    homeCategorizer: "google/gemini-2.5-flash",
-    suggestionGenerator: "google/gemini-2.5-flash",
-    chatTitleGenerator: "google/gemini-2.5-flash",
-    negotiationInsights: "google/gemini-2.5-flash",
-    chatContextSummarizer: "google/gemini-2.5-flash",
-    questioner: "google/gemini-2.5-flash",
-    signalIntakePack: "google/gemini-2.5-flash",
-    negotiationSummarizer: "google/gemini-2.5-flash",
-    poolDiscriminatorMiner: "google/gemini-2.5-flash",
-    poolDiscriminatorAssigner: "google/gemini-2.5-flash",
-    negotiationEvidenceMiner: "google/gemini-2.5-flash",
-    inviteGenerator: "google/gemini-2.5-flash",
-    premiseAnalyzer: "google/gemini-2.5-flash",
-    premiseDecomposer: "google/gemini-2.5-flash",
-    premiseIndexer: "google/gemini-2.5-flash",
-    userContextGenerator: "google/gemini-2.5-flash",
-    networkRecommender: "google/gemini-2.5-flash",
-    interruptClassifier: "google/gemini-2.5-flash",
-    chat: "google/gemini-3-pro-preview",
+    intentInferrer: "google/gemini-3.7-flash",
+    intentVerifier: "google/gemini-3.7-flash",
+    intentClarifier: "google/gemini-3.7-flash",
+    profileGenerator: "google/gemini-3.7-flash",
+    opportunityPresenter: "google/gemini-3.7-flash",
+    negotiator: "google/gemini-3.7-flash",
+    negotiationReflector: "google/gemini-3.7-flash",
+    homeCategorizer: "google/gemini-3.7-flash",
+    suggestionGenerator: "google/gemini-3.7-flash",
+    chatTitleGenerator: "google/gemini-3.7-flash",
+    negotiationInsights: "google/gemini-3.7-flash",
+    chatContextSummarizer: "google/gemini-3.7-flash",
+    negotiationSummarizer: "google/gemini-3.7-flash",
+    inviteGenerator: "google/gemini-3.7-flash",
+    userContextGenerator: "google/gemini-3.7-flash",
+    networkRecommender: "google/gemini-3.7-flash",
+    interruptClassifier: "google/gemini-3.7-flash",
+    chat: "google/gemini-3.7-flash",
 });
 export const CANONICAL_MODEL_AGENTS = Object.freeze(Object.keys(CANONICAL_AGENT_MODEL_DEFAULTS));
 function parseOverrides(raw) {

package/dist/internal/shared/agent/scope.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Request scope primitives.
+ *
+ * `scopeType`/`scopeId` describe the caller's focused scope, not the full set of
+ * networks they may read or write. The helpers here derive concrete network id
+ * sets from the focused scope and the caller's memberships.
+ */
+import type { ScopeMembership, ScopeType } from '../../../protocol/core.js';
+export type { ScopeMembership, ScopeType } from '../../../protocol/core.js';
+export interface ScopeEnvelope {
+    scopeType?: ScopeType;
+    scopeId?: string;
+}
+export interface DeriveNetworkScopeInput extends ScopeEnvelope {
+    memberships: ScopeMembership[];
+}
+/** Every network the caller may read within their focused scope. */
+export declare function deriveAllowedNetworkIds(input: DeriveNetworkScopeInput): string[];
+/** The networks discovery may draw counterparties from. Empty when the focused network is not one of the caller's. */
+export declare function deriveDiscoveryNetworkIds(input: DeriveNetworkScopeInput): string[];

package/dist/internal/shared/agent/scope.js

@@ -0,0 +1,24 @@
+function uniqueNetworkIds(ids) {
+    return [...new Set(ids.map((id) => id.trim()).filter(Boolean))];
+}
+function hasNetworkScope(scope) {
+    return scope.scopeType === 'network' && typeof scope.scopeId === 'string' && scope.scopeId.trim().length > 0;
+}
+/** Every network the caller may read within their focused scope. */
+export function deriveAllowedNetworkIds(input) {
+    if (!hasNetworkScope(input)) {
+        return uniqueNetworkIds(input.memberships.map((membership) => membership.networkId));
+    }
+    return uniqueNetworkIds(input.memberships
+        .filter((membership) => membership.networkId === input.scopeId)
+        .map((membership) => membership.networkId));
+}
+/** The networks discovery may draw counterparties from. Empty when the focused network is not one of the caller's. */
+export function deriveDiscoveryNetworkIds(input) {
+    if (!hasNetworkScope(input)) {
+        return uniqueNetworkIds(input.memberships.map((membership) => membership.networkId));
+    }
+    return input.memberships.some((membership) => membership.networkId === input.scopeId)
+        ? [input.scopeId]
+        : [];
+}

package/dist/internal/shared/assignment/network-assignment.policy.d.ts

@@ -0,0 +1,23 @@
+import type { NetworkAssignmentMetadata, NetworkAssignmentResourceType } from "../../../protocol/schemas/network-assignment.schema.js";
+export interface ManualAssignmentArgs {
+    resourceType: NetworkAssignmentResourceType;
+    /** Provenance tag recorded on the row, e.g. `intent-create`. */
+    source: string;
+    createdAt?: string;
+    reason?: string;
+}
+export interface NetworkAssignmentDecision {
+    finalScore: number;
+    metadata: NetworkAssignmentMetadata;
+}
+/**
+ * Builds the row-level metadata for a network assignment.
+ *
+ * Every assignment is a deliberate act by the resource's owner — nothing is
+ * scored or thresholded — so the score is always 1 and the recorded mode is
+ * always `manual_override`.
+ *
+ * @param args - Resource type and provenance for the assignment.
+ * @returns The score and explainability metadata to persist.
+ */
+export declare function buildManualAssignmentMetadata(args: ManualAssignmentArgs): NetworkAssignmentDecision;

package/dist/internal/shared/assignment/network-assignment.policy.js

@@ -0,0 +1,28 @@
+/**
+ * Builds the row-level metadata for a network assignment.
+ *
+ * Every assignment is a deliberate act by the resource's owner — nothing is
+ * scored or thresholded — so the score is always 1 and the recorded mode is
+ * always `manual_override`.
+ *
+ * @param args - Resource type and provenance for the assignment.
+ * @returns The score and explainability metadata to persist.
+ */
+export function buildManualAssignmentMetadata(args) {
+    return {
+        finalScore: 1,
+        metadata: {
+            resourceType: args.resourceType,
+            mode: "manual_override",
+            scope: "network",
+            policy: "unified-threshold-v1",
+            threshold: 0,
+            promptPresence: "none",
+            finalScore: 1,
+            assigned: true,
+            reason: args.reason ?? "Assigned explicitly by the owner.",
+            ...(args.source ? { source: args.source } : {}),
+            ...(args.createdAt ? { createdAt: args.createdAt } : {}),
+        },
+    };
+}

package/dist/{shared → internal/shared}/observability/log.d.ts

@@ -1,11 +1,8 @@
 /**
  * Protocol-internal logging module.
  *
- * Self-contained — no imports from outside the protocol library.
- * Ships with a minimal console-based default. The host application can
- * call `setLoggerFactory()` at startup to wire in a richer implementation
- * (e.g. the project-wide `log` utility with ANSI colors, context filtering,
- * and embedding redaction).
+ * The package emits through a host-provided logger factory. It intentionally
+ * has no console or vendor logger implementation; hosts wire their own logger.
  */
 type LogMethod = (message: string, meta?: Record<string, unknown>) => void;
 export type LoggerWithSource = {
@@ -34,7 +31,7 @@ type SanitizeFn = (value: unknown) => unknown;
  * );
  * ```
  */
-export declare function setLoggerFactory(factory: LoggerFactory, sanitize?: SanitizeFn): void;
+export declare function setLoggerFactory(factory: LoggerFactory | undefined, sanitize?: SanitizeFn): void;
 /** Sanitize an object for logging (redacts embeddings when host logger is wired in). */
 export declare function sanitizeForLog(value: unknown): unknown;
 /**