@inneranimalmedia/agentsam-sdk 2.6.4 → 2.6.7

package/packages/theme-scenes/test/theme-scenes.test.mjs

@@ -0,0 +1,179 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+
+import {
+  BLOCK_KINDS,
+  SCENE_KINDS,
+  SCENE_ORIGIN,
+  SCROLL_PRESETS,
+  composeCardCollection,
+  createCopyBlock,
+  createActionBlock,
+  createDemoBlock,
+  createWorkPreset,
+  createAgencyHomePreset,
+  createPreset,
+  listPresets,
+  listSceneKinds,
+  listThemes,
+  resolveTheme,
+  themeToCssVars,
+  compilePage,
+  validatePageContent,
+  resolveRoute,
+  createDemoHost,
+  getSceneKind,
+  normalizeSection,
+} from '../src/index.js';
+
+describe('theme-scenes contracts', () => {
+  it('exports block kinds and scroll presets', () => {
+    assert.ok(BLOCK_KINDS.includes('copy'));
+    assert.ok(BLOCK_KINDS.includes('demo'));
+    assert.equal(SCROLL_PRESETS['sticky-story'].mode, 'sticky-story');
+    assert.ok(SCROLL_PRESETS.bridge.length <= 80);
+  });
+
+  it('composeCardCollection never invents fillers and adapts layout', () => {
+    assert.equal(composeCardCollection([]), null);
+    assert.equal(composeCardCollection([{ title: 'A' }]).layout.strategy, 'feature');
+    assert.equal(composeCardCollection([{ title: 'A' }, { title: 'B' }]).layout.strategy, 'split');
+    assert.equal(
+      composeCardCollection([{ title: 'A' }, { title: 'B' }, { title: 'C' }, { title: 'D' }]).layout.strategy,
+      'grid',
+    );
+    assert.equal(
+      composeCardCollection(Array.from({ length: 6 }, (_, i) => ({ title: String(i) }))).layout.strategy,
+      'rail',
+    );
+  });
+
+  it('resolveRoute uses host route map', () => {
+    const href = resolveRoute(
+      { type: 'route', ref: 'product.agentsam' },
+      { 'product.agentsam': '/agentsam' },
+    );
+    assert.equal(href, '/agentsam');
+    assert.equal(resolveRoute({ type: 'url', href: 'https://example.com' }, {}), 'https://example.com');
+  });
+});
+
+describe('scenes inventory', () => {
+  it('registers harvested scene kinds', () => {
+    const ids = listSceneKinds().map((s) => s.id);
+    assert.ok(ids.includes('hero.scroll-product'));
+    assert.ok(ids.includes('product.demo'));
+    assert.ok(ids.includes('bridge.theme'));
+    assert.ok(ids.includes('gallery.storyboard'));
+    assert.ok(Object.keys(SCENE_KINDS).length >= 8);
+  });
+
+  it('maps MeauxIDE / MeauxSQL origins to demo adapters', () => {
+    assert.equal(SCENE_ORIGIN['meauxide-block'].becomes, 'product.demo');
+    assert.equal(SCENE_ORIGIN['meauxide-block'].adapter, 'agentsam-mini-composer');
+    assert.equal(SCENE_ORIGIN['meauxsql-card'].adapter, 'database-editor');
+    assert.equal(SCENE_ORIGIN['vibe-shift-transition'].becomes, 'bridge.theme');
+  });
+
+  it('normalizeSection fills scroll defaults and drops empty cards', () => {
+    const section = normalizeSection({
+      id: 'x',
+      scene: 'product.stack',
+      groups: [
+        { blocks: [{ kind: 'cards', items: [] }, createCopyBlock({ title: 'Hi' })] },
+      ],
+    }, { scrollPresets: SCROLL_PRESETS });
+    assert.equal(section.scroll.mode, 'natural');
+    assert.equal(section.groups.length, 1);
+    assert.equal(section.groups[0].blocks.length, 1);
+    assert.equal(section.groups[0].blocks[0].kind, 'copy');
+  });
+});
+
+describe('themes', () => {
+  it('resolves inheritance inneranimal ← foundation', () => {
+    const t = resolveTheme('agentsam');
+    assert.equal(t.id, 'agentsam');
+    assert.ok(t.tokens.color['color.brand.primary'].value);
+    assert.ok(t.tokens.type['type.display.xl']);
+    const vars = themeToCssVars(t);
+    assert.ok(vars['--scene-accent']);
+  });
+
+  it('lists foundation family', () => {
+    const ids = listThemes().map((t) => t.id);
+    assert.deepEqual(ids.sort(), ['agentsam', 'autodidact', 'foundation', 'inneranimal'].sort());
+  });
+});
+
+describe('presets + compile', () => {
+  it('lists presets', () => {
+    assert.ok(listPresets().includes('work'));
+    assert.ok(listPresets().includes('agency-home'));
+  });
+
+  it('createWorkPreset compiles without hardcoded CDN or product hrefs in scenes', () => {
+    const page = createWorkPreset({
+      heroGroups: [{
+        blocks: [
+          createCopyBlock({ title: 'Interface clarity.', body: 'System discipline.' }),
+          createActionBlock({
+            label: 'Open',
+            target: { type: 'route', ref: 'product.agentsam' },
+          }),
+        ],
+      }],
+      agentsamGroups: [{
+        blocks: [
+          createCopyBlock({ title: 'AgentSam' }),
+          createDemoBlock('agentsam-mini-composer'),
+        ],
+      }],
+      productGroups: [{
+        blocks: [
+          composeCardCollection([
+            { title: 'Database', target: { type: 'route', ref: 'product.database' } },
+          ]),
+        ],
+      }],
+    });
+
+    const plan = compilePage(page);
+    assert.equal(plan.validation.ok, true);
+    assert.ok(plan.cssVars['--scene-accent']);
+    assert.equal(plan.sections[0].scene, 'hero.scroll-product');
+    assert.equal(plan.sections[1].demoHost.adapter, 'agentsam-mini-composer');
+    assert.equal(plan.sections[0].groups[0].blocks[1].href, '/agentsam');
+
+    const dumped = JSON.stringify(plan);
+    assert.equal(dumped.includes('imagedelivery.net'), false);
+    assert.equal(dumped.includes('bg-[#020617]'), false);
+  });
+
+  it('agency-home has bridge + capability scenes', () => {
+    const page = createAgencyHomePreset({});
+    const scenes = page.sections.map((s) => s.scene);
+    assert.ok(scenes.includes('bridge.theme'));
+    assert.ok(scenes.includes('capability.grid'));
+    assert.ok(scenes.includes('product.demo'));
+  });
+
+  it('createPreset rejects unknown names', () => {
+    assert.throws(() => createPreset('nope'), /Unknown preset/);
+  });
+
+  it('validatePageContent flags missing scene', () => {
+    const r = validatePageContent({
+      id: 'x',
+      theme: 'foundation',
+      sections: [{ id: 'a' }],
+    });
+    assert.equal(r.ok, false);
+    assert.ok(r.errors.some((e) => e.code === 'scene_required'));
+  });
+
+  it('createDemoHost rejects unknown adapter', () => {
+    assert.throws(() => createDemoHost('fake'), /Unknown demo adapter/);
+    assert.equal(getSceneKind('hero.editorial').defaultScroll, 'viewport');
+  });
+});

package/packages/theme-shinshu-site/package.json

@@ -1,7 +1,7 @@
 {
-  "name": "@inneranimalmedia/theme-shinshu-site",
-  "version": "0.1.0",
-  "description": "Real Shinshu Solutions static archive \u2014 services, gallery, and CMS-ready pages.",
+  "name": "@inneranimalmedia/theme-summit",
+  "version": "2.6.7",
+  "description": "Real Shinshu Solutions static archive — services, gallery, and CMS-ready pages.",
   "type": "module",
   "main": "./src/index.js",
   "exports": {
@@ -25,7 +25,18 @@
     "kind": "theme",
     "slug": "shinshu-site",
     "galleryPath": "apps/theme-gallery-preview/themes/shinshu-site",
-    "installable": true,
-    "icon": "theme"
-  }
+    "installable": false,
+    "icon": "theme",
+    "lineage": "shin",
+    "family": "consulting-portfolio",
+    "normalization": "canonical_id_assigned",
+    "canonicalId": "summit",
+    "legacyPackageName": "@inneranimalmedia/theme-shinshu-site"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
+    "directory": "packages/theme-shinshu-site"
+  },
+  "private": true
 }

package/packages/theme-shinshu-site/src/harvest.json

@@ -2,11 +2,13 @@
   "harvest_batch": "theme-harvest-20260924",
   "app_path": "apps/shinshu-site",
   "harvest_path": "work/theme-harvest/shinshu-site",
-  "status": "scaffolded",
+  "status": "needs_normalization",
   "source_hash": "dbe669910cbee05028a7113c2e1f72d0d964f8898d48130f67c5955fbbbc978e",
   "capabilities": [
     "cms.pages",
     "forms.leads",
     "theme.storefront.shell"
-  ]
+  ],
+  "lineage": "shin",
+  "family": "consulting-portfolio"
 }

package/packages/theme-shinshu-site/src/index.js

@@ -1,7 +1,9 @@
-/** Deterministic installable theme contract for AgentSam gallery/CMS. */
+/** Harvested donor-derived theme wrapper — not installable until remaster gates pass. */
 const THEME = {
   "id": "theme.shinshu-site",
   "slug": "shinshu-site",
+  "lineage": "shin",
+  "family": "consulting-portfolio",
   "displayName": "Shinshu Solutions",
   "version": "0.1.0",
   "kind": "gallery-theme",
@@ -40,7 +42,7 @@ const THEME = {
     "mobile": "/themes/shinshu-site/demo/",
     "demoUrl": "/themes/shinshu-site/demo/"
   },
-  "installable": true,
+  "installable": false,
   "galleryPath": "apps/theme-gallery-preview/themes/shinshu-site",
   "capabilityHints": [
     "theme.storefront.shell"
@@ -69,7 +71,9 @@ export function createProductRow({ accountId = null, repositoryId = null, status
     package_name: theme.package,
     metadata: {
       origin: "gallery_mount",
-      normalization_state: status === "production" ? "promoted" : "portable-preview",
+      normalization_state: status === "production" ? "promoted" : "needs_normalization",
+      lineage: theme.lineage,
+      family: theme.family,
       package: theme.package,
       gallery_path: theme.galleryPath,
       preview_kind: theme.preview?.kind || "static",

package/packages/theme-shinshu-site/test/theme.test.mjs

@@ -2,10 +2,12 @@ import assert from 'node:assert/strict';
 import test from 'node:test';
 import { createTheme, createProductRow } from '../src/index.js';
 
-test('shinshu-site theme package exports installable contract', () => {
+test('shinshu-site theme package exports harvested (not installable) contract', () => {
   const theme = createTheme();
   assert.equal(theme.slug, "shinshu-site");
-  assert.equal(theme.installable, true);
+  assert.equal(theme.installable, false);
+  assert.equal(theme.lineage, "shin");
+  assert.equal(theme.family, "consulting-portfolio");
   assert.equal(theme.package, "@inneranimalmedia/theme-shinshu-site");
   assert.ok(Array.isArray(theme.pages));
 });

package/packages/work-graph/package.json

@@ -1,7 +1,6 @@
 {
-  "name": "@inneranimalmedia/work-graph",
-  "version": "0.1.0",
-  "private": true,
+  "name": "@inneranimalmedia/agentsam-work-graph",
+  "version": "2.6.7",
   "description": "Core AgentSam work-graph primitive: one graph model (WorkItem, Dependency, TimelineEvent, Artifact, Evidence, Actor) powering an engineering adapter (git/MCP/tests/deploys) and a business adapter (projects/clients/approvals/milestones), with Gantt/timeline rendering as a pure projection over the graph rather than its own source of truth.",
   "type": "module",
   "main": "./src/index.js",
@@ -15,5 +14,16 @@
   },
   "scripts": {
     "test": "node --test test/*.test.mjs"
-  }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SamPrimeaux/agentsam-sdk.git",
+    "directory": "packages/work-graph"
+  },
+  "files": [
+    "src"
+  ]
 }

package/packages/work-graph/src/index.js

@@ -20,7 +20,29 @@ export class WorkGraph {
 }
 
 export class WorkItem {
-  constructor({ id, title, type = 'task', status = 'planned', owner = null, start = null, end = null, dependencies = [], artifacts = [], evidence = [] } = {}) {
+  constructor({
+    id,
+    title,
+    type = 'task',
+    status = 'planned',
+    owner = null,
+    start = null,
+    end = null,
+    baselineStart = null,
+    baselineEnd = null,
+    progress = null,
+    parentId = null,
+    dependencies = [],
+    blockedReason = null,
+    estimateMinutes = null,
+    actualMinutes = null,
+    executionRef = null,
+    goapRef = null,
+    version = 1,
+    metadata = {},
+    artifacts = [],
+    evidence = [],
+  } = {}) {
     this.id = id ?? randomUUID();
     this.title = title;
     this.type = type;
@@ -28,7 +50,18 @@ export class WorkItem {
     this.owner = owner;
     this.start = start;
     this.end = end;
+    this.baselineStart = baselineStart;
+    this.baselineEnd = baselineEnd;
+    this.progress = progress;
+    this.parentId = parentId;
     this.dependencies = dependencies;
+    this.blockedReason = blockedReason;
+    this.estimateMinutes = estimateMinutes;
+    this.actualMinutes = actualMinutes;
+    this.executionRef = executionRef;
+    this.goapRef = goapRef;
+    this.version = version;
+    this.metadata = metadata;
     this.artifacts = artifacts;
     this.evidence = evidence;
   }

package/packages/work-graph/src/renderers/gantt-model.js

@@ -1,11 +1,35 @@
+function projectOwner(owner, actorById) {
+  if (!owner) return null;
+  if (typeof owner === 'object') return owner;
+  const actor = actorById.get(owner);
+  return actor ? { id: actor.id, name: actor.name, role: actor.role } : owner;
+}
+
 export function createGanttModel(graph) {
   const items = graph?.items ?? graph?.workItems ?? [];
+  const actorById = new Map((graph?.actors ?? []).map((actor) => [actor.id, actor]));
 
   return items.map((item) => ({
     id: item.id,
     title: item.title,
+    kind: item.type ?? 'task',
     status: item.status,
+    owner: projectOwner(item.owner, actorById),
     start: item.start ?? null,
     end: item.end ?? null,
+    baselineStart: item.baselineStart ?? null,
+    baselineEnd: item.baselineEnd ?? null,
+    progress: typeof item.progress === 'number' ? item.progress : null,
+    parentId: item.parentId ?? null,
+    dependencies: [...(item.dependencies ?? [])],
+    blockedReason: item.blockedReason ?? null,
+    estimateMinutes: item.estimateMinutes ?? null,
+    actualMinutes: item.actualMinutes ?? null,
+    executionRef: item.executionRef ?? null,
+    goapRef: item.goapRef ?? null,
+    version: item.version ?? 1,
+    artifactCount: item.artifacts?.length ?? 0,
+    evidenceCount: item.evidence?.length ?? 0,
+    metadata: { ...(item.metadata ?? {}) },
   }));
 }

package/packages/work-graph/test/work-graph.test.mjs

@@ -7,11 +7,25 @@ import { createProjectsAdapter } from '../src/adapters/business/projects.js';
 import { createTimelineModel } from '../src/renderers/timeline.js';
 import { createGanttModel } from '../src/renderers/gantt-model.js';
 
-test('work graph projects one source of truth into timeline and Gantt views', () => {
+test('work graph projects one source of truth into timeline and rich Gantt views', () => {
   const actor = new Actor({ id: 'agent-1', name: 'Agent One' });
-  const item = new WorkItem({ id: 'task-1', title: 'Index repository', owner: actor.id });
-  item.start = '2026-09-18';
-  item.end = '2026-09-19';
+  const item = new WorkItem({
+    id: 'task-1',
+    title: 'Index repository',
+    owner: actor.id,
+    start: '2026-09-18',
+    end: '2026-09-19',
+    baselineStart: '2026-09-17',
+    baselineEnd: '2026-09-18',
+    progress: 0.5,
+    parentId: 'phase-index',
+    estimateMinutes: 120,
+    actualMinutes: 70,
+    dependencies: ['inventory'],
+    artifacts: [{ id: 'artifact-1' }],
+    evidence: ['receipt-1'],
+    metadata: { summary: 'Repository indexing' },
+  });
   const graph = new WorkGraph({ name: 'Release', actors: [actor] });
   graph.add(item);
   graph.events.push(new TimelineEvent({ type: 'deploy', at: '2026-09-19T12:00:00Z', workItemId: item.id }));
@@ -21,9 +35,15 @@ test('work graph projects one source of truth into timeline and Gantt views', ()
   assert.equal(timeline.title, 'Release');
   assert.equal(timeline.lanes[0].items[0], item);
   assert.deepEqual(timeline.events.map((event) => event.type), ['test', 'deploy']);
-  assert.deepEqual(createGanttModel(graph)[0], {
-    id: 'task-1', title: 'Index repository', status: 'planned', start: '2026-09-18', end: '2026-09-19',
-  });
+
+  const gantt = createGanttModel(graph)[0];
+  assert.equal(gantt.id, 'task-1');
+  assert.equal(gantt.owner.name, 'Agent One');
+  assert.equal(gantt.progress, 0.5);
+  assert.equal(gantt.parentId, 'phase-index');
+  assert.equal(gantt.artifactCount, 1);
+  assert.equal(gantt.evidenceCount, 1);
+  assert.deepEqual(gantt.dependencies, ['inventory']);
 });
 
 test('adapters map source records without fetching or mutating them', () => {

package/protocol/FILEMETA_V1.md

@@ -36,7 +36,7 @@ Semantic entries correspond one-for-one with non-directory content entries and r
   "size": 213,
   "mode": 420,
   "hash": "sha256:...",
-  "package": "@inneranimalmedia/agentsam-sdk-identity",
+  "package": "@inneranimalmedia/agentsam-identity",
   "package_root": "packages/identity",
   "package_kind": "library",
   "system": "identity",
@@ -70,7 +70,7 @@ A package may declare stable package-level semantics without tagging every file:
 
 ```json
 {
-  "name": "@inneranimalmedia/agentsam-sdk-identity",
+  "name": "@inneranimalmedia/agentsam-identity",
   "agentsam": {
     "system": "identity",
     "kind": "library",

package/protocol/README.md

@@ -20,10 +20,12 @@ Platform repositories may consume the SDK, provide host adapters, or incubate pr
 agentsam-sdk/
 ├── src/                       # Node SDK + local/deploy CLI
 ├── python/agentsam_sdk/       # Python portable tools and TUI
-├── packages/                  # Optional focused packages/workspaces
-├── apps/                      # Runnable + mountable APP compositions
-│   └── */.agentsam/app.json   # App contract (standalone | embedded)
+├── packages/                  # Reusable PACKAGE / SERVICE / THEME code
+├── apps/                      # Portable product APPs (when agentsam.app.json exists)
+│   └── */agentsam.app.json    # Canonical APP product definition (APP.id)
+│   └── */.agentsam/app.json   # Host/install state (app_id → APP.id)
 ├── protocol/                  # Shared SDK contracts and ownership rules
+│   ├── apps/                  # agentsam.app.v1 + host-install schemas
 │   └── features/              # agentsam.feature.v1 schema + catalog
 ├── templates/                 # Scaffold templates
 ├── examples/                  # Runnable examples/pointers
@@ -31,12 +33,18 @@ agentsam-sdk/
 └── test/ + python/tests/      # Node and Python verification
 ```
 
-### APP vs FEATURE
+### Artifact taxonomy
 
-| Unit | Manifest | Role |
+| Type | Manifest | Role |
 |------|----------|------|
-| APP | `.agentsam/app.json` | Runnable/mountable product composition |
-| FEATURE | `agentsam.feature.json` | Vertical capability (provider/UI/domain/composer) |
+| **APP** | `agentsam.app.json` | Portable installable product — sole `APP.id` authority |
+| **PACKAGE** | `agentsam.package.json` / package metadata | Reusable code/capability |
+| **SERVICE** | `agentsam.package.json` (`type: "service"`) | Runtime infrastructure |
+| **HOST install** | `.agentsam/app.json` | Installation/mount state; references `app_id` |
+| **THEME** | theme package / theme-site scaffold | Appearance/content kit — not an APP |
+| **FEATURE** | `agentsam.feature.json` | Vertical capability (provider/UI/domain) |
+
+SSOT: [`docs/architecture/AGENTSAM_APPLICATION_CONTRACT.md`](../docs/architecture/AGENTSAM_APPLICATION_CONTRACT.md) · `agentsam app validate`
 
 `npm install` is inert. AgentSam activates features after validation → plan → operator approval → receipt.
 

package/protocol/apps/agentsam.app.v1.schema.json

@@ -2,15 +2,63 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://agentsam.inneranimalmedia.com/protocol/apps/agentsam.app.v1.schema.json",
   "title": "agentsam.app.v1",
-  "description": "Installable AgentSam product app. Owns its routes/runtime; identity never hardcodes product URLs.",
+  "description": "Installable AgentSam product APP. Canonical identity is id (kebab-case). Package, Worker, route, desktop, and service names live in other namespaces.",
   "type": "object",
-  "required": ["schema", "id", "name"],
+  "required": ["schema", "id", "name", "kind"],
   "properties": {
     "schema": { "const": "agentsam.app.v1" },
-    "id": { "type": "string", "minLength": 1 },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$",
+      "minLength": 2,
+      "description": "Immutable APP.id — short kebab-case product identity (not Worker/npm/route name)"
+    },
     "name": { "type": "string", "minLength": 1 },
-    "package": { "type": "string" },
+    "kind": { "const": "app" },
+    "product_id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$",
+      "description": "Optional platform PRODUCT registry id when it differs from APP.id"
+    },
+    "package": {
+      "type": "string",
+      "description": "npm package name (PACKAGE namespace) — must not be used as APP.id"
+    },
     "version": { "type": "string" },
+    "entrypoints": {
+      "type": "object",
+      "properties": {
+        "frontend": { "type": "string" },
+        "backend": { "type": "string" },
+        "cli": { "type": "string" }
+      },
+      "additionalProperties": { "type": "string" }
+    },
+    "capabilities": {
+      "description": "Capability tokens this APP provides (array) or legacy boolean map",
+      "oneOf": [
+        {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        {
+          "type": "object",
+          "additionalProperties": { "type": "boolean" }
+        }
+      ]
+    },
+    "provides": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "bin": { "type": "string" },
+    "commands": { "type": "object", "additionalProperties": { "type": "string" } },
+    "surfaces": {
+      "oneOf": [
+        { "type": "array", "items": { "type": "string" } },
+        { "type": "object" }
+      ]
+    },
     "routes": {
       "type": "object",
       "properties": {
@@ -35,17 +83,51 @@
             }
           }
         }
-      }
+      },
+      "additionalProperties": true
     },
     "runtime": {
       "type": "object",
       "properties": {
         "type": { "enum": ["spa", "ssr", "static"] },
         "assetRoot": { "type": "string" },
-        "shell": { "type": "string" }
+        "shell": { "type": "string" },
+        "browser": { "type": ["boolean", "string"] },
+        "local": { "type": ["boolean", "string"] },
+        "cloudflare": { "type": ["boolean", "string"] }
       },
       "additionalProperties": true
-    }
+    },
+    "preview": { "type": "object", "additionalProperties": true },
+    "install": { "type": "object", "additionalProperties": true },
+    "auth": { "type": "object", "additionalProperties": true },
+    "hosts": {
+      "type": "array",
+      "description": "HOST namespace — public origins this APP is served from. Separate from APP.id and from PLATFORM IAM_OAUTH_ISSUER.",
+      "items": {
+        "type": "object",
+        "required": ["host_id", "origin"],
+        "properties": {
+          "host_id": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$",
+            "description": "Canonical HOST.id for this origin"
+          },
+          "origin": {
+            "type": "string",
+            "format": "uri",
+            "description": "https://… origin (no path)"
+          },
+          "role": {
+            "type": "string",
+            "enum": ["production", "development", "preview", "staging"]
+          },
+          "notes": { "type": "string" }
+        },
+        "additionalProperties": true
+      }
+    },
+    "secrets": { "type": "object", "additionalProperties": true }
   },
   "additionalProperties": true
 }

package/protocol/apps/agentsam.host-install.v1.schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://agentsam.inneranimalmedia.com/protocol/apps/agentsam.host-install.v1.schema.json",
+  "title": "agentsam.host-install.v1",
+  "description": "Host/installation state for an AgentSam APP. Lives under .agentsam/app.json. References APP.id; must not redefine product identity (enforced by agentsam app validate).",
+  "type": "object",
+  "required": ["schema", "app_id"],
+  "properties": {
+    "schema": { "const": "agentsam.host-install.v1" },
+    "app_id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9]*(-[a-z0-9]+)*$",
+      "description": "Must resolve to a known agentsam.app.json id"
+    },
+    "config": { "type": "object", "additionalProperties": true },
+    "mounts": {
+      "type": "array",
+      "items": {
+        "oneOf": [
+          { "type": "string" },
+          {
+            "type": "object",
+            "additionalProperties": true
+          }
+        ]
+      }
+    },
+    "features": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Feature ids enabled for this installation"
+    },
+    "notes": { "type": "string" }
+  },
+  "additionalProperties": true
+}