yaml-flow 8.2.5 → 8.3.0

package/examples/board/test/server-http-test.js

@@ -13,12 +13,17 @@
  *   node test/server-http-test.js [--port 7799]
  */
 
-import { spawn } from 'node:child_process';
+import { spawn, spawnSync } from 'node:child_process';
 import { Worker } from 'node:worker_threads';
 import { fileURLToPath } from 'node:url';
 import path from 'node:path';
 import http from 'node:http';
+import net from 'node:net';
 import fs from 'node:fs';
+import os from 'node:os';
+
+const ECHO_PROBE_MARKER = '__probe__echo__probe__';
+const PROBE_IN_PROGRESS_TEXT = 'in-progress';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
@@ -26,6 +31,18 @@ const __dirname = path.dirname(__filename);
 const cliArgs = process.argv.slice(2);
 const portArg = cliArgs.indexOf('--port');
 const cliPort = portArg !== -1 ? parseInt(cliArgs[portArg + 1], 10) : NaN;
+const skipT1 = cliArgs.includes('--skip-t1');
+const skipT2 = cliArgs.includes('--skip-t2');
+const skipT3 = cliArgs.includes('--skip-t3');
+function isCopilotAvailable() {
+  try {
+    const r = spawnSync('copilot', ['--version'], { timeout: 5_000, stdio: 'ignore', windowsHide: true });
+    return !r.error;
+  } catch { return false; }
+}
+
+const skipT3a = cliArgs.includes('--skip-t3a') || !isCopilotAvailable();
+const skipT3b = cliArgs.includes('--skip-t3b');
 const RUN_ID = `run-${Date.now()}-${process.pid}-${Math.random().toString(36).slice(2, 8)}`;
 
 const BOARD_ID = 'live';
@@ -35,34 +52,28 @@ const SSE_WORKER_SCRIPT = path.join(__dirname, 'sse-worker.js');
 const CARD_PATTERN = 'cardT*';
 const CHAT_CARD_ID = 'card-portfolio';
 
-function resolveServerPort() {
+function findFreePort() {
+  return new Promise((resolve, reject) => {
+    const srv = net.createServer();
+    srv.listen(0, '127.0.0.1', () => {
+      const addr = /** @type {import('node:net').AddressInfo} */ (srv.address());
+      srv.close(() => resolve(addr.port));
+    });
+    srv.on('error', reject);
+  });
+}
+
+async function resolveServerPort() {
   if (Number.isInteger(cliPort) && cliPort > 0) return cliPort;
-  const configPath = path.join(BOARD_DIR, 'server-config.json');
-  try {
-    const cfg = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-    const configured = Number(cfg?.port);
-    if (Number.isInteger(configured) && configured > 0) return configured;
-  } catch { /* ignore */ }
-  return 7799;
+  return findFreePort();
 }
 
-const PORT = resolveServerPort();
+const PORT = await resolveServerPort();
 const BASE = `http://127.0.0.1:${PORT}/api/boards/${BOARD_ID}`;
 
-// Resolve and wipe the setup directory so each test run starts clean.
+// Always use a system temp directory so parallel runs and vitest don't collide.
 function resolveSetupDirRoot() {
-  const configPath = path.join(BOARD_DIR, 'server-config.json');
-  try {
-    const cfg = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-    const boardSetupDir = cfg?.boards?.[BOARD_ID]?.setupDir;
-    if (typeof boardSetupDir === 'string' && boardSetupDir.trim()) {
-      return path.resolve(BOARD_DIR, boardSetupDir.trim());
-    }
-    if (cfg && typeof cfg.setupDir === 'string' && cfg.setupDir.trim()) {
-      return path.resolve(BOARD_DIR, cfg.setupDir.trim());
-    }
-  } catch { /* ignore */ }
-  return path.join(BOARD_DIR, '.demo-setup');
+  return os.tmpdir();
 }
 
 const SETUP_DIR = path.join(resolveSetupDirRoot(), RUN_ID);
@@ -220,6 +231,49 @@ const waitForAllCompleted = (ms = 60_000, label = 'all completed') =>
 const waitForChatPredicate = (predicate, ms, label) =>
   waitUntil(() => predicate(NS.chatEvents) || false, ms, label);
 
+function deriveProbeLifecycleMilestones(events, opts) {
+  const milestones = [];
+  let prevMessageCount = Number(opts.beforeCount || 0);
+  let prevProcessing = Boolean(opts.beforeProcessing);
+  const prompt = String(opts.prompt || '');
+  const inProgressText = String(opts.inProgressText || PROBE_IN_PROGRESS_TEXT);
+
+  for (const event of events) {
+    const messages = Array.isArray(event?.messages) ? event.messages : [];
+    const nextMessageCount = Number(event?.messageCount || messages.length || 0);
+    const newMessages = nextMessageCount > prevMessageCount
+      ? messages.slice(prevMessageCount, nextMessageCount)
+      : [];
+
+    for (const message of newMessages) {
+      const role = String(message?.role || '');
+      const text = String(message?.text || '');
+      if (role === 'user' && text.includes(prompt)) milestones.push('user');
+      else if (role === 'system' && text.trim().toLowerCase() === inProgressText) milestones.push('in-progress');
+      else if (role === 'assistant' && text.includes(`Echo: ${prompt}`)) milestones.push('assistant');
+    }
+
+    const processing = Boolean(event?.processing);
+    if (processing !== prevProcessing) milestones.push(processing ? 'processing-true' : 'processing-false');
+
+    prevMessageCount = nextMessageCount;
+    prevProcessing = processing;
+  }
+
+  return milestones;
+}
+
+function matchOrderedProbeLifecycle(events, opts) {
+  const milestones = deriveProbeLifecycleMilestones(events, opts);
+  if (milestones.length !== 5) return false;
+  const firstPair = milestones.slice(0, 2);
+  const lastPair = milestones.slice(3, 5);
+  const firstOk = firstPair.includes('user') && firstPair.includes('processing-true');
+  const middleOk = milestones[2] === 'in-progress';
+  const lastOk = lastPair.includes('assistant') && lastPair.includes('processing-false');
+  return (firstOk && middleOk && lastOk) ? { milestones } : false;
+}
+
 function httpGet(url) {
   return new Promise((resolve, reject) => {
     http.get(url, (res) => {
@@ -402,7 +456,10 @@ try {
   console.log(`[T0] ok: ${t0Positions.length} positions computed`);
 
   // ── T1: PATCH holdings (+1 row), verify recomputation ──
-  console.log('\n=== T1: patch holdings (+1 row) ===');
+  if (skipT1) {
+    console.log('\n=== T1: skipped (--skip-t1) ===');
+  } else {
+    console.log('\n=== T1: patch holdings (+1 row) ===');
 
   // Read current holdings from card store
   const portfolioCardRes = await httpGet(`${BASE}/cards/card-portfolio`);
@@ -446,49 +503,57 @@ try {
     `Expected positions rows +1 (before=${t0PositionsCount}, after=${afterPositionsCount})`);
   console.log(`[T1] ok: holdings ${t0HoldingsCount}->${afterHoldingsCount}, ` +
     `positions ${t0PositionsCount}->${afterPositionsCount}, added=${newTicker}`);
+  }
 
   // ── T2: plain file upload API + card_data.files + download roundtrip ──
-  console.log('\n=== T2: plain file upload -> card_data.files -> download ===');
-  const t2CardBefore = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}`);
-  assert(t2CardBefore.status === 200, `T2 pre card read returned ${t2CardBefore.status}`);
-  const t2FilesBefore = Array.isArray(t2CardBefore.data?.card_data?.files)
-    ? t2CardBefore.data.card_data.files
-    : [];
-  const t2BeforeCount = t2FilesBefore.length;
-
-  const t2UploadText = `plain-file-upload-${Date.now()}`;
-  const t2UploadName = 't2-upload.txt';
-  const t2UploadRes = await httpUploadChatFile(
-    `${BASE}/cards/${CHAT_CARD_ID}/files`,
-    t2UploadName,
-    t2UploadText,
-  );
-  assert(t2UploadRes.status === 200, `T2 file upload returned ${t2UploadRes.status}`);
-  const t2UploadedFile = t2UploadRes.data?.file;
-  assert(t2UploadedFile && typeof t2UploadedFile === 'object', 'T2 upload response missing file metadata');
-  assert(String(t2UploadedFile?.name || '') === t2UploadName, 'T2 uploaded file name mismatch');
-
-  const t2CardAfter = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}`);
-  assert(t2CardAfter.status === 200, `T2 post card read returned ${t2CardAfter.status}`);
-  const t2FilesAfter = Array.isArray(t2CardAfter.data?.card_data?.files)
-    ? t2CardAfter.data.card_data.files
-    : [];
-  assert(t2FilesAfter.length === t2BeforeCount + 1, `T2 expected files +1 (before=${t2BeforeCount}, after=${t2FilesAfter.length})`);
-
-  const t2FileIndex = t2FilesAfter.findIndex((f) => String(f?.stored_name || '') === String(t2UploadedFile?.stored_name || ''));
-  assert(t2FileIndex >= 0, 'T2 uploaded file metadata not found in card_data.files');
-
-  const t2DownloadRes = await httpGetRaw(
-    `${BASE}/cards/${CHAT_CARD_ID}/files/${t2FileIndex}?sn=${encodeURIComponent(String(t2UploadedFile?.stored_name || ''))}`,
-  );
-  assert(t2DownloadRes.status === 200, `T2 file download returned ${t2DownloadRes.status}`);
-  const t2DownloadedText = t2DownloadRes.body.toString('utf-8');
-  assert(t2DownloadedText === t2UploadText, 'T2 downloaded content mismatch');
-  console.log('[T2] ok: card_data.files updated and file download endpoint returned exact bytes');
+  if (skipT2) {
+    console.log('\n=== T2: skipped (--skip-t2) ===');
+  } else {
+    console.log('\n=== T2: plain file upload -> card_data.files -> download ===');
+    const t2CardBefore = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}`);
+    assert(t2CardBefore.status === 200, `T2 pre card read returned ${t2CardBefore.status}`);
+    const t2FilesBefore = Array.isArray(t2CardBefore.data?.card_data?.files)
+      ? t2CardBefore.data.card_data.files
+      : [];
+    const t2BeforeCount = t2FilesBefore.length;
+
+    const t2UploadText = `plain-file-upload-${Date.now()}`;
+    const t2UploadName = 't2-upload.txt';
+    const t2UploadRes = await httpUploadChatFile(
+      `${BASE}/cards/${CHAT_CARD_ID}/files`,
+      t2UploadName,
+      t2UploadText,
+    );
+    assert(t2UploadRes.status === 200, `T2 file upload returned ${t2UploadRes.status}`);
+    const t2UploadedFile = t2UploadRes.data?.file;
+    assert(t2UploadedFile && typeof t2UploadedFile === 'object', 'T2 upload response missing file metadata');
+    assert(String(t2UploadedFile?.name || '') === t2UploadName, 'T2 uploaded file name mismatch');
+
+    const t2CardAfter = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}`);
+    assert(t2CardAfter.status === 200, `T2 post card read returned ${t2CardAfter.status}`);
+    const t2FilesAfter = Array.isArray(t2CardAfter.data?.card_data?.files)
+      ? t2CardAfter.data.card_data.files
+      : [];
+    assert(t2FilesAfter.length === t2BeforeCount + 1, `T2 expected files +1 (before=${t2BeforeCount}, after=${t2FilesAfter.length})`);
+
+    const t2FileIndex = t2FilesAfter.findIndex((f) => String(f?.stored_name || '') === String(t2UploadedFile?.stored_name || ''));
+    assert(t2FileIndex >= 0, 'T2 uploaded file metadata not found in card_data.files');
+
+    const t2DownloadRes = await httpGetRaw(
+      `${BASE}/cards/${CHAT_CARD_ID}/files/${t2FileIndex}?sn=${encodeURIComponent(String(t2UploadedFile?.stored_name || ''))}`,
+    );
+    assert(t2DownloadRes.status === 200, `T2 file download returned ${t2DownloadRes.status}`);
+    const t2DownloadedText = t2DownloadRes.body.toString('utf-8');
+    assert(t2DownloadedText === t2UploadText, 'T2 downloaded content mismatch');
+    console.log('[T2] ok: card_data.files updated and file download endpoint returned exact bytes');
+  }
 
   // ── T3*: chat protocol over API + SSE ──
   {
-    console.log('\n=== T3: probe chat protocol (SSE lifecycle) ===');
+    if (skipT3) {
+      console.log('\n=== T3: skipped (--skip-t3) ===');
+    } else {
+    console.log(`\n[${new Date().toISOString()}] === T3: probe chat protocol (SSE lifecycle) ===`);
   chatSseClientId = `chat-proto-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
   chatSseClient = startSseClient(`${BASE}/sse?clientId=${encodeURIComponent(chatSseClientId)}`, (payload) => {
     captureChatEvents(payload, CHAT_CARD_ID);
@@ -502,189 +567,156 @@ try {
   assert(t2Before.status === 200, `T3 pre chats returned ${t2Before.status}`);
   const t2BeforeMessages = Array.isArray(t2Before.data?.messages) ? t2Before.data.messages : [];
   const t2BeforeCount = t2BeforeMessages.length;
+  const t2EventStart = NS.chatEvents.length;
   const t2ProbePrompt = `Probe protocol validation ${Date.now()}`;
 
   const t2SendRes = await httpJson('POST', `${BASE}/cards/${CHAT_CARD_ID}/actions`, {
     actionType: 'chat-send',
     payload: {
-      text: JSON.stringify({
-        prompt: t2ProbePrompt,
-        probe: true,
-        chatTimeMs: 2200,
-        chatTimeoutMs: 20000,
-      }),
+      text: `${ECHO_PROBE_MARKER}${t2ProbePrompt}${ECHO_PROBE_MARKER}`,
     },
   });
   assert(t2SendRes.status === 200, `T3 chat-send returned ${t2SendRes.status}`);
 
-  const t2UserOrProcessing = await waitForChatPredicate((events) => {
-    const slice = events.filter((e) => e.messageCount >= t2BeforeCount + 1 || e.processing === true);
-    return slice.length > 0 ? slice[slice.length - 1] : false;
-  }, 30_000, 'T3 user/proc signal');
-  assert(!!t2UserOrProcessing, 'T3 missing user/proc signal');
-
-  const t2Assistant = await waitForChatPredicate((events) => {
-    for (let i = events.length - 1; i >= 0; i -= 1) {
-      const e = events[i];
-      if (e.messageCount < t2BeforeCount + 2) continue;
-      const last = e.messages[e.messages.length - 1];
-      if (last?.role === 'assistant' && String(last.text || '').includes(`Echo: ${t2ProbePrompt}`)) {
-        return e;
-      }
-    }
-    return false;
-  }, 45_000, 'T3 assistant echo');
-  assert(!!t2Assistant, 'T3 assistant echo not observed on SSE');
-
-  const t2ProcessingCleared = await waitForChatPredicate((events) => {
-    for (let i = events.length - 1; i >= 0; i -= 1) {
-      const e = events[i];
-      if (e.messageCount >= t2BeforeCount + 2 && e.processing === false) return e;
-    }
-    return false;
-  }, 30_000, 'T3 processing clear');
-  assert(!!t2ProcessingCleared, 'T3 processing clear not observed');
+  const t2Lifecycle = await waitForChatPredicate((events) => {
+    return matchOrderedProbeLifecycle(events.slice(t2EventStart), {
+      beforeCount: t2BeforeCount,
+      beforeProcessing: false,
+      prompt: t2ProbePrompt,
+      inProgressText: PROBE_IN_PROGRESS_TEXT,
+    });
+  }, 45_000, 'T3 ordered lifecycle');
+  assert(!!t2Lifecycle, 'T3 ordered lifecycle not observed');
 
   const t2After = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats`);
   assert(t2After.status === 200, `T3 post chats returned ${t2After.status}`);
   const t2AfterMessages = Array.isArray(t2After.data?.messages) ? t2After.data.messages : [];
   const t2NewMessages = t2AfterMessages.slice(t2BeforeCount);
-  assert(t2NewMessages.length >= 2, `T3 expected at least 2 new chat messages, got ${t2NewMessages.length}`);
+  assert(t2NewMessages.length >= 3, `T3 expected at least 3 new chat messages, got ${t2NewMessages.length}`);
   const t2User = t2NewMessages.find((m) => m?.role === 'user');
+  const t2InProgress = t2NewMessages.find((m) => m?.role === 'system' && String(m?.text || '').trim().toLowerCase() === PROBE_IN_PROGRESS_TEXT);
   const t2AssistantMsg = t2NewMessages.find((m) => m?.role === 'assistant');
   assert(!!t2User && typeof t2User.id === 'string', 'T3 user chat message missing id');
   assert(String(t2User?.text || '').includes(t2ProbePrompt), 'T3 user file text mismatch');
+  assert(!!t2InProgress && typeof t2InProgress.id === 'string', 'T3 in-progress system message missing id');
   assert(!!t2AssistantMsg && typeof t2AssistantMsg.id === 'string', 'T3 assistant chat message missing id');
   assert(String(t2AssistantMsg?.text || '').includes(`Echo: ${t2ProbePrompt}`), 'T3 assistant echo file content mismatch');
-  console.log('[T3] ok: probe lifecycle observed (processing/user any-order, assistant write, processing clear)');
+  console.log(`[${new Date().toISOString()}] [T3] ok: ordered probe lifecycle observed (user+processing, in-progress, assistant+processing clear)`);
+    }
 
-  /*
   // ── T3a: non-probe chat protocol over API + SSE ──
-  // Disabled in the public example — requires a configured Azure Foundry
-  // endpoint and agent_id in server-config.json.
-  console.log('\n=== T3a: non-probe chat protocol (expect paris) ===');
-  const t2aBefore = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats`);
-  assert(t2aBefore.status === 200, `T3a pre chats returned ${t2aBefore.status}`);
-  const t2aBeforeMessages = Array.isArray(t2aBefore.data?.messages) ? t2aBefore.data.messages : [];
-  const t2aBeforeCount = t2aBeforeMessages.length;
-  const t2aPrompt = 'Just answer what is the capital of France. No Fluff. No COmmentary.  No Markup Respond in lower case in one word.';
-
-  const t2aSendRes = await httpJson('POST', `${BASE}/cards/${CHAT_CARD_ID}/actions`, {
-    actionType: 'chat-send',
-    payload: {
-      text: JSON.stringify({
-        prompt: t2aPrompt,
-        chatTimeoutMs: 180000,
-      }),
-    },
-  });
-  assert(t2aSendRes.status === 200, `T3a chat-send returned ${t2aSendRes.status}`);
-
-  const t2aAssistant = await waitForChatPredicate((events) => {
-    for (let i = events.length - 1; i >= 0; i -= 1) {
-      const e = events[i];
-      if (e.messageCount < t2aBeforeCount + 2) continue;
-      const last = e.messages[e.messages.length - 1];
-      if (last?.role === 'assistant' && /paris/i.test(String(last.text || ''))) return e;
-    }
-    return false;
-  }, 240_000, 'T3a assistant response with paris');
-  assert(!!t2aAssistant, 'T3a assistant response with paris not observed on SSE');
-
-  const t2aAfter = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats`);
-  assert(t2aAfter.status === 200, `T3a post chats returned ${t2aAfter.status}`);
-  const t2aAfterMessages = Array.isArray(t2aAfter.data?.messages) ? t2aAfter.data.messages : [];
-  const t2aNewMessages = t2aAfterMessages.slice(t2aBeforeCount);
-  assert(t2aNewMessages.length >= 2, `T3a expected at least 2 new chat messages, got ${t2aNewMessages.length}`);
-  const t2aAssistantMsg = [...t2aNewMessages].reverse().find((m) => m?.role === 'assistant');
-  assert(!!t2aAssistantMsg && typeof t2aAssistantMsg.id === 'string', 'T3a assistant chat message missing id');
-  assert(/paris/i.test(String(t2aAssistantMsg?.text || '')), 'T3a assistant file content missing paris');
-  console.log('[T3a] ok: non-probe response contains paris');
-  */
+  // Disabled in the public example unless explicitly requested — requires a
+  // configured Azure Foundry endpoint and agent_id in server-config.json.
+  if (skipT3a) {
+    console.log('\n=== T3a: skipped (--skip-t3a) ===');
+  } else {
+    console.log('\n=== T3a: non-probe chat protocol (expect paris) ===');
+    const t2aBefore = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats`);
+    assert(t2aBefore.status === 200, `T3a pre chats returned ${t2aBefore.status}`);
+    const t2aBeforeMessages = Array.isArray(t2aBefore.data?.messages) ? t2aBefore.data.messages : [];
+    const t2aBeforeCount = t2aBeforeMessages.length;
+    const t2aPrompt = 'Just answer what is the capital of France. No Fluff. No COmmentary.  No Markup Respond in lower case in one word.';
+
+    const t2aSendRes = await httpJson('POST', `${BASE}/cards/${CHAT_CARD_ID}/actions`, {
+      actionType: 'chat-send',
+      payload: {
+        text: JSON.stringify({
+          prompt: t2aPrompt,
+          chatTimeoutMs: 180000,
+        }),
+      },
+    });
+    assert(t2aSendRes.status === 200, `T3a chat-send returned ${t2aSendRes.status}`);
+
+    const t2aAssistant = await waitForChatPredicate((events) => {
+      for (let i = events.length - 1; i >= 0; i -= 1) {
+        const e = events[i];
+        if (e.messageCount < t2aBeforeCount + 2) continue;
+        const last = e.messages[e.messages.length - 1];
+        if (last?.role === 'assistant' && /paris/i.test(String(last.text || ''))) return e;
+      }
+      return false;
+    }, 240_000, 'T3a assistant response with paris');
+    assert(!!t2aAssistant, 'T3a assistant response with paris not observed on SSE');
+
+    const t2aAfter = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats`);
+    assert(t2aAfter.status === 200, `T3a post chats returned ${t2aAfter.status}`);
+    const t2aAfterMessages = Array.isArray(t2aAfter.data?.messages) ? t2aAfter.data.messages : [];
+    const t2aNewMessages = t2aAfterMessages.slice(t2aBeforeCount);
+    assert(t2aNewMessages.length >= 2, `T3a expected at least 2 new chat messages, got ${t2aNewMessages.length}`);
+    const t2aAssistantMsg = [...t2aNewMessages].reverse().find((m) => m?.role === 'assistant');
+    assert(!!t2aAssistantMsg && typeof t2aAssistantMsg.id === 'string', 'T3a assistant chat message missing id');
+    assert(/paris/i.test(String(t2aAssistantMsg?.text || '')), 'T3a assistant file content missing paris');
+    console.log('[T3a] ok: non-probe response contains paris');
+  }
 
   // ── T3b: probe-echo chat + file upload protocol over API + SSE ──
-  console.log('\n=== T3b: probe-echo chat with file upload protocol ===');
-  const t2bBefore = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats`);
-  assert(t2bBefore.status === 200, `T3b pre chats returned ${t2bBefore.status}`);
-  const t2bBeforeMessages = Array.isArray(t2bBefore.data?.messages) ? t2bBefore.data.messages : [];
-  const t2bBeforeCount = t2bBeforeMessages.length;
-
-  const t2bUploadRes = await httpUploadChatFile(
-    `${BASE}/cards/${CHAT_CARD_ID}/files?inChat=true`,
-    'q1.txt',
-    'what is the capital of japan',
-  );
-  assert(t2bUploadRes.status === 200, `T3b file upload returned ${t2bUploadRes.status}`);
-  const uploadedFile = t2bUploadRes.data?.file;
-  assert(uploadedFile && typeof uploadedFile === 'object', 'T3b upload response missing file metadata');
-
-  const t2bAfterUpload = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats`);
-  assert(t2bAfterUpload.status === 200, `T3b chats after upload returned ${t2bAfterUpload.status}`);
-  const t2bUploadMessages = Array.isArray(t2bAfterUpload.data?.messages) ? t2bAfterUpload.data.messages : [];
-  const t2bUploadNewMessages = t2bUploadMessages.slice(t2bBeforeCount);
-  const t2bUploadSystem = t2bUploadNewMessages.find((m) => m?.role === 'system');
-  assert(!!t2bUploadSystem, 'T3b upload protocol missing system chat file');
-  assert(String(t2bUploadSystem?.text || '').toLowerCase().includes('file uploaded:'), 'T3b upload system message does not describe uploaded file');
-
-  const t2bSendBaseline = t2bUploadMessages.length;
-
-  const t2bPrompt = `probe echo file-upload validation ${Date.now()}`;
-  const t2bSendRes = await httpJson('POST', `${BASE}/cards/${CHAT_CARD_ID}/actions`, {
-    actionType: 'chat-send',
-    payload: {
-      text: JSON.stringify({
-        prompt: t2bPrompt,
-        probe: true,
-        chatTimeMs: 2200,
-      }),
-      files: [uploadedFile],
-    },
-  });
-  assert(t2bSendRes.status === 200, `T3b chat-send returned ${t2bSendRes.status}`);
+  if (skipT3b) {
+    console.log('\n=== T3b: skipped (--skip-t3b) ===');
+  } else {
+    console.log('\n=== T3b: probe-echo chat with file upload protocol ===');
+    const t2bBefore = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats`);
+    assert(t2bBefore.status === 200, `T3b pre chats returned ${t2bBefore.status}`);
+    const t2bBeforeMessages = Array.isArray(t2bBefore.data?.messages) ? t2bBefore.data.messages : [];
+    const t2bBeforeCount = t2bBeforeMessages.length;
+
+    const t2bUploadRes = await httpUploadChatFile(
+      `${BASE}/cards/${CHAT_CARD_ID}/files?inChat=true`,
+      'q1.txt',
+      'what is the capital of japan',
+    );
+    assert(t2bUploadRes.status === 200, `T3b file upload returned ${t2bUploadRes.status}`);
+    const uploadedFile = t2bUploadRes.data?.file;
+    assert(uploadedFile && typeof uploadedFile === 'object', 'T3b upload response missing file metadata');
+
+    const t2bAfterUpload = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats`);
+    assert(t2bAfterUpload.status === 200, `T3b chats after upload returned ${t2bAfterUpload.status}`);
+    const t2bUploadMessages = Array.isArray(t2bAfterUpload.data?.messages) ? t2bAfterUpload.data.messages : [];
+    const t2bUploadNewMessages = t2bUploadMessages.slice(t2bBeforeCount);
+    const t2bUploadSystem = t2bUploadNewMessages.find((m) => m?.role === 'system');
+    assert(!!t2bUploadSystem, 'T3b upload protocol missing system chat file');
+    assert(String(t2bUploadSystem?.text || '').toLowerCase().includes('file uploaded:'), 'T3b upload system message does not describe uploaded file');
+
+    const t2bSendBaseline = t2bUploadMessages.length;
+    const t2bEventStart = NS.chatEvents.length;
+
+    const t2bPrompt = `probe echo file-upload validation ${Date.now()}`;
+    const t2bSendRes = await httpJson('POST', `${BASE}/cards/${CHAT_CARD_ID}/actions`, {
+      actionType: 'chat-send',
+      payload: {
+        text: `${ECHO_PROBE_MARKER}${t2bPrompt}${ECHO_PROBE_MARKER}`,
+        files: [uploadedFile],
+      },
+    });
+    assert(t2bSendRes.status === 200, `T3b chat-send returned ${t2bSendRes.status}`);
 
-  const t2bUserOrProcessing = await waitForChatPredicate((events) => {
-    for (let i = events.length - 1; i >= 0; i -= 1) {
-      const e = events[i];
-      if (e.messageCount >= t2bSendBaseline + 1 || e.processing === true) return e;
-    }
-    return false;
-  }, 45_000, 'T3b user/proc signal');
-  assert(!!t2bUserOrProcessing, 'T3b user/proc signal not observed');
-
-  const t2bAssistantOnSse = await waitForChatPredicate((events) => {
-    for (let i = events.length - 1; i >= 0; i -= 1) {
-      const e = events[i];
-      if (e.messageCount < t2bSendBaseline + 2) continue;
-      const last = e.messages[e.messages.length - 1];
-      if (last?.role === 'assistant' && String(last.text || '').includes(`Echo: ${t2bPrompt}`)) return e;
-    }
-    return false;
-  }, 60_000, 'T3b assistant response');
-  assert(!!t2bAssistantOnSse, 'T3b assistant response not observed on SSE');
-
-  const t2bAfter = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats`);
-  assert(t2bAfter.status === 200, `T3b post chats returned ${t2bAfter.status}`);
-  const t2bAfterMessages = Array.isArray(t2bAfter.data?.messages) ? t2bAfter.data.messages : [];
-  const t2bNewMessages = t2bAfterMessages.slice(t2bSendBaseline);
-  assert(t2bNewMessages.length >= 2, `T3b expected at least 2 chat messages after send, got ${t2bNewMessages.length}`);
-
-  const t2bUser = t2bNewMessages.find((m) => m?.role === 'user');
-  const t2bAssistantMsg = t2bNewMessages.find((m) => m?.role === 'assistant');
-
-  assert(!!t2bUser && typeof t2bUser.id === 'string', 'T3b missing user chat message notification');
-  assert(!!t2bAssistantMsg && typeof t2bAssistantMsg.id === 'string', 'T3b missing assistant chat message notification');
-  assert(Array.isArray(t2bUser?.files) && t2bUser.files.length === 1, 'T3b user chat message missing uploaded file metadata');
-  assert(String(t2bAssistantMsg?.text || '').includes(`Echo: ${t2bPrompt}`), 'T3b assistant file content mismatch');
-
-  const t2bProcessingCleared = await waitForChatPredicate((events) => {
-    for (let i = events.length - 1; i >= 0; i -= 1) {
-      const e = events[i];
-      if (e.messageCount >= t2bSendBaseline + 2 && e.processing === false) return e;
-    }
-    return false;
-  }, 30_000, 'T3b processing clear');
-  assert(!!t2bProcessingCleared, 'T3b processing clear not observed');
-  console.log('[T3b] ok: upload protocol (system/user) and chat protocol (.processing/user/assistant/.processing clear) observed');
+    const t2bLifecycle = await waitForChatPredicate((events) => {
+      return matchOrderedProbeLifecycle(events.slice(t2bEventStart), {
+        beforeCount: t2bSendBaseline,
+        beforeProcessing: false,
+        prompt: t2bPrompt,
+        inProgressText: PROBE_IN_PROGRESS_TEXT,
+      });
+    }, 60_000, 'T3b ordered lifecycle');
+    assert(!!t2bLifecycle, 'T3b ordered lifecycle not observed');
+
+    const t2bAfter = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats`);
+    assert(t2bAfter.status === 200, `T3b post chats returned ${t2bAfter.status}`);
+    const t2bAfterMessages = Array.isArray(t2bAfter.data?.messages) ? t2bAfter.data.messages : [];
+    const t2bNewMessages = t2bAfterMessages.slice(t2bSendBaseline);
+    assert(t2bNewMessages.length >= 3, `T3b expected at least 3 chat messages after send, got ${t2bNewMessages.length}`);
+
+    const t2bUser = t2bNewMessages.find((m) => m?.role === 'user');
+    const t2bInProgress = t2bNewMessages.find((m) => m?.role === 'system' && String(m?.text || '').trim().toLowerCase() === PROBE_IN_PROGRESS_TEXT);
+    const t2bAssistantMsg = t2bNewMessages.find((m) => m?.role === 'assistant');
+
+    assert(!!t2bUser && typeof t2bUser.id === 'string', 'T3b missing user chat message notification');
+    assert(!!t2bInProgress && typeof t2bInProgress.id === 'string', 'T3b missing in-progress system chat message');
+    assert(!!t2bAssistantMsg && typeof t2bAssistantMsg.id === 'string', 'T3b missing assistant chat message notification');
+    assert(Array.isArray(t2bUser?.files) && t2bUser.files.length === 1, 'T3b user chat message missing uploaded file metadata');
+    assert(String(t2bAssistantMsg?.text || '').includes(`Echo: ${t2bPrompt}`), 'T3b assistant file content mismatch');
+    console.log('[T3b] ok: upload protocol and ordered probe lifecycle observed (user+processing, in-progress, assistant+processing clear)');
+  }
   }
 
   console.log('\n=== All smoke checks passed ===\n');

package/examples/board-local/demo-shell-localstorage.html

@@ -6,13 +6,13 @@
   <title>Example Board Demo (LocalStorage Runtime)</title>
   <link rel="icon" type="image/svg+xml" href="../../browser/favicon.svg" />
   <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" rel="stylesheet" />
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.2.5/browser/compute-jsonata.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.3.0/browser/compute-jsonata.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/dompurify/dist/purify.min.js"></script>
   <script src="https://cdn.jsdelivr.net/npm/leader-line/leader-line.min.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.2.5/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.2.5/browser/board-livecards-localstorage.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.3.0/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.3.0/browser/board-livecards-localstorage.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">

package/lib/{artifacts-store-lib-public-C5UL5tyG.d.cts → artifacts-store-lib-public-Cz8-kdXG.d.cts}

@@ -1,4 +1,4 @@
-import { C as CommandInput, a as CommandResult } from './board-live-cards-public-BLXbcBNk.cjs';
+import { C as CommandInput, a as CommandResult } from './board-live-cards-public-BwZYGAsF.cjs';
 import { B as BlobStorage } from './storage-interface-B6ecOulj.cjs';
 
 /**

package/lib/{artifacts-store-lib-public-GD4H-fFp.d.ts → artifacts-store-lib-public-ksGIExhc.d.ts}

@@ -1,4 +1,4 @@
-import { C as CommandInput, a as CommandResult } from './board-live-cards-public-BZaNb2mi.js';
+import { C as CommandInput, a as CommandResult } from './board-live-cards-public-DWpZVDXN.js';
 import { B as BlobStorage } from './storage-interface-B6ecOulj.js';
 
 /**

package/lib/artifacts-store-public.d.cts

@@ -1,5 +1,5 @@
-import './board-live-cards-public-BLXbcBNk.cjs';
-export { A as ArtifactsStorePublic, a as createArtifactsStorePublic } from './artifacts-store-lib-public-C5UL5tyG.cjs';
+import './board-live-cards-public-BwZYGAsF.cjs';
+export { A as ArtifactsStorePublic, a as createArtifactsStorePublic } from './artifacts-store-lib-public-Cz8-kdXG.cjs';
 import './storage-interface-B6ecOulj.cjs';
 import './execution-refs.cjs';
 import './types-BBhqYGhE.cjs';

package/lib/artifacts-store-public.d.ts

@@ -1,5 +1,5 @@
-import './board-live-cards-public-BZaNb2mi.js';
-export { A as ArtifactsStorePublic, a as createArtifactsStorePublic } from './artifacts-store-lib-public-GD4H-fFp.js';
+import './board-live-cards-public-DWpZVDXN.js';
+export { A as ArtifactsStorePublic, a as createArtifactsStorePublic } from './artifacts-store-lib-public-ksGIExhc.js';
 import './storage-interface-B6ecOulj.js';
 import './execution-refs.js';
 import './types-BBhqYGhE.js';