@inneranimalmedia/agentsam-sdk 2.0.0 → 2.2.0

package/protocol/capabilities/capability-manifest.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.inneranimalmedia.com/agentsam/capabilities/manifest.schema.json",
+  "title": "AgentSam capability manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "package", "capabilities"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "package": { "type": "string", "minLength": 1 },
+    "capabilities": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["id", "kind", "version", "domain", "runtime", "description", "deterministic", "model_required", "side_effects", "status"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z][a-z0-9.-]+$" },
+          "kind": { "enum": ["capability", "agent_primitive"] },
+          "version": { "type": "integer", "minimum": 1 },
+          "domain": { "type": "string", "minLength": 1 },
+          "runtime": { "type": "string", "minLength": 1 },
+          "package": { "type": "string" },
+          "export": { "type": "string" },
+          "cli": { "type": "string" },
+          "description": { "type": "string", "minLength": 1 },
+          "deterministic": { "type": "boolean" },
+          "model_required": { "type": "boolean" },
+          "side_effects": { "type": "string" },
+          "input_schema": { "type": "string" },
+          "output_schema": { "type": "string" },
+          "status": { "enum": ["stable", "experimental", "deprecated"] }
+        }
+      }
+    }
+  }
+}

package/protocol/capabilities/manifest.json

@@ -0,0 +1,179 @@
+{
+  "schema_version": 1,
+  "package": "@inneranimalmedia/agentsam-sdk",
+  "capabilities": {
+    "repository.snapshot": {
+      "id": "repository.snapshot",
+      "kind": "capability",
+      "version": 1,
+      "domain": "repository",
+      "runtime": "node+python",
+      "package": "@inneranimalmedia/agentsam-sdk/repository",
+      "export": "repositorySnapshot",
+      "cli": "agentsam inspect --json",
+      "description": "Collect a read-only, content-addressed repository evidence snapshot.",
+      "deterministic": true,
+      "model_required": false,
+      "side_effects": "none",
+      "input_schema": "protocol/capabilities/repository-snapshot-input.schema.json",
+      "output_schema": "protocol/capabilities/repository-snapshot.schema.json",
+      "status": "stable"
+    },
+    "repository.audit": {
+      "id": "repository.audit",
+      "kind": "agent_primitive",
+      "version": 1,
+      "domain": "repository",
+      "runtime": "node",
+      "package": "@inneranimalmedia/agentsam-sdk/agent",
+      "export": "runRepositoryAudit",
+      "description": "Analyze a certified repository snapshot through an injected reasoning adapter without granting mutation authority.",
+      "deterministic": false,
+      "model_required": true,
+      "side_effects": "none",
+      "input_schema": "protocol/capabilities/repository-audit-input.schema.json",
+      "output_schema": "protocol/capabilities/repository-audit.schema.json",
+      "status": "stable"
+    },
+    "repository.intelligence": {
+      "id": "repository.intelligence",
+      "kind": "capability",
+      "version": 1,
+      "domain": "repository",
+      "runtime": "python",
+      "package": "@inneranimalmedia/agentsam-sdk/repository",
+      "cli": "agentsam repo snapshot",
+      "description": "Observe repository composition, manifests, churn, pressure, and stability.",
+      "deterministic": true,
+      "model_required": false,
+      "side_effects": "none",
+      "status": "stable"
+    },
+    "knowledge.index": {
+      "id": "knowledge.index",
+      "kind": "capability",
+      "version": 1,
+      "domain": "repository",
+      "runtime": "node",
+      "package": "@inneranimalmedia/agentsam-sdk/knowledge",
+      "cli": "agentsam index run",
+      "description": "Build a coherent incremental AST/text generation with optional embeddings.",
+      "deterministic": true,
+      "model_required": false,
+      "side_effects": "local-state",
+      "status": "stable"
+    },
+    "knowledge.search": {
+      "id": "knowledge.search",
+      "kind": "capability",
+      "version": 1,
+      "domain": "repository",
+      "runtime": "node",
+      "package": "@inneranimalmedia/agentsam-sdk/knowledge",
+      "cli": "agentsam search \"query\"",
+      "description": "Retrieve bounded repository context from a published knowledge generation.",
+      "deterministic": true,
+      "model_required": false,
+      "side_effects": "none",
+      "status": "stable"
+    },
+    "merkle.snapshot": {
+      "id": "merkle.snapshot",
+      "kind": "capability",
+      "version": 1,
+      "domain": "integrity",
+      "runtime": "node",
+      "package": "@inneranimalmedia/agentsam-sdk/merkle",
+      "cli": "agentsam merkle snapshot",
+      "description": "Create a portable SHA-256 filesystem snapshot.",
+      "deterministic": true,
+      "model_required": false,
+      "side_effects": "local-state",
+      "status": "stable"
+    },
+    "deploy.receipt": {
+      "id": "deploy.receipt",
+      "kind": "capability",
+      "version": 1,
+      "domain": "delivery",
+      "runtime": "node",
+      "package": "@inneranimalmedia/agentsam-sdk/deploy-receipt",
+      "cli": "agentsam deploy-receipt capture",
+      "description": "Capture and finalize content-addressed deployment evidence.",
+      "deterministic": true,
+      "model_required": false,
+      "side_effects": "local-state",
+      "status": "stable"
+    },
+    "security.scan": {
+      "id": "security.scan",
+      "kind": "capability",
+      "version": 1,
+      "domain": "security",
+      "runtime": "node",
+      "package": "@inneranimalmedia/agentsam-sdk/security",
+      "cli": "agentsam security scan",
+      "description": "Inventory dependency state and optionally query vulnerability evidence.",
+      "deterministic": true,
+      "model_required": false,
+      "side_effects": "network-optional",
+      "status": "stable"
+    },
+    "identity.init": {
+      "id": "identity.init",
+      "kind": "capability",
+      "version": 1,
+      "domain": "app",
+      "runtime": "node",
+      "package": "@inneranimalmedia/agentsam-sdk/identity",
+      "cli": "agentsam identity init",
+      "description": "Generate portable identity/auth application surfaces from SDK contracts.",
+      "deterministic": true,
+      "model_required": false,
+      "side_effects": "filesystem",
+      "status": "stable"
+    },
+    "scaffold.create": {
+      "id": "scaffold.create",
+      "kind": "capability",
+      "version": 1,
+      "domain": "app",
+      "runtime": "node",
+      "package": "@inneranimalmedia/agentsam-sdk",
+      "cli": "agentsam create <name> --preset <preset>",
+      "description": "Create a local-first project from a deterministic preset selection.",
+      "deterministic": true,
+      "model_required": false,
+      "side_effects": "filesystem",
+      "status": "stable"
+    },
+    "recon.pack": {
+      "id": "recon.pack",
+      "kind": "capability",
+      "version": 1,
+      "domain": "agent",
+      "runtime": "node+python",
+      "package": "@inneranimalmedia/agentsam-sdk/repository",
+      "cli": "agentsam recon pack",
+      "description": "Convert explicit evidence slices into bounded worker task packets.",
+      "deterministic": true,
+      "model_required": false,
+      "side_effects": "none",
+      "status": "stable"
+    },
+    "site.scrape": {
+      "id": "site.scrape",
+      "kind": "capability",
+      "version": 1,
+      "domain": "web",
+      "runtime": "python",
+      "package": "agentsam-site-scrape",
+      "cli": "python -m agentsam_site_scrape",
+      "description": "Crawl a bounded public site and prepare page/image assets for local or R2 ingest.",
+      "deterministic": true,
+      "model_required": false,
+      "side_effects": "network+filesystem",
+      "status": "stable"
+    }
+  }
+}

package/protocol/capabilities/repository-audit-input.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.inneranimalmedia.com/agentsam/capabilities/repository-audit-input.schema.json",
+  "title": "repository.audit input",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "snapshot": { "type": "object" },
+    "focus": { "type": "array", "maxItems": 24, "items": { "type": "string" } },
+    "depth": { "enum": ["quick", "standard", "deep"], "default": "standard" },
+    "requestedSections": { "type": "array", "maxItems": 24, "items": { "type": "string" } },
+    "evidenceBudget": { "type": "integer", "minimum": 1000, "maximum": 64000, "default": 8000 }
+  }
+}

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

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.inneranimalmedia.com/agentsam/capabilities/repository-audit.schema.json",
+  "title": "repository.audit result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "primitive", "snapshot_id", "snapshot_content_hash", "generated_at", "summary", "packages", "binaries", "commands", "capabilities", "services", "protocols", "notable_combinations", "findings", "cleanup_candidates", "recommended_routes", "evidence_refs", "artifacts"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "primitive": { "const": "repository.audit" },
+    "snapshot_id": { "type": "string" },
+    "snapshot_content_hash": { "type": "string" },
+    "generated_at": { "type": "string" },
+    "summary": { "type": "string", "minLength": 1 },
+    "repository_map": {},
+    "file_tree": {},
+    "packages": { "type": "array" },
+    "binaries": { "type": "array" },
+    "commands": { "type": "array" },
+    "capabilities": { "type": "array" },
+    "services": { "type": "array" },
+    "protocols": { "type": "array" },
+    "notable_combinations": { "type": "array" },
+    "findings": { "type": "array" },
+    "cleanup_candidates": { "type": "array" },
+    "recommended_routes": { "type": "array" },
+    "evidence_refs": { "type": "array", "items": { "type": "string" } },
+    "artifacts": { "type": "array" }
+  }
+}

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

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.inneranimalmedia.com/agentsam/capabilities/repository-snapshot-input.schema.json",
+  "title": "repository.snapshot input",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "cwd": { "type": "string", "minLength": 1 },
+    "churnDays": { "type": "integer", "minimum": 1, "maximum": 3650, "default": 30 }
+  }
+}

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

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://schemas.inneranimalmedia.com/agentsam/capabilities/repository-snapshot.schema.json",
+  "title": "repository.snapshot result",
+  "type": "object",
+  "required": ["schema_version", "capability", "snapshot_id", "created_at", "content_hash", "repository", "tree", "intelligence", "packages", "knowledge"],
+  "properties": {
+    "schema_version": { "const": 1 },
+    "capability": { "const": "repository.snapshot" },
+    "snapshot_id": { "type": "string", "pattern": "^rsnap_[a-f0-9]{24}$" },
+    "created_at": { "type": "string" },
+    "content_hash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "repository": { "type": "object" },
+    "tree": { "type": "object" },
+    "intelligence": { "type": "object" },
+    "packages": { "type": "array", "items": { "type": "object" } },
+    "knowledge": { "type": "object" },
+    "deploy": { "type": ["object", "null"] }
+  }
+}

package/protocol/knowledge/chunk.schema.json

@@ -4,79 +4,21 @@
   "type": "object",
   "additionalProperties": false,
   "title": "Chunk",
-  "required": [
-    "chunk_id",
-    "document_id",
-    "workspace_id",
-    "content",
-    "ordinal",
-    "content_hash"
-  ],
+  "required": ["chunk_id", "document_id", "content", "ordinal", "content_hash"],
   "properties": {
-    "chunk_id": {
-      "type": "string"
-    },
-    "document_id": {
-      "type": "string"
-    },
-    "workspace_id": {
-      "type": "string"
-    },
-    "content": {
-      "type": "string"
-    },
-    "ordinal": {
-      "type": "integer",
-      "minimum": 0
-    },
-    "content_hash": {
-      "type": "string"
-    },
-    "token_count": {
-      "type": [
-        "integer",
-        "null"
-      ],
-      "minimum": 0
-    },
-    "repository_full_name": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "ref": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "commit_sha": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "path": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "symbol": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "heading_path": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
-    "metadata": {
-      "type": "object"
-    }
+    "chunk_id": { "type": "string" },
+    "document_id": { "type": "string" },
+    "workspace_id": { "type": "string", "deprecated": true, "description": "Legacy compatibility metadata only." },
+    "content": { "type": "string" },
+    "ordinal": { "type": "integer", "minimum": 0 },
+    "content_hash": { "type": "string" },
+    "token_count": { "type": ["integer", "null"], "minimum": 0 },
+    "repository_full_name": { "type": ["string", "null"] },
+    "ref": { "type": ["string", "null"] },
+    "commit_sha": { "type": ["string", "null"] },
+    "path": { "type": ["string", "null"] },
+    "symbol": { "type": ["string", "null"] },
+    "heading_path": { "type": "array", "items": { "type": "string" } },
+    "metadata": { "type": "object" }
   }
 }

package/protocol/knowledge/document.schema.json

@@ -4,54 +4,16 @@
   "type": "object",
   "additionalProperties": false,
   "title": "Document",
-  "required": [
-    "document_id",
-    "source_id",
-    "workspace_id",
-    "content_hash",
-    "media_type"
-  ],
+  "required": ["document_id", "source_id", "content_hash", "media_type"],
   "properties": {
-    "document_id": {
-      "type": "string",
-      "minLength": 1
-    },
-    "source_id": {
-      "type": "string",
-      "minLength": 1
-    },
-    "workspace_id": {
-      "type": "string",
-      "minLength": 1
-    },
-    "content_hash": {
-      "type": "string",
-      "minLength": 1
-    },
-    "media_type": {
-      "type": "string",
-      "minLength": 1
-    },
-    "title": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "path": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "text": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "metadata": {
-      "type": "object"
-    }
+    "document_id": { "type": "string", "minLength": 1 },
+    "source_id": { "type": "string", "minLength": 1 },
+    "workspace_id": { "type": "string", "minLength": 1, "deprecated": true, "description": "Legacy compatibility metadata only." },
+    "content_hash": { "type": "string", "minLength": 1 },
+    "media_type": { "type": "string", "minLength": 1 },
+    "title": { "type": ["string", "null"] },
+    "path": { "type": ["string", "null"] },
+    "text": { "type": ["string", "null"] },
+    "metadata": { "type": "object" }
   }
 }

package/protocol/knowledge/index-config.schema.json

@@ -4,11 +4,11 @@
   "title": "Portable index configuration v1",
   "type": "object",
   "additionalProperties": false,
-  "required": ["version", "repository_id", "workspace_id", "scope", "chunking", "embedding", "storage"],
+  "required": ["version", "repository_id", "scope", "chunking", "embedding", "storage"],
   "properties": {
     "version": { "const": 1 },
     "repository_id": { "type": "string", "minLength": 1 },
-    "workspace_id": { "type": "string", "minLength": 1 },
+    "workspace_id": { "type": "string", "minLength": 1, "deprecated": true, "description": "Legacy compatibility metadata. New portable configs are repository-scoped and must not require this field." },
     "scope": {
       "type": "object", "additionalProperties": false, "required": ["name", "include"],
       "properties": {

package/protocol/knowledge/repository.schema.json

@@ -4,58 +4,17 @@
   "type": "object",
   "additionalProperties": false,
   "title": "RepositoryDescriptor",
-  "required": [
-    "repository_id",
-    "full_name",
-    "workspace_id",
-    "default_branch"
-  ],
+  "required": ["repository_id", "full_name", "default_branch"],
   "properties": {
-    "repository_id": {
-      "type": "string"
-    },
-    "full_name": {
-      "type": "string",
-      "pattern": "^[^/]+/[^/]+$"
-    },
-    "workspace_id": {
-      "type": "string"
-    },
-    "default_branch": {
-      "type": "string"
-    },
-    "product_ids": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
-    "indexed_refs": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
-    "enabled_lanes": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
-    "include": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
-    "exclude": {
-      "type": "array",
-      "items": {
-        "type": "string"
-      }
-    },
-    "metadata": {
-      "type": "object"
-    }
+    "repository_id": { "type": "string" },
+    "full_name": { "type": "string", "pattern": "^[^/]+/[^/]+$" },
+    "workspace_id": { "type": "string", "deprecated": true, "description": "Legacy compatibility metadata only." },
+    "default_branch": { "type": "string" },
+    "product_ids": { "type": "array", "items": { "type": "string" } },
+    "indexed_refs": { "type": "array", "items": { "type": "string" } },
+    "enabled_lanes": { "type": "array", "items": { "type": "string" } },
+    "include": { "type": "array", "items": { "type": "string" } },
+    "exclude": { "type": "array", "items": { "type": "string" } },
+    "metadata": { "type": "object" }
   }
 }

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

@@ -4,69 +4,19 @@
   "type": "object",
   "additionalProperties": false,
   "title": "RetrievalQuery",
-  "required": [
-    "text",
-    "workspace_id"
-  ],
+  "required": ["text"],
   "properties": {
-    "text": {
-      "type": "string",
-      "minLength": 1
-    },
-    "workspace_id": {
-      "type": "string",
-      "minLength": 1
-    },
-    "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": 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 }
   }
 }