@inneranimalmedia/agentsam-sdk 2.6.9 → 2.6.11

package/examples/hyperspace-demo/index.html

@@ -0,0 +1,16 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
+    <title>AgentSam — Computational Hyperspace</title>
+    <style>
+      html, body, #root { margin: 0; height: 100%; background: #000; }
+      * { box-sizing: border-box; }
+    </style>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/examples/hyperspace-demo/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "hyperspace-demo",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build"
+  },
+  "dependencies": {
+    "@inneranimalmedia/agentsam-loading-scene": "*",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "@vitejs/plugin-react": "^5.2.0",
+    "vite": "^8.2.0"
+  }
+}

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

@@ -0,0 +1,277 @@
+import { StrictMode, useEffect, useMemo, useState } from "react";
+import { createRoot } from "react-dom/client";
+import {
+  HYPERSPACE_STUDIES,
+  LoadingSceneController,
+  adaptAgentSamEvent,
+  computationalHyperspace,
+  type HyperspaceStudyId,
+} from "@inneranimalmedia/agentsam-loading-scene";
+import {
+  LoadingScene,
+  LoadingSceneStatus,
+  LoadingSceneDevtools,
+} from "@inneranimalmedia/agentsam-loading-scene/react";
+
+const preset = computationalHyperspace;
+
+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));
+
+  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 PreviewSurface() {
+  return (
+    <div
+      style={{
+        height: "100%",
+        display: "grid",
+        placeItems: "center",
+        background: "#090A0E",
+        color: "#F7F5FB",
+        fontFamily:
+          'Inter, ui-sans-serif, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif',
+      }}
+    >
+      <div style={{ textAlign: "center", opacity: 0.9 }}>
+        <div
+          style={{
+            fontSize: 12,
+            letterSpacing: "0.12em",
+            textTransform: "uppercase",
+            color: "#B5B1C0",
+          }}
+        >
+          AgentSam
+        </div>
+        <div
+          style={{
+            marginTop: 10,
+            fontSize: 30,
+            letterSpacing: "-0.035em",
+            fontWeight: 600,
+          }}
+        >
+          Runtime complete
+        </div>
+      </div>
+    </div>
+  );
+}
+
+function App() {
+  const controller = useMemo(
+    () => new LoadingSceneController(preset),
+    [],
+  );
+  const [run, setRun] = useState(0);
+  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;
+    return simulateRuntime(controller, () => {
+      window.setTimeout(() => {
+        controller.reset();
+        setRun((value) => value + 1);
+      }, 1500);
+    });
+  }, [controller, run, debug]);
+
+  return (
+    <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",
+          zIndex: 5,
+        }}
+      >
+        <LoadingSceneStatus
+          controller={controller}
+          preset={preset}
+        />
+      </div>
+
+      <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>
+  );
+}
+
+createRoot(document.getElementById("root")!).render(
+  <StrictMode>
+    <App />
+  </StrictMode>,
+);

package/examples/hyperspace-demo/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"]
+  },
+  "include": ["src"]
+}

package/examples/hyperspace-demo/vite.config.ts

@@ -0,0 +1,24 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import path from "node:path";
+
+export default defineConfig({
+  plugins: [react()],
+  server: {
+    host: "0.0.0.0",
+    port: 5181,
+    allowedHosts: true,
+  },
+  resolve: {
+    alias: {
+      "@inneranimalmedia/agentsam-loading-scene/react": path.resolve(
+        __dirname,
+        "../../packages/agentsam-loading-scene/src/react/index.ts",
+      ),
+      "@inneranimalmedia/agentsam-loading-scene": path.resolve(
+        __dirname,
+        "../../packages/agentsam-loading-scene/src/index.ts",
+      ),
+    },
+  },
+});

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/0005_agentsam_hooks.sql

@@ -0,0 +1,87 @@
+-- Portable AgentSam hook registry and execution evidence.
+--
+-- This is the standalone/local baseline. Shared hosts may map owner_id to their
+-- account authority, but tenant_id/workspace_id are intentionally not part of
+-- the portable contract. Repository/project/session applicability belongs in
+-- scope_type + scope_ref; less common correlations stay in JSON.
+--
+-- Handler secrets are references resolved by the host. Never store API keys,
+-- bearer tokens, or decrypted credentials in handler_config_json or receipts.
+
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE IF NOT EXISTS agentsam_hook (
+  id TEXT PRIMARY KEY DEFAULT ('hook_' || lower(hex(randomblob(8)))),
+  owner_id TEXT NOT NULL DEFAULT 'local',
+  hook_key TEXT NOT NULL CHECK(length(trim(hook_key)) > 0 AND hook_key = trim(hook_key)),
+  event_type TEXT NOT NULL CHECK(length(trim(event_type)) > 0 AND event_type = trim(event_type)),
+  source_kind TEXT NOT NULL DEFAULT 'stored'
+    CHECK(source_kind IN ('stored','config','code','system')),
+  scope_type TEXT NOT NULL DEFAULT 'project'
+    CHECK(scope_type IN ('global','account','repository','project','session')),
+  scope_ref TEXT,
+  handler_type TEXT NOT NULL DEFAULT 'log_only'
+    CHECK(length(trim(handler_type)) > 0 AND handler_type = trim(handler_type)),
+  handler_config_json TEXT NOT NULL DEFAULT '{}'
+    CHECK(json_valid(handler_config_json)),
+  match_json TEXT NOT NULL DEFAULT '{}'
+    CHECK(json_valid(match_json)),
+  failure_mode TEXT NOT NULL DEFAULT 'open'
+    CHECK(failure_mode IN ('open','closed','error')),
+  priority INTEGER NOT NULL DEFAULT 100,
+  timeout_ms INTEGER NOT NULL DEFAULT 30000
+    CHECK(timeout_ms BETWEEN 1 AND 600000),
+  is_active INTEGER NOT NULL DEFAULT 1 CHECK(is_active IN (0,1)),
+  workflow_id TEXT,
+  description TEXT,
+  metadata_json TEXT NOT NULL DEFAULT '{}'
+    CHECK(json_valid(metadata_json)),
+  revision INTEGER NOT NULL DEFAULT 1 CHECK(revision >= 1),
+  created_at_unix INTEGER NOT NULL DEFAULT (unixepoch()),
+  updated_at_unix INTEGER NOT NULL DEFAULT (unixepoch())
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_agentsam_hook_identity
+  ON agentsam_hook(owner_id, scope_type, IFNULL(scope_ref, ''), hook_key);
+CREATE INDEX IF NOT EXISTS idx_agentsam_hook_dispatch
+  ON agentsam_hook(owner_id, event_type, is_active, priority, hook_key);
+CREATE INDEX IF NOT EXISTS idx_agentsam_hook_scope
+  ON agentsam_hook(owner_id, scope_type, scope_ref, is_active);
+
+CREATE TABLE IF NOT EXISTS agentsam_hook_execution (
+  id TEXT PRIMARY KEY DEFAULT ('hexec_' || lower(hex(randomblob(8)))),
+  owner_id TEXT NOT NULL DEFAULT 'local',
+  hook_id TEXT,
+  hook_key TEXT NOT NULL,
+  source_kind TEXT NOT NULL DEFAULT 'stored'
+    CHECK(source_kind IN ('stored','config','code','system')),
+  event_type TEXT NOT NULL,
+  invocation_id TEXT,
+  agent_run_id TEXT,
+  session_id TEXT,
+  conversation_id TEXT,
+  status TEXT NOT NULL
+    CHECK(status IN ('completed','failed','timeout','skipped','blocked')),
+  duration_ms INTEGER NOT NULL DEFAULT 0 CHECK(duration_ms >= 0),
+  input_keys_json TEXT NOT NULL DEFAULT '[]' CHECK(json_valid(input_keys_json)),
+  output_keys_json TEXT NOT NULL DEFAULT '[]' CHECK(json_valid(output_keys_json)),
+  decision TEXT,
+  reason TEXT,
+  error_code TEXT,
+  error_message TEXT,
+  receipt_json TEXT NOT NULL DEFAULT '{}' CHECK(json_valid(receipt_json)),
+  correlation_json TEXT NOT NULL DEFAULT '{}' CHECK(json_valid(correlation_json)),
+  ran_at_unix INTEGER NOT NULL DEFAULT (unixepoch())
+);
+
+CREATE INDEX IF NOT EXISTS idx_agentsam_hook_execution_hook
+  ON agentsam_hook_execution(owner_id, hook_key, ran_at_unix DESC);
+CREATE INDEX IF NOT EXISTS idx_agentsam_hook_execution_run
+  ON agentsam_hook_execution(agent_run_id, ran_at_unix DESC)
+  WHERE agent_run_id IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_agentsam_hook_execution_session
+  ON agentsam_hook_execution(session_id, ran_at_unix DESC)
+  WHERE session_id IS NOT NULL;
+CREATE INDEX IF NOT EXISTS idx_agentsam_hook_execution_failure
+  ON agentsam_hook_execution(owner_id, status, ran_at_unix DESC)
+  WHERE status IN ('failed','timeout','blocked');

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
+);