harn-stdlib 0.9.13

Embedded Harn standard library source catalog
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

/**
 * Merge annotations carried directly on a tool registry entry. Entry-local
 * metadata overrides entry policy defaults.
 *
 * @effects: []
 * @errors: []
 * @api_stability: experimental
 */
pub fn agent_tool_entry_annotations(entry) {
  if type_of(entry) != "dict" {
    return {}
  }
  var annotations = {}
  let policy = entry?.policy
  if type_of(policy) == "dict" {
    annotations = annotations + policy
  }
  let direct = entry?.annotations
  if type_of(direct) == "dict" {
    annotations = annotations + direct
  }
  let func = entry?.function
  if type_of(func) == "dict" && type_of(func?.policy) == "dict" {
    annotations = annotations + func.policy
  }
  if type_of(func) == "dict" && type_of(func?.annotations) == "dict" {
    annotations = annotations + func.annotations
  }
  return annotations
}

/**
 * Return policy-level annotations for one tool name. Empty or malformed
 * policy annotation maps are ignored.
 *
 * @effects: []
 * @errors: []
 * @api_stability: experimental
 */
pub fn agent_tool_policy_annotations(policy, tool_name) {
  if type_of(policy) != "dict" {
    return {}
  }
  let registry = policy?.tool_annotations ?? policy?.toolAnnotations ?? {}
  if type_of(registry) != "dict" {
    return {}
  }
  let annotations = registry[tool_name]
  if type_of(annotations) == "dict" {
    return annotations
  }
  return {}
}

/**
 * Merge policy-level annotations with registry-entry annotations. Policy
 * annotations provide defaults; direct registry metadata wins.
 *
 * @effects: []
 * @errors: []
 * @api_stability: experimental
 */
pub fn agent_tool_annotations(entry, policy, tool_name) {
  return agent_tool_policy_annotations(policy, tool_name) + agent_tool_entry_annotations(entry)
}