yaml-flow 8.4.23 → 8.5.0

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

@@ -50,6 +50,7 @@ const BOARD_DIR = path.resolve(__dirname, '..');
 const SERVER_SCRIPT = path.resolve(BOARD_DIR, 'server', 'board-server.js');
 const SSE_WORKER_SCRIPT = path.join(__dirname, 'sse-worker.js');
 const CARD_PATTERN = 'cardT*';
+const T2_FILE_CARD_ID = 'card-market-prices';
 const CHAT_CARD_ID = 'card-portfolio';
 
 function findFreePort() {
@@ -236,6 +237,7 @@ function deriveProbeLifecycleMilestones(events, opts) {
   let prevMessageCount = Number(opts.beforeCount || 0);
   let prevProcessing = Boolean(opts.beforeProcessing);
   const prompt = String(opts.prompt || '');
+  const assistantText = opts.assistantText == null ? `Echo: ${prompt}` : String(opts.assistantText);
   const inProgressText = String(opts.inProgressText || PROBE_IN_PROGRESS_TEXT);
 
   for (const event of events) {
@@ -250,7 +252,7 @@ function deriveProbeLifecycleMilestones(events, opts) {
       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');
+      else if (role === 'assistant' && text.includes(assistantText)) milestones.push('assistant');
     }
 
     const processing = Boolean(event?.processing);
@@ -510,7 +512,7 @@ try {
     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}`);
+    const t2CardBefore = await httpGet(`${BASE}/cards/${T2_FILE_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
@@ -520,7 +522,7 @@ try {
     const t2UploadText = `plain-file-upload-${Date.now()}`;
     const t2UploadName = 't2-upload.txt';
     const t2UploadRes = await httpUploadChatFile(
-      `${BASE}/cards/${CHAT_CARD_ID}/files`,
+      `${BASE}/cards/${T2_FILE_CARD_ID}/files`,
       t2UploadName,
       t2UploadText,
     );
@@ -529,7 +531,7 @@ try {
     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}`);
+    const t2CardAfter = await httpGet(`${BASE}/cards/${T2_FILE_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
@@ -540,7 +542,7 @@ try {
     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 || ''))}`,
+      `${BASE}/cards/${T2_FILE_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');
@@ -563,7 +565,7 @@ try {
   const subRes = await httpJson('POST', `${BASE}/cards/${CHAT_CARD_ID}/chats/subscribe-sse`, { clientId: chatSseClientId });
   assert(subRes.status === 200, `chat subscribe returned ${subRes.status}`);
 
-  const t2Before = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats`);
+  const t2Before = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats?all-turns=true`);
   assert(t2Before.status === 200, `T3 pre chats returned ${t2Before.status}`);
   const t2BeforeMessages = Array.isArray(t2Before.data?.messages) ? t2Before.data.messages : [];
   const t2BeforeCount = t2BeforeMessages.length;
@@ -588,7 +590,7 @@ try {
   }, 45_000, 'T3 ordered lifecycle');
   assert(!!t2Lifecycle, 'T3 ordered lifecycle not observed');
 
-  const t2After = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats`);
+  const t2After = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats?all-turns=true`);
   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);
@@ -611,7 +613,7 @@ try {
     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`);
+    const t2aBefore = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats?all-turns=true`);
     assert(t2aBefore.status === 200, `T3a pre chats returned ${t2aBefore.status}`);
     const t2aBeforeMessages = Array.isArray(t2aBefore.data?.messages) ? t2aBefore.data.messages : [];
     const t2aBeforeCount = t2aBeforeMessages.length;
@@ -639,7 +641,7 @@ try {
     }, 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`);
+    const t2aAfter = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats?all-turns=true`);
     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);
@@ -655,7 +657,7 @@ try {
     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`);
+    const t2bBefore = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats?all-turns=true`);
     assert(t2bBefore.status === 200, `T3b pre chats returned ${t2bBefore.status}`);
     const t2bBeforeMessages = Array.isArray(t2bBefore.data?.messages) ? t2bBefore.data.messages : [];
     const t2bBeforeCount = t2bBeforeMessages.length;
@@ -663,13 +665,13 @@ try {
     const t2bUploadRes = await httpUploadChatFile(
       `${BASE}/cards/${CHAT_CARD_ID}/files?inChat=true`,
       'q1.txt',
-      'what is the capital of japan',
+      'tokyo',
     );
     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`);
+    const t2bAfterUpload = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats?all-turns=true`);
     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);
@@ -677,6 +679,20 @@ try {
     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 t2bCardAfterUpload = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}`);
+    assert(t2bCardAfterUpload.status === 200, `T3b card read after upload returned ${t2bCardAfterUpload.status}`);
+    const t2bFilesAfterUpload = Array.isArray(t2bCardAfterUpload.data?.card_data?.files)
+      ? t2bCardAfterUpload.data.card_data.files
+      : [];
+    const t2bFileIndex = t2bFilesAfterUpload.findIndex((f) => String(f?.stored_name || '') === String(uploadedFile?.stored_name || ''));
+    assert(t2bFileIndex >= 0, 'T3b uploaded file metadata not found in card_data.files');
+
+    const t2bDownloadRes = await httpGetRaw(
+      `${BASE}/cards/${CHAT_CARD_ID}/files/${t2bFileIndex}?sn=${encodeURIComponent(String(uploadedFile?.stored_name || ''))}`,
+    );
+    assert(t2bDownloadRes.status === 200, `T3b file download returned ${t2bDownloadRes.status}`);
+    assert(t2bDownloadRes.body.toString('utf-8') === 'tokyo', 'T3b downloaded content mismatch');
+
     const t2bSendBaseline = t2bUploadMessages.length;
     const t2bEventStart = NS.chatEvents.length;
 
@@ -695,12 +711,13 @@ try {
         beforeCount: t2bSendBaseline,
         beforeProcessing: false,
         prompt: t2bPrompt,
+        assistantText: 'tokyo',
         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`);
+    const t2bAfter = await httpGet(`${BASE}/cards/${CHAT_CARD_ID}/chats?all-turns=true`);
     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);
@@ -714,8 +731,8 @@ try {
     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)');
+    assert(String(t2bAssistantMsg?.text || '').trim() === 'tokyo', 'T3b assistant attachment content mismatch');
+    console.log('[T3b] ok: upload protocol and ordered probe lifecycle observed with attachment-derived assistant reply');
   }
   }
 

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.4.23/browser/compute-jsonata.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.5.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.4.23/browser/live-cards.js"></script>
-  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.4.23/browser/board-livecards-localstorage.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.5.0/browser/live-cards.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/yaml-flow@8.5.0/browser/board-livecards-localstorage.js"></script>
 </head>
 <body class="bg-light">
   <div class="container-fluid py-3">

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

@@ -1,4 +1,4 @@
-import { C as CommandInput, a as CommandResult } from './board-live-cards-public-B4RcYPC_.cjs';
+import { a as CommandInput, C as CommandResult } from './board-live-cards-public-CvkDfZQ7.cjs';
 import { A as ArtifactInfo, a as ArtifactsStore } from './artifacts-store-lib-CVgtQrNZ.cjs';
 import './storage-interface-B2WD9D5n.cjs';
 import './execution-refs.cjs';

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

@@ -1,4 +1,4 @@
-import { C as CommandInput, a as CommandResult } from './board-live-cards-public-ydXuA4zh.js';
+import { a as CommandInput, C as CommandResult } from './board-live-cards-public-DdVhH4M-.js';
 import { A as ArtifactInfo, a as ArtifactsStore } from './artifacts-store-lib-D-k-E8Vy.js';
 import './storage-interface-B2WD9D5n.js';
 import './execution-refs.js';

package/lib/board-live-cards-mcp.cjs

@@ -0,0 +1,2 @@
+'use strict';function m(a,i){if(a?.status==="success")return Object.prototype.hasOwnProperty.call(a,"data")?a.data:void 0;throw a?.status==="fail"||a?.status==="error"?new Error(a.error||`${i} failed`):new Error(`${i} returned an unexpected response`)}function d(a){return a&&typeof a=="object"&&!Array.isArray(a)?a:{}}function C(a){return Array.isArray(a)?a:[]}function F(a,i){if(typeof i!="string"||i.length===0)return;let c=a,p=i;p.startsWith("fetched_sources.")&&(c=d(a).fetched_sources,p=p.slice(16));for(let x of p.split(".")){if(c==null||typeof c!="object")return;c=c[x];}return c}function G(a,i){let c=d(a.view),p=C(c.elements);return {layout:c.layout,features:c.features,elements:p.map((x,T)=>{let k=d(x),v=d(k.data),q=typeof k.visible=="string"?!!F(i,k.visible):true,A=typeof v.bind=="string"?v.bind:void 0,M=A?F(i,A):void 0,I={id:typeof k.id=="string"&&k.id?k.id:`element-${T}`,kind:k.kind,label:k.label,visible:q};return A&&(I.bind=A),Array.isArray(v.columns)&&(I.columns=v.columns),typeof v.maxRows=="number"&&(I.maxRows=v.maxRows),M!==void 0&&(I.resolved=Array.isArray(M)&&typeof I.maxRows=="number"?M.slice(0,I.maxRows):M),I})}}function Q(a){if(typeof a!="string"||!a.trim())return null;let i=/^(file uploaded|AI generated|AI geneterated):\s*.*?#(\d+)\s*$/i.exec(a.trim());if(!i)return null;let c=Number.parseInt(i[2],10);return !Number.isInteger(c)||c<0?null:c}function X(a){return {"card-content":a}}function O(a,i){let c=m(a.get({params:{id:i}}),"cardStore.get"),p=Array.isArray(c?.cards)?c.cards:[];if(p.length===0)throw new Error(`Card "${i}" not found`);return p[0]}function Z(a){let{board:i,nonCore:c,cardStore:p,chatStore:x,uploadCardFile:T,buildFileDownloadUrl:k,readFetchedSourceJsonByRef:v}=a;function q(r){if(Array.isArray(r.bytes))return new Uint8Array(r.bytes.map(e=>Math.max(0,Math.min(255,Number(e)||0))));if(typeof r.text=="string")return new TextEncoder().encode(r.text);if(typeof r.base64=="string"){let e=String(r.base64).replace(/-/g,"+").replace(/_/g,"/"),n=e+"=".repeat((4-e.length%4)%4),f=atob(n);return Uint8Array.from(f,o=>o.charCodeAt(0))}throw new Error("file entry requires bytes, text, or base64")}function A(){let r=d(m(c.describeTaskExecutorCapabilities({}),"describeTaskExecutorCapabilities"));return {version:r.version,commonSourceFields:d(r.commonSourceDefFields),sourceKinds:d(r.sourceKinds)}}function M(){let r=d(m(i.status({}),"status")),e=d(r.summary),n=C(r.cards);return {meta:d(r.meta),summary:{card_count:typeof e.card_count=="number"?e.card_count:0,completed:typeof e.completed=="number"?e.completed:0,eligible:typeof e.eligible=="number"?e.eligible:0,pending:typeof e.pending=="number"?e.pending:0,blocked:typeof e.blocked=="number"?e.blocked:0,in_progress:typeof e.in_progress=="number"?e.in_progress:0,failed:typeof e.failed=="number"?e.failed:0,unresolved:typeof e.unresolved=="number"?e.unresolved:0},cards:n.map(f=>{let o=d(f);return {"card-id":typeof o.name=="string"?o.name:null,status:o.status??null,error:o.error??null,requires:C(o.requires),requires_satisfied:C(o.requires_satisfied),requires_missing:C(o.requires_missing),provides_declared:C(o.provides_declared),provides_runtime:C(o.provides_runtime)}})}}function I(r){let e=String(r.cardId||"").trim();if(!e)throw new Error("inspectCardDefinitionAndRuntime requires cardId");let n=d(m(i.status({}),"status")),o=C(n.cards).map(d).find(s=>s.name===e);if(!o)throw new Error(`card "${e}" not found in board status`);let t=d(O(p,e)),g=C(o.requires_satisfied).filter(s=>typeof s=="string"&&!!s),b=C(o.provides_runtime).filter(s=>typeof s=="string"&&!!s),l=Object.fromEntries(g.map(s=>[s,m(i.getOutputsDataObject({params:{key:s}}),`getOutputsDataObject(${s})`)])),w=Object.fromEntries(b.map(s=>[s,m(i.getOutputsDataObject({params:{key:s}}),`getOutputsDataObject(${s})`)])),_=d(m(i.getOutputsComputedValues({params:{key:e}}),"getOutputsComputedValues")),U=m(i.getOutputsFetchedSources({params:{key:e}}),"getOutputsFetchedSources"),L=C(t.source_defs).map(d),u={};for(let s of L)typeof s.bindTo=="string"&&typeof s.outputFile=="string"&&(u[s.outputFile]=s.bindTo);let h={};for(let[s,B]of Object.entries(U)){let y=u[s]??s;if(!v||typeof B!="string"){h[y]=null;continue}try{h[y]=v({cardId:e,ref:B});}catch{h[y]=null;}}let R={card_data:d(t.card_data),requires:l,fetched_sources:h,computed_values:_};return {cardId:e,card_status_in_board:o,card_definition_and_static_data:t,refs_for_fetched_source_files:U,runtime_data:{requires:l,provides:w,computed_values:_,rendered_view:G(t,R)}}}function j(r){let e=String(r.cardId||"").trim();if(!e)throw new Error("inspectChatMessagesOnCards requires cardId");let n=typeof r.turnId=="string"?r.turnId:"",f=r.allTurns===true,o=typeof r.tailTurnsBeforeId=="string"?r.tailTurnsBeforeId:"",t=f?void 0:r.lastUserTurns??(n?void 0:1),g=r.tail,b=t===void 0?{params:{cardId:e}}:{params:{cardId:e},body:{lastUserTurns:t}},l=m(x.readAll(b),"chatStore.readAll"),w=d(O(p,e)),_=C(d(w.card_data).files).map((u,h)=>({idx:h,stored_name:d(u).stored_name})).filter(u=>typeof u.stored_name=="string"&&u.stored_name.length>0),U=(Array.isArray(l.records)?l.records:[]).filter(u=>n?typeof u?.turn=="string"?u.turn===n:n==="":true);if(o){if(t===void 0||!Number.isInteger(t)||t<=0)throw new Error("inspectChatMessagesOnCards requires tail-turns when tail-turns-before-id is provided");let u=new Map,h=[];for(let y of Array.isArray(l.records)?l.records:[]){let S=typeof y?.turn=="string"?y.turn:"";u.has(S)||(u.set(S,[]),h.push(S)),u.get(S).push(y);}let R=h.findIndex(y=>y===o),s=Math.max(0,R-t);U=(R===-1?[]:h.slice(s,R)).flatMap(y=>u.get(y)??[]);}let L=U.map(u=>{let R=d(u.payload),s={...u},B=typeof u?.role=="string"?u.role:typeof R.role=="string"?String(R.role):"",y=typeof u?.text=="string"?u.text:typeof R.text=="string"?String(R.text):"";if(B==="system"){let S=Q(y);if(S!==null&&_.some(D=>D.idx===S)){let D=`Retrieve using inspect-file-contents --card-id ${e} --file-idx ${S}`;s.retrieval_hint=D,Object.keys(R).length>0&&typeof u.role!="string"&&(s.payload={...R,retrieval_hint:D});}}return s});return {cardId:e,messages:typeof g=="number"&&g>=0?L.slice(-g):L}}function P(r){let e=String(r.cardId||"").trim(),n=Number(r.fileIdx);if(!e)throw new Error("inspectFileContents requires cardId");if(!Number.isInteger(n)||n<0)throw new Error("inspectFileContents requires fileIdx to be a non-negative integer");let f=d(O(p,e)),o=C(d(f.card_data).files).map(d);if(n>=o.length)throw new Error(`attachment index ${n} is out of range for card "${e}"`);let t=o[n],g=typeof t.stored_name=="string"?t.stored_name:null;return {cardId:e,fileIdx:n,downloadUrl:k({cardId:e,fileIdx:n,storedName:g}),...typeof t.name=="string"?{name:t.name}:{},...typeof t.stored_name=="string"?{stored_name:t.stored_name}:{},...typeof t.mime_type=="string"?{mime_type:t.mime_type}:{},...typeof t.size=="number"?{size:t.size}:{},...typeof t.uploaded_at=="string"?{uploaded_at:t.uploaded_at}:{}}}function E(r){return c.validateCardPreflight({body:X(r.candidateCardContent)})}function $(r){return c.evalCardCompute({body:{"card-content":r.candidateCardContent,"mock-requires":r.mockRequires,"mock-fetched-sources":r.mockFetchedSources}})}function N(r){return c.probeSourcePreflight({params:{sourceIdx:r.sourceIdx},body:{"card-content":r.candidateCardContent,"mock-projections":r.mockProjections}})}function V(r){return c.runSourcePreflight({params:{sourceIdx:r.sourceIdx},body:{"card-content":r.candidateCardContent,"mock-projections":r.mockProjections}})}function K(r){return c.simulateCardCycle({body:{"card-content":r.candidateCardContent,"mock-requires":r.mockRequires}})}function z(r){let e=String(r.cardId||"").trim();if(!e)throw new Error("manageReadCard requires cardId");let n=m(p.get({params:{id:e}}),"cardStore.get");return Array.isArray(n.cards)?n.cards:[]}function W(r){let e=String(r.cardId||"").trim(),n=String(r.role||"").trim(),f=typeof r.text=="string"?r.text:"",o=typeof r.turn=="string"?r.turn:"";if(!e)throw new Error("manageAddChatEntryAndAnyAttachments requires cardId");if(!n)throw new Error("manageAddChatEntryAndAnyAttachments requires role");let t=C(r.files).map(b=>{let l=d(b),w=String(l.file_name??l.fileName??l.name??"").trim(),_=String(l.content_type??l.contentType??"application/octet-stream");if(!w)throw new Error("file entry requires file_name");return T({cardId:e,fileName:w,contentType:_,bytes:q(l)}).file});t.forEach((b,l)=>{let w=n==="assistant"?`AI generated: ${String(b.name||"")} as ${String(b.stored_name||"")} #${l}`:`file uploaded: ${String(b.name||"")} as ${String(b.stored_name||"")} #${l}`;m(x.append({params:{cardId:e},body:{role:"system",text:w,files:[],turn:o}}),"chatStore.append(system attachment message)");});let g=m(x.append({params:{cardId:e},body:{role:n,text:f,files:t,turn:o}}),"chatStore.append");return {status:"success",data:{cardId:e,id:String(g.id),role:n,turn:o,files:t}}}function J(r){let e=String(r.cardId||"").trim(),n=d(r.candidateCardContent);if(!e)throw new Error("manageUpsertCard requires cardId");if(typeof n.id!="string"||!n.id.trim())throw new Error("candidateCardContent.id must be a non-empty string");if(n.id!==e)throw new Error(`candidateCardContent.id must match cardId (${e})`);let f=E({candidateCardContent:n}),o=d(f),t=d(o.data);if(o.status!=="success"||t.isValid!==true)return {status:"fail",step:"validate",validation:f};let g=null;try{g=O(p,e);}catch{g=null;}let b=p.set({body:n});m(b,"cardStore.set");let l;try{l=i.upsertCard({params:{cardId:e,restart:!0}}),m(l,"upsertCard");}catch(_){try{g&&p.set({body:g});}catch{}throw _}let w=null;try{w=i.cardRefreshedNotify({params:{cardId:e}}),m(w,"cardRefreshedNotify");}catch{w=null;}return {status:"success",data:{validation:f,card_saved:null,board_result:l,refresh_notify:w}}}function H(r){let e=String(r.cardId||"").trim();if(!e)throw new Error("manageDeprecate requires cardId");let n=i.removeCard({params:{id:e}});return m(n,"removeCard"),n}return {discoverSourceKinds:A,inspectBoardRuntimeStatus:M,inspectCardDefinitionAndRuntime:I,inspectChatMessagesOnCards:j,inspectFileContents:P,preflightValidateCandidateCardDefinition:E,preflightMaterializeCandidateCard:$,preflightProbeSingleSourceInCandidateCard:N,preflightRunSingleSourceInCandidateCard:V,preflightRunOneCycleWithCandidateCard:K,manageReadCard:z,manageAddChatEntryAndAnyAttachments:W,manageUpsertCard:J,manageDeprecate:H}}exports.createBoardLiveCardsMcp=Z;//# sourceMappingURL=board-live-cards-mcp.cjs.map
+//# sourceMappingURL=board-live-cards-mcp.cjs.map

package/lib/board-live-cards-mcp.d.cts

@@ -0,0 +1,259 @@
+import { L as LiveCard, C as CommandResult } from './board-live-cards-public-CvkDfZQ7.cjs';
+import { CardStorePublic } from './card-store-public.cjs';
+import { ChatStorePublic } from './chat-store-public.cjs';
+import { C as ChatRecord } from './chat-storage-lib-0imhRX3l.cjs';
+import './storage-interface-B2WD9D5n.cjs';
+import './execution-refs.cjs';
+import './types-BBhqYGhE.cjs';
+
+/**
+ * board-live-cards-mcp.ts
+ *
+ * Platform-free MCP-oriented facade for board-live-cards.
+ *
+ * This layer preserves the wrapper-script-visible tool semantics while using
+ * the existing public library surfaces instead of shelling out to CLIs.
+ */
+
+type UnknownRecord = Record<string, unknown>;
+interface BoardLiveCardsMcpFileDownloadDescriptor {
+    cardId: string;
+    fileIdx: number;
+    downloadUrl: string;
+    name?: string;
+    stored_name?: string;
+    mime_type?: string;
+    size?: number;
+    uploaded_at?: string;
+}
+interface BoardLiveCardsMcpDiscoverSourceKindsResult {
+    version?: unknown;
+    commonSourceFields: UnknownRecord;
+    sourceKinds: UnknownRecord;
+}
+interface BoardLiveCardsMcpBoardStatusCard {
+    'card-id': string | null;
+    status: unknown;
+    error: unknown;
+    requires: unknown[];
+    requires_satisfied: unknown[];
+    requires_missing: unknown[];
+    provides_declared: unknown[];
+    provides_runtime: unknown[];
+}
+interface BoardLiveCardsMcpBoardStatusResult {
+    meta: UnknownRecord;
+    summary: {
+        card_count: number;
+        completed: number;
+        eligible: number;
+        pending: number;
+        blocked: number;
+        in_progress: number;
+        failed: number;
+        unresolved: number;
+    };
+    cards: BoardLiveCardsMcpBoardStatusCard[];
+}
+interface BoardLiveCardsMcpRenderedViewElement {
+    id: string;
+    kind: unknown;
+    label: unknown;
+    visible: boolean;
+    bind?: string;
+    columns?: unknown[];
+    maxRows?: number;
+    resolved?: unknown;
+}
+interface BoardLiveCardsMcpRenderedView {
+    layout: unknown;
+    features: unknown;
+    elements: BoardLiveCardsMcpRenderedViewElement[];
+}
+interface BoardLiveCardsMcpInspectCardDefinitionAndRuntimeResult {
+    cardId: string;
+    card_status_in_board: UnknownRecord;
+    card_definition_and_static_data: UnknownRecord;
+    refs_for_fetched_source_files: Record<string, string>;
+    runtime_data: {
+        requires: Record<string, unknown>;
+        provides: Record<string, unknown>;
+        computed_values: UnknownRecord;
+        rendered_view: BoardLiveCardsMcpRenderedView;
+    };
+}
+interface BoardLiveCardsMcpInspectChatMessagesResult {
+    cardId: string;
+    messages: Array<ChatRecord & {
+        retrieval_hint?: string;
+        payload?: UnknownRecord;
+    }>;
+}
+interface BoardLiveCardsMcpManageUpsertCardFailureResult {
+    status: 'fail';
+    step: 'validate';
+    validation: unknown;
+}
+interface BoardLiveCardsMcpManageUpsertCardSuccessResult {
+    status: 'success';
+    data: {
+        validation: unknown;
+        card_saved: unknown;
+        board_result: unknown;
+        refresh_notify: unknown;
+    };
+}
+type BoardLiveCardsMcpManageUpsertCardResult = BoardLiveCardsMcpManageUpsertCardFailureResult | BoardLiveCardsMcpManageUpsertCardSuccessResult;
+interface BoardLiveCardsMcpManageAddChatEntryAndAnyAttachmentsResult {
+    status: 'success';
+    data: {
+        cardId: string;
+        id: string;
+        role: string;
+        turn: string;
+        files: Array<Record<string, unknown>>;
+    };
+}
+interface BoardLiveCardsMcpBoardDeps {
+    status(input: {}): CommandResult;
+    getOutputsDataObject(input: {
+        params: {
+            key: string;
+        };
+    }): CommandResult;
+    getOutputsComputedValues(input: {
+        params: {
+            key: string;
+        };
+    }): CommandResult;
+    getOutputsFetchedSources(input: {
+        params: {
+            key: string;
+        };
+    }): CommandResult<Record<string, string>>;
+    removeCard(input: {
+        params: {
+            id: string;
+        };
+    }): CommandResult;
+    cardRefreshedNotify(input: {
+        params: {
+            cardId: string;
+        };
+    }): CommandResult;
+    upsertCard(input: {
+        params: {
+            cardId: string;
+            restart?: boolean;
+        };
+    }): CommandResult;
+}
+interface BoardLiveCardsMcpNonCoreDeps {
+    describeTaskExecutorCapabilities(input: {}): CommandResult;
+    validateCardPreflight(input: {
+        body: unknown;
+    }): CommandResult;
+    evalCardCompute(input: {
+        body: unknown;
+    }): CommandResult;
+    probeSourcePreflight(input: {
+        params: {
+            sourceIdx: number;
+        };
+        body: unknown;
+    }): CommandResult;
+    runSourcePreflight(input: {
+        params: {
+            sourceIdx: number;
+        };
+        body: unknown;
+    }): CommandResult;
+    simulateCardCycle(input: {
+        body: unknown;
+    }): CommandResult;
+}
+interface BoardLiveCardsMcpDeps {
+    board: BoardLiveCardsMcpBoardDeps;
+    nonCore: BoardLiveCardsMcpNonCoreDeps;
+    cardStore: CardStorePublic;
+    chatStore: ChatStorePublic;
+    uploadCardFile(args: {
+        cardId: string;
+        fileName: string;
+        contentType: string;
+        bytes: Uint8Array;
+    }): {
+        ok: true;
+        file: Record<string, unknown>;
+    };
+    buildFileDownloadUrl(args: {
+        cardId: string;
+        fileIdx: number;
+        storedName?: string | null;
+    }): string;
+    readFetchedSourceJsonByRef?(args: {
+        cardId: string;
+        ref: string;
+    }): unknown | null;
+}
+interface BoardLiveCardsMcp {
+    discoverSourceKinds(): BoardLiveCardsMcpDiscoverSourceKindsResult;
+    inspectBoardRuntimeStatus(): BoardLiveCardsMcpBoardStatusResult;
+    inspectCardDefinitionAndRuntime(args: {
+        cardId: string;
+    }): BoardLiveCardsMcpInspectCardDefinitionAndRuntimeResult;
+    inspectChatMessagesOnCards(args: {
+        cardId: string;
+        lastUserTurns?: number;
+        tail?: number;
+        turnId?: string;
+        allTurns?: boolean;
+        tailTurnsBeforeId?: string;
+    }): BoardLiveCardsMcpInspectChatMessagesResult;
+    inspectFileContents(args: {
+        cardId: string;
+        fileIdx: number;
+    }): BoardLiveCardsMcpFileDownloadDescriptor;
+    preflightValidateCandidateCardDefinition(args: {
+        candidateCardContent: UnknownRecord;
+    }): unknown;
+    preflightMaterializeCandidateCard(args: {
+        candidateCardContent: UnknownRecord;
+        mockRequires: UnknownRecord;
+        mockFetchedSources: UnknownRecord;
+    }): unknown;
+    preflightProbeSingleSourceInCandidateCard(args: {
+        candidateCardContent: UnknownRecord;
+        mockProjections: UnknownRecord;
+        sourceIdx: number;
+    }): unknown;
+    preflightRunSingleSourceInCandidateCard(args: {
+        candidateCardContent: UnknownRecord;
+        mockProjections: UnknownRecord;
+        sourceIdx: number;
+    }): unknown;
+    preflightRunOneCycleWithCandidateCard(args: {
+        candidateCardContent: UnknownRecord;
+        mockRequires: UnknownRecord;
+    }): unknown;
+    manageReadCard(args: {
+        cardId: string;
+    }): LiveCard[];
+    manageAddChatEntryAndAnyAttachments(args: {
+        cardId: string;
+        role: string;
+        text?: string;
+        turn?: string;
+        files?: unknown[];
+    }): BoardLiveCardsMcpManageAddChatEntryAndAnyAttachmentsResult;
+    manageUpsertCard(args: {
+        cardId: string;
+        candidateCardContent: UnknownRecord;
+    }): BoardLiveCardsMcpManageUpsertCardResult;
+    manageDeprecate(args: {
+        cardId: string;
+    }): unknown;
+}
+declare function createBoardLiveCardsMcp(deps: BoardLiveCardsMcpDeps): BoardLiveCardsMcp;
+
+export { type BoardLiveCardsMcp, type BoardLiveCardsMcpBoardDeps, type BoardLiveCardsMcpBoardStatusCard, type BoardLiveCardsMcpBoardStatusResult, type BoardLiveCardsMcpDeps, type BoardLiveCardsMcpDiscoverSourceKindsResult, type BoardLiveCardsMcpFileDownloadDescriptor, type BoardLiveCardsMcpInspectCardDefinitionAndRuntimeResult, type BoardLiveCardsMcpInspectChatMessagesResult, type BoardLiveCardsMcpManageAddChatEntryAndAnyAttachmentsResult, type BoardLiveCardsMcpManageUpsertCardFailureResult, type BoardLiveCardsMcpManageUpsertCardResult, type BoardLiveCardsMcpManageUpsertCardSuccessResult, type BoardLiveCardsMcpNonCoreDeps, type BoardLiveCardsMcpRenderedView, type BoardLiveCardsMcpRenderedViewElement, createBoardLiveCardsMcp };