multi-forge 0.4.0__tar.gz → 0.5.0__tar.gz

{multi_forge-0.4.0 → multi_forge-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: multi-forge
-Version: 0.4.0
+Version: 0.5.0
 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

{multi_forge-0.4.0 → multi_forge-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "multi-forge"
-version = "0.4.0"
+version = "0.5.0"
 description = "Multi-runtime agent toolkit: proxy routing, cost control, session management, policy enforcement, and workflow orchestration"
 readme = "README.md"
 license = "Apache-2.0"

{multi_forge-0.4.0 → multi_forge-0.5.0}/src/forge/__init__.py

@@ -1,3 +1,3 @@
 """Multi-Forge - Multi-runtime agent toolkit."""
 
-__version__ = "0.4.0"
+__version__ = "0.5.0"

{multi_forge-0.4.0 → multi_forge-0.5.0}/src/forge/cli/activity.py

@@ -100,7 +100,10 @@ def _render(summary: SessionActivitySummary, *, days: int | None) -> None:
         for c in summary.commands:
             errors = f"[red]{c.errors}[/red]" if c.errors else "0"
             tokens = f"{c.input_tokens}/{c.output_tokens}" if (c.input_tokens or c.output_tokens) else "-"
-            cost = f"~{_fmt_usd(c.cost_micro_usd)}" if c.cost_micro_usd is not None else "-"
+            if c.cost_micro_usd is None:
+                cost = "-"
+            else:
+                cost = f"{'~' if c.cost_estimated else ''}{_fmt_usd(c.cost_micro_usd)}"
             row = [c.command, str(c.calls)]
             if show_workers:
                 row.append(str(c.workers) if c.workers else "-")
@@ -120,7 +123,10 @@ def _render(summary: SessionActivitySummary, *, days: int | None) -> None:
     if summary.subagents:
         console.print(f"\n[bold]Subagents[/bold]: {summary.subagents}")
 
-    total_cost = f"~{_fmt_usd(summary.total_cost_micro_usd)}" if summary.total_cost_micro_usd is not None else "n/a"
+    if summary.total_cost_micro_usd is None:
+        total_cost = "n/a"
+    else:
+        total_cost = f"{'~' if summary.cost_estimated else ''}{_fmt_usd(summary.total_cost_micro_usd)}"
     console.print(
         f"\n[dim]Total:[/dim] {summary.total_events} events · "
         f"{summary.total_input_tokens}/{summary.total_output_tokens} tok · {total_cost}"
@@ -138,7 +144,12 @@ def _footnotes(summary: SessionActivitySummary) -> list[str]:
         notes.append("policy decision log is at capacity — older decisions may not be shown")
     if summary.session_tagging_partial:
         notes.append("some calls (e.g. the action tagger) are not session-attributed")
-    notes.append("cost is reported-or-estimated, best-effort; 'forge proxy costs show' is the authoritative spend view")
+    # "no snapshot estimates" covers both exact sources: the 4g cost-plane root-join
+    # and runtime-reported (runtime_native) self-reports. A cost-less summary keeps
+    # the generic caveat -- there is no figure to call exact.
+    exact = summary.total_cost_micro_usd is not None and not summary.cost_estimated
+    evidence = "reported (no snapshot estimates mixed in)" if exact else "reported-or-estimated"
+    notes.append(f"cost is {evidence}, best-effort; 'forge proxy costs show' is the authoritative spend view")
     return notes
 
 

{multi_forge-0.4.0 → multi_forge-0.5.0}/src/forge/cli/gc.py

@@ -16,9 +16,9 @@ from forge.core.ops.gc import CleanError, CleanReport, collect_clean_report, run
 @click.command("clean")
 @click.option(
     "--scope",
-    type=click.Choice(["repo", "project", "all"]),
-    default="repo",
-    help="Scope: repo (default), project, or all",
+    type=click.Choice(["workspace", "project", "all"]),
+    default="workspace",
+    help="Scope: workspace (default), project, or all",
 )
 @click.option("--yes", "-y", is_flag=True, help="Actually delete (default is dry-run)")
 @click.option("--verbose", "-v", is_flag=True, help="Show individual items")
@@ -31,7 +31,7 @@ def clean_cmd(scope: str, yes: bool, verbose: bool, as_json: bool) -> None:
     Examples:
 
     \b
-        forge clean                       # Dry-run (scope: repo)
+        forge clean                       # Dry-run (scope: workspace)
         forge clean --yes                 # Actually clean
         forge clean --scope all --yes     # Clean globally
         forge clean --scope project       # Current Forge project only

{multi_forge-0.4.0 → multi_forge-0.5.0}/src/forge/cli/hooks/direct_commands.py

@@ -68,7 +68,7 @@ def _handle_cmd_help() -> None:
                 "reason": "Direct commands:\n"
                 "- %session show [name] | list\n"
                 "- %proxy list | show <id> | audit show|diff [id]\n"
-                "- %clean [--scope repo|project|all]\n"
+                "- %clean [--scope workspace|project|all]\n"
                 "- %plan\n"
                 "- %config (show runtime config)\n"
                 "- %policy status | enable | disable | check\n"
@@ -108,8 +108,8 @@ def _handle_cmd_session(data: dict[str, Any], argv: list[str]) -> None:
     if "--no-incognito" in argv:
         include_incognito = False
 
-    # Parse --scope VALUE or --scope=VALUE (default: repo)
-    scope = "repo"
+    # Parse --scope VALUE or --scope=VALUE (default: workspace)
+    scope = "workspace"
     for i, arg in enumerate(argv):
         if arg.startswith("--scope="):
             scope = arg.split("=", 1)[1].lower()

{multi_forge-0.4.0 → multi_forge-0.5.0}/src/forge/cli/memory.py

@@ -85,7 +85,7 @@ def memory() -> None:
         forge memory track docs/changelog.md --strategy changelog    # author a passport (sessionless)
         forge memory enable --session planner                  # enable memory for a session
         forge memory list                                      # show passported docs
-        forge memory status --scope repo                       # show activation across sessions
+        forge memory status --scope workspace                  # show activation across sessions
     """
 
 
@@ -590,7 +590,7 @@ def list_cmd(as_json: bool) -> None:
 @memory.command("status")
 @click.option(
     "--scope",
-    type=click.Choice(["project", "repo", "all"]),
+    type=click.Choice(["project", "workspace", "all"]),
     default="project",
     show_default=True,
     help="Scope for discovery.",
@@ -689,7 +689,7 @@ def _collect_shadow_entries(
 @shadows_group.command("list")
 @click.option(
     "--scope",
-    type=click.Choice(["project", "repo", "all"]),
+    type=click.Choice(["project", "workspace", "all"]),
     default="project",
     show_default=True,
     help="Scope for discovery.",
@@ -754,7 +754,7 @@ def shadows_list_cmd(scope: str, as_json: bool) -> None:
 @click.option("--for", "for_doc", required=True, help="Official doc to show shadow content for.")
 @click.option(
     "--scope",
-    type=click.Choice(["project", "repo", "all"]),
+    type=click.Choice(["project", "workspace", "all"]),
     default="project",
     show_default=True,
     help="Scope for discovery.",
@@ -820,7 +820,7 @@ def shadows_show_cmd(for_doc: str, scope: str) -> None:
 @click.option("--session", "-s", "session_name", default=None, help="Session name.")
 @click.option(
     "--scope",
-    type=click.Choice(["project", "repo", "all"]),
+    type=click.Choice(["project", "workspace", "all"]),
     default="project",
     show_default=True,
     help="Scope for shadow discovery.",
@@ -923,7 +923,7 @@ def _review_curate(
     )
 
     if scope == "all":
-        raise click.ClickException("Cross-project curation deferred; use --scope project or --scope repo.")
+        raise click.ClickException("Cross-project curation deferred; use --scope project or --scope workspace.")
 
     ctx = ExecutionContext.from_cwd()
     try:

{multi_forge-0.4.0 → multi_forge-0.5.0}/src/forge/cli/policy.py

@@ -59,7 +59,7 @@ def _resolve_session_for_display(
     name: str,
     cwd: Path,
 ) -> tuple[SessionStore, SessionState]:
-    """Resolve a named session, repo-scoped with current-project preference.
+    """Resolve a named session, workspace-scoped with current-project preference.
 
     Delegates to the shared two-tier resolver in core.ops.resolution.
     """

{multi_forge-0.4.0 → multi_forge-0.5.0}/src/forge/cli/runtime.py

@@ -7,12 +7,19 @@ headless, hooks, usage source, native resume, install scopes).
 
 from __future__ import annotations
 
+import sys
+
 import click
 from rich.console import Console
 from rich.markup import escape
 from rich.table import Table
 
-from forge.core.runtime import RuntimeSpec, list_runtimes
+from forge.core.runtime import (
+    CodexPreflight,
+    RuntimeSpec,
+    list_runtimes,
+    preflight_codex,
+)
 
 
 @click.group(context_settings={"help_option_names": ["-h", "--help"]})
@@ -99,7 +106,75 @@ def list_cmd(as_json: bool) -> None:
 
     console.print(table)
     # Escape note text: a free-text note may contain bracketed tokens (e.g.
-    # `[features] codex_hooks = true`) that Rich would otherwise eat as markup.
+    # `[features] hooks`) that Rich would otherwise eat as markup.
     for s in specs:
         if s.note:
             console.print(f"[dim]{s.id}: {escape(s.note)}[/dim]")
+
+
+def _render_preflight(console: Console, result: CodexPreflight) -> None:
+    """Render a CodexPreflight as a labeled report (escapes free-text; carries no secret)."""
+    version = result.version or "-"
+    floor_met = "yes" if result.version_ok else "no"
+    ready = "[green]YES[/green]" if result.ready else "[red]NO[/red]"
+
+    console.print("[bold]Codex preflight[/bold]")
+    console.print(f"  Installed:  {'yes' if result.installed else 'no'}")
+    console.print(f"  Version:    {escape(version)} (hook floor met: {floor_met})")
+    console.print(
+        f"  Auth:       {escape(result.auth_method)}  "
+        f"(source: {escape(result.auth_source)}, billing: {escape(result.billing_mode)})"
+    )
+    console.print(f"  Hook seam:  {escape(result.hook_seam)}")
+    console.print(f"  Responses:  {escape(result.proxy_responses)}")
+    if result.doctor_status:
+        console.print(f"  Doctor:     {escape(result.doctor_status)} [dim](informational)[/dim]")
+    console.print(f"  Ready:      {ready}")
+    if not result.ready and result.blocking_reason:
+        console.print()
+        console.print(escape(result.blocking_reason))
+
+
+@runtime.command("preflight")
+@click.argument("runtime_name", metavar="RUNTIME")
+@click.option(
+    "--proxy",
+    "proxy_id",
+    default=None,
+    metavar="PROXY_ID",
+    help="Check Responses support against an existing proxy id (reads proxy.yaml; starts nothing).",
+)
+@click.option("--json", "as_json", is_flag=True, help="Output as JSON")
+def preflight_cmd(runtime_name: str, proxy_id: str | None, as_json: bool) -> None:
+    """Preflight a runtime for headless runs: auth, hooks, and Responses readiness.
+
+    Runs the dynamic, per-machine checks the static `forge runtime list` matrix cannot:
+    resolves a non-interactive credential, reads `codex doctor`, checks hook state, and
+    -- with --proxy -- whether that proxy can serve Codex its Responses API. Exits
+    non-zero when the runtime is not ready.
+
+    \b
+    Examples:
+        forge runtime preflight codex
+        forge runtime preflight codex --json
+        forge runtime preflight codex --proxy my-openai-proxy
+    """
+    if runtime_name != "codex":
+        # Codex is the only runtime with a preflight today; this is the dispatch seam.
+        raise click.BadParameter(
+            f"No preflight available for '{runtime_name}' (supported: codex).",
+            param_hint="RUNTIME",
+        )
+
+    result = preflight_codex(proxy_id=proxy_id)
+
+    if as_json:
+        import json
+        from dataclasses import asdict
+
+        click.echo(json.dumps(asdict(result), indent=2))
+    else:
+        _render_preflight(Console(), result)
+
+    if not result.ready:
+        sys.exit(1)

{multi_forge-0.4.0 → multi_forge-0.5.0}/src/forge/cli/session_manage.py

@@ -415,9 +415,9 @@ def _delete_single_session(
 )
 @click.option(
     "--scope",
-    type=click.Choice(["repo", "project", "all"], case_sensitive=False),
-    default="repo",
-    help="Scope: repo (default, same logical repo), project (same forge_root), all (global)",
+    type=click.Choice(["workspace", "project", "all"], case_sensitive=False),
+    default="workspace",
+    help="Scope: workspace (default, all worktrees of the same repo), project (same forge_root), all (global)",
 )
 @click.option("--json", "as_json", is_flag=True, help="Output as JSON")
 def list_sessions(include_incognito: bool, older_than: int | None, scope: str, as_json: bool) -> None:
@@ -788,7 +788,7 @@ def show(session_id: str | None, as_json: bool, field_path: str | None) -> None:
 
     # Resolve the forge_root once -- either from get_session_context's prior
     # UUID/name lookup (preserves exact scope for UUIDs) or via the two-tier
-    # repo-wide resolver as fallback.
+    # workspace-wide resolver as fallback.
     from forge.core.ops.resolution import resolve_session_repo_wide
     from forge.core.ops.session_context import resolve_session_identifier
 
@@ -815,7 +815,7 @@ def show(session_id: str | None, as_json: bool, field_path: str | None) -> None:
                 return st, ent, is_cross
             except ForgeSessionError:
                 pass
-        # Fallback: two-tier repo-wide resolution
+        # Fallback: two-tier workspace-wide resolution
         try:
             res = resolve_session_repo_wide(ctx.session_name, _fr, manager=manager)
             return res.state, res.entry, res.is_cross_project

{multi_forge-0.4.0 → multi_forge-0.5.0}/src/forge/cli/status_line.py

@@ -338,7 +338,8 @@ def get_tier_display(runtime: ProxyRuntimeTruth | None) -> str | None:
 def get_tier_from_display_name(display_name: str) -> str:
     """Map Claude Code's display name to tier."""
     display_lower = display_name.lower()
-    if "opus" in display_lower:
+    # Fable carries no tier word of its own; it rides the opus tier.
+    if "opus" in display_lower or "fable" in display_lower:
         return "opus"
     elif "sonnet" in display_lower:
         return "sonnet"
@@ -360,6 +361,9 @@ def explicit_tier_from_model(model_id: str) -> str | None:
     for tier in ("haiku", "sonnet", "opus"):
         if tier in name:
             return tier
+    # Fable carries no tier word of its own; it rides the opus tier.
+    if "fable" in name:
+        return "opus"
     return None
 
 

{multi_forge-0.4.0 → multi_forge-0.5.0}/src/forge/cli/transfer.py

@@ -31,7 +31,7 @@ from forge.core.ops.transfer import (
     show_transfer,
 )
 from forge.core.paths import display_path
-from forge.session.transfer import ResumeStrategy
+from forge.session.transfer import TRANSFER_TARGET_RUNTIMES, ResumeStrategy
 
 _STRATEGY_CHOICES = [s.value for s in ResumeStrategy]
 
@@ -112,11 +112,19 @@ def show_cmd(parent: str, child: str | None, as_json: bool) -> None:
     help="Override strategy (default: the cache's current strategy).",
 )
 @click.option("--depth", type=int, default=None, help="Override lineage depth (default: the cache's current depth).")
-def regenerate_cmd(parent: str, strategy: str | None, depth: int | None) -> None:
+@click.option(
+    "--target-runtime",
+    type=click.Choice(list(TRANSFER_TARGET_RUNTIMES)),
+    default=None,
+    help="Which runtime will consume this context (default: the cache's current target runtime).",
+)
+def regenerate_cmd(parent: str, strategy: str | None, depth: int | None, target_runtime: str | None) -> None:
     """Rebuild the parent cache (generated.md). Never touches children or notes."""
     ctx = ExecutionContext.from_cwd()
     try:
-        result = regenerate_transfer(ctx=ctx, parent=parent, strategy=strategy, depth=depth)
+        result = regenerate_transfer(
+            ctx=ctx, parent=parent, strategy=strategy, depth=depth, target_runtime=target_runtime
+        )
     except ForgeOpError as e:
         print_error_with_tip(
             str(e),
@@ -127,7 +135,7 @@ def regenerate_cmd(parent: str, strategy: str | None, depth: int | None) -> None
 
     console.print(
         f"Regenerated [green]{display_path(result.path)}[/green] "
-        f"[dim](strategy={result.strategy}, depth={result.depth})[/dim]"
+        f"[dim](strategy={result.strategy}, depth={result.depth}, runtime={result.target_runtime})[/dim]"
     )
     for warning in result.warnings:
         console.print(f"[yellow]Warning:[/yellow] {warning}")

{multi_forge-0.4.0 → multi_forge-0.5.0}/src/forge/config/defaults/templates/anthropic-passthrough.yaml

@@ -8,7 +8,8 @@
 # `provider: litellm` is only a config slot used for credential and upstream
 # resolution — `wire_shape: anthropic_passthrough` is the authoritative wire truth
 # (GET / reports it). Tiers are informational here; the client's model is forwarded
-# unchanged. Requires ANTHROPIC_API_KEY in .env (or environment).
+# unchanged (so --model claude-fable-5 reaches the API as-is; no model_alternatives
+# remap applies on this wire shape). Requires ANTHROPIC_API_KEY in .env (or environment).
 
 proxy:
   family: anthropic
@@ -26,5 +27,5 @@ proxy:
     tiers:
       haiku: claude-haiku-4-5
       sonnet: claude-sonnet-4-6
-      opus: claude-opus-4-6
+      opus: claude-fable-5
     base_url: "https://api.anthropic.com"

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

@@ -6,6 +6,9 @@
 #
 # Backend (LiteLLM on port 4000) starts automatically.
 #
+# Opus tier defaults to Fable 5. Use --model claude-opus-4-8 or
+# --model claude-opus-4-6 to select an Opus alternative instead.
+#
 # Note: If you added ANTHROPIC_API_KEY after the backend started,
 # restart with: forge backend stop litellm-4000
 
@@ -25,9 +28,10 @@ proxy:
     tiers:
       haiku: anthropic/claude-haiku-4-5
       sonnet: anthropic/claude-sonnet-4-6
-      opus: anthropic/claude-opus-4-6
+      opus: anthropic/claude-fable-5
     model_alternatives:
       opus:
         claude-opus-4-8: anthropic/claude-opus-4-8
+        claude-opus-4-6: anthropic/claude-opus-4-6
     prompt_caching: passthrough
     error_hints: true

{multi_forge-0.4.0 → multi_forge-0.5.0}/src/forge/config/defaults/templates/litellm-anthropic.yaml

@@ -1,10 +1,12 @@
 # Template: litellm-anthropic
 # Anthropic Claude via remote/shared LiteLLM
 #
-# Access to Claude Opus 4.6/4.8, Sonnet 4.6, and Haiku 4.5.
+# Access to Claude Fable 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-fable-5.
 #
-# Use --model claude-opus-4-8 to select Opus 4.8 instead of the 4.6 default.
+# Opus tier defaults to Fable 5. Use --model claude-opus-4-8 or
+# --model claude-opus-4-6 to select an Opus alternative instead.
 # prompt_caching: passthrough respects Anthropic's 4-breakpoint cache_control limit.
 
 proxy:
@@ -16,9 +18,10 @@ proxy:
     tiers:
       haiku: anthropic/claude-haiku-4-5
       sonnet: anthropic/claude-sonnet-4-6
-      opus: anthropic/claude-opus-4-6
+      opus: anthropic/claude-fable-5
     model_alternatives:
       opus:
         claude-opus-4-8: anthropic/claude-opus-4-8
+        claude-opus-4-6: anthropic/claude-opus-4-6
     prompt_caching: passthrough
     error_hints: true

{multi_forge-0.4.0 → multi_forge-0.5.0}/src/forge/config/defaults/templates/openrouter-anthropic.yaml

@@ -1,10 +1,11 @@
 # Template: openrouter-anthropic
 # Anthropic Claude models via OpenRouter (direct, no LiteLLM)
 #
-# Access to Claude Opus 4.6/4.8, Sonnet 4.6, and Haiku 4.5.
+# Access to Claude Fable 5, Opus 4.8/4.6, Sonnet 4.6, and Haiku 4.5.
 # Requires OPENROUTER_API_KEY in .env (or environment).
 #
-# Use --model claude-opus-4-8 to select Opus 4.8 instead of the 4.6 default.
+# Opus tier defaults to Fable 5. Use --model claude-opus-4-8 or
+# --model claude-opus-4-6 to select an Opus alternative instead.
 
 proxy:
   family: anthropic
@@ -15,9 +16,10 @@ proxy:
     tiers:
       haiku: anthropic/claude-haiku-4.5
       sonnet: anthropic/claude-sonnet-4.6
-      opus: anthropic/claude-opus-4.6
+      opus: anthropic/claude-fable-5
     model_alternatives:
       opus:
         claude-opus-4-8: anthropic/claude-opus-4.8
+        claude-opus-4-6: anthropic/claude-opus-4.6
     base_url: "https://openrouter.ai/api/v1"
     error_hints: true

{multi_forge-0.4.0 → multi_forge-0.5.0}/src/forge/core/auth/capabilities.py

@@ -84,6 +84,21 @@ CREDENTIALS: dict[str, Credential] = {
         signup_url="https://aistudio.google.com/apikey",
         note="Gemini API key for local LiteLLM proxy routing",
     ),
+    "codex-api": Credential(
+        name="codex-api",
+        env_vars=(EnvVar("CODEX_API_KEY"),),
+        unlocks_features=("Native Codex headless runs (codex exec)",),
+        signup_url="https://platform.openai.com/api-keys",
+        note=(
+            "Non-interactive Codex override. Codex keeps its OWN credential store; run "
+            "'codex doctor' to see resolved auth. Not your ChatGPT login (codex login "
+            "--device-auth) and not OPENAI_API_KEY."
+        ),
+        not_needed_for=(
+            "Codex already logged in via 'codex login'",
+            "Codex via ChatGPT subscription (codex login --device-auth)",
+        ),
+    ),
     "litellm-remote": Credential(
         name="litellm-remote",
         env_vars=(
@@ -158,8 +173,8 @@ def format_missing_credential_error(
     """Build an actionable error message for missing credentials.
 
     Includes what failed, which key(s), signup URL, and the exact
-    ``forge auth login`` command. Renders ``not_needed_for`` only for
-    anthropic-api (where false urgency is common).
+    ``forge auth login`` command. Renders ``not_needed_for`` when the credential
+    defines it (anthropic-api, codex-api -- where false urgency is common).
     """
     key_word = "key" if len(missing_vars) == 1 else "keys"
     var_list = ", ".join(missing_vars)

{multi_forge-0.4.0 → multi_forge-0.5.0}/src/forge/core/data/model_catalog.yaml

@@ -761,7 +761,7 @@ models:
     # minimal/low/none/disable -> low, medium/high -> high
     litellm_reasoning_efforts: [none, disable, minimal, low, medium, high]
     default_reasoning_effort: high
-    intelligence_score: 94
+    intelligence_score: 99  # Peer of gpt-5.5 / Claude Opus 4.8
     system_prompt_addendum: system_prompt_addendums/gemini.md
     tags: []
 
@@ -785,7 +785,7 @@ models:
     default_thinking_level: high
     litellm_reasoning_efforts: [none, disable, minimal, low, medium, high]
     default_reasoning_effort: high
-    intelligence_score: 94
+    intelligence_score: 99  # Tracks gemini-3.1-pro-preview
     system_prompt_addendum: system_prompt_addendums/gemini.md
     tags: [agentic, custom-tools]
 
@@ -976,9 +976,41 @@ models:
     litellm_reasoning_efforts: [low, medium, high, xhigh]
     default_reasoning_effort: high
     token_estimate_multiplier: 1.35
-    intelligence_score: 100
+    intelligence_score: 99  # Below Fable 5; peer of gpt-5.5 / Gemini 3.1 Pro
     tags: [bounded-review, opt-in]
 
+  # --- Claude Fable Series ---
+  # Fable 5 is the most capable model (a tier above Opus). Same request surface
+  # as Opus 4.8 -- adaptive thinking only, sampling overrides removed. Used as
+  # the OpenRouter opus-tier default (see templates/openrouter-anthropic.yaml);
+  # Opus 4.8/4.6 stay selectable via --model. Not a catalog default: anthropic
+  # defaults stay on 4.6 until this profile is proven for resume-heavy flows.
+  claude-fable-5:
+    friendly_name: Claude Fable 5
+    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: 1024
+      max_cache_blocks: 4
+    native_thinking_param: output_config.effort
+    thinking_modes: [adaptive]
+    litellm_reasoning_efforts: [low, medium, high, xhigh]
+    default_reasoning_effort: high
+    token_estimate_multiplier: 1.35
+    intelligence_score: 100
+    tags: [opt-in]
+
   claude-sonnet-4-6:
     friendly_name: Claude Sonnet 4.6
     context_window_tokens: 200000
@@ -1547,6 +1579,12 @@ aliases:
   opus-4-8: claude-opus-4-8
   opus-4.8: claude-opus-4-8
 
+  # Fable 5 (most capable; OpenRouter opus-tier default, direct --model fable)
+  anthropic/claude-fable-5: claude-fable-5
+  claude-fable: claude-fable-5
+  fable-5: claude-fable-5
+  fable: claude-fable-5
+
   # Sonnet 4.6
   anthropic/claude-sonnet-4-6: claude-sonnet-4-6
   anthropic/claude-sonnet-4-6-1m: claude-sonnet-4-6-1m

{multi_forge-0.4.0 → multi_forge-0.5.0}/src/forge/core/invoker/__init__.py

@@ -7,6 +7,7 @@ ordered fan-out, timeouts) and per-job usage emission. Phase 5 adds a
 """
 
 from .claude import ClaudeHeadlessInvoker
+from .codex import CodexHeadlessInvoker, prepare_codex_request
 from .types import (
     Attribution,
     HeadlessInvoker,
@@ -17,7 +18,9 @@ from .types import (
 __all__ = [
     "Attribution",
     "ClaudeHeadlessInvoker",
+    "CodexHeadlessInvoker",
     "HeadlessInvoker",
     "HeadlessRequest",
     "HeadlessResult",
+    "prepare_codex_request",
 ]