@vpxa/aikit 0.1.352 → 0.1.353
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/package.json +1 -1
- package/packages/blocks-core/dist/index.mjs +928 -130
- package/packages/present/dist/index.html +911 -127
- package/packages/server/dist/bin.js +1 -1
- package/packages/server/dist/index.js +1 -1
- package/packages/server/dist/prelude-DetbWo8R.js +1 -0
- package/packages/server/dist/prelude-hfAEi93R.js +2 -0
- package/packages/server/dist/sampling-CWjnUevo.js +2 -0
- package/packages/server/dist/sampling-CnE3owSt.js +1 -0
- package/packages/server/dist/{server-Crfl8sRN.js → server-D5eu57oU.js} +145 -148
- package/packages/server/dist/{server-Znp0a9J2.js → server-D7gZ4K_H.js} +145 -148
- package/packages/server/dist/{server-http-BSGdxVRV.js → server-http-AarbD3gm.js} +1 -1
- package/packages/server/dist/{server-http-BGF1k0j9.js → server-http-wnYmWFkC.js} +1 -1
- package/packages/server/dist/{server-stdio-CTgwgIGC.js → server-stdio-BWoMqXU8.js} +1 -1
- package/packages/server/dist/{server-stdio-B2N-eM5T.js → server-stdio-CBGO6XiO.js} +1 -1
- package/packages/server/viewers/canvas.html +912 -128
- package/packages/server/viewers/report-template.html +885 -101
- package/packages/server/viewers/task-plan-static.html +1 -1
- package/packages/server/viewers/tour-viewer.html +886 -102
- package/scaffold/dist/definitions/skills/c4-architecture.mjs +1 -1
- package/scaffold/dist/definitions/skills/docs.mjs +1 -1
- package/scaffold/dist/generated/block-docs.mjs +18 -64
- package/packages/server/dist/prelude-CXds3AXY.js +0 -2
- package/packages/server/dist/prelude-Cms2H0-F.js +0 -1
- package/packages/server/dist/sampling-BoH5wpOJ.js +0 -1
- package/packages/server/dist/sampling-SoUYZhFs.js +0 -2
|
@@ -28,19 +28,19 @@ import{n as e,t}from"./curated-manager-CBKTmAjM.js";import{a as n,c as r,d as i,
|
|
|
28
28
|
`),mimeType:`text/plain`}]})),e.registerResource(`aikit-channel-surface-schema`,fs,{description:`Composite catalog: ChannelSurface JSON Schema, block types, and resource URIs`,mimeType:`application/json`},async()=>({contents:[{uri:fs,text:_s(await hs()),mimeType:`application/json`}]})),us(e,n),r?(e.registerResource(`aikit-l0-index`,`aikit://l0`,{description:`Index of available L0 briefing cards for the current workspace`,mimeType:`text/markdown`},async()=>({contents:[{uri:`aikit://l0`,text:`# L0 Briefing Cards\n\n${[`- [workspace-core](aikit://l0/workspace-core) — Durable repo facts and session rules`].join(`
|
|
29
29
|
`)}`,mimeType:`text/markdown`}]})),e.registerResource(`aikit-l0-workspace-core`,`aikit://l0/workspace-core`,{description:`Workspace-core briefing card: structure, entry points, key deps, and symbols. Use INSTEAD of read_file for workspace understanding. Auto-regenerated after onboard/produce_knowledge.`,mimeType:`text/markdown`},async()=>{let e=F(r,`workspace-core.md`),t;try{t=N(e)?P(e,`utf-8`):'# workspace-core: not generated\n\nRun `onboard({ path: "." })` or `produce_knowledge({})` to generate this card.'}catch{t=`# workspace-core: error
|
|
30
30
|
|
|
31
|
-
Failed to read card file.`}return{contents:[{uri:`aikit://l0/workspace-core`,text:t,mimeType:`text/markdown`}]}}),ds.debug(`L0 briefing card resources registered`,{l0CardDir:r})):ds.debug(`l0CardDir not configured — L0 resources skipped`)}const ys=[`er_push`,`er_pull`,`er_sync_status`],bs=[...ys,`er_update_policy`,`er_evolve_review`],xs=new Set(bs);function Ss(e){return e.toolProfiles}const Cs=5e3,ws=j(`structured-content-guard`);function Ts(){let e=(async(e,t)=>{let n;try{n=await t()}catch(e){n={content:[{type:`text`,text:`[ERROR:INTERNAL] ${e instanceof Error?e.message:String(e)}`}],isError:!0}}let r=(e.toolConfig??{}).outputSchema;if(r==null)return n;let i=null;if(n.structuredContent==null){let t=Es(r);n.structuredContent=t,i=`synthesize`,n.structuredContent??(n.structuredContent={},i=`synthesize-null-fallback`,ws.error(`synthesizeStructuredContent returned null/undefined — using empty fallback`,{tool:e.toolName}))}let a=Ds(r,n.structuredContent);if(a.action!=null&&(n.structuredContent=a.structuredContent,i=a.action),ks(n.structuredContent)||(n.isError=!0,n.structuredContent={},i=`fallback-error`),Os(r,n.structuredContent)===!1){let e=Es(r);n.structuredContent=e??{},Os(r,n.structuredContent)===!1?(n.structuredContent=ks(n.structuredContent)?n.structuredContent:{},i=`final-validation-failed`):i??=`final-heal`}return n});return e.critical=!0,e}function Es(e){try{return As(e)??{}}catch{return{}}}function Ds(e,t){if(Os(e,t)!==!1)return{structuredContent:t,action:null};try{let n=Es(e);if(ks(n)&&ks(t)){let r={...n,...t};if(Os(e,r)!==!1)return{structuredContent:r,action:`heal`}}return{structuredContent:n,action:`fallback-zero-value`}}catch{return{structuredContent:t,action:null}}}function Os(e,t){let n=e.safeParse;if(typeof n==`function`)try{return n(t).success}catch{return}}function ks(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function As(e){if(!e)return{};if(e.anyOf){let t=e.anyOf.find(e=>e.type!==`null`);return t?As(t):null}let t=e._def?.typeName;if(t&&!e.type)switch(t){case`ZodObject`:{let t={},n=null;try{n=e.shape??(typeof e._def?.shape==`function`?e._def.shape():e._def?.shape)}catch{n=null}if(n)for(let[e,r]of Object.entries(n))try{t[e]=As(r)}catch{t[e]=null}return t}case`ZodArray`:return[];case`ZodString`:return``;case`ZodNumber`:return 0;case`ZodBoolean`:return!1;case`ZodNullable`:return null;case`ZodOptional`:return;case`ZodRecord`:return{};case`ZodEnum`:return e._def?.values?.[0]??``;default:return{}}switch(e.type){case`object`:{let t={},n=e.properties??e.shape;if(n)for(let[e,r]of Object.entries(n))t[e]=As(r);return t}case`array`:return[];case`string`:return``;case`number`:case`integer`:return 0;case`boolean`:return!1;case`nullable`:return null;case`optional`:return;case`record`:return{};case`enum`:return e.options?.[0]??Object.values(e.enum??e._def?.entries??{})[0]??``;default:return{}}}function js(e){if(!e)return{};try{let t=As(e);return ks(t)?t:{}}catch{return{}}}const Ms=Symbol(`toolPipelineState`);function Ns(e){return e[Ms]}function Ps(e,t){e[Ms]=t}function Fs(e,t){return t?async(...n)=>{let r=await e(...n);if(!r||typeof r!=`object`)return r;let i=r;return!(`content`in i)||i.structuredContent!=null&&typeof i.structuredContent==`object`?r:(i.structuredContent=js(t),i.structuredContent??={},r)}:e}function Is(e,t,n=``){let r=Ns(e);if(r){r.pipeline=t,r.prefix=n;return}Ps(e,{originalRegisterTool:e.registerTool.bind(e),pipeline:t,prefix:n}),e.registerTool=(n,r,i)=>{let a=Ns(e),o=a?.prefix?`${a.prefix}${n}`:n;if(!i)return a?.originalRegisterTool(o,r);let s=r?.outputSchema;if((a?.pipeline??t).getMiddlewareNames().length===0){let e=Fs(i,s);return a?.originalRegisterTool(o,r,e)}let c=W(n),l=Fs((a?.pipeline??t).wrap(n,i,r,c),s);return a?.originalRegisterTool(o,r,l)}}const Ls={analyze:1,audit:1,blast_radius:1,changelog:1,check:2,checkpoint:2,codemod:2,config:0,data_transform:1,dead_symbols:1,delegate:3,describe_tool:1,diff_parse:1,digest:1,encode:1,env:0,eval:2,evidence_map:2,file_summary:1,find:1,flow:3,forge_classify:1,forge_ground:2,git_context:1,graph:1,guide:0,health:0,http:1,lane:2,list_tools:1,lookup:1,measure:1,onboard:3,parse_output:1,present:1,process:3,produce_knowledge:3,queue:3,regex_test:1,reindex:3,rename:2,replay:1,restore:2,schema_validate:1,scope_map:1,search:1,search_tools:1,signal:2,session_digest:2,stash:2,status:0,symbol:1,test_run:2,time:0,trace:1,watch:3,web_fetch:1,web_search:1,workset:2};function Rs(e,t){return e.filter(e=>(Ls[e]??0)<=t)}const zs=new Set([`status`,`config`,`guide`,`health`]),Bs={full:{description:`All tools enabled (default)`,includeCategories:[]},safe:{description:`Read-only tools — no file/state modifications`,includeCategories:[`search`,`analysis`,`compression`,`utilities`,`system`,`git`,`flow`],excludeTools:[`reindex`,`onboard`]},research:{description:`Search, analysis, knowledge, and web access`,includeCategories:[`search`,`analysis`,`knowledge`,`compression`,`web`,`system`,`flow`]},minimal:{description:`Essential tools only — search, status, basic operations`,includeCategories:[`search`,`system`],includeTools:[`file_summary`,`check`,`test_run`]},discovery:{description:`Full toolset plus discovery-oriented meta-tools for guided tool exploration`,includeCategories:[],includeTools:[`list_tools`,`describe_tool`,`search_tools`]}};function Vs(e,t){let n=Bs[e];if(n)return n;let r=t?.[e];if(r)return r;throw Error(`Unknown tool profile: ${e}`)}function Hs(e,t,n){return t.includes(`*`)?!0:(n[e]?.category??[]).some(e=>t.includes(e))}function Us(e,t,n,r){if(t.includes(`*`)){for(let t of n)e.add(t);return}for(let i of n)Hs(i,t,r)&&e.add(i)}function Ws(e,t,n){if(t.includes(`*`)){e.clear();return}for(let r of[...e])Hs(r,t,n)&&e.delete(r)}function Gs(e,t,n){if(!e||e.length===0||e.includes(`*`))return new Set(t);let r=new Set;return Us(r,e,t,n),r}function Ks(e,t){return e===void 0?t:t===void 0?e:Math.min(e,t)}function qs(e,t){for(let n of[...e])t[n]?.annotations?.readOnlyHint===!1&&e.delete(n)}function Js(e,t,n=0,r=[]){if(n>10)throw Error(`Tool profile inheritance exceeded max depth 10: ${[...r,e].join(` -> `)}`);if(r.includes(e))throw Error(`Tool profile inheritance cycle detected: ${[...r,e].join(` -> `)}`);let i=Vs(e,t);return Ks(i.extends?Js(i.extends,t,n+1,[...r,e]):void 0,i.maxTier)}function Ys(e,t,n,r){let i=(e,a,o)=>{if(a>10)throw Error(`Tool profile inheritance exceeded max depth 10: ${[...o,e].join(` -> `)}`);if(o.includes(e))throw Error(`Tool profile inheritance cycle detected: ${[...o,e].join(` -> `)}`);let s=Vs(e,r),c=[...o,e],l=s.extends?i(s.extends,a+1,c):Gs(s.includeCategories,t,n);s.extends&&s.includeCategories?.length&&Us(l,s.includeCategories,t,n),s.excludeCategories?.length&&Ws(l,s.excludeCategories,n);for(let e of s.includeTools??[])l.add(e);for(let e of s.excludeTools??[])l.delete(e);return l},a=i(e,0,[]),o=Js(e,r);if(o!==void 0){let e=Rs([...a],o);a.clear();for(let t of e)a.add(t)}for(let e of zs)a.add(e);return e===`safe`&&qs(a,n),a}const Xs=new Set([`search`,`analysis`,`knowledge`,`compression`,`forge`,`presentation`,`execution`,`manipulation`,`session`,`git`,`process`,`system`,`meta`,`utilities`,`web`,`queue`,`flow`]);function Zs(e,t,n,r){let i=process.env.AIKIT_TOOLSET||e.toolProfile||`full`,a=Ys(i,t,n,r);if(e.features&&e.features.length>0){let i=e.features.filter(e=>!Xs.has(e));if(i.length>0)throw Error(`Unknown feature group(s): ${i.join(`, `)}. Valid categories: ${[...Xs].join(`, `)}`);let o={description:`Synthetic profile from features config`,includeCategories:e.features},s=Ys(`_features`,t,n,{...r,_features:o});for(let e of a)!s.has(e)&&!zs.has(e)&&a.delete(e)}if(e.readOnly)for(let e of[...a])n[e]?.annotations?.readOnlyHint===!1&&!zs.has(e)&&a.delete(e);for(let e of zs)a.add(e);return i===`safe`&&qs(a,n),a}const Qs=R.object({mode:R.enum([`wasm`,`regex`,`unknown`]),reason:R.string(),pathsChecked:R.array(R.object({path:R.string(),exists:R.boolean()})),os:R.string(),arch:R.string(),nodeVersion:R.string(),webTreeSitterImportable:R.boolean(),healAttempted:R.boolean(),healSuccess:R.boolean(),healError:R.string().nullable(),initError:R.string().nullable(),wasmDir:R.string().nullable(),grammarCount:R.number()}),$s=R.object({kind:R.enum([`onboard`,`reindex`,`handoff`,`proceed`]),reason:R.string()}),ec=R.object({title:R.string(),insight:R.string(),confidence:R.number()}),tc=R.object({lessons:R.array(ec),conventions:R.array(R.object({title:R.string(),preview:R.string()})),checkpoint:R.string().nullable()});R.object({totalRecords:R.number(),totalFiles:R.number(),lastIndexedAt:R.string().nullable(),onboarded:R.boolean(),onboardDir:R.string(),contentTypes:R.record(R.string(),R.number()),wasmAvailable:R.boolean(),wasmDiagnostics:Qs,graphStats:R.object({nodes:R.number(),edges:R.number()}).nullable(),curatedCount:R.number(),serverVersion:R.string(),scaffoldVersion:R.string().nullable(),workspaceScaffoldVersion:R.string().nullable(),upgradeAvailable:R.boolean(),sessionTokens:R.object({callCount:R.number(),totalInputChars:R.number(),totalOutputChars:R.number(),estInputTokens:R.number(),estTotalTokens:R.number(),startTime:R.string()}).optional(),storeBackend:R.string().optional(),storeDiagnostics:R.object({adapterType:R.string(),vectorSearchEnabled:R.boolean(),ftsEnabled:R.boolean(),degradedMode:R.boolean(),dbPath:R.string(),dbSizeBytes:R.number().nullable(),embeddingDim:R.number(),vectorDtype:R.string()}).nullable().optional(),contextPressure:R.number().min(0).max(100).describe(`0–100 score indicating AI Kit saturation`),nextAction:$s,prelude:tc.nullable().optional()}).catchall(R.any()),R.object({entries:R.array(R.object({path:R.string(),title:R.string(),category:R.string(),tags:R.array(R.string()),version:R.number(),preview:R.string()})),totalCount:R.number()});const nc=R.object({ok:R.boolean(),checks:R.array(R.object({name:R.string(),ok:R.boolean(),message:R.string().optional()}))}),rc=R.object({summary:R.object({totalFiles:R.number(),totalLines:R.number(),totalCodeLines:R.number(),totalFunctions:R.number(),avgComplexity:R.number(),maxComplexity:R.object({value:R.number(),file:R.string()})}),files:R.array(R.object({path:R.string(),lines:R.number(),code:R.number(),complexity:R.number(),functions:R.number()}))}),ic=R.object({platform:R.string(),arch:R.string(),nodeVersion:R.string(),cwd:R.string(),cpus:R.number(),memoryFreeGb:R.number(),memoryTotalGb:R.number()}),ac=R.object({iso:R.string(),unix:R.number(),timezone:R.string(),formatted:R.string()}),oc=R.object({passed:R.boolean(),errorCount:R.number(),warningCount:R.number(),topErrors:R.array(R.string())}),sc=R.object({passed:R.boolean(),tsc:oc,biome:oc}),cc=R.object({name:R.string(),definedIn:R.object({path:R.string(),line:R.number(),kind:R.string(),signature:R.string().optional()}).nullable(),importedBy:R.array(R.object({path:R.string(),line:R.number(),importStatement:R.string()})),referencedIn:R.array(R.object({path:R.string(),line:R.number(),context:R.string(),scope:R.string().optional()})),graphContext:R.object({definingModule:R.string().optional(),importedByModules:R.array(R.string()),siblingSymbols:R.array(R.string())}).nullable()}),lc=R.object({sourcePath:R.string(),contentType:R.string(),score:R.number(),headingPath:R.string().optional(),startLine:R.number().optional(),endLine:R.number().optional(),origin:R.string().optional(),category:R.string().optional(),tags:R.array(R.string()).optional()}),uc=R.object({results:R.array(lc),totalResults:R.number(),searchMode:R.string(),query:R.string(),ref:R.string().optional().describe(`Reusable cache reference for later compact(ref, query)`)}),dc=R.object({path:R.string(),line:R.number().optional(),matchType:R.string(),preview:R.string()}),fc=R.object({matches:R.array(dc),totalMatches:R.number(),pattern:R.string(),truncated:R.boolean(),ref:R.string().optional().describe(`Reusable cache reference for later compact(ref, query)`)}),pc=R.object({path:R.string(),relevance:R.number(),estimatedTokens:R.number(),focusLines:R.array(R.string()).optional()}),mc=R.object({files:R.array(pc),totalFiles:R.number(),totalEstimatedTokens:R.number(),task:R.string()}),hc=R.object({path:R.string(),impact:R.string(),reason:R.string()}),gc=R.object({changedFiles:R.array(R.string()),affectedFiles:R.array(hc),totalAffected:R.number(),riskLevel:R.string()}),_c=R.object({name:R.string(),passed:R.boolean(),message:R.string().optional(),severity:R.string().optional()}),vc=R.object({passed:R.boolean(),score:R.number(),checks:R.array(_c),summary:R.string()}),yc=R.object({id:R.string(),name:R.string(),type:R.string(),sourcePath:R.string().optional()}),bc=R.object({fromId:R.string(),toId:R.string(),fromName:R.string(),toName:R.string(),type:R.string()}),xc=R.object({id:R.string(),name:R.string(),type:R.string()}),Sc=R.object({id:R.string(),nodeCount:R.number(),types:R.record(R.string(),R.number()),samples:R.array(xc)}),Cc=R.object({nodes:R.array(yc),edges:R.array(bc),communities:R.array(Sc).optional(),totalNodes:R.number(),totalEdges:R.number(),query:R.string()}),wc=R.object({symbols:R.array(R.object({name:R.string(),path:R.string(),line:R.number().optional(),kind:R.string()})),totalDead:R.number()});R.object({files:R.number(),packages:R.number(),languages:R.record(R.string(),R.number()),tree:R.string()});const Tc=R.object({gitRoot:R.string(),branch:R.string(),commitCount:R.number(),hasUncommitted:R.boolean(),recentCommits:R.array(R.object({hash:R.string(),message:R.string(),author:R.string(),date:R.string()}))}),Ec=R.object({sourceId:R.string(),value:R.string()}),Dc=R.object({id:R.string(),originalChars:R.number(),keptChars:R.number(),segmentsKept:R.number(),segmentsTotal:R.number()}),Oc=R.object({text:R.string().describe(`The compressed digest text output`),ref:R.string().optional().describe(`Reusable cache reference`),fields:R.record(R.string(),R.array(Ec)),sourceStats:R.array(Dc),totalOriginalChars:R.number(),totalCompressedChars:R.number(),ratio:R.number()}),kc=R.object({passed:R.boolean(),totalTests:R.number(),passedTests:R.number(),failedTests:R.number(),skippedTests:R.number(),duration:R.number().describe(`Duration in milliseconds`),failures:R.array(R.object({name:R.string(),message:R.string(),file:R.string().optional()}))}),Ac=j(`utils:enrich`);async function G(e,t){let n={curated:[],graph:[]},r=t.limit??3,[i,a]=await Promise.allSettled([jc(e,t.query,r),Mc(e,t.filePath)]);return i.status===`fulfilled`?n.curated=i.value:Ac.debug(`Curated enrichment failed`,{error:i.reason}),a.status===`fulfilled`?n.graph=a.value:Ac.debug(`Graph enrichment failed`,{error:a.reason}),n}async function jc(e,t,n){if(!e.store||!t)return[];try{let r=await e.store.ftsSearch(t,{origin:`curated`,limit:n});if(r.length>0)return r.map(e=>Nc(e.record));if(e.embedder){let r=await e.embedder.embedQuery(t);return(await e.store.search(r,{origin:`curated`,limit:n,minScore:.3})).map(e=>Nc(e.record))}return[]}catch(e){return Ac.debug(`Curated enrichment failed`,{error:e}),[]}}async function Mc(e,t){if(!e.graphStore||!t)return[];try{let n=await e.graphStore.findNodes({sourcePath:t,limit:1});if(n.length===0){let r=t.split(/[/\\]/).pop()?.replace(/\.\w+$/,``)||``;if(!r)return[];let i=await e.graphStore.findNodes({namePattern:r,type:`module`,limit:1});if(i.length===0)return[];n.push(i[0])}let r=n[0],i=await e.graphStore.getNeighbors(r.id,{direction:`both`,limit:10}),a=[];for(let e of i.edges){let t=e.fromId===r.id?e.toId:e.fromId,n=i.nodes.find(e=>e.id===t);if(!n)continue;let o=e.fromId===r.id?`->`:`<-`;a.push(`${o} ${e.type}: ${n.name} (${n.type})`)}return a}catch(e){return Ac.debug(`Graph enrichment failed`,{error:e}),[]}}function K(e){let t=[];if(e.curated.length>0){t.push(`**Curated Knowledge:**`);for(let n of e.curated)t.push(`- ${n}`)}if(e.graph.length>0){t.push(`**Graph Context:**`);for(let n of e.graph)t.push(`- ${n}`)}return t.length===0?``:`\n\n---\n### Enrichment\n${t.join(`
|
|
32
|
-
`)}`}function
|
|
31
|
+
Failed to read card file.`}return{contents:[{uri:`aikit://l0/workspace-core`,text:t,mimeType:`text/markdown`}]}}),ds.debug(`L0 briefing card resources registered`,{l0CardDir:r})):ds.debug(`l0CardDir not configured — L0 resources skipped`)}const ys=[`er_push`,`er_pull`,`er_sync_status`],bs=[...ys,`er_update_policy`,`er_evolve_review`],xs=new Set(bs);function Ss(e){return e.toolProfiles}const Cs=5e3,ws=j(`structured-content-guard`);function Ts(){let e=(async(e,t)=>{let n;try{n=await t()}catch(e){n={content:[{type:`text`,text:`[ERROR:INTERNAL] ${e instanceof Error?e.message:String(e)}`}],isError:!0}}let r=(e.toolConfig??{}).outputSchema;if(r==null)return n;let i=null;if(n.structuredContent==null){let t=Es(r);n.structuredContent=t,i=`synthesize`,n.structuredContent??(n.structuredContent={},i=`synthesize-null-fallback`,ws.error(`synthesizeStructuredContent returned null/undefined — using empty fallback`,{tool:e.toolName}))}let a=Ds(r,n.structuredContent);if(a.action!=null&&(n.structuredContent=a.structuredContent,i=a.action),ks(n.structuredContent)||(n.isError=!0,n.structuredContent={},i=`fallback-error`),Os(r,n.structuredContent)===!1){let e=Es(r);n.structuredContent=e??{},Os(r,n.structuredContent)===!1?(n.structuredContent=ks(n.structuredContent)?n.structuredContent:{},i=`final-validation-failed`):i??=`final-heal`}return n});return e.critical=!0,e}function Es(e){try{return As(e)??{}}catch{return{}}}function Ds(e,t){if(Os(e,t)!==!1)return{structuredContent:t,action:null};try{let n=Es(e);if(ks(n)&&ks(t)){let r={...n,...t};if(Os(e,r)!==!1)return{structuredContent:r,action:`heal`}}return{structuredContent:n,action:`fallback-zero-value`}}catch{return{structuredContent:t,action:null}}}function Os(e,t){let n=e.safeParse;if(typeof n==`function`)try{return n(t).success}catch{return}}function ks(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function As(e){if(!e)return{};if(e.anyOf){let t=e.anyOf.find(e=>e.type!==`null`);return t?As(t):null}let t=e._def?.typeName;if(t&&!e.type)switch(t){case`ZodObject`:{let t={},n=null;try{n=e.shape??(typeof e._def?.shape==`function`?e._def.shape():e._def?.shape)}catch{n=null}if(n)for(let[e,r]of Object.entries(n))try{t[e]=As(r)}catch{t[e]=null}return t}case`ZodArray`:return[];case`ZodString`:return``;case`ZodNumber`:return 0;case`ZodBoolean`:return!1;case`ZodNullable`:return null;case`ZodOptional`:return;case`ZodRecord`:return{};case`ZodEnum`:return e._def?.values?.[0]??``;default:return{}}switch(e.type){case`object`:{let t={},n=e.properties??e.shape;if(n)for(let[e,r]of Object.entries(n))t[e]=As(r);return t}case`array`:return[];case`string`:return``;case`number`:case`integer`:return 0;case`boolean`:return!1;case`nullable`:return null;case`optional`:return;case`record`:return{};case`enum`:return e.options?.[0]??Object.values(e.enum??e._def?.entries??{})[0]??``;default:return{}}}function js(e){if(!e)return{};try{let t=As(e);return ks(t)?t:{}}catch{return{}}}const Ms=Symbol(`toolPipelineState`);function Ns(e){return e[Ms]}function Ps(e,t){e[Ms]=t}function Fs(e,t){return t?async(...n)=>{let r=await e(...n);if(!r||typeof r!=`object`)return r;let i=r;return!(`content`in i)||i.structuredContent!=null&&typeof i.structuredContent==`object`?r:(i.structuredContent=js(t),i.structuredContent??={},r)}:e}function Is(e,t,n=``){let r=Ns(e);if(r){r.pipeline=t,r.prefix=n;return}Ps(e,{originalRegisterTool:e.registerTool.bind(e),pipeline:t,prefix:n}),e.registerTool=(n,r,i)=>{let a=Ns(e),o=a?.prefix?`${a.prefix}${n}`:n;if(!i)return a?.originalRegisterTool(o,r);let s=r?.outputSchema;if((a?.pipeline??t).getMiddlewareNames().length===0){let e=Fs(i,s);return a?.originalRegisterTool(o,r,e)}let c=W(n),l=Fs((a?.pipeline??t).wrap(n,i,r,c),s);return a?.originalRegisterTool(o,r,l)}}const Ls={analyze:1,audit:1,blast_radius:1,changelog:1,check:2,checkpoint:2,codemod:2,config:0,data_transform:1,dead_symbols:1,delegate:3,describe_tool:1,diff_parse:1,digest:1,encode:1,env:0,eval:2,evidence_map:2,file_summary:1,find:1,flow:3,forge_classify:1,forge_ground:2,git_context:1,graph:1,guide:0,health:0,http:1,lane:2,list_tools:1,lookup:1,measure:1,onboard:3,parse_output:1,present:1,process:3,produce_knowledge:3,queue:3,regex_test:1,reindex:3,rename:2,replay:1,restore:2,schema_validate:1,scope_map:1,search:1,search_tools:1,signal:2,session_digest:2,stash:2,status:0,symbol:1,test_run:2,time:0,trace:1,watch:3,web_fetch:1,web_search:1,workset:2};function Rs(e,t){return e.filter(e=>(Ls[e]??0)<=t)}const zs=new Set([`status`,`config`,`guide`,`health`]),Bs={full:{description:`All tools enabled (default)`,includeCategories:[]},safe:{description:`Read-only tools — no file/state modifications`,includeCategories:[`search`,`analysis`,`compression`,`utilities`,`system`,`git`,`flow`],excludeTools:[`reindex`,`onboard`]},research:{description:`Search, analysis, knowledge, and web access`,includeCategories:[`search`,`analysis`,`knowledge`,`compression`,`web`,`system`,`flow`]},minimal:{description:`Essential tools only — search, status, basic operations`,includeCategories:[`search`,`system`],includeTools:[`file_summary`,`check`,`test_run`]},discovery:{description:`Full toolset plus discovery-oriented meta-tools for guided tool exploration`,includeCategories:[],includeTools:[`list_tools`,`describe_tool`,`search_tools`]}};function Vs(e,t){let n=Bs[e];if(n)return n;let r=t?.[e];if(r)return r;throw Error(`Unknown tool profile: ${e}`)}function Hs(e,t,n){return t.includes(`*`)?!0:(n[e]?.category??[]).some(e=>t.includes(e))}function Us(e,t,n,r){if(t.includes(`*`)){for(let t of n)e.add(t);return}for(let i of n)Hs(i,t,r)&&e.add(i)}function Ws(e,t,n){if(t.includes(`*`)){e.clear();return}for(let r of[...e])Hs(r,t,n)&&e.delete(r)}function Gs(e,t,n){if(!e||e.length===0||e.includes(`*`))return new Set(t);let r=new Set;return Us(r,e,t,n),r}function Ks(e,t){return e===void 0?t:t===void 0?e:Math.min(e,t)}function qs(e,t){for(let n of[...e])t[n]?.annotations?.readOnlyHint===!1&&e.delete(n)}function Js(e,t,n=0,r=[]){if(n>10)throw Error(`Tool profile inheritance exceeded max depth 10: ${[...r,e].join(` -> `)}`);if(r.includes(e))throw Error(`Tool profile inheritance cycle detected: ${[...r,e].join(` -> `)}`);let i=Vs(e,t);return Ks(i.extends?Js(i.extends,t,n+1,[...r,e]):void 0,i.maxTier)}function Ys(e,t,n,r){let i=(e,a,o)=>{if(a>10)throw Error(`Tool profile inheritance exceeded max depth 10: ${[...o,e].join(` -> `)}`);if(o.includes(e))throw Error(`Tool profile inheritance cycle detected: ${[...o,e].join(` -> `)}`);let s=Vs(e,r),c=[...o,e],l=s.extends?i(s.extends,a+1,c):Gs(s.includeCategories,t,n);s.extends&&s.includeCategories?.length&&Us(l,s.includeCategories,t,n),s.excludeCategories?.length&&Ws(l,s.excludeCategories,n);for(let e of s.includeTools??[])l.add(e);for(let e of s.excludeTools??[])l.delete(e);return l},a=i(e,0,[]),o=Js(e,r);if(o!==void 0){let e=Rs([...a],o);a.clear();for(let t of e)a.add(t)}for(let e of zs)a.add(e);return e===`safe`&&qs(a,n),a}const Xs=new Set([`search`,`analysis`,`knowledge`,`compression`,`forge`,`presentation`,`execution`,`manipulation`,`session`,`git`,`process`,`system`,`meta`,`utilities`,`web`,`queue`,`flow`]);function Zs(e,t,n,r){let i=process.env.AIKIT_TOOLSET||e.toolProfile||`full`,a=Ys(i,t,n,r);if(e.features&&e.features.length>0){let i=e.features.filter(e=>!Xs.has(e));if(i.length>0)throw Error(`Unknown feature group(s): ${i.join(`, `)}. Valid categories: ${[...Xs].join(`, `)}`);let o={description:`Synthetic profile from features config`,includeCategories:e.features},s=Ys(`_features`,t,n,{...r,_features:o});for(let e of a)!s.has(e)&&!zs.has(e)&&a.delete(e)}if(e.readOnly)for(let e of[...a])n[e]?.annotations?.readOnlyHint===!1&&!zs.has(e)&&a.delete(e);for(let e of zs)a.add(e);return i===`safe`&&qs(a,n),a}const Qs=R.object({mode:R.enum([`wasm`,`regex`,`unknown`]),reason:R.string(),pathsChecked:R.array(R.object({path:R.string(),exists:R.boolean()})),os:R.string(),arch:R.string(),nodeVersion:R.string(),webTreeSitterImportable:R.boolean(),healAttempted:R.boolean(),healSuccess:R.boolean(),healError:R.string().nullable(),initError:R.string().nullable(),wasmDir:R.string().nullable(),grammarCount:R.number()}),$s=R.object({kind:R.enum([`onboard`,`reindex`,`handoff`,`proceed`]),reason:R.string()}),ec=R.object({title:R.string(),insight:R.string(),confidence:R.number()}),tc=R.object({lessons:R.array(ec),conventions:R.array(R.object({title:R.string(),preview:R.string()})),checkpoint:R.string().nullable()});R.object({totalRecords:R.number(),totalFiles:R.number(),lastIndexedAt:R.string().nullable(),onboarded:R.boolean(),onboardDir:R.string(),contentTypes:R.record(R.string(),R.number()),wasmAvailable:R.boolean(),wasmDiagnostics:Qs,graphStats:R.object({nodes:R.number(),edges:R.number()}).nullable(),curatedCount:R.number(),serverVersion:R.string(),scaffoldVersion:R.string().nullable(),workspaceScaffoldVersion:R.string().nullable(),upgradeAvailable:R.boolean(),sessionTokens:R.object({callCount:R.number(),totalInputChars:R.number(),totalOutputChars:R.number(),estInputTokens:R.number(),estTotalTokens:R.number(),startTime:R.string()}).optional(),storeBackend:R.string().optional(),storeDiagnostics:R.object({adapterType:R.string(),vectorSearchEnabled:R.boolean(),ftsEnabled:R.boolean(),degradedMode:R.boolean(),dbPath:R.string(),dbSizeBytes:R.number().nullable(),embeddingDim:R.number(),vectorDtype:R.string()}).nullable().optional(),contextPressure:R.number().min(0).max(100).describe(`0–100 score indicating AI Kit saturation`),nextAction:$s,prelude:tc.nullable().optional()}).catchall(R.any());const nc=R.object({ok:R.boolean(),checks:R.array(R.object({name:R.string(),ok:R.boolean(),message:R.string().optional()}))}),rc=R.object({summary:R.object({totalFiles:R.number(),totalLines:R.number(),totalCodeLines:R.number(),totalFunctions:R.number(),avgComplexity:R.number(),maxComplexity:R.object({value:R.number(),file:R.string()})}),files:R.array(R.object({path:R.string(),lines:R.number(),code:R.number(),complexity:R.number(),functions:R.number()}))}),ic=R.object({platform:R.string(),arch:R.string(),nodeVersion:R.string(),cwd:R.string(),cpus:R.number(),memoryFreeGb:R.number(),memoryTotalGb:R.number()}),ac=R.object({iso:R.string(),unix:R.number(),timezone:R.string(),formatted:R.string()}),oc=R.object({passed:R.boolean(),errorCount:R.number(),warningCount:R.number(),topErrors:R.array(R.string())}),sc=R.object({passed:R.boolean(),tsc:oc,biome:oc}),cc=R.object({name:R.string(),path:R.string(),depth:R.number()}),lc=R.object({name:R.string(),definedIn:R.object({path:R.string(),line:R.number(),kind:R.string(),signature:R.string().optional()}).nullable(),importedBy:R.array(R.object({path:R.string(),line:R.number(),importStatement:R.string()})),referencedIn:R.array(R.object({path:R.string(),line:R.number(),context:R.string(),scope:R.string().optional()})),graphContext:R.object({definingModule:R.string().optional(),importedByModules:R.array(R.string()),siblingSymbols:R.array(R.string())}).nullable(),trace:R.object({callers:R.array(cc),callees:R.array(cc)}).nullable(),confidence:R.number().nullable(),method:R.string().nullable(),rationale:R.string().nullable(),error:R.string().optional()}),uc=R.object({symbols:R.array(lc)}),dc=R.object({sourcePath:R.string(),contentType:R.string(),score:R.number(),headingPath:R.string().optional(),startLine:R.number().optional(),endLine:R.number().optional(),origin:R.string().optional(),category:R.string().optional(),tags:R.array(R.string()).optional()}),fc=R.object({results:R.array(dc),totalResults:R.number(),searchMode:R.string(),query:R.string(),ref:R.string().optional().describe(`Reusable cache reference for later compact(ref, query)`)}),pc=R.object({path:R.string(),line:R.number().optional(),matchType:R.string(),preview:R.string()}),mc=R.object({matches:R.array(pc),totalMatches:R.number(),pattern:R.string(),truncated:R.boolean(),ref:R.string().optional().describe(`Reusable cache reference for later compact(ref, query)`)}),hc=R.object({path:R.string(),relevance:R.number(),estimatedTokens:R.number(),focusLines:R.array(R.string()).optional()}),gc=R.object({files:R.array(hc),totalFiles:R.number(),totalEstimatedTokens:R.number(),task:R.string()}),_c=R.object({path:R.string(),impact:R.string(),reason:R.string()}),vc=R.object({changedFiles:R.array(R.string()),affectedFiles:R.array(_c),totalAffected:R.number(),riskLevel:R.string()}),yc=R.object({name:R.string(),passed:R.boolean(),message:R.string().optional(),severity:R.string().optional()}),bc=R.object({passed:R.boolean(),score:R.number(),checks:R.array(yc),summary:R.string()}),xc=R.object({id:R.string(),name:R.string(),type:R.string(),sourcePath:R.string().optional()}),Sc=R.object({fromId:R.string(),toId:R.string(),fromName:R.string(),toName:R.string(),type:R.string()}),Cc=R.object({id:R.string(),name:R.string(),type:R.string()}),wc=R.object({id:R.string(),nodeCount:R.number(),types:R.record(R.string(),R.number()),samples:R.array(Cc)}),Tc=R.object({nodes:R.array(xc),edges:R.array(Sc),communities:R.array(wc).optional(),totalNodes:R.number(),totalEdges:R.number(),query:R.string()}),Ec=R.object({symbols:R.array(R.object({name:R.string(),path:R.string(),line:R.number().optional(),kind:R.string()})),totalDead:R.number()}),Dc=R.object({gitRoot:R.string(),branch:R.string(),commitCount:R.number(),hasUncommitted:R.boolean(),recentCommits:R.array(R.object({hash:R.string(),message:R.string(),author:R.string(),date:R.string()}))}),Oc=R.object({sourceId:R.string(),value:R.string()}),kc=R.object({id:R.string(),originalChars:R.number(),keptChars:R.number(),segmentsKept:R.number(),segmentsTotal:R.number()}),Ac=R.object({text:R.string().describe(`The compressed digest text output`),ref:R.string().optional().describe(`Reusable cache reference`),fields:R.record(R.string(),R.array(Oc)),sourceStats:R.array(kc),totalOriginalChars:R.number(),totalCompressedChars:R.number(),ratio:R.number()}),jc=R.object({passed:R.boolean(),totalTests:R.number(),passedTests:R.number(),failedTests:R.number(),skippedTests:R.number(),duration:R.number().describe(`Duration in milliseconds`),failures:R.array(R.object({name:R.string(),message:R.string(),file:R.string().optional()}))}),Mc=j(`utils:enrich`);async function G(e,t){let n={curated:[],graph:[]},r=t.limit??3,[i,a]=await Promise.allSettled([Nc(e,t.query,r),Pc(e,t.filePath)]);return i.status===`fulfilled`?n.curated=i.value:Mc.debug(`Curated enrichment failed`,{error:i.reason}),a.status===`fulfilled`?n.graph=a.value:Mc.debug(`Graph enrichment failed`,{error:a.reason}),n}async function Nc(e,t,n){if(!e.store||!t)return[];try{let r=await e.store.ftsSearch(t,{origin:`curated`,limit:n});if(r.length>0)return r.map(e=>Fc(e.record));if(e.embedder){let r=await e.embedder.embedQuery(t);return(await e.store.search(r,{origin:`curated`,limit:n,minScore:.3})).map(e=>Fc(e.record))}return[]}catch(e){return Mc.debug(`Curated enrichment failed`,{error:e}),[]}}async function Pc(e,t){if(!e.graphStore||!t)return[];try{let n=await e.graphStore.findNodes({sourcePath:t,limit:1});if(n.length===0){let r=t.split(/[/\\]/).pop()?.replace(/\.\w+$/,``)||``;if(!r)return[];let i=await e.graphStore.findNodes({namePattern:r,type:`module`,limit:1});if(i.length===0)return[];n.push(i[0])}let r=n[0],i=await e.graphStore.getNeighbors(r.id,{direction:`both`,limit:10}),a=[];for(let e of i.edges){let t=e.fromId===r.id?e.toId:e.fromId,n=i.nodes.find(e=>e.id===t);if(!n)continue;let o=e.fromId===r.id?`->`:`<-`;a.push(`${o} ${e.type}: ${n.name} (${n.type})`)}return a}catch(e){return Mc.debug(`Graph enrichment failed`,{error:e}),[]}}function K(e){let t=[];if(e.curated.length>0){t.push(`**Curated Knowledge:**`);for(let n of e.curated)t.push(`- ${n}`)}if(e.graph.length>0){t.push(`**Graph Context:**`);for(let n of e.graph)t.push(`- ${n}`)}return t.length===0?``:`\n\n---\n### Enrichment\n${t.join(`
|
|
32
|
+
`)}`}function Fc(e){let t=Ic(e.metadata,`title`)||e.sourcePath||`Untitled`;return`[${Ic(e.metadata,`category`)}] ${t}: ${e.content.slice(0,200)}`}function Ic(e,t){let n=e?.[t];return typeof n==`string`?n:``}function q(e,t,n){return{content:[{type:`text`,text:`[ERROR:${e}] ${t}`}],isError:!0,...n==null?{}:{structuredContent:n}}}function J(e,t){return async(n,r)=>{let i=Date.now(),a=await t(n,r),o=Date.now()-i;return a._meta={...a._meta??{},durationMs:o,toolName:e},a}}const Lc=j(`tools`),Rc=R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`);function zc(e,t){return t?L(e,t):e}function Bc(){let e=[];return vr.get()||e.push(`Tree-sitter unavailable — using regex fallback, symbol/pattern confidence reduced`),e.length===0?``:`\n\n> **⚠ Caveats:** ${e.join(`; `)}`}function Vc(e){return(e??[]).map(e=>{if(typeof e==`string`)return e;if(e&&typeof e==`object`&&`path`in e)return typeof e.path==`string`?e.path:void 0}).filter(e=>!!e)}function Hc(e){let t=[],n=e.filter(e=>/\.(ts|tsx|js|jsx)$/.test(e)&&/(service|store|model|schema|migration)/i.test(e)),r=e.filter(e=>/\.(ts|tsx|js|jsx)$/.test(e)&&!n.includes(e)),i=e.filter(e=>!/\.(ts|tsx|js|jsx)$/.test(e));return(n.length>0||r.length>0||i.length>0)&&(t.push(`
|
|
33
33
|
|
|
34
34
|
### Risk Assessment`),n.length>0&&t.push(`- 🔴 **High risk** (${n.length}): ${n.slice(0,5).map(e=>`\`${e}\``).join(`, `)}`),r.length>0&&t.push(`- 🟡 **Medium risk** (${r.length}): source files`),i.length>0&&t.push(`- 🟢 **Low risk** (${i.length}): non-source files`)),t.join(`
|
|
35
|
-
`)}function
|
|
35
|
+
`)}function Uc(e){let t=e.replace(/\\/g,`/`);return/(^|\/)__tests__\/|\.(test|spec)\.[jt]sx?$/i.test(t)?`Tests`:/(controller|route|handler|api)/i.test(t)?`API`:/(service|store|model|schema|migration|repo|repository|db|database)/i.test(t)?`Core/Data`:/\.(ts|tsx|js|jsx)$/.test(t)?`Source`:`Config/Docs`}function Wc(e){if(e.length===0)return``;let t=[`Core/Data`,`API`,`Source`,`Tests`,`Config/Docs`],n=new Map;for(let t of e){let e=Uc(t),r=n.get(e)??[];r.push(t),n.set(e,r)}let r=[`
|
|
36
36
|
|
|
37
37
|
### Layer Classification`];for(let e of t){let t=n.get(e);if(!t?.length)continue;let i=t.slice(0,5).map(e=>`\`${e}\``).join(`, `),a=t.length>5?`, ... and ${t.length-5} more`:``;r.push(`- **${e}** (${t.length}): ${i}${a}`)}return r.join(`
|
|
38
|
-
`)}async function
|
|
38
|
+
`)}async function Gc(e,t){if(!e||t.length===0)return[];let n=new Set;for(let r of t){let i=await e.findNodes({sourcePath:r,limit:10});for(let r of i){let i=await e.getNeighbors(r.id,{direction:`incoming`,edgeType:`imports`});for(let e of i.nodes){let r=e.sourcePath??e.name;t.includes(r)||n.add(r)}}}return[...n]}async function Kc(e,t,n,r,i){try{let a=`produced/analysis/${n}/${we(r,12)}.md`,o=Je(`sha256`).update(i).digest(`hex`).slice(0,16),s=new Date().toISOString(),c=i.length>2e3?i.split(/(?=^## )/m).filter(e=>e.trim().length>0):[i],l=c.map((e,t)=>({id:Je(`sha256`).update(`${a}::${t}`).digest(`hex`).slice(0,16),content:e.trim(),sourcePath:a,contentType:`produced-knowledge`,chunkIndex:t,totalChunks:c.length,startLine:0,endLine:0,fileHash:o,indexedAt:s,origin:`produced`,tags:[`analysis`,n],category:`analysis`,version:1})),u=await t.embedBatch(l.map(e=>e.content));await e.upsert(l,u),Lc.info(`Auto-persisted analysis`,{analyzerName:n,chunkCount:l.length})}catch(e){Lc.warn(`Auto-persist analysis failed`,{analyzerName:n,...M(e)})}}const qc=R.enum([`structure`,`dependencies`,`symbols`,`patterns`,`entry_points`,`diagram`]),Jc=R.string().describe(`Root path to analyze`),Yc=R.boolean().default(!1).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default false — set true when you need stored decisions, conventions, or relationship context.`),Xc=R.object({path:Jc,max_depth:R.number().min(1).max(10).default(6).describe(`Maximum directory depth`),format:R.enum([`json`,`markdown`]).default(`markdown`).describe(`Output format`),max_tokens:Rc,enrich:Yc}),Zc=R.object({path:Jc,format:R.enum([`json`,`markdown`,`mermaid`]).default(`markdown`).describe(`Output format`),max_tokens:Rc,enrich:Yc}),Qc=R.object({path:Jc,filter:R.string().optional().describe(`Filter symbols by name substring`),format:R.enum([`json`,`markdown`]).default(`markdown`).describe(`Output format`),enrich:Yc}),$c=R.object({path:Jc,enrich:Yc}),el=R.object({path:Jc,enrich:Yc}),tl=R.object({path:Jc,diagram_type:R.enum([`architecture`,`dependencies`]).default(`architecture`).describe(`Type of diagram`),enrich:Yc}),nl=R.object({path:Jc,aspect:qc.describe(`Analysis aspect to execute`),max_depth:R.number().min(1).max(10).optional(),format:R.enum([`json`,`markdown`,`mermaid`]).optional(),filter:R.string().optional().describe(`Filter symbols by name substring`),diagram_type:R.enum([`architecture`,`dependencies`]).optional().describe(`Type of diagram when aspect="diagram"`)}),rl=R.object({items:R.array(nl).min(1).describe(`Array of analysis requests to run in batch.`),max_tokens:Rc,enrich:Yc});async function il(e,t,n,r){return!n||!r?e:e+K(await G(r,{query:t,filePath:t}))}async function al(e,{store:t,embedder:n,enrichDeps:r}){let i=new hr,{path:a,max_depth:o,format:s,max_tokens:c,enrich:l}=Xc.parse(e),u=await i.analyze(a,{format:s,maxDepth:o,maxTokens:c});Kc(t,n,`structure`,a,u.output);let d=u.data;return{content:[{type:`text`,text:zc(await il(u.output+'\n\n---\n_Analysis auto-saved to AI Kit memory. Next: Use `analyze({ aspect: "dependencies", ... })` for import graphs, or `analyze({ aspect: "patterns", ... })` to detect architecture patterns._',a,l,r),c)}],structuredContent:{files:d.fileCount??u.meta.fileCount,packages:d.packageCount??0,languages:d.languages??{},tree:u.output.slice(0,2e3)}}}async function ol(e,{store:t,embedder:n,enrichDeps:r}){let i=new ur,{path:a,format:o,max_tokens:s,enrich:c}=Zc.parse(e),l=await i.analyze(a,{format:o});return Kc(t,n,`dependencies`,a,l.output),{content:[{type:`text`,text:zc(await il(l.output+'\n\n---\n_Analysis auto-saved to AI Kit memory. Next: Use `analyze({ aspect: "symbols", ... })` to explore exported symbols, or `analyze({ aspect: "diagram", ... })` for visual representation._',a,c,r),s)}]}}async function sl(e,{store:t,embedder:n,enrichDeps:r}){let i=new gr,{path:a,filter:o,format:s,enrich:c}=Qc.parse(e),l=await i.analyze(a,{format:s,filter:o});return Kc(t,n,`symbols`,a,l.output),{content:[{type:`text`,text:await il(l.output+Bc()+'\n\n---\n_Analysis auto-saved to AI Kit memory. Next: Use `analyze({ aspect: "dependencies", ... })` to see import relationships, or `search` to find usage patterns._',a,c,r)}]}}async function cl(e,{store:t,embedder:n,enrichDeps:r}){let i=new mr,{path:a,enrich:o}=$c.parse(e),s=await i.analyze(a);return Kc(t,n,`patterns`,a,s.output),{content:[{type:`text`,text:await il(s.output+Bc()+'\n\n---\n_Analysis auto-saved to AI Kit memory. Next: Use `analyze({ aspect: "entry_points", ... })` to find Lambda handlers and main exports, or `produce_knowledge` for full analysis._',a,o,r)}]}}async function ll(e,{store:t,embedder:n,enrichDeps:r}){let i=new fr,{path:a,enrich:o}=el.parse(e),s=await i.analyze(a);return Kc(t,n,`entry-points`,a,s.output),{content:[{type:`text`,text:await il(s.output+Bc()+'\n\n---\n_Analysis auto-saved to AI Kit memory. Next: Use `analyze({ aspect: "dependencies", ... })` to see what each entry point imports, or `produce_knowledge` for comprehensive analysis._',a,o,r)}]}}async function ul(e,{store:t,embedder:n,enrichDeps:r}){let i=new dr,{path:a,diagram_type:o,enrich:s}=tl.parse(e),c=await i.analyze(a,{diagramType:o});return Kc(t,n,`diagram`,a,c.output),{content:[{type:`text`,text:await il(c.output+'\n\n---\n_Analysis auto-saved to AI Kit memory. Next: Use `analyze({ aspect: "structure", ... })` for detailed file tree, or `produce_knowledge` for comprehensive analysis._',a,s,r)}]}}async function dl(e,t,n){switch(e){case`structure`:return al(t,n);case`dependencies`:return ol(t,n);case`symbols`:return sl(t,n);case`patterns`:return cl(t,n);case`entry_points`:return ll(t,n);case`diagram`:return ul(t,n)}}function fl(e,t,n,r){let i=W(`analyze`);e.registerTool(`analyze`,{title:i.title,description:"Analyze a codebase using one of the supported aspects. Set `aspect` to structure, dependencies, symbols, patterns, entry_points, or diagram.",inputSchema:rl.shape,annotations:i.annotations},J(`analyze`,async e=>{try{let i=rl.parse(e);if(!i.items||i.items.length===0)return q(`VALIDATION`,`"items[]" is required.`);let a=await Promise.allSettled(i.items.map(async e=>{let a={...e,enrich:i.enrich,max_tokens:i.max_tokens};return dl(e.aspect,a,{store:t,embedder:n,enrichDeps:r})})),o=[],s=[];for(let e=0;e<a.length;e++){let t=a[e],n=i.items[e],r=`${n.aspect}:${n.path}`;if(t.status===`fulfilled`){let i=t.value.content[0]?.text??``;o.push(`## ${e+1}. ${r}\n${i}`),s.push({aspect:n.aspect,path:n.path,...`structuredContent`in t.value?t.value.structuredContent:{}})}else{let i=t.reason instanceof Error?t.reason.message:String(t.reason);o.push(`## ${e+1}. ${r}\nERROR: ${i}`),s.push({aspect:n.aspect,path:n.path,error:i})}}return{content:[{type:`text`,text:o.join(`
|
|
39
39
|
|
|
40
|
-
`)}],structuredContent:{items:s}}}catch(e){return
|
|
41
|
-
`),p.length>20&&(m+=`\n- ... and ${p.length-20} more`))}catch{}let h=
|
|
40
|
+
`)}],structuredContent:{items:s}}}catch(e){return Lc.error(`Analysis failed`,M(e)),q(`INTERNAL`,`Analysis failed: ${e instanceof Error?e.message:String(e)}`)}}))}function pl(e,t,n,r,i){let a=new lr,o=W(`blast_radius`);e.registerTool(`blast_radius`,{title:o.title,description:`Given a list of changed files, trace the dependency graph to find all affected files (direct + transitive importers) and their tests. Useful for scoping code reviews and impact analysis.`,outputSchema:vc,inputSchema:{path:R.string().describe(`Root path of the codebase`),files:R.array(R.string()).optional().describe(`Changed file paths (relative to root). If omitted, auto-detects from git status.`),max_depth:R.number().min(1).max(20).default(5).describe(`Maximum transitive dependency depth`),format:R.enum([`json`,`markdown`]).default(`markdown`).describe(`Output format`),max_tokens:Rc,enrich:R.boolean().default(!0).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default true for planning tools — set false to save tokens when enrichment is not needed.`)},annotations:o.annotations},J(`blast_radius`,async({path:e,files:o,max_depth:s,format:c,max_tokens:l,enrich:u})=>{try{let d=o??[];if(d.length===0)try{let t=await It({cwd:e,includeDiff:!1});if(d=Array.from(new Set([...Vc(t.status?.staged),...Vc(t.status?.modified),...Vc(t.status?.untracked)])),d.length===0)return{content:[{type:`text`,text:"No changed files detected from git status. Provide `files` explicitly or make changes first."}]}}catch{return q(`VALIDATION`,"Could not detect changed files from git. Provide `files` explicitly.")}let f=await a.analyze(e,{files:d,maxDepth:s,format:c}),p=[],m=``;if(r)try{p=await Gc(r,d),p.length>0&&(m=`\n\n### Graph-discovered importers (${p.length})\n`+p.slice(0,20).map(e=>`- \`${e}\``).join(`
|
|
41
|
+
`),p.length>20&&(m+=`\n- ... and ${p.length-20} more`))}catch{}let h=Wc(d),g=Hc(d),_=f.output+m+h+g+Bc()+'\n\n---\n_Analysis auto-saved to AI Kit memory. Next: Use `analyze({ aspect: "dependencies", ... })` to see the full import graph, or `analyze({ aspect: "symbols", ... })` to inspect affected exports._';if(u&&i){let t=await G(i,{query:e,filePath:e});_+=K(t)}Kc(t,n,`blast-radius`,e,_);let v=p.map(e=>({path:e,impact:`transitive`,reason:`imports changed file`})),y=d.length>10?`high`:d.length>3?`medium`:`low`;return{content:[{type:`text`,text:zc(_,l)}],structuredContent:{changedFiles:d,affectedFiles:v,totalAffected:v.length,riskLevel:y}}}catch(e){return Lc.error(`Blast radius analysis failed`,M(e)),q(`INTERNAL`,`Blast radius analysis failed: ${e instanceof Error?e.message:String(e)}`)}}))}const ml=j(`task-manager`);let hl=0;function gl(e){let t=typeof e?.sendNotification==`function`;return{createTask(n,r){let i=`aikit-task-${++hl}`,a=(n,r,a)=>{t&&e.sendNotification?.({method:`notifications/progress`,params:{progressToken:i,progress:n,total:r,...a?{message:a}:{}}}).catch(e=>{ml.debug(`Progress notification failed`,{token:i,error:String(e)})})};return t&&ml.debug(`Task created`,{token:i,title:n,totalSteps:r}),{progress(e,t){a(e,r,t??`${n}: step ${e+1}/${r}`)},complete(e){a(r,r,e??`${n}: complete`)},fail(e){a(r,r,e??`${n}: failed`)}}}}}const _l=j(`tools`);function vl(e,t,n,r){let i=W(`audit`);e.registerTool(`audit`,{title:i.title,description:`Run a unified audit: structure, dependencies, patterns, health, dead_symbols, check, entry_points. Returns synthesized report with score, recommendations, and next steps. 6 round-trips → 1.`,outputSchema:bc,inputSchema:{path:R.string().default(`.`).describe(`Root path to audit`),checks:R.array(R.enum([`structure`,`dependencies`,`patterns`,`health`,`dead_symbols`,`check`,`entry_points`])).optional().describe(`Which checks to run (default: all)`),detail:R.enum(ye).optional().describe(`'efficient' for overview (~500 tokens), 'full' includes pattern table`)},annotations:i.annotations},async({path:e,checks:i,detail:a},o)=>{try{let s=await nt(t,n,{path:e,checks:i,detail:a??r??`efficient`});return gl(o).createTask(`Audit`,1).complete(`Audit complete: ${s.data?.recommendations?.length??0} recommendations`),{content:[{type:`text`,text:s.ok?`${s.summary}\n\n---\n_Audit score: ${s.data?.score}/100 | ${s.meta.durationMs}ms${s.next&&s.next.length>0?` | Next: ${s.next.map(e=>`\`${e.tool}\` (${e.reason})`).join(`, `)}`:``}_`:s.error?.message??`Audit failed`}],isError:!s.ok,...s.ok&&s.data?{structuredContent:{passed:s.ok,score:s.data.score??0,checks:(s.data.recommendations??[]).map(e=>({name:e.area,passed:e.priority!==`high`,message:e.message,severity:e.priority})),summary:s.summary??``}}:{}}}catch(e){return _l.error(`Audit failed`,M(e)),q(`INTERNAL`,`Audit failed: ${e instanceof Error?e.message:String(e)}`)}})}const yl=j(`tools`);function bl(e){if(!e?.enabled)return;let t=process.env.AIKIT_ER_API_KEY;if(!t){yl.warn(`ER bridge enabled but AIKIT_ER_API_KEY not set; disabling`);return}return{enabled:!0,baseUrl:e.baseUrl,apiKey:t,timeoutMs:e.timeoutMs??5e3,cacheTtlMs:e.cacheTtlMs??360*60*1e3,cacheMaxEntries:e.cacheMaxEntries??100,fallbackThreshold:e.fallbackThreshold??.45}}function xl(e){let t=bl(e);if(t)try{let e=new xr(t),n=new br({maxEntries:t.cacheMaxEntries,defaultTtl:t.cacheTtlMs}),r=new wr(e);try{let e=new URL(t.baseUrl).hostname;yl.info(`ER bridge initialized`,{host:e})}catch{yl.info(`ER bridge initialized`)}return{client:e,cache:n,pushAdapter:r,config:t}}catch(e){yl.warn(`ER bridge initialization failed`,M(e));return}}function Sl(e,t,n){let r=W(`er_push`);e.registerTool(`er_push`,{title:r.title,description:`Push a curated knowledge entry to Enterprise RAG. The entry is stored via ER's curated_remember tool and becomes immediately searchable in the enterprise AI Kit.`,inputSchema:{title:R.string().min(3).max(120).describe(`Title for the knowledge entry`),content:R.string().min(10).max(1e5).describe(`Markdown content to push (max 100KB)`),category:R.string().regex(/^[a-z][a-z0-9-]*$/).default(`conventions`).describe(`Category slug (e.g., "decisions", "patterns", "conventions")`),tags:R.array(R.string()).default([]).describe(`Optional tags`),rule_id:R.string().optional().describe(`ID of the classification rule that motivated this push (from remember classification signals). Improves rule effectiveness tracking.`)},annotations:r.annotations},J(`er_push`,async({title:e,content:r,category:i,tags:a,rule_id:o})=>{try{let s=`${i}/${e.toLowerCase().replace(/[^a-z0-9]+/g,`-`)}`,c=await t.pushAdapter.push(s,{title:e,content:r,category:i,tags:a});return c.pushed?(n&&n.recordPush(s,c.pushed,o),{content:[{type:`text`,text:`Pushed to ER: **${e}**\n\nRemote path: \`${c.remotePath??`unknown`}\`\nTimestamp: ${c.timestamp}\n\n---\n_Next: Use \`er_pull\` to verify the entry is searchable in ER, or \`er_sync_status\` to see push history._`}]}):(n&&n.recordPush(s,!1,o),q(`INTERNAL`,`ER push failed: ${c.error??`Unknown error`}\n\n_The local AI Kit is unaffected. You can retry or check ER health with \`er_sync_status\`._`))}catch(t){if(yl.error(`ER push failed`,M(t)),n){let t=`${i}/${e.toLowerCase().replace(/[^a-z0-9]+/g,`-`)}`;n.recordPush(t,!1,o)}return q(`INTERNAL`,`ER push failed: operation unsuccessful
|
|
42
42
|
|
|
43
|
-
_The local AI Kit is unaffected. You can retry or check ER health with \`er_sync_status\`._`)}}))}function
|
|
43
|
+
_The local AI Kit is unaffected. You can retry or check ER health with \`er_sync_status\`._`)}}))}function Cl(e,t){let n=W(`er_pull`);e.registerTool(`er_pull`,{title:n.title,description:`Explicitly search the Enterprise RAG AI Kit. Returns results from the enterprise system only (not local AI Kit). Uses a cache with 6-hour TTL to reduce API calls.`,inputSchema:{query:R.string().min(1).max(2e3).describe(`Search query for Enterprise RAG AI Kit (max 2000 chars)`),max_results:R.number().min(1).max(20).default(5).describe(`Maximum results to return`),bypass_cache:R.boolean().default(!0).describe(`Skip cache and fetch fresh results from ER (default: true per DR-001)`)},annotations:n.annotations},J(`er_pull`,async({query:e,max_results:n,bypass_cache:r})=>{try{if(!r){let r=t.cache.get(e);if(r)return{content:[{type:`text`,text:`${r.slice(0,n).map((e,t)=>`### Result ${t+1} (score: ${e.score.toFixed(3)}, source: ER cached)\n- **Source**: ${e.sourcePath}\n\n${e.content}`).join(`
|
|
44
44
|
|
|
45
45
|
---
|
|
46
46
|
|
|
@@ -48,15 +48,15 @@ _The local AI Kit is unaffected. You can retry or check ER health with \`er_sync
|
|
|
48
48
|
|
|
49
49
|
---
|
|
50
50
|
|
|
51
|
-
`)}\n\n---\n_Source: Enterprise RAG (${i.length} results) | Results cached for ${Math.floor(t.config.cacheTtlMs/36e5)}h_`}]}}catch(e){return
|
|
51
|
+
`)}\n\n---\n_Source: Enterprise RAG (${i.length} results) | Results cached for ${Math.floor(t.config.cacheTtlMs/36e5)}h_`}]}}catch(e){return yl.error(`ER pull failed`,M(e)),q(`INTERNAL`,`ER pull failed: search request unsuccessful
|
|
52
52
|
|
|
53
|
-
_Enterprise RAG may be unavailable. Local AI Kit search is unaffected._`)}}))}function
|
|
53
|
+
_Enterprise RAG may be unavailable. Local AI Kit search is unaffected._`)}}))}function wl(e,t){let n=W(`er_sync_status`);e.registerTool(`er_sync_status`,{title:n.title,description:`Show the status of the Enterprise RAG bridge: health, cache stats, and push history.`,inputSchema:{check_health:R.boolean().default(!0).describe(`Whether to ping ER health endpoint (adds latency)`)},annotations:n.annotations},J(`er_sync_status`,async({check_health:e})=>{try{let n=t.cache.stats(),r=t.pushAdapter.getStatus(),i=new URL(t.config.baseUrl),a=`${i.protocol}//${i.hostname}${i.port?`:${i.port}`:``}`,o=`_Health check skipped_`;if(e){let e=await t.client.health();o=e.healthy?`✅ Healthy (HTTP ${e.status})`:`❌ Unhealthy${e.status?` (HTTP ${e.status})`:``}`}let s=[`## ER Bridge Status
|
|
54
54
|
`,`**Endpoint**: \`${a}\``,`**Health**: ${o}`,`**Threshold**: ${t.config.fallbackThreshold} (vector similarity for auto-fallback)`,``,`### Cache`,`- Entries: ${n.size} / ${n.maxEntries}`,`- TTL: ${Math.floor(n.defaultTtlMs/36e5)}h`,``,`### Push History`,`- Total pushed: ${r.totalPushed}`,`- Successful: ${r.successCount}`,`- Failed: ${r.failCount}`];return r.lastPush&&s.push(`- Last push: "${r.lastPush.title}" at ${r.lastPush.pushedAt} (${r.lastPush.status})`),s.push("\n---\n_Next: Use `er_push` to send knowledge to ER, or `er_pull` to search ER._"),{content:[{type:`text`,text:s.join(`
|
|
55
|
-
`)}]}}catch(e){return
|
|
55
|
+
`)}]}}catch(e){return yl.error(`ER sync status failed`,M(e)),q(`INTERNAL`,`ER sync status failed: ${e instanceof Error?e.message:String(e)}`)}}))}const Tl=j(`tools`);function El(e){let t=[`Compliance score: ${e.score}/100`,`Calls scored: ${e.totalCalls}`,`Summary: ${e.summary}`];if(e.violations.length===0)return`${t.join(`
|
|
56
56
|
`)}\n\nNo violations detected.`;let n=e.violations.map(e=>`- ${e.ruleId} | ${e.tool} | ${e.timestamp}\n ${e.rule}\n Suggestion: ${e.suggestion}`);return`${t.join(`
|
|
57
57
|
`)}\n\nViolations:\n${n.join(`
|
|
58
|
-
`)}`}function
|
|
59
|
-
`)}function
|
|
58
|
+
`)}`}function Dl(e){let t=W(`compliance_score`);e.registerTool(`compliance_score`,{title:t.title,description:`Score replay log compliance against AI Kit tool-routing rules and surface violations with remediation guidance.`,inputSchema:{last_n:R.number().min(1).max(500).default(50).describe(`Maximum number of recent replay entries to score (default: 50)`)},annotations:t.annotations},J(`compliance_score`,async({last_n:e})=>{try{return{content:[{type:`text`,text:El(An(Sn({last:e}),{lastN:e}))}]}}catch(e){return Tl.error(`Compliance score failed`,M(e)),q(`INTERNAL`,`Compliance score failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Y(e){return String(e??``).replace(/&/g,`&`).replace(/</g,`<`).replace(/>/g,`>`).replace(/"/g,`"`)}const Ol=R.object({action:R.enum([`view`,`update`]).default(`view`).describe(`Action to perform: view current configuration or update it`),updates:R.record(R.string(),R.unknown()).optional().describe(`Partial configuration to merge when action is "update". Supports nested paths like { "indexing": { "chunkSize": 2000 } }`)}),kl=j(`config-tool`),Al=`ui://aikit/config.html`,jl=[`serverName`,`toolPrefix`,`autoIndex`,`sources`,`indexing`,`tokenBudget`];function Ml(){let e=process.env.AIKIT_CONFIG_PATH;if(e&&N(e))return e;let t=De();if(t){let e=I(t,`aikit.config.json`);if(N(e))return e}return``}function Nl(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Pl(e,t){let n={...e};for(let[e,r]of Object.entries(t)){let t=n[e];if(Nl(t)&&Nl(r)){n[e]=Pl(t,r);continue}n[e]=r}return n}function Fl(e){return e===void 0?`undefined`:JSON.stringify(e)}function Il(e,t,n,r=``){let i=[];for(let[a,o]of Object.entries(n)){let n=r?`${r}.${a}`:a,s=e[a],c=t[a];if(Nl(o)&&Nl(s)&&Nl(c)){i.push(...Il(s,c,o,n));continue}Fl(s)!==Fl(c)&&i.push(`- ${n}: ${Fl(s)} -> ${Fl(c)}`)}return i}function Ll(e){let t=[];for(let[n,r]of Object.entries(e)){if(n===`store`||n===`embedding`||n===`er`){t.push(`Field "${n}" cannot be updated through this tool because it requires a restart.`);continue}if(n===`onboardDir`||n===`stateDir`||n===`curated`){t.push(`Field "${n}" cannot be updated through this tool because it requires a restart.`);continue}if(n===`autoIndex`){typeof r!=`boolean`&&t.push(`autoIndex must be a boolean.`);continue}if(n===`serverName`||n===`toolPrefix`){typeof r!=`string`&&t.push(`${n} must be a string.`);continue}if(n===`sources`){(!Array.isArray(r)||r.length===0)&&t.push(`sources must be a non-empty array.`);continue}if(n===`indexing`){if(!Nl(r)){t.push(`indexing must be an object.`);continue}for(let[e,n]of Object.entries(r)){if(e!==`chunkSize`&&e!==`chunkOverlap`&&e!==`minChunkSize`&&e!==`concurrency`){t.push(`indexing.${e} is not updatable through this tool.`);continue}(typeof n!=`number`||!Number.isFinite(n)||n<=0)&&t.push(`indexing.${e} must be a positive number.`)}continue}if(n===`tokenBudget`){(typeof r!=`string`||!ye.includes(r))&&t.push(`tokenBudget must be one of: ${ye.join(`, `)}.`);continue}t.push(`Field "${n}" is not updatable through this tool.`)}return t}function Rl(e){let t=[];if(`autoIndex`in e&&typeof e.autoIndex!=`boolean`&&t.push(`autoIndex must be a boolean.`),`serverName`in e&&e.serverName!==void 0&&typeof e.serverName!=`string`&&t.push(`serverName must be a string.`),`toolPrefix`in e&&e.toolPrefix!==void 0&&typeof e.toolPrefix!=`string`&&t.push(`toolPrefix must be a string.`),(!Array.isArray(e.sources)||e.sources.length===0)&&t.push(`sources must be a non-empty array.`),!Nl(e.indexing))return t.push(`indexing must be an object.`),t;for(let n of[`chunkSize`,`chunkOverlap`,`minChunkSize`,`concurrency`]){let r=e.indexing[n];r!==void 0&&(typeof r!=`number`||!Number.isFinite(r)||r<=0)&&t.push(`indexing.${n} must be a positive number.`)}return t}function zl(e){let t=JSON.parse(P(e,`utf-8`));if(!Nl(t))throw Error(`Config file must contain a JSON object.`);return t}function Bl(e,t){return[`AI Kit Configuration`,`Config file: ${t}`,``,JSON.stringify(e,null,2)].join(`
|
|
59
|
+
`)}function Vl(e){return e===void 0?``:Nl(e)||Array.isArray(e)?JSON.stringify(e,null,2):String(e)}function Hl(e){let t=e.metrics??[],n={success:`#22c55e`,warning:`#f59e0b`,error:`#ef4444`,info:`#38bdf8`},r={up:`↑`,down:`↓`,neutral:`→`};return`
|
|
60
60
|
<style>
|
|
61
61
|
.db-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(200px,1fr));gap:14px}
|
|
62
62
|
.db-card{padding:14px;border:1px solid var(--aikit-border,#3c3c3c);border-left-width:4px;border-radius:8px;background:var(--aikit-surface,#252526)}
|
|
@@ -73,7 +73,7 @@ _Enterprise RAG may be unavailable. Local AI Kit search is unaffected._`)}}))}fu
|
|
|
73
73
|
<div class="db-card" style="border-left-color:${t}">
|
|
74
74
|
<div class="db-label">${Y(e.label)}</div>
|
|
75
75
|
${a}
|
|
76
|
-
</div>`}).join(``)}</div>`}function
|
|
76
|
+
</div>`}).join(``)}</div>`}function Ul(e){let t=e.fields??[];return`
|
|
77
77
|
<style>
|
|
78
78
|
.fm-container{display:grid;grid-template-columns:1fr 280px;gap:24px}
|
|
79
79
|
@media(max-width:640px){.fm-container{grid-template-columns:1fr}}
|
|
@@ -138,9 +138,9 @@ _Enterprise RAG may be unavailable. Local AI Kit search is unaffected._`)}}))}fu
|
|
|
138
138
|
}
|
|
139
139
|
});
|
|
140
140
|
})();
|
|
141
|
-
<\/script>`}function
|
|
142
|
-
`)}`}],ui:{type:`resource`,uri:
|
|
143
|
-
`)}`}],ui:{type:`resource`,uri:
|
|
141
|
+
<\/script>`}function Wl(e){return Hl({metrics:Object.entries(e).map(([e,t])=>({label:e,value:Nl(t)||Array.isArray(t)?JSON.stringify(t,null,2):String(t),status:`info`}))})}function Gl(e){return Ul({fields:jl.map(t=>{let n=e[t];return typeof n==`boolean`?{name:t,label:t,type:`select`,options:[`true`,`false`],value:String(n)}:{name:t,label:t,type:Nl(n)||Array.isArray(n)?`textarea`:`text`,value:Vl(n)}})})}function Kl(e,t){return`<!DOCTYPE html><html><head><meta charset="utf-8"><title>${e}</title><style>:root{--aikit-bg:#1e1e1e;--aikit-surface:#252526;--aikit-surface2:#2d2d30;--aikit-border:#3c3c3c;--aikit-text:#e5e7eb;--aikit-muted:#9ca3af;--aikit-accent:#60a5fa;--aikit-success:#22c55e;font-family:system-ui,sans-serif}body{margin:0;padding:20px;background:var(--aikit-bg);color:var(--aikit-text);font-family:system-ui,sans-serif}h2{margin:0 0 16px}</style></head><body><h2>${e}</h2>${t}</body></html>`}function ql(e){let t=``,n=``,r=!1;return function(i,a){t=i,n=a,!r&&(r=!0,Or(e,`AI Kit Config App`,Al,{description:`View and update AI Kit configuration`},async()=>({contents:[{uri:Al,mimeType:Er,text:Kl(t,n)}]})))}}function Jl(e,t){let n=W(`config`),r=ql(e);kr(e,`config`,{title:n.title,description:`View and update AI Kit server configuration. Use action "view" to see current settings, or "update" to modify configuration values. Changes are written to aikit.config.json and take effect on next server restart. Some settings (store, embedding) require a full restart.`,inputSchema:Ol,annotations:n.annotations,_meta:{ui:{resourceUri:Al}}},J(`config`,async e=>{let{action:n,updates:i}=e;if(t.readOnly&&n!==`view`)return q(`PERMISSION`,`Configuration updates are disabled in read-only mode`);if(n===`view`){let e=Ml(),n=e||`(runtime config only; no aikit.config.json found)`;try{let i=e?zl(e):t,a=Bl(i,n);return r(`Configuration`,Wl(i)),{content:[{type:`text`,text:a}],ui:{type:`resource`,uri:Al}}}catch(t){return kl.error(`Failed to read config for view`,{configPath:e,error:t instanceof Error?t.message:String(t)}),{content:[{type:`text`,text:`Failed to read configuration from ${n}: ${t instanceof Error?t.message:String(t)}`}]}}}if(!i)return r(`Configuration Form`,Gl(t)),{content:[{type:`text`,text:`No updates provided. Pass an updates object when action is "update".`}],ui:{type:`resource`,uri:Al}};let a=Ml();if(!a)return r(`Configuration Form`,Gl(t)),{content:[{type:`text`,text:`No config file found to update.`}],ui:{type:`resource`,uri:Al}};let o=Ll(i);if(o.length>0)return r(`Configuration Form`,Gl(zl(a))),{content:[{type:`text`,text:`Configuration update rejected:\n${o.map(e=>`- ${e}`).join(`
|
|
142
|
+
`)}`}],ui:{type:`resource`,uri:Al}};try{let e=zl(a),t=Pl(e,i),n=Rl(t);if(n.length>0)return r(`Configuration Form`,Gl(e)),{content:[{type:`text`,text:`Configuration update rejected:\n${n.map(e=>`- ${e}`).join(`
|
|
143
|
+
`)}`}],ui:{type:`resource`,uri:Al}};Fe(a,JSON.stringify(t,null,2),`utf-8`);let o=Il(e,t,i),s=`Configuration updated successfully.
|
|
144
144
|
|
|
145
145
|
Config file: ${a}
|
|
146
146
|
|
|
@@ -148,32 +148,32 @@ Changed values:
|
|
|
148
148
|
${o.length>0?o.join(`
|
|
149
149
|
`):`- No effective changes; requested values already matched the file.`}
|
|
150
150
|
|
|
151
|
-
These changes take effect on the next server restart.`;return r(`Configuration`,
|
|
152
|
-
`)+"\n\n---\n_Next: Use `search` to dive into specific files, or `compact` to compress file contents for context._";if(s&&r){let t=await G(r,{query:e});l+=K(t)}return{content:[{type:`text`,text:o?L(l,o):l}],structuredContent:{files:c.files.map(e=>({path:e.path,relevance:e.relevance,estimatedTokens:e.estimatedTokens,...e.focusRanges.length>0?{focusLines:e.focusRanges.map(e=>`L${e.start}-${e.end}`)}:{}})),totalFiles:c.files.length,totalEstimatedTokens:c.totalEstimatedTokens,task:e}}}catch(e){return
|
|
151
|
+
These changes take effect on the next server restart.`;return r(`Configuration`,Wl(t)),{content:[{type:`text`,text:s}],ui:{type:`resource`,uri:Al}}}catch(e){return kl.error(`Failed to update config`,{configPath:a,error:e instanceof Error?e.message:String(e)}),{content:[{type:`text`,text:`Failed to update configuration in ${a}: ${e instanceof Error?e.message:String(e)}`}]}}})),r(`Configuration`,Wl(t))}const Yl=j(`cross-workspace`);function Xl(e,t){if(!Te())return[];let n=Ee();if(n.length===0)return[];if(e.includes(`*`))return t?n.filter(e=>e.partition!==t):n;let r=[];for(let i of e){let e=n.find(e=>e.partition===i);if(e){e.partition!==t&&r.push(e);continue}let a=n.filter(e=>e.partition!==t&&e.partition.replace(/-[a-f0-9]{8}$/,``)===i.toLowerCase());r.push(...a)}let i=new Set;return r.filter(e=>i.has(e.partition)?!1:(i.add(e.partition),!0))}async function Zl(e){let t=new Map;for(let n of e){let e=Ce(n.partition),r=F(e,`aikit.db`);try{let e=await Pr({backend:`sqlite-vec`,path:r});await e.initialize(),t.set(n.partition,e)}catch(t){Yl.warn(`Failed to open workspace store`,{partition:n.partition,partitionDir:e,storePath:r,error:M(t)})}}return{stores:t,closeAll:async()=>{for(let[,e]of t)try{await e.close()}catch{}}}}async function Ql(e,t,n){let r=[...e.entries()].map(async([e,r])=>{try{return(await r.search(t,n)).map(t=>({...t,workspace:e}))}catch(t){return Yl.warn(`Cross-workspace search failed for partition`,{partition:e,err:t}),[]}});return(await Promise.all(r)).flat().sort((e,t)=>t.score-e.score).slice(0,n.limit)}async function $l(e,t,n){let r=[...e.entries()].map(async([e,r])=>{try{return(await r.ftsSearch(t,n)).map(t=>({...t,workspace:e}))}catch(t){return Yl.warn(`Cross-workspace FTS search failed for partition`,{partition:e,err:t}),[]}});return(await Promise.all(r)).flat().sort((e,t)=>t.score-e.score).slice(0,n.limit)}function eu(e){return e.toLowerCase().replace(/[-_]/g,``)}function tu(e){let t=Le(e),n=eu(Ie(e));try{let e=Ae(t);for(let r of e)if(eu(r)===n){let e=I(t,r);if(N(e))return e}}catch{}}function nu(e,t,n){if(Re(e))return N(e)?e:tu(e)||e;let r=I(t,e);if(N(r))return r;let i=tu(r);if(i)return i;if(n)for(let r of n){if(r===t)continue;let n=I(r,e);if(N(n))return n;let i=tu(n);if(i)return i}try{let n=Ae(t,{withFileTypes:!0});for(let r of n){if(!r.isDirectory()||r.name.startsWith(`.`)||r.name===`node_modules`)continue;let n=I(t,r.name,e);if(N(n))return n;let i=tu(n);if(i)return i}}catch{}return r}function ru(e){if(e.length!==0)return Rn({kind:`compact`,text:e,originalChars:e.length,compressedChars:e.length})?.ref??void 0}function iu(e,t){return t?`${e}\n\nRef: ${t}`:e}const au=j(`tools:context`);function ou(e){return e instanceof Error?(`code`in e?e.code:void 0)===`ENOENT`||e.message.startsWith(`File not found:`)||e.message.startsWith(`Path not found:`):!1}function su(e,t){return ou(t)?(au.warn(`${e} failed`,{error:`File not found`}),q(`NOT_FOUND`,`File not found`)):(au.error(`${e} failed`,M(t)),q(`INTERNAL`,`${e} failed: ${t instanceof Error?t.message:String(t)}`))}function cu(e,t,n,r){let i=W(`scope_map`);e.registerTool(`scope_map`,{title:i.title,description:`Generate a task-scoped reading plan. Given a task description, identifies which files and sections are relevant, with estimated token counts and suggested reading order.`,outputSchema:gc,inputSchema:{task:R.string().describe(`Description of the task to scope`),max_files:R.number().min(1).max(50).default(15).describe(`Maximum files to include`),content_type:R.enum(fe).optional().describe(`Filter by content type`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:R.boolean().default(!0).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default true for planning tools — set false to save tokens when enrichment is not needed.`)},annotations:i.annotations},J(`scope_map`,async({task:e,max_files:i,content_type:a,max_tokens:o,enrich:s})=>{try{let c=await kn(t,n,{task:e,maxFiles:i,contentType:a}),l=[`## Scope Map: ${e}`,`Total estimated tokens: ~${c.totalEstimatedTokens}`,``,`### Files (by relevance)`,...c.files.map((e,t)=>`${t+1}. **${e.path}** (~${e.estimatedTokens} tokens, ${(e.relevance*100).toFixed(0)}% relevant)\n ${e.reason}\n Focus: ${e.focusRanges.map(e=>`L${e.start}-${e.end}`).join(`, `)}`),``,`### Suggested Reading Order`,...c.readingOrder.map((e,t)=>`${t+1}. ${e}`),``,`### Suggested Compact Calls`,`_Estimated compressed total: ~${Math.ceil(c.totalEstimatedTokens/5)} tokens_`,...c.compactCommands.map((e,t)=>`${t+1}. ${e}`)].join(`
|
|
152
|
+
`)+"\n\n---\n_Next: Use `search` to dive into specific files, or `compact` to compress file contents for context._";if(s&&r){let t=await G(r,{query:e});l+=K(t)}return{content:[{type:`text`,text:o?L(l,o):l}],structuredContent:{files:c.files.map(e=>({path:e.path,relevance:e.relevance,estimatedTokens:e.estimatedTokens,...e.focusRanges.length>0?{focusLines:e.focusRanges.map(e=>`L${e.start}-${e.end}`)}:{}})),totalFiles:c.files.length,totalEstimatedTokens:c.totalEstimatedTokens,task:e}}}catch(e){return su(`Scope map`,e)}}))}function lu(e,t,n,r,i,a){let o=W(`find`);e.registerTool(`find`,{title:o.title,description:`Multi-strategy search combining vector, FTS, glob, and regex. Use for precise queries needing multiple strategies. mode=examples finds real usage of a symbol. For general discovery use search instead.`,outputSchema:mc,inputSchema:{query:R.string().optional().describe(`Semantic/keyword search query (required for mode "examples")`),glob:R.string().optional().describe(`File glob pattern (search mode only)`),pattern:R.string().optional().describe(`Regex pattern to match in content (search mode only)`),limit:R.number().min(1).max(50).default(10).describe(`Max results`),content_type:R.enum(fe).optional().describe(`Filter by content type`),mode:R.enum([`search`,`examples`,`explore`]).default(`search`).describe(`Mode: "search" (default) for federated search, "examples" to find usage examples of a symbol/pattern, "explore" for enriched context with graph neighbors and related symbols`),explore:R.boolean().optional().describe(`Enable explore mode: enriches find results with related context (neighboring symbols, file summaries, dependency info) from the knowledge graph. Can be used alongside mode="search" or standalone.`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),workspaces:R.array(R.string()).optional().describe(`Cross-workspace search: partition names or folder basenames to include. Use ["*"] for all. User-level mode only.`),enrich:R.boolean().default(!1).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default false — set true when you need stored decisions, conventions, or relationship context for the file/query.`)},annotations:o.annotations},J(`find`,async({query:e,glob:o,pattern:s,limit:c,content_type:l,mode:u,max_tokens:d,workspaces:f,enrich:p,explore:m})=>{try{if(u===`examples`){if(!e)return q(`VALIDATION`,`"query" is required for mode "examples".`);let r=await jt(t,n,{query:e,limit:c,contentType:l}),a=ru(JSON.stringify(r)),o=JSON.stringify(a?{ref:a,...r}:r);if(p&&i){let t=await G(i,{query:e});o+=K(t)}return{content:[{type:`text`,text:d?L(o,d):o}]}}if(u===`explore`||m){if(!e)return q(`VALIDATION`,`"query" is required for mode "explore".`);let a=await kt(t,n,{query:e,glob:o,pattern:s,limit:c,contentType:l,cwd:r,explore:!0}),u=[...new Set(a.results.map(e=>e.path))].slice(0,5),f=i?.graphStore?await Promise.allSettled(u.map(async e=>{let t=await G(i,{filePath:e,limit:3});return{filePath:e,graph:t.graph,curated:t.curated}})):[],m=new Map;for(let e of f)e.status===`fulfilled`&&e.value&&m.set(e.value.filePath,{graph:e.value.graph,curated:e.value.curated});let h=`## Explore: ${e}\n\nFound ${a.totalFound} results across ${a.results.length} files.\n\n`;for(let e of a.results.slice(0,c)){let t=e.lineRange?`:${e.lineRange.start}-${e.lineRange.end}`:``;h+=`### ${e.path}${t}\n`,h+=`- **Source:** ${e.source} | **Score:** ${e.score.toFixed(3)}\n`,e.preview&&(h+=`- **Preview:** ${e.preview.slice(0,200).replace(/\n/g,` `)}\n`);let n=m.get(e.path);n?.graph&&n.graph.length>0&&(h+=`- **Related symbols:** ${n.graph.slice(0,4).join(`; `)}\n`),n?.curated&&n.curated.length>0&&(h+=`- **Related knowledge:** ${n.curated.slice(0,2).join(`; `)}\n`),h+=`
|
|
153
153
|
`}if(p&&i){let t=await G(i,{query:e});h+=K(t)}return h+=`
|
|
154
154
|
---
|
|
155
|
-
_Explore mode: results enriched with graph neighbors, related symbols, and curated knowledge._`,{content:[{type:`text`,text:d?L(h,d):h}]}}let h=await kt(t,n,{query:e,glob:o,pattern:s,limit:c,contentType:l,cwd:r}),g=``;if(f&&f.length>0&&e){let n=
|
|
156
|
-
No search strategies were activated. Provide at least one of: query, glob, or pattern.`:``}`;if(p&&i){let n=await G(i,{query:e});t+=K(n)}let n=d?L(t,d):t,r=
|
|
157
|
-
`);if(p&&i){let t=await G(i,{query:e,filePath:h.results[0]?.path});_+=K(t)}let v=d?L(_,d):_,y=
|
|
155
|
+
_Explore mode: results enriched with graph neighbors, related symbols, and curated knowledge._`,{content:[{type:`text`,text:d?L(h,d):h}]}}let h=await kt(t,n,{query:e,glob:o,pattern:s,limit:c,contentType:l,cwd:r}),g=``;if(f&&f.length>0&&e){let n=Xl(f,a);if(n.length>0){let{stores:r,closeAll:i}=await Zl(n);try{let i=await Ql(r,await t.embedQuery(e),{limit:c,contentType:l});for(let e of i)h.results.push({path:`[${e.workspace}] ${e.record.sourcePath}`,score:e.score,source:`cross-workspace`,lineRange:e.record.startLine?{start:e.record.startLine,end:e.record.endLine}:void 0,preview:e.record.content.slice(0,200)});h.results.sort((e,t)=>t.score-e.score),h.results=h.results.slice(0,c),h.totalFound=h.results.length,g=` + ${n.length} workspace(s)`}finally{await i()}}}if(h.results.length===0){let t=`No results found.${h.failedStrategies?.length?`\nStrategies attempted: ${h.strategies.join(`, `)}\nFailed: ${h.failedStrategies.map(e=>`${e.strategy} (${e.reason})`).join(`, `)}`:h.strategies.length===0?`
|
|
156
|
+
No search strategies were activated. Provide at least one of: query, glob, or pattern.`:``}`;if(p&&i){let n=await G(i,{query:e});t+=K(n)}let n=d?L(t,d):t,r=ru(n);return{content:[{type:`text`,text:iu(n,r)}],structuredContent:{matches:[],totalMatches:0,pattern:e??o??s??``,truncated:!1,ref:r}}}let _=[`Found ${h.totalFound} results via ${h.strategies.join(` + `)}${g}`,``,...h.results.map(e=>{let t=e.lineRange?`:${e.lineRange.start}-${e.lineRange.end}`:``,n=e.preview?`\n ${e.preview.slice(0,100)}...`:``;return`- [${e.source}] ${e.path}${t} (${(e.score*100).toFixed(0)}%)${n}`})].join(`
|
|
157
|
+
`);if(p&&i){let t=await G(i,{query:e,filePath:h.results[0]?.path});_+=K(t)}let v=d?L(_,d):_,y=ru(v);return{content:[{type:`text`,text:iu(v,y)}],structuredContent:{matches:h.results.map(e=>({path:e.path,...e.lineRange?{line:e.lineRange.start}:{},matchType:e.source,preview:e.preview?.slice(0,200)??``})),totalMatches:h.totalFound,pattern:e??o??s??``,truncated:h.results.length<h.totalFound,ref:y}}}catch(e){return su(`Find`,e)}}))}function uu(e,t,n,r,i){let a=W(`symbol`);e.registerTool(`symbol`,{title:a.title,description:`Find definition, imports, and references of a named symbol (function, class, type). For tracing data flow across call sites use trace instead. Supports transitive trace with direction and maxDepth parameters when a graph store is available.`,inputSchema:{items:R.array(R.object({name:R.string().describe(`Symbol name to look up`),limit:R.number().min(1).max(50).default(20).optional().describe(`Max results per category`),direction:R.enum([`callers`,`callees`,`both`]).optional().describe(`Transitive trace direction: callers (who calls this), callees (what this calls), or both`),maxDepth:R.number().min(1).max(10).default(2).optional().describe(`Max traversal depth for transitive trace`),edgeKinds:R.array(R.string()).optional().describe(`Filter trace by edge types (e.g., ["imports", "calls"])`),use_llm:R.boolean().default(!1).optional().describe(`Enable Tier 3 LLM disambiguation for ambiguous symbols (uses local Ollama)`)})).nonempty().describe(`Array of symbol names to look up in batch.`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:R.boolean().default(!1).optional().describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens.`)},outputSchema:uc,annotations:a.annotations},J(`symbol`,async({items:e,max_tokens:a,enrich:o})=>{try{if(!e||e.length===0)return q(`VALIDATION`,`"items[]" is required.`);let s=await Promise.allSettled(e.map(e=>Bn(t,n,{name:e.name,limit:e.limit,graphStore:r,direction:e.direction,maxDepth:e.maxDepth,edgeKinds:e.edgeKinds,useLLM:e.use_llm??!1}))),c=[],l=[];for(let t=0;t<s.length;t++){let n=s[t],r=e[t].name;if(n.status===`fulfilled`)c.push(`## ${t+1}. ${r}\n${pu(n.value)}`),l.push({name:n.value.name,definedIn:n.value.definedIn??null,importedBy:n.value.importedBy??[],referencedIn:n.value.referencedIn??[],graphContext:n.value.graphContext??null,trace:n.value.trace??null,confidence:n.value.confidence??null,method:n.value.method??null,rationale:n.value.rationale??null});else{let e=n.reason instanceof Error?n.reason.message:String(n.reason);c.push(`## ${t+1}. ${r}\nERROR: ${e}`),l.push({name:r,definedIn:null,importedBy:[],referencedIn:[],graphContext:null,trace:null,confidence:null,method:null,rationale:null,error:e})}}let u=c.join(`
|
|
158
158
|
|
|
159
|
-
`);if(o&&i){let t=await G(i,{query:`symbols: ${e.map(e=>e.name).join(`, `)}`});u+=K(t)}return{content:[{type:`text`,text:a?L(u,a):u}],structuredContent:{symbols:l}}}catch(e){return
|
|
159
|
+
`);if(o&&i){let t=await G(i,{query:`symbols: ${e.map(e=>e.name).join(`, `)}`});u+=K(t)}return{content:[{type:`text`,text:a?L(u,a):u}],structuredContent:{symbols:l}}}catch(e){return su(`Symbol lookup`,e)}}))}function du(e,t,n,r,i){let a=W(`trace`);function o(e){let t=[`## Trace: ${e.start}`,`Direction: ${e.direction} | Depth: ${e.depth}`,``];if(e.graphContext&&(t.push(`### Graph Context`),e.graphContext.definingModule&&t.push(`- Module: ${e.graphContext.definingModule}`),e.graphContext.community&&t.push(`- Community: ${e.graphContext.community}`),e.graphContext.importedByModules.length>0&&t.push(`- Imported by modules: ${e.graphContext.importedByModules.join(`, `)}`),e.graphContext.siblingSymbols.length>0&&t.push(`- Sibling symbols: ${e.graphContext.siblingSymbols.join(`, `)}`),t.push(``)),e.nodes.length===0)t.push(`No connections found.`);else{let n=e.nodes.filter(e=>e.relationship===`calls`),r=e.nodes.filter(e=>e.relationship===`called-by`),i=e.nodes.filter(e=>e.relationship===`imports`),a=e.nodes.filter(e=>e.relationship===`imported-by`),o=e.nodes.filter(e=>e.relationship===`references`);if(n.length>0){t.push(`### Calls (${n.length})`);for(let e of n){let n=e.scope?` (from ${e.scope}())`:``;t.push(`- ${e.symbol}() — ${e.path}:${e.line}${n}`)}t.push(``)}if(r.length>0){t.push(`### Called by (${r.length})`);for(let e of r){let n=e.scope?` in ${e.scope}()`:``;t.push(`- ${e.symbol}()${n} — ${e.path}:${e.line}`)}t.push(``)}if(i.length>0){t.push(`### Imports (${i.length})`);for(let e of i)t.push(`- ${e.symbol} — ${e.path}:${e.line}`);t.push(``)}if(a.length>0){t.push(`### Imported by (${a.length})`);for(let e of a)t.push(`- ${e.path}:${e.line}`);t.push(``)}if(o.length>0){t.push(`### References (${o.length})`);for(let e of o)t.push(`- ${e.path}:${e.line}`);t.push(``)}}return{lines:t,structured:{start:e.start,direction:e.direction,depth:e.depth,nodes:e.nodes,graphContext:e.graphContext??null}}}e.registerTool(`trace`,{title:a.title,description:`Follow data flow forward/backward across imports and call sites from a starting symbol or file:line. For finding a single symbol definition use symbol instead.`,inputSchema:{items:R.array(R.object({start:R.string().describe(`Starting point — symbol name or file:line reference`),direction:R.enum([`forward`,`backward`,`both`]).describe(`Which direction to trace relationships`),max_depth:R.number().min(1).max(10).default(3).optional().describe(`Maximum trace depth`),edge_kinds:R.array(R.string()).optional().describe(`Filter edges by type (e.g., ["calls", "imports"]). Default: all edge types`)})).min(1).describe(`Array of trace queries to run in batch.`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:R.boolean().default(!1).optional().describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens.`)},annotations:a.annotations},J(`trace`,async({items:e,max_tokens:a,enrich:s})=>{try{if(!e||e.length===0)return q(`VALIDATION`,`"items[]" is required.`);let c=await Promise.allSettled(e.map(e=>Un(t,n,{start:e.start,direction:e.direction??`both`,maxDepth:e.max_depth,graphStore:r,edgeKinds:e.edge_kinds}))),l=[],u=[];for(let t=0;t<c.length;t++){let n=c[t],r=e[t].start;if(n.status===`fulfilled`){let e=o(n.value);l.push(`## ${t+1}. ${r}\n${e.lines.join(`
|
|
160
160
|
`)}`),u.push(e.structured)}else{let e=n.reason instanceof Error?n.reason.message:String(n.reason);l.push(`## ${t+1}. ${r}\nERROR: ${e}`),u.push({start:r,error:e})}}let d=l.join(`
|
|
161
161
|
|
|
162
|
-
`)+"\n\n---\n_Next: `symbol` for definition details | `compact` to read a referenced file_";if(s&&i){let t=await G(i,{query:`traces: ${e.map(e=>e.start).join(`, `)}`});d+=K(t)}return{content:[{type:`text`,text:a?L(d,a):d}],structuredContent:{traces:u}}}catch(e){return
|
|
163
|
-
`);if(c&&a){let t=await G(a,{query:`dead symbols ${e??l??``}`});f+=K(t)}return{content:[{type:`text`,text:s?L(f,s):f}],structuredContent:{symbols:[...u.deadInSource,...u.deadInDocs].map(e=>({name:e.name,path:e.path,...e.line===void 0?{}:{line:e.line},kind:e.kind})),totalDead:u.totalDeadSource+u.totalDeadDocs}}}catch(e){return
|
|
164
|
-
`)}const
|
|
162
|
+
`)+"\n\n---\n_Next: `symbol` for definition details | `compact` to read a referenced file_";if(s&&i){let t=await G(i,{query:`traces: ${e.map(e=>e.start).join(`, `)}`});d+=K(t)}return{content:[{type:`text`,text:a?L(d,a):d}],structuredContent:{traces:u}}}catch(e){return su(`Trace`,e)}}))}function fu(e,t,n,r,i,a){let o=W(`dead_symbols`);e.registerTool(`dead_symbols`,{title:o.title,description:`Find exported symbols that appear to be unused because they are never imported or re-exported.`,outputSchema:Ec,inputSchema:{path:R.string().optional().describe(`Root path to scope the search (default: cwd)`),limit:R.number().min(1).max(500).default(100).optional().describe(`Maximum exported symbols to scan`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:R.boolean().default(!1).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default false — set true when you need stored decisions, conventions, or relationship context for the file/query.`)},annotations:o.annotations},J(`dead_symbols`,async({path:e,limit:o,max_tokens:s,enrich:c})=>{try{let l=e&&r?nu(e,r,i):e,u=await At(t,n,{rootPath:l,limit:o}),d=[`## Dead Symbol Analysis`,``,`**Exports scanned:** ${u.totalExports}`,`**Dead in source:** ${u.totalDeadSource} (actionable)`,`**Dead in docs:** ${u.totalDeadDocs} (informational — code samples in .md files)`,``];if(u.deadInSource.length>0){d.push(`### Dead in Source (actionable)`);for(let e of u.deadInSource)d.push(`- \`${e.name}\` (${e.kind}) — ${e.path}:${e.line}`);d.push(``)}if(u.deadInDocs.length>0){d.push(`### Dead in Docs (informational)`),d.push(`_${u.totalDeadDocs} symbol(s) found only in documentation code samples — not actionable dead code._`);for(let e of u.deadInDocs.slice(0,5))d.push(`- \`${e.name}\` — ${e.path}:${e.line}`);u.deadInDocs.length>5&&d.push(`- _... ${u.deadInDocs.length-5} more omitted_`)}u.totalDeadSource>0?d.push(``,`---`,`_Next: \`codemod\` to remove ${u.totalDeadSource} unused exports | \`symbol\` to verify usage before removing_`):d.push(``,`---`,"_Next: `check` — no dead symbols found, validate types and lint_");let f=d.join(`
|
|
163
|
+
`);if(c&&a){let t=await G(a,{query:`dead symbols ${e??l??``}`});f+=K(t)}return{content:[{type:`text`,text:s?L(f,s):f}],structuredContent:{symbols:[...u.deadInSource,...u.deadInDocs].map(e=>({name:e.name,path:e.path,...e.line===void 0?{}:{line:e.line},kind:e.kind})),totalDead:u.totalDeadSource+u.totalDeadDocs}}}catch(e){return su(`Dead symbol scan`,e)}}))}function pu(e){let t=[`Symbol: ${e.name}`];if(e.confidence!==void 0){let n=(e.confidence*100).toFixed(0);t.push(`Confidence: ${n}% (${e.method??`unknown`})`)}if(e.definedIn){let n=`Defined in: ${e.definedIn.path}:${e.definedIn.line} (${e.definedIn.kind})`;e.definedIn.signature&&(n+=`\nSignature: ${e.definedIn.signature}`),e.rationale&&(n+=`\nRationale: ${e.rationale}`),t.push(n)}else t.push(`Defined in: not found`);if(t.push(``,`Imported by:`),e.importedBy.length===0)t.push(` none`);else for(let n of e.importedBy)t.push(` - ${n.path}:${n.line} ${n.importStatement}`);if(t.push(``,`Referenced in:`),e.referencedIn.length===0)t.push(` none`);else for(let n of e.referencedIn){let e=`scope`in n&&n.scope?` in ${n.scope}()`:``;t.push(` - ${n.path}:${n.line}${e} ${n.context}`)}if(e.graphContext){let n=e.graphContext;t.push(``,`Graph context:`),n.definingModule&&t.push(` Module: ${n.definingModule}`),n.importedByModules.length>0&&t.push(` Imported by modules: ${n.importedByModules.join(`, `)}`),n.siblingSymbols.length>0&&t.push(` Sibling symbols: ${n.siblingSymbols.join(`, `)}`)}if(e.trace){if(e.trace.callers.length>0){t.push(``,`Transitive callers:`);for(let n of e.trace.callers)t.push(` - ${n.name} (${n.path}) [depth: ${n.depth}]`)}if(e.trace.callees.length>0){t.push(``,`Transitive callees:`);for(let n of e.trace.callees)t.push(` - ${n.name} (${n.path}) [depth: ${n.depth}]`)}}return t.join(`
|
|
164
|
+
`)}const mu=j(`tools`);function hu(e,t){let n=W(`er_evolve_review`);e.registerTool(`er_evolve_review`,{title:n.title,description:`Review evolution metrics for the AI Kit ↔ ER bridge. Shows local miss rates, push acceptance, rule effectiveness, and top missed queries. Use this to reason about improving classification rules and knowledge flow.`,inputSchema:{include_details:R.boolean().default(!0).describe(`Include detailed breakdowns (top missed queries, rule stats)`),reset_after:R.boolean().default(!1).describe(`Reset collected metrics after review`)},annotations:n.annotations},async({include_details:e,reset_after:n})=>{try{let r=t.getMetrics(),i=[`## ER Evolution Review
|
|
165
165
|
`,`**Period**: ${r.period.startedAt} → ${r.period.queriedAt}`,`**Total events**: ${r.period.totalEvents}\n`,`### Search`,`- Total searches: ${r.search.totalSearches}`,`- ER fallback triggered: ${r.search.erFallbackCount} (${(r.search.erFallbackRate*100).toFixed(1)}%)`,`- ER cache hits: ${r.search.erCacheHitCount} (${(r.search.erCacheHitRate*100).toFixed(1)}% of fallbacks)`];if(e&&r.search.topMissedQueries.length>0){i.push(`
|
|
166
|
-
**Top missed queries** (triggered ER fallback):`);for(let e of r.search.topMissedQueries.slice(0,10)){let t=e.query.length>60?`${e.query.slice(0,57)}...`:e.query;i.push(` - "${t}" (${e.count}x)`)}}if(i.push(``,`### Push`,`- Total pushes: ${r.push.totalPushes} (${r.push.successCount} ok, ${r.push.failCount} failed)`,`- Classification match rate: ${(r.push.classificationMatchRate*100).toFixed(1)}%`,`- Push acceptance rate: ${(r.push.pushAcceptanceRate*100).toFixed(1)}%`),i.push(``,`### Rule Effectiveness`),Object.keys(r.rules.matchCounts).length>0)for(let[e,t]of Object.entries(r.rules.matchCounts)){let n=r.rules.pushCounts[e]??0,a=t>0?(n/t*100).toFixed(0):`0`;i.push(`- **${e}**: ${t} matches → ${n} pushes (${a}% conversion)`)}else i.push(`- _No rule activity recorded yet_`);if(e&&r.rules.lowConversionRules.length>0){i.push(``,`### ⚠️ Low Conversion Rules (potential false positives)`);for(let e of r.rules.lowConversionRules)i.push(`- **${e.ruleId}**: ${e.matchCount} matches, ${e.pushCount} pushes (${(e.conversionRate*100).toFixed(0)}% conversion) — consider tightening patterns`)}return i.push(``,`---`,"_Next: Use `er_update_policy` to refine rules based on these metrics, or `er_push` to share high-value knowledge._"),n&&(
|
|
166
|
+
**Top missed queries** (triggered ER fallback):`);for(let e of r.search.topMissedQueries.slice(0,10)){let t=e.query.length>60?`${e.query.slice(0,57)}...`:e.query;i.push(` - "${t}" (${e.count}x)`)}}if(i.push(``,`### Push`,`- Total pushes: ${r.push.totalPushes} (${r.push.successCount} ok, ${r.push.failCount} failed)`,`- Classification match rate: ${(r.push.classificationMatchRate*100).toFixed(1)}%`,`- Push acceptance rate: ${(r.push.pushAcceptanceRate*100).toFixed(1)}%`),i.push(``,`### Rule Effectiveness`),Object.keys(r.rules.matchCounts).length>0)for(let[e,t]of Object.entries(r.rules.matchCounts)){let n=r.rules.pushCounts[e]??0,a=t>0?(n/t*100).toFixed(0):`0`;i.push(`- **${e}**: ${t} matches → ${n} pushes (${a}% conversion)`)}else i.push(`- _No rule activity recorded yet_`);if(e&&r.rules.lowConversionRules.length>0){i.push(``,`### ⚠️ Low Conversion Rules (potential false positives)`);for(let e of r.rules.lowConversionRules)i.push(`- **${e.ruleId}**: ${e.matchCount} matches, ${e.pushCount} pushes (${(e.conversionRate*100).toFixed(0)}% conversion) — consider tightening patterns`)}return i.push(``,`---`,"_Next: Use `er_update_policy` to refine rules based on these metrics, or `er_push` to share high-value knowledge._"),n&&(mu.info(`Evolution metrics reset requested`,{requestedAt:new Date().toISOString(),clearedEvents:r.period.totalEvents}),t.reset(),i.push(`
|
|
167
167
|
_Metrics have been reset._`)),{content:[{type:`text`,text:i.join(`
|
|
168
|
-
`)}]}}catch(e){return
|
|
169
|
-
`);if(s&&t){let e=await G(t,{query:`known issues failures`});i+=K(e)}return{content:[{type:`text`,text:i}],structuredContent:{...e}}}let f=JSON.stringify(u);if(s&&t){let e=await G(t,{query:`known issues failures`});f+=K(e)}return{content:[{type:`text`,text:f}]}}catch(e){return
|
|
170
|
-
`).replace(/\\t/g,` `),t);return{content:[{type:`text`,text:JSON.stringify(n)}]}}catch(e){return
|
|
171
|
-
`)}const
|
|
172
|
-
`)}]}}catch(e){return
|
|
173
|
-
`);return{content:i,tokens:Math.ceil(i.length/4)}}}}function
|
|
174
|
-
`),i=Math.ceil(n.length/4);return{content:`**Recalled Knowledge:**\n${n}`,tokens:Math.min(i,200)}}catch{return null}}}}const
|
|
168
|
+
`)}]}}catch(e){return mu.error(`Evolution review failed`,M(e)),q(`INTERNAL`,`Evolution review failed: unable to compute metrics`)}})}const gu=j(`tools:execution`);function _u(e,t,n){let r=W(`check`);e.registerTool(`check`,{title:r.title,description:`Run incremental typecheck (tsc) and lint (biome) on the project or specific files. Returns structured error and warning lists. Default detail level is "efficient" (~300 tokens).`,inputSchema:{files:R.array(R.string()).optional().describe(`Specific files to check (if omitted, checks all)`),cwd:R.string().optional().describe(`Working directory`),skip_types:R.boolean().default(!1).describe(`Skip TypeScript typecheck`),skip_lint:R.boolean().default(!1).describe(`Skip Biome lint`),detail:R.enum(ye).optional().describe(`Output detail level: efficient (default, ~300 tokens — pass/fail + counts + top errors), normal (parsed error objects), full (includes raw terminal output)`),enrich:R.boolean().default(!1).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default false — set true when you need stored decisions, conventions, or relationship context.`)},outputSchema:sc,annotations:r.annotations},J(`check`,async({files:e,cwd:r,skip_types:i,skip_lint:a,detail:o,enrich:s},c)=>{try{let l=o??n??`efficient`,u=await ot({files:e,cwd:r,skipTypes:i,skipLint:a,detail:l===`efficient`?`normal`:l}),d=gl(c).createTask(`Check`,2);if(d.progress(0,`tsc: ${u.tsc.errors.length} errors`),d.progress(1,`biome: ${u.biome.errors.length} errors`),d.complete(`Check ${u.passed?`passed`:`failed`}`),l===`efficient`){let e=zn(u),n=[];if(u.passed)n.push({tool:`test_run`,reason:`Types and lint clean — run tests next`});else{let t=u.tsc.errors[0]?.file??u.biome.errors[0]?.file,r=e.tsc.topErrors[0]??e.biome.topErrors[0]??`reported errors`;t&&n.push({tool:`compact`,reason:`Inspect failing code with compact({ path: ${JSON.stringify(t)}, query: ${JSON.stringify(r)} })`,suggested_args:{path:t,query:r}}),n.push({tool:`check`,reason:`Re-check after fixing errors`,suggested_args:{detail:`normal`}})}let r=[`## Check ${e.passed?`✅ PASS`:`❌ FAIL`}`,``,`**tsc**: ${e.tsc.passed?`✅`:`❌`} ${e.tsc.errorCount} errors, ${e.tsc.warningCount} warnings`];if(e.tsc.topErrors.length>0)for(let t of e.tsc.topErrors)r.push(` - ${t}`);if(r.push(`**biome**: ${e.biome.passed?`✅`:`❌`} ${e.biome.errorCount} errors, ${e.biome.warningCount} warnings`),e.biome.topErrors.length>0)for(let t of e.biome.topErrors)r.push(` - ${t}`);if(n.length>0){r.push(``,`**Next steps:**`);for(let e of n)r.push(`- \`${e.tool}\`: ${e.reason}`)}let i=r.join(`
|
|
169
|
+
`);if(s&&t){let e=await G(t,{query:`known issues failures`});i+=K(e)}return{content:[{type:`text`,text:i}],structuredContent:{...e}}}let f=JSON.stringify(u);if(s&&t){let e=await G(t,{query:`known issues failures`});f+=K(e)}return{content:[{type:`text`,text:f}]}}catch(e){return gu.error(`Check failed`,M(e)),q(`INTERNAL`,`Check failed: ${e instanceof Error?e.message:String(e)}`)}}))}function vu(e){let t=W(`eval`);e.registerTool(`eval`,{title:t.title,description:`Execute a JavaScript or TypeScript snippet in a constrained VM sandbox with a timeout. Captures console output and returned values.`,inputSchema:{code:R.string().max(1e5).describe(`Code snippet to execute`),lang:R.enum([`js`,`ts`]).default(`js`).optional().describe(`Language mode: js executes directly, ts strips common type syntax first`),timeout:R.number().min(1).max(6e4).default(5e3).optional().describe(`Execution timeout in milliseconds`)},annotations:t.annotations},J(`eval`,async({code:e,lang:t,timeout:n})=>{try{let r=await Et({code:e,lang:t,timeout:n});return r.success?{content:[{type:`text`,text:`Eval succeeded in ${r.durationMs}ms\n\n${r.output}`}]}:q(`INTERNAL`,`Eval failed in ${r.durationMs}ms: ${r.error??`Unknown error`}`)}catch(e){return gu.error(`Eval failed`,M(e)),q(`INTERNAL`,`Eval failed: ${e instanceof Error?e.message:String(e)}`)}}))}function yu(e,t){let n=W(`test_run`);e.registerTool(`test_run`,{title:n.title,description:`Run Vitest for the current project or a subset of files, then return a structured summary of passing and failing tests.`,inputSchema:{files:R.array(R.string()).optional().describe(`Specific test files or patterns to run`),grep:R.string().optional().describe(`Only run tests whose names match this pattern`),cwd:R.string().optional().describe(`Working directory for the test run`),enrich:R.boolean().default(!1).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default false — set true when you need stored decisions, conventions, or relationship context.`)},annotations:n.annotations,outputSchema:jc},J(`test_run`,async({files:e,grep:n,cwd:r,enrich:i},a)=>{try{let o=await Vn({files:e,grep:n,cwd:r}),s=gl(a).createTask(`Test Run`,1),c=o.summary.passed+o.summary.failed+o.summary.skipped;s.complete(`Tests: ${o.passed?`passed`:`failed`} (${c} tests)`);let l=Su(o);if(i&&t){let e=await G(t,{query:`test patterns known failures`});l+=K(e)}return{content:[{type:`text`,text:l}],structuredContent:{passed:o.passed,totalTests:c,passedTests:o.summary.passed,failedTests:o.summary.failed,skippedTests:o.summary.skipped,duration:o.summary.duration??0,failures:o.summary.tests.filter(e=>e.status===`fail`).map(e=>({name:e.name,message:e.error??``,...e.file?{file:e.file}:{}}))},isError:!o.passed}}catch(e){return gu.error(`Test run failed`,M(e)),q(`INTERNAL`,`Test run failed: ${e instanceof Error?e.message:String(e)}`)}}))}function bu(e){let t=W(`parse_output`);e.registerTool(`parse_output`,{title:t.title,description:`Parse structured data from build tool output. Supports tsc, vitest, biome, and git status. Auto-detects the tool or specify explicitly.`,inputSchema:{output:R.string().max(5e5).describe(`Raw output text from a build tool`),tool:R.enum([`tsc`,`vitest`,`biome`,`git-status`]).optional().describe(`Tool to parse as (auto-detects if omitted)`)},annotations:t.annotations},async({output:e,tool:t})=>{try{let n=$t(e.replace(/\\n/g,`
|
|
170
|
+
`).replace(/\\t/g,` `),t);return{content:[{type:`text`,text:JSON.stringify(n)}]}}catch(e){return gu.error(`Parse failed`,M(e)),q(`INTERNAL`,`Parse failed: ${e instanceof Error?e.message:String(e)}`)}})}function xu(e,t){let n=W(`delegate`);e.registerTool(`delegate`,{title:n.title,description:`Delegate a subtask to a local Ollama model. Use for summarization, classification, naming, or any task that can offload work from the host agent. Fails fast if Ollama is not running.`,inputSchema:{prompt:R.string().max(2e5).describe(`The task or question to send to the local model`),model:R.string().optional().describe(`Ollama model name (default: first available model)`),system:R.string().optional().describe(`System prompt for the model`),context:R.string().max(5e5).optional().describe(`Context text to include before the prompt (e.g. file contents)`),temperature:R.number().min(0).max(2).default(.3).optional().describe(`Sampling temperature (0=deterministic, default 0.3)`),timeout:R.number().min(1e3).max(6e5).default(12e4).optional().describe(`Timeout in milliseconds (default 120000)`),action:R.enum([`generate`,`list_models`]).default(`generate`).optional().describe(`Action: generate a response or list available models`)},annotations:n.annotations},async({prompt:e,model:n,system:r,context:i,temperature:a,timeout:o,action:s})=>{try{if(s===`list_models`){let e=await bt();return{content:[{type:`text`,text:JSON.stringify({models:e,count:e.length,_Next:`Use delegate with a model name`},null,2)}]}}if(t?.available)try{let n=await t.createMessage({prompt:e,systemPrompt:r,context:i,maxTokens:4e3,modelPreferences:{intelligencePriority:.8,speedPriority:.5,costPriority:.3}});return{content:[{type:`text`,text:JSON.stringify({model:n.model??`sampling`,response:n.text,provider:`mcp-sampling`,_Next:`Use the response in your workflow. stash to save it.`},null,2)}]}}catch{gu.debug(`Sampling failed, falling back to Ollama`)}let c=await yt({prompt:e,model:n,system:r,context:i,temperature:a,timeout:o});return c.error?q(`INTERNAL`,JSON.stringify({error:c.error,model:c.model,durationMs:c.durationMs},null,2)):{content:[{type:`text`,text:JSON.stringify({model:c.model,response:c.response,durationMs:c.durationMs,tokenCount:c.tokenCount,_Next:`Use the response in your workflow. stash to save it.`},null,2)}]}}catch(e){return gu.error(`Delegate failed`,M(e)),q(`INTERNAL`,`Delegate failed: ${e instanceof Error?e.message:String(e)}`)}})}function Su(e){let t=[`Vitest run: ${e.passed?`passed`:`failed`}`,`Duration: ${e.durationMs}ms`,`Passed: ${e.summary.passed}`,`Failed: ${e.summary.failed}`,`Skipped: ${e.summary.skipped}`];e.summary.suites!==void 0&&t.push(`Suites: ${e.summary.suites}`);let n=e.summary.tests.filter(e=>e.status===`fail`);if(n.length>0){t.push(``,`Failed tests:`);for(let e of n)t.push(`- ${e.name}${e.file?` (${e.file})`:``}`),e.error&&t.push(` ${e.error}`)}return t.join(`
|
|
171
|
+
`)}const Cu=j(`tools:file-summary`);function wu(e,t,n){let r=W(`file_summary`);e.registerTool(`file_summary`,{title:r.title,description:"Unified file/source summary tool. With `files`: T1=structural card (ROLE/DEPS/EXPORTS), T2=card + query-relevant content. With `text`: compress arbitrary text by relevance. With `ref`: restore cached result. Replaces file_summary + compact + stratum_card.",inputSchema:{files:R.array(R.string()).min(1).max(50).optional().describe(`File paths to summarize (card output: T1=structure, T2=structure+content)`),text:R.string().optional().describe(`Arbitrary text to compress (text output with ratio/segment stats)`),ref:R.string().optional().describe(`Cached ref to restore from compact/digest/find/knowledge output`),query:R.string().optional().describe(`Focus query — guides relevance scoring. Triggers T2 when present without explicit tier`),tier:R.enum([`T1`,`T2`]).optional().describe(`Tier: T1=structure only, T2=structure+content. Default: T1, or T2 if query present`),max_content_chars:R.number().min(100).max(5e3).default(800).describe(`For T2/text: max chars for compressed content`),segmentation:R.enum([`paragraph`,`sentence`,`line`]).default(`paragraph`).describe(`How to split content for relevance scoring`),min_score:R.number().min(0).max(1).optional().describe(`Minimum relevance score threshold (0-1)`),mode:R.enum([`full`,`delta`]).default(`full`).describe(`'full'=compress everything, 'delta'=only changes since last read`)},annotations:r.annotations},J(`file_summary`,async({files:e,text:r,ref:i,query:a,tier:o,max_content_chars:s,segmentation:c,min_score:l,mode:u})=>{try{let d=await Ot(t,{files:e,text:r,ref:i,query:a,tier:o,maxContentChars:s,segmentation:c,minScore:l,mode:u,cache:n}),f=[];if(i)f.push(`## File Summary — Ref Restored`,`Ref: ${d.ref??i}`,``,d.text??``);else if(r){let e=d.ratio==null?`?`:(d.ratio*100).toFixed(0);f.push(`## File Summary — Text Compression`,`Original: ${d.originalChars??0} chars → ${d.compressedChars??0} chars (${e}%)`,...d.ref?[`Ref: ${d.ref}`]:[],``,d.text??``)}else if(d.cards){let e=o??`T1`;f.push(`## File Summary (${e}) — ${d.cards.length} files`,`Total: ~${d.totalTokenEstimate} tokens (was ~${d.totalOriginalTokenEstimate}, ${((d.compressionRatio??1)*100).toFixed(0)}% of original)`,``,...d.cards.map(e=>e.card),``)}return f.push(`---`,'_Next: Use `file_summary` with `tier: "T2"` and a query for deeper content or `digest` for multi-file synthesis._'),{content:[{type:`text`,text:f.filter(e=>typeof e==`string`).join(`
|
|
172
|
+
`)}]}}catch(e){return Cu.error(`file_summary failed`,M(e)),q(`INTERNAL`,`file_summary failed: ${e instanceof Error?e.message:String(e)}`)}}))}const Tu=[],Eu=[`_docs-sync`],Du=new Map([[`_docs-sync`,`Synchronize project documentation — update docs/ folder based on changes made during the flow.`]]);function Ou(e){function t(t,n,r){let i=n?.installPath?Ie(n.installPath):t.replaceAll(`:`,`-`),a=I(Qn(),`.copilot`,`flows`,i).replaceAll(`\\`,`/`);if(N(a))return a;let o=I(Qn(),`.claude`,`flows`,i).replaceAll(`\\`,`/`);if(N(o))return o;let s=I(r??e(),`.github`,`flows`,i).replaceAll(`\\`,`/`);return N(s)?s:n?.installPath&&N(n.installPath)?n.installPath.replaceAll(`\\`,`/`):null}function n(e,n,r){let i=t(e.name,e,r);return i?I(i,n).replaceAll(`\\`,`/`):n}function r(t,n){let r=t.replace(/^_/,``),i=n??e(),a=[F(i,`.github`,`flows`,`_epilogue`,`steps`,r,`README.md`),F(i,`.github`,`flows`,`_epilogue`,r,`README.md`)];for(let e of a)if(N(e))return e.replaceAll(`\\`,`/`);return null}function i(e){return[...Tu,...e.manifest.steps.map(e=>e.id),...Eu]}function a(e,t,r){let i=t?e.manifest.steps.find(e=>e.id===t)??null:null,a=t?Du.get(t)??null:null;return{currentStep:i,epilogueStep:a?{id:t,description:a}:null,instructionPath:i&&t?n(e,i.instruction,r):null,description:i?.description??a}}function o(){try{let e=F(Zn(`npm root -g`,{encoding:`utf-8`}).trim(),`@fission-ai`,`openspec`);if(N(e))return{path:e,sourceType:`npm-global`,isGit:!1}}catch{}return{path:`https://github.com/Fission-AI/OpenSpec.git`,sourceType:`git`,isGit:!0}}function s(e){let t=I(e);if(N(F(t,`.claude-plugin`,`plugin.json`)))return{path:t,sourceType:`claude-plugin`};let n=Qn(),r=F(n,`.claude`,`plugins`,e);if(N(F(r,`.claude-plugin`,`plugin.json`)))return{path:r,sourceType:`claude-plugin`};let i=F(n,`.claude`,`plugins`);if(!N(i))return null;for(let t of Ae(i,{withFileTypes:!0})){if(!t.isDirectory())continue;let n=F(i,t.name,`.claude-plugin`,`plugin.json`);if(N(n))try{if(JSON.parse(P(n,`utf-8`)).name===e)return{path:F(i,t.name),sourceType:`claude-plugin`}}catch{}}return null}return{resolveInstallPath:t,resolveInstructionPath:n,resolveEpilogueInstructionPath:r,getStepSequence:i,resolveCurrentStepInfo:a,resolveOpenSpecSource:o,resolveClaudePluginSource:s}}function ku(e){function t(){return e.sources?.[0]?.path??Oe()}function n(){return e.allRoots?.length?e.allRoots:[t()]}function r(e){return e.map(e=>e.replaceAll(`\\`,`/`))}function i(e){let t=[];try{let n=Ae(e,{withFileTypes:!0});for(let r of n){if(!r.isDirectory()||r.name.startsWith(`.`))continue;let n=F(e,r.name);N(F(n,`.git`))&&t.push(n)}}catch{}return t}function a(){let e=n(),t=new Set(e);for(let n of e)for(let e of i(n))t.add(e);return[...t]}function o(e){let t=e.replaceAll(`\\`,`/`);if(r(a()).includes(t))return!0;let i=r(n());for(let n of i)if(t.startsWith(`${n}/`)&&N(F(e,`.git`)))return!0;return!1}function s(e){return F(e??t(),`.flows`)}async function c(){let e=a();for(let t of e){let e=s(t);if(N(e))for(let n of Ae(e,{withFileTypes:!0})){if(!n.isDirectory())continue;let r=F(e,n.name,`meta.json`);if(N(r))try{let e=JSON.parse(P(r,`utf-8`));if(e.status===`active`)return e.primaryRoot?e.primaryRoot:t}catch{}}}return null}async function l(e){return e||(await c()??t())}function u(){let e=t(),i=r(n()),o=a(),s=r(o),c=s.filter(e=>!i.includes(e));return{workspaceRoot:e,allRoots:o,normalizedAllRoots:s,discoveredRepos:c.length>0?c:void 0}}function d(e,t,n){let r=F(s(t),e,`meta.json`),i=P(r,`utf-8`),a=JSON.parse(i);a.roots=n.map(e=>e.replaceAll(`\\`,`/`)),a.primaryRoot=t.replaceAll(`\\`,`/`);let o=`${r}.tmp`;Fe(o,JSON.stringify(a,null,2),`utf-8`),je(o,r)}function f(e,t){let n=F(s(t),e,`meta.json`);if(!N(n))return;let r=P(n,`utf-8`),i=JSON.parse(r),a=i.roots;if(!a||a.length<=1)return;let o=t.replaceAll(`\\`,`/`);for(let t of a){if(t===o)continue;let n=F(t,`.flows`,e);ke(n,{recursive:!0});let a=F(n,`meta.json`),s=`${a}.tmp`;Fe(s,r,`utf-8`),je(s,a),ke(F(n,i.artifactsDir??`.spec`),{recursive:!0})}}return{getWorkspaceRoot:t,getAllRoots:a,getFlowsDir:s,isValidFlowRoot:o,resolveFlowRoot:l,resolveRoots:u,patchMetaRoots:d,syncMetaToRoots:f}}const Au={design:`researcher`,spec:`researcher`,plan:`implementer`,task:`implementer`,execute:`implementer`,verify:`reviewer`,"basic-design":`researcher`,assess:`researcher`,"basic-implement":`implementer`,"basic-verify":`reviewer`,"docs-sync":`documenter`,"lesson-learned":`documenter`,epilogue:`documenter`},ju={implementer:`implementer`,frontend:`implementer`,refactor:`implementer`,debugger:`debugger`,security:`reviewer`,documenter:`documenter`,planner:`implementer`,researcher:`researcher`,explorer:`researcher`,orchestrator:`implementer`,"code-reviewer":`reviewer`,"architect-reviewer":`reviewer`},Mu=new Set([`implementer`,`documenter`,`reviewer`,`researcher`,`debugger`]);function Nu(e){if(e.profile!==void 0&&e.profile!==null)return Mu.has(e.profile)?e.profile:`implementer`;if(e.id){let t=Au[e.id];if(t)return t}if(e.agents&&e.agents.length>0)for(let t of e.agents){let e=ju[t.toLowerCase()];if(e)return e}return`implementer`}function Pu(e){let{manifest:t}=e;if(!t?.steps)return null;let n=t.steps.find(t=>t.id===e.stepId);return n?Nu(n):null}function Fu(e){return{name:`flow-context`,order:40,maxTokens:120,runInBrief:!1,async execute(t){let n=Pu(t),r=[`**Flow Context:** Call \`knowledge({ action: 'withdraw', scope: 'flow', profile: '${e??n??`implementer`}', budget: 4000 })\` as FIRST action for prior context.`,"Remember decisions: `knowledge({ action: 'remember', title: '...', content: '...', category: 'flow-context', scope: 'flow' })`"];t.completedSteps.length>0&&r.push(`Completed steps: ${t.completedSteps.join(`, `)}`);let i=r.join(`
|
|
173
|
+
`);return{content:i,tokens:Math.ceil(i.length/4)}}}}function Iu(e){return{name:`knowledge-recall`,order:20,maxTokens:200,runInBrief:!1,async execute(t){if(!e.store)return null;let n=[t.stepDescription,t.topic].filter(e=>typeof e==`string`&&e.trim().length>0);if(n.length===0)return null;let r=[...n,t.flowName].filter(Boolean).join(` `);if(!r.trim())return null;try{let t=await e.store.search(r,{limit:3});if(!t||t.length===0)return null;let n=t.map(e=>`• ${e.content.slice(0,200)}`).join(`
|
|
174
|
+
`),i=Math.ceil(n.length/4);return{content:`**Recalled Knowledge:**\n${n}`,tokens:Math.min(i,200)}}catch{return null}}}}const Lu=[`**Read Code:** Structure → file_summary({ files, tier: 'T1' }). Specific section → file_summary({ files, tier: 'T2', query }).`,`Multiple files → digest(). Cached ref → file_summary({ ref, query }). Repeated file ref → file_summary(). Edit lines → read_file().`,`NEVER read_file >50 lines to understand. Use search() for discovery.`].join(` `),Ru={name:`token-efficiency`,order:30,maxTokens:80,runInBrief:!1,runOnce:!0,async execute(e){return{content:Lu,tokens:25}}},zu=[`**Tool Routing:** search() not grep_search. file_summary() not read_file (for understanding).`,`check() not terminal tsc/lint. test_run() not terminal test. trace() for data flow.`,`read_file ONLY for exact lines before editing. symbol() for definition+refs.`].join(` `),Bu={name:`tool-routing`,order:10,maxTokens:100,runInBrief:!0,runOnce:!0,async execute(e){return{content:zu,tokens:30}}};function Vu(e,t){return Promise.race([e,new Promise(e=>setTimeout(()=>e(null),t))])}var Hu=class{hooks=[];firedOnce=new Set;sealed=!1;log;constructor(e){this.log=e?.log}seal(){this.sealed=!0}register(e){if(this.sealed){this.log?.warn(`Attempted to register hook "%s" on sealed pipeline`,e.name);return}this.hooks.push(e),this.hooks.sort((e,t)=>e.order-t.order)}get hookCount(){return this.hooks.length}async enrich(e,t,n){let r=this.resolveBudget(t.mode,n),i=new Set(n?.disable??[]),a=this.hooks.filter(e=>!(i.has(e.name)||t.mode===`brief`&&!e.runInBrief||e.runOnce&&this.firedOnce.has(e.name)));if(a.length===0)return e;let o=[],s=0;for(let e of a){if(s>=r){this.log?.debug(`[step-hooks] Budget exhausted (${s}/${r}), skipping remaining hooks`);break}try{let n=await Vu(e.execute(t),5e3);if(!n||n.content.length===0)continue;e.runOnce&&this.firedOnce.add(e.name);let i=n.content.replace(/<\/(step-context|step-hints)>/gi,``);if(i.length===0)continue;let a=this.truncateToTokens(i,e.maxTokens),c=Math.min(n.tokens,e.maxTokens);if(s+c<=r){o.push({content:a,tokens:c}),s+=c;continue}let l=r-s;if(l<=0)break;o.push({content:this.truncateToTokens(a,l),tokens:l}),s=r}catch(t){this.log?.warn(`[step-hooks] Hook "${e.name}" failed: ${t instanceof Error?t.message:String(t)}`)}}if(o.length===0)return e;let c=t.mode===`full`?`<step-context>`:`<step-hints>`,l=t.mode===`full`?`</step-context>`:`</step-hints>`;return`${e}\n\n${c}\n${o.map(e=>e.content).join(`
|
|
175
175
|
|
|
176
|
-
`)}\n${l}`}resolveBudget(e,t){return e===`full`?t?.tokenBudget?.full??500:t?.tokenBudget?.brief??150}truncateToTokens(e,t){let n=t*4;return e.length<=n?e:`${e.slice(0,n).trimEnd()}…`}};function
|
|
176
|
+
`)}\n${l}`}resolveBudget(e,t){return e===`full`?t?.tokenBudget?.full??500:t?.tokenBudget?.brief??150}truncateToTokens(e,t){let n=t*4;return e.length<=n?e:`${e.slice(0,n).trimEnd()}…`}};function Uu(e={}){let t=new Hu({log:e.log});return t.register(Bu),t.register(Iu({store:e.store,graphStore:e.graphStore,embedder:e.embedder})),t.register(Ru),t.register(Fu()),t.seal(),t}const Wu=j(`flow-tools`);function Gu(e){return Array.isArray(e)?e.filter(e=>typeof e==`string`&&e.trim().length>0):[]}function Ku(e){return{content:[{type:`text`,text:e}]}}function qu(e){return e instanceof Error?e.message:String(e)}const Ju={before:[],after:[{id:`_docs-sync`,description:`Synchronize project documentation — update docs/ folder based on changes made during the flow.`,position:`after`,skills:[`docs`]}]};function Yu(e,t,n){let r=ku(t),i=Ou(r.getWorkspaceRoot),a=Uu({store:n?.store,graphStore:n?.graphStore,embedder:n?.embedder,log:Wu});function o(){return F(Se(),`flows`,`registry.json`)}function s(){let t=ii(e);return async({content:e,sourceFormat:n,stepName:r,metadata:i})=>{let a=r.charAt(0).toUpperCase()+r.slice(1),o=i?JSON.stringify(i,null,2):void 0,s=`You are converting a flow step definition from "${n}" format to aikit native flow step README.md format.
|
|
177
177
|
|
|
178
178
|
Convert the provided content into a well-structured README.md for a flow step named "${r}".
|
|
179
179
|
|
|
@@ -186,22 +186,22 @@ The output must:
|
|
|
186
186
|
6. Preserve ALL tool restrictions, constraints, and requirements from the source
|
|
187
187
|
7. Be formatted as clean Markdown
|
|
188
188
|
|
|
189
|
-
Output ONLY the README.md content, nothing else.`;if(t.available)try{let i=(await t.createMessage({prompt:e,systemPrompt:s,context:o?`Step name: ${r}\nSource format: ${n}\nMetadata:\n${o}`:`Step name: ${r}\nSource format: ${n}`,maxTokens:4096,modelPreferences:{intelligencePriority:.8,speedPriority:.4,costPriority:.2}})).text.trim();if(i.length>0)return i}catch(e){
|
|
189
|
+
Output ONLY the README.md content, nothing else.`;if(t.available)try{let i=(await t.createMessage({prompt:e,systemPrompt:s,context:o?`Step name: ${r}\nSource format: ${n}\nMetadata:\n${o}`:`Step name: ${r}\nSource format: ${n}`,maxTokens:4096,modelPreferences:{intelligencePriority:.8,speedPriority:.4,costPriority:.2}})).text.trim();if(i.length>0)return i}catch(e){Wu.debug(`Flow transform sampling failed; using fallback formatting`,{error:qu(e),sourceFormat:n,stepName:r})}let c=typeof i?.description==`string`&&i.description.trim().length>0?i.description.trim():null,l=Gu(i?.produces),u=Gu(i?.requires);return[`# ${a}`,``,`## Purpose`,``,c??`${a} step.`,``,`## Instructions`,``,e.trim(),``,`## Artifacts`,``,...l.length>0?l.map(e=>`- ${e}`):[`- ${r}.md`],...u.length>0?[``,`## Prerequisites`,``,...u.map(e=>`- ${e}`)]:[],``].join(`
|
|
190
190
|
`).trimEnd().concat(`
|
|
191
|
-
`)}}async function c(e){let{FlowRegistryManager:n,FlowStateMachine:i,FlowLoader:a,GitInstaller:s}=await import(`../../flows/dist/index.js`),c=F(t.stateDir??``,`flows`,`installed`);return{registry:new n(o()),stateMachine:new i(r.getFlowsDir(e),
|
|
192
|
-
`),t.lastIndexOf(` `),t.lastIndexOf(` `));return`${(n>=Math.floor(t.length*.6)?t.slice(0,n):t).trimEnd()}…`}function
|
|
191
|
+
`)}}async function c(e){let{FlowRegistryManager:n,FlowStateMachine:i,FlowLoader:a,GitInstaller:s}=await import(`../../flows/dist/index.js`),c=F(t.stateDir??``,`flows`,`installed`);return{registry:new n(o()),stateMachine:new i(r.getFlowsDir(e),Ju),loader:new a,installer:new s(c)}}return{server:e,config:t,log:Wu,toTextResponse:Ku,toErrorText:qu,createFlowTransform:s,getFlows:c,stepPipeline:a,stateDir:t.stateDir??``,...r,...i}}var Xu=class extends Error{code;constructor(e,t){super(t),this.code=e,this.name=`FlowError`}};function Zu(e){return e instanceof Xu}async function Qu(e){let{entry:t,stepId:n,runDir:r,slug:i,primaryRoot:a,roots:o,activeRoot:s,resolveInstructionPath:c,resolveEpilogueInstructionPath:l}=e;if(!n)return null;try{let e=t.manifest.steps.find(e=>e.id===n||e.name===n),u;if(e)u=await He(c(t,e.instruction,s),`utf-8`);else{let e=l(n,s);if(!e)return null;u=await He(e,`utf-8`)}let d=F(r,t.manifest.artifacts_dir).replaceAll(`\\`,`/`),f=r.replaceAll(`\\`,`/`);u=u.replaceAll(`{{artifacts_path}}`,d).replaceAll(`{{run_dir}}`,f).replaceAll(`{{workspace_root}}`,(a??s).replaceAll(`\\`,`/`)).replaceAll(`{{all_roots}}`,JSON.stringify(o??[s.replaceAll(`\\`,`/`)],null,2));for(let e of[`spec-driven`])u=u.replaceAll(`${e}/${i}/`,`${d}/`);return u}catch{return null}}async function $u(e,t){let{getFlows:n,log:r,resolveEpilogueInstructionPath:i,resolveFlowRoot:a,resolveInstructionPath:o,stepPipeline:s,toErrorText:c,toTextResponse:l}=t,{step:u}=e;try{let e=await a(),{registry:t,stateMachine:r}=await n(e),c=r.getStatus();if(!c.success||!c.data)throw new Xu(`NO_ACTIVE_FLOW`,`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let d=c.data,f=t.get(d.flow);if(!f)throw new Xu(`FLOW_NOT_FOUND`,`Flow "${d.flow}" not found in registry.`);let p=u??d.currentStep;if(!p)throw new Xu(`STEP_OUT_OF_RANGE`,`No current step is available for the active flow.`);let m=await Qu({entry:f,stepId:p,runDir:d.runDir,slug:d.slug,primaryRoot:d.primaryRoot,roots:d.roots,activeRoot:e,resolveInstructionPath:o,resolveEpilogueInstructionPath:i});if(!m)throw new Xu(`STEP_OUT_OF_RANGE`,`Step "${p}" not found in flow "${d.flow}".`);let h=f.manifest.steps.find(e=>e.id===p||e.name===p),g=F(d.runDir,f.manifest.artifacts_dir).replaceAll(`\\`,`/`),_={stepId:p,flowName:d.flow,flowSlug:d.slug,phase:d.phase??`flow`,runDir:d.runDir,artifactsPath:g,completedSteps:d.completedSteps??[],stepDescription:h?.description,agents:h?.agents??[],mode:`full`,topic:d.topic??``,activeRoot:e};return l(await s.enrich(m,_,f.manifest.hooks))}catch(e){return Zu(e)?l(e.message):(r.error(`flow action read failed`,M(e)),e instanceof Error&&`code`in e&&e.code===`ENOENT`?l(`Could not read instruction file: ${e.message}`):l(`Error: ${c(e)}`))}}async function ed(e,t){let{registry:n,loader:r,installer:i}=await e.getFlows(),a=e.createFlowTransform(),o=I(t.source);if(!N(o))return e.toTextResponse(`Source path no longer exists: ${o}`);let s=`${t.installPath}.updating`,c=`${t.installPath}.backup`;N(s)&&Me(s,{recursive:!0,force:!0}),N(c)&&Me(c,{recursive:!0,force:!0});let l=i.copyLocal(o,Ie(s));if(!l.success||!l.data)return e.toTextResponse(`Failed to copy flow: ${l.error}`);let u=await r.load(s,{forceAssetSync:!0,transform:a});if(!u.success||!u.data)return i.remove(s),e.toTextResponse(`Failed to load flow manifest: ${u.error}`);let d=!1;try{je(t.installPath,c),je(s,t.installPath);let e=await r.load(t.installPath,{forceAssetSync:!0,transform:a});if(!e.success||!e.data)throw Error(`Failed to load flow manifest: ${e.error}`);let o=e.data.manifest,l=e.data.format,u=n.register({...t,version:o.version,format:l,installPath:t.installPath,manifest:o,updatedAt:new Date().toISOString()});if(!u.success)throw Error(`Failed to refresh flow registry entry: ${u.error}`);if(d=!0,o.install.length>0){let e=i.runInstallDeps(o.install);if(!e.success)throw Error(`Dependency install failed: ${e.error}`)}Me(c,{recursive:!0,force:!0})}catch(r){return N(s)&&Me(s,{recursive:!0,force:!0}),N(c)&&(N(t.installPath)&&Me(t.installPath,{recursive:!0,force:!0}),je(c,t.installPath)),d&&n.register(t),e.toTextResponse(e.toErrorText(r))}return e.toTextResponse(`Flow "${t.name}" updated from ${t.sourceType} source successfully.`)}async function td(e,t){let{registry:n,loader:r}=await e.getFlows(),i=e.createFlowTransform();try{Zn(`npm update -g @fission-ai/openspec`,{encoding:`utf-8`,stdio:`pipe`})}catch(t){return e.toTextResponse(`npm update failed: ${e.toErrorText(t)}`)}let a=e.resolveOpenSpecSource(),o=await r.load(a.path,{forceAssetSync:!0,transform:i}),s=o.success&&o.data?o.data.manifest:null,c=o.success&&o.data?o.data.format:t.format;if(s){let r=n.register({...t,version:s.version,format:c,installPath:a.path,manifest:s,updatedAt:new Date().toISOString()});if(!r.success)return e.toTextResponse(`Failed to refresh flow registry entry: ${r.error}`)}return e.toTextResponse(`Flow "${t.name}" updated via npm successfully.`)}async function nd(e,t){let{registry:n,loader:r,installer:i}=await e.getFlows(),a=e.createFlowTransform(),o=i.update(t.installPath);if(!o.success)return e.toTextResponse(`Update failed: ${o.error}`);let s=await r.load(t.installPath,{forceAssetSync:!0,transform:a}),c=s.success&&s.data?s.data.manifest:null,l=s.success&&s.data?s.data.format:t.format;if(c){let r=i.getLocalCommit(t.installPath),a=n.register({...t,version:c.version,format:l,manifest:c,updatedAt:new Date().toISOString(),...r?{commitSha:r}:{}});if(!a.success)return e.toTextResponse(`Failed to refresh flow registry entry: ${a.error}`)}let u=c?.install??t.manifest.install;if(u.length>0){let t=i.runInstallDeps(u);if(!t.success)return e.toTextResponse(`Dependency install failed: ${t.error}`)}return e.toTextResponse(`Flow "${t.name}" updated successfully.`)}async function rd(e,t){let{createFlowTransform:n,getFlows:r,log:i,resolveClaudePluginSource:a,resolveOpenSpecSource:o,toErrorText:s,toTextResponse:c}=t,{source:l,name:u,token:d}=e;try{let{registry:e,loader:t,installer:i}=await r(),s=n(),f=l===`openspec`||l.startsWith(`openspec:`),p,m=l,h;if(f){let e=o();m=e.path,p=e.sourceType}let g=f?null:a(m);g&&(m=g.path,p=g.sourceType);let _=/^https?:\/\/|^git@/.test(m),v;if(_){let e=i.clone(m,d);if(!e.success||!e.data)return c(`Failed to clone flow: ${e.error}`);v=e.data}else{let e=I(m);h=e;let t=u||Ie(e)||`custom-flow`,n=i.copyLocal(e,t);if(!n.success||!n.data)return c(`Failed to copy flow: ${n.error}`);v=n.data}let y=await t.load(v,{forceAssetSync:!0,transform:s});if(!y.success||!y.data)return i.remove(v),c(`Failed to load flow manifest: ${y.error}`);let{manifest:b,format:x}=y.data,S=u||b.name,C=p??(_?`git`:`local`);if(e.has(S))return i.remove(v),c(`Flow "${S}" is already installed. Use flow({ action: "update", name: "${S}" }) to update it, or flow({ action: "remove", name: "${S}" }) then flow({ action: "add", source: "..." }) to replace.`);if(b.install.length>0){let e=i.runInstallDeps(b.install);if(!e.success)return i.remove(v),c(`Dependency install failed: ${e.error}`)}let w=new Date().toISOString(),T=_?i.getLocalCommit(v):void 0,E=e.register({name:S,version:b.version,source:C===`local`||C===`claude-plugin`?h??l:l,sourceType:C,installPath:v,format:x,registeredAt:w,updatedAt:w,manifest:b,...T?{commitSha:T}:{}});if(!E.success)return i.remove(v),c(`Failed to register flow: ${E.error}`);let D=b.steps.length;return c(`Flow "${S}" installed successfully (${D} steps). Use flow({ action: "start", name: "${S}" }) to begin.`)}catch(e){return i.error(`flow action add failed`,M(e)),c(`Error: ${s(e)}`)}}async function id(e,t){let{getFlows:n,log:r,toErrorText:i,toTextResponse:a}=t,{name:o}=e;try{let{registry:e,installer:t}=await n();if(!e.has(o))return a(`Flow "${o}" is not installed.`);let r=e.get(o);if(!r)return a(`Flow "${o}" is not installed.`);if(r.sourceType===`builtin`)return a(`Cannot remove builtin flow "${o}".`);let i=t.remove(r.installPath);if(!i.success)return a(`Failed to remove flow files: ${i.error}`);let s=e.unregister(o);return s.success?a(`Flow "${o}" removed successfully.`):a(`Failed to unregister flow: ${s.error}`)}catch(e){return r.error(`flow action remove failed`,M(e)),a(`Error: ${i(e)}`)}}async function ad(e,t){let{getFlows:n,log:r,toErrorText:i,toTextResponse:a}=t,{name:o}=e,s={createFlowTransform:t.createFlowTransform,getFlows:t.getFlows,resolveOpenSpecSource:t.resolveOpenSpecSource,toErrorText:t.toErrorText,toTextResponse:t.toTextResponse};try{let{registry:e}=await n();if(!e.has(o))return a(`Flow "${o}" is not installed.`);let t=e.get(o);return!t||t.sourceType!==`git`&&t.sourceType!==`npm-global`&&t.sourceType!==`local`&&t.sourceType!==`claude-plugin`?a(`Flow "${o}" was not installed from git, npm, or a local source — cannot update. Remove and re-add instead.`):t.sourceType===`local`||t.sourceType===`claude-plugin`?ed(s,t):t.sourceType===`npm-global`?td(s,t):nd(s,t)}catch(e){return r.error(`flow action update failed`,M(e)),a(`Error: ${i(e)}`)}}const od=`IMPORTANT: Start/status/step only include a brief. Call flow({ action: "read" }) before executing this flow step.`,sd=1200,cd=/artifact|output contract|gate|completion criteria|deliverable|must|do not|forbidden/i;function ld(){return{artifactsPath:null,currentStepInstruction:null,currentStepDescription:null,currentStepContent:null,currentStepBrief:null,currentStepPins:null,stepSequence:[]}}function ud(e){if(e.length<=sd)return e;let t=e.slice(0,sd-1),n=Math.max(t.lastIndexOf(`
|
|
192
|
+
`),t.lastIndexOf(` `),t.lastIndexOf(` `));return`${(n>=Math.floor(t.length*.6)?t.slice(0,n):t).trimEnd()}…`}function dd(e){if(!e?.trim())return{brief:null,pins:null};let t=/^##\s+/m.exec(e),n=(t?e.slice(0,t.index):e).trim(),r=null;if(n){let e=n.split(/\n\s*\n/).filter(e=>e.trim().length>0),t=(e[0]?.startsWith(`#`)&&e[1]?e.slice(0,2):e.slice(0,1)).join(`
|
|
193
193
|
|
|
194
|
-
`).trim();r=t?
|
|
194
|
+
`).trim();r=t?ud(t):null}let i=Array.from(e.matchAll(/^##\s+.*$/gm)),a=[];for(let[t,n]of i.entries()){let r=n[0];if(!cd.test(r))continue;let o=n.index??0,s=i[t+1]?.index??e.length;a.push(e.slice(o,s).replace(/\s+$/,``))}return{brief:r,pins:a.length>0?a.join(`
|
|
195
195
|
|
|
196
|
-
`):null}}function ud(e,t){return t(e)}async function dd(e){let{context:t,entry:n,state:r,activeRoot:i,primaryRoot:a,roots:o}=e,{instructionPath:s,description:c}=t.resolveCurrentStepInfo(n,r.currentStep,i),l=ud(n,t.getStepSequence),u=await Xu({entry:n,stepId:r.currentStep,runDir:r.runDir,slug:r.slug,primaryRoot:a,roots:o,activeRoot:i,resolveInstructionPath:t.resolveInstructionPath,resolveEpilogueInstructionPath:t.resolveEpilogueInstructionPath}),{brief:d,pins:f}=ld(u),p=d;if(d&&r.currentStep){let e=n.manifest.steps.find(e=>e.id===r.currentStep),a={stepId:r.currentStep,flowName:r.flow,flowSlug:r.slug,phase:`flow`,runDir:r.runDir,artifactsPath:F(r.runDir,n.manifest.artifacts_dir).replaceAll(`\\`,`/`),completedSteps:r.completedSteps??[],stepDescription:e?.description??c??void 0,agents:e?.agents??[],mode:`brief`,topic:r.topic??``,activeRoot:i};p=await t.stepPipeline.enrich(d,a,n.manifest.hooks)}return{artifactsPath:F(r.runDir,n.manifest.artifacts_dir).replaceAll(`\\`,`/`),currentStepInstruction:s,currentStepDescription:c,currentStepContent:u,currentStepBrief:p,currentStepPins:f,stepSequence:l}}function fd(e){let{state:t,data:n,started:r,includeStatus:i,action:a,includeInstructionPath:o}=e,s={};return r&&(s.started=!0),s.flow=t.flow,t.flowOrigin&&(s.flowOrigin=t.flowOrigin),i&&(s.status=t.status),a&&(s.action=a),s.slug=t.slug,s.topic=t.topic,s.runDir=t.runDir,s.artifactsPath=n.artifactsPath,s.currentStep=t.currentStep,s.currentStepInstruction=n.currentStepInstruction,o&&(s.instructionPath=n.currentStepInstruction),s.currentStepDescription=n.currentStepDescription,s.currentStepContent=null,s.currentStepBrief=n.currentStepBrief,s.currentStepPins=n.currentStepPins,s.fullContentHint=`Call flow({ action: 'read' }) for the complete step instructions.`,s}function pd(e){return e.sourceType===`local`?{source:`local`,sourceType:e.sourceType,format:e.format,...e.commitSha?{commitSha:e.commitSha}:{}}:{source:e.source,sourceType:e.sourceType,format:e.format,...e.commitSha?{commitSha:e.commitSha}:{}}}async function md(e,t){let{getAllRoots:n,getFlows:r,getWorkspaceRoot:i,isValidFlowRoot:a,log:o,patchMetaRoots:s,stateDir:c,toErrorText:l,toTextResponse:u}=t,{flow:d,topic:f,roots:p,objective:m,acceptanceCriteria:h,scope:g,exclusions:_}=e;try{if(p&&p.length>0){let e=n().map(e=>e.replaceAll(`\\`,`/`)),t=p.filter(e=>!a(e));if(t.length>0)return u(`Invalid roots — not part of the workspace or a recognized sub-repository: ${t.join(`, `)}. Available roots: ${e.join(`, `)}`)}let e=n(),o=e.map(e=>e.replaceAll(`\\`,`/`)),l=i(),v=e.length>1,y=!p&&v,b=p?.[0]??l,{registry:x,stateMachine:S}=await r(b),C=x.get(d);if(!C)throw new Ju(`UNKNOWN_FLOW`,`Flow "${d}" not found. Use flow({ action: "list" }) to see available flows.`);let w=S.start(C.name,C.manifest,f,pd(C),{objective:m,acceptanceCriteria:h,scope:g,exclusions:_});if(!w.success||!w.data){let e=w.error??`Unknown flow start error.`;return e.includes(`already active`)?u(`Cannot start: ${new Ju(`FLOW_ALREADY_ACTIVE`,e).message}`):u(`Cannot start: ${e}`)}let T=w.data,E;if(t.config.layeredKnowledge){let e=Lr(),t=S.setOwnerCapability({ownerTokenSalt:e.salt,ownerTokenHash:e.hash,ownerTokenVersion:e.version});if(!t.success)return u(`Cannot start in layered mode: failed to persist owner capability — ${t.error??`unknown error`}`);E=e.rawToken}if(p&&p.length>1)try{s(T.slug,b,p),t.syncMetaToRoots(T.slug,b)}catch(e){return S.reset(),u(`Flow created but failed to sync to secondary roots — rolled back. Error: ${e instanceof Error?e.message:String(e)}`)}let D=F(c,`flow-context`),O=typeof Ue==`function`?await Ue(D).catch(()=>[]):[];for(let e of O)e!==T.slug&&typeof We==`function`&&await We(F(D,e),{recursive:!0,force:!0}).catch(()=>{});if(typeof Ve==`function`)try{await Ve(F(D,T.slug),{recursive:!0})}catch{}let k=await dd({context:t,entry:C,state:T,activeRoot:b,primaryRoot:null,roots:p??null}),ee=Ir(T,C.manifest,{objective:m,acceptanceCriteria:h,scope:g,exclusions:_}),te={...fd({state:T,data:k,started:!0}),phase:T.phase,isEpilogue:T.isEpilogue,totalSteps:k.stepSequence.length,stepSequence:k.stepSequence,artifactsDir:C.manifest.artifacts_dir,roots:p??[b.replaceAll(`\\`,`/`)],snapshot:ee,_hint:id,...y?{multiRootWarning:`No roots specified in multi-root workspace. Flow created at workspace root. Pass roots parameter with target repo for precise placement.`,availableRoots:o}:{},...E?{_ownerToken:E}:{}};return u(JSON.stringify(te,null,2))}catch(e){return Yu(e)?u(e.message):(o.error(`flow action start failed`,M(e)),u(`Error: ${l(e)}`))}}async function hd(e,t){let{getFlows:n,log:r,resolveFlowRoot:i,syncMetaToRoots:a,toErrorText:o,toTextResponse:s}=t,{targetStep:c,lifecycleOwnerToken:l,currentToken:u}=e;try{let e=await i(),{registry:r,stateMachine:o}=await n(e),d=o.getStatus();if(!d.success||!d.data)return s(`No active flow. Use flow({ action: "start", name: "<flow>" }) first.`);let f=d.data,p=r.get(f.flow);if(!p)return s(`Flow "${f.flow}" not found in registry.`);if(t.config.layeredKnowledge){if(!l)return s(`lifecycleOwnerToken required in layered mode.`);let e=f,t=e.ownerTokenSalt,n=e.ownerTokenHash;if(!t||!n)return s(`Flow has no owner capability — cannot backtrack.`);if(!zr(l,t,n))return s(`Invalid lifecycleOwnerToken — backtrack denied.`);if(u&&u!==f.currentToken)return s(`Invalid currentToken — flow state changed since last status.`)}let m=o.backtrack(c,p.manifest);if(!m.success||!m.data)return s(`Cannot backtrack: ${m.error}`);a(m.data.slug,e);let h=m.data,g=await dd({context:t,entry:p,state:h,activeRoot:e,primaryRoot:h.primaryRoot,roots:h.roots}),_={...fd({state:h,data:g,includeStatus:!0,action:`backtrack`}),_hint:h.currentStep?id:void 0,phase:h.phase,isEpilogue:h.isEpilogue,completedSteps:h.completedSteps,skippedSteps:h.skippedSteps,totalSteps:g.stepSequence.length};return s(JSON.stringify(_,null,2))}catch(e){return Yu(e)?s(e.message):(r.error(`flow action backtrack failed`,M(e)),s(`Error: ${o(e)}`))}}async function gd(e,t){let{getFlows:n,log:r,resolveFlowRoot:i,syncMetaToRoots:a,toErrorText:o,toTextResponse:s}=t,{currentToken:c}=e;try{let e=await i(),{stateMachine:r}=await n(e),o=r.getStatus();if(!o.success||!o.data)return s(`No active flow. Use flow({ action: "start", name: "<flow>" }) first.`);let l=o.data;if(c&&c!==l.currentToken)return s(`Invalid currentToken — claim denied.`);if(!t.config.layeredKnowledge)return s(`Claim requires layeredKnowledge mode.`);let u=t.server?(await import(`./sampling-BoH5wpOJ.js`)).createSamplingClient(t.server):null;if(u?.available){if((await u.createMessage({prompt:`You have been asked to transfer flow ownership. Do you confirm?`,systemPrompt:`Respond with "yes" to confirm or anything else to decline.`,maxTokens:16,modelPreferences:{intelligencePriority:.2,speedPriority:.9,costPriority:.9}})).text.trim().toLowerCase()!==`yes`)return s(`Ownership transfer declined by user.`)}else return s(`Cannot verify ownership transfer — no elicitor available.`);let d=Rr(l.ownerTokenVersion??1),f=r.setOwnerCapability({ownerTokenSalt:d.salt,ownerTokenHash:d.hash,ownerTokenVersion:d.version});if(!f.success)return s(`Claim failed: ${f.error}`);let p=r.getStatus();if(p.success&&p.data){let t=p.data;a(t.slug,e)}let m={success:!0,_ownerToken:d.rawToken,version:d.version,message:`Ownership transferred successfully.`};return s(JSON.stringify(m,null,2))}catch(e){return Yu(e)?s(e.message):(r.error(`flow action claim failed`,M(e)),s(`Error: ${o(e)}`))}}async function _d(e){let{getFlows:t,log:n,resolveFlowRoot:r,resolveRoots:i,toErrorText:a,toTextResponse:o}=e;try{let n=await r(),{registry:a,stateMachine:s}=await t(n),c=s.getStatus();if(!c.success||!c.data)throw new Ju(`NO_ACTIVE_FLOW`,`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let l=c.data,u=a.get(l.flow),d=u?await dd({context:e,entry:u,state:l,activeRoot:n,primaryRoot:l.primaryRoot,roots:l.roots}):sd(),f={...fd({state:l,data:d,includeStatus:!0,includeInstructionPath:!0}),_hint:l.currentStep?id:void 0,phase:l.phase,isEpilogue:l.isEpilogue,completedSteps:l.completedSteps,skippedSteps:l.skippedSteps,artifacts:l.artifacts,startedAt:l.startedAt,updatedAt:l.updatedAt,totalSteps:d.stepSequence.length,progress:u?`${l.completedSteps.length+l.skippedSteps.length}/${d.stepSequence.length}`:`unknown`,workspaceRoot:n.replaceAll(`\\`,`/`),primaryRoot:(l.primaryRoot??n).replaceAll(`\\`,`/`),roots:l.roots??[n.replaceAll(`\\`,`/`)],allRoots:i().normalizedAllRoots,discoveredRepos:i().discoveredRepos};return o(JSON.stringify(f,null,2))}catch(e){return Yu(e)?o(e.message):(n.error(`flow action status failed`,M(e)),o(`Error: ${a(e)}`))}}async function vd(e){let{getFlows:t,log:n,resolveFlowRoot:r,stateDir:i,syncMetaToRoots:a,toErrorText:o,toTextResponse:s}=e;try{let e=await r(),{stateMachine:n}=await t(e),o=n.getStatus(),c=n.reset();if(!c.success)return s(`Reset failed: ${c.error}`);if(o.success&&o.data&&a(o.data.slug,e),o.success&&o.data?.slug)try{await We(F(i,`flow-context`,o.data.slug),{recursive:!0,force:!0})}catch{}return s(`Flow abandoned. Use flow({ action: "start", name: "<flow>" }) to begin a new flow.`)}catch(e){return n.error(`flow action reset failed`,M(e)),s(`Error: ${o(e)}`)}}async function yd(e,t){let{getFlows:n,log:r,resolveFlowRoot:i,syncMetaToRoots:a,toErrorText:o,toTextResponse:s}=t,{action:c,targetStep:l,lifecycleOwnerToken:u,currentToken:d}=e;if(c===`backtrack`)return l?hd({targetStep:l,lifecycleOwnerToken:u,currentToken:d},t):s(`Missing required parameter: targetStep for backtrack action.`);try{let e=await i(),{registry:r,stateMachine:o}=await n(e),l=o.getStatus();if(!l.success||!l.data)throw new Ju(`NO_ACTIVE_FLOW`,`No active flow. Use flow({ action: "start", name: "<flow>" }) first.`);let u=r.get(l.data.flow);if(!u)throw new Ju(`FLOW_NOT_FOUND`,`Flow "${l.data.flow}" not found in registry.`);let d=o.step(c,u.manifest);if(!d.success||!d.data)return s(`Cannot ${c}: ${d.error}`);a(d.data.slug,e);let f=d.data,p=[];if(f.status===`completed`){let e=F(t.stateDir,`flow-context`,f.slug);for(let t of[`decision`,`pattern`]){let n=F(e,t);try{let e=await Ue(n);for(let r of e){if(!r.endsWith(`.md`))continue;let e=await He(F(n,r),`utf-8`);e.length>100&&p.push({type:t,title:r.replace(/\.md$/,``).replace(/-/g,` `),content:e.length>500?`${e.slice(0,497)}...`:e})}}catch{}}typeof We==`function`&&await We(e,{recursive:!0,force:!0}).catch(()=>{})}let m=await dd({context:t,entry:u,state:f,activeRoot:e,primaryRoot:f.primaryRoot,roots:f.roots}),h={...fd({state:f,data:m,includeStatus:!0,action:c}),_hint:f.currentStep?id:void 0,phase:f.phase,isEpilogue:f.isEpilogue,completedSteps:f.completedSteps,skippedSteps:f.skippedSteps,totalSteps:m.stepSequence.length,remaining:m.stepSequence.filter(e=>!f.completedSteps.includes(e)&&!f.skippedSteps.includes(e)&&e!==f.currentStep),...p.length>0?{promotionCandidates:p}:{}};return s(JSON.stringify(h,null,2))}catch(e){return Yu(e)?s(e.message):(r.error(`flow action step failed`,M(e)),s(`Error: ${o(e)}`))}}async function bd(e){let{getFlows:t,log:n,resolveFlowRoot:r,resolveRoots:i,toErrorText:a,toTextResponse:o}=e;try{let{registry:e,stateMachine:n,installer:a}=await t(await r()),s=e.list(),c=n.getStatus(),l={flows:s.map(e=>{let t={name:e.name,version:e.version,source:e.source,sourceType:e.sourceType,format:e.format,steps:e.manifest.steps.map(e=>e.id)};if(e.sourceType===`git`&&e.commitSha){let n=a.hasUpdates(e.installPath);return{...t,commitSha:e.commitSha,updateAvailable:n.success&&n.data?n.data.hasUpdates:void 0}}return t}),activeFlow:c.success&&c.data?{flow:c.data.flow,flowOrigin:c.data.flowOrigin,status:c.data.status,currentStep:c.data.currentStep,slug:c.data.slug,topic:c.data.topic,runDir:c.data.runDir}:null,allRoots:i().normalizedAllRoots,discoveredRepos:i().discoveredRepos};return o(JSON.stringify(l,null,2))}catch(e){return n.error(`flow action list failed`,M(e)),o(`Error: ${a(e)}`)}}async function xd(e,t){let{getFlows:n,log:r,resolveInstallPath:i,resolveInstructionPath:a,toErrorText:o,toTextResponse:s}=t,{name:c}=e;try{let{registry:e,installer:t}=await n(),r=e.get(c);if(!r)throw new Ju(`UNKNOWN_FLOW`,`Flow "${c}" not found. Use flow({ action: "list" }) to see available flows.`);let o=r.commitSha??null,l;if(r.sourceType===`git`&&r.installPath){let e=t.hasUpdates(r.installPath);l=e.success&&e.data?e.data.hasUpdates:void 0}let u={name:r.name,version:r.version,description:r.manifest.description,source:r.source,sourceType:r.sourceType,format:r.format,commitSha:o,updateAvailable:l,installPath:i(r.name,r),registeredAt:r.registeredAt,updatedAt:r.updatedAt,steps:r.manifest.steps.map(e=>({id:e.id,name:e.name,instruction:a(r,e.instruction),produces:e.produces,requires:e.requires,description:e.description})),agents:r.manifest.agents,artifactsDir:r.manifest.artifacts_dir,install:r.manifest.install};return s(JSON.stringify(u,null,2))}catch(e){return Yu(e)?s(e.message):(r.error(`flow action info failed`,M(e)),s(`Error: ${o(e)}`))}}async function Sd(e,t){let{getAllRoots:n,getFlows:r,log:i,toErrorText:a,toTextResponse:o}=t,{flow:s,status:c,limit:l=50}=e,u=e=>{for(let t of[`updatedAt`,`startedAt`,`createdAt`]){let n=e[t];if(typeof n==`number`&&Number.isFinite(n))return n;if(typeof n==`string`){let e=Date.parse(n);if(!Number.isNaN(e))return e}}return null};try{let e=n(),t=[];for(let n of e){let{stateMachine:e}=await r(n),i=e.listRuns({flow:s,status:c});for(let e of i)t.push({...JSON.parse(JSON.stringify(e)),root:n.replaceAll(`\\`,`/`)})}let i=new Set,a=t.filter(e=>{let t=e.id;return i.has(t)?!1:(i.add(t),!0)});if(a.length===0)return o(`No flow runs found.`);let d=a.map((e,t)=>({run:e,index:t,recency:u(e)})).sort((e,t)=>e.recency==null&&t.recency==null?e.index-t.index:e.recency==null?1:t.recency==null?-1:t.recency===e.recency?e.index-t.index:t.recency-e.recency).map(({run:e})=>e).slice(0,l);return o(JSON.stringify({total:a.length,returned:d.length,truncated:a.length>d.length,runs:d},null,2))}catch(e){return i.error(`flow action runs failed`,M(e)),o(`Error: ${a(e)}`)}}function Cd(e){let t=e.content?.find(e=>e.type===`text`)?.text??``;if(!t)return null;try{let e=JSON.parse(t);if(typeof e.slug==`string`&&e.slug.length>0)return e.slug}catch{}return t.match(/[Ss]lug[:\s]*`?([^`\s,]+)`?/)?.[1]??null}function wd(e,t,n,r){let i=n&&typeof n!=`function`?n:void 0,a=typeof n==`function`?n:r,o=qu(e,t,i),s=W(`flow`);e.registerTool(`flow`,{title:s.title,description:`Manage development flows — list available flows, start/stop runs, navigate steps, read instructions, and install/remove/update flows. Use action parameter to select operation.`,annotations:s.annotations,inputSchema:{action:R.enum([`list`,`info`,`start`,`step`,`status`,`reset`,`read`,`runs`,`add`,`remove`,`update`,`backtrack`,`claim`]).describe(`The flow operation to perform.`),name:R.string().optional().describe(`Flow name — required for info, start, remove, update. Optional override for add.`),topic:R.string().optional().describe(`Human-readable topic for the run (used by start).`),objective:R.string().optional().describe(`L1 snapshot objective — the goal of this flow run. Falls back to topic when absent.`),acceptanceCriteria:R.array(R.string()).optional().describe(`L1 snapshot acceptance criteria (used by start).`),scope:R.array(R.string()).optional().describe(`L1 snapshot scope boundaries (used by start). Falls back to roots when absent.`),exclusions:R.array(R.string()).optional().describe(`L1 snapshot exclusions — what is out of scope (used by start).`),roots:R.array(R.string()).optional().describe(`Workspace roots participating in this flow (used by start).`),advance:R.enum([`next`,`skip`,`redo`,`backtrack`]).optional().describe(`Step navigation action — required for step.`),lifecycleOwnerToken:R.string().optional().describe(`Owner capability token for layered lifecycle mutations (required in layered mode for step/backtrack/claim/reset).`),currentToken:R.string().optional().describe(`Current step execution token from status response for optimistic concurrency.`),targetStep:R.string().optional().describe(`Target step ID for backtrack action — must be a completed prior step.`),step:R.string().optional().describe(`Step id or name to read (used by read). Defaults to current step.`),source:R.string().optional().describe(`Git URL, local path, or "openspec" shorthand — required for add.`),token:R.string().optional().describe(`Auth token for private repos (used by add).`),filter_flow:R.string().optional().describe(`Filter runs by flow name (used by runs).`),filter_status:R.string().optional().describe(`Filter runs by status: active, completed, abandoned (used by runs).`),limit:R.number().int().positive().optional().describe(`Max runs to return (default 50).`)}},J(`flow`,async e=>{switch(e.action){case`list`:return bd(o);case`info`:return e.name?xd({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);case`start`:{if(!e.name)return o.toTextResponse(`Missing required parameter: name (flow to start)`);let t=await md({flow:e.name,topic:e.topic,roots:e.roots,objective:e.objective,acceptanceCriteria:e.acceptanceCriteria,scope:e.scope,exclusions:e.exclusions},o),n=Cd(t);return n&&a&&a(n),t}case`step`:return e.advance?yd({action:e.advance,targetStep:e.targetStep,lifecycleOwnerToken:e.lifecycleOwnerToken,currentToken:e.currentToken},o):o.toTextResponse(`Missing required parameter: advance (next/skip/redo/backtrack)`);case`status`:{let e=await _d(o);return a&&a(Cd(e)),e}case`reset`:{let e=await vd(o);return a&&a(null),e}case`read`:return Zu({step:e.step},o);case`runs`:return Sd({flow:e.filter_flow,status:e.filter_status,limit:e.limit},o);case`add`:return e.source?td({source:e.source,name:e.name,token:e.token},o):o.toTextResponse(`Missing required parameter: source`);case`remove`:return e.name?nd({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);case`update`:return e.name?rd({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);case`backtrack`:return e.targetStep?hd({targetStep:e.targetStep,lifecycleOwnerToken:e.lifecycleOwnerToken,currentToken:e.currentToken},o):o.toTextResponse(`Missing required parameter: targetStep for backtrack action`);case`claim`:return gd({currentToken:e.currentToken},o);default:return o.toTextResponse(`Unknown action: ${e.action}`)}}))}const Td=j(`tools`);function Ed(e){let t=W(`evidence_map`);e.registerTool(`evidence_map`,{title:t.title,description:`Track verified/assumed/unresolved claims for complex tasks. Gate readiness: YIELD (proceed), HOLD (unknowns), HARD_BLOCK (critical gaps). Persists across calls.`,inputSchema:{action:R.enum([`create`,`add`,`update`,`get`,`gate`,`list`,`delete`]).describe(`Operation to perform`),task_id:R.string().optional().describe(`Task identifier (required for all except list)`),tier:R.enum([`floor`,`standard`,`critical`]).optional().describe(`FORGE tier (required for create)`),claim:R.string().optional().describe(`Critical-path claim text (for add)`),status:R.enum([`V`,`A`,`U`]).optional().describe(`Evidence status: V=Verified, A=Assumed, U=Unresolved`),receipt:R.string().optional().describe(`Evidence receipt: tool→ref for V, reasoning for A, attempts for U`),id:R.number().optional().describe(`Entry ID (for update)`),critical_path:R.boolean().default(!0).describe(`Whether this claim is on the critical path`),unknown_type:R.enum([`contract`,`convention`,`freshness`,`runtime`,`data-flow`,`impact`]).optional().describe(`Typed unknown classification`),safety_gate:R.enum([`provenance`,`commitment`,`coverage`]).optional().describe(`Safety gate tag: provenance (claim→evidence), commitment (user-approved), coverage (nothing dropped)`),retry_count:R.number().default(0).describe(`Retry count for gate evaluation (0 = first attempt)`),max_retries:R.number().int().min(0).optional().describe(`Maximum retries before escalating. Default: 3`),timeout_action:R.enum([`iterate`,`retry`,`manual`,`terminate`]).optional().describe(`Action to take when gate retries are exhausted. Default: manual`),cwd:R.string().optional().describe(`Working directory for evidence map storage (default: server cwd). Use root_path from forge_ground to match.`)},annotations:t.annotations},J(`evidence_map`,async({action:e,task_id:t,tier:n,claim:r,status:i,receipt:a,id:o,critical_path:s,unknown_type:c,safety_gate:l,retry_count:u,max_retries:d,timeout_action:f,cwd:p})=>{try{switch(e){case`create`:if(!t)throw Error(`task_id required for create`);if(!n)throw Error(`tier required for create`);return Dt({action:`create`,taskId:t,tier:n},p),{content:[{type:`text`,text:`Created evidence map "${t}" (tier: ${n}).\n\n---\n_Next: Use \`evidence_map\` with action "add" to record critical-path claims._`}]};case`add`:{if(!t)throw Error(`task_id required for add`);if(!r)throw Error(`claim required for add`);if(!i)throw Error(`status required for add`);let e=Dt({action:`add`,taskId:t,claim:r,status:i,receipt:a??``,criticalPath:s,unknownType:c,safetyGate:l},p),n=e.autoCreated?[`⚠️ Evidence map "${t}" was auto-created with tier "standard". Use \`create\` action to set a specific tier.`,``,`Added entry #${e.entry?.id} to "${t}": [${i}] ${r}`]:[`Added entry #${e.entry?.id} to "${t}": [${i}] ${r}`];return e.summary&&n.push(``,e.summary),{content:[{type:`text`,text:n.join(`
|
|
196
|
+
`):null}}function fd(e,t){return t(e)}async function pd(e){let{context:t,entry:n,state:r,activeRoot:i,primaryRoot:a,roots:o}=e,{instructionPath:s,description:c}=t.resolveCurrentStepInfo(n,r.currentStep,i),l=fd(n,t.getStepSequence),u=await Qu({entry:n,stepId:r.currentStep,runDir:r.runDir,slug:r.slug,primaryRoot:a,roots:o,activeRoot:i,resolveInstructionPath:t.resolveInstructionPath,resolveEpilogueInstructionPath:t.resolveEpilogueInstructionPath}),{brief:d,pins:f}=dd(u),p=d;if(d&&r.currentStep){let e=n.manifest.steps.find(e=>e.id===r.currentStep),a={stepId:r.currentStep,flowName:r.flow,flowSlug:r.slug,phase:`flow`,runDir:r.runDir,artifactsPath:F(r.runDir,n.manifest.artifacts_dir).replaceAll(`\\`,`/`),completedSteps:r.completedSteps??[],stepDescription:e?.description??c??void 0,agents:e?.agents??[],mode:`brief`,topic:r.topic??``,activeRoot:i};p=await t.stepPipeline.enrich(d,a,n.manifest.hooks)}return{artifactsPath:F(r.runDir,n.manifest.artifacts_dir).replaceAll(`\\`,`/`),currentStepInstruction:s,currentStepDescription:c,currentStepContent:u,currentStepBrief:p,currentStepPins:f,stepSequence:l}}function md(e){let{state:t,data:n,started:r,includeStatus:i,action:a,includeInstructionPath:o}=e,s={};return r&&(s.started=!0),s.flow=t.flow,t.flowOrigin&&(s.flowOrigin=t.flowOrigin),i&&(s.status=t.status),a&&(s.action=a),s.slug=t.slug,s.topic=t.topic,s.runDir=t.runDir,s.artifactsPath=n.artifactsPath,s.currentStep=t.currentStep,s.currentStepInstruction=n.currentStepInstruction,o&&(s.instructionPath=n.currentStepInstruction),s.currentStepDescription=n.currentStepDescription,s.currentStepContent=null,s.currentStepBrief=n.currentStepBrief,s.currentStepPins=n.currentStepPins,s.fullContentHint=`Call flow({ action: 'read' }) for the complete step instructions.`,s}function hd(e){return e.sourceType===`local`?{source:`local`,sourceType:e.sourceType,format:e.format,...e.commitSha?{commitSha:e.commitSha}:{}}:{source:e.source,sourceType:e.sourceType,format:e.format,...e.commitSha?{commitSha:e.commitSha}:{}}}async function gd(e,t){let{getAllRoots:n,getFlows:r,getWorkspaceRoot:i,isValidFlowRoot:a,log:o,patchMetaRoots:s,stateDir:c,toErrorText:l,toTextResponse:u}=t,{flow:d,topic:f,roots:p,objective:m,acceptanceCriteria:h,scope:g,exclusions:_}=e;try{if(p&&p.length>0){let e=n().map(e=>e.replaceAll(`\\`,`/`)),t=p.filter(e=>!a(e));if(t.length>0)return u(`Invalid roots — not part of the workspace or a recognized sub-repository: ${t.join(`, `)}. Available roots: ${e.join(`, `)}`)}let e=n(),o=e.map(e=>e.replaceAll(`\\`,`/`)),l=i(),v=e.length>1,y=!p&&v,b=p?.[0]??l,{registry:x,stateMachine:S}=await r(b),C=x.get(d);if(!C)throw new Xu(`UNKNOWN_FLOW`,`Flow "${d}" not found. Use flow({ action: "list" }) to see available flows.`);let w=S.start(C.name,C.manifest,f,hd(C),{objective:m,acceptanceCriteria:h,scope:g,exclusions:_});if(!w.success||!w.data){let e=w.error??`Unknown flow start error.`;return e.includes(`already active`)?u(`Cannot start: ${new Xu(`FLOW_ALREADY_ACTIVE`,e).message}`):u(`Cannot start: ${e}`)}let T=w.data,E;if(t.config.layeredKnowledge){let e=Lr(),t=S.setOwnerCapability({ownerTokenSalt:e.salt,ownerTokenHash:e.hash,ownerTokenVersion:e.version});if(!t.success)return u(`Cannot start in layered mode: failed to persist owner capability — ${t.error??`unknown error`}`);E=e.rawToken}if(p&&p.length>1)try{s(T.slug,b,p),t.syncMetaToRoots(T.slug,b)}catch(e){return S.reset(),u(`Flow created but failed to sync to secondary roots — rolled back. Error: ${e instanceof Error?e.message:String(e)}`)}let D=F(c,`flow-context`),O=typeof Ue==`function`?await Ue(D).catch(()=>[]):[];for(let e of O)e!==T.slug&&typeof We==`function`&&await We(F(D,e),{recursive:!0,force:!0}).catch(()=>{});if(typeof Ve==`function`)try{await Ve(F(D,T.slug),{recursive:!0})}catch{}let k=await pd({context:t,entry:C,state:T,activeRoot:b,primaryRoot:null,roots:p??null}),ee=Ir(T,C.manifest,{objective:m,acceptanceCriteria:h,scope:g,exclusions:_}),te={...md({state:T,data:k,started:!0}),phase:T.phase,isEpilogue:T.isEpilogue,totalSteps:k.stepSequence.length,stepSequence:k.stepSequence,artifactsDir:C.manifest.artifacts_dir,roots:p??[b.replaceAll(`\\`,`/`)],snapshot:ee,_hint:od,...y?{multiRootWarning:`No roots specified in multi-root workspace. Flow created at workspace root. Pass roots parameter with target repo for precise placement.`,availableRoots:o}:{},...E?{_ownerToken:E}:{}};return u(JSON.stringify(te,null,2))}catch(e){return Zu(e)?u(e.message):(o.error(`flow action start failed`,M(e)),u(`Error: ${l(e)}`))}}async function _d(e,t){let{getFlows:n,log:r,resolveFlowRoot:i,syncMetaToRoots:a,toErrorText:o,toTextResponse:s}=t,{targetStep:c,lifecycleOwnerToken:l,currentToken:u}=e;try{let e=await i(),{registry:r,stateMachine:o}=await n(e),d=o.getStatus();if(!d.success||!d.data)return s(`No active flow. Use flow({ action: "start", name: "<flow>" }) first.`);let f=d.data,p=r.get(f.flow);if(!p)return s(`Flow "${f.flow}" not found in registry.`);if(t.config.layeredKnowledge){if(!l)return s(`lifecycleOwnerToken required in layered mode.`);let e=f,t=e.ownerTokenSalt,n=e.ownerTokenHash;if(!t||!n)return s(`Flow has no owner capability — cannot backtrack.`);if(!zr(l,t,n))return s(`Invalid lifecycleOwnerToken — backtrack denied.`);if(u&&u!==f.currentToken)return s(`Invalid currentToken — flow state changed since last status.`)}let m=o.backtrack(c,p.manifest);if(!m.success||!m.data)return s(`Cannot backtrack: ${m.error}`);a(m.data.slug,e);let h=m.data,g=await pd({context:t,entry:p,state:h,activeRoot:e,primaryRoot:h.primaryRoot,roots:h.roots}),_={...md({state:h,data:g,includeStatus:!0,action:`backtrack`}),_hint:h.currentStep?od:void 0,phase:h.phase,isEpilogue:h.isEpilogue,completedSteps:h.completedSteps,skippedSteps:h.skippedSteps,totalSteps:g.stepSequence.length};return s(JSON.stringify(_,null,2))}catch(e){return Zu(e)?s(e.message):(r.error(`flow action backtrack failed`,M(e)),s(`Error: ${o(e)}`))}}async function vd(e,t){let{getFlows:n,log:r,resolveFlowRoot:i,syncMetaToRoots:a,toErrorText:o,toTextResponse:s}=t,{currentToken:c}=e;try{let e=await i(),{stateMachine:r}=await n(e),o=r.getStatus();if(!o.success||!o.data)return s(`No active flow. Use flow({ action: "start", name: "<flow>" }) first.`);let l=o.data;if(c&&c!==l.currentToken)return s(`Invalid currentToken — claim denied.`);if(!t.config.layeredKnowledge)return s(`Claim requires layeredKnowledge mode.`);let u=t.server?(await import(`./sampling-CnE3owSt.js`)).createSamplingClient(t.server):null;if(u?.available){if((await u.createMessage({prompt:`You have been asked to transfer flow ownership. Do you confirm?`,systemPrompt:`Respond with "yes" to confirm or anything else to decline.`,maxTokens:16,modelPreferences:{intelligencePriority:.2,speedPriority:.9,costPriority:.9}})).text.trim().toLowerCase()!==`yes`)return s(`Ownership transfer declined by user.`)}else return s(`Cannot verify ownership transfer — no elicitor available.`);let d=Rr(l.ownerTokenVersion??1),f=r.setOwnerCapability({ownerTokenSalt:d.salt,ownerTokenHash:d.hash,ownerTokenVersion:d.version});if(!f.success)return s(`Claim failed: ${f.error}`);let p=r.getStatus();if(p.success&&p.data){let t=p.data;a(t.slug,e)}let m={success:!0,_ownerToken:d.rawToken,version:d.version,message:`Ownership transferred successfully.`};return s(JSON.stringify(m,null,2))}catch(e){return Zu(e)?s(e.message):(r.error(`flow action claim failed`,M(e)),s(`Error: ${o(e)}`))}}async function yd(e){let{getFlows:t,log:n,resolveFlowRoot:r,resolveRoots:i,toErrorText:a,toTextResponse:o}=e;try{let n=await r(),{registry:a,stateMachine:s}=await t(n),c=s.getStatus();if(!c.success||!c.data)throw new Xu(`NO_ACTIVE_FLOW`,`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let l=c.data,u=a.get(l.flow),d=u?await pd({context:e,entry:u,state:l,activeRoot:n,primaryRoot:l.primaryRoot,roots:l.roots}):ld(),f={...md({state:l,data:d,includeStatus:!0,includeInstructionPath:!0}),_hint:l.currentStep?od:void 0,phase:l.phase,isEpilogue:l.isEpilogue,completedSteps:l.completedSteps,skippedSteps:l.skippedSteps,artifacts:l.artifacts,startedAt:l.startedAt,updatedAt:l.updatedAt,totalSteps:d.stepSequence.length,progress:u?`${l.completedSteps.length+l.skippedSteps.length}/${d.stepSequence.length}`:`unknown`,workspaceRoot:n.replaceAll(`\\`,`/`),primaryRoot:(l.primaryRoot??n).replaceAll(`\\`,`/`),roots:l.roots??[n.replaceAll(`\\`,`/`)],allRoots:i().normalizedAllRoots,discoveredRepos:i().discoveredRepos};return o(JSON.stringify(f,null,2))}catch(e){return Zu(e)?o(e.message):(n.error(`flow action status failed`,M(e)),o(`Error: ${a(e)}`))}}async function bd(e){let{getFlows:t,log:n,resolveFlowRoot:r,stateDir:i,syncMetaToRoots:a,toErrorText:o,toTextResponse:s}=e;try{let e=await r(),{stateMachine:n}=await t(e),o=n.getStatus(),c=n.reset();if(!c.success)return s(`Reset failed: ${c.error}`);if(o.success&&o.data&&a(o.data.slug,e),o.success&&o.data?.slug)try{await We(F(i,`flow-context`,o.data.slug),{recursive:!0,force:!0})}catch{}return s(`Flow abandoned. Use flow({ action: "start", name: "<flow>" }) to begin a new flow.`)}catch(e){return n.error(`flow action reset failed`,M(e)),s(`Error: ${o(e)}`)}}async function xd(e,t){let{getFlows:n,log:r,resolveFlowRoot:i,syncMetaToRoots:a,toErrorText:o,toTextResponse:s}=t,{action:c,targetStep:l,lifecycleOwnerToken:u,currentToken:d}=e;if(c===`backtrack`)return l?_d({targetStep:l,lifecycleOwnerToken:u,currentToken:d},t):s(`Missing required parameter: targetStep for backtrack action.`);try{let e=await i(),{registry:r,stateMachine:o}=await n(e),l=o.getStatus();if(!l.success||!l.data)throw new Xu(`NO_ACTIVE_FLOW`,`No active flow. Use flow({ action: "start", name: "<flow>" }) first.`);let u=r.get(l.data.flow);if(!u)throw new Xu(`FLOW_NOT_FOUND`,`Flow "${l.data.flow}" not found in registry.`);let d=o.step(c,u.manifest);if(!d.success||!d.data)return s(`Cannot ${c}: ${d.error}`);a(d.data.slug,e);let f=d.data,p=[];if(f.status===`completed`){let e=F(t.stateDir,`flow-context`,f.slug);for(let t of[`decision`,`pattern`]){let n=F(e,t);try{let e=await Ue(n);for(let r of e){if(!r.endsWith(`.md`))continue;let e=await He(F(n,r),`utf-8`);e.length>100&&p.push({type:t,title:r.replace(/\.md$/,``).replace(/-/g,` `),content:e.length>500?`${e.slice(0,497)}...`:e})}}catch{}}typeof We==`function`&&await We(e,{recursive:!0,force:!0}).catch(()=>{})}let m=await pd({context:t,entry:u,state:f,activeRoot:e,primaryRoot:f.primaryRoot,roots:f.roots}),h={...md({state:f,data:m,includeStatus:!0,action:c}),_hint:f.currentStep?od:void 0,phase:f.phase,isEpilogue:f.isEpilogue,completedSteps:f.completedSteps,skippedSteps:f.skippedSteps,totalSteps:m.stepSequence.length,remaining:m.stepSequence.filter(e=>!f.completedSteps.includes(e)&&!f.skippedSteps.includes(e)&&e!==f.currentStep),...p.length>0?{promotionCandidates:p}:{}};return s(JSON.stringify(h,null,2))}catch(e){return Zu(e)?s(e.message):(r.error(`flow action step failed`,M(e)),s(`Error: ${o(e)}`))}}async function Sd(e){let{getFlows:t,log:n,resolveFlowRoot:r,resolveRoots:i,toErrorText:a,toTextResponse:o}=e;try{let{registry:e,stateMachine:n,installer:a}=await t(await r()),s=e.list(),c=n.getStatus(),l={flows:s.map(e=>{let t={name:e.name,version:e.version,source:e.source,sourceType:e.sourceType,format:e.format,steps:e.manifest.steps.map(e=>e.id)};if(e.sourceType===`git`&&e.commitSha){let n=a.hasUpdates(e.installPath);return{...t,commitSha:e.commitSha,updateAvailable:n.success&&n.data?n.data.hasUpdates:void 0}}return t}),activeFlow:c.success&&c.data?{flow:c.data.flow,flowOrigin:c.data.flowOrigin,status:c.data.status,currentStep:c.data.currentStep,slug:c.data.slug,topic:c.data.topic,runDir:c.data.runDir}:null,allRoots:i().normalizedAllRoots,discoveredRepos:i().discoveredRepos};return o(JSON.stringify(l,null,2))}catch(e){return n.error(`flow action list failed`,M(e)),o(`Error: ${a(e)}`)}}async function Cd(e,t){let{getFlows:n,log:r,resolveInstallPath:i,resolveInstructionPath:a,toErrorText:o,toTextResponse:s}=t,{name:c}=e;try{let{registry:e,installer:t}=await n(),r=e.get(c);if(!r)throw new Xu(`UNKNOWN_FLOW`,`Flow "${c}" not found. Use flow({ action: "list" }) to see available flows.`);let o=r.commitSha??null,l;if(r.sourceType===`git`&&r.installPath){let e=t.hasUpdates(r.installPath);l=e.success&&e.data?e.data.hasUpdates:void 0}let u={name:r.name,version:r.version,description:r.manifest.description,source:r.source,sourceType:r.sourceType,format:r.format,commitSha:o,updateAvailable:l,installPath:i(r.name,r),registeredAt:r.registeredAt,updatedAt:r.updatedAt,steps:r.manifest.steps.map(e=>({id:e.id,name:e.name,instruction:a(r,e.instruction),produces:e.produces,requires:e.requires,description:e.description})),agents:r.manifest.agents,artifactsDir:r.manifest.artifacts_dir,install:r.manifest.install};return s(JSON.stringify(u,null,2))}catch(e){return Zu(e)?s(e.message):(r.error(`flow action info failed`,M(e)),s(`Error: ${o(e)}`))}}async function wd(e,t){let{getAllRoots:n,getFlows:r,log:i,toErrorText:a,toTextResponse:o}=t,{flow:s,status:c,limit:l=50}=e,u=e=>{for(let t of[`updatedAt`,`startedAt`,`createdAt`]){let n=e[t];if(typeof n==`number`&&Number.isFinite(n))return n;if(typeof n==`string`){let e=Date.parse(n);if(!Number.isNaN(e))return e}}return null};try{let e=n(),t=[];for(let n of e){let{stateMachine:e}=await r(n),i=e.listRuns({flow:s,status:c});for(let e of i)t.push({...JSON.parse(JSON.stringify(e)),root:n.replaceAll(`\\`,`/`)})}let i=new Set,a=t.filter(e=>{let t=e.id;return i.has(t)?!1:(i.add(t),!0)});if(a.length===0)return o(`No flow runs found.`);let d=a.map((e,t)=>({run:e,index:t,recency:u(e)})).sort((e,t)=>e.recency==null&&t.recency==null?e.index-t.index:e.recency==null?1:t.recency==null?-1:t.recency===e.recency?e.index-t.index:t.recency-e.recency).map(({run:e})=>e).slice(0,l);return o(JSON.stringify({total:a.length,returned:d.length,truncated:a.length>d.length,runs:d},null,2))}catch(e){return i.error(`flow action runs failed`,M(e)),o(`Error: ${a(e)}`)}}function Td(e){let t=e.content?.find(e=>e.type===`text`)?.text??``;if(!t)return null;try{let e=JSON.parse(t);if(typeof e.slug==`string`&&e.slug.length>0)return e.slug}catch{}return t.match(/[Ss]lug[:\s]*`?([^`\s,]+)`?/)?.[1]??null}function Ed(e,t,n,r){let i=n&&typeof n!=`function`?n:void 0,a=typeof n==`function`?n:r,o=Yu(e,t,i),s=W(`flow`);e.registerTool(`flow`,{title:s.title,description:`Manage development flows — list available flows, start/stop runs, navigate steps, read instructions, and install/remove/update flows. Use action parameter to select operation.`,annotations:s.annotations,inputSchema:{action:R.enum([`list`,`info`,`start`,`step`,`status`,`reset`,`read`,`runs`,`add`,`remove`,`update`,`backtrack`,`claim`]).describe(`The flow operation to perform.`),name:R.string().optional().describe(`Flow name — required for info, start, remove, update. Optional override for add.`),topic:R.string().optional().describe(`Human-readable topic for the run (used by start).`),objective:R.string().optional().describe(`L1 snapshot objective — the goal of this flow run. Falls back to topic when absent.`),acceptanceCriteria:R.array(R.string()).optional().describe(`L1 snapshot acceptance criteria (used by start).`),scope:R.array(R.string()).optional().describe(`L1 snapshot scope boundaries (used by start). Falls back to roots when absent.`),exclusions:R.array(R.string()).optional().describe(`L1 snapshot exclusions — what is out of scope (used by start).`),roots:R.array(R.string()).optional().describe(`Workspace roots participating in this flow (used by start).`),advance:R.enum([`next`,`skip`,`redo`,`backtrack`]).optional().describe(`Step navigation action — required for step.`),lifecycleOwnerToken:R.string().optional().describe(`Owner capability token for layered lifecycle mutations (required in layered mode for step/backtrack/claim/reset).`),currentToken:R.string().optional().describe(`Current step execution token from status response for optimistic concurrency.`),targetStep:R.string().optional().describe(`Target step ID for backtrack action — must be a completed prior step.`),step:R.string().optional().describe(`Step id or name to read (used by read). Defaults to current step.`),source:R.string().optional().describe(`Git URL, local path, or "openspec" shorthand — required for add.`),token:R.string().optional().describe(`Auth token for private repos (used by add).`),filter_flow:R.string().optional().describe(`Filter runs by flow name (used by runs).`),filter_status:R.string().optional().describe(`Filter runs by status: active, completed, abandoned (used by runs).`),limit:R.number().int().positive().optional().describe(`Max runs to return (default 50).`)}},J(`flow`,async e=>{switch(e.action){case`list`:return Sd(o);case`info`:return e.name?Cd({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);case`start`:{if(!e.name)return o.toTextResponse(`Missing required parameter: name (flow to start)`);let t=await gd({flow:e.name,topic:e.topic,roots:e.roots,objective:e.objective,acceptanceCriteria:e.acceptanceCriteria,scope:e.scope,exclusions:e.exclusions},o),n=Td(t);return n&&a&&a(n),t}case`step`:return e.advance?xd({action:e.advance,targetStep:e.targetStep,lifecycleOwnerToken:e.lifecycleOwnerToken,currentToken:e.currentToken},o):o.toTextResponse(`Missing required parameter: advance (next/skip/redo/backtrack)`);case`status`:{let e=await yd(o);return a&&a(Td(e)),e}case`reset`:{let e=await bd(o);return a&&a(null),e}case`read`:return $u({step:e.step},o);case`runs`:return wd({flow:e.filter_flow,status:e.filter_status,limit:e.limit},o);case`add`:return e.source?rd({source:e.source,name:e.name,token:e.token},o):o.toTextResponse(`Missing required parameter: source`);case`remove`:return e.name?id({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);case`update`:return e.name?ad({name:e.name},o):o.toTextResponse(`Missing required parameter: name`);case`backtrack`:return e.targetStep?_d({targetStep:e.targetStep,lifecycleOwnerToken:e.lifecycleOwnerToken,currentToken:e.currentToken},o):o.toTextResponse(`Missing required parameter: targetStep for backtrack action`);case`claim`:return vd({currentToken:e.currentToken},o);default:return o.toTextResponse(`Unknown action: ${e.action}`)}}))}const Dd=j(`tools`);function Od(e){let t=W(`evidence_map`);e.registerTool(`evidence_map`,{title:t.title,description:`Track verified/assumed/unresolved claims for complex tasks. Gate readiness: YIELD (proceed), HOLD (unknowns), HARD_BLOCK (critical gaps). Persists across calls.`,inputSchema:{action:R.enum([`create`,`add`,`update`,`get`,`gate`,`list`,`delete`]).describe(`Operation to perform`),task_id:R.string().optional().describe(`Task identifier (required for all except list)`),tier:R.enum([`floor`,`standard`,`critical`]).optional().describe(`FORGE tier (required for create)`),claim:R.string().optional().describe(`Critical-path claim text (for add)`),status:R.enum([`V`,`A`,`U`]).optional().describe(`Evidence status: V=Verified, A=Assumed, U=Unresolved`),receipt:R.string().optional().describe(`Evidence receipt: tool→ref for V, reasoning for A, attempts for U`),id:R.number().optional().describe(`Entry ID (for update)`),critical_path:R.boolean().default(!0).describe(`Whether this claim is on the critical path`),unknown_type:R.enum([`contract`,`convention`,`freshness`,`runtime`,`data-flow`,`impact`]).optional().describe(`Typed unknown classification`),safety_gate:R.enum([`provenance`,`commitment`,`coverage`]).optional().describe(`Safety gate tag: provenance (claim→evidence), commitment (user-approved), coverage (nothing dropped)`),retry_count:R.number().default(0).describe(`Retry count for gate evaluation (0 = first attempt)`),max_retries:R.number().int().min(0).optional().describe(`Maximum retries before escalating. Default: 3`),timeout_action:R.enum([`iterate`,`retry`,`manual`,`terminate`]).optional().describe(`Action to take when gate retries are exhausted. Default: manual`),cwd:R.string().optional().describe(`Working directory for evidence map storage (default: server cwd). Use root_path from forge_ground to match.`)},annotations:t.annotations},J(`evidence_map`,async({action:e,task_id:t,tier:n,claim:r,status:i,receipt:a,id:o,critical_path:s,unknown_type:c,safety_gate:l,retry_count:u,max_retries:d,timeout_action:f,cwd:p})=>{try{switch(e){case`create`:if(!t)throw Error(`task_id required for create`);if(!n)throw Error(`tier required for create`);return Dt({action:`create`,taskId:t,tier:n},p),{content:[{type:`text`,text:`Created evidence map "${t}" (tier: ${n}).\n\n---\n_Next: Use \`evidence_map\` with action "add" to record critical-path claims._`}]};case`add`:{if(!t)throw Error(`task_id required for add`);if(!r)throw Error(`claim required for add`);if(!i)throw Error(`status required for add`);let e=Dt({action:`add`,taskId:t,claim:r,status:i,receipt:a??``,criticalPath:s,unknownType:c,safetyGate:l},p),n=e.autoCreated?[`⚠️ Evidence map "${t}" was auto-created with tier "standard". Use \`create\` action to set a specific tier.`,``,`Added entry #${e.entry?.id} to "${t}": [${i}] ${r}`]:[`Added entry #${e.entry?.id} to "${t}": [${i}] ${r}`];return e.summary&&n.push(``,e.summary),{content:[{type:`text`,text:n.join(`
|
|
197
197
|
`)}]}}case`update`:{if(!t)throw Error(`task_id required for update`);if(o===void 0)throw Error(`id required for update`);if(!i)throw Error(`status required for update`);let e=Dt({action:`update`,taskId:t,id:o,status:i,receipt:a??``},p),n=[`Updated entry #${o} in "${t}" → ${i}`];return e.summary&&n.push(``,e.summary),{content:[{type:`text`,text:n.join(`
|
|
198
198
|
`)}]}}case`get`:{if(!t)throw Error(`task_id required for get`);let e=Dt({action:`get`,taskId:t},p);return e.state?{content:[{type:`text`,text:[`## Evidence Map: ${t} (${e.state.tier})`,``,e.formattedMap??`No entries.`,``,`_${e.state.entries.length} entries — created ${e.state.createdAt}_`].join(`
|
|
199
199
|
`)}]}:{content:[{type:`text`,text:`Evidence map "${t}" not found.`}]}}case`gate`:{if(!t)throw Error(`task_id required for gate`);let e=Dt({action:`gate`,taskId:t,retryCount:u,maxRetries:d,timeoutAction:f},p);if(!e.gate)return{content:[{type:`text`,text:`Evidence map "${t}" not found.`}]};let n=e.gate,r=[`## FORGE Gate: **${n.verdict}**`,``,`**Reason:** ${n.reason}`,``,`**Stats:** ${n.stats.verified}V / ${n.stats.assumed}A / ${n.stats.unresolved}U (${n.stats.total} total)`];return n.action&&r.push(``,`**Recommended action:** ${n.action}`),n.retriesRemaining!==void 0&&r.push(`**Retries remaining:** ${n.retriesRemaining}`),n.summary&&r.push(``,`**Summary:** ${n.summary}`),n.warnings.length>0&&r.push(``,`**Warnings:**`,...n.warnings.map(e=>`- ⚠️ ${e}`)),n.unresolvedCritical.length>0&&r.push(``,`**Blocking entries:**`,...n.unresolvedCritical.map(e=>`- #${e.id}: ${e.claim} [${e.unknownType??`untyped`}]`)),n.safetyGates&&(r.push(``,`**Safety Gates:**`,`- Provenance: ${n.safetyGates.provenance}`,`- Commitment: ${n.safetyGates.commitment}`,`- Coverage: ${n.safetyGates.coverage}`),n.safetyGates.failures.length>0&&r.push(``,`**Safety failures:**`,...n.safetyGates.failures.map(e=>`- \u{1F6D1} ${e}`))),n.annotation&&r.push(``,`**Annotation:**`,n.annotation),e.formattedMap&&r.push(``,`---`,``,e.formattedMap),r.push(``,`---`,`_Next: ${n.verdict===`YIELD`?`Proceed to implementation.`:n.action===`iterate`?`Re-run the build loop, then evaluate the gate again.`:n.action===`retry`?`Re-evaluate the gate after refreshing evidence.`:n.action===`manual`?`Ask for human review before proceeding.`:`Abort the current path and terminate the task.`}_`),{content:[{type:`text`,text:r.join(`
|
|
200
200
|
`)}]}}case`list`:{let e=Dt({action:`list`},p);return!e.states||e.states.length===0?{content:[{type:`text`,text:`No evidence maps found.`}]}:{content:[{type:`text`,text:e.states.map(e=>`- **${e.taskId}** (${e.tier}) — ${e.entries.length} entries — ${e.updatedAt}`).join(`
|
|
201
|
-
`)}]}}case`delete`:if(!t)throw Error(`task_id required for delete`);return{content:[{type:`text`,text:Dt({action:`delete`,taskId:t},p).deleted?`Deleted evidence map "${t}".`:`Evidence map "${t}" not found.`}]}}}catch(e){return
|
|
202
|
-
`);return{content:[{type:`text`,text:u}],structuredContent:{text:u,ref:s.ref,fields:s.fields,sourceStats:s.sourceStats,totalOriginalChars:s.totalOriginalChars,totalCompressedChars:s.totalCompressedChars,ratio:s.ratio}}}catch(e){return
|
|
203
|
-
`);if(i&&t){let e=await G(t,{query:`forge classify ${n}`});c+=K(e)}return{content:[{type:`text`,text:c}]}}catch(e){return
|
|
204
|
-
`)}]}}catch(e){return
|
|
201
|
+
`)}]}}case`delete`:if(!t)throw Error(`task_id required for delete`);return{content:[{type:`text`,text:Dt({action:`delete`,taskId:t},p).deleted?`Deleted evidence map "${t}".`:`Evidence map "${t}" not found.`}]}}}catch(e){return Dd.error(`Evidence map error`,M(e)),q(`INTERNAL`,`Evidence map error: ${e instanceof Error?e.message:String(e)}`)}}))}function kd(e,t){let n=W(`digest`);e.registerTool(`digest`,{title:n.title,description:`Compress multiple text sources (handoffs, debates, phase summaries) into a token-budgeted digest. Jointly ranks across all sources, pins structured fields (status, files, decisions, blockers), and allocates budget by priority weight.`,outputSchema:Ac,inputSchema:{sources:R.array(R.object({id:R.string().describe(`Source identifier (e.g., "phase-2-handoff")`),text:R.string().max(5e5).describe(`Source text to compress`),weight:R.number().min(0).default(1).describe(`Priority weight (higher = more budget)`)})).min(1).max(20).describe(`Text sources to compress`),query:R.string().describe(`Focus query — what matters for the next step?`),max_chars:R.number().min(100).max(5e4).default(4e3).describe(`Target budget in characters`),pin_fields:R.array(R.string()).optional().describe(`Key fields to always extract (default: status, files, decisions, blockers, next)`),segmentation:R.enum([`paragraph`,`sentence`,`line`]).default(`paragraph`).describe(`How to split text for scoring`),token_budget:R.number().min(50).max(12500).optional().describe(`Token budget — overrides max_chars (approx 4 chars per token). Use to fit output into a specific context window.`)},annotations:n.annotations},async({sources:e,query:n,max_chars:r,pin_fields:i,segmentation:a,token_budget:o})=>{try{let s=await Ct(t,{sources:e,query:n,maxChars:o?o*4:r,pinFields:i,segmentation:a}),c=[`## Digest (${s.totalOriginalChars} → ${s.totalCompressedChars} chars, ${(s.ratio*100).toFixed(0)}%)`,s.ref?`Ref: ${s.ref}`:void 0,``],l=Object.keys(s.fields);if(l.length>0){c.push(`### Extracted Fields`);for(let e of l){let t=s.fields[e];c.push(`**${e}:**`);for(let e of t)c.push(` - [${e.sourceId}] ${e.value}`)}c.push(``)}c.push(`### Compressed Content`,``,s.text),c.push(``,`### Source Stats`);for(let e of s.sourceStats)c.push(`- **${e.id}**: ${e.originalChars} → ${e.keptChars} chars (${e.segmentsKept}/${e.segmentsTotal} segments)`);c.push(``,`---`,"_Next: Use the digest as compressed context for the next phase. Use `stash` to persist it if needed._");let u=c.filter(e=>typeof e==`string`).join(`
|
|
202
|
+
`);return{content:[{type:`text`,text:u}],structuredContent:{text:u,ref:s.ref,fields:s.fields,sourceStats:s.sourceStats,totalOriginalChars:s.totalOriginalChars,totalCompressedChars:s.totalCompressedChars,ratio:s.ratio}}}catch(e){return Dd.error(`Digest failed`,M(e)),{...q(`INTERNAL`,`Digest failed: ${e instanceof Error?e.message:String(e)}`),structuredContent:{text:``,ref:void 0,fields:{},sourceStats:[],totalOriginalChars:0,totalCompressedChars:0,ratio:0}}}})}function Ad(e,t){let n=W(`forge_classify`);e.registerTool(`forge_classify`,{title:n.title,description:`Classify FORGE tier (Floor/Standard/Critical) from target files and task description. Checks blast radius, cross-package boundaries, schema/contract patterns, and security signals. Returns tier, triggers, typed unknown seeds, and ceremony guidance.`,inputSchema:{files:R.array(R.string()).min(1).max(100).describe(`Files being modified (paths)`),task:R.string().describe(`Task description`),root_path:R.string().describe(`Root path of the codebase`),enrich:R.boolean().default(!1).optional().describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens.`)},annotations:n.annotations},J(`forge_classify`,async({files:e,task:n,root_path:r,enrich:i})=>{try{let a=await Mt({files:e,task:n,rootPath:r}),o=[`## FORGE Classification: **${a.tier.toUpperCase()}**`,``];if(a.triggers.length>0){o.push(`### Triggers`);for(let e of a.triggers)o.push(`- **${e.rule}** (${e.source}): ${e.detail}`);o.push(``)}if(a.packagesCrossed.length>0&&o.push(`**Packages crossed:** ${a.packagesCrossed.join(`, `)}`),a.typedUnknownSeeds.length>0){o.push(``,`### Typed Unknown Seeds`);for(let e of a.typedUnknownSeeds)o.push(`- [${e.type}] ${e.description} → use \`${e.suggestedTool}\``)}o.push(``,`### Ceremony`);let s=a.ceremony;o.push(`- **Ground:** ${s.ground}`,`- **Build:** ${s.build}`,`- **Break:** ${s.break}`,`- **Evidence Map:** ${s.evidenceMap}`,`- **Gate:** ${s.gate}`),o.push(``,`---`,`_Next: ${a.tier===`floor`?`Proceed directly to implementation.`:"Run `forge_ground` to execute the full Ground phase."}_`);let c=o.join(`
|
|
203
|
+
`);if(i&&t){let e=await G(t,{query:`forge classify ${n}`});c+=K(e)}return{content:[{type:`text`,text:c}]}}catch(e){return Dd.error(`FORGE classify failed`,M(e)),q(`INTERNAL`,`FORGE classify failed: ${e instanceof Error?e.message:String(e)}`)}}))}function jd(e,t,n){let r=W(`forge_ground`);e.registerTool(`forge_ground`,{title:r.title,description:`Execute the complete FORGE Ground phase in a single call. Chains: tier classification → scope map → typed unknown seeds → constraint loading → file summaries → evidence map creation. Replaces 5-15 manual tool calls.`,inputSchema:{task:R.string().describe(`Task description`),files:R.array(R.string()).min(1).max(100).describe(`Target files being modified (absolute paths)`),root_path:R.string().describe(`Root path of the codebase`),max_constraints:R.number().min(0).max(10).default(3).describe(`Max constraint entries to load from AI Kit memory`),force_tier:R.enum([`floor`,`standard`,`critical`]).optional().describe(`Force a specific tier (skips auto-classification)`),task_id:R.string().optional().describe(`Custom task ID for evidence map (auto-generated if omitted)`)},annotations:r.annotations},J(`forge_ground`,async({task:e,files:r,root_path:i,max_constraints:a,force_tier:o,task_id:s},c)=>{try{let l=await Nt(t,n,{task:e,files:r,rootPath:i,maxConstraints:a,forceTier:o,taskId:s}),u=gl(c).createTask(`FORGE Ground`,3);u.progress(0,`Classification: ${l.tier}`),u.progress(1,`Files analyzed: ${l.fileSummaries.length}`),u.progress(2,`Unknowns: ${l.typedUnknownSeeds.length}`),u.complete(`FORGE Ground complete: tier=${l.tier}`);let d=[`## FORGE Ground: **${l.tier.toUpperCase()}**`,`Estimated output: ~${l.estimatedTokens} tokens`,``];if(l.classifyTriggers.length>0){d.push(`### Classification Triggers`);for(let e of l.classifyTriggers)d.push(`- **${e.rule}** (${e.source}): ${e.detail}`);d.push(``)}if(l.fileSummaries.length>0){d.push(`### Target Files`);for(let e of l.fileSummaries)d.push(`- **${e.path}** (${e.lines} lines) — exports: ${e.exports.join(`, `)||`none`} — functions: ${e.functions.join(`, `)||`none`}`);d.push(``)}if(l.typedUnknownSeeds.length>0){d.push(`### Typed Unknown Seeds`);for(let e of l.typedUnknownSeeds)d.push(`- [${e.type}] ${e.description} → \`${e.suggestedTool}\``);d.push(``)}if(l.constraints.length>0){d.push(`### Constraint Seed`);for(let e of l.constraints)d.push(`- **${e.source}** (${(e.relevance*100).toFixed(0)}%): ${e.snippet}`);d.push(``)}if(l.scopeMap){d.push(`### Scope Map: ${l.scopeMap.files.length} files (~${l.scopeMap.totalEstimatedTokens} tokens)`);for(let e of l.scopeMap.files.slice(0,5))d.push(`- ${e.path} (${(e.relevance*100).toFixed(0)}%) — ${e.reason}`);l.scopeMap.files.length>5&&d.push(`- _...and ${l.scopeMap.files.length-5} more_`),d.push(``)}l.evidenceMapTaskId&&(d.push(`**Evidence Map:** \`${l.evidenceMapTaskId}\` (initialized)`),d.push(``)),d.push(`### Ceremony Guidance`);let f=l.ceremony;return d.push(`- **Ground:** ${f.ground}`,`- **Build:** ${f.build}`,`- **Break:** ${f.break}`,`- **Evidence Map:** ${f.evidenceMap}`,`- **Gate:** ${f.gate}`),d.push(``,`---`,`_Next: ${l.tier===`floor`?`Proceed to Build phase.`:"Use `evidence_map` to track claims during Build, then `evidence_map` gate after Break."}_`),{content:[{type:`text`,text:d.join(`
|
|
204
|
+
`)}]}}catch(e){return Dd.error(`FORGE Ground failed`,M(e)),q(`INTERNAL`,`FORGE Ground failed: ${e instanceof Error?e.message:String(e)}`)}}))}const Md=j(`tools`),Nd=R.object({id:R.string().optional().describe(`Node ID (auto-generated if omitted)`),type:R.string().describe(`Node type (entity, service, api, concept, decision)`),name:R.string().describe(`Display name`),properties:R.record(R.string(),R.unknown()).optional().describe(`Arbitrary properties`),sourceRecordId:R.string().optional().describe(`Back-link to knowledge record ID`),sourcePath:R.string().optional().describe(`Source file path`)}),Pd=R.object({id:R.string().optional().describe(`Edge ID (auto-generated if omitted)`),fromId:R.string().describe(`Source node ID`),toId:R.string().describe(`Target node ID`),type:R.string().describe(`Relationship type (depends-on, implements, calls, affects)`),weight:R.number().min(0).max(1).optional().describe(`Relationship weight`),properties:R.record(R.string(),R.unknown()).optional().describe(`Arbitrary properties`)});function Fd(e,t,n){let r=W(`graph`);e.registerTool(`graph`,{title:r.title,description:`Query the auto-populated code knowledge graph (modules, symbols, imports) to answer
|
|
205
205
|
structural questions vector search cannot.
|
|
206
206
|
|
|
207
207
|
Common flow (when you don't have a node_id yet — TWO STEPS):
|
|
@@ -220,7 +220,7 @@ Single-step read actions:
|
|
|
220
220
|
Mutating actions (use deliberately): add, delete, clear, set_community,
|
|
221
221
|
detect_communities, trace_process, delete_process.
|
|
222
222
|
|
|
223
|
-
Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_radius\` (change impact).`,outputSchema:
|
|
223
|
+
Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_radius\` (change impact).`,outputSchema:Tc,inputSchema:{action:R.enum([`find_nodes`,`find_edges`,`neighbors`,`traverse`,`stats`,`validate`,`add`,`delete`,`clear`,`detect_communities`,`set_community`,`trace_process`,`list_processes`,`delete_process`,`depth_traverse`,`cohesion`,`symbol360`]).describe(`Action: find_nodes (search nodes), find_edges (search edges), neighbors (direct connections), traverse (multi-hop), stats (graph overview), validate (check graph integrity), add (insert nodes/edges), delete (remove nodes), clear (remove all), detect_communities (find clusters), set_community (label a node), trace_process (persist execution flow), list_processes (list traced flows), delete_process (remove a flow), depth_traverse (bucket traversal by depth), cohesion (score a community), symbol360 (full node context)`),node_type:R.string().optional().describe(`Node type filter (for find_nodes)`),name_pattern:R.string().optional().describe(`Name substring match (for find_nodes)`),source_path:R.string().optional().describe(`Source path filter`),node_id:R.string().optional().describe(`Node ID (for neighbors, traverse, delete)`),edge_type:R.string().optional().describe(`Edge type filter`),from_id:R.string().optional().describe(`Source node ID (for find_edges)`),to_id:R.string().optional().describe(`Target node ID (for find_edges)`),direction:R.enum([`outgoing`,`incoming`,`both`]).default(`both`).describe(`Traversal direction`),max_depth:R.number().min(1).max(5).default(2).describe(`Max traversal depth`),limit:R.number().min(1).max(100).default(50).describe(`Max results`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),nodes:R.array(Nd).max(500).optional().describe(`Nodes to add (for action=add)`),edges:R.array(Pd).max(500).optional().describe(`Edges to add (for action=add)`),community:R.string().optional().describe(`Community label (for set_community, cohesion)`),process_id:R.string().optional().describe(`Process ID (for delete_process)`),label:R.string().optional().describe(`Label for process tracing (for trace_process)`),enrich:R.boolean().default(!1).optional().describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens.`)},annotations:r.annotations},J(`graph`,async e=>{try{let r=await Rt(t,{action:e.action,nodeType:e.node_type,namePattern:e.name_pattern,sourcePath:e.source_path,nodeId:e.node_id,edgeType:e.edge_type,fromId:e.from_id,toId:e.to_id,direction:e.direction,maxDepth:e.max_depth,limit:e.limit,nodes:e.nodes,edges:e.edges,community:e.community,processId:e.process_id,label:e.label}),i=[r.summary],a=it(r.nodes??[]);if(r.nodes&&r.nodes.length>0){i.push(`
|
|
224
224
|
### Nodes`);for(let e of r.nodes){let t=Object.keys(e.properties).length>0?` — ${JSON.stringify(e.properties)}`:``;i.push(`- **${e.name}** (${e.type}, id: \`${e.id}\`)${t}`)}}if(r.edges&&r.edges.length>0){i.push(`
|
|
225
225
|
### Edges`);for(let e of r.edges){let t=wn(e.fromId,a),n=wn(e.toId,a);i.push(`- \`${t}\` —[${e.type}]→ \`${n}\`${e.weight===1?``:` (weight: ${e.weight})`}`)}}if(r.stats&&(i.push(`\nNode types: ${JSON.stringify(r.stats.nodeTypes)}`),i.push(`Edge types: ${JSON.stringify(r.stats.edgeTypes)}`)),r.validation){if(i.push(`
|
|
226
226
|
### Validation`),i.push(`- **Valid**: ${r.validation.valid?`yes`:`no`}`),r.validation.danglingEdges.length>0){i.push(`- **Dangling edges**:`);for(let e of r.validation.danglingEdges)i.push(` - \`${e.edgeId}\` references missing node \`${e.missingNodeId}\``)}r.validation.orphanNodes.length>0&&i.push(`- **Orphan nodes**: ${r.validation.orphanNodes.map(e=>`\`${e}\``).join(`, `)}`)}if(r.communities){i.push(`
|
|
@@ -229,79 +229,76 @@ Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_rad
|
|
|
229
229
|
### Processes`);for(let e of r.processes)i.push(`- **${e.label}** (id: \`${e.id}\`) — ${e.steps.length} step(s)`)}if(r.depthGroups){i.push(`
|
|
230
230
|
### Depth Groups`);for(let[e,t]of Object.entries(r.depthGroups))i.push(`- **Depth ${e}**: ${t.map(e=>`${e.name} (${e.type})`).join(`, `)}`)}if(r.cohesionScore!==void 0&&i.push(`\n**Cohesion Score**: ${(r.cohesionScore*100).toFixed(1)}%`),r.symbol360){let e=r.symbol360;i.push(`
|
|
231
231
|
### 360° Symbol View`),i.push(`- **Node**: ${e.node.name} (${e.node.type})`),i.push(`- **Community**: ${e.community??`none`}`),i.push(`- **Incoming**: ${e.incoming.length} edge(s)`),i.push(`- **Outgoing**: ${e.outgoing.length} edge(s)`),i.push(`- **Processes**: ${e.processes.length}`)}i.push("\n---\n_Next: Use `graph(traverse)` to explore connections, `graph(add)` to insert entities, `graph(symbol360)` for full node context, or `graph(detect_communities)` to find clusters._");let o=i.join(`
|
|
232
|
-
`);if(e.enrich&&n){let t=await G(n,{query:`graph ${e.action} ${e.name_pattern??e.node_id??e.community??``}`.trim(),filePath:e.source_path});o+=K(t)}return{content:[{type:`text`,text:e.max_tokens?L(o,e.max_tokens):o}],structuredContent:{nodes:(r.nodes??[]).map(e=>({id:e.id,name:e.name,type:e.type,...e.sourcePath?{sourcePath:e.sourcePath}:{}})),edges:(r.edges??[]).map(e=>({fromId:e.fromId,toId:e.toId,fromName:wn(e.fromId,a),toName:wn(e.toId,a),type:e.type})),communities:(r.communities??[]).map(e=>({id:e.id,nodeCount:e.nodeCount,types:e.types,samples:e.samples.slice(0,3)})),totalNodes:r.stats?.nodeCount??r.nodes?.length??0,totalEdges:r.stats?.edgeCount??r.edges?.length??0,query:e.action}}}catch(e){return
|
|
233
|
-
`)};if(l.length===1)try{return{content:[{type:`text`,text:await u(l[0])+"\n\n---\n_Next: Use `remember` to save key findings, or `web_fetch` with a `selector` to extract a specific section._"}]}}catch(e){let t=e instanceof Error?e.message:String(e);return/HTTP [45]\d{2}/.test(t)?
|
|
234
|
-
|
|
235
|
-
`);return m===f.length?q(`INTERNAL`,g):{content:[{type:`text`,text:g}]}}))}function
|
|
236
|
-
`)}]}}catch(e){return
|
|
237
|
-
`)}`}async function
|
|
238
|
-
`)}function
|
|
239
|
-
`)}function
|
|
240
|
-
`)}async function
|
|
232
|
+
`);if(e.enrich&&n){let t=await G(n,{query:`graph ${e.action} ${e.name_pattern??e.node_id??e.community??``}`.trim(),filePath:e.source_path});o+=K(t)}return{content:[{type:`text`,text:e.max_tokens?L(o,e.max_tokens):o}],structuredContent:{nodes:(r.nodes??[]).map(e=>({id:e.id,name:e.name,type:e.type,...e.sourcePath?{sourcePath:e.sourcePath}:{}})),edges:(r.edges??[]).map(e=>({fromId:e.fromId,toId:e.toId,fromName:wn(e.fromId,a),toName:wn(e.toId,a),type:e.type})),communities:(r.communities??[]).map(e=>({id:e.id,nodeCount:e.nodeCount,types:e.types,samples:e.samples.slice(0,3)})),totalNodes:r.stats?.nodeCount??r.nodes?.length??0,totalEdges:r.stats?.edgeCount??r.edges?.length??0,query:e.action}}}catch(e){return Md.error(`Graph query failed`,M(e)),q(`INTERNAL`,`Graph query failed: ${e instanceof Error?e.message:String(e)}`)}}))}const Id=j(`tools:infra`);function Ld(e){let t=W(`process`);e.registerTool(`process`,{title:t.title,description:`Start, stop, inspect, list, and tail logs for in-memory managed child processes.`,inputSchema:{action:R.enum([`start`,`stop`,`status`,`list`,`logs`]).describe(`Process action to perform`),id:R.string().optional().describe(`Managed process ID`),command:R.string().optional().describe(`Executable to start`),args:R.array(R.string()).optional().describe(`Arguments for start actions`),tail:R.number().min(1).max(500).optional().describe(`Log lines to return for logs actions`)},annotations:t.annotations},J(`process`,async({action:e,id:t,command:n,args:r,tail:i})=>{try{switch(e){case`start`:if(!t||!n)throw Error(`id and command are required for start`);return{content:[{type:`text`,text:JSON.stringify(nn(t,n,r??[]))}]};case`stop`:if(!t)throw Error(`id is required for stop`);return{content:[{type:`text`,text:JSON.stringify(an(t)??null)}]};case`status`:if(!t)throw Error(`id is required for status`);return{content:[{type:`text`,text:JSON.stringify(rn(t)??null)}]};case`list`:return{content:[{type:`text`,text:JSON.stringify(en())}]};case`logs`:if(!t)throw Error(`id is required for logs`);return{content:[{type:`text`,text:JSON.stringify(tn(t,i))}]}}}catch(e){return Id.error(`Process action failed`,M(e)),q(`INTERNAL`,`Process action failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Rd(e){let t=W(`watch`);e.registerTool(`watch`,{title:t.title,description:`Watch a directory for file changes (create/modify/delete). Actions: start (begin watching, optionally with autoSync for pending file tracking), stop (by ID), list (show active watchers with pending files). Auto-sync tracks changed files for re-onboarding with debounced batching.`,inputSchema:{action:R.enum([`start`,`stop`,`list`]).describe(`Watch action to perform`),path:R.string().optional().describe(`Directory path to watch for start actions`),id:R.string().optional().describe(`Watcher ID for stop actions`),autoSync:R.boolean().default(!1).optional().describe(`Auto-sync mode: track changed files pending re-onboard (default: false)`),debounceMs:R.number().min(500).max(3e4).default(2e3).optional().describe(`Debounce interval in ms for auto-sync (default: 2000)`)},annotations:t.annotations},J(`watch`,async({action:e,path:t,id:n,autoSync:r,debounceMs:i})=>{try{switch(e){case`start`:{if(!t)throw Error(`path is required for start`);let e=Gn({path:t,autoSync:r??!1,debounceMs:i});return{content:[{type:`text`,text:JSON.stringify({id:e.id,status:e.status,pendingFiles:e.pendingFiles})}]}}case`stop`:if(!n)throw Error(`id is required for stop`);return{content:[{type:`text`,text:JSON.stringify({stopped:Kn(n)})}]};case`list`:{let e=Wn();return{content:[{type:`text`,text:JSON.stringify(e,null,2)}]}}}}catch(e){return Id.error(`Watch action failed`,M(e)),q(`INTERNAL`,`Watch action failed: ${e instanceof Error?e.message:String(e)}`)}}))}function zd(e){let t=W(`health`);e.registerTool(`health`,{title:t.title,description:`Run project health checks — verifies package.json, tsconfig, scripts, lockfile, README, LICENSE, .gitignore.`,outputSchema:nc,inputSchema:{path:R.string().optional().describe(`Root directory to check (defaults to cwd)`)},annotations:t.annotations},J(`health`,async({path:e})=>{try{let t=Bt(e),n={ok:t.checks.every(e=>e.status!==`fail`),checks:t.checks.map(e=>({name:e.name,ok:e.status===`pass`,message:e.message}))};return{content:[{type:`text`,text:JSON.stringify(t)}],structuredContent:n}}catch(e){return Id.error(`Health check failed`,M(e)),q(`INTERNAL`,`Health check failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Bd(e){let t=W(`web_fetch`);e.registerTool(`web_fetch`,{title:t.title,description:`PREFERRED web fetcher — fetch one or many URLs and convert to LLM-optimized markdown. Pass one URL or multiple for parallel fetching. Supports CSS selectors, 4 output modes (markdown/raw/links/outline), smart paragraph-boundary truncation. Strips scripts/styles/nav automatically.`,inputSchema:{urls:R.array(R.string().url()).min(1).max(10).describe('URLs to fetch (1–10). Single URL: `["https://..."]`. Multiple fetched in parallel.'),mode:R.enum([`markdown`,`raw`,`links`,`outline`]).default(`markdown`).describe(`Output mode: markdown (clean content), raw (HTML), links (extracted URLs), outline (heading hierarchy)`),selector:R.string().optional().describe(`CSS selector to extract a specific element instead of auto-detecting main content`),max_length:R.number().min(500).max(1e5).default(15e3).describe(`Max characters in output — truncates at paragraph boundaries`),include_metadata:R.boolean().default(!0).describe(`Include page title, description, and URL as a header`),include_links:R.boolean().default(!1).describe(`Append extracted links list at the end`),include_images:R.boolean().default(!1).describe(`Include image alt texts inline`),timeout:R.number().min(1e3).max(12e4).default(3e4).describe(`Request timeout in milliseconds`),allow_localhost:R.boolean().default(!1).describe(`Allow requests to localhost/loopback addresses (127.0.0.1, localhost, ::1). Default false for SSRF protection. Set true for local dev servers.`)},annotations:t.annotations},J(`web_fetch`,async({urls:e,mode:t,selector:n,max_length:r,include_metadata:i,include_links:a,include_images:o,timeout:s,allow_localhost:c})=>{let l=e,u=async(e,l)=>{let u=await qn({url:e,mode:t,selector:n,maxLength:r,includeMetadata:i,includeLinks:a,includeImages:o,timeout:s,allowLocalhost:c}),d=[l?`## ${l} ${u.title||`Web Page`}\n> Source: ${e}`:`## ${u.title||`Web Page`}`,``,u.content];return u.truncated&&d.push(``,`_Original length: ${u.originalLength.toLocaleString()} chars_`),d.join(`
|
|
233
|
+
`)};if(l.length===1)try{return{content:[{type:`text`,text:await u(l[0])+"\n\n---\n_Next: Use `remember` to save key findings, or `web_fetch` with a `selector` to extract a specific section._"}]}}catch(e){let t=e instanceof Error?e.message:String(e);return/HTTP [45]\d{2}/.test(t)?Id.warn(`Web fetch failed`,{error:t}):Id.error(`Web fetch failed`,M(e)),{...q(`INTERNAL`,`Web fetch failed: ${t}`)}}let d=l.length,f=await Promise.allSettled(l.map((e,t)=>u(e,`[${t+1}/${d}]`))),p=[],m=0;for(let e=0;e<f.length;e++){let t=f[e];if(t.status===`fulfilled`)p.push(t.value);else{m++;let n=t.reason instanceof Error?t.reason.message:String(t.reason);/HTTP [45]\d{2}/.test(n)?Id.warn(`Web fetch failed`,{url:l[e],error:n}):Id.error(`Web fetch failed`,{url:l[e],...M(t.reason)}),p.push(`## ❌ Failed: ${l[e]}\n\n${n}`)}}let h=`_Fetched ${f.length-m}/${f.length} URLs successfully._`;p.push(``,`---`,h,"_Next: Use `remember` to save key findings, or `web_fetch` with a `selector` to extract a specific section._");let g=p.join(`
|
|
234
|
+
|
|
235
|
+
`);return m===f.length?q(`INTERNAL`,g):{content:[{type:`text`,text:g}]}}))}function Vd(e,t){let n=W(`guide`);e.registerTool(`guide`,{title:n.title,description:`Tool discovery — given a goal description, recommends which AI Kit tools to use and in what order. Matches against 10 predefined workflows: onboard, audit, bugfix, implement, refactor, search, context, memory, validate, analyze.`,inputSchema:{goal:R.string().describe(`What you want to accomplish (e.g., "audit this monorepo", "fix a failing test")`),max_recommendations:R.number().min(1).max(10).default(5).describe(`Maximum number of tool recommendations`)},annotations:n.annotations},J(`guide`,async({goal:e,max_recommendations:n})=>{try{let r=zt(e,n,t),i=[`## Recommended Workflow: **${r.workflow}**`,r.description,``,`### Tools`,...r.tools.map(e=>{let t=e,n=t.suggestedArgs?` — \`${JSON.stringify(t.suggestedArgs)}\``:``,r=t.tokenTip?`\n 💡 ${t.tokenTip}`:``;return`${t.order}. **${t.tool}** — ${t.reason}${n}${r}`})];return r.alternativeWorkflows.length>0&&i.push(``,`_Alternative workflows: ${r.alternativeWorkflows.join(`, `)}_`),i.push(``,`---`,"_Next: Run the first recommended tool, or use `guide` again with a more specific goal._"),{content:[{type:`text`,text:i.join(`
|
|
236
|
+
`)}]}}catch(e){return Id.error(`Guide failed`,M(e)),q(`INTERNAL`,`Guide failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Hd(e,t,n){if(!(!e||typeof e!=`string`)&&!(e.includes(`..`)||e.startsWith(`/`)||e.startsWith(`[`)))return{type:`resource_link`,uri:`aikit://curated/${e}`,name:t??e,mimeType:`text/markdown`,...n?{description:n}:{}}}function Ud(e){let t=new Set,n=[];for(let r of e){let e=Hd(r.path,r.title,r.category?`[${r.category}]`:void 0);e&&!t.has(e.uri)&&(t.add(e.uri),n.push(e))}return n}function Wd(e){if(e.startsWith(`.ai/curated/`))return e.slice(12)}const Gd={decisions:`decision`,patterns:`pattern`,conventions:`pattern`,context:`analysis`,session:`step-summary`},Kd=new Set([`decision`,`pattern`,`file-card`,`analysis`,`search-result`,`step-summary`]),qd=R.enum([`remember`,`read`,`update`,`forget`,`list`,`history`,`diff`,`recover`,`orphaned`,`withdraw`,`flush`,`flagged`,`lesson`,`gap-analysis`]),Jd=R.enum([`create`,`confirm`,`contradict`,`list-lessons`,`auto-observe`,`prune`,`group`,`promote`,`demote`]),Yd=R.enum([`confidence`,`recent`]),Xd=R.string().min(3).max(120).describe(`Short descriptive title for the knowledge entry`),Zd=R.string().min(10).max(1e5),Qd=R.string().regex(/^[a-z][a-z0-9-]*$/).describe(`Category slug (e.g., "decisions", "patterns", "conventions", "api-contracts")`),$d=R.array(R.string()).default([]).describe(`Optional tags for filtering`),ef=R.string().describe(`Relative path within .ai/curated/ (e.g., "decisions/use-lancedb.md")`),tf=R.string().min(3),nf=R.number().int().min(0).max(100).describe(`Lesson confidence from 0-100`),rf=R.object({title:Xd,content:Zd.describe(`The markdown content to store`),category:Qd,tags:$d,force:R.boolean().optional().describe(`When true, supersede flagged similar entries without waiting for confirmation`)}),af=R.object({path:ef}),of=R.object({path:ef,content:Zd.describe(`New markdown content to replace existing content`),reason:tf.max(1e3).describe(`Why this update is being made (recorded in changelog)`)}),sf=R.object({path:R.string().describe(`Relative path within .ai/curated/ (e.g., "decisions/deprecated-approach.md")`),reason:tf.describe(`Why this entry is being removed`)}),cf=R.object({category:R.string().optional().describe(`Filter by category (e.g., "decisions", "patterns")`),tag:R.string().optional().describe(`Filter by tag`),limit:R.number().int().min(1).max(200).default(50).describe(`Maximum entries to return`),offset:R.number().int().min(0).default(0).describe(`Pagination offset`)}),lf=R.object({title:Xd,context:Zd.describe(`What happened (the situation)`),insight:Zd.describe(`What was learned (the lesson)`),evidence:Zd.describe(`Proof or justification`),confidence:nf.default(50),tags:$d.optional().default([])}),uf=R.object({path:ef.optional(),id:ef.optional(),reason:tf.max(1e3).optional()}).refine(e=>!!(e.path??e.id),{message:`path or id is required`,path:[`path`]}),df=R.object({topic:R.string().optional(),minConfidence:nf.optional(),tag:R.string().optional(),tags:R.array(R.string()).optional(),sortBy:Yd.default(`confidence`),includeArchived:R.boolean().default(!1),limit:R.number().int().min(1).max(200).default(50),offset:R.number().int().min(0).default(0)}),ff=R.object({bufferPath:R.string().optional()}),pf=R.object({maxConfidence:nf.optional(),minIdleDays:R.number().int().min(1).optional(),safetyDays:R.number().int().min(0).optional(),maxPrune:R.number().int().min(1).max(1e3).optional(),dryRun:R.boolean().default(!0)}),mf=R.object({similarityThreshold:R.number().min(0).max(1).optional(),minGroupSize:R.number().int().min(2).max(1e3).optional(),maxGroups:R.number().int().min(1).max(1e3).optional(),dryRun:R.boolean().default(!0)}),hf=R.object({minWorkspaces:R.number().int().min(2).max(1e3).optional(),minAvgConfidence:nf.optional(),similarityThreshold:R.number().min(0).max(1).optional(),dryRun:R.boolean().default(!0)}),gf=R.object({action:qd.describe(`Knowledge operation to perform`),title:Xd.optional(),content:Zd.optional(),category:Qd.optional(),tags:R.array(R.string()).optional().describe(`Optional tags for remember`),path:ef.optional(),reason:tf.max(1e3).optional(),scope:R.enum([`curated`,`flow`]).optional().describe(`Storage scope: curated (default) or flow-scoped ephemeral context`),profile:R.string().optional().describe(`Role profile for withdraw filtering (e.g., "implementer", "reviewer", "debugger")`),budget:R.number().int().min(100).max(5e4).optional().describe(`Maximum character budget for withdraw results (default: 6000)`),token_budget:R.number().int().min(50).max(12500).optional().describe(`Token budget (overrides budget). Approx 4 chars per token.`),tag:R.string().optional().describe(`Filter by tag when action="list"`),id:ef.optional().describe(`Alias for path when action="lesson"`),subAction:Jd.optional().describe(`Lesson sub-action when action="lesson"`),bufferPath:R.string().optional().describe(`Optional observation buffer path for lesson auto-observe`),context:Zd.optional().describe(`What happened (the situation) for lesson creation`),insight:Zd.optional().describe(`What was learned (the lesson) for lesson creation`),evidence:Zd.optional().describe(`Proof or justification for lesson creation`),confidence:nf.optional(),minConfidence:nf.optional().describe(`Minimum confidence when listing lessons`),topic:R.string().optional().describe(`Topic filter when listing lessons`),sortBy:Yd.optional().describe(`Sort lessons by confidence or recency`),includeArchived:R.boolean().optional().describe(`Include auto-archived lessons in list-lessons`),maxConfidence:nf.optional().describe(`Prune lessons below this effective confidence`),minIdleDays:R.number().int().min(1).optional().describe(`Minimum idle days required before pruning a lesson`),safetyDays:R.number().int().min(0).optional().describe(`Never prune if accessed within this many days`),maxPrune:R.number().int().min(1).max(1e3).optional().describe(`Maximum number of lessons to prune in one run`),similarityThreshold:R.number().min(0).max(1).optional().describe(`Minimum Jaccard similarity required to group lesson titles`),minGroupSize:R.number().int().min(2).max(1e3).optional().describe(`Minimum number of lessons required to form a group`),maxGroups:R.number().int().min(1).max(1e3).optional().describe(`Maximum number of lesson groups to create in one run`),minWorkspaces:R.number().int().min(2).max(1e3).optional().describe(`Minimum number of distinct workspaces required before promoting a lesson`),minAvgConfidence:nf.optional().describe(`Minimum average lesson confidence required before promoting a lesson`),dryRun:R.boolean().optional().describe(`Preview the operation without modifying stored lessons`),limit:R.number().int().min(1).max(200).optional().describe(`Maximum entries to return for list/history operations`),offset:R.number().int().min(0).optional().describe(`Pagination offset when action="list"`),force:R.boolean().optional().describe(`When true, supersede flagged similar entries without waiting for confirmation`),from_sha:R.string().optional().describe(`Start SHA for diff (older version). If omitted with to_sha, shows full content.`),to_sha:R.string().optional().describe(`End SHA for diff (newer version). If omitted, uses the latest two versions.`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:R.boolean().default(!1).optional().describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens.`)}),_f=j(`tools`);function vf(e,t){return[`knowledge`,e,t.path,t.id,t.title,t.topic,t.category,t.tag,t.profile].filter(e=>typeof e==`string`&&e.length>0).join(` `)}async function yf(e,t,n){let r=e.content?.find(e=>typeof e==`object`&&!!e&&`type`in e&&e.type===`text`);if(!r)return e;let i=r.text??``;if(t.enrich&&n){let e=await G(n,{query:vf(t.action,t)});i+=K(e)}t.max_tokens&&(i=L(i,t.max_tokens));let a=ru(i),o=iu(i,a),s=a&&e.structuredContent&&typeof e.structuredContent==`object`?{...e.structuredContent,ref:a}:a?{ref:a}:e.structuredContent;return{...e,content:e.content.map(e=>e.type===`text`?{...e,text:o}:e),structuredContent:s}}function bf(e,t,n,r){b(e,t,n);let i=e.memoryMetaGet(t);if(!i)return;let a=g(i,{..._,...r});return a?(y(e,t,a),v(e,t,n)??e.memoryMetaGet(t)):i}function xf(e,t){return`\n\n### ${e}\n${t.map(e=>`- **${e.title}** (${e.id}) — similarity ${e.similarity.toFixed(3)}`).join(`
|
|
237
|
+
`)}`}async function Sf(e,t,r,i){if(typeof e.list!=`function`||typeof e.read!=`function`)return[];let a=n(i),o=await e.list({category:r,limit:a.maxCompare,orderBy:`updated`,order:`desc`});return o.length===0?[]:u(t,await Promise.all(o.map(async t=>{let n=await e.read(t.path);return{id:t.path,title:n.title,content:n.content,path:t.path}})),a)}function Cf(e,t,n){return{superseded:e.filter(e=>n||e.similarity>=t).map(e=>({id:e.entryId,title:e.title,similarity:e.similarity})),supersessionCandidates:n?[]:e.filter(e=>e.similarity<t).map(e=>({id:e.entryId,title:e.title,similarity:e.similarity}))}}function wf(e){if(!e)return`analysis`;let t=Gd[e]??e;return Kd.has(t)?t:`analysis`}function Tf(e){let t=[...new Set(e.issues.filter(e=>e.code===`invalid_type`&&/received undefined$/i.test(e.message)).map(e=>e.path.join(`.`)).filter(e=>e.length>0))];if(t.length>0)return`Missing required fields: ${t.join(`, `)}`;let n=e.issues.map(e=>`${e.path.length>0?`${e.path.join(`.`)}: `:``}${e.message}`).join(`; `);return n.length>0?`Invalid parameters: ${n}`:`Invalid parameters.`}function Ef(e,t){return e??t??``}function Df(e){return[...new Set([...e??[],`lesson`])]}function Of(e,t,n){if(e)return e.memoryMetaCreate(t,`working`),e.memoryMetaUpdateConfidence(t,n),e.memoryMetaGet(t)}function kf(e,t,n,r=d){if(!e)return;let i=f(r);e.memoryMetaCreate(t,`working`),e.memoryMetaTouch(t);let a=n??e.memoryMetaGet(t)?.confidence??50,o=Math.min(100,a+i.implicitUseIncrement);return e.memoryMetaUpdateConfidence(t,o),e.memoryMetaGet(t)}function Af(e){let t=e.matchAll(/(?:\.ai\/curated\/)?(lessons\/[A-Za-z0-9._/%-]+\.md)/g);return[...new Set(Array.from(t,e=>e[1]))]}async function jf(e,t,n){let r=await e.read(n),i=a(r.content),o=t?.memoryMetaGet(n)?.confidence??i.confidence??50;return{entry:r,confidence:o,meta:Of(t,n,o)??t?.memoryMetaGet(n)}}function Mf(e){if(typeof e!=`object`||!e)return e;let t=e;if(t.title)return e;let n=typeof t.topic==`string`&&t.topic||typeof t.insight==`string`&&t.insight||``;if(!n)return e;let r=n.length<=120?n:`${n.slice(0,117)}...`;return{...t,title:r}}async function Nf(e){if(e){let t=I(e);try{return await Ge(t),t}catch{return}}let t=(await Ue($n(),{withFileTypes:!0})).filter(e=>e.isFile()&&e.name.startsWith(`aikit-obs-`)&&e.name.endsWith(`.jsonl`)).map(e=>F($n(),e.name)),n=await Promise.all(t.map(async e=>{try{return{path:e,mtimeMs:(await Ge(e)).mtimeMs}}catch{return{path:e,mtimeMs:0}}}));return n.sort((e,t)=>t.mtimeMs-e.mtimeMs),n[0]?.path}function Pf(e,t){return t.map(t=>({path:t.path,title:t.title,similarity:p(e,t.title)})).filter(e=>e.similarity>.8).sort((e,t)=>t.similarity-e.similarity)[0]}function Ff(e){let t=[`Lesson prune ${e.dryRun?`preview`:`completed`}: ${e.pruned.length} lessons selected.`,`Skipped ${e.skipped} lessons.`];return e.pruned.length>0&&(t.push(``,`Pruned:`),t.push(...e.pruned.map(e=>`- ${e}`))),t.join(`
|
|
238
|
+
`)}function If(e){let t=[`Lesson grouping ${e.dryRun?`preview`:`completed`}: ${e.groupsCreated} groups, ${e.lessonsGrouped} lessons.`];return e.groups.length>0&&(t.push(``,`Groups:`),t.push(...e.groups.map(e=>`- ${e.label}: ${e.members.join(`, `)}`))),t.join(`
|
|
239
|
+
`)}function Lf(e,n){let r=e;return new t(n,r.store,r.embedder)}function Rf(e,t){let n=e.candidates.filter(e=>e.action===`promote`),r=e.candidates.filter(e=>e.action===`skip`),i=[`Lesson promotion ${t?`preview`:`completed`}: ${n.length} candidates ready.`,`Skipped ${r.length} candidates.`];return n.length>0&&(i.push(``,`Candidates:`),i.push(...n.map(e=>`- ${e.insight} (${e.foundIn.join(`, `)}) avg ${e.avgConfidence}/100`))),r.length>0&&(i.push(``,`Skipped:`),i.push(...r.map(e=>`- ${e.insight}: ${e.reason}`))),e.promoted.length>0&&(i.push(``,`Promoted:`),i.push(...e.promoted.map(e=>`- ${e}`))),i.join(`
|
|
240
|
+
`)}async function zf(e,t){let r=e;if(r.scope===`flow`&&t.flowContextAdapter){let{title:e,content:n,category:i}=r,a=(e??`untitled`).toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-|-$/g,``),o=wf(i),s=o?`${o}/${a}.md`:`${a}.md`,c=`# ${e}\n\n${n??``}`;return await t.flowContextAdapter.write(s,c),{content:[{type:`text`,text:`Deposited flow context at \`${s}\``}]}}let{curated:i,policyStore:a,evolutionCollector:o,resourceNotifier:c,stateStore:l,supersessionConfig:u}=t,{title:d,content:f,category:p,tags:m,force:h=!1}=rf.parse(e),g=n(u),_=await Sf(i,f,p,g),v=await i.remember(d,f,p,m);l?.memoryMetaCreate(v.path,`working`);let y=Cf(_,g.autoThreshold,h);if(l)for(let e of y.superseded)s(l,e.id,v.path);let b=``;if(a){let e=a.classify(d,f,m);o&&o.recordClassification(d,e.matchingRules.map(e=>e.ruleId),e.pushRecommended),e.matchingRules.length>0&&(b=`\n\n### Classification Signals\n${e.matchingRules.map(e=>` - **${e.ruleId}** (${e.category}, weight: ${e.pushWeight}) — matched: ${e.matchedPatterns.join(`, `)}`).join(`
|
|
241
241
|
`)}\n- **Push recommended**: ${e.pushRecommended?`yes`:`no`} (max weight: ${e.maxPushWeight})`,e.pushRecommended&&(b+=`
|
|
242
242
|
|
|
243
|
-
> 💡 This entry matches push rules. Consider \`er_push\` to share with Enterprise RAG.`))}c&&c.notifyAfterCuratedWrite(v.path).catch(()=>{});let x=
|
|
244
|
-
`),l=
|
|
243
|
+
> 💡 This entry matches push rules. Consider \`er_push\` to share with Enterprise RAG.`))}c&&c.notifyAfterCuratedWrite(v.path).catch(()=>{});let x=Hd(v.path,d,`[${p}]`),S=y.superseded.length>0?xf(`Superseded Entries`,y.superseded):``,C=y.supersessionCandidates.length>0?xf(`Supersession Suggestions`,y.supersessionCandidates):``;return{content:[{type:`text`,text:`Remembered: **${d}**\n\nStored at \`.ai/curated/${v.path}\` and indexed for semantic search.${b}${S}${C}\n\n---\n_Next: Use \`search\` to verify the entry is findable, or \`knowledge({ action: "list" })\` to see all curated entries._`},...x?[x]:[]],structuredContent:{path:v.path,superseded:y.superseded,supersessionCandidates:y.supersessionCandidates}}}async function Bf(e,{curated:t,stateStore:n,retentionConfig:r,consolidationConfig:i}){let{path:a}=af.parse(e),o=await t.read(a),s=n?bf(n,a,r,i):void 0,c=[`## ${o.title}`,`- **Path**: .ai/curated/${a}`,`- **Category**: ${o.category}`,o.tags.length?`- **Tags**: ${o.tags.join(`, `)}`:null,`- **Version**: ${o.version}`,`- **Created**: ${o.created}`,o.updated===o.created?null:`- **Updated**: ${o.updated}`,s?`- **Tier**: ${s.tier}`:null,s?`- **Retention**: ${s.retentionScore.toFixed(3)}`:null,``].filter(e=>e!==null).join(`
|
|
244
|
+
`),l=Hd(a,o.title,`[${o.category}]`);return{content:[{type:`text`,text:`${c}\n${o.content}\n\n---\n_Next: Use \`knowledge({ action: "update", ... })\` to modify this entry, or \`search\` to find related entries._`},...l?[l]:[]]}}async function Vf(e,{curated:t,resourceNotifier:n}){let{path:r,content:i,reason:a}=of.parse(e),o=await t.update(r,i,a);return n&&n.notifyAfterCuratedWrite(r).catch(()=>{}),{content:[{type:`text`,text:`Updated: \`.ai/curated/${o.path}\` → version ${o.version}\n\nReason: ${a}\n\n---\n_Next: Use \`knowledge({ action: "read", path: "${o.path}" })\` to verify the updated content, or \`search\` to test searchability._`}]}}async function Hf(e,{curated:t,resourceNotifier:n}){let{path:r,reason:i}=sf.parse(e),a=I(t.curatedDir,r);if(N(a))try{gt(`forget`,[{path:a,content:P(a,`utf-8`)}],`forget: ${r}`)}catch{}let o=await t.forget(r,i);return _f.info(`Forgot entry`,{path:o.path,reason:i}),n&&(n.notifyAfterCuratedWrite().catch(()=>{}),n.notifyResourceListChanged().catch(()=>{})),{content:[{type:`text`,text:`Forgotten: \`.ai/curated/${o.path}\`\n\nRemoved from disk and vector store.\nReason: ${i}\n\n---\n_Next: Use \`knowledge({ action: "list" })\` to verify removal, or \`search\` to confirm the entry is no longer returned._`}]}}async function Uf(e,t){if(e.scope===`flow`&&t.flowContextAdapter){let e=await t.flowContextAdapter.list();if(e.length===0)return{content:[{type:`text`,text:`## Flow Context
|
|
245
245
|
|
|
246
246
|
No flow context entries found.`}]};let n=e.map(e=>` - \`${e.path}\` (${e.size} chars)`).join(`
|
|
247
|
-
`);return{content:[{type:`text`,text:`## Flow Context (${e.length} entries)\n\n${n}`}]}}let{curated:n,stateStore:r,retentionConfig:i}=t,{category:a,tag:o,limit:s,offset:c}=
|
|
248
|
-
`),m=
|
|
249
|
-
`);return{content:[{type:`text`,text:`## History for \`${n}\` (${i.length} entries)\n\n${a}\n\n_Use \`knowledge({ action: "diff", path: "${n}", from_sha: "...", to_sha: "..." })\` to compare versions._`}]}}async function
|
|
250
|
-
`);return{content:[{type:`text`,text:`## Orphaned Knowledge Entries (${n.length})\n\nThese entries exist in git but are missing from the filesystem:\n\n${r}\n\n_Use \`knowledge({ action: "recover", path: "..." })\` to restore any of these entries._`}]}}async function
|
|
247
|
+
`);return{content:[{type:`text`,text:`## Flow Context (${e.length} entries)\n\n${n}`}]}}let{curated:n,stateStore:r,retentionConfig:i}=t,{category:a,tag:o,limit:s,offset:c}=cf.parse(e),l=await n.listPage({category:a,tag:o,limit:s,offset:c,orderBy:`updated`,order:`desc`}),u=l.entries,d=u.map(e=>({entry:e,retentionMeta:r?v(r,e.path,i):void 0})),f={entries:d.map(({entry:e,retentionMeta:t})=>({path:e.path,title:e.title,category:e.category,tags:e.tags,version:e.version,preview:e.contentPreview?.slice(0,120)??``,...t?{retentionScore:t.retentionScore,tier:t.tier}:{}})),totalCount:l.totalCount,returnedCount:u.length,limit:l.limit,offset:l.offset,hasMore:l.hasMore};if(u.length===0)return{content:[{type:`text`,text:`No curated knowledge entries found.`+(a?` (category: ${a})`:``)+(o?` (tag: ${o})`:``)}],structuredContent:f};let p=d.map(({entry:e,retentionMeta:t})=>{let n=e.tags.length>0?` [${e.tags.join(`, `)}]`:``,r=t?` | tier ${t.tier} | retention ${t.retentionScore.toFixed(3)}`:``;return`- **${e.title}** (v${e.version})${n}${r}\n \`${e.path}\` — ${e.contentPreview.slice(0,80)}…`}).join(`
|
|
248
|
+
`),m=Ud(u),h=l.hasMore?`\n\n_Showing ${u.length} of ${l.totalCount} entries. Request \`offset: ${l.offset+u.length}\` for next page._`:l.totalCount>u.length?`\n\n_Showing ${u.length} of ${l.totalCount} entries._`:``;return{content:[{type:`text`,text:`## Curated Knowledge (${u.length} of ${l.totalCount} entries)\n\n${p}${h}\n\n---\n_Next: Use \`knowledge({ action: "read", path: "..." })\` to view full content of any entry, or \`knowledge({ action: "remember", ... })\` to store new knowledge._`},...m],structuredContent:f}}async function Wf(e,{curated:t}){let{path:n}=af.parse(e),r=e.limit??20,i=await t.history(n,r);if(i.length===0)return{content:[{type:`text`,text:`No git history available for this entry. Git-backing may not be available or the entry predates git-backing.`}]};let a=i.map((e,t)=>`${t+1}. **${e.date}** \`${e.sha.slice(0,8)}\` — ${e.message}`).join(`
|
|
249
|
+
`);return{content:[{type:`text`,text:`## History for \`${n}\` (${i.length} entries)\n\n${a}\n\n_Use \`knowledge({ action: "diff", path: "${n}", from_sha: "...", to_sha: "..." })\` to compare versions._`}]}}async function Gf(e,{curated:t}){let{path:n}=af.parse(e),{from_sha:r,to_sha:i}=e,a=await t.diff(n,r,i);return a?{content:[{type:`text`,text:`## Diff for \`${n}\`\n\n\`\`\`diff\n${a}\n\`\`\``}]}:{content:[{type:`text`,text:`No diff available. Git-backing may not be available or the entry has no history.`}]}}async function Kf(e,{curated:t}){let{path:n}=af.parse(e),r=await t.recover(n);return r?{content:[{type:`text`,text:`✅ Recovered \`${r.path}\` (version ${r.version}) from git history. The entry has been restored to the filesystem and re-indexed.`}]}:{content:[{type:`text`,text:`No git history found for \`${n}\`. Cannot recover — the entry either never existed or was never git-backed.`}]}}async function qf(e,{curated:t}){let n=await t.listOrphaned();if(n.length===0)return{content:[{type:`text`,text:`No orphaned entries found. All git-backed entries have corresponding filesystem files.`}]};let r=n.map((e,t)=>`${t+1}. \`${e.path}\` — last: ${e.lastMessage}`).join(`
|
|
250
|
+
`);return{content:[{type:`text`,text:`## Orphaned Knowledge Entries (${n.length})\n\nThese entries exist in git but are missing from the filesystem:\n\n${r}\n\n_Use \`knowledge({ action: "recover", path: "..." })\` to restore any of these entries._`}]}}async function Jf(e,{curated:t,stateStore:n,retentionConfig:r,lessonConfig:a}){if(!n)return{content:[{type:`text`,text:`Retention state store not available.`}],structuredContent:{entries:[],totalCount:0}};let o=S(n,r),s=f(a??d),l=await t.list({category:`lessons`}),u=(await Promise.all(l.filter(e=>e.tags.includes(`lesson`)).map(async e=>{let r=n.memoryMetaGet(e.path);return r||=(await jf(t,n,e.path)).meta,!r||!i(r,s)?null:{path:e.path,title:e.title,confidence:c(r.confidence,r.lastAccessedAt,r.createdAt,s),createdAt:r.createdAt,lastAccessedAt:r.lastAccessedAt,supersededBy:r.supersededBy}}))).filter(e=>e!==null).sort((e,t)=>e.confidence-t.confidence||Date.parse(e.lastAccessedAt??e.createdAt)-Date.parse(t.lastAccessedAt??t.createdAt));if(o.length===0&&u.length===0)return{content:[{type:`text`,text:`No flagged knowledge entries found below the current retention threshold.`}],structuredContent:{entries:[],totalCount:0}};let p=o.length===0?`### Retention
|
|
251
251
|
None.`:`### Retention\n${o.map(e=>`- \`${e.entryId}\` — score ${e.retentionScore.toFixed(3)}, tier ${e.tier}, accesses ${e.accessCount}`).join(`
|
|
252
252
|
`)}`,m=u.length===0?`### Stale Lessons
|
|
253
253
|
None.`:`### Stale Lessons\n${u.map(e=>`- **${e.title}** (\`${e.path}\`) — effective confidence ${e.confidence}/100, last access ${e.lastAccessedAt??e.createdAt}`).join(`
|
|
254
|
-
`)}`;return{content:[{type:`text`,text:`## Flagged Knowledge Entries (${o.length+u.length})\n\n${p}\n\n${m}`}],structuredContent:{entries:o,staleLessons:u,totalCount:o.length+u.length}}}const
|
|
254
|
+
`)}`;return{content:[{type:`text`,text:`## Flagged Knowledge Entries (${o.length+u.length})\n\n${p}\n\n${m}`}],structuredContent:{entries:o,staleLessons:u,totalCount:o.length+u.length}}}const Yf=/^(export|import|function|class|interface|type|const|let|var|→|├|└|─|##)/,Xf=/^(decision|rationale|status|context|consequence)/i,Zf=/finding|recommendation|warning|error|issue/i,Qf=/status|done|decision|blocker|next|file|created|modified/i,$f=/(score|relevance)/i,ep=/[/.]|\\.(ts|js)$/i;function tp(e){return e.split(/\r?\n/u).map(e=>e.replace(/[ \t]+$/u,``)).join(`
|
|
255
255
|
`).replace(/\n{3,}/gu,`
|
|
256
256
|
|
|
257
|
-
`).trim()}function
|
|
257
|
+
`).trim()}function np(e,t){if(e.length<=t)return e;let n=e.split(`
|
|
258
258
|
`),r=[],i=0;for(let e of n){let n=r.length===0?e.length:e.length+1;if(i+n>t)break;r.push(e),i+=n}return r.length>0?r.join(`
|
|
259
|
-
`):e.slice(0,t).trimEnd()}function
|
|
260
|
-
`)}function
|
|
261
|
-
`))}function
|
|
262
|
-
`),.7,e.length))}function
|
|
263
|
-
`),.65,e.length))}function
|
|
264
|
-
`),.6,e.length))}function
|
|
265
|
-
`),.5,e.length))}function
|
|
266
|
-
`).trim();return a.length<=t
|
|
267
|
-
|
|
268
|
-
`),b=g.reduce((e,t)=>e+t.content.length,0);return{content:[{type:`text`,text:`## Flow Context (${g.length}/${h.length} entries, ${b} chars, profile: ${s.profile})\n\n${y}`}]}}async function
|
|
259
|
+
`):e.slice(0,t).trimEnd()}function rp(e,t,n){return np(e,Math.max(1,Math.floor(n*t)))}function ip(e,t){if(e.length<50)return e;let n=tp(t);return!n||n.length<e.length*.2?e:n}function ap(e,t,n){let r=new Set;for(let n=0;n<Math.min(t,e.length);n+=1)r.add(n);return e.forEach((e,t)=>{n(e,t)&&r.add(t)}),e.filter((e,t)=>r.has(t)).join(`
|
|
260
|
+
`)}function op(e,t){e.includes(t)||e.push(t)}function sp(e){return ip(e,rp(ap(e.split(/\r?\n/u),3,e=>Yf.test(e)||e.startsWith(`- `)),.6,e.length))}function cp(e){let t=e.split(/\r?\n/u),n=[];return t.forEach((e,t)=>{if(t<5||$f.test(e)||ep.test(e)||/^Content:/i.test(e)){if(/^Content:/i.test(e)){op(n,`Content: ${e.replace(/^Content:\s*/i,``).trim().slice(0,200)}`);return}op(n,e)}}),ip(e,n.join(`
|
|
261
|
+
`))}function lp(e){let t=e.split(/\r?\n/u),n=new Set;for(let e=0;e<t.length&&t[e].trim()!==``;e+=1)n.add(e);return t.forEach((e,t)=>{(e.startsWith(`- `)||e.startsWith(`* `)||Xf.test(e))&&n.add(t)}),ip(e,rp(t.filter((e,t)=>n.has(t)).join(`
|
|
262
|
+
`),.7,e.length))}function up(e){let t=e.split(/\r?\n/u),n=new Set,r=!1;for(let e=0;e<Math.min(2,t.length);e+=1)n.add(e);return t.forEach((e,t)=>{if(e.startsWith("```")){n.add(t),r=!r;return}(r||e.startsWith(`##`)||e.startsWith(`- `)||e.startsWith(`* `))&&n.add(t)}),ip(e,rp(t.filter((e,t)=>n.has(t)).join(`
|
|
263
|
+
`),.65,e.length))}function dp(e){return ip(e,rp(e.split(/\r?\n/u).filter(e=>e.startsWith(`#`)||e.startsWith(`- `)||/\d/.test(e)||/\d+%/.test(e)||Zf.test(e)).join(`
|
|
264
|
+
`),.6,e.length))}function fp(e){return ip(e,rp(e.split(/\r?\n/u).filter(e=>e.startsWith(`- `)||e.startsWith(`* `)||Qf.test(e)).join(`
|
|
265
|
+
`),.5,e.length))}function pp(e,t){switch(e){case`file-card`:return sp(t);case`search-result`:return cp(t);case`decision`:return lp(t);case`pattern`:return up(t);case`analysis`:return dp(t);case`step-summary`:return fp(t)}}const mp=/^### (Context|Insight|Evidence|Key|Finding|Result|Decision)/imu;function hp(e,t){let n=e.trim();if(!n||n.length<=t)return n;let r=n.split(/\\r?\\n/u),i=new Set;for(let e=0;e<r.length;e++)if(/^#{1,3}\s/mu.test(r[e])&&i.size===0){i.add(e);for(let t=e+1;t<r.length;t++)if(r[t].trim().length>0){i.add(t);break}}r.forEach((e,t)=>{if((/^\s*[-*]\s/mu.test(e)||/^\d+\.\s/mu.test(e))&&i.add(t),mp.test(e)){i.add(t);let e=r[t+1]?.trim();e&&!/^[#>-]/.test(e)&&i.add(t+1)}/^(Confidence|Source|Tags?):/imu.test(e)&&i.add(t)}),n.length>t&&r.forEach((e,t)=>{i.has(t)||/\b(always|never|prefer|use|should|must|requires?|detected|confirmed|verified)\b/im.test(e)&&i.add(t)});let a=r.filter((e,t)=>i.has(t)).join(`
|
|
266
|
+
`).trim();return a.length<=t?tp(a):np(tp(a),t)}function gp(e,t,n,r){let i=t?.trim()??``,a=`(confidence: ${n}/100)`,o=`**${e}** ${a} — ${i}`.trim();if(o.length<=r)return o;let s=`**${e}** ${a}`;if(s.length<=r)return s;let c=r-a.length-8;return`**${e.length>c?`${e.slice(0,Math.max(0,c-3))}...`:e}** ${a}`}const _p={decision:6,pattern:5,"file-card":4,analysis:3,"search-result":2,"step-summary":1},vp={"search-result":864e5,"file-card":1728e5,analysis:1728e5,"step-summary":2592e5,decision:6048e5,pattern:6048e5},yp={implementer:{name:`implementer`,contextTypes:[`file-card`,`decision`,`pattern`],priority:{..._p}},documenter:{name:`documenter`,contextTypes:[`decision`,`pattern`,`step-summary`],priority:{..._p}},reviewer:{name:`reviewer`,contextTypes:[`file-card`,`search-result`,`decision`,`pattern`,`step-summary`,`analysis`],priority:{..._p}},researcher:{name:`researcher`,contextTypes:[`search-result`,`decision`,`analysis`],priority:{..._p}},debugger:{name:`debugger`,contextTypes:[`file-card`,`search-result`,`pattern`,`analysis`],priority:{..._p}}};function bp(e){return yp[e]}function xp(e,t,n=Date.now()){let r=n-t;if(r<36e5)return!1;let i=vp[e];return i==null?!1:r>i}function Sp(e,t,n){if(n<=0)return[];let r=new Set(t.contextTypes),i=e.filter(e=>r.has(e.type)).map((e,t)=>({entry:e,index:t})).sort((e,n)=>{let r=t.priority[n.entry.type]-t.priority[e.entry.type];return r===0?e.index-n.index:r}),a=[],o=0;for(let{entry:e}of i){let t=pp(e.type,e.content),r=t.length;o+r>n||(a.push({type:e.type,content:t}),o+=r)}return a}async function Cp(e,{curated:t,flowContextAdapter:n,stateStore:r,retentionConfig:i,consolidationConfig:a,lessonConfig:o}){let s=R.object({profile:R.string(),budget:R.number().int().min(100).max(5e4).default(6e3).describe(`Character budget for withdraw results`),token_budget:R.number().int().min(50).max(12500).optional().describe(`Token budget (overrides budget). Approx 4 chars per token.`)}).parse(e),c=s.token_budget?s.token_budget*4:s.budget;if(!n)return{content:[{type:`text`,text:`Flow context not available — no active flow or adapter not configured.`}]};let l=bp(s.profile);if(!l)return{content:[{type:`text`,text:`Unknown profile: "implementer, documenter, reviewer, researcher, debugger".`}]};let u=await n.list();if(u.length===0)return{content:[{type:`text`,text:`No flow context available yet. Context is deposited automatically as agents use search, file_summary, and other analysis tools.`}]};let p=Date.now(),m=u.filter(e=>{let t=e.path.split(`/`)[0];return Kd.has(t)?!xp(t,e.mtimeMs,p):!0}),h=(await Promise.all(m.map(async e=>{let t=e.path.split(`/`),o=t[0];if(t.length<2||!Kd.has(o))return null;let s=await n.read(e.path);return s?(r&&bf(r,e.path,i,a),{type:o,content:s}):null}))).filter(e=>e!==null),g=Sp(h,l,c),_=f(o??d),v=[...new Set(g.flatMap(e=>Af(e.content)))];if(await Promise.all(v.map(async e=>{let n=r?.memoryMetaGet(e)?.confidence;if(n===void 0)try{n=(await jf(t,r,e)).confidence}catch{return}kf(r,e,n,_)})),g.length===0)return{content:[{type:`text`,text:`No relevant context for profile "${s.profile}". ${h.length} entries available but none match your role's context types.`}]};let y=g.map(e=>`### [${e.type}]\n${e.content}`).join(`
|
|
267
|
+
|
|
268
|
+
`),b=g.reduce((e,t)=>e+t.content.length,0);return{content:[{type:`text`,text:`## Flow Context (${g.length}/${h.length} entries, ${b} chars, profile: ${s.profile})\n\n${y}`}]}}async function wp(e,{flowContextAdapter:t}){return t?{content:[{type:`text`,text:`Flushed ${await t.flushAll()} flow context entries.`}]}:{content:[{type:`text`,text:`Flow context not available — no active flow or adapter not configured.`}]}}async function Tp(e){try{let t=await e.getStats(),n=await e.validate(),r=t.nodeCount,i=t.edgeCount,a=await e.findNodes({limit:1e4}),o=a.slice(0,500),s=Math.max(0,a.length-500),c=[];for(let t=0;t<o.length;t+=50){let n=o.slice(t,t+50),r=await Promise.allSettled(n.map(t=>e.getNeighbors(t.id,{direction:`both`,maxDepth:1})));for(let e=0;e<n.length;e++){let t=r[e],i=t.status===`fulfilled`&&t.value.nodes!=null&&t.value.nodes.length>0;c.push({id:n[e].id,hasNeighbors:i})}}let l=[];for(let e=0;e<o.length;e++)c[e].hasNeighbors||l.push({id:o[e].id,name:o[e].name,type:o[e].type});let u=l.length,d=r>0?u/r:0,f=[];if(t.communities)for(let[e,n]of Object.entries(t.communities))Array.isArray(n)&&n.length<3&&f.push({name:e,nodeCount:n.length,nodes:n});let p={danglingEdgeCount:n.danglingEdges.length,orphanNodeCount:n.orphanNodes.length},m=t.communityCount??0,h=m>0?f.length/m:0,g=i>0?p.danglingEdgeCount/i:0,_=Math.max(d,h,g),v=_<.1?`healthy`:_<.3?`fair`:`poor`,y={summary:[`# Knowledge Gap Analysis`,``,`**${r}** nodes, **${i}** edges across **${m}** communities.`,`**Overall health: ${v.toUpperCase()}**`,``,`## Key Metrics`,``,`| Metric | Value | Threshold |`,`|--------|-------|-----------|`,`| Isolated nodes | ${u} / ${r} (${(d*100).toFixed(1)}%)${s>0?` *(${s} unchecked)*`:``} | < 10% healthy |`,`| Thin communities | ${f.length} / ${m} (${(h*100).toFixed(1)}%) | < 10% healthy |`,`| Dangling edges | ${p.danglingEdgeCount} / ${i} (${(g*100).toFixed(1)}%) | < 10% healthy |`,``].join(`
|
|
269
269
|
`),metadata:{analyzedAt:new Date().toISOString(),nodeCount:r,edgeCount:i},isolatedNodes:l,uncheckedNodeCount:s,thinCommunities:f,graphIntegrity:p,combinedScore:{overall:v,isolatedNodeRatio:d,thinCommunityRatio:h,integrityRatio:g}},b=[];if(s>0&&b.push(``,`> **Note:** ${s} nodes were not checked for isolation (limit: 500). Unchecked nodes are not classified as isolated.`),l.length>0){b.push(``,`## Isolated Nodes`);for(let e of l.slice(0,20))b.push(`- **${e.name}** (${e.type}, id: \`${e.id}\`)`);l.length>20&&b.push(`- ... and ${l.length-20} more`)}if(f.length>0){b.push(``,`## Thin Communities`);for(let e of f)b.push(`- **${e.name}**: ${e.nodeCount} node(s) — ${e.nodes.join(`, `)}`)}if(p.danglingEdgeCount>0){b.push(``,`## Dangling Edges (graph integrity)`);for(let e of n.danglingEdges.slice(0,20))b.push(`- Edge \`${e.edgeId}\` → missing node \`${e.missingNodeId}\``)}return p.orphanNodeCount>0&&(b.push(``,`## Orphan Nodes`),b.push(`- ${n.orphanNodes.join(`, `)}`)),y.summary+=b.join(`
|
|
270
|
-
`),{content:[{type:`text`,text:y.summary}],isError:!1,report:y}}catch(e){return{content:[{type:`text`,text:`Gap analysis failed: ${e instanceof Error?e.message:M(e)}`}],isError:!0,report:null}}}async function
|
|
271
|
-
`);return{content:[{type:`text`,text:`## Lessons (${T.length} of ${w.length})\n\n${E}`}],structuredContent:{entries:T.map(({storedConfidence:e,...t})=>t),totalCount:w.length,scannedCount:S.length,limit:h,offset:g,hasMore:w.length>g+h||b.hasMore,archivedCount:C}}}async function
|
|
272
|
-
`)}],structuredContent:{bufferPath:a,observations:o.length,createdCount:l.length,skippedCount:u.length,candidates:s.map(e=>({title:e.title,detector:e.detector,confidence:e.confidence,tags:e.tags})),created:l,skipped:u}}}async function
|
|
273
|
-
|
|
274
|
-
`),s=
|
|
275
|
-
`).replace(/\\t/g,` `)}))}]}}catch(e){return
|
|
276
|
-
`)}function
|
|
277
|
-
`)}function
|
|
270
|
+
`),{content:[{type:`text`,text:y.summary}],isError:!1,report:y}}catch(e){return{content:[{type:`text`,text:`Gap analysis failed: ${e instanceof Error?e.message:M(e)}`}],isError:!0,report:null}}}async function Ep(e,{curated:t,stateStore:n,resourceNotifier:r}){let i=Mf(e),{title:a,context:o,insight:s,evidence:c,confidence:l,tags:u}=lf.parse(i),d=h({title:a,context:o,insight:s,evidence:c,confidence:l,tags:u}),f=await t.remember(a,d,`lessons`,Df(u));return Of(n,f.path,l),r&&r.notifyAfterCuratedWrite(f.path).catch(()=>{}),{content:[{type:`text`,text:`Recorded lesson: **${a}**\n\nStored at \`.ai/curated/${f.path}\` with confidence ${l}/100.`}],structuredContent:{path:f.path,confidence:l,category:`lessons`,tags:Df(u)}}}async function Dp(e,t,n){let{curated:i,stateStore:a,resourceNotifier:o,retentionConfig:s,consolidationConfig:c,lessonConfig:u}=n,p=uf.parse(e);if(t===`contradict`&&!p.reason)throw new R.ZodError([{code:`custom`,path:[`reason`],message:`reason is required`}]);let m=Ef(p.path,p.id),h=f(u??d);a&&bf(a,m,s,c);let{entry:g,confidence:_}=await jf(i,a,m),v=r(_,t,h),y=l(g.content,v),b=t===`confirm`?p.reason??`Confirmed lesson confidence`:`Contradicted lesson confidence: ${p.reason}`,x=await i.update(m,y,b);return a&&a.memoryMetaUpdateConfidence(m,v),o&&o.notifyAfterCuratedWrite(m).catch(()=>{}),{content:[{type:`text`,text:`${t===`confirm`?`Confirmed`:`Contradicted`} lesson: \`${m}\`\n\nConfidence ${_}/100 → ${v}/100.`}],structuredContent:{path:x.path,confidence:v,previousConfidence:_,version:x.version}}}async function Op(e,{curated:t,stateStore:n,lessonConfig:r}){let{topic:i,minConfidence:a,tag:s,tags:l,sortBy:u,includeArchived:p,limit:h,offset:g}=df.parse(e),_=Df([...l??[],...s?[s]:[]]),v=f(r??d),y=Math.max(h+g,500),b=await t.listPage({category:`lessons`,...s?{tag:s}:{},limit:y,orderBy:`updated`,order:`desc`}),x=b.entries,S=await Promise.all(x.filter(e=>e.tags.includes(`lesson`)).map(async e=>{let{confidence:r,meta:i}=await jf(t,n,e.path),a=i??n?.memoryMetaGet(e.path);a&&a.supersededBy===null&&o(a,v)&&n?.memoryMetaSetSuperseded(e.path,m);let s=n?.memoryMetaGet(e.path)??a,l=s?.createdAt??e.created,u=s?.confidence??r,d=c(u,s?.lastAccessedAt,l,v),f=s?.lastAccessedAt??s?.createdAt??null;return{path:e.path,title:e.title,category:e.category,tags:e.tags,version:e.version,preview:e.contentPreview,confidence:d,storedConfidence:u,createdAt:l,lastAccessedAt:s?.lastAccessedAt??null,recency:f,archived:s?.supersededBy===m,supersededBy:s?.supersededBy??null}})),C=S.filter(e=>e.archived).length,w=S.filter(e=>p?!0:e.supersededBy===null).filter(e=>a===void 0?!0:e.confidence>=a).filter(e=>_.length===0?!0:_.every(t=>e.tags.includes(t))).filter(e=>i?`${e.title}\n${e.preview}\n${e.tags.join(` `)}`.toLowerCase().includes(i.toLowerCase()):!0).sort((e,t)=>u===`recent`?Date.parse(t.recency??``)-Date.parse(e.recency??``)||t.confidence-e.confidence:t.confidence-e.confidence||Date.parse(t.recency??``)-Date.parse(e.recency??``)),T=w.slice(g,g+h);if(w.forEach(e=>{kf(n,e.path,e.storedConfidence,v)}),T.length===0)return{content:[{type:`text`,text:`No lessons matched the requested filters.`}],structuredContent:{entries:[],totalCount:w.length,scannedCount:S.length,limit:h,offset:g,hasMore:w.length>g+h||b.hasMore,archivedCount:C}};let E=T.map(e=>{let t=e.recency?` | recent ${e.recency}`:``;return`- **${e.title}** (${e.confidence}/100)${t}\n \`${e.path}\` — ${e.preview.slice(0,80)}…`}).join(`
|
|
271
|
+
`);return{content:[{type:`text`,text:`## Lessons (${T.length} of ${w.length})\n\n${E}`}],structuredContent:{entries:T.map(({storedConfidence:e,...t})=>t),totalCount:w.length,scannedCount:S.length,limit:h,offset:g,hasMore:w.length>g+h||b.hasMore,archivedCount:C}}}async function kp(e,{curated:t,stateStore:n,resourceNotifier:r}){let{bufferPath:i}=ff.parse(e),a=await Nf(i);if(!a)return{content:[{type:`text`,text:`No observation buffer found for auto-observe.`}],structuredContent:{bufferPath:null,observations:0,createdCount:0,skippedCount:0,candidates:[]}};let o=qi(P(a,`utf8`)),s=Ki(o,Si),c=await t.list({category:`lessons`}),l=[],u=[];try{for(let e of s){let i=Pf(e.title,c);if(i){u.push({title:e.title,path:i.path,similarity:i.similarity});continue}let a=h({title:e.title,context:e.context,insight:e.insight,evidence:e.evidence,confidence:e.confidence,tags:e.tags}),o=await t.remember(e.title,a,`lessons`,Df(e.tags));Of(n,o.path,e.confidence),l.push({path:o.path,title:e.title,detector:e.detector}),c.push({path:o.path,title:e.title,category:`lessons`,tags:Df(e.tags),version:1,created:new Date().toISOString(),updated:new Date().toISOString(),contentPreview:e.insight}),r&&r.notifyAfterCuratedWrite(o.path).catch(()=>{})}}finally{try{Pe(a)}catch{}}let d=[`Auto-observe processed ${o.length} observations from \`${a}\`.`,`Created ${l.length} lessons and skipped ${u.length} duplicates from ${s.length} candidates.`];return l.length>0&&(d.push(``,`Created:`),d.push(...l.map(e=>`- **${e.title}** (${e.path})`))),u.length>0&&(d.push(``,`Skipped:`),d.push(...u.map(e=>`- **${e.title}** matched ${e.path} (${e.similarity.toFixed(2)})`))),{content:[{type:`text`,text:d.join(`
|
|
272
|
+
`)}],structuredContent:{bufferPath:a,observations:o.length,createdCount:l.length,skippedCount:u.length,candidates:s.map(e=>({title:e.title,detector:e.detector,confidence:e.confidence,tags:e.tags})),created:l,skipped:u}}}async function Ap(e,t){switch(e.subAction??`create`){case`create`:return Ep(e,t);case`confirm`:return Dp(e,`confirm`,t);case`contradict`:return Dp(e,`contradict`,t);case`list-lessons`:return Op(e,t);case`auto-observe`:return kp(e,t);case`prune`:{if(!t.stateStore)return q(`VALIDATION`,`StateStore required for lesson/prune`);let n=pf.parse(e),r=await E(t.curated,t.stateStore,{maxConfidence:n.maxConfidence,minIdleDays:n.minIdleDays,safetyDays:n.safetyDays,maxPrune:n.maxPrune,dryRun:n.dryRun},t.lessonConfig?f(t.lessonConfig):d);return{content:[{type:`text`,text:Ff(r)}],structuredContent:r}}case`group`:{if(!t.stateStore)return q(`VALIDATION`,`StateStore required for lesson/group`);let n=mf.parse(e),r=await T(t.curated,t.stateStore,{similarityThreshold:n.similarityThreshold,minGroupSize:n.minGroupSize,maxGroups:n.maxGroups,dryRun:n.dryRun});return{content:[{type:`text`,text:If(r)}],structuredContent:r}}case`promote`:{if(!Te())return{content:[{type:`text`,text:`Promotion requires user-level install (not workspace-scoped).`}]};let n=hf.parse(e),r={minWorkspaces:n.minWorkspaces??ne.minWorkspaces,minAvgConfidence:n.minAvgConfidence??ne.minAvgConfidence,similarityThreshold:n.similarityThreshold??ne.similarityThreshold,dryRun:n.dryRun},i=await D(te(await k(),r),Lf(t.curated,O()),r);return{content:[{type:`text`,text:Rf(i,r.dryRun)}],structuredContent:i}}case`demote`:{if(!Te())return{content:[{type:`text`,text:`Demotion requires user-level install.`}]};let n=Ef(e.path,e.id);if(!n)return{content:[{type:`text`,text:`Missing required "path" or "id" parameter for demote.`}]};let r=await ee(Lf(t.curated,O()),n);return{content:[{type:`text`,text:r.removed?`Demoted: ${n}`:`Not found in global: ${n}`}],structuredContent:r}}}}async function jp(e,t,n){switch(e){case`remember`:return zf(t,n);case`read`:return Bf(t,n);case`update`:return Vf(t,n);case`forget`:return Hf(t,n);case`list`:return Uf(t,n);case`history`:return Wf(t,n);case`diff`:return Gf(t,n);case`recover`:return Kf(t,n);case`orphaned`:return qf(t,n);case`withdraw`:return Cp(t,n);case`flush`:return wp(t,n);case`flagged`:return Jf(t,n);case`lesson`:return Ap(t,n);case`gap-analysis`:return n.graphStore?Tp(n.graphStore):{content:[{type:`text`,text:`Gap analysis requires a graph store (not available).`}],isError:!0}}}function Mp(e,t,n,r,i,a,o,s,c,l,u,d,f){let p=W(`knowledge`),m={curated:t,policyStore:n,evolutionCollector:r,resourceNotifier:i,flowContextAdapter:a,stateStore:o,retentionConfig:s,consolidationConfig:l,supersessionConfig:c,lessonConfig:u,graphStore:f};e.registerTool(`knowledge`,{title:p.title,description:"Operate on curated knowledge entries with a single tool. Use `action` to remember, read, update, forget, list, history, diff, recover, orphaned, withdraw, flush, flagged, lesson, or gap-analysis entries. gap-analysis runs a knowledge graph health check: isolated nodes, thin communities, dangling edges.",inputSchema:gf.shape,annotations:p.annotations},J(`knowledge`,async({action:e,...t})=>{try{let n=gf.parse({action:e,...t});return await yf(await jp(n.action,n,m),n,d)}catch(e){return e instanceof R.ZodError?q(`VALIDATION`,Tf(e)):(_f.error(`Knowledge operation failed`,M(e)),q(`INTERNAL`,`Knowledge operation failed: ${e instanceof Error?e.message:String(e)}`))}}))}const Np=j(`tools`);function Pp(e,t,n){let r=W(`lookup`);e.registerTool(`lookup`,{title:r.title,description:`Get all indexed content for a known file path, sorted by position. Use when you know the exact file. For discovery across files use search.`,inputSchema:{path:R.string().describe(`Relative file path to look up (e.g., "src/index.ts")`),enrich:R.boolean().default(!1).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default false — set true when you need stored decisions, conventions, or relationship context.`)},annotations:r.annotations},J(`lookup`,async({path:e,enrich:r})=>{try{let i=await t.getBySourcePath(e);if(i.length===0)return{content:[{type:`text`,text:`No indexed content found for: ${e}`}]};i.sort((e,t)=>e.chunkIndex-t.chunkIndex);let a=`## ${e}\n**Chunks**: ${i.length} | **Type**: ${i[0].contentType}\n`,o=i.map(e=>{let t=e.startLine?` (lines ${e.startLine}-${e.endLine})`:``;return`### Chunk ${e.chunkIndex+1}/${e.totalChunks}${t}\n${e.content}`}).join(`
|
|
273
|
+
|
|
274
|
+
`),s=Wd(e),c=s?Hd(s):void 0,l=`${a}\n${o}\n\n---\n_Next: Use \`search\` to find related content, or \`analyze({ aspect: "dependencies", path: "${e}" })\` to see what this file imports._`;if(r&&n){let t=await G(n,{query:e});l+=K(t)}return{content:[{type:`text`,text:l},...c?[c]:[]]}}catch(e){return Np.error(`Lookup failed`,M(e)),q(`INTERNAL`,`Lookup failed: ${e instanceof Error?e.message:String(e)}`)}}))}const Fp=j(`tools:manipulation`);function Ip(e){return e.sources[0]?.path??Oe()}function Lp(e,t){let n=I(t,e),r=ze(t,n);if(r.startsWith(`..`)||Re(r))throw Error(`Path "${e}" escapes workspace root: ${t}`);return n}function Rp(e){let t=W(`git_context`);e.registerTool(`git_context`,{title:t.title,description:`Summarize the current Git branch, working tree state, recent commits, and optional diff statistics for the repository.`,inputSchema:{cwd:R.string().optional().describe(`Repository root or working directory`),commit_count:R.number().min(1).max(50).default(5).optional().describe(`How many recent commits to include`),include_diff:R.boolean().default(!1).optional().describe(`Include diff stat for working tree changes`)},annotations:t.annotations,outputSchema:Dc},async({cwd:e,commit_count:t,include_diff:n})=>{try{let r=await It({cwd:e,commitCount:t,includeDiff:n});return{content:[{type:`text`,text:Up(r)}],structuredContent:{gitRoot:r.gitRoot,branch:r.branch,commitCount:r.recentCommits.length,hasUncommitted:r.status.staged.length>0||r.status.modified.length>0||r.status.untracked.length>0,recentCommits:r.recentCommits.map(e=>({hash:e.hash,message:e.message,author:e.author,date:e.date}))}}}catch(e){return Fp.error(`Git context failed`,M(e)),q(`INTERNAL`,`Git context failed: ${e instanceof Error?e.message:String(e)}`)}})}function zp(e){let t=W(`diff_parse`);e.registerTool(`diff_parse`,{title:t.title,description:`Parse raw unified diff text into file-level and hunk-level structural changes.`,inputSchema:{diff:R.string().max(1e6).describe(`Raw unified diff text`)},annotations:t.annotations},async({diff:e})=>{try{return{content:[{type:`text`,text:Wp(St({diff:e.replace(/\\n/g,`
|
|
275
|
+
`).replace(/\\t/g,` `)}))}]}}catch(e){return Fp.error(`Diff parse failed`,M(e)),q(`INTERNAL`,`Diff parse failed: ${e instanceof Error?e.message:String(e)}`)}})}function Bp(e,t){let n=W(`rename`),r=Ip(t);e.registerTool(`rename`,{title:n.title,description:`Rename a symbol across files using whole-word regex matching for exports, imports, and general usage references.`,inputSchema:{old_name:R.string().describe(`Existing symbol name to replace`),new_name:R.string().describe(`New symbol name to use`),root_path:R.string().describe(`Root directory to search within`),extensions:R.array(R.string()).optional().describe(`Optional file extensions to include, such as .ts,.tsx,.js,.jsx`),dry_run:R.boolean().default(!0).describe(`Preview changes without writing files`)},annotations:n.annotations},J(`rename`,async({old_name:e,new_name:t,root_path:n,extensions:i,dry_run:a},o)=>{let s;try{s=gl(o).createTask(`Rename Symbol`,2),s.progress(0,`Scanning for references`);let c=Lp(n,r);s.progress(1,`Applying renames`);let l=await yn({oldName:e,newName:t,rootPath:c,extensions:i,dryRun:a});return s.complete(`Rename complete`),{content:[{type:`text`,text:JSON.stringify(l)}]}}catch(e){return s?.fail?.(`Rename failed`),Fp.error(`Rename failed`,M(e)),q(`INTERNAL`,`Rename failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Vp(e,t){let n=W(`codemod`),r=Ip(t);e.registerTool(`codemod`,{title:n.title,description:`Apply regex-based codemod rules across files and return structured before/after changes for each affected line.`,inputSchema:{root_path:R.string().describe(`Root directory to transform within`),rules:R.array(R.object({description:R.string().describe(`What the codemod rule does`),pattern:R.string().describe(`Regex pattern in string form`),replacement:R.string().describe(`Replacement string with optional capture groups`)})).min(1).describe(`Codemod rules to apply`),dry_run:R.boolean().default(!0).describe(`Preview changes without writing files`)},annotations:n.annotations},J(`codemod`,async({root_path:e,rules:t,dry_run:n},i)=>{let a;try{a=gl(i).createTask(`Codemod`,2),a.progress(0,`Scanning files`);let o=Lp(e,r);a.progress(1,`Applying transforms`);let s=await mt({rootPath:o,rules:t,dryRun:n});return a.complete(`Codemod complete`),{content:[{type:`text`,text:JSON.stringify(s)}]}}catch(e){return a?.fail?.(`Codemod failed`),Fp.error(`Codemod failed`,M(e)),q(`INTERNAL`,`Codemod failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Hp(e){let t=W(`data_transform`);e.registerTool(`data_transform`,{title:t.title,description:`Apply small jq-like transforms to JSON input for filtering, projection, grouping, and path extraction.`,inputSchema:{input:R.string().max(5e5).describe(`Input JSON string`),expression:R.string().max(1e4).describe(`Transform expression to apply`)},annotations:t.annotations},async({input:e,expression:t})=>{try{return{content:[{type:`text`,text:vt({input:e,expression:t}).outputString}]}}catch(e){return Fp.error(`Data transform failed`,M(e)),q(`INTERNAL`,`Data transform failed: ${e instanceof Error?e.message:String(e)}`)}})}function Up(e){let t=[`Git root: ${e.gitRoot}`,`Branch: ${e.branch}`,`Staged: ${e.status.staged.length}`,...e.status.staged.map(e=>` - ${e}`),`Modified: ${e.status.modified.length}`,...e.status.modified.map(e=>` - ${e}`),`Untracked: ${e.status.untracked.length}`,...e.status.untracked.map(e=>` - ${e}`),``,`Recent commits:`];if(e.recentCommits.length===0)t.push(` none`);else for(let n of e.recentCommits)t.push(` - ${n.hash} ${n.message}`),t.push(` ${n.author} @ ${n.date}`);return e.diff&&t.push(``,`Diff stat:`,e.diff),t.join(`
|
|
276
|
+
`)}function Wp(e){if(e.length===0)return`No diff files found.`;let t=[];for(let n of e){let e=n.oldPath?` (from ${n.oldPath})`:``;t.push(`${n.path}${e} [${n.status}] +${n.additions} -${n.deletions} (${n.hunks.length} hunks)`);for(let e of n.hunks){let n=e.header?` ${e.header}`:``;t.push(` @@ -${e.oldStart},${e.oldLines} +${e.newStart},${e.newLines} @@${n}`)}}return t.join(`
|
|
277
|
+
`)}function Gp(e,t){return t?e.length<=500?e:`${e.slice(0,497)}...`:``}function Kp(e,t){let n=[];return e.keywordRank!==void 0&&n.push(`keyword match rank ${e.keywordRank+1}`),e.vectorRank!==void 0&&n.push(`semantic match rank ${e.vectorRank+1}`),e.result.record.origin===`curated`&&n.push(`curated memory`),e.result.record.category&&n.push(`category:${e.result.record.category}`),e.result.record.tags.length>0&&n.push(`tags:${e.result.record.tags.join(`,`)}`),{id:e.result.record.id,score:e.result.score,content:Gp(e.result.record.content,t),sourcePath:e.result.record.sourcePath,origin:e.result.record.origin,category:e.result.record.category,tags:e.result.record.tags,reason:n.join(`; `)||`store result`}}function qp(e,t){let n=new Map;return e.forEach((e,t)=>{n.set(e.record.id,{result:e,vectorRank:t})}),t.forEach((e,t)=>{let r=n.get(e.record.id);if(r){n.set(e.record.id,{result:{record:e.record,score:Math.max(r.result.score,e.score)},vectorRank:r.vectorRank,keywordRank:t});return}n.set(e.record.id,{result:e,keywordRank:t})}),[...n.values()].sort((e,t)=>{let n=Math.min(e.vectorRank??1/0,e.keywordRank??1/0),r=Math.min(t.vectorRank??1/0,t.keywordRank??1/0);return n===r?t.result.score-e.result.score:n-r})}async function Jp(e,t,n={}){let r=n.limit??5,i=n.candidateLimit??Math.max(r*3,10),a=n.searchMode??`hybrid`,o={limit:i,origin:n.origin??`curated`,category:n.category,tags:n.tags?[...n.tags]:void 0},[s,c]=await Promise.all([a===`keyword`?Promise.resolve([]):t.embedder.embedQuery(e).then(e=>t.store.search(e,o)).catch(()=>[]),a===`semantic`?Promise.resolve([]):t.store.ftsSearch(e,o).catch(()=>[])]),l=qp(s,c).map(e=>Kp(e,n.includeContent??!0)),u=l.slice(0,r),d=l.slice(r).map(e=>({...e,ignoredReason:`lower ranked candidate outside selection limit`})),f=c.length,p=s.length;return{query:e,searchMode:a,retrieved:l,selected:u,ignored:d,finalReasoning:u.length===0?`No active matching memory was found. Deleted memories are not visible after store cleanup.`:`Selected ${u.length} of ${l.length} active candidate(s). Keyword candidates: ${f}; semantic candidates: ${p}.`}}function Yp(e,t,n){let r=W(`memory_explain`);e.registerTool(`memory_explain`,{title:r.title,description:`Explain why AI Kit memory search returns, selects, or ignores memories for a query. Debugs curated and auto-knowledge quality without invoking an LLM.`,inputSchema:{query:R.string().min(1).max(5e3).describe(`Memory query to explain`),limit:R.number().int().min(1).max(20).default(5),candidate_limit:R.number().int().min(1).max(100).optional(),search_mode:R.enum([`hybrid`,`semantic`,`keyword`]).default(`hybrid`),origin:R.enum(ge).default(`curated`),category:R.string().optional(),tags:R.array(R.string()).optional(),include_content:R.boolean().default(!0)},annotations:r.annotations},async({query:e,limit:r,candidate_limit:i,search_mode:a,origin:o,category:s,tags:c,include_content:l})=>{try{let u=await Jp(e,{embedder:t,store:n},{limit:r,candidateLimit:i,searchMode:a,origin:o,category:s,tags:c,includeContent:l}),d=JSON.stringify(u,null,2),f=ru(d);return{content:[{type:`text`,text:iu(d,f)}],structuredContent:{...u,ref:f}}}catch(e){return q(`INTERNAL`,`memory_explain failed: ${M(e).message}`)}})}const Xp=[`list_tools`,`describe_tool`,`search_tools`];function Zp(e,t,n){let r=[...new Set(n)].sort();e.registerTool(`list_tools`,{title:W(`list_tools`).title,description:`List the available AI Kit tools with names, titles, and categories. Use this before describe_tool when you need to discover the active toolset.`,inputSchema:{category:R.string().optional().describe(`Optional category filter`)},annotations:W(`list_tools`).annotations},J(`list_tools`,async({category:e})=>{let t=e?.trim().toLowerCase();return{content:[{type:`text`,text:r.filter(e=>t?(U[e]?.category??[]).some(e=>e.toLowerCase()===t):!0).map(e=>{let t=U[e]??{title:e,category:[]},n=t.category?.join(`, `)||`uncategorized`;return`${e}: ${t.title} [${n}]`}).join(`
|
|
278
278
|
`)||`No tools matched the filter.`}]}})),e.registerTool(`describe_tool`,{title:W(`describe_tool`).title,description:`Describe a specific active AI Kit tool using centralized metadata. Use this after list_tools when you need a tool title, categories, and annotations before calling it directly.`,inputSchema:{tool_name:R.string().describe(`The active tool name to describe`)},annotations:W(`describe_tool`).annotations},J(`describe_tool`,async({tool_name:e})=>{if(!r.includes(e))return q(`VALIDATION`,`Unknown or inactive tool: ${e}`);let t=U[e],n={name:e,title:t?.title??e,categories:t?.category??[],annotations:t?.annotations??{},note:`Call the tool directly after discovery. AI Kit does not expose an execute_tool proxy.`};return{content:[{type:`text`,text:JSON.stringify(n,null,2)}]}})),e.registerTool(`search_tools`,{title:W(`search_tools`).title,description:`Search active AI Kit tools by keyword across tool names, titles, and categories.`,inputSchema:{query:R.string().min(1).describe(`Keyword query to match against active tools`)},annotations:W(`search_tools`).annotations},J(`search_tools`,async({query:e})=>{let t=e.trim().toLowerCase(),n=r.filter(e=>{let n=U[e];return e.toLowerCase().includes(t)||n?.title.toLowerCase().includes(t)||(n?.category??[]).some(e=>e.toLowerCase().includes(t))}).map(e=>{let t=U[e]??{title:e,category:[]},n=t.category?.join(`, `)||`uncategorized`;return`${e}: ${t.title} [${n}]`});return{content:[{type:`text`,text:n.length>0?n.join(`
|
|
279
|
-
`):`No tools found matching "${e}"`}]}}))}const
|
|
280
|
-
`),`utf8`),
|
|
281
|
-
`);if(u&&a){let e=await G(a,{query:`onboard codebase conventions`});O+=K(e)}return{content:[{type:`text`,text:O}]}}catch(e){return
|
|
282
|
-
`)}]}}case`delete`:if(!t)throw Error(`name required for delete`);return{content:[{type:`text`,text:xt(t)?`Deleted workset "${t}".`:`Workset "${t}" not found.`}]};case`add`:{if(!t||!n)throw Error(`name and files required for add`);let e=tt(t,n);return{content:[{type:`text`,text:`Added to workset "${e.name}": now ${e.files.length} files.`}]}}case`remove`:{if(!t||!n)throw Error(`name and files required for remove`);let e=vn(t,n);return e?{content:[{type:`text`,text:`Removed from workset "${e.name}": now ${e.files.length} files.`}]}:{content:[{type:`text`,text:`Workset "${t}" not found.`}]}}}}catch(e){return
|
|
283
|
-
`)}]}}case`delete`:if(!n)throw Error(`key required for delete`);return{content:[{type:`text`,text:Pn(t,n)?`Deleted stash entry "${n}".`:`Stash entry "${n}" not found.`}]};case`clear`:{let e=Nn(t);return{content:[{type:`text`,text:`Cleared ${e} stash entr${e===1?`y`:`ies`}.`}]}}}}catch(e){return
|
|
284
|
-
`)}]}}case`latest`:{let e=ut(t,{label:n});return{content:[{type:`text`,text:e?
|
|
279
|
+
`):`No tools found matching "${e}"`}]}}))}const Qp=j(`server`),$p=ue(Xn),em={"@huggingface/transformers":`4.2.0`,"onnxruntime-common":`1.24.3`,"onnxruntime-node":`1.24.3`};function tm(e){return e.replace(/\\/g,`/`)}function nm(e){return process.platform===`win32`?e.replace(/\//g,Be):e}function rm(){return I(Le(le(import.meta.url)),`..`,`..`,`..`)}function im(e){return tm(e).includes(`/_npx/`)}function am(e){return/^(1|true)$/i.test(process.env.AIKIT_DISABLE_DEP_REPAIR??``)?!1:/^(1|true)$/i.test(process.env.AIKIT_ALLOW_DEP_REPAIR??``)?!0:im(e)}function om(e,t){let n=tm(e),r=`/node_modules/${t}/`,i=n.lastIndexOf(r);if(i<0)return null;let a=i+r.length-1,o=n.slice(0,a),s=o.search(/[A-Za-z]:\/|\//);return s<0?null:nm(o.slice(s))}function sm(e,t){if(!e)return em[t]??`latest`;try{return JSON.parse(P(F(e,`package.json`),`utf8`)).version??em[t]??`latest`}catch{return em[t]??`latest`}}function cm(e){let t=tm(e).toLowerCase();return/(cannot find module|cannot find package|module not found|err_module_not_found)/i.test(e)?t.includes(`@huggingface/transformers`)||t.includes(`transformers.node`)||t.includes(`onnxruntime-common`)||t.includes(`onnxruntime-node`):!1}function lm(e){if(!cm(e))return[];let t=tm(e).toLowerCase(),n=new Map;if(t.includes(`@huggingface/transformers`)){let t=om(e,`@huggingface/transformers`);n.set(`@huggingface/transformers`,`@huggingface/transformers@${sm(t,`@huggingface/transformers`)}`)}if(t.includes(`onnxruntime-common`)){let t=om(e,`onnxruntime-common`);n.set(`onnxruntime-common`,`onnxruntime-common@${sm(t,`onnxruntime-common`)}`)}if(t.includes(`onnxruntime-node`)){let t=om(e,`onnxruntime-node`);n.set(`onnxruntime-node`,`onnxruntime-node@${sm(t,`onnxruntime-node`)}`)}return Array.from(n.values())}function um(e){if(!/index\.js/i.test(e)||!tm(e).includes(`@huggingface`))return!1;let t=om(e,`@huggingface/transformers`);if(!t)return!1;let n=F(t,`index.js`),r=F(t,`dist`,`transformers.node.mjs`);return N(n)||!N(r)?!1:(Fe(n,[`// Auto-generated by AI Kit runtime dependency repair.`,`export * from './dist/transformers.node.mjs';`,`export { default } from './dist/transformers.node.mjs';`,``].join(`
|
|
280
|
+
`),`utf8`),Qp.info(`Auto-heal: created @huggingface/transformers index.js shim`,{path:n}),!0)}async function dm(e,t={}){let n=lm(e),r=t.packageRoot??rm(),i=um(e);if(n.length===0)return{attempted:i,repaired:i,packages:n,reason:i?`created transformer index shim`:`no missing runtime dependency detected`};if(!am(r))return{attempted:i,repaired:i,packages:n,reason:`runtime dependency auto-install disabled outside npx cache; set AIKIT_ALLOW_DEP_REPAIR=1 to enable`};let a=process.platform===`win32`?`npm.cmd`:`npm`,o=[`install`,`--no-save`,`--package-lock=false`,`--no-audit`,`--no-fund`,`--omit=dev`,`--prefer-online`,`--ignore-scripts`,...n];Qp.warn(`Auto-heal: repairing missing runtime dependencies`,{packages:n,packageRoot:r});try{return await $p(a,o,{cwd:r,timeout:t.timeoutMs??6e4,windowsHide:!0}),Qp.info(`Auto-heal: runtime dependency repair completed`,{packages:n,packageRoot:r}),{attempted:!0,repaired:!0,packages:n,reason:`npm install repair completed`}}catch(e){let t=e instanceof Error?e.message:String(e);return Qp.warn(`Auto-heal: runtime dependency repair failed`,{packages:n,packageRoot:r,...M(e)}),{attempted:!0,repaired:i,packages:n,reason:i?`created transformer shim but npm repair failed`:`npm repair failed`,error:t}}}const fm=j(`tools`);let pm=!1;function mm(e){let t=e instanceof Error?e.message:String(e);return cm(t)||/embedder worker|embedding worker|circuit breaker|timed out|killed|respawn|ipc_channel|epipe|econnreset/i.test(t)}async function hm(e,t,n){try{return await e.embedBatch(t,n)}catch(r){if((await dm(r instanceof Error?r.message:String(r))).repaired)return e.embedBatch(t,n);throw r}}async function gm(e,t,n){for(let r of n.steps)if(!(r.status!==`success`||!r.output))try{let i=we(n.path,12),a=`produced/onboard/${r.name}/${i}.md`,o=Je(`sha256`).update(r.output).digest(`hex`).slice(0,16),s=new Date().toISOString(),c=r.output.length>2e3?r.output.split(/(?=^## )/m).filter(e=>e.trim().length>0):[r.output],l=c.map((e,t)=>({id:Je(`sha256`).update(`${a}::${t}`).digest(`hex`).slice(0,16),content:e.trim(),sourcePath:a,contentType:`produced-knowledge`,chunkIndex:t,totalChunks:c.length,startLine:0,endLine:0,fileHash:o,indexedAt:s,origin:`produced`,tags:[`onboard`,r.name],category:`analysis`,version:1})),u=await hm(t,l.map(e=>e.content));await e.upsert(l,u)}catch(e){if(mm(e)){let t=e instanceof Error?e.message:String(e);he.instance().reportDegraded(`embedder`,t),fm.warn(`Auto-persist onboard disabled — embedder unavailable`,{stepName:r.name,...M(e)});return}fm.warn(`Auto-persist onboard step failed`,{stepName:r.name,...M(e)})}}async function _m(e,t,n){if(n.autoRemember?.length)for(let r of n.autoRemember)try{let n=Je(`sha256`).update(`onboard-remember::${r.title}`).digest(`hex`).slice(0,16),i=new Date().toISOString(),a={id:n,content:`# ${r.title}\n\n${r.content}`,sourcePath:`curated/onboard/${r.category}/${n}.md`,contentType:`curated`,chunkIndex:0,totalChunks:1,startLine:0,endLine:0,fileHash:Je(`sha256`).update(r.content).digest(`hex`).slice(0,16),indexedAt:i,origin:`curated`,tags:r.tags,category:r.category,version:1},[o]=await hm(t,[a.content]);await e.upsert([a],[o])}catch(e){if(mm(e)){let t=e instanceof Error?e.message:String(e);he.instance().reportDegraded(`embedder`,t),fm.warn(`Auto-persist remember disabled — embedder unavailable`,{title:r.title,...M(e)});return}fm.warn(`Auto-persist remember entry failed`,{title:r.title,...M(e)})}}function vm(e,t,n,r,i,a,o,s){let c=W(`onboard`);e.registerTool(`onboard`,{title:c.title,description:`Onboard a codebase: run all analyses (structure, deps, symbols, patterns, diagram) and persist to AI Kit memory + ~/.aikit/workspaces/. Also supports explore (context package), trace (BFS traversal), diff (impact analysis), and routes (framework detection) via dedicated modes. Output goes to ~/.aikit/workspaces/<name>/ — never inside the project.`,inputSchema:{path:R.string().describe(`Root path of the codebase to onboard`),mode:R.enum([`memory`,`generate`]).default(`generate`).describe(`Output mode: generate (default) = persist to AI Kit + write workspace files; memory = AI Kit vector store only`),out_dir:R.string().optional().describe(`Custom output directory (default: ~/.aikit/workspaces/<name>/onboard/)`),enrich:R.boolean().default(!0).describe(`Append curated knowledge and graph context to output. Adds ~150-250 tokens. Default true for planning tools — set false to save tokens when enrichment is not needed.`),explore:R.string().optional().describe(`Explore mode: given a topic, return entry points, related symbols, and code snippets as a single context package. Uses indexed knowledge from previous onboard.`),trace:R.string().optional().describe(`Trace mode: BFS traversal from a symbol. Returns callers and/or callees.`),direction:R.enum([`callers`,`callees`,`both`]).optional().default(`both`).describe(`Trace direction (default: both).`),maxDepth:R.number().min(1).max(10).optional().default(2).describe(`Trace max traversal depth (default: 2, max: 10).`),diff:R.union([R.boolean(),R.string()]).optional().describe(`Diff mode: analyze git diff for impact assessment. true = auto-detect, string = explicit diff content.`),routes:R.boolean().optional().describe(`Routes mode: detect web framework routes (Express, FastAPI, Django, NestJS).`),framework:R.enum([`express`,`fastify`,`nextjs`]).optional().describe(`Framework to scan for routes. Omit to detect all supported frameworks.`),update:R.boolean().optional().describe(`Incremental update mode: load existing index from ~/.aikit/workspaces/, re-extract changed files, merge.`),detail:R.enum([`summary`,`standard`,`full`]).optional().default(`standard`).describe(`Output detail level: summary (key concepts only), standard (recommended), full (all data).`),language:R.string().optional().describe(`Output language for localized content. Supported: en, zh, ja, ko, ru.`),llm_sampling:R.boolean().default(!1).optional().describe(`Enable LLM-based semantic enrichment (module summaries, architectural roles, tags). Uses the session LLM via MCP sampling.`)},annotations:c.annotations},J(`onboard`,async({path:e,mode:c,out_dir:l,enrich:u,explore:d,trace:f,direction:p,maxDepth:m,diff:h,routes:g,framework:_,update:v,detail:y,language:b,llm_sampling:x},S)=>{try{if(pm)return{content:[{type:`text`,text:`Onboard is already running. Please wait for it to complete before starting another.`}]};pm=!0,fm.info(`Starting onboard`,{path:e,mode:c,explore:d,trace:f,diff:h,routes:g,update:v});let C=await Qt({path:e,mode:c,outDir:l,explore:d,trace:f,direction:p,maxDepth:m,diff:typeof h==`string`?h:h===!0,routes:g,framework:_,update:v,detail:y,language:b,enrich:x??!1,llmCall:x&&o?.available?async(e,t)=>(await o.createMessage({prompt:e,systemPrompt:t,maxTokens:4e3,timeoutMs:6e4,modelPreferences:{intelligencePriority:.8,speedPriority:.5,costPriority:.3}})).text:void 0}),w=gl(S).createTask(`Onboard`,C.steps.length);for(let e=0;e<C.steps.length;e++){let t=C.steps[e];w.progress(e,`${t.name}: ${t.status}`)}w.complete(`Onboard complete: ${C.steps.filter(e=>e.status===`success`).length}/${C.steps.length} steps succeeded`),gm(t,n,C),C.autoRemember?.length&&_m(t,n,C).catch(e=>{fm.debug(`Auto-persist autoRemember failed`,M(e))});try{let e=I(Tn(C.path),de.l0Cards);ke(e,{recursive:!0});let t=new Map(C.steps.map(e=>[e.name,e.output])),n=Pt({workspaceName:C.path,structure:t.get(`structure`),entryPoints:t.get(`entry-points`)||t.get(`entry_points`),dependencies:t.get(`dependencies`),symbols:t.get(`symbols`)});Fe(F(e,$e),n,`utf-8`),fm.debug(`L0 workspace-core card generated from onboard`,{path:F(e,$e)});let i=r?.l0CardDir?I(r.l0CardDir,`..`):null,a=Tn(C.path);i&&a===i&&s?.notifyL0CardChanged().catch(()=>{})}catch(e){fm.debug(`Failed to generate L0 workspace-core card from onboard`,{error:M(e)})}i&&(i.onboardComplete=!0,i.onboardTimestamp=new Date().toISOString());let T=[`## Onboard Complete`,``,`**Path:** \`${C.path}\``,`**Mode:** ${C.mode}`,`**Duration:** ${C.totalDurationMs}ms`,``];C.outDir&&(T.push(`**Output directory:** \`${C.outDir}\``),T.push(``)),T.push(`### Analysis Results`,``);let E=[],D=[];for(let e of C.steps)e.status===`success`?E.push(`- ✓ **${e.name}** (${e.durationMs}ms) — ${e.output.length} chars`):D.push(`- ✗ **${e.name}** — ${e.error}`);T.push(...E),D.length>0&&T.push(``,`### Failed`,``,...D),T.push(``,`---`,``);for(let e of C.steps)e.status===`success`&&T.push(`### ${e.name}`,``,e.output,``,`---`,``);T.push(`_All results auto-saved to AI Kit memory._`,C.mode===`generate`?` Files written to \`${C.outDir}\`.`:``,' Next: Use `search` to query the knowledge, or `knowledge({ action: "remember", ... })` to add custom insights.');let O=T.join(`
|
|
281
|
+
`);if(u&&a){let e=await G(a,{query:`onboard codebase conventions`});O+=K(e)}return{content:[{type:`text`,text:O}]}}catch(e){return fm.error(`Onboard failed`,M(e)),q(`INTERNAL`,`Onboard failed: ${e instanceof Error?e.message:String(e)}`)}finally{pm=!1}}))}const ym=j(`tools:persistence`);function bm(e){let t=W(`workset`);e.registerTool(`workset`,{title:t.title,description:`Manage named file sets (worksets). Save, load, list, add/remove files. Worksets persist across sessions in the AI Kit state directory.`,inputSchema:{action:R.enum([`save`,`get`,`list`,`delete`,`add`,`remove`]).describe(`Operation to perform`),name:R.string().optional().describe(`Workset name (required for all except list)`),files:R.array(R.string()).optional().describe(`File paths (required for save, add, remove)`),description:R.string().optional().describe(`Description (for save)`)},annotations:t.annotations},J(`workset`,async({action:e,name:t,files:n,description:r})=>{try{switch(e){case`save`:{if(!t||!n)throw Error(`name and files required for save`);let e=Dn(t,n,{description:r});return{content:[{type:`text`,text:`Saved workset "${e.name}" with ${e.files.length} files.`}]}}case`get`:{if(!t)throw Error(`name required for get`);let e=Ft(t);return e?{content:[{type:`text`,text:JSON.stringify(e)}]}:{content:[{type:`text`,text:`Workset "${t}" not found.`}]}}case`list`:{let e=Xt();return e.length===0?{content:[{type:`text`,text:`No worksets.`}]}:{content:[{type:`text`,text:e.map(e=>`- **${e.name}** (${e.files.length} files) — ${e.description??`no description`}`).join(`
|
|
282
|
+
`)}]}}case`delete`:if(!t)throw Error(`name required for delete`);return{content:[{type:`text`,text:xt(t)?`Deleted workset "${t}".`:`Workset "${t}" not found.`}]};case`add`:{if(!t||!n)throw Error(`name and files required for add`);let e=tt(t,n);return{content:[{type:`text`,text:`Added to workset "${e.name}": now ${e.files.length} files.`}]}}case`remove`:{if(!t||!n)throw Error(`name and files required for remove`);let e=vn(t,n);return e?{content:[{type:`text`,text:`Removed from workset "${e.name}": now ${e.files.length} files.`}]}:{content:[{type:`text`,text:`Workset "${t}" not found.`}]}}}}catch(e){return ym.error(`Workset operation failed`,M(e)),q(`INTERNAL`,`Workset operation failed: ${e instanceof Error?e.message:String(e)}`)}}))}function xm(e,t){let n=W(`stash`);e.registerTool(`stash`,{title:n.title,description:`Persist and retrieve named values in the SQLite-backed state store for intermediate results between tool calls.`,inputSchema:{action:R.enum([`set`,`get`,`list`,`delete`,`clear`]).describe(`Operation to perform on the stash`),key:R.string().optional().describe(`Entry key for set/get/delete operations`),value:R.string().optional().describe(`String or JSON value for set operations`)},annotations:n.annotations},J(`stash`,async({action:e,key:n,value:r})=>{try{switch(e){case`set`:{if(!n)throw Error(`key required for set`);let e=Ln(t,n,Em(r??``));return{content:[{type:`text`,text:`Stored stash entry "${e.key}" (${e.type}) at ${e.storedAt}.`}]}}case`get`:{if(!n)throw Error(`key required for get`);let e=Fn(t,n);return{content:[{type:`text`,text:e?JSON.stringify(e):`Stash entry "${n}" not found.`}]}}case`list`:{let e=In(t);return{content:[{type:`text`,text:e.length===0?`Stash is empty.`:e.map(e=>`- ${e.key} (${e.type}) — ${e.storedAt}`).join(`
|
|
283
|
+
`)}]}}case`delete`:if(!n)throw Error(`key required for delete`);return{content:[{type:`text`,text:Pn(t,n)?`Deleted stash entry "${n}".`:`Stash entry "${n}" not found.`}]};case`clear`:{let e=Nn(t);return{content:[{type:`text`,text:`Cleared ${e} stash entr${e===1?`y`:`ies`}.`}]}}}}catch(e){return ym.error(`Stash operation failed`,M(e)),q(`INTERNAL`,`Stash operation failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Sm(e,t){let n=W(`checkpoint`);e.registerTool(`checkpoint`,{title:n.title,description:`Save and restore lightweight session checkpoints in the SQLite-backed state store for cross-session continuity. Legacy AI Kit checkpoint directories are imported automatically on first access.`,inputSchema:{action:R.enum([`save`,`load`,`list`,`latest`,`diff`,`history`,`gc`]).describe(`Checkpoint action to perform`),label:R.string().optional().describe(`Checkpoint label for save, or checkpoint id for load`),data:R.string().max(5e5).optional().describe(`JSON object string for save actions`),notes:R.string().max(1e4).optional().describe(`Optional notes for save actions`),from_id:R.string().optional().describe(`Checkpoint ID to diff FROM (for diff action)`),to_id:R.string().optional().describe(`Checkpoint ID to diff TO (for diff action)`),limit:R.number().min(1).max(50).optional().describe(`Max history entries to return`),keep_last:R.number().min(1).max(100).optional().describe(`Keep N most recent checkpoints per label (default: 10, for gc action)`),max_age_days:R.number().min(1).optional().describe(`Delete checkpoints older than N days (for gc action)`),dry_run:R.boolean().optional().describe(`Preview changes without deleting (default: true, for gc action)`)},annotations:n.annotations},J(`checkpoint`,async({action:e,label:n,data:r,notes:i,from_id:a,to_id:o,limit:s,keep_last:c,max_age_days:l,dry_run:u})=>{try{switch(e){case`save`:if(!n)throw Error(`label required for save`);return{content:[{type:`text`,text:Tm(pt(t,n,Dm(r),{notes:i}))}]};case`load`:{if(!n)throw Error(`label required for load`);let e=ft(t,n);return{content:[{type:`text`,text:e?Tm(e):`Checkpoint "${n}" not found.`}]}}case`list`:{let e=dt(t,{label:n,limit:s});return{content:[{type:`text`,text:e.length===0?`No checkpoints saved.`:e.map(e=>`- ${e.id} — ${e.label} (${e.createdAt})`).join(`
|
|
284
|
+
`)}]}}case`latest`:{let e=ut(t,{label:n});return{content:[{type:`text`,text:e?Tm(e):`No checkpoints saved.`}]}}case`diff`:{if(!a||!o)throw Error(`from_id and to_id required for diff`);let e=st(t,a,o);return e?{content:[{type:`text`,text:[`## Checkpoint Diff: ${a} → ${o}`,e.added.length?`**Added:** ${e.added.join(`, `)}`:``,e.removed.length?`**Removed:** ${e.removed.join(`, `)}`:``,e.modified.length?`**Modified:** ${e.modified.join(`, `)}`:``,!e.added.length&&!e.removed.length&&!e.modified.length?`No differences found.`:``].filter(Boolean).join(`
|
|
285
285
|
`)}]}:{content:[{type:`text`,text:`One or both checkpoints not found.`}]}}case`history`:{if(!n)throw Error(`label required for history`);let e=lt(t,n,{limit:s??20});return e.length===0?{content:[{type:`text`,text:`No history found for "${n}".`}]}:{content:[{type:`text`,text:`## History: ${n}\n${e.map(e=>`- ${e.sha?e.sha.slice(0,8):e.id} — ${e.createdAt}${e.label?` (${e.label})`:``}`).join(`
|
|
286
286
|
`)}`}]}}case`gc`:{let e=ct(t,{label:n,keepLast:c,maxAgeDays:l,dryRun:u});return{content:[{type:`text`,text:[`## Checkpoint GC${e.labels.length?`: ${e.labels.join(`, `)}`:``}`,`Deleted: ${e.deleted}`,`Kept: ${e.kept}`,`Mode: ${u??!0?`dry-run`:`delete`}`,e.deletedIds.length?`Deleted IDs: ${e.deletedIds.join(`, `)}`:`Deleted IDs: none`].join(`
|
|
287
|
-
`)}]}}}}catch(e){return
|
|
288
|
-
`)}function
|
|
289
|
-
`)}function
|
|
290
|
-
`)}\n\n---\n_${e.length} rules total. Use \`action: "update"\` to modify a rule._`}]}}if(e===`get`){if(!n)return q(`VALIDATION`,'`rule_id` is required for "get" action.');let e=t.getRule(n);return e?{content:[{type:`text`,text:Dm(e)}]}:q(`NOT_FOUND`,`Rule "${n}" not found.`)}if(e===`update`){if(!n||!r)return q(`VALIDATION`,'`rule_id` and `changes` are required for "update" action.');let e=t.updateRule(n,r);return e?{content:[{type:`text`,text:`${Dm(e)}\n\n---\n_Updated. Next: Use \`action: "list"\` to verify._`}]}:q(`NOT_FOUND`,`Rule "${n}" not found.`)}return e===`create`?i?{content:[{type:`text`,text:`${Dm(t.addRule(i))}\n\n---\n_Created. Next: Test classification with \`remember\`._`}]}:q(`VALIDATION`,'`new_rule` is required for "create" action.'):e===`delete`?n?t.deleteRule(n)?{content:[{type:`text`,text:`Deleted rule **${n}**.\n\n---\n_Next: Use \`action: "list"\` to verify._`}]}:q(`NOT_FOUND`,`Rule "${n}" not found.`):q(`VALIDATION`,'`rule_id` is required for "delete" action.'):q(`VALIDATION`,`Unknown action: ${e}`)}catch(e){return Em.error(`Policy update failed`,M(e)),q(`INTERNAL`,`Policy update failed: ${e instanceof Error?e.message:String(e)}`)}}))}const km=new Map;function Am(e){return e.replace(/[|\\{}()[\]^$+*?.]/g,`\\$&`)}function jm(e){let t=`(?=[^>]*\\bid=['"]${Am(e)}['"])`;return RegExp(`(<script\\b(?=[^>]*\\btype=['"]application\\/json['"])${t}[^>]*>)[\\s\\S]*?(<\/script>)`,`i`)}function Mm(e){km.has(e.id)&&console.warn(`[viewer-registry] Overwriting viewer template "${e.id}"`),km.set(e.id,e)}function Nm(e){return km.get(e)}function Pm(e){return typeof e==`string`&&km.has(e)}function Fm(){return[...km.values()]}function Im(e,t,n,r){let i=jm(n);if(!i.test(e))throw Error(`No <script type="application/json" id="${n}"> found in template`);let a=r?r(t):t,o=JSON.stringify(a??null).replace(/<\/script/gi,`<\\/script`).replace(/<script/gi,`\\u003Cscript`).replace(/-->/g,`--\\u003E`).replace(/<!--/g,`\\u003C!--`);return e.replace(i,`$1\n${o}\n$2`)}const Lm=import.meta.dirname??Le(le(import.meta.url)),Rm={type:`object`,properties:{title:{type:`string`},description:{type:`string`},layout:{type:`object`,properties:{direction:{type:`string`},spacing:{type:`number`},layerSpacing:{type:`number`}}},nodes:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},type:{type:`string`,enum:[`person`,`system`,`container`,`component`,`database`,`queue`,`external`,`boundary`]},label:{type:`string`},technology:{type:`string`},icon:{type:`string`},description:{type:`string`}},required:[`id`,`type`,`label`]}},edges:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`},label:{type:`string`},style:{type:`string`,enum:[`sync`,`async`,`dashed`,`dotted`,`solid`]}},required:[`source`,`target`]},default:[]}},required:[`nodes`]},zm={type:`object`,properties:{nodes:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},label:{type:`string`},type:{type:`string`,enum:[`start-end`,`manual`,`automated`,`integration`,`decision`,`prerequisite`]},description:{type:`string`}},required:[`id`,`label`]}},edges:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`},label:{type:`string`},type:{type:`string`,enum:[`standard`,`loop-back`,`exception`]}},required:[`source`,`target`]}}},required:[`nodes`]},Bm={type:`object`,properties:{title:{type:`string`},description:{type:`string`},phases:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},label:{type:`string`},outcome:{type:`string`},batches:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},order:{type:`number`},parallel:{type:`boolean`},label:{type:`string`},tasks:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},title:{type:`string`},agent:{type:`string`},files:{type:`array`,items:{type:`string`},default:[]},status:{type:`string`,enum:[`pending`,`in-progress`,`done`,`blocked`]},dependsOn:{type:`array`,items:{type:`string`},default:[]}},required:[`id`,`title`]},default:[]}},required:[`id`,`tasks`]},default:[]}},required:[`id`,`label`,`batches`]}}},required:[`phases`]};function Vm(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Hm(e,t){return Vm(t)?{...t,kind:e}:{kind:e}}function Um(e){let t=e===`canvas.html`?[F(Lm,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`canvas`,`index.html`),F(Lm,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`canvas`,`index.html`)]:[],n=C(`server`,[F(`viewers`,`dist`,e),F(`viewers`,e)]),r=[...t,...n?[n]:[],F(Lm,`..`,`..`,`..`,`viewers`,e),F(Lm,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`static`,e),F(Lm,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`dist`,e),F(Lm,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,e),F(Lm,`..`,`..`,`scaffold`,`general`,`viewers`,`dist`,e),F(Lm,`..`,`..`,`scaffold`,`general`,`viewers`,e),F(Lm,`..`,`viewers`,`dist`,e),F(Lm,`..`,`viewers`,e)];for(let e of r)try{return P(e,`utf8`)}catch{}throw Error(`Viewer HTML not found: ${e}. Searched: ${r.join(`, `)}`)}let Wm,Gm,Km,qm,Jm,Ym,Xm;function Zm(){return Wm??=Um(`c4-viewer.html`),Wm}function Qm(){return Gm??=Um(`tour-viewer.html`),Gm}function $m(){return Km??=Um(`canvas.html`),Km}function eh(){return qm??=Um(`architecture-static.html`),qm}function th(){return Jm??=Um(`process-flow-static.html`),Jm}function nh(){return Ym??=Um(`task-plan-static.html`),Ym}function rh(){return Xm??=Um(`code-review-viewer.html`),Xm}const ih={type:`object`,properties:{title:{type:`string`,description:`PR or review title`},repo:{type:`string`,description:`Repository identifier (e.g., owner/repo)`},author:{type:`string`,description:`Author display name`},date:{type:`string`,description:`Date or relative time string`},branch:{type:`string`,description:`Source branch name`},targetBranch:{type:`string`,default:`main`},description:{type:`string`,description:`PR or change description`},additions:{type:`number`,default:0},deletions:{type:`number`,default:0},summary:{type:`string`,description:`Overall review summary`},summaryTitle:{type:`string`,default:`Summary`},conclusion:{type:`array`,items:{type:`string`},description:`Conclusion paragraphs`},files:{type:`array`,items:{type:`object`,properties:{path:{type:`string`},additions:{type:`number`,default:0},deletions:{type:`number`,default:0},risk:{type:`string`,enum:[`safe`,`medium`,`attention`],default:`safe`},collapsed:{type:`boolean`,default:!0},diff:{type:`array`,items:{type:`object`,properties:{t:{type:`string`,enum:[`add`,`del`,`ctx`,`hunk`],default:`ctx`},n:{type:`string`,description:`Line number`},c:{type:`string`,description:`Code content`}}}},comments:{type:`array`,items:{type:`object`,properties:{line:{type:`number`},text:{type:`string`},blocking:{type:`boolean`,default:!1}}}}},required:[`path`]}}},required:[`files`]};function ah(){Mm({id:`c4@1`,label:`C4 Architecture Diagram`,description:`Interactive C4 architecture diagram with zoom, pan, and ELK auto-layout`,inputSchema:Rm,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:Zm}),Mm({id:`c4-static@1`,label:`C4 Architecture Diagram (Static)`,description:`Static SVG architecture diagram for inline rendering`,inputSchema:Rm,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:eh}),Mm({id:`tour@1`,label:`Code Tour Viewer`,description:`Interactive code tour with step navigation and dependency graph`,inputSchema:{type:`object`,properties:{title:{type:`string`},description:{type:`string`},estimatedTime:{type:`string`},steps:{type:`array`,items:{type:`object`,properties:{stepNumber:{type:`number`},id:{type:`string`},title:{type:`string`},file:{type:`string`},explanation:{type:`string`},description:{type:`string`},learnsConcept:{type:`string`},duration:{type:`string`},line:{type:`number`},code:{type:`string`}},required:[`id`,`title`]}},dependencies:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`}},required:[`source`,`target`]},default:[]}},required:[`steps`]},injectId:`tour-data`,supportedTransports:[`browser`],resolveHtml:Qm}),Mm({id:`process-flow-static@1`,label:`Process Flow Diagram (Static)`,description:`Static SVG process flow diagram for inline rendering`,inputSchema:zm,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:th}),Mm({id:`task-plan-static@1`,label:`Task Execution Plan (Static)`,description:`Static SVG task execution plan for inline rendering`,inputSchema:Bm,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:nh}),Mm({id:`process-flow@1`,label:`Process Flow Diagram (Interactive)`,description:`Interactive process flow diagram with ReactFlow`,inputSchema:zm,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:$m,transformData:e=>Hm(`process-flow`,e)}),Mm({id:`code-review@1`,label:`Code Review`,description:`Annotated code review with diff display, risk map, and review bubbles. Supports text selection annotations when used with actions.`,inputSchema:ih,injectId:`review-data`,supportedTransports:[`mcp-app`,`browser`],resolveHtml:rh})}function oh(){let e=new Br;for(let t of Ur.list())e.register(t);return e.register(Hr),e.register(qr),e.register(Jr),e.register(Wr),e}function sh(e,t){return e?.supportedTransports.includes(t)??!1}const ch=oh();function lh(e){if(e.template)return ch.get(e.template)}function uh(e){if((e.actions?.length??0)>0)return!0;if(e.template&&Pm(e.template)){let t=Nm(e.template);return t?.supportedTransports.includes(`browser`)===!0&&!t.supportedTransports.includes(`mcp-app`)}let t=lh(e);return sh(t,`browser`)&&!sh(t,`mcp-app`)}ah();const dh=new Map([{type:`markdown`,category:`content`,description:`Markdown content rendered with the marked parser.`,valueShape:`string`,relevantSkills:[`present`,`docs`]},{type:`code`,category:`content`,description:`Formatted code block rendered inside pre/code tags.`,valueShape:`string`,relevantSkills:[`present`,`docs`]},{type:`mermaid`,category:`visualization`,description:`Mermaid diagram source rendered in a mermaid pre block.`,valueShape:`string`,vendorScripts:[`mermaid`],relevantSkills:[`present`,`c4-architecture`,`docs`]},{type:`diagram`,category:`visualization`,description:`Structured diagram JSON rendered through the centralized diagram engine. Supports architecture, workflow, sequence, dataflow, and lifecycle types. Produces SVG with dark/light theming, export toolbar, and markdown output.`,vendorScripts:[`mermaid`],valueShape:`object (ArchitectureDiagram | WorkflowDiagram | SequenceDiagram | DataFlowDiagram | LifecycleDiagram)`,since:`1.0`,relevantSkills:[`present`,`c4-architecture`,`docs`,`onboard`],usageExample:`{
|
|
291
|
-
type: 'diagram',
|
|
287
|
+
`)}]}}}}catch(e){return ym.error(`Checkpoint failed`,M(e)),q(`INTERNAL`,`Checkpoint failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Cm(e){let t=W(`lane`);e.registerTool(`lane`,{title:t.title,description:`Manage verified lanes — isolated file copies for parallel exploration. Also provides advisory write-intent leases for multi-agent coordination.`,inputSchema:{action:R.enum([`create`,`list`,`status`,`diff`,`merge`,`discard`,`lease`,`unlease`,`leases`]).describe(`Lane action to perform`),name:R.string().optional().describe(`Lane name (required for create/status/diff/merge/discard)`),files:R.array(R.string()).optional().describe(`File paths to copy into the lane (required for create)`),agent:R.string().optional().describe(`Agent identifier (required for lease)`),intent:R.string().optional().describe(`What the agent plans to do (required for lease)`),id:R.string().optional().describe(`Lease ID (required for unlease)`),symbols:R.array(R.string()).optional().describe(`Symbol names within files (optional for lease)`),ttl_minutes:R.number().optional().describe(`Lease TTL in minutes (default 10, optional for lease)`)},annotations:t.annotations},J(`lane`,async({action:e,name:t,files:n,agent:r,intent:i,id:a,symbols:o,ttl_minutes:s})=>{try{switch(e){case`create`:{if(!t)throw Error(`name is required for create`);if(!n||n.length===0)throw Error(`files are required for create`);let e=Ht(t,n);return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`list`:return{content:[{type:`text`,text:JSON.stringify(Gt())}]};case`status`:if(!t)throw Error(`name is required for status`);return{content:[{type:`text`,text:JSON.stringify(qt(t))}]};case`diff`:if(!t)throw Error(`name is required for diff`);return{content:[{type:`text`,text:JSON.stringify(Ut(t))}]};case`merge`:if(!t)throw Error(`name is required for merge`);return{content:[{type:`text`,text:JSON.stringify(Kt(t))}]};case`discard`:if(!t)throw Error(`name is required for discard`);return{content:[{type:`text`,text:JSON.stringify({discarded:Wt(t)})}]};case`lease`:{if(!r)throw Error(`agent is required for lease`);if(!n||n.length===0)throw Error(`files are required for lease`);if(!i)throw Error(`intent is required for lease`);let e=et({agent:r,files:n,intent:i,symbols:o,ttl_minutes:s});return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`unlease`:{if(!a)throw Error(`id is required for unlease`);let e=_n({id:a});return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`leases`:{let e=Jt({agent:r});return{content:[{type:`text`,text:JSON.stringify(e)}]}}}}catch(e){return ym.error(`Lane action failed`,M(e)),q(`INTERNAL`,`Lane action failed: ${e instanceof Error?e.message:String(e)}`)}}))}function wm(e){let t=W(`queue`);e.registerTool(`queue`,{title:t.title,description:`Manage task queues with optional DAG dependencies. Push items with dependsOn for wave-based execution. Take next, mark done/failed, list queues.`,inputSchema:{action:R.enum([`create`,`push`,`next`,`done`,`fail`,`get`,`list`,`clear`,`delete`,`dag`]).describe(`Queue action`),name:R.string().optional().describe(`Queue name (required for most actions)`),title:R.string().optional().describe(`Item title (required for push)`),id:R.string().optional().describe(`Item ID (required for done/fail)`),data:R.unknown().optional().describe(`Arbitrary data to attach to a queue item`),error:R.string().optional().describe(`Error message (required for fail)`),dependsOn:R.array(R.string()).optional().describe(`Item IDs this task depends on. Dependent items start as blocked until deps complete.`)},annotations:t.annotations},J(`queue`,async({action:e,name:t,title:n,id:r,data:i,error:a,dependsOn:o})=>{try{switch(e){case`create`:if(!t)throw Error(`name is required for create`);return{content:[{type:`text`,text:JSON.stringify(sn(t))}]};case`push`:if(!t)throw Error(`name is required for push`);if(!n)throw Error(`title is required for push`);return{content:[{type:`text`,text:JSON.stringify(hn(t,n,i,void 0,o))}]};case`next`:{if(!t)throw Error(`name is required for next`);let e=mn(t);return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`done`:if(!t)throw Error(`name is required for done`);if(!r)throw Error(`id is required for done`);return{content:[{type:`text`,text:JSON.stringify(un(t,r))}]};case`fail`:if(!t)throw Error(`name is required for fail`);if(!r)throw Error(`id is required for fail`);if(!a)throw Error(`error is required for fail`);return{content:[{type:`text`,text:JSON.stringify(dn(t,r,a))}]};case`get`:if(!t)throw Error(`name is required for get`);return{content:[{type:`text`,text:JSON.stringify(fn(t))}]};case`list`:return{content:[{type:`text`,text:JSON.stringify(pn())}]};case`clear`:if(!t)throw Error(`name is required for clear`);return{content:[{type:`text`,text:JSON.stringify({cleared:on(t)})}]};case`delete`:if(!t)throw Error(`name is required for delete`);return{content:[{type:`text`,text:JSON.stringify({deleted:ln(t)})}]};case`dag`:if(!t)throw Error(`name is required for dag`);return{content:[{type:`text`,text:JSON.stringify(cn(t))}]}}}catch(e){return ym.error(`Queue action failed`,M(e)),q(`INTERNAL`,`Queue action failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Tm(e){let t=[e.id,`Label: ${e.label}`,`Created: ${e.createdAt}`];return e.notes&&t.push(`Notes: ${e.notes}`),t.push(``,`Data:`,JSON.stringify(e.data)),t.join(`
|
|
288
|
+
`)}function Em(e){let t=e.trim();if(!t)return``;try{return JSON.parse(t)}catch{return e}}function Dm(e){let t=e?.trim();if(!t)return{};let n;try{n=JSON.parse(t)}catch{throw Error(`data must be a valid JSON object string`)}if(!n||typeof n!=`object`||Array.isArray(n))throw Error(`data must be a JSON object string`);return n}const Om=j(`tools`);function km(e){let t=[`## Rule: ${e.id}`,``,`- **Status**: ${e.enabled?`enabled`:`disabled`}`,`- **Description**: ${e.description??`—`}`,`- **Category**: ${e.category??`—`}`,`- **Push weight**: ${e.pushWeight??`—`}`];return e.patterns?.length&&t.push(`- **Patterns**: ${e.patterns.join(`, `)}`),e.examples?.length&&t.push(`- **Examples**: ${e.examples.join(`, `)}`),t.join(`
|
|
289
|
+
`)}function Am(e,t){let n=W(`er_update_policy`);e.registerTool(`er_update_policy`,{title:n.title,description:`Manage ER push classification rules. Supports listing, updating, creating, and deleting rules that determine when knowledge should be pushed to Enterprise RAG.`,inputSchema:{action:R.enum([`list`,`get`,`update`,`create`,`delete`]).describe(`Action to perform on classification rules`),rule_id:R.string().optional().describe(`Rule ID (required for get, update, delete)`),changes:R.object({patterns:R.array(R.string()).optional(),category:R.string().optional(),pushWeight:R.number().min(0).max(1).optional(),description:R.string().optional(),examples:R.array(R.string()).optional(),enabled:R.boolean().optional()}).optional().describe(`Changes to apply (for update action)`),new_rule:R.object({id:R.string().regex(/^[a-z][a-z0-9-]*$/),patterns:R.array(R.string()).min(1),category:R.string(),pushWeight:R.number().min(0).max(1),description:R.string(),examples:R.array(R.string()).default([]),enabled:R.boolean().default(!0)}).optional().describe(`New rule definition (for create action)`)},annotations:n.annotations},J(`er_update_policy`,async({action:e,rule_id:n,changes:r,new_rule:i})=>{try{if(e===`list`){let e=t.getRules();return{content:[{type:`text`,text:`## Classification Rules\n\n${e.map(e=>`- **${e.id}** (${e.enabled?`enabled`:`disabled`}) — ${e.description}\n Category: ${e.category} | Weight: ${e.pushWeight} | Patterns: ${e.patterns.join(`, `)}`).join(`
|
|
290
|
+
`)}\n\n---\n_${e.length} rules total. Use \`action: "update"\` to modify a rule._`}]}}if(e===`get`){if(!n)return q(`VALIDATION`,'`rule_id` is required for "get" action.');let e=t.getRule(n);return e?{content:[{type:`text`,text:km(e)}]}:q(`NOT_FOUND`,`Rule "${n}" not found.`)}if(e===`update`){if(!n||!r)return q(`VALIDATION`,'`rule_id` and `changes` are required for "update" action.');let e=t.updateRule(n,r);return e?{content:[{type:`text`,text:`${km(e)}\n\n---\n_Updated. Next: Use \`action: "list"\` to verify._`}]}:q(`NOT_FOUND`,`Rule "${n}" not found.`)}return e===`create`?i?{content:[{type:`text`,text:`${km(t.addRule(i))}\n\n---\n_Created. Next: Test classification with \`remember\`._`}]}:q(`VALIDATION`,'`new_rule` is required for "create" action.'):e===`delete`?n?t.deleteRule(n)?{content:[{type:`text`,text:`Deleted rule **${n}**.\n\n---\n_Next: Use \`action: "list"\` to verify._`}]}:q(`NOT_FOUND`,`Rule "${n}" not found.`):q(`VALIDATION`,'`rule_id` is required for "delete" action.'):q(`VALIDATION`,`Unknown action: ${e}`)}catch(e){return Om.error(`Policy update failed`,M(e)),q(`INTERNAL`,`Policy update failed: ${e instanceof Error?e.message:String(e)}`)}}))}const jm=new Map;function Mm(e){return e.replace(/[|\\{}()[\]^$+*?.]/g,`\\$&`)}function Nm(e){let t=`(?=[^>]*\\bid=['"]${Mm(e)}['"])`;return RegExp(`(<script\\b(?=[^>]*\\btype=['"]application\\/json['"])${t}[^>]*>)[\\s\\S]*?(<\/script>)`,`i`)}function Pm(e){jm.has(e.id)&&console.warn(`[viewer-registry] Overwriting viewer template "${e.id}"`),jm.set(e.id,e)}function Fm(e){return jm.get(e)}function Im(e){return typeof e==`string`&&jm.has(e)}function Lm(){return[...jm.values()]}function Rm(e,t,n,r){let i=Nm(n);if(!i.test(e))throw Error(`No <script type="application/json" id="${n}"> found in template`);let a=r?r(t):t,o=JSON.stringify(a??null).replace(/<\/script/gi,`<\\/script`).replace(/<script/gi,`\\u003Cscript`).replace(/-->/g,`--\\u003E`).replace(/<!--/g,`\\u003C!--`);return e.replace(i,`$1\n${o}\n$2`)}const zm=import.meta.dirname??Le(le(import.meta.url)),Bm={type:`object`,properties:{title:{type:`string`},description:{type:`string`},layout:{type:`object`,properties:{direction:{type:`string`},spacing:{type:`number`},layerSpacing:{type:`number`}}},nodes:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},type:{type:`string`,enum:[`person`,`system`,`container`,`component`,`database`,`queue`,`external`,`boundary`]},label:{type:`string`},technology:{type:`string`},icon:{type:`string`},description:{type:`string`}},required:[`id`,`type`,`label`]}},edges:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`},label:{type:`string`},style:{type:`string`,enum:[`sync`,`async`,`dashed`,`dotted`,`solid`]}},required:[`source`,`target`]},default:[]}},required:[`nodes`]},Vm={type:`object`,properties:{nodes:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},label:{type:`string`},type:{type:`string`,enum:[`start-end`,`manual`,`automated`,`integration`,`decision`,`prerequisite`]},description:{type:`string`}},required:[`id`,`label`]}},edges:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`},label:{type:`string`},type:{type:`string`,enum:[`standard`,`loop-back`,`exception`]}},required:[`source`,`target`]}}},required:[`nodes`]},Hm={type:`object`,properties:{title:{type:`string`},description:{type:`string`},phases:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},label:{type:`string`},outcome:{type:`string`},batches:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},order:{type:`number`},parallel:{type:`boolean`},label:{type:`string`},tasks:{type:`array`,items:{type:`object`,properties:{id:{type:`string`},title:{type:`string`},agent:{type:`string`},files:{type:`array`,items:{type:`string`},default:[]},status:{type:`string`,enum:[`pending`,`in-progress`,`done`,`blocked`]},dependsOn:{type:`array`,items:{type:`string`},default:[]}},required:[`id`,`title`]},default:[]}},required:[`id`,`tasks`]},default:[]}},required:[`id`,`label`,`batches`]}}},required:[`phases`]};function Um(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Wm(e,t){return Um(t)?{...t,kind:e}:{kind:e}}function Gm(e){let t=e===`canvas.html`?[F(zm,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`canvas`,`index.html`),F(zm,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`canvas`,`index.html`)]:[],n=C(`server`,[F(`viewers`,`dist`,e),F(`viewers`,e)]),r=[...t,...n?[n]:[],F(zm,`..`,`..`,`..`,`viewers`,e),F(zm,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`static`,e),F(zm,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`dist`,e),F(zm,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,e),F(zm,`..`,`..`,`scaffold`,`general`,`viewers`,`dist`,e),F(zm,`..`,`..`,`scaffold`,`general`,`viewers`,e),F(zm,`..`,`viewers`,`dist`,e),F(zm,`..`,`viewers`,e)];for(let e of r)try{return P(e,`utf8`)}catch{}throw Error(`Viewer HTML not found: ${e}. Searched: ${r.join(`, `)}`)}let Km,qm,Jm,Ym,Xm,Zm,Qm;function $m(){return Km??=Gm(`c4-viewer.html`),Km}function eh(){return qm??=Gm(`tour-viewer.html`),qm}function th(){return Jm??=Gm(`canvas.html`),Jm}function nh(){return Ym??=Gm(`architecture-static.html`),Ym}function rh(){return Xm??=Gm(`process-flow-static.html`),Xm}function ih(){return Zm??=Gm(`task-plan-static.html`),Zm}function ah(){return Qm??=Gm(`code-review-viewer.html`),Qm}const oh={type:`object`,properties:{title:{type:`string`,description:`PR or review title`},repo:{type:`string`,description:`Repository identifier (e.g., owner/repo)`},author:{type:`string`,description:`Author display name`},date:{type:`string`,description:`Date or relative time string`},branch:{type:`string`,description:`Source branch name`},targetBranch:{type:`string`,default:`main`},description:{type:`string`,description:`PR or change description`},additions:{type:`number`,default:0},deletions:{type:`number`,default:0},summary:{type:`string`,description:`Overall review summary`},summaryTitle:{type:`string`,default:`Summary`},conclusion:{type:`array`,items:{type:`string`},description:`Conclusion paragraphs`},files:{type:`array`,items:{type:`object`,properties:{path:{type:`string`},additions:{type:`number`,default:0},deletions:{type:`number`,default:0},risk:{type:`string`,enum:[`safe`,`medium`,`attention`],default:`safe`},collapsed:{type:`boolean`,default:!0},diff:{type:`array`,items:{type:`object`,properties:{t:{type:`string`,enum:[`add`,`del`,`ctx`,`hunk`],default:`ctx`},n:{type:`string`,description:`Line number`},c:{type:`string`,description:`Code content`}}}},comments:{type:`array`,items:{type:`object`,properties:{line:{type:`number`},text:{type:`string`},blocking:{type:`boolean`,default:!1}}}}},required:[`path`]}}},required:[`files`]};function sh(){Pm({id:`c4@1`,label:`C4 Architecture Diagram`,description:`Interactive C4 architecture diagram with zoom, pan, and ELK auto-layout`,inputSchema:Bm,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:$m}),Pm({id:`c4-static@1`,label:`C4 Architecture Diagram (Static)`,description:`Static SVG architecture diagram for inline rendering`,inputSchema:Bm,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:nh}),Pm({id:`tour@1`,label:`Code Tour Viewer`,description:`Interactive code tour with step navigation and dependency graph`,inputSchema:{type:`object`,properties:{title:{type:`string`},description:{type:`string`},estimatedTime:{type:`string`},steps:{type:`array`,items:{type:`object`,properties:{stepNumber:{type:`number`},id:{type:`string`},title:{type:`string`},file:{type:`string`},explanation:{type:`string`},description:{type:`string`},learnsConcept:{type:`string`},duration:{type:`string`},line:{type:`number`},code:{type:`string`}},required:[`id`,`title`]}},dependencies:{type:`array`,items:{type:`object`,properties:{source:{type:`string`},target:{type:`string`}},required:[`source`,`target`]},default:[]}},required:[`steps`]},injectId:`tour-data`,supportedTransports:[`browser`],resolveHtml:eh}),Pm({id:`process-flow-static@1`,label:`Process Flow Diagram (Static)`,description:`Static SVG process flow diagram for inline rendering`,inputSchema:Vm,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:rh}),Pm({id:`task-plan-static@1`,label:`Task Execution Plan (Static)`,description:`Static SVG task execution plan for inline rendering`,inputSchema:Hm,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:ih}),Pm({id:`process-flow@1`,label:`Process Flow Diagram (Interactive)`,description:`Interactive process flow diagram with ReactFlow`,inputSchema:Vm,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:th,transformData:e=>Wm(`process-flow`,e)}),Pm({id:`code-review@1`,label:`Code Review`,description:`Annotated code review with diff display, risk map, and review bubbles. Supports text selection annotations when used with actions.`,inputSchema:oh,injectId:`review-data`,supportedTransports:[`mcp-app`,`browser`],resolveHtml:ah})}function ch(){let e=new Br;for(let t of Ur.list())e.register(t);return e.register(Hr),e.register(qr),e.register(Jr),e.register(Wr),e}function lh(e,t){return e?.supportedTransports.includes(t)??!1}const uh=ch();function dh(e){if(e.template)return uh.get(e.template)}function fh(e){if((e.actions?.length??0)>0)return!0;if(e.template&&Im(e.template)){let t=Fm(e.template);return t?.supportedTransports.includes(`browser`)===!0&&!t.supportedTransports.includes(`mcp-app`)}let t=dh(e);return lh(t,`browser`)&&!lh(t,`mcp-app`)}sh();const ph=new Map([{type:`markdown`,category:`content`,description:`Markdown content rendered with the marked parser.`,valueShape:`string`,relevantSkills:[`present`,`docs`]},{type:`code`,category:`content`,description:`Formatted code block rendered inside pre/code tags.`,valueShape:`string`,relevantSkills:[`present`,`docs`]},{type:`mermaid`,category:`visualization`,description:`Mermaid diagram source rendered in a mermaid pre block.`,valueShape:`string`,vendorScripts:[`mermaid`],relevantSkills:[`present`,`c4-architecture`,`docs`]},{type:`architecture-diagram`,category:`visualization`,description:`Architecture diagram with positioned components, connections, and boundary groups. Produces SVG with mermaid rendering.`,vendorScripts:[`mermaid`],valueShape:`object ({ components, connections, boundaries? })`,since:`1.0`,relevantSkills:[`present`,`c4-architecture`,`onboard`],usageExample:`{
|
|
291
|
+
type: 'architecture-diagram',
|
|
292
292
|
value: {
|
|
293
|
-
schema_version: 1,
|
|
294
|
-
diagram_type: 'architecture',
|
|
295
|
-
meta: { title: 'System Architecture' },
|
|
296
293
|
components: [
|
|
297
|
-
{ id: 'api',
|
|
298
|
-
{ id: 'web',
|
|
294
|
+
{ id: 'api', label: 'API Server', type: 'backend' },
|
|
295
|
+
{ id: 'web', label: 'Web App', type: 'frontend' }
|
|
299
296
|
],
|
|
300
297
|
connections: [
|
|
301
298
|
{ from: 'web', to: 'api', label: 'HTTPS' }
|
|
302
299
|
]
|
|
303
300
|
}
|
|
304
|
-
}`},{type:`table`,category:`data`,description:`Tabular data rendered from records or explicit headers and rows.`,valueShape:`Record<string, unknown>[] | { headers: string[]; rows: unknown[][] }`,relevantSkills:[`present`,`docs`]},{type:`metrics`,category:`data`,description:`Metric cards showing label/value pairs with optional trend and status.`,valueShape:`Array<{ label: string; value: string | number; trend?: string | number; status?: string }>`,relevantSkills:[`present`]},{type:`cards`,category:`visualization`,description:`Card grid for titled items with optional body, badge, and status.`,valueShape:`Array<{ title: string; body?: string; badge?: string; status?: string; description?: string }>`,relevantSkills:[`present`,`docs`]},{type:`tree`,category:`visualization`,description:`Hierarchical object or name/children tree rendered recursively.`,valueShape:`{ name: string; children?: unknown[] } | Record<string, unknown>`,relevantSkills:[`present`]},{type:`graph`,category:`visualization`,description:`Node and edge graph rendered as a Mermaid flow graph in HTML mode.`,valueShape:`{ nodes: Array<{ id: string; label?: string }>; edges: Array<{ from: string; to: string; label?: string }> }`,vendorScripts:[`mermaid`],relevantSkills:[`present`,`c4-architecture`]},{type:`chart`,category:`data`,description:`Structured chart definition rendered as SVG.`,valueShape:`{ chartType: string; data: Record<string, unknown>[]; xKey: string; yKeys: string[] }`,relevantSkills:[`present`]},{type:`timeline`,category:`interactive`,description:`Timeline entries rendered as a vertical sequence of events.`,valueShape:`Array<{ title: string; description?: string; timestamp?: string; status?: string }>`,relevantSkills:[`present`]},{type:`checklist`,category:`interactive`,description:`Checklist items with boolean checked state.`,valueShape:`Array<{label, checked}> | {items: Array<{label, checked}>}`,relevantSkills:[`present`]},{type:`comparison`,category:`interactive`,description:`Side-by-side comparison columns with titled item lists.`,valueShape:`Array<{title, items}> | {columns: Array<{title, items}>}`,relevantSkills:[`present`]},{type:`status-board`,category:`interactive`,description:`Status categories containing labeled status items.`,valueShape:`Array<{category, items}> | {items: Array<{category, items}>}`,relevantSkills:[`present`]},{type:`prompt`,category:`interactive`,description:`Prompt payload rendered through the prompt display helper.`,valueShape:`unknown`,relevantSkills:[`present`]},{type:`progress`,category:`interactive`,description:`Progress bar with current value and optional maximum.`,valueShape:`{label, value, max?} | {items: Array<{label, value, max?, color?}>}`,relevantSkills:[`present`]},{type:`docs-browser`,category:`interactive`,description:`Documentation file list with inline content previews for chat-safe rendering.`,valueShape:`{ files: Array<{ path: string; title?: string; content?: string; status?: "current" | "stale" | "missing" }>; title?: string }`,relevantSkills:[`present`,`docs`],usageExample:`{
|
|
301
|
+
}`},{type:`workflow-diagram`,category:`visualization`,description:`Workflow/pipeline diagram with lane-based columns, typed nodes, and edges. Produces SVG with mermaid rendering.`,vendorScripts:[`mermaid`],valueShape:`object ({ lanes, nodes, edges })`,since:`1.0`,relevantSkills:[`present`,`docs`]},{type:`sequence-diagram`,category:`visualization`,description:`Sequence diagram with participants and time-ordered messages. Produces SVG with mermaid rendering.`,vendorScripts:[`mermaid`],valueShape:`object ({ participants, messages })`,since:`1.0`,relevantSkills:[`present`,`docs`]},{type:`dataflow-diagram`,category:`visualization`,description:`Data flow diagram with stage-based columns, nodes, and classification-colored edges. Produces SVG with mermaid rendering.`,vendorScripts:[`mermaid`],valueShape:`object ({ stages, nodes, flows })`,since:`1.0`,relevantSkills:[`present`,`onboard`]},{type:`lifecycle-diagram`,category:`visualization`,description:`Lifecycle state machine with lanes, states, and transitions. Produces SVG with mermaid rendering.`,vendorScripts:[`mermaid`],valueShape:`object ({ lanes, states, transitions })`,since:`1.0`,relevantSkills:[`present`,`docs`]},{type:`table`,category:`data`,description:`Tabular data rendered from records or explicit headers and rows.`,valueShape:`Record<string, unknown>[] | { headers: string[]; rows: unknown[][] }`,relevantSkills:[`present`,`docs`]},{type:`metrics`,category:`data`,description:`Metric cards showing label/value pairs with optional trend and status.`,valueShape:`Array<{ label: string; value: string | number; trend?: string | number; status?: string }>`,relevantSkills:[`present`]},{type:`cards`,category:`visualization`,description:`Card grid for titled items with optional body, badge, and status.`,valueShape:`Array<{ title: string; body?: string; badge?: string; status?: string; description?: string }>`,relevantSkills:[`present`,`docs`]},{type:`tree`,category:`visualization`,description:`Hierarchical object or name/children tree rendered recursively.`,valueShape:`{ name: string; children?: unknown[] } | Record<string, unknown>`,relevantSkills:[`present`]},{type:`graph`,category:`visualization`,description:`Node and edge graph rendered as a Mermaid flow graph in HTML mode.`,valueShape:`{ nodes: Array<{ id: string; label?: string }>; edges: Array<{ from: string; to: string; label?: string }> }`,vendorScripts:[`mermaid`],relevantSkills:[`present`,`c4-architecture`]},{type:`chart`,category:`data`,description:`Structured chart definition rendered as SVG.`,valueShape:`{ chartType: string; data: Record<string, unknown>[]; xKey: string; yKeys: string[] }`,relevantSkills:[`present`]},{type:`timeline`,category:`interactive`,description:`Timeline entries rendered as a vertical sequence of events.`,valueShape:`Array<{ title: string; description?: string; timestamp?: string; status?: string }>`,relevantSkills:[`present`]},{type:`checklist`,category:`interactive`,description:`Checklist items with boolean checked state.`,valueShape:`Array<{label, checked}> | {items: Array<{label, checked}>}`,relevantSkills:[`present`]},{type:`comparison`,category:`interactive`,description:`Side-by-side comparison columns with titled item lists.`,valueShape:`Array<{title, items}> | {columns: Array<{title, items}>}`,relevantSkills:[`present`]},{type:`status-board`,category:`interactive`,description:`Status categories containing labeled status items.`,valueShape:`Array<{category, items}> | {items: Array<{category, items}>}`,relevantSkills:[`present`]},{type:`prompt`,category:`interactive`,description:`Prompt payload rendered through the prompt display helper.`,valueShape:`unknown`,relevantSkills:[`present`]},{type:`progress`,category:`interactive`,description:`Progress bar with current value and optional maximum.`,valueShape:`{label, value, max?} | {items: Array<{label, value, max?, color?}>}`,relevantSkills:[`present`]},{type:`docs-browser`,category:`interactive`,description:`Documentation file list with inline content previews for chat-safe rendering.`,valueShape:`{ files: Array<{ path: string; title?: string; content?: string; status?: "current" | "stale" | "missing" }>; title?: string }`,relevantSkills:[`present`,`docs`],usageExample:`{
|
|
305
302
|
type: 'docs-browser',
|
|
306
303
|
value: {
|
|
307
304
|
title: 'Project Docs',
|
|
@@ -310,7 +307,7 @@ None.`:`### Stale Lessons\n${u.map(e=>`- **${e.title}** (\`${e.path}\`) — effe
|
|
|
310
307
|
{ path: 'docs/api.md', title: 'API Reference', status: 'stale' },
|
|
311
308
|
],
|
|
312
309
|
},
|
|
313
|
-
}`},{type:`text`,category:`content`,description:`Plain text content rendered through the markdown parser.`,valueShape:`string`},{type:`heading`,category:`content`,description:`Single heading with configurable level from h1 to h6.`,valueShape:`string`},{type:`paragraph`,category:`content`,description:`Single paragraph rendered inside a p tag.`,valueShape:`string`},{type:`separator`,category:`layout`,description:`Horizontal rule used to separate adjacent blocks.`,valueShape:`undefined`},{type:`actions`,category:`layout`,description:`Action bar containing button and select action definitions.`,valueShape:`Array<{ type: string; id: string; label: string; variant?: string; options?: Array<string | { label: string; value: string }> }>`},{type:`diff`,category:`content`,description:`Diff view with +/- lines for showing changes between text.`,valueShape:`string | { content: string } | { before: string; after: string }`},{type:`finding`,category:`content`,description:`Finding with severity pill showing title, severity, and detail.`,valueShape:`{ title?: string; severity?: string; detail?: unknown }`},{type:`kv`,category:`data`,description:`Key-value pairs rendered as labeled entries.`,valueShape:`Array<{ key: string; value: unknown }> | Record<string, unknown>`},{type:`tags`,category:`data`,description:`Tag pills rendered with optional tone/color.`,valueShape:`Array<string | { text?: string; label?: string; status?: string; tone?: string; color?: string }> | { items: Array<...> }`},{type:`list`,category:`content`,description:`Bullet list items rendered as an unordered list.`,valueShape:`string[]`},{type:`lifecycle-flow`,category:`visualization`,description:`SVG flow diagram with labeled steps, edges, and status colors.`,valueShape:`{ title?: string; steps: Array<{ id: string; label: string; type?: string; status?: string; description?: string }>; edges?: Array<{ from: string; to: string; label?: string }> }`},{type:`component-detail`,category:`visualization`,description:`Component detail view with name, type, technology, responsibilities, interfaces, dependencies, metrics, and code links.`,valueShape:`{ name: string; description?: string; type?: string; technology?: string; responsibilities?: string[]; interfaces?: Array<{ name: string; type: string; description?: string }>; dependencies?: Array<{ name: string; relationship?: string }>; metrics?: Record<string, string | number>; codeLinks?: Array<{ href: string; label: string }> }`},{type:`data-table-schema`,category:`data`,description:`Schema table with field names, types, constraints, and indexes.`,valueShape:`{ name: string; description?: string; fields: Array<{ name: string; type: string; required?: boolean; default?: unknown; constraints?: string[]; description?: string }>; indexes?: Array<{ name: string; columns: string[]; unique?: boolean }> }`},{type:`annotation`,category:`interactive`,description:`Annotation groups with COMMENT, DELETION, and GLOBAL_COMMENT types.`,valueShape:`Array<{ id: string; type: "COMMENT" | "DELETION" | "GLOBAL_COMMENT"; body: string; author?: string; createdAt?: string }>`},{type:`approval`,category:`interactive`,description:`Approval widget with radio options and optional comment textarea.`,valueShape:`{ prompt: string; options: Array<{ id: string; label: string; description?: string }>; requireComment?: boolean }`},{type:`docs-hub`,category:`content`,description:`Doc hub card grid with titled pages, descriptions, categories, and statuses.`,valueShape:`{ title?: string; description?: string; pages?: Array<{ title: string; description?: string; href?: string; icon?: string; category?: string; status?: "draft" | "published" | "deprecated" }> }`}].map(e=>[e.type,{...e}]));function fh(){let e={};for(let[t,n]of dh)n.vendorScripts?.length&&(e[t]=n.vendorScripts);return e}const X={TIMEOUT:`timeout`,DUPLICATE_CALLBACK:`duplicate_callback`,INVALID_NONCE:`invalid_nonce`,INVALID_ORIGIN:`invalid_origin`,SESSION_NOT_FOUND:`session_not_found`,SESSION_LIMIT_REACHED:`session_limit_reached`,ASSET_NOT_FOUND:`asset_not_found`,ASSET_FORBIDDEN:`asset_forbidden`,RATE_LIMITED:`rate_limited`,PAYLOAD_TOO_LARGE:`payload_too_large`,UNSUPPORTED_MEDIA_TYPE:`unsupported_media_type`,INVALID_TRANSITION:`invalid_transition`,ANNOTATION_CAP_EXCEEDED:`annotation_cap_exceeded`},ph={[X.TIMEOUT]:408,[X.DUPLICATE_CALLBACK]:409,[X.INVALID_NONCE]:400,[X.INVALID_ORIGIN]:403,[X.SESSION_NOT_FOUND]:404,[X.SESSION_LIMIT_REACHED]:429,[X.ASSET_NOT_FOUND]:404,[X.ASSET_FORBIDDEN]:403,[X.RATE_LIMITED]:429,[X.PAYLOAD_TOO_LARGE]:413,[X.UNSUPPORTED_MEDIA_TYPE]:415,[X.INVALID_TRANSITION]:400,[X.ANNOTATION_CAP_EXCEEDED]:403};function mh(e,t,n){return{code:e,message:t,httpStatus:n??ph[e]}}const hh={created:[`rendering`,`errored`,`cleaned_up`,`timed_out`,`cancelled`,`responded`],rendering:[`listening`,`errored`,`cleaned_up`,`timed_out`,`cancelled`],listening:[`connected`,`timed_out`,`cancelled`,`errored`,`cleaned_up`],connected:[`responded`,`timed_out`,`cancelled`,`errored`,`cleaned_up`],responded:[`cleaned_up`],timed_out:[`cleaned_up`],cancelled:[`cleaned_up`],errored:[`cleaned_up`],cleaned_up:[]};function gh(e,t,n,r){return hh[e].includes(t)?{ok:!0,to:t,entry:{from:e,to:t,timestamp:Date.now(),trigger:r}}:{ok:!1,error:{code:`invalid_transition`,message:`Cannot transition from "${e}" to "${t}"`,from:e,to:t}}}function _h(e){return hh[e].length===0}const vh=1024,yh=new Set([`user-closed`,`host-dismissed`,`replaced`]);function bh(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function xh(e,t,n){let r={code:e,message:t};return n!==void 0&&(r.details=n),{kind:`error`,error:r}}function Sh(e,t,n,r){e.writeHead(t,{"Content-Type":`application/json`,"Access-Control-Allow-Origin":r??`null`}),e.end(JSON.stringify(n))}async function Ch(e){return await new Promise((t,n)=>{let r=[],i=0;e.on(`data`,t=>{if(i+=t.length,i>65536){n(Error(`Callback payload exceeds 64KB limit`)),e.destroy();return}r.push(t)}),e.on(`end`,()=>t(Buffer.concat(r).toString(`utf8`))),e.on(`error`,n)})}function wh(e,t){if(typeof e!=`string`||e.length!==t.length)return!1;let n=Buffer.from(e,`hex`),r=Buffer.from(t,`hex`);return n.length===r.length?Ze(n,r):!1}function Th(e,t){let n=e.headers.origin;if(n!==void 0)return n===t;let r=e.headers.referer;return r==null?!0:r.startsWith(t)}function Eh(e){return(e.headers[`content-type`]??``).startsWith(`application/json`)}function Dh(e){for(let[t,n]of Object.entries(e)){let e=typeof n==`string`?n:JSON.stringify(n);if(Buffer.byteLength(e,`utf8`)>8192)return`Form field "${t}" exceeds 8KB limit`}return null}function Oh(e){return Array.isArray(e)&&e.length>vh?`Selection exceeds ${vh} items (got ${e.length})`:null}function kh(e,t,n){let r=typeof e.actionId==`string`?e.actionId:``,i=n.find(e=>e.id===r);if(!i)return xh(`INVALID_ACTION`,`Unknown actionId: ${r||`(missing)`}`);let a=typeof e.selection==`string`||Array.isArray(e.selection)?e.selection:void 0,o=bh(e.formData)?e.formData:void 0,s={surfaceId:t,actionId:i.id,actionType:i.type,timestamp:typeof e.timestamp==`string`?e.timestamp:new Date().toISOString(),sourceTransport:`browser`};return e.value!==void 0&&(s.value=e.value),a!==void 0&&(s.selection=a),o!==void 0&&(s.formData=o),e.annotations!==void 0&&(s.annotations=e.annotations),typeof e.label==`string`?s.label=e.label:i.label&&(s.label=i.label),{kind:`result`,result:s}}function Ah(e){switch(e.kind){case`timeout`:return`timed_out`;case`cancelled`:return`cancelled`;case`error`:return`errored`;case`result`:return`responded`;default:return`errored`}}function jh(e,t,n,r,i){let a=i??Ye(16).toString(`hex`),o=`created`,s=[],c=!1,l,u,d=new Promise(e=>{u=e}),f=e=>{if(_h(o))return l;let t=Ah(e),i=gh(o,t,s,`resolve`);return i.ok?(o=t,s.push(i.entry),l=e,u?.(e),n&&r&&n.transitionSession(r,t,`resolve`),e):l};return{nonce:a,promise:d,get state(){return o},get stateHistory(){return s},settleTimeout(e){return f({kind:`timeout`,waitedMs:e})},settleCancelled(e){return f({kind:`cancelled`,reason:e})},settleError(e,t,n){return f(xh(e,t,n))},async handle(n,r,i){if(!Eh(n)){let e=f(xh(X.UNSUPPORTED_MEDIA_TYPE,`Content-Type must be application/json`));return Sh(r,415,{ok:!1,error:X.UNSUPPORTED_MEDIA_TYPE},i),e}if(!Th(n,i)){let e=n.headers.origin??n.headers.referer??`(missing)`,t=f(xh(X.INVALID_ORIGIN,`Unexpected callback origin: ${e}`));return Sh(r,403,{ok:!1,error:X.INVALID_ORIGIN},i),t}let o=``;try{o=await Ch(n)}catch(e){let t=f(xh(`INVALID_PAYLOAD`,e instanceof Error?e.message:`Unable to read callback payload`));return Sh(r,413,{ok:!1,error:X.PAYLOAD_TOO_LARGE},i),t}let s;try{let e=JSON.parse(o);if(!bh(e))throw Error(`Callback payload must be an object`);s=e}catch(e){let t=f(xh(`INVALID_PAYLOAD`,e instanceof Error?e.message:`Malformed callback payload`));return Sh(r,400,{ok:!1,error:`invalid-json`},i),t}if(c){let e=xh(X.DUPLICATE_CALLBACK,`Nonce has already been used`);return Sh(r,403,{ok:!1,error:X.DUPLICATE_CALLBACK},i),e}if(!wh(typeof s.nonce==`string`?s.nonce:``,a)){let e=f(xh(X.INVALID_NONCE,`Callback nonce did not match`));return Sh(r,403,{ok:!1,error:X.INVALID_NONCE},i),e}c=!0;let l=Oh(s.selection);if(l){let e=f(xh(`SELECTION_TOO_LARGE`,l));return Sh(r,413,{ok:!1,error:`selection-too-large`},i),e}if(bh(s.formData)){let e=Dh(s.formData);if(e){let t=f(xh(`PAYLOAD_FIELD_TOO_LARGE`,e));return Sh(r,413,{ok:!1,error:`field-too-large`},i),t}}if(s.kind===`cancelled`){let e=typeof s.reason==`string`?s.reason:``;if(!yh.has(e)){let t=f(xh(`INVALID_CANCEL_REASON`,`Unsupported cancel reason: ${e||`(missing)`}`));return Sh(r,400,{ok:!1,error:`invalid-cancel-reason`},i),t}let t=f({kind:`cancelled`,reason:e});return Sh(r,200,{ok:!0,kind:`cancelled`},i),t}let u=f(kh(s,e,t));return Sh(r,u.kind===`error`?400:200,{ok:u.kind!==`error`,kind:u.kind},i),u}}}const Mh=`Install AI Kit with <code>${Y(`npx -y @vpxa/aikit@latest init --user`)}</code>.`;function Nh(e){let t=Date.now();return{id:e.id,state:`created`,nonce:e.nonce,surfaceId:e.surfaceId,transport:e.transport,createdAt:t,updatedAt:t,stateHistory:[],responsePromise:null,resolveOutcome:null,cleanupCallbacks:[],nonceConsumed:!1}}var Ph=class{sessions;maxSessions;rejectedCount;constructor(e=16){this.sessions=new Map,this.maxSessions=e,this.rejectedCount=0}createSession(e){if(this.sessions.size>=this.maxSessions)return this.rejectedCount++,{ok:!1,error:mh(X.SESSION_LIMIT_REACHED,`Session limit reached`)};let t=Xe(),n=Nh({id:t,nonce:e.nonce,surfaceId:e.surfaceId,transport:e.transport});return this.sessions.set(t,n),{ok:!0,session:n}}getSession(e){return this.sessions.get(e)||mh(X.SESSION_NOT_FOUND,`Session ${e} not found`)}transitionSession(e,t,n){let r=this.sessions.get(e);if(!r)return{ok:!1,error:mh(X.SESSION_NOT_FOUND,`Session ${e} not found`)};let i=gh(r.state,t,r.stateHistory,n);return i.ok?(r.state=i.to,r.stateHistory.push(i.entry),r.updatedAt=Date.now(),{ok:!0,record:r}):{ok:!1,error:mh(X.INVALID_TRANSITION,i.error.message)}}consumeNonce(e){let t=this.sessions.get(e);return t?t.nonceConsumed?{ok:!1,error:mh(X.DUPLICATE_CALLBACK,`Nonce already consumed`)}:(t.nonceConsumed=!0,t.updatedAt=Date.now(),{ok:!0}):{ok:!1,error:mh(X.SESSION_NOT_FOUND,`Session ${e} not found`)}}removeSession(e){return this.sessions.delete(e)}cleanupStale(e){let t=Date.now(),n=0;for(let[r,i]of this.sessions.entries())i.state!==`connected`&&t-i.updatedAt>e&&(i.resolveOutcome&&(i.resolveOutcome({outcome:`timeout`}),i.resolveOutcome=null,i.responsePromise=null),this.sessions.delete(r),n++);return n}shutdown(){for(let[,e]of this.sessions.entries()){e.resolveOutcome&&(e.resolveOutcome({outcome:`shutdown`}),e.resolveOutcome=null,e.responsePromise=null);for(let t of e.cleanupCallbacks)try{t()}catch{}e.cleanupCallbacks=[]}this.sessions.clear()}get activeCount(){return this.sessions.size}get rejectedSessionCount(){return this.rejectedCount}setResponseResolver(e,t){let n=this.sessions.get(e);return n?(n.resolveOutcome=t,n.updatedAt=Date.now(),{ok:!0}):{ok:!1,error:mh(X.SESSION_NOT_FOUND,`Session ${e} not found`)}}};const Fh=String.raw`(function(){
|
|
310
|
+
}`},{type:`text`,category:`content`,description:`Plain text content rendered through the markdown parser.`,valueShape:`string`},{type:`heading`,category:`content`,description:`Single heading with configurable level from h1 to h6.`,valueShape:`string`},{type:`paragraph`,category:`content`,description:`Single paragraph rendered inside a p tag.`,valueShape:`string`},{type:`separator`,category:`layout`,description:`Horizontal rule used to separate adjacent blocks.`,valueShape:`undefined`},{type:`actions`,category:`layout`,description:`Action bar containing button and select action definitions.`,valueShape:`Array<{ type: string; id: string; label: string; variant?: string; options?: Array<string | { label: string; value: string }> }>`},{type:`diff`,category:`content`,description:`Diff view with +/- lines for showing changes between text.`,valueShape:`string | { content: string } | { before: string; after: string }`},{type:`finding`,category:`content`,description:`Finding with severity pill showing title, severity, and detail.`,valueShape:`{ title?: string; severity?: string; detail?: unknown }`},{type:`kv`,category:`data`,description:`Key-value pairs rendered as labeled entries.`,valueShape:`Array<{ key: string; value: unknown }> | Record<string, unknown>`},{type:`tags`,category:`data`,description:`Tag pills rendered with optional tone/color.`,valueShape:`Array<string | { text?: string; label?: string; status?: string; tone?: string; color?: string }> | { items: Array<...> }`},{type:`list`,category:`content`,description:`Bullet list items rendered as an unordered list.`,valueShape:`string[]`},{type:`lifecycle-flow`,category:`visualization`,description:`SVG flow diagram with labeled steps, edges, and status colors.`,valueShape:`{ title?: string; steps: Array<{ id: string; label: string; type?: string; status?: string; description?: string }>; edges?: Array<{ from: string; to: string; label?: string }> }`},{type:`component-detail`,category:`visualization`,description:`Component detail view with name, type, technology, responsibilities, interfaces, dependencies, metrics, and code links.`,valueShape:`{ name: string; description?: string; type?: string; technology?: string; responsibilities?: string[]; interfaces?: Array<{ name: string; type: string; description?: string }>; dependencies?: Array<{ name: string; relationship?: string }>; metrics?: Record<string, string | number>; codeLinks?: Array<{ href: string; label: string }> }`},{type:`data-table-schema`,category:`data`,description:`Schema table with field names, types, constraints, and indexes.`,valueShape:`{ name: string; description?: string; fields: Array<{ name: string; type: string; required?: boolean; default?: unknown; constraints?: string[]; description?: string }>; indexes?: Array<{ name: string; columns: string[]; unique?: boolean }> }`},{type:`annotation`,category:`interactive`,description:`Annotation groups with COMMENT, DELETION, and GLOBAL_COMMENT types.`,valueShape:`Array<{ id: string; type: "COMMENT" | "DELETION" | "GLOBAL_COMMENT"; body: string; author?: string; createdAt?: string }>`},{type:`approval`,category:`interactive`,description:`Approval widget with radio options and optional comment textarea.`,valueShape:`{ prompt: string; options: Array<{ id: string; label: string; description?: string }>; requireComment?: boolean }`},{type:`docs-hub`,category:`content`,description:`Doc hub card grid with titled pages, descriptions, categories, and statuses.`,valueShape:`{ title?: string; description?: string; pages?: Array<{ title: string; description?: string; href?: string; icon?: string; category?: string; status?: "draft" | "published" | "deprecated" }> }`}].map(e=>[e.type,{...e}]));function mh(){let e={};for(let[t,n]of ph)n.vendorScripts?.length&&(e[t]=n.vendorScripts);return e}const X={TIMEOUT:`timeout`,DUPLICATE_CALLBACK:`duplicate_callback`,INVALID_NONCE:`invalid_nonce`,INVALID_ORIGIN:`invalid_origin`,SESSION_NOT_FOUND:`session_not_found`,SESSION_LIMIT_REACHED:`session_limit_reached`,ASSET_NOT_FOUND:`asset_not_found`,ASSET_FORBIDDEN:`asset_forbidden`,RATE_LIMITED:`rate_limited`,PAYLOAD_TOO_LARGE:`payload_too_large`,UNSUPPORTED_MEDIA_TYPE:`unsupported_media_type`,INVALID_TRANSITION:`invalid_transition`,ANNOTATION_CAP_EXCEEDED:`annotation_cap_exceeded`},hh={[X.TIMEOUT]:408,[X.DUPLICATE_CALLBACK]:409,[X.INVALID_NONCE]:400,[X.INVALID_ORIGIN]:403,[X.SESSION_NOT_FOUND]:404,[X.SESSION_LIMIT_REACHED]:429,[X.ASSET_NOT_FOUND]:404,[X.ASSET_FORBIDDEN]:403,[X.RATE_LIMITED]:429,[X.PAYLOAD_TOO_LARGE]:413,[X.UNSUPPORTED_MEDIA_TYPE]:415,[X.INVALID_TRANSITION]:400,[X.ANNOTATION_CAP_EXCEEDED]:403};function gh(e,t,n){return{code:e,message:t,httpStatus:n??hh[e]}}const _h={created:[`rendering`,`errored`,`cleaned_up`,`timed_out`,`cancelled`,`responded`],rendering:[`listening`,`errored`,`cleaned_up`,`timed_out`,`cancelled`],listening:[`connected`,`timed_out`,`cancelled`,`errored`,`cleaned_up`],connected:[`responded`,`timed_out`,`cancelled`,`errored`,`cleaned_up`],responded:[`cleaned_up`],timed_out:[`cleaned_up`],cancelled:[`cleaned_up`],errored:[`cleaned_up`],cleaned_up:[]};function vh(e,t,n,r){return _h[e].includes(t)?{ok:!0,to:t,entry:{from:e,to:t,timestamp:Date.now(),trigger:r}}:{ok:!1,error:{code:`invalid_transition`,message:`Cannot transition from "${e}" to "${t}"`,from:e,to:t}}}function yh(e){return _h[e].length===0}const bh=1024,xh=new Set([`user-closed`,`host-dismissed`,`replaced`]);function Sh(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Ch(e,t,n){let r={code:e,message:t};return n!==void 0&&(r.details=n),{kind:`error`,error:r}}function wh(e,t,n,r){e.writeHead(t,{"Content-Type":`application/json`,"Access-Control-Allow-Origin":r??`null`}),e.end(JSON.stringify(n))}async function Th(e){return await new Promise((t,n)=>{let r=[],i=0;e.on(`data`,t=>{if(i+=t.length,i>65536){n(Error(`Callback payload exceeds 64KB limit`)),e.destroy();return}r.push(t)}),e.on(`end`,()=>t(Buffer.concat(r).toString(`utf8`))),e.on(`error`,n)})}function Eh(e,t){if(typeof e!=`string`||e.length!==t.length)return!1;let n=Buffer.from(e,`hex`),r=Buffer.from(t,`hex`);return n.length===r.length?Ze(n,r):!1}function Dh(e,t){let n=e.headers.origin;if(n!==void 0)return n===t;let r=e.headers.referer;return r==null?!0:r.startsWith(t)}function Oh(e){return(e.headers[`content-type`]??``).startsWith(`application/json`)}function kh(e){for(let[t,n]of Object.entries(e)){let e=typeof n==`string`?n:JSON.stringify(n);if(Buffer.byteLength(e,`utf8`)>8192)return`Form field "${t}" exceeds 8KB limit`}return null}function Ah(e){return Array.isArray(e)&&e.length>bh?`Selection exceeds ${bh} items (got ${e.length})`:null}function jh(e,t,n){let r=typeof e.actionId==`string`?e.actionId:``,i=n.find(e=>e.id===r);if(!i)return Ch(`INVALID_ACTION`,`Unknown actionId: ${r||`(missing)`}`);let a=typeof e.selection==`string`||Array.isArray(e.selection)?e.selection:void 0,o=Sh(e.formData)?e.formData:void 0,s={surfaceId:t,actionId:i.id,actionType:i.type,timestamp:typeof e.timestamp==`string`?e.timestamp:new Date().toISOString(),sourceTransport:`browser`};return e.value!==void 0&&(s.value=e.value),a!==void 0&&(s.selection=a),o!==void 0&&(s.formData=o),e.annotations!==void 0&&(s.annotations=e.annotations),typeof e.label==`string`?s.label=e.label:i.label&&(s.label=i.label),{kind:`result`,result:s}}function Mh(e){switch(e.kind){case`timeout`:return`timed_out`;case`cancelled`:return`cancelled`;case`error`:return`errored`;case`result`:return`responded`;default:return`errored`}}function Nh(e,t,n,r,i){let a=i??Ye(16).toString(`hex`),o=`created`,s=[],c=!1,l,u,d=new Promise(e=>{u=e}),f=e=>{if(yh(o))return l;let t=Mh(e),i=vh(o,t,s,`resolve`);return i.ok?(o=t,s.push(i.entry),l=e,u?.(e),n&&r&&n.transitionSession(r,t,`resolve`),e):l};return{nonce:a,promise:d,get state(){return o},get stateHistory(){return s},settleTimeout(e){return f({kind:`timeout`,waitedMs:e})},settleCancelled(e){return f({kind:`cancelled`,reason:e})},settleError(e,t,n){return f(Ch(e,t,n))},async handle(n,r,i){if(!Oh(n)){let e=f(Ch(X.UNSUPPORTED_MEDIA_TYPE,`Content-Type must be application/json`));return wh(r,415,{ok:!1,error:X.UNSUPPORTED_MEDIA_TYPE},i),e}if(!Dh(n,i)){let e=n.headers.origin??n.headers.referer??`(missing)`,t=f(Ch(X.INVALID_ORIGIN,`Unexpected callback origin: ${e}`));return wh(r,403,{ok:!1,error:X.INVALID_ORIGIN},i),t}let o=``;try{o=await Th(n)}catch(e){let t=f(Ch(`INVALID_PAYLOAD`,e instanceof Error?e.message:`Unable to read callback payload`));return wh(r,413,{ok:!1,error:X.PAYLOAD_TOO_LARGE},i),t}let s;try{let e=JSON.parse(o);if(!Sh(e))throw Error(`Callback payload must be an object`);s=e}catch(e){let t=f(Ch(`INVALID_PAYLOAD`,e instanceof Error?e.message:`Malformed callback payload`));return wh(r,400,{ok:!1,error:`invalid-json`},i),t}if(c){let e=Ch(X.DUPLICATE_CALLBACK,`Nonce has already been used`);return wh(r,403,{ok:!1,error:X.DUPLICATE_CALLBACK},i),e}if(!Eh(typeof s.nonce==`string`?s.nonce:``,a)){let e=f(Ch(X.INVALID_NONCE,`Callback nonce did not match`));return wh(r,403,{ok:!1,error:X.INVALID_NONCE},i),e}c=!0;let l=Ah(s.selection);if(l){let e=f(Ch(`SELECTION_TOO_LARGE`,l));return wh(r,413,{ok:!1,error:`selection-too-large`},i),e}if(Sh(s.formData)){let e=kh(s.formData);if(e){let t=f(Ch(`PAYLOAD_FIELD_TOO_LARGE`,e));return wh(r,413,{ok:!1,error:`field-too-large`},i),t}}if(s.kind===`cancelled`){let e=typeof s.reason==`string`?s.reason:``;if(!xh.has(e)){let t=f(Ch(`INVALID_CANCEL_REASON`,`Unsupported cancel reason: ${e||`(missing)`}`));return wh(r,400,{ok:!1,error:`invalid-cancel-reason`},i),t}let t=f({kind:`cancelled`,reason:e});return wh(r,200,{ok:!0,kind:`cancelled`},i),t}let u=f(jh(s,e,t));return wh(r,u.kind===`error`?400:200,{ok:u.kind!==`error`,kind:u.kind},i),u}}}const Ph=`Install AI Kit with <code>${Y(`npx -y @vpxa/aikit@latest init --user`)}</code>.`;function Fh(e){let t=Date.now();return{id:e.id,state:`created`,nonce:e.nonce,surfaceId:e.surfaceId,transport:e.transport,createdAt:t,updatedAt:t,stateHistory:[],responsePromise:null,resolveOutcome:null,cleanupCallbacks:[],nonceConsumed:!1}}var Ih=class{sessions;maxSessions;rejectedCount;constructor(e=16){this.sessions=new Map,this.maxSessions=e,this.rejectedCount=0}createSession(e){if(this.sessions.size>=this.maxSessions)return this.rejectedCount++,{ok:!1,error:gh(X.SESSION_LIMIT_REACHED,`Session limit reached`)};let t=Xe(),n=Fh({id:t,nonce:e.nonce,surfaceId:e.surfaceId,transport:e.transport});return this.sessions.set(t,n),{ok:!0,session:n}}getSession(e){return this.sessions.get(e)||gh(X.SESSION_NOT_FOUND,`Session ${e} not found`)}transitionSession(e,t,n){let r=this.sessions.get(e);if(!r)return{ok:!1,error:gh(X.SESSION_NOT_FOUND,`Session ${e} not found`)};let i=vh(r.state,t,r.stateHistory,n);return i.ok?(r.state=i.to,r.stateHistory.push(i.entry),r.updatedAt=Date.now(),{ok:!0,record:r}):{ok:!1,error:gh(X.INVALID_TRANSITION,i.error.message)}}consumeNonce(e){let t=this.sessions.get(e);return t?t.nonceConsumed?{ok:!1,error:gh(X.DUPLICATE_CALLBACK,`Nonce already consumed`)}:(t.nonceConsumed=!0,t.updatedAt=Date.now(),{ok:!0}):{ok:!1,error:gh(X.SESSION_NOT_FOUND,`Session ${e} not found`)}}removeSession(e){return this.sessions.delete(e)}cleanupStale(e){let t=Date.now(),n=0;for(let[r,i]of this.sessions.entries())i.state!==`connected`&&t-i.updatedAt>e&&(i.resolveOutcome&&(i.resolveOutcome({outcome:`timeout`}),i.resolveOutcome=null,i.responsePromise=null),this.sessions.delete(r),n++);return n}shutdown(){for(let[,e]of this.sessions.entries()){e.resolveOutcome&&(e.resolveOutcome({outcome:`shutdown`}),e.resolveOutcome=null,e.responsePromise=null);for(let t of e.cleanupCallbacks)try{t()}catch{}e.cleanupCallbacks=[]}this.sessions.clear()}get activeCount(){return this.sessions.size}get rejectedSessionCount(){return this.rejectedCount}setResponseResolver(e,t){let n=this.sessions.get(e);return n?(n.resolveOutcome=t,n.updatedAt=Date.now(),{ok:!0}):{ok:!1,error:gh(X.SESSION_NOT_FOUND,`Session ${e} not found`)}}};const Lh=String.raw`(function(){
|
|
314
311
|
'use strict';
|
|
315
312
|
|
|
316
313
|
var SVG_NS = 'http://www.w3.org/2000/svg';
|
|
@@ -2691,7 +2688,7 @@ None.`:`### Stale Lessons\n${u.map(e=>`- **${e.title}** (\`${e.path}\`) — effe
|
|
|
2691
2688
|
};
|
|
2692
2689
|
|
|
2693
2690
|
init();
|
|
2694
|
-
})();`;function
|
|
2691
|
+
})();`;function Rh(){let e;return()=>{if(e!==void 0)return e;try{e=P(ce(import.meta.url).resolve(`mermaid/dist/mermaid.min.js`),`utf-8`)}catch{e=``}return e}}const zh={id:`mermaid`,cdn:`https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js`,inlineSource:Lh,initScript:`window.__aikit_initMermaid = function() {
|
|
2695
2692
|
if (typeof mermaid === 'undefined') return;
|
|
2696
2693
|
if (document.readyState === 'loading') {
|
|
2697
2694
|
document.addEventListener('DOMContentLoaded', window.__aikit_initMermaid);
|
|
@@ -2704,8 +2701,8 @@ None.`:`### Stale Lessons\n${u.map(e=>`- **${e.title}** (\`${e.path}\`) — effe
|
|
|
2704
2701
|
}
|
|
2705
2702
|
mermaid.initialize({ startOnLoad: false, theme: theme });
|
|
2706
2703
|
mermaid.run();
|
|
2707
|
-
};`,onload:`window.__aikit_initMermaid&&window.__aikit_initMermaid()`,local:{route:`/vendor/mermaid.min.js`,getSource:
|
|
2708
|
-
`)}function
|
|
2704
|
+
};`,onload:`window.__aikit_initMermaid&&window.__aikit_initMermaid()`,local:{route:`/vendor/mermaid.min.js`,getSource:Rh()}},Bh=new Map([[`mermaid`,zh]]);function Vh(e,t){if(!e?.length)return;let n=[];for(let r of e){let e=Bh.get(r);if(e){if(t===`browser`){n.push({inlineSource:e.inlineSource,onload:e.onload});continue}if(t===`mcp-app`){n.push({inlineSource:e.inlineSource,onload:e.onload});continue}n.push({src:e.cdn,initScript:e.initScript,onload:e.onload})}}return n.length>0?n:void 0}function Hh(){let e=[];for(let t of Bh.values())t.local&&e.push({route:t.local.route,getSource:t.local.getSource,cdn:t.cdn});return e}const Uh=300*1e3,Wh=15*1e3,Gh=`/@aikit/blocks-interactive/dist/`;var Kh=class{maxTokens;refillPerSecond;tokens;lastRefill;constructor(e,t){this.maxTokens=e,this.refillPerSecond=t,this.tokens=e,this.lastRefill=Date.now()}tryConsume(){return this.#e(),this.tokens>=1?(--this.tokens,!0):!1}#e(){let e=Date.now(),t=(e-this.lastRefill)/1e3;this.tokens=Math.min(this.maxTokens,this.tokens+t*this.refillPerSecond),this.lastRefill=e}};let qh=null,Jh=null;const Yh=new Map,Xh=new Kh(10,10),Zh=new Kh(50,50);function Qh(){return qh||(qh={manager:new Ih,server:null,port:0},process.on(`exit`,()=>{qh?.manager.shutdown()})),qh.manager}async function $h(){if(!qh)throw Error(`Browser server state not initialized`);let e=qh;if(e.server)return e.port;if(Jh)return Jh;let t=Xr((e,t)=>{ig(e,t)});return e.server=t,Jh=new Promise((n,r)=>{t.listen(0,`127.0.0.1`,()=>{let i=t.address();typeof i==`object`&&i?(e.port=i.port,n(i.port)):r(Error(`Failed to resolve local browser address`))}),t.on(`error`,r)}),Jh}let eg;function tg(){return eg===void 0&&(eg=w(`blocks-interactive`)),eg}function ng(e){if(!e.startsWith(Gh))return null;let t=tg();if(!t)return null;let n=I(F(t,`dist`,e.slice(32))),r=I(F(t,`dist`)),i=process.platform===`win32`?`\\`:`/`;return!n.startsWith(r+i)&&n!==r?null:n}function rg(e){return`script-src 'nonce-${e}' 'strict-dynamic'; style-src 'self' 'unsafe-inline'; img-src 'self' data: blob:; connect-src 'self'; frame-ancestors 'self'`}function ig(e,t){let n=qh;if(!n){mg(t);return}try{let r=new URL(e.url??`/`,`http://${e.headers.host??`127.0.0.1`}`).pathname,i=e.method??`GET`;if(i===`OPTIONS`){t.writeHead(204,{"Access-Control-Allow-Origin":`*`,"Access-Control-Allow-Methods":`POST, GET, OPTIONS`,"Access-Control-Allow-Headers":`Content-Type`}),t.end();return}if(r.startsWith(`/__aikit_clipboard.png`)){if(i!==`POST`){ag(t,405,`METHOD_NOT_ALLOWED`,`Clipboard capture requires POST.`);return}vg(t,hg(e,n));return}if(r.startsWith(`/__aikit_screenshot.png`)){_g(t,hg(e,n));return}if(r.startsWith(`/__aikit_system_clipboard`)){if(i!==`POST`){ag(t,405,`METHOD_NOT_ALLOWED`,`System clipboard write requires POST.`);return}yg(e,t);return}let a=r.match(/^\/present\/([^/]+)(?:\/(.*))?$/);if(a){let r=a[1],i=a[2]??``,o=Yh.get(r);if(!o){ag(t,404,X.SESSION_NOT_FOUND,`Session ${r} not found`);return}if(o.hasClientConnected=!0,n.manager.transitionSession(r,`connected`,`client-connect`),i===``||i===`/`){t.writeHead(200,{"Content-Type":`text/html; charset=utf-8`,"Content-Security-Policy":rg(o.callbackSession.nonce)}),t.end(o.html);return}if(i===`viewer`){if(!o.viewerHtml){t.writeHead(404,{"Content-Type":`text/plain`}),t.end(`Not Found`);return}t.writeHead(200,{"Content-Type":`text/html; charset=utf-8`}),t.end(o.viewerHtml);return}if(i===`callback`){if(!Xh.tryConsume()){ag(t,429,X.RATE_LIMITED,`Too many requests`);return}o.callbackSession.handle(e,t,`http://127.0.0.1:${n.port}`).catch(()=>{mg(t)});return}t.writeHead(404,{"Content-Type":`text/plain`}),t.end(`Not Found`);return}let o=Hh().find(t=>e.url===t.route);if(o){let e=o.getSource();if(e){t.writeHead(200,{"Content-Type":`application/javascript; charset=utf-8`,"Cache-Control":`public, max-age=86400`}),t.end(e);return}t.writeHead(302,{Location:o.cdn}),t.end();return}if(r.startsWith(Gh)){if(!Zh.tryConsume()){ag(t,429,X.RATE_LIMITED,`Too many requests`);return}let e=ng(r);if(e)try{let n=P(e,`utf8`);t.writeHead(200,{"Content-Type":`application/javascript; charset=utf-8`}),t.end(n);return}catch{}}t.writeHead(404,{"Content-Type":`text/plain`}),t.end(`Not Found`)}catch{mg(t)}}function ag(e,t,n,r){if(!e.headersSent)try{e.writeHead(t,{"Content-Type":`application/json; charset=utf-8`}),e.end(JSON.stringify({error:n,message:r}))}catch{try{e.end()}catch{}}}function og(e){let t=Y(e.id),n=Y(e.label);if(e.type===`select`||e.type===`multi-select`)return`<label class="present-action-field"><span>${n}</span><select data-action-id="${t}"${e.type===`multi-select`?` multiple`:``}>${(e.options??[]).map(e=>`<option value="${Y(e.value)}">${Y(e.label)}</option>`).join(``)}</select></label>`;if(e.type===`text-submit`)return`<label class="present-action-field"><span>${n}</span><div class="present-text-submit"><input type="text" class="present-text-input" data-action-id="${t}" data-action-label="${n}" placeholder="${n}" /><button type="button" class="present-action-btn present-action-primary present-submit-btn" data-submit-for="${t}">Send</button></div></label>`;if(e.type===`form-submit`){let r=e.schema;if(r)return`<form class="present-form" data-action-id="${t}" data-action-label="${n}">${Object.entries(r).map(([e,t])=>{let n=Y(t.description??e);return`<label class="present-action-field"><span>${n}</span><input type="${t.type===`number`?`number`:t.type===`boolean`?`checkbox`:`text`}" class="present-text-input" name="${Y(e)}" placeholder="${n}" /></label>`}).join(``)}<button type="submit" class="present-action-btn present-action-primary">${n}</button></form>`}return`<button type="button" class="present-action-btn present-action-${Y(e.variant??`default`)}" data-action-id="${t}" data-action-label="${n}">${n}</button>`}function sg(e){if(e.length===0)return``;let t=e.filter(e=>e.type===`button`||e.type===`select`||e.type===`multi-select`||e.type===`custom`),n=e.filter(e=>e.type===`text-submit`||e.type===`form-submit`),r=[];return t.length>0&&r.push(`<div class="bk-actions">${t.map(og).join(``)}</div>`),n.length>0&&r.push(n.map(og).join(``)),r.join(`
|
|
2705
|
+
`)}function cg(e,t){if(e.length===0)return``;let n=JSON.stringify(t);return`<style>
|
|
2709
2706
|
.present-surface-title { margin: 0 0 0.75rem; font-size: 1.875rem; }
|
|
2710
2707
|
.present-surface-description { margin: 0; color: var(--muted-foreground, #6b7280); }
|
|
2711
2708
|
.present-actions-list { display: flex; flex-wrap: wrap; gap: 0.75rem; align-items: flex-end; }
|
|
@@ -2927,27 +2924,27 @@ None.`:`### Stale Lessons\n${u.map(e=>`- **${e.title}** (\`${e.path}\`) — effe
|
|
|
2927
2924
|
navigator.sendBeacon('/callback', new Blob([body], { type: 'application/json' }));
|
|
2928
2925
|
});
|
|
2929
2926
|
})();
|
|
2930
|
-
<\/script>`}function
|
|
2931
|
-
`)}function
|
|
2932
|
-
`);return{content:[{type:`text`,text:`[ERROR:VALIDATION] Template "${t.id}" data validation failed:\n${e}\n\nExpected schema: ${JSON.stringify(t.inputSchema,null,2)}`}],structuredContent:{kind:`error`,error:{code:`VIEWER_DATA_INVALID`,message:`Template "${t.id}" data validation failed:\n${e}\n\nExpected schema: ${JSON.stringify(t.inputSchema,null,2)}`}},isError:!0}}}let n=
|
|
2927
|
+
<\/script>`}function lg(e){try{if(process.platform===`win32`){Xn(`cmd`,[`/c`,`start`,``,e],{windowsHide:!0});return}if(process.platform===`darwin`){Xn(`open`,[e]);return}Xn(`xdg-open`,[e])}catch{}}async function ug(e){try{let t=sr();return await t.launch(`ui`),t.resetIdleTimer(),await t.open(e),!0}catch{return lg(e),!1}}function dg(e,t,n){let r=[e.title];return e.description&&r.push(e.description),r.push(``,`Opened in browser at ${t}`,n),r.join(`
|
|
2928
|
+
`)}function fg(e){return e.some(e=>e.id!==`__dismiss`)}function pg(e){return e.replace(`</head>`,`${__}\n</head>`).replace(`</body>`,`${v_}\n</body>`)}function mg(e){if(!e.headersSent)try{e.writeHead(500,{"Content-Type":`text/plain`}),e.end(`Internal Server Error`)}catch{try{e.end()}catch{}}}function hg(e,t){let n=e.headers.referer;return typeof n==`string`&&n.length>0?n:`http://127.0.0.1:${t.port}`}async function gg(e,t){let n=sr(),r=`ss-${Date.now()}`;n.isLaunched()||await n.launch(`headless`);let{base64:i}=await n.screenshot(r,{fullPage:t?.fullPage!==!1,format:t?.format,quality:t?.quality,annotate:t?.annotate});return Buffer.from(i,`base64`)}async function _g(e,t){if(!t){e.writeHead(503,{"Content-Type":`text/plain; charset=utf-8`}),e.end(`Screenshot target is not ready.`);return}try{let n=await gg(t);e.writeHead(200,{"Content-Type":`image/png`,"Cache-Control":`no-store`}),e.end(n)}catch(t){let n=t instanceof Error?t.message:String(t);console.warn(`[present] Screenshot capture failed:`,n),mg(e)}}async function vg(e,t){if(!t){ag(e,503,`CLIPBOARD_CAPTURE_TARGET_MISSING`,`Clipboard target is not ready.`);return}try{let n=await gg(t);e.writeHead(200,{"Content-Type":`image/png`,"Cache-Control":`no-store`}),e.end(n)}catch(t){let n=t instanceof Error?t.message:String(t);console.warn(`[present] Clipboard capture failed:`,n),ag(e,500,`CLIPBOARD_CAPTURE_FAILED`,`Clipboard capture failed: ${n}`)}}async function yg(e,t){let n=[];e.on(`data`,e=>n.push(e)),e.on(`end`,async()=>{let e=Buffer.concat(n);if(e.length===0){ag(t,400,`EMPTY_BODY`,`No image data received.`);return}try{await bg(e),t.writeHead(200,{"Content-Type":`application/json`}),t.end(JSON.stringify({ok:!0}))}catch(e){let n=e instanceof Error?e.message:String(e);console.warn(`[present] System clipboard write failed:`,n),ag(t,500,`SYSTEM_CLIPBOARD_WRITE_FAILED`,`System clipboard write failed: ${n}`)}}),e.on(`error`,e=>{console.warn(`[present] System clipboard write request error:`,e.message),ag(t,500,`REQUEST_ERROR`,`Request stream error.`)})}async function bg(e){let t=F($n(),`aikit-clipboard-${Date.now()}-${Ye(4).toString(`hex`)}.png`);Fe(t,e);try{if(process.platform===`win32`){let e=[`Add-Type -AssemblyName System.Drawing;`,`Add-Type -AssemblyName System.Windows.Forms;`,`$path = '${t.replace(/'/g,`''`)}';`,`$img = [System.Drawing.Image]::FromFile($path);`,`$img2 = [System.Drawing.Bitmap]::FromImage($img);`,`$img.Dispose();`,`[System.Windows.Forms.Clipboard]::SetImage($img2);`,`Start-Sleep -Milliseconds 500;`,`$img2.Dispose();`].join(` `);await new Promise((t,n)=>{Yn(`powershell.exe -NoProfile -STA -Command "${e.replace(/"/g,`\\"`)}"`,{timeout:15e3},e=>{e?n(Error(`PowerShell clipboard write failed: ${e.message}`)):t()})})}else if(process.platform===`darwin`)await new Promise((e,n)=>{Yn(`osascript -e 'set the clipboard to (read (POSIX file "${t}") as picture)'`,{timeout:15e3},t=>{t?n(Error(`macOS clipboard write failed: ${t.message}`)):e()})});else try{await new Promise((e,n)=>{Yn(`wl-copy --type image/png < "${t}" 2>/dev/null`,{timeout:1e4},(t,r)=>{t?n(Error(`wl-copy failed: ${t.message}`)):e(r)})});return}catch{await new Promise((e,n)=>{Yn(`xclip -selection clipboard -t image/png -i "${t}"`,{timeout:15e3},t=>{t?n(Error(`Linux clipboard write failed (tried wl-copy then xclip): ${t.message}. Install wl-clipboard (Wayland) or xclip (X11) for clipboard image support.`)):e()})})}}finally{try{Pe(t)}catch{}}}function xg(e,t){return e.replace(/'\/callback'/g,`'/present/${t}/callback'`).replace(/"\/callback"/g,`"/present/${t}/callback"`)}function Sg(e,t){return e.replace(/src="\/viewer"/g,`src="/present/${t}/viewer"`)}async function Cg(e,t){if(Yg(`<html><body style="font-family:system-ui;padding:2rem;color:#888;text-align:center"><p>Content opened in browser window.</p></body></html>`),e.data!=null&&t.inputSchema){let n=On({data:e.data,schema:t.inputSchema});if(!n.valid){let e=n.errors.map(e=>` ${e.path}: ${e.message}${e.expected?` (expected: ${e.expected}, got: ${e.received})`:``}`).join(`
|
|
2929
|
+
`);return{content:[{type:`text`,text:`[ERROR:VALIDATION] Template "${t.id}" data validation failed:\n${e}\n\nExpected schema: ${JSON.stringify(t.inputSchema,null,2)}`}],structuredContent:{kind:`error`,error:{code:`VIEWER_DATA_INVALID`,message:`Template "${t.id}" data validation failed:\n${e}\n\nExpected schema: ${JSON.stringify(t.inputSchema,null,2)}`}},isError:!0}}}let n=pg(Rm(t.resolveHtml(),e.data??null,t.injectId,t.transformData)),r=Qh(),i=Ye(16).toString(`hex`),a=r.createSession({surfaceId:`viewer`,transport:`viewer`,nonce:i});if(!a.ok)return{content:[{type:`text`,text:`${e.title}\n\nUnable to start local browser transport.`}],structuredContent:{kind:`error`,error:{code:`BROWSER_START_FAILED`,message:a.error.message}},isError:!0};let o=a.session.id,s=Nh(`viewer`,e.actions??[],r,o,i),c=Sg(Vr({title:e.title,subtitle:e.description,html:[`<div class="present-viewer-container">`,` <iframe class="present-viewer-iframe" src="/viewer" sandbox="allow-scripts allow-same-origin"></iframe>`,` ${y_(i)}`,`</div>`].join(`
|
|
2933
2930
|
`),css:[[`.present-viewer-container {`,` flex: 1;`,` min-height: calc(100vh - 12rem);`,` position: relative;`,` border-radius: 0.75rem;`,` overflow: hidden;`,` border: none;`,`}`,`.present-viewer-iframe {`,` border: none;`,` width: 100%;`,` height: 100%;`,` position: absolute;`,` inset: 0;`,` border-radius: inherit;`,`}`].join(`
|
|
2934
|
-
`)],islands:[],payload:void 0,nonce:i,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`browser`,exportPolicy:`local-interactive`,imageExportMode:`browser-server`,footerContentHtml:
|
|
2935
|
-
`),css:r.css,islands:r.islands,payload:r.payload,nonce:r.nonce,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`browser`,exportPolicy:r.exportPolicy,imageExportMode:`browser-server`,footerContentHtml:
|
|
2931
|
+
`)],islands:[],payload:void 0,nonce:i,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`browser`,exportPolicy:`local-interactive`,imageExportMode:`browser-server`,footerContentHtml:Ph}),o);Yh.set(o,{callbackSession:s,html:c,viewerHtml:n,hasClientConnected:!1,createdAt:Date.now()});let l=``;try{l=`http://127.0.0.1:${await $h()}/present/${o}`}catch(t){return Yh.delete(o),r.removeSession(o),{content:[{type:`text`,text:`${e.title}\n\nUnable to start local browser transport.`}],structuredContent:{kind:`error`,error:{code:`BROWSER_START_FAILED`,message:t instanceof Error?t.message:`Unable to start browser transport`}},isError:!0}}return await ug(l),setTimeout(()=>{Yh.delete(o),r.removeSession(o)},Uh),{content:[{type:`text`,text:dg(e,l,`Rendered.`)}],structuredContent:{kind:`rendered`,reason:`no-response-required`}}}async function wg(e){Yg(`<html><body style="font-family:system-ui;padding:2rem;color:#888;text-align:center"><p>Content opened in browser window.</p></body></html>`);let t=Qh(),n=Ye(16).toString(`hex`),r=Yr(e,{transport:`browser`,registry:uh,blockVendorScripts:mh(),nonce:n}),i=t.createSession({surfaceId:r.surfaceId,transport:`browser`,nonce:n});if(!i.ok)return{content:[{type:`text`,text:`${e.title}\n\nUnable to start local browser transport.`}],structuredContent:{kind:`error`,error:{code:`BROWSER_START_FAILED`,message:i.error.message}},isError:!0};let a=i.session.id,o=Nh(r.surfaceId,r.actions,t,a,n),s=Vh(r.vendorScripts,`browser`);Hh();let c=r.actions.length>0?sg(r.actions):``,l=r.actions.length>0?cg(r.actions,o.nonce):``,u=xg(T_(Vr({title:e.title,subtitle:e.description,html:[r.html,c,l].filter(Boolean).join(`
|
|
2932
|
+
`),css:r.css,islands:r.islands,payload:r.payload,nonce:r.nonce,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`browser`,exportPolicy:r.exportPolicy,imageExportMode:`browser-server`,footerContentHtml:Ph,headScripts:s}),r.nonce),a);Yh.set(a,{callbackSession:o,html:u,hasClientConnected:!1,createdAt:Date.now()});let d=``;try{d=`http://127.0.0.1:${await $h()}/present/${a}`;let e=Yh.get(a);e&&e.hasClientConnected}catch(n){return Yh.delete(a),t.removeSession(a),t.shutdown(),{content:[{type:`text`,text:`${e.title}\n\nUnable to start local browser transport.`}],structuredContent:o.settleError(`BROWSER_START_FAILED`,n instanceof Error?n.message:`Unable to start browser transport`),isError:!0}}let f=await ug(d);if(!fg(r.actions))return setTimeout(()=>{Yh.delete(a);try{t.removeSession(a)}catch{}},Uh),{content:[{type:`text`,text:dg(e,d,`Rendered.`)}],structuredContent:{kind:`rendered`,reason:`no-response-required`}};let p=await Promise.race([o.promise,new Promise(e=>{setTimeout(()=>{Yh.get(a)?.hasClientConnected||(Yh.delete(a),e(o.settleError(`BROWSER_CONNECT_TIMEOUT`,f?`No browser client connected within ${Wh}ms.`:`Fell back to system browser, but no browser client connected within ${Wh}ms.`)))},Wh)}),new Promise(e=>{setTimeout(()=>e(o.settleTimeout(Uh)),Uh)})]);setTimeout(()=>{Yh.delete(a);try{t.removeSession(a)}catch{}},Uh);let m=p.kind===`result`?`Selected action: ${p.result.actionId}`:p.kind===`timeout`?`Timed out after ${p.waitedMs}ms.`:p.kind===`cancelled`?`Cancelled: ${p.reason}.`:p.kind===`error`?`Error: ${p.error.message}`:`Rendered.`;return{content:[{type:`text`,text:dg(e,d,m)}],structuredContent:p,isError:p.kind===`error`}}const Tg={id:`browser`,priority:20,canHandle(e,t){let n=m_(e);return fh(n)||!!t.preferBrowser&&!!h_(n)},async render(e,t){return wg(e)}},Eg=`openai/outputTemplate`,Dg=`ui/resourceUri`,Og={connectDomains:[],resourceDomains:[]},kg={connect_domains:[],resource_domains:[]};function Ag(e){return{ui:{resourceUri:e,visibility:[`model`,`app`]},[Dg]:e,[Eg]:e,"openai/widgetAccessible":!0}}function jg(){return{ui:{prefersBorder:!1,csp:Og},"openai/widgetDescription":`AI Kit renders structured visual surfaces such as dashboards, charts, reports, and diagrams.`,"openai/widgetPrefersBorder":!1,"openai/widgetCSP":kg}}function Mg(e){return{ui:{resourceUri:e},[Dg]:e,[Eg]:e}}function Ng(e){return{...e,schemaVersion:1}}function Pg(e){try{let t=Yr(e,{transport:`mcp-app`,registry:uh,blockVendorScripts:mh()}),n=Vh(t.vendorScripts,`mcp-app`),r=Vr({title:e.title,subtitle:e.description,html:t.html,css:t.css,islands:t.islands,payload:t.payload,nonce:t.nonce,colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`mcp-app`,exportPolicy:t.exportPolicy,imageExportMode:`disabled`,showToolbox:t.exportPolicy!==`static-only`,showInstallGuide:!1,footerContentHtml:Ph,headScripts:n}),i={kind:`rendered`,reason:`no-response-required`},a=x_(r);Yg(a);let o=g_(e,i,{includeSurfaceHeader:!1}),s=qg(),c=Qg(s);return c&&Xg(c,a),{content:[{type:`text`,text:o}],structuredContent:Ng(e),_meta:Mg(s),ui:{type:`resource`,uri:s}}}catch(t){return D_(`RENDER_FAILED`,t instanceof Error?t.message:`Failed to render ChannelSurface`,void 0,e.title)}}const Fg={id:`mcp-app`,priority:30,canHandle(e,t){return!0},async render(e,t){return Pg(e)}};var Ig=class{handlers=[];register(e){let t=this.handlers.findIndex(t=>t.id===e.id);t===-1?this.handlers.push(e):this.handlers[t]=e}unregister(e){let t=this.handlers.findIndex(t=>t.id===e);t!==-1&&this.handlers.splice(t,1)}select(e,t){return[...this.handlers].sort((e,t)=>(e.priority??99)-(t.priority??99)).find(n=>n.canHandle(e,t))??null}getAll(){return[...this.handlers]}};function Lg(e){return`<script nonce="${Y(e)}">
|
|
2936
2933
|
window.addEventListener('message', function(e) {
|
|
2937
2934
|
if (e.data && e.data.type === 'aikit-viewer-height') {
|
|
2938
2935
|
var container = document.querySelector('.present-viewer-container');
|
|
2939
2936
|
if (container) { container.style.minHeight = e.data.height + 'px'; }
|
|
2940
2937
|
}
|
|
2941
2938
|
});
|
|
2942
|
-
<\/script>`}async function
|
|
2939
|
+
<\/script>`}async function Rg(e,t){try{let n=b_(Rm(t.resolveHtml(),e.data??null,t.injectId,t.transformData)).replace(/&/g,`&`).replace(/"/g,`"`),r=Ye(16).toString(`hex`),i={kind:`rendered`,reason:`no-response-required`};Yg(x_(Vr({title:e.title,subtitle:e.description,html:[`<div class="present-viewer-container">`,` <iframe class="present-viewer-iframe" srcdoc="${n}" sandbox="allow-scripts allow-same-origin"></iframe>`,` ${y_(r)}`,` ${Lg(r)}`,`</div>`].join(`
|
|
2943
2940
|
`),css:[[`.present-viewer-container {`,` flex: 1;`,` min-height: 640px;`,` position: relative;`,` border-radius: 0.75rem;`,` overflow: hidden;`,` border: none;`,`}`,`.present-viewer-iframe {`,` border: none;`,` width: 100%;`,` height: 100%;`,` position: absolute;`,` inset: 0;`,` border-radius: inherit;`,`}`].join(`
|
|
2944
|
-
`)],islands:[],payload:void 0,nonce:r,generatedAt:new Date().toISOString(),footerContentHtml:
|
|
2945
|
-
`);return
|
|
2946
|
-
`)}),r.length=0)},a=0;for(;a<t.length;){let e=t[a],o=t[a+1];if(o!==void 0&&
|
|
2947
|
-
`)}const
|
|
2941
|
+
`)],islands:[],payload:void 0,nonce:r,generatedAt:new Date().toISOString(),footerContentHtml:Ph,colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`mcp-app`,exportPolicy:`local-interactive`,imageExportMode:`disabled`})));let a=g_(e,i,{includeSurfaceHeader:!1}),o=qg();return{content:[{type:`text`,text:a}],structuredContent:Ng(e),_meta:Mg(o),ui:{type:`resource`,uri:o}}}catch(t){return D_(`VIEWER_RENDER_FAILED`,t instanceof Error?t.message:`Failed to render viewer template`,void 0,e.title)}}const zg={id:`viewer`,priority:10,canHandle(e,t){return e.template?Fm(e.template)!=null:!1},async render(e,t){let n=Fm(e.template??``);if(!n)return D_(`VIEWER_NOT_FOUND`,`Viewer template "${e.template}" not found`,void 0,e.title);if(e.data!=null&&n.inputSchema){let t=On({data:e.data,schema:n.inputSchema});if(!t.valid){let r=t.errors.map(e=>` ${e.path}: ${e.message}${e.expected?` (expected: ${e.expected}, got: ${e.received})`:``}`).join(`
|
|
2942
|
+
`);return D_(`VIEWER_DATA_INVALID`,`Template "${n.id}" data validation failed:\n${r}\n\nExpected schema: ${JSON.stringify(n.inputSchema,null,2)}`,void 0,e.title)}}let r=n.supportedTransports.includes(`browser`),i=n.supportedTransports.includes(`mcp-app`);return t.preferBrowser||r&&!i?await Cg(e,n):i?Rg(e,n):D_(`VIEWER_TRANSPORT_UNSUPPORTED`,`Viewer template "${n.id}" does not support an available transport`,void 0,e.title)}},Bg=`ui://aikit/present.html`,Vg=`ui://aikit/present/{id}.html`,Hg=j(`present`);let Ug=0,Wg=``;const Gg=new Map,Kg=new Map;function qg(){return`ui://aikit/present/${`${Date.now().toString(36)}_${(++Ug).toString(36)}`}.html`}function Jg(){return Wg}function Yg(e){Wg=e}function Xg(e,t){let n=Kg.get(e);n&&clearTimeout(n),Gg.set(e,t),Kg.set(e,setTimeout(()=>{Gg.delete(e),Kg.delete(e)},3e4))}function Zg(e){return Gg.get(e)}function Qg(e){return e.match(/\/present\/(.+)\.html$/)?.[1]}const $g=new Ig;$g.register(zg),$g.register(Tg),$g.register(Fg);function e_(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}const t_=/\\u[0-9a-fA-F]{4}/,n_=/^\s*\|(?:[^|\r\n]+\|){2,}\s*$/,r_=/^\s*\|?(?:\s*:?-{3,}:?\s*\|){2,}\s*$/,i_=/\b(cli|terminal|tty|console|command(?:-|\s)?line)\b/i;function a_(e){let t=[e.value,e.markdown,e.text,e.content];for(let e of t)if(typeof e==`string`&&e.trim().length>0)return e}function o_(e){let t=e.split(/\r?\n/);for(let e=0;e<t.length-1;e+=1)if(n_.test(t[e])&&r_.test(t[e+1]))return!0;return!1}function s_(e){let t=e.trim().split(`|`),n=+(t[0]?.trim()===``),r=t.at(-1)?.trim()===``?t.length-1:t.length;return t.slice(n,r).map(e=>e.trim())}function c_(e,t){if(t<2)return!1;let n=e.trim();return n.startsWith(`|`)?s_(n).length===t:!1}function l_(e){let t=e.split(/\r?\n/),n=[],r=[],i=()=>{r.length!==0&&(n.push({type:`text`,content:r.join(`
|
|
2943
|
+
`)}),r.length=0)},a=0;for(;a<t.length;){let e=t[a],o=t[a+1];if(o!==void 0&&n_.test(e)&&r_.test(o)){let r=s_(e),o=[];i();let s=a+2;for(;s<t.length&&c_(t[s],r.length);)o.push(s_(t[s])),s+=1;n.push({type:`table`,headers:r,rows:o}),a=s;continue}r.push(e),a+=1}return i(),n}function u_(e){let t=a_(e);return!t||!o_(t)?[e]:l_(t).flatMap(e=>{if(e.type===`text`){let t=e.content.trim();return t.length>0?[{type:`markdown`,value:t}]:[]}return[{type:`table`,value:{headers:e.headers,rows:e.rows}}]})}function d_(e){if(typeof e==`string`)return i_.test(e);if(Array.isArray(e))return e.some(e=>d_(e));if(!e_(e))return!1;let t=[`client`,`clientInfo`,`host`,`source`,`mode`,`name`,`title`,`channel`];return Object.entries(e).some(([e,n])=>t.includes(e)?d_(n):!1)}function f_(e,t){return{preferBrowser:[t,e._meta,e_(e.metadata)?e.metadata.source:void 0].some(e=>d_(e))}}const p_={id:`__dismiss`,type:`button`,label:`Done`,variant:`default`};function m_(e){if((e.actions?.length??0)>0||!e.template)return e;let t=dh(e);return t?.supportedTransports.includes(`browser`)===!0&&!t.supportedTransports.includes(`mcp-app`)?{...e,actions:[p_]}:e}function h_(e){if(!e.template)return!0;let t=Fm(e.template);return t?t.supportedTransports.includes(`browser`):dh(e)?.supportedTransports.includes(`browser`)??!1}function g_(e,t,n={}){let r=n.includeSurfaceHeader??!0,i=r?[e.title]:[];return r&&e.description&&i.push(e.description),Kr(t)?i.push(``,`Selected action: ${t.result.actionId}`):Gr(t)?i.push(``,`Error: ${t.error.message}`):t.kind===`timeout`?i.push(``,`Timed out after ${t.waitedMs}ms.`):t.kind===`cancelled`?i.push(``,`Cancelled: ${t.reason}.`):r||i.push(`Rendered inline.`),i.join(`
|
|
2944
|
+
`)}const __=`<style>
|
|
2948
2945
|
.toolbar, .badge, .aikit-header, .aikit-footer { display: none !important; }
|
|
2949
2946
|
body { padding-top: 0 !important; margin-top: 0 !important; }
|
|
2950
|
-
</style>`,
|
|
2947
|
+
</style>`,v_=`<script>
|
|
2951
2948
|
window.addEventListener('message', function(e) {
|
|
2952
2949
|
// Accept from any origin — theme change is cosmetic-only.
|
|
2953
2950
|
// Strict origin check breaks in MCP host custom protocols (ui://, vscode-webview://)
|
|
@@ -2959,7 +2956,7 @@ window.addEventListener('message', function(e) {
|
|
|
2959
2956
|
}
|
|
2960
2957
|
}
|
|
2961
2958
|
});
|
|
2962
|
-
<\/script>`;function
|
|
2959
|
+
<\/script>`;function y_(e){return`<script nonce="${e}">
|
|
2963
2960
|
(function() {
|
|
2964
2961
|
var iframe = document.querySelector('.present-viewer-iframe');
|
|
2965
2962
|
if (!iframe) return;
|
|
@@ -2978,7 +2975,7 @@ window.addEventListener('message', function(e) {
|
|
|
2978
2975
|
iframe.addEventListener('load', sendTheme);
|
|
2979
2976
|
trySend();
|
|
2980
2977
|
})();
|
|
2981
|
-
<\/script>`}function
|
|
2978
|
+
<\/script>`}function b_(e){let t=e.replace(`</head>`,`${__}\n</head>`);t===e&&Hg.warn(`injectEmbeddedViewerRuntime: </head> not found — viewer style not injected`);let n=t.replace(`</body>`,`<script>
|
|
2982
2979
|
(function() {
|
|
2983
2980
|
function report() {
|
|
2984
2981
|
var h = document.documentElement.scrollHeight;
|
|
@@ -2988,7 +2985,7 @@ window.addEventListener('message', function(e) {
|
|
|
2988
2985
|
ro.observe(document.documentElement);
|
|
2989
2986
|
report();
|
|
2990
2987
|
})();
|
|
2991
|
-
<\/script>\n${
|
|
2988
|
+
<\/script>\n${v_}\n</body>`);return n===t&&Hg.warn(`injectEmbeddedViewerRuntime: </body> not found — runtime scripts not injected`),n}function x_(e){let t=`<script>
|
|
2992
2989
|
(function(){
|
|
2993
2990
|
var last=0;
|
|
2994
2991
|
function notify(){
|
|
@@ -2999,7 +2996,7 @@ window.addEventListener('message', function(e) {
|
|
|
2999
2996
|
if(typeof ResizeObserver!=="undefined"){new ResizeObserver(notify).observe(document.documentElement)}
|
|
3000
2997
|
else{setInterval(notify,500)}
|
|
3001
2998
|
})();
|
|
3002
|
-
<\/script>`;return e.includes(`</body>`)?e.replace(`</body>`,`${t}</body>`):`${e}${t}`}let
|
|
2999
|
+
<\/script>`;return e.includes(`</body>`)?e.replace(`</body>`,`${t}</body>`):`${e}${t}`}let S_=``;function C_(e){return`<script${e?` nonce="${Y(e)}"`:``}>
|
|
3003
3000
|
(function(){
|
|
3004
3001
|
var readyState = document.readyState;
|
|
3005
3002
|
var boot = function() {
|
|
@@ -3012,12 +3009,12 @@ window.addEventListener('message', function(e) {
|
|
|
3012
3009
|
boot();
|
|
3013
3010
|
}
|
|
3014
3011
|
})();
|
|
3015
|
-
<\/script>`}function
|
|
3016
|
-
`)}function
|
|
3017
|
-
`),n=t.lastIndexOf(t[0]);return{type:`code`,value:e>=0?t.slice(e+1,n).trimEnd():t}}return z_.test(t)?{type:`table`,value:t}:{type:`markdown`,value:t}}function V_(e,t){let n=I_[e];if(!n)return null;switch(e){case`M`:return{type:`metrics`,value:t};case`C`:return{type:`chart`,value:t};case`T`:case`tl`:return{type:`timeline`,value:t};case`g`:return{type:`graph`,value:t};case`tr`:return{type:`tree`,value:t};case`cl`:return{type:`checklist`,value:t};case`pr`:return{type:`progress`,value:t};case`sb`:return{type:`status-board`,value:t};case`kv`:return{type:`kv`,value:t};case`ac`:return{type:`actions`,value:t};case`di`:return{type:`mermaid`,value:t};case`s`:return{type:`separator`,value:t||!0};default:return{type:n,value:typeof t==`string`?t:String(t??``)}}}function H_(e){if(typeof e==`string`){let t=B_(e);return{type:t.type,value:t.value}}if(Array.isArray(e)){let[t,n]=e;if(typeof t==`string`){let e=V_(t,n);if(e)return e}return{type:`markdown`,value:String(t??``)}}if(typeof e==`object`&&e){let{blockId:t,...n}=e;return n}return{type:`markdown`,value:String(e??``)}}function U_(e){return{title:e.title??``,blocks:Array.isArray(e.blocks)?e.blocks.map(H_):[]}}function W_(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function G_(e){return W_(e)&&typeof e.schemaVersion==`number`&&e.schemaVersion===1}function K_(e){return W_(e)&&typeof e.schemaVersion==`number`&&e.schemaVersion!==1}function q_(e){return e.schemaVersion===1?typeof e.title!=`string`||e.title.length===0?{ok:!1,error:{code:`MISSING_TITLE`,reason:`ChannelSurface requires a non-empty title`}}:e.blocks!==void 0&&!Array.isArray(e.blocks)?{ok:!1,error:{code:`INVALID_BLOCKS`,reason:`blocks must be an array of TypedBlock objects`}}:{ok:!0,surface:e}:{ok:!1,error:{code:`UNSUPPORTED_SCHEMA_VERSION`,reason:`Unsupported schemaVersion: ${String(e.schemaVersion)}`}}}function J_(e){try{let t=re(e);return W_(t)?(t.schemaVersion===void 0&&(t.schemaVersion=1),Y_(t)):{ok:!1,error:{code:`INVALID_RAW_INPUT`,reason:`raw field must contain a JSON object (ChannelSurface)`}}}catch(e){return{ok:!1,error:{code:`INVALID_RAW_JSON`,reason:`Failed to parse raw field: ${e.message}`,hint:`JSON repair attempted. Ensure the raw string contains a valid ChannelSurface object. Common LLM errors (newlines in strings, trailing commas) are auto-repaired.`}}}}function Y_(e){if(Array.isArray(e)){if(e.length!==2)return{ok:!1,error:{code:`INVALID_PRESET_INPUT`,reason:`Preset input must be a [name, data] tuple`,hint:`Use [presetName, { title, ...fields }]`}};let[t,n]=e;if(typeof t!=`string`)return{ok:!1,error:{code:`INVALID_PRESET_INPUT`,reason:`Preset name must be a string`}};if(!W_(n))return{ok:!1,error:{code:`INVALID_PRESET_INPUT`,reason:`Preset data must be an object`}};let r=F_(t,n);return r?{ok:!0,surface:{schemaVersion:1,title:r.title,blocks:r.blocks}}:{ok:!1,error:{code:`UNKNOWN_PRESET`,reason:`Unknown preset: ${t}`,hint:`Available presets: summary, plan, understanding, bug-analyze, task-done, review, explore, decision`}}}if(K_(e))return{ok:!1,error:{code:`UNSUPPORTED_SCHEMA_VERSION`,reason:`Unsupported schemaVersion: ${String(e.schemaVersion)}`,hint:`Use schemaVersion: 1`}};if(G_(e))return q_(e);if(typeof e==`string`){let t=U_({blocks:[e]});return{ok:!0,surface:{schemaVersion:1,title:t.title||`Present`,blocks:t.blocks}}}if(W_(e)){if(typeof e.raw==`string`)return J_(e.raw);if(!(`blocks`in e)&&!(`title`in e))return{ok:!1,error:{code:`INVALID_INPUT`,reason:`Expected a ChannelSurface object, preset tuple, or shorthand input`}};let t=U_(e);return{ok:!0,surface:{schemaVersion:1,title:t.title||`Present`,blocks:t.blocks}}}return{ok:!1,error:{code:`INVALID_INPUT`,reason:`Expected a ChannelSurface object, preset tuple, or shorthand input`}}}const X_=R.object({label:R.string(),value:R.string(),description:R.string().optional()}),Z_=R.object({id:R.string().describe(`Unique action identifier`),type:R.enum([`button`,`select`,`multi-select`,`form-submit`,`text-submit`,`confirm`,`custom`]).describe(`Interactive action type`),label:R.string().describe(`Visible action label`),variant:R.enum([`primary`,`danger`,`default`]).optional(),options:R.array(X_).optional(),schema:R.record(R.string(),R.unknown()).optional()}),Q_=R.object({type:R.string(),title:R.string().optional(),value:R.unknown().optional(),language:R.string().optional()}).catchall(R.unknown()),$_={schemaVersion:R.literal(1).describe(`ChannelSurface schema version. Must be 1.`),title:R.string().describe(`Surface title shown to the user.`),description:R.string().optional().describe(`Optional supporting copy for the surface.`),template:R.string().optional().describe(`Optional template id such as report@1.`),layout:R.object({maxWidth:R.string().optional(),padding:R.string().optional(),columns:R.number().optional()}).optional(),blocks:R.array(Q_).optional().describe(`Typed block content for the surface.`),data:R.unknown().optional().describe(`Template data payload, if the template expands data.`),actions:R.array(Z_).optional().describe(`Interactive actions. Presence triggers browser transport.`),response:R.object({timeout:R.number().optional(),required:R.boolean().optional()}).optional(),metadata:R.object({surfaceId:R.string().optional(),createdAt:R.string().optional(),source:R.string().optional()}).optional(),colorScheme:R.enum([`light`,`dark`,`auto`]).optional(),lang:R.string().optional(),dir:R.enum([`ltr`,`rtl`,`auto`]).optional(),raw:R.string().optional().describe(`Raw JSON string with auto-repair. Accepts common LLM JSON errors (unescaped newlines in strings, trailing commas). Use for complex payloads with mermaid/code/markdown blocks.`),preferBrowser:R.boolean().optional().describe(`Force browser transport instead of inline rendering. Set true when user explicitly requests external browser or browser transport.`)};R.object({surfaceId:R.string(),actionId:R.string(),actionType:R.enum([`button`,`select`,`multi-select`,`form-submit`,`text-submit`,`confirm`,`custom`]),value:R.unknown().optional(),formData:R.record(R.string(),R.unknown()).optional(),selection:R.union([R.string(),R.array(R.string())]).optional(),label:R.string().optional(),timestamp:R.string(),sourceTransport:R.enum([`mcp-app`,`browser`,`export`])});function ev(e){let t=e.server?.getClientCapabilities?.();if(!t)return`unknown`;let n=Dr(t);return!n||Array.isArray(n.mimeTypes)&&n.mimeTypes.length>0&&!n.mimeTypes.includes(Er)?`unsupported`:`supported`}const tv=[{name:`summary`,description:`Title + markdown summary + optional metrics (pass/fail counts)`,inputSchema:{type:`object`,properties:{title:{type:`string`,description:`Section heading`},summary:{type:`string`,description:`Free-form markdown summary`},passed:{type:`number`,description:`Pass count for metrics`},failed:{type:`number`,description:`Fail count for metrics`}},required:[`title`]},example:JSON.stringify({title:`Build Summary`,summary:`All tests passed.`,passed:42,failed:0}),expandsTo:`blocks: [heading, markdown, metrics]`},{name:`plan`,description:`Title + heading per step + checklist items`,inputSchema:{type:`object`,properties:{title:{type:`string`},steps:{type:`array`,items:{type:`object`,properties:{label:{type:`string`},checked:{type:`boolean`}}}}},required:[`title`]},example:JSON.stringify({title:`Sprint Plan`,steps:[{label:`Write tests`,checked:!1},{label:`Deploy`,checked:!1}]}),expandsTo:`blocks: [heading, checklist]`},{name:`understanding`,description:`Title + markdown explanation + kv pairs`,inputSchema:{type:`object`,properties:{title:{type:`string`},explanation:{type:`string`},details:{type:`object`,additionalProperties:{type:`string`}}},required:[`title`,`explanation`]},example:JSON.stringify({title:`Architecture Overview`,explanation:`The system uses microservices.`,details:{Language:`TypeScript`,Runtime:`Node`}}),expandsTo:`blocks: [heading, markdown, kv]`},{name:`bug-analyze`,description:`Title + heading + severity/status kv + code block + markdown`,inputSchema:{type:`object`,properties:{title:{type:`string`},severity:{type:`string`},status:{type:`string`},code:{type:`string`},analysis:{type:`string`}},required:[`title`,`severity`,`status`]},example:JSON.stringify({title:`Null pointer in auth`,severity:`high`,status:`open`,code:`const x = obj.prop;`,analysis:`obj may be null when token missing.`}),expandsTo:`blocks: [heading, kv, code, markdown]`},{name:`task-done`,description:`Title + checklist of completed items + optional metrics`,inputSchema:{type:`object`,properties:{title:{type:`string`},items:{type:`array`,items:{type:`object`,properties:{label:{type:`string`},checked:{type:`boolean`}}}},completed:{type:`number`},total:{type:`number`}},required:[`title`,`items`]},example:JSON.stringify({title:`PR #42 Done`,items:[{label:`Lint pass`,checked:!0},{label:`Tests pass`,checked:!0}],completed:2,total:2}),expandsTo:`blocks: [heading, checklist, metrics]`},{name:`review`,description:`Title + criteria checklist + approval actions`,inputSchema:{type:`object`,properties:{title:{type:`string`,description:`Review title`},criteria:{type:`array`,description:`Checklist criteria items`,items:{type:`object`,properties:{label:{type:`string`},checked:{type:`boolean`}}}},annotations:{type:`array`,description:`Optional annotation items`,items:{type:`object`,properties:{label:{type:`string`},description:{type:`string`},severity:{type:`string`}}}},approval:{type:`object`,description:`Optional approval config`,properties:{prompt:{type:`string`},options:{type:`array`,items:{type:`object`,properties:{label:{type:`string`},value:{type:`string`}}}}}}},required:[`title`,`criteria`]},example:JSON.stringify({title:`Code Review`,criteria:[{label:`Tests included`,checked:!0},{label:`No regressions`,checked:!1}]}),expandsTo:`blocks: [heading, checklist] + actions: [approve, reject]`},{name:`explore`,description:`Title + heading per finding + code blocks`,inputSchema:{type:`object`,properties:{title:{type:`string`},findings:{type:`array`,items:{type:`object`,properties:{heading:{type:`string`},code:{type:`string`}}}}},required:[`title`,`findings`]},example:JSON.stringify({title:`Codebase Exploration`,findings:[{heading:`Auth flow`,code:`function login()`},{heading:`API routes`,code:`router.get("/api")`}]}),expandsTo:`blocks: [heading, code] per finding`},{name:`decision`,description:`Title + kv for recommendation + comparison blocks per option`,inputSchema:{type:`object`,properties:{title:{type:`string`},recommendation:{type:`string`},options:{type:`array`,items:{type:`object`,properties:{title:{type:`string`},items:{type:`array`,items:{type:`string`}}}}}},required:[`title`,`recommendation`]},example:JSON.stringify({title:`DB Choice`,recommendation:`PostgreSQL`,options:[{title:`Postgres`,items:[`ACID`,`Rich types`]},{title:`Mongo`,items:[`Schema-less`,`Horizontal`]}]}),expandsTo:`blocks: [heading, kv, comparison]`}];function nv(e,t){let n=W(`present`);try{let e=w(`present`);e&&S_(P(I(e,`dist`,`annotation-layer.js`),`utf8`))}catch{}kr(e,`present`,{title:n.title,description:"Render a ChannelSurface. Required: schemaVersion: 1, title. Supports blocks, template+data, named presets, and raw JSON string with auto-repair. Use `raw` for complex payloads (mermaid, code, many blocks) — common LLM JSON errors are auto-fixed. Actions use browser transport. Resources: aikit://schemas/channel-surface (schema+blocks), aikit://present/presets (presets), aikit://present/templates (viewers).",inputSchema:$_,annotations:n.annotations,_meta:Og(zg)},J(`present`,async(t,n)=>{let r=t,i=typeof r.preferBrowser==`boolean`?r.preferBrowser:void 0,a=Y_(t);if(!a.ok)return T_(a.error.code,a.error.reason,void 0,`Present`);let o=E_(a.surface,n);if(!o.ok)return o.response;let s=ev(e);return await A_(o.surface,{...o.options,preferBrowser:i??(o.options.preferBrowser||s===`unsupported`)})}));try{let t=new tr(zg,{list:void 0});e.registerResource(`Present View`,t,{description:`AI Kit present tool viewer`},async(e,t,n)=>{let r=Array.isArray(t.id)?t.id[0]:t.id,i=r?Yg(r):void 0;return{contents:[{uri:e.href,mimeType:Er,_meta:kg(),text:i??Kg()??`<html><body><p>No content generated yet. Call the present tool first.</p></body></html>`}]}})}catch{}function r(){try{let e=w(`present`);if(e)return P(I(e,`dist`,`index.html`),`utf8`)}catch{}return Kg()||`<html><body><p>Loading...</p></body></html>`}try{e.registerResource(`Present App`,Rg,{description:`AI Kit present app - entry point`},async()=>({contents:[{uri:Rg,mimeType:Er,_meta:kg(),text:r()}]}))}catch{}try{e.registerResource(`present-templates`,`aikit://present/templates`,{description:`List all registered present viewer templates with their input schemas`},async()=>{let e=Fm().map(e=>({id:e.id,label:e.label,description:e.description,transports:e.supportedTransports,inputSchema:e.inputSchema}));return{contents:[{uri:`aikit://present/templates`,mimeType:`application/json`,text:JSON.stringify(e,null,2)}]}})}catch{}try{e.registerResource(`present-presets`,`aikit://present/presets`,{description:`List all registered present presets with input schemas and examples`},async()=>({contents:[{uri:`aikit://present/presets`,mimeType:`application/json`,text:JSON.stringify(tv,null,2)}]}))}catch{}}const rv=j(`tools`);function iv(e,t){let n=new pr({structure:new hr,dependencies:new ur,symbols:new gr,patterns:new mr,entryPoints:new fr,diagrams:new dr}),r=W(`produce_knowledge`);e.registerTool(`produce_knowledge`,{title:r.title,description:`Run automated codebase analysis and produce synthesis instructions. Executes Tier 1 deterministic analyzers, then returns structured baselines and instructions for you to synthesize knowledge using remember.`,inputSchema:{scope:R.string().optional().describe(`Root path to analyze (defaults to workspace root)`),aspects:R.array(R.enum([`all`,`structure`,`dependencies`,`symbols`,`patterns`,`entry-points`,`diagrams`])).default([`all`]).describe(`Which analysis aspects to run`)},annotations:r.annotations},J(`produce_knowledge`,async({scope:e,aspects:r},i)=>{let a;try{a=ml(i).createTask(`Produce Knowledge`,3),a.progress(0,`Running analyzers`);let o=e??`.`;rv.info(`Running knowledge production`,{rootPath:o,aspects:r});let s=await n.runExtraction(o,r);try{let e=F(Tn(I(o)),de.onboard);ke(e,{recursive:!0});let t=`<!-- Generated by produce_knowledge at ${new Date().toISOString()} -->\n\n`;for(let[n,r]of Object.entries(s))r&&typeof r==`string`&&Fe(F(e,`${n}.md`),t+r,`utf-8`);rv.info(`Knowledge persisted to .ai/context/`,{files:Object.keys(s).length})}catch(e){rv.warn(`Failed to persist knowledge to .ai/context/`,{error:M(e)})}try{let e=I(Tn(I(o)),de.l0Cards);ke(e,{recursive:!0});let n=Pt({workspaceName:o,structure:s.structure?.output,entryPoints:s.entryPoints?.output,dependencies:s.dependencies?.output,symbols:s.symbols?.output});Fe(F(e,$e),n,`utf-8`),rv.info(`L0 workspace-core card generated`,{path:F(e,$e)}),t?.notifyL0CardChanged().catch(()=>{})}catch(e){rv.warn(`Failed to generate L0 workspace-core card`,{error:M(e)})}a.progress(1,`Synthesizing results`);let c=n.buildSynthesisInstructions(s,r);return a.complete(`Knowledge production complete`),{content:[{type:`text`,text:c+`
|
|
3012
|
+
<\/script>`}function w_(e){S_=e||``}function T_(e,t){if(!S_)return e;let n=`${`<script${t?` nonce="${Y(t)}"`:``}>${S_}<\/script>`}\n${C_(t||``)}`;return e.includes(`</body>`)?e.replace(`</body>`,`${n}\n</body>`):`${e}${n}`}function E_(e,t){return[`<!DOCTYPE html>`,`<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">`,`<title>Error — ${Y(e)}</title>`,`<style>`,` * { box-sizing: border-box; margin: 0; padding: 0; }`,` body { font-family: system-ui, -apple-system, sans-serif; min-height: 100vh; display: flex; align-items: center; justify-content: center; padding: 2rem; background: #fafafa; color: #333; }`,` .error-card { max-width: 560px; width: 100%; padding: 2.5rem; border-radius: 1rem; background: #fff; border: 1px solid #e5e7eb; box-shadow: 0 1px 3px rgba(0,0,0,0.06); }`,` .error-badge { display: inline-block; font-size: 0.75rem; font-weight: 600; text-transform: uppercase; letter-spacing: 0.05em; color: #dc2626; background: #fef2f2; border: 1px solid #fecaca; border-radius: 0.375rem; padding: 0.25rem 0.625rem; margin-bottom: 1rem; }`,` .error-title { font-size: 1.25rem; font-weight: 600; margin-bottom: 0.75rem; color: #111; }`,` .error-message { font-size: 0.875rem; line-height: 1.6; color: #6b7280; white-space: pre-wrap; word-break: break-word; }`,`</style></head><body>`,`<div class="error-card">`,` <span class="error-badge">Render Error</span>`,` <h1 class="error-title">${Y(e)}</h1>`,` <p class="error-message">${Y(t)}</p>`,`</div>`,`</body></html>`].join(`
|
|
3013
|
+
`)}function D_(e,t,n,r){return Yg(E_(r??`Present`,t)),{content:[{type:`text`,text:`[ERROR:VALIDATION] ${t}`}],isError:!0}}function O_(e,t){if(!e_(e)||!(`schemaVersion`in e))return{ok:!1,response:D_(`INVALID_CHANNEL_SURFACE`,`present expects a ChannelSurface object with schemaVersion: 1`)};if(e.schemaVersion!==1)return{ok:!1,response:D_(`UNSUPPORTED_SCHEMA_VERSION`,`Unsupported ChannelSurface schemaVersion: ${String(e.schemaVersion)}`)};if(typeof e.title==`string`&&t_.test(e.title))return{ok:!1,response:D_(`TITLE_UNICODE_ESCAPE_NOT_ALLOWED`,`Use actual Unicode characters in title, not escape sequences.`)};let n=Array.isArray(e.blocks)?{...e,blocks:e.blocks.flatMap(e=>{if(!e_(e)||e.type!==`markdown`)return[e];let t=a_(e);return!t||!o_(t)?[e]:u_(e)})}:e;return{ok:!0,surface:n,options:f_(n,t)}}const k_={id:`__feedback`,type:`text-submit`,label:`💬 Feedback`,variant:`default`};function A_(e){return!e.actions||e.actions.length===0||e.actions.some(e=>e.id===`__feedback`)?e:{...e,actions:[...e.actions,k_]}}function j_(e){return(e.actions?.length??0)>0||e.response?.required===!0?$g.getAll().some(e=>e.id===`browser`):!1}async function M_(e,t={}){let n=j_(e)?{...t,preferBrowser:!0}:t,r=m_(e),i=$g.select(r,n),a=i?.id===`browser`?A_(r):r,o;if(o=i?await i.render(a,n):Pg(a),t.compact){let{structuredContent:e,...t}=o;return t}return o}function Z(e,t=``){return typeof e==`string`?e:typeof e==`number`||typeof e==`boolean`?String(e):t}function N_(e){return{type:`kv`,value:e}}function P_(e){if(Array.isArray(e))return e}const F_=[{name:`summary`,description:`Title + markdown summary + optional metrics (pass/fail counts)`,expand(e){let t=Z(e.title,`Summary`),n=[{type:`heading`,value:t}],r=Z(e.summary);r&&n.push({type:`markdown`,value:r});let i=Number(e.passed)||0,a=Number(e.failed)||0;if(i>0||a>0){let e=[];i>0&&e.push({label:`Passed`,value:i,status:`success`}),a>0&&e.push({label:`Failed`,value:a,status:`error`}),n.push({type:`metrics`,value:e})}return{title:t,blocks:n}}},{name:`plan`,description:`Title + heading per step + checklist items`,expand(e){let t=Z(e.title,`Plan`),n=[{type:`heading`,value:t}],r=P_(e.steps);return r&&n.push({type:`checklist`,value:{items:r}}),{title:t,blocks:n}}},{name:`understanding`,description:`Title + markdown explanation + kv pairs`,expand(e){let t=Z(e.title,`Understanding`),n=[{type:`heading`,value:t}],r=Z(e.explanation);return r&&n.push({type:`markdown`,value:r}),e.details&&typeof e.details==`object`&&!Array.isArray(e.details)&&n.push(N_(e.details)),{title:t,blocks:n}}},{name:`bug-analyze`,description:`Title + heading + severity/status kv + code block + markdown`,expand(e){let t=Z(e.title,`Bug Analysis`),n=[{type:`heading`,value:t}],r={};e.severity&&(r.Severity=e.severity),e.status&&(r.Status=e.status),Object.keys(r).length>0&&n.push({type:`kv`,value:r});let i=Z(e.code);i&&n.push({type:`code`,value:i});let a=Z(e.analysis);return a&&n.push({type:`markdown`,value:a}),{title:t,blocks:n}}},{name:`task-done`,description:`Title + checklist of completed items + optional metrics`,expand(e){let t=Z(e.title,`Task Complete`),n=[{type:`heading`,value:t}],r=P_(e.items);r&&n.push({type:`checklist`,value:{items:r}});let i=e.completed,a=e.total;if(i!==void 0||a!==void 0){let e=[];i!==void 0&&e.push({label:`Completed`,value:Number(i)||i,status:`success`}),a!==void 0&&e.push({label:`Total`,value:Number(a)||a}),n.push({type:`metrics`,value:e})}return{title:t,blocks:n}}},{name:`review`,description:`Title + criteria checklist + annotation items + approval controls`,expand(e){let t=Z(e.title,`Review`),n=[{type:`heading`,value:t}],r=P_(e.criteria);r&&n.push({type:`checklist`,value:{items:r}});let i=e.annotations;Array.isArray(i)&&i.length>0&&n.push({type:`annotation`,value:i});let a=e.approval;return a&&typeof a==`object`?n.push({type:`approval`,value:a}):n.push({type:`actions`,value:[{type:`button`,id:`approve`,label:`Approve`,variant:`primary`},{type:`button`,id:`reject`,label:`Reject`,variant:`danger`}]}),{title:t,blocks:n}}},{name:`explore`,description:`Title + heading per finding + code blocks`,expand(e){let t=Z(e.title,`Exploration`),n=[{type:`heading`,value:t}],r=P_(e.findings);if(r)for(let e of r)n.push({type:`heading`,value:Z(e.heading,`Finding`)}),e.code&&n.push({type:`code`,value:e.code});return{title:t,blocks:n}}},{name:`decision`,description:`Title + kv for recommendation + comparison blocks per option`,expand(e){let t=Z(e.title,`Decision`),n=[{type:`heading`,value:t}];e.recommendation&&n.push({type:`kv`,value:{Recommendation:e.recommendation}});let r=P_(e.options);return r&&r.length>0&&n.push({type:`comparison`,value:r.map(e=>({title:Z(e.title,`Option`),items:Array.isArray(e.items)?e.items:[]}))}),{title:t,blocks:n}}}],I_=new Map;for(let e of F_)I_.set(e.name,e);function L_(e,t){let n=I_.get(e);return n?n.expand(t):null}const R_={h:`heading`,m:`markdown`,t:`table`,p:`paragraph`,c:`code`,s:`separator`,M:`metrics`,C:`chart`,T:`timeline`,g:`graph`,tr:`tree`,tl:`timeline`,cl:`checklist`,pr:`progress`,sb:`status-board`,kv:`kv`,ac:`actions`,di:`mermaid`},z_=/^(#{1,6})\s/,B_=/^(`{3,}|~{3,})/,V_=/^\|.+\|.+\|/m;function H_(e){let t=e.trim(),n=t.match(z_);if(n)return{type:`heading`,value:t.slice(n[0].length)};if(B_.test(t)){let e=t.indexOf(`
|
|
3014
|
+
`),n=t.lastIndexOf(t[0]);return{type:`code`,value:e>=0?t.slice(e+1,n).trimEnd():t}}return V_.test(t)?{type:`table`,value:t}:{type:`markdown`,value:t}}function U_(e,t){let n=R_[e];if(!n)return null;switch(e){case`M`:return{type:`metrics`,value:t};case`C`:return{type:`chart`,value:t};case`T`:case`tl`:return{type:`timeline`,value:t};case`g`:return{type:`graph`,value:t};case`tr`:return{type:`tree`,value:t};case`cl`:return{type:`checklist`,value:t};case`pr`:return{type:`progress`,value:t};case`sb`:return{type:`status-board`,value:t};case`kv`:return{type:`kv`,value:t};case`ac`:return{type:`actions`,value:t};case`di`:return{type:`mermaid`,value:t};case`s`:return{type:`separator`,value:t||!0};default:return{type:n,value:typeof t==`string`?t:String(t??``)}}}function W_(e){if(typeof e==`string`){let t=H_(e);return{type:t.type,value:t.value}}if(Array.isArray(e)){let[t,n]=e;if(typeof t==`string`){let e=U_(t,n);if(e)return e}return{type:`markdown`,value:String(t??``)}}if(typeof e==`object`&&e){let{blockId:t,...n}=e;return n}return{type:`markdown`,value:String(e??``)}}function G_(e){return{title:e.title??``,blocks:Array.isArray(e.blocks)?e.blocks.map(W_):[]}}function K_(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function q_(e){return K_(e)&&typeof e.schemaVersion==`number`&&e.schemaVersion===1}function J_(e){return K_(e)&&typeof e.schemaVersion==`number`&&e.schemaVersion!==1}function Y_(e){return e.schemaVersion===1?typeof e.title!=`string`||e.title.length===0?{ok:!1,error:{code:`MISSING_TITLE`,reason:`ChannelSurface requires a non-empty title`}}:e.blocks!==void 0&&!Array.isArray(e.blocks)?{ok:!1,error:{code:`INVALID_BLOCKS`,reason:`blocks must be an array of TypedBlock objects`}}:{ok:!0,surface:e}:{ok:!1,error:{code:`UNSUPPORTED_SCHEMA_VERSION`,reason:`Unsupported schemaVersion: ${String(e.schemaVersion)}`}}}function X_(e){try{let t=re(e);return K_(t)?(t.schemaVersion===void 0&&(t.schemaVersion=1),Z_(t)):{ok:!1,error:{code:`INVALID_RAW_INPUT`,reason:`raw field must contain a JSON object (ChannelSurface)`}}}catch(e){return{ok:!1,error:{code:`INVALID_RAW_JSON`,reason:`Failed to parse raw field: ${e.message}`,hint:`JSON repair attempted. Ensure the raw string contains a valid ChannelSurface object. Common LLM errors (newlines in strings, trailing commas) are auto-repaired.`}}}}function Z_(e){if(Array.isArray(e)){if(e.length!==2)return{ok:!1,error:{code:`INVALID_PRESET_INPUT`,reason:`Preset input must be a [name, data] tuple`,hint:`Use [presetName, { title, ...fields }]`}};let[t,n]=e;if(typeof t!=`string`)return{ok:!1,error:{code:`INVALID_PRESET_INPUT`,reason:`Preset name must be a string`}};if(!K_(n))return{ok:!1,error:{code:`INVALID_PRESET_INPUT`,reason:`Preset data must be an object`}};let r=L_(t,n);return r?{ok:!0,surface:{schemaVersion:1,title:r.title,blocks:r.blocks}}:{ok:!1,error:{code:`UNKNOWN_PRESET`,reason:`Unknown preset: ${t}`,hint:`Available presets: summary, plan, understanding, bug-analyze, task-done, review, explore, decision`}}}if(J_(e))return{ok:!1,error:{code:`UNSUPPORTED_SCHEMA_VERSION`,reason:`Unsupported schemaVersion: ${String(e.schemaVersion)}`,hint:`Use schemaVersion: 1`}};if(q_(e))return Y_(e);if(typeof e==`string`){let t=G_({blocks:[e]});return{ok:!0,surface:{schemaVersion:1,title:t.title||`Present`,blocks:t.blocks}}}if(K_(e)){if(typeof e.raw==`string`)return X_(e.raw);if(!(`blocks`in e)&&!(`title`in e))return{ok:!1,error:{code:`INVALID_INPUT`,reason:`Expected a ChannelSurface object, preset tuple, or shorthand input`}};let t=G_(e);return{ok:!0,surface:{schemaVersion:1,title:t.title||`Present`,blocks:t.blocks}}}return{ok:!1,error:{code:`INVALID_INPUT`,reason:`Expected a ChannelSurface object, preset tuple, or shorthand input`}}}const Q_=R.object({label:R.string(),value:R.string(),description:R.string().optional()}),$_=R.object({id:R.string().describe(`Unique action identifier`),type:R.enum([`button`,`select`,`multi-select`,`form-submit`,`text-submit`,`confirm`,`custom`]).describe(`Interactive action type`),label:R.string().describe(`Visible action label`),variant:R.enum([`primary`,`danger`,`default`]).optional(),options:R.array(Q_).optional(),schema:R.record(R.string(),R.unknown()).optional()}),ev=R.object({type:R.string(),title:R.string().optional(),value:R.unknown().optional(),language:R.string().optional()}).catchall(R.unknown()),tv={schemaVersion:R.literal(1).describe(`ChannelSurface schema version. Must be 1.`),title:R.string().describe(`Surface title shown to the user.`),description:R.string().optional().describe(`Optional supporting copy for the surface.`),template:R.string().optional().describe(`Optional template id such as report@1.`),layout:R.object({maxWidth:R.string().optional(),padding:R.string().optional(),columns:R.number().optional()}).optional(),blocks:R.array(ev).optional().describe(`Typed block content for the surface.`),data:R.unknown().optional().describe(`Template data payload, if the template expands data.`),actions:R.array($_).optional().describe(`Interactive actions. Presence triggers browser transport.`),response:R.object({timeout:R.number().optional(),required:R.boolean().optional()}).optional(),metadata:R.object({surfaceId:R.string().optional(),createdAt:R.string().optional(),source:R.string().optional()}).optional(),colorScheme:R.enum([`light`,`dark`,`auto`]).optional(),lang:R.string().optional(),dir:R.enum([`ltr`,`rtl`,`auto`]).optional(),raw:R.string().optional().describe(`Raw JSON string with auto-repair. Accepts common LLM JSON errors (unescaped newlines in strings, trailing commas). Use for complex payloads with mermaid/code/markdown blocks.`),preferBrowser:R.boolean().optional().describe(`Force browser transport instead of inline rendering. Set true when user explicitly requests external browser or browser transport.`)};R.object({surfaceId:R.string(),actionId:R.string(),actionType:R.enum([`button`,`select`,`multi-select`,`form-submit`,`text-submit`,`confirm`,`custom`]),value:R.unknown().optional(),formData:R.record(R.string(),R.unknown()).optional(),selection:R.union([R.string(),R.array(R.string())]).optional(),label:R.string().optional(),timestamp:R.string(),sourceTransport:R.enum([`mcp-app`,`browser`,`export`])});function nv(e){let t=e.server?.getClientCapabilities?.();if(!t)return`unknown`;let n=Dr(t);return!n||Array.isArray(n.mimeTypes)&&n.mimeTypes.length>0&&!n.mimeTypes.includes(Er)?`unsupported`:`supported`}const rv=[{name:`summary`,description:`Title + markdown summary + optional metrics (pass/fail counts)`,inputSchema:{type:`object`,properties:{title:{type:`string`,description:`Section heading`},summary:{type:`string`,description:`Free-form markdown summary`},passed:{type:`number`,description:`Pass count for metrics`},failed:{type:`number`,description:`Fail count for metrics`}},required:[`title`]},example:JSON.stringify({title:`Build Summary`,summary:`All tests passed.`,passed:42,failed:0}),expandsTo:`blocks: [heading, markdown, metrics]`},{name:`plan`,description:`Title + heading per step + checklist items`,inputSchema:{type:`object`,properties:{title:{type:`string`},steps:{type:`array`,items:{type:`object`,properties:{label:{type:`string`},checked:{type:`boolean`}}}}},required:[`title`]},example:JSON.stringify({title:`Sprint Plan`,steps:[{label:`Write tests`,checked:!1},{label:`Deploy`,checked:!1}]}),expandsTo:`blocks: [heading, checklist]`},{name:`understanding`,description:`Title + markdown explanation + kv pairs`,inputSchema:{type:`object`,properties:{title:{type:`string`},explanation:{type:`string`},details:{type:`object`,additionalProperties:{type:`string`}}},required:[`title`,`explanation`]},example:JSON.stringify({title:`Architecture Overview`,explanation:`The system uses microservices.`,details:{Language:`TypeScript`,Runtime:`Node`}}),expandsTo:`blocks: [heading, markdown, kv]`},{name:`bug-analyze`,description:`Title + heading + severity/status kv + code block + markdown`,inputSchema:{type:`object`,properties:{title:{type:`string`},severity:{type:`string`},status:{type:`string`},code:{type:`string`},analysis:{type:`string`}},required:[`title`,`severity`,`status`]},example:JSON.stringify({title:`Null pointer in auth`,severity:`high`,status:`open`,code:`const x = obj.prop;`,analysis:`obj may be null when token missing.`}),expandsTo:`blocks: [heading, kv, code, markdown]`},{name:`task-done`,description:`Title + checklist of completed items + optional metrics`,inputSchema:{type:`object`,properties:{title:{type:`string`},items:{type:`array`,items:{type:`object`,properties:{label:{type:`string`},checked:{type:`boolean`}}}},completed:{type:`number`},total:{type:`number`}},required:[`title`,`items`]},example:JSON.stringify({title:`PR #42 Done`,items:[{label:`Lint pass`,checked:!0},{label:`Tests pass`,checked:!0}],completed:2,total:2}),expandsTo:`blocks: [heading, checklist, metrics]`},{name:`review`,description:`Title + criteria checklist + approval actions`,inputSchema:{type:`object`,properties:{title:{type:`string`,description:`Review title`},criteria:{type:`array`,description:`Checklist criteria items`,items:{type:`object`,properties:{label:{type:`string`},checked:{type:`boolean`}}}},annotations:{type:`array`,description:`Optional annotation items`,items:{type:`object`,properties:{label:{type:`string`},description:{type:`string`},severity:{type:`string`}}}},approval:{type:`object`,description:`Optional approval config`,properties:{prompt:{type:`string`},options:{type:`array`,items:{type:`object`,properties:{label:{type:`string`},value:{type:`string`}}}}}}},required:[`title`,`criteria`]},example:JSON.stringify({title:`Code Review`,criteria:[{label:`Tests included`,checked:!0},{label:`No regressions`,checked:!1}]}),expandsTo:`blocks: [heading, checklist] + actions: [approve, reject]`},{name:`explore`,description:`Title + heading per finding + code blocks`,inputSchema:{type:`object`,properties:{title:{type:`string`},findings:{type:`array`,items:{type:`object`,properties:{heading:{type:`string`},code:{type:`string`}}}}},required:[`title`,`findings`]},example:JSON.stringify({title:`Codebase Exploration`,findings:[{heading:`Auth flow`,code:`function login()`},{heading:`API routes`,code:`router.get("/api")`}]}),expandsTo:`blocks: [heading, code] per finding`},{name:`decision`,description:`Title + kv for recommendation + comparison blocks per option`,inputSchema:{type:`object`,properties:{title:{type:`string`},recommendation:{type:`string`},options:{type:`array`,items:{type:`object`,properties:{title:{type:`string`},items:{type:`array`,items:{type:`string`}}}}}},required:[`title`,`recommendation`]},example:JSON.stringify({title:`DB Choice`,recommendation:`PostgreSQL`,options:[{title:`Postgres`,items:[`ACID`,`Rich types`]},{title:`Mongo`,items:[`Schema-less`,`Horizontal`]}]}),expandsTo:`blocks: [heading, kv, comparison]`}];function iv(e,t){let n=W(`present`);try{let e=w(`present`);e&&w_(P(I(e,`dist`,`annotation-layer.js`),`utf8`))}catch{}kr(e,`present`,{title:n.title,description:"Render a ChannelSurface. Required: schemaVersion: 1, title. Supports blocks, template+data, named presets, and raw JSON string with auto-repair. Use `raw` for complex payloads (mermaid, code, many blocks) — common LLM JSON errors are auto-fixed. Actions use browser transport. Resources: aikit://schemas/channel-surface (schema+blocks), aikit://present/presets (presets), aikit://present/templates (viewers).",inputSchema:tv,annotations:n.annotations,_meta:Ag(Vg)},J(`present`,async(t,n)=>{let r=t,i=typeof r.preferBrowser==`boolean`?r.preferBrowser:void 0,a=Z_(t);if(!a.ok)return D_(a.error.code,a.error.reason,void 0,`Present`);let o=O_(a.surface,n);if(!o.ok)return o.response;let s=nv(e);return await M_(o.surface,{...o.options,preferBrowser:i??(o.options.preferBrowser||s===`unsupported`)})}));try{let t=new tr(Vg,{list:void 0});e.registerResource(`Present View`,t,{description:`AI Kit present tool viewer`},async(e,t,n)=>{let r=Array.isArray(t.id)?t.id[0]:t.id,i=r?Zg(r):void 0;return{contents:[{uri:e.href,mimeType:Er,_meta:jg(),text:i??Jg()??`<html><body><p>No content generated yet. Call the present tool first.</p></body></html>`}]}})}catch{}function r(){try{let e=w(`present`);if(e)return P(I(e,`dist`,`index.html`),`utf8`)}catch{}return Jg()||`<html><body><p>Loading...</p></body></html>`}try{e.registerResource(`Present App`,Bg,{description:`AI Kit present app - entry point`},async()=>({contents:[{uri:Bg,mimeType:Er,_meta:jg(),text:r()}]}))}catch{}try{e.registerResource(`present-templates`,`aikit://present/templates`,{description:`List all registered present viewer templates with their input schemas`},async()=>{let e=Lm().map(e=>({id:e.id,label:e.label,description:e.description,transports:e.supportedTransports,inputSchema:e.inputSchema}));return{contents:[{uri:`aikit://present/templates`,mimeType:`application/json`,text:JSON.stringify(e,null,2)}]}})}catch{}try{e.registerResource(`present-presets`,`aikit://present/presets`,{description:`List all registered present presets with input schemas and examples`},async()=>({contents:[{uri:`aikit://present/presets`,mimeType:`application/json`,text:JSON.stringify(rv,null,2)}]}))}catch{}}const av=j(`tools`);function ov(e,t){let n=new pr({structure:new hr,dependencies:new ur,symbols:new gr,patterns:new mr,entryPoints:new fr,diagrams:new dr}),r=W(`produce_knowledge`);e.registerTool(`produce_knowledge`,{title:r.title,description:`Run automated codebase analysis and produce synthesis instructions. Executes Tier 1 deterministic analyzers, then returns structured baselines and instructions for you to synthesize knowledge using remember.`,inputSchema:{scope:R.string().optional().describe(`Root path to analyze (defaults to workspace root)`),aspects:R.array(R.enum([`all`,`structure`,`dependencies`,`symbols`,`patterns`,`entry-points`,`diagrams`])).default([`all`]).describe(`Which analysis aspects to run`)},annotations:r.annotations},J(`produce_knowledge`,async({scope:e,aspects:r},i)=>{let a;try{a=gl(i).createTask(`Produce Knowledge`,3),a.progress(0,`Running analyzers`);let o=e??`.`;av.info(`Running knowledge production`,{rootPath:o,aspects:r});let s=await n.runExtraction(o,r);try{let e=F(Tn(I(o)),de.onboard);ke(e,{recursive:!0});let t=`<!-- Generated by produce_knowledge at ${new Date().toISOString()} -->\n\n`;for(let[n,r]of Object.entries(s))r&&typeof r==`string`&&Fe(F(e,`${n}.md`),t+r,`utf-8`);av.info(`Knowledge persisted to .ai/context/`,{files:Object.keys(s).length})}catch(e){av.warn(`Failed to persist knowledge to .ai/context/`,{error:M(e)})}try{let e=I(Tn(I(o)),de.l0Cards);ke(e,{recursive:!0});let n=Pt({workspaceName:o,structure:s.structure?.output,entryPoints:s.entryPoints?.output,dependencies:s.dependencies?.output,symbols:s.symbols?.output});Fe(F(e,$e),n,`utf-8`),av.info(`L0 workspace-core card generated`,{path:F(e,$e)}),t?.notifyL0CardChanged().catch(()=>{})}catch(e){av.warn(`Failed to generate L0 workspace-core card`,{error:M(e)})}a.progress(1,`Synthesizing results`);let c=n.buildSynthesisInstructions(s,r);return a.complete(`Knowledge production complete`),{content:[{type:`text`,text:c+`
|
|
3018
3015
|
|
|
3019
3016
|
---
|
|
3020
|
-
_Next: Review the baselines above and use \`remember\` to store synthesized knowledge entries._`}]}}catch(e){return a?.fail?.(`Production failed`),
|
|
3017
|
+
_Next: Review the baselines above and use \`remember\` to store synthesized knowledge entries._`}]}}catch(e){return a?.fail?.(`Production failed`),av.error(`Knowledge production failed`,M(e)),q(`INTERNAL`,`Knowledge production failed: ${e instanceof Error?e.message:String(e)}`)}}))}const sv=j(`tools`);function cv(e,t,n,r,i,a,o){let s=W(`reindex`);e.registerTool(`reindex`,{title:s.title,description:`Trigger re-indexing of the AI Kit index. Can do incremental (only changed files) or full re-index. When smart indexing is active, use force: true to override the automatic trickle indexer.`,inputSchema:{full:R.boolean().default(!1).describe(`If true, force full re-index ignoring file hashes`),force:R.boolean().default(!1).describe(`If true, override smart indexing guard and run reindex anyway`)},annotations:s.annotations},J(`reindex`,async({full:e,force:s},c)=>{try{if(t.isIndexing)return{content:[{type:`text`,text:`## Reindex Already in Progress
|
|
3021
3018
|
|
|
3022
3019
|
A reindex operation is currently running. Search and other tools continue to work with existing data. Use \`status({})\` to check when it completes.`}]};if(o===`smart`&&!s)return{content:[{type:`text`,text:`## Smart Indexing Active
|
|
3023
3020
|
|
|
@@ -3025,53 +3022,53 @@ Smart indexing (trickle mode) is enabled — files are automatically indexed as
|
|
|
3025
3022
|
|
|
3026
3023
|
**If the index is severely outdated**, use \`reindex({ force: true })\` to override.
|
|
3027
3024
|
|
|
3028
|
-
Use \`status({})\` to check smart indexing queue status.`}]};let l=
|
|
3025
|
+
Use \`status({})\` to check smart indexing queue status.`}]};let l=gl(c).createTask(`Reindex`,1);l.progress(0,`Starting ${e?`full`:`incremental`} reindex`),sv.info(`Starting background re-index`,{mode:e?`full`:`incremental`});let u=e=>t=>{t.phase===`chunking`&&t.currentFile&&sv.debug(`Re-index progress`,{prefix:e,current:t.filesProcessed+1,total:t.filesTotal,file:t.currentFile})};return(e?t.reindexAll(n,u(`Reindex`)):t.index(n,u(`Index`))).then(async e=>{if(sv.info(`Background re-index complete`,{filesProcessed:e.filesProcessed,chunksCreated:e.chunksCreated,durationMs:e.durationMs}),l.complete(`Reindex complete: ${e.filesProcessed} files, ${e.chunksCreated} chunks in ${e.durationMs}ms`),i)try{await i.createFtsIndex(),sv.info(`FTS index rebuilt after reindex`)}catch(e){sv.warn(`FTS index rebuild failed`,M(e))}try{let e=await r.reindexAll();sv.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){sv.warn(`Curated re-index failed`,M(e))}if(a)try{await a.notifyAfterReindex()}catch(e){sv.warn(`Post-reindex resource notification failed`,M(e))}}).catch(e=>{l.fail(`Reindex failed: ${e instanceof Error?e.message:String(e)}`),sv.error(`Background reindex failed`,M(e))}),{content:[{type:`text`,text:`## Reindex Started (Background)\n\n- **Mode**: ${e?`Full`:`Incremental`}\n- Search and other tools continue to work with existing data during reindex.\n- Completion will be logged. Use \`status({})\` to check index stats afterward.\n\n---\n_Next: Continue working — the reindex runs in the background._`}]}}catch(e){return sv.error(`Reindex failed`,M(e)),q(`INTERNAL`,`Reindex failed: ${e instanceof Error?e.message:String(e)}`)}}))}const lv=j(`tools`);function uv(e){let t=W(`replay`);e.registerTool(`replay`,{title:t.title,description:`View or clear the audit trail of recent MCP tool and CLI invocations. Shows tool name, duration, status, and input/output summaries.`,inputSchema:{action:R.enum([`list`,`clear`]).default(`list`).describe(`Action: "list" (default) to view entries, "clear" to wipe the log`),last:R.number().optional().describe(`Number of entries to return (default: 20, list only)`),tool:R.string().optional().describe(`Filter by tool name (list only)`),source:R.enum([`mcp`,`cli`]).optional().describe(`Filter by source: "mcp" or "cli" (list only)`),since:R.string().optional().describe(`ISO timestamp — only show entries after this time (list only)`)},annotations:t.annotations},J(`replay`,async({action:e,last:t,tool:n,source:r,since:i})=>{try{if(e===`clear`)return xn(),{content:[{type:`text`,text:`Replay log cleared.`}]};let a=Sn({last:t,tool:n,source:r,since:i});if(a.length===0)return{content:[{type:`text`,text:`No replay entries found. Activity is logged when tools are invoked via MCP or CLI.`}]};let o=a.map(e=>`${e.ts.split(`T`)[1]?.split(`.`)[0]??e.ts} ${e.status===`ok`?`✓`:`✗`} ${e.tool} (${e.durationMs}ms) [${e.source}]\n in: ${e.input}\n out: ${e.output}`);return Cn().catch(()=>{}),{content:[{type:`text`,text:`**Replay Log** (${a.length} entries)\n\n${o.join(`
|
|
3029
3026
|
|
|
3030
|
-
`)}`}]}}catch(e){return
|
|
3027
|
+
`)}`}]}}catch(e){return lv.error(`Replay failed`,M(e)),q(`INTERNAL`,`Replay failed: ${e instanceof Error?e.message:String(e)}`)}}))}const dv=j(`tools`);function fv(e){let t=W(`restore`);e.registerTool(`restore`,{title:t.title,description:`List and restore file snapshots taken before destructive operations (codemod, rename, forget). Use action=list to see available restore points, action=restore with an id to undo.`,inputSchema:{action:R.enum([`list`,`restore`]).describe(`list: show restore points, restore: apply a restore point`),id:R.string().optional().describe(`Restore point ID (required for action=restore)`),limit:R.number().min(1).max(50).default(10).describe(`Max restore points to list`)},annotations:t.annotations},async({action:e,id:t,limit:n})=>{try{if(e===`list`){let e=Yt().slice(0,n);return e.length===0?{content:[{type:`text`,text:`No restore points found.`}]}:{content:[{type:`text`,text:`## Restore Points\n\n${e.map(e=>`- **${e.id}** (${e.timestamp}) — ${e.operation}: ${e.description} (${e.files.length} files)`).join(`
|
|
3031
3028
|
`)}`}]}}if(!t)throw Error(`id is required for restore action`);let r=await En(t);return{content:[{type:`text`,text:`Restored ${r.length} files:\n${r.map(e=>`- \`${e}\``).join(`
|
|
3032
|
-
`)}`}]}}catch(e){return
|
|
3029
|
+
`)}`}]}}catch(e){return dv.error(`Restore failed`,M(e)),q(`INTERNAL`,`Restore failed: ${e instanceof Error?e.message:String(e)}`)}})}const pv=/<\/?curated-context>/gi;function mv(e){return e.replace(pv,``)}function hv(e){return`<curated-context>\n${mv(e)}\n</curated-context>`}const gv=j(`tools`);function _v(e,t,n,r){b(e,t,n);let i=e.memoryMetaGet(t);if(!i)return;let a=g(i,{..._,...r});a&&(y(e,t,a),v(e,t,n))}function vv(e,t){let n=[],r=De(),i=r?Ie(r):``;i&&n.push(`[project: ${i}]`);let a=t?Fn(t,`__context_boost`):void 0;return a&&n.push(`[focus: ${a.value}]`),n.length===0?e:`${n.join(` `)} ${e}`}function yv(e,t,n){return n?e:t===`curated`?e*1.2:e}function bv(e,t){return t?e:e.map(e=>({record:e.record,score:yv(e.score,e.record.origin,t)})).sort((e,t)=>t.score-e.score)}function xv(e,t){let n=e?Math.floor(e/Math.max(1,t)):96;return Math.max(40,Math.min(160,n))}function Sv(e,t){let n=e.origin===`curated`?hv(e.content):e.content,r=L(n,t);return{body:r,truncated:r!==n}}async function Cv(e,t,n,r,i){if(!e||t>=e.config.fallbackThreshold&&n.length>0)return{results:n,triggered:!1,cacheHit:!1};let a=!1;try{let t=e.cache.get(r);return t?a=!0:(t=await e.client.search(r,i),t.length>0&&e.cache.set(r,t)),t.length>0?{results:Tr(n,t,i).map(e=>({record:{id:`er:${e.sourcePath}`,content:e.content,sourcePath:e.source===`er`?`[ER] ${e.sourcePath}`:e.sourcePath,startLine:e.startLine??0,endLine:e.endLine??0,contentType:e.contentType??`documentation`,headingPath:e.headingPath,origin:e.source===`er`?`curated`:e.origin??`indexed`,category:e.category,tags:e.tags??[],chunkIndex:0,totalChunks:1,fileHash:``,indexedAt:new Date().toISOString(),version:1},score:e.score})),triggered:!0,cacheHit:a}:{results:n,triggered:!0,cacheHit:a}}catch(e){return gv.warn(`ER fallback failed`,M(e)),{results:n,triggered:!0,cacheHit:a}}}function wv(e,t,n=60){let r=new Map,i=e[0]?.score||1,a=t[0]?.score||1;for(let t=0;t<e.length;t++){let a=e[t],o=a.score/i;r.set(a.record.id,{record:a.record,score:1/(n+t+1)*o})}for(let e=0;e<t.length;e++){let i=t[e],o=i.score/a,s=r.get(i.record.id);s?s.score+=1/(n+e+1)*o:r.set(i.record.id,{record:i.record,score:1/(n+e+1)*o})}return[...r.values()].sort((e,t)=>t.score-e.score).map(({record:e,score:t})=>({record:e,score:t*(n+1)}))}function Tv(e,t){let n=t.toLowerCase().split(/\s+/).filter(e=>e.length>=2);return n.length<2?e:e.map(e=>{let t=e.record.content.toLowerCase();if(t.length>5e3)return e;let r=n.map(e=>{let n=[],r=t.indexOf(e);for(;r!==-1&&n.length<10;)n.push(r),r=t.indexOf(e,r+1);return n});if(r.some(e=>e.length===0))return e;let i=t.length;for(let e of r[0]){let t=e,a=e+n[0].length;for(let i=1;i<r.length;i++){let o=r[i][0],s=Math.abs(o-e);for(let t=1;t<r[i].length;t++){let n=Math.abs(r[i][t]-e);n<s&&(s=n,o=r[i][t])}t=Math.min(t,o),a=Math.max(a,o+n[i].length)}i=Math.min(i,a-t)}let a=1+.25/(1+i/200);return{record:e.record,score:e.score*a}}).sort((e,t)=>t.score-e.score)}function Ev(e){if(e.length<=1)return e;let t=new Set;return e.filter(e=>{let n=e.record.contentHash;return n?t.has(n)?!1:(t.add(n),!0):!0})}function Dv(e,t,n=8){let r=new Set(t.toLowerCase().split(/\s+/).filter(e=>e.length>=2)),i=new Map,a=e.length;for(let t of e){let e=t.record.content.split(/[^a-zA-Z0-9_]+/).filter(e=>e.length>=3&&!Ov.has(e.toLowerCase())),n=new Set;for(let t of e){let e=t.toLowerCase();/[_A-Z]/.test(t)&&i.set(`__id__${e}`,1),n.has(e)||(n.add(e),i.set(e,(i.get(e)??0)+1))}}let o=[];for(let[e,t]of i){if(e.startsWith(`__id__`)||r.has(e)||t>a*.8)continue;let n=Math.log(a/t),s=+!!i.has(`__id__${e}`),c=e.length>8?.5:0;o.push({term:e,score:n+s+c})}return o.sort((e,t)=>t.score-e.score).slice(0,n).map(e=>e.term)}const Ov=new Set(`the.and.for.are.but.not.you.all.can.had.her.was.one.our.out.has.have.from.this.that.with.they.been.said.each.which.their.will.other.about.many.then.them.these.some.would.make.like.into.could.time.very.when.come.just.know.take.people.also.back.after.only.more.than.over.such.import.export.const.function.return.true.false.null.undefined.string.number.boolean.void.type.interface`.split(`.`));async function kv(e,t){try{let n=await e.getStats();if(!n.lastIndexedAt)return;let r=new Date(n.lastIndexedAt).getTime(),i=Date.now(),a=[...new Set(t.map(e=>e.record.sourcePath))].filter(e=>!e.startsWith(`[ER]`)).slice(0,5);if(a.length===0)return;let o=0;for(let e of a)try{(await Ge(e)).mtimeMs>r&&o++}catch{o++}if(o>0){let e=i-r,t=Math.floor(e/6e4),n=t<1?`<1 min`:`${t} min`;return`> ⚠️ **Index may be stale** — ${o} file(s) modified since last index (${n} ago). Use \`reindex\` to refresh.`}}catch{}}function Av(e,t,n,r,i,a,o,s,c,l,u){let d=W(`search`);e.registerTool(`search`,{title:d.title,description:`Search AI Kit for code, docs, and prior decisions. Default choice for discovery. Modes: hybrid (default), semantic, keyword. For multi-strategy precision queries use find; for a known file path use lookup.`,outputSchema:fc,inputSchema:{query:R.string().max(5e3).describe(`Natural language search query`),limit:R.number().min(1).max(20).default(5).describe(`Maximum results to return`),search_mode:R.enum([`hybrid`,`semantic`,`keyword`]).default(`hybrid`).describe(`Search strategy: hybrid (vector + FTS + RRF fusion, default), semantic (vector only), keyword (FTS only)`),content_type:R.enum(fe).optional().describe(`Filter by content type`),source_type:R.enum(ve).optional().describe(`Coarse filter: "source" (code only), "documentation" (md, curated), "test", "config". Overrides content_type if both set.`),origin:R.enum(ge).optional().describe(`Filter by knowledge origin`),category:R.string().optional().describe(`Filter by category (e.g., decisions, patterns, conventions)`),tags:R.array(R.string()).optional().describe(`Filter by exact tag membership (any supplied tag may match)`),min_score:R.number().min(0).max(1).default(.25).describe(`Minimum similarity score`),graph_hops:R.number().min(0).max(3).default(1).describe(`Number of graph hops to augment results with connected entities (0 = disabled, 1 = direct connections, 2-3 = deeper traversal). Default 1 provides module/symbol context automatically.`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),min_confidence:R.enum([`extracted`,`inferred`,`ambiguous`]).optional().describe(`Minimum confidence level for results: "extracted" (guaranteed correct from source code), "inferred" (LLM-derived), "ambiguous" (uncertain, needs verification). Lower values include more results.`),dedup:R.enum([`file`,`chunk`]).default(`chunk`).describe(`Deduplication mode: "chunk" (default, show all matching chunks) or "file" (collapse chunks from same file into single result with merged line ranges)`),workspaces:R.array(R.string()).optional().describe(`Cross-workspace search: partition names or folder basenames to include. Use ["*"] for all registered workspaces. Only works in user-level install mode.`)},annotations:d.annotations},async({query:e,limit:d,search_mode:f,content_type:p,source_type:m,origin:h,category:g,tags:_,min_score:v,min_confidence:y,graph_hops:b,max_tokens:x,dedup:S,workspaces:C})=>{let w=Date.now();try{let T={limit:d,minScore:v,contentType:p,sourceType:m,origin:h,category:g,tags:_},E,D=!1,O=!1,k=``,ee=f!==`keyword`,te=vv(e,s);if(f===`keyword`)E=await n.ftsSearch(e,T),E=E.slice(0,d);else if(f===`semantic`)try{let r=await t.embedQuery(te);E=await n.search(r,T);let a=await Cv(i,E[0]?.score??0,E,e,d);E=a.results,D=a.triggered,O=a.cacheHit}catch(t){ee=!1,gv.warn(`Embedder unavailable in semantic mode, falling back to FTS`,M(t)),E=await n.ftsSearch(e,{...T,limit:d}),k=`> _⚠️ Semantic search unavailable (embedder recovering). Showing keyword results instead._
|
|
3033
3030
|
|
|
3034
|
-
`}else{let r=[],a=[];try{let i=await t.embedQuery(te),o=n.coarseSearch,s=o?o.bind(n):n.search.bind(n);[r,a]=await Promise.all([s(i,{...T,limit:d*2}),n.ftsSearch(e,{...T,limit:d*2}).catch(()=>[])])}catch(t){ee=!1,
|
|
3031
|
+
`}else{let r=[],a=[];try{let i=await t.embedQuery(te),o=n.coarseSearch,s=o?o.bind(n):n.search.bind(n);[r,a]=await Promise.all([s(i,{...T,limit:d*2}),n.ftsSearch(e,{...T,limit:d*2}).catch(()=>[])])}catch(t){ee=!1,gv.warn(`Embedder unavailable, falling back to FTS-only`,M(t)),a=await n.ftsSearch(e,{...T,limit:d*2}),k=`> _⚠️ Vector search unavailable (embedder recovering). Results from keyword search only._
|
|
3035
3032
|
|
|
3036
|
-
`}if(ee?r.length===0&&a.length>0?(E=a.slice(0,d),k=` (FTS-only: vector index rebuilding)`):E=a.length===0&&r.length>0?r.slice(0,d):
|
|
3037
|
-
`)[0].slice(0,500);if(r&&r!==e){let i=f===`keyword`||!ee?await n.ftsSearch(r,T):await n.search(await t.embedQuery(r),T);i.length>0&&(E=i,k=`> _Original query "${e}" returned 0 results. Auto-reformulated to "${r}"._\n\n`,
|
|
3033
|
+
`}if(ee?r.length===0&&a.length>0?(E=a.slice(0,d),k=` (FTS-only: vector index rebuilding)`):E=a.length===0&&r.length>0?r.slice(0,d):wv(r,a).slice(0,d):E=a.slice(0,d),ee){let t=await Cv(i,r[0]?.score??0,E,e,d);E=t.results,D=t.triggered,O=t.cacheHit}}E=bv(E,h).slice(0,d),a&&a.recordSearch(e,D,O),E.length>1&&(E=Tv(E,e)),E=Ev(E);let ne=``;if(C&&C.length>0){let n=Xl(C,u);if(n.length>0){let{stores:r,closeAll:i}=await Zl(n);try{let i;i=f===`keyword`||!ee?await $l(r,e,{...T,limit:d}):await Ql(r,await t.embedQuery(e),{...T,limit:d});for(let e of i)E.push({record:{...e.record,sourcePath:`[${e.workspace}] ${e.record.sourcePath}`},score:e.score});E=E.sort((e,t)=>t.score-e.score).slice(0,d),ne=` + ${n.length} workspace(s)`}finally{await i()}}}if(S===`file`&&E.length>1){let e=new Map;for(let t of E){let n=t.record.sourcePath,r=e.get(n);r?(t.score>r.best.score&&(r.best=t),r.ranges.push({start:t.record.startLine,end:t.record.endLine})):e.set(n,{best:t,ranges:[{start:t.record.startLine,end:t.record.endLine}]})}E=[...e.values()].sort((e,t)=>t.best.score-e.best.score).map(({best:e,ranges:t})=>({record:{...e.record,content:t.length>1?`${e.record.content}\n\n_Matched ${t.length} sections: ${t.sort((e,t)=>e.start-t.start).map(e=>`L${e.start}-${e.end}`).join(`, `)}_`:e.record.content},score:e.score}))}if(E.length>1){let e=E[0].score,t=Math.max(e*.4,.1);E=E.filter(e=>e.score>=t)}let re={extracted:3,inferred:2,ambiguous:1};if(y){let e=re[y]??0;E=E.filter(t=>(t.record.confidence?re[t.record.confidence]??2:2)>=e)}if(E.length===0){if(o?.available)try{let r=(await o.createMessage({prompt:`The search query "${e}" returned 0 results in AI Kit code search. Suggest ONE alternative search query that might find relevant results. Reply with ONLY the alternative query, nothing else.`,systemPrompt:`You are a search query optimizer for AI Kit code search. Generate a single alternative query.`,maxTokens:100,timeoutMs:1e4})).text.trim().split(`
|
|
3034
|
+
`)[0].slice(0,500);if(r&&r!==e){let i=f===`keyword`||!ee?await n.ftsSearch(r,T):await n.search(await t.embedQuery(r),T);i.length>0&&(E=i,k=`> _Original query "${e}" returned 0 results. Auto-reformulated to "${r}"._\n\n`,gv.debug(`Smart search fallback succeeded`,{originalQuery:e,altQuery:r,resultCount:i.length}))}}catch(e){gv.debug(`Smart search fallback failed`,{error:String(e)})}if(E.length===0){let t=_t({text:`No results found for the given query.`,query:e,searchMode:f,limit:d,results:[],durationMs:Date.now()-w}),n=ru(t.summary);return{content:[{type:`text`,text:iu(t.summary,n)}],isError:!t.ok,structuredContent:{...t.data??{results:[],totalResults:0,searchMode:f,query:e},ref:n}}}}let ie,ae;if(b>0&&!r&&(ae="> **Note:** `graph_hops` was set but no graph store is available. Graph augmentation skipped."),b>0&&r)try{let e=await Lt(r,E.map(e=>({recordId:e.record.id,score:e.score,sourcePath:e.record.sourcePath})),{hops:b,maxPerHit:5});ie=new Map;for(let t of e)if(t.graphContext.nodes.length>0){let e=t.graphContext.nodes.slice(0,5).map(e=>` - **${e.name}** (${e.type})`).join(`
|
|
3038
3035
|
`),n=new Map;for(let e of t.graphContext.nodes)n.set(e.id,e.name);let r=t.graphContext.edges.slice(0,5).map(e=>` - ${n.get(e.fromId)??e.fromId} —[${e.type}]→ ${n.get(e.toId)??e.toId}`).join(`
|
|
3039
3036
|
`),i=[`- **Graph Context** (${b} hop${b>1?`s`:``}):`];e&&i.push(` Entities:\n${e}`),r&&i.push(` Relationships:\n${r}`),ie.set(t.recordId,i.join(`
|
|
3040
|
-
`))}}catch(e){
|
|
3041
|
-
`),{body:a,truncated:o}=
|
|
3037
|
+
`))}}catch(e){gv.warn(`Graph augmentation failed`,M(e)),ae=`> **Note:** Graph augmentation failed. Results shown without graph context.`}let oe=Date.now();for(let e of E)if(e.record.origin===`curated`&&e.record.indexedAt){let t=oe-new Date(e.record.indexedAt).getTime(),n=Math.max(0,t/864e5);e.score*=.95**n}if(E.sort((e,t)=>t.score-e.score),E=rt(E),s)for(let e of E){if(e.record.origin!==`curated`)continue;let t=Wd(e.record.sourcePath);t&&_v(s,t,c,l)}let se=xv(x,E.length),ce=!1,le=E.map((e,t)=>{let n=e.record,r=`### Result ${t+1} (score: ${e.score.toFixed(3)})`,i=[`- **Source**: ${n.sourcePath}`,n.headingPath?`- **Section**: ${n.headingPath}`:null,`- **Type**: ${n.contentType}`,n.startLine?`- **Lines**: ${n.startLine}-${n.endLine}`:null,n.origin===`indexed`?null:`- **Origin**: ${n.origin}`,n.category?`- **Category**: ${n.category}`:null,n.tags?.length?`- **Tags**: ${n.tags.join(`, `)}`:null,ie?.get(n.id)??null].filter(Boolean).join(`
|
|
3038
|
+
`),{body:a,truncated:o}=Sv(n,se);return ce||=o,`${r}\n${i}\n\n${a}${o?`\n\n_Full content: use \`lookup\` on \`${n.sourcePath}\`._`:``}`}).join(`
|
|
3042
3039
|
|
|
3043
3040
|
---
|
|
3044
3041
|
|
|
3045
|
-
`),ue=(f===`hybrid`?`hybrid (vector + keyword RRF)`:f===`keyword`?`keyword (FTS)`:`semantic (vector)`)+ne,A=
|
|
3042
|
+
`),ue=(f===`hybrid`?`hybrid (vector + keyword RRF)`:f===`keyword`?`keyword (FTS)`:`semantic (vector)`)+ne,A=Dv(E,e),de=A.length>0?`\n_Distinctive terms: ${A.map(e=>`\`${e}\``).join(`, `)}_`:``,fe=await kv(n,E),pe=[];if(E.length===0)pe.push("`reindex` — no results found, index may be stale"),pe.push("`find` — try federated search with glob/regex");else{let e=E[0]?.record.sourcePath;e&&pe.push(`\`lookup\` — see all chunks from \`${e}\``),pe.push("`symbol` — resolve a specific symbol from the results"),pe.push("`compact` — compress a result file for focused reading")}let me=[ae?`${ae}\n\n`:``,fe?`${fe}\n\n`:``,le,`\n\n---\n_Search mode: ${ue} | ${E.length} results_${de}`,`\n_Next: ${pe.join(` | `)}_`],he=k+me.join(``),ge=!1;if(x){let e=L(he,x);ge=e!==he,he=e}ge||=ce;let _e=E.map(e=>({sourcePath:e.record.sourcePath,contentType:e.record.contentType,score:e.score,...e.record.headingPath?{headingPath:e.record.headingPath}:{},...e.record.startLine?{startLine:e.record.startLine}:{},...e.record.endLine?{endLine:e.record.endLine}:{},...e.record.origin===`indexed`?{}:{origin:e.record.origin},...e.record.category?{category:e.record.category}:{},...e.record.tags?.length?{tags:e.record.tags}:{}})),ve=[ae,fe].filter(e=>!!e),ye=_t({text:he,query:e,searchMode:f,limit:d,results:_e,durationMs:Date.now()-w,truncated:ge,caveats:ve}),be=ru(ye.summary),xe=new Set,j=[];for(let e of E){if(e.record.origin!==`curated`||e.record.sourcePath.startsWith(`[`))continue;let t=Wd(e.record.sourcePath);if(!t)continue;let n=Hd(t,e.record.headingPath??t);n&&!xe.has(n.uri)&&(xe.add(n.uri),j.push(n))}return{content:[{type:`text`,text:iu(ye.summary,be)},...j],isError:!ye.ok,structuredContent:{...ye.data??{results:[],totalResults:0,searchMode:f,query:e},ref:be}}}catch(t){gv.error(`Search failed`,M(t));let n=_t({text:`Search failed: ${t instanceof Error?t.message:String(t)}`,query:e??``,searchMode:f??`hybrid`,limit:d,results:[],durationMs:Date.now()-w}),r=ru(n.summary);return{content:[{type:`text`,text:iu(n.summary,r)}],structuredContent:{...n.data??{results:[],totalResults:0,searchMode:f??`hybrid`,query:e??``},ref:r}}}})}const jv=j(`tools`);function Mv(e,t,n){let r=W(`session_digest`);e.registerTool(`session_digest`,{title:r.title,description:`Compress the current session's tool trajectory into a focused digest. Aggregates replay log, stash state, and checkpoints. Supports deterministic and LLM-assisted (sampling) modes with configurable token budget.`,inputSchema:{scope:R.enum([`tools`,`stash`,`all`]).default(`all`).describe(`What to include: tools (replay only), stash (stash + checkpoints only), or all`),since:R.string().optional().describe(`ISO timestamp — only include activity after this time`),last:R.number().min(1).max(500).optional().describe(`Max replay entries to consider (default: 50)`),focus:R.string().optional().describe(`Focus query — prioritize entries matching this topic`),mode:R.enum([`deterministic`,`sampling`]).default(`deterministic`).describe(`Summary mode: deterministic (fast, template-based) or sampling (LLM-assisted, richer)`),token_budget:R.number().min(100).max(8e3).default(2e3).describe(`Target token budget for the digest output`),persist:R.boolean().default(!0).describe(`Auto-save digest to stash for crash recovery`)},annotations:r.annotations},J(`session_digest`,async({scope:e,since:r,last:i,focus:a,mode:o,token_budget:s,persist:c})=>{try{let l={scope:e,since:r,last:i,focus:a,mode:o,tokenBudget:s,persist:c},u=t?{stateStore:t}:void 0;return{content:[{type:`text`,text:(o===`sampling`&&n?.available?await Mn(l,async(e,t,r)=>(await n.createMessage({prompt:e,systemPrompt:t,maxTokens:r})).text,u):jn(l,u)).digest}]}}catch(e){return jv.error(`Session digest failed`,M(e)),q(`INTERNAL`,`Session digest failed: ${e instanceof Error?e.message:String(e)}`)}}))}const Nv=1e4,Pv={defaultTtlSeconds:300,defaultLeaseTtlMinutes:10,globalEnabled:!1};function Fv(e){return e??Pv}function Iv(e,t){let n=e.trim();if(!n)throw Error(`${t} is required`);return n}function Lv(e,t,n){let r=Iv(e,t);if(r.length>n)throw Error(`${t} exceeds max length of ${n}`);return r}function Rv(e,t){if(!Number.isFinite(e)||e<=0)throw Error(`${t} must be greater than 0`);return Math.trunc(e)}function zv(e,t=!1,n){Iv(e,`workspace`);let r=Fv(n);if(!t)return e;if(!r.globalEnabled)throw Error(`Global signal scope is disabled`);return`__global__`}function Bv(e,t,n){let r=Fv(n),i=zv(t.workspace,t.global??!1,r),a=Lv(t.key,`key`,500),o=Lv(t.value,`value`,Nv),s=t.agent?Lv(t.agent,`agent`,500):void 0,c=Rv(t.ttlSeconds??r.defaultTtlSeconds,`ttlSeconds`);return e.signalPost(i,a,o,s,c)}function Vv(e,t,n){let r=Iv(t,`workspace`),i=Lv(n,`key`,500);return e.signalGet(r,i)}function Hv(e,t){let n=Iv(t,`workspace`);return e.signalList(n)}function Uv(e,t,n){let r=Iv(t,`workspace`),i=n===void 0?void 0:Lv(n,`key`,500);return e.signalClear(r,i)}function Wv(e,t,n){let r=Fv(n),i=Lv(t.resource,`resource`,500),a=Lv(t.holder,`holder`,500),o=Iv(t.workspace,`workspace`),s=t.intent?Lv(t.intent,`intent`,Nv):void 0,c=Rv(t.ttlMinutes??r.defaultLeaseTtlMinutes,`ttlMinutes`);if(c>60)throw Error(`ttlMinutes exceeds max of 60`);let l=e.leaseAcquire(i,a,o,s,c),u=e.leaseGet(i,o);return u?{acquired:l,holder:u.holder,expiresAt:u.expiresAt}:{acquired:l}}function Gv(e,t,n,r){let i=Iv(t,`workspace`),a=Lv(n,`resource`,500),o=Lv(r,`holder`,500);return e.leaseRelease(a,o,i)}function Kv(e,t){let n=Iv(t,`workspace`);return e.leaseList(n)}const qv=j(`tools:signal`);function Jv(e){return JSON.stringify(e,null,2)}function Yv(e,t,n){let r=W(`signal`),i={...Pv,...n};e.registerTool(`signal`,{title:r.title,description:`Inter-agent signaling and lease coordination`,inputSchema:{action:R.enum([`post`,`get`,`list`,`clear`,`lease`,`unlease`,`leases`]).describe(`Signal action to perform`),workspace:R.string().describe(`Workspace identifier (required)`),key:R.string().optional().describe(`Signal key (for post/get/clear)`),value:R.string().optional().describe(`Signal value (for post)`),agent:R.string().optional().describe(`Agent identifier`),resource:R.string().optional().describe(`Resource path (for lease/unlease)`),holder:R.string().optional().describe(`Lease holder ID (for lease/unlease)`),intent:R.string().optional().describe(`What the holder plans to do`),ttl:R.number().optional().describe(`TTL (seconds for signals, minutes for leases)`),global:R.boolean().optional().describe(`Use global scope (default: false)`)},annotations:r.annotations},J(`signal`,async({action:e,workspace:n,key:r,value:a,agent:o,resource:s,holder:c,intent:l,ttl:u,global:d})=>{try{switch(e){case`post`:{if(!r||a===void 0)throw Error(`key and value are required for post`);let e=Bv(t,{workspace:n,key:r,value:a,agent:o,ttlSeconds:u,global:d},i);return{content:[{type:`text`,text:Jv({id:e})}],structuredContent:{id:e}}}case`get`:{if(!r)throw Error(`key is required for get`);let e=Vv(t,zv(n,d??!1,i),r);return{content:[{type:`text`,text:e.length===0?`[]`:Jv(e)}],structuredContent:{signals:e}}}case`list`:{let e=Hv(t,zv(n,d??!1,i));return{content:[{type:`text`,text:e.length===0?`[]`:Jv(e)}],structuredContent:{signals:e}}}case`clear`:{let e=Uv(t,zv(n,d??!1,i),r);return{content:[{type:`text`,text:Jv({cleared:e})}],structuredContent:{cleared:e}}}case`lease`:{if(!s||!c)throw Error(`resource and holder are required for lease`);let e=Wv(t,{resource:s,holder:c,workspace:n,intent:l,ttlMinutes:u},i);return{content:[{type:`text`,text:Jv(e)}],structuredContent:e}}case`unlease`:{if(!s||!c)throw Error(`resource and holder are required for unlease`);let e=Gv(t,n,s,c);return{content:[{type:`text`,text:Jv({released:e})}],structuredContent:{released:e}}}case`leases`:{let e=Kv(t,n);return{content:[{type:`text`,text:e.length===0?`[]`:Jv(e)}],structuredContent:{leases:e}}}}}catch(e){return qv.error(`Signal operation failed`,M(e)),q(`INTERNAL`,`Signal operation failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Xv(e,t){return e.length<=t?e:e.slice(0,t)}function Zv(e){if(!e)return 0;let t=Date.parse(e);return Number.isNaN(t)?0:t}function Qv(e){if(!e)return null;let t=I(e,`workspace-core.md`);if(!N(t))return null;try{let e=P(t,`utf-8`);return e.length>400?`${e.slice(0,400)}\n...`:e}catch{return null}}async function $v(e,t,n=d,r){if(!e||!t)return null;try{let[i,o,s]=await Promise.all([e.list({category:`lessons`,limit:200,orderBy:`updated`,order:`desc`}),e.list({category:`conventions`,limit:200,orderBy:`updated`,order:`desc`}),e.list({category:`session`,limit:200,orderBy:`updated`,order:`desc`})]),l=i.filter(e=>e.tags.includes(`lesson`)).map(e=>{let r=t.memoryMetaGet(e.path);return!r||r.supersededBy!=null?null:{entry:e,confidence:c(r.confidence,r.lastAccessedAt,r.createdAt,n)}}).filter(e=>e!==null).sort((e,t)=>t.confidence-e.confidence).slice(0,3);return{lessons:await Promise.all(l.map(async({entry:t,confidence:n})=>{let r=a((await e.read(t.path)).content);return{title:t.title,insight:Xv(r.insight??``,150),confidence:n}})),conventions:o.map(e=>({entry:e,lastAccessedAt:t.memoryMetaGet(e.path)?.lastAccessedAt??null})).filter(({entry:e})=>(e.contentPreview?.trim()??``).length>5).sort((e,t)=>Zv(t.lastAccessedAt)-Zv(e.lastAccessedAt)).slice(0,2).map(({entry:e})=>({title:e.title,preview:e.contentPreview})),checkpoint:s.map(e=>({entry:e,lastAccessedAt:t.memoryMetaGet(e.path)?.lastAccessedAt??null})).sort((e,t)=>Zv(t.lastAccessedAt)-Zv(e.lastAccessedAt)).map(({entry:e})=>Xv(e.contentPreview,200))[0]??null,workspaceCore:Qv(r)}}catch{return null}}function ey(e,t=600){if(!e)return{lines:[],totalChars:0,autoInjectCount:0};let n=[],r=0;for(let t of e.lessons){if(t.confidence<45)continue;let e=gp(t.title,t.insight,t.confidence,200);n.push(`• ${e}`),r++}e.workspaceCore&&(n.push(`• Workspace: ${e.workspaceCore.split(`
|
|
3046
3043
|
`)[0]??``}`),r++);for(let t of e.conventions){let e=t.preview?.trim()||``;if(e){let r=e.length>120?`${e.slice(0,117)}...`:e;n.push(`• ${t.title}: ${r}`)}else n.push(`• ${t.title}`)}if(n.length===0)return{lines:[],totalChars:0,autoInjectCount:0};let i=[`━━ Knowledge ━━`,...n,`───`],a=i.join(`
|
|
3047
3044
|
`);if(a.length>t)for(;i.length>3&&a.length>t;)i.splice(1,1)[0]?.startsWith(`•`)&&r--;return{lines:i,totalChars:i.join(`
|
|
3048
|
-
`).length,autoInjectCount:r}}const
|
|
3045
|
+
`).length,autoInjectCount:r}}const ty=j(`tools`),ny=14400*1e3,ry={includePrelude:R.boolean().default(!1).describe(`Include session prelude with top lessons, conventions, and last checkpoint`)};function iy(e,t,n,r=15e3){let i,a=new Promise(e=>{i=setTimeout(()=>{ty.warn(`Status sub-operation "${n}" timed out after ${r}ms`),e({value:t,timedOut:!0})},r)});return Promise.race([e.then(e=>(clearTimeout(i),{value:e,timedOut:!1}),e=>(clearTimeout(i),ty.warn(`Status sub-operation "${n}" failed: ${e instanceof Error?e.message:String(e)}`),{value:t,timedOut:!1})),a])}function ay(e){return e.onboarded?e.indexStale?{kind:`reindex`,reason:`Index stale. Run reindex() to update.`}:e.contextPressure>70?{kind:`handoff`,reason:`Context pressure high. Consider session handoff.`}:{kind:`proceed`,reason:`Ready to work.`}:{kind:`onboard`,reason:`Index not initialized. Run onboard({ path: "." }) first.`}}function oy(){let e=vr.get(),t=_r.get();if(e)return`- **Tree-sitter (WASM)**: ✅ Available (${t.grammarCount} grammars, dir: ${t.wasmDir})`;let n=t.pathsChecked.length?t.pathsChecked.map(e=>` ${e.exists?`✓`:`✗`} ${e.path}`).join(`
|
|
3049
3046
|
`):` none`,r=t.healAttempted?` Auto-heal: ${t.healSuccess?`✓ succeeded`:`✗ failed (${t.healError??`unknown`})`}`:` Auto-heal: not attempted`;return[`- **Tree-sitter (WASM)**: ⚠ Unavailable (regex fallback)`,` Reason: ${t.reason||`unknown`}`,` Paths checked:`,n,r,` OS: ${t.os} ${t.arch} | Node: ${t.nodeVersion}`,` Fix: Reinstall package or run vendor:wasm script`].join(`
|
|
3050
|
-
`)}const
|
|
3051
|
-
`)}],structuredContent:o}}))}function
|
|
3052
|
-
`),me=e||O>=
|
|
3053
|
-
`)};if(i.length===1)try{return{content:[{type:`text`,text:`${await a(i[0])}\n---\n_Next: Use \`web_fetch\` to read any of these pages in full._`}]}}catch(e){return
|
|
3054
|
-
|
|
3055
|
-
`);return c===o.length?q(`INTERNAL`,u):{content:[{type:`text`,text:u}]}}))}function
|
|
3056
|
-
`)}]}}catch(e){return
|
|
3057
|
-
`)}]}}))}function
|
|
3047
|
+
`)}const sy=5*6e4;let cy=null,ly=null;function uy(e,t,n,r){let i=Math.min(e/2e4,1),a=Math.min((t+n)/5e4,1),o=Math.min(r/200,1);return Math.round(i*40+a*35+o*25)}function dy(){let e=Date.now();if(cy&&e-cy.ts<sy)return cy.value;try{let t=I(Qn(),`.copilot`,`.aikit-scaffold.json`);if(!N(t))return cy={value:null,ts:e},null;let n=JSON.parse(P(t,`utf-8`)).version??null;return cy={value:n,ts:e},n}catch{return cy={value:null,ts:e},null}}function fy(){let e=Date.now();if(ly&&e-ly.ts<sy)return ly.value;try{let t=I(process.cwd(),`.github`,`.aikit-scaffold.json`);if(!N(t))return ly={value:null,ts:e},null;let n=JSON.parse(P(t,`utf-8`)).version??null;return ly={value:n,ts:e},n}catch{return ly={value:null,ts:e},null}}function py(e){let t=W(`status`);e.registerTool(`status`,{title:t.title,description:`Get the current status and statistics of the AI Kit index.`,inputSchema:ry,annotations:t.annotations},J(`status`,async()=>{let e=oe(),t=dy(),n=fy(),r=t!=null&&t!==e,i=n!=null&&n!==e,a=[`## AI Kit Status`,``,`⏳ **AI Kit is initializing** — index stats will be available shortly.`,``,`### Runtime`,`- **Tree-sitter (WASM)**: ${vr.get()?`✅ Available (AST analysis)`:`⚠ Unavailable (regex fallback)`}`,``,`### Version`,`- **Server**: ${e}`,`- **Scaffold (user)**: ${t??`not installed`}`,`- **Scaffold (workspace)**: ${n??`not installed`}`];if(r||i){let o=se(),s=[];r&&s.push(`user scaffold v${t}`),i&&s.push(`workspace scaffold v${n}`);let c=s.join(`, `);o.state===`success`?a.push(``,`### ✅ Upgrade Applied`,`- Server v${e} — ${c} auto-upgraded successfully.`,`- _Restart the MCP server to use the updated version._`):o.state===`pending`?a.push(``,`### ⏳ Upgrade In Progress`,`- Server v${e} ≠ ${c}`,`- Auto-upgrade is running in the background…`):o.state===`failed`?(ie(),a.push(``,`### ⬆ Upgrade Available (auto-upgrade failed, retrying)`,`- Server v${e} ≠ ${c}`,`- Error: ${o.error??`unknown`}`)):(ie(),a.push(``,`### ⬆ Upgrade Available`,`- Server v${e} ≠ ${c}`,`- Auto-upgrade triggered — check again shortly.`))}let o={totalRecords:0,totalFiles:0,lastIndexedAt:null,onboarded:!1,onboardDir:``,contentTypes:{},wasmAvailable:!!vr.get(),wasmDiagnostics:_r.get(),graphStats:null,curatedCount:0,serverVersion:e,scaffoldVersion:t??null,workspaceScaffoldVersion:n??null,upgradeAvailable:r||i,contextPressure:0,nextAction:ay({onboarded:!1,indexStale:!1,contextPressure:0})};return{content:[{type:`text`,text:a.join(`
|
|
3048
|
+
`)}],structuredContent:o}}))}function my(e,t,n,r,i,a,o,s,c){let l=W(`status`);e.registerTool(`status`,{title:l.title,description:`Get the current status and statistics of the AI Kit index.`,inputSchema:ry,annotations:l.annotations},J(`status`,async({includePrelude:e=!1})=>{let l=[];try{let[u,d]=await Promise.all([iy(t.getStats(),{totalRecords:0,totalFiles:0,lastIndexedAt:null,contentTypeBreakdown:{}},`store.getStats`),iy(t.listSourcePaths(),[],`store.listSourcePaths`)]),f=u.value;u.timedOut&&l.push(`⚠ Index stats timed out — values may be incomplete`);let p=d.value;d.timedOut&&l.push(`⚠ File listing timed out`);let m=null,h=0,g=[`## AI Kit Status`,``,`- **Total Records**: ${f.totalRecords}`,`- **Total Files**: ${f.totalFiles}`,`- **Last Indexed**: ${f.lastIndexedAt??`Never`}`,``,`### Content Types`,...Object.entries(f.contentTypeBreakdown).map(([e,t])=>`- ${e}: ${t}`),``,`### Indexed Files`,...p.slice(0,50).map(e=>`- ${e}`),p.length>50?`\n... and ${p.length-50} more files`:``];if(n)try{let e=await iy(n.getStats(),{nodeCount:0,edgeCount:0,nodeTypes:{},edgeTypes:{}},`graphStore.getStats`);if(e.timedOut)l.push(`⚠ Graph stats timed out`),g.push(``,`### Knowledge Graph`,`- Graph stats timed out`);else{let t=e.value;m={nodes:t.nodeCount,edges:t.edgeCount},g.push(``,`### Knowledge Graph`,`- **Nodes**: ${t.nodeCount}`,`- **Edges**: ${t.edgeCount}`,...Object.entries(t.nodeTypes).map(([e,t])=>` - ${e}: ${t}`));try{let e=await iy(n.validate(),{valid:!0,danglingEdges:[],orphanNodes:[],stats:{nodeCount:0,edgeCount:0,nodeTypes:{},edgeTypes:{}}},`graphStore.validate`);if(!e.timedOut){let t=e.value;t.valid||g.push(`- **⚠ Integrity Issues**: ${t.danglingEdges.length} dangling edges`),t.orphanNodes.length>0&&g.push(`- **Orphan nodes**: ${t.orphanNodes.length}`)}}catch{}}}catch{g.push(``,`### Knowledge Graph`,`- Graph store unavailable`)}let _=a?.onboardDir??``,v=N(_),y=i?.onboardComplete||v;if(g.push(``,`### Onboard Status`,y?`- ✅ Complete${i?.onboardTimestamp?` (last: ${i.onboardTimestamp})`:``}`:'- ❌ Not run — call `onboard({ path: "." })` to analyze the codebase',`- **Onboard Directory**: \`${_}\``),r)try{let e=await iy(r.count(),0,`curated.count`);e.timedOut?(l.push(`⚠ Curated knowledge count timed out`),g.push(``,`### Curated Knowledge`,`- Listing timed out`)):(h=e.value,g.push(``,`### Curated Knowledge`,h>0?`- ${h} entries`:'- Empty — use `knowledge({ action: "remember", ... })` to persist decisions'))}catch{g.push(``,`### Curated Knowledge`,`- Unable to read curated entries`)}let b=Wn().filter(e=>e.status===`watching`);if(b.length>0){g.push(``,`### File Watchers`,`- **Active**: ${b.length}`);for(let e of b){let t=e.pendingFiles?.length??0;if(g.push(` - \`${e.path}\`: ${e.eventCount} events, ${t} pending files`),t>0&&t<=10)for(let t of e.pendingFiles)g.push(` - \`${t}\``);else t>10&&g.push(` - ${t} pending files (use \`watch({ action: 'list' })\` for details)`)}}let x=uy(f.totalRecords,m?.nodes??0,m?.edges??0,h),S=f.lastIndexedAt?new Date(f.lastIndexedAt).getTime():0,C=S>0?Date.now()-S:1/0,w=ay({onboarded:y,indexStale:y&&C>1440*60*1e3,contextPressure:x});g.push(``),g.push(`## 📊 Context Pressure: ${x}/100`),x>=80?g.push(`⚠️ High pressure — consider pruning stale entries or compacting context.`):x>=50?g.push(`ℹ️ Moderate pressure — AI Kit memory is well-populated.`):g.push(`✅ Low pressure — plenty of headroom for more content.`);let T=0;if(f.lastIndexedAt){T=new Date(f.lastIndexedAt).getTime();let e=(Date.now()-T)/(1e3*60*60);g.push(``,`### Index Freshness`,e>24?o===`smart`?`- ⚠ Last indexed ${Math.floor(e)}h ago — smart indexing will refresh automatically`:`- ⚠ Last indexed ${Math.floor(e)}h ago — may be stale. Run \`reindex({})\``:`- ✅ Last indexed ${e<1?`less than 1h`:`${Math.floor(e)}h`} ago`)}g.push(``,`### Next Action`,`- **${w.kind}**: ${w.reason}`);let E=null,D=t;if(typeof D.getDiagnostics==`function`)try{let e=D.getDiagnostics();E={adapterType:e.adapterType,vectorSearchEnabled:e.vectorSearchEnabled,ftsEnabled:e.ftsEnabled,degradedMode:e.degradedMode,dbPath:e.dbPath,dbSizeBytes:e.dbSizeBytes,embeddingDim:e.embeddingDim,vectorDtype:e.vectorDtype},g.push(``,`### Storage`,`- **Backend**: ${a?.store?.backend??`unknown`}`,`- **Adapter**: ${E.adapterType}`,`- **Vector search**: ${E.vectorSearchEnabled?`✅ enabled`:`⚠ disabled (FTS-only fallback)`}`,E.dbPath?`- **DB**: ${E.dbPath}`:``,E.dbSizeBytes==null?``:`- **DB size**: ${(E.dbSizeBytes/1024/1024).toFixed(2)} MB`,`- **Embedding dim**: ${E.embeddingDim}`,`- **Vector dtype**: ${E.vectorDtype}`)}catch{}if(o===`smart`)if(g.push(``,`### Smart Indexing`),s){let e=s();e?g.push(`- **Mode**: Smart (trickle)`,`- **Status**: ${e.running?`✅ Running`:`⏸ Stopped`}`,`- **Queue**: ${e.queueSize} files pending`,`- **Changed files**: ${e.changedFilesSize} detected`,`- **Interval**: ${Math.round(e.intervalMs/1e3)}s per batch of ${e.batchSize}`):g.push(`- **Mode**: Smart (trickle)`,`- **Status**: scheduler state unavailable (init may have failed)`)}else g.push(`- **Mode**: Smart (trickle) — scheduler state unavailable`);let O=0;{try{let e=a?.stateDir?F(a.stateDir,`stash`):null;if(e&&N(e)){let t=Ne(e).mtimeMs;t>T&&(T=t)}}catch{}let e=[];if(r)try{let t=h>0?await r.list({limit:5,orderBy:`updated`,order:`desc`}):[];for(let e of t){let t=new Date(e.updated||e.created).getTime();t>T&&(T=t)}e.push(...t)}catch{}if(O=T>0?Date.now()-T:0,O>=ny){let t=Math.floor(O/36e5);if(g.push(``,`### 🌅 Session Briefing`,`_${t}+ hours since last activity — here's what to pick up:_`,``),e.length>0){g.push(`**Recent decisions/notes:**`);for(let t of e)g.push(`- **${t.title}** (${t.category??`note`}) — ${(t.contentPreview??``).slice(0,80)}…`)}g.push(``,`**Suggested next steps:**`,'- `search({ query: "SESSION CHECKPOINT", origin: "curated" })` — find your last checkpoint',"- `restore({})` — resume from a saved checkpoint",'- `knowledge({ action: "list" })` — browse all stored knowledge')}}g.push(``,`### Runtime`,oy());let k=he.instance().getAll(),ee=k.filter(e=>e.status!==`healthy`);if(ee.length>0){g.push(``,`### ⚠️ Subsystem Health`);for(let e of ee){let t=Math.round((Date.now()-e.since)/1e3);g.push(`- **${e.name}**: ${e.status} (${t}s ago${e.reason?` — ${e.reason}`:``})`)}}else k.length>0&&g.push(``,`### ✅ Subsystem Health`,`- All ${k.length} subsystems healthy`);let te=pe.getAll();if(te.size>0){g.push(``,`### 🔌 Circuit Breakers`);for(let[e,t]of te){let n=t.getState(),r=`- **${e}**: ${n===`closed`?`🟢`:n===`open`?`🔴`:`🟡`} ${n}`;if(n===`open`){let e=t.remainingCooldownMs();r+=` (recovery in ${Math.ceil(e/1e3)}s)`}g.push(r)}}let ne=dy(),re=fy(),ae=oe(),ce=ne!=null&&ne!==ae,le=re!=null&&re!==ae;if(ce||le){let e=se(),t=[];ce&&t.push(`user scaffold v${ne}`),le&&t.push(`workspace scaffold v${re}`);let n=t.join(`, `);e.state===`success`?g.push(``,`### ✅ Upgrade Applied`,`- Server v${ae} — ${n} auto-upgraded successfully.`,`- _Restart the MCP server to use the updated version._`):e.state===`pending`?g.push(``,`### ⏳ Upgrade In Progress`,`- Server v${ae} ≠ ${n}`,`- Auto-upgrade is running in the background…`):e.state===`failed`?(ie(),g.push(``,`### ⬆ Upgrade Available (auto-upgrade failed, retrying)`,`- Server v${ae} ≠ ${n}`,`- Error: ${e.error??`unknown`}`)):(ie(),g.push(``,`### ⬆ Upgrade Available`,`- Server v${ae} ≠ ${n}`,`- Auto-upgrade triggered — check again shortly.`))}l.length>0&&g.push(``,`### ⚠ Warnings`,...l.map(e=>`- ${e}`));let ue=ss();if(ue.length>0){let e=ue.sort((e,t)=>t.callCount-e.callCount);g.push(``,`### Tool Usage This Session`,``),g.push(`| Tool | Calls | Tokens In | Tokens Out | Errors | Avg Latency |`),g.push(`|------|-------|-----------|------------|--------|-------------|`);for(let t of e.slice(0,15)){let e=Math.round(t.totalInputChars/4),n=Math.round(t.totalOutputChars/4),r=Math.round(t.totalDurationMs/t.callCount);g.push(`| ${t.tool} | ${t.callCount} | ${e.toLocaleString()} | ${n.toLocaleString()} | ${t.errorCount} | ${r}ms |`)}}let A=rs();A.callCount>0&&(g.push(``),g.push(`### Session Token Usage`),g.push(`- Tool calls: ${A.callCount}`),g.push(`- Input chars: ${A.totalInputChars.toLocaleString()}`),g.push(`- Output chars: ${A.totalOutputChars.toLocaleString()}`),g.push(`- Est. input tokens: ${Math.round(A.totalInputChars/4).toLocaleString()}`),g.push(`- Est. total tokens: ${Math.round((A.totalInputChars+A.totalOutputChars)/4).toLocaleString()}`));let de=Xo();if(de.bufferSize>=10){let e=de.state===`healthy`?`🟢`:de.state===`degraded`?`🔴`:`🟡`;g.push(``,`### Auto-GC: ${e} ${de.state}`),g.push(`- p95 latency: ${de.p95}ms | buffer: ${de.bufferSize} samples`),de.gcCount>0&&g.push(`- GC cycles triggered: ${de.gcCount}`)}let fe=g.join(`
|
|
3049
|
+
`),me=e||O>=ny?await $v(r,c,void 0,a?.l0CardDir):void 0,ge=b.length>0?b.map(e=>({id:e.id,path:e.path,eventCount:e.eventCount,pendingFiles:e.pendingFiles??[]})):void 0,_e={totalRecords:f.totalRecords,totalFiles:f.totalFiles,lastIndexedAt:f.lastIndexedAt??null,onboarded:y,onboardDir:_,contentTypes:f.contentTypeBreakdown,wasmAvailable:!!vr.get(),wasmDiagnostics:_r.get(),graphStats:m,curatedCount:h,serverVersion:ae,scaffoldVersion:ne??null,workspaceScaffoldVersion:re??null,upgradeAvailable:ce||le,storeBackend:a?.store?.backend,storeDiagnostics:E??null,contextPressure:x,nextAction:w,watchers:ge,sessionTokens:{callCount:A.callCount,totalInputChars:A.totalInputChars,totalOutputChars:A.totalOutputChars,estInputTokens:Math.round(A.totalInputChars/4),estTotalTokens:Math.round((A.totalInputChars+A.totalOutputChars)/4),startTime:A.startTime},...me===void 0?{}:{prelude:me}};return{content:[{type:`text`,text:fe+(o===`smart`?"\n\n---\n_Next: Use `search` to query indexed content or `graph({action:'find_nodes', name_pattern:'<top-level-module>'})` → then `graph({action:'neighbors', node_id})` for relationships. Smart indexing handles updates automatically._":"\n\n---\n_Next: Use `search` to query indexed content, `graph({action:'find_nodes', name_pattern:'<top-level-module>'})` → then `graph({action:'neighbors', node_id})` for relationships, or `reindex` to refresh the index._")}],structuredContent:_e}}catch(e){return ty.error(`Status failed`,M(e)),q(`INTERNAL`,`Status check failed: ${e instanceof Error?e.message:String(e)}`)}}))}const hy=j(`tools`);function gy(e){return e instanceof Error?(`code`in e?e.code:void 0)===`ENOENT`||e.message.startsWith(`File not found:`)||e.message.startsWith(`Path not found:`):!1}function _y(e){let t=W(`web_search`);e.registerTool(`web_search`,{title:t.title,description:`PREFERRED web search — fans out to multiple keyless providers (DuckDuckGo + Bing-HTML + Mojeek) by default, returning a deduplicated, consensus-ranked union within a 10s deadline. Optional providers (SearXNG, Google, Brave, Bing API) join the fan-out automatically when their env vars are set. Pass one query or multiple for parallel searching.`,inputSchema:{queries:R.array(R.string().max(2e3)).min(1).max(5).describe('Search queries (1–5). Single: `["react hooks"]`. Multiple searched in parallel.'),limit:R.number().min(1).max(20).default(5).describe(`Max results per query`),site:R.string().optional().describe(`Restrict to domain (e.g., "docs.aws.amazon.com")`),provider:R.enum([`multi`,`duckduckgo`,`bing-html`,`mojeek`,`searxng`,`google`,`brave`,`bing`]).optional().describe("Search provider. Defaults to env AIKIT_SEARCH_PROVIDER, then `multi` (fan-out). Single keyless: `duckduckgo`, `bing-html`, `mojeek`. Self-hosted: `searxng` (requires SEARXNG_URL). Keyed APIs: `google` (GOOGLE_API_KEY+GOOGLE_CSE_ID), `brave` (BRAVE_API_KEY), `bing` (BING_API_KEY). Missing keys auto-fall back to duckduckgo.")},annotations:t.annotations},J(`web_search`,async({queries:e,limit:t,site:n,provider:r})=>{let i=e,a=async e=>{let i=await Jn({query:e,limit:t,site:n,provider:r}),a=[`## Search: ${i.query} _(via ${i.provider})_`,``];if(i.results.length===0)a.push(`No results found.`);else for(let e of i.results)a.push(`### [${e.title}](${e.url})`,e.snippet,``);return a.join(`
|
|
3050
|
+
`)};if(i.length===1)try{return{content:[{type:`text`,text:`${await a(i[0])}\n---\n_Next: Use \`web_fetch\` to read any of these pages in full._`}]}}catch(e){return hy.error(`Web search failed`,M(e)),q(`INTERNAL`,`Web search failed: ${e instanceof Error?e.message:String(e)}`)}let o=await Promise.allSettled(i.map(e=>a(e))),s=[],c=0;for(let e=0;e<o.length;e++){let t=o[e];if(t.status===`fulfilled`)s.push(t.value);else{c++;let n=t.reason instanceof Error?t.reason.message:String(t.reason);hy.error(`Web search failed`,{query:i[e],error:n}),s.push(`## ❌ Search failed: ${i[e]}\n\n${n}`)}}let l=`_Searched ${o.length-c}/${o.length} queries successfully._`;s.push(``,`---`,l,"_Next: Use `web_fetch` to read any of these pages in full._");let u=s.join(`
|
|
3051
|
+
|
|
3052
|
+
`);return c===o.length?q(`INTERNAL`,u):{content:[{type:`text`,text:u}]}}))}function vy(e){let t=W(`http`);e.registerTool(`http`,{title:t.title,description:`Make HTTP requests (GET/POST/PUT/PATCH/DELETE/HEAD) for API testing. Returns status, headers, and formatted body with timing info.`,inputSchema:{url:R.string().url().describe(`Request URL (http/https only)`),method:R.enum([`GET`,`POST`,`PUT`,`PATCH`,`DELETE`,`HEAD`]).default(`GET`).describe(`HTTP method`),headers:R.record(R.string(),R.string()).optional().describe(`Request headers as key-value pairs`),body:R.string().optional().describe(`Request body (for POST/PUT/PATCH)`),timeout:R.number().min(1e3).max(6e4).default(15e3).describe(`Timeout in milliseconds`)},annotations:t.annotations},J(`http`,async({url:e,method:t,headers:n,body:r,timeout:i})=>{try{let a=await Vt({url:e,method:t,headers:n,body:r,timeout:i}),o=[`## ${t} ${e}`,``,`**Status:** ${a.status} ${a.statusText}`,`**Time:** ${a.durationMs}ms`,`**Size:** ${a.sizeBytes} bytes`,`**Content-Type:** ${a.contentType}`,``,`### Headers`,"```json",JSON.stringify(a.headers),"```",``,`### Body`,a.contentType.includes(`json`)?"```json":"```",a.body,"```"];return a.truncated&&o.push(``,`_Response truncated — total size: ${a.sizeBytes} bytes_`),{content:[{type:`text`,text:o.join(`
|
|
3053
|
+
`)}]}}catch(e){return hy.error(`HTTP request failed`,M(e)),q(`INTERNAL`,`HTTP request failed: ${e instanceof Error?e.message:String(e)}`)}}))}function yy(e){let t=W(`regex_test`);e.registerTool(`regex_test`,{title:t.title,description:`Test a regex pattern against sample strings. Supports match, replace, and split modes.`,inputSchema:{pattern:R.string().max(500).describe(`Regex pattern (without delimiters)`),flags:R.string().max(10).regex(/^[gimsuy]*$/).default(``).describe(`Regex flags (g, i, m, s, etc.)`),test_strings:R.array(R.string().max(1e4)).max(50).describe(`Strings to test the pattern against`),mode:R.enum([`match`,`replace`,`split`]).default(`match`).describe(`Test mode`),replacement:R.string().optional().describe(`Replacement string (for replace mode)`)},annotations:t.annotations},J(`regex_test`,async({pattern:e,flags:t,test_strings:n,mode:r,replacement:i})=>{let a=gn({pattern:e,flags:t,testStrings:n,mode:r,replacement:i});if(!a.valid)return q(`VALIDATION`,`Invalid regex: ${a.error}`);let o=[`## Regex: \`/${a.pattern}/${a.flags}\``,``,`Mode: ${r}`,``];for(let e of a.results){if(o.push(`**Input:** \`${e.input}\``),o.push(`**Matched:** ${e.matched}`),e.matches)for(let t of e.matches){let e=t.groups.length>0?` groups: [${t.groups.join(`, `)}]`:``;o.push(` - "${t.full}" at index ${t.index}${e}`)}e.replaced!==void 0&&o.push(`**Result:** \`${e.replaced}\``),e.split&&o.push(`**Split:** ${JSON.stringify(e.split)}`),o.push(``)}return{content:[{type:`text`,text:o.join(`
|
|
3054
|
+
`)}]}}))}function by(e){let t=W(`encode`);e.registerTool(`encode`,{title:t.title,description:`Encode, decode, or hash text. Supports base64, URL encoding, SHA-256, MD5, JWT decode, hex.`,inputSchema:{operation:R.enum([`base64_encode`,`base64_decode`,`url_encode`,`url_decode`,`sha256`,`md5`,`jwt_decode`,`hex_encode`,`hex_decode`]).describe(`Operation to perform`),input:R.string().max(1e6).describe(`Input text`)},annotations:t.annotations},J(`encode`,async({operation:e,input:t})=>{try{let n=wt({operation:e,input:t});return{content:[{type:`text`,text:`## ${e}\n\n**Input:** \`${t.length>100?`${t.slice(0,100)}...`:t}\`\n**Output:**\n\`\`\`\n${n.output}\n\`\`\``}]}}catch(e){return hy.error(`Encode failed`,M(e)),q(`INTERNAL`,`Encode failed: ${e instanceof Error?e.message:String(e)}`)}}))}function xy(e){let t=W(`measure`);e.registerTool(`measure`,{title:t.title,description:`Measure code complexity, line counts, and function counts for a file or directory. Returns per-file metrics sorted by complexity.`,outputSchema:rc,inputSchema:{path:R.string().describe(`File or directory path to measure`),extensions:R.array(R.string()).optional().describe(`File extensions to include (default: .ts,.tsx,.js,.jsx)`),include_hidden:R.boolean().optional().describe(`Include hidden trees such as .generated and .cache. Default false.`),max_tokens:R.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`)},annotations:t.annotations},J(`measure`,async({path:e,extensions:t,include_hidden:n,max_tokens:r})=>{try{let i=await Zt({path:e,extensions:t,includeHidden:n}),a=[`## Code Metrics`,``,`**Files:** ${i.summary.totalFiles}`,`**Total lines:** ${i.summary.totalLines} (${i.summary.totalCodeLines} code)`,`**Functions:** ${i.summary.totalFunctions}`,`**Avg complexity:** ${i.summary.avgComplexity}`,`**Max complexity:** ${i.summary.maxComplexity.value} (${i.summary.maxComplexity.file})`,``,`### Top files by complexity`,``,`| File | Lines | Code | Complexity | Cognitive | Functions | Imports |`,`|------|-------|------|------------|-----------|-----------|---------|`];for(let e of i.files.slice(0,20)){let t=e.cognitiveComplexity===void 0?`—`:String(e.cognitiveComplexity);a.push(`| ${e.path} | ${e.lines.total} | ${e.lines.code} | ${e.complexity} | ${t} | ${e.functions} | ${e.imports} |`)}i.files.length>20&&a.push(``,`_...and ${i.files.length-20} more files_`);let o={summary:{totalFiles:i.summary.totalFiles,totalLines:i.summary.totalLines,totalCodeLines:i.summary.totalCodeLines,totalFunctions:i.summary.totalFunctions,avgComplexity:i.summary.avgComplexity,maxComplexity:{value:i.summary.maxComplexity.value,file:i.summary.maxComplexity.file}},files:i.files.map(e=>({path:e.path,lines:e.lines.total,code:e.lines.code,complexity:e.complexity,functions:e.functions}))};return{content:[{type:`text`,text:r?L(a.join(`
|
|
3058
3055
|
`),r):a.join(`
|
|
3059
|
-
`)}],structuredContent:o}}catch(e){return
|
|
3056
|
+
`)}],structuredContent:o}}catch(e){return gy(e)?(hy.warn(`Measure failed`,{error:`File not found`}),q(`NOT_FOUND`,`File not found`)):(hy.error(`Measure failed`,M(e)),q(`INTERNAL`,`Measure failed: ${e instanceof Error?e.message:String(e)}`))}}))}function Sy(e){let t=W(`changelog`);e.registerTool(`changelog`,{title:t.title,description:`Generate a changelog from git history between two refs. Groups by conventional commit type.`,inputSchema:{from:R.string().max(200).describe(`Start ref (tag, SHA, HEAD~N)`),to:R.string().max(200).default(`HEAD`).describe(`End ref (default: HEAD)`),format:R.enum([`grouped`,`chronological`,`per-scope`]).default(`grouped`).describe(`Output format`),include_breaking:R.boolean().default(!0).describe(`Highlight breaking changes`),cwd:R.string().optional().describe(`Repository root or working directory`)},annotations:t.annotations},J(`changelog`,async({from:e,to:t,format:n,include_breaking:r,cwd:i})=>{try{let a=at({from:e,to:t,format:n,includeBreaking:r,cwd:i}),o=`${a.stats.total} commits (${Object.entries(a.stats.types).map(([e,t])=>`${t} ${e}`).join(`, `)})`;return{content:[{type:`text`,text:`${a.markdown}\n---\n_${o}_`}]}}catch(e){return hy.error(`Changelog failed`,M(e)),q(`INTERNAL`,`Changelog failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Cy(e){let t=W(`schema_validate`);e.registerTool(`schema_validate`,{title:t.title,description:`Validate JSON data against a JSON Schema. Supports type, required, properties, items, enum, pattern, min/max.`,inputSchema:{data:R.string().max(5e5).describe(`JSON data to validate (as string)`),schema:R.string().max(5e5).describe(`JSON Schema to validate against (as string)`)},annotations:t.annotations},J(`schema_validate`,async({data:e,schema:t})=>{try{let n=On({data:JSON.parse(e),schema:JSON.parse(t)});if(n.valid)return{content:[{type:`text`,text:`## Validation: PASSED
|
|
3060
3057
|
|
|
3061
3058
|
Data matches the schema.`}]};let r=[`## Validation: FAILED`,``,`**${n.errors.length} error(s):**`,``];for(let e of n.errors){let t=e.expected?` (expected: ${e.expected}, got: ${e.received})`:``;r.push(`- \`${e.path}\`: ${e.message}${t}`)}return{content:[{type:`text`,text:r.join(`
|
|
3062
|
-
`)}]}}catch(e){return
|
|
3063
|
-
`)}],structuredContent:a}}))}function
|
|
3064
|
-
`)}],structuredContent:o}}catch(e){return
|
|
3059
|
+
`)}]}}catch(e){return hy.error(`Schema validation failed`,M(e)),q(`INTERNAL`,`Schema validation failed: ${e instanceof Error?e.message:String(e)}`)}}))}function wy(e){let t=W(`env`);e.registerTool(`env`,{title:t.title,description:`Get system and runtime environment info. Sensitive env vars are redacted by default.`,outputSchema:ic,inputSchema:{include_env:R.boolean().default(!1).describe(`Include environment variables`),filter_env:R.string().optional().describe(`Filter env vars by name substring`),show_sensitive:R.boolean().default(!1).describe(`Show sensitive values (keys, tokens, etc.) — redacted by default`)},annotations:t.annotations},J(`env`,async({include_env:e,filter_env:t,show_sensitive:n})=>{let r=Tt({includeEnv:e,filterEnv:t,showSensitive:n}),i=[`## Environment`,``,`**Platform:** ${r.system.platform} ${r.system.arch}`,`**OS:** ${r.system.type} ${r.system.release}`,`**Host:** ${r.system.hostname}`,`**CPUs:** ${r.system.cpus}`,`**Memory:** ${r.system.memoryFreeGb}GB free / ${r.system.memoryTotalGb}GB total`,``,`**Node:** ${r.runtime.node}`,`**V8:** ${r.runtime.v8}`,`**CWD:** ${r.cwd}`];if(r.env){i.push(``,`### Environment Variables`,``);for(let[e,t]of Object.entries(r.env))i.push(`- \`${e}\`: ${t}`)}let a={platform:r.system.platform,arch:r.system.arch,nodeVersion:r.runtime.node,cwd:r.cwd,cpus:r.system.cpus,memoryFreeGb:r.system.memoryFreeGb,memoryTotalGb:r.system.memoryTotalGb};return{content:[{type:`text`,text:i.join(`
|
|
3060
|
+
`)}],structuredContent:a}}))}function Ty(e){let t=W(`time`);e.registerTool(`time`,{title:t.title,description:`Parse dates, convert timezones, calculate durations, add time. Supports ISO 8601, unix timestamps, and human-readable formats.`,outputSchema:ac,inputSchema:{operation:R.enum([`now`,`parse`,`convert`,`diff`,`add`]).describe(`now: current time | parse: parse a date string | convert: timezone conversion | diff: duration between two dates | add: add duration to date`),input:R.string().optional().describe(`Date input (ISO, unix timestamp, or parseable string). For diff: two comma-separated dates`),timezone:R.string().optional().describe(`Target timezone (e.g., "America/New_York", "Asia/Tokyo")`),duration:R.string().optional().describe(`Duration to add (e.g., "2h30m", "1d", "30s") — for add operation`)},annotations:t.annotations},J(`time`,async({operation:e,input:t,timezone:n,duration:r})=>{try{let i=Hn({operation:e,input:t,timezone:n,duration:r}),a=[`**${i.output}**`,``,`ISO: ${i.iso}`,`Unix: ${i.unix}`];i.details&&a.push(``,"```json",JSON.stringify(i.details),"```");let o={iso:i.iso,unix:i.unix,timezone:n??Intl.DateTimeFormat().resolvedOptions().timeZone,formatted:i.output};return{content:[{type:`text`,text:a.join(`
|
|
3061
|
+
`)}],structuredContent:o}}catch(e){return hy.error(`Time failed`,M(e)),q(`INTERNAL`,`Time failed: ${e instanceof Error?e.message:String(e)}`)}}))}function Ey(e){try{let t=F(e,`.flows`);if(!N(t))return null;let n=Ae(t,{withFileTypes:!0});for(let e of n){if(!e.isDirectory())continue;let n=F(t,e.name,`meta.json`);if(N(n)&&JSON.parse(P(n,`utf-8`)).status===`active`)return e.name}}catch{return null}return null}function Dy(e){let{server:t,aikit:n,config:r,elicitor:i,resourceNotifier:a,samplingClient:o,indexMode:s,getSmartState:c,getSmartScheduler:l,precomputedActiveTools:u}=e,d=new Uo,f=r.sources[0]?.path??Oe(),p=xe(f),m={activeSlug:null};m.activeSlug=Ey(f);let h=new co(F(r.stateDir??``,`flow-context`),()=>m.activeSlug),g=new Wa;g.register(Yi()),g.register(Va),g.register(aa),g.register(Aa),g.register(na),g.register(Xi),g.register(Zi),g.register(Ra),g.register($i),g.register(Ua),g.register(ka(()=>m.activeSlug?{active:!0,slug:m.activeSlug}:null));let _=new Xa(g,n.curated,{},h),v=u??Zs(r,[...ro,...bs],U,Ss(r)),y=e=>v.has(e),b=new Set([...v].filter(e=>!Xp.includes(e)&&!ko.has(e))),x=new No;d.use(qa(_),{order:5,name:`auto-knowledge`}),d.use(ls(),{order:10,name:`replay`}),d.use(Io(x,{stateStore:n.stateStore,curatedStore:n.curated},{trackedTools:b}),{order:94,name:`procedural-memory`}),d.use(To(new Co(n.stateStore,n.curated)),{order:95,name:`observation-capture`}),d.use(Ts(),{order:1,name:`structured-content-guard`}),d.use(so(oo(r.tokenBudget)),{order:90,name:`compression`}),Is(t,d,r.toolPrefix??``);let S=[...v].filter(e=>xs.has(e)?ys.includes(e)?!!n.bridge:e===`er_update_policy`?!!n.policyStore:e===`er_evolve_review`?!!n.evolutionCollector:!1:!0);y(`search`)&&Av(t,n.embedder,n.store,n.graphStore,n.bridge,n.evolutionCollector,o,n.stateStore,r.memory?.retention,r.memory?.consolidation,p);let C={store:n.store,graphStore:n.graphStore,embedder:n.embedder};y(`lookup`)&&Pp(t,n.store,C);let w={onboardComplete:n.onboardComplete,onboardTimestamp:n.onboardTimestamp};y(`status`)&&my(t,n.store,n.graphStore,n.curated,w,r,s,c,n.stateStore),y(`config`)&&Jl(t,r),y(`reindex`)&&cv(t,n.indexer,r,n.curated,n.store,a,s),y(`knowledge`)&&Mp(t,n.curated,n.policyStore,n.evolutionCollector,a,h,n.stateStore,r.memory?.retention,r.memory?.supersession,r.memory?.consolidation,r.memory?.lessons,C,n.graphStore),y(`memory_explain`)&&Yp(t,n.embedder,n.store),y(`analyze`)&&fl(t,n.store,n.embedder,C),y(`blast_radius`)&&pl(t,n.store,n.embedder,n.graphStore,C),y(`produce_knowledge`)&&ov(t,a),y(`onboard`)&&vm(t,n.store,n.embedder,r,w,C,o,a),y(`graph`)&&Fd(t,n.graphStore,C),y(`audit`)&&vl(t,n.store,n.embedder,r.tokenBudget),y(`scope_map`)&&cu(t,n.embedder,n.store,C),y(`find`)&&lu(t,n.embedder,n.store,f,C,p),y(`parse_output`)&&bu(t),y(`workset`)&&bm(t),y(`check`)&&_u(t,C,r.tokenBudget),y(`symbol`)&&uu(t,n.embedder,n.store,n.graphStore,C),y(`eval`)&&vu(t),y(`test_run`)&&yu(t,C),y(`stash`)&&xm(t,n.stateStore),y(`signal`)&&Yv(t,n.stateStore),y(`git_context`)&&Rp(t),y(`diff_parse`)&&zp(t),y(`rename`)&&Bp(t,r),y(`codemod`)&&Vp(t,r),y(`restore`)&&fv(t),y(`file_summary`)&&wu(t,n.embedder,n.fileCache),y(`checkpoint`)&&Sm(t,n.stateStore),y(`data_transform`)&&Hp(t),y(`trace`)&&du(t,n.embedder,n.store,n.graphStore,C),y(`process`)&&Ld(t),y(`watch`)&&Rd(t),y(`dead_symbols`)&&fu(t,n.embedder,n.store,f,r.allRoots,C),y(`delegate`)&&xu(t,o),y(`health`)&&zd(t),y(`lane`)&&Cm(t),y(`queue`)&&wm(t),y(`web_fetch`)&&Bd(t),y(`guide`)&&Vd(t,s),Xp.some(e=>y(e))&&Zp(t,r,S),y(`evidence_map`)&&Od(t),y(`digest`)&&kd(t,n.embedder),y(`forge_classify`)&&Ad(t,C),y(`forge_ground`)&&jd(t,n.embedder,n.store),y(`present`)&&iv(t,i),y(`browser`)&&cr(t,r),y(`web_search`)&&_y(t),y(`http`)&&vy(t),y(`regex_test`)&&yy(t),y(`encode`)&&by(t),y(`measure`)&&xy(t),y(`changelog`)&&Sy(t),y(`schema_validate`)&&Cy(t),y(`env`)&&wy(t),y(`time`)&&Ty(t),y(`flow`)&&Ed(t,r,{store:n.store?{search:async(e,t)=>(await n.store.ftsSearch(e,t)).map(e=>({content:e.record.content}))}:null,graphStore:n.graphStore,embedder:n.embedder},e=>{m.activeSlug=e}),n.bridge&&ys.some(e=>y(e))&&(Sl(t,n.bridge,n.evolutionCollector),Cl(t,n.bridge),wl(t,n.bridge)),n.policyStore&&y(`er_update_policy`)&&Am(t,n.policyStore),n.evolutionCollector&&y(`er_evolve_review`)&&hu(t,n.evolutionCollector),vs(t,n.store,n.curated,r.l0CardDir),y(`compliance_score`)&&Dl(t),y(`replay`)&&uv(t),y(`session_digest`)&&Mv(t,n.stateStore,o)}function Oy(e,t,n){let r=e=>!n||n.has(e);r(`check`)&&_u(e,void 0,t.tokenBudget),r(`eval`)&&vu(e),r(`test_run`)&&yu(e),r(`parse_output`)&&bu(e),r(`delegate`)&&xu(e),r(`git_context`)&&Rp(e),r(`diff_parse`)&&zp(e),r(`rename`)&&Bp(e,t),r(`codemod`)&&Vp(e,t),r(`data_transform`)&&Hp(e),r(`workset`)&&bm(e),r(`restore`)&&fv(e),r(`lane`)&&Cm(e),r(`queue`)&&wm(e),r(`session_digest`)&&Mv(e),r(`health`)&&zd(e),r(`process`)&&Ld(e),r(`watch`)&&Rd(e),r(`web_fetch`)&&Bd(e),r(`guide`)&&Vd(e),Xp.some(e=>r(e))&&Zp(e,t,[...n??new Set(ro)]),r(`evidence_map`)&&Od(e),r(`forge_classify`)&&Ad(e),r(`present`)&&iv(e),r(`browser`)&&cr(e,t),r(`produce_knowledge`)&&ov(e),r(`compliance_score`)&&Dl(e),r(`replay`)&&uv(e),r(`status`)&&py(e),r(`flow`)&&Ed(e,t),r(`web_search`)&&_y(e),r(`http`)&&vy(e),r(`regex_test`)&&yy(e),r(`encode`)&&by(e),r(`measure`)&&xy(e),r(`changelog`)&&Sy(e),r(`schema_validate`)&&Cy(e),r(`env`)&&wy(e),r(`time`)&&Ty(e)}const ky=j(`resource-notifier`);var Ay=class{mcpServer;constructor(e){this.mcpServer=e}async notifyStatusChanged(){await this.sendUpdate(`aikit://status`)}async notifyFileTreeChanged(){await this.sendUpdate(`aikit://file-tree`)}async notifyCuratedIndexChanged(){await this.sendUpdate(`aikit://curated`)}async notifyCuratedEntryChanged(e){await this.sendUpdate(`aikit://curated/${e}`)}async notifyResourceListChanged(){try{await this.mcpServer.server.sendResourceListChanged()}catch(e){ky.debug(`sendResourceListChanged failed`,{error:String(e)})}}async notifyL0CardChanged(){await this.sendUpdate(`aikit://l0/workspace-core`),await this.sendUpdate(`aikit://l0`)}async notifyAfterReindex(){await Promise.allSettled([this.notifyStatusChanged(),this.notifyFileTreeChanged()])}async notifyAfterCuratedWrite(e){let t=[this.notifyStatusChanged(),this.notifyCuratedIndexChanged()];e&&t.push(this.notifyCuratedEntryChanged(e)),await Promise.allSettled(t)}async sendUpdate(e){try{await this.mcpServer.server.sendResourceUpdated({uri:e})}catch(t){ky.debug(`sendResourceUpdated failed`,{uri:e,error:String(t)})}}};const Q=j(`server`);function jy(e){let t=e?.trim().toLowerCase();return t===`1`||t===`true`||t===`yes`||t===`on`}async function My(n){Q.info(`Initializing AI Kit components`);let r=n.store.backend,i=n.embedding,a=_e[i.model],o={model:i.model,nativeDim:i.nativeDim??a?.nativeDim??me.nativeDim,dimensions:i.dimensions??a?.dimensions??me.dimensions,queryPrefix:i.queryPrefix??a?.queryPrefix??me.queryPrefix,pooling:i.pooling??a?.pooling??`mean`},s=n.store.path,c=jy(process.env.AIKIT_SPLIT_STATE),l=F(s,`aikit.db`),u={splitEnabled:c,contentDbPath:l,controlDbPath:c?F(s,`aikit-control.db`):l},d=null;if(r===`sqlite-vec`){let e=u.contentDbPath;N(s)||ke(s,{recursive:!0}),d=await Mr(e),Q.debug(`SQLite adapter ready`,{type:d.type,vectorCapable:d.vectorCapable,dbPath:e}),d.vectorCapable||Q.warn(`┌──────────────────────────────────────────────────────────────────┐
|
|
3065
3062
|
│ ⚠ SQLite vector extension unavailable — DEGRADED MODE │
|
|
3066
3063
|
│ Vector search is disabled. Hybrid search returns FTS only. │
|
|
3067
3064
|
│ To enable: install/rebuild better-sqlite3 (native module). │
|
|
3068
|
-
└──────────────────────────────────────────────────────────────────┘`);let t=F(s,`lance`);N(t)&&Q.info(`Old LanceDB data found at ${t} — ignored. Safe to delete after verifying sqlite-vec works.`)}let f;if(d)if(u.splitEnabled&&u.controlDbPath!==u.contentDbPath){let{migrateToSplitState:e}=await import(`../../store/dist/index.js`);await e(u),f=await Mr(u.controlDbPath),Fr(f,jr),Q.info(`State store adapter ready`,{type:f.type,dbPath:u.controlDbPath,splitEnabled:!0})}else f=d;else{let e=F(s,`aikit-state.db`);N(s)||ke(s,{recursive:!0}),f=await Mr(e),Fr(f,jr),Q.info(`State store adapter ready`,{type:f.type,dbPath:e})}let[p,m,h,g]=await Promise.all([(async()=>{if(n.embedding.childProcess!==!1){let e=new Zr({model:o.model,dimensions:o.dimensions,nativeDim:o.nativeDim,queryPrefix:o.queryPrefix,pooling:o.pooling,interOpNumThreads:i.interOpNumThreads,intraOpNumThreads:i.intraOpNumThreads,idleTimeoutMs:i.idleTimeoutMs});return await e.initialize(),Q.debug(`Embedder loaded (child process)`,{modelId:e.modelId,dimensions:e.dimensions}),e}let{OnnxEmbedder:e}=await import(`../../embeddings/dist/index.js`),t=new e({model:o.model,dimensions:o.dimensions,nativeDim:o.nativeDim,queryPrefix:o.queryPrefix,pooling:o.pooling,interOpNumThreads:i.interOpNumThreads,intraOpNumThreads:i.intraOpNumThreads});return await t.initialize(),Q.debug(`Embedder loaded (in-process)`,{modelId:t.modelId,dimensions:t.dimensions}),t})(),(async()=>{let e=r===`sqlite-vec`?await Pr({backend:r,path:s,adapter:d??void 0,embeddingDim:o.dimensions,embeddingProfile:o,partition:u}):await Pr({backend:r,path:s,adapter:d??void 0,embeddingDim:o.dimensions,partition:void 0});return await e.initialize(),Q.debug(`Store initialized`,{backend:r}),e})(),(async()=>{let e=d?new Ar({adapter:d}):new Ar({path:s});return await e.initialize(),Q.debug(`Graph store initialized`,{shared:!!d}),e})(),(async()=>{let e=await yr();if(e){let e=_r.get();Q.debug(`WASM tree-sitter enabled`,{grammars:e.grammarCount,dir:e.wasmDir})}else{let e=_r.get();Q.warn(`WASM tree-sitter not available; analyzers will use regex fallback`,{reason:e.reason,os:e.os,arch:e.arch,healAttempted:e.healAttempted,healSuccess:e.healSuccess,healError:e.healError,pathsChecked:e.pathsChecked.map(e=>`${e.path} (${e.exists?`found`:`missing`})`)})}return e})()]),_=new $r(p,m),v=Nr(f),y=new Qr(n.store.path);y.load(),_.setHashCache(y);let b=n.curated.path,x=new e(b);await x.initialize();let S=new t(b,m,p,x);_.setGraphStore(h);let C=
|
|
3069
|
-
`)}const
|
|
3065
|
+
└──────────────────────────────────────────────────────────────────┘`);let t=F(s,`lance`);N(t)&&Q.info(`Old LanceDB data found at ${t} — ignored. Safe to delete after verifying sqlite-vec works.`)}let f;if(d)if(u.splitEnabled&&u.controlDbPath!==u.contentDbPath){let{migrateToSplitState:e}=await import(`../../store/dist/index.js`);await e(u),f=await Mr(u.controlDbPath),Fr(f,jr),Q.info(`State store adapter ready`,{type:f.type,dbPath:u.controlDbPath,splitEnabled:!0})}else f=d;else{let e=F(s,`aikit-state.db`);N(s)||ke(s,{recursive:!0}),f=await Mr(e),Fr(f,jr),Q.info(`State store adapter ready`,{type:f.type,dbPath:e})}let[p,m,h,g]=await Promise.all([(async()=>{if(n.embedding.childProcess!==!1){let e=new Zr({model:o.model,dimensions:o.dimensions,nativeDim:o.nativeDim,queryPrefix:o.queryPrefix,pooling:o.pooling,interOpNumThreads:i.interOpNumThreads,intraOpNumThreads:i.intraOpNumThreads,idleTimeoutMs:i.idleTimeoutMs});return await e.initialize(),Q.debug(`Embedder loaded (child process)`,{modelId:e.modelId,dimensions:e.dimensions}),e}let{OnnxEmbedder:e}=await import(`../../embeddings/dist/index.js`),t=new e({model:o.model,dimensions:o.dimensions,nativeDim:o.nativeDim,queryPrefix:o.queryPrefix,pooling:o.pooling,interOpNumThreads:i.interOpNumThreads,intraOpNumThreads:i.intraOpNumThreads});return await t.initialize(),Q.debug(`Embedder loaded (in-process)`,{modelId:t.modelId,dimensions:t.dimensions}),t})(),(async()=>{let e=r===`sqlite-vec`?await Pr({backend:r,path:s,adapter:d??void 0,embeddingDim:o.dimensions,embeddingProfile:o,partition:u}):await Pr({backend:r,path:s,adapter:d??void 0,embeddingDim:o.dimensions,partition:void 0});return await e.initialize(),Q.debug(`Store initialized`,{backend:r}),e})(),(async()=>{let e=d?new Ar({adapter:d}):new Ar({path:s});return await e.initialize(),Q.debug(`Graph store initialized`,{shared:!!d}),e})(),(async()=>{let e=await yr();if(e){let e=_r.get();Q.debug(`WASM tree-sitter enabled`,{grammars:e.grammarCount,dir:e.wasmDir})}else{let e=_r.get();Q.warn(`WASM tree-sitter not available; analyzers will use regex fallback`,{reason:e.reason,os:e.os,arch:e.arch,healAttempted:e.healAttempted,healSuccess:e.healSuccess,healError:e.healError,pathsChecked:e.pathsChecked.map(e=>`${e.path} (${e.exists?`found`:`missing`})`)})}return e})()]),_=new $r(p,m),v=Nr(f),y=new Qr(n.store.path);y.load(),_.setHashCache(y);let b=n.curated.path,x=new e(b);await x.initialize();let S=new t(b,m,p,x);_.setGraphStore(h);let C=xl(n.er),w=C?new Cr(n.curated.path):void 0;w&&Q.debug(`Policy store initialized`,{ruleCount:w.getRules().length});let T=C?new Sr:void 0,E=I(n.sources[0]?.path??Oe(),A.aiContext),D=N(E),O=n.onboardDir?N(n.onboardDir):!1,k=D||O,ee,te=D?E:n.onboardDir;if(k&&te)try{ee=Ne(te).mtime.toISOString()}catch{}return Q.debug(`Onboard state detected`,{onboardComplete:k,onboardTimestamp:ee,aiKbExists:D,onboardDirExists:O}),{embedder:p,store:m,stateStore:v,closeStateStore:f===d?void 0:async()=>f.close(),indexer:_,curated:S,graphStore:h,fileCache:new Qe,bridge:C,policyStore:w,evolutionCollector:T,onboardComplete:k,onboardTimestamp:ee}}function Ny(e,t,n){if(e.serverInstructions)return e.serverInstructions;let r=new Set;for(let e of t){let t=n[e];if(t?.category)for(let e of t.category)r.add(e)}let i=[`This server provides ${t.size} tools across ${r.size} categories: ${[...r].sort().join(`, `)}.`,`TOOL ROUTING:`,`- Understand a file -> file_summary (T1=structure, T2=content)`,`- Find code/symbols -> search (hybrid) or symbol (definition + refs)`,`- Validate changes -> check (typecheck+lint) or test_run (tests)`,`- Read file for editing -> read_file (only for exact lines before edits)`,`FORBIDDEN: DO NOT USE native equivalents when AI Kit provides same:`,`- grep/find -> search or find tool`,`- cat/read_file (for understanding) -> file_summary`,`- terminal tsc/lint -> check tool`,`- terminal test -> test_run tool`];return e.readOnly&&i.push(`Server is in read-only mode. Mutating operations are disabled.`),e.features?.length&&i.push(`Active feature groups: ${e.features.join(`, `)}.`),i.join(`
|
|
3066
|
+
`)}const Py=j(`background-task`);var Fy=class{queue=[];running=null;get isRunning(){return this.running!==null}get currentTask(){return this.running}get pendingCount(){return this.queue.length}schedule(e){return new Promise((t,n)=>{this.queue.push({...e,resolve:t,reject:n}),this.running||this.processQueue()})}async processQueue(){for(;this.queue.length>0;){let e=this.queue.shift();if(!e)break;this.running=e.name,Py.info(`Background task started`,{task:e.name,pending:this.queue.length});let t=Date.now();try{await e.fn();let n=Date.now()-t;Py.info(`Background task completed`,{task:e.name,durationMs:n}),e.resolve()}catch(n){let r=Date.now()-t;Py.error(`Background task failed`,{task:e.name,durationMs:r,err:n}),e.reject(n instanceof Error?n:Error(String(n)))}}this.running=null}};const Iy=j(`idle-timer`);var Ly=class{timer=null;cleanupFns=[];idleMs;disposed=!1;sessionActive=!1;_busy=!1;constructor(e){this.idleMs=e?.idleMs??3e5}setBusy(e){this._busy=e,e?this.cancel():this.touch()}onIdle(e){this.cleanupFns.push(e)}markSessionActive(){this.sessionActive=!0}touch(){this.disposed||this._busy||(this.cancel(),this.timer=setTimeout(()=>{this.runCleanup()},this.idleMs),this.timer.unref&&this.timer.unref())}cancel(){this.timer&&=(clearTimeout(this.timer),null)}dispose(){this.cancel(),this.cleanupFns.length=0,this.disposed=!0}async runCleanup(){if(!this.sessionActive){Iy.info(`Idle timeout reached with no active session — skipping cleanup (waiting for first tool call)`);return}if(this._busy){Iy.info(`Skipping idle cleanup — background work in progress`);return}Iy.info(`Idle for ${this.idleMs/1e3}s — running cleanup`);let e=await Promise.allSettled(this.cleanupFns.map(e=>e()));for(let t of e)t.status===`rejected`&&Iy.warn(`Idle cleanup callback failed`,{error:String(t.reason)})}};const Ry=j(`memory-monitor`);var zy=class{timer=null;warningBytes;criticalBytes;intervalMs;pressureFns=[];memoryPressureFns=[];lastLevel=`normal`;constructor(e){this.warningBytes=e?.warningBytes??3221225472,this.criticalBytes=e?.criticalBytes??6442450944,this.intervalMs=e?.intervalMs??3e4}onPressure(e){this.pressureFns.push(e)}registerMemoryPressureCallback(e){this.memoryPressureFns.push(e)}start(){this.timer||(this.timer=setInterval(()=>this.check(),this.intervalMs),this.timer.unref&&this.timer.unref(),Ry.debug(`Memory monitor started`,{warningMB:Math.round(this.warningBytes/1024/1024),criticalMB:Math.round(this.criticalBytes/1024/1024),intervalSec:Math.round(this.intervalMs/1e3)}))}stop(){this.timer&&=(clearInterval(this.timer),null)}getRssBytes(){return process.memoryUsage.rss()}check(){let e=this.getRssBytes(),t=`normal`;if(e>=this.criticalBytes?t=`critical`:e>=this.warningBytes&&(t=`warning`),t!==this.lastLevel||t===`critical`){let n=Math.round(e/1024/1024);t===`critical`?Ry.warn(`Memory CRITICAL: ${n}MB RSS — consider restarting the server`):t===`warning`?Ry.warn(`Memory WARNING: ${n}MB RSS`):this.lastLevel!==`normal`&&Ry.info(`Memory returned to normal: ${n}MB RSS`),this.lastLevel=t}if(t!==`normal`)for(let n of this.pressureFns)try{n(t,e)}catch{}if(t===`critical`)for(let e of this.memoryPressureFns)try{let t=e();t&&typeof t.catch==`function`&&t.catch(()=>{})}catch{}return t===`critical`&&typeof globalThis.gc==`function`&&globalThis.gc(),t}};const By=new ei;function Vy(e,t){return By.run(e,async()=>{try{return await t()}finally{}})}j(`tool-timeout`);const Hy=new Set([`onboard`,`reindex`,`produce_knowledge`,`analyze`,`codemod`,`audit`]);var Uy=class extends Error{toolName;timeoutMs;constructor(e,t){super(`Tool "${e}" timed out after ${t}ms`),this.toolName=e,this.timeoutMs=t,this.name=`ToolTimeoutError`}};function Wy(e){return Hy.has(e)?6e5:12e4}function Gy(e,t,n){let r=new AbortController,i=r.signal;return new Promise((a,o)=>{let s=setTimeout(()=>{let e=new Uy(n,t);i.aborted||r.abort(e),o(e)},t);s.unref();try{e(i).then(a,o).finally(()=>clearTimeout(s))}catch(e){clearTimeout(s),o(e instanceof Error?e:Error(String(e)))}})}const $=j(`server`),Ky=new Set([`status`,`list_tools`,`describe_tool`,`config`,`env`,`present`]);function qy(e,t=28){let n=e.replace(/\s+/g,` `).trim();return n.length<=t?n:`${n.slice(0,t-3)}...`}function Jy(e){let t=[`query`,`path`,`task`,`name`,`start`,`symbol`,`file`,`pattern`],n=[];for(let r of t){let t=e[r];typeof t==`string`&&t.length>0&&t.length<200&&n.push(t)}return n.join(` `).slice(0,200)}async function Yy(e,t,n,r){let i=[];if(n){let t=await Xy(e,n);t&&i.push(t)}try{if(t.statePath){let{ensureLegacyStashImported:n}=await import(`../../tools/dist/index.js`);n(e.stateStore,{stateDir:t.statePath})}let r=e.stateStore.stashList().map(e=>e.key);if(r.length>0){let e=n?n.toLowerCase().split(/\s+/).filter(e=>e.length>2):[];if(e.length===0)i.push(`📦 stash: ${r.length} entries`);else{let t=r.filter(t=>e.some(e=>t.toLowerCase().includes(e))).slice(0,3);t.length>0&&i.push(`📦 stash: ${t.map(e=>`"${qy(e)}"`).join(`, `)}${r.length>t.length?` (+${r.length-t.length})`:``}`)}}}catch{}if(i.length===0&&!r)return null;if(r){let n=e,r=n.curated;if(r?.list&&n.stateStore)try{let{buildPreludeInjection:e,generatePrelude:a}=await import(`./prelude-DetbWo8R.js`),o=e(await a(r,n.stateStore,void 0,t.l0CardDir),500);o.lines.length>0&&i.push(o.lines.join(`
|
|
3070
3067
|
`))}catch(e){$.debug?.(`Periodic prelude injection failed`,{error:String(e)})}}return i.length===0?null:`\n${i.join(`
|
|
3071
|
-
`)}`}async function
|
|
3072
|
-
`)}catch{return null}}function
|
|
3068
|
+
`)}`}async function Xy(e,t){try{let n=await Promise.race([e.store.ftsSearch(t,{limit:3}),new Promise(e=>{let t=setTimeout(()=>e(null),1e3);t.unref&&t.unref()})]);if(!Array.isArray(n)||n.length===0)return null;let r=[];for(let e of n){if(!e||typeof e!=`object`)continue;let t=e.record;if(!t)continue;let n=t.origin;if(n!==`curated`&&n!==`produced`)continue;let i=t.content??``;if(!(!i||i.length<20)){if(i.length<=400){let e=t.headingPath?.trim()||``,n=i.slice(0,400),a=e?`📚 ${e}: ${n}`:`📚 ${n}`;r.push(a)}else{let e=hp(i,400),n=t.headingPath?.trim()||``,a=n?`📚 ${n}: ${e}`:`📚 ${e}`;r.push(a)}if(r.length>=2)break}}return r.length===0?null:r.join(`
|
|
3069
|
+
`)}catch{return null}}function Zy(e,t,n){let r=5,i=0;for(let[a,o]of Object.entries(e)){let e=o.handler;o.handler=async(...o)=>{let s=await e(...o);if(!s||typeof s!=`object`||r<=0||s.isError||Ky.has(a))return s;try{r--,i++;let e=o[0],a=await Yy(t,n,Jy(e&&typeof e==`object`?e:{}),i%5==0);a&&(s.content=Array.isArray(s.content)?s.content:[],s.content.push({type:`text`,text:a}))}catch{}return s}}}function Qy(e){let t=e.toLowerCase();return[`protobuf`,`invalid model`,`invalid onnx`,`unexpected end`,`unexpected token`,`failed to load`,`failed to initialize embedding`,`checksum`,`corrupt`,`malformed`,`could not load`,`onnx`,`database disk image is malformed`,`file is not a database`,`lance`,`cannot find module`,`cannot find package`,`module not found`].some(e=>t.includes(e))}function $y(e){return cm(e)?[`Auto-heal tried to repair missing runtime dependency files in the npx install.`,`If this persists, clear the broken npx cache and restart:`,` npm cache clean --force`,` npx -y @vpxa/aikit@latest serve`].join(`
|
|
3073
3070
|
`):[`To fix embedding errors, try deleting the cached model:`,` rm -rf ~/.cache/huggingface/transformers-js/mixedbread-ai/`,`Then restart the server to re-download a fresh copy.`].join(`
|
|
3074
|
-
`)}async function
|
|
3075
|
-
`),`utf8`),$.info(`Auto-heal: created ESM shim for @huggingface/transformers (.mjs wrapper → .cjs)`,{path:t}))}catch(e){$.warn(`Auto-heal: failed to create ESM shim`,{error:e instanceof Error?e.message:String(e),path:t})}}}if(n.includes(`embedding`)||n.includes(`onnx`)||n.includes(`protobuf`)||n.includes(`model`)){let t=e.embedding?.model;if(t){let e=F(Qn(),`.cache`,`huggingface`,`transformers-js`,t);try{await r(e,{recursive:!0,force:!0}),$.info(`Auto-heal: cleared embedding model cache`,{path:e})}catch{}}}if(n.includes(`lance`)||n.includes(`database`)||n.includes(`store`)){let t=F(e.store.path,`lance`);try{await r(t,{recursive:!0,force:!0}),$.info(`Auto-heal: cleared LanceDB store`,{path:t})}catch{}}if(n.includes(`sqlite`)||n.includes(`database disk image`)||n.includes(`graph`)){let t=F(e.store.path,`graph.db`);try{await r(t,{force:!0}),$.info(`Auto-heal: cleared graph database`,{path:t})}catch{}let n=F(e.store.path,`aikit.db`);try{await r(n,{force:!0}),await r(`${n}-wal`,{force:!0}).catch(()=>{}),await r(`${n}-shm`,{force:!0}).catch(()=>{}),$.info(`Auto-heal: cleared corrupted aikit database`,{path:n})}catch{}}if(
|
|
3071
|
+
`)}async function eb(){try{let{existsSync:e,readFileSync:t}=await import(`node:fs`),n=F(Qn(),`.aikit`,`current-version.json`);if(!e(n))return null;let r=JSON.parse(t(n,`utf-8`));if(!r.version)return null;let i=oe();return r.version===i?null:r.version}catch{return null}}async function tb(e,t){let n=t.toLowerCase(),r;try{({rm:r}=await import(`node:fs/promises`))}catch{return}if(n.includes(`transformers.node.mjs`)&&n.includes(`cannot find module`)){let e=t.match(/Cannot find module '([^']+transformers\.node\.mjs)'/);if(e){let t=e[1],n=t.replace(/\.mjs$/,`.cjs`);try{let{existsSync:e,writeFileSync:r}=await import(`node:fs`);e(n)&&!e(t)&&(r(t,[`// Auto-generated ESM shim — published package missing this file`,`import { createRequire } from 'node:module';`,`const require = createRequire(import.meta.url);`,`const mod = require('./transformers.node.cjs');`,`export default mod;`,``].join(`
|
|
3072
|
+
`),`utf8`),$.info(`Auto-heal: created ESM shim for @huggingface/transformers (.mjs wrapper → .cjs)`,{path:t}))}catch(e){$.warn(`Auto-heal: failed to create ESM shim`,{error:e instanceof Error?e.message:String(e),path:t})}}}if(n.includes(`embedding`)||n.includes(`onnx`)||n.includes(`protobuf`)||n.includes(`model`)){let t=e.embedding?.model;if(t){let e=F(Qn(),`.cache`,`huggingface`,`transformers-js`,t);try{await r(e,{recursive:!0,force:!0}),$.info(`Auto-heal: cleared embedding model cache`,{path:e})}catch{}}}if(n.includes(`lance`)||n.includes(`database`)||n.includes(`store`)){let t=F(e.store.path,`lance`);try{await r(t,{recursive:!0,force:!0}),$.info(`Auto-heal: cleared LanceDB store`,{path:t})}catch{}}if(n.includes(`sqlite`)||n.includes(`database disk image`)||n.includes(`graph`)){let t=F(e.store.path,`graph.db`);try{await r(t,{force:!0}),$.info(`Auto-heal: cleared graph database`,{path:t})}catch{}let n=F(e.store.path,`aikit.db`);try{await r(n,{force:!0}),await r(`${n}-wal`,{force:!0}).catch(()=>{}),await r(`${n}-shm`,{force:!0}).catch(()=>{}),$.info(`Auto-heal: cleared corrupted aikit database`,{path:n})}catch{}}if(cm(t)){let e=await dm(t);e.repaired||$.warn(`Auto-heal: missing runtime dependency repair did not complete`,{packages:e.packages,reason:e.reason,error:e.error,hint:`Run: npm cache clean --force && npx -y @vpxa/aikit@latest serve`})}else n.includes(`cannot find module`)&&!n.includes(`.cache`)&&$.warn(`Auto-heal: missing module detected during initialization cleanup`,{hint:`Run: npm cache clean --force && npx -y @vpxa/aikit@latest serve`})}function nb(e,t){let n=Zs(e,ro,U,Ss(e)),r=Ny(e,n,U),i=new er({name:e.serverName??`aikit`,version:oe()},{capabilities:{logging:{},completions:{},prompts:{}},instructions:r}),a=`initializing`,o=``,s=!1,c=null,l=null,u=null;function d(e){if(!e||typeof e!=`object`)return[];let t=e,n=[];for(let e of[`path`,`file`,`source_path`,`sourcePath`,`filePath`]){let r=t[e];typeof r==`string`&&r&&n.push(r)}for(let e of[`changed_files`,`paths`,`files`]){let r=t[e];if(Array.isArray(r))for(let e of r){if(typeof e==`string`){n.push(e);continue}e&&typeof e==`object`&&typeof e.path==`string`&&n.push(e.path)}}if(Array.isArray(t.sources))for(let e of t.sources)e&&typeof e==`object`&&typeof e.path==`string`&&n.push(e.path);return n}let f=()=>a===`failed`?[`❌ AI Kit initialization failed — this tool is unavailable.`,``,o?`Error: ${o}`:``,``,`**${io.size} tools are still available** and fully functional:`,`check, eval, test_run, git_context, health, measure, web_fetch, web_search,`,`flow, regex_test, encode,`,`stash, checkpoint, lane, process, time, env, and more.`,``,$y(o),``,`Try restarting the MCP server to retry initialization.`].filter(Boolean).join(`
|
|
3076
3073
|
`):[`AI Kit is still initializing (loading embeddings model & store).`,``,`**${io.size} tools are already available** while initialization completes — including:`,`check, eval, test_run, git_context, health, measure, web_fetch, web_search,`,`flow, regex_test, encode,`,`stash, checkpoint, lane, process, time, env, and more.`,``,`This tool requires the AI Kit index. Please retry in a few seconds,`,`or use one of the available tools above in the meantime.`].join(`
|
|
3077
|
-
`);si(i);let p=new Uo;p.use(Ts(),{order:1,name:`structured-content-guard`}),Is(i,p,e.toolPrefix??``);let m=i.sendToolListChanged.bind(i);i.sendToolListChanged=()=>{};let h=[];for(let e of ro){if(!n.has(e))continue;let t=W(e),r=i.registerTool(e,{title:t.title,description:`${t.title} — initializing, available shortly`,inputSchema:{},annotations:t.annotations},async()=>({content:[{type:`text`,text:f()}]}));io.has(e)?r.remove():h.push(r)}Ey(i,e,n),i.sendToolListChanged=m;let g=i.registerResource(`aikit-status`,`aikit://status`,{description:`AI Kit status (initializing...)`,mimeType:`text/plain`},async()=>({contents:[{uri:`aikit://status`,text:`AI Kit is initializing...`,mimeType:`text/plain`}]})),_=i.registerPrompt(`_init`,{description:`Initializing AI Kit…`,argsSchema:{_dummy:or(R.string(),()=>[])}},async()=>({messages:[]})),v,y,b=new Promise((e,t)=>{v=e,y=t}),x,S=new Promise(e=>{x=e}),C=()=>x?.(),w=(async()=>{await S;try{let{createRequire:e}=await import(`node:module`),{readFileSync:t,existsSync:n}=await import(`node:fs`),{fileURLToPath:r}=await import(`node:url`),{resolve:i,dirname:a}=await import(`node:path`),o=e(import.meta.url),s=a(r(import.meta.url)),c=i(s,`..`,`package.json`),l=i(s,`..`,`..`),u=JSON.parse(t(c,`utf8`)),d=Object.keys(u.dependencies??{}),f=[`@mixmark-io/domino`],p=[...d,...f.filter(e=>!d.includes(e))],m=p.filter(e=>!e.startsWith(`@aikit/`)),h=p.filter(e=>e.startsWith(`@aikit/`)),g=[];for(let e of m)try{o.resolve(e)}catch{try{o.resolve(`${e}/package.json`)}catch{g.push(e)}}g.length>0&&$.warn(`Dependencies not resolvable — server may operate in degraded mode`,{missing:g,hint:`Run: npm cache clean --force && npx -y @vpxa/aikit@latest serve`});let _=[];if(h.length>0){for(let e of h)n(i(l,e.slice(7),`dist`))||_.push(e);_.length>0&&$.warn(`Workspace sibling packages missing dist — server may have degraded features`,{missing:_,hint:`Reinstall: npm cache clean --force && npx -y @vpxa/aikit@latest serve`})}}catch{}let n;try{n=await Ay(e)}catch(t){let r=t instanceof Error?t.message:String(t);if(Xy(r)){let t=await Qy();if(t){a=`failed`,o=`Server v${oe()} superseded by installed v${t}. Restart the MCP server to use the new version.`,$.info(o),y?.(Error(o));return}$.warn(`AI Kit initialization failed with recoverable error — attempting auto-heal retry`,{error:r}),await $y(e,r);try{n=await Ay(e),$.info(`AI Kit auto-heal successful — initialization recovered after retry`)}catch(e){a=`failed`,o=e instanceof Error?e.message:String(e),$.error(`AI Kit initialization failed after auto-heal attempt — server continuing with zero-dep tools only`,{error:o,originalError:r}),y?.(e instanceof Error?e:Error(o));return}}else{a=`failed`,o=r,$.error(`AI Kit initialization failed — server continuing with zero-dep tools only`,{error:o}),y?.(t instanceof Error?t:Error(o));return}}ae();let r=i.sendToolListChanged.bind(i);i.sendToolListChanged=()=>{};let f=i.sendPromptListChanged.bind(i);i.sendPromptListChanged=()=>{};let p=i.sendResourceListChanged.bind(i);i.sendResourceListChanged=()=>{};for(let e of h)e.remove();g.remove(),_.remove();let m=i._registeredTools??{};for(let e of io)m[e]?.remove();let b=new Oy(i),x=ii(i);Ty({server:i,aikit:n,config:e,elicitor:ai(i),resourceNotifier:b,samplingClient:x,indexMode:t,getSmartState:t===`smart`?(()=>{let e=u;return e?.getState?e.getState():null}):null,getSmartScheduler:t===`smart`?()=>{let e=u;return e?{prioritize:e.prioritize.bind(e)}:null}:null}),vi(i,{curated:n.curated,store:n.store,graphStore:n.graphStore,stateStore:n.stateStore},t),i.sendToolListChanged=r,i.sendPromptListChanged=f,i.sendResourceListChanged=p,Promise.resolve(i.sendToolListChanged()).catch(()=>{}),Promise.resolve(i.sendPromptListChanged()).catch(()=>{}),Promise.resolve(i.sendResourceListChanged()).catch(()=>{});let C=i._registeredTools??{};for(let[e,t]of Object.entries(C)){if(ao.has(e))continue;let r=t.handler;t.handler=async(...i)=>{if(!n.indexer.isIndexing)return r(...i);let a=s?`re-indexing`:`running initial index`,o=new Promise(n=>setTimeout(()=>n({content:[{type:`text`,text:`⏳ AI Kit is ${a}. The tool "${e}" timed out waiting for index data (${Cs/1e3}s).\n\nThe existing index may be temporarily locked. Please retry shortly — indexing will complete automatically.`}],...t.config?.outputSchema?{structuredContent:js(t.config.outputSchema)}:{}}),Cs));return Promise.race([r(...i),o])}}for(let[e,t]of Object.entries(C)){let n=t.handler,r=Hy(e);t.handler=async(...i)=>{try{return await Uy(e=>zy(e,()=>n(...i)),r,e)}catch(n){if(n instanceof Vy)return{content:[{type:`text`,text:`⏳ Tool "${e}" timed out after ${r/1e3}s. This may indicate a long-running operation. Please retry or break the task into smaller steps.`}],...t.config?.outputSchema?{structuredContent:js(t.config.outputSchema)}:{}};throw n}}}let w=Object.keys(C).length;w<ro.length&&$.warn(`ALL_TOOL_NAMES count mismatch`,{expectedToolCount:ro.length,registeredToolCount:w}),$.debug(`MCP server configured`,{toolCount:ro.length,resourceCount:4});let T=new Ly;T.onPressure((e,t)=>{e===`warning`&&di(),e===`critical`&&($.warn(`Memory pressure critical — consider restarting`,{rssMB:Math.round(t/1024/1024)}),di())}),T.registerMemoryPressureCallback(()=>n.embedder.shutdown?.()),T.start();let D=new Fy;l=D,D.onIdle(async()=>{if(E.isRunning||n.indexer.isIndexing){$.info(`Idle cleanup deferred — background tasks still running`),D.touch();return}$.info(`Idle cleanup: releasing cached memory (connections stay open)`);try{n.store.releaseMemory?.(),n.graphStore.releaseMemory?.()}catch{}}),D.touch();let O=!1;for(let e of Object.values(C)){let t=e.handler;e.handler=async(...e)=>{if(O||(O=!0,D.markSessionActive()),D.touch(),u){let t=d(e[0]);t.length>0&&u.prioritize(...t)}return t(...e)}}Yy(C,n,{statePath:e.stateDir??``,l0CardDir:e.l0CardDir});for(let[,e]of Object.entries(C)){let t=e.config?.outputSchema;if(!t)continue;let n=e.handler;e.handler=async(...e)=>{let r=await n(...e);if(!r||typeof r!=`object`)return r;let i=r;return!(`content`in i)||i.isError||i.structuredContent!=null&&typeof i.structuredContent==`object`?r:(i.structuredContent=js(t),i.structuredContent??={},r)}}process.stdin.on(`end`,()=>($.info(`stdin closed — MCP client disconnected. Shutting down.`),process.exit(0))),process.stdin.on(`error`,()=>($.info(`stdin error — MCP client disconnected. Shutting down.`),process.exit(0))),c=n,v?.(n)})(),T=async()=>{let t;try{t=await b}catch{$.warn(`Skipping initial index — AI Kit initialization failed`);return}l?.setBusy(!0);try{let n=e.sources.map(e=>e.path).join(`, `);$.info(`Running initial index`,{sourcePaths:n});let r=await t.indexer.index(e,e=>{e.phase===`crawling`||e.phase===`done`||(e.phase===`chunking`&&e.currentFile&&$.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&$.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});s=!0,$.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){$.warn(`FTS index creation failed`,M(e))}try{let e=await t.curated.reindexAll();$.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){$.error(`Curated re-index failed`,M(e))}}catch(e){$.error(`Initial index failed; will retry on aikit_reindex`,M(e))}finally{l?.setBusy(!1)}},E=new Ny,D=()=>E.schedule({name:`initial-index`,fn:T}),O=process.ppid,k=setInterval(()=>{try{process.kill(O,0)}catch{$.info(`Parent process died; shutting down`,{parentPid:O}),clearInterval(k),u?.stop&&u.stop(),import(`../../tools/dist/index.js`).then(({processStopAll:e})=>e()).catch(()=>{}),b.then(async e=>{await Promise.all([e.embedder.shutdown?.().catch(()=>{})??Promise.resolve(),e.graphStore.close().catch(()=>{}),e.closeStateStore?.().catch(()=>{})??Promise.resolve(),e.store.close().catch(()=>{})])}).catch(()=>{}).finally(()=>process.exit(0))}},5e3);return k.unref(),{server:i,startInit:C,ready:w,runInitialIndex:D,get aikit(){return c},scheduler:E,setSmartScheduler(e){u=e}}}const tb=j(`server`);function nb(e,t){let n=Zs(t,[...ro,...bs],U,Ss(t)),r=jy(t,n,U),i=new er({name:t.serverName??`aikit`,version:oe()},{capabilities:{logging:{},completions:{},prompts:{},extensions:{roots:{}}},instructions:r}),a=i;return a.setNotificationHandler(nr,async()=>{try{let{roots:e}=await a.listRoots();if(e&&e.length>0){let n=le(e[0].uri);process.env.AIKIT_TRANSPORT===`http`?(t.sources[0]={path:n,excludePatterns:t.sources[0]?.excludePatterns??[]},t.allRoots=e.map(e=>le(e.uri)),tb.info(`Workspace root updated (HTTP mode)`,{rootPath:n,sourceCount:t.sources.length})):(x(t,n),tb.info(`Workspace root updated (stdio mode)`,{rootPath:n}))}}catch(e){tb.debug(`MCP roots/list not available`,{error:M(e)})}}),si(i),Ty({server:i,aikit:e,config:t,elicitor:ai(i),resourceNotifier:new Oy(i),samplingClient:ii(i),precomputedActiveTools:n}),vi(i,{curated:e.curated,store:e.store,graphStore:e.graphStore,stateStore:e.stateStore},t.indexMode),i}async function rb(e){let t=await Ay(e),n=nb(t,e);tb.debug(`MCP server configured`,{toolCount:ro.length,resourceCount:2});let r=async()=>{try{let n=e.sources.map(e=>e.path).join(`, `);tb.info(`Running initial index`,{sourcePaths:n});let r=await t.indexer.index(e,e=>{e.phase===`crawling`||e.phase===`done`||(e.phase===`chunking`&&e.currentFile&&tb.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&tb.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});tb.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){tb.warn(`FTS index creation failed`,M(e))}try{let e=await t.curated.reindexAll();tb.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){tb.error(`Curated re-index failed`,M(e))}}catch(e){tb.error(`Initial index failed; will retry on aikit_reindex`,M(e))}},i=async()=>{tb.info(`Shutting down`),await import(`../../tools/dist/index.js`).then(({processStopAll:e})=>e()).catch(()=>{}),await Promise.all([t.embedder.shutdown?.().catch(()=>{})??Promise.resolve(),t.graphStore.close().catch(()=>{}),t.closeStateStore?.().catch(()=>{})??Promise.resolve(),t.store.close().catch(()=>{})]),process.exit(0)};process.on(`SIGINT`,i),process.on(`SIGTERM`,i);let a=process.ppid,o=setInterval(()=>{try{process.kill(a,0)}catch{tb.info(`Parent process died; shutting down`,{parentPid:a}),clearInterval(o),i()}},5e3);return o.unref(),{server:n,runInitialIndex:r,shutdown:i}}export{ro as ALL_TOOL_NAMES,eb as createLazyServer,nb as createMcpServer,rb as createServer,Ay as initializeAikit,Zv as n,ii as r,Ty as registerMcpTools,Qv as t};
|
|
3074
|
+
`);si(i);let p=new Uo;p.use(Ts(),{order:1,name:`structured-content-guard`}),Is(i,p,e.toolPrefix??``);let m=i.sendToolListChanged.bind(i);i.sendToolListChanged=()=>{};let h=[];for(let e of ro){if(!n.has(e))continue;let t=W(e),r=i.registerTool(e,{title:t.title,description:`${t.title} — initializing, available shortly`,inputSchema:{},annotations:t.annotations},async()=>({content:[{type:`text`,text:f()}]}));io.has(e)?r.remove():h.push(r)}Oy(i,e,n),i.sendToolListChanged=m;let g=i.registerResource(`aikit-status`,`aikit://status`,{description:`AI Kit status (initializing...)`,mimeType:`text/plain`},async()=>({contents:[{uri:`aikit://status`,text:`AI Kit is initializing...`,mimeType:`text/plain`}]})),_=i.registerPrompt(`_init`,{description:`Initializing AI Kit…`,argsSchema:{_dummy:or(R.string(),()=>[])}},async()=>({messages:[]})),v,y,b=new Promise((e,t)=>{v=e,y=t}),x,S=new Promise(e=>{x=e}),C=()=>x?.(),w=(async()=>{await S;try{let{createRequire:e}=await import(`node:module`),{readFileSync:t,existsSync:n}=await import(`node:fs`),{fileURLToPath:r}=await import(`node:url`),{resolve:i,dirname:a}=await import(`node:path`),o=e(import.meta.url),s=a(r(import.meta.url)),c=i(s,`..`,`package.json`),l=i(s,`..`,`..`),u=JSON.parse(t(c,`utf8`)),d=Object.keys(u.dependencies??{}),f=[`@mixmark-io/domino`],p=[...d,...f.filter(e=>!d.includes(e))],m=p.filter(e=>!e.startsWith(`@aikit/`)),h=p.filter(e=>e.startsWith(`@aikit/`)),g=[];for(let e of m)try{o.resolve(e)}catch{try{o.resolve(`${e}/package.json`)}catch{g.push(e)}}g.length>0&&$.warn(`Dependencies not resolvable — server may operate in degraded mode`,{missing:g,hint:`Run: npm cache clean --force && npx -y @vpxa/aikit@latest serve`});let _=[];if(h.length>0){for(let e of h)n(i(l,e.slice(7),`dist`))||_.push(e);_.length>0&&$.warn(`Workspace sibling packages missing dist — server may have degraded features`,{missing:_,hint:`Reinstall: npm cache clean --force && npx -y @vpxa/aikit@latest serve`})}}catch{}let n;try{n=await My(e)}catch(t){let r=t instanceof Error?t.message:String(t);if(Qy(r)){let t=await eb();if(t){a=`failed`,o=`Server v${oe()} superseded by installed v${t}. Restart the MCP server to use the new version.`,$.info(o),y?.(Error(o));return}$.warn(`AI Kit initialization failed with recoverable error — attempting auto-heal retry`,{error:r}),await tb(e,r);try{n=await My(e),$.info(`AI Kit auto-heal successful — initialization recovered after retry`)}catch(e){a=`failed`,o=e instanceof Error?e.message:String(e),$.error(`AI Kit initialization failed after auto-heal attempt — server continuing with zero-dep tools only`,{error:o,originalError:r}),y?.(e instanceof Error?e:Error(o));return}}else{a=`failed`,o=r,$.error(`AI Kit initialization failed — server continuing with zero-dep tools only`,{error:o}),y?.(t instanceof Error?t:Error(o));return}}ae();let r=i.sendToolListChanged.bind(i);i.sendToolListChanged=()=>{};let f=i.sendPromptListChanged.bind(i);i.sendPromptListChanged=()=>{};let p=i.sendResourceListChanged.bind(i);i.sendResourceListChanged=()=>{};for(let e of h)e.remove();g.remove(),_.remove();let m=i._registeredTools??{};for(let e of io)m[e]?.remove();let b=new Ay(i),x=ii(i);Dy({server:i,aikit:n,config:e,elicitor:ai(i),resourceNotifier:b,samplingClient:x,indexMode:t,getSmartState:t===`smart`?(()=>{let e=u;return e?.getState?e.getState():null}):null,getSmartScheduler:t===`smart`?()=>{let e=u;return e?{prioritize:e.prioritize.bind(e)}:null}:null}),vi(i,{curated:n.curated,store:n.store,graphStore:n.graphStore,stateStore:n.stateStore},t),i.sendToolListChanged=r,i.sendPromptListChanged=f,i.sendResourceListChanged=p,Promise.resolve(i.sendToolListChanged()).catch(()=>{}),Promise.resolve(i.sendPromptListChanged()).catch(()=>{}),Promise.resolve(i.sendResourceListChanged()).catch(()=>{});let C=i._registeredTools??{};for(let[e,t]of Object.entries(C)){if(ao.has(e))continue;let r=t.handler;t.handler=async(...i)=>{if(!n.indexer.isIndexing)return r(...i);let a=s?`re-indexing`:`running initial index`,o=new Promise(n=>setTimeout(()=>n({content:[{type:`text`,text:`⏳ AI Kit is ${a}. The tool "${e}" timed out waiting for index data (${Cs/1e3}s).\n\nThe existing index may be temporarily locked. Please retry shortly — indexing will complete automatically.`}],...t.config?.outputSchema?{structuredContent:js(t.config.outputSchema)}:{}}),Cs));return Promise.race([r(...i),o])}}for(let[e,t]of Object.entries(C)){let n=t.handler,r=Wy(e);t.handler=async(...i)=>{try{return await Gy(e=>Vy(e,()=>n(...i)),r,e)}catch(n){if(n instanceof Uy)return{content:[{type:`text`,text:`⏳ Tool "${e}" timed out after ${r/1e3}s. This may indicate a long-running operation. Please retry or break the task into smaller steps.`}],...t.config?.outputSchema?{structuredContent:js(t.config.outputSchema)}:{}};throw n}}}let w=Object.keys(C).length;w<ro.length&&$.warn(`ALL_TOOL_NAMES count mismatch`,{expectedToolCount:ro.length,registeredToolCount:w}),$.debug(`MCP server configured`,{toolCount:ro.length,resourceCount:4});let T=new zy;T.onPressure((e,t)=>{e===`warning`&&di(),e===`critical`&&($.warn(`Memory pressure critical — consider restarting`,{rssMB:Math.round(t/1024/1024)}),di())}),T.registerMemoryPressureCallback(()=>n.embedder.shutdown?.()),T.start();let D=new Ly;l=D,D.onIdle(async()=>{if(E.isRunning||n.indexer.isIndexing){$.info(`Idle cleanup deferred — background tasks still running`),D.touch();return}$.info(`Idle cleanup: releasing cached memory (connections stay open)`);try{n.store.releaseMemory?.(),n.graphStore.releaseMemory?.()}catch{}}),D.touch();let O=!1;for(let e of Object.values(C)){let t=e.handler;e.handler=async(...e)=>{if(O||(O=!0,D.markSessionActive()),D.touch(),u){let t=d(e[0]);t.length>0&&u.prioritize(...t)}return t(...e)}}Zy(C,n,{statePath:e.stateDir??``,l0CardDir:e.l0CardDir});for(let[,e]of Object.entries(C)){let t=e.config?.outputSchema;if(!t)continue;let n=e.handler;e.handler=async(...e)=>{let r=await n(...e);if(!r||typeof r!=`object`)return r;let i=r;return!(`content`in i)||i.isError||i.structuredContent!=null&&typeof i.structuredContent==`object`?r:(i.structuredContent=js(t),i.structuredContent??={},r)}}process.stdin.on(`end`,()=>($.info(`stdin closed — MCP client disconnected. Shutting down.`),process.exit(0))),process.stdin.on(`error`,()=>($.info(`stdin error — MCP client disconnected. Shutting down.`),process.exit(0))),c=n,v?.(n)})(),T=async()=>{let t;try{t=await b}catch{$.warn(`Skipping initial index — AI Kit initialization failed`);return}l?.setBusy(!0);try{let n=e.sources.map(e=>e.path).join(`, `);$.info(`Running initial index`,{sourcePaths:n});let r=await t.indexer.index(e,e=>{e.phase===`crawling`||e.phase===`done`||(e.phase===`chunking`&&e.currentFile&&$.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&$.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});s=!0,$.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){$.warn(`FTS index creation failed`,M(e))}try{let e=await t.curated.reindexAll();$.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){$.error(`Curated re-index failed`,M(e))}}catch(e){$.error(`Initial index failed; will retry on aikit_reindex`,M(e))}finally{l?.setBusy(!1)}},E=new Fy,D=()=>E.schedule({name:`initial-index`,fn:T}),O=process.ppid,k=setInterval(()=>{try{process.kill(O,0)}catch{$.info(`Parent process died; shutting down`,{parentPid:O}),clearInterval(k),u?.stop&&u.stop(),import(`../../tools/dist/index.js`).then(({processStopAll:e})=>e()).catch(()=>{}),b.then(async e=>{await Promise.all([e.embedder.shutdown?.().catch(()=>{})??Promise.resolve(),e.graphStore.close().catch(()=>{}),e.closeStateStore?.().catch(()=>{})??Promise.resolve(),e.store.close().catch(()=>{})])}).catch(()=>{}).finally(()=>process.exit(0))}},5e3);return k.unref(),{server:i,startInit:C,ready:w,runInitialIndex:D,get aikit(){return c},scheduler:E,setSmartScheduler(e){u=e}}}const rb=j(`server`);function ib(e,t){let n=Zs(t,[...ro,...bs],U,Ss(t)),r=Ny(t,n,U),i=new er({name:t.serverName??`aikit`,version:oe()},{capabilities:{logging:{},completions:{},prompts:{},extensions:{roots:{}}},instructions:r}),a=i;return a.setNotificationHandler(nr,async()=>{try{let{roots:e}=await a.listRoots();if(e&&e.length>0){let n=le(e[0].uri);process.env.AIKIT_TRANSPORT===`http`?(t.sources[0]={path:n,excludePatterns:t.sources[0]?.excludePatterns??[]},t.allRoots=e.map(e=>le(e.uri)),rb.info(`Workspace root updated (HTTP mode)`,{rootPath:n,sourceCount:t.sources.length})):(x(t,n),rb.info(`Workspace root updated (stdio mode)`,{rootPath:n}))}}catch(e){rb.debug(`MCP roots/list not available`,{error:M(e)})}}),si(i),Dy({server:i,aikit:e,config:t,elicitor:ai(i),resourceNotifier:new Ay(i),samplingClient:ii(i),precomputedActiveTools:n}),vi(i,{curated:e.curated,store:e.store,graphStore:e.graphStore,stateStore:e.stateStore},t.indexMode),i}async function ab(e){let t=await My(e),n=ib(t,e);rb.debug(`MCP server configured`,{toolCount:ro.length,resourceCount:2});let r=async()=>{try{let n=e.sources.map(e=>e.path).join(`, `);rb.info(`Running initial index`,{sourcePaths:n});let r=await t.indexer.index(e,e=>{e.phase===`crawling`||e.phase===`done`||(e.phase===`chunking`&&e.currentFile&&rb.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&rb.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});rb.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){rb.warn(`FTS index creation failed`,M(e))}try{let e=await t.curated.reindexAll();rb.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){rb.error(`Curated re-index failed`,M(e))}}catch(e){rb.error(`Initial index failed; will retry on aikit_reindex`,M(e))}},i=async()=>{rb.info(`Shutting down`),await import(`../../tools/dist/index.js`).then(({processStopAll:e})=>e()).catch(()=>{}),await Promise.all([t.embedder.shutdown?.().catch(()=>{})??Promise.resolve(),t.graphStore.close().catch(()=>{}),t.closeStateStore?.().catch(()=>{})??Promise.resolve(),t.store.close().catch(()=>{})]),process.exit(0)};process.on(`SIGINT`,i),process.on(`SIGTERM`,i);let a=process.ppid,o=setInterval(()=>{try{process.kill(a,0)}catch{rb.info(`Parent process died; shutting down`,{parentPid:a}),clearInterval(o),i()}},5e3);return o.unref(),{server:n,runInitialIndex:r,shutdown:i}}export{ro as ALL_TOOL_NAMES,nb as createLazyServer,ib as createMcpServer,ab as createServer,My as initializeAikit,$v as n,ii as r,Dy as registerMcpTools,ey as t};
|