@x12i/ai-profiles 2.0.0 → 2.1.0

package/dist/data/models-profiles.json

@@ -2,7 +2,7 @@
   "schema": "x12i.ai-profiles.model-registry.v3",
   "registryId": "models-profiles",
   "generatedAt": "2026-05-29T00:00:00.000Z",
-  "lastVerifiedAt": "2026-06-01T12:00:00Z",
+  "lastVerifiedAt": "2026-06-02T00:00:00Z",
   "version": "4.0.0",
   "currency": "USD",
   "pricingUnit": "1M_tokens",
@@ -19,7 +19,10 @@
     "outputModalities": "Required output media types for profile intent (text, image, audio, video, file).",
     "choiceModalities": "Optional per-choice modality override when catalog linkage is missing.",
     "profileTags": "Short discovery tags (2–4 chars). Vendor affinity: ds, ggl, xai, mmx, ant, oai. (profile, tag-set) pairs are unique.",
+    "profileChoiceKey": "Canonical model lookup key is profile/choice (e.g. cheap/default). Object keys must match profile and choice fields. Aliases are discovery-only.",
     "catalogLane": "Required OpenRouter browser lane per profile. resolveAIProfile requires options.catalogLane matching the profile lane.",
+    "secondary": "Optional companion model per choice (review, escalation, verification). Resolved via resolveSecondaryModel; not a failover replacement.",
+    "fallbackChoiceOrder": "Replacement order when constraints exclude the primary choice (cost cap, vendor trim). Independent of secondary.",
     "volRouting": "Volume agent profile (vol): Flash default, Pro for hard/final. Model SKUs are never profile aliases."
   },
   "sourceCatalog": {
@@ -99,7 +102,12 @@
               "openrouter:catalog"
             ]
           },
-          "modelStatus": "verified"
+          "modelStatus": "verified",
+          "secondary": {
+            "kind": "choice",
+            "choice": "anthropic_cheap",
+            "reason": "Stronger instruction-following pass when cheap default quality is insufficient."
+          }
         },
         "google_floor": {
           "choice": "google_floor",
@@ -213,6 +221,134 @@
       },
       "catalogLane": "text"
     },
+    "value": {
+      "profile": "value",
+      "displayName": "Value",
+      "description": "Cheap but powerful: prioritize strong reasoning per dollar when you want higher capability without flagship pricing.",
+      "category": "cost",
+      "tags": ["eco", "rsn", "cod", "anl", "ds"],
+      "aliases": ["cheap-power", "power-cheap", "value", "cheap-strong"],
+      "defaultChoice": "default",
+      "choices": {
+        "default": {
+          "choice": "default",
+          "displayName": "Value Default (DeepSeek Pro)",
+          "description": "Recommended cheap-but-strong model choice.",
+          "provider": "deepseek",
+          "modelId": "deepseek-v4-pro",
+          "runtime": {
+            "instructionTier": "reasoning",
+            "backend": "openrouter",
+            "reasoningEffort": "high",
+            "toolPolicy": "none",
+            "outputMode": "text"
+          },
+          "reason": "Strong reasoning-per-dollar alternative when cheap is desired but quality matters."
+        },
+        "deepseek_flash": {
+          "choice": "deepseek_flash",
+          "displayName": "Value Fast (DeepSeek Flash)",
+          "description": "Cheaper and faster, but still strong for many tasks.",
+          "provider": "deepseek",
+          "modelId": "deepseek-v4-flash",
+          "runtime": {
+            "instructionTier": "default",
+            "backend": "openrouter",
+            "reasoningEffort": "medium",
+            "toolPolicy": "none",
+            "outputMode": "text"
+          },
+          "reason": "Use when you want the DeepSeek family but need a cheaper/faster option."
+        },
+        "google_value": {
+          "choice": "google_value",
+          "displayName": "Value Long-Context",
+          "description": "Long-context alternative for heavy reading.",
+          "provider": "google",
+          "modelId": "gemini-3.5-flash",
+          "runtime": {
+            "instructionTier": "default",
+            "backend": "openrouter",
+            "reasoningEffort": "medium",
+            "toolPolicy": "none",
+            "outputMode": "text"
+          },
+          "reason": "Good alternative when input size and context length matter more than maximum reasoning."
+        }
+      },
+      "fallbackChoiceOrder": ["default", "deepseek_flash", "google_value"],
+      "requiredCapabilities": {
+        "reasoning": "medium",
+        "coding": true,
+        "cost": "low",
+        "inputModalities": ["text"],
+        "outputModalities": ["text"]
+      },
+      "catalogLane": "text"
+    },
+    "testing": {
+      "profile": "testing",
+      "displayName": "Testing",
+      "description": "Cheap default profile for smoke tests, demos, and deterministic integration checks.",
+      "category": "cost",
+      "tags": ["eco", "wf", "bat", "tri"],
+      "aliases": ["test", "testing", "smoke", "smoke-test"],
+      "defaultChoice": "default",
+      "choices": {
+        "default": {
+          "choice": "default",
+          "displayName": "Testing Default",
+          "description": "Stable, cheap baseline model for tests.",
+          "provider": "google",
+          "modelId": "gemini-2.5-flash-lite",
+          "runtime": {
+            "instructionTier": "default",
+            "backend": "openrouter",
+            "reasoningEffort": "minimal",
+            "toolPolicy": "none",
+            "outputMode": "text"
+          },
+          "reason": "Cheap enough to use in CI-like flows and manual smoke tests."
+        },
+        "floor": {
+          "choice": "floor",
+          "displayName": "Testing Floor (same SKU)",
+          "description": "Explicit cost-floor choice for tests (intentionally same model).",
+          "provider": "google",
+          "modelId": "gemini-2.5-flash-lite",
+          "runtime": {
+            "reasoningEffort": "minimal",
+            "executionMode": "batch",
+            "toolPolicy": "none",
+            "outputMode": "text"
+          },
+          "reason": "Same catalog model as default, but labeled separately for easy selection in test matrices."
+        },
+        "deepseek_test": {
+          "choice": "deepseek_test",
+          "displayName": "Testing DeepSeek",
+          "description": "Alternate vendor for testing provider fallbacks.",
+          "provider": "deepseek",
+          "modelId": "deepseek-v4-flash",
+          "runtime": {
+            "instructionTier": "default",
+            "backend": "openrouter",
+            "reasoningEffort": "low",
+            "toolPolicy": "none",
+            "outputMode": "text"
+          },
+          "reason": "Useful to test non-Google routing and vendor trimming while staying inexpensive."
+        }
+      },
+      "fallbackChoiceOrder": ["default", "floor", "deepseek_test"],
+      "requiredCapabilities": {
+        "cost": "low",
+        "reasoning": "minimal",
+        "inputModalities": ["text"],
+        "outputModalities": ["text"]
+      },
+      "catalogLane": "text"
+    },
     "fast": {
       "profile": "fast",
       "displayName": "Fast",
@@ -406,7 +542,12 @@
               "openrouter:catalog"
             ]
           },
-          "modelStatus": "verified"
+          "modelStatus": "verified",
+          "secondary": {
+            "kind": "choice",
+            "choice": "anthropic_balanced",
+            "reason": "Higher-quality reviewer when balanced default needs a second opinion."
+          }
         },
         "anthropic_balanced": {
           "choice": "anthropic_balanced",
@@ -427,7 +568,7 @@
               "openrouter:catalog"
             ]
           },
-          "modelStatus": "predicted"
+          "modelStatus": "verified"
         },
         "google_balanced": {
           "choice": "google_balanced",
@@ -523,7 +664,7 @@
           "displayName": "Deep Default",
           "description": "Recommended high-reasoning model.",
           "provider": "anthropic",
-          "modelId": "claude-sonnet-4-5",
+          "modelId": "claude-sonnet-4-6",
           "runtime": {
             "instructionTier": "reasoning",
             "backend": "openrouter",
@@ -533,13 +674,18 @@
           },
           "reason": "Strong default for architecture, planning, code review, analysis, and complex workflows.",
           "verification": {
-            "lastVerifiedAt": "2026-05-29T17:08:03Z",
+          "lastVerifiedAt": "2026-06-02T00:00:00Z",
             "sourceRefs": [
               "vendor:anthropic",
               "openrouter:catalog"
             ]
           },
-          "modelStatus": "verified"
+          "modelStatus": "verified",
+          "secondary": {
+            "kind": "choice",
+            "choice": "deepseek_pro",
+            "reason": "Alternate flagship reasoning tier for verification and escalation."
+          }
         },
         "openai_deep": {
           "choice": "openai_deep",
@@ -560,7 +706,7 @@
               "openrouter:catalog"
             ]
           },
-          "modelStatus": "predicted"
+          "modelStatus": "verified"
         },
         "google_deep": {
           "choice": "google_deep",
@@ -628,7 +774,7 @@
               "openrouter:catalog"
             ]
           },
-          "modelStatus": "predicted"
+          "modelStatus": "verified"
         },
         "minimax_deep": {
           "choice": "minimax_deep",
@@ -739,7 +885,7 @@
               "openrouter:catalog"
             ]
           },
-          "modelStatus": "predicted"
+          "modelStatus": "verified"
         },
         "anthropic_pro": {
           "choice": "anthropic_pro",
@@ -760,7 +906,7 @@
               "openrouter:catalog"
             ]
           },
-          "modelStatus": "predicted"
+          "modelStatus": "verified"
         }
       },
       "fallbackChoiceOrder": [
@@ -827,7 +973,12 @@
               "openrouter:catalog"
             ]
           },
-          "modelStatus": "verified"
+          "modelStatus": "verified",
+          "secondary": {
+            "kind": "choice",
+            "choice": "anthropic_json",
+            "reason": "Higher-quality structured-output reviewer for complex extraction."
+          }
         },
         "google_json": {
           "choice": "google_json",
@@ -871,7 +1022,7 @@
               "openrouter:catalog"
             ]
           },
-          "modelStatus": "predicted"
+          "modelStatus": "verified"
         },
         "deepseek_json": {
           "choice": "deepseek_json",
@@ -943,7 +1094,7 @@
           "displayName": "Agentic Default",
           "description": "Recommended model for agentic execution.",
           "provider": "anthropic",
-          "modelId": "claude-sonnet-4-5",
+          "modelId": "claude-sonnet-4-6",
           "runtime": {
             "instructionTier": "default",
             "backend": "openrouter",
@@ -953,12 +1104,40 @@
           },
           "reason": "Strong default for multi-step planning, tool use, and agent workflows.",
           "verification": {
-            "lastVerifiedAt": "2026-05-29T17:08:03Z",
+          "lastVerifiedAt": "2026-06-02T00:00:00Z",
             "sourceRefs": [
               "vendor:anthropic",
               "openrouter:catalog"
             ]
           },
+          "modelStatus": "verified",
+          "secondary": {
+            "kind": "choice",
+            "choice": "openai_agentic",
+            "reason": "Cross-vendor reviewer for agentic tool-use workflows."
+          }
+        },
+        "deepseek_agentic": {
+          "choice": "deepseek_agentic",
+          "displayName": "DeepSeek V4 Agentic",
+          "description": "Agentic fallback using DeepSeek's reasoning and tool capabilities.",
+          "provider": "deepseek",
+          "modelId": "deepseek-v4-pro",
+          "runtime": {
+            "instructionTier": "reasoning",
+            "backend": "openrouter",
+            "reasoningEffort": "high",
+            "toolPolicy": "write-with-approval",
+            "outputMode": "text"
+          },
+          "reason": "Use when cost or vendor trimming excludes Anthropic or OpenAI for agentic tool use.",
+          "verification": {
+            "lastVerifiedAt": "2026-06-02T00:00:00Z",
+            "sourceRefs": [
+              "vendor:deepseek",
+              "openrouter:catalog"
+            ]
+          },
           "modelStatus": "verified"
         },
         "openai_agentic": {
@@ -980,7 +1159,7 @@
               "openrouter:catalog"
             ]
           },
-          "modelStatus": "predicted"
+          "modelStatus": "verified"
         },
         "google_agentic": {
           "choice": "google_agentic",
@@ -1407,7 +1586,7 @@
               "openrouter:catalog"
             ]
           },
-          "modelStatus": "predicted"
+          "modelStatus": "verified"
         }
       },
       "fallbackChoiceOrder": [
@@ -1486,7 +1665,7 @@
               "openrouter:catalog"
             ]
           },
-          "modelStatus": "predicted"
+          "modelStatus": "verified"
         }
       },
       "fallbackChoiceOrder": [
@@ -1997,6 +2176,11 @@
               "openrouter:catalog",
               "vendor:deepseek-api-docs"
             ]
+          },
+          "secondary": {
+            "kind": "choice",
+            "choice": "pro",
+            "reason": "Escalation to Pro when Flash default is insufficient for agent steps."
           }
         },
         "flash": {

package/dist/data/models-profiles.schema.json

@@ -88,6 +88,7 @@
           "enum": ["proprietary", "openWeightsHosted", "selfHosted"]
         },
         "fallbackChoiceOrder": { "type": "array", "items": { "type": "string" } },
+        "defaultSecondaryChoice": { "type": "string" },
         "aliases": { "type": "array", "items": { "type": "string" } },
         "tags": {
           "type": "array",
@@ -193,15 +194,43 @@
         }
       }
     },
+    "secondaryRef": {
+      "type": "object",
+      "required": ["kind"],
+      "properties": {
+        "kind": { "enum": ["choice", "model"] },
+        "choice": { "type": "string" },
+        "provider": { "type": "string" },
+        "modelId": { "type": "string" },
+        "reason": { "type": "string" },
+        "runtime": {
+          "type": "object",
+          "additionalProperties": true
+        }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "kind": { "const": "choice" } } },
+          "then": { "required": ["choice"] }
+        },
+        {
+          "if": { "properties": { "kind": { "const": "model" } } },
+          "then": { "required": ["provider", "modelId"] }
+        }
+      ]
+    },
     "choice": {
       "type": "object",
       "required": ["choice", "displayName", "description", "provider", "modelId"],
       "properties": {
         "choice": { "type": "string" },
+        "displayName": { "type": "string" },
+        "description": { "type": "string" },
         "provider": { "type": "string" },
         "modelId": { "type": "string" },
         "modelStatus": { "enum": ["verified", "predicted"] },
         "modalities": { "$ref": "#/$defs/modalityContract" },
+        "secondary": { "$ref": "#/$defs/secondaryRef" },
         "deploymentType": {
           "enum": ["proprietary", "openWeightsHosted", "selfHosted"]
         }

package/dist/data/profiles-shortcuts.json

@@ -1,16 +1,19 @@
 {
   "schema": "x12i.ai-profiles.shortcuts",
-  "version": "1.6.0",
-  "generatedAt": "2026-06-01T12:00:00.000Z",
+  "version": "2.0.0",
+  "generatedAt": "2026-06-02T13:39:41.774Z",
   "shortcuts": {
     "economy": {
-      "profile": "cheap"
+      "profile": "cheap",
+      "choice": "default"
     },
     "budget": {
-      "profile": "cheap"
+      "profile": "cheap",
+      "choice": "default"
     },
     "low-cost": {
-      "profile": "cheap"
+      "profile": "cheap",
+      "choice": "default"
     },
     "cheapest": {
       "profile": "cheap",
@@ -20,31 +23,57 @@
       "profile": "cheap",
       "choice": "anthropic_cheap"
     },
+    "cheap-power": {
+      "profile": "value",
+      "choice": "default"
+    },
+    "value": {
+      "profile": "value",
+      "choice": "default"
+    },
+    "test": {
+      "profile": "testing",
+      "choice": "default"
+    },
+    "testing": {
+      "profile": "testing",
+      "choice": "default"
+    },
+    "smoke-test": {
+      "profile": "testing",
+      "choice": "default"
+    },
     "instant": {
-      "profile": "fast"
+      "profile": "fast",
+      "choice": "default"
     },
     "quick": {
-      "profile": "fast"
+      "profile": "fast",
+      "choice": "default"
     },
     "fast-cheap": {
       "profile": "fast",
       "choice": "google_fast"
     },
     "default": {
-      "profile": "balanced"
+      "profile": "balanced",
+      "choice": "default"
     },
     "standard": {
-      "profile": "balanced"
+      "profile": "balanced",
+      "choice": "default"
     },
     "normal": {
       "profile": "balanced",
       "choice": "default"
     },
     "thinking": {
-      "profile": "deep"
+      "profile": "deep",
+      "choice": "default"
     },
     "high-reasoning": {
-      "profile": "deep"
+      "profile": "deep",
+      "choice": "default"
     },
     "long-context": {
       "profile": "deep",
@@ -55,50 +84,60 @@
       "choice": "default"
     },
     "premium": {
-      "profile": "pro"
+      "profile": "pro",
+      "choice": "default"
     },
     "best": {
-      "profile": "pro"
+      "profile": "pro",
+      "choice": "default"
     },
     "strong": {
       "profile": "pro",
       "choice": "default"
     },
     "schema": {
-      "profile": "json"
+      "profile": "json",
+      "choice": "default"
     },
     "strict-json": {
-      "profile": "json"
+      "profile": "json",
+      "choice": "default"
     },
     "cheap-json": {
       "profile": "json",
       "choice": "google_json"
     },
     "agent": {
-      "profile": "agentic"
+      "profile": "agentic",
+      "choice": "default"
     },
     "tools": {
-      "profile": "agentic"
+      "profile": "agentic",
+      "choice": "default"
     },
     "cheap-agent": {
       "profile": "agentic",
       "choice": "google_agentic"
     },
     "web-research": {
-      "profile": "research"
+      "profile": "research",
+      "choice": "default"
     },
     "source-review": {
-      "profile": "research"
+      "profile": "research",
+      "choice": "default"
     },
     "premium-research": {
       "profile": "research",
       "choice": "openai_research"
     },
     "offline": {
-      "profile": "local"
+      "profile": "local",
+      "choice": "llama_cpp_gguf"
     },
     "on-device": {
-      "profile": "local"
+      "profile": "local",
+      "choice": "llama_cpp_gguf"
     },
     "cpu": {
       "profile": "local",
@@ -109,10 +148,12 @@
       "choice": "llama_cpp_gguf"
     },
     "threat-intel": {
-      "profile": "cyber"
+      "profile": "cyber",
+      "choice": "default"
     },
     "security": {
-      "profile": "cyber"
+      "profile": "cyber",
+      "choice": "default"
     },
     "audit": {
       "profile": "cyber",
@@ -123,10 +164,12 @@
       "choice": "log_analysis"
     },
     "writing": {
-      "profile": "content"
+      "profile": "content",
+      "choice": "default"
     },
     "copy": {
-      "profile": "content"
+      "profile": "content",
+      "choice": "default"
     },
     "pseo": {
       "profile": "content",
@@ -149,7 +192,8 @@
       "choice": "mega_context"
     },
     "image": {
-      "profile": "vision"
+      "profile": "vision",
+      "choice": "default"
     },
     "ocr": {
       "profile": "vision",
@@ -160,25 +204,32 @@
       "choice": "deepseek_cheap"
     },
     "coding": {
-      "profile": "coding"
+      "profile": "coding",
+      "choice": "default"
     },
     "dev": {
-      "profile": "coding"
+      "profile": "coding",
+      "choice": "default"
     },
     "extraction": {
-      "profile": "extraction"
+      "profile": "extraction",
+      "choice": "default"
     },
     "extract": {
-      "profile": "extraction"
+      "profile": "extraction",
+      "choice": "default"
     },
     "routing": {
-      "profile": "routing"
+      "profile": "routing",
+      "choice": "default"
     },
     "route": {
-      "profile": "routing"
+      "profile": "routing",
+      "choice": "default"
     },
     "cyber-analysis": {
-      "profile": "cyber"
+      "profile": "cyber",
+      "choice": "default"
     },
     "cyber-default": {
       "profile": "cyber",
@@ -197,7 +248,8 @@
       "choice": "deepseek_pro"
     },
     "volume-agent": {
-      "profile": "vol"
+      "profile": "vol",
+      "choice": "default"
     },
     "agent-volume": {
       "profile": "vol",

package/dist/errors.d.ts

@@ -1,4 +1,4 @@
-export type AIProfilesErrorCode = "UNKNOWN_PROFILE" | "UNKNOWN_SHORTCUT" | "UNKNOWN_CHOICE" | "NO_ALLOWED_VENDOR" | "NO_MODALITY_MATCH" | "NO_COST_CAP_MATCH" | "NO_OPENROUTER_CATALOG" | "CATALOG_LANE_MISMATCH" | "MISSING_CATALOG_LANE" | "REMOTE_FETCH_FAILED" | "REMOTE_JSON_INVALID" | "BUNDLED_JSON_INVALID" | "REGISTRY_SCHEMA_UNSUPPORTED" | "REGISTRY_VALIDATION_FAILED";
+export type AIProfilesErrorCode = "UNKNOWN_PROFILE" | "UNKNOWN_PROFILE_CHOICE" | "UNKNOWN_MODEL" | "CHOICE_SUBSTITUTED" | "UNKNOWN_SHORTCUT" | "UNKNOWN_CHOICE" | "UNKNOWN_SECONDARY_CHOICE" | "SECONDARY_CYCLE" | "NO_ALLOWED_VENDOR" | "NO_MODALITY_MATCH" | "NO_COST_CAP_MATCH" | "NO_OPENROUTER_CATALOG" | "CATALOG_LANE_MISMATCH" | "MISSING_CATALOG_LANE" | "REMOTE_FETCH_FAILED" | "REMOTE_JSON_INVALID" | "BUNDLED_JSON_INVALID" | "REGISTRY_SCHEMA_UNSUPPORTED" | "REGISTRY_VALIDATION_FAILED";
 export declare class AIProfilesError extends Error {
     code: AIProfilesErrorCode;
     details?: Record<string, unknown> | undefined;

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAC3B,iBAAiB,GACjB,kBAAkB,GAClB,gBAAgB,GAChB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,uBAAuB,GACvB,uBAAuB,GACvB,sBAAsB,GACtB,qBAAqB,GACrB,qBAAqB,GACrB,sBAAsB,GACtB,6BAA6B,GAC7B,4BAA4B,CAAC;AAEjC,qBAAa,eAAgB,SAAQ,KAAK;IAE/B,IAAI,EAAE,mBAAmB;IAEzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,mBAAmB,EAChC,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAK3C"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAC3B,iBAAiB,GACjB,wBAAwB,GACxB,eAAe,GACf,oBAAoB,GACpB,kBAAkB,GAClB,gBAAgB,GAChB,0BAA0B,GAC1B,iBAAiB,GACjB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,GACnB,uBAAuB,GACvB,uBAAuB,GACvB,sBAAsB,GACtB,qBAAqB,GACrB,qBAAqB,GACrB,sBAAsB,GACtB,6BAA6B,GAC7B,4BAA4B,CAAC;AAEjC,qBAAa,eAAgB,SAAQ,KAAK;IAE/B,IAAI,EAAE,mBAAmB;IAEzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAFjC,IAAI,EAAE,mBAAmB,EAChC,OAAO,EAAE,MAAM,EACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;CAK3C"}