@inneranimalmedia/agentsam-sdk 2.6.3 → 2.6.5

package/protocol/ui/icon.v1.schema.json

@@ -0,0 +1,51 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "agentsam.icon.v1",
+  "title": "AgentSamSemanticIconKey",
+  "description": "Stable semantic icon key used by AgentSam registries and manifests. Persist semantic meaning only; renderer-specific icon library identifiers, emoji, SVG paths, and asset URLs are not valid values. Vocabulary is additive-only: never rename a shipped key; alias on ingest if needed.",
+  "type": "string",
+  "enum": [
+    "generic",
+    "agent",
+    "app",
+    "project",
+    "package",
+    "plugin",
+    "inspect",
+    "search",
+    "code",
+    "terminal",
+    "browser",
+    "workflow",
+    "database",
+    "storage",
+    "vector",
+    "data",
+    "repository",
+    "file",
+    "folder",
+    "document",
+    "artifact",
+    "image",
+    "memory",
+    "model",
+    "provider",
+    "tool",
+    "skill",
+    "integration",
+    "connection",
+    "api",
+    "identity",
+    "key",
+    "security",
+    "network",
+    "cloud",
+    "deploy",
+    "brand",
+    "theme",
+    "settings",
+    "metrics",
+    "logs"
+  ],
+  "examples": ["database", "skill", "identity", "theme", "vector"]
+}

package/registry/cms-rust-machine-20260928/installable-products.json

@@ -0,0 +1,31 @@
+{
+  "schema": "agentsam.installable-products.v1",
+  "source": "inneranimalmedia-business.agentsam_products",
+  "refreshed_at": "2026-09-28",
+  "products": [
+    {
+      "slug": "cms",
+      "kind": "product",
+      "status": "wired",
+      "label": "CMS",
+      "hint": "Guided CMS site or full CMS Editor app",
+      "action": { "kind": "scaffold", "id": "cms" }
+    },
+    {
+      "slug": "client-cms-editor",
+      "kind": "app",
+      "status": "scaffolded",
+      "label": "AgentSam CMS Editor",
+      "hint": "Reusable full CMS editor app",
+      "action": { "kind": "app", "id": "client-cms-editor" }
+    },
+    {
+      "slug": "agentsam-rapid-rust",
+      "kind": "sdk-package",
+      "status": "prototype",
+      "label": "Rust/Wasm Worker",
+      "hint": "Scaffold the shared-core Rust/Wasm Worker template",
+      "action": { "kind": "rust-template", "template": "shared-core" }
+    }
+  ]
+}

package/registry/cms-rust-machine-20260928/manifest.json

@@ -0,0 +1,22 @@
+{
+  "schema": "agentsam.registry.migration.v1",
+  "id": "cms-rust-machine-20260928",
+  "database": "inneranimalmedia-business",
+  "database_id": "cf87b717-d4e2-4cf8-bab0-a81268e32d49",
+  "products": [
+    "cms",
+    "client-cms-editor",
+    "theme-inneranimals-site",
+    "asrust",
+    "agentsam-machine",
+    "agentsam-rapid-rust"
+  ],
+  "legacy_aliases": {
+    "iam-client-cms-editor": "client-cms-editor"
+  },
+  "policy": {
+    "npm_publish": false,
+    "cms_live_swap": false,
+    "oauth_reconnect": false
+  }
+}

package/registry/cms-rust-machine-20260928/migration.sql

@@ -0,0 +1,237 @@
+-- AgentSam CMS / Rust / machine product registry graduation.
+-- Idempotent: stable product slugs + unique relationship edges.
+-- Database: inneranimalmedia-business
+
+INSERT INTO agentsam_products (
+  slug, name, kind, status, description,
+  repository_id, canonical_path, package_name, version, tags, metadata, updated_at
+) VALUES (
+  'cms',
+  'InnerAnimalMedia CMS',
+  'product',
+  'wired',
+  'Independent CMS product identity; portable editor/runtime surfaces inherit AgentSam capabilities.',
+  'github:samprimeaux/inneranimalmedia',
+  'src/core/agentsam/cms',
+  NULL,
+  NULL,
+  '["cms","product","installable"]',
+  '{"origin":"registry.cms-rust-machine-20260928","installable":true,"app_id":"client-cms-editor","install":{"command":"agentsam app scaffold client-cms-editor","paths":["/install/cms"]},"run_targets":["local","cloudflare","tauri"],"persistence":["sqlite","d1","localStorage_cache"],"cli_commands":[],"capabilities":["cms.editor","cms.pages","cms.sections","cms.components","cms.media"]}',
+  unixepoch()
+)
+ON CONFLICT(slug) DO UPDATE SET
+  name=excluded.name,
+  kind=excluded.kind,
+  status=excluded.status,
+  description=excluded.description,
+  repository_id=COALESCE(excluded.repository_id,agentsam_products.repository_id),
+  canonical_path=excluded.canonical_path,
+  package_name=excluded.package_name,
+  version=excluded.version,
+  tags=excluded.tags,
+  metadata=excluded.metadata,
+  updated_at=excluded.updated_at;
+
+INSERT INTO agentsam_products (
+  slug, name, kind, status, description,
+  repository_id, canonical_path, package_name, version, tags, metadata, updated_at
+) VALUES (
+  'client-cms-editor',
+  'AgentSam CMS Editor',
+  'app',
+  'scaffolded',
+  'Canonical reusable CMS editor app; donor-quality remaster is in progress behind adapter boundaries.',
+  'github:samprimeaux/agentsam-sdk',
+  'apps/client-cms-editor',
+  '@inneranimalmedia/client-cms-editor',
+  '0.1.0',
+  '["cms","app","editor","installable"]',
+  '{"origin":"registry.cms-rust-machine-20260928","installable":true,"app_id":"client-cms-editor","product_id":"cms","legacy_slug":"iam-client-cms-editor","install":{"command":"agentsam app scaffold client-cms-editor","paths":["/install/cms","/install/client-cms-editor"]},"run_targets":["local","cloudflare","tauri"],"persistence":["sqlite","d1","localStorage_cache"],"cli_commands":[],"capabilities":["cms.editor","cms.pages","cms.sections","cms.components","cms.media"]}',
+  unixepoch()
+)
+ON CONFLICT(slug) DO UPDATE SET
+  name=excluded.name,
+  kind=excluded.kind,
+  status=excluded.status,
+  description=excluded.description,
+  repository_id=COALESCE(excluded.repository_id,agentsam_products.repository_id),
+  canonical_path=excluded.canonical_path,
+  package_name=excluded.package_name,
+  version=excluded.version,
+  tags=excluded.tags,
+  metadata=excluded.metadata,
+  updated_at=excluded.updated_at;
+
+INSERT INTO agentsam_products (
+  slug, name, kind, status, description,
+  repository_id, canonical_path, package_name, version, tags, metadata, updated_at
+) VALUES (
+  'theme-inneranimals-site',
+  'Inner Animals Site Theme',
+  'theme',
+  'prototype',
+  'Harvested Inner Animals storefront/theme candidate awaiting canonical reusable theme graduation.',
+  NULL,
+  NULL,
+  NULL,
+  NULL,
+  '["cms","theme","harvest","candidate"]',
+  '{"origin":"registry.cms-rust-machine-20260928","installable":false,"candidate":true,"source":"harvest","capabilities":["cms.theme"]}',
+  unixepoch()
+)
+ON CONFLICT(slug) DO UPDATE SET
+  name=excluded.name,
+  kind=excluded.kind,
+  status=excluded.status,
+  description=excluded.description,
+  repository_id=COALESCE(excluded.repository_id,agentsam_products.repository_id),
+  canonical_path=excluded.canonical_path,
+  package_name=excluded.package_name,
+  version=excluded.version,
+  tags=excluded.tags,
+  metadata=excluded.metadata,
+  updated_at=excluded.updated_at;
+
+INSERT INTO agentsam_products (
+  slug, name, kind, status, description,
+  repository_id, canonical_path, package_name, version, tags, metadata, updated_at
+) VALUES (
+  'asrust',
+  'AgentSam Rust/Wasm Edge Lab',
+  'service',
+  'wired',
+  'Live Rust/Wasm Worker capability lab at asrust.inneranimalmedia.com.',
+  NULL,
+  NULL,
+  NULL,
+  NULL,
+  '["rust","wasm","cloudflare","service"]',
+  '{"origin":"registry.cms-rust-machine-20260928","runtime":"rust-wasm","deployment":{"provider":"cloudflare","url":"https://asrust.inneranimalmedia.com","state":"live"},"run_targets":["cloudflare"],"cli_commands":[],"capabilities":["rust.wasm.worker"]}',
+  unixepoch()
+)
+ON CONFLICT(slug) DO UPDATE SET
+  name=excluded.name,
+  kind=excluded.kind,
+  status=excluded.status,
+  description=excluded.description,
+  repository_id=COALESCE(excluded.repository_id,agentsam_products.repository_id),
+  canonical_path=excluded.canonical_path,
+  package_name=excluded.package_name,
+  version=excluded.version,
+  tags=excluded.tags,
+  metadata=excluded.metadata,
+  updated_at=excluded.updated_at;
+
+INSERT INTO agentsam_products (
+  slug, name, kind, status, description,
+  repository_id, canonical_path, package_name, version, tags, metadata, updated_at
+) VALUES (
+  'agentsam-machine',
+  'AgentSam Machine',
+  'service',
+  'prototype',
+  'Deterministic native inspect/catalog engine; native core is present while top-level agentsam machine dispatch remains pending.',
+  'github:samprimeaux/agentsam-sdk',
+  'native/agentsam-machine',
+  NULL,
+  '0.1.0',
+  '["rust","native","machine","inspect"]',
+  '{"origin":"registry.cms-rust-machine-20260928","installable":false,"runtime":"native-rust","run_targets":["local","tauri"],"cli_commands":[],"capabilities":["machine.inspect"],"dispatch":"pending"}',
+  unixepoch()
+)
+ON CONFLICT(slug) DO UPDATE SET
+  name=excluded.name,
+  kind=excluded.kind,
+  status=excluded.status,
+  description=excluded.description,
+  repository_id=COALESCE(excluded.repository_id,agentsam_products.repository_id),
+  canonical_path=excluded.canonical_path,
+  package_name=excluded.package_name,
+  version=excluded.version,
+  tags=excluded.tags,
+  metadata=excluded.metadata,
+  updated_at=excluded.updated_at;
+
+INSERT INTO agentsam_products (
+  slug, name, kind, status, description,
+  repository_id, canonical_path, package_name, version, tags, metadata, updated_at
+) VALUES (
+  'agentsam-rapid-rust',
+  'AgentSam Rapid Rust',
+  'sdk-package',
+  'prototype',
+  'Rust/Wasm Worker scaffolding and local proof tooling shipped inside the AgentSam SDK.',
+  'github:samprimeaux/agentsam-sdk',
+  'packages/agentsam-rapid-rust',
+  '@inneranimalmedia/agentsam-sdk',
+  '0.1.0',
+  '["rust","wasm","sdk","cli","installable"]',
+  '{"origin":"registry.cms-rust-machine-20260928","installable":true,"bundled_in":"@inneranimalmedia/agentsam-sdk","run_targets":["local","cloudflare"],"persistence":[],"cli_commands":["agentsam rust","agentsam wasm"],"capabilities":["rust.scaffold","rust.check","rust.build","rust.dev","rust.deploy"]}',
+  unixepoch()
+)
+ON CONFLICT(slug) DO UPDATE SET
+  name=excluded.name,
+  kind=excluded.kind,
+  status=excluded.status,
+  description=excluded.description,
+  repository_id=COALESCE(excluded.repository_id,agentsam_products.repository_id),
+  canonical_path=excluded.canonical_path,
+  package_name=excluded.package_name,
+  version=excluded.version,
+  tags=excluded.tags,
+  metadata=excluded.metadata,
+  updated_at=excluded.updated_at;
+
+-- CMS product is packaged as the canonical editor app.
+INSERT INTO asset_relationships (
+  source_type, source_id, target_type, target_id, relationship_type, metadata
+)
+SELECT 'agentsam_product', cms.id, 'agentsam_product', editor.id, 'packaged_as',
+       '{"origin":"registry.cms-rust-machine-20260928","role":"editor_app"}'
+FROM agentsam_products cms, agentsam_products editor
+WHERE cms.slug='cms' AND editor.slug='client-cms-editor'
+ON CONFLICT(source_type,source_id,target_type,target_id,relationship_type)
+DO UPDATE SET metadata=excluded.metadata;
+
+-- Preserve the existing legacy product identity as an alias, not a second canonical editor.
+INSERT INTO asset_relationships (
+  source_type, source_id, target_type, target_id, relationship_type, metadata
+)
+SELECT 'agentsam_product', legacy.id, 'agentsam_product', editor.id, 'aliased_as',
+       '{"origin":"registry.cms-rust-machine-20260928","legacy_slug":"iam-client-cms-editor"}'
+FROM agentsam_products legacy, agentsam_products editor
+WHERE legacy.slug='iam-client-cms-editor' AND editor.slug='client-cms-editor'
+ON CONFLICT(source_type,source_id,target_type,target_id,relationship_type)
+DO UPDATE SET metadata=excluded.metadata;
+
+-- Harvested theme candidate belongs to the CMS product family.
+INSERT INTO asset_relationships (
+  source_type, source_id, target_type, target_id, relationship_type, metadata
+)
+SELECT 'agentsam_product', theme.id, 'agentsam_product', cms.id, 'depends_on',
+       '{"origin":"registry.cms-rust-machine-20260928","role":"cms_theme"}'
+FROM agentsam_products theme, agentsam_products cms
+WHERE theme.slug='theme-inneranimals-site' AND cms.slug='cms'
+ON CONFLICT(source_type,source_id,target_type,target_id,relationship_type)
+DO UPDATE SET metadata=excluded.metadata;
+
+-- Rapid Rust exposes the commands that are already mainline and tested.
+INSERT INTO asset_relationships (
+  source_type, source_id, target_type, target_id, relationship_type, metadata
+)
+SELECT 'agentsam_product', p.id, 'cli_command', 'agentsam:rust', 'exposes_command',
+       '{"origin":"registry.cms-rust-machine-20260928","command":"agentsam rust"}'
+FROM agentsam_products p
+WHERE p.slug='agentsam-rapid-rust'
+ON CONFLICT(source_type,source_id,target_type,target_id,relationship_type)
+DO UPDATE SET metadata=excluded.metadata;
+
+INSERT INTO asset_relationships (
+  source_type, source_id, target_type, target_id, relationship_type, metadata
+)
+SELECT 'agentsam_product', p.id, 'cli_command', 'agentsam:wasm', 'exposes_command',
+       '{"origin":"registry.cms-rust-machine-20260928","command":"agentsam wasm"}'
+FROM agentsam_products p
+WHERE p.slug='agentsam-rapid-rust'
+ON CONFLICT(source_type,source_id,target_type,target_id,relationship_type)
+DO UPDATE SET metadata=excluded.metadata;

package/registry/cms-rust-machine-20260928/receipt.json

@@ -0,0 +1,21 @@
+{
+  "schema": "agentsam.registry.receipt.v1",
+  "database": "inneranimalmedia-business",
+  "applied_at": "2026-09-28",
+  "validated": true,
+  "products": {
+    "cms": "wired",
+    "client-cms-editor": "scaffolded",
+    "theme-inneranimals-site": "prototype",
+    "asrust": "wired",
+    "agentsam-machine": "prototype",
+    "agentsam-rapid-rust": "prototype"
+  },
+  "relationships": [
+    ["cms", "packaged_as", "client-cms-editor"],
+    ["iam-client-cms-editor", "aliased_as", "client-cms-editor"],
+    ["theme-inneranimals-site", "depends_on", "cms"],
+    ["agentsam-rapid-rust", "exposes_command", "agentsam:rust"],
+    ["agentsam-rapid-rust", "exposes_command", "agentsam:wasm"]
+  ]
+}

package/registry/cms-rust-machine-20260928/receipt.sql

@@ -0,0 +1,27 @@
+SELECT slug,kind,status,canonical_path,package_name,
+       json_extract(metadata,'$.app_id') AS app_id,
+       json_extract(metadata,'$.legacy_slug') AS legacy_slug,
+       json_extract(metadata,'$.dispatch') AS dispatch
+FROM agentsam_products
+WHERE slug IN (
+  'cms',
+  'client-cms-editor',
+  'theme-inneranimals-site',
+  'asrust',
+  'agentsam-machine',
+  'agentsam-rapid-rust'
+)
+ORDER BY slug;
+
+SELECT p.slug AS source_slug,
+       ar.relationship_type,
+       CASE WHEN ar.target_type='agentsam_product' THEN tp.slug ELSE ar.target_id END AS target,
+       ar.target_type
+FROM asset_relationships ar
+JOIN agentsam_products p
+  ON ar.source_type='agentsam_product' AND ar.source_id=p.id
+LEFT JOIN agentsam_products tp
+  ON ar.target_type='agentsam_product' AND ar.target_id=tp.id
+WHERE p.slug IN ('cms','iam-client-cms-editor','theme-inneranimals-site','agentsam-rapid-rust')
+  AND ar.relationship_type IN ('packaged_as','aliased_as','depends_on','exposes_command')
+ORDER BY source_slug, ar.relationship_type, target;

package/scripts/build_rapid_rust_cli.py

@@ -0,0 +1,83 @@
+#!/usr/bin/env python3
+"""Build/install/smoke-test AgentSam Rapid Rust native CLI.
+
+Nothing here deploys a Worker. --bootstrap only installs local Rust/Wasm build
+prerequisites. --smoke scaffolds disposable projects and cargo-checks them.
+"""
+from __future__ import annotations
+import argparse, json, os, shutil, subprocess, sys, tempfile
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parents[1]
+MANIFEST = ROOT / "packages" / "agentsam-rapid-rust" / "Cargo.toml"
+BINARY = ROOT / "packages" / "agentsam-rapid-rust" / "target" / "release" / "agentsam-rapid-rust"
+WORKER_BUILD_VERSION = "0.8.7"
+TEMPLATES = ("api", "shared-core", "crypto-auth", "data-processor")
+
+def run(cmd, *, cwd=ROOT, check=True):
+    print("→", " ".join(map(str, cmd)))
+    return subprocess.run(list(map(str, cmd)), cwd=cwd, check=check)
+
+def have(cmd):
+    return shutil.which(cmd) is not None
+
+def bootstrap():
+    if not have("rustup") or not have("cargo"):
+        raise RuntimeError("Rust/rustup/cargo are required")
+    installed = subprocess.check_output(["rustup", "target", "list", "--installed"], text=True)
+    if "wasm32-unknown-unknown" not in installed.splitlines():
+        run(["rustup", "target", "add", "wasm32-unknown-unknown"])
+    if not have("worker-build"):
+        run(["cargo", "install", "worker-build", "--version", WORKER_BUILD_VERSION, "--locked"])
+
+def build():
+    run(["cargo", "fmt", "--manifest-path", MANIFEST, "--", "--check"])
+    run(["cargo", "test", "--manifest-path", MANIFEST])
+    run(["cargo", "build", "--release", "--manifest-path", MANIFEST])
+
+def install(dest: Path):
+    if not BINARY.exists():
+        build()
+    dest.mkdir(parents=True, exist_ok=True)
+    target = dest / "agentsam-rapid-rust-native"
+    tmp = dest / ".agentsam-rapid-rust-native.tmp"
+    shutil.copy2(BINARY, tmp)
+    tmp.chmod(0o755)
+    os.replace(tmp, target)
+    print("installed:", target)
+    return target
+
+def smoke(binary: Path):
+    bootstrap()
+    with tempfile.TemporaryDirectory(prefix="agentsam-rapid-rust-") as td:
+        root = Path(td)
+        for template in TEMPLATES:
+            name = "fixture-" + template
+            run([binary, "new", name, "--template", template, "--out", root])
+            project = root / name
+            run([binary, "check", "--cwd", project])
+
+def main():
+    ap=argparse.ArgumentParser(description=__doc__)
+    ap.add_argument("--bootstrap", action="store_true")
+    ap.add_argument("--build", action="store_true")
+    ap.add_argument("--install", action="store_true")
+    ap.add_argument("--install-dir", type=Path, default=Path.home()/".agentsam"/"bin")
+    ap.add_argument("--smoke", action="store_true")
+    ap.add_argument("--json", action="store_true")
+    args=ap.parse_args()
+    if not any((args.bootstrap,args.build,args.install,args.smoke)):
+        args.build=True
+    if args.bootstrap: bootstrap()
+    if args.build or args.install or args.smoke: build()
+    installed=None
+    if args.install: installed=install(args.install_dir.expanduser())
+    if args.smoke: smoke(installed or BINARY)
+    result={"ok":True,"binary":str(BINARY),"installed":str(installed) if installed else None,"smoke":args.smoke}
+    if args.json: print(json.dumps(result,indent=2))
+    return 0
+
+if __name__ == '__main__':
+    try: raise SystemExit(main())
+    except (RuntimeError, subprocess.CalledProcessError) as exc:
+        print("ERROR:", exc, file=sys.stderr); raise SystemExit(2)

package/skills/README.md

@@ -4,18 +4,31 @@ Portable, on-demand AgentSam behavior modules. Skills keep specialized guidance
 out of the permanent system prompt and load deeper `references/` only when the
 current task calls for them.
 
-## Canonical skills
+## Canonical portable skills (`skills/catalog.json`)
 
-- `agentsam-jr-dev/` — explain, inspect, build, and revise real software using
-  beginner-friendly language grounded in the actual repository and runtime.
+| id | Status | Use when |
+|----|--------|----------|
+| `agentsam-jr-dev` | **current** | Teach/inspect/build with beginner-friendly, evidence-grounded language |
+| `agentsam-app-fundamentals` | **current** | Contracts, credentials, graphs, AST, Merkle — application laws |
+| `agentsam-progression-guard` | **current** | Local → CI → deploy → postdeploy gates; no silent regress |
+| `agentsam-cloudflare-workers` | **current** | Wrangler-native ops, observability, CPU profiling |
+| `agentsam-codebaseindex` | **current** | Guided ingest / `codebaseindex.ingest` / Vectorize+pgvector+local lanes |
 
-- `agentsam-app-fundamentals/` — quick application-building laws for trust,
-  contracts, credentials, dependency graphs, AST evidence, and Merkle evidence.
-- `agentsam-progression-guard/` — checkpoint/hook discipline for local work, CI,
-  deploy, postdeploy verification, promotion, runtime observation, and rollback.
+List or open them with `agentsam skills`; aliases such as `quick-bytes`, `no-regress`,
+`ingest` are intentionally short enough for terminal use.
 
-List or open them with `agentsam skills`; aliases such as `quick-bytes` and
-`no-regress` are intentionally short enough for terminal use.
+## Not portable (host / app scoped)
+
+`apps/local-studio/.grok/skills/*` (game/UI/sprite/xAI packs) are **Local Studio
+Grok host skills**. They do not belong in the SDK portable catalog and must not
+be confused with D1 `agentsam_skill` rows or `agentsam_tools`.
+
+## D1 registries (normalize for new users)
+
+| Table | Owns | New-user requirement |
+|-------|------|----------------------|
+| `agentsam_skill` (+ revision/invocation) | Dashboard Skills CRUD / slash triggers | Ship schema + seed portable skill metadata that mirrors `skills/catalog.json` |
+| `agentsam_tools` (+ capabilities/call log) | Callable tools: AST retrieve, merkle, D1, Vectorize, … | Ship schema migrations under `migrations/d1/` + optional seed of filesystem/code AST tools so scaffolds match IAM host |
 
 Apps may contain host-specific skill directories of their own. Those do not
 replace the portable SDK skills in this directory.