yaml-flow 8.4.25 → 8.5.1

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

@@ -0,0 +1,296 @@
+import { C as CommandResult, L as LiveCard } from './board-live-cards-public-BGS22cMb.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 BoardLiveCardsMcpPreflightRunOneCycleResult {
+    status: 'success';
+    data: {
+        cardId: string;
+        ok: boolean;
+        issues: string[];
+        provides_outputs: Record<string, unknown>;
+        rendered_view: BoardLiveCardsMcpRenderedView;
+    };
+}
+interface BoardLiveCardsMcpPreflightMaterializeResult {
+    status: 'success';
+    data: {
+        cardId: string;
+        ok: boolean;
+        computed_values: UnknownRecord;
+        errors: Array<{
+            bindTo: string;
+            error: string;
+        }>;
+        provides_outputs: Record<string, unknown>;
+        rendered_view: BoardLiveCardsMcpRenderedView;
+    };
+}
+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<{
+        cardId: string;
+        ok: boolean;
+        computed_values: Record<string, unknown>;
+        errors: Array<{
+            bindTo: string;
+            error: string;
+        }>;
+    }>;
+    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;
+    }): BoardLiveCardsMcpPreflightMaterializeResult | CommandResult;
+    preflightProbeSingleSourceInCandidateCard(args: {
+        candidateCardContent: UnknownRecord;
+        mockProjections: UnknownRecord;
+        sourceIdx: number;
+    }): unknown;
+    preflightRunSingleSourceInCandidateCard(args: {
+        candidateCardContent: UnknownRecord;
+        mockProjections: UnknownRecord;
+        sourceIdx: number;
+    }): unknown;
+    preflightRunSingleSourceInLiveCard(args: {
+        cardId: string;
+        sourceIdx: number;
+        mockRequires: UnknownRecord;
+    }): unknown;
+    preflightRunOneCycleWithCandidateCard(args: {
+        candidateCardContent: UnknownRecord;
+        mockRequires: UnknownRecord;
+    }): BoardLiveCardsMcpPreflightRunOneCycleResult;
+    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 BoardLiveCardsMcpPreflightMaterializeResult, type BoardLiveCardsMcpPreflightRunOneCycleResult, type BoardLiveCardsMcpRenderedView, type BoardLiveCardsMcpRenderedViewElement, createBoardLiveCardsMcp };

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

@@ -0,0 +1,2 @@
+import {createRequire}from'module';import'ajv-formats';var ae=createRequire(import.meta.url);ae("./jsonata-sync.cjs");var de=createRequire(import.meta.url),L=de("./jsonata-sync.cjs"),V=L;function D(e,r){if(!r||!e)return;let s=r.split("."),t=e;for(let a=0;a<s.length;a++){if(t==null)return;t=t[s[a]];}return t}function K(e,r,s){let t=r.split("."),a=e;for(let c=0;c<t.length-1;c++)(a[t[c]]==null||typeof a[t[c]]!="object")&&(a[t[c]]={}),a=a[t[c]];a[t[t.length-1]]=s;}async function ce(e,r){if(!e?.compute?.length)return e;e.card_data||(e.card_data={}),e.computed_values={},e._sourcesData=r?.sourcesData??{};let s=e.requires??{},t={card_data:e.card_data,requires:s,expects_data:s,fetched_sources:e._sourcesData,data:e.computed_values,computed_values:e.computed_values};for(let a of e.compute)try{let c=await L(a.expr).evaluate(t);K(e.computed_values,a.bindTo,c),t.computed_values=e.computed_values;}catch{}return e}function ue(e,r){if(!e?.compute?.length)return {ok:true,node:e};e.card_data||(e.card_data={}),e.computed_values={},e._sourcesData=r?.sourcesData??{};let s=e.requires??{},t={card_data:e.card_data,requires:s,expects_data:s,fetched_sources:e._sourcesData,data:e.computed_values,computed_values:e.computed_values},a=[];for(let c of e.compute)try{let l=V(c.expr).evaluate(t);K(e.computed_values,c.bindTo,l),t.computed_values=e.computed_values;}catch(l){let m=l instanceof Error?l.message:String(l);a.push({bindTo:c.bindTo,error:m});}return a.length>0?{ok:true,node:e,errors:a}:{ok:true,node:e}}async function pe(e,r,s){let t={...s??{},card_data:r.card_data??{},requires:r.requires??{},fetched_sources:r._sourcesData??{},computed_values:r.computed_values??{}};return L(e).evaluate(t)}function le(e,r){return r.startsWith("fetched_sources.")?D(e._sourcesData??{},r.slice(16)):D(e,r)}var P=new Set(["metric","table","editable-table","chart","form","filter","list","notes","todo","alert","narrative","badge","text","markdown","ref","custom","actions"]),fe=new Set(["id","meta","requires","provides","view","card_data","compute","source_defs"]);function me(e){let r=[];if(!e||typeof e!="object"||Array.isArray(e))return {ok:false,errors:["Node must be a non-null object"]};let s=e;(typeof s.id!="string"||!s.id)&&r.push("id: required, must be a non-empty string");for(let t of Object.keys(s))fe.has(t)||r.push(`Unknown top-level key: "${t}"`);if((s.card_data==null||typeof s.card_data!="object"||Array.isArray(s.card_data))&&r.push("card_data: required, must be an object"),s.meta!=null)if(typeof s.meta!="object"||Array.isArray(s.meta))r.push("meta: must be an object");else {let t=s.meta;t.title!=null&&typeof t.title!="string"&&r.push("meta.title: must be a string"),t.tags!=null&&!Array.isArray(t.tags)&&r.push("meta.tags: must be an array");}if(s.requires!=null&&!Array.isArray(s.requires)&&r.push("requires: must be an array of strings"),s.provides!=null&&(Array.isArray(s.provides)?s.provides.forEach((t,a)=>{if(!t||typeof t!="object"||Array.isArray(t))r.push(`provides[${a}]: must be an object with bindTo and ref`);else {let c=t;(typeof c.bindTo!="string"||!c.bindTo)&&r.push(`provides[${a}]: missing required "bindTo" string`),(typeof c.ref!="string"||!c.ref)&&r.push(`provides[${a}]: missing required "ref" string`);}}):r.push("provides: must be an array of { bindTo, ref } bindings")),s.compute!=null&&(Array.isArray(s.compute)?s.compute.forEach((t,a)=>{if(!t||typeof t!="object"||Array.isArray(t))r.push(`compute[${a}]: must be a compute step object`);else {let c=t;(typeof c.bindTo!="string"||!c.bindTo)&&r.push(`compute[${a}]: missing required "bindTo" property`),(typeof c.expr!="string"||!c.expr)&&r.push(`compute[${a}]: missing required "expr" string (JSONata expression)`);}}):r.push("compute: must be an array of compute steps")),s.source_defs!=null)if(!Array.isArray(s.source_defs))r.push("source_defs: must be an array");else {let t=new Set,a=new Set;s.source_defs.forEach((c,l)=>{if(!c||typeof c!="object"||Array.isArray(c))r.push(`source_defs[${l}]: must be an object`);else {let m=c;typeof m.bindTo!="string"||!m.bindTo?r.push(`source_defs[${l}]: missing required "bindTo" property`):(t.has(m.bindTo)&&r.push(`source_defs[${l}]: bindTo "${m.bindTo}" is not unique across source_defs`),t.add(m.bindTo)),typeof m.outputFile!="string"||!m.outputFile?r.push(`source_defs[${l}]: missing required "outputFile" property`):(a.has(m.outputFile)&&r.push(`source_defs[${l}]: outputFile "${m.outputFile}" is not unique across source_defs`),a.add(m.outputFile)),m.optionalForCompletionGating!=null&&typeof m.optionalForCompletionGating!="boolean"&&r.push(`source_defs[${l}]: optionalForCompletionGating must be a boolean`);}});}if(s.view!=null)if(typeof s.view!="object"||Array.isArray(s.view))r.push("view: must be an object");else {let t=s.view;!Array.isArray(t.elements)||t.elements.length===0?r.push("view.elements: required, must be a non-empty array"):t.elements.forEach((a,c)=>{if(!a||typeof a!="object"){r.push(`view.elements[${c}]: must be an object`);return}!a.kind||typeof a.kind!="string"?r.push(`view.elements[${c}].kind: required, must be a string`):P.has(a.kind)||r.push(`view.elements[${c}].kind: unknown kind "${a.kind}". Valid: ${[...P].join(", ")}`),a.data!=null&&(typeof a.data!="object"||Array.isArray(a.data))&&r.push(`view.elements[${c}].data: must be an object`);}),t.layout!=null&&(typeof t.layout!="object"||Array.isArray(t.layout))&&r.push("view.layout: must be an object"),t.features!=null&&(typeof t.features!="object"||Array.isArray(t.features))&&r.push("view.features: must be an object");}return {ok:r.length===0,errors:r}}async function ge(e,r){if(!e||e.length===0)return [];let s={card_data:r.card_data??{},requires:r.requires??{}};return Promise.all(e.map(async t=>{let a={};if(t.projections&&typeof t.projections=="object"&&!Array.isArray(t.projections)){for(let[c,l]of Object.entries(t.projections))if(typeof l=="string"&&l.trim().length>0)try{a[c]=await L(l).evaluate(s);}catch{a[c]=void 0;}}return {...t,_projections:a}}))}function ye(e,r){if(!e||e.length===0)return [];let s={card_data:r.card_data??{},requires:r.requires??{}};return e.map(t=>{let a={};if(t.projections&&typeof t.projections=="object"&&!Array.isArray(t.projections)){for(let[c,l]of Object.entries(t.projections))if(typeof l=="string"&&l.trim().length>0)try{a[c]=V(l).evaluate(s);}catch{a[c]=void 0;}}return {...t,_projections:a}})}var z={run:ce,runSync:ue,eval:pe,resolve:le,validate:me,enrichSources:ge,enrichSourcesSync:ye};function _(e,r){if(e?.status==="success")return Object.prototype.hasOwnProperty.call(e,"data")?e.data:void 0;throw e?.status==="fail"||e?.status==="error"?new Error(e.error||`${r} failed`):new Error(`${r} returned an unexpected response`)}function we(e,r){if(e?.status==="success"&&Object.prototype.hasOwnProperty.call(e,"data"))return e.data;throw e?.status==="success"?new Error(`${r} returned success without data`):e?.status==="fail"||e?.status==="error"?new Error(e.error||`${r} failed`):new Error(`${r} returned an unexpected response`)}function d(e){return e&&typeof e=="object"&&!Array.isArray(e)?e:{}}function C(e){return Array.isArray(e)?e:[]}function O(e,r){if(typeof r!="string"||r.length===0)return;let s=e,t=r;t.startsWith("fetched_sources.")&&(s=d(e).fetched_sources,t=t.slice(16));for(let a of t.split(".")){if(s==null||typeof s!="object")return;s=s[a];}return s}function F(e,r){let s=d(e.view),t=C(s.elements);return {layout:s.layout,features:s.features,elements:t.map((a,c)=>{let l=d(a),m=d(l.data),q=typeof l.visible=="string"?!!O(r,l.visible):true,S=typeof m.bind=="string"?m.bind:void 0,I=S?O(r,S):void 0,x={id:typeof l.id=="string"&&l.id?l.id:`element-${c}`,kind:l.kind,label:l.label,visible:q};return S&&(x.bind=S),Array.isArray(m.columns)&&(x.columns=m.columns),typeof m.maxRows=="number"&&(x.maxRows=m.maxRows),I!==void 0&&(x.resolved=Array.isArray(I)&&typeof x.maxRows=="number"?I.slice(0,x.maxRows):I),x})}}function W(e,r){let s=typeof e.id=="string"&&e.id?e.id:"card",t=C(e.provides),a=t.length>0?t:[{bindTo:s,ref:"card_data"}],c={};for(let l of a){let m=d(l),q=typeof m.bindTo=="string"?m.bindTo:"",S=typeof m.ref=="string"?m.ref:"";if(!q||!S)continue;let I=O(r,S);I!==void 0&&(c[q]=I);}return c}function be(e){if(typeof e!="string"||!e.trim())return null;let r=/^(file uploaded|AI generated|AI geneterated):\s*.*?#(\d+)\s*$/i.exec(e.trim());if(!r)return null;let s=Number.parseInt(r[2],10);return !Number.isInteger(s)||s<0?null:s}function Ce(e){return {"card-content":e}}function M(e,r){let s=_(e.get({params:{id:r}}),"cardStore.get"),t=Array.isArray(s?.cards)?s.cards:[];if(t.length===0)throw new Error(`Card "${r}" not found`);return t[0]}function $e(e){let{board:r,nonCore:s,cardStore:t,chatStore:a,uploadCardFile:c,buildFileDownloadUrl:l,readFetchedSourceJsonByRef:m}=e;function q(n){if(Array.isArray(n.bytes))return new Uint8Array(n.bytes.map(o=>Math.max(0,Math.min(255,Number(o)||0))));if(typeof n.text=="string")return new TextEncoder().encode(n.text);if(typeof n.base64=="string"){let o=String(n.base64).replace(/-/g,"+").replace(/_/g,"/"),i=o+"=".repeat((4-o.length%4)%4),g=atob(i);return Uint8Array.from(g,u=>u.charCodeAt(0))}throw new Error("file entry requires bytes, text, or base64")}function S(){let n=d(_(s.describeTaskExecutorCapabilities({}),"describeTaskExecutorCapabilities"));return {version:n.version,commonSourceFields:d(n.commonSourceDefFields),sourceKinds:d(n.sourceKinds)}}function I(){let n=d(_(r.status({}),"status")),o=d(n.summary),i=C(n.cards);return {meta:d(n.meta),summary:{card_count:typeof o.card_count=="number"?o.card_count:0,completed:typeof o.completed=="number"?o.completed:0,eligible:typeof o.eligible=="number"?o.eligible:0,pending:typeof o.pending=="number"?o.pending:0,blocked:typeof o.blocked=="number"?o.blocked:0,in_progress:typeof o.in_progress=="number"?o.in_progress:0,failed:typeof o.failed=="number"?o.failed:0,unresolved:typeof o.unresolved=="number"?o.unresolved:0},cards:i.map(g=>{let u=d(g);return {"card-id":typeof u.name=="string"?u.name:null,status:u.status??null,error:u.error??null,requires:C(u.requires),requires_satisfied:C(u.requires_satisfied),requires_missing:C(u.requires_missing),provides_declared:C(u.provides_declared),provides_runtime:C(u.provides_runtime)}})}}function x(n){let o=String(n.cardId||"").trim();if(!o)throw new Error("inspectCardDefinitionAndRuntime requires cardId");let i=d(_(r.status({}),"status")),u=C(i.cards).map(d).find(f=>f.name===o);if(!u)throw new Error(`card "${o}" not found in board status`);let p=d(M(t,o)),y=C(u.requires_satisfied).filter(f=>typeof f=="string"&&!!f),v=C(u.provides_runtime).filter(f=>typeof f=="string"&&!!f),w=Object.fromEntries(y.map(f=>[f,_(r.getOutputsDataObject({params:{key:f}}),`getOutputsDataObject(${f})`)])),h=Object.fromEntries(v.map(f=>[f,_(r.getOutputsDataObject({params:{key:f}}),`getOutputsDataObject(${f})`)])),R=d(_(r.getOutputsComputedValues({params:{key:o}}),"getOutputsComputedValues")),b=_(r.getOutputsFetchedSources({params:{key:o}}),"getOutputsFetchedSources"),j=C(p.source_defs).map(d),A={};for(let f of j)typeof f.bindTo=="string"&&typeof f.outputFile=="string"&&(A[f.outputFile]=f.bindTo);let k={};for(let[f,T]of Object.entries(b)){let E=A[f]??f;if(!m||typeof T!="string"){k[E]=null;continue}try{k[E]=m({cardId:o,ref:T});}catch{k[E]=null;}}let $={card_data:d(p.card_data),requires:w,fetched_sources:k,computed_values:R};return {cardId:o,card_status_in_board:u,card_definition_and_static_data:p,refs_for_fetched_source_files:b,runtime_data:{requires:w,provides:h,computed_values:R,rendered_view:F(p,$)}}}function J(n){let o=String(n.cardId||"").trim();if(!o)throw new Error("inspectChatMessagesOnCards requires cardId");let i=typeof n.turnId=="string"?n.turnId:"",g=n.allTurns===true,u=typeof n.tailTurnsBeforeId=="string"?n.tailTurnsBeforeId:"",p=g?void 0:n.lastUserTurns??(i?void 0:1),y=n.tail,v={...p===void 0?{}:{tailTurns:p},...i?{turnId:i}:{},...g?{allTurns:true}:{},...u?{tailTurnsBeforeId:u}:{}},w=Object.keys(v).length>0?{params:{cardId:o},body:v}:{params:{cardId:o}},h=_(a.readAll(w),"chatStore.readAll"),R=d(M(t,o)),b=C(d(R.card_data).files).map((k,$)=>({idx:$,stored_name:d(k).stored_name})).filter(k=>typeof k.stored_name=="string"&&k.stored_name.length>0),A=(Array.isArray(h.records)?h.records:[]).map(k=>{let f=d(k.payload),T={...k},E=typeof k?.role=="string"?k.role:typeof f.role=="string"?String(f.role):"",oe=typeof k?.text=="string"?k.text:typeof f.text=="string"?String(f.text):"";if(E==="system"){let B=be(oe);if(B!==null&&b.some(U=>U.idx===B)){let U=`Retrieve using inspect-file-contents --card-id ${o} --file-idx ${B}`;T.retrieval_hint=U,Object.keys(f).length>0&&typeof k.role!="string"&&(T.payload={...f,retrieval_hint:U});}}return T});return {cardId:o,messages:typeof y=="number"&&y>=0?A.slice(-y):A}}function G(n){let o=String(n.cardId||"").trim(),i=Number(n.fileIdx);if(!o)throw new Error("inspectFileContents requires cardId");if(!Number.isInteger(i)||i<0)throw new Error("inspectFileContents requires fileIdx to be a non-negative integer");let g=d(M(t,o)),u=C(d(g.card_data).files).map(d);if(i>=u.length)throw new Error(`attachment index ${i} is out of range for card "${o}"`);let p=u[i],y=typeof p.stored_name=="string"?p.stored_name:null;return {cardId:o,fileIdx:i,downloadUrl:l({cardId:o,fileIdx:i,storedName:y}),...typeof p.name=="string"?{name:p.name}:{},...typeof p.stored_name=="string"?{stored_name:p.stored_name}:{},...typeof p.mime_type=="string"?{mime_type:p.mime_type}:{},...typeof p.size=="number"?{size:p.size}:{},...typeof p.uploaded_at=="string"?{uploaded_at:p.uploaded_at}:{}}}function N(n){return s.validateCardPreflight({body:Ce(n.candidateCardContent)})}function H(n){if(!n.mockRequires||typeof n.mockRequires!="object"||Array.isArray(n.mockRequires))throw new Error("preflightMaterializeCandidateCard requires mockRequires");if(!n.mockFetchedSources||typeof n.mockFetchedSources!="object"||Array.isArray(n.mockFetchedSources))throw new Error("preflightMaterializeCandidateCard requires mockFetchedSources");let o=s.evalCardCompute({body:{"card-content":n.candidateCardContent,"mock-requires":n.mockRequires,"mock-fetched-sources":n.mockFetchedSources}});if(o.status!=="success")return o;let i=d(we(o,"evalCardCompute")),g=d(n.candidateCardContent),u={card_data:d(g.card_data),requires:d(n.mockRequires),fetched_sources:d(n.mockFetchedSources),computed_values:d(i.computed_values)};return {status:"success",data:{cardId:typeof i.cardId=="string"?i.cardId:typeof g.id=="string"?g.id:"(unknown)",ok:i.ok===true,computed_values:d(i.computed_values),errors:C(i.errors).map(p=>{let y=d(p);return {bindTo:typeof y.bindTo=="string"?y.bindTo:"",error:typeof y.error=="string"?y.error:""}}),provides_outputs:W(g,u),rendered_view:F(g,u)}}}function Y(n){return s.probeSourcePreflight({params:{sourceIdx:n.sourceIdx},body:{"card-content":n.candidateCardContent,"mock-projections":n.mockProjections}})}function Q(n){return s.runSourcePreflight({params:{sourceIdx:n.sourceIdx},body:{"card-content":n.candidateCardContent,"mock-projections":n.mockProjections}})}function X(n){let o=String(n.cardId||"").trim();if(!o)throw new Error("preflightRunSingleSourceInLiveCard requires cardId");if(!n.mockRequires||typeof n.mockRequires!="object"||Array.isArray(n.mockRequires))throw new Error("preflightRunSingleSourceInLiveCard requires mockRequires");let i=d(M(t,o)),g=C(i.source_defs).filter(p=>!!p&&typeof p=="object"&&!Array.isArray(p)),u={};if(n.sourceIdx>=0&&n.sourceIdx<g.length){let p=g[n.sourceIdx],y=z.enrichSourcesSync([p],{card_data:d(i.card_data),requires:n.mockRequires});Array.isArray(y)&&y.length>0&&(u=d(y[0]._projections));}return s.runSourcePreflight({params:{sourceIdx:n.sourceIdx},body:{"card-content":i,"mock-requires":n.mockRequires,"mock-projections":u}})}function Z(n){let o=d(_(s.simulateCardCycle({body:{"card-content":n.candidateCardContent,"mock-requires":n.mockRequires}}),"simulateCardCycle")),i=d(n.candidateCardContent),g=d(o.validation),u=C(o.source_probes),p=C(o.projection_errors),y=C(o.compute_errors),v=d(o.computed_values),w={card_data:d(i.card_data),requires:n.mockRequires,fetched_sources:{},computed_values:v},h=[];for(let R of C(g.issues))typeof R=="string"&&R&&h.push(R);for(let R of u){let b=d(R),j=typeof b.bindTo=="string"?b.bindTo:"source",A=typeof b.error=="string"?b.error:"";A&&h.push(`${j}: ${A}`);}for(let R of p){let b=d(R),j=typeof b.bindTo=="string"?b.bindTo:"source",A=typeof b.key=="string"?b.key:"projection",k=typeof b.error=="string"?b.error:"projection failed";h.push(`${j}.${A}: ${k}`);}for(let R of y){let b=d(R),j=typeof b.bindTo=="string"?b.bindTo:"compute",A=typeof b.error=="string"?b.error:"compute failed";h.push(`${j}: ${A}`);}return {status:"success",data:{cardId:typeof o.cardId=="string"?o.cardId:"(unknown)",ok:o.ok===true,issues:h,provides_outputs:W(i,w),rendered_view:F(i,w)}}}function ee(n){let o=String(n.cardId||"").trim();if(!o)throw new Error("manageReadCard requires cardId");let i=_(t.get({params:{id:o}}),"cardStore.get");return Array.isArray(i.cards)?i.cards:[]}function re(n){let o=String(n.cardId||"").trim(),i=String(n.role||"").trim(),g=typeof n.text=="string"?n.text:"",u=typeof n.turn=="string"?n.turn:"";if(!o)throw new Error("manageAddChatEntryAndAnyAttachments requires cardId");if(!i)throw new Error("manageAddChatEntryAndAnyAttachments requires role");let p=C(n.files).map(v=>{let w=d(v),h=String(w.file_name??w.fileName??w.name??"").trim(),R=String(w.content_type??w.contentType??"application/octet-stream");if(!h)throw new Error("file entry requires file_name");return c({cardId:o,fileName:h,contentType:R,bytes:q(w)}).file});p.forEach((v,w)=>{let h=i==="assistant"?`AI generated: ${String(v.name||"")} as ${String(v.stored_name||"")} #${w}`:`file uploaded: ${String(v.name||"")} as ${String(v.stored_name||"")} #${w}`;_(a.append({params:{cardId:o},body:{role:"system",text:h,files:[],turn:u}}),"chatStore.append(system attachment message)");});let y=_(a.append({params:{cardId:o},body:{role:i,text:g,files:p,turn:u}}),"chatStore.append");return {status:"success",data:{cardId:o,id:String(y.id),role:i,turn:u,files:p}}}function te(n){let o=String(n.cardId||"").trim(),i=d(n.candidateCardContent);if(!o)throw new Error("manageUpsertCard requires cardId");if(typeof i.id!="string"||!i.id.trim())throw new Error("candidateCardContent.id must be a non-empty string");if(i.id!==o)throw new Error(`candidateCardContent.id must match cardId (${o})`);let g=N({candidateCardContent:i}),u=d(g),p=d(u.data);if(u.status!=="success"||p.isValid!==true)return {status:"fail",step:"validate",validation:g};let y=null;try{y=M(t,o);}catch{y=null;}let v=t.set({body:i});_(v,"cardStore.set");let w;try{w=r.upsertCard({params:{cardId:o,restart:!0}}),_(w,"upsertCard");}catch(R){try{y&&t.set({body:y});}catch{}throw R}let h=null;try{h=r.cardRefreshedNotify({params:{cardId:o}}),_(h,"cardRefreshedNotify");}catch{h=null;}return {status:"success",data:{validation:g,card_saved:null,board_result:w,refresh_notify:h}}}function ne(n){let o=String(n.cardId||"").trim();if(!o)throw new Error("manageDeprecate requires cardId");let i=r.removeCard({params:{id:o}});return _(i,"removeCard"),i}return {discoverSourceKinds:S,inspectBoardRuntimeStatus:I,inspectCardDefinitionAndRuntime:x,inspectChatMessagesOnCards:J,inspectFileContents:G,preflightValidateCandidateCardDefinition:N,preflightMaterializeCandidateCard:H,preflightProbeSingleSourceInCandidateCard:Y,preflightRunSingleSourceInCandidateCard:Q,preflightRunSingleSourceInLiveCard:X,preflightRunOneCycleWithCandidateCard:Z,manageReadCard:ee,manageAddChatEntryAndAnyAttachments:re,manageUpsertCard:te,manageDeprecate:ne}}export{$e as createBoardLiveCardsMcp};//# sourceMappingURL=board-live-cards-mcp.js.map
+//# sourceMappingURL=board-live-cards-mcp.js.map