yaml-flow 8.4.23 → 8.5.0

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

@@ -0,0 +1,259 @@
+import { L as LiveCard, C as CommandResult } from './board-live-cards-public-DdVhH4M-.js';
+import { CardStorePublic } from './card-store-public.js';
+import { ChatStorePublic } from './chat-store-public.js';
+import { C as ChatRecord } from './chat-storage-lib-CJn7a6OH.js';
+import './storage-interface-B2WD9D5n.js';
+import './execution-refs.js';
+import './types-BBhqYGhE.js';
+
+/**
+ * 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 };

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

@@ -0,0 +1,2 @@
+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}}export{Z as createBoardLiveCardsMcp};//# sourceMappingURL=board-live-cards-mcp.js.map
+//# sourceMappingURL=board-live-cards-mcp.js.map