Skip to main content

v1.4.0

Released: April 12, 2026

Highlights​

  • Kubernetes tools — 11 new k8s.* tools for cluster management via kubectl
  • Human-in-the-Loop (HITL) — configurable confirmation prompts for sensitive action tools with risk levels and bypass rules
  • Hybrid search (@toolpack-sdk/knowledge) — combine semantic and keyword search with tunable weighting
  • New knowledge sources — WebURLSource and APISource for indexing web pages and REST API responses
  • Persistent Knowledge Provider — disk-based storage that survives restarts

Breaking changes​

  • Knowledge.create() now accepts KnowledgeOptions with additional optional callbacks (onError, onSync, onEmbeddingProgress, streamingBatchSize)
  • QueryOptions extended with searchType and semanticWeight — fully backward compatible (both optional)

toolpack-sdk​

Kubernetes tools​

11 new tools in the k8s category: k8s.list_pods, k8s.describe, k8s.get_logs, k8s.apply_manifest, k8s.delete_resource, k8s.list_services, k8s.list_deployments, k8s.get_config_map, k8s.switch_context, k8s.get_namespaces, k8s.wait_for_deployment.

Human-in-the-Loop confirmation​

const client = new AIClient({
  hitlConfig: {
    enabled: true,
    bypassCategories: ['coding'],
    bypassTools: ['fs.read_file'],
  },
});

Tools declare their risk level via a confirmation property (level: 'high' | 'medium'). All built-in action tools are updated with HITL configuration.

@toolpack-sdk/knowledge​

const results = await knowledge.query('search term', {
  searchType: 'hybrid',   // 'semantic' | 'keyword' | 'hybrid'
  semanticWeight: 0.7,    // 70% semantic, 30% keyword
});

New sources​

import { WebURLSource, APISource } from '@toolpack-sdk/knowledge';

const webSource = new WebURLSource({ name: 'docs', urls: ['https://docs.example.com'] });
const apiSource = new APISource({ name: 'api', endpoint: 'https://api.example.com/docs' });

Sync event handling​

await Knowledge.create({
  // ...
  onEmbeddingProgress: (e) => console.log(`${e.percent}%`),
  onSync: (e) => console.log(e.type),
  onError: (err) => 'skip',
});

Install​

npm install toolpack-sdk@1.4.0
npm install @toolpack-sdk/knowledge@1.4.0