@stll/ai-catalog 0.1.14 → 0.2.0

package/dist/index.d.ts

@@ -634,6 +634,8 @@ export declare const MODEL_ROLES: readonly ["fast", "chat", "reasoning", "pdf"];
 export type ModelRole = (typeof MODEL_ROLES)[number];
 export declare const TEMPERATURE_POLICIES: readonly ["emit", "omit"];
 export type TemperaturePolicy = (typeof TEMPERATURE_POLICIES)[number];
+export declare const STREAMING_TOOL_USE_SUPPORTS: readonly ["supported", "unsupported"];
+export type StreamingToolUseSupport = (typeof STREAMING_TOOL_USE_SUPPORTS)[number];
 export declare const AI_PROVIDERS: readonly ["google", "openrouter", "openai", "azure_foundry", "anthropic", "bedrock", "mistral", "openai_compatible", "huggingface"];
 export type AIProvider = (typeof AI_PROVIDERS)[number];
 declare const AI_PROVIDER_ADAPTER_KIND: {
@@ -1146,6 +1148,81 @@ export declare const normalizeModelCatalogId: (modelId: string) => string;
  * a runtime string.
  */
 export declare const shouldEmitTemperature: (modelId: string) => boolean;
+/**
+ * Whether a model accepts tool use on a streaming request.
+ *
+ * Every tool-carrying request stella sends is a stream, and structured
+ * output is a forced tool call, so `"unsupported"` withdraws both: the
+ * provider answers such a request with a fatal stream error rather than a
+ * degraded result. models.dev does not publish this, so the map is
+ * hand-declared here rather than in the generated `capabilities.gen.ts`,
+ * and it is total over the offered catalog: a new model forces a decision.
+ *
+ * Consumers must go through `supportsStreamingToolUse`.
+ */
+export declare const MODEL_STREAMING_TOOL_USE: {
+  readonly "gemini-3.8-flash": "supported";
+  readonly "gemini-3.7-flash": "supported";
+  readonly "gemini-3.6-flash": "supported";
+  readonly "gemini-3.5-flash-lite": "supported";
+  readonly "gemini-3.1-pro-preview": "supported";
+  readonly "gemini-3.5-flash": "supported";
+  readonly "gemini-3.1-flash-lite": "supported";
+  readonly "openai/gpt-6-astra": "supported";
+  readonly "openai/gpt-5.6-sol": "supported";
+  readonly "openai/gpt-5.6-terra": "supported";
+  readonly "openai/gpt-5.6-luna": "supported";
+  readonly "google/gemini-3.8-flash": "supported";
+  readonly "google/gemini-3.7-flash": "supported";
+  readonly "google/gemini-3.6-flash": "supported";
+  readonly "google/gemini-3.5-flash-lite": "supported";
+  readonly "google/gemini-3.1-pro-preview": "supported";
+  readonly "google/gemini-3.5-flash": "supported";
+  readonly "google/gemini-3.1-flash-lite": "supported";
+  readonly "anthropic/claude-sonnet-5": "supported";
+  readonly "anthropic/claude-opus-5": "supported";
+  readonly "anthropic/claude-opus-4.8": "supported";
+  readonly "anthropic/claude-sonnet-4.6": "supported";
+  readonly "openai/gpt-5.5": "supported";
+  readonly "openai/gpt-5.4-mini": "supported";
+  readonly "gpt-6-astra": "supported";
+  readonly "gpt-5.6": "supported";
+  readonly "gpt-5.6-terra": "supported";
+  readonly "gpt-5.6-luna": "supported";
+  readonly "gpt-5.5": "supported";
+  readonly "gpt-5.4": "supported";
+  readonly "gpt-5.4-mini": "supported";
+  readonly "gpt-5.4-nano": "supported";
+  readonly "gpt-5.2": "supported";
+  readonly "claude-sonnet-5": "supported";
+  readonly "claude-fable-5-1": "supported";
+  readonly "claude-fable-5": "supported";
+  readonly "claude-opus-5": "supported";
+  readonly "claude-opus-4-8": "supported";
+  readonly "claude-opus-4-7": "supported";
+  readonly "claude-sonnet-4-6": "supported";
+  readonly "claude-opus-4-6": "supported";
+  readonly "claude-haiku-4-5-20251001": "supported";
+  readonly "us.anthropic.claude-sonnet-4-5-20250929-v1:0": "supported";
+  readonly "us.anthropic.claude-haiku-4-5-20251001-v1:0": "supported";
+  readonly "us.amazon.nova-pro-v1:0": "supported";
+  readonly "us.amazon.nova-lite-v1:0": "supported";
+  readonly "us.amazon.nova-micro-v1:0": "supported";
+  readonly "openai.gpt-oss-120b-1:0": "supported";
+  readonly "openai.gpt-oss-20b-1:0": "supported";
+  readonly "us.deepseek.r1-v1:0": "unsupported";
+  readonly "mistral-large-latest": "supported";
+  readonly "mistral-medium-latest": "supported";
+  readonly "mistral-small-latest": "supported";
+};
+/**
+ * Whether stella may send tools (or a structured-output schema) to this
+ * model on a streaming request. Unlisted ids resolve to `true`: custom
+ * deployments and env overrides are overwhelmingly tool-capable, and
+ * withdrawing tools from an uncatalogued model would silently strip the
+ * agent loop rather than fail where it can be seen.
+ */
+export declare const supportsStreamingToolUse: (modelId: string) => boolean;
 /**
  * Declared reasoning-effort values for a model ID, or `null` when the
  * model has no effort control or is not catalogued (custom deployments,

package/dist/index.js

@@ -924,6 +924,7 @@ const MODEL_ROLES = [
 	"pdf"
 ];
 const TEMPERATURE_POLICIES = ["emit", "omit"];
+const STREAMING_TOOL_USE_SUPPORTS = ["supported", "unsupported"];
 const AI_PROVIDERS = [
 	"google",
 	"openrouter",
@@ -1493,6 +1494,82 @@ const MODEL_TEMPERATURE_POLICY_BY_ID = MODEL_TEMPERATURE_POLICIES;
 * a runtime string.
 */
 const shouldEmitTemperature = (modelId) => MODEL_TEMPERATURE_POLICY_BY_ID[normalizeModelCatalogId(modelId)] === "emit";
+/**
+* Whether a model accepts tool use on a streaming request.
+*
+* Every tool-carrying request stella sends is a stream, and structured
+* output is a forced tool call, so `"unsupported"` withdraws both: the
+* provider answers such a request with a fatal stream error rather than a
+* degraded result. models.dev does not publish this, so the map is
+* hand-declared here rather than in the generated `capabilities.gen.ts`,
+* and it is total over the offered catalog: a new model forces a decision.
+*
+* Consumers must go through `supportsStreamingToolUse`.
+*/
+const MODEL_STREAMING_TOOL_USE = {
+	"gemini-3.8-flash": "supported",
+	"gemini-3.7-flash": "supported",
+	"gemini-3.6-flash": "supported",
+	"gemini-3.5-flash-lite": "supported",
+	"gemini-3.1-pro-preview": "supported",
+	"gemini-3.5-flash": "supported",
+	"gemini-3.1-flash-lite": "supported",
+	"openai/gpt-6-astra": "supported",
+	"openai/gpt-5.6-sol": "supported",
+	"openai/gpt-5.6-terra": "supported",
+	"openai/gpt-5.6-luna": "supported",
+	"google/gemini-3.8-flash": "supported",
+	"google/gemini-3.7-flash": "supported",
+	"google/gemini-3.6-flash": "supported",
+	"google/gemini-3.5-flash-lite": "supported",
+	"google/gemini-3.1-pro-preview": "supported",
+	"google/gemini-3.5-flash": "supported",
+	"google/gemini-3.1-flash-lite": "supported",
+	"anthropic/claude-sonnet-5": "supported",
+	"anthropic/claude-opus-5": "supported",
+	"anthropic/claude-opus-4.8": "supported",
+	"anthropic/claude-sonnet-4.6": "supported",
+	"openai/gpt-5.5": "supported",
+	"openai/gpt-5.4-mini": "supported",
+	"gpt-6-astra": "supported",
+	"gpt-5.6": "supported",
+	"gpt-5.6-terra": "supported",
+	"gpt-5.6-luna": "supported",
+	"gpt-5.5": "supported",
+	"gpt-5.4": "supported",
+	"gpt-5.4-mini": "supported",
+	"gpt-5.4-nano": "supported",
+	"gpt-5.2": "supported",
+	"claude-sonnet-5": "supported",
+	"claude-fable-5-1": "supported",
+	"claude-fable-5": "supported",
+	"claude-opus-5": "supported",
+	"claude-opus-4-8": "supported",
+	"claude-opus-4-7": "supported",
+	"claude-sonnet-4-6": "supported",
+	"claude-opus-4-6": "supported",
+	"claude-haiku-4-5-20251001": "supported",
+	"us.anthropic.claude-sonnet-4-5-20250929-v1:0": "supported",
+	"us.anthropic.claude-haiku-4-5-20251001-v1:0": "supported",
+	"us.amazon.nova-pro-v1:0": "supported",
+	"us.amazon.nova-lite-v1:0": "supported",
+	"us.amazon.nova-micro-v1:0": "supported",
+	"openai.gpt-oss-120b-1:0": "supported",
+	"openai.gpt-oss-20b-1:0": "supported",
+	"us.deepseek.r1-v1:0": "unsupported",
+	"mistral-large-latest": "supported",
+	"mistral-medium-latest": "supported",
+	"mistral-small-latest": "supported"
+};
+const MODEL_STREAMING_TOOL_USE_BY_ID = MODEL_STREAMING_TOOL_USE;
+/**
+* Whether stella may send tools (or a structured-output schema) to this
+* model on a streaming request. Unlisted ids resolve to `true`: custom
+* deployments and env overrides are overwhelmingly tool-capable, and
+* withdrawing tools from an uncatalogued model would silently strip the
+* agent loop rather than fail where it can be seen.
+*/
+const supportsStreamingToolUse = (modelId) => MODEL_STREAMING_TOOL_USE_BY_ID[normalizeModelCatalogId(modelId)] !== "unsupported";
 const MODEL_REASONING_EFFORTS_BY_ID = MODEL_REASONING_EFFORTS;
 /**
 * Declared reasoning-effort values for a model ID, or `null` when the
@@ -1638,4 +1715,4 @@ const DEFAULT_CONTEXT_WINDOW_TOKENS = 128e3;
 */
 const getContextWindowTokens = (modelId) => CONTEXT_WINDOW_TOKENS_BY_ID[normalizeModelCatalogId(modelId)] ?? 128e3;
 //#endregion
-export { AI_PROVIDERS, ANTHROPIC_ADAPTIVE_THINKING_MODELS, BYOK_DEFAULT_MODELS, BYOK_DOCUMENT_INPUT_MODEL_OPTIONS, BYOK_MODEL_OPTIONS, CAPABILITY_OVERRIDES, CHAT_PDF_ATTACHMENT_MODEL_OPTIONS, CONTEXT_WINDOW_TOKENS, DEFAULT_CONTEXT_WINDOW_TOKENS, DEFAULT_MODELS, DOCUMENT_INPUT_OVERRIDES, FALLBACK_CHAT_MODEL_BY_PROVIDER, FIRST_PARTY_MODEL_PROVIDERS, MODELS_DEV_RATE_PROVIDER_BY_CATALOG_PROVIDER, MODELS_DEV_RATE_SOURCE_ALIASES, MODEL_CATALOG_ID_ALIASES, MODEL_CATALOG_PROVIDER_KIND, MODEL_DEFAULT_REASONING_EFFORTS, MODEL_DISPLAY_METADATA, MODEL_RATES, MODEL_RATE_UNITS_PER_USD, MODEL_REASONING_EFFORTS, MODEL_ROLES, MODEL_TEMPERATURE_POLICIES, REASONING_EFFORTS, RETAINED_MODELS_DEV_RATE_ENTRIES, TANSTACK_AI_PROVIDERS, TEMPERATURE_POLICIES, getContextWindowTokens, getModelDefaultReasoningEffort, getModelDisplayMetadata, getModelRate, getModelReasoningEfforts, getStandardModelRate, isBYOKModelRoleSupported, isBYOKProviderRoleSupported, isChatPdfAttachmentModelSupported, normalizeModelCatalogId, resolveModelRate, resolveReasoningEffort, resolveWorkingBYOKModelForRole, shouldEmitTemperature };
+export { AI_PROVIDERS, ANTHROPIC_ADAPTIVE_THINKING_MODELS, BYOK_DEFAULT_MODELS, BYOK_DOCUMENT_INPUT_MODEL_OPTIONS, BYOK_MODEL_OPTIONS, CAPABILITY_OVERRIDES, CHAT_PDF_ATTACHMENT_MODEL_OPTIONS, CONTEXT_WINDOW_TOKENS, DEFAULT_CONTEXT_WINDOW_TOKENS, DEFAULT_MODELS, DOCUMENT_INPUT_OVERRIDES, FALLBACK_CHAT_MODEL_BY_PROVIDER, FIRST_PARTY_MODEL_PROVIDERS, MODELS_DEV_RATE_PROVIDER_BY_CATALOG_PROVIDER, MODELS_DEV_RATE_SOURCE_ALIASES, MODEL_CATALOG_ID_ALIASES, MODEL_CATALOG_PROVIDER_KIND, MODEL_DEFAULT_REASONING_EFFORTS, MODEL_DISPLAY_METADATA, MODEL_RATES, MODEL_RATE_UNITS_PER_USD, MODEL_REASONING_EFFORTS, MODEL_ROLES, MODEL_STREAMING_TOOL_USE, MODEL_TEMPERATURE_POLICIES, REASONING_EFFORTS, RETAINED_MODELS_DEV_RATE_ENTRIES, STREAMING_TOOL_USE_SUPPORTS, TANSTACK_AI_PROVIDERS, TEMPERATURE_POLICIES, getContextWindowTokens, getModelDefaultReasoningEffort, getModelDisplayMetadata, getModelRate, getModelReasoningEfforts, getStandardModelRate, isBYOKModelRoleSupported, isBYOKProviderRoleSupported, isChatPdfAttachmentModelSupported, normalizeModelCatalogId, resolveModelRate, resolveReasoningEffort, resolveWorkingBYOKModelForRole, shouldEmitTemperature, supportsStreamingToolUse };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/ai-catalog",
-  "version": "0.1.14",
+  "version": "0.2.0",
   "description": "Provider-neutral AI model roles, capabilities, and curated model metadata.",
   "keywords": [
     "ai",