claude-codes 2.1.310

Typed Rust SDK for the Claude Code agent CLI: serde models of its JSON-Lines (stream-json) protocol with streaming parsing, plus sync and async (Tokio) clients for driving Claude Code sessions, tools, and subagents.
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

//! Coverage for the CLI 2.1.304 stream-json drift.
//!
//! 2.1.303 → 2.1.304 added one optional nested object, no new message types
//! and no removals: `usageCreditOffer` on `rate_limit_event.rate_limit_info`.
//!
//! Each frame below carries the new field and is asserted **fully wrapped** —
//! the typed model captures every wire field with nothing left in an untyped
//! escape hatch.

use claude_codes::{assert_fully_wrapped, ClaudeOutput, UsageCreditOfferKind};
use serde_json::json;

/// A rejected rate-limit frame from a VS Code extension session carries the
/// account's limited-time usage-credit offer.
#[test]
fn rate_limit_info_carries_usage_credit_offer() {
    let frame = json!({
        "type": "rate_limit_event",
        "rate_limit_info": {
            "status": "rejected",
            "resetsAt": 1700003600,
            "rateLimitType": "five_hour",
            "errorCode": "credits_required",
            "canUserPurchaseCredits": true,
            "usageCreditOffer": {
                "kind": "extra_credit",
                "headlinePct": 25,
                "daysLeft": 6,
                "label": "25% extra usage credit, 6 days left"
            }
        },
        "uuid": "u1",
        "session_id": "s1"
    });
    assert_fully_wrapped(&frame);

    let ClaudeOutput::RateLimitEvent(evt) = serde_json::from_value(frame).unwrap() else {
        panic!("expected RateLimitEvent");
    };
    let offer = evt.rate_limit_info.usage_credit_offer.unwrap();
    assert_eq!(offer.kind, UsageCreditOfferKind::ExtraCredit);
    assert_eq!(offer.headline_pct, 25);
    assert_eq!(offer.days_left, 6);
    assert_eq!(offer.label, "25% extra usage credit, 6 days left");
}