@inneranimalmedia/agentsam-sdk 2.6.2 → 2.6.3

package/protocol/presets/catalog.json

@@ -6,43 +6,152 @@
       "version": 1,
       "lane": "fullstack",
       "description": "Local-first application with AgentSam runtime, repository primitives, knowledge, and delivery hooks.",
-      "features": ["agent", "knowledge"],
-      "capabilities": ["scaffold.create", "repository.snapshot", "knowledge.index", "knowledge.search", "security.scan", "deploy.receipt"],
-      "defaults": { "database": "sqlite", "assets": "local", "deploy": "local" }
+      "features": [
+        "agent",
+        "knowledge"
+      ],
+      "capabilities": [
+        "scaffold.create",
+        "repository.snapshot",
+        "knowledge.index",
+        "knowledge.search",
+        "security.scan",
+        "deploy.receipt"
+      ],
+      "defaults": {
+        "database": "sqlite",
+        "assets": "local",
+        "deploy": "local"
+      }
     },
     "cms": {
       "id": "cms",
-      "version": 1,
+      "version": 2,
       "lane": "cms",
-      "description": "Content-oriented application starting from local CMS primitives with explicit auth/deploy opt-ins.",
-      "features": ["cms", "knowledge"],
-      "capabilities": ["scaffold.create", "repository.snapshot", "knowledge.index", "knowledge.search", "site.scrape", "deploy.receipt"],
-      "defaults": { "database": "sqlite", "assets": "local", "deploy": "local" }
+      "description": "Content-oriented application with AgentSam CMS editor, stock heuristic-theme, and explicit auth/deploy opt-ins.",
+      "features": [
+        "cms",
+        "knowledge",
+        "brand",
+        "theme"
+      ],
+      "capabilities": [
+        "scaffold.create",
+        "repository.snapshot",
+        "knowledge.index",
+        "knowledge.search",
+        "site.scrape",
+        "deploy.receipt",
+        "brand.scan",
+        "brand.resolve",
+        "theme.storefront.shell"
+      ],
+      "defaults": {
+        "database": "sqlite",
+        "assets": "local",
+        "deploy": "local",
+        "theme": "heuristic-theme",
+        "composer": "agentsam.mini-composer"
+      },
+      "packages": {
+        "theme": "@inneranimalmedia/heuristic-theme",
+        "composer": "@inneranimalmedia/agentsam-workbench",
+        "analytics": "@inneranimalmedia/commerce-analytics"
+      },
+      "notes": "Fuel & Free Time hosts proving-ground copies; SDK packages are the publish targets."
     },
     "prototype": {
       "id": "prototype",
       "version": 1,
       "lane": "fullstack",
       "description": "Small local prototype with the minimum deterministic AgentSam runtime.",
-      "features": ["agent"],
-      "capabilities": ["scaffold.create", "repository.snapshot", "security.scan"],
-      "defaults": { "database": "sqlite", "assets": "local", "deploy": "local" }
+      "features": [
+        "agent"
+      ],
+      "capabilities": [
+        "scaffold.create",
+        "repository.snapshot",
+        "security.scan"
+      ],
+      "defaults": {
+        "database": "sqlite",
+        "assets": "local",
+        "deploy": "local"
+      }
     },
     "data": {
       "id": "data",
       "version": 1,
       "lane": "data",
       "description": "Data-oriented local application with repository knowledge and explicit production storage graduation.",
-      "features": ["knowledge"],
-      "capabilities": ["scaffold.create", "repository.snapshot", "knowledge.index", "knowledge.search", "security.scan"],
-      "defaults": { "database": "sqlite", "assets": "local", "deploy": "local" }
+      "features": [
+        "knowledge"
+      ],
+      "capabilities": [
+        "scaffold.create",
+        "repository.snapshot",
+        "knowledge.index",
+        "knowledge.search",
+        "security.scan"
+      ],
+      "defaults": {
+        "database": "sqlite",
+        "assets": "local",
+        "deploy": "local"
+      }
     }
   },
   "addons": {
-    "agent": { "id": "agent", "capabilities": ["scaffold.create"], "description": "AgentSam local runtime selection." },
-    "auth": { "id": "auth", "capabilities": ["identity.init"], "description": "Identity package selection; use `agentsam identity init` when a standalone auth app scaffold is required." },
-    "cms": { "id": "cms", "capabilities": ["site.scrape"], "description": "CMS/content feature selection." },
-    "knowledge": { "id": "knowledge", "capabilities": ["knowledge.index", "knowledge.search"], "description": "Portable repository indexing and retrieval." },
-    "deploy-cloudflare": { "id": "deploy-cloudflare", "capabilities": ["deploy.receipt"], "description": "Select Cloudflare as the intended deploy target; provisioning remains explicit at deploy time." }
+    "agent": {
+      "id": "agent",
+      "capabilities": [
+        "scaffold.create"
+      ],
+      "description": "AgentSam local runtime selection."
+    },
+    "auth": {
+      "id": "auth",
+      "capabilities": [
+        "identity.init"
+      ],
+      "description": "Identity selection (schema_version 2). Records provider_template; use `agentsam identity plan|init|schema` for protocol-driven setup."
+    },
+    "cms": {
+      "id": "cms",
+      "capabilities": [
+        "site.scrape"
+      ],
+      "description": "CMS/content feature selection (stock theme: heuristic-theme via theme.storefront.shell)."
+    },
+    "theme": {
+      "id": "theme",
+      "capabilities": [
+        "theme.storefront.shell"
+      ],
+      "description": "Stock storefront theme selection — default package @inneranimalmedia/heuristic-theme (theme.storefront.shell). Theme is a projection of Brand, not brand authority."
+    },
+    "brand": {
+      "id": "brand",
+      "capabilities": [
+        "brand.scan",
+        "brand.resolve"
+      ],
+      "description": "Deterministic Brand Intelligence — evidence from repository.snapshot; Brand ≠ Theme."
+    },
+    "knowledge": {
+      "id": "knowledge",
+      "capabilities": [
+        "knowledge.index",
+        "knowledge.search"
+      ],
+      "description": "Portable repository indexing and retrieval."
+    },
+    "deploy-cloudflare": {
+      "id": "deploy-cloudflare",
+      "capabilities": [
+        "deploy.receipt"
+      ],
+      "description": "Select Cloudflare as the intended deploy target; provisioning remains explicit at deploy time."
+    }
   }
 }

package/protocol/rpc/v1/errors.proto

@@ -23,6 +23,9 @@ enum ErrorCode {
   ERROR_CODE_UNAUTHENTICATED = 16;
 }
 
+// Transport representation of the canonical AgentSam ErrorEnvelope. String
+// vocabulary is deliberate: SDK reason/severity/source catalogs evolve faster
+// than protobuf enum releases, while code retains the canonical gRPC mapping.
 message ErrorDetail {
   ErrorCode code = 1;
   string message = 2;
@@ -32,4 +35,25 @@ message ErrorDetail {
   optional uint32 retry_after_ms = 6;
   optional string provider = 7;
   optional string provider_code = 8;
+
+  optional string severity = 9;
+  optional string source_kind = 10;
+  optional string source_name = 11;
+  optional string source_service = 12;
+  optional string resolution_owner = 13;
+  optional string domain = 14;
+  optional string tool = 15;
+  optional string stage = 16;
+  optional string remediation_action = 17;
+  optional string remediation_message = 18;
+  optional string fingerprint = 19;
+  optional string trace_id = 20;
+  optional string transport = 21;
+  optional string resource_json = 22;
+  optional string native_json = 23;
+  optional string environment_json = 24;
+  optional string details_json = 25;
+  optional uint32 occurrence_count = 26;
+  optional string request_id = 27;
+  optional uint32 schema_version = 28;
 }

package/protocol/theme-refinery/d1-reconciliation.md

@@ -0,0 +1,48 @@
+# D1 reconciliation contract (theme refinery)
+
+Target DB: **inneranimalmedia-business** (live AgentSam product graph).
+
+## Invariant
+
+```sql
+SELECT slug, kind, status, repository_id, canonical_path
+FROM agentsam_products
+ORDER BY kind, name;
+```
+
+must answer current inventory. From any row, `asset_relationships` answers defined_in / sourced_from / depends_on / consumed_by / exposes_tool / provides_workflow. Evidence + artifacts answer what was observed and what preview/QA supports promotion.
+
+## Product UPSERT (pseudocode)
+
+```sql
+INSERT INTO agentsam_products (
+  id, account_id, slug, name, kind, status,
+  repository_id, canonical_path, metadata, updated_at
+) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, unixepoch())
+ON CONFLICT(account_id, slug) DO UPDATE SET
+  name = excluded.name,
+  kind = excluded.kind,
+  status = excluded.status,
+  repository_id = COALESCE(excluded.repository_id, agentsam_products.repository_id),
+  canonical_path = excluded.canonical_path,
+  metadata = excluded.metadata,
+  updated_at = excluded.updated_at;
+```
+
+- Resolve `repository_id` via `code_repositories` lookup (repo URL / name / path). **Never invent.**
+- Existing triggers emit `defined_in` when `repository_id` is set — do not duplicate manually.
+
+## Relationship UPSERT
+
+Honor uniqueness on `(source_type, source_id, target_type, target_id, relationship_type)`.
+
+## Evidence
+
+Write `agentsam_evidence_snapshots` with `snapshot_type` in (`repository`,`website`,`seo`,`business`), same `account_id` as product/repo.
+
+## Do not
+
+- Dual-write every product into legacy `apps` by default (backfill *from* `apps` only).
+- Register whole sites as `cms_component_templates` or only as `cms_themes`.
+- Stuff giant archaeology JSON or secrets into `agentsam_products.metadata`.
+- Emit tools/workflows/skills/hooks unless formally exposed.

package/protocol/theme-refinery/product-metadata.schema.json

@@ -0,0 +1,27 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "agentsam.theme-refinery.product-metadata.v1",
+  "title": "agentsam_products.metadata for theme-refinery provenance",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "origin": { "type": "string", "enum": ["machine_harvest", "gallery_mount", "manual", "apps_backfill"] },
+    "donor_name": { "type": "string" },
+    "source_path": { "type": "string", "description": "Local donor path; never secrets" },
+    "harvest_batch": { "type": "string" },
+    "normalization_state": {
+      "type": "string",
+      "enum": ["fingerprinted", "portable", "portable-preview", "normalized", "wired", "promoted"]
+    },
+    "source_hash": { "type": "string" },
+    "app_manifest": { "type": "string" },
+    "help_root": { "type": "string" },
+    "preview_kind": { "type": "string", "enum": ["static", "live", "iframe", "none"] },
+    "package": { "type": "string" },
+    "gallery_path": { "type": "string" },
+    "capabilities": { "type": "array", "items": { "type": "string" } },
+    "latest_evidence_snapshot_id": { "type": ["string", "null"] },
+    "latest_quality_report_id": { "type": ["string", "null"] }
+  },
+  "required": ["origin", "normalization_state"]
+}

package/protocol/theme-refinery/receipts/products-registry-batch-20260924.json

@@ -0,0 +1,318 @@
+[
+  {
+    "slug": "church-site",
+    "name": "New Iberia Church of Christ",
+    "kind": "app",
+    "status": "scaffolded",
+    "repository_id": null,
+    "canonical_path": "apps/church-site",
+    "package_name": "@inneranimalmedia/theme-church-site",
+    "metadata": {
+      "origin": "machine_harvest",
+      "donor_name": "New Iberia Church of Christ",
+      "source_path": "/Users/samprimeaux/Library/Mobile Documents/com~apple~CloudDocs/Projects/Cloudflare/NewIberiaChurchofChrist",
+      "harvest_batch": "theme-harvest-20260924",
+      "normalization_state": "portable-preview",
+      "source_hash": "0a8ae5de768f874ccdebe92a5e438ad8e4d51b4c5fdae9679c7e09268328fee6",
+      "app_manifest": "apps/church-site/.agentsam/app.json",
+      "help_root": "apps/church-site/docs/",
+      "preview_kind": "static",
+      "package": "@inneranimalmedia/theme-church-site",
+      "gallery_path": "apps/theme-gallery-preview/themes/church-site",
+      "capabilities": [
+        "cms.media",
+        "cms.pages",
+        "deploy.receipt",
+        "forms.leads",
+        "theme.storefront.shell"
+      ]
+    },
+    "relationships": [
+      {
+        "relationship_type": "packaged_as",
+        "target_type": "sdk-package",
+        "target_slug": "theme-church-site"
+      },
+      {
+        "relationship_type": "depends_on",
+        "target_type": "capability",
+        "target_slug": "theme.storefront.shell"
+      },
+      {
+        "relationship_type": "sourced_from",
+        "target_type": "gallery-theme",
+        "target_slug": "church-site"
+      }
+    ],
+    "_note": "repository_id must be resolved against live code_repositories before D1 UPSERT"
+  },
+  {
+    "slug": "companions-site",
+    "name": "Companions of Caddo",
+    "kind": "app",
+    "status": "scaffolded",
+    "repository_id": null,
+    "canonical_path": "apps/companions-site",
+    "package_name": "@inneranimalmedia/theme-companions-site",
+    "metadata": {
+      "origin": "machine_harvest",
+      "donor_name": "Companions of Caddo",
+      "source_path": "/Users/samprimeaux/companionscpas/static",
+      "harvest_batch": "theme-harvest-20260924",
+      "normalization_state": "portable-preview",
+      "source_hash": "cdad95d1a674b05456a6166f9fc70d86dce106d4215395601164ec40ac161f7b",
+      "app_manifest": "apps/companions-site/.agentsam/app.json",
+      "help_root": "apps/companions-site/docs/",
+      "preview_kind": "static",
+      "package": "@inneranimalmedia/theme-companions-site",
+      "gallery_path": "apps/theme-gallery-preview/themes/companions-site",
+      "capabilities": [
+        "cms.media",
+        "cms.pages",
+        "theme.storefront.shell"
+      ]
+    },
+    "relationships": [
+      {
+        "relationship_type": "packaged_as",
+        "target_type": "sdk-package",
+        "target_slug": "theme-companions-site"
+      },
+      {
+        "relationship_type": "depends_on",
+        "target_type": "capability",
+        "target_slug": "theme.storefront.shell"
+      },
+      {
+        "relationship_type": "sourced_from",
+        "target_type": "gallery-theme",
+        "target_slug": "companions-site"
+      }
+    ],
+    "_note": "repository_id must be resolved against live code_repositories before D1 UPSERT"
+  },
+  {
+    "slug": "floors-site",
+    "name": "Anything Floors & More",
+    "kind": "app",
+    "status": "scaffolded",
+    "repository_id": null,
+    "canonical_path": "apps/floors-site",
+    "package_name": "@inneranimalmedia/theme-floors-site",
+    "metadata": {
+      "origin": "machine_harvest",
+      "donor_name": "Anything Floors & More",
+      "source_path": "/Volumes/Expansion/Anything Floors & More",
+      "harvest_batch": "theme-harvest-20260924",
+      "normalization_state": "portable-preview",
+      "source_hash": "2244de43568a0bb08d7d3779971c1fc0c6c832c226a65c7bb4313e8ac039add8",
+      "app_manifest": "apps/floors-site/.agentsam/app.json",
+      "help_root": "apps/floors-site/docs/",
+      "preview_kind": "static",
+      "package": "@inneranimalmedia/theme-floors-site",
+      "gallery_path": "apps/theme-gallery-preview/themes/floors-site",
+      "capabilities": [
+        "cms.media",
+        "cms.pages",
+        "deploy.receipt",
+        "forms.leads",
+        "theme.storefront.shell"
+      ]
+    },
+    "relationships": [
+      {
+        "relationship_type": "packaged_as",
+        "target_type": "sdk-package",
+        "target_slug": "theme-floors-site"
+      },
+      {
+        "relationship_type": "depends_on",
+        "target_type": "capability",
+        "target_slug": "theme.storefront.shell"
+      },
+      {
+        "relationship_type": "sourced_from",
+        "target_type": "gallery-theme",
+        "target_slug": "floors-site"
+      }
+    ],
+    "_note": "repository_id must be resolved against live code_repositories before D1 UPSERT"
+  },
+  {
+    "slug": "fuelnfree-site",
+    "name": "Fuel & Free Time",
+    "kind": "app",
+    "status": "scaffolded",
+    "repository_id": null,
+    "canonical_path": "apps/fuelnfree-site",
+    "package_name": "@inneranimalmedia/theme-fuelnfree-site",
+    "metadata": {
+      "origin": "machine_harvest",
+      "donor_name": "Fuel & Free Time",
+      "source_path": "/Users/samprimeaux/fuelnfreetime/legacy",
+      "harvest_batch": "theme-harvest-20260924",
+      "normalization_state": "portable-preview",
+      "source_hash": "5ea35182b99816b9cb137a15f6ce7c361bfa932010759d3ac5bf74b1083895cf",
+      "app_manifest": "apps/fuelnfree-site/.agentsam/app.json",
+      "help_root": "apps/fuelnfree-site/docs/",
+      "preview_kind": "static",
+      "package": "@inneranimalmedia/theme-fuelnfree-site",
+      "gallery_path": "apps/theme-gallery-preview/themes/fuelnfree-site",
+      "capabilities": [
+        "cms.media",
+        "cms.pages",
+        "forms.leads",
+        "theme.storefront.shell"
+      ]
+    },
+    "relationships": [
+      {
+        "relationship_type": "packaged_as",
+        "target_type": "sdk-package",
+        "target_slug": "theme-fuelnfree-site"
+      },
+      {
+        "relationship_type": "depends_on",
+        "target_type": "capability",
+        "target_slug": "theme.storefront.shell"
+      },
+      {
+        "relationship_type": "sourced_from",
+        "target_type": "gallery-theme",
+        "target_slug": "fuelnfree-site"
+      }
+    ],
+    "_note": "repository_id must be resolved against live code_repositories before D1 UPSERT"
+  },
+  {
+    "slug": "handyman-site",
+    "name": "Primeaux Handyman Services",
+    "kind": "app",
+    "status": "scaffolded",
+    "repository_id": null,
+    "canonical_path": "apps/handyman-site",
+    "package_name": "@inneranimalmedia/theme-handyman-site",
+    "metadata": {
+      "origin": "machine_harvest",
+      "donor_name": "Primeaux Handyman Services",
+      "source_path": "/Users/samprimeaux/worktrees/primeaux-handyman-services-agent/dist",
+      "harvest_batch": "theme-harvest-20260924",
+      "normalization_state": "portable-preview",
+      "source_hash": "36a5a147cd70c0523a50466fad113cc265ee22a571e98b2fd67fde15ee795ea4",
+      "app_manifest": "apps/handyman-site/.agentsam/app.json",
+      "help_root": "apps/handyman-site/docs/",
+      "preview_kind": "static",
+      "package": "@inneranimalmedia/theme-handyman-site",
+      "gallery_path": "apps/theme-gallery-preview/themes/handyman-site",
+      "capabilities": [
+        "theme.storefront.shell"
+      ]
+    },
+    "relationships": [
+      {
+        "relationship_type": "packaged_as",
+        "target_type": "sdk-package",
+        "target_slug": "theme-handyman-site"
+      },
+      {
+        "relationship_type": "depends_on",
+        "target_type": "capability",
+        "target_slug": "theme.storefront.shell"
+      },
+      {
+        "relationship_type": "sourced_from",
+        "target_type": "gallery-theme",
+        "target_slug": "handyman-site"
+      }
+    ],
+    "_note": "repository_id must be resolved against live code_repositories before D1 UPSERT"
+  },
+  {
+    "slug": "insurance-site",
+    "name": "Chrystal Clear Insurance",
+    "kind": "app",
+    "status": "scaffolded",
+    "repository_id": null,
+    "canonical_path": "apps/insurance-site",
+    "package_name": "@inneranimalmedia/theme-insurance-site",
+    "metadata": {
+      "origin": "machine_harvest",
+      "donor_name": "Chrystal Clear Insurance",
+      "source_path": "/Users/samprimeaux/Projects/client-demos/chrystal-clear-insurance/chrystal-clear-insurance/dist",
+      "harvest_batch": "theme-harvest-20260924",
+      "normalization_state": "portable-preview",
+      "source_hash": "1e171081f5a06d7568554aedcc6a17fd17f102b4109e9b543895fca3879606c2",
+      "app_manifest": "apps/insurance-site/.agentsam/app.json",
+      "help_root": "apps/insurance-site/docs/",
+      "preview_kind": "static",
+      "package": "@inneranimalmedia/theme-insurance-site",
+      "gallery_path": "apps/theme-gallery-preview/themes/insurance-site",
+      "capabilities": [
+        "theme.storefront.shell"
+      ]
+    },
+    "relationships": [
+      {
+        "relationship_type": "packaged_as",
+        "target_type": "sdk-package",
+        "target_slug": "theme-insurance-site"
+      },
+      {
+        "relationship_type": "depends_on",
+        "target_type": "capability",
+        "target_slug": "theme.storefront.shell"
+      },
+      {
+        "relationship_type": "sourced_from",
+        "target_type": "gallery-theme",
+        "target_slug": "insurance-site"
+      }
+    ],
+    "_note": "repository_id must be resolved against live code_repositories before D1 UPSERT"
+  },
+  {
+    "slug": "shinshu-site",
+    "name": "Shinshu Solutions",
+    "kind": "app",
+    "status": "scaffolded",
+    "repository_id": null,
+    "canonical_path": "apps/shinshu-site",
+    "package_name": "@inneranimalmedia/theme-shinshu-site",
+    "metadata": {
+      "origin": "machine_harvest",
+      "donor_name": "Shinshu Solutions",
+      "source_path": "/Users/samprimeaux/IAM-Library/01_Template_Candidates/MEAUXIDERANDOMBUILDS/06_shinshu_static_site_archive/source/shinshu-solutions/static",
+      "harvest_batch": "theme-harvest-20260924",
+      "normalization_state": "portable-preview",
+      "source_hash": "dbe669910cbee05028a7113c2e1f72d0d964f8898d48130f67c5955fbbbc978e",
+      "app_manifest": "apps/shinshu-site/.agentsam/app.json",
+      "help_root": "apps/shinshu-site/docs/",
+      "preview_kind": "static",
+      "package": "@inneranimalmedia/theme-shinshu-site",
+      "gallery_path": "apps/theme-gallery-preview/themes/shinshu-site",
+      "capabilities": [
+        "cms.pages",
+        "forms.leads",
+        "theme.storefront.shell"
+      ]
+    },
+    "relationships": [
+      {
+        "relationship_type": "packaged_as",
+        "target_type": "sdk-package",
+        "target_slug": "theme-shinshu-site"
+      },
+      {
+        "relationship_type": "depends_on",
+        "target_type": "capability",
+        "target_slug": "theme.storefront.shell"
+      },
+      {
+        "relationship_type": "sourced_from",
+        "target_type": "gallery-theme",
+        "target_slug": "shinshu-site"
+      }
+    ],
+    "_note": "repository_id must be resolved against live code_repositories before D1 UPSERT"
+  }
+]