nanocodex-tools 0.3.0

Code Mode and heterogeneous tool runtime for Nanocodex
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

#![doc = include_str!("../README.md")]
#![deny(missing_docs, rustdoc::broken_intra_doc_links)]
#![cfg_attr(docsrs, feature(doc_cfg))]
#![cfg_attr(target_family = "wasm", allow(clippy::module_name_repetitions))]

#[cfg(not(target_family = "wasm"))]
mod apply_patch;
#[cfg(not(target_family = "wasm"))]
#[cfg_attr(docsrs, doc(cfg(not(target_family = "wasm"))))]
pub mod code_mode;
pub mod hosted;
#[cfg(not(target_family = "wasm"))]
#[cfg_attr(docsrs, doc(cfg(not(target_family = "wasm"))))]
pub mod image;
#[cfg(not(target_family = "wasm"))]
mod image_generation;
#[cfg(not(target_family = "wasm"))]
#[cfg_attr(docsrs, doc(cfg(not(target_family = "wasm"))))]
pub mod mcp;
#[cfg(not(target_family = "wasm"))]
mod plan;
#[cfg(not(target_family = "wasm"))]
#[cfg_attr(docsrs, doc(cfg(not(target_family = "wasm"))))]
pub mod runtime;
mod runtime_config;
#[cfg(not(target_family = "wasm"))]
mod shell;
#[cfg(not(target_family = "wasm"))]
#[cfg_attr(docsrs, doc(cfg(not(target_family = "wasm"))))]
pub mod standard;
#[cfg(not(target_family = "wasm"))]
mod view_image;
#[cfg(not(target_family = "wasm"))]
mod web_search;

/// Model-visible tool definitions, inputs, outputs, and execution contracts.
pub mod contract {
    #[cfg(not(target_family = "wasm"))]
    #[cfg_attr(docsrs, doc(cfg(not(target_family = "wasm"))))]
    pub use async_trait::async_trait;
    pub use nanocodex_oai_api::tools::{
        DEFAULT_TOOL_OUTPUT_TOKENS, Tool, ToolContext, ToolDefinition, ToolError, ToolInput,
        ToolInputError, ToolOutput, ToolOutputBody, ToolOutputContent, ToolOutputWire,
        ToolProcessTraceWire, ToolResult,
    };
}

#[cfg(target_family = "wasm")]
/// Code Mode results and observation contracts for the host-backed WASM runtime.
pub mod code_mode {
    pub use crate::hosted::{
        CodeModeExecution, CodeModeNotification, CodeModeObserver, CodeModeUpdate, NestedToolCall,
    };
}

#[cfg(target_family = "wasm")]
/// Image input and output preparation for the host-backed WASM runtime.
pub mod image {
    pub use crate::hosted::{prepare_output_images, prepare_user_input};
    pub use nanocodex_oai_api::ImageDetail;
}

#[cfg(target_family = "wasm")]
/// Host-backed tool selection and execution runtime.
pub mod runtime {
    pub use crate::{
        hosted::{
            HostedToolRuntime as ToolRuntime, HostedToolRuntimeControl as ToolRuntimeControl,
            HostedTools as Tools, OwnedToolContext,
        },
        runtime_config::{ImageGenerationConfig, WebSearchConfig},
    };
}

pub use contract::{Tool, ToolContext, ToolDefinition, ToolInput, ToolOutput, ToolResult};
#[cfg(not(target_family = "wasm"))]
pub(crate) use contract::{ToolOutputBody, ToolOutputContent};
#[cfg(not(target_family = "wasm"))]
pub(crate) use image::ImageDetail;
#[cfg(not(target_family = "wasm"))]
#[cfg_attr(docsrs, doc(cfg(not(target_family = "wasm"))))]
pub use nanocodex_tools_macros::tool;
pub use runtime::Tools;
#[cfg(not(target_family = "wasm"))]
pub(crate) use runtime::{DynamicToolProvider, ImageGenerationConfig, WebSearchConfig};
#[cfg(not(target_family = "wasm"))]
#[cfg_attr(docsrs, doc(cfg(not(target_family = "wasm"))))]
pub use runtime::{ToolsBuildError, ToolsBuilder};
#[cfg(not(target_family = "wasm"))]
pub(crate) use standard::StandardTool;

#[doc(hidden)]
pub mod __private {
    #[cfg(not(target_family = "wasm"))]
    pub use async_trait::async_trait;
    #[cfg(not(target_family = "wasm"))]
    pub use schemars;
    #[cfg(not(target_family = "wasm"))]
    pub use serde;

    #[cfg(not(target_family = "wasm"))]
    pub use crate::{
        Tool, ToolContext, ToolDefinition, ToolInput, ToolOutput, ToolResult, runtime::schema_for,
    };

    /// Builds the direct Responses tool prefix and the nested Code Mode name map together.
    pub fn model_contract(
        runtime: &crate::runtime::ToolRuntime,
        session_id: &str,
    ) -> (
        Vec<nanocodex_oai_api::tools::ToolDefinition>,
        Vec<(String, String)>,
    ) {
        runtime.model_contract(session_id)
    }
}