shotgun-sh 0.2.1.dev1__py3-none-any.whl → 0.2.1.dev2__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of shotgun-sh might be problematic. Click here for more details.

@@ -115,12 +115,12 @@ class AgentManager(Widget):
115
115
  super().__init__()
116
116
  self.display = False
117
117
 
118
+ if deps is None:
119
+ raise ValueError("AgentDeps must be provided to AgentManager")
120
+
118
121
  # Use provided deps or create default with interactive mode
119
122
  self.deps = deps
120
123
 
121
- if self.deps is None:
122
- raise ValueError("AgentDeps must be provided to AgentManager")
123
-
124
124
  # Create AgentRuntimeOptions from deps for agent creation
125
125
  agent_runtime_options = AgentRuntimeOptions(
126
126
  interactive_mode=self.deps.interactive_mode,
@@ -269,6 +269,7 @@ class AgentManager(Widget):
269
269
  Returns:
270
270
  The agent run result.
271
271
  """
272
+ logger.info(f"Running agent {self._current_agent_type.value}")
272
273
  # Use merged deps (shared state + agent-specific system prompt) if not provided
273
274
  if deps is None:
274
275
  deps = self._create_merged_deps(self._current_agent_type)
@@ -395,6 +396,10 @@ class AgentManager(Widget):
395
396
  # Apply compaction to persistent message history to prevent cascading growth
396
397
  all_messages = result.all_messages()
397
398
  self.message_history = await apply_persistent_compaction(all_messages, deps)
399
+ usage = result.usage()
400
+ deps.usage_manager.add_usage(
401
+ usage, model_name=deps.llm_model.name, provider=deps.llm_model.provider
402
+ )
398
403
 
399
404
  # Log file operations summary if any files were modified
400
405
  file_operations = deps.file_tracker.operations.copy()
@@ -641,6 +646,9 @@ class AgentManager(Widget):
641
646
  filtered_messages.append(msg)
642
647
  return filtered_messages
643
648
 
649
+ def get_usage_hint(self) -> str | None:
650
+ return self.deps.usage_manager.build_usage_hint()
651
+
644
652
  def get_conversation_state(self) -> "ConversationState":
645
653
  """Get the current conversation state.
646
654
 
@@ -1,7 +1,6 @@
1
1
  """Configuration manager for Shotgun CLI."""
2
2
 
3
3
  import json
4
- import os
5
4
  import uuid
6
5
  from pathlib import Path
7
6
  from typing import Any
@@ -12,10 +11,7 @@ from shotgun.logging_config import get_logger
12
11
  from shotgun.utils import get_shotgun_home
13
12
 
14
13
  from .constants import (
15
- ANTHROPIC_API_KEY_ENV,
16
14
  API_KEY_FIELD,
17
- GEMINI_API_KEY_ENV,
18
- OPENAI_API_KEY_ENV,
19
15
  ConfigSection,
20
16
  )
21
17
  from .models import (
@@ -245,25 +241,13 @@ class ConfigManager:
245
241
  def has_provider_key(self, provider: ProviderType | str) -> bool:
246
242
  """Check if the given provider has a non-empty API key configured.
247
243
 
248
- This checks both the configuration file and environment variables.
244
+ This checks only the configuration file.
249
245
  """
250
246
  config = self.load()
251
247
  provider_enum = self._ensure_provider_enum(provider)
252
248
  provider_config = self._get_provider_config(config, provider_enum)
253
249
 
254
- # Check config first
255
- if self._provider_has_api_key(provider_config):
256
- return True
257
-
258
- # Check environment variable
259
- if provider_enum == ProviderType.OPENAI:
260
- return bool(os.getenv(OPENAI_API_KEY_ENV))
261
- elif provider_enum == ProviderType.ANTHROPIC:
262
- return bool(os.getenv(ANTHROPIC_API_KEY_ENV))
263
- elif provider_enum == ProviderType.GOOGLE:
264
- return bool(os.getenv(GEMINI_API_KEY_ENV))
265
-
266
- return False
250
+ return self._provider_has_api_key(provider_config)
267
251
 
268
252
  def has_any_provider_key(self) -> bool:
269
253
  """Determine whether any provider has a configured API key."""
@@ -27,6 +27,7 @@ class ModelName(StrEnum):
27
27
  GPT_5 = "gpt-5"
28
28
  GPT_5_MINI = "gpt-5-mini"
29
29
  CLAUDE_OPUS_4_1 = "claude-opus-4-1"
30
+ CLAUDE_SONNET_4_5 = "claude-sonnet-4-5"
30
31
  GEMINI_2_5_PRO = "gemini-2.5-pro"
31
32
  GEMINI_2_5_FLASH = "gemini-2.5-flash"
32
33
 
@@ -102,6 +103,13 @@ MODEL_SPECS: dict[ModelName, ModelSpec] = {
102
103
  max_output_tokens=32_000,
103
104
  litellm_proxy_model_name="anthropic/claude-opus-4-1",
104
105
  ),
106
+ ModelName.CLAUDE_SONNET_4_5: ModelSpec(
107
+ name=ModelName.CLAUDE_SONNET_4_5,
108
+ provider=ProviderType.ANTHROPIC,
109
+ max_input_tokens=200_000,
110
+ max_output_tokens=16_000,
111
+ litellm_proxy_model_name="anthropic/claude-sonnet-4-5",
112
+ ),
105
113
  ModelName.GEMINI_2_5_PRO: ModelSpec(
106
114
  name=ModelName.GEMINI_2_5_PRO,
107
115
  provider=ProviderType.GOOGLE,
@@ -1,7 +1,5 @@
1
1
  """Provider management for LLM configuration."""
2
2
 
3
- import os
4
-
5
3
  from pydantic import SecretStr
6
4
  from pydantic_ai.models import Model
7
5
  from pydantic_ai.models.anthropic import AnthropicModel, AnthropicModelSettings
@@ -15,12 +13,6 @@ from pydantic_ai.settings import ModelSettings
15
13
  from shotgun.llm_proxy import create_litellm_provider
16
14
  from shotgun.logging_config import get_logger
17
15
 
18
- from .constants import (
19
- ANTHROPIC_API_KEY_ENV,
20
- GEMINI_API_KEY_ENV,
21
- OPENAI_API_KEY_ENV,
22
- SHOTGUN_API_KEY_ENV,
23
- )
24
16
  from .manager import get_config_manager
25
17
  from .models import (
26
18
  MODEL_SPECS,
@@ -150,10 +142,10 @@ def get_provider_model(
150
142
  config = config_manager.load()
151
143
 
152
144
  # Priority 1: Check if Shotgun key exists - if so, use it for ANY model
153
- shotgun_api_key = _get_api_key(config.shotgun.api_key, SHOTGUN_API_KEY_ENV)
145
+ shotgun_api_key = _get_api_key(config.shotgun.api_key)
154
146
  if shotgun_api_key:
155
- # Use selected model or default to claude-opus-4-1
156
- model_name = config.selected_model or ModelName.CLAUDE_OPUS_4_1
147
+ # Use selected model or default to claude-sonnet-4-5
148
+ model_name = config.selected_model or ModelName.CLAUDE_SONNET_4_5
157
149
  if model_name not in MODEL_SPECS:
158
150
  raise ValueError(f"Model '{model_name.value}' not found")
159
151
  spec = MODEL_SPECS[model_name]
@@ -202,11 +194,9 @@ def get_provider_model(
202
194
  requested_model = None # Will use provider's default model
203
195
 
204
196
  if provider_enum == ProviderType.OPENAI:
205
- api_key = _get_api_key(config.openai.api_key, OPENAI_API_KEY_ENV)
197
+ api_key = _get_api_key(config.openai.api_key)
206
198
  if not api_key:
207
- raise ValueError(
208
- f"OpenAI API key not configured. Set via environment variable {OPENAI_API_KEY_ENV} or config."
209
- )
199
+ raise ValueError("OpenAI API key not configured. Set via config.")
210
200
 
211
201
  # Use requested model or default to gpt-5
212
202
  model_name = requested_model if requested_model else ModelName.GPT_5
@@ -225,11 +215,9 @@ def get_provider_model(
225
215
  )
226
216
 
227
217
  elif provider_enum == ProviderType.ANTHROPIC:
228
- api_key = _get_api_key(config.anthropic.api_key, ANTHROPIC_API_KEY_ENV)
218
+ api_key = _get_api_key(config.anthropic.api_key)
229
219
  if not api_key:
230
- raise ValueError(
231
- f"Anthropic API key not configured. Set via environment variable {ANTHROPIC_API_KEY_ENV} or config."
232
- )
220
+ raise ValueError("Anthropic API key not configured. Set via config.")
233
221
 
234
222
  # Use requested model or default to claude-opus-4-1
235
223
  model_name = requested_model if requested_model else ModelName.CLAUDE_OPUS_4_1
@@ -248,11 +236,9 @@ def get_provider_model(
248
236
  )
249
237
 
250
238
  elif provider_enum == ProviderType.GOOGLE:
251
- api_key = _get_api_key(config.google.api_key, GEMINI_API_KEY_ENV)
239
+ api_key = _get_api_key(config.google.api_key)
252
240
  if not api_key:
253
- raise ValueError(
254
- f"Gemini API key not configured. Set via environment variable {GEMINI_API_KEY_ENV} or config."
255
- )
241
+ raise ValueError("Gemini API key not configured. Set via config.")
256
242
 
257
243
  # Use requested model or default to gemini-2.5-pro
258
244
  model_name = requested_model if requested_model else ModelName.GEMINI_2_5_PRO
@@ -285,20 +271,19 @@ def _has_provider_key(config: "ShotgunConfig", provider: ProviderType) -> bool:
285
271
  True if provider has a configured API key
286
272
  """
287
273
  if provider == ProviderType.OPENAI:
288
- return bool(_get_api_key(config.openai.api_key, OPENAI_API_KEY_ENV))
274
+ return bool(_get_api_key(config.openai.api_key))
289
275
  elif provider == ProviderType.ANTHROPIC:
290
- return bool(_get_api_key(config.anthropic.api_key, ANTHROPIC_API_KEY_ENV))
276
+ return bool(_get_api_key(config.anthropic.api_key))
291
277
  elif provider == ProviderType.GOOGLE:
292
- return bool(_get_api_key(config.google.api_key, GEMINI_API_KEY_ENV))
278
+ return bool(_get_api_key(config.google.api_key))
293
279
  return False
294
280
 
295
281
 
296
- def _get_api_key(config_key: SecretStr | None, env_var: str) -> str | None:
297
- """Get API key from config or environment variable.
282
+ def _get_api_key(config_key: SecretStr | None) -> str | None:
283
+ """Get API key from config.
298
284
 
299
285
  Args:
300
286
  config_key: API key from configuration
301
- env_var: Environment variable name to check
302
287
 
303
288
  Returns:
304
289
  API key string or None
@@ -306,4 +291,4 @@ def _get_api_key(config_key: SecretStr | None, env_var: str) -> str | None:
306
291
  if config_key is not None:
307
292
  return config_key.get_secret_value()
308
293
 
309
- return os.getenv(env_var)
294
+ return None
shotgun/agents/models.py CHANGED
@@ -11,6 +11,8 @@ from typing import TYPE_CHECKING
11
11
  from pydantic import BaseModel, ConfigDict, Field
12
12
  from pydantic_ai import RunContext
13
13
 
14
+ from shotgun.agents.usage_manager import SessionUsageManager, get_session_usage_manager
15
+
14
16
  from .config.models import ModelConfig
15
17
 
16
18
  if TYPE_CHECKING:
@@ -108,6 +110,11 @@ class AgentRuntimeOptions(BaseModel):
108
110
  description="Tasks for storing deferred tool results",
109
111
  )
110
112
 
113
+ usage_manager: SessionUsageManager = Field(
114
+ default_factory=get_session_usage_manager,
115
+ description="Usage manager for tracking usage",
116
+ )
117
+
111
118
 
112
119
  class FileOperationType(StrEnum):
113
120
  """Types of file operations that can be tracked."""
@@ -94,7 +94,6 @@ async def anthropic_web_search_tool(query: str) -> str:
94
94
 
95
95
  async def main() -> None:
96
96
  """Main function for testing the Anthropic web search tool."""
97
- import os
98
97
  import sys
99
98
 
100
99
  from shotgun.logging_config import setup_logger
@@ -119,15 +118,14 @@ async def main() -> None:
119
118
  print("=" * 60)
120
119
 
121
120
  # Check if API key is available
122
- if not (
123
- os.getenv("ANTHROPIC_API_KEY")
124
- or (
125
- callable(get_provider_model)
126
- and get_provider_model(ProviderType.ANTHROPIC).api_key
127
- )
128
- ):
129
- print(" Error: ANTHROPIC_API_KEY environment variable not set")
130
- print(" Please set it with: export ANTHROPIC_API_KEY=your_key_here")
121
+ try:
122
+ if callable(get_provider_model):
123
+ model_config = get_provider_model(ProviderType.ANTHROPIC)
124
+ if not model_config.api_key:
125
+ raise ValueError("No API key configured")
126
+ except (ValueError, Exception):
127
+ print("❌ Error: Anthropic API key not configured")
128
+ print(" Please set it in your config file")
131
129
  sys.exit(1)
132
130
 
133
131
  try:
@@ -0,0 +1,159 @@
1
+ import json
2
+ from collections import defaultdict
3
+ from dataclasses import dataclass
4
+ from datetime import datetime
5
+ from logging import getLogger
6
+ from pathlib import Path
7
+ from typing import TypeAlias
8
+
9
+ from genai_prices import calc_price
10
+ from pydantic import BaseModel, Field
11
+ from pydantic_ai import RunUsage
12
+
13
+ from shotgun.agents.config.models import ProviderType
14
+ from shotgun.utils import get_shotgun_home
15
+
16
+ logger = getLogger(__name__)
17
+ ModelName: TypeAlias = str
18
+
19
+
20
+ @dataclass(frozen=True)
21
+ class UsageSummaryEntry:
22
+ model_name: ModelName
23
+ provider: ProviderType
24
+ usage: RunUsage
25
+
26
+
27
+ class UsageLogEntry(BaseModel):
28
+ timestamp: datetime = Field(default_factory=datetime.now)
29
+ model_name: ModelName
30
+ usage: RunUsage
31
+ provider: ProviderType
32
+
33
+
34
+ class SessionUsage(BaseModel):
35
+ usage: RunUsage
36
+ log: list[UsageLogEntry]
37
+
38
+
39
+ class UsageState(BaseModel):
40
+ usage: dict[ModelName, RunUsage] = Field(default_factory=dict)
41
+ model_providers: dict[ModelName, ProviderType] = Field(default_factory=dict)
42
+ usage_log: list[UsageLogEntry] = Field(default_factory=list)
43
+
44
+
45
+ class SessionUsageManager:
46
+ def __init__(self) -> None:
47
+ self.usage: defaultdict[ModelName, RunUsage] = defaultdict(RunUsage)
48
+ self._model_providers: dict[ModelName, ProviderType] = {}
49
+ self._usage_log: list[UsageLogEntry] = []
50
+ self._usage_path: Path = get_shotgun_home() / "usage.json"
51
+ self.restore_usage_state()
52
+
53
+ def add_usage(
54
+ self, usage: RunUsage, *, model_name: ModelName, provider: ProviderType
55
+ ) -> None:
56
+ self.usage[model_name] += usage
57
+ self._model_providers[model_name] = provider
58
+ self._usage_log.append(
59
+ UsageLogEntry(model_name=model_name, usage=usage, provider=provider)
60
+ )
61
+ self.persist_usage_state()
62
+
63
+ def get_usage_report(self) -> dict[ModelName, RunUsage]:
64
+ return self.usage.copy()
65
+
66
+ def get_usage_breakdown(self) -> list[UsageSummaryEntry]:
67
+ breakdown: list[UsageSummaryEntry] = []
68
+ for model_name, usage in self.usage.items():
69
+ provider = self._model_providers.get(model_name)
70
+ if provider is None:
71
+ continue
72
+ breakdown.append(
73
+ UsageSummaryEntry(model_name=model_name, provider=provider, usage=usage)
74
+ )
75
+ breakdown.sort(key=lambda entry: entry.model_name.lower())
76
+ return breakdown
77
+
78
+ def build_usage_hint(self) -> str | None:
79
+ return format_usage_hint(self.get_usage_breakdown())
80
+
81
+ def persist_usage_state(self) -> None:
82
+ state = UsageState(
83
+ usage=dict(self.usage.items()),
84
+ model_providers=self._model_providers.copy(),
85
+ usage_log=self._usage_log.copy(),
86
+ )
87
+
88
+ try:
89
+ self._usage_path.parent.mkdir(parents=True, exist_ok=True)
90
+ with self._usage_path.open("w", encoding="utf-8") as f:
91
+ json.dump(state.model_dump(mode="json"), f, indent=2)
92
+ logger.debug("Usage state persisted to %s", self._usage_path)
93
+ except Exception as exc:
94
+ logger.error(
95
+ "Failed to persist usage state to %s: %s", self._usage_path, exc
96
+ )
97
+
98
+ def restore_usage_state(self) -> None:
99
+ if not self._usage_path.exists():
100
+ logger.debug("No usage state file found at %s", self._usage_path)
101
+ return
102
+
103
+ try:
104
+ with self._usage_path.open(encoding="utf-8") as f:
105
+ data = json.load(f)
106
+
107
+ state = UsageState.model_validate(data)
108
+ except Exception as exc:
109
+ logger.error(
110
+ "Failed to restore usage state from %s: %s", self._usage_path, exc
111
+ )
112
+ return
113
+
114
+ self.usage = defaultdict(RunUsage)
115
+ for model_name, usage in state.usage.items():
116
+ self.usage[model_name] = usage
117
+
118
+ self._model_providers = state.model_providers.copy()
119
+ self._usage_log = state.usage_log.copy()
120
+
121
+
122
+ def format_usage_hint(breakdown: list[UsageSummaryEntry]) -> str | None:
123
+ if not breakdown:
124
+ return None
125
+
126
+ lines = ["# Token usage by model"]
127
+
128
+ for entry in breakdown:
129
+ usage = entry.usage
130
+ input_tokens = usage.input_tokens
131
+ output_tokens = usage.output_tokens
132
+ cached_tokens = usage.cache_read_tokens
133
+
134
+ cost = calc_price(usage=usage, model_ref=entry.model_name)
135
+ input_line = f"* Input: {input_tokens:,}"
136
+ if cached_tokens > 0:
137
+ input_line += f" (+ {cached_tokens:,} cached)"
138
+ input_line += " tokens"
139
+ section = f"""
140
+ ### {entry.model_name}
141
+
142
+ {input_line}
143
+ * Output: {output_tokens:,} tokens
144
+ * Total: {input_tokens + output_tokens:,} tokens
145
+ * Cost: ${cost.total_price:,.2f}
146
+ """.strip()
147
+ lines.append(section)
148
+
149
+ return "\n\n".join(lines)
150
+
151
+
152
+ _usage_manager = None
153
+
154
+
155
+ def get_session_usage_manager() -> SessionUsageManager:
156
+ global _usage_manager
157
+ if _usage_manager is None:
158
+ _usage_manager = SessionUsageManager()
159
+ return _usage_manager
shotgun/cli/feedback.py CHANGED
@@ -43,4 +43,4 @@ def send_feedback(
43
43
 
44
44
  submit_feedback_survey(feedback)
45
45
 
46
- console.print("Feedback sent. Thank you!")
46
+ console.print("Feedback sent. Thank you!")
shotgun/tui/app.py CHANGED
@@ -108,7 +108,7 @@ class ShotgunApp(App[None]):
108
108
  def handle_feedback(feedback: Feedback | None) -> None:
109
109
  if feedback is not None:
110
110
  submit_feedback_survey(feedback)
111
- self.notify("Feedback sent. Thank you!")
111
+ self.notify("Feedback sent. Thank you!")
112
112
 
113
113
  self.push_screen("feedback", callback=handle_feedback)
114
114
 
@@ -58,6 +58,7 @@ from .chat_screen.command_providers import (
58
58
  CodebaseCommandProvider,
59
59
  DeleteCodebasePaletteProvider,
60
60
  ProviderSetupProvider,
61
+ UsageProvider,
61
62
  )
62
63
 
63
64
  logger = logging.getLogger(__name__)
@@ -228,9 +229,15 @@ class ChatScreen(Screen[None]):
228
229
  BINDINGS = [
229
230
  ("ctrl+p", "command_palette", "Command Palette"),
230
231
  ("shift+tab", "toggle_mode", "Toggle mode"),
232
+ ("ctrl+u", "show_usage", "Show usage"),
231
233
  ]
232
234
 
233
- COMMANDS = {AgentModeProvider, ProviderSetupProvider, CodebaseCommandProvider}
235
+ COMMANDS = {
236
+ AgentModeProvider,
237
+ ProviderSetupProvider,
238
+ CodebaseCommandProvider,
239
+ UsageProvider,
240
+ }
234
241
 
235
242
  value = reactive("")
236
243
  mode = reactive(AgentType.RESEARCH)
@@ -401,6 +408,14 @@ class ChatScreen(Screen[None]):
401
408
  # whoops it actually changes focus. Let's be brutal for now
402
409
  self.call_later(lambda: self.query_one(PromptInput).focus())
403
410
 
411
+ def action_show_usage(self) -> None:
412
+ usage_hint = self.agent_manager.get_usage_hint()
413
+ logger.info(f"Usage hint: {usage_hint}")
414
+ if usage_hint:
415
+ self.mount_hint(usage_hint)
416
+ else:
417
+ self.notify("No usage hint available", severity="error")
418
+
404
419
  @work
405
420
  async def add_question_listener(self) -> None:
406
421
  while True:
@@ -589,7 +604,7 @@ class ChatScreen(Screen[None]):
589
604
  async def index_codebase(self, selection: CodebaseIndexSelection) -> None:
590
605
  label = self.query_one("#indexing-job-display", Static)
591
606
  label.update(
592
- f"[$foreground-muted]Indexing [bold $text-accent]{selection.name}[/]...[/]"
607
+ f"[$foreground-muted]Indexing codebase: [bold $text-accent]{selection.name}[/][/]"
593
608
  )
594
609
  label.refresh()
595
610
 
@@ -599,33 +614,33 @@ class ChatScreen(Screen[None]):
599
614
  empty = width - filled
600
615
  return "▓" * filled + "░" * empty
601
616
 
602
- # Spinner animation state (shared between timer and progress callback)
617
+ # Spinner animation frames
603
618
  spinner_frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]
604
- spinner_state: dict[str, int | str | float] = {
619
+
620
+ # Progress state (shared between timer and progress callback)
621
+ progress_state: dict[str, int | float] = {
605
622
  "frame_index": 0,
606
- "phase_name": "Starting...",
607
623
  "percentage": 0.0,
608
624
  }
609
625
 
610
- def update_spinner_display() -> None:
611
- """Update spinner frame on timer - runs every 100ms."""
626
+ def update_progress_display() -> None:
627
+ """Update progress bar on timer - runs every 100ms."""
612
628
  # Advance spinner frame
613
- frame_idx = int(spinner_state["frame_index"])
614
- spinner_state["frame_index"] = (frame_idx + 1) % len(spinner_frames)
629
+ frame_idx = int(progress_state["frame_index"])
630
+ progress_state["frame_index"] = (frame_idx + 1) % len(spinner_frames)
615
631
  spinner = spinner_frames[frame_idx]
616
632
 
617
633
  # Get current state
618
- phase = str(spinner_state["phase_name"])
619
- pct = float(spinner_state["percentage"])
634
+ pct = float(progress_state["percentage"])
620
635
  bar = create_progress_bar(pct)
621
636
 
622
637
  # Update label
623
638
  label.update(
624
- f"[$foreground-muted]Indexing codebase: {spinner} {phase}... {bar} {pct:.0f}%[/]"
639
+ f"[$foreground-muted]Indexing codebase: {spinner} {bar} {pct:.0f}%[/]"
625
640
  )
626
641
 
627
642
  def progress_callback(progress_info: IndexProgress) -> None:
628
- """Update progress state (spinner animates independently on timer)."""
643
+ """Update progress state (timer renders it independently)."""
629
644
  # Calculate overall percentage (0-95%, reserve 95-100% for finalization)
630
645
  if progress_info.phase == ProgressPhase.STRUCTURE:
631
646
  # Phase 1: 0-10%, always show 5% while running, 10% when complete
@@ -648,11 +663,10 @@ class ChatScreen(Screen[None]):
648
663
  overall_pct = 0.0
649
664
 
650
665
  # Update shared state (timer will render it)
651
- spinner_state["phase_name"] = progress_info.phase_name
652
- spinner_state["percentage"] = overall_pct
666
+ progress_state["percentage"] = overall_pct
653
667
 
654
- # Start spinner animation timer (10 fps = 100ms interval)
655
- spinner_timer = self.set_interval(0.1, update_spinner_display)
668
+ # Start progress animation timer (10 fps = 100ms interval)
669
+ progress_timer = self.set_interval(0.1, update_progress_display)
656
670
 
657
671
  try:
658
672
  # Pass the current working directory as the indexed_from_cwd
@@ -667,14 +681,12 @@ class ChatScreen(Screen[None]):
667
681
  progress_callback=progress_callback,
668
682
  )
669
683
 
670
- # Stop spinner animation
671
- spinner_timer.stop()
684
+ # Stop progress animation
685
+ progress_timer.stop()
672
686
 
673
687
  # Show 100% completion after indexing finishes
674
688
  final_bar = create_progress_bar(100.0)
675
- label.update(
676
- f"[$foreground-muted]Indexing codebase: ✓ Complete {final_bar} 100%[/]"
677
- )
689
+ label.update(f"[$foreground-muted]Indexing codebase: {final_bar} 100%[/]")
678
690
  label.refresh()
679
691
 
680
692
  logger.info(
@@ -687,12 +699,12 @@ class ChatScreen(Screen[None]):
687
699
  )
688
700
 
689
701
  except CodebaseAlreadyIndexedError as exc:
690
- spinner_timer.stop()
702
+ progress_timer.stop()
691
703
  logger.warning(f"Codebase already indexed: {exc}")
692
704
  self.notify(str(exc), severity="warning")
693
705
  return
694
706
  except InvalidPathError as exc:
695
- spinner_timer.stop()
707
+ progress_timer.stop()
696
708
  logger.error(f"Invalid path error: {exc}")
697
709
  self.notify(str(exc), severity="error")
698
710
 
@@ -704,8 +716,8 @@ class ChatScreen(Screen[None]):
704
716
  )
705
717
  self.notify(f"Failed to index codebase: {exc}", severity="error")
706
718
  finally:
707
- # Always stop the spinner timer
708
- spinner_timer.stop()
719
+ # Always stop the progress timer
720
+ progress_timer.stop()
709
721
  label.update("")
710
722
  label.refresh()
711
723
 
@@ -774,6 +786,7 @@ class ChatScreen(Screen[None]):
774
786
 
775
787
  # Update the current mode
776
788
  self.mode = AgentType(conversation.last_agent_model)
789
+ self.deps.usage_manager.restore_usage_state()
777
790
 
778
791
 
779
792
  def help_text_with_codebase(already_indexed: bool = False) -> str:
@@ -96,6 +96,38 @@ class AgentModeProvider(Provider):
96
96
  yield Hit(score, matcher.highlight(title), callback, help=help_text)
97
97
 
98
98
 
99
+ class UsageProvider(Provider):
100
+ """Command provider for agent mode switching."""
101
+
102
+ @property
103
+ def chat_screen(self) -> "ChatScreen":
104
+ from shotgun.tui.screens.chat import ChatScreen
105
+
106
+ return cast(ChatScreen, self.screen)
107
+
108
+ async def discover(self) -> AsyncGenerator[DiscoveryHit, None]:
109
+ """Provide default mode switching commands when palette opens."""
110
+ yield DiscoveryHit(
111
+ "Show usage",
112
+ self.chat_screen.action_show_usage,
113
+ help="Display usage information for the current session",
114
+ )
115
+
116
+ async def search(self, query: str) -> AsyncGenerator[Hit, None]:
117
+ """Search for mode commands."""
118
+ matcher = self.matcher(query)
119
+
120
+ async for discovery_hit in self.discover():
121
+ score = matcher.match(discovery_hit.text or "")
122
+ if score > 0:
123
+ yield Hit(
124
+ score,
125
+ matcher.highlight(discovery_hit.text or ""),
126
+ discovery_hit.command,
127
+ help=discovery_hit.help,
128
+ )
129
+
130
+
99
131
  class ProviderSetupProvider(Provider):
100
132
  """Command palette entries for provider configuration."""
101
133
 
@@ -198,6 +198,7 @@ class ModelPickerScreen(Screen[None]):
198
198
  names = {
199
199
  ModelName.GPT_5: "GPT-5 (OpenAI)",
200
200
  ModelName.CLAUDE_OPUS_4_1: "Claude Opus 4.1 (Anthropic)",
201
+ ModelName.CLAUDE_SONNET_4_5: "Claude Sonnet 4.5 (Anthropic)",
201
202
  ModelName.GEMINI_2_5_PRO: "Gemini 2.5 Pro (Google)",
202
203
  }
203
204
  return names.get(model_name, model_name.value)
@@ -9,7 +9,7 @@ from textual.app import ComposeResult
9
9
  from textual.containers import Horizontal, Vertical
10
10
  from textual.reactive import reactive
11
11
  from textual.screen import Screen
12
- from textual.widgets import Button, Input, Label, ListItem, ListView, Static
12
+ from textual.widgets import Button, Input, Label, ListItem, ListView, Markdown, Static
13
13
 
14
14
  from shotgun.agents.config import ConfigManager, ProviderType
15
15
 
@@ -50,6 +50,10 @@ class ProviderConfigScreen(Screen[None]):
50
50
  color: $text-accent;
51
51
  }
52
52
 
53
+ #provider-links {
54
+ padding: 1 0;
55
+ }
56
+
53
57
  #provider-list {
54
58
  margin: 2 0;
55
59
  height: auto;
@@ -81,6 +85,10 @@ class ProviderConfigScreen(Screen[None]):
81
85
  "Select a provider and enter the API key needed to activate it.",
82
86
  id="provider-config-summary",
83
87
  )
88
+ yield Markdown(
89
+ "Don't have an API Key? Use these links to get one: [OpenAI](https://platform.openai.com/api-keys) | [Anthropic](https://console.anthropic.com) | [Google Gemini](https://aistudio.google.com)",
90
+ id="provider-links",
91
+ )
84
92
  yield ListView(*self._build_provider_items(), id="provider-list")
85
93
  yield Input(
86
94
  placeholder=self._input_placeholder(self.selected_provider),
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: shotgun-sh
3
- Version: 0.2.1.dev1
3
+ Version: 0.2.1.dev2
4
4
  Summary: AI-powered research, planning, and task management CLI tool
5
5
  Project-URL: Homepage, https://shotgun.sh/
6
6
  Project-URL: Repository, https://github.com/shotgun-sh/shotgun
@@ -22,6 +22,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
22
22
  Classifier: Topic :: Utilities
23
23
  Requires-Python: >=3.11
24
24
  Requires-Dist: anthropic>=0.39.0
25
+ Requires-Dist: genai-prices>=0.0.27
25
26
  Requires-Dist: httpx>=0.27.0
26
27
  Requires-Dist: jinja2>=3.1.0
27
28
  Requires-Dist: kuzu>=0.7.0
@@ -7,23 +7,24 @@ shotgun/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
7
7
  shotgun/sentry_telemetry.py,sha256=L7jFMNAnDIENWVeQYSLpyul2nmIm2w3wnOp2kDP_cic,2902
8
8
  shotgun/telemetry.py,sha256=Ves6Ih3hshpKVNVAUUmwRdtW8NkTjFPg8hEqvFKZ0t0,3208
9
9
  shotgun/agents/__init__.py,sha256=8Jzv1YsDuLyNPFJyckSr_qI4ehTVeDyIMDW4omsfPGc,25
10
- shotgun/agents/agent_manager.py,sha256=wXUQCEsSs68FG8edFLryeePBzxxX1GStJZwd1sS5WsE,26245
10
+ shotgun/agents/agent_manager.py,sha256=xq8L0oAFgtFCpKVsyUoMtYJqUyz5XxjWLKNnxoe1zo4,26577
11
11
  shotgun/agents/common.py,sha256=Hr9HigsDopkI0Sr3FThGDv1f67NLemOjcYA6LV9v970,18963
12
12
  shotgun/agents/conversation_history.py,sha256=5J8_1yxdZiiWTq22aDio88DkBDZ4_Lh_p5Iy5_ENszc,3898
13
13
  shotgun/agents/conversation_manager.py,sha256=fxAvXbEl3Cl2ugJ4N9aWXaqZtkrnfj3QzwjWC4LFXwI,3514
14
14
  shotgun/agents/export.py,sha256=Zke952DbJ_lOBUmN-TPHw7qmjbfqsFu1uycBRQI_pkg,2969
15
15
  shotgun/agents/llm.py,sha256=hs8j1wwTczGtehzahL1Z_5D4qus5QUx4-h9-m5ZPzm4,2209
16
16
  shotgun/agents/messages.py,sha256=wNn0qC5AqASM8LMaSGFOerZEJPn5FsIOmaJs1bdosuU,1036
17
- shotgun/agents/models.py,sha256=n4N141QOPmcuFjJkn5uZRAvtVwF1acsAJE8QlQABCiM,7845
17
+ shotgun/agents/models.py,sha256=IvwwjbJYi5wi9S-budg8g1ezi1VaO57Q-XtegkbTrXg,8096
18
18
  shotgun/agents/plan.py,sha256=s-WfILBOW4l8kY59RUOVtX5MJSuSzFm1nGp6b17If78,3030
19
19
  shotgun/agents/research.py,sha256=lYG7Rytcitop8mXs3isMI3XvYzzI3JH9u0VZz6K9zfo,3274
20
20
  shotgun/agents/specify.py,sha256=7MoMxfIn34G27mw6wrp_F0i2O5rid476L3kHFONDCd0,3137
21
21
  shotgun/agents/tasks.py,sha256=nk8zIl24o01hfzOGyWSbeVWeke6OGseO4Ppciurh13U,2999
22
+ shotgun/agents/usage_manager.py,sha256=5d9JC4_cthXwhTSytMfMExMDAUYp8_nkPepTJZXk13w,5017
22
23
  shotgun/agents/config/__init__.py,sha256=Fl8K_81zBpm-OfOW27M_WWLSFdaHHek6lWz95iDREjQ,318
23
24
  shotgun/agents/config/constants.py,sha256=I3f0ueoQaTg5HddXGCYimCYpj-U57z3IBQYIVJxVIhg,872
24
- shotgun/agents/config/manager.py,sha256=phm_oqObIrCGJrZUvVbwSJHB--Mn7zqJLWB9ZWok5lY,15042
25
- shotgun/agents/config/models.py,sha256=h1XqPOh66moIYaXtEyoGJuPLXdD3acVCOgvgrELsS_4,4796
26
- shotgun/agents/config/provider.py,sha256=V4s7HwU3XwCWqmvMPoDiG9pVjUuuyNWidvqhImLXvxE,11547
25
+ shotgun/agents/config/manager.py,sha256=WKVWx77XrD_Jra3-6e-bSUYR4bUYMAsRuQNcy-MpoLY,14499
26
+ shotgun/agents/config/models.py,sha256=ZojhfheNO337e1icy_cE2PpBXIl5oHkdajr4azzFF-U,5106
27
+ shotgun/agents/config/provider.py,sha256=zaQoD8JYEKgTMEJ5etZDSyLhPzD9-EHSOYNfS70BemQ,10931
27
28
  shotgun/agents/history/__init__.py,sha256=XFQj2a6fxDqVg0Q3juvN9RjV_RJbgvFZtQOCOjVJyp4,147
28
29
  shotgun/agents/history/compaction.py,sha256=9RMpG0aY_7L4TecbgwHSOkGtbd9W5XZTg-MbzZmNl00,3515
29
30
  shotgun/agents/history/constants.py,sha256=yWY8rrTZarLA3flCCMB_hS2NMvUDRDTwP4D4j7MIh1w,446
@@ -50,14 +51,14 @@ shotgun/agents/tools/codebase/models.py,sha256=8eR3_8DQiBNgB2twu0aC_evIJbugN9KW3
50
51
  shotgun/agents/tools/codebase/query_graph.py,sha256=vOeyN4-OZj-vpTSk3Z9W5TjraZAepJ-Qjk_zzvum3fU,2115
51
52
  shotgun/agents/tools/codebase/retrieve_code.py,sha256=2VjiqVKJMd9rPV-mGrL4C-N8fqGjYLW6ZInFGbcTxOM,2878
52
53
  shotgun/agents/tools/web_search/__init__.py,sha256=_9rgs_gv41-wfPvwfWM_Qfq-zvboyQ_srfyneGsxgM4,3182
53
- shotgun/agents/tools/web_search/anthropic.py,sha256=wN3dRBXohIwcJRp0KA3QTgldGjKuDZ2NW4X36mvIn3E,4971
54
+ shotgun/agents/tools/web_search/anthropic.py,sha256=GelAhAmb-b4o87-3sgxNFfw-G2LXDEjfdZ7XfF0bQD0,4983
54
55
  shotgun/agents/tools/web_search/gemini.py,sha256=-fI_deaBT4-_61A7KlKtz8tmKXW50fVx_97WAJTUg4w,3468
55
56
  shotgun/agents/tools/web_search/openai.py,sha256=pnIcTV3vwXJQuxPs4I7gQNX18XzM7D7FqeNxnn1E7yw,3437
56
57
  shotgun/agents/tools/web_search/utils.py,sha256=GLJ5QV9bT2ubFMuFN7caMN7tK9OTJ0R3GD57B-tCMF0,532
57
58
  shotgun/cli/__init__.py,sha256=_F1uW2g87y4bGFxz8Gp8u7mq2voHp8vQIUtCmm8Tojo,40
58
59
  shotgun/cli/config.py,sha256=wQhuz8zE2K-fjwxeK2yZt-NkV13kEZAitBqrwPLUvgg,7466
59
60
  shotgun/cli/export.py,sha256=3hIwK2_OM1MFYSTfzBxsGuuBGm5fo0XdxASfQ5Uqb3Y,2471
60
- shotgun/cli/feedback.py,sha256=Sh0aK93wE7rvvCI31QCbm0sU-AUEldg7s9QqoAm1oQM,1242
61
+ shotgun/cli/feedback.py,sha256=Me1dQQgkYwP4AIFwYgfHcPXxFdJ6CzFbCBttKcFd2Q0,1238
61
62
  shotgun/cli/models.py,sha256=kwZEldQWUheNsqF_ezgDzRBc6h0Y0JxFw1VMQjZlvPE,182
62
63
  shotgun/cli/plan.py,sha256=T-eu-I9z-dSoKqJ-KI8X5i5Mm0VL1BfornxRiUjTgnk,2324
63
64
  shotgun/cli/research.py,sha256=qvBBtX3Wyn6pDZlJpcEvbeK-0iTOXegi71tm8HKVYaE,2490
@@ -113,7 +114,7 @@ shotgun/sdk/exceptions.py,sha256=qBcQv0v7ZTwP7CMcxZST4GqCsfOWtOUjSzGBo0-heqo,412
113
114
  shotgun/sdk/models.py,sha256=X9nOTUHH0cdkQW1NfnMEDu-QgK9oUsEISh1Jtwr5Am4,5496
114
115
  shotgun/sdk/services.py,sha256=J4PJFSxCQ6--u7rb3Ta-9eYtlYcxcbnzrMP6ThyCnw4,705
115
116
  shotgun/tui/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
116
- shotgun/tui/app.py,sha256=Rv4Pxi2uyDE_tspZGMWKJY1KrH47d8uCIBBMfM05gCQ,5093
117
+ shotgun/tui/app.py,sha256=DrULqhxPPDZzz1WQNjXDY_cls4kXJNexYlI1ISrNTKs,5089
117
118
  shotgun/tui/filtered_codebase_service.py,sha256=lJ8gTMhIveTatmvmGLP299msWWTkVYKwvY_2FhuL2s4,1687
118
119
  shotgun/tui/styles.tcss,sha256=ETyyw1bpMBOqTi5RLcAJUScdPWTvAWEqE9YcT0kVs_E,121
119
120
  shotgun/tui/commands/__init__.py,sha256=8D5lvtpqMW5-fF7Bg3oJtUzU75cKOv6aUaHYYszydU8,2518
@@ -121,15 +122,15 @@ shotgun/tui/components/prompt_input.py,sha256=Ss-htqraHZAPaehGE4x86ij0veMjc4Ugad
121
122
  shotgun/tui/components/spinner.py,sha256=ovTDeaJ6FD6chZx_Aepia6R3UkPOVJ77EKHfRmn39MY,2427
122
123
  shotgun/tui/components/splash.py,sha256=vppy9vEIEvywuUKRXn2y11HwXSRkQZHLYoVjhDVdJeU,1267
123
124
  shotgun/tui/components/vertical_tail.py,sha256=kROwTaRjUwVB7H35dtmNcUVPQqNYvvfq7K2tXBKEb6c,638
124
- shotgun/tui/screens/chat.py,sha256=HIDnqt8og2KMmtdOok1lL44130M8V7IP6Un_8HcRwsA,30178
125
+ shotgun/tui/screens/chat.py,sha256=H3uAE4sQ7iJO33tJhdoW_OkzaNxXgW6BUP-SxoNiohw,30465
125
126
  shotgun/tui/screens/chat.tcss,sha256=2Yq3E23jxsySYsgZf4G1AYrYVcpX0UDW6kNNI0tDmtM,437
126
127
  shotgun/tui/screens/directory_setup.py,sha256=lIZ1J4A6g5Q2ZBX8epW7BhR96Dmdcg22CyiM5S-I5WU,3237
127
128
  shotgun/tui/screens/feedback.py,sha256=cYtmuM3qqKwevstu8gJ9mmk7lkIKZvfAyDEBUOLh-yI,5660
128
- shotgun/tui/screens/model_picker.py,sha256=2l0zkhJ5CPH_4Fn0MM3bp9RN7fEowbljpBsmTjzRQT8,6886
129
- shotgun/tui/screens/provider_config.py,sha256=-en99fDxTim0DSjpJTLSRba_yrON8wDhcuwU6rNZwHM,7765
129
+ shotgun/tui/screens/model_picker.py,sha256=Lbmsh-wCwFpJ9pEANi6uKpSatKJ2kHVocJ9-wCYMd58,6960
130
+ shotgun/tui/screens/provider_config.py,sha256=nJ7mwhabCo9AGTqi03YWhic9uHkRQstN5UCgg4bdTX0,8126
130
131
  shotgun/tui/screens/splash.py,sha256=E2MsJihi3c9NY1L28o_MstDxGwrCnnV7zdq00MrGAsw,706
131
132
  shotgun/tui/screens/chat_screen/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
132
- shotgun/tui/screens/chat_screen/command_providers.py,sha256=B4uUzzGq23vfS1mp4U6zsOEqyv6Ni9AMu5fqp5xMz5s,8437
133
+ shotgun/tui/screens/chat_screen/command_providers.py,sha256=AlBegXO-meob5TfNqjbs8txPXhScxxbcy7600FW_228,9520
133
134
  shotgun/tui/screens/chat_screen/hint_message.py,sha256=WOpbk8q7qt7eOHTyyHvh_IQIaublVDeJGaLpsxEk9FA,933
134
135
  shotgun/tui/screens/chat_screen/history.py,sha256=NVLA3_tERTyB4vkH71w8ef_M5CszfkwbQOuMb100Fzc,12272
135
136
  shotgun/tui/utils/__init__.py,sha256=cFjDfoXTRBq29wgP7TGRWUu1eFfiIG-LLOzjIGfadgI,150
@@ -139,8 +140,8 @@ shotgun/utils/env_utils.py,sha256=8QK5aw_f_V2AVTleQQlcL0RnD4sPJWXlDG46fsHu0d8,10
139
140
  shotgun/utils/file_system_utils.py,sha256=l-0p1bEHF34OU19MahnRFdClHufThfGAjQ431teAIp0,1004
140
141
  shotgun/utils/source_detection.py,sha256=Co6Q03R3fT771TF3RzB-70stfjNP2S4F_ArZKibwzm8,454
141
142
  shotgun/utils/update_checker.py,sha256=IgzPHRhS1ETH7PnJR_dIx6lxgr1qHpCkMTgzUxvGjhI,7586
142
- shotgun_sh-0.2.1.dev1.dist-info/METADATA,sha256=KnWsl_ASqmh5tc4yblK9TGGltQxztoW_XYK7fNPCLqE,11190
143
- shotgun_sh-0.2.1.dev1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
144
- shotgun_sh-0.2.1.dev1.dist-info/entry_points.txt,sha256=asZxLU4QILneq0MWW10saVCZc4VWhZfb0wFZvERnzfA,45
145
- shotgun_sh-0.2.1.dev1.dist-info/licenses/LICENSE,sha256=YebsZl590zCHrF_acCU5pmNt0pnAfD2DmAnevJPB1tY,1065
146
- shotgun_sh-0.2.1.dev1.dist-info/RECORD,,
143
+ shotgun_sh-0.2.1.dev2.dist-info/METADATA,sha256=21gMEduUKH5hRYdTHdBTg0vQnEX_7H-gHJU5elXs1t0,11226
144
+ shotgun_sh-0.2.1.dev2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
145
+ shotgun_sh-0.2.1.dev2.dist-info/entry_points.txt,sha256=asZxLU4QILneq0MWW10saVCZc4VWhZfb0wFZvERnzfA,45
146
+ shotgun_sh-0.2.1.dev2.dist-info/licenses/LICENSE,sha256=YebsZl590zCHrF_acCU5pmNt0pnAfD2DmAnevJPB1tY,1065
147
+ shotgun_sh-0.2.1.dev2.dist-info/RECORD,,