multi-forge 1.1.4__tar.gz → 1.1.5__tar.gz

{multi_forge-1.1.4 → multi_forge-1.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: multi-forge
-Version: 1.1.4
+Version: 1.1.5
 Summary: Multi-runtime agent toolkit: proxy routing, cost control, session management, policy enforcement, and workflow orchestration
 Project-URL: Homepage, https://github.com/hapa1i/multi-forge
 Project-URL: Repository, https://github.com/hapa1i/multi-forge
@@ -38,7 +38,7 @@ Requires-Dist: filelock>=4.2.1
 Requires-Dist: httpx>=0.25.0
 Requires-Dist: litellm==1.102.2
 Requires-Dist: multidict<7,>=6.9.1
-Requires-Dist: oauthlib<5,>=4.0.0
+Requires-Dist: oauthlib<5,>=4.0.1
 Requires-Dist: openai>=1.0.0
 Requires-Dist: orjson<4,>=3.11.6
 Requires-Dist: packaging>=21.0

{multi_forge-1.1.4 → multi_forge-1.1.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "multi-forge"
-version = "1.1.4"
+version = "1.1.5"
 description = "Multi-runtime agent toolkit: proxy routing, cost control, session management, policy enforcement, and workflow orchestration"
 readme = "README.md"
 license = "Apache-2.0"
@@ -64,7 +64,7 @@ dependencies = [
     "filelock>=4.2.1",
     # Runtime security floors belong in wheel metadata, not only uv constraints.
     "multidict>=6.9.1,<7",
-    "oauthlib>=4.0.0,<5",
+    "oauthlib>=4.0.1,<5",
     "orjson>=3.11.6,<4",
     "pydantic-settings>=2.14.1,<3",
     "pyjwt>=2.15.0,<3",
@@ -172,7 +172,7 @@ constraint-dependencies = [
     "virtualenv>=21.14.13",
     "mcp>=1.28.1",
     "Pygments>=2.20.0",
-    "pyasn1>=0.6.4",
+    "pyasn1>=0.6.5",
 ]
 
 [dependency-groups]

{multi_forge-1.1.4 → multi_forge-1.1.5}/src/forge/config/defaults/backends/litellm.yaml

@@ -16,7 +16,7 @@
 #
 #   Anthropic (requires ANTHROPIC_API_KEY):
 #     - anthropic/claude-haiku-4-5, claude-sonnet-5-5, claude-sonnet-5, claude-opus-5-5, claude-opus-5
-#     - anthropic/claude-fable-5-1, claude-fable-5
+#     - anthropic/claude-fable-5-2, claude-fable-5-1, claude-fable-5
 #     - anthropic/claude-opus-4-8, claude-opus-4-6, claude-sonnet-4-6
 #
 #   OpenAI (requires OPENAI_API_KEY):
@@ -279,6 +279,47 @@ model_list:
       model: anthropic/claude-opus-5
       api_key: os.environ/ANTHROPIC_API_KEY
 
+  # LiteLLM 1.102.2 predates Fable 5.2; register its native controls and prices offline.
+  # https://platform.claude.com/docs/en/models/fable-5-2/overview (verified 2026-11-10)
+  - model_name: anthropic/claude-fable-5-2
+    litellm_params:
+      model: anthropic/claude-fable-5-2
+      api_key: os.environ/ANTHROPIC_API_KEY
+    model_info:
+      base_model: claude-fable-5-2
+      mode: chat
+      max_input_tokens: 1000000
+      max_output_tokens: 128000
+      max_tokens: 128000
+      input_cost_per_token: 0.000008
+      output_cost_per_token: 0.000040
+      cache_creation_input_token_cost: 0.000010
+      cache_creation_input_token_cost_above_1hr: 0.000016
+      cache_read_input_token_cost: 0.0000002
+      supports_vision: true
+      supports_function_calling: true
+      supports_tool_choice: true
+      supports_forced_tool_use: false
+      supports_sampling_params: false
+      supports_prompt_caching: true
+      prompt_cache_min_tokens: 512
+      supports_reasoning: true
+      supports_adaptive_thinking: true
+      supports_legacy_thinking: false
+      thinking_always_on: true
+      supports_output_config: true
+      supports_xhigh_reasoning_effort: true
+      supports_max_reasoning_effort: true
+      default_reasoning_effort: high
+      reasoning_effort_levels: [low, medium, high, xhigh, max]
+      supports_response_schema: true
+      supports_native_structured_output: true
+      supports_assistant_prefill: false
+      supports_mid_conversation_system: true
+      provider_specific_entry:
+        us: 1.1
+        fast: 2.0
+
   - model_name: anthropic/claude-fable-5-1
     litellm_params:
       model: anthropic/claude-fable-5-1

{multi_forge-1.1.4 → multi_forge-1.1.5}/src/forge/config/defaults/templates/litellm-anthropic-local.yaml

@@ -7,7 +7,7 @@
 # Backend (LiteLLM on port 4000) starts automatically.
 #
 # Defaults: sonnet tier -> Sonnet 5.5, opus tier -> Opus 5.5. Alternatives are
-# claude-opus-5, claude-fable-5-1, claude-fable-5, claude-opus-4-8, claude-opus-4-6,
+# claude-opus-5, claude-fable-5-2, claude-fable-5-1, claude-fable-5, claude-opus-4-8, claude-opus-4-6,
 # claude-sonnet-5, and claude-sonnet-4-6.
 #
 # After adding ANTHROPIC_API_KEY, stop the backend so Forge restarts it with the new environment:
@@ -27,6 +27,7 @@ proxy:
     model_alternatives:
       opus:
         claude-opus-5: anthropic/claude-opus-5
+        claude-fable-5-2: anthropic/claude-fable-5-2
         claude-fable-5-1: anthropic/claude-fable-5-1
         claude-fable-5: anthropic/claude-fable-5
         claude-opus-4-8: anthropic/claude-opus-4-8

{multi_forge-1.1.4 → multi_forge-1.1.5}/src/forge/config/defaults/templates/litellm-anthropic.yaml

@@ -1,12 +1,12 @@
 # Template: litellm-anthropic
 # Anthropic Claude via remote/shared LiteLLM
 #
-# Access to Claude Opus 5.5/5, Sonnet 5.5/5, Fable 5.1/5, Opus 4.8/4.6, Sonnet 4.6, and Haiku 4.5.
+# Access to Claude Opus 5.5/5, Sonnet 5.5/5, Fable 5.2/5.1/5, Opus 4.8/4.6, Sonnet 4.6, and Haiku 4.5.
 # Requires LITELLM_API_KEY and LITELLM_BASE_URL in .env (or environment).
 # NOTE: the shared LiteLLM instance must serve anthropic/claude-opus-5-5 and anthropic/claude-sonnet-5-5.
 #
 # Defaults: sonnet tier -> Sonnet 5.5, opus tier -> Opus 5.5. Alternatives are
-# claude-opus-5, claude-fable-5-1, claude-fable-5, claude-opus-4-8, claude-opus-4-6,
+# claude-opus-5, claude-fable-5-2, claude-fable-5-1, claude-fable-5, claude-opus-4-8, claude-opus-4-6,
 # claude-sonnet-5, and claude-sonnet-4-6.
 # prompt_caching: passthrough respects Anthropic's 4-breakpoint cache_control limit.
 
@@ -24,6 +24,7 @@ proxy:
     model_alternatives:
       opus:
         claude-opus-5: anthropic/claude-opus-5
+        claude-fable-5-2: anthropic/claude-fable-5-2
         claude-fable-5-1: anthropic/claude-fable-5-1
         claude-fable-5: anthropic/claude-fable-5
         claude-opus-4-8: anthropic/claude-opus-4-8

{multi_forge-1.1.4 → multi_forge-1.1.5}/src/forge/config/defaults/templates/openrouter-anthropic.yaml

@@ -1,11 +1,11 @@
 # Template: openrouter-anthropic
 # Anthropic Claude models via OpenRouter (direct, no LiteLLM)
 #
-# Access to Claude Opus 5.5/5, Sonnet 5.5/5, Fable 5.1/5, Opus 4.8/4.6, Sonnet 4.6, and Haiku 4.5.
+# Access to Claude Opus 5.5/5, Sonnet 5.5/5, Fable 5.2/5.1/5, Opus 4.8/4.6, Sonnet 4.6, and Haiku 4.5.
 # Requires OPENROUTER_API_KEY in .env (or environment).
 #
 # Defaults: sonnet tier -> Sonnet 5.5, opus tier -> Opus 5.5. Alternatives are
-# claude-opus-5, claude-fable-5-1, claude-fable-5, claude-opus-4-8, claude-opus-4-6,
+# claude-opus-5, claude-fable-5-2, claude-fable-5-1, claude-fable-5, claude-opus-4-8, claude-opus-4-6,
 # claude-sonnet-5, and claude-sonnet-4-6.
 
 proxy:
@@ -21,11 +21,13 @@ proxy:
       sonnet: anthropic/claude-sonnet-5.5
       opus: anthropic/claude-opus-5.5
     zdr_fallbacks:
+      anthropic/claude-fable-5.2: anthropic/claude-opus-5.5
       anthropic/claude-fable-5.1: anthropic/claude-opus-5.5
       anthropic/claude-fable-5: anthropic/claude-opus-5.5
     model_alternatives:
       opus:
         claude-opus-5: anthropic/claude-opus-5
+        claude-fable-5-2: anthropic/claude-fable-5.2
         claude-fable-5-1: anthropic/claude-fable-5.1
         claude-fable-5: anthropic/claude-fable-5
         claude-opus-4-8: anthropic/claude-opus-4.8

{multi_forge-1.1.4 → multi_forge-1.1.5}/src/forge/core/data/model_catalog.yaml

@@ -1361,10 +1361,35 @@ models:
     tags: []
 
   # --- Claude Fable Series ---
-  # Fable 5.1 is the current Fable family default (unversioned aliases and the
-  # named review worker), but not a catalog tier default: the opus tier remains
-  # on Opus 5.5. Fable 5.1 adds max effort to Fable 5's adaptive-only request
-  # surface; both versions stay selectable via --model (opus alternatives).
+  # Stable Fable aliases and the named worker select 5.2. The opus tier stays on
+  # Opus 5.5; earlier Fable versions remain explicit opus alternatives.
+  # https://platform.claude.com/docs/en/models/fable-5-2/overview
+  claude-fable-5-2:
+    friendly_name: Claude Fable 5.2
+    context_window_tokens: 1000000
+    max_output_tokens: 128000
+    max_thinking_tokens: 128000
+    supports_thinking: true
+    supports_images: true
+    supports_1m_context: true
+    temperature_constraint: fixed
+    temperature: 1.0
+    supports_top_p: false
+    supports_sampling_overrides: false
+    default_timeout_seconds: 240
+    prompt_caching:
+      supports: true
+      mechanism: cache_control
+      min_tokens: 512
+      max_cache_blocks: 4
+    native_thinking_param: output_config.effort
+    thinking_modes: [adaptive]
+    supports_forced_tool_choice: false
+    litellm_reasoning_efforts: [low, medium, high, xhigh, max]
+    default_reasoning_effort: high
+    token_estimate_multiplier: 1.35
+    tags: [opt-in]
+
   claude-fable-5-1:
     friendly_name: Claude Fable 5.1
     context_window_tokens: 1000000
@@ -1385,6 +1410,7 @@ models:
       max_cache_blocks: 4
     native_thinking_param: output_config.effort
     thinking_modes: [adaptive]
+    supports_forced_tool_choice: false
     litellm_reasoning_efforts: [low, medium, high, xhigh, max]
     default_reasoning_effort: high
     token_estimate_multiplier: 1.35
@@ -2506,14 +2532,21 @@ aliases:
   anthropic/claude-opus-5: claude-opus-5  # also the OpenRouter slug (no dot)
   opus-5: claude-opus-5
 
-  # Fable 5.1 (current family default; opus --model alternative)
+  # Fable 5.2 (current family default; opus --model alternative)
+  anthropic/claude-fable-5-2: claude-fable-5-2
+  anthropic/claude-fable-5.2: claude-fable-5-2  # OpenRouter slug
+  claude-fable-5.2: claude-fable-5-2
+  claude-fable: claude-fable-5-2
+  fable-5-2: claude-fable-5-2
+  fable-5.2: claude-fable-5-2
+  fable: claude-fable-5-2
+
+  # Fable 5.1 (retained explicit prior-version aliases)
   anthropic/claude-fable-5-1: claude-fable-5-1
   anthropic/claude-fable-5.1: claude-fable-5-1  # OpenRouter slug
   claude-fable-5.1: claude-fable-5-1
-  claude-fable: claude-fable-5-1
   fable-5-1: claude-fable-5-1
   fable-5.1: claude-fable-5-1
-  fable: claude-fable-5-1
 
   # Fable 5 (retained explicit prior-version aliases)
   anthropic/claude-fable-5: claude-fable-5

{multi_forge-1.1.4 → multi_forge-1.1.5}/src/forge/core/data/model_routes.yaml

@@ -946,6 +946,11 @@ models:
       - kind: direct
         runtime: claude_code
         model_ref: claude-opus-5
+  claude-fable-5-2:
+    routes:
+      - kind: direct
+        runtime: claude_code
+        model_ref: claude-fable-5-2
   claude-fable-5-1:
     routes:
       - kind: direct

{multi_forge-1.1.4 → multi_forge-1.1.5}/src/forge/core/usage/correlation.py

@@ -143,19 +143,21 @@ def resolve_client_base_url(model: str) -> str | None:
 def target_is_forge_proxy(base_url: str | None) -> bool:
     """True if ``base_url`` is a known Forge proxy endpoint.
 
-    Reverse-lookup in the proxy registry (``~/.forge/proxies/index.json``).
-    Best-effort: any failure (no registry, unreadable, lookup error) returns
-    False -- callers must not stamp ``cost_request_id`` unless this is certain,
-    or the ledger would carry a back-reference to a cost record that never
-    materialized.
+    Membership check in the proxy registry (``~/.forge/proxies/index.json``);
+    any registered entry qualifies, even when several share the URL and none
+    owns it alone. Best-effort: any failure (no registry, unreadable, lookup
+    error) returns False -- callers must not stamp ``cost_request_id`` unless
+    this is certain, or the ledger would carry a back-reference to a cost record
+    that never materialized.
     """
     if not base_url:
         return False
     try:
-        from forge.proxy.proxies import ProxyRegistryStore, lookup_proxy_by_base_url
+        from forge.proxy.proxies import ProxyRegistryStore
 
+        normalized = base_url.rstrip("/")
         registry = ProxyRegistryStore().read()
-        return lookup_proxy_by_base_url(registry, base_url.rstrip("/")) is not None
+        return any(entry.base_url == normalized for entry in registry.proxies.values())
     except Exception as e:
         logger.debug("target_is_forge_proxy(%s) failed, treating as non-proxy: %s", base_url, e)
         return False

{multi_forge-1.1.4 → multi_forge-1.1.5}/src/forge/proxy/model_routes.py

@@ -9,9 +9,11 @@ from forge.core.models.model_reference import strip_transport_model_suffix
 
 # Full bundled-default/alternative audit against OpenRouter's ZDR endpoint
 # catalog on 2026-08-21, refreshed for the September releases on 2026-09-23.
+# Fable 5.2 was checked separately on 2026-11-10.
 # These slugs had no eligible endpoint. Request-level provider.zdr remains authoritative
 # if this dated snapshot becomes stale.
 BUILTIN_OPENROUTER_ZDR_FALLBACKS = {
+    "anthropic/claude-fable-5.2": "anthropic/claude-opus-5.5",
     "anthropic/claude-fable-5.1": "anthropic/claude-opus-5.5",
     "anthropic/claude-fable-5": "anthropic/claude-opus-5.5",
     "qwen/qwen3.6-flash": "qwen/qwen3.8-27b",

{multi_forge-1.1.4 → multi_forge-1.1.5}/src/forge/proxy/proxies.py

@@ -111,24 +111,31 @@ def get_proxy_registry_path() -> Path:
     return get_forge_home() / PROXIES_DIR / PROXY_INDEX_FILENAME
 
 
+# Proxy statuses that represent a routable (active) proxy.
+ROUTABLE_STATUSES = frozenset({"healthy", "starting"})
+
+
 def lookup_proxy_by_base_url(registry: ProxyRegistry, base_url: str) -> ProxyEntry | None:
-    """Reverse lookup: find proxy entry by base_url.
+    """Reverse lookup: find the proxy entry that owns base_url.
+
+    Template starts spawn new proxy ids on the template's default port, so stopped
+    instances accumulate on one base_url. A sole registered entry owns its URL in
+    any status; among several, only a sole routable entry does, mirroring the
+    template fallback in ``resolve_proxy``. Returning the first match instead would
+    attribute a live session to whichever stale instance was registered earliest.
 
     Args:
         registry: The proxy registry to search.
         base_url: The URL to match (e.g., "http://localhost:8084").
 
     Returns:
-        The matching ProxyEntry, or None if no proxy owns that base_url.
+        The owning ProxyEntry, or None if no entry, or no single routable entry, owns that base_url.
     """
-    for entry in registry.proxies.values():
-        if entry.base_url == base_url:
-            return entry
-    return None
-
-
-# Proxy statuses that represent a routable (active) proxy.
-ROUTABLE_STATUSES = frozenset({"healthy", "starting"})
+    matches = [entry for entry in registry.proxies.values() if entry.base_url == base_url]
+    if len(matches) == 1:
+        return matches[0]
+    active = [entry for entry in matches if entry.status in ROUTABLE_STATUSES]
+    return active[0] if len(active) == 1 else None
 
 
 class ProxyResolutionError(Exception):

{multi_forge-1.1.4 → multi_forge-1.1.5}/src/skills/qa/resources/checklist/4-proxy.md

@@ -472,8 +472,8 @@ forge proxy template show openrouter-qwen
 - [ ] `openrouter-qwen` maps tiers to Qwen models (haiku/sonnet=qwen3.8-27b, opus=qwen3.8-max)
 - [ ] `openrouter-qwen` exposes `qwen3.8-flash` and the distinct `qwen3.8-max-0902` snapshot
 - [ ] Every OpenRouter template defaults `allow_non_zdr` to false; no LiteLLM template contains ZDR fields
-- [ ] The dated ZDR audit fallbacks map Fable 5.1/Fable 5 to Opus 5.5 and cover all eight bundled non-ZDR Qwen slugs;
-  both Qwen3.8 Max entries map to `qwen/qwen3.8-2.4t-a95b`, and Qwen3.8 Flash maps to `qwen/qwen3.8-27b`
+- [ ] The dated ZDR audit fallbacks map Fable 5.2/5.1/5 to Opus 5.5 and cover all eight bundled non-ZDR Qwen slugs; both
+  Qwen3.8 Max entries map to `qwen/qwen3.8-2.4t-a95b`, and Qwen3.8 Flash maps to `qwen/qwen3.8-27b`
 - [ ] `openrouter-openai` maps tiers to GPT models (haiku=gpt-5.4-mini, sonnet=gpt-6-astra, opus=gpt-6-astra)
 - [ ] `openrouter-openai-codex` maps tiers to Codex models (haiku=gpt-5.1-codex-mini, sonnet=gpt-5.3-codex,
   opus=gpt-6-astra)