@inneranimalmedia/agentsam-sdk 2.6.4 → 2.6.7

package/apps/client-cms-editor/shared/cms/src/starter-pack.ts

@@ -0,0 +1,158 @@
+import type { CmsEditorAdapter } from './adapter';
+import type { CmsEditorZone } from './editor-types';
+
+/**
+ * Built-in or harvested starter content. Not ephemeral, not demo-mode.
+ * Preview vs install are separate operations — the pack itself is durable product content.
+ */
+export type CmsStarterPackProvenance = {
+  kind: 'builtin_starter' | 'harvested' | 'imported';
+  packId: string;
+  packVersion: number;
+};
+
+export type CmsStarterBlockSeed = {
+  type: string;
+  data?: Record<string, unknown>;
+};
+
+export type CmsStarterSectionSeed = {
+  name: string;
+  type: string;
+  zone?: CmsEditorZone;
+  fields?: Record<string, unknown>;
+  blocks?: CmsStarterBlockSeed[];
+};
+
+export type CmsStarterPageSeed = {
+  title: string;
+  slug: string;
+  type?: string;
+  metaTitle?: string;
+  metaDescription?: string;
+  sections: CmsStarterSectionSeed[];
+};
+
+export type CmsStarterSiteSeed = {
+  name?: string;
+  domain?: string;
+  initials?: string;
+  color?: string;
+};
+
+export type CmsStarterPack = {
+  id: string;
+  name: string;
+  version: number;
+  description?: string;
+  provenance: CmsStarterPackProvenance;
+  /** Initial site shell when installing into an empty adapter (no public domain invented). */
+  site?: CmsStarterSiteSeed;
+  theme: {
+    cssVars: Record<string, string>;
+  };
+  schemas: {
+    protocol_version: number;
+    sections: unknown[];
+    blocks: unknown[];
+    fields?: unknown[];
+  };
+  templates?: Array<{
+    id: string;
+    name: string;
+    type: string;
+    category?: string;
+  }>;
+  pages: CmsStarterPageSeed[];
+};
+
+export type InstallStarterPackResult = {
+  siteId: string;
+  pageIds: string[];
+  packId: string;
+  packVersion: number;
+};
+
+/**
+ * Install a starter pack into a real CmsEditorAdapter (durable path).
+ * Uses adapter CRUD + saveDraft — never fabricates success outside the adapter.
+ */
+function siteInitials(name: string) {
+  return (
+    name
+      .split(/\s+/)
+      .filter(Boolean)
+      .slice(0, 2)
+      .map((part) => part[0])
+      .join('')
+      .toUpperCase() || 'CMS'
+  );
+}
+
+export async function installStarterPack(
+  adapter: CmsEditorAdapter,
+  pack: CmsStarterPack,
+  options?: { siteId?: string },
+): Promise<InstallStarterPackResult> {
+  const siteId = String(options?.siteId || pack.id).trim();
+  if (!siteId) throw new Error('starter_pack_site_id_required');
+
+  const sites = await adapter.listSites();
+  const siteExists = sites.some((site) => site.id === siteId);
+  if (!siteExists) {
+    const siteName = pack.site?.name?.trim() || pack.name;
+    await adapter.createSite({
+      id: siteId,
+      name: siteName,
+      domain: pack.site?.domain ?? '',
+      initials: pack.site?.initials ?? siteInitials(siteName),
+      color: pack.site?.color ?? pack.theme.cssVars['--brand-primary'] ?? '#1e6a6f',
+      theme: pack.theme,
+      schemas: pack.schemas,
+    });
+  } else {
+    await adapter.updateSite(siteId, {
+      theme: pack.theme,
+      schemas: pack.schemas,
+      name: pack.site?.name?.trim() || undefined,
+    });
+  }
+
+  const pageIds: string[] = [];
+  for (const pageSeed of pack.pages) {
+    const page = await adapter.createPage(siteId, {
+      title: pageSeed.title,
+      slug: pageSeed.slug,
+      type: pageSeed.type || 'Interior',
+      metaTitle: pageSeed.metaTitle || pageSeed.title,
+      metaDescription: pageSeed.metaDescription || '',
+    });
+    pageIds.push(page.id);
+
+    for (const sectionSeed of pageSeed.sections) {
+      const section = await adapter.createSection(page.id, {
+        name: sectionSeed.name,
+        type: sectionSeed.type,
+        zone: sectionSeed.zone || 'BODY',
+        fields: { ...(sectionSeed.fields || {}) },
+        blocks: [],
+      });
+      for (const blockSeed of sectionSeed.blocks || []) {
+        await adapter.createBlock(section.id, {
+          type: blockSeed.type,
+          data: { ...(blockSeed.data || {}) },
+        });
+      }
+    }
+
+    const hydrated = await adapter.getPage(page.id);
+    await adapter.saveDraft(page.id, { sections: hydrated.sections, theme: pack.theme, schemas: pack.schemas });
+  }
+
+  return {
+    siteId,
+    pageIds,
+    packId: pack.provenance.packId,
+    packVersion: pack.provenance.packVersion,
+  };
+}

package/apps/client-cms-editor/shared/cms/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "isolatedModules": true,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["src"]
+}

package/bin/agentsam-rapid-rust

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawnSync } from 'node:child_process';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const root = path.resolve(here, '..');
+const args = process.argv.slice(2);
+const candidates = [
+  process.env.AGENTSAM_RAPID_RUST_BIN,
+  path.join(os.homedir(), '.agentsam', 'bin', 'agentsam-rapid-rust-native'),
+  path.join(root, 'packages', 'agentsam-rapid-rust', 'target', 'release', 'agentsam-rapid-rust'),
+].filter(Boolean);
+
+for (const candidate of candidates) {
+  if (fs.existsSync(candidate)) {
+    const result = spawnSync(candidate, args, { stdio: 'inherit' });
+    process.exit(result.status ?? 1);
+  }
+}
+
+const manifest = path.join(root, 'packages', 'agentsam-rapid-rust', 'Cargo.toml');
+if (!fs.existsSync(manifest)) {
+  console.error('AgentSam Rapid Rust source is missing from this installation.');
+  process.exit(2);
+}
+const cargo = spawnSync('cargo', ['--version'], { stdio: 'ignore' });
+if (cargo.status !== 0) {
+  console.error('Rust/Cargo is required. Install Rust, then run: agentsam rust doctor');
+  process.exit(2);
+}
+console.error('AgentSam Rapid Rust native binary is not installed; compiling local CLI source…');
+const result = spawnSync('cargo', ['run', '--quiet', '--manifest-path', manifest, '--', ...args], { stdio: 'inherit' });
+process.exit(result.status ?? 1);

package/contracts/source-types.v1.json

@@ -0,0 +1,353 @@
+{
+  "schema": "agentsam.source-types.v1",
+  "types": [
+    {
+      "id": "javascript",
+      "label": "JavaScript",
+      "kind": "code",
+      "extensions": [
+        ".js",
+        ".mjs",
+        ".cjs",
+        ".jsx"
+      ],
+      "knowledge": true,
+      "ast": true,
+      "syntax_by_extension": {
+        ".jsx": "jsx"
+      }
+    },
+    {
+      "id": "typescript",
+      "label": "TypeScript",
+      "kind": "code",
+      "extensions": [
+        ".ts",
+        ".tsx",
+        ".mts",
+        ".cts"
+      ],
+      "knowledge": true,
+      "ast": true,
+      "syntax_by_extension": {
+        ".tsx": "tsx"
+      }
+    },
+    {
+      "id": "rust",
+      "label": "Rust",
+      "kind": "code",
+      "extensions": [
+        ".rs"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "python",
+      "label": "Python",
+      "kind": "code",
+      "extensions": [
+        ".py"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "go",
+      "label": "Go",
+      "kind": "code",
+      "extensions": [
+        ".go"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "java",
+      "label": "Java",
+      "kind": "code",
+      "extensions": [
+        ".java"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "shell",
+      "label": "Shell",
+      "kind": "code",
+      "extensions": [
+        ".sh",
+        ".bash",
+        ".zsh"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "yaml",
+      "label": "YAML",
+      "kind": "code",
+      "extensions": [
+        ".yaml",
+        ".yml"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "toml",
+      "label": "TOML",
+      "kind": "code",
+      "extensions": [
+        ".toml"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "vue",
+      "label": "Vue",
+      "kind": "code",
+      "extensions": [
+        ".vue"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "svelte",
+      "label": "Svelte",
+      "kind": "code",
+      "extensions": [
+        ".svelte"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "markdown",
+      "label": "Markdown",
+      "kind": "document",
+      "extensions": [
+        ".md",
+        ".mdx"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "json",
+      "label": "JSON",
+      "kind": "document",
+      "extensions": [
+        ".json"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "jsonc",
+      "label": "JSONC",
+      "kind": "document",
+      "extensions": [
+        ".jsonc"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "html",
+      "label": "HTML",
+      "kind": "document",
+      "extensions": [
+        ".html",
+        ".htm"
+      ],
+      "knowledge": true,
+      "ast": false,
+      "frontend": true
+    },
+    {
+      "id": "css",
+      "label": "CSS",
+      "kind": "document",
+      "extensions": [
+        ".css",
+        ".scss",
+        ".sass"
+      ],
+      "knowledge": true,
+      "ast": false,
+      "frontend": true
+    },
+    {
+      "id": "svg",
+      "label": "SVG",
+      "kind": "asset",
+      "extensions": [
+        ".svg"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "png",
+      "label": "PNG",
+      "kind": "asset",
+      "extensions": [
+        ".png"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "jpeg",
+      "label": "JPEG",
+      "kind": "asset",
+      "extensions": [
+        ".jpg",
+        ".jpeg"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "webp",
+      "label": "WebP",
+      "kind": "asset",
+      "extensions": [
+        ".webp"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "gif",
+      "label": "GIF",
+      "kind": "asset",
+      "extensions": [
+        ".gif"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "text",
+      "label": "Text",
+      "kind": "document",
+      "extensions": [
+        ".txt"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "xml",
+      "label": "XML",
+      "kind": "document",
+      "extensions": [
+        ".xml"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "csv",
+      "label": "CSV",
+      "kind": "document",
+      "extensions": [
+        ".csv"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "sql",
+      "label": "SQL",
+      "kind": "code",
+      "extensions": [
+        ".sql"
+      ],
+      "knowledge": true,
+      "ast": false
+    },
+    {
+      "id": "wasm",
+      "label": "WebAssembly",
+      "kind": "binary",
+      "extensions": [
+        ".wasm"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "liquid",
+      "label": "Liquid",
+      "kind": "document",
+      "extensions": [
+        ".liquid"
+      ],
+      "knowledge": true,
+      "ast": false,
+      "frontend": true
+    },
+    {
+      "id": "woff",
+      "label": "WOFF Font",
+      "kind": "asset",
+      "extensions": [
+        ".woff",
+        ".woff2"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "ttf",
+      "label": "TrueType Font",
+      "kind": "asset",
+      "extensions": [
+        ".ttf",
+        ".otf"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "mp4",
+      "label": "MP4 Video",
+      "kind": "asset",
+      "extensions": [
+        ".mp4",
+        ".webm",
+        ".mov"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "ico",
+      "label": "Icon",
+      "kind": "asset",
+      "extensions": [
+        ".ico"
+      ],
+      "knowledge": false,
+      "ast": false
+    },
+    {
+      "id": "glb",
+      "label": "glTF Binary",
+      "kind": "asset",
+      "extensions": [
+        ".glb",
+        ".gltf"
+      ],
+      "knowledge": false,
+      "ast": false
+    }
+  ]
+}

package/docs/AUTH_IDENTITY_CONTRACT.md

@@ -2,6 +2,8 @@
 
 The `agentsam-sdk` package owns the portable public configuration contract. Consuming applications implement storage, authorization, and host routes against this contract instead of defining competing environment names.
 
+Full env naming / alias / storage law: [`docs/contracts/environment-vocabulary.md`](./contracts/environment-vocabulary.md).
+
 ## Canonical variables
 
 | Variable | Meaning |

package/docs/CMS_CONTEXTUAL_COMPOSER.md

@@ -9,7 +9,7 @@ These FNF packages are **examples of the ideal state**, not permanent homes. Eac
 | Proving ground (FNF) | SDK target | Role |
 |---|---|---|
 | `packages/agentsam-workbench` | `@inneranimalmedia/agentsam-workbench` | miniAgentSam + contextual composer |
-| `packages/heuristic-theme` | `@inneranimalmedia/heuristic-theme` | **Stock CMS theme preset** |
+| `packages/heuristic-theme` | `@inneranimalmedia/theme-heuristic` | **Stock CMS theme preset** |
 | `packages/commerce-analytics` | `@inneranimalmedia/commerce-analytics` | Commerce analytics surfaces |
 
 `agentsam create … --preset cms` should land on **heuristic-theme** as the basic stock theme.

package/docs/MACHINE_INTELLIGENCE.md

@@ -0,0 +1,120 @@
+# Machine Intelligence — AgentSam ladder
+
+**Status:** Scaffold for Batches A–D (2026-09-24 plans).  
+**Authority:** `AGENTSAM.md` · work orders in `docs/plans/UNIVERSAL-INGEST-MACHINE-FIRST-2026-09-24.md` and `docs/plans/MACHINE-FIRST-APPS-TUI-2026-09-24.md`.
+
+**Intent:** Audit and strengthen worlds in place. Do not redesign the repo around package purity. Proof = real `apps/*` + harvested sites — not toy demos.
+
+---
+
+## Product scales (MINI / APP / WORLD)
+
+```text
+MINI  — tiny local artifact, instant preview, seconds
+        → agentsam mini (see docs/MINI.md)
+        → intentionally tiny utility lane — not architectural proof
+
+APP   — complete packaged product (npm install / agentsam app add), minutes
+        → Clack catalog: Preview · Info · Doctor · Scaffold/Add · Deploy
+        → maturity-gated actions
+
+WORLD — arbitrary repo/path → deterministic world-state → progressive normalize
+        → agentsam inspect [path]
+        → Merkle + snapshot + AST + brand + harvest + verify + next
+```
+
+---
+
+## Maturity ladder (calculated, observable)
+
+Imperfection is maturity state, not exclusion. Prefer calculated facts over hand labels.
+
+```text
+harvested → scaffolded → wired → verified → releasable → production
+```
+
+| Stage | Gate examples (facts, not badges) |
+|-------|-----------------------------------|
+| harvested | dir exists; optional gallery/canonical paths |
+| scaffolded | package.json / wrangler / preview root present |
+| wired | bin + commands.preview/doctor resolve |
+| verified | doctor + app contract / boundary checks pass |
+| releasable | verify receipts green; no donor junk in publish set; secrets marked |
+| production | deploy receipt / remote binding evidence |
+
+---
+
+## Decision primitives (AgentSam-owned)
+
+**Not** TypeSafe/Jev product vocabulary. Native choose / score / check live under `src/sam/decision/` (see `docs/architecture/SAM_DECISION_WORK_RECEIPT.md`).
+
+| Primitive | Role |
+|-----------|------|
+| predicate / check | yes/no with support |
+| choice | discrete option |
+| score | ordered magnitude (raw estimate unless calibrated) |
+| distribution | deferred / optional |
+
+**Confidence ≠ risk.** Confidence answers “how sure are we?” Risk answers “how bad if wrong?” Abstention and hierarchical degrade are policy, not UI chrome.
+
+Decision receipts (target shape): `{ input_hash, primitive, result, confidence, risk?, next }` — protocol under `protocol/sam/decision-receipt.v1.schema.json`.
+
+First acceptance path: ≥1 classification (e.g. maturity gate or brand route) emits a receipt **without** a model.
+
+---
+
+## World-state
+
+Converge existing slices into one inspectable envelope (extend `repository.snapshot` or add `world.state`):
+
+- files / hashes / MIME (snapshot + merkle)
+- AST / routes / APIs
+- brand packet (when present)
+- app manifest + provenance
+- verify receipts
+- maturity + next_actions
+
+`agentsam inspect` must work for arbitrary paths **and** every `apps/*`.
+
+Consumers: Brand Intelligence, apps catalog, local gallery, progression next-actions. LLM is one handler inside AgentSam — only on ambiguity.
+
+---
+
+## Explicit non-goals
+
+- Repo redesign for package purity
+- New toy/demo apps as architectural proof
+- Requiring finished status before inclusion
+- TypeSafe/Jev dependency or product vocabulary
+- Mini as showcase / poster framing
+- Auto-fetch remotes / auto-delete orphans / execute imported HTML
+- Jump every path to Level-4 LLM
+
+---
+
+## Acceptance (machine-first, without a model)
+
+1. List every `apps/*` with calculated maturity + provenance + verify status  
+2. `agentsam inspect` a harvested site and a serious app → world-state  
+3. Answer what / where / contents / capabilities / reusable / missing / verified / next from receipts  
+4. Expose decision primitives + a confidence-policy receipt on ≥1 classification path  
+5. Keep `agentsam mini` working as the tiny lane  
+6. Docs state this ladder + MINI / APP / WORLD (this file)
+
+---
+
+## Related docs
+
+| Doc | Role |
+|-----|------|
+| `docs/plans/UNIVERSAL-INGEST-MACHINE-FIRST-2026-09-24.md` | Locked work order (Batches A–D) |
+| `docs/plans/MACHINE-FIRST-APPS-TUI-2026-09-24.md` | Apps Clack catalog + batch detail |
+| `docs/plans/TOMORROW-MACHINE-FIRST-BRIEFING.md` | Review index for next session |
+| `docs/MINI.md` | Mini lane |
+| `docs/architecture/SAM_DECISION_WORK_RECEIPT.md` | Decision layer ship receipt |
+| `docs/BRAND_INTELLIGENCE.md` | Consumer of world-state |
+| `docs/REPOSITORY_INTELLIGENCE.md` | Snapshot / inspect substrate |
+| `docs/THEME_REFINERY.md` | Harvest ladder + sites |
+| `protocol/INSPECT_VIEWS_V1.md` | Inspect views |
+| `docs/plans/AGENTSAM-INTERACTIVE-UI-REQUIREMENTS.md` | **Canonical** interactive shell contract (`ctrl-c`) |
+| `docs/plans/AGENTSAM-INTERACTIVE-UI-REQUIREMENTS-codex-tui-20260919.md` | Observational Codex brief (`esc`) — not the implemented contract |