@agent-live/cli 0.0.1

package/console-dist/assets/page-BRDi_757.js

@@ -0,0 +1 @@
+import{a as n,u as l,m as o,j as e,f as d}from"./index-jfHKGDWM.js";import{P as c,D as p,a as h,c as m,b as u,E as j}from"./index-49jCgePm.js";import{A as x}from"./components-0p8SghrX.js";function A(){const{agentId:r,search:i}=n(),a=l("approvals",r),t=a.data?.approvals.filter(s=>o(i,s.label,s.agentName,s.customerAlias));return e.jsxs(e.Fragment,{children:[e.jsx(c,{title:"Approvals",description:"Observed approval requests and decisions. Decisions are made in the originating application.",children:e.jsx(x,{})}),e.jsx(p,{pending:a.isPending,error:a.error,retry:a.refetch,children:t&&e.jsx(h,{children:t.length?e.jsx(m,{label:"Approval events",headers:["Request","Agent","Customer","When","Status"],children:t.map(s=>e.jsxs("tr",{children:[e.jsxs("td",{children:[s.label,e.jsx("div",{className:"row-sub",children:s.channel})]}),e.jsx("td",{children:s.agentName}),e.jsx("td",{children:s.customerAlias}),e.jsx("td",{children:d(s.at)}),e.jsxs("td",{children:[e.jsx(u,{status:s.status}),s.open&&e.jsx("div",{className:"row-sub",children:"Needs a decision"})]})]},s.id))}):e.jsx(j,{children:"No approvals match this view. Adjust filters or wait for an approval request."})})})]})}export{A as default};

package/console-dist/assets/page-BpIZP_o-.js

@@ -0,0 +1 @@
+import{a as n,u as l,m as c,j as e,f as o}from"./index-jfHKGDWM.js";import{P as m,D as d,a as h,c as u,b as j,E as x}from"./index-49jCgePm.js";import{A as v}from"./components-0p8SghrX.js";function y(){const{agentId:a,search:i}=n(),r=l("deliveries",a),t=r.data?.deliveries.filter(s=>c(i,s.summary,s.purpose,s.agentName,s.customerAlias));return e.jsxs(e.Fragment,{children:[e.jsx(m,{title:"Deliveries",description:"Delivery events and their recorded outcomes.",children:e.jsx(v,{})}),e.jsx(d,{pending:r.isPending,error:r.error,retry:r.refetch,children:t&&e.jsx(h,{children:t.length?e.jsx(u,{label:"Delivery events",headers:["Delivery","Agent","Customer","When","Outcome"],children:t.map(s=>e.jsxs("tr",{children:[e.jsxs("td",{children:[s.purpose,e.jsx("div",{className:"row-sub",children:s.summary})]}),e.jsx("td",{children:s.agentName}),e.jsx("td",{children:s.customerAlias}),e.jsx("td",{children:o(s.at)}),e.jsx("td",{children:e.jsx(j,{status:s.outcome})})]},s.id))}):e.jsx(x,{children:"No deliveries match this view. Adjust filters or wait for a delivery event."})})})]})}export{y as default};

package/console-dist/assets/page-Byx3HD88.js

@@ -0,0 +1 @@
+import{a as i,u as o,m as c,j as e}from"./index-jfHKGDWM.js";import{P as u,D as m,a as d}from"./index-49jCgePm.js";import{A as l,R as g}from"./components-0p8SghrX.js";function f(){const{agentId:t,search:n}=i(),a=o("runs",t),r=a.data?.runs.filter(s=>c(n,s.summary,s.agentName,s.customerAlias,s.channel,s.id));return e.jsxs(e.Fragment,{children:[e.jsx(u,{title:"Activity",description:"Runs and outcomes across your agents.",children:e.jsx(l,{})}),e.jsx(m,{pending:a.isPending,error:a.error,retry:a.refetch,children:r&&e.jsx(d,{children:e.jsx(g,{runs:r})})})]})}export{f as default};

package/console-dist/assets/page-CEUp9Rfn.js

@@ -0,0 +1 @@
+import{u as t,j as e,f as n}from"./index-jfHKGDWM.js";import{P as i,D as c,a as r,E as l}from"./index-49jCgePm.js";import{C as o}from"./components-0p8SghrX.js";function p(){const s=t("touchpoints");return e.jsxs(e.Fragment,{children:[e.jsx(i,{title:"Touchpoints",description:"Where customers interact with your agents."}),e.jsx(c,{pending:s.isPending,error:s.error,retry:s.refetch,children:s.data&&e.jsxs("div",{className:"panels",children:[e.jsx(r,{title:"Channel share",children:e.jsx(o,{items:s.data.breakdown})}),e.jsx(r,{title:"Recent touches",children:e.jsx("div",{className:"card-b",children:s.data.recent.length?s.data.recent.map(a=>e.jsxs("div",{className:"row",children:[e.jsxs("div",{className:"row-title",children:[a.action,e.jsxs("div",{className:"row-sub",children:[a.customerAlias," · ",a.agentName," · ",n(a.at)]})]}),e.jsx("span",{className:"pill pill-info",children:a.channel})]},a.id)):e.jsx(l,{children:"Customer interactions will appear here when received."})})})]})})]})}export{p as default};

package/console-dist/assets/page-CmST3snz.js

@@ -0,0 +1 @@
+import{u as a,j as e,L as n,f as r}from"./index-jfHKGDWM.js";import{P as i,D as d,b as c,E as l}from"./index-49jCgePm.js";function g(){const t=a("agents");return e.jsxs(e.Fragment,{children:[e.jsx(i,{title:"Agents",description:"Fleet health. Open an agent to see its activity."}),e.jsx(d,{pending:t.isPending,error:t.error,retry:t.refetch,children:t.data&&(t.data.agents.length?e.jsx("div",{className:"agent-grid",children:t.data.agents.map(s=>e.jsxs(n,{className:"agent-card",to:`/activity?${new URLSearchParams({agent:s.id})}`,children:[e.jsxs("div",{className:"agent-title",children:[e.jsx("h2",{children:s.name}),e.jsx(c,{status:s.status})]}),e.jsx("p",{children:s.description}),e.jsxs("div",{className:"agent-meta",children:[e.jsxs("span",{children:[s.runsToday," runs today"]}),e.jsxs("span",{children:[Math.round(s.failureRate*100),"% failed"]}),e.jsx("span",{children:s.channels.join(", ")}),e.jsxs("span",{children:["Last ",r(s.lastActivityAt)]})]})]},s.id))}):e.jsx(l,{children:"Connected agents will appear here when the server receives activity."}))})]})}export{g as default};

package/console-dist/assets/page-DMYOtzYN.js

@@ -0,0 +1 @@
+import{u as l,j as e,f as r}from"./index-jfHKGDWM.js";import{P as d,D as o,S as i,a as n,b as c,E as u}from"./index-49jCgePm.js";import{C as v,R as x}from"./components-0p8SghrX.js";function m(){const t=l("overview"),a=t.data;return e.jsxs(e.Fragment,{children:[e.jsx(d,{title:"Overview",description:"Customer touchpoints, agent activity, and what needs attention."}),e.jsx(o,{pending:t.isPending,error:t.error,retry:t.refetch,children:a&&e.jsxs("div",{className:"stack",children:[e.jsxs("div",{className:"grid-stats",children:[e.jsx(i,{label:"Active agents",value:a.stats.activeAgents,detail:`${a.stats.agentCount} in fleet`}),e.jsx(i,{label:"Open approvals",value:a.stats.openApprovals,detail:"Waiting on humans"}),e.jsx(i,{label:"Failed deliveries",value:a.stats.failedDeliveries,detail:"Need follow-up"}),e.jsx(i,{label:"Touches today",value:a.stats.touchesToday,detail:`${a.stats.runningRuns} runs live`})]}),e.jsxs("div",{className:"panels",children:[e.jsx(n,{title:"Needs attention",children:e.jsx("div",{className:"card-b",children:a.attention.length?a.attention.map(s=>e.jsxs("div",{className:"row",children:[e.jsxs("div",{className:"row-title",children:[s.title,e.jsxs("div",{className:"row-sub",children:[s.agentName," · ",s.customerAlias," · ",r(s.at)]})]}),e.jsx(c,{status:s.kind==="approval"?"waiting":"failed"})]},`${s.kind}:${s.runId}`)):e.jsx(u,{children:"No outstanding approvals or failed deliveries."})})}),e.jsx(n,{title:"Touch mix",children:e.jsx(v,{items:a.channelBreakdown})})]}),e.jsx(n,{title:"Recent activity",children:e.jsx(x,{runs:a.recentRuns})})]})})]})}export{m as default};

package/console-dist/index.html

@@ -0,0 +1,4 @@
+<!doctype html>
+<html lang="en"><head><meta charset="UTF-8"/><meta name="viewport" content="width=device-width, initial-scale=1.0"/><meta name="description" content="Agent Live — agent activity, approvals, and delivery outcomes."/><title>Agent Live</title>  <script type="module" crossorigin src="/assets/index-jfHKGDWM.js"></script>
+  <link rel="stylesheet" crossorigin href="/assets/index-BnLKN4xZ.css">
+</head><body><div id="root"></div></body></html>

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@agent-live/cli",
+  "version": "0.0.1",
+  "description": "Run a local dashboard for agents instrumented with @agent-live/sdk — one command, no build tooling required.",
+  "license": "Apache-2.0",
+  "keywords": ["ai-agents", "observability", "telemetry", "dashboard", "cli"],
+  "type": "module",
+  "bin": {
+    "agent-live": "./bin.mjs"
+  },
+  "files": ["bin.mjs", "console-dist", "server"],
+  "publishConfig": { "access": "public" },
+  "scripts": {
+    "prepack": "node ./scripts/build-assets.mjs"
+  },
+  "dependencies": {
+    "@agent-live/sdk": "^0.0.2"
+  }
+}

package/server/demo/data.mjs

@@ -0,0 +1,524 @@
+export const ORG = {
+  id: 'org_northline',
+  name: 'Northline Ops',
+  mode: 'demo',
+}
+
+function ago(ms) {
+  return new Date(Date.now() - ms).toISOString()
+}
+
+function seed() {
+  const agents = [
+    {
+      id: 'agt_invoice',
+      name: 'Invoice Concierge',
+      description: 'Collects, reviews, and delivers invoice packs over WhatsApp',
+      status: 'busy',
+      channels: ['whatsapp'],
+      runsToday: 48,
+      failureRate: 0.04,
+      lastActivityAt: ago(40_000),
+    },
+    {
+      id: 'agt_support',
+      name: 'Support Desk',
+      description: 'Triages inbound email and drafts grounded replies',
+      status: 'busy',
+      channels: ['email', 'web'],
+      runsToday: 112,
+      failureRate: 0.07,
+      lastActivityAt: ago(18_000),
+    },
+    {
+      id: 'agt_ops',
+      name: 'Ops Runner',
+      description: 'Schedules field jobs and confirms with customers',
+      status: 'idle',
+      channels: ['whatsapp', 'api'],
+      runsToday: 31,
+      failureRate: 0.02,
+      lastActivityAt: ago(14 * 60_000),
+    },
+    {
+      id: 'agt_billing',
+      name: 'Billing Follow-up',
+      description: 'Sends payment reminders and escalates disputes',
+      status: 'degraded',
+      channels: ['email', 'whatsapp'],
+      runsToday: 67,
+      failureRate: 0.14,
+      lastActivityAt: ago(3 * 60_000),
+    },
+    {
+      id: 'agt_onboard',
+      name: 'Onboarding Guide',
+      description: 'Walks new accounts through setup checklists',
+      status: 'idle',
+      channels: ['web', 'email'],
+      runsToday: 19,
+      failureRate: 0.01,
+      lastActivityAt: ago(42 * 60_000),
+    },
+  ]
+
+  const customers = [
+    { id: 'cus_mira', alias: 'Mira Chen', hint: 'WhatsApp · +1 ···· 1212' },
+    { id: 'cus_jonas', alias: 'Jonas Reed', hint: 'Email · jonas@…' },
+    { id: 'cus_nova', alias: 'Nova Freight', hint: 'API · tenant nova' },
+    { id: 'cus_hala', alias: 'Hala Ortiz', hint: 'WhatsApp · +1 ···· 9981' },
+    { id: 'cus_orbit', alias: 'Orbit Labs', hint: 'Web · portal' },
+    { id: 'cus_eli', alias: 'Eli Park', hint: 'Email · eli@…' },
+  ]
+
+  const runs = []
+  const eventsByRun = new Map()
+
+  function addRun(partial, events) {
+    const run = {
+      model: null,
+      inputTokens: null,
+      outputTokens: null,
+      errorCode: null,
+      externalTraceId: null,
+      inputPreview: null,
+      outputPreview: null,
+      ...partial,
+    }
+    runs.push(run)
+    eventsByRun.set(
+      run.id,
+      events.map((e, i) => ({
+        id: `${run.id}:${i + 1}`,
+        runId: run.id,
+        agentId: run.agentId,
+        tenantId: run.customerId,
+        sequence: i + 1,
+        status: null,
+        completedAt: null,
+        durationMs: null,
+        ...e,
+      })),
+    )
+    return run
+  }
+
+  addRun(
+    {
+      id: 'run_live_invoice',
+      agentId: 'agt_invoice',
+      customerId: 'cus_mira',
+      channel: 'whatsapp',
+      status: 'running',
+      startedAt: ago(2 * 60_000),
+      completedAt: null,
+      durationMs: null,
+      summary: 'Reviewing invoice pack #4421 — waiting on approval',
+    },
+    [
+      { type: 'run.received', label: 'Inbound WhatsApp', startedAt: ago(120_000) },
+      { type: 'context.loaded', label: 'Customer context ready', startedAt: ago(110_000) },
+      { type: 'tool.completed', label: 'lookup_invoice', startedAt: ago(90_000) },
+      {
+        type: 'approval.waiting',
+        label: 'Send invoice summary to customer',
+        startedAt: ago(45_000),
+        metadata: { action: 'Send invoice-summary.pdf to Mira Chen' },
+      },
+    ],
+  )
+
+  addRun(
+    {
+      id: 'run_done_invoice',
+      agentId: 'agt_invoice',
+      customerId: 'cus_hala',
+      channel: 'whatsapp',
+      status: 'completed',
+      startedAt: ago(28 * 60_000),
+      completedAt: ago(24 * 60_000),
+      durationMs: 210_000,
+      summary: 'Delivered weekly invoice summary',
+    },
+    [
+      { type: 'run.received', label: 'Inbound WhatsApp', startedAt: ago(28 * 60_000) },
+      { type: 'approval.approved', label: 'Customer approved send', startedAt: ago(26 * 60_000) },
+      {
+        type: 'output.published',
+        label: 'File ready',
+        startedAt: ago(25.5 * 60_000),
+        metadata: { fileName: 'invoice-summary.pdf' },
+      },
+      {
+        type: 'receipt.sent',
+        label: 'Work receipt',
+        startedAt: ago(25 * 60_000),
+        metadata: {
+          checked: ['Invoice #4418'],
+          created: ['PDF summary'],
+          approval: 'approved',
+        },
+      },
+      {
+        type: 'delivery.delivered',
+        label: 'Delivered on WhatsApp',
+        startedAt: ago(24.2 * 60_000),
+        metadata: { purpose: 'send_result' },
+      },
+      { type: 'run.completed', label: 'Completed', startedAt: ago(24 * 60_000) },
+    ],
+  )
+
+  addRun(
+    {
+      id: 'run_fail_billing',
+      agentId: 'agt_billing',
+      customerId: 'cus_eli',
+      channel: 'email',
+      status: 'failed',
+      startedAt: ago(55 * 60_000),
+      completedAt: ago(52 * 60_000),
+      durationMs: 180_000,
+      summary: 'Reminder prepared but delivery failed',
+    },
+    [
+      { type: 'run.received', label: 'Scheduled reminder', startedAt: ago(55 * 60_000) },
+      {
+        type: 'output.published',
+        label: 'Reminder draft',
+        startedAt: ago(53.5 * 60_000),
+        metadata: { fileName: 'payment-reminder.eml' },
+      },
+      {
+        type: 'delivery.started',
+        label: 'Sending email',
+        startedAt: ago(53 * 60_000),
+        metadata: { purpose: 'payment_reminder' },
+      },
+      {
+        type: 'delivery.failed',
+        label: 'Mailbox rejected',
+        startedAt: ago(52.4 * 60_000),
+        metadata: { purpose: 'payment_reminder' },
+      },
+      { type: 'run.failed', label: 'Stopped', startedAt: ago(52 * 60_000) },
+    ],
+  )
+
+  addRun(
+    {
+      id: 'run_support_live',
+      agentId: 'agt_support',
+      customerId: 'cus_jonas',
+      channel: 'email',
+      status: 'running',
+      startedAt: ago(90_000),
+      completedAt: null,
+      durationMs: null,
+      summary: 'Drafting reply for shipping delay ticket',
+    },
+    [
+      { type: 'run.received', label: 'Inbound email', startedAt: ago(90_000) },
+      { type: 'context.loading', label: 'Loading ticket thread', startedAt: ago(80_000) },
+      { type: 'tool.started', label: 'search_orders', startedAt: ago(40_000) },
+    ],
+  )
+
+  addRun(
+    {
+      id: 'run_ops_done',
+      agentId: 'agt_ops',
+      customerId: 'cus_nova',
+      channel: 'api',
+      status: 'completed',
+      startedAt: ago(3 * 60 * 60_000),
+      completedAt: ago(3 * 60 * 60_000 - 90_000),
+      durationMs: 90_000,
+      summary: 'Confirmed two field jobs via API',
+    },
+    [
+      { type: 'run.received', label: 'API job.confirm', startedAt: ago(3 * 60 * 60_000) },
+      { type: 'tool.completed', label: 'schedule_jobs', startedAt: ago(3 * 60 * 60_000 - 40_000) },
+      { type: 'run.completed', label: 'Completed', startedAt: ago(3 * 60 * 60_000 - 90_000) },
+    ],
+  )
+
+  addRun(
+    {
+      id: 'run_onboard_web',
+      agentId: 'agt_onboard',
+      customerId: 'cus_orbit',
+      channel: 'web',
+      status: 'completed',
+      startedAt: ago(5 * 60 * 60_000),
+      completedAt: ago(5 * 60 * 60_000 - 4 * 60_000),
+      durationMs: 240_000,
+      summary: 'Finished onboarding checklist',
+    },
+    [
+      { type: 'run.received', label: 'Portal session', startedAt: ago(5 * 60 * 60_000) },
+      { type: 'progress.sent', label: 'Step 3 of 5', startedAt: ago(5 * 60 * 60_000 - 90_000) },
+      { type: 'run.completed', label: 'Completed', startedAt: ago(5 * 60 * 60_000 - 4 * 60_000) },
+    ],
+  )
+
+  const touchpoints = [
+    { id: 'tp1', channel: 'whatsapp', customerId: 'cus_mira', agentId: 'agt_invoice', at: ago(120_000), action: 'Message received' },
+    { id: 'tp2', channel: 'email', customerId: 'cus_jonas', agentId: 'agt_support', at: ago(90_000), action: 'Ticket opened' },
+    { id: 'tp3', channel: 'whatsapp', customerId: 'cus_hala', agentId: 'agt_invoice', at: ago(24 * 60_000), action: 'Delivery read' },
+    { id: 'tp4', channel: 'email', customerId: 'cus_eli', agentId: 'agt_billing', at: ago(52 * 60_000), action: 'Bounce received' },
+    { id: 'tp5', channel: 'api', customerId: 'cus_nova', agentId: 'agt_ops', at: ago(3 * 60 * 60_000), action: 'job.confirm' },
+    { id: 'tp6', channel: 'web', customerId: 'cus_orbit', agentId: 'agt_onboard', at: ago(5 * 60 * 60_000), action: 'Checklist started' },
+    { id: 'tp7', channel: 'whatsapp', customerId: 'cus_mira', agentId: 'agt_billing', at: ago(6 * 60 * 60_000), action: 'Reminder opened' },
+    { id: 'tp8', channel: 'email', customerId: 'cus_jonas', agentId: 'agt_support', at: ago(7 * 60 * 60_000), action: 'Follow-up reply' },
+    { id: 'tp9', channel: 'web', customerId: 'cus_orbit', agentId: 'agt_support', at: ago(8 * 60 * 60_000), action: 'Help center chat' },
+    { id: 'tp10', channel: 'api', customerId: 'cus_nova', agentId: 'agt_ops', at: ago(9 * 60 * 60_000), action: 'status.poll' },
+    { id: 'tp11', channel: 'whatsapp', customerId: 'cus_hala', agentId: 'agt_invoice', at: ago(10 * 60 * 60_000), action: 'Approval granted' },
+    { id: 'tp12', channel: 'email', customerId: 'cus_eli', agentId: 'agt_billing', at: ago(11 * 60 * 60_000), action: 'Reminder queued' },
+  ]
+
+  return { agents, customers, runs, eventsByRun, touchpoints }
+}
+
+export const db = seed()
+
+
+export function agentById(id) {
+  return db.agents.find((a) => a.id === id)
+}
+
+export function customerById(id) {
+  return db.customers.find((c) => c.id === id)
+}
+
+export function enrichRun(run) {
+  const agent = agentById(run.agentId)
+  const customer = customerById(run.customerId)
+  return {
+    ...run,
+    agentName: agent?.name ?? run.agentId,
+    customerAlias: customer?.alias ?? run.customerId,
+    customerHint: customer?.hint ?? '',
+  }
+}
+
+export function channelBreakdown() {
+  const counts = {}
+  for (const t of db.touchpoints) {
+    counts[t.channel] = (counts[t.channel] || 0) + 1
+  }
+  const total = db.touchpoints.length || 1
+  return Object.entries(counts)
+    .map(([channel, count]) => ({
+      channel,
+      count,
+      pct: Math.round((count / total) * 100),
+    }))
+    .sort((a, b) => b.count - a.count)
+}
+
+function runHasOpenApproval(run) {
+  if (run.status !== 'running') return false
+  const events = db.eventsByRun.get(run.id) || []
+  const waiting = events.filter((e) => e.type === 'approval.waiting')
+  if (!waiting.length) return false
+  const resolved = events.some((e) => e.type === 'approval.approved' || e.type === 'approval.cancelled')
+  return !resolved
+}
+
+function openApprovalEvent(run) {
+  if (!runHasOpenApproval(run)) return null
+  const events = db.eventsByRun.get(run.id) || []
+  return events.findLast?.((e) => e.type === 'approval.waiting') || events.filter((e) => e.type === 'approval.waiting').at(-1)
+}
+
+export function buildOverview() {
+  const openApprovals = db.runs.filter((r) => runHasOpenApproval(r)).length
+  const failedDeliveries = db.runs.filter((r) =>
+    (db.eventsByRun.get(r.id) || []).some((e) => e.type === 'delivery.failed'),
+  ).length
+  const activeAgents = db.agents.filter((a) => a.status === 'busy' || a.status === 'degraded').length
+  const touchesToday = db.touchpoints.length
+  const running = db.runs.filter((r) => r.status === 'running').length
+
+  return {
+    org: ORG,
+    stats: {
+      activeAgents,
+      agentCount: db.agents.length,
+      openApprovals,
+      failedDeliveries,
+      touchesToday,
+      runningRuns: running,
+    },
+    recentRuns: db.runs
+      .slice()
+      .sort((a, b) => Date.parse(b.startedAt) - Date.parse(a.startedAt))
+      .slice(0, 6)
+      .map(enrichRun),
+    channelBreakdown: channelBreakdown(),
+    attention: [
+      ...db.runs.flatMap((r) => {
+          const waiting = openApprovalEvent(r)
+          if (!waiting) return []
+          return [
+            {
+              kind: 'approval',
+              runId: r.id,
+              title: waiting.metadata?.action || waiting.label,
+              agentName: agentById(r.agentId)?.name,
+              customerAlias: customerById(r.customerId)?.alias,
+              at: waiting.startedAt,
+            },
+          ]
+        }),
+      ...db.runs
+        .filter((r) => (db.eventsByRun.get(r.id) || []).some((e) => e.type === 'delivery.failed'))
+        .map((r) => ({
+          kind: 'delivery_failed',
+          runId: r.id,
+          title: r.summary,
+          agentName: agentById(r.agentId)?.name,
+          customerAlias: customerById(r.customerId)?.alias,
+          at: r.completedAt || r.startedAt,
+        })),
+    ],
+  }
+}
+
+export function listApprovals(agentId) {
+  const items = []
+  for (const run of db.runs) {
+    if (agentId && run.agentId !== agentId) continue
+    for (const e of db.eventsByRun.get(run.id) || []) {
+      if (!e.type.startsWith('approval.')) continue
+      items.push({
+        id: e.id,
+        runId: run.id,
+        type: e.type,
+        label: e.metadata?.action || e.label,
+        status: e.type === 'approval.waiting' ? 'waiting' : e.type === 'approval.approved' ? 'approved' : 'cancelled',
+        at: e.startedAt,
+        agentId: run.agentId,
+        agentName: agentById(run.agentId)?.name,
+        customerAlias: customerById(run.customerId)?.alias,
+        customerHint: customerById(run.customerId)?.hint,
+        channel: run.channel,
+        open: e.type === 'approval.waiting' && runHasOpenApproval(run),
+      })
+    }
+  }
+  return items.sort((a, b) => Date.parse(b.at) - Date.parse(a.at))
+}
+
+export function listDeliveries(agentId) {
+  const items = []
+  for (const run of db.runs) {
+    if (agentId && run.agentId !== agentId) continue
+    for (const e of db.eventsByRun.get(run.id) || []) {
+      if (!e.type.startsWith('delivery.')) continue
+      let outcome = 'in_progress'
+      if (e.type === 'delivery.delivered' || e.type === 'delivery.completed' || e.type === 'delivery.read') {
+        outcome = 'delivered'
+      } else if (e.type === 'delivery.failed') {
+        outcome = 'failed'
+      } else if (e.type === 'delivery.accepted' || e.type === 'delivery.sent') {
+        outcome = 'in_progress'
+      }
+      items.push({
+        id: e.id,
+        runId: run.id,
+        type: e.type,
+        outcome,
+        purpose: e.metadata?.purpose || e.label,
+        at: e.startedAt,
+        agentId: run.agentId,
+        agentName: agentById(run.agentId)?.name,
+        customerAlias: customerById(run.customerId)?.alias,
+        channel: run.channel,
+        summary: run.summary,
+      })
+    }
+  }
+  return items.sort((a, b) => Date.parse(b.at) - Date.parse(a.at))
+}
+
+
+export function startSimulation(broadcast) {
+// Simulate live fleet activity
+let tick = 0
+return setInterval(() => {
+  tick += 1
+  const support = db.runs.find((r) => r.id === 'run_support_live')
+  if (support && tick === 1) {
+    const list = db.eventsByRun.get(support.id) || []
+    const next = {
+      id: `${support.id}:${list.length + 1}`,
+      runId: support.id,
+      agentId: support.agentId,
+      tenantId: support.customerId,
+      sequence: list.length + 1,
+      type: 'tool.completed',
+      status: null,
+      label: 'search_orders finished',
+      metadata: null,
+      startedAt: new Date().toISOString(),
+      completedAt: null,
+      durationMs: null,
+    }
+    list.push(next)
+    support.lastEventAt = next.startedAt
+    const agent = agentById(support.agentId)
+    if (agent) agent.lastActivityAt = next.startedAt
+    broadcast('run-event', {
+      ...next,
+      agentName: agent?.name,
+      customerAlias: customerById(support.customerId)?.alias,
+    })
+  }
+
+  if (tick === 2) {
+    const touch = {
+      id: `tp_live_${Date.now()}`,
+      channel: 'whatsapp',
+      customerId: 'cus_mira',
+      agentId: 'agt_invoice',
+      at: new Date().toISOString(),
+      action: 'Customer opened approval prompt',
+      agentName: agentById('agt_invoice')?.name,
+      customerAlias: customerById('cus_mira')?.alias,
+    }
+    db.touchpoints.unshift(touch)
+    broadcast('touch', touch)
+  }
+
+  if (tick === 3) {
+    const support = db.runs.find((r) => r.id === 'run_support_live')
+    if (!support) return
+    const list = db.eventsByRun.get(support.id) || []
+    const next = {
+      id: `${support.id}:${list.length + 1}`,
+      runId: support.id,
+      agentId: support.agentId,
+      tenantId: support.customerId,
+      sequence: list.length + 1,
+      type: 'model.started',
+      status: null,
+      label: 'Drafting grounded reply',
+      metadata: null,
+      startedAt: new Date().toISOString(),
+      completedAt: null,
+      durationMs: null,
+    }
+    list.push(next)
+    const agent = agentById(support.agentId)
+    if (agent) agent.lastActivityAt = next.startedAt
+    broadcast('run-event', {
+      ...next,
+      agentName: agent?.name,
+      customerAlias: customerById(support.customerId)?.alias,
+    })
+  }
+}, 5000)
+
+}

package/server/http.mjs

@@ -0,0 +1,102 @@
+import { createServer as createHttpServer } from 'node:http'
+import { readFile } from 'node:fs/promises'
+import { fileURLToPath } from 'node:url'
+import { resolve, sep, extname } from 'node:path'
+import { db, buildOverview as buildDemoOverview, channelBreakdown as demoChannelBreakdown, enrichRun, listApprovals as listDemoApprovals, listDeliveries as listDemoDeliveries, agentById, customerById, startSimulation } from './demo/data.mjs'
+import { createRealData } from './real/data.mjs'
+
+const defaultAssets = fileURLToPath(new URL('../../console/dist/', import.meta.url))
+const mimeTypes = { '.html': 'text/html; charset=utf-8', '.js': 'text/javascript; charset=utf-8', '.css': 'text/css; charset=utf-8', '.svg': 'image/svg+xml', '.woff2': 'font/woff2', '.png': 'image/png', '.ico': 'image/x-icon' }
+export function sendJson(res, status, body) {
+  res.writeHead(status, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store' }).end(JSON.stringify(body))
+}
+
+function demoData() {
+  return {
+    buildOverview: buildDemoOverview,
+    listAgents: () => ({ agents: db.agents }),
+    listTouchpoints: () => ({
+      breakdown: demoChannelBreakdown(),
+      recent: db.touchpoints.slice().sort((a, b) => Date.parse(b.at) - Date.parse(a.at)).map(t => ({ ...t, agentName: agentById(t.agentId)?.name, customerAlias: customerById(t.customerId)?.alias })),
+    }),
+    listRuns: (agentId) => ({ runs: db.runs.filter(r => !agentId || r.agentId === agentId).map(enrichRun).sort((a, b) => Date.parse(b.startedAt) - Date.parse(a.startedAt)) }),
+    listApprovals: (agentId) => ({ approvals: listDemoApprovals(agentId) }),
+    listDeliveries: (agentId) => ({ deliveries: listDemoDeliveries(agentId) }),
+    subscribe: (broadcast) => { const sim = startSimulation(broadcast); return () => clearInterval(sim) },
+    dispose() {},
+  }
+}
+
+/** `mode: 'demo'` serves fabricated sample data; `mode: 'real'` reads the SDK's SQLite store at `dbPath`. */
+export function createServer({ mode = 'demo', dbPath, assetsDir = defaultAssets, simulate = true } = {}) {
+  const data = mode === 'real' ? createRealData({ dbPath }) : demoData()
+  const clients = new Set()
+  const heartbeats = new Set()
+  function broadcast(event, payload) {
+    for (const client of clients) client.write(`event: ${event}\ndata: ${JSON.stringify(payload)}\n\n`)
+  }
+  const unsubscribe = (mode === 'demo' ? simulate : true) ? data.subscribe(broadcast) : null
+  const server = createHttpServer((req, res) => {
+    handle(req, res).catch(() => {
+      if (!res.headersSent) sendJson(res, 500, { error: 'Request failed' })
+      else res.end()
+    })
+  })
+  async function handle(req, res) {
+    const url = new URL(req.url || '/', 'http://localhost')
+    const agentId = url.searchParams.get('agentId') || undefined
+    if (req.method !== 'GET' && req.method !== 'HEAD') {
+      res.setHeader('Allow', 'GET, HEAD')
+      return sendJson(res, 405, { error: 'Method not allowed' })
+    }
+    if (url.pathname === '/api/overview') return sendJson(res, 200, data.buildOverview())
+    if (url.pathname === '/api/agents') return sendJson(res, 200, data.listAgents())
+    if (url.pathname === '/api/touchpoints') return sendJson(res, 200, data.listTouchpoints())
+    if (url.pathname === '/api/runs') return sendJson(res, 200, data.listRuns(agentId))
+    if (url.pathname === '/api/approvals') return sendJson(res, 200, data.listApprovals(agentId))
+    if (url.pathname === '/api/deliveries') return sendJson(res, 200, data.listDeliveries(agentId))
+    if (url.pathname === '/api/stream') {
+      res.writeHead(200, { 'Content-Type': 'text/event-stream', 'Cache-Control': 'no-cache', 'Connection': 'keep-alive', 'X-Accel-Buffering': 'no' })
+      if (req.method === 'HEAD') return res.end()
+      res.write(': connected\n\n')
+      clients.add(res)
+      const heartbeat = setInterval(() => res.write(': ping\n\n'), 15000)
+      heartbeats.add(heartbeat)
+      res.on('close', () => { clearInterval(heartbeat); heartbeats.delete(heartbeat); clients.delete(res) })
+      return
+    }
+    if (url.pathname.startsWith('/api/') || url.pathname === '/api') return sendJson(res, 404, { error: 'Not found' })
+    let pathname
+    try { pathname = decodeURIComponent(url.pathname) } catch { return sendJson(res, 400, { error: 'Invalid path' }) }
+    const root = resolve(assetsDir)
+    const target = resolve(root, '.' + pathname)
+    if (target !== root && !target.startsWith(root + sep)) return sendJson(res, 403, { error: 'Forbidden' })
+    const isAsset = pathname.startsWith('/assets/') || extname(pathname) !== ''
+    const file = isAsset ? target : resolve(root, 'index.html')
+    try {
+      const body = await readFile(file)
+      res.writeHead(200, {
+        'Content-Type': mimeTypes[extname(file)] || 'application/octet-stream',
+        'Cache-Control': pathname.startsWith('/assets/') ? 'public, max-age=31536000, immutable' : 'no-cache',
+        'X-Content-Type-Options': 'nosniff',
+      }).end(req.method === 'HEAD' ? undefined : body)
+    } catch {
+      sendJson(res, isAsset ? 404 : 503, { error: isAsset ? 'Asset not found' : 'Console is not built. Run npm run build first, or use npm run dev.' })
+    }
+  }
+  function dispose() {
+    if (unsubscribe) unsubscribe()
+    for (const timer of heartbeats) clearInterval(timer)
+    for (const client of clients) client.end()
+    heartbeats.clear()
+    clients.clear()
+    data.dispose()
+  }
+  server.on('close', dispose)
+  return { server, dispose }
+}
+
+/** Back-compat wrapper — `npm run demo` and existing tests import this directly. */
+export function createDemoServer({ assetsDir = defaultAssets, simulate = true } = {}) {
+  return createServer({ mode: 'demo', assetsDir, simulate })
+}