@omnicross/contracts 0.1.10 → 0.2.1

package/dist/index.cjs

@@ -34,8 +34,11 @@ __export(index_exports, {
   DEFAULT_VOUCHER_CONFIG: () => DEFAULT_VOUCHER_CONFIG,
   EFFORT_RATIO: () => EFFORT_RATIO,
   EXTENDED_CONTEXT_CAPABLE_MODELS: () => EXTENDED_CONTEXT_CAPABLE_MODELS,
+  IMAGE_CAPABILITY_UNAVAILABLE_REASONS: () => IMAGE_CAPABILITY_UNAVAILABLE_REASONS,
+  IMAGE_GENERATION_ERROR_CODES: () => IMAGE_GENERATION_ERROR_CODES,
   KNOWN_MODELS: () => KNOWN_MODELS,
   LEGACY_THINKING_TOKEN_LIMITS: () => LEGACY_THINKING_TOKEN_LIMITS,
+  LEGACY_UNKNOWN_PROVIDER_ID: () => LEGACY_UNKNOWN_PROVIDER_ID,
   LLM_PROVIDER_PRESETS: () => LLM_PROVIDER_PRESETS,
   MAX_CONCURRENCY_DEFAULTS: () => MAX_CONCURRENCY_DEFAULTS,
   MODEL_ALIASES: () => MODEL_ALIASES,
@@ -43,6 +46,7 @@ __export(index_exports, {
   PROVIDER_SEARCH_CONFIGS: () => PROVIDER_SEARCH_CONFIGS,
   REASONING_MODEL_PATTERNS: () => REASONING_MODEL_PATTERNS,
   SUBSCRIPTION_MODEL_CATALOG: () => SUBSCRIPTION_MODEL_CATALOG,
+  SearchProviderError: () => SearchProviderError,
   THINKING_TOKEN_MAP: () => THINKING_TOKEN_MAP,
   WEBHOOK_DESTINATION_TYPES: () => WEBHOOK_DESTINATION_TYPES,
   WEBHOOK_EVENT_KINDS: () => WEBHOOK_EVENT_KINDS,
@@ -54,6 +58,7 @@ __export(index_exports, {
   canDisableThinking: () => canDisableThinking,
   findLegacyTokenLimit: () => findLegacyTokenLimit,
   findTokenLimit: () => findTokenLimit,
+  fromLegacyWebSearchResponse: () => fromLegacyWebSearchResponse,
   getAllProviderPresets: () => getAllProviderPresets,
   getClaudeMaxTokens: () => getClaudeMaxTokens,
   getCodingPlanBaseUrl: () => getCodingPlanBaseUrl,
@@ -64,16 +69,23 @@ __export(index_exports, {
   healthHttpStatus: () => healthHttpStatus,
   isApiProvider: () => isApiProvider,
   isExtendedContextCapable: () => isExtendedContextCapable,
+  isKnownSearchProviderId: () => isKnownSearchProviderId,
   isLocalProvider: () => isLocalProvider,
   isReasoningModel: () => isReasoningModel,
+  isSearchProviderError: () => isSearchProviderError,
   legacyCliBackendToSubscriptionProvider: () => legacyCliBackendToSubscriptionProvider,
+  legacyErrorStringToSearchErrorCode: () => legacyErrorStringToSearchErrorCode,
+  legacyProviderIdToSearchProviderId: () => legacyProviderIdToSearchProviderId,
   lookupCanonicalCapabilities: () => lookupCanonicalCapabilities,
   normalizeModelId: () => normalizeModelId,
   resolveFollowProviderModel: () => resolveFollowProviderModel,
   resolveModelCapabilities: () => resolveModelCapabilities,
   resolveProviderEndpoint: () => resolveProviderEndpoint,
+  searchErrorToLegacyWebSearchResponse: () => searchErrorToLegacyWebSearchResponse,
   subscriptionProviderHasCatalog: () => subscriptionProviderHasCatalog,
-  subscriptionTargetForSession: () => subscriptionTargetForSession
+  subscriptionTargetForSession: () => subscriptionTargetForSession,
+  toLegacyWebSearchResponse: () => toLegacyWebSearchResponse,
+  toSearchErrorShape: () => toSearchErrorShape
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -372,6 +384,40 @@ function healthHttpStatus(status) {
   return status === "ok" ? 200 : 503;
 }
 
+// src/image-generation-types.ts
+var IMAGE_GENERATION_ERROR_CODES = [
+  "invalid_image_request",
+  "unsupported_model",
+  "unsupported_capability",
+  "invalid_api_key",
+  "upstream_auth_required",
+  "image_reference_not_found",
+  "image_reference_expired",
+  "image_too_large",
+  "unsupported_image_type",
+  "moderation_blocked",
+  "upstream_rate_limited",
+  "subscription_usage_limit_reached",
+  "image_queue_full",
+  "image_queue_timeout",
+  "request_cancelled",
+  "upstream_protocol_changed",
+  "image_generation_failed",
+  "image_generation_timeout"
+];
+var IMAGE_CAPABILITY_UNAVAILABLE_REASONS = [
+  "missing_evidence",
+  "stale_evidence",
+  "contradictory_evidence",
+  "adapter_unavailable",
+  "account_unverified",
+  "protocol_unverified",
+  "no_common_models",
+  "no_common_output_formats",
+  "no_common_quality_levels",
+  "no_common_moderation_modes"
+];
+
 // src/mcp-types.ts
 var DEFAULT_MCP_SESSION_CONFIG = {
   mode: "auto",
@@ -2546,6 +2592,168 @@ function getProviderSearchConfig(presetId) {
   return PROVIDER_SEARCH_CONFIGS[presetId];
 }
 
+// src/search-compat.ts
+var LEGACY_UNKNOWN_PROVIDER_ID = "legacy:unknown";
+var DEFAULT_LEGACY_ERROR_CODE = "upstream_unavailable";
+function legacyProviderIdToSearchProviderId(id) {
+  return id;
+}
+var LEGACY_ERROR_RULES = [
+  // Runtime facts first.
+  { pattern: /abort|cancell?ed|cancell?ing/i, code: "cancelled" },
+  { pattern: /timed ?out|timeout/i, code: "timeout" },
+  // WebSearchService.search()
+  { pattern: /not configured/i, code: "config_missing" },
+  { pattern: /is disabled/i, code: "policy_denied" },
+  { pattern: /not implemented/i, code: "upstream_unavailable" },
+  // HttpOnlyWebSearchService / WebSearchOrchestrator transport availability
+  { pattern: /unavailable in this host/i, code: "upstream_unavailable" },
+  { pattern: /HTTP search transport is unavailable/i, code: "upstream_unavailable" },
+  // Exhausted-candidate summaries (both fallback implementations)
+  { pattern: /No eligible web search provider returned usable results/i, code: "upstream_unavailable" },
+  { pattern: /No keyless HTTP search provider returned usable results/i, code: "upstream_unavailable" },
+  // Anti-bot / anti-decoy refusals — the page came back, it just cannot be trusted.
+  { pattern: /bot-challenge/i, code: "upstream_unavailable" },
+  {
+    pattern: /returned an untrusted search result page|refusing to return possible bot-decoy content/i,
+    code: "upstream_unavailable"
+  },
+  { pattern: /JavaScript-only search shell without result entries/i, code: "upstream_unavailable" },
+  // Response the provider did return, but which could not be turned into results.
+  { pattern: /response contained no result entries/i, code: "parse_failed" },
+  { pattern: /returned an invalid response/i, code: "parse_failed" },
+  { pattern: /returned an invalid result list/i, code: "parse_failed" },
+  { pattern: /returned only duplicate results/i, code: "parse_failed" },
+  { pattern: /returned no usable direct results/i, code: "parse_failed" },
+  { pattern: /returned no results/i, code: "parse_failed" }
+];
+function legacyErrorStringToSearchErrorCode(message) {
+  for (const rule of LEGACY_ERROR_RULES) {
+    if (rule.pattern.test(message)) return rule.code;
+  }
+  return DEFAULT_LEGACY_ERROR_CODE;
+}
+function providerIdFromLegacyErrorString(message) {
+  const match = /^Provider\s+(?!is\b|returned\b|request\b)(\S+)\s+(?:is|not)\b/i.exec(message);
+  return match?.[1];
+}
+function toSearchResult(result) {
+  return { title: result.title, url: result.url, content: result.content };
+}
+function fromLegacyWebSearchResponse(resp) {
+  if (resp.success) {
+    return {
+      ok: true,
+      response: {
+        query: resp.query,
+        providerId: resp.provider ?? LEGACY_UNKNOWN_PROVIDER_ID,
+        results: resp.results.map(toSearchResult)
+      }
+    };
+  }
+  const message = resp.error ?? "Unknown error";
+  const error = {
+    code: legacyErrorStringToSearchErrorCode(message),
+    message
+  };
+  const providerId = resp.provider ?? providerIdFromLegacyErrorString(message);
+  if (providerId !== void 0) error.providerId = providerId;
+  return { ok: false, error };
+}
+function toLegacyWebSearchResponse(response) {
+  return {
+    success: true,
+    query: response.query,
+    results: response.results.map((result) => ({
+      title: result.title,
+      content: result.content,
+      url: result.url
+    })),
+    provider: response.providerId
+  };
+}
+function searchErrorToLegacyWebSearchResponse(query, error) {
+  const response = {
+    success: false,
+    query,
+    results: [],
+    error: error.message.trim().length > 0 ? error.message : error.code
+  };
+  if (error.providerId !== void 0) {
+    response.provider = error.providerId;
+  }
+  return response;
+}
+
+// src/search-types.ts
+var KNOWN_SEARCH_PROVIDER_IDS = /* @__PURE__ */ new Set([
+  "http-bing",
+  "http-duckduckgo",
+  "tavily",
+  "jina",
+  "searxng",
+  "zhipu",
+  "z.ai"
+]);
+function isKnownSearchProviderId(id) {
+  return KNOWN_SEARCH_PROVIDER_IDS.has(id);
+}
+var SEARCH_ERROR_CODES = /* @__PURE__ */ new Set([
+  "config_missing",
+  "auth_failed",
+  "rate_limited",
+  "timeout",
+  "upstream_unavailable",
+  "parse_failed",
+  "cancelled",
+  "policy_denied"
+]);
+var DEFAULT_SEARCH_ERROR_CODE = "upstream_unavailable";
+var SearchProviderError = class _SearchProviderError extends Error {
+  /** Stable taxonomy code. */
+  code;
+  /** The provider that failed, when known. */
+  providerId;
+  /** Whether retrying the same provider could plausibly succeed. */
+  retryable;
+  /** Pre-sanitized string-valued context. */
+  details;
+  constructor(code, message, init = {}) {
+    super(message, init.cause === void 0 ? void 0 : { cause: init.cause });
+    this.name = "SearchProviderError";
+    this.code = code;
+    this.providerId = init.providerId;
+    this.retryable = init.retryable;
+    this.details = init.details;
+    Object.setPrototypeOf(this, _SearchProviderError.prototype);
+  }
+  /** This error as its serializable {@link SearchErrorShape}. */
+  toShape() {
+    return toSearchErrorShape(this);
+  }
+};
+function isSearchProviderError(value) {
+  if (value instanceof SearchProviderError) return true;
+  if (!(value instanceof Error)) return false;
+  const code = value.code;
+  return typeof code === "string" && SEARCH_ERROR_CODES.has(code);
+}
+function toSearchErrorShape(value) {
+  if (isSearchProviderError(value)) {
+    const shape = { code: value.code, message: value.message };
+    if (value.providerId !== void 0) shape.providerId = value.providerId;
+    if (value.retryable !== void 0) shape.retryable = value.retryable;
+    if (value.details !== void 0) shape.details = value.details;
+    return shape;
+  }
+  return { code: DEFAULT_SEARCH_ERROR_CODE, message: describeUnknownError(value) };
+}
+function describeUnknownError(value) {
+  if (typeof value === "string") return value;
+  if (value instanceof Error && value.message) return value.message;
+  return "Unknown error";
+}
+
 // src/subscription-model-catalog.ts
 var SUBSCRIPTION_MODEL_CATALOG = {
   claude: ["claude-haiku-4-5", "claude-sonnet-5", "claude-opus-5", "claude-fable-5"],
@@ -2812,8 +3020,11 @@ function isLocalProvider(id) {
   DEFAULT_VOUCHER_CONFIG,
   EFFORT_RATIO,
   EXTENDED_CONTEXT_CAPABLE_MODELS,
+  IMAGE_CAPABILITY_UNAVAILABLE_REASONS,
+  IMAGE_GENERATION_ERROR_CODES,
   KNOWN_MODELS,
   LEGACY_THINKING_TOKEN_LIMITS,
+  LEGACY_UNKNOWN_PROVIDER_ID,
   LLM_PROVIDER_PRESETS,
   MAX_CONCURRENCY_DEFAULTS,
   MODEL_ALIASES,
@@ -2821,6 +3032,7 @@ function isLocalProvider(id) {
   PROVIDER_SEARCH_CONFIGS,
   REASONING_MODEL_PATTERNS,
   SUBSCRIPTION_MODEL_CATALOG,
+  SearchProviderError,
   THINKING_TOKEN_MAP,
   WEBHOOK_DESTINATION_TYPES,
   WEBHOOK_EVENT_KINDS,
@@ -2832,6 +3044,7 @@ function isLocalProvider(id) {
   canDisableThinking,
   findLegacyTokenLimit,
   findTokenLimit,
+  fromLegacyWebSearchResponse,
   getAllProviderPresets,
   getClaudeMaxTokens,
   getCodingPlanBaseUrl,
@@ -2842,14 +3055,21 @@ function isLocalProvider(id) {
   healthHttpStatus,
   isApiProvider,
   isExtendedContextCapable,
+  isKnownSearchProviderId,
   isLocalProvider,
   isReasoningModel,
+  isSearchProviderError,
   legacyCliBackendToSubscriptionProvider,
+  legacyErrorStringToSearchErrorCode,
+  legacyProviderIdToSearchProviderId,
   lookupCanonicalCapabilities,
   normalizeModelId,
   resolveFollowProviderModel,
   resolveModelCapabilities,
   resolveProviderEndpoint,
+  searchErrorToLegacyWebSearchResponse,
   subscriptionProviderHasCatalog,
-  subscriptionTargetForSession
+  subscriptionTargetForSession,
+  toLegacyWebSearchResponse,
+  toSearchErrorShape
 });

package/dist/index.d.cts

@@ -9,11 +9,14 @@ export { R as ReasoningConfig, T as ThinkLevel, a as ThinkingContent } from './t
 export { ResolvedEndpoint, resolveProviderEndpoint } from './endpoint-resolver.cjs';
 export { EXTENDED_CONTEXT_CAPABLE_MODELS, isExtendedContextCapable } from './extended-context.cjs';
 export { HealthReport, HealthStatus, LogFormat, LogLevel, LoggingConfig, healthHttpStatus } from './health-logging-types.cjs';
+export { IMAGE_CAPABILITY_UNAVAILABLE_REASONS, IMAGE_GENERATION_ERROR_CODES, ImageAction, ImageArtifactId, ImageArtifactMetadata, ImageBackground, ImageCapabilities, ImageCapabilityEvidenceLayer, ImageCapabilityLayerKind, ImageCapabilityUnavailableReason, ImageCapabilityValues, ImageGenerationErrorCode, ImageGenerationPublicError, ImageInputAsset, ImageModeration, ImageModerationDetails, ImageModerationStage, ImageOutputCompressionCapability, ImageOutputFormat, ImageProviderAcceptedEvent, ImageProviderCompletedEvent, ImageProviderEvent, ImageProviderFailedEvent, ImageProviderOutput, ImageProviderPartialImageEvent, ImageQuality, ImageReferenceId, ImageReferenceMetadata, ImageRequestOptions, ImageRetrySafety, ImageSize, ImageUsage, NormalizedImageEditRequest, NormalizedImageGenerateRequest, NormalizedImageRequest, SensitiveOpaqueImageReference } from './image-generation-types.cjs';
 export { A as API_MODE_IDS, a as AgentDefaultModels, b as ApiFormat, c as ApiKeyEntry, d as ApiMode, e as ApiModeId, C as ChatApiFormat, f as CodingPlanConfig, g as CompletionSettings, G as GlobalModelParameters, L as LLMProvider, M as ModelConfig, h as ModelGroup, i as ModelParameter, j as ModelRef, O as OpenRouterDataCollection, k as OpenRouterMaxPrice, l as OpenRouterProviderRouting, m as OpenRouterProviderSort, n as OpenRouterQuantization, P as PresetProviderTemplate, o as ProviderApiType, p as ProviderModelMapping, q as ProviderSearchConfig, r as ProviderTemplate, S as SearchCapability, T as TransformerConfig, s as TransformerEntry } from './llm-config-DeWNx1ig.cjs';
 export { DEFAULT_MCP_SESSION_CONFIG, MCPCallToolResponse, MCPTool, MCPToolResponseContent, McpActionResult, McpDiscoverResult, McpMode, McpServerConfig, McpServerInput, McpServerJsonInput, McpServerList, McpServerRecord, McpServerRemoveInput, McpServerScope, McpServerTransport, McpSessionConfig, McpTestResult, McpToolInfo } from './mcp-types.cjs';
 export { MessageBlock, MessageBlockBase, MessageBlockType, TextBlock, ThinkingBlock, ToolResultBlock, ToolUseBlock } from './message-blocks.cjs';
 export { DEFAULT_LITELLM_PRICING_URL, DEFAULT_OPENROUTER_PRICING_URL, PricingConflict, PricingConflictDecision, PricingEntry, PricingEntryInput, PricingFetchResult, PricingResolution, PricingSource, PricingSourceRefreshResult } from './pricing-types.cjs';
 export { CATALOG_VERSION, CODING_PLAN_URL_PRESETS, DEFAULT_SEED_PRESET_IDS, LLM_PROVIDER_PRESETS, MAX_CONCURRENCY_DEFAULTS, PROVIDER_MODEL_MAPPINGS, PROVIDER_SEARCH_CONFIGS, getAllProviderPresets, getCodingPlanBaseUrl, getPresetById, getPresetRevision, getProviderSearchConfig, resolveFollowProviderModel } from './provider-presets/index.cjs';
+export { LEGACY_UNKNOWN_PROVIDER_ID, fromLegacyWebSearchResponse, legacyErrorStringToSearchErrorCode, legacyProviderIdToSearchProviderId, searchErrorToLegacyWebSearchResponse, toLegacyWebSearchResponse } from './search-compat.cjs';
+export { KnownSearchProviderId, OrchestratedSearchResponse, SearchAttempt, SearchAttemptEvent, SearchAttemptOutcome, SearchCompleteEvent, SearchContributionContext, SearchErrorCode, SearchErrorShape, SearchOptions, SearchPolicy, SearchProvider, SearchProviderCapabilities, SearchProviderContribution, SearchProviderDescriptor, SearchProviderDiagnostic, SearchProviderError, SearchProviderErrorInit, SearchProviderHealthStatus, SearchProviderId, SearchProviderSource, SearchRequest, SearchResponse, SearchResult, SearchRuntimeEvent, SearchRuntimeEventBase, SearchTimeRange, SearchTransportKind, SearchUrlReadResult, isKnownSearchProviderId, isSearchProviderError, toSearchErrorShape } from './search-types.cjs';
 export { SUBSCRIPTION_MODEL_CATALOG, subscriptionProviderHasCatalog } from './subscription-model-catalog.cjs';
 export { CANNOT_DISABLE_THINKING_PATTERNS, DEFAULT_MAX_TOKENS, EFFORT_RATIO, LEGACY_THINKING_TOKEN_LIMITS, REASONING_MODEL_PATTERNS, THINKING_TOKEN_MAP, buildAnthropicThinking, buildGeminiThinkingConfig, buildQwenThinkingConfig, calculateThinkingBudget, canDisableThinking, findLegacyTokenLimit, findTokenLimit, getClaudeMaxTokens, getOpenAIReasoningEffort, isReasoningModel } from './thinking-config.cjs';
 export { ApiKeyUsageRow, MessageUsageRow, ModelUsageRow, SessionCacheStats, UsageCacheKeySource, UsageDateRange, UsageEventInput, UsageEventRecord, UsageQueryParams, UsageTimeBucket, UsageTimeSeriesBucket, UsageTotals } from './usage-stats-types.cjs';

package/dist/index.d.ts

@@ -9,11 +9,14 @@ export { R as ReasoningConfig, T as ThinkLevel, a as ThinkingContent } from './t
 export { ResolvedEndpoint, resolveProviderEndpoint } from './endpoint-resolver.js';
 export { EXTENDED_CONTEXT_CAPABLE_MODELS, isExtendedContextCapable } from './extended-context.js';
 export { HealthReport, HealthStatus, LogFormat, LogLevel, LoggingConfig, healthHttpStatus } from './health-logging-types.js';
+export { IMAGE_CAPABILITY_UNAVAILABLE_REASONS, IMAGE_GENERATION_ERROR_CODES, ImageAction, ImageArtifactId, ImageArtifactMetadata, ImageBackground, ImageCapabilities, ImageCapabilityEvidenceLayer, ImageCapabilityLayerKind, ImageCapabilityUnavailableReason, ImageCapabilityValues, ImageGenerationErrorCode, ImageGenerationPublicError, ImageInputAsset, ImageModeration, ImageModerationDetails, ImageModerationStage, ImageOutputCompressionCapability, ImageOutputFormat, ImageProviderAcceptedEvent, ImageProviderCompletedEvent, ImageProviderEvent, ImageProviderFailedEvent, ImageProviderOutput, ImageProviderPartialImageEvent, ImageQuality, ImageReferenceId, ImageReferenceMetadata, ImageRequestOptions, ImageRetrySafety, ImageSize, ImageUsage, NormalizedImageEditRequest, NormalizedImageGenerateRequest, NormalizedImageRequest, SensitiveOpaqueImageReference } from './image-generation-types.js';
 export { A as API_MODE_IDS, a as AgentDefaultModels, b as ApiFormat, c as ApiKeyEntry, d as ApiMode, e as ApiModeId, C as ChatApiFormat, f as CodingPlanConfig, g as CompletionSettings, G as GlobalModelParameters, L as LLMProvider, M as ModelConfig, h as ModelGroup, i as ModelParameter, j as ModelRef, O as OpenRouterDataCollection, k as OpenRouterMaxPrice, l as OpenRouterProviderRouting, m as OpenRouterProviderSort, n as OpenRouterQuantization, P as PresetProviderTemplate, o as ProviderApiType, p as ProviderModelMapping, q as ProviderSearchConfig, r as ProviderTemplate, S as SearchCapability, T as TransformerConfig, s as TransformerEntry } from './llm-config-CKOaFFdy.js';
 export { DEFAULT_MCP_SESSION_CONFIG, MCPCallToolResponse, MCPTool, MCPToolResponseContent, McpActionResult, McpDiscoverResult, McpMode, McpServerConfig, McpServerInput, McpServerJsonInput, McpServerList, McpServerRecord, McpServerRemoveInput, McpServerScope, McpServerTransport, McpSessionConfig, McpTestResult, McpToolInfo } from './mcp-types.js';
 export { MessageBlock, MessageBlockBase, MessageBlockType, TextBlock, ThinkingBlock, ToolResultBlock, ToolUseBlock } from './message-blocks.js';
 export { DEFAULT_LITELLM_PRICING_URL, DEFAULT_OPENROUTER_PRICING_URL, PricingConflict, PricingConflictDecision, PricingEntry, PricingEntryInput, PricingFetchResult, PricingResolution, PricingSource, PricingSourceRefreshResult } from './pricing-types.js';
 export { CATALOG_VERSION, CODING_PLAN_URL_PRESETS, DEFAULT_SEED_PRESET_IDS, LLM_PROVIDER_PRESETS, MAX_CONCURRENCY_DEFAULTS, PROVIDER_MODEL_MAPPINGS, PROVIDER_SEARCH_CONFIGS, getAllProviderPresets, getCodingPlanBaseUrl, getPresetById, getPresetRevision, getProviderSearchConfig, resolveFollowProviderModel } from './provider-presets/index.js';
+export { LEGACY_UNKNOWN_PROVIDER_ID, fromLegacyWebSearchResponse, legacyErrorStringToSearchErrorCode, legacyProviderIdToSearchProviderId, searchErrorToLegacyWebSearchResponse, toLegacyWebSearchResponse } from './search-compat.js';
+export { KnownSearchProviderId, OrchestratedSearchResponse, SearchAttempt, SearchAttemptEvent, SearchAttemptOutcome, SearchCompleteEvent, SearchContributionContext, SearchErrorCode, SearchErrorShape, SearchOptions, SearchPolicy, SearchProvider, SearchProviderCapabilities, SearchProviderContribution, SearchProviderDescriptor, SearchProviderDiagnostic, SearchProviderError, SearchProviderErrorInit, SearchProviderHealthStatus, SearchProviderId, SearchProviderSource, SearchRequest, SearchResponse, SearchResult, SearchRuntimeEvent, SearchRuntimeEventBase, SearchTimeRange, SearchTransportKind, SearchUrlReadResult, isKnownSearchProviderId, isSearchProviderError, toSearchErrorShape } from './search-types.js';
 export { SUBSCRIPTION_MODEL_CATALOG, subscriptionProviderHasCatalog } from './subscription-model-catalog.js';
 export { CANNOT_DISABLE_THINKING_PATTERNS, DEFAULT_MAX_TOKENS, EFFORT_RATIO, LEGACY_THINKING_TOKEN_LIMITS, REASONING_MODEL_PATTERNS, THINKING_TOKEN_MAP, buildAnthropicThinking, buildGeminiThinkingConfig, buildQwenThinkingConfig, calculateThinkingBudget, canDisableThinking, findLegacyTokenLimit, findTokenLimit, getClaudeMaxTokens, getOpenAIReasoningEffort, isReasoningModel } from './thinking-config.js';
 export { ApiKeyUsageRow, MessageUsageRow, ModelUsageRow, SessionCacheStats, UsageCacheKeySource, UsageDateRange, UsageEventInput, UsageEventRecord, UsageQueryParams, UsageTimeBucket, UsageTimeSeriesBucket, UsageTotals } from './usage-stats-types.js';

package/dist/index.js

@@ -293,6 +293,40 @@ function healthHttpStatus(status) {
   return status === "ok" ? 200 : 503;
 }
 
+// src/image-generation-types.ts
+var IMAGE_GENERATION_ERROR_CODES = [
+  "invalid_image_request",
+  "unsupported_model",
+  "unsupported_capability",
+  "invalid_api_key",
+  "upstream_auth_required",
+  "image_reference_not_found",
+  "image_reference_expired",
+  "image_too_large",
+  "unsupported_image_type",
+  "moderation_blocked",
+  "upstream_rate_limited",
+  "subscription_usage_limit_reached",
+  "image_queue_full",
+  "image_queue_timeout",
+  "request_cancelled",
+  "upstream_protocol_changed",
+  "image_generation_failed",
+  "image_generation_timeout"
+];
+var IMAGE_CAPABILITY_UNAVAILABLE_REASONS = [
+  "missing_evidence",
+  "stale_evidence",
+  "contradictory_evidence",
+  "adapter_unavailable",
+  "account_unverified",
+  "protocol_unverified",
+  "no_common_models",
+  "no_common_output_formats",
+  "no_common_quality_levels",
+  "no_common_moderation_modes"
+];
+
 // src/mcp-types.ts
 var DEFAULT_MCP_SESSION_CONFIG = {
   mode: "auto",
@@ -2467,6 +2501,168 @@ function getProviderSearchConfig(presetId) {
   return PROVIDER_SEARCH_CONFIGS[presetId];
 }
 
+// src/search-compat.ts
+var LEGACY_UNKNOWN_PROVIDER_ID = "legacy:unknown";
+var DEFAULT_LEGACY_ERROR_CODE = "upstream_unavailable";
+function legacyProviderIdToSearchProviderId(id) {
+  return id;
+}
+var LEGACY_ERROR_RULES = [
+  // Runtime facts first.
+  { pattern: /abort|cancell?ed|cancell?ing/i, code: "cancelled" },
+  { pattern: /timed ?out|timeout/i, code: "timeout" },
+  // WebSearchService.search()
+  { pattern: /not configured/i, code: "config_missing" },
+  { pattern: /is disabled/i, code: "policy_denied" },
+  { pattern: /not implemented/i, code: "upstream_unavailable" },
+  // HttpOnlyWebSearchService / WebSearchOrchestrator transport availability
+  { pattern: /unavailable in this host/i, code: "upstream_unavailable" },
+  { pattern: /HTTP search transport is unavailable/i, code: "upstream_unavailable" },
+  // Exhausted-candidate summaries (both fallback implementations)
+  { pattern: /No eligible web search provider returned usable results/i, code: "upstream_unavailable" },
+  { pattern: /No keyless HTTP search provider returned usable results/i, code: "upstream_unavailable" },
+  // Anti-bot / anti-decoy refusals — the page came back, it just cannot be trusted.
+  { pattern: /bot-challenge/i, code: "upstream_unavailable" },
+  {
+    pattern: /returned an untrusted search result page|refusing to return possible bot-decoy content/i,
+    code: "upstream_unavailable"
+  },
+  { pattern: /JavaScript-only search shell without result entries/i, code: "upstream_unavailable" },
+  // Response the provider did return, but which could not be turned into results.
+  { pattern: /response contained no result entries/i, code: "parse_failed" },
+  { pattern: /returned an invalid response/i, code: "parse_failed" },
+  { pattern: /returned an invalid result list/i, code: "parse_failed" },
+  { pattern: /returned only duplicate results/i, code: "parse_failed" },
+  { pattern: /returned no usable direct results/i, code: "parse_failed" },
+  { pattern: /returned no results/i, code: "parse_failed" }
+];
+function legacyErrorStringToSearchErrorCode(message) {
+  for (const rule of LEGACY_ERROR_RULES) {
+    if (rule.pattern.test(message)) return rule.code;
+  }
+  return DEFAULT_LEGACY_ERROR_CODE;
+}
+function providerIdFromLegacyErrorString(message) {
+  const match = /^Provider\s+(?!is\b|returned\b|request\b)(\S+)\s+(?:is|not)\b/i.exec(message);
+  return match?.[1];
+}
+function toSearchResult(result) {
+  return { title: result.title, url: result.url, content: result.content };
+}
+function fromLegacyWebSearchResponse(resp) {
+  if (resp.success) {
+    return {
+      ok: true,
+      response: {
+        query: resp.query,
+        providerId: resp.provider ?? LEGACY_UNKNOWN_PROVIDER_ID,
+        results: resp.results.map(toSearchResult)
+      }
+    };
+  }
+  const message = resp.error ?? "Unknown error";
+  const error = {
+    code: legacyErrorStringToSearchErrorCode(message),
+    message
+  };
+  const providerId = resp.provider ?? providerIdFromLegacyErrorString(message);
+  if (providerId !== void 0) error.providerId = providerId;
+  return { ok: false, error };
+}
+function toLegacyWebSearchResponse(response) {
+  return {
+    success: true,
+    query: response.query,
+    results: response.results.map((result) => ({
+      title: result.title,
+      content: result.content,
+      url: result.url
+    })),
+    provider: response.providerId
+  };
+}
+function searchErrorToLegacyWebSearchResponse(query, error) {
+  const response = {
+    success: false,
+    query,
+    results: [],
+    error: error.message.trim().length > 0 ? error.message : error.code
+  };
+  if (error.providerId !== void 0) {
+    response.provider = error.providerId;
+  }
+  return response;
+}
+
+// src/search-types.ts
+var KNOWN_SEARCH_PROVIDER_IDS = /* @__PURE__ */ new Set([
+  "http-bing",
+  "http-duckduckgo",
+  "tavily",
+  "jina",
+  "searxng",
+  "zhipu",
+  "z.ai"
+]);
+function isKnownSearchProviderId(id) {
+  return KNOWN_SEARCH_PROVIDER_IDS.has(id);
+}
+var SEARCH_ERROR_CODES = /* @__PURE__ */ new Set([
+  "config_missing",
+  "auth_failed",
+  "rate_limited",
+  "timeout",
+  "upstream_unavailable",
+  "parse_failed",
+  "cancelled",
+  "policy_denied"
+]);
+var DEFAULT_SEARCH_ERROR_CODE = "upstream_unavailable";
+var SearchProviderError = class _SearchProviderError extends Error {
+  /** Stable taxonomy code. */
+  code;
+  /** The provider that failed, when known. */
+  providerId;
+  /** Whether retrying the same provider could plausibly succeed. */
+  retryable;
+  /** Pre-sanitized string-valued context. */
+  details;
+  constructor(code, message, init = {}) {
+    super(message, init.cause === void 0 ? void 0 : { cause: init.cause });
+    this.name = "SearchProviderError";
+    this.code = code;
+    this.providerId = init.providerId;
+    this.retryable = init.retryable;
+    this.details = init.details;
+    Object.setPrototypeOf(this, _SearchProviderError.prototype);
+  }
+  /** This error as its serializable {@link SearchErrorShape}. */
+  toShape() {
+    return toSearchErrorShape(this);
+  }
+};
+function isSearchProviderError(value) {
+  if (value instanceof SearchProviderError) return true;
+  if (!(value instanceof Error)) return false;
+  const code = value.code;
+  return typeof code === "string" && SEARCH_ERROR_CODES.has(code);
+}
+function toSearchErrorShape(value) {
+  if (isSearchProviderError(value)) {
+    const shape = { code: value.code, message: value.message };
+    if (value.providerId !== void 0) shape.providerId = value.providerId;
+    if (value.retryable !== void 0) shape.retryable = value.retryable;
+    if (value.details !== void 0) shape.details = value.details;
+    return shape;
+  }
+  return { code: DEFAULT_SEARCH_ERROR_CODE, message: describeUnknownError(value) };
+}
+function describeUnknownError(value) {
+  if (typeof value === "string") return value;
+  if (value instanceof Error && value.message) return value.message;
+  return "Unknown error";
+}
+
 // src/subscription-model-catalog.ts
 var SUBSCRIPTION_MODEL_CATALOG = {
   claude: ["claude-haiku-4-5", "claude-sonnet-5", "claude-opus-5", "claude-fable-5"],
@@ -2732,8 +2928,11 @@ export {
   DEFAULT_VOUCHER_CONFIG,
   EFFORT_RATIO,
   EXTENDED_CONTEXT_CAPABLE_MODELS,
+  IMAGE_CAPABILITY_UNAVAILABLE_REASONS,
+  IMAGE_GENERATION_ERROR_CODES,
   KNOWN_MODELS,
   LEGACY_THINKING_TOKEN_LIMITS,
+  LEGACY_UNKNOWN_PROVIDER_ID,
   LLM_PROVIDER_PRESETS,
   MAX_CONCURRENCY_DEFAULTS,
   MODEL_ALIASES,
@@ -2741,6 +2940,7 @@ export {
   PROVIDER_SEARCH_CONFIGS,
   REASONING_MODEL_PATTERNS,
   SUBSCRIPTION_MODEL_CATALOG,
+  SearchProviderError,
   THINKING_TOKEN_MAP,
   WEBHOOK_DESTINATION_TYPES,
   WEBHOOK_EVENT_KINDS,
@@ -2752,6 +2952,7 @@ export {
   canDisableThinking,
   findLegacyTokenLimit,
   findTokenLimit,
+  fromLegacyWebSearchResponse,
   getAllProviderPresets,
   getClaudeMaxTokens,
   getCodingPlanBaseUrl,
@@ -2762,14 +2963,21 @@ export {
   healthHttpStatus,
   isApiProvider,
   isExtendedContextCapable,
+  isKnownSearchProviderId,
   isLocalProvider,
   isReasoningModel,
+  isSearchProviderError,
   legacyCliBackendToSubscriptionProvider,
+  legacyErrorStringToSearchErrorCode,
+  legacyProviderIdToSearchProviderId,
   lookupCanonicalCapabilities,
   normalizeModelId,
   resolveFollowProviderModel,
   resolveModelCapabilities,
   resolveProviderEndpoint,
+  searchErrorToLegacyWebSearchResponse,
   subscriptionProviderHasCatalog,
-  subscriptionTargetForSession
+  subscriptionTargetForSession,
+  toLegacyWebSearchResponse,
+  toSearchErrorShape
 };