nika-core 0.72.0

Lightweight AST and analysis core for Nika workflows
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

//! Static catalog of known `nika:*` builtin tool names.
//!
//! This list is used by the analyzer to validate `invoke: nika:xxx` references
//! at check time. It must be kept in sync with the runtime router in nika-engine.

/// All known nika:* builtin tool names (without the `nika:` prefix).
///
/// Categories:
/// - Core (7): sleep, log, emit, assert, prompt, run, complete
/// - File (5): read, write, edit, glob, grep
/// - Data (12): jq, tree_data, inject, map, filter, group_by, enrich,
///   json_merge, set_diff, zip, chunk, token_count
/// - Sprint 2 (6): json_verify, yaml_validate, locale_lookup, aggregate,
///   json_flatten, json_unflatten
/// - Introspection (4): dag_info, task_status, threads, orchestrate
/// - Cost/Records (2): cost, records
/// - Media always-on (5): import, decode, dimensions, thumbhash, dominant_color
/// - Media core (3): thumbnail, convert, strip
/// - Media opt-in (17): metadata, optimize, svg_render, chart, phash, compare,
///   pdf_extract, provenance, verify, qr_validate, quality, html_to_md,
///   css_select, extract_metadata, extract_links, readability, pipeline
pub static KNOWN_BUILTIN_TOOLS: &[&str] = &[
    // Core (7)
    "sleep",
    "log",
    "emit",
    "assert",
    "prompt",
    "run",
    "complete",
    // File (5)
    "read",
    "write",
    "edit",
    "glob",
    "grep",
    // Data (12)
    "jq",
    "tree_data",
    "inject",
    "map",
    "filter",
    "group_by",
    "enrich",
    "json_merge",
    "set_diff",
    "zip",
    "chunk",
    "token_count",
    // Sprint 2 (6)
    "json_verify",
    "yaml_validate",
    "locale_lookup",
    "aggregate",
    "json_flatten",
    "json_unflatten",
    // Introspection (4)
    "dag_info",
    "task_status",
    "threads",
    "orchestrate",
    // Cost / Records (2)
    "cost",
    "records",
    // Media always-on (5)
    "import",
    "decode",
    "dimensions",
    "thumbhash",
    "dominant_color",
    // Media core (3)
    "thumbnail",
    "convert",
    "strip",
    // Media opt-in (17)
    "metadata",
    "optimize",
    "svg_render",
    "chart",
    "phash",
    "compare",
    "pdf_extract",
    "provenance",
    "verify",
    "qr_validate",
    "quality",
    "html_to_md",
    "css_select",
    "extract_metadata",
    "extract_links",
    "readability",
    "pipeline",
];

/// Check if a tool name (without nika: prefix) is a known builtin.
pub fn is_known_builtin(name: &str) -> bool {
    KNOWN_BUILTIN_TOOLS.contains(&name)
}

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

    #[test]
    fn test_known_builtins_count() {
        // 7 + 5 + 12 + 6 + 4 + 2 + 5 + 3 + 17 = 61
        assert_eq!(KNOWN_BUILTIN_TOOLS.len(), 61);
    }

    #[test]
    fn test_is_known_builtin() {
        assert!(is_known_builtin("sleep"));
        assert!(is_known_builtin("jq"));
        assert!(is_known_builtin("pipeline"));
        assert!(!is_known_builtin("typo_tool"));
        assert!(!is_known_builtin("json_query")); // deprecated, removed
    }
}