cc-transcript 3.2.0__tar.gz → 3.3.0__tar.gz

{cc_transcript-3.2.0 → cc_transcript-3.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cc-transcript
-Version: 3.2.0
+Version: 3.3.0
 Classifier: Development Status :: 3 - Alpha
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers

{cc_transcript-3.2.0 → cc_transcript-3.3.0}/cc_transcript/__init__.py

@@ -60,7 +60,9 @@ EXPORTS: dict[str, str] = {
             "CcVersion",
             "ContentBlock",
             "EntryMeta",
+            "FallbackBlock",
             "ModeEvent",
+            "OtherBlock",
             "OtherEvent",
             "SystemEvent",
             "TextBlock",
@@ -426,9 +428,15 @@ if TYPE_CHECKING:
     from cc_transcript.models import (
         EntryMeta as EntryMeta,
     )
+    from cc_transcript.models import (
+        FallbackBlock as FallbackBlock,
+    )
     from cc_transcript.models import (
         ModeEvent as ModeEvent,
     )
+    from cc_transcript.models import (
+        OtherBlock as OtherBlock,
+    )
     from cc_transcript.models import (
         OtherEvent as OtherEvent,
     )

{cc_transcript-3.2.0 → cc_transcript-3.3.0}/cc_transcript/models.py

@@ -83,7 +83,39 @@ class ToolResultBlock:
     is_async: bool = False
 
 
-ContentBlock = TextBlock | ThinkingBlock | ToolUseBlock | ToolResultBlock
+@dataclass(frozen=True, slots=True)
+class FallbackBlock:
+    """A marker that the assistant turn fell back from one model to another.
+
+    Claude Code records this when a turn switches models mid-stream; it carries
+    no message content, only the two model names.
+
+    Attributes:
+        from_model: The model the turn started on.
+        to_model: The model the turn fell back to.
+    """
+
+    from_model: str
+    to_model: str
+
+
+@dataclass(frozen=True, slots=True)
+class OtherBlock:
+    """Any assistant content block whose ``type`` is not yet modeled.
+
+    The escape hatch that keeps an unrecognized block from crashing the parser
+    as Claude Code's transcript format evolves, mirroring :class:`OtherEvent`.
+
+    Attributes:
+        type: The block's ``type`` field.
+        raw: The block's full decoded payload.
+    """
+
+    type: str
+    raw: Mapping[str, Any]
+
+
+ContentBlock = TextBlock | ThinkingBlock | ToolUseBlock | ToolResultBlock | FallbackBlock | OtherBlock
 
 
 @dataclass(frozen=True, slots=True)

{cc_transcript-3.2.0 → cc_transcript-3.3.0}/cc_transcript/parser.py

@@ -18,7 +18,9 @@ from cc_transcript.models import (
     ContentBlock,
     EntryMeta,
     EventUuid,
+    FallbackBlock,
     ModeEvent,
+    OtherBlock,
     OtherEvent,
     SessionId,
     SystemEvent,
@@ -102,8 +104,10 @@ def parse_assistant_block(block: dict[str, Any]) -> ContentBlock:
             return ThinkingBlock(block["thinking"])
         case "tool_use":
             return ToolUseBlock(id=ToolUseId(block["id"]), name=block["name"], input=block["input"])
+        case "fallback":
+            return FallbackBlock(from_model=block["from"]["model"], to_model=block["to"]["model"])
         case unknown:
-            raise ValueError(f"unexpected assistant block type: {unknown}")
+            return OtherBlock(type=unknown, raw=block)
 
 
 def parse_event(data: Mapping[str, Any]) -> TranscriptEvent | None:

{cc_transcript-3.2.0 → cc_transcript-3.3.0}/cc_transcript/render.py

@@ -13,7 +13,9 @@ import orjson
 from cc_transcript.filterspec import event_kind, event_meta, event_text, tool_uses
 from cc_transcript.models import (
     AssistantEvent,
+    FallbackBlock,
     ModeEvent,
+    OtherBlock,
     OtherEvent,
     SystemEvent,
     TextBlock,
@@ -230,6 +232,10 @@ def block_payload(block: ContentBlock, *, width: int, thinking: bool) -> str:
             )
         case ToolResultBlock():
             return ""
+        case FallbackBlock(from_model=src, to_model=dst):
+            return f"fallback {src}->{dst}"
+        case OtherBlock(type=type_):
+            return type_
 
 
 def line_budget(width: int) -> Budget:

{cc_transcript-3.2.0 → cc_transcript-3.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cc-transcript"
-version = "3.2.0"
+version = "3.3.0"
 description = "The Claude Code session-activity platform: a superset JSONL parser (Rust fast path, Python reference), typed tool calls with a cross-language content digest, turns/edits/evidence over one spine, context windows with labeled fidelity, unified decision and correction ledgers, LLM judging, and a transcript-investigation CLI."
 readme = "README.md"
 license = "PolyForm-Noncommercial-1.0.0"

{cc_transcript-3.2.0 → cc_transcript-3.3.0}/rust/src/event.rs

@@ -6,9 +6,9 @@ use pyo3::IntoPyObjectExt;
 use sonic_rs::{JsonContainerTrait, JsonType, JsonValueTrait, Value};
 
 use crate::model::{
-    models_type, ASSISTANT_EVENT_CLS, ENTRY_META_CLS, MODE_EVENT_CLS, OTHER_EVENT_CLS,
-    SYSTEM_EVENT_CLS, TEXT_BLOCK_CLS, THINKING_BLOCK_CLS, TOOL_RESULT_BLOCK_CLS,
-    TOOL_USE_BLOCK_CLS, USER_EVENT_CLS,
+    models_type, ASSISTANT_EVENT_CLS, ENTRY_META_CLS, FALLBACK_BLOCK_CLS, MODE_EVENT_CLS,
+    OTHER_BLOCK_CLS, OTHER_EVENT_CLS, SYSTEM_EVENT_CLS, TEXT_BLOCK_CLS, THINKING_BLOCK_CLS,
+    TOOL_RESULT_BLOCK_CLS, TOOL_USE_BLOCK_CLS, USER_EVENT_CLS,
 };
 use crate::value::{block_type, field, field_bool, field_str};
 
@@ -148,10 +148,14 @@ fn parse_assistant_block<'py>(py: Python<'py>, block: &Value) -> PyResult<Bound<
             require_str(block, "name")?,
             json_to_py(py, require(block, "input")?)?,
         )),
-        other => Err(PyValueError::new_err(format!(
-            "unexpected assistant block type: {}",
-            other.unwrap_or("None")
-        ))),
+        Some("fallback") => models_type(py, &FALLBACK_BLOCK_CLS, "FallbackBlock")?.call1((
+            require_str(require(block, "from")?, "model")?,
+            require_str(require(block, "to")?, "model")?,
+        )),
+        Some(other) => {
+            models_type(py, &OTHER_BLOCK_CLS, "OtherBlock")?.call1((other, json_to_py(py, block)?))
+        }
+        None => Err(PyKeyError::new_err("'type'")),
     }
 }
 

{cc_transcript-3.2.0 → cc_transcript-3.3.0}/rust/src/model.rs

@@ -12,6 +12,8 @@ pub static TEXT_BLOCK_CLS: PyOnceLock<Py<PyType>> = PyOnceLock::new();
 pub static THINKING_BLOCK_CLS: PyOnceLock<Py<PyType>> = PyOnceLock::new();
 pub static TOOL_USE_BLOCK_CLS: PyOnceLock<Py<PyType>> = PyOnceLock::new();
 pub static TOOL_RESULT_BLOCK_CLS: PyOnceLock<Py<PyType>> = PyOnceLock::new();
+pub static FALLBACK_BLOCK_CLS: PyOnceLock<Py<PyType>> = PyOnceLock::new();
+pub static OTHER_BLOCK_CLS: PyOnceLock<Py<PyType>> = PyOnceLock::new();
 
 pub fn models_type<'py>(
     py: Python<'py>,