starweaver-context 0.10.0

Agent context, checkpoint state, and runtime evidence contracts for Starweaver
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

//! Durable agent-owned state used by tool bundles.

use std::collections::{BTreeMap, BTreeSet};

use serde::{Deserialize, Serialize};
use starweaver_core::Metadata;

use crate::TaskManager;

/// Durable agent-owned state used by tool bundles.
///
/// This component keeps shell, task, deferred-call, handoff-file, and dynamic
/// tool-search state out of the lifecycle-wide [`crate::AgentContext`] root.
/// It is flattened during context serialization to preserve the established
/// v0 wire shape while giving runtime code an explicit ownership boundary.
#[derive(Clone, Default, Deserialize, Serialize)]
pub struct AgentToolState {
    /// Legacy execution environment accepted on restore but never serialized.
    #[serde(default, rename = "shell_env", skip_serializing)]
    pub shell_environment: BTreeMap<String, String>,
    /// Metadata for deferred tool calls.
    #[serde(
        default,
        rename = "deferred_tool_metadata",
        skip_serializing_if = "BTreeMap::is_empty"
    )]
    pub deferred_call_metadata: BTreeMap<String, Metadata>,
    /// Files to auto-load on the next request.
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub auto_load_files: Vec<String>,
    /// Agent-managed task state.
    #[serde(
        default,
        rename = "task_manager",
        skip_serializing_if = "TaskManager::is_empty"
    )]
    pub tasks: TaskManager,
    /// Tool names loaded through dynamic tool search.
    #[serde(
        default,
        rename = "tool_search_loaded_tools",
        skip_serializing_if = "Vec::is_empty"
    )]
    pub loaded_tool_names: Vec<String>,
    /// Namespace identifiers loaded through dynamic tool search.
    #[serde(
        default,
        rename = "tool_search_loaded_namespaces",
        skip_serializing_if = "Vec::is_empty"
    )]
    pub loaded_tool_namespaces: Vec<String>,
    /// Applied background-subagent context-delta operation ids.
    #[serde(
        default,
        rename = "background_context_delta_ids",
        skip_serializing_if = "BTreeSet::is_empty"
    )]
    pub background_context_delta_ids: BTreeSet<String>,
}

impl std::fmt::Debug for AgentToolState {
    fn fmt(&self, formatter: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        formatter
            .debug_struct("AgentToolState")
            .field(
                "shell_environment_keys",
                &self.shell_environment.keys().collect::<Vec<_>>(),
            )
            .field("deferred_call_metadata", &self.deferred_call_metadata)
            .field("auto_load_files", &self.auto_load_files)
            .field("tasks", &self.tasks)
            .field("loaded_tool_names", &self.loaded_tool_names)
            .field("loaded_tool_namespaces", &self.loaded_tool_namespaces)
            .field(
                "background_context_delta_ids",
                &self.background_context_delta_ids,
            )
            .finish()
    }
}