coding-os 0.3.6__tar.gz → 0.3.7__tar.gz

{coding_os-0.3.6 → coding_os-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coding-os
-Version: 0.3.6
+Version: 0.3.7
 Summary: The cognitive operating system that gives AI agents memory, structure, and discipline
 Author-email: Kourosh Ebrahimzadeh <info@coding-os.dev>
 License-Expression: Apache-2.0

{coding_os-0.3.6 → coding_os-0.3.7}/coding_os.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: coding-os
-Version: 0.3.6
+Version: 0.3.7
 Summary: The cognitive operating system that gives AI agents memory, structure, and discipline
 Author-email: Kourosh Ebrahimzadeh <info@coding-os.dev>
 License-Expression: Apache-2.0

{coding_os-0.3.6 → coding_os-0.3.7}/coding_os.egg-info/SOURCES.txt

@@ -526,6 +526,7 @@ src/core/skills/typescript/references/type-system.md
 src/core/skills/typescript/scripts/check_tsconfig.py
 src/core/thinking_os/__init__.py
 src/core/thinking_os/_agent_markers.py
+src/core/thinking_os/adapter_registry.py
 src/core/thinking_os/background.py
 src/core/thinking_os/bootstrap_outcomes.py
 src/core/thinking_os/budget.py
@@ -562,6 +563,7 @@ src/core/thinking_os/session_enrich.py
 src/core/thinking_os/session_observe_worker.py
 src/core/thinking_os/session_startup.py
 src/core/thinking_os/session_summary.py
+src/core/thinking_os/supervision.py
 src/core/thinking_os/task_analyzer.py
 src/core/thinking_os/task_parser.py
 src/core/thinking_os/task_sync.py
@@ -1159,6 +1161,7 @@ src/templates/wordpress/skills/wordpress/assets/wp-checklist.md
 src/templates/wordpress/skills/wordpress/references/wp-development.md
 src/templates/wordpress/skills/wordpress/references/wp-security.md
 src/templates/wordpress/skills/wordpress/scripts/scan_wp_smells.py
+tests/test_adapter_capacity_errors.py
 tests/test_adapter_parity.py
 tests/test_adapter_registry.py
 tests/test_adapter_session_marker_probe_parity.py

{coding_os-0.3.6 → coding_os-0.3.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "coding-os"
-version = "0.3.6"
+version = "0.3.7"
 description = "The cognitive operating system that gives AI agents memory, structure, and discipline"
 readme = "README.md"
 requires-python = ">=3.10"

{coding_os-0.3.6 → coding_os-0.3.7}/src/adapters/claude/adapter.yaml

@@ -5,6 +5,9 @@ label: "Anthropic Claude Code"
 # Hub chat model picker — adapter→models SSOT (served by /api/config/adapters).
 # runtime: in_process ⇒ runnable via the Claude Agent SDK inside Hub chat.
 runtime: in_process
+runtime_entrypoints:
+  dispatch: sdk_dispatcher.py
+  capabilities: [dispatch, model_selection, effort_selection, structured_output]
 models:
   - id: claude-fable-5
     label: "Fable 5"

{coding_os-0.3.6 → coding_os-0.3.7}/src/adapters/claude/sdk_dispatcher.py

@@ -70,6 +70,38 @@ _CHAT_BASE_TOOLS = (
 _CHAT_PROFILES = ("chat", "chat_resume")
 
 
+def _failure_fields(status: str, error: str | None) -> dict[str, Any]:
+    if status == "ok":
+        return {}
+    message = (error or "").lower()
+    if status == "timeout":
+        return {"error_category": "timeout", "retryable": True, "outcome": "unknown"}
+    retry_after: int | None = None
+    match = re.search(r"(?:retry after|try again in)\s+(\d+)\s*(?:seconds?|s)?", message)
+    if match:
+        retry_after = int(match.group(1))
+    if any(
+        token in message
+        for token in ("rate limit", "usage limit", "quota", "too many requests", "429", "capacity")
+    ):
+        return {
+            "error_category": "capacity",
+            "retryable": True,
+            "retry_after_s": retry_after,
+            "outcome": "known_failed",
+        }
+    if any(
+        token in message
+        for token in ("unauthorized", "authentication", "not logged in", "401", "403")
+    ):
+        return {"error_category": "auth", "outcome": "known_failed"}
+    if any(token in message for token in ("not importable", "not found")):
+        return {"error_category": "unavailable", "outcome": "known_failed"}
+    if any(token in message for token in ("must be absolute", "max_budget_usd", "max_turns")):
+        return {"error_category": "invalid", "outcome": "known_failed"}
+    return {"error_category": "provider", "outcome": "unknown"}
+
+
 def _cos_mcp_servers(cwd: str) -> dict[str, Any]:
     try:
         data = json.loads((Path(cwd) / ".mcp.json").read_text(encoding="utf-8"))
@@ -371,6 +403,9 @@ class ClaudeSDKDispatcher:
                 error=f"claude-agent-sdk not importable: {self._import_error}",
                 dispatcher_name=self.name,
                 latency_ms=int((time.monotonic() - t0) * 1000),
+                **_failure_fields(
+                    "error", f"claude-agent-sdk not importable: {self._import_error}"
+                ),
             )
 
         from claude_agent_sdk import (
@@ -394,6 +429,9 @@ class ClaudeSDKDispatcher:
                 error=f"agent_file must be absolute, got: {request.agent_file!r}",
                 dispatcher_name=self.name,
                 latency_ms=int((time.monotonic() - t0) * 1000),
+                **_failure_fields(
+                    "error", f"agent_file must be absolute, got: {request.agent_file!r}"
+                ),
             )
 
         try:
@@ -405,6 +443,7 @@ class ClaudeSDKDispatcher:
                 error=str(exc),
                 dispatcher_name=self.name,
                 latency_ms=int((time.monotonic() - t0) * 1000),
+                **_failure_fields("error", str(exc)),
             )
 
         # Skill inheritance — formula sub-sessions get a fresh context, so
@@ -465,9 +504,9 @@ class ClaudeSDKDispatcher:
 
         # High-tier models get "xhigh"; everything else uses the SDK
         # default (None → "high"). See _XHIGH_EFFORT_MODEL_PREFIXES.
-        effort: str | None = None
+        effort: str | None = request.effort
         if resolved_model and resolved_model.startswith(_XHIGH_EFFORT_MODEL_PREFIXES):
-            effort = "xhigh"
+            effort = effort or "xhigh"
 
         # Structured output (T1) — opt-in per role via
         # `structured_output: true` frontmatter. SDK enforces the
@@ -739,6 +778,7 @@ class ClaudeSDKDispatcher:
                     dispatcher_name=self.name,
                     latency_ms=int((time.monotonic() - t0) * 1000),
                     raw_transcript="\n".join(transcript_parts) or None,
+                    **_failure_fields("timeout", f"timed out after {request.timeout_s}s"),
                 )
             except Exception as exc:
                 logger.exception("claude-sdk dispatch failed")
@@ -749,6 +789,7 @@ class ClaudeSDKDispatcher:
                     dispatcher_name=self.name,
                     latency_ms=int((time.monotonic() - t0) * 1000),
                     raw_transcript="\n".join(transcript_parts) or None,
+                    **_failure_fields("error", f"{type(exc).__name__}: {exc}"),
                 )
         finally:
             _presence_write(project_root, "claude", sub_session_id, "end")
@@ -804,6 +845,7 @@ class ClaudeSDKDispatcher:
                 latency_ms=latency_ms,
                 dispatcher_name=self.name,
                 raw_transcript=transcript or None,
+                **_failure_fields("error", f"max_budget_usd={request.max_budget_usd} exhausted"),
             )
         if result_subtype == "error_max_turns":
             return DispatchResult(
@@ -814,6 +856,7 @@ class ClaudeSDKDispatcher:
                 latency_ms=latency_ms,
                 dispatcher_name=self.name,
                 raw_transcript=transcript or None,
+                **_failure_fields("error", "max_turns exhausted"),
             )
         if result_subtype == "error_max_structured_output_retries":
             # Schema enforcement gave up; fall through to regex extraction
@@ -858,6 +901,7 @@ class ClaudeSDKDispatcher:
             dispatcher_name=self.name,
             error=error_str,
             raw_transcript=transcript,
+            **_failure_fields("ok" if ok else "error", error_str),
         )
 
 

{coding_os-0.3.6 → coding_os-0.3.7}/src/adapters/codex/adapter.yaml

@@ -6,6 +6,10 @@ label: "OpenAI Codex CLI"
 # runtime: roadmap ⇒ declared but not yet runnable inside Hub chat (Claude SDK
 # only today). Models intentionally empty — no fabricated IDs (P7 no-guessing).
 runtime: roadmap
+runtime_entrypoints:
+  dispatch: sdk_dispatcher.py
+  transcript: chat_provider.py
+  capabilities: [dispatch, model_selection, structured_output]
 models: []
 
 presence:

{coding_os-0.3.6 → coding_os-0.3.7}/src/adapters/codex/sdk_dispatcher.py

@@ -6,6 +6,7 @@ import asyncio
 import json
 import logging
 import os
+import re
 import shutil
 import subprocess
 import tempfile
@@ -24,6 +25,38 @@ _PYTHON_SDK_BACKEND = "python-sdk"
 _BACKENDS = {_CLI_BACKEND, _PYTHON_SDK_BACKEND}
 
 
+def _failure_fields(status: str, error: str | None) -> dict[str, Any]:
+    if status == "ok":
+        return {}
+    message = (error or "").lower()
+    if status == "timeout":
+        return {"error_category": "timeout", "retryable": True, "outcome": "unknown"}
+    retry_after: int | None = None
+    match = re.search(r"(?:retry after|try again in)\s+(\d+)\s*(?:seconds?|s)?", message)
+    if match:
+        retry_after = int(match.group(1))
+    if any(
+        token in message
+        for token in ("rate limit", "usage limit", "quota", "too many requests", "429", "capacity")
+    ):
+        return {
+            "error_category": "capacity",
+            "retryable": True,
+            "retry_after_s": retry_after,
+            "outcome": "known_failed",
+        }
+    if any(
+        token in message
+        for token in ("unauthorized", "authentication", "not logged in", "401", "403")
+    ):
+        return {"error_category": "auth", "outcome": "known_failed"}
+    if any(token in message for token in ("not in path", "not importable", "unsupported")):
+        return {"error_category": "unavailable", "outcome": "known_failed"}
+    if any(token in message for token in ("must be absolute", "cannot enforce", "invalid")):
+        return {"error_category": "invalid", "outcome": "known_failed"}
+    return {"error_category": "provider", "outcome": "unknown"}
+
+
 def _codex_binary() -> str | None:
     return shutil.which("codex")
 
@@ -189,6 +222,7 @@ class CodexSDKDispatcher:
             raw_transcript=raw_transcript,
             dispatcher_name=self.name,
             latency_ms=int((time.monotonic() - started_at) * 1000),
+            **_failure_fields(status, error),
         )
 
     def _completed(

{coding_os-0.3.6 → coding_os-0.3.7}/src/core/hooks/nudge-model-routing.sh

@@ -1,10 +1,9 @@
 #!/usr/bin/env bash
-# UserPromptSubmit hook — model-routing directive injector (TASK-319).
+# UserPromptSubmit hook — supervision directive injector.
 #
 # When hub-settings.json::model_routing.enabled is true, inject a ONE-LINE
-# directive (once per session) telling the agent to consult cos_route_model
-# at Classify and honor it at dispatch — CLI/VSCode parity with the hub
-# chat Auto option. Toggle off = exit silently before any output: zero
+# directive (once per session) telling the agent how the selected trigger
+# mode controls formula dispatch. Toggle off = exit silently before any output: zero
 # injected tokens, zero behavior change. Fail-open: never blocks a prompt.
 set -euo pipefail
 
@@ -23,8 +22,9 @@ MARKER="${COS_PANEL_DIR:-$COS_AGENT_DIR}/.model-routing-nudged"
 [[ -f "$MARKER" ]] && exit 0
 touch "$MARKER" 2>/dev/null || true
 
-ORCH=$(jq -r '.model_routing.orchestrator_model // ""' "$SETTINGS_FILE" 2>/dev/null || echo "")
-CONTEXT="[model-routing ON] After recording the gate (cos_classify_prompt), call cos_route_model(complexity=<gate>) and honor it at dispatch (pass model+complexity to cos_dispatch_formula_run). Cold history -> orchestrator_model '${ORCH}' (settings), else adapter default. Contract: src/core/rules/model-routing.md"
+MODE=$(jq -r '.model_routing.mode // "explicit"' "$SETTINGS_FILE" 2>/dev/null || echo "explicit")
+THRESHOLD=$(jq -r '.model_routing.complexity_threshold // "COMPLICATED"' "$SETTINGS_FILE" 2>/dev/null || echo "COMPLICATED")
+CONTEXT="[agent-supervision ON] mode=${MODE}, threshold=${THRESHOLD}. Follow src/core/rules/model-routing.md: role policies choose adapter/model/effort; dispatch tools enforce capacity cooldown, safe fallback, and recovery."
 
 cos_log_hook nudge-model-routing ok || true
 printf '%s' "{\"hookSpecificOutput\":{\"hookEventName\":\"UserPromptSubmit\",\"additionalContext\":$(printf '%s' "$CONTEXT" | python3 -c 'import json,sys; print(json.dumps(sys.stdin.read()))')}}"

{coding_os-0.3.6 → coding_os-0.3.7}/src/core/hooks/registry.yaml

@@ -1101,11 +1101,10 @@ hooks:
   - id: nudge-model-routing
     script: nudge-model-routing.sh
     description: |
-      UserPromptSubmit nudge — model-routing directive (TASK-319). When
+      UserPromptSubmit nudge — agent-supervision directive. When
       hub-settings.json::model_routing.enabled, injects a one-line
-      additional-context directive (once per session) telling the agent to
-      consult cos_route_model at Classify and pass model+complexity at
-      dispatch — CLI/VSCode parity with the hub chat Auto option. Toggle
+      additional-context directive (once per session) with the configured
+      trigger mode and complexity threshold. Toggle
       off = silent exit, zero injected tokens. Contract:
       src/core/rules/model-routing.md.
     category: cognition

coding_os-0.3.7/src/core/rules/model-routing.md

@@ -0,0 +1,25 @@
+# Agent Supervision (settings-gated)
+
+> **Rule:** When `model_routing.enabled` is on in `$COS_STATE_DIR/hub-settings.json`, formula dispatch follows the configured trigger mode and role policy. When it is off, this rule is inert.
+
+CLI and desktop sessions receive the same project policy through the once-per-session `nudge-model-routing` hook. Hub edits that policy without changing the current conversation's parent runtime.
+
+## The contract
+
+1. **Toggle off (default)** — nothing fires; dispatch behaviour is unchanged.
+2. **Explicit** — dispatch only when the operator or active procedure requests a child run.
+3. **Suggest** — propose the adapter/model/role route and wait for operator approval.
+4. **Adaptive** — after classification, supervise work at or above the configured complexity threshold.
+5. **Dispatch** — explicit request fields override per-role policy, then preset and role defaults. Every parallel role resolves its own adapter.
+6. **Capacity** — a normalized usage-limit failure pauses only that adapter. The dispatcher uses an eligible fallback only when the failed run is known not to have started; timeout or unknown outcomes are never replayed.
+7. **Recovery** — after cooldown, one half-open probe is allowed. Success restores normal routing; another capacity failure extends cooldown.
+
+## Settings source (SSOT)
+
+`hub-settings.json::model_routing` is written by Hub and read fresh per dispatch. Adapter capabilities, models, and efforts come from adapter descriptors; the kernel does not enumerate providers.
+
+## See also
+
+- [Agent supervision](../../docs/engineering/agent-supervision.md)
+- [Dispatcher contract](../../docs/engineering/dispatcher-contract.md)
+- [src/core/hooks/nudge-model-routing.sh](../hooks/nudge-model-routing.sh) — the per-session directive injector

{coding_os-0.3.6 → coding_os-0.3.7}/src/core/schemas/adapter.schema.json

@@ -66,6 +66,26 @@
       "type": ["string", "null"],
       "description": "Optional adapter-local Python module that exposes read-only Hub transcript list/get operations."
     },
+    "runtime_entrypoints": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Provider-neutral adapter-owned runtime modules and capabilities used by supervision. Entrypoints must be bare filenames inside the adapter directory.",
+      "properties": {
+        "dispatch": {
+          "type": ["string", "null"],
+          "pattern": "^[^/\\\\]+$"
+        },
+        "transcript": {
+          "type": ["string", "null"],
+          "pattern": "^[^/\\\\]+$"
+        },
+        "capabilities": {
+          "type": "array",
+          "items": {"type": "string", "pattern": "^[a-z][a-z0-9_]*$"},
+          "uniqueItems": true
+        }
+      }
+    },
     "cli_binary": {
       "type": "string",
       "description": "Executable name discoverable on PATH for this agent (e.g. \"claude\"). Consumed by src/cli/doctor.py::_probe_agent_sdk so that file stays free of hardcoded adapter literals (rule #11). Optional — defaults to the adapter id when missing."

coding_os-0.3.7/src/core/thinking_os/adapter_registry.py

@@ -0,0 +1,111 @@
+from __future__ import annotations
+
+import importlib.util
+import logging
+from dataclasses import dataclass
+from pathlib import Path
+from types import ModuleType
+from typing import Any
+
+import yaml
+
+logger = logging.getLogger("coding_os.adapter_registry")
+
+
+def _resolve_adapters_dir(module_path: Path) -> Path:
+    candidates = (
+        module_path.resolve().parents[2] / "adapters",
+        module_path.resolve().parents[1] / "adapters",
+    )
+    return next((candidate for candidate in candidates if candidate.is_dir()), candidates[0])
+
+
+ADAPTERS_DIR = _resolve_adapters_dir(Path(__file__))
+
+
+@dataclass(frozen=True)
+class AdapterRecord:
+    id: str
+    path: Path
+    manifest: dict[str, Any]
+
+    @property
+    def entrypoints(self) -> dict[str, Any]:
+        value = self.manifest.get("runtime_entrypoints")
+        return value if isinstance(value, dict) else {}
+
+    @property
+    def capabilities(self) -> frozenset[str]:
+        values = self.entrypoints.get("capabilities") or []
+        return frozenset(str(value) for value in values if value)
+
+    @property
+    def models(self) -> tuple[dict[str, Any], ...]:
+        return tuple(
+            value for value in (self.manifest.get("models") or []) if isinstance(value, dict)
+        )
+
+    @property
+    def efforts(self) -> tuple[str, ...]:
+        return tuple(str(value) for value in (self.manifest.get("efforts") or []) if value)
+
+
+def load_adapter_records(adapters_dir: Path | None = None) -> dict[str, AdapterRecord]:
+    root = adapters_dir or ADAPTERS_DIR
+    records: dict[str, AdapterRecord] = {}
+    if not root.is_dir():
+        return records
+    for manifest_path in sorted(root.glob("*/adapter.yaml")):
+        try:
+            manifest = yaml.safe_load(manifest_path.read_text(encoding="utf-8")) or {}
+        except (OSError, yaml.YAMLError) as exc:
+            logger.debug("adapter manifest skipped %s: %s", manifest_path, exc)
+            continue
+        if not isinstance(manifest, dict):
+            continue
+        adapter_id = str(manifest.get("id") or manifest_path.parent.name).strip().lower()
+        if not adapter_id or adapter_id != manifest_path.parent.name:
+            logger.warning("adapter manifest id/path mismatch: %s", manifest_path)
+            continue
+        records[adapter_id] = AdapterRecord(adapter_id, manifest_path.parent, manifest)
+    return records
+
+
+def configured_adapter_ids(
+    project_root: Path, records: dict[str, AdapterRecord] | None = None
+) -> tuple[str, ...]:
+    known = records or load_adapter_records()
+    config_path = project_root / ".coding-os.yaml"
+    try:
+        config = yaml.safe_load(config_path.read_text(encoding="utf-8")) or {}
+    except (OSError, yaml.YAMLError):
+        config = {}
+    values = config.get("agents") if isinstance(config, dict) else None
+    if not isinstance(values, list):
+        return tuple(known)
+    return tuple(str(value) for value in values if str(value) in known)
+
+
+def entrypoint_path(record: AdapterRecord, capability: str) -> Path | None:
+    filename = record.entrypoints.get(capability)
+    if not isinstance(filename, str) or not filename or Path(filename).name != filename:
+        return None
+    path = record.path / filename
+    return path if path.is_file() else None
+
+
+def load_entrypoint_module(record: AdapterRecord, capability: str) -> ModuleType | None:
+    path = entrypoint_path(record, capability)
+    if path is None:
+        return None
+    module_name = f"coding_os_adapter_{record.id}_{capability}"
+    spec = importlib.util.spec_from_file_location(module_name, path)
+    if spec is None or spec.loader is None:
+        return None
+    module = importlib.util.module_from_spec(spec)
+    try:
+        spec.loader.exec_module(module)
+    except Exception as exc:
+        logger.warning("%s %s entrypoint load failed: %s", record.id, capability, exc)
+        return None
+    return module

{coding_os-0.3.6 → coding_os-0.3.7}/src/core/thinking_os/database.py

@@ -2184,6 +2184,37 @@ def _migrate_v52_derived_outcome_columns(conn: sqlite3.Connection) -> None:
     logger.info("Migration v52 applied: task_outcomes gained derived_outcome columns")
 
 
+def _migrate_v53_adapter_health(conn: sqlite3.Connection) -> None:
+    conn.executescript(
+        """
+CREATE TABLE IF NOT EXISTS adapter_health (
+    adapter_id        TEXT PRIMARY KEY,
+    state             TEXT NOT NULL DEFAULT 'healthy'
+                      CHECK(state IN ('healthy', 'cooling_down', 'half_open')),
+    failure_count     INTEGER NOT NULL DEFAULT 0,
+    cooldown_until    REAL,
+    probe_lease_until REAL,
+    reason            TEXT,
+    updated_at        REAL NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_adapter_health_state_cooldown
+    ON adapter_health(state, cooldown_until);
+"""
+    )
+    for column, sql_type in (
+        ("adapter", "TEXT"),
+        ("effort", "TEXT"),
+        ("error_category", "TEXT"),
+        ("retry_after_s", "INTEGER"),
+        ("health_state", "TEXT"),
+        ("health_probe", "INTEGER NOT NULL DEFAULT 0"),
+    ):
+        if not _column_exists_table(conn, "formula_dispatches", column):
+            conn.execute(f"ALTER TABLE formula_dispatches ADD COLUMN {column} {sql_type}")
+    conn.commit()
+    logger.info("Migration v53 applied: adapter capacity health and dispatch identity")
+
+
 MIGRATIONS: list[tuple[int, str, MigrationAction]] = [
     (
         1,
@@ -2566,6 +2597,11 @@ CREATE TABLE IF NOT EXISTS routing_weights (
         "task_outcomes gains additive derived_outcome + derived_provenance — reward label sourced from the tree-keyed verify ledger, self-report fallback (ADR-0016 stage 1)",
         _migrate_v52_derived_outcome_columns,
     ),
+    (
+        53,
+        "adapter capacity health with persistent cooldown and half-open probe leases",
+        _migrate_v53_adapter_health,
+    ),
 ]
 
 
@@ -2792,6 +2828,7 @@ _TABLES = [
     "graph_evidence_v12",
     "file_index_state",
     "retrieval_router_log",
+    "adapter_health",
 ]