chunk-your-tools 2.0.3

MCP tool schema decomposition and recomposition
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

//! Canonical manifest of chunk-your-tools C FFI exports.

/// One exported `chunk_your_tools_*` C symbol.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct FfiExport {
    pub name: &'static str,
    pub category: &'static str,
}

/// All exported FFI symbols grouped by module category.
pub const EXPORTS: &[FfiExport] = &[
    export("chunk_your_tools_clear_error", "core"),
    export("chunk_your_tools_free_string", "core"),
    export("chunk_your_tools_get_last_error", "core"),
    export("chunk_your_tools_get_version", "core"),
    export("chunk_your_tools_build_catalog_index", "build"),
    export("chunk_your_tools_build_catalog_from_tools", "build"),
    export("chunk_your_tools_catalog_tool_count", "build"),
    export(
        "chunk_your_tools_anthropic_tools_to_catalog_entries",
        "build",
    ),
    export("chunk_your_tools_anthropic_tool_to_catalog_entry", "build"),
    export("chunk_your_tools_prepare_tool_entry", "build"),
    export("chunk_your_tools_truncate_description", "build"),
    export("chunk_your_tools_catalog_index_to_catalog_dict", "build"),
    export(
        "chunk_your_tools_catalog_index_tool_schema_metadata",
        "build",
    ),
    export("chunk_your_tools_catalog_builder_new", "build"),
    export("chunk_your_tools_catalog_builder_free", "build"),
    export("chunk_your_tools_catalog_builder_add_tool", "build"),
    export("chunk_your_tools_catalog_builder_get_tool_info", "build"),
    export("chunk_your_tools_catalog_builder_build_index", "build"),
    export("chunk_your_tools_catalog_builder_write_catalog", "build"),
    export("chunk_your_tools_catalog_builder_to_catalog_dict", "build"),
    export("chunk_your_tools_write_catalog_index", "build"),
    export("chunk_your_tools_configure_runtime_defaults", "runtime"),
    export("chunk_your_tools_runtime_decomposed_score", "runtime"),
    export("chunk_your_tools_runtime_enum_score", "runtime"),
    export("chunk_your_tools_runtime_rerank_score", "runtime"),
    export(
        "chunk_your_tools_runtime_empty_optional_fallback_k",
        "runtime",
    ),
    export("chunk_your_tools_runtime_default_system_policy", "runtime"),
    export("chunk_your_tools_runtime_default_mcp_policy", "runtime"),
    export("chunk_your_tools_configure_path_constants", "paths"),
    export("chunk_your_tools_collect_enums", "paths"),
    export("chunk_your_tools_to_decomposed_key", "paths"),
    export("chunk_your_tools_tool_id_from_decomposed_rel", "paths"),
    export("chunk_your_tools_get_root_tool_key", "paths"),
    export("chunk_your_tools_path_md_ext", "paths"),
    export("chunk_your_tools_path_json_ext", "paths"),
    export("chunk_your_tools_path_decomposed_prefix", "paths"),
    export("chunk_your_tools_path_decomposed_root", "paths"),
    export("chunk_your_tools_path_catalog_prefix", "paths"),
    export("chunk_your_tools_path_default_catalog_dir", "paths"),
    export("chunk_your_tools_path_builder_memory_only", "paths"),
    export("chunk_your_tools_path_write_catalog_prune", "paths"),
    export("chunk_your_tools_tool_policies", "policies"),
    export("chunk_your_tools_policy_context_from_values", "policies"),
    export("chunk_your_tools_effective_policy", "policies"),
    export("chunk_your_tools_tool_pass_through", "policies"),
    export("chunk_your_tools_batch_tool_pass_through", "policies"),
    export("chunk_your_tools_partition_catalog", "policies"),
    export("chunk_your_tools_merge_catalog", "policies"),
    export("chunk_your_tools_catalog_needs_partition", "policies"),
    export(
        "chunk_your_tools_catalog_needs_pruned_recompose",
        "policies",
    ),
    export("chunk_your_tools_request_pass_through", "policies"),
    export("chunk_your_tools_full_pass_through", "policies"),
    export("chunk_your_tools_needs_partition", "policies"),
    export("chunk_your_tools_needs_pruned_recompose", "policies"),
    export("chunk_your_tools_system_tools_pass_through", "policies"),
    export("chunk_your_tools_mcp_tools_pass_through", "policies"),
    export("chunk_your_tools_needs_description_reinstate", "policies"),
    export("chunk_your_tools_is_decomposed_tool_root_chunk", "policies"),
    export(
        "chunk_your_tools_is_decomposed_optional_property_chunk",
        "policies",
    ),
    export("chunk_your_tools_is_system_chunk", "policies"),
    export("chunk_your_tools_is_non_system_chunk", "policies"),
    export("chunk_your_tools_is_system_root_chunk", "policies"),
    export("chunk_your_tools_is_mcp_root_chunk", "policies"),
    export("chunk_your_tools_is_system_optional_chunk", "policies"),
    export("chunk_your_tools_is_mcp_optional_chunk", "policies"),
    export(
        "chunk_your_tools_is_direct_root_optional_property_chunk",
        "policies",
    ),
    export("chunk_your_tools_root_chunk_properties_empty", "policies"),
    export(
        "chunk_your_tools_classify_optional_chunks_batch",
        "policies",
    ),
    export("chunk_your_tools_stash_system_tools", "policies"),
    export("chunk_your_tools_restore_system_tools", "policies"),
    export("chunk_your_tools_stash_mcp_tools", "policies"),
    export("chunk_your_tools_restore_mcp_tools", "policies"),
    export("chunk_your_tools_merge_tools_preserving_order", "policies"),
    export("chunk_your_tools_split_anthropic_tools", "policies"),
    export("chunk_your_tools_filter_recompose_json_entries", "policies"),
    export(
        "chunk_your_tools_mitigate_empty_optional_properties",
        "policies",
    ),
    export(
        "chunk_your_tools_append_description_reinstate_entries",
        "policies",
    ),
    export("chunk_your_tools_is_description_policy", "policies"),
    export("chunk_your_tools_scoring_policy", "policies"),
    export(
        "chunk_your_tools_drop_recomposed_tools_with_empty_properties",
        "policies",
    ),
    export("chunk_your_tools_root_tool_id_from_chunk", "policies"),
    export("chunk_your_tools_chunk_tool_id", "policies"),
    export("chunk_your_tools_is_non_system_tool_id", "policies"),
    export("chunk_your_tools_is_system_tool_id", "policies"),
    export("chunk_your_tools_entries_for_policy", "policies"),
    export("chunk_your_tools_tools_for_catalog", "policies"),
    export("chunk_your_tools_system_required_enum_values", "policies"),
    export("chunk_your_tools_mcp_required_enum_values", "policies"),
    export("chunk_your_tools_required_enum_values_by_tool", "policies"),
    export("chunk_your_tools_optional_leaf_survived_rerank", "policies"),
    export("chunk_your_tools_anthropic_tool_is_system", "policies"),
    export("chunk_your_tools_anthropic_tool_is_mcp", "policies"),
    export(
        "chunk_your_tools_direct_root_optional_chunks_for_tool",
        "policies",
    ),
    export(
        "chunk_your_tools_tool_id_has_empty_decomposed_root",
        "policies",
    ),
    export(
        "chunk_your_tools_tool_id_had_empty_original_root_properties",
        "policies",
    ),
    export("chunk_your_tools_decomposed_catalog_new", "retrieve"),
    export("chunk_your_tools_decomposed_catalog_free", "retrieve"),
    export(
        "chunk_your_tools_decomposed_catalog_from_catalog_index",
        "retrieve",
    ),
    export(
        "chunk_your_tools_decomposed_catalog_from_catalog_dict",
        "retrieve",
    ),
    export("chunk_your_tools_decomposed_catalog_has_json", "retrieve"),
    export("chunk_your_tools_decomposed_catalog_get_json", "retrieve"),
    export("chunk_your_tools_load_catalog", "retrieve"),
    export("chunk_your_tools_retrieve_tools", "retrieve"),
    export("chunk_your_tools_retrieve_core", "retrieve"),
    export("chunk_your_tools_chunk_survivor_key", "retrieve"),
    export("chunk_your_tools_removed_chunks", "retrieve"),
    export("chunk_your_tools_retrieve_catalog_tool_count", "retrieve"),
    export("chunk_your_tools_resolve_build_catalog", "retrieve"),
];

const fn export(name: &'static str, category: &'static str) -> FfiExport {
    FfiExport { name, category }
}

/// N-API-only exports (Node/TypeScript SDK).
pub const NAPI_EXPORTS: &[&str] = &[
    "resolveBuildCatalog",
    "resolveSurvivorsFromNames",
    "recomposeToolsFromNames",
    "retrieveCatalogToolCount",
    "runtimeDefaultSystemPolicy",
    "runtimeDefaultMcpPolicy",
];

pub const CBINDGEN_STUB_SYMBOLS: &[&str] = &[
    "chunk_your_tools_full_pass_through",
    "chunk_your_tools_needs_description_reinstate",
    "chunk_your_tools_needs_partition",
    "chunk_your_tools_needs_pruned_recompose",
    "chunk_your_tools_system_tools_pass_through",
    "chunk_your_tools_mcp_tools_pass_through",
    "chunk_your_tools_tool_pass_through",
    "chunk_your_tools_is_decomposed_tool_root_chunk",
    "chunk_your_tools_is_decomposed_optional_property_chunk",
    "chunk_your_tools_is_system_chunk",
    "chunk_your_tools_is_non_system_chunk",
    "chunk_your_tools_is_system_root_chunk",
    "chunk_your_tools_is_mcp_root_chunk",
    "chunk_your_tools_is_system_optional_chunk",
    "chunk_your_tools_is_mcp_optional_chunk",
    "chunk_your_tools_is_direct_root_optional_property_chunk",
    "chunk_your_tools_root_chunk_properties_empty",
    "chunk_your_tools_stash_system_tools",
    "chunk_your_tools_restore_system_tools",
    "chunk_your_tools_stash_mcp_tools",
    "chunk_your_tools_restore_mcp_tools",
    "chunk_your_tools_path_md_ext",
    "chunk_your_tools_path_json_ext",
    "chunk_your_tools_path_decomposed_prefix",
    "chunk_your_tools_path_decomposed_root",
    "chunk_your_tools_path_catalog_prefix",
    "chunk_your_tools_path_default_catalog_dir",
];

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn exports_are_unique() {
        let mut seen = std::collections::HashSet::new();
        for exp in EXPORTS {
            assert!(seen.insert(exp.name), "duplicate export: {}", exp.name);
        }
    }

    #[test]
    fn cbindgen_stubs_listed_in_exports() {
        for name in CBINDGEN_STUB_SYMBOLS {
            assert!(
                EXPORTS.iter().any(|e| e.name == *name),
                "stub symbol missing from EXPORTS: {name}"
            );
        }
    }
}