chasm-cli 2.0.0

Universal chat session manager - harvest, merge, and analyze AI chat history from VS Code, Cursor, and other editors
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
//! Cloud provider examples for CSM library
//!
//! Demonstrates working with cloud LLM providers:
//! - ChatGPT (OpenAI)
//! - Claude (Anthropic)
//! - Perplexity AI
//! - DeepSeek
//! - Google Gemini
//! - Microsoft 365 Copilot
//!
//! Run with: cargo run --example cloud_providers

use chasm::providers::cloud::anthropic::parse_claude_export;
use chasm::providers::cloud::chatgpt::parse_chatgpt_export;
#[allow(unused_imports)]
use chasm::providers::cloud::deepseek::parse_deepseek_export;
#[allow(unused_imports)]
use chasm::providers::cloud::gemini::parse_gemini_export;
use chasm::providers::cloud::m365copilot::{get_friendly_app_name, parse_m365_copilot_export};
#[allow(unused_imports)]
use chasm::providers::cloud::perplexity::parse_perplexity_export;
use chasm::providers::{
    CloudConversation, CloudMessage, FetchOptions, GenericMessage, GenericSession, ProviderType,
};
use chrono::{TimeZone, Utc};

fn main() -> anyhow::Result<()> {
    println!("=== CSM Cloud Provider Examples ===\n");

    // ========================================================================
    // Example 1: List all cloud providers
    // ========================================================================
    println!("1. Available cloud providers:");

    let cloud_providers = vec![
        (ProviderType::ChatGPT, "OPENAI_API_KEY"),
        (ProviderType::Anthropic, "ANTHROPIC_API_KEY"),
        (ProviderType::Perplexity, "PERPLEXITY_API_KEY"),
        (ProviderType::DeepSeek, "DEEPSEEK_API_KEY"),
        (ProviderType::Gemini, "GOOGLE_API_KEY"),
        (ProviderType::M365Copilot, "MICROSOFT_GRAPH_TOKEN"),
        (ProviderType::Mistral, "MISTRAL_API_KEY"),
        (ProviderType::Cohere, "COHERE_API_KEY"),
        (ProviderType::Groq, "GROQ_API_KEY"),
        (ProviderType::Together, "TOGETHER_API_KEY"),
    ];

    for (provider, env_var) in &cloud_providers {
        let has_key = std::env::var(env_var).is_ok();
        let status = if has_key { "+" } else { "o" };
        println!("   {} {} ({})", status, provider.display_name(), env_var);
    }

    // ========================================================================
    // Example 2: Parse ChatGPT export data
    // ========================================================================
    println!("\n2. Parsing ChatGPT export:");

    // ChatGPT export format uses "mapping" with nested messages
    let chatgpt_export = r#"[
        {
            "id": "conv-001",
            "title": "Rust Programming",
            "create_time": 1700000000.0,
            "update_time": 1700001000.0,
            "mapping": {
                "node-1": {
                    "id": "node-1",
                    "message": {
                        "id": "msg-1",
                        "author": {"role": "user"},
                        "content": {"parts": ["How do I use iterators in Rust?"]},
                        "create_time": 1700000000.0
                    }
                },
                "node-2": {
                    "id": "node-2",
                    "message": {
                        "id": "msg-2",
                        "author": {"role": "assistant"},
                        "content": {"parts": ["Iterators in Rust are lazy and powerful..."]},
                        "create_time": 1700000100.0
                    }
                }
            }
        }
    ]"#;

    match parse_chatgpt_export(chatgpt_export) {
        Ok(conversations) => {
            println!("   Parsed {} conversation(s)", conversations.len());
            for conv in &conversations {
                println!(
                    "   - {} ({} messages)",
                    conv.title.as_deref().unwrap_or("Untitled"),
                    conv.messages.len()
                );
            }
        }
        Err(e) => println!("   Parse error: {}", e),
    }

    // ========================================================================
    // Example 3: Parse Claude export data
    // ========================================================================
    println!("\n3. Parsing Claude export:");

    // Claude export format uses "chat_messages" array
    let claude_export = r#"[
        {
            "uuid": "claude-conv-001",
            "name": "Python Data Analysis",
            "created_at": "2024-01-15T10:30:00Z",
            "updated_at": "2024-01-15T11:00:00Z",
            "chat_messages": [
                {
                    "uuid": "msg-001",
                    "sender": "human",
                    "text": "How do I read a CSV file in pandas?",
                    "created_at": "2024-01-15T10:30:00Z"
                },
                {
                    "uuid": "msg-002",
                    "sender": "assistant",
                    "text": "You can use pd.read_csv('file.csv')...",
                    "created_at": "2024-01-15T10:30:30Z"
                }
            ]
        }
    ]"#;

    match parse_claude_export(claude_export) {
        Ok(conversations) => {
            println!("   Parsed {} conversation(s)", conversations.len());
            for conv in &conversations {
                println!(
                    "   - {} ({} messages)",
                    conv.title.as_deref().unwrap_or("Untitled"),
                    conv.messages.len()
                );
            }
        }
        Err(e) => println!("   Parse error: {}", e),
    }

    // ========================================================================
    // Example 4: Parse M365 Copilot Graph API response
    // ========================================================================
    println!("\n4. Parsing Microsoft 365 Copilot data:");

    // M365 Copilot uses Microsoft Graph API response format
    let m365_export = r#"{
        "value": [
            {
                "id": "interaction-001",
                "createdDateTime": "2024-01-15T10:00:00Z",
                "appClass": "Office.Word",
                "body": {
                    "content": "<p>Help me write an introduction</p>"
                },
                "from": {
                    "user": {"displayName": "John Doe"}
                }
            },
            {
                "id": "interaction-002",
                "createdDateTime": "2024-01-15T10:00:30Z",
                "appClass": "Office.Word",
                "body": {
                    "content": "<p>Here's a professional introduction...</p>"
                },
                "from": {
                    "application": {"displayName": "Copilot"}
                }
            }
        ]
    }"#;

    match parse_m365_copilot_export(m365_export) {
        Ok(conversations) => {
            println!("   Parsed {} conversation(s)", conversations.len());
            for conv in &conversations {
                let app_name = get_friendly_app_name(
                    conv.metadata
                        .as_ref()
                        .and_then(|m| m.get("app_class"))
                        .and_then(|v| v.as_str())
                        .unwrap_or("Unknown"),
                );
                println!(
                    "   - {} in {} ({} messages)",
                    conv.title.as_deref().unwrap_or("Untitled"),
                    app_name,
                    conv.messages.len()
                );
            }
        }
        Err(e) => println!("   Parse error: {}", e),
    }

    // Show friendly app names
    println!("\n   M365 Copilot application contexts:");
    let app_classes = [
        "Office.Word",
        "Office.Excel",
        "Office.PowerPoint",
        "Office.Outlook",
        "Teams",
        "Bing",
    ];
    for app in &app_classes {
        println!("     {} -> {}", app, get_friendly_app_name(app));
    }

    // ========================================================================
    // Example 5: Create CloudConversation and convert to ChatSession
    // ========================================================================
    println!("\n5. CloudConversation to ChatSession conversion:");

    let cloud_conv = CloudConversation {
        id: "cloud-123".to_string(),
        title: Some("API Design Discussion".to_string()),
        created_at: Utc.with_ymd_and_hms(2024, 1, 15, 10, 0, 0).unwrap(),
        updated_at: Some(Utc.with_ymd_and_hms(2024, 1, 15, 11, 0, 0).unwrap()),
        model: Some("gpt-4".to_string()),
        messages: vec![
            CloudMessage {
                id: Some("msg-1".to_string()),
                role: "user".to_string(),
                content: "What are REST API best practices?".to_string(),
                timestamp: Some(Utc.with_ymd_and_hms(2024, 1, 15, 10, 0, 0).unwrap()),
                model: None,
            },
            CloudMessage {
                id: Some("msg-2".to_string()),
                role: "assistant".to_string(),
                content: "Here are key REST API best practices:\n\n1. Use nouns for resources\n2. Use HTTP methods correctly\n3. Version your API...".to_string(),
                timestamp: Some(Utc.with_ymd_and_hms(2024, 1, 15, 10, 0, 30).unwrap()),
                model: Some("gpt-4".to_string()),
            },
        ],
        metadata: Some(serde_json::json!({
            "source": "chatgpt",
            "exported_at": "2024-01-20"
        })),
    };

    println!("   Cloud conversation:");
    println!("     ID: {}", cloud_conv.id);
    println!("     Title: {:?}", cloud_conv.title);
    println!("     Model: {:?}", cloud_conv.model);
    println!("     Messages: {}", cloud_conv.messages.len());

    // Convert to VS Code format
    let chat_session = cloud_conv.to_chat_session("ChatGPT");
    println!("\n   Converted ChatSession:");
    println!("     Session ID: {:?}", chat_session.session_id);
    println!("     Is imported: {}", chat_session.is_imported);
    println!("     Requests: {}", chat_session.requests.len());
    println!("     Responder: {:?}", chat_session.responder_username);

    // ========================================================================
    // Example 6: FetchOptions for filtering cloud conversations
    // ========================================================================
    println!("\n6. FetchOptions configuration:");

    // Default options
    let default_opts = FetchOptions::default();
    println!("   Default options:");
    println!("     Limit: {:?}", default_opts.limit);
    println!("     Include archived: {}", default_opts.include_archived);

    // Custom options for date range
    let custom_opts = FetchOptions {
        limit: Some(100),
        after: Some(Utc.with_ymd_and_hms(2024, 1, 1, 0, 0, 0).unwrap()),
        before: Some(Utc.with_ymd_and_hms(2024, 12, 31, 23, 59, 59).unwrap()),
        include_archived: true,
        session_token: None,
    };

    println!("\n   Custom options (2024 conversations only):");
    println!("     Limit: {:?}", custom_opts.limit);
    println!("     After: {:?}", custom_opts.after);
    println!("     Before: {:?}", custom_opts.before);
    println!("     Include archived: {}", custom_opts.include_archived);

    // ========================================================================
    // Example 7: Export format detection
    // ========================================================================
    println!("\n7. Export format detection:");

    fn detect_export_format(json_data: &str) -> &'static str {
        if let Ok(value) = serde_json::from_str::<serde_json::Value>(json_data) {
            // M365 Copilot (Graph API response)
            if value.get("value").is_some() && value.get("@odata.context").is_some() {
                return "Microsoft 365 Copilot (Graph API)";
            }

            // M365 with just "value" array
            if value.get("value").is_some() {
                return "Microsoft 365 Copilot (Graph API)";
            }

            // Array format
            if let Some(arr) = value.as_array() {
                if let Some(first) = arr.first() {
                    // ChatGPT has "mapping" field
                    if first.get("mapping").is_some() {
                        return "ChatGPT";
                    }
                    // Claude has "chat_messages" field
                    if first.get("chat_messages").is_some() {
                        return "Claude (Anthropic)";
                    }
                    // Perplexity has "entries" field
                    if first.get("entries").is_some() {
                        return "Perplexity";
                    }
                    // DeepSeek has specific structure
                    if first.get("messages").is_some() && first.get("title").is_some() {
                        return "DeepSeek";
                    }
                    // Gemini structure
                    if first.get("contents").is_some() {
                        return "Google Gemini";
                    }
                }
            }
        }
        "Unknown format"
    }

    let test_formats = [
        (r#"[{"mapping": {}, "title": "Test"}]"#, "ChatGPT-like"),
        (r#"[{"chat_messages": [], "uuid": "123"}]"#, "Claude-like"),
        (r#"{"value": []}"#, "M365-like"),
    ];

    for (data, expected) in &test_formats {
        let detected = detect_export_format(data);
        println!("   {} -> {}", expected, detected);
    }

    // ========================================================================
    // Example 8: Cloud to Generic to ChatSession pipeline
    // ========================================================================
    println!("\n8. Full import pipeline:");

    // Simulate importing from cloud provider
    let imported_messages = vec![
        GenericMessage {
            role: "user".to_string(),
            content: "Explain async/await in JavaScript".to_string(),
            timestamp: Some(Utc::now().timestamp_millis()),
            model: None,
        },
        GenericMessage {
            role: "assistant".to_string(),
            content: "Async/await is syntactic sugar for Promises...".to_string(),
            timestamp: Some(Utc::now().timestamp_millis()),
            model: Some("claude-3-opus".to_string()),
        },
    ];

    let generic_session = GenericSession {
        id: "imported-001".to_string(),
        title: Some("JavaScript Async Help".to_string()),
        messages: imported_messages,
        created_at: Some(Utc::now().timestamp_millis()),
        updated_at: Some(Utc::now().timestamp_millis()),
        provider: Some("Claude".to_string()),
        model: Some("claude-3-opus".to_string()),
    };

    println!("   Step 1: Generic session created");
    println!("     Source: {:?}", generic_session.provider);
    println!("     Messages: {}", generic_session.messages.len());

    // Convert to ChatSession (VS Code format)
    let chat_session: chasm::models::ChatSession = generic_session.into();

    println!("   Step 2: Converted to ChatSession");
    println!("     Session ID: {:?}", chat_session.session_id);
    println!("     Is imported: {}", chat_session.is_imported);

    // Serialize to JSON (ready for VS Code)
    let session_json = serde_json::to_string_pretty(&chat_session)?;
    println!("   Step 3: Ready for VS Code import");
    println!("     JSON size: {} bytes", session_json.len());
    println!("     Preview:");
    for line in session_json.lines().take(8) {
        println!("       {}", line);
    }
    println!("       ...");

    // ========================================================================
    // Example 9: Provider endpoints and compatibility
    // ========================================================================
    println!("\n9. Cloud provider API information:");

    let providers_info = [
        (
            ProviderType::ChatGPT,
            "https://chat.openai.com/backend-api",
            "Session token",
        ),
        (
            ProviderType::Anthropic,
            "https://claude.ai/api",
            "Session token",
        ),
        (
            ProviderType::Perplexity,
            "https://www.perplexity.ai/api",
            "Session token",
        ),
        (
            ProviderType::DeepSeek,
            "https://chat.deepseek.com/api",
            "API key",
        ),
        (
            ProviderType::Gemini,
            "https://generativelanguage.googleapis.com/v1",
            "API key",
        ),
        (
            ProviderType::M365Copilot,
            "https://graph.microsoft.com/v1.0",
            "OAuth token",
        ),
    ];

    for (provider, endpoint, auth) in &providers_info {
        println!("   {}:", provider.display_name());
        println!("     Endpoint: {}", endpoint);
        println!("     Auth: {}", auth);
    }

    println!("\n=== Cloud Provider Examples Complete ===");
    Ok(())
}