@inneranimalmedia/agentsam-sdk 2.6.3 → 2.6.5

package/packages/runtime-protocol/src/index.js

@@ -0,0 +1,154 @@
+/**
+ * agentsam.runtime.v1 — Runtime Registry vocabulary (JS).
+ * Physical D1 tables remain terminal_* ; domain nouns are Runtime*.
+ * Schema SSOT: protocol/runtime/agentsam.runtime.v1.schema.json
+ * Law: docs/architecture/AGENTSAM_RUNTIME_PROTOCOL.md
+ */
+
+export const RUNTIME_PROTOCOL_SCHEMA = 'agentsam.runtime.v1';
+
+/** Compute owner / cloud. Application-validated (no aggressive D1 CHECK). */
+export const RUNTIME_PROVIDERS = Object.freeze([
+  'local',
+  'google_cloud',
+  'cloudflare',
+  'aws',
+  'azure',
+  'fly',
+  'custom',
+]);
+
+/** What kind of computer/environment. */
+export const RUNTIME_SUBSTRATES = Object.freeze([
+  'host',
+  'vm',
+  'container',
+  'sandbox',
+  'workstation',
+  'microvm',
+  'kubernetes',
+]);
+
+export const RUNTIME_LIFECYCLES = Object.freeze([
+  'persistent',
+  'scale_to_zero',
+  'ephemeral',
+  'job',
+]);
+
+/**
+ * What speaks agentsam.runtime.v1 on the instance.
+ * ExecOS is an adapter implementation — never a transport.
+ */
+export const RUNTIME_ADAPTERS = Object.freeze([
+  'agentsamd',
+  'execos_legacy',
+  'cloudflare_sandbox',
+  'docker_engine',
+  'ssh',
+  'provider_native',
+]);
+
+/** How Studio/IAM reaches the adapter. */
+export const RUNTIME_TRANSPORTS = Object.freeze([
+  'direct_https',
+  'direct_wss',
+  'cloudflare_tunnel',
+  'vpc_service',
+  'vpc_network',
+  'service_binding',
+  'local_socket',
+  'provider_api',
+  'ssh',
+]);
+
+export const RUNTIME_AUTH_MODES = Object.freeze([
+  'connection_token',
+  'platform_bridge',
+  'bridge_key',
+  'service_binding',
+]);
+
+/** Capability keys — discovered, never inferred from provider alone. */
+export const RUNTIME_CAPABILITY_KEYS = Object.freeze([
+  'exec',
+  'pty',
+  'filesystem',
+  'persistent_filesystem',
+  'process',
+  'git',
+  'docker',
+  'gpu',
+  'browser',
+  'gui',
+  'ports',
+  'snapshot',
+]);
+
+/** @deprecated use RUNTIME_ADAPTERS */
+export const RUNTIME_KINDS = RUNTIME_ADAPTERS;
+
+/**
+ * Map legacy terminal_instances.kind → substrate.
+ * @param {'local_device'|'vm'|'sandbox'|string} kind
+ */
+export function substrateFromLegacyKind(kind) {
+  const k = String(kind || '').trim().toLowerCase();
+  if (k === 'local_device') return { substrate: 'host', target_lane: 'local', provider_hint: 'local' };
+  if (k === 'vm') return { substrate: 'vm', target_lane: 'remote', provider_hint: 'google_cloud' };
+  if (k === 'sandbox') return { substrate: 'sandbox', target_lane: 'sandbox', provider_hint: 'cloudflare' };
+  return { substrate: null, target_lane: null, provider_hint: null };
+}
+
+/**
+ * Map legacy connection transport + transport_provider → adapter + transport.
+ * @param {{ transport?: string, transport_provider?: string }} row
+ */
+export function normalizeLegacyConnection(row = {}) {
+  const legacyTransport = String(row.transport || '').trim().toLowerCase();
+  const legacyProvider = String(row.transport_provider || '').trim().toLowerCase();
+  let runtime_adapter = 'agentsamd';
+  if (legacyTransport === 'execos') runtime_adapter = 'execos_legacy';
+  else if (legacyTransport === 'container') runtime_adapter = 'cloudflare_sandbox';
+
+  let transport = legacyProvider || null;
+  if (!transport || transport === 'platform_vpc') {
+    transport = transport === 'platform_vpc' ? 'vpc_service' : 'direct_https';
+  }
+  if (legacyTransport === 'container' && !legacyProvider) {
+    transport = 'service_binding';
+  }
+
+  return {
+    protocol: RUNTIME_PROTOCOL_SCHEMA,
+    runtime_adapter,
+    transport,
+  };
+}
+
+/**
+ * Normalize arch vocabulary (live GCP still has x64).
+ * @param {string|null|undefined} arch
+ */
+export function normalizeArch(arch) {
+  const a = String(arch || '').trim().toLowerCase();
+  if (!a) return null;
+  if (a === 'x64' || a === 'amd64' || a === 'x86_64') return 'x86_64';
+  if (a === 'arm64' || a === 'aarch64') return 'arm64';
+  return a;
+}
+
+/**
+ * Hard-constraint check: every required capability must be true on candidate.
+ * @param {Record<string, boolean>} required
+ * @param {Record<string, boolean>} available
+ * @returns {{ ok: boolean, missing: string[] }}
+ */
+export function capabilitiesSatisfy(required = {}, available = {}) {
+  const missing = [];
+  for (const [key, need] of Object.entries(required)) {
+    if (!need) continue;
+    if (available[key] !== true) missing.push(key);
+  }
+  return { ok: missing.length === 0, missing };
+}

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

@@ -25,6 +25,7 @@
     "kind": "theme",
     "slug": "church-site",
     "galleryPath": "apps/theme-gallery-preview/themes/church-site",
-    "installable": true
+    "installable": true,
+    "icon": "theme"
   }
 }

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

@@ -5,6 +5,7 @@ const THEME = {
   "displayName": "New Iberia Church of Christ",
   "version": "0.1.0",
   "kind": "gallery-theme",
+  "icon": "theme",
   "package": "@inneranimalmedia/theme-church-site",
   "category": "Community",
   "industries": [

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

@@ -25,6 +25,7 @@
     "kind": "theme",
     "slug": "companions-site",
     "galleryPath": "apps/theme-gallery-preview/themes/companions-site",
-    "installable": true
+    "installable": true,
+    "icon": "theme"
   }
 }

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

@@ -5,6 +5,7 @@ const THEME = {
   "displayName": "Companions of Caddo",
   "version": "0.1.0",
   "kind": "gallery-theme",
+  "icon": "theme",
   "package": "@inneranimalmedia/theme-companions-site",
   "category": "Community",
   "industries": [

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

@@ -25,6 +25,7 @@
     "kind": "theme",
     "slug": "floors-site",
     "galleryPath": "apps/theme-gallery-preview/themes/floors-site",
-    "installable": true
+    "installable": true,
+    "icon": "theme"
   }
 }

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

@@ -5,6 +5,7 @@ const THEME = {
   "displayName": "Anything Floors & More",
   "version": "0.1.0",
   "kind": "gallery-theme",
+  "icon": "theme",
   "package": "@inneranimalmedia/theme-floors-site",
   "category": "Services",
   "industries": [

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

@@ -25,6 +25,7 @@
     "kind": "theme",
     "slug": "fuelnfree-site",
     "galleryPath": "apps/theme-gallery-preview/themes/fuelnfree-site",
-    "installable": true
+    "installable": true,
+    "icon": "theme"
   }
 }

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

@@ -5,6 +5,7 @@ const THEME = {
   "displayName": "Fuel & Free Time",
   "version": "0.1.0",
   "kind": "gallery-theme",
+  "icon": "theme",
   "package": "@inneranimalmedia/theme-fuelnfree-site",
   "category": "Commerce",
   "industries": [

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

@@ -25,6 +25,7 @@
     "kind": "theme",
     "slug": "handyman-site",
     "galleryPath": "apps/theme-gallery-preview/themes/handyman-site",
-    "installable": true
+    "installable": true,
+    "icon": "theme"
   }
 }

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

@@ -5,6 +5,7 @@ const THEME = {
   "displayName": "Primeaux Handyman Services",
   "version": "0.1.0",
   "kind": "gallery-theme",
+  "icon": "theme",
   "package": "@inneranimalmedia/theme-handyman-site",
   "category": "Services",
   "industries": [

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

@@ -25,6 +25,7 @@
     "kind": "theme",
     "slug": "insurance-site",
     "galleryPath": "apps/theme-gallery-preview/themes/insurance-site",
-    "installable": true
+    "installable": true,
+    "icon": "theme"
   }
 }

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

@@ -5,6 +5,7 @@ const THEME = {
   "displayName": "Chrystal Clear Insurance",
   "version": "0.1.0",
   "kind": "gallery-theme",
+  "icon": "theme",
   "package": "@inneranimalmedia/theme-insurance-site",
   "category": "Professional",
   "industries": [

package/packages/theme-scenes/README.md

@@ -0,0 +1,164 @@
+# @inneranimalmedia/theme-scenes
+
+Reusable **scene / shell / block** vocabulary for branded website experiences.
+
+| Layer | Owns |
+| --- | --- |
+| `@inneranimalmedia/agentsam-sdk-brand` | BrandPack — assets, tokens, roles, delivery |
+| **`@inneranimalmedia/theme-scenes`** | How brands compose into experiences |
+| Page content | What this page says/shows |
+| Demo adapters | Real product surfaces inside scenes |
+
+Scenes never hardcode CDN URLs, nav hrefs, or product copy. They consume `SECTION_CONTENT`, route refs, and asset roles.
+
+## Install
+
+Workspace package (private for now):
+
+```js
+import {
+  createWorkPreset,
+  compilePage,
+  createCopyBlock,
+  createActionBlock,
+  composeCardCollection,
+} from '@inneranimalmedia/theme-scenes';
+```
+
+## Hierarchy
+
+```
+PAGE_CONTENT
+  └── SECTION_CONTENT[]   → scene kind + theme + scroll + motion
+        └── SECTION_GROUP[]
+              └── CONTENT_BLOCK[]   copy | media | action | cards | demo | …
+```
+
+## Scene kinds (harvested from Work/Create HTML)
+
+| Former HTML piece | Scene / shell |
+| --- | --- |
+| Sticky glass headers | `shell.adaptive-header` |
+| Dark / light globe heroes | `hero.scroll-product` / `hero.editorial` + `visual.orbital-field` |
+| Light→dark gradient | `bridge.theme` |
+| Brand storyboard lanes | `gallery.storyboard` |
+| Icon marquee | `gallery.rail` (loop is one *behavior*) |
+| Service bento | `capability.grid` |
+| MeauxIDE mock | `product.demo` + `agentsam-mini-composer` |
+| MeauxSQL card | `product.demo` + `database-editor` |
+| Staggered tools | `product.stack` |
+| Chess / 3D stage | `interactive.stage` |
+| Footers | `shell.site-footer` |
+
+See `SCENE_ORIGIN` in `src/scenes/index.js`.
+
+## Laws
+
+1. No raw colors in scene contracts — use theme tokens / CSS vars.
+2. No hardcoded internal URLs — use `{ type: 'route', ref: '…' }`.
+3. No direct CDN URLs — use `{ assetRole: '…' }` + BrandPack resolver.
+4. No product copy inside generic scenes — inject via groups/blocks.
+5. No required card counts — empty collections disappear; adaptive layout.
+6. Major media slots support image / video / model / demo.
+7. Animated scenes declare reduced-motion behavior.
+8. Scenes declare theme intent (`surface`, `headerTone`, …).
+9. Product marketing uses real DemoAdapters, not fake UIs.
+10. Motion must communicate something (story/scrub), not decorate forever.
+
+## Quick example
+
+```js
+import {
+  createWorkPreset,
+  createCopyBlock,
+  createActionBlock,
+  createDemoBlock,
+  composeCardCollection,
+  compilePage,
+} from '@inneranimalmedia/theme-scenes';
+
+const page = createWorkPreset({
+  theme: 'inneranimal',
+  heroGroups: [{
+    blocks: [
+      createCopyBlock({
+        variant: 'display',
+        eyebrow: 'Selected Work',
+        title: 'Interface clarity.\nSystem discipline.',
+        body: 'Digital products with refined UI and production-grade foundations.',
+      }),
+      createActionBlock({
+        label: 'View the system',
+        target: { type: 'route', ref: 'product.agentsam' },
+      }),
+    ],
+  }],
+  agentsamGroups: [{
+    blocks: [
+      createCopyBlock({ title: 'AgentSam', body: 'Unified workspace shell.' }),
+      createDemoBlock('agentsam-mini-composer'),
+    ],
+  }],
+  productGroups: [{
+    blocks: [
+      composeCardCollection([
+        { title: 'Database', body: '…', target: { type: 'route', ref: 'product.database' } },
+        { title: 'Cloud', body: '…', target: { type: 'route', ref: 'product.cloud' } },
+      ]),
+    ],
+  }],
+});
+
+const plan = compilePage(page);
+// plan.sections[].demoHost, plan.cssVars, plan.validation
+```
+
+## Presets
+
+- `agency-home` — institutional flagship narrative  
+- `work` — Work page (dark or canvas hero via `heroTone`)  
+- `product` — single product landing  
+- `services` — capability grid  
+- `brand-story` — Create/guideline storyboard  
+
+```js
+import { createPreset, listPresets } from '@inneranimalmedia/theme-scenes';
+```
+
+## Themes
+
+`foundation` → `inneranimal` → `agentsam` / `autodidact`
+
+Semantic tokens only (`color.surface.canvas`, `type.display.xl`, …). `themeToCssVars()` emits `--scene-*` for hosts.
+
+## Scroll presets
+
+| Mode | Typical | Purpose |
+| --- | --- | --- |
+| `natural` | content height | ordinary |
+| `viewport` | ~100vh | focused statement |
+| `linger` | 120–160vh | visual + copy |
+| `sticky-story` | 180–260vh | narrative scrub |
+| `cinematic` | 240–320vh | flagship product |
+| `bridge` | 40–80vh | world transition |
+
+Hosts receive normalized `progress` 0→1 (`computeScrollProgress` / `stageAtProgress`).
+
+## Demo adapters
+
+| Adapter | Product surface |
+| --- | --- |
+| `agentsam-mini-composer` | AgentSam / MiniComposer |
+| `database-editor` | MeauxSQL-class DB editor |
+| `cad-viewer` | GLB turntable |
+| `generic-iframe` | last-resort embed |
+
+## Studio (next)
+
+Reusable `studio-shell` (navigator / canvas / inspector) sits *above* this package. Moon Glass mock → Brand Studio panels over BrandPack + theme-scenes — not another one-off HTML page. See AgentSam BrandPack README for the compiler side.
+
+## Tests
+
+```bash
+npm --prefix packages/theme-scenes test
+```

package/packages/theme-scenes/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@inneranimalmedia/theme-scenes",
+  "version": "0.1.0",
+  "description": "Reusable scene / shell / block vocabulary for branded website experiences. BrandPack owns look; theme-scenes owns composition.",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22 <25"
+  },
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./contracts": "./src/contracts/index.js",
+    "./scenes": "./src/scenes/index.js",
+    "./shell": "./src/shell/index.js",
+    "./blocks": "./src/blocks/index.js",
+    "./visuals": "./src/visuals/index.js",
+    "./demos": "./src/demos/index.js",
+    "./themes": "./src/themes/index.js",
+    "./presets": "./src/presets/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/SamPrimeaux/agentsam-sdk.git",
+    "directory": "packages/theme-scenes"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "keywords": [
+    "agentsam",
+    "theme",
+    "scenes",
+    "sections",
+    "brand",
+    "cms"
+  ],
+  "agentsam": {
+    "kind": "theme-runtime",
+    "slug": "theme-scenes",
+    "depends_on": [
+      "@inneranimalmedia/agentsam-sdk-brand"
+    ]
+  }
+}

package/packages/theme-scenes/src/blocks/index.js

@@ -0,0 +1,30 @@
+/**
+ * Block helpers — scenes compose these; they never own brand URLs.
+ */
+
+export {
+  createCopyBlock,
+  createMediaBlock,
+  createActionBlock,
+  createCardsBlock,
+  createDemoBlock,
+  composeCardCollection,
+  BLOCK_KINDS,
+} from '../contracts/index.js';
+
+/** Resolve whether a block should render (empty collections disappear). */
+export function shouldRenderBlock(block) {
+  if (!block?.kind) return false;
+  if (block.kind === 'cards') return Array.isArray(block.items) && block.items.length > 0;
+  if (block.kind === 'copy') {
+    return Boolean(block.title || block.body || block.eyebrow || (block.bullets && block.bullets.length));
+  }
+  if (block.kind === 'action') return Boolean(block.label);
+  if (block.kind === 'demo') return Boolean(block.adapter);
+  if (block.kind === 'media') return Boolean(block.media?.assetRole || block.media?.ref);
+  return true;
+}
+
+export function filterRenderableBlocks(blocks = []) {
+  return blocks.filter(shouldRenderBlock);
+}