lha-core 1.0.2

Minimal agent SDK for LHA with session runtime, tools, skills, and optional MCP adapters.
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

use crate::input::InputQueue;
use crate::session::SessionId;
use crate::session::SubmissionId;
use lha_llm::ItemHandle;
use lha_llm::RuntimeNotice;
use lha_llm::SemanticOutputItem;
use lha_llm::ToolCallRequest;
use lha_llm::ToolResultItem;
use lha_llm::TranscriptItem;

#[derive(Debug, Clone, PartialEq, Eq)]
pub enum TurnItemDelta {
    OutputText { delta: String },
    ProposedPlan { delta: String },
    ReasoningSummary { delta: String, summary_index: i64 },
    ReasoningContent { delta: String, content_index: i64 },
    ReasoningSummaryPartAdded { summary_index: i64 },
}

#[derive(Debug, Clone, PartialEq, Eq)]
pub struct TurnSummary {
    pub needs_follow_up: bool,
    pub last_agent_message: Option<String>,
    pub response_total_tokens: Option<i64>,
    pub tool_output_tokens: i64,
}

#[derive(Debug, Clone, PartialEq)]
pub enum AgentEvent {
    SessionStarted {
        session_id: SessionId,
    },
    SessionStatusChanged {
        session_id: SessionId,
        status: crate::SessionStatus,
    },
    InputQueued {
        session_id: SessionId,
        queue: InputQueue,
        items: Vec<TranscriptItem>,
    },
    TurnStarted {
        session_id: SessionId,
        submission_id: SubmissionId,
    },
    RuntimeNotice {
        session_id: SessionId,
        notice: RuntimeNotice,
    },
    OutputItemStarted {
        session_id: SessionId,
        submission_id: SubmissionId,
        handle: ItemHandle,
        item: SemanticOutputItem,
    },
    OutputItemDelta {
        session_id: SessionId,
        submission_id: SubmissionId,
        handle: ItemHandle,
        delta: TurnItemDelta,
    },
    OutputItemCompleted {
        session_id: SessionId,
        submission_id: SubmissionId,
        handle: ItemHandle,
        item: SemanticOutputItem,
    },
    ToolCallRequested {
        session_id: SessionId,
        submission_id: SubmissionId,
        call: ToolCallRequest,
    },
    ToolCallCompleted {
        session_id: SessionId,
        submission_id: SubmissionId,
        response: ToolResultItem,
    },
    ServerReasoningIncluded {
        session_id: SessionId,
        included: bool,
    },
    ModelsEtagUpdated {
        session_id: SessionId,
        etag: String,
    },
    TurnCompleted {
        session_id: SessionId,
        submission_id: SubmissionId,
        outcome: TurnSummary,
    },
    TurnFailed {
        session_id: SessionId,
        submission_id: SubmissionId,
        error: String,
    },
    TurnAborted {
        session_id: SessionId,
        submission_id: SubmissionId,
    },
}