@inneranimalmedia/agentsam-sdk 2.6.10 → 2.6.12

package/migrations/runtime/0009_analytics_authority.sql

@@ -0,0 +1,108 @@
+-- AgentSam analytics authority v1.
+--
+-- Replace the old, empty aggregate-shaped agentsam_analytics table with the
+-- canonical HOT analytical fact ledger.
+--
+-- Safety: the guard aborts if the legacy table contains any rows.
+-- Operational tables remain authoritative for live transactional state.
+-- agentsam_analytics owns normalized analytical facts.
+-- Basin/Iceberg receives compact projections from those facts.
+
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE IF NOT EXISTS agentsam_analytics_migration_guard_0009 (
+  row_count INTEGER NOT NULL CHECK (row_count = 0)
+);
+
+DELETE FROM agentsam_analytics_migration_guard_0009;
+
+INSERT INTO agentsam_analytics_migration_guard_0009 (row_count)
+SELECT COUNT(*) FROM agentsam_analytics;
+
+DROP TABLE agentsam_analytics_migration_guard_0009;
+
+ALTER TABLE agentsam_analytics
+RENAME TO agentsam_analytics_aggregate_legacy_20261003;
+
+CREATE TABLE agentsam_analytics (
+  id                    TEXT PRIMARY KEY NOT NULL,
+  schema_name           TEXT NOT NULL DEFAULT 'agentsam.metric-event.v1',
+
+  account_id            TEXT,
+  tenant_id             TEXT,
+  workspace_id          TEXT,
+  repository_id         TEXT,
+  git_sha               TEXT,
+  run_id                TEXT,
+  receipt_id            TEXT,
+
+  event_kind            TEXT NOT NULL,
+  domain                TEXT NOT NULL,
+  operation             TEXT NOT NULL,
+  outcome               TEXT,
+
+  source_client         TEXT,
+  source_table          TEXT,
+  source_id             TEXT,
+  provider              TEXT,
+  model_key             TEXT,
+  tool_key              TEXT,
+
+  duration_ms           INTEGER CHECK (duration_ms IS NULL OR duration_ms >= 0),
+  queue_wait_ms         INTEGER CHECK (queue_wait_ms IS NULL OR queue_wait_ms >= 0),
+  external_wait_ms      INTEGER CHECK (external_wait_ms IS NULL OR external_wait_ms >= 0),
+  active_model_ms       INTEGER CHECK (active_model_ms IS NULL OR active_model_ms >= 0),
+
+  input_tokens          INTEGER CHECK (input_tokens IS NULL OR input_tokens >= 0),
+  cached_input_tokens   INTEGER CHECK (cached_input_tokens IS NULL OR cached_input_tokens >= 0),
+  output_tokens         INTEGER CHECK (output_tokens IS NULL OR output_tokens >= 0),
+  reasoning_tokens      INTEGER CHECK (reasoning_tokens IS NULL OR reasoning_tokens >= 0),
+  cost_usd              REAL CHECK (cost_usd IS NULL OR cost_usd >= 0),
+  cost_basis            TEXT,
+
+  attempt_count         INTEGER CHECK (attempt_count IS NULL OR attempt_count >= 0),
+  retry_count           INTEGER CHECK (retry_count IS NULL OR retry_count >= 0),
+  plan_points           REAL,
+
+  score_family          TEXT,
+  score_value           REAL,
+  weights_version       TEXT,
+
+  error_code            TEXT,
+  failure_origin        TEXT,
+  artifact_ref          TEXT,
+
+  dimensions_json       TEXT NOT NULL DEFAULT '{}',
+  metrics_json          TEXT NOT NULL DEFAULT '{}',
+
+  dedup_key             TEXT,
+  created_at_unix       INTEGER NOT NULL DEFAULT (unixepoch()),
+
+  CHECK (score_value IS NULL OR score_family IS NOT NULL),
+  CHECK (score_family IS NULL OR weights_version IS NOT NULL)
+);
+
+CREATE UNIQUE INDEX idx_agentsam_analytics_dedup
+  ON agentsam_analytics(dedup_key)
+  WHERE dedup_key IS NOT NULL;
+
+CREATE INDEX idx_agentsam_analytics_created
+  ON agentsam_analytics(created_at_unix DESC);
+
+CREATE INDEX idx_agentsam_analytics_run
+  ON agentsam_analytics(run_id, created_at_unix DESC);
+
+CREATE INDEX idx_agentsam_analytics_repo
+  ON agentsam_analytics(repository_id, git_sha, created_at_unix DESC);
+
+CREATE INDEX idx_agentsam_analytics_domain_operation
+  ON agentsam_analytics(domain, operation, created_at_unix DESC);
+
+CREATE INDEX idx_agentsam_analytics_outcome
+  ON agentsam_analytics(outcome, created_at_unix DESC);
+
+CREATE INDEX idx_agentsam_analytics_receipt
+  ON agentsam_analytics(receipt_id);
+
+CREATE INDEX idx_agentsam_analytics_score
+  ON agentsam_analytics(score_family, weights_version, created_at_unix DESC);

package/native/agentsam-machine/core/src/lib.rs

@@ -880,10 +880,10 @@ mod tests {
     #[test]
     fn church_site_fixture_produces_semantic_perception() {
         let fixture = Path::new(env!("CARGO_MANIFEST_DIR"))
-            .join("../../../apps/client-cms-editor/fixtures/donor-themes/church-site");
+            .join("../../../apps/client-cms-editor/fixtures/donor-themes/cypress");
         assert!(
             fixture.join("site/index.html").exists(),
-            "church-site fixture missing at {}",
+            "cypress fixture missing at {}",
             fixture.display()
         );
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/agentsam-sdk",
-  "version": "2.6.10",
+  "version": "2.6.12",
   "description": "Portable AgentSam SDK and CLI kits for local scaffolding, repository intelligence, incremental indexing, identity adapters, and verified dependency maintenance.",
   "type": "module",
   "main": "./src/index.js",
@@ -60,7 +60,7 @@
     "./identity/oauth/finalize-inbound": "./packages/identity/src/oauth/finalize-inbound.js",
     "./identity/oauth/redirect-paths": "./packages/identity/src/oauth/redirect-paths.js",
     "./identity/oauth/credentials": "./packages/identity/src/oauth/credentials.js",
-    "./identity/oauth/google-desktop-exchange": "./packages/identity/src/oauth/google-desktop-exchange.js",
+    "./identity/oauth/google-desktop-exchange": "./packages/identity/src/oauth/goaude.js",
     "./identity/oauth/iam-platform": "./packages/identity/src/oauth/iam-platform.js",
     "./identity/recovery/password-reset": "./packages/identity/src/recovery/password-reset.js",
     "./identity/server/worker-router": "./packages/identity/src/server/worker-router.js",
@@ -103,22 +103,15 @@
     "./cad-project": "./src/lib/cad/project-cli.js",
     "./providers/completeful": "./packages/providers/completeful/src/index.js",
     "./theme/heuristic": "./packages/heuristic-theme/src/index.js",
-    "./theme/church-site": "./packages/theme-church-site/src/index.js",
-    "./theme/companions-site": "./packages/theme-companions-site/src/index.js",
-    "./theme/floors-site": "./packages/theme-floors-site/src/index.js",
-    "./theme/fuelnfree-site": "./packages/theme-fuelnfree-site/src/index.js",
-    "./theme/handyman-site": "./packages/theme-handyman-site/src/index.js",
-    "./theme/insurance-site": "./packages/theme-insurance-site/src/index.js",
-    "./theme/shinshu-site": "./packages/theme-shinshu-site/src/index.js",
+    "./theme/cypress": "./packages/theme-cypress/src/index.js",
+    "./theme/violet": "./packages/theme-violet/src/index.js",
+    "./theme/grove": "./packages/theme-grove/src/index.js",
+    "./theme/ember": "./packages/theme-ember/src/index.js",
+    "./theme/forge": "./packages/theme-forge/src/index.js",
+    "./theme/harbor": "./packages/theme-harbor/src/index.js",
+    "./theme/summit": "./packages/theme-summit/src/index.js",
     "./identity/oauth/consent-view": "./packages/identity/src/oauth/consent-view.js",
     "./theme-scenes": "./packages/theme-scenes/src/index.js",
-    "./theme/cypress": "./packages/theme-church-site/src/index.js",
-    "./theme/violet": "./packages/theme-companions-site/src/index.js",
-    "./theme/grove": "./packages/theme-floors-site/src/index.js",
-    "./theme/ember": "./packages/theme-fuelnfree-site/src/index.js",
-    "./theme/forge": "./packages/theme-handyman-site/src/index.js",
-    "./theme/harbor": "./packages/theme-insurance-site/src/index.js",
-    "./theme/summit": "./packages/theme-shinshu-site/src/index.js",
     "./models/inventory": "./src/models/inventory-core.js",
     "./models/provider-snapshot-schema": "./protocol/models/provider-model-snapshot.v1.schema.json",
     "./local-engine": "./src/local-engine/index.js",
@@ -134,7 +127,16 @@
     "./hooks/protocol/config": "./protocol/hooks/agentsam.hooks.config.v1.schema.json",
     "./hooks/protocol/receipt": "./protocol/hooks/agentsam.hook.receipt.v1.schema.json",
     "./hooks/schema/manifest": "./packages/agentsam-hooks/schema/manifest.json",
-    "./hooks/schema/sqlite": "./migrations/runtime/0005_agentsam_hooks.sql"
+    "./hooks/schema/sqlite": "./migrations/runtime/0005_agentsam_hooks.sql",
+    "./acp": "./src/acp/index.js",
+    "./acp/http": "./src/acp/http.js",
+    "./acp/runtime-selection": "./src/acp/runtime-selection.js",
+    "./receipts": "./src/receipts/index.js",
+    "./receipts/schema": "./protocol/receipts/agentsam.receipt.v1.json",
+    "./merch": "./packages/agentsam-merch/src/index.js",
+    "./merch/node": "./packages/agentsam-merch/src/node/index.js",
+    "./theme/resolve": "./packages/theme-resolve/src/index.js",
+    "./campaign": "./packages/agentsam-campaign/src/index.js"
   },
   "bin": {
     "agentsam": "bin/agentsam",
@@ -163,7 +165,7 @@
     "packages/work-graph",
     "packages/agentsam-queue-control",
     "packages/agentsam-goap",
-    "packages/connectors/cloudflare",
+    "packages/connectors/cfoa",
     "packages/providers/completeful",
     "templates",
     "docs",
@@ -190,13 +192,14 @@
     "AGENTSAM.md",
     "apps/cad-creator/shared/cad",
     "packages/heuristic-theme",
-    "packages/theme-church-site",
-    "packages/theme-companions-site",
-    "packages/theme-floors-site",
-    "packages/theme-fuelnfree-site",
-    "packages/theme-handyman-site",
-    "packages/theme-insurance-site",
-    "packages/theme-shinshu-site",
+    "packages/theme-cypress",
+    "packages/theme-violet",
+    "packages/theme-grove",
+    "packages/theme-ember",
+    "packages/theme-forge",
+    "packages/theme-harbor",
+    "packages/theme-summit",
+    "packages/theme-resolve",
     "packages/theme-scenes",
     "packages/agentsam-vault/package.json",
     "packages/agentsam-vault/README.md",
@@ -229,11 +232,16 @@
     "packages/agentsam-workbench/package.json",
     "packages/agentsam-workbench/README.md",
     "packages/agentsam-workbench/src",
-    "packages/agentsam-workbench/tsconfig.json"
+    "packages/agentsam-workbench/tsconfig.json",
+    "packages/agentsam-merch",
+    "TRADEMARKS.md"
   ],
   "workspaces": [
+    "packages/agentsam-analytics",
+    "packages/analytics-ui",
     "packages/agentsam-assets-core",
     "packages/agentsam-brand",
+    "packages/agentsam-campaign",
     "packages/agentsam-cloudflare-images",
     "packages/agentsam-content",
     "packages/agentsam-content-studio",
@@ -248,6 +256,7 @@
     "packages/agentsam-key-manager",
     "packages/agentsam-knowledge",
     "packages/agentsam-loading-scene",
+    "packages/agentsam-merch",
     "packages/agentsam-nav",
     "packages/agentsam-queue-control",
     "packages/agentsam-repository",
@@ -258,25 +267,42 @@
     "packages/agentsam-work",
     "packages/agentsam-workbench",
     "packages/cms-runtime",
-    "packages/connectors/cloudflare",
+    "packages/connectors/cfoa",
     "packages/heuristic-theme",
     "packages/identity",
     "packages/providers/completeful",
-    "packages/theme-church-site",
-    "packages/theme-companions-site",
-    "packages/theme-floors-site",
-    "packages/theme-fuelnfree-site",
-    "packages/theme-handyman-site",
+    "packages/theme-cypress",
+    "packages/theme-violet",
+    "packages/theme-grove",
+    "packages/theme-ember",
+    "packages/theme-forge",
     "packages/theme-iasf",
-    "packages/theme-insurance-site",
+    "packages/theme-harbor",
     "packages/theme-scenes",
-    "packages/theme-shinshu-site",
+    "packages/theme-summit",
     "packages/work-graph",
-    "examples/hyperspace-demo"
+    "examples/hyperspace-demo",
+    "packages/theme-resolve",
+    "packages/agentsam-abs",
+    "packages/agentsam-browser-surface",
+    "packages/agentsam-sections",
+    "packages/copro-project",
+    "packages/copro-editor",
+    "packages/copro-media",
+    "packages/copro-render",
+    "packages/copro-provider-contracts",
+    "packages/copro-timeline",
+    "packages/copro-templates",
+    "packages/copro-proof",
+    "packages/copro-ui",
+    "packages/copro-storage"
   ],
   "scripts": {
     "test": "npm run test:standard && npm --prefix packages/identity test && npm --prefix packages/agentsam-brand test && npm run test:connectors && npm run test:providers",
     "test:brand": "npm --prefix packages/agentsam-brand test",
+    "brand:scan": "python3 scripts/brand-compliance/brand_compliance.py scan",
+    "brand:check": "python3 scripts/brand-compliance/brand_compliance.py check",
+    "brand:apply": "python3 scripts/brand-compliance/brand_compliance.py apply",
     "test:content": "npm run build -w @inneranimalmedia/agentsam-assets-core && npm run test -w @inneranimalmedia/agentsam-assets-core && npm run build -w @inneranimalmedia/agentsam-scoring && npm run test -w @inneranimalmedia/agentsam-scoring && npm run build -w @inneranimalmedia/agentsam-cloudflare-images && npm run test -w @inneranimalmedia/agentsam-cloudflare-images && npm run build -w @inneranimalmedia/agentsam-content && npm run test -w @inneranimalmedia/agentsam-content && npm run build -w @inneranimalmedia/agentsam-content-studio && npm run test -w @inneranimalmedia/agentsam-content-studio",
     "build:content": "npm run build -w @inneranimalmedia/agentsam-assets-core && npm run build -w @inneranimalmedia/agentsam-scoring && npm run build -w @inneranimalmedia/agentsam-cloudflare-images && npm run build -w @inneranimalmedia/agentsam-content && npm run build -w @inneranimalmedia/agentsam-content-studio",
     "test:standard": "node test/smoke.mjs && npm run test:unit && npm run test:cli && npm run test:integration:mock && npm run test:terminal:mock",
@@ -286,7 +312,7 @@
     "test:terminal:mock": "node --test test/terminal/*.test.mjs",
     "test:live:terminal": "node --test test/live/*.live.test.mjs",
     "test:identity": "npm --prefix packages/identity test",
-    "test:workspaces": "npm --prefix packages/agentsam-contracts test && npm --prefix packages/agentsam-contracts run typecheck && npm --prefix packages/agentsam-errors test && npm --prefix packages/agentsam-vault test && npm --prefix packages/agentsam-repository test && npm --prefix packages/agentsam-workbench test && npm --prefix packages/agentsam-workbench run typecheck && npm --prefix packages/agentsam-nav run typecheck && npm --prefix packages/agentsam-shell-kit run typecheck && npm --prefix packages/work-graph test && npm --prefix packages/agentsam-queue-control test && npm --prefix packages/cms-runtime test && npm --prefix packages/agentsam-goap test && npm --prefix packages/agentsam-hooks test",
+    "test:workspaces": "npm --prefix packages/agentsam-contracts run build && npm --prefix packages/agentsam-contracts test && npm --prefix packages/agentsam-contracts run typecheck && npm --prefix packages/agentsam-errors test && npm --prefix packages/agentsam-vault test && npm --prefix packages/agentsam-repository test && npm --prefix packages/agentsam-workbench run build && npm --prefix packages/agentsam-workbench test && npm --prefix packages/agentsam-workbench run typecheck && npm --prefix packages/agentsam-nav run typecheck && npm --prefix packages/agentsam-shell-kit run typecheck && npm --prefix packages/work-graph test && npm --prefix packages/agentsam-queue-control test && npm --prefix packages/cms-runtime test && npm --prefix packages/agentsam-goap test && npm --prefix packages/agentsam-hooks test",
     "test:autorag": "npm --prefix packages/agentsam-knowledge test",
     "smoke": "node test/smoke.mjs",
     "verify:package": "node scripts/verify-package.mjs",
@@ -296,7 +322,7 @@
     "test:python": "node scripts/verify-python.mjs",
     "verify:release": "npm run verify && npm run verify:packages:public && npm run verify:knowledge-package && npm run test:python && npm run security:release",
     "pack:check": "node scripts/verify-pack.mjs",
-    "verify": "npm run release:train:check && npm run errors:check && npm run proto:check && npm test && npm run test:workspaces && npm run cad:registry:check && npm run app:validate && npm run verify:boundaries && npm run verify:package && npm run verify:bootstrap && npm run pack:check",
+    "verify": "npm run brand:check && npm run release:train:check && npm run errors:check && npm run proto:check && npm test && npm run test:workspaces && npm run cad:registry:check && npm run app:validate && npm run verify:boundaries && npm run verify:package && npm run verify:bootstrap && npm run pack:check",
     "publish:identity-alpha": "bash scripts/publish-identity-alpha.sh",
     "publish:identity-alpha:dry-run": "bash scripts/publish-identity-alpha.sh --dry-run",
     "publish:identity-alpha:publish-only": "bash scripts/publish-identity-alpha.sh --publish-only",
@@ -309,7 +335,7 @@
     "security:check": "node src/security/cli.mjs scan",
     "security:repair": "node src/security/cli.mjs repair",
     "ui:preview": "node scripts/ui-preview.mjs",
-    "test:connectors": "node --test packages/connectors/cloudflare/tests/**/*.test.mjs",
+    "test:connectors": "node --test packages/connectors/cfoa/tests/**/*.test.mjs",
     "verify:npm10-lock": "node apps/local-studio/scripts/verify-npm10-lock.mjs",
     "proto:generate": "node scripts/generate-proto.mjs",
     "proto:check": "node scripts/verify-proto.mjs",
@@ -320,9 +346,8 @@
     "app:packaging": "node scripts/verify-app-packaging.mjs --pack",
     "guard:apps": "npm run app:validate && npm run app:packaging",
     "test:providers": "node --test packages/providers/completeful/test/*.test.mjs",
-    "test:themes": "npm --prefix packages/heuristic-theme test && npm --prefix packages/theme-church-site test && npm --prefix packages/theme-companions-site test && npm --prefix packages/theme-floors-site test && npm --prefix packages/theme-fuelnfree-site test && npm --prefix packages/theme-handyman-site test && npm --prefix packages/theme-insurance-site test && npm --prefix packages/theme-shinshu-site test && npm --prefix packages/theme-scenes test",
+    "test:themes": "npm --prefix packages/heuristic-theme test && npm --prefix packages/theme-cypress test && npm --prefix packages/theme-violet test && npm --prefix packages/theme-grove test && npm --prefix packages/theme-ember test && npm --prefix packages/theme-forge test && npm --prefix packages/theme-harbor test && npm --prefix packages/theme-summit test && npm --prefix packages/theme-resolve test && npm --prefix packages/theme-scenes test",
     "test:theme-scenes": "npm --prefix packages/theme-scenes test",
-    "theme:harvest": "python3 scripts/theme-refinery/harvest.py",
     "verify:go-distribution": "node scripts/verify-go-distribution.mjs",
     "prove:product": "node scripts/prove-agentsam-product.mjs",
     "security:release": "node scripts/verify-release-security.mjs",
@@ -332,7 +357,16 @@
     "release:train:align": "node scripts/release-train.mjs align",
     "ci:products": "node scripts/ci-products.mjs",
     "verify:packages:public": "node scripts/verify-public-packages.mjs",
-    "test:hooks": "npm --prefix packages/agentsam-hooks test"
+    "test:hooks": "npm --prefix packages/agentsam-hooks test",
+    "verify:sterility": "node scripts/verify-sdk-sterility.mjs --scope themes",
+    "verify:sterility:repo": "node scripts/verify-sdk-sterility.mjs --scope repo",
+    "verify:theme-packages": "node scripts/verify-theme-packages.mjs",
+    "build:browser-packages": "npm run build -w @inneranimalmedia/agentsam-loading-scene && npm run build -w @inneranimalmedia/agentsam-abs && npm run build -w @inneranimalmedia/agentsam-browser-surface && npm run build -w @inneranimalmedia/agentsam-sections",
+    "typecheck:browser-packages": "npm run build -w @inneranimalmedia/agentsam-loading-scene && npm run typecheck -w @inneranimalmedia/agentsam-abs && npm run typecheck -w @inneranimalmedia/agentsam-browser-surface && npm run typecheck -w @inneranimalmedia/agentsam-sections",
+    "dev:browser-site": "npm --prefix apps/agentsam-browser-site run dev",
+    "build:browser-site": "npm --prefix apps/agentsam-browser-site run build",
+    "typecheck:browser-site": "npm --prefix apps/agentsam-browser-site run typecheck",
+    "verify:browser-promo": "npm run typecheck:browser-packages && npm run build:browser-packages && npm run typecheck:browser-site && npm run build:browser-site"
   },
   "engines": {
     "node": ">=22 <25",
@@ -341,7 +375,7 @@
   "dependencies": {
     "@clack/prompts": "^1.7.0",
     "@grpc/grpc-js": "^1.14.4",
-    "@inneranimalmedia/agentsam-errors": "2.6.10",
+    "@inneranimalmedia/agentsam-errors": "2.6.12",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "google-protobuf": "^3.21.4",
     "node-pty": "^1.1.0",
@@ -381,6 +415,7 @@
     "workerd@1.20260925.1": true,
     "esbuild@0.28.2": true,
     "workerd@1.20260930.2": true,
+    "workerd@1.20261001.1": true,
     "sharp@0.34.5": true,
     "sharp@0.35.4": true,
     "sharp@0.35.5": true
@@ -392,7 +427,7 @@
     "@electric-sql/pglite-pgvector": "0.0.9",
     "esbuild": "0.28.1",
     "grpc-tools": "^1.13.1",
-    "wrangler": "4.145.0"
+    "wrangler": "4.147.0"
   },
   "overrides": {
     "@types/react": "19.2.18",

package/packages/agentsam-brand/README.md

@@ -114,3 +114,6 @@ npm --prefix packages/theme-scenes test
 ```
 
 See `packages/theme-scenes/README.md`. Studio shell (Moon Glass → Brand Studio) sits above both packages in a later tranche.
+
+<!-- agentsam:trademark-notice -->
+> Independent project. Not affiliated with, endorsed by, or sponsored by Cloudflare, Inc. or by any other company whose products are named here. Cloudflare is a registered trademark of Cloudflare, Inc. Other names are trademarks of their respective owners. See [TRADEMARKS](https://github.com/SamPrimeaux/agentsam-sdk/blob/main/TRADEMARKS.md).

package/packages/agentsam-brand/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inneranimalmedia/agentsam-brand",
-  "version": "2.6.10",
+  "version": "2.6.12",
   "description": "Deterministic Brand Intelligence + portable brand-asset promotion SDK for AgentSam (inspect, derive, plan, promote, publish, verify).",
   "type": "module",
   "license": "MIT",
@@ -12,7 +12,7 @@
   },
   "main": "./src/index.js",
   "bin": {
-    "agentsam-brand": "./bin/agentsam-brand.mjs"
+    "agentsam-brand": "bin/agentsam-brand.mjs"
   },
   "exports": {
     ".": "./src/index.js",
@@ -24,7 +24,8 @@
     "./assets": "./src/index.js",
     "./presets": "./src/presets/index.js",
     "./cli": "./src/cli/controller.js",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./public": "./src/public.js"
   },
   "files": [
     "bin",

package/packages/agentsam-brand/src/public.js

@@ -0,0 +1,192 @@
+import { brandResolve } from './resolve.js';
+import { buildBrandContractDraft } from './contract.js';
+import { brandPlan } from './plan.js';
+
+function assertScan(scan) {
+  if (!scan || scan.capability !== 'brand.scan') {
+    throw new Error('brand_public_requires_brand_scan_evidence');
+  }
+  return scan;
+}
+
+function rows(value) {
+  return Array.isArray(value) ? value : [];
+}
+
+function assetId(asset, index) {
+  return String(
+    asset?.id ?? asset?.asset_id ?? asset?.key ??
+    asset?.path ?? asset?.url ?? `asset:${index + 1}`
+  );
+}
+
+export function inspectBrandEvidence(scan, options = {}) {
+  const valid = assertScan(scan);
+  const resolved = brandResolve(valid, options.resolve || {});
+  return {
+    capability: 'brand.public.inspect',
+    deterministic: true,
+    model_required: false,
+    side_effects: 'none',
+    scan: valid,
+    resolved,
+    summary: {
+      colors: valid.tokens?.colors?.length || 0,
+      typography: valid.tokens?.typography?.length || 0,
+      assets: rows(valid.assets).length,
+      conflicts: rows(valid.conflicts).length,
+      ambiguities: rows(resolved.ambiguities).length,
+    },
+  };
+}
+
+export function listBrandAssetEvidence(scan) {
+  return rows(assertScan(scan).assets).map((asset, index) => ({
+    id: assetId(asset, index),
+    ...asset,
+  }));
+}
+
+export function inspectBrandAssetEvidence(scan, wantedId) {
+  const asset = listBrandAssetEvidence(scan)
+    .find((row) => row.id === String(wantedId || ''));
+  if (!asset) throw new Error('brand_asset_not_found');
+  return {
+    capability: 'brand.public.asset.inspect',
+    deterministic: true,
+    asset,
+  };
+}
+
+export function findBrandUsageEvidence(scan, query) {
+  const valid = assertScan(scan);
+  const needle = String(query || '').trim().toLowerCase();
+  if (!needle) throw new Error('brand_usage_query_required');
+
+  const hits = [];
+  const seen = new Set();
+
+  function walk(value, path = '$') {
+    if (value == null) return;
+    if (typeof value === 'string') {
+      if (value.toLowerCase().includes(needle)) {
+        const key = `${path}:${value}`;
+        if (!seen.has(key)) {
+          seen.add(key);
+          hits.push({ path, value });
+        }
+      }
+      return;
+    }
+    if (Array.isArray(value)) {
+      value.forEach((entry, index) => walk(entry, `${path}[${index}]`));
+      return;
+    }
+    if (typeof value === 'object') {
+      for (const [key, entry] of Object.entries(value)) {
+        walk(entry, `${path}.${key}`);
+      }
+    }
+  }
+
+  walk({
+    assets: valid.assets,
+    components: valid.components,
+    patterns: valid.patterns,
+    tokens: valid.tokens,
+  });
+
+  return {
+    capability: 'brand.public.usage.find',
+    deterministic: true,
+    query,
+    hits: hits.slice(0, 250),
+    truncated: hits.length > 250,
+  };
+}
+
+export function draftBrandContractFromEvidence(scan, options = {}) {
+  const valid = assertScan(scan);
+  const resolved = options.resolved || brandResolve(valid, options.resolve || {});
+  const contract = buildBrandContractDraft({
+    scan: valid,
+    resolved,
+    brandId: options.brandId || 'brand:inferred',
+  });
+  return {
+    capability: 'brand.public.contract.draft',
+    deterministic: true,
+    resolved,
+    contract,
+  };
+}
+
+export function buildBrandPlanFromEvidence(scan, options = {}) {
+  const valid = assertScan(scan);
+  const resolved = options.resolved || brandResolve(valid, options.resolve || {});
+  const contract = options.contract || buildBrandContractDraft({
+    scan: valid,
+    resolved,
+    brandId: options.brandId || 'brand:inferred',
+  });
+  return brandPlan({ scan: valid, resolved, contract });
+}
+
+function resolvedColors(contract) {
+  const source = contract?.visual_system?.colors?.resolved || {};
+  return new Set(
+    Object.values(source)
+      .map((row) => String(row?.value || '').trim().toLowerCase())
+      .filter(Boolean)
+  );
+}
+
+function observedFonts(contract) {
+  return new Set(
+    rows(contract?.visual_system?.typography?.observed)
+      .filter((row) => row?.kind === 'font_family')
+      .map((row) => String(row?.value || '').trim().toLowerCase())
+      .filter(Boolean)
+  );
+}
+
+export function evaluateBrandConsistency(contract, candidate = {}) {
+  if (!contract || contract.kind !== 'brand') {
+    throw new Error('brand_consistency_requires_brand_contract');
+  }
+
+  const colors = resolvedColors(contract);
+  const fonts = observedFonts(contract);
+  const checks = [
+    ...rows(candidate.colors).map((value) => ({
+      kind: 'color',
+      value: String(value),
+      accepted: colors.size ? colors.has(String(value).trim().toLowerCase()) : null,
+    })),
+    ...rows(candidate.fonts).map((value) => ({
+      kind: 'font',
+      value: String(value),
+      accepted: fonts.size ? fonts.has(String(value).trim().toLowerCase()) : null,
+    })),
+  ];
+
+  const definite = checks.filter((row) => row.accepted !== null);
+  const score = definite.length
+    ? definite.filter((row) => row.accepted).length / definite.length
+    : null;
+
+  return {
+    capability: 'brand.public.consistency.evaluate',
+    deterministic: true,
+    score: score == null ? null : Number(score.toFixed(3)),
+    verdict:
+      score == null ? 'insufficient_evidence' :
+      score >= 0.9 ? 'consistent' :
+      score >= 0.6 ? 'review' : 'inconsistent',
+    checks,
+    evidence: {
+      allowed_color_count: colors.size,
+      allowed_font_count: fonts.size,
+    },
+  };
+}

package/packages/agentsam-contracts/README.md

@@ -1,6 +1,6 @@
 # @inneranimalmedia/agentsam-contracts
 
-Framework-neutral AgentSam contracts shared by product surfaces. This package has no React dependency and must not know whether the host is Local Studio, CAD Studio, CMS Studio, Fuel & Free Time, or another product.
+Framework-neutral AgentSam contracts shared by product surfaces. This package has no React dependency and must not know whether the host is Local Studio, CAD Studio, CMS Studio, Ember Supply, or another product.
 
 It owns the portable AgentSam vocabulary: messages, inputs/runs, workbench events, tool calls/capabilities, tool definitions, provider descriptors/adapters, authority requirements, orchestration events, hook definitions, execution receipts, artifacts/attachments, explicit host context, model options, repository/company graph records, and adapter interfaces.
 

package/packages/agentsam-contracts/dist/adapter.d.ts

@@ -0,0 +1,22 @@
+import type { AgentEvent } from './events';
+import type { AgentInput, AgentRun } from './agent';
+import type { AgentCapability } from './tools';
+import type { ModelOption } from './models';
+export interface AgentWorkbenchAdapter {
+    send(input: AgentInput): AgentRun | Promise<AgentRun>;
+    cancel(runId: string): void | Promise<void>;
+    getModels(): ModelOption[] | Promise<ModelOption[]>;
+    getCapabilities(): AgentCapability[] | Promise<AgentCapability[]>;
+    subscribe(conversationId: string, onEvent: (event: AgentEvent) => void): () => void;
+}
+export interface BrowserWorkbenchAdapter {
+    navigate(url: string): void | Promise<void>;
+    back?(): void | Promise<void>;
+    forward?(): void | Promise<void>;
+    reload?(): void | Promise<void>;
+}
+export interface TerminalWorkbenchAdapter {
+    write(command: string): void | Promise<void>;
+    interrupt?(): void | Promise<void>;
+    resize?(cols: number, rows: number): void | Promise<void>;
+}