@inneranimalmedia/agentsam-sdk 2.6.10 → 2.6.11

package/examples/hyperspace-demo/src/main.tsx

@@ -1,9 +1,11 @@
 import { StrictMode, useEffect, useMemo, useState } from "react";
 import { createRoot } from "react-dom/client";
 import {
+  HYPERSPACE_STUDIES,
   LoadingSceneController,
-  computationalHyperspace,
   adaptAgentSamEvent,
+  computationalHyperspace,
+  type HyperspaceStudyId,
 } from "@inneranimalmedia/agentsam-loading-scene";
 import {
   LoadingScene,
@@ -13,141 +15,256 @@ import {
 
 const preset = computationalHyperspace;
 
-/**
- * Simulated "create a site" run: realistic runtime events flow through
- * the adapter → controller, exactly as a real CMS app would wire it.
- * The renderer never sees any of these names.
- */
-function simulateSiteCreation(controller: LoadingSceneController, onDone: () => void) {
-  const timeline: Array<[number, () => void]> = [];
-  const at = (ms: number, fn: () => void) => timeline.push([ms, fn]);
-  const ev = (raw: Parameters<typeof adaptAgentSamEvent>[0]) =>
+type StudyChoice = HyperspaceStudyId | "auto";
+
+function simulateRuntime(
+  controller: LoadingSceneController,
+  onDone: () => void,
+) {
+  const timers: number[] = [];
+  const later = (ms: number, fn: () => void) => {
+    timers.push(window.setTimeout(fn, ms));
+  };
+  const emit = (raw: Parameters<typeof adaptAgentSamEvent>[0]) =>
     controller.handle(adaptAgentSamEvent(raw));
 
-  at(0, () => ev({ type: "agent.session.started", operationId: "session", label: "Starting up" }));
-  at(900, () => controller.complete("session"));
-
-  at(1000, () => ev({ type: "context.workspace.loading", operationId: "ctx", label: "Gathering context" }));
-  // 19 rapid file reads — coalesced, no flicker
-  for (let i = 0; i < 19; i++) {
-    at(1200 + i * 60, () => ev({ type: "file.read", label: "Understanding your project" }));
-  }
-  at(2600, () => controller.complete("ctx"));
-
-  at(2700, () => ev({ type: "model.planning", operationId: "plan", label: "Planning your site" }));
-  at(5200, () => controller.complete("plan"));
-
-  // parallel tools + asset generation blending
-  at(5300, () => ev({ type: "tool.invoke", operationId: "t1", label: "Laying out pages" }));
-  at(5450, () => ev({ type: "tool.invoke", operationId: "t2", label: "Writing copy" }));
-  at(5600, () => ev({ type: "tool.image.generate", operationId: "hero", label: "Generating hero artwork" }));
-  at(9400, () => controller.complete("t1"));
-  at(10200, () => controller.complete("t2"));
-  at(12500, () => ev({ type: "content.asset.generated", operationId: "hero", label: "Hero artwork ready" }));
-
-  at(12800, () => ev({ type: "catalog.indexing", operationId: "idx", label: "Organizing your content" }));
-  at(15200, () => controller.complete("idx"));
-
-  at(15400, () => ev({ type: "site.build", operationId: "build", label: "Building your site", progress: 0 }));
-  at(16500, () => ev({ type: "site.build", operationId: "build", progress: 0.35 }));
-  at(17800, () => ev({ type: "site.build", operationId: "build", progress: 0.8 }));
-  at(18900, () => controller.complete("build"));
-
-  at(19000, () => ev({ type: "output.verify", operationId: "verify", label: "Checking everything" }));
-  at(21500, () => controller.complete("verify"));
-
-  at(21700, () => ev({ type: "site.deploy", operationId: "deploy", label: "Publishing" }));
-  at(24800, () => {
-    controller.complete("deploy");
-    onDone();
-  });
-
-  const ids = timeline.map(([ms, fn]) => window.setTimeout(fn, ms));
-  return () => ids.forEach((id) => window.clearTimeout(id));
+  later(0, () =>
+    emit({
+      type: "agent.session.started",
+      operationId: "boot",
+      label: "Preparing runtime",
+      detail: "Opening the AgentSam workspace",
+    }),
+  );
+  later(3600, () => controller.complete("boot"));
+
+  later(3900, () =>
+    emit({
+      type: "file.read",
+      operationId: "read",
+      label: "Reading project context",
+      detail: "Reviewing files and instructions relevant to the task",
+    }),
+  );
+  later(7700, () => controller.complete("read"));
+
+  later(8000, () =>
+    emit({
+      type: "context.workspace.loading",
+      operationId: "context",
+      label: "Loading context",
+      detail: "Assembling the workspace state needed for this turn",
+    }),
+  );
+  later(11900, () => controller.complete("context"));
+
+  later(12200, () =>
+    emit({
+      type: "tool.invoke",
+      operationId: "tool-a",
+      label: "Running tools",
+      detail: "Executing the first task action",
+    }),
+  );
+  later(12450, () =>
+    emit({
+      type: "tool.invoke",
+      operationId: "tool-b",
+      label: "Tracing dependencies",
+      detail: "Following related package and runtime edges",
+    }),
+  );
+  later(16300, () => controller.complete("tool-a"));
+  later(16600, () => controller.complete("tool-b"));
+
+  later(16900, () =>
+    emit({
+      type: "catalog.indexing",
+      operationId: "index",
+      label: "Reconciling state",
+      detail: "Checking the resulting workspace state",
+    }),
+  );
+  later(20700, () => controller.complete("index"));
+
+  later(21000, () =>
+    emit({
+      type: "site.build",
+      operationId: "build",
+      label: "Building application",
+      detail: "Producing the requested preview",
+      progress: 0,
+    }),
+  );
+  later(22200, () =>
+    emit({
+      type: "site.build",
+      operationId: "build",
+      progress: 0.38,
+    }),
+  );
+  later(23500, () =>
+    emit({
+      type: "site.build",
+      operationId: "build",
+      progress: 0.78,
+    }),
+  );
+  later(24900, () => controller.complete("build"));
+
+  later(26200, onDone);
+
+  return () => timers.forEach((id) => window.clearTimeout(id));
 }
 
-function EditorSurface() {
+function PreviewSurface() {
   return (
     <div
       style={{
         height: "100%",
         display: "grid",
-        gridTemplateRows: "56px 1fr",
-        color: "#d5d7e0",
-        fontFamily: "system-ui, sans-serif",
+        placeItems: "center",
+        background: "#090A0E",
+        color: "#F7F5FB",
+        fontFamily:
+          'Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif',
       }}
     >
-      <header
-        style={{
-          borderBottom: "1px solid rgba(255,255,255,0.08)",
-          display: "flex",
-          alignItems: "center",
-          padding: "0 20px",
-          gap: 16,
-          fontSize: 13,
-          letterSpacing: "0.06em",
-        }}
-      >
-        <strong style={{ color: "#8b7db7" }}>AgentSam</strong>
-        <span style={{ opacity: 0.5 }}>Fuel N Free Time — Home</span>
-        <span style={{ marginLeft: "auto", opacity: 0.4, fontSize: 12 }}>Draft saved</span>
-      </header>
-      <main style={{ padding: 32, display: "grid", gap: 20, alignContent: "start" }}>
-        <div style={{ height: 220, borderRadius: 10, background: "linear-gradient(135deg, rgba(139,125,183,0.18), rgba(104,117,173,0.1))", border: "1px solid rgba(255,255,255,0.07)", display: "flex", alignItems: "center", justifyContent: "center", fontSize: 14, opacity: 0.8 }}>
-          Hero section — generated artwork placed here
+      <div style={{ textAlign: "center", opacity: 0.9 }}>
+        <div
+          style={{
+            fontSize: 12,
+            letterSpacing: "0.12em",
+            textTransform: "uppercase",
+            color: "#B5B1C0",
+          }}
+        >
+          AgentSam
         </div>
-        <div style={{ display: "grid", gridTemplateColumns: "repeat(auto-fit, minmax(180px, 1fr))", gap: 16 }}>
-          {["Collection grid", "Countdown banner", "Newsletter"].map((s) => (
-            <div key={s} style={{ height: 110, borderRadius: 8, border: "1px solid rgba(255,255,255,0.07)", background: "rgba(255,255,255,0.02)", display: "flex", alignItems: "center", justifyContent: "center", fontSize: 13, opacity: 0.65 }}>
-              {s}
-            </div>
-          ))}
+        <div
+          style={{
+            marginTop: 10,
+            fontSize: 30,
+            letterSpacing: "-0.035em",
+            fontWeight: 600,
+          }}
+        >
+          Runtime complete
         </div>
-      </main>
+      </div>
     </div>
   );
 }
 
 function App() {
-  const controller = useMemo(() => new LoadingSceneController(preset), []);
+  const controller = useMemo(
+    () => new LoadingSceneController(preset),
+    [],
+  );
   const [run, setRun] = useState(0);
-  const debug = new URLSearchParams(window.location.search).get("debugRuntimeVisuals") === "1";
+  const params = useMemo(
+    () => new URLSearchParams(window.location.search),
+    [],
+  );
+  const debug = params.get("debugRuntimeVisuals") === "1";
+  const initialStudy = params.get("study") as StudyChoice | null;
+  const [study, setStudy] = useState<StudyChoice>(
+    initialStudy &&
+      (initialStudy === "auto" ||
+        HYPERSPACE_STUDIES.some((item) => item.id === initialStudy))
+      ? initialStudy
+      : "auto",
+  );
 
   useEffect(() => {
-    if (debug) return; // devtools drive the controller instead
-    return simulateSiteCreation(controller, () => undefined);
+    if (debug) return;
+    return simulateRuntime(controller, () => {
+      window.setTimeout(() => {
+        controller.reset();
+        setRun((value) => value + 1);
+      }, 1500);
+    });
   }, [controller, run, debug]);
 
   return (
-    <div style={{ position: "fixed", inset: 0 }}>
-      <LoadingScene controller={controller} preset={preset} style={{ width: "100%", height: "100%" }}>
-        <EditorSurface />
+    <div
+      style={{
+        position: "fixed",
+        inset: 0,
+        background: "#090A0E",
+      }}
+    >
+      <LoadingScene
+        controller={controller}
+        preset={preset}
+        study={study}
+        reducedMotion="auto"
+        style={{ width: "100%", height: "100%" }}
+      >
+        <PreviewSurface />
       </LoadingScene>
-      <div style={{ position: "fixed", left: 24, bottom: 24, pointerEvents: "none" }}>
-        <LoadingSceneStatus controller={controller} preset={preset} />
+
+      <div
+        style={{
+          position: "fixed",
+          left: 24,
+          bottom: 24,
+          pointerEvents: "none",
+          zIndex: 5,
+        }}
+      >
+        <LoadingSceneStatus
+          controller={controller}
+          preset={preset}
+        />
       </div>
-      {!debug && (
-        <button
-          onClick={() => {
-            controller.reset();
-            setRun((r) => r + 1);
-          }}
-          style={{
-            position: "fixed",
-            top: 16,
-            right: 16,
-            background: "rgba(255,255,255,0.05)",
-            border: "1px solid rgba(255,255,255,0.12)",
-            borderRadius: 6,
-            color: "#9ea1b0",
-            padding: "6px 12px",
-            fontSize: 12,
-            cursor: "pointer",
-          }}
-        >
-          Replay
-        </button>
-      )}
+
+      <div
+        style={{
+          position: "fixed",
+          top: 16,
+          right: 16,
+          zIndex: 10,
+          display: "flex",
+          gap: 6,
+          flexWrap: "wrap",
+          justifyContent: "flex-end",
+          maxWidth: "min(860px, calc(100vw - 32px))",
+          fontFamily:
+            'Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif',
+        }}
+      >
+        {(["auto", ...HYPERSPACE_STUDIES.map((item) => item.id)] as StudyChoice[]).map(
+          (item) => (
+            <button
+              key={item}
+              type="button"
+              onClick={() => setStudy(item)}
+              style={{
+                border:
+                  item === study
+                    ? "1px solid #8B5CF6"
+                    : "1px solid rgba(255,255,255,.12)",
+                background:
+                  item === study
+                    ? "rgba(139,92,246,.16)"
+                    : "rgba(9,10,14,.72)",
+                color: item === study ? "#F7F5FB" : "#B5B1C0",
+                borderRadius: 999,
+                padding: "7px 10px",
+                fontSize: 11,
+                cursor: "pointer",
+                backdropFilter: "blur(10px)",
+              }}
+            >
+              {item === "auto"
+                ? "Auto"
+                : HYPERSPACE_STUDIES.find((entry) => entry.id === item)?.title}
+            </button>
+          ),
+        )}
+      </div>
+
       <LoadingSceneDevtools controller={controller} enabled={debug} />
     </div>
   );

package/migrations/d1/0020_agentsam_receipt_catalog.sql

@@ -0,0 +1,35 @@
+-- AgentSam universal receipt catalog.
+-- Runtime payloads remain in their native schemas; this table indexes the
+-- universal agentsam.receipt.v1 envelope persisted under inneranimalmedia-schemas.
+CREATE TABLE IF NOT EXISTS agentsam_receipt_catalog (
+  id TEXT PRIMARY KEY,
+  account_id TEXT NOT NULL,
+  receipt_kind TEXT NOT NULL,
+  schema_name TEXT NOT NULL,
+  status TEXT NOT NULL,
+  retention_class TEXT NOT NULL DEFAULT 'ephemeral_success',
+
+  repository_id TEXT,
+  git_sha TEXT,
+  run_id TEXT,
+
+  r2_key TEXT NOT NULL
+    CHECK (r2_key LIKE 'agentsam/runtime/receipts/%'),
+  content_hash TEXT NOT NULL,
+  byte_size INTEGER NOT NULL CHECK (byte_size >= 0),
+
+  created_at_unix INTEGER NOT NULL,
+  expires_at_unix INTEGER,
+
+  meta_json TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_agentsam_receipts_account_kind
+  ON agentsam_receipt_catalog (account_id, receipt_kind);
+
+CREATE INDEX IF NOT EXISTS idx_agentsam_receipts_repo_sha
+  ON agentsam_receipt_catalog (repository_id, git_sha);
+
+CREATE INDEX IF NOT EXISTS idx_agentsam_receipts_expires
+  ON agentsam_receipt_catalog (expires_at_unix)
+  WHERE expires_at_unix IS NOT NULL;

package/migrations/runtime/0006_agent_run_suspend_activity.sql

@@ -0,0 +1,53 @@
+-- Durable AgentSam run suspension and append-only activity journal.
+-- Keep agentsam_agent_run.status coarse/backward-compatible; waiting detail lives here.
+
+CREATE TABLE IF NOT EXISTS agentsam_agent_run_suspension (
+  run_id TEXT PRIMARY KEY NOT NULL REFERENCES agentsam_agent_run(id) ON DELETE CASCADE,
+  state TEXT NOT NULL
+    CHECK (state IN (
+      'waiting_external','waiting_child','awaiting_input','awaiting_approval','sleeping','retry_scheduled'
+    )),
+  reason TEXT NOT NULL
+    CHECK (reason IN ('external','child_run','approval','input','retry','scheduled','rate_limit')),
+  wake_at_unix INTEGER,
+  wake_event TEXT,
+  dependency_run_ids_json TEXT NOT NULL DEFAULT '[]',
+  resume_step_id TEXT,
+  checkpoint_ref TEXT,
+  expires_at_unix INTEGER,
+  attempt INTEGER NOT NULL DEFAULT 0 CHECK (attempt >= 0),
+  metadata_json TEXT NOT NULL DEFAULT '{}',
+  created_at_unix INTEGER NOT NULL DEFAULT (unixepoch()),
+  updated_at_unix INTEGER NOT NULL DEFAULT (unixepoch())
+);
+
+CREATE INDEX IF NOT EXISTS idx_agentsam_agent_run_suspension_due
+  ON agentsam_agent_run_suspension(state, wake_at_unix);
+CREATE INDEX IF NOT EXISTS idx_agentsam_agent_run_suspension_event
+  ON agentsam_agent_run_suspension(wake_event);
+
+CREATE TABLE IF NOT EXISTS agentsam_agent_run_event (
+  event_id TEXT PRIMARY KEY NOT NULL,
+  run_id TEXT NOT NULL REFERENCES agentsam_agent_run(id) ON DELETE CASCADE,
+  parent_run_id TEXT REFERENCES agentsam_agent_run(id) ON DELETE SET NULL,
+  seq INTEGER NOT NULL CHECK (seq >= 0),
+  event_type TEXT NOT NULL,
+  phase TEXT,
+  step_id TEXT,
+  label TEXT NOT NULL DEFAULT '',
+  detail TEXT,
+  progress_current REAL,
+  progress_total REAL,
+  source_kind TEXT,
+  source_name TEXT,
+  evidence_json TEXT NOT NULL DEFAULT '{}',
+  dedupe_key TEXT,
+  created_at_unix INTEGER NOT NULL DEFAULT (unixepoch()),
+  UNIQUE(run_id, seq)
+);
+
+CREATE INDEX IF NOT EXISTS idx_agentsam_agent_run_event_run_created
+  ON agentsam_agent_run_event(run_id, created_at_unix, seq);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_agentsam_agent_run_event_dedupe
+  ON agentsam_agent_run_event(run_id, dedupe_key)
+  WHERE dedupe_key IS NOT NULL;

package/migrations/runtime/0007_queue_control.sql

@@ -0,0 +1,40 @@
+-- Portable durable Queue Control storage for local SQLite / D1-shaped hosts.
+-- Provider queues remain adapters; this is the local durable scheduler and
+-- reference persistence contract.
+
+CREATE TABLE IF NOT EXISTS agentsam_queue_job (
+  id TEXT PRIMARY KEY NOT NULL,
+  account_id TEXT NOT NULL,
+  physical_queue TEXT NOT NULL,
+  logical_queue TEXT,
+  kind TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'queued'
+    CHECK(status IN (
+      'queued','claimed','running','waiting','batch_waiting','awaiting_input',
+      'retry_scheduled','completed','failed','cancelled'
+    )),
+  priority TEXT NOT NULL DEFAULT 'normal'
+    CHECK(priority IN ('low','normal','high','urgent')),
+  available_at INTEGER NOT NULL DEFAULT (unixepoch()),
+  attempt INTEGER NOT NULL DEFAULT 0 CHECK(attempt >= 0),
+  max_attempts INTEGER NOT NULL DEFAULT 3 CHECK(max_attempts >= 1),
+  idempotency_key TEXT NOT NULL,
+  source_run_id TEXT,
+  step_id TEXT,
+  lease_owner TEXT,
+  lease_expires_at INTEGER,
+  lease_generation INTEGER NOT NULL DEFAULT 0 CHECK(lease_generation >= 0),
+  job_json TEXT NOT NULL CHECK(json_valid(job_json)),
+  result_json TEXT CHECK(result_json IS NULL OR json_valid(result_json)),
+  error_json TEXT CHECK(error_json IS NULL OR json_valid(error_json)),
+  created_at_unix INTEGER NOT NULL DEFAULT (unixepoch()),
+  updated_at_unix INTEGER NOT NULL DEFAULT (unixepoch()),
+  completed_at_unix INTEGER
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_agentsam_queue_job_idempotency
+  ON agentsam_queue_job(account_id, idempotency_key);
+CREATE INDEX IF NOT EXISTS idx_agentsam_queue_job_due
+  ON agentsam_queue_job(physical_queue, status, available_at, lease_expires_at);
+CREATE INDEX IF NOT EXISTS idx_agentsam_queue_job_run
+  ON agentsam_queue_job(source_run_id, created_at_unix DESC);

package/migrations/runtime/0008_agent_run_dependencies.sql

@@ -0,0 +1,24 @@
+-- Durable parent/child run dependency projection for AgentSam multi-agent orchestration.
+-- WorkGraph remains the planning authority; this table records the execution linkage
+-- needed to wake parents from child completion without model polling.
+
+CREATE TABLE IF NOT EXISTS agentsam_agent_run_dependency (
+  parent_run_id TEXT NOT NULL REFERENCES agentsam_agent_run(id) ON DELETE CASCADE,
+  child_run_id TEXT NOT NULL REFERENCES agentsam_agent_run(id) ON DELETE CASCADE,
+  relation TEXT NOT NULL DEFAULT 'blocks'
+    CHECK (relation IN ('blocks','requires','observes')),
+  work_item_id TEXT,
+  step_id TEXT,
+  status TEXT NOT NULL DEFAULT 'pending'
+    CHECK (status IN ('pending','satisfied','failed','cancelled')),
+  metadata_json TEXT NOT NULL DEFAULT '{}',
+  created_at_unix INTEGER NOT NULL DEFAULT (unixepoch()),
+  completed_at_unix INTEGER,
+  updated_at_unix INTEGER NOT NULL DEFAULT (unixepoch()),
+  PRIMARY KEY (parent_run_id, child_run_id, relation)
+);
+
+CREATE INDEX IF NOT EXISTS idx_agentsam_run_dependency_parent_status
+  ON agentsam_agent_run_dependency(parent_run_id, status, created_at_unix);
+CREATE INDEX IF NOT EXISTS idx_agentsam_run_dependency_child
+  ON agentsam_agent_run_dependency(child_run_id, status);

package/migrations/runtime/0008_analytics_legacy_bootstrap.sql

@@ -0,0 +1,43 @@
+-- Bootstrap compatibility for analytics authority migration 0009.
+--
+-- Production D1 already had the legacy aggregate-shaped agentsam_analytics
+-- table before 0009 was introduced. A fresh portable/local SQLite database did
+-- not, so 0009 could not run its row-count guard or rename step.
+--
+-- This migration intentionally sorts before 0009 and creates the old empty
+-- aggregate shape only when no agentsam_analytics table exists. On production
+-- or any database that already has either the legacy or canonical table, this
+-- is a no-op. 0009 remains immutable after release.
+
+CREATE TABLE IF NOT EXISTS agentsam_analytics (
+  id               TEXT NOT NULL PRIMARY KEY,
+  account_id       TEXT NOT NULL,
+  date_key         TEXT NOT NULL DEFAULT '',
+  event_type       TEXT NOT NULL DEFAULT '',
+  event_name       TEXT NOT NULL DEFAULT '',
+  workflow_key     TEXT NOT NULL DEFAULT '',
+  task_type        TEXT NOT NULL DEFAULT '',
+  model_id         TEXT NOT NULL DEFAULT '',
+
+  total_calls      INTEGER NOT NULL DEFAULT 0,
+  success_calls    INTEGER NOT NULL DEFAULT 0,
+  failure_calls    INTEGER NOT NULL DEFAULT 0,
+  timeout_calls    INTEGER NOT NULL DEFAULT 0,
+
+  total_input_tok  INTEGER NOT NULL DEFAULT 0,
+  total_output_tok INTEGER NOT NULL DEFAULT 0,
+  total_cached_tok INTEGER NOT NULL DEFAULT 0,
+
+  total_cost_usd   REAL NOT NULL DEFAULT 0.0,
+  avg_latency_ms   REAL NOT NULL DEFAULT 0.0,
+  p95_latency_ms   REAL NOT NULL DEFAULT 0.0,
+
+  success_rate     REAL NOT NULL DEFAULT 0.0,
+
+  source           TEXT NOT NULL DEFAULT 'live',
+  created_at       TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at       TEXT NOT NULL DEFAULT (datetime('now')),
+
+  UNIQUE(account_id, date_key, event_type, event_name, workflow_key, task_type, model_id)
+    ON CONFLICT REPLACE
+);