copilot-cli-trace-deck 0.2.0__tar.gz → 0.3.0__tar.gz

{copilot_cli_trace_deck-0.2.0 → copilot_cli_trace_deck-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: copilot-cli-trace-deck
-Version: 0.2.0
+Version: 0.3.0
 Summary: Render GitHub Copilot CLI agent debug logs into a clear, inspectable trace view.
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -34,7 +34,7 @@ Render GitHub Copilot CLI agent debug logs into a clear, inspectable trace view.
 Run the app directly from the workspace with `uv`:
 
 ```bash
-uv run copilot-cli-trace-deck
+uvx copilot-cli-trace-deck@latest
 ```
 
 By default the server listens on `http://127.0.0.1:9887` and opens that URL in your browser.
@@ -46,13 +46,13 @@ The summary view also estimates per-session GitHub AI Credits / USD cost from sh
 You can also pass the session-state source and server options:
 
 ```bash
-uv run copilot-cli-trace-deck ~/.copilot/session-state --host 127.0.0.1 --port 9887
+uvx copilot-cli-trace-deck ~/.copilot/session-state --host 127.0.0.1 --port 9887
 ```
 
 To skip opening a browser while still printing the local URL:
 
 ```bash
-uv run copilot-cli-trace-deck --quiet
+uvx copilot-cli-trace-deck --quiet
 ```
 
 ## Install As A Command

{copilot_cli_trace_deck-0.2.0 → copilot_cli_trace_deck-0.3.0}/README.md

@@ -24,7 +24,7 @@ Render GitHub Copilot CLI agent debug logs into a clear, inspectable trace view.
 Run the app directly from the workspace with `uv`:
 
 ```bash
-uv run copilot-cli-trace-deck
+uvx copilot-cli-trace-deck@latest
 ```
 
 By default the server listens on `http://127.0.0.1:9887` and opens that URL in your browser.
@@ -36,13 +36,13 @@ The summary view also estimates per-session GitHub AI Credits / USD cost from sh
 You can also pass the session-state source and server options:
 
 ```bash
-uv run copilot-cli-trace-deck ~/.copilot/session-state --host 127.0.0.1 --port 9887
+uvx copilot-cli-trace-deck ~/.copilot/session-state --host 127.0.0.1 --port 9887
 ```
 
 To skip opening a browser while still printing the local URL:
 
 ```bash
-uv run copilot-cli-trace-deck --quiet
+uvx copilot-cli-trace-deck --quiet
 ```
 
 ## Install As A Command

{copilot_cli_trace_deck-0.2.0 → copilot_cli_trace_deck-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "copilot-cli-trace-deck"
-version = "0.2.0"
+version = "0.3.0"
 description = "Render GitHub Copilot CLI agent debug logs into a clear, inspectable trace view."
 readme = "README.md"
 requires-python = ">=3.10"

{copilot_cli_trace_deck-0.2.0 → copilot_cli_trace_deck-0.3.0}/src/copilot_cli_trace_deck/data/sessions.py

@@ -18,6 +18,7 @@ class ModelPricing:
 
 
 AI_CREDIT_USD = Decimal("0.01")
+NANO_AIU_PER_AI_CREDIT = Decimal("1000000000")
 TOKENS_PER_MILLION = Decimal("1000000")
 MODEL_PRICING: dict[str, ModelPricing] = {
     "gpt-4.1": ModelPricing(Decimal("2.00"), Decimal("0.50"), Decimal("8.00")),
@@ -98,7 +99,12 @@ def load_session_summary(session_root: Path, session_id: str) -> SessionSummary
     model_name = find_current_model(events, shutdown_event)
     model_usages, billing_stage = extract_model_usages(events, shutdown_event)
     usage = aggregate_usage(model_usages)
-    estimated_cost_usd, estimated_ai_credits, billing_note = build_billing_estimate(model_usages, billing_stage)
+    shutdown_total_nano_aiu = extract_shutdown_total_nano_aiu(events)
+    estimated_cost_usd, estimated_ai_credits, billing_note = build_billing_estimate(
+        model_usages,
+        billing_stage,
+        shutdown_total_nano_aiu=shutdown_total_nano_aiu,
+    )
     created_value = metadata.get("created_at") or first_event_timestamp(events)
     updated_value = last_event_timestamp(events) or metadata.get("updated_at") or created_value
 
@@ -239,6 +245,25 @@ def extract_all_shutdown_model_usages(events: list[dict]) -> list[SessionModelUs
     return merged_model_usages
 
 
+def extract_shutdown_total_nano_aiu(events: list[dict]) -> int | None:
+    total_nano_aiu = 0
+    found_billing = False
+    for event in events:
+        if event.get("type") != "session.shutdown":
+            continue
+
+        raw_total_nano_aiu = event.get("data", {}).get("totalNanoAiu")
+        try:
+            total_nano_aiu += int(raw_total_nano_aiu)
+        except (TypeError, ValueError):
+            continue
+        found_billing = True
+
+    if not found_billing:
+        return None
+    return total_nano_aiu
+
+
 def extract_shutdown_model_usages(shutdown_event: dict | None) -> list[SessionModelUsage]:
     if not shutdown_event:
         return []
@@ -255,7 +280,9 @@ def extract_shutdown_model_usages(shutdown_event: dict | None) -> list[SessionMo
         if not isinstance(usage, dict):
             continue
 
-        model_usage = build_model_usage(model_name, usage)
+        estimated_ai_credits = parse_nano_aiu_as_ai_credits(metrics.get("totalNanoAiu"))
+
+        model_usage = build_model_usage(model_name, usage, estimated_ai_credits=estimated_ai_credits)
         if model_usage is None:
             continue
         model_usages.append(model_usage)
@@ -316,7 +343,12 @@ def extract_live_model_usages_since_last_shutdown(events: list[dict]) -> list[Se
     return extract_live_model_usages(events[last_shutdown_index + 1 :])
 
 
-def build_model_usage(model_name: str, usage: dict[str, object]) -> SessionModelUsage | None:
+def build_model_usage(
+    model_name: str,
+    usage: dict[str, object],
+    *,
+    estimated_ai_credits: Decimal | None = None,
+) -> SessionModelUsage | None:
     if not model_name:
         return None
 
@@ -332,6 +364,8 @@ def build_model_usage(model_name: str, usage: dict[str, object]) -> SessionModel
         cache_write_tokens=cache_write_tokens,
         output_tokens=output_tokens,
     )
+    if estimated_ai_credits is None and estimated_cost_usd is not None:
+        estimated_ai_credits = estimated_cost_usd / AI_CREDIT_USD
 
     return SessionModelUsage(
         model_name=model_name,
@@ -341,11 +375,12 @@ def build_model_usage(model_name: str, usage: dict[str, object]) -> SessionModel
         output_tokens=output_tokens,
         total_tokens=total_tokens,
         estimated_cost_usd=estimated_cost_usd,
+        estimated_ai_credits=estimated_ai_credits,
     )
 
 
 def merge_model_usages(*usage_lists: list[SessionModelUsage]) -> list[SessionModelUsage]:
-    merged_usage: dict[str, dict[str, int]] = {}
+    merged_usage: dict[str, dict[str, object]] = {}
     for usage_list in usage_lists:
         for item in usage_list:
             usage = merged_usage.setdefault(
@@ -355,17 +390,29 @@ def merge_model_usages(*usage_lists: list[SessionModelUsage]) -> list[SessionMod
                     "outputTokens": 0,
                     "cacheReadTokens": 0,
                     "cacheWriteTokens": 0,
+                    "estimatedAiCredits": None,
                 },
             )
             usage["inputTokens"] += item.input_tokens
             usage["outputTokens"] += item.output_tokens
             usage["cacheReadTokens"] += item.cached_input_tokens
             usage["cacheWriteTokens"] += item.cache_write_tokens
+            if item.estimated_ai_credits is not None:
+                current_estimated_ai_credits = usage.get("estimatedAiCredits")
+                if not isinstance(current_estimated_ai_credits, Decimal):
+                    current_estimated_ai_credits = Decimal("0")
+                usage["estimatedAiCredits"] = current_estimated_ai_credits + item.estimated_ai_credits
 
     model_usages = [
         model_usage
         for model_name, usage in merged_usage.items()
-        if (model_usage := build_model_usage(model_name, usage)) is not None
+        if (
+            model_usage := build_model_usage(
+                model_name,
+                usage,
+                estimated_ai_credits=usage.get("estimatedAiCredits") if isinstance(usage.get("estimatedAiCredits"), Decimal) else None,
+            )
+        ) is not None
     ]
     model_usages.sort(key=model_usage_sort_key, reverse=True)
     return model_usages
@@ -380,6 +427,13 @@ def aggregate_usage(model_usages: list[SessionModelUsage]) -> dict[str, int]:
     }
 
 
+def parse_nano_aiu_as_ai_credits(raw_value: object) -> Decimal | None:
+    try:
+        return Decimal(int(raw_value)) / NANO_AIU_PER_AI_CREDIT
+    except (TypeError, ValueError):
+        return None
+
+
 def parse_token_count(raw_value: object) -> int:
     try:
         return int(raw_value or 0)
@@ -407,12 +461,22 @@ def estimate_model_cost(
     ) / TOKENS_PER_MILLION
 
 
-def build_billing_estimate(model_usages: list[SessionModelUsage], billing_stage: str) -> tuple[Decimal | None, Decimal | None, str]:
+def build_billing_estimate(
+    model_usages: list[SessionModelUsage],
+    billing_stage: str,
+    *,
+    shutdown_total_nano_aiu: int | None = None,
+) -> tuple[Decimal | None, Decimal | None, str]:
     if not model_usages:
         if billing_stage == "live":
             return None, None, "Live billing estimate will appear after the first assistant response. Copilot only publishes live output tokens; input and cache token counters refresh on session shutdown."
         return None, None, "Billing estimate appears after session shutdown publishes model metrics."
 
+    if billing_stage == "shutdown" and shutdown_total_nano_aiu is not None:
+        estimated_ai_credits = Decimal(shutdown_total_nano_aiu) / NANO_AIU_PER_AI_CREDIT
+        estimated_cost_usd = estimated_ai_credits * AI_CREDIT_USD
+        return estimated_cost_usd, estimated_ai_credits, "Estimate uses Copilot session shutdown billing fields."
+
     missing_pricing = [item.model_name for item in model_usages if item.total_tokens and item.estimated_cost_usd is None]
     known_costs = [item.estimated_cost_usd for item in model_usages if item.estimated_cost_usd is not None]
     if not known_costs and missing_pricing:

{copilot_cli_trace_deck-0.2.0 → copilot_cli_trace_deck-0.3.0}/src/copilot_cli_trace_deck/models.py

@@ -52,6 +52,7 @@ class SessionModelUsage:
     output_tokens: int
     total_tokens: int
     estimated_cost_usd: Decimal | None
+    estimated_ai_credits: Decimal | None
 
 
 @dataclass(frozen=True)

{copilot_cli_trace_deck-0.2.0 → copilot_cli_trace_deck-0.3.0}/src/copilot_cli_trace_deck/web/pages.py

@@ -771,7 +771,6 @@ def build_session_page(summary: SessionSummary) -> str:
               {render_stat_card(stat_labels['totalCacheWriteLabel'], summary.total_cache_write_tokens, value_id='session-total-cache-write-value', label_id='session-total-cache-write-label')}
               {render_stat_card('Total Tokens', summary.total_tokens, value_id='session-total-tokens-value')}
               {render_stat_card('Estimated AI Credits', format_ai_credits(summary.estimated_ai_credits), value_id='session-estimated-ai-credits-value')}
-              {render_stat_card('Estimated Cost (USD)', format_currency(summary.estimated_cost_usd), value_id='session-estimated-cost-usd-value')}
               {render_stat_card('Errors', summary.error_count, value_id='session-error-count-value')}
             </div>
             <p class="billing-note" id="session-billing-note">{html.escape(summary.billing_note)}</p>
@@ -843,7 +842,6 @@ def build_session_page(summary: SessionSummary) -> str:
               setText('session-total-cache-write-value', summary.totalCacheWriteTokens || '0');
               setText('session-total-tokens-value', summary.totalTokens || '0');
               setText('session-estimated-ai-credits-value', summary.estimatedAiCredits || '-');
-              setText('session-estimated-cost-usd-value', summary.estimatedCostUsd || '-');
               setText('session-error-count-value', summary.errorCount || '0');
               setText('session-billing-note', summary.billingNote || '');
               setHTML('session-model-usage-breakdown', summary.modelUsageBreakdownHtml || '');
@@ -2400,7 +2398,6 @@ def build_session_snapshot_payload(summary: SessionSummary) -> dict[str, str]:
     "totalCacheWriteTokens": format_number(summary.total_cache_write_tokens),
     "totalTokens": format_number(summary.total_tokens),
     "estimatedAiCredits": format_ai_credits(summary.estimated_ai_credits),
-    "estimatedCostUsd": format_currency(summary.estimated_cost_usd),
     "billingNote": summary.billing_note,
     "modelUsageBreakdownHtml": render_model_usage_breakdown(summary),
     "errorCount": format_number(summary.error_count),
@@ -2505,16 +2502,10 @@ def format_stat_value(value: int | str) -> str:
     return format_number(value) if isinstance(value, int) else value
 
 
-def format_currency(value: Decimal | None) -> str:
-    if value is None:
-        return "-"
-    return f"${value.quantize(Decimal('0.000001')):,.6f}".rstrip("0").rstrip(".")
-
-
 def format_ai_credits(value: Decimal | None) -> str:
-    if value is None:
-        return "-"
-    return f"{value.quantize(Decimal('0.0001')):,.4f}".rstrip("0").rstrip(".")
+  if value is None:
+    return "-"
+  return f"{value.quantize(Decimal('0.01')):,.2f}".rstrip("0").rstrip(".")
 
 
 def render_model_usage_breakdown(summary: SessionSummary) -> str:
@@ -2530,7 +2521,7 @@ def render_model_usage_breakdown(summary: SessionSummary) -> str:
                     <td>{format_number(item.cache_write_tokens)}</td>
                     <td>{format_number(item.output_tokens)}</td>
                     <td>{format_number(item.total_tokens)}</td>
-                    <td>{html.escape(format_currency(item.estimated_cost_usd))}</td>
+                    <td>{html.escape(format_ai_credits(item.estimated_ai_credits))}</td>
                   </tr>"""
         for item in summary.model_usages
     )
@@ -2546,7 +2537,7 @@ def render_model_usage_breakdown(summary: SessionSummary) -> str:
                       <th>Cache Write</th>
                       <th>Output</th>
                       <th>Total</th>
-                      <th>Est. USD</th>
+                      <th>AIC</th>
                     </tr>
                   </thead>
                   <tbody>

{copilot_cli_trace_deck-0.2.0 → copilot_cli_trace_deck-0.3.0}/src/copilot_cli_trace_deck.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: copilot-cli-trace-deck
-Version: 0.2.0
+Version: 0.3.0
 Summary: Render GitHub Copilot CLI agent debug logs into a clear, inspectable trace view.
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -34,7 +34,7 @@ Render GitHub Copilot CLI agent debug logs into a clear, inspectable trace view.
 Run the app directly from the workspace with `uv`:
 
 ```bash
-uv run copilot-cli-trace-deck
+uvx copilot-cli-trace-deck@latest
 ```
 
 By default the server listens on `http://127.0.0.1:9887` and opens that URL in your browser.
@@ -46,13 +46,13 @@ The summary view also estimates per-session GitHub AI Credits / USD cost from sh
 You can also pass the session-state source and server options:
 
 ```bash
-uv run copilot-cli-trace-deck ~/.copilot/session-state --host 127.0.0.1 --port 9887
+uvx copilot-cli-trace-deck ~/.copilot/session-state --host 127.0.0.1 --port 9887
 ```
 
 To skip opening a browser while still printing the local URL:
 
 ```bash
-uv run copilot-cli-trace-deck --quiet
+uvx copilot-cli-trace-deck --quiet
 ```
 
 ## Install As A Command