agent-sdk-toolkit 0.1.0-alpha.3

Optional tool-pack helpers layered over agent-sdk-core primitive contracts.
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

//! Toolkit pack assembly helpers. Use these modules to turn toolkit operations into
//! core package capabilities, sidecars, and routes. Pack assembly is data-only and
//! does not execute tools or mutate a runtime package until explicitly installed.
//! This file contains the snapshot portion of that contract.
//!
use agent_sdk_core::{
    CapabilityId, CapabilityNamespace, ExecutorRef, PolicyRef, PrivacyClass, SourceRef,
    ToolPackToolSnapshot,
    policy::{CapabilityPermission, EffectClass, RiskClass},
    tool_records::CanonicalToolName,
};

/// Returns tool snapshot for the current value.
/// This is a read-only or data-construction helper unless the method body explicitly calls a
/// port or store.
#[expect(
    clippy::too_many_arguments,
    reason = "toolkit snapshot assembly mirrors the core capability sidecar fields; a builder is a separate toolkit API ergonomics pass"
)]
pub fn tool_snapshot(
    capability_id: &str,
    tool_name: &str,
    executor_ref: &str,
    schema_id: &str,
    policy_refs: Vec<PolicyRef>,
    required_permissions: Vec<CapabilityPermission>,
    effect_class: EffectClass,
    risk_class: RiskClass,
    _source: &SourceRef,
) -> ToolPackToolSnapshot {
    ToolPackToolSnapshot {
        capability_id: CapabilityId::new(capability_id),
        canonical_tool_name: CanonicalToolName::new(tool_name),
        namespace: CapabilityNamespace::new(format!("tool.{tool_name}")),
        schema_ref: agent_sdk_core::PackageSidecarRef::new(schema_id, "tool_schema", "v1"),
        executor_ref: ExecutorRef::new(executor_ref),
        policy_refs,
        required_permissions,
        effect_class,
        risk_class,
        redaction_policy_ref: PolicyRef::with_kind(
            agent_sdk_core::PolicyKind::Redaction,
            "policy.redaction.tool_result.refs_only",
        ),
        timeout_ms: 10_000,
        cancellation: "best_effort".to_string(),
        reconciliation: "effect_lineage_required".to_string(),
        privacy: PrivacyClass::ContentRefsOnly,
    }
}