Skip to main content

stakpak_api/client/
provider.rs

1//! AgentProvider trait implementation for AgentClient
2//!
3//! Implements the unified provider interface with:
4//! - Stakpak-first routing when API key is present
5//! - Local fallback when Stakpak is unavailable
6//! - Hook registry integration for lifecycle events
7
8use crate::AgentProvider;
9use crate::models::*;
10use crate::storage::{
11    CreateCheckpointRequest as StorageCreateCheckpointRequest,
12    CreateSessionRequest as StorageCreateSessionRequest,
13};
14use async_trait::async_trait;
15use futures_util::Stream;
16use reqwest::header::HeaderMap;
17use rmcp::model::Content;
18use stakpak_shared::hooks::{HookContext, LifecycleEvent};
19use stakpak_shared::models::integrations::anthropic::AnthropicModel;
20use stakpak_shared::models::integrations::openai::{
21    AgentModel, ChatCompletionChoice, ChatCompletionResponse, ChatCompletionStreamChoice,
22    ChatCompletionStreamResponse, ChatMessage, FinishReason, MessageContent, Role, Tool,
23};
24use stakpak_shared::models::llm::{
25    GenerationDelta, LLMInput, LLMMessage, LLMMessageContent, LLMModel, LLMStreamInput,
26};
27use stakpak_shared::models::stakai_adapter::get_stakai_model_string;
28use std::pin::Pin;
29use tokio::sync::mpsc;
30use uuid::Uuid;
31
32/// Lightweight session info returned by initialize_session / save_checkpoint
33#[derive(Debug, Clone)]
34pub(crate) struct SessionInfo {
35    session_id: Uuid,
36    checkpoint_id: Uuid,
37    checkpoint_created_at: chrono::DateTime<chrono::Utc>,
38}
39
40use super::AgentClient;
41
42// =============================================================================
43// Internal Message Types
44// =============================================================================
45
46#[derive(Debug)]
47pub(crate) enum StreamMessage {
48    Delta(GenerationDelta),
49    Ctx(Box<HookContext<AgentState>>),
50}
51
52// =============================================================================
53// AgentProvider Implementation
54// =============================================================================
55
56#[async_trait]
57impl AgentProvider for AgentClient {
58    // =========================================================================
59    // Account
60    // =========================================================================
61
62    async fn get_my_account(&self) -> Result<GetMyAccountResponse, String> {
63        if let Some(api) = &self.stakpak_api {
64            api.get_account().await
65        } else {
66            // Local stub
67            Ok(GetMyAccountResponse {
68                username: "local".to_string(),
69                id: "local".to_string(),
70                first_name: "local".to_string(),
71                last_name: "local".to_string(),
72                email: "local@stakpak.dev".to_string(),
73                scope: None,
74            })
75        }
76    }
77
78    async fn get_billing_info(
79        &self,
80        account_username: &str,
81    ) -> Result<stakpak_shared::models::billing::BillingResponse, String> {
82        if let Some(api) = &self.stakpak_api {
83            api.get_billing(account_username).await
84        } else {
85            Err("Billing info not available without Stakpak API key".to_string())
86        }
87    }
88
89    // =========================================================================
90    // Rulebooks
91    // =========================================================================
92
93    async fn list_rulebooks(&self) -> Result<Vec<ListRuleBook>, String> {
94        if let Some(api) = &self.stakpak_api {
95            api.list_rulebooks().await
96        } else {
97            // Try to fetch public rulebooks via unauthenticated request
98            let client = stakpak_shared::tls_client::create_tls_client(
99                stakpak_shared::tls_client::TlsClientConfig::default()
100                    .with_timeout(std::time::Duration::from_secs(30)),
101            )?;
102
103            let url = format!("{}/v1/rules", self.get_stakpak_api_endpoint());
104            let response = client.get(&url).send().await.map_err(|e| e.to_string())?;
105
106            if response.status().is_success() {
107                let value: serde_json::Value = response.json().await.map_err(|e| e.to_string())?;
108                match serde_json::from_value::<ListRulebooksResponse>(value) {
109                    Ok(resp) => Ok(resp.results),
110                    Err(_) => Ok(vec![]),
111                }
112            } else {
113                Ok(vec![])
114            }
115        }
116    }
117
118    async fn get_rulebook_by_uri(&self, uri: &str) -> Result<RuleBook, String> {
119        if let Some(api) = &self.stakpak_api {
120            api.get_rulebook_by_uri(uri).await
121        } else {
122            // Try to fetch public rulebook via unauthenticated request
123            let client = stakpak_shared::tls_client::create_tls_client(
124                stakpak_shared::tls_client::TlsClientConfig::default()
125                    .with_timeout(std::time::Duration::from_secs(30)),
126            )?;
127
128            let encoded_uri = urlencoding::encode(uri);
129            let url = format!(
130                "{}/v1/rules/{}",
131                self.get_stakpak_api_endpoint(),
132                encoded_uri
133            );
134            let response = client.get(&url).send().await.map_err(|e| e.to_string())?;
135
136            if response.status().is_success() {
137                response.json().await.map_err(|e| e.to_string())
138            } else {
139                Err("Rulebook not found".to_string())
140            }
141        }
142    }
143
144    async fn create_rulebook(
145        &self,
146        uri: &str,
147        description: &str,
148        content: &str,
149        tags: Vec<String>,
150        visibility: Option<RuleBookVisibility>,
151    ) -> Result<CreateRuleBookResponse, String> {
152        if let Some(api) = &self.stakpak_api {
153            api.create_rulebook(&CreateRuleBookInput {
154                uri: uri.to_string(),
155                description: description.to_string(),
156                content: content.to_string(),
157                tags,
158                visibility,
159            })
160            .await
161        } else {
162            Err("Creating rulebooks requires Stakpak API key".to_string())
163        }
164    }
165
166    async fn delete_rulebook(&self, uri: &str) -> Result<(), String> {
167        if let Some(api) = &self.stakpak_api {
168            api.delete_rulebook(uri).await
169        } else {
170            Err("Deleting rulebooks requires Stakpak API key".to_string())
171        }
172    }
173
174    // =========================================================================
175    // Chat Completion
176    // =========================================================================
177
178    async fn chat_completion(
179        &self,
180        model: AgentModel,
181        messages: Vec<ChatMessage>,
182        tools: Option<Vec<Tool>>,
183        session_id: Option<Uuid>,
184    ) -> Result<ChatCompletionResponse, String> {
185        let mut ctx = HookContext::new(session_id, AgentState::new(model, messages, tools));
186
187        // Execute before request hooks
188        self.hook_registry
189            .execute_hooks(&mut ctx, &LifecycleEvent::BeforeRequest)
190            .await
191            .map_err(|e| e.to_string())?
192            .ok()?;
193
194        // Initialize or resume session
195        let current_session = self.initialize_session(&ctx).await?;
196        ctx.set_session_id(current_session.session_id);
197
198        // Run completion
199        let new_message = self.run_agent_completion(&mut ctx, None).await?;
200        ctx.state.append_new_message(new_message.clone());
201
202        // Save checkpoint
203        let result = self
204            .save_checkpoint(&current_session, ctx.state.messages.clone())
205            .await?;
206        let checkpoint_created_at = result.checkpoint_created_at.timestamp() as u64;
207        ctx.set_new_checkpoint_id(result.checkpoint_id);
208
209        // Execute after request hooks
210        self.hook_registry
211            .execute_hooks(&mut ctx, &LifecycleEvent::AfterRequest)
212            .await
213            .map_err(|e| e.to_string())?
214            .ok()?;
215
216        let mut meta = serde_json::Map::new();
217        if let Some(session_id) = ctx.session_id {
218            meta.insert(
219                "session_id".to_string(),
220                serde_json::Value::String(session_id.to_string()),
221            );
222        }
223        if let Some(checkpoint_id) = ctx.new_checkpoint_id {
224            meta.insert(
225                "checkpoint_id".to_string(),
226                serde_json::Value::String(checkpoint_id.to_string()),
227            );
228        }
229
230        Ok(ChatCompletionResponse {
231            id: ctx.new_checkpoint_id.unwrap().to_string(),
232            object: "chat.completion".to_string(),
233            created: checkpoint_created_at,
234            model: ctx
235                .state
236                .llm_input
237                .as_ref()
238                .map(|llm_input| llm_input.model.clone().to_string())
239                .unwrap_or_default(),
240            choices: vec![ChatCompletionChoice {
241                index: 0,
242                message: ctx.state.messages.last().cloned().unwrap(),
243                logprobs: None,
244                finish_reason: FinishReason::Stop,
245            }],
246            usage: ctx
247                .state
248                .llm_output
249                .as_ref()
250                .map(|u| u.usage.clone())
251                .unwrap_or_default(),
252            system_fingerprint: None,
253            metadata: if meta.is_empty() {
254                None
255            } else {
256                Some(serde_json::Value::Object(meta))
257            },
258        })
259    }
260
261    async fn chat_completion_stream(
262        &self,
263        model: AgentModel,
264        messages: Vec<ChatMessage>,
265        tools: Option<Vec<Tool>>,
266        _headers: Option<HeaderMap>,
267        session_id: Option<Uuid>,
268    ) -> Result<
269        (
270            Pin<
271                Box<dyn Stream<Item = Result<ChatCompletionStreamResponse, ApiStreamError>> + Send>,
272            >,
273            Option<String>,
274        ),
275        String,
276    > {
277        let mut ctx = HookContext::new(session_id, AgentState::new(model, messages, tools));
278
279        // Execute before request hooks
280        self.hook_registry
281            .execute_hooks(&mut ctx, &LifecycleEvent::BeforeRequest)
282            .await
283            .map_err(|e| e.to_string())?
284            .ok()?;
285
286        // Initialize session
287        let current_session = self.initialize_session(&ctx).await?;
288        ctx.set_session_id(current_session.session_id);
289
290        let (tx, mut rx) = mpsc::channel::<Result<StreamMessage, String>>(100);
291
292        // Clone what we need for the spawned task
293        let client = self.clone();
294        let mut ctx_clone = ctx.clone();
295
296        // Spawn the completion task with proper shutdown handling
297        // The task checks if the channel is closed before each expensive operation
298        // to support graceful shutdown when the stream consumer is dropped
299        tokio::spawn(async move {
300            // Check if consumer is still listening before starting
301            if tx.is_closed() {
302                return;
303            }
304
305            let result = client
306                .run_agent_completion(&mut ctx_clone, Some(tx.clone()))
307                .await;
308
309            match result {
310                Err(e) => {
311                    let _ = tx.send(Err(e)).await;
312                }
313                Ok(new_message) => {
314                    // Check if consumer is still listening before continuing
315                    if tx.is_closed() {
316                        return;
317                    }
318
319                    ctx_clone.state.append_new_message(new_message.clone());
320                    if tx
321                        .send(Ok(StreamMessage::Ctx(Box::new(ctx_clone.clone()))))
322                        .await
323                        .is_err()
324                    {
325                        // Consumer dropped, exit gracefully
326                        return;
327                    }
328
329                    // Check again before expensive session update
330                    if tx.is_closed() {
331                        return;
332                    }
333
334                    let result = client
335                        .save_checkpoint(&current_session, ctx_clone.state.messages.clone())
336                        .await;
337
338                    match result {
339                        Err(e) => {
340                            let _ = tx.send(Err(e)).await;
341                        }
342                        Ok(updated) => {
343                            ctx_clone.set_new_checkpoint_id(updated.checkpoint_id);
344                            let _ = tx.send(Ok(StreamMessage::Ctx(Box::new(ctx_clone)))).await;
345                        }
346                    }
347                }
348            }
349        });
350
351        let hook_registry = self.hook_registry.clone();
352        let stream = async_stream::stream! {
353            while let Some(delta_result) = rx.recv().await {
354                match delta_result {
355                    Ok(delta) => match delta {
356                        StreamMessage::Ctx(updated_ctx) => {
357                            ctx = *updated_ctx;
358                            // Emit session metadata so callers can track session_id
359                            if let Some(session_id) = ctx.session_id {
360                                let mut meta = serde_json::Map::new();
361                                meta.insert("session_id".to_string(), serde_json::Value::String(session_id.to_string()));
362                                if let Some(checkpoint_id) = ctx.new_checkpoint_id {
363                                    meta.insert("checkpoint_id".to_string(), serde_json::Value::String(checkpoint_id.to_string()));
364                                }
365                                yield Ok(ChatCompletionStreamResponse {
366                                    id: ctx.request_id.to_string(),
367                                    object: "chat.completion.chunk".to_string(),
368                                    created: chrono::Utc::now().timestamp() as u64,
369                                    model: String::new(),
370                                    choices: vec![],
371                                    usage: None,
372                                    metadata: Some(serde_json::Value::Object(meta)),
373                                });
374                            }
375                        }
376                        StreamMessage::Delta(delta) => {
377                            yield Ok(ChatCompletionStreamResponse {
378                                id: ctx.request_id.to_string(),
379                                object: "chat.completion.chunk".to_string(),
380                                created: chrono::Utc::now().timestamp() as u64,
381                                model: ctx.state.llm_input.as_ref().map(|llm_input| llm_input.model.clone().to_string()).unwrap_or_default(),
382                                choices: vec![ChatCompletionStreamChoice {
383                                    index: 0,
384                                    delta: delta.into(),
385                                    finish_reason: None,
386                                }],
387                                usage: ctx.state.llm_output.as_ref().map(|u| u.usage.clone()),
388                                metadata: None,
389                            })
390                        }
391                    }
392                    Err(e) => yield Err(ApiStreamError::Unknown(e)),
393                }
394            }
395
396            // Execute after request hooks
397            hook_registry
398                .execute_hooks(&mut ctx, &LifecycleEvent::AfterRequest)
399                .await
400                .map_err(|e| e.to_string())?
401                .ok()?;
402        };
403
404        Ok((Box::pin(stream), None))
405    }
406
407    async fn cancel_stream(&self, request_id: String) -> Result<(), String> {
408        if let Some(api) = &self.stakpak_api {
409            api.cancel_request(&request_id).await
410        } else {
411            // Local mode doesn't support cancellation yet
412            Ok(())
413        }
414    }
415
416    // =========================================================================
417    // Search Docs
418    // =========================================================================
419
420    async fn search_docs(&self, input: &SearchDocsRequest) -> Result<Vec<Content>, String> {
421        if let Some(api) = &self.stakpak_api {
422            api.search_docs(&crate::stakpak::SearchDocsRequest {
423                keywords: input.keywords.clone(),
424                exclude_keywords: input.exclude_keywords.clone(),
425                limit: input.limit,
426            })
427            .await
428        } else {
429            // Fallback to local search service
430            use stakpak_shared::models::integrations::search_service::*;
431
432            let config = SearchServicesOrchestrator::start()
433                .await
434                .map_err(|e| e.to_string())?;
435
436            let api_url = format!("http://localhost:{}", config.api_port);
437            let search_client = SearchClient::new(api_url);
438
439            let search_results = search_client
440                .search_and_scrape(input.keywords.clone(), None)
441                .await
442                .map_err(|e| e.to_string())?;
443
444            if search_results.is_empty() {
445                return Ok(vec![Content::text("No results found".to_string())]);
446            }
447
448            Ok(search_results
449                .into_iter()
450                .map(|result| {
451                    let content = result.content.unwrap_or_default();
452                    Content::text(format!("URL: {}\nContent: {}", result.url, content))
453                })
454                .collect())
455        }
456    }
457
458    // =========================================================================
459    // Memory
460    // =========================================================================
461
462    async fn memorize_session(&self, checkpoint_id: Uuid) -> Result<(), String> {
463        if let Some(api) = &self.stakpak_api {
464            api.memorize_session(checkpoint_id).await
465        } else {
466            // No-op in local mode
467            Ok(())
468        }
469    }
470
471    async fn search_memory(&self, input: &SearchMemoryRequest) -> Result<Vec<Content>, String> {
472        if let Some(api) = &self.stakpak_api {
473            api.search_memory(&crate::stakpak::SearchMemoryRequest {
474                keywords: input.keywords.clone(),
475                start_time: input.start_time,
476                end_time: input.end_time,
477            })
478            .await
479        } else {
480            // Empty results in local mode
481            Ok(vec![])
482        }
483    }
484
485    // =========================================================================
486    // Slack
487    // =========================================================================
488
489    async fn slack_read_messages(
490        &self,
491        input: &SlackReadMessagesRequest,
492    ) -> Result<Vec<Content>, String> {
493        if let Some(api) = &self.stakpak_api {
494            api.slack_read_messages(&crate::stakpak::SlackReadMessagesRequest {
495                channel: input.channel.clone(),
496                limit: input.limit,
497            })
498            .await
499        } else {
500            Err("Slack integration requires Stakpak API key".to_string())
501        }
502    }
503
504    async fn slack_read_replies(
505        &self,
506        input: &SlackReadRepliesRequest,
507    ) -> Result<Vec<Content>, String> {
508        if let Some(api) = &self.stakpak_api {
509            api.slack_read_replies(&crate::stakpak::SlackReadRepliesRequest {
510                channel: input.channel.clone(),
511                ts: input.ts.clone(),
512            })
513            .await
514        } else {
515            Err("Slack integration requires Stakpak API key".to_string())
516        }
517    }
518
519    async fn slack_send_message(
520        &self,
521        input: &SlackSendMessageRequest,
522    ) -> Result<Vec<Content>, String> {
523        if let Some(api) = &self.stakpak_api {
524            api.slack_send_message(&crate::stakpak::SlackSendMessageRequest {
525                channel: input.channel.clone(),
526                mrkdwn_text: input.mrkdwn_text.clone(),
527                thread_ts: input.thread_ts.clone(),
528            })
529            .await
530        } else {
531            Err("Slack integration requires Stakpak API key".to_string())
532        }
533    }
534}
535
536// =============================================================================
537// SessionStorage implementation (delegates to inner session_storage)
538// =============================================================================
539
540#[async_trait]
541impl crate::storage::SessionStorage for super::AgentClient {
542    async fn list_sessions(
543        &self,
544        query: &crate::storage::ListSessionsQuery,
545    ) -> Result<crate::storage::ListSessionsResult, crate::storage::StorageError> {
546        self.session_storage.list_sessions(query).await
547    }
548
549    async fn get_session(
550        &self,
551        session_id: Uuid,
552    ) -> Result<crate::storage::Session, crate::storage::StorageError> {
553        self.session_storage.get_session(session_id).await
554    }
555
556    async fn create_session(
557        &self,
558        request: &crate::storage::CreateSessionRequest,
559    ) -> Result<crate::storage::CreateSessionResult, crate::storage::StorageError> {
560        self.session_storage.create_session(request).await
561    }
562
563    async fn update_session(
564        &self,
565        session_id: Uuid,
566        request: &crate::storage::UpdateSessionRequest,
567    ) -> Result<crate::storage::Session, crate::storage::StorageError> {
568        self.session_storage
569            .update_session(session_id, request)
570            .await
571    }
572
573    async fn delete_session(&self, session_id: Uuid) -> Result<(), crate::storage::StorageError> {
574        self.session_storage.delete_session(session_id).await
575    }
576
577    async fn list_checkpoints(
578        &self,
579        session_id: Uuid,
580        query: &crate::storage::ListCheckpointsQuery,
581    ) -> Result<crate::storage::ListCheckpointsResult, crate::storage::StorageError> {
582        self.session_storage
583            .list_checkpoints(session_id, query)
584            .await
585    }
586
587    async fn get_checkpoint(
588        &self,
589        checkpoint_id: Uuid,
590    ) -> Result<crate::storage::Checkpoint, crate::storage::StorageError> {
591        self.session_storage.get_checkpoint(checkpoint_id).await
592    }
593
594    async fn create_checkpoint(
595        &self,
596        session_id: Uuid,
597        request: &crate::storage::CreateCheckpointRequest,
598    ) -> Result<crate::storage::Checkpoint, crate::storage::StorageError> {
599        self.session_storage
600            .create_checkpoint(session_id, request)
601            .await
602    }
603
604    async fn get_active_checkpoint(
605        &self,
606        session_id: Uuid,
607    ) -> Result<crate::storage::Checkpoint, crate::storage::StorageError> {
608        self.session_storage.get_active_checkpoint(session_id).await
609    }
610
611    async fn get_session_stats(
612        &self,
613        session_id: Uuid,
614    ) -> Result<crate::storage::SessionStats, crate::storage::StorageError> {
615        self.session_storage.get_session_stats(session_id).await
616    }
617}
618
619// =============================================================================
620// Helper Methods
621// =============================================================================
622
623const TITLE_GENERATOR_PROMPT: &str =
624    include_str!("../local/prompts/session_title_generator.v1.txt");
625
626impl AgentClient {
627    /// Initialize or resume a session based on context
628    ///
629    /// If `ctx.session_id` is set, we resume that session directly.
630    /// Otherwise, we create a new session.
631    pub(crate) async fn initialize_session(
632        &self,
633        ctx: &HookContext<AgentState>,
634    ) -> Result<SessionInfo, String> {
635        let messages = &ctx.state.messages;
636
637        if messages.is_empty() {
638            return Err("At least one message is required".to_string());
639        }
640
641        // If session_id is set in context, resume that session directly
642        if let Some(session_id) = ctx.session_id {
643            let session = self
644                .session_storage
645                .get_session(session_id)
646                .await
647                .map_err(|e| e.to_string())?;
648
649            let checkpoint = session
650                .active_checkpoint
651                .ok_or_else(|| format!("Session {} has no active checkpoint", session_id))?;
652
653            return Ok(SessionInfo {
654                session_id: session.id,
655                checkpoint_id: checkpoint.id,
656                checkpoint_created_at: checkpoint.created_at,
657            });
658        }
659
660        // Create new session
661        // Generate title with fallback - don't fail session creation if title generation fails
662        let title = match self.generate_session_title(messages).await {
663            Ok(title) => title,
664            Err(_) => {
665                // Extract first few words from user message as fallback title
666                messages
667                    .iter()
668                    .find(|m| m.role == Role::User)
669                    .and_then(|m| m.content.as_ref())
670                    .map(|c| {
671                        let text = c.to_string();
672                        text.split_whitespace()
673                            .take(5)
674                            .collect::<Vec<_>>()
675                            .join(" ")
676                    })
677                    .unwrap_or_else(|| "New Session".to_string())
678            }
679        };
680
681        // Get current working directory
682        let cwd = std::env::current_dir()
683            .ok()
684            .map(|p| p.to_string_lossy().to_string());
685
686        // Create session via storage trait
687        let mut session_request = StorageCreateSessionRequest::new(title, messages.to_vec());
688        if let Some(cwd) = cwd {
689            session_request = session_request.with_cwd(cwd);
690        }
691
692        let result = self
693            .session_storage
694            .create_session(&session_request)
695            .await
696            .map_err(|e| e.to_string())?;
697
698        Ok(SessionInfo {
699            session_id: result.session_id,
700            checkpoint_id: result.checkpoint.id,
701            checkpoint_created_at: result.checkpoint.created_at,
702        })
703    }
704
705    /// Save a new checkpoint for the current session
706    pub(crate) async fn save_checkpoint(
707        &self,
708        current: &SessionInfo,
709        messages: Vec<ChatMessage>,
710    ) -> Result<SessionInfo, String> {
711        let checkpoint_request =
712            StorageCreateCheckpointRequest::new(messages).with_parent(current.checkpoint_id);
713
714        let checkpoint = self
715            .session_storage
716            .create_checkpoint(current.session_id, &checkpoint_request)
717            .await
718            .map_err(|e| e.to_string())?;
719
720        Ok(SessionInfo {
721            session_id: current.session_id,
722            checkpoint_id: checkpoint.id,
723            checkpoint_created_at: checkpoint.created_at,
724        })
725    }
726
727    /// Run agent completion (inference)
728    pub(crate) async fn run_agent_completion(
729        &self,
730        ctx: &mut HookContext<AgentState>,
731        stream_channel_tx: Option<mpsc::Sender<Result<StreamMessage, String>>>,
732    ) -> Result<ChatMessage, String> {
733        // Execute before inference hooks
734        self.hook_registry
735            .execute_hooks(ctx, &LifecycleEvent::BeforeInference)
736            .await
737            .map_err(|e| e.to_string())?
738            .ok()?;
739
740        let mut input = if let Some(llm_input) = ctx.state.llm_input.clone() {
741            llm_input
742        } else {
743            return Err(
744                "LLM input not found, make sure to register a context hook before inference"
745                    .to_string(),
746            );
747        };
748
749        // Inject session_id header if available
750        if let Some(session_id) = ctx.session_id {
751            let headers = input
752                .headers
753                .get_or_insert_with(std::collections::HashMap::new);
754            headers.insert("X-Session-Id".to_string(), session_id.to_string());
755        }
756
757        let (response_message, usage) = if let Some(tx) = stream_channel_tx {
758            // Streaming mode
759            let (internal_tx, mut internal_rx) = mpsc::channel::<GenerationDelta>(100);
760            let stream_input = LLMStreamInput {
761                model: input.model,
762                messages: input.messages,
763                max_tokens: input.max_tokens,
764                tools: input.tools,
765                stream_channel_tx: internal_tx,
766                provider_options: input.provider_options,
767                headers: input.headers,
768            };
769
770            let stakai = self.stakai.clone();
771            let chat_future = async move {
772                stakai
773                    .chat_stream(stream_input)
774                    .await
775                    .map_err(|e| e.to_string())
776            };
777
778            let receive_future = async move {
779                while let Some(delta) = internal_rx.recv().await {
780                    if tx.send(Ok(StreamMessage::Delta(delta))).await.is_err() {
781                        break;
782                    }
783                }
784            };
785
786            let (chat_result, _) = tokio::join!(chat_future, receive_future);
787            let response = chat_result?;
788            (response.choices[0].message.clone(), response.usage)
789        } else {
790            // Non-streaming mode
791            let response = self.stakai.chat(input).await.map_err(|e| e.to_string())?;
792            (response.choices[0].message.clone(), response.usage)
793        };
794
795        ctx.state.set_llm_output(response_message, usage);
796
797        // Execute after inference hooks
798        self.hook_registry
799            .execute_hooks(ctx, &LifecycleEvent::AfterInference)
800            .await
801            .map_err(|e| e.to_string())?
802            .ok()?;
803
804        let llm_output = ctx
805            .state
806            .llm_output
807            .as_ref()
808            .ok_or_else(|| "LLM output is missing from state".to_string())?;
809
810        Ok(ChatMessage::from(llm_output))
811    }
812
813    /// Generate a title for a new session
814    async fn generate_session_title(&self, messages: &[ChatMessage]) -> Result<String, String> {
815        let llm_model = if let Some(eco_model) = &self.model_options.eco_model {
816            eco_model.clone()
817        } else {
818            // Try to find a suitable model
819            LLMModel::Anthropic(AnthropicModel::Claude45Haiku)
820        };
821
822        // If Stakpak is available, route through it
823        let model = if self.has_stakpak() {
824            // Get properly formatted model string with provider prefix (e.g., "anthropic/claude-haiku-4-5")
825            let model_str = get_stakai_model_string(&llm_model);
826            // Extract display name from the last segment for UI
827            let display_name = model_str
828                .rsplit('/')
829                .next()
830                .unwrap_or(&model_str)
831                .to_string();
832            LLMModel::Custom {
833                provider: "stakpak".to_string(),
834                model: model_str,
835                name: Some(display_name),
836            }
837        } else {
838            llm_model
839        };
840
841        let llm_messages = vec![
842            LLMMessage {
843                role: Role::System.to_string(),
844                content: LLMMessageContent::String(TITLE_GENERATOR_PROMPT.to_string()),
845            },
846            LLMMessage {
847                role: Role::User.to_string(),
848                content: LLMMessageContent::String(
849                    messages
850                        .iter()
851                        .map(|msg| {
852                            msg.content
853                                .as_ref()
854                                .unwrap_or(&MessageContent::String("".to_string()))
855                                .to_string()
856                        })
857                        .collect(),
858                ),
859            },
860        ];
861
862        let input = LLMInput {
863            model,
864            messages: llm_messages,
865            max_tokens: 100,
866            tools: None,
867            provider_options: None,
868            headers: None,
869        };
870
871        let response = self.stakai.chat(input).await.map_err(|e| e.to_string())?;
872
873        Ok(response.choices[0].message.content.to_string())
874    }
875}