@opengeni/react 3.1.0 → 3.1.3-canary.38890816741001

package/dist/testing/session-scenarios.js

@@ -0,0 +1,367 @@
+"use client";
+
+// src/testing/session-scenarios.ts
+function recorder(sessionId) {
+  const events = [];
+  let clock = Date.parse("2026-10-03T09:00:00Z");
+  const push = (type, payload, turnId, advanceMs = 2e3) => {
+    clock += advanceMs;
+    events.push({
+      id: `${sessionId}-evt-${events.length + 1}`,
+      workspaceId: "lab-workspace",
+      sessionId,
+      sequence: events.length + 1,
+      type,
+      payload,
+      turnId,
+      occurredAt: new Date(clock).toISOString()
+    });
+  };
+  const tool = (turnId, id, name, args, output, durationMs = 3e3) => {
+    push("agent.toolCall.created", { id, name, arguments: args }, turnId, 800);
+    if (output !== void 0) push("agent.toolCall.output", { id, output }, turnId, durationMs);
+  };
+  return { events, push, tool };
+}
+function answer() {
+  const r = recorder("lab-answer");
+  const t = "turn-answer";
+  r.push(
+    "user.message",
+    { text: "What's the difference between a retry and a resume for a failed run?" },
+    t
+  );
+  r.push("turn.started", {}, t, 400);
+  r.push(
+    "agent.reasoning.delta",
+    { text: "The user wants a crisp conceptual distinction, with an example." },
+    t,
+    1500
+  );
+  const text = [
+    "**Retry** starts the failed step again from its last durable checkpoint. **Resume** continues the whole run from where it paused, keeping everything already done.",
+    "",
+    "### When to use which",
+    "",
+    "- **Retry** when a single step failed for a transient reason (timeout, rate limit).",
+    "- **Resume** when the run was *waiting* \u2014 for an approval, an answer, or capacity.",
+    "",
+    "```bash",
+    "opengeni sessions retry 7f3c --step build",
+    "```",
+    "",
+    "Neither replays side effects that already succeeded."
+  ].join("\n");
+  r.push("agent.message.delta", { text }, t, 2500);
+  r.push("agent.message.completed", { text }, t, 300);
+  r.push("turn.completed", { output: text }, t, 200);
+  return { id: "answer", title: "Quick answer", events: r.events, running: false };
+}
+function working() {
+  const r = recorder("lab-working");
+  const t = "turn-working";
+  r.push(
+    "user.message",
+    {
+      text: "The checkout tests started failing after the currency change. Can you find out why and fix it?"
+    },
+    t
+  );
+  r.push("turn.started", {}, t, 400);
+  r.push(
+    "agent.reasoning.delta",
+    { text: "Start by reproducing the failure, then narrow to the currency formatting path." },
+    t,
+    1800
+  );
+  r.tool(
+    t,
+    "c1",
+    "exec_command",
+    { cmd: "bun test checkout" },
+    "3 failed, 41 passed\n\u2717 formats totals in NOK\n\u2717 rounds VAT per line\n\u2717 shows discount",
+    6e3
+  );
+  r.tool(
+    t,
+    "c2",
+    "search_files",
+    { query: "formatCurrency(" },
+    "src/money/format.ts:12\nsrc/checkout/summary.tsx:48\nsrc/checkout/line.tsx:31"
+  );
+  r.push(
+    "agent.message.delta",
+    {
+      text: "Found it: the currency change switched to minor units, but the summary still divides by 100.",
+      phase: "commentary"
+    },
+    t,
+    1200
+  );
+  r.push(
+    "agent.message.completed",
+    {
+      text: "Found it: the currency change switched to minor units, but the summary still divides by 100.",
+      phase: "commentary"
+    },
+    t,
+    200
+  );
+  r.tool(t, "c3", "apply_patch", { path: "src/checkout/summary.tsx" }, "Updated 1 file (+3 \u22125)");
+  r.tool(t, "c4", "exec_command", { cmd: "bun test checkout" });
+  return { id: "working", title: "Working", events: r.events, running: true };
+}
+function needsYou() {
+  const r = recorder("lab-needs-you");
+  const t = "turn-needs-you";
+  r.push("user.message", { text: "Ship the fix to the preview environment and tell the team." }, t);
+  r.push("turn.started", {}, t, 400);
+  r.tool(t, "n1", "exec_command", { cmd: "bun run build" }, "Build completed in 41s", 8e3);
+  r.tool(t, "n2", "list_channels", { query: "release" }, "#releases, #release-ops");
+  r.push(
+    "agent.toolCall.created",
+    {
+      id: "n3",
+      name: "deploy_preview",
+      arguments: { environment: "preview", ref: "fix/checkout-minor-units" }
+    },
+    t,
+    900
+  );
+  r.push(
+    "session.requiresAction",
+    {
+      approvals: [
+        {
+          id: "n3",
+          name: "deploy_preview",
+          arguments: { environment: "preview", ref: "fix/checkout-minor-units" }
+        }
+      ]
+    },
+    t,
+    300
+  );
+  r.push(
+    "session.humanInput.requested",
+    {
+      request: {
+        id: "hi-1",
+        allowSkip: true,
+        questions: [
+          {
+            id: "channel",
+            kind: "single_select",
+            prompt: "Where should I announce the preview?",
+            label: "Announcement",
+            required: true,
+            options: [
+              { id: "releases", label: "#releases", description: "Team-wide release notes" },
+              { id: "release-ops", label: "#release-ops", description: "Operators only" }
+            ]
+          }
+        ]
+      }
+    },
+    t,
+    300
+  );
+  return { id: "needs-you", title: "Needs you", events: r.events, running: true };
+}
+function history() {
+  const r = recorder("lab-history");
+  const a = "turn-h1";
+  r.push("user.message", { text: "Summarise yesterday's support tickets." }, a);
+  r.push("turn.started", {}, a, 400);
+  r.tool(a, "h1", "search_tickets", { since: "yesterday" }, "38 tickets", 4e3);
+  r.tool(a, "h2", "read_ticket", { id: "T-1182" }, "Customer cannot export invoices to PDF");
+  r.tool(a, "h3", "read_ticket", { id: "T-1190" }, "Login loop on Android 15");
+  const summary = "38 tickets yesterday. The two themes:\n\n1. **PDF export** fails for invoices with attachments (11 tickets).\n2. **Android login loop** after the last release (7 tickets).\n\nEverything else was routine.";
+  r.push("agent.message.delta", { text: summary }, a, 2e3);
+  r.push("agent.message.completed", { text: summary }, a, 200);
+  r.push("turn.completed", { output: summary }, a, 200);
+  const b = "turn-h2";
+  r.push(
+    "user.message",
+    { text: "Open an issue for the Android one and assign it to mobile." },
+    b,
+    6e4
+  );
+  r.push("turn.started", {}, b, 400);
+  r.tool(
+    b,
+    "h4",
+    "create_issue",
+    { title: "Android login loop after release", team: "mobile" },
+    "Error: tracker token expired",
+    2e3
+  );
+  r.push(
+    "turn.failed",
+    { error: "The issue tracker connection needs to be reauthorized." },
+    b,
+    400
+  );
+  const c = "turn-h3";
+  r.push("user.message", { text: "Reconnected. Try again." }, c, 3e4);
+  r.push("turn.started", {}, c, 400);
+  r.tool(
+    c,
+    "h5",
+    "create_issue",
+    { title: "Android login loop after release", team: "mobile" },
+    "Created MOB-412",
+    2e3
+  );
+  const done = "Created **MOB-412** and assigned it to the mobile team.";
+  r.push("agent.message.delta", { text: done }, c, 1e3);
+  r.push("agent.message.completed", { text: done }, c, 200);
+  r.push("turn.completed", { output: done }, c, 200);
+  return { id: "history", title: "History", events: r.events, running: false };
+}
+function failure() {
+  const r = recorder("lab-failure");
+  const t = "turn-failure";
+  r.push("user.message", { text: "Deploy the latest build to staging." }, t);
+  r.push("turn.started", {}, t, 400);
+  r.tool(t, "f1", "exec_command", { cmd: "bun run build" }, "Build completed in 38s", 7e3);
+  r.tool(
+    t,
+    "f2",
+    "exec_command",
+    { cmd: "deploy --env staging" },
+    "error: staging cluster unreachable (connection refused after 3 attempts)",
+    4e3
+  );
+  r.push(
+    "turn.failed",
+    { error: "The staging cluster refused the connection. Nothing was deployed." },
+    t,
+    400
+  );
+  return { id: "failure", title: "Failure", events: r.events, running: false };
+}
+function longContent() {
+  const r = recorder("lab-long");
+  const t = "turn-long";
+  const question = [
+    "Here is the incident timeline from the on-call channel. Please turn it into a short postmortem with a summary, impact, root cause, a table of the timeline and the follow-ups.",
+    "",
+    "09:02 alerts fire for elevated 5xx on the checkout API; 09:05 on-call acknowledges; 09:11 rollback of release 412 starts; 09:19 error rate back to baseline; 09:40 root cause identified as a missing index after the orders migration; 10:15 index added and release 412 redeployed."
+  ].join("\n");
+  r.push("user.message", { text: question }, t);
+  r.push("turn.started", {}, t, 400);
+  r.push(
+    "agent.reasoning.delta",
+    { text: "Structure it as a standard postmortem with a timeline table." },
+    t,
+    1500
+  );
+  const text = [
+    "## Postmortem: checkout 5xx after release 412",
+    "",
+    "**Summary.** For 17 minutes the checkout API returned elevated server errors after release 412. Rolling back restored service; the fix shipped the same morning.",
+    "",
+    "**Impact.** Roughly 6% of checkout attempts failed between 09:02 and 09:19. No orders were lost, but some customers had to retry.",
+    "",
+    "**Root cause.** The orders migration in release 412 dropped and recreated a table without its `customer_id` index, so a hot query fell back to a sequential scan and timed out under load.",
+    "",
+    "### Timeline",
+    "",
+    "| Time | Event |",
+    "| --- | --- |",
+    "| 09:02 | Alerts fire for elevated 5xx on checkout |",
+    "| 09:05 | On-call acknowledges |",
+    "| 09:11 | Rollback of release 412 starts |",
+    "| 09:19 | Error rate back to baseline |",
+    "| 09:40 | Missing index identified |",
+    "| 10:15 | Index added, release 412 redeployed |",
+    "",
+    "### Follow-ups",
+    "",
+    "1. Add a migration check that fails when an index disappears.",
+    "2. Alert on query latency, not only error rate.",
+    "3. Document the rollback runbook link in the alert itself.",
+    "",
+    "```sql",
+    "CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);",
+    "```",
+    "",
+    "> Rollback was the right first move: it bought time to find the cause without pressure."
+  ].join("\n");
+  r.push("agent.message.delta", { text }, t, 3e3);
+  r.push("agent.message.completed", { text }, t, 300);
+  r.push("turn.completed", { output: text }, t, 200);
+  return { id: "long", title: "Long content", events: r.events, running: false };
+}
+var PREVIEW_FENCE_BODY = [
+  '<div class="card" style="padding:16px">',
+  '  <h2 style="margin:0 0 8px">Weekly signups</h2>',
+  '  <p style="margin:0 0 12px;color:#777">Last 6 weeks, all channels</p>',
+  '  <div style="display:flex;gap:8px;align-items:flex-end;height:140px">',
+  ...[42, 58, 51, 73, 88, 96].map(
+    (value) => `    <div style="flex:1;height:${value}%;border-radius:6px;background:linear-gradient(#5fb8a3,#2f7d6d)"></div>`
+  ),
+  "  </div>",
+  "</div>"
+].join("\n");
+function media() {
+  const r = recorder("lab-media");
+  const t = "turn-media";
+  r.push("user.message", { text: "Compare the plans and show me the signup trend." }, t);
+  r.push("turn.started", {}, t, 400);
+  const text = [
+    "Signups are up again. Here is the trend as a live chart:",
+    "",
+    "```opengeni-html",
+    PREVIEW_FENCE_BODY,
+    "```",
+    "",
+    "![Signup funnel](https://picsum.photos/id/1056/1200/675)",
+    "",
+    "And the comparison across every plan:",
+    "",
+    "| Plan | Monthly price | Seats included | Storage | Support | Uptime SLA | Overage per seat |",
+    "| --- | --- | --- | --- | --- | --- | --- |",
+    "| Starter | $0 | 3 | 5 GB | Community forum | None | Not available |",
+    "| Team | $49 | 10 | 100 GB | Email, next business day | 99.5% | $6 |",
+    "| Business | $199 | 50 | 1 TB | Chat and email, 4 hours | 99.9% | $5 |",
+    "| Enterprise | Custom | Unlimited | Custom | Dedicated manager | 99.99% | Negotiated |",
+    "",
+    "Signups grew every week except week 3."
+  ].join("\n");
+  r.push("agent.message.delta", { text }, t, 2500);
+  r.push("agent.message.completed", { text }, t, 300);
+  r.push("turn.completed", { output: text }, t, 200);
+  return { id: "media", title: "Tables & media", events: r.events, running: false };
+}
+function previewing() {
+  const r = recorder("lab-previewing");
+  const t = "turn-previewing";
+  r.push("user.message", { text: "Make me a quick chart of weekly signups." }, t);
+  r.push("turn.started", {}, t, 400);
+  const partial = PREVIEW_FENCE_BODY.split("\n").slice(0, 5).join("\n");
+  r.push(
+    "agent.message.delta",
+    { text: ["Here is the chart:", "", "```opengeni-html", partial].join("\n") },
+    t,
+    2e3
+  );
+  return { id: "previewing", title: "Writing a preview", events: r.events, running: true };
+}
+function labScenarios() {
+  return [
+    answer(),
+    working(),
+    needsYou(),
+    history(),
+    failure(),
+    longContent(),
+    media(),
+    previewing()
+  ];
+}
+export {
+  labScenarios
+};
+//# sourceMappingURL=session-scenarios.js.map

package/dist/testing/session-scenarios.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/session-scenarios.ts"],"sourcesContent":["// Deterministic session scenarios for visual harnesses (web dev gallery and native lab).\n// They use the same durable event shapes a live session produces, so every renderer\n// replays identical input through the official projection with no model calls.\nimport type { SessionEvent } from \"@opengeni/sdk\";\n\nexport type LabScenarioId =\n  | \"answer\"\n  | \"working\"\n  | \"needs-you\"\n  | \"history\"\n  | \"failure\"\n  | \"long\"\n  | \"media\"\n  | \"previewing\";\n\nexport interface LabScenario {\n  id: LabScenarioId;\n  title: string;\n  events: SessionEvent[];\n  /** Whether the session is currently running a turn. */\n  running: boolean;\n}\n\nfunction recorder(sessionId: string) {\n  const events: SessionEvent[] = [];\n  let clock = Date.parse(\"2026-10-03T09:00:00Z\");\n  const push = (type: string, payload: unknown, turnId: string | null, advanceMs = 2_000) => {\n    clock += advanceMs;\n    events.push({\n      id: `${sessionId}-evt-${events.length + 1}`,\n      workspaceId: \"lab-workspace\",\n      sessionId,\n      sequence: events.length + 1,\n      type,\n      payload,\n      turnId,\n      occurredAt: new Date(clock).toISOString(),\n    } as SessionEvent);\n  };\n  const tool = (\n    turnId: string,\n    id: string,\n    name: string,\n    args: unknown,\n    output?: unknown,\n    durationMs = 3_000,\n  ) => {\n    push(\"agent.toolCall.created\", { id, name, arguments: args }, turnId, 800);\n    if (output !== undefined) push(\"agent.toolCall.output\", { id, output }, turnId, durationMs);\n  };\n  return { events, push, tool };\n}\n\nfunction answer(): LabScenario {\n  const r = recorder(\"lab-answer\");\n  const t = \"turn-answer\";\n  r.push(\n    \"user.message\",\n    { text: \"What's the difference between a retry and a resume for a failed run?\" },\n    t,\n  );\n  r.push(\"turn.started\", {}, t, 400);\n  r.push(\n    \"agent.reasoning.delta\",\n    { text: \"The user wants a crisp conceptual distinction, with an example.\" },\n    t,\n    1_500,\n  );\n  const text = [\n    \"**Retry** starts the failed step again from its last durable checkpoint. **Resume** continues the whole run from where it paused, keeping everything already done.\",\n    \"\",\n    \"### When to use which\",\n    \"\",\n    \"- **Retry** when a single step failed for a transient reason (timeout, rate limit).\",\n    \"- **Resume** when the run was *waiting* — for an approval, an answer, or capacity.\",\n    \"\",\n    \"```bash\",\n    \"opengeni sessions retry 7f3c --step build\",\n    \"```\",\n    \"\",\n    \"Neither replays side effects that already succeeded.\",\n  ].join(\"\\n\");\n  r.push(\"agent.message.delta\", { text }, t, 2_500);\n  r.push(\"agent.message.completed\", { text }, t, 300);\n  r.push(\"turn.completed\", { output: text }, t, 200);\n  return { id: \"answer\", title: \"Quick answer\", events: r.events, running: false };\n}\n\nfunction working(): LabScenario {\n  const r = recorder(\"lab-working\");\n  const t = \"turn-working\";\n  r.push(\n    \"user.message\",\n    {\n      text: \"The checkout tests started failing after the currency change. Can you find out why and fix it?\",\n    },\n    t,\n  );\n  r.push(\"turn.started\", {}, t, 400);\n  r.push(\n    \"agent.reasoning.delta\",\n    { text: \"Start by reproducing the failure, then narrow to the currency formatting path.\" },\n    t,\n    1_800,\n  );\n  r.tool(\n    t,\n    \"c1\",\n    \"exec_command\",\n    { cmd: \"bun test checkout\" },\n    \"3 failed, 41 passed\\n✗ formats totals in NOK\\n✗ rounds VAT per line\\n✗ shows discount\",\n    6_000,\n  );\n  r.tool(\n    t,\n    \"c2\",\n    \"search_files\",\n    { query: \"formatCurrency(\" },\n    \"src/money/format.ts:12\\nsrc/checkout/summary.tsx:48\\nsrc/checkout/line.tsx:31\",\n  );\n  r.push(\n    \"agent.message.delta\",\n    {\n      text: \"Found it: the currency change switched to minor units, but the summary still divides by 100.\",\n      phase: \"commentary\",\n    },\n    t,\n    1_200,\n  );\n  r.push(\n    \"agent.message.completed\",\n    {\n      text: \"Found it: the currency change switched to minor units, but the summary still divides by 100.\",\n      phase: \"commentary\",\n    },\n    t,\n    200,\n  );\n  r.tool(t, \"c3\", \"apply_patch\", { path: \"src/checkout/summary.tsx\" }, \"Updated 1 file (+3 −5)\");\n  r.tool(t, \"c4\", \"exec_command\", { cmd: \"bun test checkout\" });\n  return { id: \"working\", title: \"Working\", events: r.events, running: true };\n}\n\nfunction needsYou(): LabScenario {\n  const r = recorder(\"lab-needs-you\");\n  const t = \"turn-needs-you\";\n  r.push(\"user.message\", { text: \"Ship the fix to the preview environment and tell the team.\" }, t);\n  r.push(\"turn.started\", {}, t, 400);\n  r.tool(t, \"n1\", \"exec_command\", { cmd: \"bun run build\" }, \"Build completed in 41s\", 8_000);\n  r.tool(t, \"n2\", \"list_channels\", { query: \"release\" }, \"#releases, #release-ops\");\n  r.push(\n    \"agent.toolCall.created\",\n    {\n      id: \"n3\",\n      name: \"deploy_preview\",\n      arguments: { environment: \"preview\", ref: \"fix/checkout-minor-units\" },\n    },\n    t,\n    900,\n  );\n  r.push(\n    \"session.requiresAction\",\n    {\n      approvals: [\n        {\n          id: \"n3\",\n          name: \"deploy_preview\",\n          arguments: { environment: \"preview\", ref: \"fix/checkout-minor-units\" },\n        },\n      ],\n    },\n    t,\n    300,\n  );\n  r.push(\n    \"session.humanInput.requested\",\n    {\n      request: {\n        id: \"hi-1\",\n        allowSkip: true,\n        questions: [\n          {\n            id: \"channel\",\n            kind: \"single_select\",\n            prompt: \"Where should I announce the preview?\",\n            label: \"Announcement\",\n            required: true,\n            options: [\n              { id: \"releases\", label: \"#releases\", description: \"Team-wide release notes\" },\n              { id: \"release-ops\", label: \"#release-ops\", description: \"Operators only\" },\n            ],\n          },\n        ],\n      },\n    },\n    t,\n    300,\n  );\n  return { id: \"needs-you\", title: \"Needs you\", events: r.events, running: true };\n}\n\nfunction history(): LabScenario {\n  const r = recorder(\"lab-history\");\n  const a = \"turn-h1\";\n  r.push(\"user.message\", { text: \"Summarise yesterday's support tickets.\" }, a);\n  r.push(\"turn.started\", {}, a, 400);\n  r.tool(a, \"h1\", \"search_tickets\", { since: \"yesterday\" }, \"38 tickets\", 4_000);\n  r.tool(a, \"h2\", \"read_ticket\", { id: \"T-1182\" }, \"Customer cannot export invoices to PDF\");\n  r.tool(a, \"h3\", \"read_ticket\", { id: \"T-1190\" }, \"Login loop on Android 15\");\n  const summary =\n    \"38 tickets yesterday. The two themes:\\n\\n1. **PDF export** fails for invoices with attachments (11 tickets).\\n2. **Android login loop** after the last release (7 tickets).\\n\\nEverything else was routine.\";\n  r.push(\"agent.message.delta\", { text: summary }, a, 2_000);\n  r.push(\"agent.message.completed\", { text: summary }, a, 200);\n  r.push(\"turn.completed\", { output: summary }, a, 200);\n  const b = \"turn-h2\";\n  r.push(\n    \"user.message\",\n    { text: \"Open an issue for the Android one and assign it to mobile.\" },\n    b,\n    60_000,\n  );\n  r.push(\"turn.started\", {}, b, 400);\n  r.tool(\n    b,\n    \"h4\",\n    \"create_issue\",\n    { title: \"Android login loop after release\", team: \"mobile\" },\n    \"Error: tracker token expired\",\n    2_000,\n  );\n  r.push(\n    \"turn.failed\",\n    { error: \"The issue tracker connection needs to be reauthorized.\" },\n    b,\n    400,\n  );\n  const c = \"turn-h3\";\n  r.push(\"user.message\", { text: \"Reconnected. Try again.\" }, c, 30_000);\n  r.push(\"turn.started\", {}, c, 400);\n  r.tool(\n    c,\n    \"h5\",\n    \"create_issue\",\n    { title: \"Android login loop after release\", team: \"mobile\" },\n    \"Created MOB-412\",\n    2_000,\n  );\n  const done = \"Created **MOB-412** and assigned it to the mobile team.\";\n  r.push(\"agent.message.delta\", { text: done }, c, 1_000);\n  r.push(\"agent.message.completed\", { text: done }, c, 200);\n  r.push(\"turn.completed\", { output: done }, c, 200);\n  return { id: \"history\", title: \"History\", events: r.events, running: false };\n}\n\nfunction failure(): LabScenario {\n  const r = recorder(\"lab-failure\");\n  const t = \"turn-failure\";\n  r.push(\"user.message\", { text: \"Deploy the latest build to staging.\" }, t);\n  r.push(\"turn.started\", {}, t, 400);\n  r.tool(t, \"f1\", \"exec_command\", { cmd: \"bun run build\" }, \"Build completed in 38s\", 7_000);\n  r.tool(\n    t,\n    \"f2\",\n    \"exec_command\",\n    { cmd: \"deploy --env staging\" },\n    \"error: staging cluster unreachable (connection refused after 3 attempts)\",\n    4_000,\n  );\n  r.push(\n    \"turn.failed\",\n    { error: \"The staging cluster refused the connection. Nothing was deployed.\" },\n    t,\n    400,\n  );\n  return { id: \"failure\", title: \"Failure\", events: r.events, running: false };\n}\n\nfunction longContent(): LabScenario {\n  const r = recorder(\"lab-long\");\n  const t = \"turn-long\";\n  const question = [\n    \"Here is the incident timeline from the on-call channel. Please turn it into a short postmortem with a summary, impact, root cause, a table of the timeline and the follow-ups.\",\n    \"\",\n    \"09:02 alerts fire for elevated 5xx on the checkout API; 09:05 on-call acknowledges; 09:11 rollback of release 412 starts; 09:19 error rate back to baseline; 09:40 root cause identified as a missing index after the orders migration; 10:15 index added and release 412 redeployed.\",\n  ].join(\"\\n\");\n  r.push(\"user.message\", { text: question }, t);\n  r.push(\"turn.started\", {}, t, 400);\n  r.push(\n    \"agent.reasoning.delta\",\n    { text: \"Structure it as a standard postmortem with a timeline table.\" },\n    t,\n    1_500,\n  );\n  const text = [\n    \"## Postmortem: checkout 5xx after release 412\",\n    \"\",\n    \"**Summary.** For 17 minutes the checkout API returned elevated server errors after release 412. Rolling back restored service; the fix shipped the same morning.\",\n    \"\",\n    \"**Impact.** Roughly 6% of checkout attempts failed between 09:02 and 09:19. No orders were lost, but some customers had to retry.\",\n    \"\",\n    \"**Root cause.** The orders migration in release 412 dropped and recreated a table without its `customer_id` index, so a hot query fell back to a sequential scan and timed out under load.\",\n    \"\",\n    \"### Timeline\",\n    \"\",\n    \"| Time | Event |\",\n    \"| --- | --- |\",\n    \"| 09:02 | Alerts fire for elevated 5xx on checkout |\",\n    \"| 09:05 | On-call acknowledges |\",\n    \"| 09:11 | Rollback of release 412 starts |\",\n    \"| 09:19 | Error rate back to baseline |\",\n    \"| 09:40 | Missing index identified |\",\n    \"| 10:15 | Index added, release 412 redeployed |\",\n    \"\",\n    \"### Follow-ups\",\n    \"\",\n    \"1. Add a migration check that fails when an index disappears.\",\n    \"2. Alert on query latency, not only error rate.\",\n    \"3. Document the rollback runbook link in the alert itself.\",\n    \"\",\n    \"```sql\",\n    \"CREATE INDEX CONCURRENTLY orders_customer_id_idx ON orders (customer_id);\",\n    \"```\",\n    \"\",\n    \"> Rollback was the right first move: it bought time to find the cause without pressure.\",\n  ].join(\"\\n\");\n  r.push(\"agent.message.delta\", { text }, t, 3_000);\n  r.push(\"agent.message.completed\", { text }, t, 300);\n  r.push(\"turn.completed\", { output: text }, t, 200);\n  return { id: \"long\", title: \"Long content\", events: r.events, running: false };\n}\n\nconst PREVIEW_FENCE_BODY = [\n  '<div class=\"card\" style=\"padding:16px\">',\n  '  <h2 style=\"margin:0 0 8px\">Weekly signups</h2>',\n  '  <p style=\"margin:0 0 12px;color:#777\">Last 6 weeks, all channels</p>',\n  '  <div style=\"display:flex;gap:8px;align-items:flex-end;height:140px\">',\n  ...[42, 58, 51, 73, 88, 96].map(\n    (value) =>\n      `    <div style=\"flex:1;height:${value}%;border-radius:6px;background:linear-gradient(#5fb8a3,#2f7d6d)\"></div>`,\n  ),\n  \"  </div>\",\n  \"</div>\",\n].join(\"\\n\");\n\n/** Wide table, an image and a finished interactive preview. */\nfunction media(): LabScenario {\n  const r = recorder(\"lab-media\");\n  const t = \"turn-media\";\n  r.push(\"user.message\", { text: \"Compare the plans and show me the signup trend.\" }, t);\n  r.push(\"turn.started\", {}, t, 400);\n  const text = [\n    \"Signups are up again. Here is the trend as a live chart:\",\n    \"\",\n    \"```opengeni-html\",\n    PREVIEW_FENCE_BODY,\n    \"```\",\n    \"\",\n    \"![Signup funnel](https://picsum.photos/id/1056/1200/675)\",\n    \"\",\n    \"And the comparison across every plan:\",\n    \"\",\n    \"| Plan | Monthly price | Seats included | Storage | Support | Uptime SLA | Overage per seat |\",\n    \"| --- | --- | --- | --- | --- | --- | --- |\",\n    \"| Starter | $0 | 3 | 5 GB | Community forum | None | Not available |\",\n    \"| Team | $49 | 10 | 100 GB | Email, next business day | 99.5% | $6 |\",\n    \"| Business | $199 | 50 | 1 TB | Chat and email, 4 hours | 99.9% | $5 |\",\n    \"| Enterprise | Custom | Unlimited | Custom | Dedicated manager | 99.99% | Negotiated |\",\n    \"\",\n    \"Signups grew every week except week 3.\",\n  ].join(\"\\n\");\n  r.push(\"agent.message.delta\", { text }, t, 2_500);\n  r.push(\"agent.message.completed\", { text }, t, 300);\n  r.push(\"turn.completed\", { output: text }, t, 200);\n  return { id: \"media\", title: \"Tables & media\", events: r.events, running: false };\n}\n\n/** The assistant is still writing an interactive preview. */\nfunction previewing(): LabScenario {\n  const r = recorder(\"lab-previewing\");\n  const t = \"turn-previewing\";\n  r.push(\"user.message\", { text: \"Make me a quick chart of weekly signups.\" }, t);\n  r.push(\"turn.started\", {}, t, 400);\n  const partial = PREVIEW_FENCE_BODY.split(\"\\n\").slice(0, 5).join(\"\\n\");\n  r.push(\n    \"agent.message.delta\",\n    { text: [\"Here is the chart:\", \"\", \"```opengeni-html\", partial].join(\"\\n\") },\n    t,\n    2_000,\n  );\n  return { id: \"previewing\", title: \"Writing a preview\", events: r.events, running: true };\n}\n\nexport function labScenarios(): LabScenario[] {\n  return [\n    answer(),\n    working(),\n    needsYou(),\n    history(),\n    failure(),\n    longContent(),\n    media(),\n    previewing(),\n  ];\n}\n"],"mappings":"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","names":[]}

package/dist/timeline/activity-rail.d.ts

@@ -1,7 +1,10 @@
+import { type ReactNode } from "react";
 import type { RetainedArtifactLoader, RetainedScreenshotLoader, ToolRegistry } from "./registry.js";
-import type { ActivityItem } from "./types.js";
+import type { ActivityItem, AgentMessageItem } from "./types.js";
 export type ActivityRailProps = {
     items: ActivityItem[];
+    /** The owning turn remains active between individual phase receipts. */
+    startupActive?: boolean;
     /** Renderer registry for tool calls. Defaults to {@link defaultToolRegistry}. */
     toolRegistry?: ToolRegistry | undefined;
     /** Drill into a spawned worker session. */
@@ -19,4 +22,10 @@ export type ActivityRailProps = {
     bare?: boolean | undefined;
     className?: string | undefined;
 };
-export declare function ActivityRail({ items, toolRegistry, onOpenSession, onMemoryClick, loadRetainedScreenshot, loadRetainedArtifact, bare, className, }: ActivityRailProps): import("react").JSX.Element;
+export declare function ActivityRail({ items, startupActive, toolRegistry, onOpenSession, onMemoryClick, loadRetainedScreenshot, loadRetainedArtifact, bare, className, }: ActivityRailProps): import("react").JSX.Element;
+/**
+ * Host message renderer for progress notes inside a rail, so notes keep the
+ * host's links and formatting. Without one, notes render the library Markdown.
+ */
+export declare const ActivityNoteTextContext: import("react").Context<((text: string, item: AgentMessageItem) => ReactNode) | null>;
+export declare function renderActivity(item: ActivityItem, toolRegistry: ToolRegistry, onOpenSession: ((sessionId: string) => void) | undefined, onMemoryClick: ((memoryId: string) => void) | undefined, loadRetainedScreenshot: RetainedScreenshotLoader | undefined, loadRetainedArtifact: RetainedArtifactLoader | undefined): import("react").JSX.Element;

package/dist/timeline/agent-identity.d.ts

@@ -0,0 +1,30 @@
+import { type ReactNode } from "react";
+import type { TimelineItem } from "./types.js";
+/**
+ * Host lookup from a session id to its current display title. Return null or
+ * undefined when the session is unknown; the timeline then falls back to the
+ * title given at spawn time, then to generic copy.
+ */
+export type ResolveSessionTitle = (sessionId: string) => string | null | undefined;
+type AgentIdentity = {
+    /** The best known display title for an agent session, or null. */
+    titleFor: (sessionId: string | null | undefined) => string | null;
+    onOpenSession?: ((sessionId: string) => void) | undefined;
+};
+/** Typed routing coordinates only: a session reference is always a UUID. */
+export declare function isSessionId(value: string | null | undefined): value is string;
+/** One bounded display line, or null for an empty or non-string title. */
+export declare function displayAgentTitle(value: unknown): string | null;
+export declare function useAgentIdentity(): AgentIdentity;
+/**
+ * Names the agents a timeline talks to. The host resolver wins (it follows
+ * renames); otherwise the title the manager passed when spawning that session
+ * in this same timeline is used.
+ */
+export declare function AgentIdentityProvider({ items, resolveSessionTitle, onOpenSession, children, }: {
+    items: readonly TimelineItem[];
+    resolveSessionTitle?: ResolveSessionTitle | undefined;
+    onOpenSession?: ((sessionId: string) => void) | undefined;
+    children: ReactNode;
+}): import("react").JSX.Element;
+export {};

package/dist/timeline/agent-row.d.ts

@@ -0,0 +1,31 @@
+import { type ReactNode } from "react";
+import type { AgentTitleParts } from "./platform-activity-presentation.js";
+export type AgentRowProps = {
+    icon: ReactNode;
+    title: AgentTitleParts;
+    /** Quiet secondary text shown while collapsed. */
+    preview?: string | null | undefined;
+    /** Two lines suit inbound messages; spawns and messages use one. */
+    previewLines?: 1 | 2 | undefined;
+    /** Short trailing note after the title, e.g. "+2 earlier". */
+    meta?: string | null | undefined;
+    /** The agent session the row deep-links to. */
+    sessionId?: string | null | undefined;
+    onOpenSession?: ((sessionId: string) => void) | undefined;
+    running?: boolean | undefined;
+    failed?: boolean | undefined;
+    cancelled?: boolean | undefined;
+    /** Expanded body; the row is static when absent. */
+    children?: ReactNode | undefined;
+};
+export declare function AgentRow({ icon, title, preview, previewLines, meta, sessionId, onOpenSession, running, failed, cancelled, children, }: AgentRowProps): import("react").JSX.Element;
+/** Plain multi-line text for an expanded agent row. */
+export declare function AgentRowText({ children }: {
+    children: string;
+}): import("react").JSX.Element;
+/** A labelled section inside an expanded agent row (Brief, Report, Evidence). */
+export declare function AgentRowSection({ label, children, muted, }: {
+    label: string;
+    children: string;
+    muted?: boolean | undefined;
+}): import("react").JSX.Element;

package/dist/timeline/allowance-exhausted-row.d.ts

@@ -0,0 +1,24 @@
+import type { AllowanceExhaustedRefusal } from "@opengeni/sdk";
+import { type ReactNode } from "react";
+import { type AllowanceLabels } from "../usage/allowance-copy.js";
+/**
+ * Replace the built-in "usage limit reached" row. Return `undefined` to keep
+ * the default for this refusal (for example, only customize member limits).
+ */
+export type RenderAllowanceExhausted = (refusal: AllowanceExhaustedRefusal, context: {
+    labels: AllowanceLabels;
+    defaultRow: ReactNode;
+}) => ReactNode | undefined;
+export declare function AllowancePresentationProvider({ render, labels, children, }: {
+    render: RenderAllowanceExhausted | undefined;
+    labels: Partial<AllowanceLabels> | undefined;
+    children: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * A usage ceiling stopped further work. Calm by design: nothing failed, the
+ * conversation is kept, and the row says who can raise the limit and when it
+ * resets. Never the server's prose or a member identifier.
+ */
+export declare function AllowanceExhaustedRow({ refusal }: {
+    refusal: AllowanceExhaustedRefusal;
+}): import("react").JSX.Element;

package/dist/timeline/compaction-copy.d.ts

@@ -0,0 +1,46 @@
+import type { ContextCompactionItem } from "./types.js";
+/** Headline for a compaction that could not produce a checkpoint. */
+export declare const COMPACTION_FAILURE_TITLE = "Couldn\u2019t compact conversation history";
+/**
+ * Headline for a compaction cut short by its own attempt's cancellation (for
+ * example a worker restarting during a deploy). Not a failure: the recovered
+ * attempt checks again and compacts if the history still needs it.
+ */
+export declare const COMPACTION_INTERRUPTED_TITLE = "Compaction interrupted";
+/** Headline for a settled `skipped` compaction landmark. */
+export declare function compactionSkipTitle(reason: string | null): string;
+/** Why a definitive provider rejection repeats; shown behind Details. */
+export declare const COMPACTION_REJECTION_NOTE = "The provider rejects this request the same way until the conversation changes.";
+/**
+ * Subtitle for a settled compaction landmark. Kept short: a definitive provider
+ * rejection withholds the generic retry promise, names the one recovery step,
+ * and moves its identifiers behind Details ({@link compactionFailureDetails}).
+ */
+export declare function compactionSkipSubtitle(reason: string | null, providerRejection?: ContextCompactionItem["providerRejection"]): string;
+export type CompactionFailureDetails = {
+    /** One plain sentence on why it failed, when known. */
+    note: string | null;
+    /** Provider identifiers or the recorded error text, in display order. */
+    facts: Array<{
+        label: string;
+        value: string;
+    }>;
+};
+/**
+ * Technical diagnostics for a failed compaction landmark, or null when it has
+ * none: a definitive provider rejection lists its content-free identifiers;
+ * any other failure shows the turn's recorded error text. Presentation only.
+ */
+export declare function compactionFailureDetails(item: Pick<ContextCompactionItem, "phase" | "skipReason" | "providerRejection" | "failureDetail">): CompactionFailureDetails | null;
+/**
+ * Short chip copy for a turn's failure reason. A compaction failure records the
+ * raw provider text after a fixed prefix; the chip names the outcome instead
+ * and keeps the recorded text as `detail` (a hover title). Every other reason
+ * passes through unchanged.
+ */
+export declare function presentTurnFailureText(failureText: string | null | undefined): {
+    summary: string;
+    detail?: string;
+} | null;
+/** `HTTP 400 invalid_request_error, param input[3].encrypted_content`; identifiers only. */
+export declare function describeCompactionProviderRejection(rejection: NonNullable<ContextCompactionItem["providerRejection"]>): string;

package/dist/timeline/entrance.d.ts

@@ -1,4 +1,16 @@
-export declare const EntranceAnimationProvider: import("react").Provider<boolean>;
+import { type ReactNode } from "react";
+/**
+ * Freeze the mount-time gate for this subtree while publishing a separate live
+ * gate to activity rails that need later appends to animate after a bulk paint.
+ * MessageTimeline mounts one provider per durable group, so existing groups do
+ * not receive a context invalidation when a prepend toggles bulk mode and new
+ * groups still capture the value from the commit that created them.
+ */
+export declare function EntranceAnimationProvider({ value, liveValue, children, }: {
+    value: boolean;
+    liveValue?: boolean | undefined;
+    children: ReactNode;
+}): import("react").JSX.Element;
 /**
  * Live entrance gate from the nearest provider. Prefer
  * {@link useEntranceAnimation} for elements that must freeze the decision at

package/dist/timeline/focus-sequence.d.ts

@@ -0,0 +1,9 @@
+import type { TimelineGroup } from "./types.js";
+/** Every durable event sequence a group renders, nested work included. */
+export declare function timelineGroupSequences(group: TimelineGroup): number[];
+/**
+ * The index of the group to land on for `sequence`: the group that holds it,
+ * else the last group that starts before it. -1 when every loaded group is
+ * later (the moment is in older history) or nothing is loaded.
+ */
+export declare function timelineGroupIndexAtSequence(groups: readonly TimelineGroup[], sequence: number): number;

package/dist/timeline/genie-copy.d.ts

@@ -0,0 +1,3 @@
+/** Decorative loading copy shared by every renderer of the preparing state. */
+export declare const GENIE_PREPARING_PHRASES: readonly string[];
+export declare const GENIE_WAITING_PHRASES: readonly string[];

package/dist/timeline/genie-loading.d.ts

@@ -0,0 +1,47 @@
+import { type ReactNode } from "react";
+export type GenieLoadingRenderProps = {
+    startedAt: string;
+    phase: "preparing" | "waiting";
+    detailsOpen: boolean;
+    onShowDetails: () => void;
+};
+export type GenieLoadingOptions = {
+    /** Replace the visual while preserving SDK loading visibility and transitions. */
+    render?: (props: GenieLoadingRenderProps) => ReactNode;
+    phrases?: readonly string[];
+    /** Native copy overrides. Omitted messages retain the default English copy. */
+    messages?: {
+        status?: string;
+        slowStatus?: string;
+        slowText?: string;
+        showDetails?: string;
+        hideDetails?: string;
+    };
+    /** Public adapter options; the renderer dependency's declarations stay private. */
+    orb?: {
+        state?: "working" | "searching" | "solving" | "listening" | "connecting" | "weaving" | "composing" | "breathing" | "shaping";
+        size?: 64 | 20;
+        speed?: number;
+    };
+};
+export declare const GenieLoadingOptionsContext: import("react").Context<GenieLoadingOptions | undefined>;
+/**
+ * Neutral defaults for conversations embedded in another product
+ * (`SessionConversation`, `OpenGeniChat`), which should not carry Opengeni's
+ * own playful copy. The Opengeni app keeps the defaults above.
+ */
+export declare const EMBEDDED_GENIE_LOADING: {
+    readonly phrases: readonly ["Thinking…"];
+    readonly messages: {
+        readonly showDetails: "Show details";
+    };
+};
+/** Decorative copy never substitutes for a failure or claims measurable progress. */
+export declare function GenieLoading({ startedAt, phase, onShowDetails, detailsOpen, notice, }: {
+    startedAt: string;
+    phase?: GenieLoadingRenderProps["phase"];
+    onShowDetails: () => void;
+    detailsOpen?: boolean;
+    /** An actionable startup problem takes precedence over decorative copy. */
+    notice?: string | undefined;
+}): string | number | bigint | boolean | import("react").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | import("react").ReactPortal | null | undefined> | null | undefined;