@inneranimalmedia/agentsam-sdk 2.4.1 → 2.6.0

package/protocol/capabilities/manifest.json

@@ -57,7 +57,7 @@
       "runtime": "node",
       "package": "@inneranimalmedia/agentsam-sdk/knowledge",
       "cli": "agentsam index run",
-      "description": "Build a coherent incremental AST/text generation with optional embeddings.",
+      "description": "Build the SDK local/portable coherent incremental structural/text generation with optional embeddings.",
       "deterministic": true,
       "model_required": false,
       "side_effects": "local-state",
@@ -71,7 +71,7 @@
       "runtime": "node",
       "package": "@inneranimalmedia/agentsam-sdk/knowledge",
       "cli": "agentsam search \"query\"",
-      "description": "Retrieve bounded repository context from a published knowledge generation.",
+      "description": "Retrieve bounded repository context from the SDK local/portable published knowledge generation.",
       "deterministic": true,
       "model_required": false,
       "side_effects": "none",
@@ -113,7 +113,7 @@
       "runtime": "node",
       "package": "@inneranimalmedia/agentsam-sdk/security",
       "cli": "agentsam security scan",
-      "description": "Inventory dependency state and optionally query vulnerability evidence.",
+      "description": "Scan dependency vulnerability evidence and Merkle-bound AST execution trust boundaries; return deterministic contradiction and repair evidence.",
       "deterministic": true,
       "model_required": false,
       "side_effects": "network-optional",
@@ -250,6 +250,82 @@
       "model_required": false,
       "side_effects": "artifact-write",
       "status": "experimental"
+    },
+    "tools.search": {
+      "id": "tools.search",
+      "kind": "capability",
+      "version": 1,
+      "domain": "agent",
+      "runtime": "node",
+      "package": "@inneranimalmedia/agentsam-sdk/tools",
+      "export": "searchToolCards",
+      "description": "Discover compact capability cards without injecting the full tool catalog or full schemas.",
+      "deterministic": true,
+      "model_required": false,
+      "side_effects": "none",
+      "status": "experimental"
+    },
+    "context.resolve": {
+      "id": "context.resolve",
+      "kind": "capability",
+      "version": 1,
+      "domain": "agent",
+      "runtime": "node",
+      "package": "@inneranimalmedia/agentsam-sdk/context",
+      "export": "resolveContext",
+      "description": "Select bounded evidence against an explicit model-aware context budget and return a measurable receipt.",
+      "deterministic": true,
+      "model_required": false,
+      "side_effects": "none",
+      "output_schema": "protocol/context/resolved-context-pack.schema.json",
+      "status": "experimental"
+    },
+    "cloudflare.wrangler.native": {
+      "id": "cloudflare.wrangler.native",
+      "kind": "capability",
+      "version": 1,
+      "domain": "cloudflare",
+      "runtime": "node+wrangler",
+      "package": "@inneranimalmedia/agentsam-sdk/cloudflare",
+      "export": "runWranglerNative",
+      "cli": "agentsam cloudflare run <command>",
+      "description": "Execute one allowlisted read-only Wrangler operation with argv-safe cwd/config scoping and structured diagnostics.",
+      "deterministic": false,
+      "model_required": false,
+      "side_effects": "network-read",
+      "input_schema": "protocol/capabilities/cloudflare-wrangler-native-input.schema.json",
+      "status": "experimental"
+    },
+    "cloudflare.cpu.profile": {
+      "id": "cloudflare.cpu.profile",
+      "kind": "capability",
+      "version": 1,
+      "domain": "cloudflare",
+      "runtime": "node",
+      "package": "@inneranimalmedia/agentsam-sdk/cloudflare",
+      "export": "summarizeCloudflareCpuProfileFile",
+      "cli": "agentsam cloudflare cpu analyze <profile.cpuprofile>",
+      "description": "Summarize a local workerd/DevTools CPU profile into bounded ranked self-time evidence.",
+      "deterministic": true,
+      "model_required": false,
+      "side_effects": "none",
+      "input_schema": "protocol/capabilities/cloudflare-cpu-profile-input.schema.json",
+      "status": "experimental"
+    },
+    "cloudflare.cpu.audit": {
+      "id": "cloudflare.cpu.audit",
+      "kind": "agent_primitive",
+      "version": 1,
+      "domain": "cloudflare",
+      "runtime": "node",
+      "package": "@inneranimalmedia/agentsam-sdk/cloudflare",
+      "export": "runCloudflareCpuAudit",
+      "description": "Analyze a bounded Cloudflare CPU profile and selected source evidence through an injected reasoning adapter without deploy authority.",
+      "deterministic": false,
+      "model_required": true,
+      "side_effects": "none",
+      "input_schema": "protocol/capabilities/cloudflare-cpu-audit-input.schema.json",
+      "status": "experimental"
     }
   }
 }

package/protocol/capabilities/repository-snapshot.schema.json

@@ -15,6 +15,7 @@
     "intelligence": { "type": "object" },
     "packages": { "type": "array", "items": { "type": "object" } },
     "knowledge": { "type": "object" },
+    "analysis": { "type": "object" },
     "deploy": { "type": ["object", "null"] }
   }
 }

package/protocol/context/context-budget.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.inneranimalmedia.com/agentsam/context/context-budget.schema.json",
+  "title": "ContextBudget",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "windowTokens", "windowChars", "charsPerToken", "targetInputRatio", "hardInputRatio", "hardWindowRatio",
+    "targetInputTokens", "compactAtTokens", "interveneAtTokens", "maxNormalInputTokens", "hardInputTokens",
+    "pricingThresholdTokens", "safetyMarginTokens", "targetInputChars", "hardInputChars",
+    "maxSystemChars", "maxToolSchemaChars", "maxEvidenceChars", "maxFileCharsPerRead", "maxFileCharsPerTurn", "maxToolResultChars"
+  ],
+  "properties": {
+    "windowTokens": { "type": "integer", "minimum": 1 },
+    "windowChars": { "type": "integer", "minimum": 1 },
+    "charsPerToken": { "type": "number", "exclusiveMinimum": 0 },
+    "targetInputRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 1 },
+    "hardInputRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 1 },
+    "hardWindowRatio": { "type": "number", "exclusiveMinimum": 0, "maximum": 1 },
+    "targetInputTokens": { "type": "integer", "minimum": 1 },
+    "compactAtTokens": { "type": "integer", "minimum": 1 },
+    "interveneAtTokens": { "type": "integer", "minimum": 1 },
+    "maxNormalInputTokens": { "type": "integer", "minimum": 1 },
+    "hardInputTokens": { "type": "integer", "minimum": 1 },
+    "pricingThresholdTokens": { "type": ["integer", "null"], "minimum": 1 },
+    "safetyMarginTokens": { "type": "integer", "minimum": 0 },
+    "targetInputChars": { "type": "integer", "minimum": 1 },
+    "hardInputChars": { "type": "integer", "minimum": 1 },
+    "maxSystemChars": { "type": "integer", "minimum": 1 },
+    "maxToolSchemaChars": { "type": "integer", "minimum": 1 },
+    "maxEvidenceChars": { "type": "integer", "minimum": 1 },
+    "maxFileCharsPerRead": { "type": "integer", "minimum": 1 },
+    "maxFileCharsPerTurn": { "type": "integer", "minimum": 1 },
+    "maxToolResultChars": { "type": "integer", "minimum": 1 }
+  }
+}

package/protocol/context/context-item.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.inneranimalmedia.com/agentsam/context/context-item.schema.json",
+  "title": "ContextItem",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["ref", "kind", "chars", "priority"],
+  "properties": {
+    "ref": { "type": "string", "minLength": 1 },
+    "kind": { "type": "string", "enum": ["file", "symbol", "memory", "tool_result", "repo", "artifact"] },
+    "chars": { "type": "integer", "minimum": 0 },
+    "hash": { "type": "string" },
+    "priority": { "type": "number" },
+    "content": { "type": "string" },
+    "truncated": { "type": "boolean" },
+    "compacted": { "type": "boolean" },
+    "source_chars": { "type": "integer", "minimum": 0 }
+  }
+}

package/protocol/context/resolved-context-pack.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.inneranimalmedia.com/agentsam/context/resolved-context-pack.schema.json",
+  "title": "ResolvedContextPack",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["objective", "refs", "items", "budget", "receipt"],
+  "properties": {
+    "objective": { "type": "string", "minLength": 1 },
+    "refs": { "type": "array", "items": { "type": "string" } },
+    "rules": { "type": ["object", "null"] },
+    "items": { "type": "array", "items": { "$ref": "./context-item.schema.json" } },
+    "budget": { "$ref": "./context-budget.schema.json" },
+    "receipt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "chars", "system_chars", "instruction_chars", "tool_schema_chars", "history_chars", "evidence_chars", "tool_result_chars",
+        "estimated_tokens", "estimated_input_tokens", "window_tokens", "utilization_ratio", "pricing_threshold_tokens",
+        "tokens_until_pricing_threshold", "pressure", "estimate_kind", "sources_considered", "sources_included",
+        "sources_deferred", "deferred_refs", "rehydratable_refs"
+      ],
+      "properties": {
+        "chars": { "type": "integer", "minimum": 0 },
+        "system_chars": { "type": "integer", "minimum": 0 },
+        "instruction_chars": { "type": "integer", "minimum": 0 },
+        "tool_schema_chars": { "type": "integer", "minimum": 0 },
+        "history_chars": { "type": "integer", "minimum": 0 },
+        "evidence_chars": { "type": "integer", "minimum": 0 },
+        "tool_result_chars": { "type": "integer", "minimum": 0 },
+        "estimated_tokens": { "type": "integer", "minimum": 0 },
+        "estimated_input_tokens": { "type": "integer", "minimum": 0 },
+        "window_tokens": { "type": "integer", "minimum": 1 },
+        "utilization_ratio": { "type": "number", "minimum": 0 },
+        "pricing_threshold_tokens": { "type": ["integer", "null"] },
+        "tokens_until_pricing_threshold": { "type": ["integer", "null"] },
+        "pressure": { "type": "string", "enum": ["normal", "target", "compact", "intervene", "max-normal", "hard"] },
+        "estimate_kind": { "type": "string", "enum": ["local", "provider"] },
+        "sources_considered": { "type": "integer", "minimum": 0 },
+        "sources_included": { "type": "integer", "minimum": 0 },
+        "sources_deferred": { "type": "integer", "minimum": 0 },
+        "deferred_refs": { "type": "array", "items": { "type": "string" } },
+        "rehydratable_refs": { "type": "array", "items": { "type": "string" } }
+      }
+    }
+  }
+}

package/protocol/context/result-policy.schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.inneranimalmedia.com/agentsam/context/result-policy.schema.json",
+  "title": "ResultPolicy",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["max_items", "max_chars", "detail"],
+  "properties": {
+    "max_items": { "type": "integer", "minimum": 1, "default": 8 },
+    "max_chars": { "type": "integer", "minimum": 1, "default": 24000 },
+    "detail": {
+      "type": "string",
+      "enum": ["metadata", "card", "excerpt", "range", "full"],
+      "default": "excerpt"
+    }
+  }
+}

package/protocol/knowledge/context-pack.schema.json

@@ -32,6 +32,39 @@
     },
     "diagnostics": {
       "type": "object"
+    },
+    "receipt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "chars",
+        "estimated_tokens",
+        "sources_considered",
+        "sources_included",
+        "sources_deferred"
+      ],
+      "properties": {
+        "chars": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "estimated_tokens": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "sources_considered": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "sources_included": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "sources_deferred": {
+          "type": "integer",
+          "minimum": 0
+        }
+      }
     }
   }
 }

package/protocol/knowledge/retrieval-query.schema.json

@@ -4,19 +4,74 @@
   "type": "object",
   "additionalProperties": false,
   "title": "RetrievalQuery",
-  "required": ["text"],
+  "required": [
+    "text"
+  ],
   "properties": {
-    "text": { "type": "string", "minLength": 1 },
-    "workspace_id": { "type": "string", "minLength": 1, "deprecated": true, "description": "Legacy compatibility metadata only; repository selection is explicit through repository identity." },
-    "repositories": { "type": "array", "items": { "type": "string" } },
-    "product_ids": { "type": "array", "items": { "type": "string" } },
-    "refs": { "type": "array", "items": { "type": "string" } },
-    "intent": { "type": "string", "default": "auto" },
-    "lanes": { "type": "array", "items": { "type": "string" } },
-    "top_k": { "type": "integer", "minimum": 1, "maximum": 100, "default": 12 },
-    "token_budget": { "type": "integer", "minimum": 256, "default": 8000 },
-    "require_current_ref": { "type": "boolean", "default": true },
-    "include_archived": { "type": "boolean", "default": false },
-    "explain": { "type": "boolean", "default": true }
+    "text": {
+      "type": "string",
+      "minLength": 1
+    },
+    "workspace_id": {
+      "type": "string",
+      "minLength": 1,
+      "deprecated": true,
+      "description": "Legacy compatibility metadata only; repository selection is explicit through repository identity."
+    },
+    "repositories": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "product_ids": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "refs": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "intent": {
+      "type": "string",
+      "default": "auto"
+    },
+    "lanes": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "top_k": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 8,
+      "default": 8
+    },
+    "token_budget": {
+      "type": "integer",
+      "minimum": 256,
+      "default": 6000,
+      "maximum": 6000
+    },
+    "require_current_ref": {
+      "type": "boolean",
+      "default": true
+    },
+    "include_archived": {
+      "type": "boolean",
+      "default": false
+    },
+    "explain": {
+      "type": "boolean",
+      "default": true
+    },
+    "result_policy": {
+      "$ref": "../context/result-policy.schema.json"
+    }
   }
 }