@vpxa/aikit 0.1.184 → 0.1.186
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/browser/dist/index.js +1 -1
- package/packages/server/dist/index.js +1 -1
- package/packages/server/dist/{server-TZDCpgEd.js → server-BCnhTdUy.js} +115 -115
- package/scaffold/dist/definitions/bodies.mjs +17 -1
- package/scaffold/dist/definitions/skills/browser-use.mjs +1 -1
|
@@ -1,36 +1,36 @@
|
|
|
1
|
-
import{n as e,t}from"./curated-manager-BnP6VqvL.js";import{_ as n,c as r,d as i,f as a,g as o,h as s,i as c,l,m as u,n as d,o as f,p,r as m,s as h,u as g,v as _,y as v}from"./supersession-DJQGXMWm.js";import{autoUpgradeScaffold as y,getCurrentVersion as b,getUpgradeState as x}from"./version-check-BgHzxxCW.js";import{createRequire as S}from"node:module";import{createHash as C,randomBytes as w,randomUUID as T,timingSafeEqual as E}from"node:crypto";import{existsSync as D,mkdirSync as O,readFileSync as k,readdirSync as A,renameSync as j,rmSync as ee,statSync as te,writeFileSync as ne}from"node:fs";import{basename as re,dirname as M,isAbsolute as ie,join as N,relative as ae,resolve as P,sep as oe}from"node:path";import{fileURLToPath as se}from"node:url";import{AIKIT_PATHS as ce,CONTENT_TYPES as le,EMBEDDING_DEFAULTS as ue,KNOWLEDGE_ORIGINS as de,SOURCE_TYPES as fe,TOKEN_BUDGETS as pe,addLogListener as me,computePartitionKey as he,createLogger as F,getGlobalDataDir as ge,getPartitionDir as _e,isUserInstalled as ve,listWorkspaces as ye,serializeError as I}from"../../core/dist/index.js";import{FileCache as be,acquireLease as xe,addToWorkset as Se,audit as Ce,bookendReorder as we,changelog as Te,check as Ee,checkpointDiff as De,checkpointGC as Oe,checkpointHistory as ke,checkpointLatest as Ae,checkpointList as je,checkpointLoad as Me,checkpointSave as Ne,codemod as Pe,compact as Fe,compressTerminalOutput as Ie,createRestorePoint as Le,dataTransform as Re,delegate as ze,delegateListModels as Be,deleteWorkset as Ve,diffParse as He,digest as Ue,encode as We,ensureLegacyStashImported as Ge,envInfo as Ke,evaluate as qe,evidenceMap as Je,fileSummary as Ye,find as Xe,findDeadSymbols as Ze,findExamples as Qe,forgeClassify as $e,forgeGround as et,getWorkset as tt,gitContext as nt,graphAugmentSearch as rt,graphQuery as it,guide as at,health as ot,httpRequest as st,laneCreate as ct,laneDiff as lt,laneDiscard as ut,laneList as dt,laneMerge as ft,laneStatus as pt,listActiveLeases as mt,listRestorePoints as ht,listWorksets as gt,measure as _t,onboard as vt,parseOutput as yt,processList as bt,processLogs as xt,processStart as St,processStatus as Ct,processStop as wt,queueClear as Tt,queueCreate as Et,queueDag as Dt,queueDelete as Ot,queueDone as kt,queueFail as At,queueGet as jt,queueList as Mt,queueNext as Nt,queuePush as Pt,regexTest as Ft,releaseLease as It,removeFromWorkset as Lt,rename as Rt,replayAppend as zt,replayClear as Bt,replayList as Vt,replayTrim as Ht,restoreFromPoint as Ut,saveWorkset as Wt,schemaValidate as Gt,scopeMap as Kt,sessionDigest as qt,sessionDigestSampling as Jt,stashClear as Yt,stashDelete as Xt,stashGet as Zt,stashList as Qt,stashSet as $t,stratumCard as en,summarizeCheckResult as tn,symbol as nn,testRun as rn,timeUtils as an,trace as on,truncateToTokenBudget as sn,watchList as cn,watchStart as ln,watchStop as un,webFetch as dn,webSearch as fn}from"../../tools/dist/index.js";import{mkdir as pn,readFile as mn,readdir as hn,rm as gn,stat as _n,unlink as vn,writeFile as yn}from"node:fs/promises";import{exec as bn,execSync as xn}from"node:child_process";import{homedir as Sn}from"node:os";import{McpServer as Cn,ResourceTemplate as wn}from"@modelcontextprotocol/sdk/server/mcp.js";import{buildFormSchema as Tn,field as En,normalizeResponse as Dn}from"../../elicitation/dist/index.js";import{completable as On}from"@modelcontextprotocol/sdk/server/completable.js";import{z as L}from"zod";import{registerBrowserTools as
|
|
1
|
+
import{n as e,t}from"./curated-manager-BnP6VqvL.js";import{_ as n,c as r,d as i,f as a,g as o,h as s,i as c,l,m as u,n as d,o as f,p,r as m,s as h,u as g,v as _,y as v}from"./supersession-DJQGXMWm.js";import{autoUpgradeScaffold as y,getCurrentVersion as b,getUpgradeState as x}from"./version-check-BgHzxxCW.js";import{createRequire as S}from"node:module";import{createHash as C,randomBytes as w,randomUUID as T,timingSafeEqual as E}from"node:crypto";import{existsSync as D,mkdirSync as O,readFileSync as k,readdirSync as A,renameSync as j,rmSync as ee,statSync as te,writeFileSync as ne}from"node:fs";import{basename as re,dirname as M,isAbsolute as ie,join as N,relative as ae,resolve as P,sep as oe}from"node:path";import{fileURLToPath as se}from"node:url";import{AIKIT_PATHS as ce,CONTENT_TYPES as le,EMBEDDING_DEFAULTS as ue,KNOWLEDGE_ORIGINS as de,SOURCE_TYPES as fe,TOKEN_BUDGETS as pe,addLogListener as me,computePartitionKey as he,createLogger as F,getGlobalDataDir as ge,getPartitionDir as _e,isUserInstalled as ve,listWorkspaces as ye,serializeError as I}from"../../core/dist/index.js";import{FileCache as be,acquireLease as xe,addToWorkset as Se,audit as Ce,bookendReorder as we,changelog as Te,check as Ee,checkpointDiff as De,checkpointGC as Oe,checkpointHistory as ke,checkpointLatest as Ae,checkpointList as je,checkpointLoad as Me,checkpointSave as Ne,codemod as Pe,compact as Fe,compressTerminalOutput as Ie,createRestorePoint as Le,dataTransform as Re,delegate as ze,delegateListModels as Be,deleteWorkset as Ve,diffParse as He,digest as Ue,encode as We,ensureLegacyStashImported as Ge,envInfo as Ke,evaluate as qe,evidenceMap as Je,fileSummary as Ye,find as Xe,findDeadSymbols as Ze,findExamples as Qe,forgeClassify as $e,forgeGround as et,getWorkset as tt,gitContext as nt,graphAugmentSearch as rt,graphQuery as it,guide as at,health as ot,httpRequest as st,laneCreate as ct,laneDiff as lt,laneDiscard as ut,laneList as dt,laneMerge as ft,laneStatus as pt,listActiveLeases as mt,listRestorePoints as ht,listWorksets as gt,measure as _t,onboard as vt,parseOutput as yt,processList as bt,processLogs as xt,processStart as St,processStatus as Ct,processStop as wt,queueClear as Tt,queueCreate as Et,queueDag as Dt,queueDelete as Ot,queueDone as kt,queueFail as At,queueGet as jt,queueList as Mt,queueNext as Nt,queuePush as Pt,regexTest as Ft,releaseLease as It,removeFromWorkset as Lt,rename as Rt,replayAppend as zt,replayClear as Bt,replayList as Vt,replayTrim as Ht,restoreFromPoint as Ut,saveWorkset as Wt,schemaValidate as Gt,scopeMap as Kt,sessionDigest as qt,sessionDigestSampling as Jt,stashClear as Yt,stashDelete as Xt,stashGet as Zt,stashList as Qt,stashSet as $t,stratumCard as en,summarizeCheckResult as tn,symbol as nn,testRun as rn,timeUtils as an,trace as on,truncateToTokenBudget as sn,watchList as cn,watchStart as ln,watchStop as un,webFetch as dn,webSearch as fn}from"../../tools/dist/index.js";import{mkdir as pn,readFile as mn,readdir as hn,rm as gn,stat as _n,unlink as vn,writeFile as yn}from"node:fs/promises";import{exec as bn,execSync as xn}from"node:child_process";import{homedir as Sn}from"node:os";import{McpServer as Cn,ResourceTemplate as wn}from"@modelcontextprotocol/sdk/server/mcp.js";import{buildFormSchema as Tn,field as En,normalizeResponse as Dn}from"../../elicitation/dist/index.js";import{completable as On}from"@modelcontextprotocol/sdk/server/completable.js";import{z as L}from"zod";import{getEngine as kn,registerBrowserTools as An}from"../../browser/dist/index.js";import{BlastRadiusAnalyzer as jn,DependencyAnalyzer as Mn,DiagramGenerator as Nn,EntryPointAnalyzer as Pn,KnowledgeProducer as Fn,PatternAnalyzer as In,StructureAnalyzer as Ln,SymbolAnalyzer as Rn}from"../../analyzers/dist/index.js";import{WasmDiagnostics as zn,WasmRuntime as Bn,initializeWasm as Vn}from"../../chunker/dist/index.js";import{ERCache as Hn,ERClient as Un,EvolutionCollector as Wn,PolicyStore as Gn,PushAdapter as Kn,mergeResults as qn}from"../../enterprise-bridge/dist/index.js";import{RESOURCE_MIME_TYPE as Jn,registerAppResource as Yn,registerAppTool as Xn}from"@modelcontextprotocol/ext-apps/server";import{SqliteGraphStore as Zn,allMigrations as Qn,createSqliteAdapter as $n,createStateStore as er,createStore as tr,runMigrations as nr}from"../../store/dist/index.js";import{TemplateRegistry as rr,buildShell as ir,dashboardTemplateDefinition as ar,defaultRegistry as or,flameGraphTemplateDefinition as sr,isError as cr,isResult as lr,kanbanTemplateDefinition as ur,listSortTemplateDefinition as dr,renderSurface as fr}from"../../blocks-core/dist/index.js";import{createServer as pr}from"node:http";import{EmbedderProxy as mr}from"../../embeddings/dist/index.js";import{FileHashCache as hr,IncrementalIndexer as gr}from"../../indexer/dist/index.js";function _r(e){function t(){return!!e.server?.getClientCapabilities?.()?.elicitation}async function n(n,r){if(t())try{let t=await e.server.elicitInput({message:n,requestedSchema:r});return Dn(t?{action:t.action,content:t.content}:void 0)}catch{return}}return{get available(){return t()},async ask(e){return await n(e.message,e.schema)||{action:`decline`}},async confirm(e){let t=await n(e,Tn({confirmed:En.confirm(e)}));return t?.action===`accept`&&t.content?.confirmed===!0},async selectOne(e,t){let r=await n(e,Tn({selection:En.select(`Choose one`,t)}));if(r?.action!==`accept`)return null;let i=r.content?.selection;return typeof i==`string`?i:null},async selectMany(e,t){let r=await n(e,Tn({selections:En.multi(`Choose one or more`,t)}));if(r?.action!==`accept`)return[];let i=r.content?.selections;return Array.isArray(i)?i:[]},async promptText(e,t){let r=await n(e,Tn({text:En.text(e,{description:t})}));if(r?.action!==`accept`)return null;let i=r.content?.text;return typeof i==`string`?i:null}}}const vr={debug:`debug`,info:`info`,warn:`warning`,error:`error`};function yr(e){return me(({level:t,component:n,message:r,data:i})=>{try{Promise.resolve(e.sendLoggingMessage({level:vr[t],logger:n,data:i?{message:r,...i}:r})).catch(()=>{})}catch{}})}const br=3e4,xr=new Map;function Sr(e,t,n){let r=xr.get(e);if(r&&Date.now()<r.expires)return Promise.resolve(r.data);let i=n();return Promise.resolve(i).then(n=>(xr.set(e,{data:n,expires:Date.now()+t}),n))}function Cr(){xr.clear()}function wr(e,t){return Sr(`curated-paths`,br,async()=>(await e.list()).map(e=>e.path)).then(e=>e.filter(e=>e.toLowerCase().includes(t.toLowerCase())).slice(0,20))}function Tr(e,t){return Sr(`file-paths`,br,()=>e.listSourcePaths()).then(e=>e.filter(e=>e.toLowerCase().includes(t.toLowerCase())).slice(0,20))}function Er(e,t){return Sr(`symbol-names`,br,async()=>(await e.findNodes({type:`symbol`,limit:500})).map(e=>e.name)).then(e=>e.filter(e=>e.toLowerCase().includes(t.toLowerCase())).slice(0,20))}function Dr(e,t){return t?Qt(t).map(e=>e.key).filter(t=>t.toLowerCase().includes(e.toLowerCase())).slice(0,20):[]}function Or(e){return gt().map(e=>e.name).filter(t=>t.toLowerCase().includes(e.toLowerCase())).slice(0,20)}function kr(e,t){return t?je(t).map(e=>e.label).filter(t=>t.toLowerCase().includes(e.toLowerCase())).slice(0,20):[]}function Ar(e,t,n){if(e.registerPrompt(`ready`,{title:`AI Kit Ready`,description:`AI Kit is ready — quick-start guide for search, onboard, and workflows`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`AI Kit is ready. Quick start:`,``,'• **New project?** → `onboard({ path: "." })` for full codebase analysis','• **Returning?** → `status({})` then `search({ query: "SESSION CHECKPOINT", origin: "curated" })`','• **Exploring?** → `guide({ goal: "your task" })` for workflow recommendations','• **Quick lookup?** → `search({ query: "your question" })`'].join(`
|
|
2
2
|
`)}}]})),e.registerPrompt(`onboard`,{title:`Onboard Codebase`,description:`Analyze the codebase for first-time onboarding — runs all analyzers and produces a knowledge summary`,argsSchema:{path:L.string().optional().describe(`Path to analyze (default: workspace root)`)}},async({path:e})=>({messages:[{role:`user`,content:{type:`text`,text:[`Run the full onboarding workflow for "${e??`.`}"`,``,`1. \`onboard({ path: "${e??`.`}" })\` — full codebase analysis`,`2. \`produce_knowledge({ path: "${e??`.`}" })\` — generate synthesis`,'3. `knowledge({ action: "remember", ... })` for key curated entries',"4. `status` to verify index health"].join(`
|
|
3
3
|
`)}}]})),e.registerPrompt(`sessionStart`,{title:`Start AI Kit Session`,description:`Initialize an AI Kit session — check status, list knowledge, and resume from last checkpoint`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`Run the session start protocol:`,``,"1. `status({})` — check AI Kit health and onboard state",'2. `knowledge({ action: "list" })` — see stored knowledge entries','3. `search({ query: "SESSION CHECKPOINT", origin: "curated" })` — resume prior work'].join(`
|
|
4
4
|
`)}}]})),e.registerPrompt(`sessionEnd`,{title:`End AI Kit Session`,description:`Persist decisions and create a session checkpoint before ending`,argsSchema:{summary:L.string().describe(`Brief summary of decisions made, blockers encountered, and next steps`)}},async({summary:e})=>({messages:[{role:`user`,content:{type:`text`,text:[`Run the session end protocol:`,``,'1. `knowledge({ action: "remember", title: "Session checkpoint: '+e.slice(0,60)+`...", content: "`+e.replace(/"/g,`\\"`)+'", category: "conventions" })` — persist findings',n===`smart`?`2. Smart indexing is active — index refreshes automatically`:"2. `reindex({})` — refresh search index if files changed",`3. Confirm session data saved`].join(`
|
|
5
5
|
`)}}]})),e.registerPrompt(`search`,{title:`Search AI Kit`,description:`Search AI Kit with hybrid semantic + keyword search`,argsSchema:{query:L.string().describe(`Search query`)}},async({query:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Search AI Kit for: "${e}"\n\nUse \`search({ query: "${e.replace(/"/g,`\\"`)}" })\` to find relevant code, documentation, and curated knowledge.`}}]})),e.registerPrompt(`remember`,{title:`Remember Knowledge`,description:`Store a decision, convention, or finding as curated knowledge`,argsSchema:{title:L.string().describe(`Title of the knowledge entry`),content:L.string().describe(`Content to remember`),category:L.enum([`conventions`,`decisions`,`patterns`,`blockers`,`tasks`]).optional().describe(`Category (default: conventions)`)}},async({title:e,content:t,category:n})=>({messages:[{role:`user`,content:{type:`text`,text:`Store this knowledge:\n\n\`knowledge({ action: "remember", title: "${e.replace(/"/g,`\\"`)}", content: "${t.replace(/"/g,`\\"`).slice(0,200)}...", category: "${n??`conventions`}" })\``}}]})),e.registerPrompt(`planTask`,{title:`Plan a Task`,description:`Generate a reading plan and scope map for a development task`,argsSchema:{task:L.string().describe(`Description of the task to plan`)}},async({task:e})=>({messages:[{role:`user`,content:{type:`text`,text:[`Plan implementation for: "${e}"`,``,'1. `search({ query: "'+e.replace(/"/g,`\\"`)+'" })` — find related code and prior decisions','2. `scope_map({ task: "'+e.replace(/"/g,`\\"`)+'" })` — generate a reading plan',"3. For each recommended file, use `file_summary` then `compact` for detail","4. `blast_radius` on planned changes to assess impact"].join(`
|
|
6
6
|
`)}}]})),e.registerPrompt(`investigate`,{title:`Investigate Bug`,description:`Bug investigation workflow — parse error, find symbols, trace data flow, assess impact`,argsSchema:{error:L.string().describe(`Error message, stack trace, or bug description`)}},async({error:e})=>({messages:[{role:`user`,content:{type:`text`,text:[`Investigate this error:`,"```",e,"```",``,`Follow the bug investigation workflow:`,"1. `parse_output({ text: <error> })` — extract structured data from the error","2. `symbol({ name: <relevant symbol> })` — find definition and references",'3. `trace({ symbol: <symbol>, direction: "backward" })` — trace data flow to find root cause',"4. `blast_radius({ changed_files: [<affected files>] })` — assess fix impact"].join(`
|
|
7
|
-
`)}}]})),!t)return;let{curated:r,store:i,graphStore:a}=t;e.registerPrompt(`read_knowledge`,{title:`Read Knowledge`,description:`Read a curated knowledge entry by path — with autocomplete`,argsSchema:{path:On(L.string().describe(`Path of the curated entry (e.g. conventions/naming.md)`),async e=>
|
|
7
|
+
`)}}]})),!t)return;let{curated:r,store:i,graphStore:a}=t;e.registerPrompt(`read_knowledge`,{title:`Read Knowledge`,description:`Read a curated knowledge entry by path — with autocomplete`,argsSchema:{path:On(L.string().describe(`Path of the curated entry (e.g. conventions/naming.md)`),async e=>wr(r,e))}},async({path:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Read the curated knowledge entry: \`knowledge({ action: "read", path: "${e}" })\``}}]})),e.registerPrompt(`update_knowledge`,{title:`Update Knowledge`,description:`Update an existing curated knowledge entry — with autocomplete`,argsSchema:{path:On(L.string().describe(`Path of the curated entry to update`),async e=>wr(r,e)),content:L.string().describe(`New content for the entry`)}},async({path:e,content:t})=>({messages:[{role:`user`,content:{type:`text`,text:`Update the curated entry at "${e}":\n\n\`knowledge({ action: "update", path: "${e}", content: "${t.replace(/"/g,`\\"`).slice(0,200)}..." })\``}}]})),e.registerPrompt(`forget_knowledge`,{title:`Forget Knowledge`,description:`Delete a curated knowledge entry — with autocomplete`,argsSchema:{path:On(L.string().describe(`Path of the curated entry to delete`),async e=>wr(r,e))}},async({path:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Delete the curated entry: \`knowledge({ action: "forget", path: "${e}" })\``}}]})),e.registerPrompt(`lookup_file`,{title:`Lookup File`,description:`Look up an indexed file — with autocomplete`,argsSchema:{path:On(L.string().describe(`Source file path`),async e=>Tr(i,e))}},async({path:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Look up the indexed file: \`file_summary({ path: "${e}" })\``}}]})),e.registerPrompt(`find_symbol`,{title:`Find Symbol`,description:`Find a symbol definition and references — with autocomplete`,argsSchema:{name:On(L.string().describe(`Symbol name`),async e=>Er(a,e))}},async({name:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Find symbol: \`symbol({ name: "${e}" })\``}}]})),e.registerPrompt(`get_stash`,{title:`Get Stash`,description:`Retrieve a stashed value by key — with autocomplete`,argsSchema:{key:On(L.string().describe(`Stash key`),e=>Dr(e,t?.stateStore))}},async({key:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Get stashed value: \`stash({ action: "get", key: "${e}" })\``}}]})),e.registerPrompt(`get_workset`,{title:`Get Workset`,description:`Load a saved workset by name — with autocomplete`,argsSchema:{name:On(L.string().describe(`Workset name`),e=>Or(e))}},async({name:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Load workset: \`workset({ action: "load", name: "${e}" })\``}}]})),e.registerPrompt(`load_checkpoint`,{title:`Load Checkpoint`,description:`Restore a saved checkpoint by name — with autocomplete`,argsSchema:{name:On(L.string().describe(`Checkpoint name`),e=>kr(e,t?.stateStore))}},async({name:e})=>({messages:[{role:`user`,content:{type:`text`,text:`Load checkpoint: \`checkpoint({ action: "load", name: "${e}" })\``}}]})),e.registerPrompt(`audit_workflow`,{title:`Audit Workflow`,description:`Run a full project quality audit: check → test_run → audit → produce recommendations`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## Audit Workflow`,``,`Execute the following tools in sequence:`,``,"1. `check({})` — Run typecheck + lint","2. `test_run({})` — Run all tests","3. `audit({})` — Full project audit","4. Review findings and `remember` important patterns",``,`Report: pass/fail status, error counts, audit recommendations, and suggested next steps.`].join(`
|
|
8
8
|
`)}}]})),e.registerPrompt(`refactor_workflow`,{title:`Refactor Workflow`,description:`Safe refactoring workflow: analyze → blast_radius → implement → verify`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## Refactor Workflow`,``,`For the target files/symbols:`,``,'1. `analyze({ aspect: "structure", path })` — Understand current structure','2. `analyze({ aspect: "dependencies", path })` — Map dependency graph',"3. `blast_radius({ changed_files })` — Assess impact scope",`4. Implement changes carefully`,"5. `check({})` + `test_run({})` — Verify nothing broke",n===`smart`?`6. Smart indexing is active — changes will be indexed automatically`:"6. `reindex({})` — Update AI Kit with changes",``,`What would you like to refactor?`].join(`
|
|
9
9
|
`)}}]})),e.registerPrompt(`forge_workflow`,{title:`FORGE Workflow`,description:`Full FORGE protocol: classify → ground → implement with quality gates`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## FORGE Quality Gate Workflow`,``,"1. `forge_classify({ task })` — Determine complexity tier (floor/standard/critical)","2. `forge_ground({ task, files, root_path })` — Full grounding analysis",`3. Review typed unknowns and constraints`,`4. Implement with evidence tracking`,'5. `evidence_map({ action: "validate" })` — Verify all claims',"6. `check({})` + `test_run({})` — Final verification",``,`Describe the task to classify:`].join(`
|
|
10
10
|
`)}}]})),e.registerPrompt(`investigate_workflow`,{title:`Investigate Issue`,description:`Bug investigation workflow: trace → analyze → find root cause → fix`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## Bug Investigation Workflow`,``,"1. `parse_output({ output })` — Parse error messages if available","2. `symbol({ name })` — Find the failing symbol",'3. `trace({ symbol, direction: "backward" })` — Trace data flow to root cause',"4. `blast_radius({ changed_files })` — Assess impact of fix",`5. Implement fix`,"6. `check({})` + `test_run({})` — Verify fix works",``,`Describe the issue:`].join(`
|
|
11
11
|
`)}}]})),e.registerPrompt(`context_workflow`,{title:`Build Context`,description:`Progressive context building: file_summary → compact → digest for deep understanding`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## Context Building Workflow`,``,`Build understanding progressively:`,``,"1. `file_summary({ path })` — Structure overview (~50 tokens)","2. `compact({ path, query })` — Extract relevant sections (5-20x reduction)","3. `digest({ sources })` — Multi-file compressed summary","4. `stratum_card({ files })` — Reusable reference card",``,`For project-wide context:`,"- `scope_map({ task })` — Reading plan for a specific task",'- `workset({ action: "save" })` — Save working set for later',``,`What do you need to understand?`].join(`
|
|
12
12
|
`)}}]})),e.registerPrompt(`migrate_workflow`,{title:`Migration Workflow`,description:`Code migration workflow: analyze → plan → migrate → verify → document`},async()=>({messages:[{role:`user`,content:{type:`text`,text:[`## Migration Workflow`,``,'1. `analyze({ aspect: "structure", path })` — Current codebase state','2. `analyze({ aspect: "patterns", path })` — Identify patterns to migrate',"3. `dead_symbols({ path })` — Find unused code to remove",'4. `scope_map({ task: "migration" })` — Plan migration scope',"5. Use `codemod` for bulk transformations","6. `check({})` + `test_run({})` — Verify after each step","7. `changelog({ from })` — Document changes",``,`What are you migrating from/to?`].join(`
|
|
13
|
-
`)}}]}))}const
|
|
14
|
-
`)}function R(e){return C(`sha256`).update(e).digest(`hex`).slice(0,16)}function
|
|
13
|
+
`)}}]}))}const jr={enabled:!0,batchSize:10,debounceMs:5e3,maxFactsPerSession:50,minQuality:.3};function Mr(e){return(e.content??[]).filter(e=>e.type===`text`&&typeof e.text==`string`).map(e=>e.text??``).join(`
|
|
14
|
+
`)}function R(e){return C(`sha256`).update(e).digest(`hex`).slice(0,16)}function Nr(e){let t=0;return e.length>=50&&(t+=.2),e.length>=150&&(t+=.1),/[a-zA-Z]\w+\.\w+/.test(e)&&(t+=.15),/[:=]|^[-*]|\n[-*]|```/.test(e)&&(t+=.15),/\b(use|should|must|always|never|prefer|avoid|requires?|detected|confirmed|verified)\b/i.test(e)&&(t+=.2),/^(Error|TypeError|ReferenceError):/m.test(e)&&e.length<100&&(t-=.2),Math.max(0,Math.min(1,t))}const Pr={name:`build-commands`,tools:[`check`,`test_run`],extract(e){if(e.isError)return[];let t=Mr(e.result);if(!t)return[];let n=[];if(e.toolName===`check`){let r=[];if(/typecheck.*(?:pass|success|0 error)/i.test(t)&&r.push(`typecheck`),/lint.*(?:pass|success|no (?:warning|error))/i.test(t)&&r.push(`lint`),/biome.*(?:checked|no fixes)/i.test(t)&&r.push(`biome`),r.length>0){let t=[...r].sort();n.push({title:`Verified checks: ${t.join(`, `)}`,content:`The following checks passed successfully: ${t.join(`, `)}.\nRun with the \`check\` tool to verify code quality.`,category:`conventions`,tags:[`build`,`verified`,...t],hash:R(`build-checks-${t.join(`,`)}`),quality:.8,source:e.toolName})}}if(e.toolName===`test_run`){let r=t.match(/(\d+)\s*(?:tests?\s+)?pass/i),i=t.match(/(\d+)\s*(?:total|tests)/i),a=t.match(/(\d+)\s*(?:test\s+)?files?/i);if(r){let t=r[1],o=i?.[1]??t,s=a?.[1]??`unknown`;n.push({title:`Test suite summary`,content:`Test results: ${t}/${o} tests passed across ${s} test files.\nUse \`test_run\` tool to execute the test suite.`,category:`context`,tags:[`testing`,`verified`,`test-summary`],hash:R(`test-summary-${t}-${o}`),quality:.7,source:e.toolName,ttlMs:72e5})}let o=t.match(/(?:running|command|exec):\s*(.+?)$/im);if(o?.[1]){let t=o[1].trim();n.push({title:`Test command: ${t.slice(0,60)}`,content:`Verified test command: \`${t}\`\nThis command successfully ran the project's test suite.`,category:`conventions`,tags:[`testing`,`build-command`,`verified`],hash:R(`test-cmd-${t}`),quality:.9,source:e.toolName})}}return n}},Fr={name:`codebase-insights`,tools:[`analyze`,`scope_map`,`blast_radius`,`onboard`],extract(e){let t=Mr(e.result);if(!t||t.length<50||e.isError)return[];let n=[];if(e.toolName===`analyze`&&e.args.aspect===`structure`){let r=typeof e.args.path==`string`?e.args.path:`.`,i=t.slice(0,600);n.push({title:`Structure: ${r}`,content:`Project structure analysis for ${r}:\n${i}`,category:`context`,tags:[`architecture`,`structure`,`analysis`],hash:R(`structure-${r}`),quality:Math.min(.9,Nr(i)+.2),source:e.toolName})}if(e.toolName===`analyze`&&e.args.aspect===`dependencies`){let r=typeof e.args.path==`string`?e.args.path:`.`,i=t.split(/\r?\n/).filter(e=>/(?:depends on|imports?|requires?|from)\s/i.test(e)).slice(0,10);if(i.length>0){let t=`Dependency analysis for ${r}:\n${i.join(`
|
|
15
15
|
`)}`;n.push({title:`Dependencies: ${r}`,content:t,category:`context`,tags:[`architecture`,`dependencies`,`analysis`],hash:R(`deps-${r}`),quality:.7,source:e.toolName})}}if(e.toolName===`blast_radius`){let r=e.args.changed_files,i=Array.isArray(r)?r.map(String).join(`, `):String(r??``);if(i&&t.length>50){let r=t.slice(0,400);n.push({title:`Blast radius: ${i.slice(0,60)}`,content:`Impact analysis for changes to ${i}:\n${r}`,category:`context`,tags:[`architecture`,`blast-radius`,`impact`],hash:R(`blast-${i}`),quality:.6,source:e.toolName,ttlMs:36e5})}}if(e.toolName===`analyze`&&e.args.aspect===`entry_points`){let r=t.split(/\r?\n/).filter(e=>/(?:entry|export|main|bin)\b/i.test(e)).slice(0,10);r.length>0&&n.push({title:`Project entry points`,content:`Detected entry points:\n${r.join(`
|
|
16
|
-
`)}`,category:`context`,tags:[`architecture`,`entry-points`],hash:R(`entry-points`),quality:.7,source:e.toolName})}if(e.toolName===`scope_map`){let r=typeof e.args.task==`string`?e.args.task:``;r&&t.length>100&&n.push({title:`Scope map: ${r.slice(0,60)}`,content:`Scope analysis for "${r}":\n${t.slice(0,500)}`,category:`context`,tags:[`planning`,`scope-map`],hash:R(`scope-${r}`),quality:.6,source:e.toolName,ttlMs:72e5})}return e.toolName===`onboard`&&t.length>200&&n.push({title:`Onboard analysis summary`,content:`Codebase onboarding analysis:\n${t.slice(0,800)}`,category:`context`,tags:[`onboarding`,`analysis`,`structure`],hash:R(`onboard-summary`),quality:.9,source:e.toolName}),n}};function Fr(e,t){let n=[],r=e.toLowerCase();r.includes(`biome`)?n.push({title:`Linter: Biome`,content:`This project uses Biome for linting and formatting.`,category:`conventions`,tags:[`tooling`,`linter`,`biome`],hash:R(`convention-linter-biome`),quality:.8,source:t}):r.includes(`eslint`)&&n.push({title:`Linter: ESLint`,content:`This project uses ESLint for linting.`,category:`conventions`,tags:[`tooling`,`linter`,`eslint`],hash:R(`convention-linter-eslint`),quality:.8,source:t}),r.includes(`prettier`)&&n.push({title:`Formatter: Prettier`,content:`This project uses Prettier for code formatting.`,category:`conventions`,tags:[`tooling`,`formatter`,`prettier`],hash:R(`convention-formatter-prettier`),quality:.8,source:t}),(/strict\s*(?:mode)?.*(?:enabled|true)/i.test(e)||/"strict"\s*:\s*true/.test(e))&&n.push({title:`TypeScript strict mode enabled`,content:`This project has TypeScript strict mode enabled. Ensure all types are explicit.`,category:`conventions`,tags:[`typescript`,`strict`,`config`],hash:R(`convention-ts-strict`),quality:.8,source:t});for(let e of[`pnpm`,`yarn`,`npm`,`bun`])if(r.includes(e)&&(r.includes(`lockfile`)||r.includes(`workspace`)||r.includes(`${e} run`))){n.push({title:`Package manager: ${e}`,content:`This project uses ${e} as its package manager.`,category:`conventions`,tags:[`tooling`,`package-manager`,e],hash:R(`convention-pm-${e}`),quality:.7,source:t});break}return(r.includes(`monorepo`)||r.includes(`workspaces`)||/packages\/\w+/.test(e))&&n.push({title:`Monorepo structure detected`,content:`This project uses a monorepo structure with multiple packages.`,category:`conventions`,tags:[`architecture`,`monorepo`],hash:R(`convention-monorepo`),quality:.7,source:t}),n}function Ir(e,t){let n=[],r=e.matchAll(/(?:pattern|convention):\s*(.+?)(?:\n|$)/gi);for(let e of r){let r=e[1]?.trim();r&&r.length>20&&r.length<200&&n.push({title:`Pattern: ${r.slice(0,80)}`,content:r,category:`patterns`,tags:[`detected-pattern`],hash:R(`pattern-${r}`),quality:.6,source:t})}return n}const Lr={name:`convention-detection`,tools:[`check`,`analyze`,`onboard`],extract(e){let t=jr(e.result);if(!t||e.isError)return[];let n=[];return n.push(...Fr(t,e.toolName)),e.toolName===`analyze`&&e.args.aspect===`patterns`&&n.push(...Ir(t,e.toolName)),n}};function Rr(e,t){return e.match(t)?.[1]?.trim()||null}function zr(e,t,n,r,i,a){return{title:e,content:t,category:`context`,tags:n,hash:R(r),quality:i,source:a}}const Br={name:`environment-facts`,tools:[`env`,`config`,`status`],extract(e){let t=jr(e.result);if(!t)return[];let n=[],r=Rr(t,/node(?:\.js)?\s*[:=]\s*([^\r\n]+)/i);r&&n.push(zr(`Node.js version`,`Detected Node.js version: ${r}`,[`environment`,`node`],`node-version-${r}`,.4,e.toolName));let i=Rr(t,/(?:^|\n)os\s*[:=]\s*([^\r\n]+)/i);i&&n.push(zr(`Operating system`,`Detected OS: ${i}`,[`environment`,`os`],`os-${i}`,.4,e.toolName));let a=Rr(t,/workspace(?: path)?\s*[:=]\s*([^\r\n]+)/i);a&&n.push(zr(`Workspace path`,`Primary workspace path: ${a}`,[`environment`,`workspace`],`workspace-${a}`,.4,e.toolName));let o=Rr(t,/store(?: backend)?\s*[:=]\s*([^\r\n]+)/i);o&&n.push(zr(`Store backend`,`Configured store backend: ${o}`,[`environment`,`storage`],`store-${o}`,.6,e.toolName));let s=Rr(t,/embedding(?: model)?\s*[:=]\s*([^\r\n]+)/i);return s&&n.push(zr(`Embedding model`,`Configured embedding model: ${s}`,[`environment`,`embedding`],`embedding-${s}`,.6,e.toolName)),n}},z={"search-result":800,"file-card":2e3,analysis:1500,"step-summary":3e3},Vr=[`search`,`file_summary`,`stratum_card`,`compact`,`blast_radius`,`scope_map`],Hr={search:`search-result`,file_summary:`file-card`,stratum_card:`file-card`,compact:`analysis`,blast_radius:`analysis`,scope_map:`step-summary`},Ur={"search-result":72e5,"file-card":144e5,analysis:144e5,"step-summary":288e5};function Wr(e){return e.replace(/\s+/g,` `).trim()}function Gr(e){return Math.max(.6,Math.min(.8,Mr(e)))}function B(e,t=500){let n=Wr(e);return n.length<=t?n:`${n.slice(0,Math.max(0,t-3)).trimEnd()}...`}function Kr(e){return typeof e==`object`&&!!e}function qr(e){try{return JSON.parse(e)}catch{return null}}function V(e){return typeof e==`string`?Wr(e):typeof e==`number`||typeof e==`boolean`?String(e):``}function Jr(e,t=5){if(!Array.isArray(e))return[];let n=[];for(let r of e){if(n.length>=t)break;if(typeof r==`string`){let e=Wr(r);e&&n.push(e);continue}if(Kr(r)){let e=V(r.path)||V(r.sourcePath)||V(r.title)||V(r.name)||V(r.label);e&&n.push(e)}}return n}function H(e,...t){for(let n of t){let t=V(e[n]);if(t)return t}return``}function Yr(e){let t=[e.file,e.path,e.files,e.changed_files,e.changedFiles].flatMap(e=>typeof e==`string`?[Wr(e)]:Jr(e,6));return[...new Set(t.filter(Boolean))].slice(0,6)}function Xr(e,t=6){let n=e.match(/(?:[A-Za-z]:[\\/]|\.\/?|\.\.[\\/]|[A-Za-z0-9_.-]+\/)[^\s,:;]+\.[A-Za-z0-9]+/g)??[];return[...new Set(n.map(e=>Wr(e)))].slice(0,t)}function Zr(e,t){return e.length===0?``:`${t}: ${e.join(`, `)}`}function Qr(e,t=3){return e.split(/\r?\n/).map(e=>Wr(e)).filter(e=>e.length>=12).slice(0,t)}function $r(e){if(!Kr(e))return``;let t=V(e.title)||V(e.path)||V(e.sourcePath)||V(e.file),n=V(e.snippet)||V(e.preview)||V(e.content)||V(e.summary);return Wr([t,n&&`- ${n}`].filter(Boolean).join(` `))}function ei(e,t){let n=H(e,`query`),r=qr(t);if(Kr(r)&&Array.isArray(r.results)){let e=r.results.map(e=>$r(e)).filter(Boolean).slice(0,3);if(e.length>0)return B(`Query: ${n||`unknown`}. Top hits: ${e.join(` | `)}`,z[`search-result`])}let i=Qr(t,3);return B(`Query: ${n||`unknown`}. Top hits: ${i.join(` | `)}`,z[`search-result`])}function ti(e,t){let n=H(e,`path`,`file`),r=qr(t);if(Kr(r)){let e=V(r.path)||n||`unknown file`,t=Jr(r.imports,4),i=Jr(r.exports,5),a=Jr(r.functions,4),o=[`File: ${e}`,Zr(i,`Exports`),Zr(t,`Imports`),Zr(a,`Functions`)].filter(Boolean);if(o.length>1)return B(o.join(`. `),z[`file-card`])}let i=Qr(t,4);return B(`File: ${n||`unknown file`}. Structure: ${i.join(` | `)}`,z[`file-card`])}function ni(e,t){let n=Yr(e),r=H(e,`tier`)||`T1`,i=qr(t);if(Kr(i)){let e=(Array.isArray(i.cards)?i.cards:[]).map(e=>$r(e)).filter(Boolean).slice(0,3);if(e.length>0)return B(`Tier: ${r}. Files: ${n.join(`, `)||`unknown`}. Cards: ${e.join(` | `)}`,z[`file-card`])}let a=Qr(t,3);return B(`Tier: ${r}. Files: ${n.join(`, `)||`unknown`}. Highlights: ${a.join(` | `)}`,z[`file-card`])}function ri(e,t){let n=H(e,`path`,`file`),r=H(e,`query`);return B(`Path: ${n||`unknown`}. Focus: ${r||`general`}. Summary: ${t}`,z.analysis)}function ii(e,t){let n=Yr(e),r=qr(t),i=Kr(r)?[...Jr(r.affectedFiles,8),...Jr(r.tests,4),...Jr(r.importers,4)]:[],a=[...new Set([...i,...Xr(t,8)])].slice(0,8),o=[`Changed: ${n.join(`, `)||`unknown`}`,Zr(a,`Affected`)].filter(Boolean);return o.length>1?B(o.join(`. `),z.analysis):B(`Changed: ${n.join(`, `)||`unknown`}. Summary: ${t}`,z.analysis)}function ai(e,t){let n=H(e,`task`),r=qr(t);if(Kr(r)){let e=Jr(r.files,6),t=typeof r.totalFiles==`number`?r.totalFiles:e.length;if(e.length>0)return B(`Task: ${n||`unknown`}. Reading plan (${t} files): ${e.join(`, `)}`,z[`step-summary`])}let i=Xr(t,6);return B(`Task: ${n||`unknown`}. Reading plan: ${i.join(`, `)||Qr(t,3).join(` | `)}`,z[`step-summary`])}function oi(e,t){switch(e.toolName){case`search`:return ei(e.args,t);case`file_summary`:return ti(e.args,t);case`stratum_card`:return ni(e.args,t);case`compact`:return ri(e.args,t);case`blast_radius`:return ii(e.args,t);case`scope_map`:return ai(e.args,t);default:return``}}function si(e){switch(e.toolName){case`search`:return B(`Search: ${H(e.args,`query`)||`unknown query`}`,120);case`file_summary`:return B(`File summary: ${H(e.args,`path`,`file`)||`unknown file`}`,120);case`stratum_card`:return B(`Stratum card: ${Yr(e.args).join(`, `)||`unknown files`}${H(e.args,`tier`)?` (${H(e.args,`tier`)})`:``}`,120);case`compact`:return B(`Compact: ${H(e.args,`path`,`file`)||`unknown path`}${H(e.args,`query`)?` - ${H(e.args,`query`)}`:``}`,120);case`blast_radius`:return B(`Blast radius: ${Yr(e.args).join(`, `)||`unknown changes`}`,120);case`scope_map`:return B(`Scope map: ${H(e.args,`task`)||`unknown task`}`,120);default:return B(`Flow context: ${e.toolName}`,120)}}function ci(e){return{name:`flow-context`,tools:[...Vr],extract(t){if(t.isError)return[];let n=e();if(!n?.active||!n.slug||!(t.toolName in Hr))return[];let r=jr(t.result).trim();if(r.length<50)return[];let i=Hr[t.toolName],a=oi(t,r);if(a.length<50)return[];let o=si(t);return[{title:o,content:a,category:`flow-context`,tags:[`flow-context`,`flow:${n.slug}`,i,`tool:${t.toolName}`],hash:R(`${n.slug}|${t.toolName}|${o}|${a}`),quality:Gr(a),ttlMs:Ur[i],source:t.toolName}]}}}const li={name:`research-results`,tools:[`web_search`,`web_fetch`,`search`],extract(e){let t=jr(e.result);if(!t||t.length<100||e.isError)return[];let n=[];if(e.toolName===`web_search`){let r=typeof e.args.query==`string`?e.args.query:``;if(r&&t.length>200){let i=t.slice(0,800);n.push({title:`Web research: ${r.slice(0,80)}`,content:`Research query: "${r}"\n\nKey findings:\n${i}`,category:`context`,tags:[`research`,`web-search`],hash:R(`web-search-${r}`),quality:Math.min(.8,Mr(i)+.2),source:e.toolName,ttlMs:864e5})}}if(e.toolName===`web_fetch`){let r=e.args.urls,i=Array.isArray(r)?String(r[0]??``):typeof e.args.url==`string`?e.args.url:``;if(i&&t.length>200){let r=t.split(/\r?\n/).find(e=>e.trim().length>10)?.trim()??i,a=t.slice(0,600);n.push({title:`Fetched: ${r.slice(0,80)}`,content:`Source: ${i}\n\n${a}`,category:`context`,tags:[`research`,`web-fetch`],hash:R(`web-fetch-${i}`),quality:Mr(a),source:e.toolName,ttlMs:864e5})}}if(e.toolName===`search`){let r=typeof e.args.query==`string`?e.args.query:``;(typeof e.args.origin==`string`?e.args.origin:``)===`curated`&&r&&t.length>100&&n.push({title:`Curated search: ${r.slice(0,80)}`,content:`Searched curated knowledge for: "${r}"\n\nResults:\n${t.slice(0,500)}`,category:`context`,tags:[`research`,`curated-search`],hash:R(`curated-search-${r}`),quality:.5,source:e.toolName,ttlMs:36e5})}return n}};function ui(e){let t=e.toLowerCase();return t.includes(`vitest`)?`vitest`:t.includes(`jest`)?`jest`:t.includes(`mocha`)?`mocha`:t.includes(`playwright`)?`playwright`:t.includes(`cypress`)?`cypress`:null}function di(e){let t=[/(\S+\.test\.\w+)/,/(\S+\.spec\.\w+)/,/(\S+_test\.\w+)/,/__tests__\/\S+/],n=new Set;for(let r of t){let t=e.matchAll(new RegExp(r.source,`g`));for(let e of t){let t=e[0].match(/\.(test|spec)\.\w+$/);t&&n.add(t[0])}}return n.size>0?[...n].join(`, `):null}const fi={name:`test-results`,tools:[`check`,`test_run`],extract(e){let t=jr(e.result);if(!t)return[];let n=[],r=ui(t);r&&n.push({title:`Test framework: ${r}`,content:`This project uses ${r} for testing. Detected from ${e.toolName} output.`,category:`context`,tags:[`testing`,`environment`,r],hash:R(`test-framework-${r}`),quality:.7,source:e.toolName});let i=di(t);return i&&n.push({title:`Test file pattern: ${i}`,content:`Test files use the naming pattern: ${i}. Follow this convention when creating new tests.`,category:`conventions`,tags:[`testing`,`naming-convention`],hash:R(`test-pattern-${i}`),quality:.7,source:e.toolName}),n}};function pi(e){let t=e.toLowerCase();return/enoent|no such file|not found/i.test(e)?{type:`missing-file`,actionable:!1}:/econnreset|econnrefused|etimedout|fetch failed/i.test(e)?{type:`network`,actionable:!1}:/permission denied|eacces/i.test(e)?{type:`permission`,actionable:!0}:/type\s*error|cannot.*property|is not a function/i.test(e)?{type:`type-error`,actionable:!0}:/syntax\s*error|unexpected token|parsing error/i.test(e)?{type:`syntax`,actionable:!0}:/out of memory|heap|allocation/i.test(e)?{type:`memory`,actionable:!0}:/timeout|timed out/i.test(e)?{type:`timeout`,actionable:t.includes(`increase`)||t.includes(`config`)}:/import|require|module not found|cannot find module/i.test(e)?{type:`module-resolution`,actionable:!0}:{type:`unknown`,actionable:e.length>100}}const mi={name:`tool-failure-patterns`,tools:[],extract(e){if(!e.isError)return[];let t=jr(e.result);if(!t||t.length<30)return[];let{type:n,actionable:r}=pi(t);if(!r)return[];let i=t.slice(0,500),a=Mr(i);return a<.2?[]:[{title:`${n} error in ${e.toolName}`,content:`Tool \`${e.toolName}\` failed with a ${n} error.\n\nArgs: ${JSON.stringify(e.args,null,2).slice(0,200)}\n\nError:\n${i}`,category:`context`,tags:[`errors`,n,e.toolName],hash:R(`smart-error-${n}-${e.toolName}-${t.slice(0,80)}`),quality:Math.min(.7,a+.1),source:e.toolName,ttlMs:72e5}]}};var hi=class{extractors=[];register(e){this.extractors.push(e)}getExtractors(e){return this.extractors.filter(t=>t.tools.length===0||t.tools.includes(e))}extractAll(e){return this.getExtractors(e.toolName).flatMap(t=>t.extract(e))}};function gi(e){return{content:[{type:`text`,text:(e instanceof Error,String(e))}],isError:!0}}function _i(e,t){try{e.push(t)}catch{}}function vi(e){return async(t,n)=>{let r=Date.now();try{let i=await n();return _i(e,{toolName:t.toolName,args:t.args,result:i,durationMs:Date.now()-r,isError:i.isError===!0,timestamp:new Date().toISOString()}),i}catch(n){throw _i(e,{toolName:t.toolName,args:t.args,result:gi(n),durationMs:Date.now()-r,isError:!0,timestamp:new Date().toISOString()}),n}}}const yi=F(`auto-knowledge`);var bi=class{registry;curated;flowContextAdapter;queue=[];timer=null;seenHashes=new Map;storedCount=0;droppedCount=0;dedupedCount=0;config;existingTitles=null;constructor(e,t,n={},r){this.registry=e,this.curated=t,this.flowContextAdapter=r,this.config={...Ar,...n}}push(e){if(!(!this.config.enabled||!this.curated&&!this.flowContextAdapter)&&!(this.storedCount>=this.config.maxFactsPerSession)){if(this.queue.push(e),this.queue.length>=this.config.batchSize){this.flush().catch(e=>{yi.warn(`Auto-knowledge flush error`,{error:String(e)})});return}this.scheduleBatch()}}async flush(){this.timer&&=(clearTimeout(this.timer),null);let e=this.queue.splice(0);if(e.length===0||!this.curated&&!this.flowContextAdapter)return;this.existingTitles===null&&(this.existingTitles=await this.loadExistingTitles());let t=new Map;for(let n of e)for(let e of this.registry.extractAll(n)){if(e.quality<this.config.minQuality){this.droppedCount++;continue}if(this.isSeenRecently(e)){this.dedupedCount++;continue}if(t.has(e.hash)){this.dedupedCount++;continue}if(this.existingTitles.has(this.normalizeTitle(e.title))){this.dedupedCount++;continue}t.set(e.hash,e)}for(let e of t.values()){if(this.storedCount>=this.config.maxFactsPerSession)break;try{if(e.tags.includes(`flow-context`)&&this.flowContextAdapter){let t=`${e.tags.find(e=>!e.startsWith(`flow:`)&&!e.startsWith(`tool:`)&&e!==`flow-context`)||`analysis`}/${e.title.toLowerCase().replace(/[^a-z0-9]+/g,`-`).slice(0,60)}.md`;await this.flowContextAdapter.write(t,`# ${e.title}\n\n${e.content}`)}else if(this.curated)await this.curated.remember(e.title,e.content,e.category,e.tags);else continue;this.seenHashes.set(e.hash,Date.now()),this.existingTitles.add(this.normalizeTitle(e.title)),this.storedCount++,yi.info(`Auto-knowledge stored`,{title:e.title,category:e.category,quality:e.quality,source:e.source})}catch(t){yi.warn(`Auto-knowledge store failed`,{title:e.title,error:String(t)})}}}reset(){this.queue=[],this.seenHashes.clear(),this.storedCount=0,this.droppedCount=0,this.dedupedCount=0,this.existingTitles=null,this.timer&&=(clearTimeout(this.timer),null)}getStats(){return{queued:this.queue.length,stored:this.storedCount,seen:this.seenHashes.size,dropped:this.droppedCount,deduped:this.dedupedCount}}isSeenRecently(e){let t=this.seenHashes.get(e.hash);return t==null?!1:e.ttlMs==null?!0:Date.now()-t<e.ttlMs}normalizeTitle(e){return e.toLowerCase().trim()}async loadExistingTitles(){let e=new Set,t=this.curated;if(!t)return e;try{let n=await t.list();for(let t of n)e.add(this.normalizeTitle(t.title))}catch{yi.warn(`Failed to load existing curated titles for dedup`,{})}return e}scheduleBatch(){this.timer||=setTimeout(()=>{this.timer=null,this.flush().catch(e=>{yi.warn(`Auto-knowledge flush error`,{error:String(e)})})},this.config.debounceMs)}};const xi=new Set([`compact`,`digest`,`file_summary`,`stratum_card`,`present`,`web_fetch`,`web_search`,`check`,`audit`]);function Si(e){switch(e){case`efficient`:return{threshold:2e3,tokenBudget:1e3};case`full`:return{threshold:1/0};default:return{threshold:4e3,tokenBudget:2e3}}}function Ci(e){let t=e?.threshold??4e3,n=e?.tokenBudget??2e3;return async(e,r)=>{if(xi.has(e.toolName))return r();let i=await r();if(!Array.isArray(i.content))return i;let a=0;for(let e of i.content)e.type===`text`&&typeof e.text==`string`&&(a+=e.text.length);if(a<t)return i;let o=i.content.map(r=>{if(r.type!==`text`||typeof r.text!=`string`||r.text.length<t)return r;let i=Ie({text:r.text,tool:e.toolName,tokenBudget:n});return{...r,text:i.text}});return{...i,content:o}}}var wi=class{baseDir;getActiveSlug;constructor(e,t){this.baseDir=e,this.getActiveSlug=t}async initialize(){await pn(this.baseDir,{recursive:!0})}async read(e){let t=this.resolveScopedPath(e);if(t==null)return null;try{return await mn(t,`utf-8`)}catch(e){if(this.isMissingError(e))return null;throw e}}async write(e,t,n){let r=this.resolveScopedPath(e);r!=null&&(await pn(M(r),{recursive:!0}),await yn(r,t,{encoding:`utf-8`,flag:n?.exclusive?`wx`:`w`}))}async delete(e){let t=this.resolveScopedPath(e);if(t==null)return!1;try{return await vn(t),!0}catch(e){if(this.isMissingError(e))return!1;throw e}}async list(e){let t=this.getActiveSlugDir();if(t==null)return[];let n=e?this.resolveScopedPath(e):t;return n==null?[]:this.collectFiles(n,e??``)}async exists(e){let t=this.resolveScopedPath(e);if(t==null)return!1;try{return await _n(t),!0}catch(e){if(this.isMissingError(e))return!1;throw e}}async listDirectories(){let e=this.getActiveSlugDir();if(e==null)return[];try{return(await hn(e,{withFileTypes:!0})).filter(e=>e.isDirectory()&&/^[a-z][a-z0-9-]*$/.test(e.name)).map(e=>e.name).sort()}catch(e){if(this.isMissingError(e))return[];throw e}}async flushAll(){let e=this.getActiveSlugDir();if(e==null)return 0;let t=await this.countFiles(e);return t===0?0:(await gn(e,{recursive:!0,force:!0}),t)}async close(){}getActiveSlugDir(){let e=this.getActiveSlug();return e?N(this.baseDir,e):null}resolveScopedPath(e){let t=this.getActiveSlugDir();if(t==null)return null;let n=P(t),r=P(n,e),i=ae(n,r);if(i===``||i===`..`||i.startsWith(`..${oe}`)||ie(i))throw Error(`Path escapes active flow context scope: ${e}`);return r}async collectFiles(e,t){let n;try{n=await hn(e,{withFileTypes:!0})}catch(e){if(this.isMissingError(e))return[];throw e}let r=[];for(let i of n){let n=t?`${t}/${i.name}`:i.name,a=N(e,i.name);if(i.isDirectory()){r.push(...await this.collectFiles(a,n));continue}if(!(!i.isFile()||!i.name.endsWith(`.md`)))try{let e=await _n(a);r.push({path:n,size:e.size})}catch(e){if(!this.isMissingError(e))throw e}}return r.sort((e,t)=>e.path.localeCompare(t.path))}async countFiles(e){let t;try{t=await hn(e,{withFileTypes:!0})}catch(e){if(this.isMissingError(e))return 0;throw e}let n=0;for(let r of t){let t=N(e,r.name);if(r.isDirectory()){n+=await this.countFiles(t);continue}r.isFile()&&(n+=1)}return n}isMissingError(e){return typeof e==`object`&&!!e&&`code`in e&&(e.code===`ENOENT`||e.code===`ENOTDIR`)}};const Ti=F(`observation-capture`),Ei=[`check`,`test_run`,`search`,`trace`],Di=[/\bAuthorization\s*:\s*Bearer\s+[A-Za-z0-9\-._~+/]+=*/gi,/\bBearer\s+[A-Za-z0-9\-._~+/]+=*/g,/\b(?:sk|ghp|gho|glpat|xoxb|xoxp)-[A-Za-z0-9\-._]{20,}\b/g,/\b(?:token|key|secret|password|auth(?:orization)?)\s*[=:]\s*['"]?[^\s'"&]{8,}/gi,/\b(?:token|key|secret|password|auth(?:orization)?)=[^\s&]+/gi,/\b[A-Z][A-Z0-9_]*(?:PASSWORD|SECRET|TOKEN|AUTH)[A-Z0-9_]*\b\s*[=:]\s*['"]?[^\s'"]+/g,/\b[A-Z][A-Z0-9_]*KEY[A-Z0-9_]*\b\s*[=:]\s*['"]?[^\s'"]{8,}/g,/-----BEGIN [\w\s]+-----[\s\S]*?-----END [\w\s]+-----/g],Oi=new Set([`env`,`auth`,`config`]),ki=2e3,Ai={enabled:!0,rateLimit:10,captureFrom:[...Ei],minContentLength:50};var ji=class{maxPerMinute;timestamps=[];constructor(e){this.maxPerMinute=e}canCapture(e=Date.now()){return this.prune(e),this.timestamps.length<this.maxPerMinute}record(e=Date.now()){this.prune(e),this.timestamps.push(e)}setLimit(e){this.maxPerMinute=e,this.prune(Date.now())}prune(e){let t=e-6e4;this.timestamps=this.timestamps.filter(e=>e>t)}};function Mi(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Ni(e){return typeof e==`string`?e:Mi(e)?[Array.isArray(e.content)?e.content.filter(e=>Mi(e)).map(e=>typeof e.text==`string`?e.text:``).filter(e=>e.length>0).join(`
|
|
16
|
+
`)}`,category:`context`,tags:[`architecture`,`entry-points`],hash:R(`entry-points`),quality:.7,source:e.toolName})}if(e.toolName===`scope_map`){let r=typeof e.args.task==`string`?e.args.task:``;r&&t.length>100&&n.push({title:`Scope map: ${r.slice(0,60)}`,content:`Scope analysis for "${r}":\n${t.slice(0,500)}`,category:`context`,tags:[`planning`,`scope-map`],hash:R(`scope-${r}`),quality:.6,source:e.toolName,ttlMs:72e5})}return e.toolName===`onboard`&&t.length>200&&n.push({title:`Onboard analysis summary`,content:`Codebase onboarding analysis:\n${t.slice(0,800)}`,category:`context`,tags:[`onboarding`,`analysis`,`structure`],hash:R(`onboard-summary`),quality:.9,source:e.toolName}),n}};function Ir(e,t){let n=[],r=e.toLowerCase();r.includes(`biome`)?n.push({title:`Linter: Biome`,content:`This project uses Biome for linting and formatting.`,category:`conventions`,tags:[`tooling`,`linter`,`biome`],hash:R(`convention-linter-biome`),quality:.8,source:t}):r.includes(`eslint`)&&n.push({title:`Linter: ESLint`,content:`This project uses ESLint for linting.`,category:`conventions`,tags:[`tooling`,`linter`,`eslint`],hash:R(`convention-linter-eslint`),quality:.8,source:t}),r.includes(`prettier`)&&n.push({title:`Formatter: Prettier`,content:`This project uses Prettier for code formatting.`,category:`conventions`,tags:[`tooling`,`formatter`,`prettier`],hash:R(`convention-formatter-prettier`),quality:.8,source:t}),(/strict\s*(?:mode)?.*(?:enabled|true)/i.test(e)||/"strict"\s*:\s*true/.test(e))&&n.push({title:`TypeScript strict mode enabled`,content:`This project has TypeScript strict mode enabled. Ensure all types are explicit.`,category:`conventions`,tags:[`typescript`,`strict`,`config`],hash:R(`convention-ts-strict`),quality:.8,source:t});for(let e of[`pnpm`,`yarn`,`npm`,`bun`])if(r.includes(e)&&(r.includes(`lockfile`)||r.includes(`workspace`)||r.includes(`${e} run`))){n.push({title:`Package manager: ${e}`,content:`This project uses ${e} as its package manager.`,category:`conventions`,tags:[`tooling`,`package-manager`,e],hash:R(`convention-pm-${e}`),quality:.7,source:t});break}return(r.includes(`monorepo`)||r.includes(`workspaces`)||/packages\/\w+/.test(e))&&n.push({title:`Monorepo structure detected`,content:`This project uses a monorepo structure with multiple packages.`,category:`conventions`,tags:[`architecture`,`monorepo`],hash:R(`convention-monorepo`),quality:.7,source:t}),n}function Lr(e,t){let n=[],r=e.matchAll(/(?:pattern|convention):\s*(.+?)(?:\n|$)/gi);for(let e of r){let r=e[1]?.trim();r&&r.length>20&&r.length<200&&n.push({title:`Pattern: ${r.slice(0,80)}`,content:r,category:`patterns`,tags:[`detected-pattern`],hash:R(`pattern-${r}`),quality:.6,source:t})}return n}const Rr={name:`convention-detection`,tools:[`check`,`analyze`,`onboard`],extract(e){let t=Mr(e.result);if(!t||e.isError)return[];let n=[];return n.push(...Ir(t,e.toolName)),e.toolName===`analyze`&&e.args.aspect===`patterns`&&n.push(...Lr(t,e.toolName)),n}};function zr(e,t){return e.match(t)?.[1]?.trim()||null}function Br(e,t,n,r,i,a){return{title:e,content:t,category:`context`,tags:n,hash:R(r),quality:i,source:a}}const Vr={name:`environment-facts`,tools:[`env`,`config`,`status`],extract(e){let t=Mr(e.result);if(!t)return[];let n=[],r=zr(t,/node(?:\.js)?\s*[:=]\s*([^\r\n]+)/i);r&&n.push(Br(`Node.js version`,`Detected Node.js version: ${r}`,[`environment`,`node`],`node-version-${r}`,.4,e.toolName));let i=zr(t,/(?:^|\n)os\s*[:=]\s*([^\r\n]+)/i);i&&n.push(Br(`Operating system`,`Detected OS: ${i}`,[`environment`,`os`],`os-${i}`,.4,e.toolName));let a=zr(t,/workspace(?: path)?\s*[:=]\s*([^\r\n]+)/i);a&&n.push(Br(`Workspace path`,`Primary workspace path: ${a}`,[`environment`,`workspace`],`workspace-${a}`,.4,e.toolName));let o=zr(t,/store(?: backend)?\s*[:=]\s*([^\r\n]+)/i);o&&n.push(Br(`Store backend`,`Configured store backend: ${o}`,[`environment`,`storage`],`store-${o}`,.6,e.toolName));let s=zr(t,/embedding(?: model)?\s*[:=]\s*([^\r\n]+)/i);return s&&n.push(Br(`Embedding model`,`Configured embedding model: ${s}`,[`environment`,`embedding`],`embedding-${s}`,.6,e.toolName)),n}},z={"search-result":800,"file-card":2e3,analysis:1500,"step-summary":3e3},Hr=[`search`,`file_summary`,`stratum_card`,`compact`,`blast_radius`,`scope_map`],Ur={search:`search-result`,file_summary:`file-card`,stratum_card:`file-card`,compact:`analysis`,blast_radius:`analysis`,scope_map:`step-summary`},Wr={"search-result":72e5,"file-card":144e5,analysis:144e5,"step-summary":288e5};function Gr(e){return e.replace(/\s+/g,` `).trim()}function Kr(e){return Math.max(.6,Math.min(.8,Nr(e)))}function B(e,t=500){let n=Gr(e);return n.length<=t?n:`${n.slice(0,Math.max(0,t-3)).trimEnd()}...`}function qr(e){return typeof e==`object`&&!!e}function Jr(e){try{return JSON.parse(e)}catch{return null}}function V(e){return typeof e==`string`?Gr(e):typeof e==`number`||typeof e==`boolean`?String(e):``}function Yr(e,t=5){if(!Array.isArray(e))return[];let n=[];for(let r of e){if(n.length>=t)break;if(typeof r==`string`){let e=Gr(r);e&&n.push(e);continue}if(qr(r)){let e=V(r.path)||V(r.sourcePath)||V(r.title)||V(r.name)||V(r.label);e&&n.push(e)}}return n}function H(e,...t){for(let n of t){let t=V(e[n]);if(t)return t}return``}function Xr(e){let t=[e.file,e.path,e.files,e.changed_files,e.changedFiles].flatMap(e=>typeof e==`string`?[Gr(e)]:Yr(e,6));return[...new Set(t.filter(Boolean))].slice(0,6)}function Zr(e,t=6){let n=e.match(/(?:[A-Za-z]:[\\/]|\.\/?|\.\.[\\/]|[A-Za-z0-9_.-]+\/)[^\s,:;]+\.[A-Za-z0-9]+/g)??[];return[...new Set(n.map(e=>Gr(e)))].slice(0,t)}function Qr(e,t){return e.length===0?``:`${t}: ${e.join(`, `)}`}function $r(e,t=3){return e.split(/\r?\n/).map(e=>Gr(e)).filter(e=>e.length>=12).slice(0,t)}function ei(e){if(!qr(e))return``;let t=V(e.title)||V(e.path)||V(e.sourcePath)||V(e.file),n=V(e.snippet)||V(e.preview)||V(e.content)||V(e.summary);return Gr([t,n&&`- ${n}`].filter(Boolean).join(` `))}function ti(e,t){let n=H(e,`query`),r=Jr(t);if(qr(r)&&Array.isArray(r.results)){let e=r.results.map(e=>ei(e)).filter(Boolean).slice(0,3);if(e.length>0)return B(`Query: ${n||`unknown`}. Top hits: ${e.join(` | `)}`,z[`search-result`])}let i=$r(t,3);return B(`Query: ${n||`unknown`}. Top hits: ${i.join(` | `)}`,z[`search-result`])}function ni(e,t){let n=H(e,`path`,`file`),r=Jr(t);if(qr(r)){let e=V(r.path)||n||`unknown file`,t=Yr(r.imports,4),i=Yr(r.exports,5),a=Yr(r.functions,4),o=[`File: ${e}`,Qr(i,`Exports`),Qr(t,`Imports`),Qr(a,`Functions`)].filter(Boolean);if(o.length>1)return B(o.join(`. `),z[`file-card`])}let i=$r(t,4);return B(`File: ${n||`unknown file`}. Structure: ${i.join(` | `)}`,z[`file-card`])}function ri(e,t){let n=Xr(e),r=H(e,`tier`)||`T1`,i=Jr(t);if(qr(i)){let e=(Array.isArray(i.cards)?i.cards:[]).map(e=>ei(e)).filter(Boolean).slice(0,3);if(e.length>0)return B(`Tier: ${r}. Files: ${n.join(`, `)||`unknown`}. Cards: ${e.join(` | `)}`,z[`file-card`])}let a=$r(t,3);return B(`Tier: ${r}. Files: ${n.join(`, `)||`unknown`}. Highlights: ${a.join(` | `)}`,z[`file-card`])}function ii(e,t){let n=H(e,`path`,`file`),r=H(e,`query`);return B(`Path: ${n||`unknown`}. Focus: ${r||`general`}. Summary: ${t}`,z.analysis)}function ai(e,t){let n=Xr(e),r=Jr(t),i=qr(r)?[...Yr(r.affectedFiles,8),...Yr(r.tests,4),...Yr(r.importers,4)]:[],a=[...new Set([...i,...Zr(t,8)])].slice(0,8),o=[`Changed: ${n.join(`, `)||`unknown`}`,Qr(a,`Affected`)].filter(Boolean);return o.length>1?B(o.join(`. `),z.analysis):B(`Changed: ${n.join(`, `)||`unknown`}. Summary: ${t}`,z.analysis)}function oi(e,t){let n=H(e,`task`),r=Jr(t);if(qr(r)){let e=Yr(r.files,6),t=typeof r.totalFiles==`number`?r.totalFiles:e.length;if(e.length>0)return B(`Task: ${n||`unknown`}. Reading plan (${t} files): ${e.join(`, `)}`,z[`step-summary`])}let i=Zr(t,6);return B(`Task: ${n||`unknown`}. Reading plan: ${i.join(`, `)||$r(t,3).join(` | `)}`,z[`step-summary`])}function si(e,t){switch(e.toolName){case`search`:return ti(e.args,t);case`file_summary`:return ni(e.args,t);case`stratum_card`:return ri(e.args,t);case`compact`:return ii(e.args,t);case`blast_radius`:return ai(e.args,t);case`scope_map`:return oi(e.args,t);default:return``}}function ci(e){switch(e.toolName){case`search`:return B(`Search: ${H(e.args,`query`)||`unknown query`}`,120);case`file_summary`:return B(`File summary: ${H(e.args,`path`,`file`)||`unknown file`}`,120);case`stratum_card`:return B(`Stratum card: ${Xr(e.args).join(`, `)||`unknown files`}${H(e.args,`tier`)?` (${H(e.args,`tier`)})`:``}`,120);case`compact`:return B(`Compact: ${H(e.args,`path`,`file`)||`unknown path`}${H(e.args,`query`)?` - ${H(e.args,`query`)}`:``}`,120);case`blast_radius`:return B(`Blast radius: ${Xr(e.args).join(`, `)||`unknown changes`}`,120);case`scope_map`:return B(`Scope map: ${H(e.args,`task`)||`unknown task`}`,120);default:return B(`Flow context: ${e.toolName}`,120)}}function li(e){return{name:`flow-context`,tools:[...Hr],extract(t){if(t.isError)return[];let n=e();if(!n?.active||!n.slug||!(t.toolName in Ur))return[];let r=Mr(t.result).trim();if(r.length<50)return[];let i=Ur[t.toolName],a=si(t,r);if(a.length<50)return[];let o=ci(t);return[{title:o,content:a,category:`flow-context`,tags:[`flow-context`,`flow:${n.slug}`,i,`tool:${t.toolName}`],hash:R(`${n.slug}|${t.toolName}|${o}|${a}`),quality:Kr(a),ttlMs:Wr[i],source:t.toolName}]}}}const ui={name:`research-results`,tools:[`web_search`,`web_fetch`,`search`],extract(e){let t=Mr(e.result);if(!t||t.length<100||e.isError)return[];let n=[];if(e.toolName===`web_search`){let r=typeof e.args.query==`string`?e.args.query:``;if(r&&t.length>200){let i=t.slice(0,800);n.push({title:`Web research: ${r.slice(0,80)}`,content:`Research query: "${r}"\n\nKey findings:\n${i}`,category:`context`,tags:[`research`,`web-search`],hash:R(`web-search-${r}`),quality:Math.min(.8,Nr(i)+.2),source:e.toolName,ttlMs:864e5})}}if(e.toolName===`web_fetch`){let r=e.args.urls,i=Array.isArray(r)?String(r[0]??``):typeof e.args.url==`string`?e.args.url:``;if(i&&t.length>200){let r=t.split(/\r?\n/).find(e=>e.trim().length>10)?.trim()??i,a=t.slice(0,600);n.push({title:`Fetched: ${r.slice(0,80)}`,content:`Source: ${i}\n\n${a}`,category:`context`,tags:[`research`,`web-fetch`],hash:R(`web-fetch-${i}`),quality:Nr(a),source:e.toolName,ttlMs:864e5})}}if(e.toolName===`search`){let r=typeof e.args.query==`string`?e.args.query:``;(typeof e.args.origin==`string`?e.args.origin:``)===`curated`&&r&&t.length>100&&n.push({title:`Curated search: ${r.slice(0,80)}`,content:`Searched curated knowledge for: "${r}"\n\nResults:\n${t.slice(0,500)}`,category:`context`,tags:[`research`,`curated-search`],hash:R(`curated-search-${r}`),quality:.5,source:e.toolName,ttlMs:36e5})}return n}};function di(e){let t=e.toLowerCase();return t.includes(`vitest`)?`vitest`:t.includes(`jest`)?`jest`:t.includes(`mocha`)?`mocha`:t.includes(`playwright`)?`playwright`:t.includes(`cypress`)?`cypress`:null}function fi(e){let t=[/(\S+\.test\.\w+)/,/(\S+\.spec\.\w+)/,/(\S+_test\.\w+)/,/__tests__\/\S+/],n=new Set;for(let r of t){let t=e.matchAll(new RegExp(r.source,`g`));for(let e of t){let t=e[0].match(/\.(test|spec)\.\w+$/);t&&n.add(t[0])}}return n.size>0?[...n].join(`, `):null}const pi={name:`test-results`,tools:[`check`,`test_run`],extract(e){let t=Mr(e.result);if(!t)return[];let n=[],r=di(t);r&&n.push({title:`Test framework: ${r}`,content:`This project uses ${r} for testing. Detected from ${e.toolName} output.`,category:`context`,tags:[`testing`,`environment`,r],hash:R(`test-framework-${r}`),quality:.7,source:e.toolName});let i=fi(t);return i&&n.push({title:`Test file pattern: ${i}`,content:`Test files use the naming pattern: ${i}. Follow this convention when creating new tests.`,category:`conventions`,tags:[`testing`,`naming-convention`],hash:R(`test-pattern-${i}`),quality:.7,source:e.toolName}),n}};function mi(e){let t=e.toLowerCase();return/enoent|no such file|not found/i.test(e)?{type:`missing-file`,actionable:!1}:/econnreset|econnrefused|etimedout|fetch failed/i.test(e)?{type:`network`,actionable:!1}:/permission denied|eacces/i.test(e)?{type:`permission`,actionable:!0}:/type\s*error|cannot.*property|is not a function/i.test(e)?{type:`type-error`,actionable:!0}:/syntax\s*error|unexpected token|parsing error/i.test(e)?{type:`syntax`,actionable:!0}:/out of memory|heap|allocation/i.test(e)?{type:`memory`,actionable:!0}:/timeout|timed out/i.test(e)?{type:`timeout`,actionable:t.includes(`increase`)||t.includes(`config`)}:/import|require|module not found|cannot find module/i.test(e)?{type:`module-resolution`,actionable:!0}:{type:`unknown`,actionable:e.length>100}}const hi={name:`tool-failure-patterns`,tools:[],extract(e){if(!e.isError)return[];let t=Mr(e.result);if(!t||t.length<30)return[];let{type:n,actionable:r}=mi(t);if(!r)return[];let i=t.slice(0,500),a=Nr(i);return a<.2?[]:[{title:`${n} error in ${e.toolName}`,content:`Tool \`${e.toolName}\` failed with a ${n} error.\n\nArgs: ${JSON.stringify(e.args,null,2).slice(0,200)}\n\nError:\n${i}`,category:`context`,tags:[`errors`,n,e.toolName],hash:R(`smart-error-${n}-${e.toolName}-${t.slice(0,80)}`),quality:Math.min(.7,a+.1),source:e.toolName,ttlMs:72e5}]}};var gi=class{extractors=[];register(e){this.extractors.push(e)}getExtractors(e){return this.extractors.filter(t=>t.tools.length===0||t.tools.includes(e))}extractAll(e){return this.getExtractors(e.toolName).flatMap(t=>t.extract(e))}};function _i(e){return{content:[{type:`text`,text:(e instanceof Error,String(e))}],isError:!0}}function vi(e,t){try{e.push(t)}catch{}}function yi(e){return async(t,n)=>{let r=Date.now();try{let i=await n();return vi(e,{toolName:t.toolName,args:t.args,result:i,durationMs:Date.now()-r,isError:i.isError===!0,timestamp:new Date().toISOString()}),i}catch(n){throw vi(e,{toolName:t.toolName,args:t.args,result:_i(n),durationMs:Date.now()-r,isError:!0,timestamp:new Date().toISOString()}),n}}}const bi=F(`auto-knowledge`);var xi=class{registry;curated;flowContextAdapter;queue=[];timer=null;seenHashes=new Map;storedCount=0;droppedCount=0;dedupedCount=0;config;existingTitles=null;constructor(e,t,n={},r){this.registry=e,this.curated=t,this.flowContextAdapter=r,this.config={...jr,...n}}push(e){if(!(!this.config.enabled||!this.curated&&!this.flowContextAdapter)&&!(this.storedCount>=this.config.maxFactsPerSession)){if(this.queue.push(e),this.queue.length>=this.config.batchSize){this.flush().catch(e=>{bi.warn(`Auto-knowledge flush error`,{error:String(e)})});return}this.scheduleBatch()}}async flush(){this.timer&&=(clearTimeout(this.timer),null);let e=this.queue.splice(0);if(e.length===0||!this.curated&&!this.flowContextAdapter)return;this.existingTitles===null&&(this.existingTitles=await this.loadExistingTitles());let t=new Map;for(let n of e)for(let e of this.registry.extractAll(n)){if(e.quality<this.config.minQuality){this.droppedCount++;continue}if(this.isSeenRecently(e)){this.dedupedCount++;continue}if(t.has(e.hash)){this.dedupedCount++;continue}if(this.existingTitles.has(this.normalizeTitle(e.title))){this.dedupedCount++;continue}t.set(e.hash,e)}for(let e of t.values()){if(this.storedCount>=this.config.maxFactsPerSession)break;try{if(e.tags.includes(`flow-context`)&&this.flowContextAdapter){let t=`${e.tags.find(e=>!e.startsWith(`flow:`)&&!e.startsWith(`tool:`)&&e!==`flow-context`)||`analysis`}/${e.title.toLowerCase().replace(/[^a-z0-9]+/g,`-`).slice(0,60)}.md`;await this.flowContextAdapter.write(t,`# ${e.title}\n\n${e.content}`)}else if(this.curated)await this.curated.remember(e.title,e.content,e.category,e.tags);else continue;this.seenHashes.set(e.hash,Date.now()),this.existingTitles.add(this.normalizeTitle(e.title)),this.storedCount++,bi.info(`Auto-knowledge stored`,{title:e.title,category:e.category,quality:e.quality,source:e.source})}catch(t){bi.warn(`Auto-knowledge store failed`,{title:e.title,error:String(t)})}}}reset(){this.queue=[],this.seenHashes.clear(),this.storedCount=0,this.droppedCount=0,this.dedupedCount=0,this.existingTitles=null,this.timer&&=(clearTimeout(this.timer),null)}getStats(){return{queued:this.queue.length,stored:this.storedCount,seen:this.seenHashes.size,dropped:this.droppedCount,deduped:this.dedupedCount}}isSeenRecently(e){let t=this.seenHashes.get(e.hash);return t==null?!1:e.ttlMs==null?!0:Date.now()-t<e.ttlMs}normalizeTitle(e){return e.toLowerCase().trim()}async loadExistingTitles(){let e=new Set,t=this.curated;if(!t)return e;try{let n=await t.list();for(let t of n)e.add(this.normalizeTitle(t.title))}catch{bi.warn(`Failed to load existing curated titles for dedup`,{})}return e}scheduleBatch(){this.timer||=setTimeout(()=>{this.timer=null,this.flush().catch(e=>{bi.warn(`Auto-knowledge flush error`,{error:String(e)})})},this.config.debounceMs)}};const Si=new Set([`compact`,`digest`,`file_summary`,`stratum_card`,`present`,`web_fetch`,`web_search`,`check`,`audit`]);function Ci(e){switch(e){case`efficient`:return{threshold:2e3,tokenBudget:1e3};case`full`:return{threshold:1/0};default:return{threshold:4e3,tokenBudget:2e3}}}function wi(e){let t=e?.threshold??4e3,n=e?.tokenBudget??2e3;return async(e,r)=>{if(Si.has(e.toolName))return r();let i=await r();if(!Array.isArray(i.content))return i;let a=0;for(let e of i.content)e.type===`text`&&typeof e.text==`string`&&(a+=e.text.length);if(a<t)return i;let o=i.content.map(r=>{if(r.type!==`text`||typeof r.text!=`string`||r.text.length<t)return r;let i=Ie({text:r.text,tool:e.toolName,tokenBudget:n});return{...r,text:i.text}});return{...i,content:o}}}var Ti=class{baseDir;getActiveSlug;constructor(e,t){this.baseDir=e,this.getActiveSlug=t}async initialize(){await pn(this.baseDir,{recursive:!0})}async read(e){let t=this.resolveScopedPath(e);if(t==null)return null;try{return await mn(t,`utf-8`)}catch(e){if(this.isMissingError(e))return null;throw e}}async write(e,t,n){let r=this.resolveScopedPath(e);r!=null&&(await pn(M(r),{recursive:!0}),await yn(r,t,{encoding:`utf-8`,flag:n?.exclusive?`wx`:`w`}))}async delete(e){let t=this.resolveScopedPath(e);if(t==null)return!1;try{return await vn(t),!0}catch(e){if(this.isMissingError(e))return!1;throw e}}async list(e){let t=this.getActiveSlugDir();if(t==null)return[];let n=e?this.resolveScopedPath(e):t;return n==null?[]:this.collectFiles(n,e??``)}async exists(e){let t=this.resolveScopedPath(e);if(t==null)return!1;try{return await _n(t),!0}catch(e){if(this.isMissingError(e))return!1;throw e}}async listDirectories(){let e=this.getActiveSlugDir();if(e==null)return[];try{return(await hn(e,{withFileTypes:!0})).filter(e=>e.isDirectory()&&/^[a-z][a-z0-9-]*$/.test(e.name)).map(e=>e.name).sort()}catch(e){if(this.isMissingError(e))return[];throw e}}async flushAll(){let e=this.getActiveSlugDir();if(e==null)return 0;let t=await this.countFiles(e);return t===0?0:(await gn(e,{recursive:!0,force:!0}),t)}async close(){}getActiveSlugDir(){let e=this.getActiveSlug();return e?N(this.baseDir,e):null}resolveScopedPath(e){let t=this.getActiveSlugDir();if(t==null)return null;let n=P(t),r=P(n,e),i=ae(n,r);if(i===``||i===`..`||i.startsWith(`..${oe}`)||ie(i))throw Error(`Path escapes active flow context scope: ${e}`);return r}async collectFiles(e,t){let n;try{n=await hn(e,{withFileTypes:!0})}catch(e){if(this.isMissingError(e))return[];throw e}let r=[];for(let i of n){let n=t?`${t}/${i.name}`:i.name,a=N(e,i.name);if(i.isDirectory()){r.push(...await this.collectFiles(a,n));continue}if(!(!i.isFile()||!i.name.endsWith(`.md`)))try{let e=await _n(a);r.push({path:n,size:e.size})}catch(e){if(!this.isMissingError(e))throw e}}return r.sort((e,t)=>e.path.localeCompare(t.path))}async countFiles(e){let t;try{t=await hn(e,{withFileTypes:!0})}catch(e){if(this.isMissingError(e))return 0;throw e}let n=0;for(let r of t){let t=N(e,r.name);if(r.isDirectory()){n+=await this.countFiles(t);continue}r.isFile()&&(n+=1)}return n}isMissingError(e){return typeof e==`object`&&!!e&&`code`in e&&(e.code===`ENOENT`||e.code===`ENOTDIR`)}};const Ei=F(`observation-capture`),Di=[`check`,`test_run`,`search`,`trace`],Oi=[/\bAuthorization\s*:\s*Bearer\s+[A-Za-z0-9\-._~+/]+=*/gi,/\bBearer\s+[A-Za-z0-9\-._~+/]+=*/g,/\b(?:sk|ghp|gho|glpat|xoxb|xoxp)-[A-Za-z0-9\-._]{20,}\b/g,/\b(?:token|key|secret|password|auth(?:orization)?)\s*[=:]\s*['"]?[^\s'"&]{8,}/gi,/\b(?:token|key|secret|password|auth(?:orization)?)=[^\s&]+/gi,/\b[A-Z][A-Z0-9_]*(?:PASSWORD|SECRET|TOKEN|AUTH)[A-Z0-9_]*\b\s*[=:]\s*['"]?[^\s'"]+/g,/\b[A-Z][A-Z0-9_]*KEY[A-Z0-9_]*\b\s*[=:]\s*['"]?[^\s'"]{8,}/g,/-----BEGIN [\w\s]+-----[\s\S]*?-----END [\w\s]+-----/g],ki=new Set([`env`,`auth`,`config`]),Ai=2e3,ji={enabled:!0,rateLimit:10,captureFrom:[...Di],minContentLength:50};var Mi=class{maxPerMinute;timestamps=[];constructor(e){this.maxPerMinute=e}canCapture(e=Date.now()){return this.prune(e),this.timestamps.length<this.maxPerMinute}record(e=Date.now()){this.prune(e),this.timestamps.push(e)}setLimit(e){this.maxPerMinute=e,this.prune(Date.now())}prune(e){let t=e-6e4;this.timestamps=this.timestamps.filter(e=>e>t)}};function Ni(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Pi(e){return typeof e==`string`?e:Ni(e)?[Array.isArray(e.content)?e.content.filter(e=>Ni(e)).map(e=>typeof e.text==`string`?e.text:``).filter(e=>e.length>0).join(`
|
|
17
17
|
`):``,e.structuredContent==null?``:JSON.stringify(e.structuredContent,null,2)].filter(e=>e.length>0).join(`
|
|
18
18
|
|
|
19
|
-
`):JSON.stringify(e)}function
|
|
20
|
-
`),r=await this.curatedStore.remember(t,n,`context`,[`observation`,`source-${e.source}`,`type-${e.type}`]);this.stateStore.memoryMetaCreate(r.path,`working`)}};function
|
|
21
|
-
`)}function
|
|
22
|
-
`):`_No curated entries yet._`}`,mimeType:`text/markdown`}]}});let n=new wn(`aikit://curated/{+path}`,{list:async()=>({resources:(await t.list()).map(e=>({uri:`aikit://curated/${e.path}`,name:e.title,description:`[${e.category}] ${e.contentPreview?.slice(0,80)??``}`,mimeType:`text/markdown`}))})});e.registerResource(`aikit-curated-entry`,n,{description:`A curated knowledge entry`,mimeType:`text/markdown`},async(e,n)=>{let r=n.path;if(!r)throw Error(`Missing path variable in curated resource URI`);let i=await t.read(r);return{contents:[{uri:e.toString(),text:`---\ntitle: ${i.title}\ncategory: ${i.category}\ntags: ${i.tags?.join(`, `)??``}\nversion: ${i.version??1}\n---\n\n${i.content??i.contentPreview??``}`,mimeType:`text/markdown`}]}})}const
|
|
23
|
-
`),mimeType:`text/plain`}]})),e.registerResource(`aikit-channel-surface-schema`,Ca,{description:`JSON Schema for the ChannelSurface communication contract`,mimeType:`application/schema+json`},async()=>({contents:[{uri:Ca,text:await Ea(),mimeType:`application/schema+json`}]})),Sa(e,n)}const Oa=[`er_push`,`er_pull`,`er_sync_status`],ka=[...Oa,`er_update_policy`,`er_evolve_review`],Aa=new Set(ka);function ja(e){return e.toolProfiles}const Ma=new Set(`browser.changelog.check.checkpoint.codemod.compact.config.data_transform.delegate.diff_parse.digest.encode.env.eval.evidence_map.file_summary.forge_classify.git_context.graph.guide.health.http.knowledge.lane.measure.onboard.parse_output.present.process.produce_knowledge.queue.regex_test.reindex.rename.replay.restore.schema_validate.session_digest.scope_map.stash.status.stratum_card.signal.test_run.time.watch.web_fetch.web_search.workset`.split(`.`)),Na=5e3,Pa=new Set(`browser.changelog.check.checkpoint.codemod.data_transform.delegate.diff_parse.encode.env.eval.evidence_map.flow.describe_tool.list_tools.search_tools.forge_classify.git_context.guide.present.health.http.lane.measure.parse_output.process.produce_knowledge.queue.regex_test.rename.replay.restore.schema_validate.session_digest.status.test_run.time.watch.web_fetch.web_search.workset`.split(`.`)),Fa=`analyze.audit.blast_radius.browser.changelog.check.checkpoint.codemod.compact.config.data_transform.dead_symbols.delegate.diff_parse.digest.encode.env.eval.evidence_map.file_summary.find.flow.forge_classify.forge_ground.git_context.graph.guide.health.http.knowledge.lane.describe_tool.list_tools.lookup.measure.onboard.parse_output.present.process.produce_knowledge.queue.regex_test.reindex.rename.replay.restore.schema_validate.scope_map.search.search_tools.signal.session_digest.stash.status.stratum_card.symbol.test_run.time.trace.watch.web_fetch.web_search.workset`.split(`.`),Ia=F(`structured-content-guard`);function La(){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.isError&&n.structuredContent==null&&(n.structuredContent={},Ia.warn(`Structured content guard activated`,{tool:e.toolName,action:`inject-empty-no-schema`})),n;let i=null;n.structuredContent??(n.structuredContent=Ra(r),i=`synthesize`);let a=za(r,n.structuredContent);return a.action!=null&&(n.structuredContent=a.structuredContent,i=a.action),n.structuredContent||(n.isError=!0,n.structuredContent={},i=`fallback-error`),i!=null&&Ia.warn(`Structured content guard activated`,{tool:e.toolName,action:i}),n});return e.critical=!0,e}function Ra(e){try{return Va(e)??{}}catch{return{}}}function za(e,t){let n=e.safeParse;if(typeof n!=`function`)return{structuredContent:t,action:null};try{if(n(t).success)return{structuredContent:t,action:null};let r=Ra(e);if(Ba(r)&&Ba(t)){let e={...r,...t};if(n(e).success)return{structuredContent:e,action:`heal`}}return{structuredContent:r,action:`fallback-zero-value`}}catch{return{structuredContent:t,action:null}}}function Ba(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Va(e){if(!e)return{};if(e.anyOf){let t=e.anyOf.find(e=>e.type!==`null`);return t?Va(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]=Va(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]=Va(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{}}}const U={search:{title:`Hybrid Search`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`]},find:{title:`Federated Find`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`]},symbol:{title:`Symbol Resolver — Cross-Module Definitions & References`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`]},trace:{title:`Data Flow Tracer — Cross-Module Call & Import Chains`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`]},scope_map:{title:`Task Scope Map`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`]},lookup:{title:`Chunk Lookup`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`]},dead_symbols:{title:`Dead Symbol Finder`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`]},file_summary:{title:`File Summary`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`]},analyze:{title:`Analyze`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`analysis`]},blast_radius:{title:`Blast Radius`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`analysis`,`search`]},knowledge:{title:`Knowledge`,annotations:{readOnlyHint:!1},category:[`knowledge`]},produce_knowledge:{title:`Produce Knowledge`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`knowledge`]},compact:{title:`Semantic Compactor`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`compression`]},digest:{title:`Multi-Source Digest`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`compression`]},stratum_card:{title:`Stratum Card`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`compression`]},forge_ground:{title:`FORGE Ground`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`forge`]},forge_classify:{title:`FORGE Classify`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`forge`]},evidence_map:{title:`Evidence Map`,annotations:{readOnlyHint:!1},category:[`forge`]},present:{title:`Rich Content Presenter`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`presentation`]},check:{title:`Typecheck & Lint`,annotations:{readOnlyHint:!0,openWorldHint:!0},category:[`execution`]},test_run:{title:`Run Tests`,annotations:{readOnlyHint:!0,openWorldHint:!0},category:[`execution`]},eval:{title:`Evaluate Code`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`execution`]},audit:{title:`Project Audit`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`execution`]},browser:{title:`Browser Automation`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`web`]},rename:{title:`Rename Symbol`,annotations:{readOnlyHint:!1,destructiveHint:!0},category:[`manipulation`]},restore:{title:`Restore`,annotations:{readOnlyHint:!1},category:[`manipulation`]},codemod:{title:`Codemod`,annotations:{readOnlyHint:!1,destructiveHint:!0},category:[`manipulation`]},data_transform:{title:`Data Transform`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`manipulation`]},stash:{title:`Stash Values`,annotations:{readOnlyHint:!1},category:[`session`]},signal:{title:`Inter-Agent Signaling`,annotations:{readOnlyHint:!1},category:[`session`]},checkpoint:{title:`Session Checkpoint`,annotations:{readOnlyHint:!1},category:[`session`]},session_digest:{title:`Session Digest`,annotations:{readOnlyHint:!0,idempotentHint:!1},category:[`session`]},workset:{title:`Workset Manager`,annotations:{readOnlyHint:!1},category:[`session`]},lane:{title:`Exploration Lane`,annotations:{readOnlyHint:!1},category:[`session`]},git_context:{title:`Git Context`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`git`]},diff_parse:{title:`Diff Parser`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`git`]},parse_output:{title:`Parse Build Output`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`git`]},process:{title:`Process Manager`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`process`]},watch:{title:`File Watcher`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`process`]},delegate:{title:`Delegate Task`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`process`]},config:{title:`Configuration Manager`,annotations:{readOnlyHint:!1},category:[`system`]},status:{title:`AI Kit Status`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},health:{title:`Health Check`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},reindex:{title:`Reindex`,annotations:{readOnlyHint:!1},category:[`system`]},onboard:{title:`Onboard Codebase`,annotations:{readOnlyHint:!1},category:[`system`]},graph:{title:`Code Knowledge Graph — Module & Symbol Relationships`,annotations:{readOnlyHint:!1},category:[`system`]},guide:{title:`Tool Guide`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},replay:{title:`Replay History`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},list_tools:{title:`List Available Tools`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`meta`]},describe_tool:{title:`Describe Tool`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`meta`]},search_tools:{title:`Search Tools`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`meta`]},changelog:{title:`Generate Changelog`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`]},regex_test:{title:`Regex Tester`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`]},encode:{title:`Encode / Decode`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`]},measure:{title:`Code Metrics`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`]},schema_validate:{title:`Schema Validator`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`]},env:{title:`Environment Info`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`]},time:{title:`Date & Time`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`]},web_fetch:{title:`Web Fetch`,annotations:{readOnlyHint:!0,openWorldHint:!0},category:[`web`]},web_search:{title:`Web Search`,annotations:{readOnlyHint:!0,openWorldHint:!0},category:[`web`]},http:{title:`HTTP Request`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`web`]},queue:{title:`Operation Queue`,annotations:{readOnlyHint:!1},category:[`queue`]},bridge_push:{title:`Bridge Push`,annotations:{readOnlyHint:!1},category:[`system`]},bridge_pull:{title:`Bridge Pull`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},bridge_sync:{title:`Bridge Sync Status`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},er_push:{title:`Enterprise Push`,annotations:{readOnlyHint:!1},category:[`system`]},er_pull:{title:`Enterprise Pull`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},er_sync_status:{title:`Enterprise Sync Status`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},er_update_policy:{title:`Enterprise Update Policy`,annotations:{readOnlyHint:!1},category:[`system`]},er_evolve_review:{title:`Enterprise Evolution Review`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},evolution_state:{title:`Evolution State`,annotations:{readOnlyHint:!1},category:[`system`]},policy_check:{title:`Policy Check`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},flow:{title:`Flow`,annotations:{readOnlyHint:!1},category:[`flow`]}};function W(e){return U[e]??{title:e,annotations:{readOnlyHint:!1},category:[]}}const Ha=Symbol(`toolPipelineState`);function Ua(e){return e[Ha]}function Wa(e,t){e[Ha]=t}function Ga(e,t,n=``){let r=Ua(e);if(r){r.pipeline=t,r.prefix=n;return}Wa(e,{originalRegisterTool:e.registerTool.bind(e),pipeline:t,prefix:n}),e.registerTool=(n,r,i)=>{let a=Ua(e),o=a?.prefix?`${a.prefix}${n}`:n;if(!i)return a?.originalRegisterTool(o,r);if((a?.pipeline??t).getMiddlewareNames().length===0)return a?.originalRegisterTool(o,r,i);let s=W(n),c=(a?.pipeline??t).wrap(n,i,r,s);return a?.originalRegisterTool(o,r,c)}}const Ka={analyze:1,audit:1,blast_radius:1,changelog:1,check:2,checkpoint:2,codemod:2,compact:1,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,stratum_card:1,symbol:1,test_run:2,time:0,trace:1,watch:3,web_fetch:1,web_search:1,workset:2};function qa(e,t){return e.filter(e=>(Ka[e]??0)<=t)}const Ja=new Set([`status`,`config`,`guide`,`health`]),Ya={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:[`compact`,`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 Xa(e,t){let n=Ya[e];if(n)return n;let r=t?.[e];if(r)return r;throw Error(`Unknown tool profile: ${e}`)}function Za(e,t,n){return t.includes(`*`)?!0:(n[e]?.category??[]).some(e=>t.includes(e))}function Qa(e,t,n,r){if(t.includes(`*`)){for(let t of n)e.add(t);return}for(let i of n)Za(i,t,r)&&e.add(i)}function $a(e,t,n){if(t.includes(`*`)){e.clear();return}for(let r of[...e])Za(r,t,n)&&e.delete(r)}function eo(e,t,n){if(!e||e.length===0||e.includes(`*`))return new Set(t);let r=new Set;return Qa(r,e,t,n),r}function to(e,t){return e===void 0?t:t===void 0?e:Math.min(e,t)}function no(e,t){for(let n of[...e])t[n]?.annotations?.readOnlyHint===!1&&e.delete(n)}function ro(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=Xa(e,t);return to(i.extends?ro(i.extends,t,n+1,[...r,e]):void 0,i.maxTier)}function io(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=Xa(e,r),c=[...o,e],l=s.extends?i(s.extends,a+1,c):eo(s.includeCategories,t,n);s.extends&&s.includeCategories?.length&&Qa(l,s.includeCategories,t,n),s.excludeCategories?.length&&$a(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=ro(e,r);if(o!==void 0){let e=qa([...a],o);a.clear();for(let t of e)a.add(t)}for(let e of Ja)a.add(e);return e===`safe`&&no(a,n),a}const ao=new Set([`search`,`analysis`,`knowledge`,`compression`,`forge`,`presentation`,`execution`,`manipulation`,`session`,`git`,`process`,`system`,`meta`,`utilities`,`web`,`queue`,`flow`]);function oo(e,t,n,r){let i=process.env.AIKIT_TOOLSET||e.toolProfile||`full`,a=io(i,t,n,r);if(e.features&&e.features.length>0){let i=e.features.filter(e=>!ao.has(e));if(i.length>0)throw Error(`Unknown feature group(s): ${i.join(`, `)}. Valid categories: ${[...ao].join(`, `)}`);let o={description:`Synthetic profile from features config`,includeCategories:e.features},s=io(`_features`,t,n,{...r,_features:o});for(let e of a)!s.has(e)&&!Ja.has(e)&&a.delete(e)}if(e.readOnly)for(let e of[...a])n[e]?.annotations?.readOnlyHint===!1&&!Ja.has(e)&&a.delete(e);for(let e of Ja)a.add(e);return i===`safe`&&no(a,n),a}const so=L.object({mode:L.enum([`wasm`,`regex`,`unknown`]),reason:L.string(),pathsChecked:L.array(L.object({path:L.string(),exists:L.boolean()})),os:L.string(),arch:L.string(),nodeVersion:L.string(),webTreeSitterImportable:L.boolean(),healAttempted:L.boolean(),healSuccess:L.boolean(),healError:L.string().nullable(),initError:L.string().nullable(),wasmDir:L.string().nullable(),grammarCount:L.number()}),co=L.object({kind:L.enum([`onboard`,`reindex`,`handoff`,`proceed`]),reason:L.string()}),lo=L.object({totalRecords:L.number(),totalFiles:L.number(),lastIndexedAt:L.string().nullable(),onboarded:L.boolean(),onboardDir:L.string(),contentTypes:L.record(L.string(),L.number()),wasmAvailable:L.boolean(),wasmDiagnostics:so,graphStats:L.object({nodes:L.number(),edges:L.number()}).nullable(),curatedCount:L.number(),serverVersion:L.string(),scaffoldVersion:L.string().nullable(),workspaceScaffoldVersion:L.string().nullable(),upgradeAvailable:L.boolean(),storeBackend:L.string().optional(),storeDiagnostics:L.object({adapterType:L.string(),vectorSearchEnabled:L.boolean(),ftsEnabled:L.boolean(),degradedMode:L.boolean(),dbPath:L.string(),dbSizeBytes:L.number().nullable(),embeddingDim:L.number(),vectorDtype:L.string()}).nullable().optional(),contextPressure:L.number().min(0).max(100).describe(`0–100 score indicating AI Kit saturation`),nextAction:co});L.object({entries:L.array(L.object({path:L.string(),title:L.string(),category:L.string(),tags:L.array(L.string()),version:L.number(),preview:L.string()})),totalCount:L.number()});const uo=L.object({ok:L.boolean(),checks:L.array(L.object({name:L.string(),ok:L.boolean(),message:L.string().optional()}))}),fo=L.object({summary:L.object({totalFiles:L.number(),totalLines:L.number(),totalCodeLines:L.number(),totalFunctions:L.number(),avgComplexity:L.number(),maxComplexity:L.object({value:L.number(),file:L.string()})}),files:L.array(L.object({path:L.string(),lines:L.number(),code:L.number(),complexity:L.number(),functions:L.number()}))}),po=L.object({platform:L.string(),arch:L.string(),nodeVersion:L.string(),cwd:L.string(),cpus:L.number(),memoryFreeGb:L.number(),memoryTotalGb:L.number()}),mo=L.object({iso:L.string(),unix:L.number(),timezone:L.string(),formatted:L.string()}),ho=L.object({passed:L.boolean(),errorCount:L.number(),warningCount:L.number(),topErrors:L.array(L.string())}),go=L.object({passed:L.boolean(),tsc:ho,biome:ho}),_o=L.object({name:L.string(),definedIn:L.object({path:L.string(),line:L.number(),kind:L.string(),signature:L.string().optional()}).nullable(),importedBy:L.array(L.object({path:L.string(),line:L.number(),importStatement:L.string()})),referencedIn:L.array(L.object({path:L.string(),line:L.number(),context:L.string(),scope:L.string().optional()})),graphContext:L.object({definingModule:L.string().optional(),importedByModules:L.array(L.string()),siblingSymbols:L.array(L.string())}).nullable()}),vo=L.object({sourcePath:L.string(),contentType:L.string(),score:L.number(),headingPath:L.string().optional(),startLine:L.number().optional(),endLine:L.number().optional(),origin:L.string().optional(),category:L.string().optional(),tags:L.array(L.string()).optional()}),yo=L.object({results:L.array(vo),totalResults:L.number(),searchMode:L.string(),query:L.string()}),bo=L.object({path:L.string(),line:L.number().optional(),matchType:L.string(),preview:L.string()}),xo=L.object({matches:L.array(bo),totalMatches:L.number(),pattern:L.string(),truncated:L.boolean()}),So=L.object({path:L.string(),relevance:L.number(),estimatedTokens:L.number(),focusLines:L.array(L.string()).optional()}),Co=L.object({files:L.array(So),totalFiles:L.number(),totalEstimatedTokens:L.number(),task:L.string()}),wo=L.object({path:L.string(),impact:L.string(),reason:L.string()}),To=L.object({changedFiles:L.array(L.string()),affectedFiles:L.array(wo),totalAffected:L.number(),riskLevel:L.string()}),Eo=L.object({name:L.string(),passed:L.boolean(),message:L.string().optional(),severity:L.string().optional()}),Do=L.object({passed:L.boolean(),score:L.number(),checks:L.array(Eo),summary:L.string()}),Oo=L.object({id:L.string(),name:L.string(),type:L.string(),sourcePath:L.string().optional()}),ko=L.object({fromId:L.string(),toId:L.string(),type:L.string()}),Ao=L.object({nodes:L.array(Oo),edges:L.array(ko),totalNodes:L.number(),totalEdges:L.number(),query:L.string()}),jo=L.object({symbols:L.array(L.object({name:L.string(),path:L.string(),line:L.number().optional(),kind:L.string()})),totalDead:L.number()});L.object({files:L.number(),packages:L.number(),languages:L.record(L.string(),L.number()),tree:L.string()});const Mo=L.object({path:L.string(),language:L.string(),lines:L.number(),imports:L.number(),exports:L.number(),functions:L.number(),classes:L.number()}),No=L.object({gitRoot:L.string(),branch:L.string(),commitCount:L.number(),hasUncommitted:L.boolean(),recentCommits:L.array(L.object({hash:L.string(),message:L.string(),author:L.string(),date:L.string()}))}),Po=L.object({originalChars:L.number(),compressedChars:L.number(),ratio:L.number(),segmentsKept:L.number(),segmentsTotal:L.number()}),Fo=L.object({passed:L.boolean(),totalTests:L.number(),passedTests:L.number(),failedTests:L.number(),skippedTests:L.number(),duration:L.number().describe(`Duration in milliseconds`),failures:L.array(L.object({name:L.string(),message:L.string(),file:L.string().optional()}))}),Io=F(`utils:enrich`);async function G(e,t){let n={curated:[],graph:[]},r=t.limit??3,[i,a]=await Promise.allSettled([Lo(e,t.query,r),Ro(e,t.filePath)]);return i.status===`fulfilled`?n.curated=i.value:Io.debug(`Curated enrichment failed`,{error:i.reason}),a.status===`fulfilled`?n.graph=a.value:Io.debug(`Graph enrichment failed`,{error:a.reason}),n}async function Lo(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=>zo(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=>zo(e.record))}return[]}catch(e){return Io.debug(`Curated enrichment failed`,{error:e}),[]}}async function Ro(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 Io.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(`
|
|
24
|
-
`)}`}function
|
|
19
|
+
`):JSON.stringify(e)}function Fi(e,t=500){return e.length<=t?e:e.slice(0,t)}function Ii(e){let t=e.toLowerCase();return[...ki].some(e=>t===e||t.includes(e))}function Li(e){let t=e;for(let e of Oi)t=t.replace(e,`[REDACTED]`);return t.length>Ai&&(t=`${t.slice(0,Ai)}\n...[truncated]`),t}function Ri(e,t){let n=t?.args??{},r=[];switch(t?.workspace&&r.push(`workspace=${t.workspace}`),e){case`check`:typeof n.cwd==`string`&&r.push(`cwd=${n.cwd}`),Array.isArray(n.files)&&n.files.length>0&&r.push(`files=${n.files.join(`, `)}`);break;case`test_run`:typeof n.cwd==`string`&&r.push(`cwd=${n.cwd}`),typeof n.grep==`string`&&r.push(`grep=${n.grep}`),Array.isArray(n.files)&&n.files.length>0&&r.push(`files=${n.files.join(`, `)}`);break;case`search`:typeof n.query==`string`&&r.push(`query=${n.query}`);break;case`trace`:typeof n.start==`string`&&r.push(`start=${n.start}`),typeof n.direction==`string`&&r.push(`direction=${n.direction}`);break;default:break}return r.length>0?r.join(` | `):void 0}var zi=class{stateStore;curatedStore;rateLimiter;config;constructor(e,t,n){this.stateStore=e,this.curatedStore=t,this.config={...ji,...n,captureFrom:n?.captureFrom?[...n.captureFrom]:[...Di]},this.rateLimiter=new Mi(this.config.rateLimit)}getConfig(){return{...this.config,captureFrom:[...this.config.captureFrom]}}updateConfig(e){this.config={...this.config,...e,captureFrom:e.captureFrom?[...e.captureFrom]:[...this.config.captureFrom]},e.rateLimit!==void 0&&this.rateLimiter.setLimit(e.rateLimit)}enable(){this.config.enabled=!0}disable(){this.config.enabled=!1}registerTool(e){this.config.captureFrom.includes(e)||this.config.captureFrom.push(e)}unregisterTool(e){this.config.captureFrom=this.config.captureFrom.filter(t=>t!==e)}async processToolResult(e,t,n){if(!this.config.enabled||Ii(e)||!this.config.captureFrom.includes(e)||!this.rateLimiter.canCapture())return null;let r=this.extractObservation(e,t,n);if(!r)return null;let i=Li(r.content).trim();if(i.length<this.config.minContentLength)return null;let a={...r,content:Fi(i).trim()},o={...a,content:i};this.rateLimiter.record();try{await this.storeObservation(o)}catch(t){Ei.warn(`Failed to store observation`,{toolName:e,error:t instanceof Error?t.message:String(t)})}return a}extractObservation(e,t,n){let r=Pi(t);if(r.trim().length===0)return null;switch(e){case`check`:return this.extractFromCheck(t,r,n);case`test_run`:return this.extractFromTestRun(t,r,n);case`search`:return this.extractFromSearch(r,n);case`trace`:return this.extractFromTrace(r,n);default:return null}}extractFromCheck(e,t,n){return Ni(e)&&e.isError===!0||/\berror\b/i.test(t)||/failed/i.test(t)?this.buildObservation(`check`,`error`,t,n):null}extractFromTestRun(e,t,n){let r=Ni(e)&&Ni(e.structuredContent)?e.structuredContent:void 0,i=typeof r?.failedTests==`number`?r.failedTests:void 0;return Ni(e)&&e.isError===!0||typeof i==`number`&&i>0||/\bFAIL\b/.test(t)||/failed/i.test(t)?this.buildObservation(`test_run`,`test_failure`,t,n):null}extractFromSearch(e,t){if(!/\b(convention|pattern)\b/i.test(e))return null;let n=/\bconvention\b/i.test(e)?`convention`:`pattern`;return this.buildObservation(`search`,n,e,t)}extractFromTrace(e,t){return this.buildObservation(`trace`,`insight`,e,t)}buildObservation(e,t,n,r){return{id:T(),source:e,type:t,content:n,context:Ri(e,r),timestamp:new Date().toISOString()}}async storeObservation(e){let t=`Observation ${e.source} ${e.type} ${e.timestamp}`,n=[`Source: ${e.source}`,`Type: ${e.type}`,`Captured: ${e.timestamp}`,e.context?`Context: ${e.context}`:null,``,e.content].filter(e=>e!==null).join(`
|
|
20
|
+
`),r=await this.curatedStore.remember(t,n,`context`,[`observation`,`source-${e.source}`,`type-${e.type}`]);this.stateStore.memoryMetaCreate(r.path,`working`)}};function Bi(e){let t=[e.cwd,e.workspace,e.root_path,e.path];for(let e of t)if(typeof e==`string`&&e.length>0)return e}function Vi(e){return async(t,n)=>{let r=await n();try{await e.processToolResult(t.toolName,r,{workspace:Bi(t.args),args:t.args})}catch(e){Ei.warn(`Observation capture failed`,{toolName:t.toolName,requestId:t.requestId,error:e instanceof Error?e.message:String(e)})}return r}}const Hi=F(`procedural-memory`),Ui=`Use when these user-facing tools are run in this order within a single session.`,Wi={minSequenceLength:3,minRepetitions:3,maxSequenceLength:10,confidenceIncrement:10,confidenceDecrement:20},Gi=new Set([`status`,`guide`,`health`,`onboard`,`reindex`,`replay`,`session_digest`,`process`,`watch`,`produce_knowledge`,`list_tools`,`describe_tool`,`search_tools`]);function Ki(e){return e.join(`→`)}function qi(e){return{...e,steps:[...e.steps]}}function Ji(e){return e.every(e=>e.success)}var Yi=class{config;history=[];sequences=new Map;procedures=new Map;pendingProcedures=new Map;constructor(e=Wi){this.config=e}record(e,t){let n=new Date().toISOString();this.history.push({toolName:e,timestamp:n,success:t}),this.history.length>100&&(this.history=this.history.slice(-100));let r=this.detectSequences(n);this.updateMatchedProcedures(n,r)}getExtractableSequences(){return[...this.sequences.entries()].filter(([,e])=>e.count>=this.config.minRepetitions).map(([e,t])=>({steps:e.split(`→`),count:t.count,lastSeen:t.lastSeen})).sort((e,t)=>t.count===e.count?t.steps.length-e.steps.length:t.count-e.count)}listProcedures(){return[...this.procedures.values()].map(e=>qi(e)).sort((e,t)=>t.occurrences===e.occurrences?t.steps.length-e.steps.length:t.occurrences-e.occurrences)}drainNewProcedures(){let e=[...this.pendingProcedures.values()].map(e=>qi(e));return this.pendingProcedures.clear(),e}requeueProcedures(e){for(let t of e)this.pendingProcedures.set(Ki(t.steps),qi(t))}extractProcedure(e,t){return{id:T(),steps:[...e],occurrences:t,confidence:Math.min(50+(t-this.config.minRepetitions)*this.config.confidenceIncrement,100),lastSeen:new Date().toISOString(),conditions:Ui}}adjustConfidence(e,t){return e.confidence=t?Math.min(100,e.confidence+this.config.confidenceIncrement):Math.max(0,e.confidence-this.config.confidenceDecrement),e.confidence}getHistoryLength(){return this.history.length}clear(){this.history=[],this.sequences.clear(),this.procedures.clear(),this.pendingProcedures.clear()}detectSequences(e){let t=this.history.map(e=>e.toolName),n=Math.min(this.config.maxSequenceLength,t.length),r=new Set,i=Math.max(1,Math.min(2,this.config.minRepetitions));for(let a=this.config.minSequenceLength;a<=n;a+=1){let n=t.slice(-a),o=Ki(n),s=0;for(let e=0;e<=t.length-a;e+=1)Ki(t.slice(e,e+a))===o&&(s+=1);if(!(s<i)&&(this.sequences.set(o,{count:s,lastSeen:e}),s>=this.config.minRepetitions&&!this.procedures.has(o))){let t=this.extractProcedure(n,s);t.lastSeen=e,this.procedures.set(o,t),this.pendingProcedures.set(o,qi(t)),r.add(o)}}return r}updateMatchedProcedures(e,t){for(let[n,r]of this.procedures.entries()){if(t.has(n))continue;let i=n.split(`→`);if(this.history.length<i.length)continue;let a=this.history.slice(-i.length);Ki(a.map(e=>e.toolName))===n&&(r.occurrences+=1,r.lastSeen=e,this.adjustConfidence(r,Ji(a)))}}};async function Xi(e,t,n){let r=await t.remember(`Procedure: ${n.steps.join(` → `)}`,Zi(n),`patterns`,[`procedure`,`auto-extracted`]);return e.memoryMetaCreate(r.path,`procedural`),r.path}function Zi(e){return[`## Procedure: ${e.steps.join(` → `)}`,``,`**Confidence:** ${e.confidence}/100`,`**Occurrences:** ${e.occurrences}`,`**Last Seen:** ${e.lastSeen}`,``,`### Steps`,...e.steps.map((e,t)=>`${t+1}. \`${e}\``),``,`### When to Use`,e.conditions??Ui].join(`
|
|
21
|
+
`)}function Qi(e,t,n={}){return async(r,i)=>{if(!$i(r.toolName,n))return i();try{let n=await i();return e.record(r.toolName,n.isError!==!0),await ea(e,t,r.toolName),n}catch(n){throw e.record(r.toolName,!1),await ea(e,t,r.toolName),n}}}function $i(e,t){return t.trackedTools&&!t.trackedTools.has(e)?!1:!(t.ignoredTools??Gi).has(e)}async function ea(e,t,n){let r=e.drainNewProcedures();if(r.length===0)return;let i=[];for(let e of r)try{await Xi(t.stateStore,t.curatedStore,e)}catch(t){i.push(e),Hi.warn(`Failed to store procedural memory`,{toolName:n,sequence:e.steps.join(` -> `),error:t instanceof Error?t.message:String(t)})}i.length>0&&e.requeueProcedures(i)}const ta=F(`tool-pipeline`);function na(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function ra(e,t){return e.tools?(Array.isArray(e.tools)?e.tools:[e.tools]).includes(t):!0}function ia(e){return e.middleware.critical===!0}var aa=class{entries=[];use(e,t){this.entries.push({middleware:e,order:t?.order??100,tools:t?.tools,name:t?.name??e.name??`anonymous`})}useFor(e,t,n){this.use(t,{order:n?.order,tools:e,name:n?.name})}wrap(e,t,n,r){let i=this.entries.filter(t=>ra(t,e)).sort((e,t)=>e.order-t.order);return async(a,o)=>{let s={toolName:e,args:na(a)?a:{},requestId:T(),meta:r,extra:o,toolConfig:n},c=async n=>{let r=i[n];if(!r)return await t(s.args,o);let a=!1,l=!1,u,d=async()=>{a=!0;let e=await c(n+1);return l=!0,u=e,e};try{return await r.middleware(s,d)}catch(t){if(ia(r))throw t;if(ta.warn(`Middleware failed for tool`,{middleware:r.name,tool:e,error:String(t)}),a){if(l&&u)return u;throw t}return c(n+1)}};return c(0)}}getMiddlewareNames(){return this.entries.map(e=>e.name)}};const oa=F(`auto-gc`);let sa=`warming`,ca=null,la=0;function ua(){let e=[...xa()];if(e.length<10)return 0;e.sort((e,t)=>e-t);let t=Math.floor(e.length*.95);return e[Math.min(t,e.length-1)]}function da(e){let t=ua();if(t===0){sa=`warming`;return}if(t>500){sa=`degraded`;let n=Date.now();if(ca&&n-ca<36e5){oa.debug(`GC cooldown active — skipping`,{lastGcAgoMs:n-ca});return}ca=n,la++,oa.warn(`p95 latency exceeds threshold, triggering GC`,{p95:t,cycle:la}),e&&e().catch(e=>oa.error(`GC callback failed`,{err:String(e)}))}else t<200&&(sa=`healthy`)}function fa(){return{state:sa,p95:ua(),lastGcAt:ca,gcCount:la,bufferSize:xa().length}}const pa=/key|token|secret|auth|password|bearer/i,ma=new Set([`eval`,`env`]);function ha(e){if(typeof e==`string`)return/^(Bearer |sk-|ghp_|glpat-|ghu_|ghs_|github_pat_)/i.test(e)?`[REDACTED]`:e;if(Array.isArray(e))return e.map(ha);if(e&&typeof e==`object`){let t={};for(let[n,r]of Object.entries(e))/(?:token|secret|password|passphrase|key|auth|credential|api.?key)/i.test(n)?t[n]=`[REDACTED]`:t[n]=ha(r);return t}return e}function ga(e,t){if(ma.has(e))return JSON.stringify({_redacted:!0,tool:e});let n=ha(t);if(e===`http`&&n.headers&&typeof n.headers==`object`){let e={};for(let[t,r]of Object.entries(n.headers))e[t]=pa.test(t)?`[REDACTED]`:r;return n.headers=e,JSON.stringify(n).slice(0,2e3)}return JSON.stringify(n).slice(0,2e3)}const _a=new Map,va=[];function ya(e,t,n,r,i){let a=_a.get(e);a||(a={callCount:0,totalDurationMs:0,totalInputChars:0,totalOutputChars:0,errorCount:0},_a.set(e,a)),a.callCount++,a.totalDurationMs+=t,a.totalInputChars+=n,a.totalOutputChars+=r,i&&a.errorCount++,va.push(t),va.length>100&&va.shift(),va.length>=10&&va.length%20==0&&da()}function ba(){return Array.from(_a.entries()).map(([e,t])=>({tool:e,...t}))}function xa(){return va}function Sa(){return async(e,t)=>{let n=Date.now(),r=JSON.stringify(e.args??{}).length;try{let i=await t(),a=Date.now()-n,o=JSON.stringify(i);return zt({ts:new Date().toISOString(),source:`mcp`,tool:e.toolName,input:ga(e.toolName,e.args),durationMs:a,status:`ok`,output:o,traceId:e.requestId,outputChars:o.length}),ya(e.toolName,a,r,o.length,!1),i}catch(t){let i=Date.now()-n;throw zt({ts:new Date().toISOString(),source:`mcp`,tool:e.toolName,input:ga(e.toolName,e.args),durationMs:i,status:`error`,output:t instanceof Error?t.message:String(t),traceId:e.requestId,outputChars:0}),ya(e.toolName,i,r,0,!0),t}}}function Ca(e,t){e.registerResource(`aikit-curated-index`,`aikit://curated`,{description:`Index of all curated knowledge entries`,mimeType:`text/markdown`},async()=>{let e=(await t.list()).map(e=>`- [${e.title}](aikit://curated/${e.path}) — ${e.category}`);return{contents:[{uri:`aikit://curated`,text:`# Curated Knowledge Index\n\n${e.length>0?e.join(`
|
|
22
|
+
`):`_No curated entries yet._`}`,mimeType:`text/markdown`}]}});let n=new wn(`aikit://curated/{+path}`,{list:async()=>({resources:(await t.list()).map(e=>({uri:`aikit://curated/${e.path}`,name:e.title,description:`[${e.category}] ${e.contentPreview?.slice(0,80)??``}`,mimeType:`text/markdown`}))})});e.registerResource(`aikit-curated-entry`,n,{description:`A curated knowledge entry`,mimeType:`text/markdown`},async(e,n)=>{let r=n.path;if(!r)throw Error(`Missing path variable in curated resource URI`);let i=await t.read(r);return{contents:[{uri:e.toString(),text:`---\ntitle: ${i.title}\ncategory: ${i.category}\ntags: ${i.tags?.join(`, `)??``}\nversion: ${i.version??1}\n---\n\n${i.content??i.contentPreview??``}`,mimeType:`text/markdown`}]}})}const wa=`aikit://schemas/channel-surface`,Ta=new URL(`../../../blocks-core/schemas/channel-surface.schema.json`,import.meta.url);let Ea;function Da(){return Ea??=mn(Ta,`utf8`),Ea}function Oa(e,t,n){e.registerResource(`aikit-status`,`aikit://status`,{description:`Current AI Kit status and statistics`,mimeType:`text/plain`},async()=>{let e=await t.getStats();return{contents:[{uri:`aikit://status`,text:`AI Kit: ${e.totalRecords} records from ${e.totalFiles} files. Last indexed: ${e.lastIndexedAt??`Never`}`,mimeType:`text/plain`}]}}),e.registerResource(`aikit-file-tree`,`aikit://file-tree`,{description:`List of all indexed source files`,mimeType:`text/plain`},async()=>({contents:[{uri:`aikit://file-tree`,text:(await t.listSourcePaths()).sort().join(`
|
|
23
|
+
`),mimeType:`text/plain`}]})),e.registerResource(`aikit-channel-surface-schema`,wa,{description:`JSON Schema for the ChannelSurface communication contract`,mimeType:`application/schema+json`},async()=>({contents:[{uri:wa,text:await Da(),mimeType:`application/schema+json`}]})),Ca(e,n)}const ka=[`er_push`,`er_pull`,`er_sync_status`],Aa=[...ka,`er_update_policy`,`er_evolve_review`],ja=new Set(Aa);function Ma(e){return e.toolProfiles}const Na=new Set(`browser.changelog.check.checkpoint.codemod.compact.config.data_transform.delegate.diff_parse.digest.encode.env.eval.evidence_map.file_summary.forge_classify.git_context.graph.guide.health.http.knowledge.lane.measure.onboard.parse_output.present.process.produce_knowledge.queue.regex_test.reindex.rename.replay.restore.schema_validate.session_digest.scope_map.stash.status.stratum_card.signal.test_run.time.watch.web_fetch.web_search.workset`.split(`.`)),Pa=5e3,Fa=new Set(`browser.changelog.check.checkpoint.codemod.data_transform.delegate.diff_parse.encode.env.eval.evidence_map.flow.describe_tool.list_tools.search_tools.forge_classify.git_context.guide.present.health.http.lane.measure.parse_output.process.produce_knowledge.queue.regex_test.rename.replay.restore.schema_validate.session_digest.status.test_run.time.watch.web_fetch.web_search.workset`.split(`.`)),Ia=`analyze.audit.blast_radius.browser.changelog.check.checkpoint.codemod.compact.config.data_transform.dead_symbols.delegate.diff_parse.digest.encode.env.eval.evidence_map.file_summary.find.flow.forge_classify.forge_ground.git_context.graph.guide.health.http.knowledge.lane.describe_tool.list_tools.lookup.measure.onboard.parse_output.present.process.produce_knowledge.queue.regex_test.reindex.rename.replay.restore.schema_validate.scope_map.search.search_tools.signal.session_digest.stash.status.stratum_card.symbol.test_run.time.trace.watch.web_fetch.web_search.workset`.split(`.`),La=F(`structured-content-guard`);function Ra(){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.isError&&n.structuredContent==null&&(n.structuredContent={},La.warn(`Structured content guard activated`,{tool:e.toolName,action:`inject-empty-no-schema`})),n;let i=null;n.structuredContent??(n.structuredContent=za(r),i=`synthesize`);let a=Ba(r,n.structuredContent);return a.action!=null&&(n.structuredContent=a.structuredContent,i=a.action),n.structuredContent||(n.isError=!0,n.structuredContent={},i=`fallback-error`),i!=null&&La.warn(`Structured content guard activated`,{tool:e.toolName,action:i}),n});return e.critical=!0,e}function za(e){try{return Ha(e)??{}}catch{return{}}}function Ba(e,t){let n=e.safeParse;if(typeof n!=`function`)return{structuredContent:t,action:null};try{if(n(t).success)return{structuredContent:t,action:null};let r=za(e);if(Va(r)&&Va(t)){let e={...r,...t};if(n(e).success)return{structuredContent:e,action:`heal`}}return{structuredContent:r,action:`fallback-zero-value`}}catch{return{structuredContent:t,action:null}}}function Va(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Ha(e){if(!e)return{};if(e.anyOf){let t=e.anyOf.find(e=>e.type!==`null`);return t?Ha(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]=Ha(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]=Ha(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{}}}const U={search:{title:`Hybrid Search`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`]},find:{title:`Federated Find`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`]},symbol:{title:`Symbol Resolver — Cross-Module Definitions & References`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`]},trace:{title:`Data Flow Tracer — Cross-Module Call & Import Chains`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`]},scope_map:{title:`Task Scope Map`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`]},lookup:{title:`Chunk Lookup`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`]},dead_symbols:{title:`Dead Symbol Finder`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`]},file_summary:{title:`File Summary`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`search`]},analyze:{title:`Analyze`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`analysis`]},blast_radius:{title:`Blast Radius`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`analysis`,`search`]},knowledge:{title:`Knowledge`,annotations:{readOnlyHint:!1},category:[`knowledge`]},produce_knowledge:{title:`Produce Knowledge`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`knowledge`]},compact:{title:`Semantic Compactor`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`compression`]},digest:{title:`Multi-Source Digest`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`compression`]},stratum_card:{title:`Stratum Card`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`compression`]},forge_ground:{title:`FORGE Ground`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`forge`]},forge_classify:{title:`FORGE Classify`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`forge`]},evidence_map:{title:`Evidence Map`,annotations:{readOnlyHint:!1},category:[`forge`]},present:{title:`Rich Content Presenter`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`presentation`]},check:{title:`Typecheck & Lint`,annotations:{readOnlyHint:!0,openWorldHint:!0},category:[`execution`]},test_run:{title:`Run Tests`,annotations:{readOnlyHint:!0,openWorldHint:!0},category:[`execution`]},eval:{title:`Evaluate Code`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`execution`]},audit:{title:`Project Audit`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`execution`]},browser:{title:`Browser Automation`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`web`]},rename:{title:`Rename Symbol`,annotations:{readOnlyHint:!1,destructiveHint:!0},category:[`manipulation`]},restore:{title:`Restore`,annotations:{readOnlyHint:!1},category:[`manipulation`]},codemod:{title:`Codemod`,annotations:{readOnlyHint:!1,destructiveHint:!0},category:[`manipulation`]},data_transform:{title:`Data Transform`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`manipulation`]},stash:{title:`Stash Values`,annotations:{readOnlyHint:!1},category:[`session`]},signal:{title:`Inter-Agent Signaling`,annotations:{readOnlyHint:!1},category:[`session`]},checkpoint:{title:`Session Checkpoint`,annotations:{readOnlyHint:!1},category:[`session`]},session_digest:{title:`Session Digest`,annotations:{readOnlyHint:!0,idempotentHint:!1},category:[`session`]},workset:{title:`Workset Manager`,annotations:{readOnlyHint:!1},category:[`session`]},lane:{title:`Exploration Lane`,annotations:{readOnlyHint:!1},category:[`session`]},git_context:{title:`Git Context`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`git`]},diff_parse:{title:`Diff Parser`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`git`]},parse_output:{title:`Parse Build Output`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`git`]},process:{title:`Process Manager`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`process`]},watch:{title:`File Watcher`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`process`]},delegate:{title:`Delegate Task`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`process`]},config:{title:`Configuration Manager`,annotations:{readOnlyHint:!1},category:[`system`]},status:{title:`AI Kit Status`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},health:{title:`Health Check`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},reindex:{title:`Reindex`,annotations:{readOnlyHint:!1},category:[`system`]},onboard:{title:`Onboard Codebase`,annotations:{readOnlyHint:!1},category:[`system`]},graph:{title:`Code Knowledge Graph — Module & Symbol Relationships`,annotations:{readOnlyHint:!1},category:[`system`]},guide:{title:`Tool Guide`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},replay:{title:`Replay History`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},list_tools:{title:`List Available Tools`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`meta`]},describe_tool:{title:`Describe Tool`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`meta`]},search_tools:{title:`Search Tools`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`meta`]},changelog:{title:`Generate Changelog`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`]},regex_test:{title:`Regex Tester`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`]},encode:{title:`Encode / Decode`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`]},measure:{title:`Code Metrics`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`]},schema_validate:{title:`Schema Validator`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`]},env:{title:`Environment Info`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`]},time:{title:`Date & Time`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`utilities`]},web_fetch:{title:`Web Fetch`,annotations:{readOnlyHint:!0,openWorldHint:!0},category:[`web`]},web_search:{title:`Web Search`,annotations:{readOnlyHint:!0,openWorldHint:!0},category:[`web`]},http:{title:`HTTP Request`,annotations:{readOnlyHint:!1,openWorldHint:!0},category:[`web`]},queue:{title:`Operation Queue`,annotations:{readOnlyHint:!1},category:[`queue`]},bridge_push:{title:`Bridge Push`,annotations:{readOnlyHint:!1},category:[`system`]},bridge_pull:{title:`Bridge Pull`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},bridge_sync:{title:`Bridge Sync Status`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},er_push:{title:`Enterprise Push`,annotations:{readOnlyHint:!1},category:[`system`]},er_pull:{title:`Enterprise Pull`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},er_sync_status:{title:`Enterprise Sync Status`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},er_update_policy:{title:`Enterprise Update Policy`,annotations:{readOnlyHint:!1},category:[`system`]},er_evolve_review:{title:`Enterprise Evolution Review`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},evolution_state:{title:`Evolution State`,annotations:{readOnlyHint:!1},category:[`system`]},policy_check:{title:`Policy Check`,annotations:{readOnlyHint:!0,idempotentHint:!0},category:[`system`]},flow:{title:`Flow`,annotations:{readOnlyHint:!1},category:[`flow`]}};function W(e){return U[e]??{title:e,annotations:{readOnlyHint:!1},category:[]}}const Ua=Symbol(`toolPipelineState`);function Wa(e){return e[Ua]}function Ga(e,t){e[Ua]=t}function Ka(e,t,n=``){let r=Wa(e);if(r){r.pipeline=t,r.prefix=n;return}Ga(e,{originalRegisterTool:e.registerTool.bind(e),pipeline:t,prefix:n}),e.registerTool=(n,r,i)=>{let a=Wa(e),o=a?.prefix?`${a.prefix}${n}`:n;if(!i)return a?.originalRegisterTool(o,r);if((a?.pipeline??t).getMiddlewareNames().length===0)return a?.originalRegisterTool(o,r,i);let s=W(n),c=(a?.pipeline??t).wrap(n,i,r,s);return a?.originalRegisterTool(o,r,c)}}const qa={analyze:1,audit:1,blast_radius:1,changelog:1,check:2,checkpoint:2,codemod:2,compact:1,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,stratum_card:1,symbol:1,test_run:2,time:0,trace:1,watch:3,web_fetch:1,web_search:1,workset:2};function Ja(e,t){return e.filter(e=>(qa[e]??0)<=t)}const Ya=new Set([`status`,`config`,`guide`,`health`]),Xa={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:[`compact`,`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 Za(e,t){let n=Xa[e];if(n)return n;let r=t?.[e];if(r)return r;throw Error(`Unknown tool profile: ${e}`)}function Qa(e,t,n){return t.includes(`*`)?!0:(n[e]?.category??[]).some(e=>t.includes(e))}function $a(e,t,n,r){if(t.includes(`*`)){for(let t of n)e.add(t);return}for(let i of n)Qa(i,t,r)&&e.add(i)}function eo(e,t,n){if(t.includes(`*`)){e.clear();return}for(let r of[...e])Qa(r,t,n)&&e.delete(r)}function to(e,t,n){if(!e||e.length===0||e.includes(`*`))return new Set(t);let r=new Set;return $a(r,e,t,n),r}function no(e,t){return e===void 0?t:t===void 0?e:Math.min(e,t)}function ro(e,t){for(let n of[...e])t[n]?.annotations?.readOnlyHint===!1&&e.delete(n)}function io(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=Za(e,t);return no(i.extends?io(i.extends,t,n+1,[...r,e]):void 0,i.maxTier)}function ao(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=Za(e,r),c=[...o,e],l=s.extends?i(s.extends,a+1,c):to(s.includeCategories,t,n);s.extends&&s.includeCategories?.length&&$a(l,s.includeCategories,t,n),s.excludeCategories?.length&&eo(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=io(e,r);if(o!==void 0){let e=Ja([...a],o);a.clear();for(let t of e)a.add(t)}for(let e of Ya)a.add(e);return e===`safe`&&ro(a,n),a}const oo=new Set([`search`,`analysis`,`knowledge`,`compression`,`forge`,`presentation`,`execution`,`manipulation`,`session`,`git`,`process`,`system`,`meta`,`utilities`,`web`,`queue`,`flow`]);function so(e,t,n,r){let i=process.env.AIKIT_TOOLSET||e.toolProfile||`full`,a=ao(i,t,n,r);if(e.features&&e.features.length>0){let i=e.features.filter(e=>!oo.has(e));if(i.length>0)throw Error(`Unknown feature group(s): ${i.join(`, `)}. Valid categories: ${[...oo].join(`, `)}`);let o={description:`Synthetic profile from features config`,includeCategories:e.features},s=ao(`_features`,t,n,{...r,_features:o});for(let e of a)!s.has(e)&&!Ya.has(e)&&a.delete(e)}if(e.readOnly)for(let e of[...a])n[e]?.annotations?.readOnlyHint===!1&&!Ya.has(e)&&a.delete(e);for(let e of Ya)a.add(e);return i===`safe`&&ro(a,n),a}const co=L.object({mode:L.enum([`wasm`,`regex`,`unknown`]),reason:L.string(),pathsChecked:L.array(L.object({path:L.string(),exists:L.boolean()})),os:L.string(),arch:L.string(),nodeVersion:L.string(),webTreeSitterImportable:L.boolean(),healAttempted:L.boolean(),healSuccess:L.boolean(),healError:L.string().nullable(),initError:L.string().nullable(),wasmDir:L.string().nullable(),grammarCount:L.number()}),lo=L.object({kind:L.enum([`onboard`,`reindex`,`handoff`,`proceed`]),reason:L.string()}),uo=L.object({totalRecords:L.number(),totalFiles:L.number(),lastIndexedAt:L.string().nullable(),onboarded:L.boolean(),onboardDir:L.string(),contentTypes:L.record(L.string(),L.number()),wasmAvailable:L.boolean(),wasmDiagnostics:co,graphStats:L.object({nodes:L.number(),edges:L.number()}).nullable(),curatedCount:L.number(),serverVersion:L.string(),scaffoldVersion:L.string().nullable(),workspaceScaffoldVersion:L.string().nullable(),upgradeAvailable:L.boolean(),storeBackend:L.string().optional(),storeDiagnostics:L.object({adapterType:L.string(),vectorSearchEnabled:L.boolean(),ftsEnabled:L.boolean(),degradedMode:L.boolean(),dbPath:L.string(),dbSizeBytes:L.number().nullable(),embeddingDim:L.number(),vectorDtype:L.string()}).nullable().optional(),contextPressure:L.number().min(0).max(100).describe(`0–100 score indicating AI Kit saturation`),nextAction:lo});L.object({entries:L.array(L.object({path:L.string(),title:L.string(),category:L.string(),tags:L.array(L.string()),version:L.number(),preview:L.string()})),totalCount:L.number()});const fo=L.object({ok:L.boolean(),checks:L.array(L.object({name:L.string(),ok:L.boolean(),message:L.string().optional()}))}),po=L.object({summary:L.object({totalFiles:L.number(),totalLines:L.number(),totalCodeLines:L.number(),totalFunctions:L.number(),avgComplexity:L.number(),maxComplexity:L.object({value:L.number(),file:L.string()})}),files:L.array(L.object({path:L.string(),lines:L.number(),code:L.number(),complexity:L.number(),functions:L.number()}))}),mo=L.object({platform:L.string(),arch:L.string(),nodeVersion:L.string(),cwd:L.string(),cpus:L.number(),memoryFreeGb:L.number(),memoryTotalGb:L.number()}),ho=L.object({iso:L.string(),unix:L.number(),timezone:L.string(),formatted:L.string()}),go=L.object({passed:L.boolean(),errorCount:L.number(),warningCount:L.number(),topErrors:L.array(L.string())}),_o=L.object({passed:L.boolean(),tsc:go,biome:go}),vo=L.object({name:L.string(),definedIn:L.object({path:L.string(),line:L.number(),kind:L.string(),signature:L.string().optional()}).nullable(),importedBy:L.array(L.object({path:L.string(),line:L.number(),importStatement:L.string()})),referencedIn:L.array(L.object({path:L.string(),line:L.number(),context:L.string(),scope:L.string().optional()})),graphContext:L.object({definingModule:L.string().optional(),importedByModules:L.array(L.string()),siblingSymbols:L.array(L.string())}).nullable()}),yo=L.object({sourcePath:L.string(),contentType:L.string(),score:L.number(),headingPath:L.string().optional(),startLine:L.number().optional(),endLine:L.number().optional(),origin:L.string().optional(),category:L.string().optional(),tags:L.array(L.string()).optional()}),bo=L.object({results:L.array(yo),totalResults:L.number(),searchMode:L.string(),query:L.string()}),xo=L.object({path:L.string(),line:L.number().optional(),matchType:L.string(),preview:L.string()}),So=L.object({matches:L.array(xo),totalMatches:L.number(),pattern:L.string(),truncated:L.boolean()}),Co=L.object({path:L.string(),relevance:L.number(),estimatedTokens:L.number(),focusLines:L.array(L.string()).optional()}),wo=L.object({files:L.array(Co),totalFiles:L.number(),totalEstimatedTokens:L.number(),task:L.string()}),To=L.object({path:L.string(),impact:L.string(),reason:L.string()}),Eo=L.object({changedFiles:L.array(L.string()),affectedFiles:L.array(To),totalAffected:L.number(),riskLevel:L.string()}),Do=L.object({name:L.string(),passed:L.boolean(),message:L.string().optional(),severity:L.string().optional()}),Oo=L.object({passed:L.boolean(),score:L.number(),checks:L.array(Do),summary:L.string()}),ko=L.object({id:L.string(),name:L.string(),type:L.string(),sourcePath:L.string().optional()}),Ao=L.object({fromId:L.string(),toId:L.string(),type:L.string()}),jo=L.object({nodes:L.array(ko),edges:L.array(Ao),totalNodes:L.number(),totalEdges:L.number(),query:L.string()}),Mo=L.object({symbols:L.array(L.object({name:L.string(),path:L.string(),line:L.number().optional(),kind:L.string()})),totalDead:L.number()});L.object({files:L.number(),packages:L.number(),languages:L.record(L.string(),L.number()),tree:L.string()});const No=L.object({path:L.string(),language:L.string(),lines:L.number(),imports:L.number(),exports:L.number(),functions:L.number(),classes:L.number()}),Po=L.object({gitRoot:L.string(),branch:L.string(),commitCount:L.number(),hasUncommitted:L.boolean(),recentCommits:L.array(L.object({hash:L.string(),message:L.string(),author:L.string(),date:L.string()}))}),Fo=L.object({originalChars:L.number(),compressedChars:L.number(),ratio:L.number(),segmentsKept:L.number(),segmentsTotal:L.number()}),Io=L.object({passed:L.boolean(),totalTests:L.number(),passedTests:L.number(),failedTests:L.number(),skippedTests:L.number(),duration:L.number().describe(`Duration in milliseconds`),failures:L.array(L.object({name:L.string(),message:L.string(),file:L.string().optional()}))}),Lo=F(`utils:enrich`);async function G(e,t){let n={curated:[],graph:[]},r=t.limit??3,[i,a]=await Promise.allSettled([Ro(e,t.query,r),zo(e,t.filePath)]);return i.status===`fulfilled`?n.curated=i.value:Lo.debug(`Curated enrichment failed`,{error:i.reason}),a.status===`fulfilled`?n.graph=a.value:Lo.debug(`Graph enrichment failed`,{error:a.reason}),n}async function Ro(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=>Bo(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=>Bo(e.record))}return[]}catch(e){return Lo.debug(`Curated enrichment failed`,{error:e}),[]}}async function zo(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 Lo.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(`
|
|
24
|
+
`)}`}function Bo(e){let t=Vo(e.metadata,`title`)||e.sourcePath||`Untitled`;return`[${Vo(e.metadata,`category`)}] ${t}: ${e.content.slice(0,200)}`}function Vo(e,t){let n=e?.[t];return typeof n==`string`?n:``}function q(e,t){return{content:[{type:`text`,text:`[ERROR:${e}] ${t}`}],isError:!0}}const Ho=F(`tools`),Uo=L.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`);function Wo(e,t){return t?sn(e,t):e}function Go(){let e=[];return Bn.get()||e.push(`Tree-sitter unavailable — using regex fallback, symbol/pattern confidence reduced`),e.length===0?``:`\n\n> **⚠ Caveats:** ${e.join(`; `)}`}function Ko(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 qo(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(`
|
|
25
25
|
|
|
26
26
|
### 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(`
|
|
27
|
-
`)}function
|
|
27
|
+
`)}function Jo(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 Yo(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=Jo(t),r=n.get(e)??[];r.push(t),n.set(e,r)}let r=[`
|
|
28
28
|
|
|
29
29
|
### 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(`
|
|
30
|
-
`)}async function
|
|
31
|
-
`),p.length>20&&(m+=`\n- ... and ${p.length-20} more`))}catch{}let h=
|
|
30
|
+
`)}async function Xo(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 Zo(e,t,n,r,i){try{let a=`produced/analysis/${n}/${C(`sha256`).update(r).digest(`hex`).slice(0,12)}.md`,o=C(`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:C(`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),Ho.info(`Auto-persisted analysis`,{analyzerName:n,chunkCount:l.length})}catch(e){Ho.warn(`Auto-persist analysis failed`,{analyzerName:n,...I(e)})}}const Qo=L.enum([`structure`,`dependencies`,`symbols`,`patterns`,`entry_points`,`diagram`]),$o=L.string().describe(`Root path to analyze`),es=L.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.`),ts=L.object({path:$o,max_depth:L.number().min(1).max(10).default(6).describe(`Maximum directory depth`),format:L.enum([`json`,`markdown`]).default(`markdown`).describe(`Output format`),max_tokens:Uo,enrich:es}),ns=L.object({path:$o,format:L.enum([`json`,`markdown`,`mermaid`]).default(`markdown`).describe(`Output format`),max_tokens:Uo,enrich:es}),rs=L.object({path:$o,filter:L.string().optional().describe(`Filter symbols by name substring`),format:L.enum([`json`,`markdown`]).default(`markdown`).describe(`Output format`),enrich:es}),is=L.object({path:$o,enrich:es}),as=L.object({path:$o,enrich:es}),os=L.object({path:$o,diagram_type:L.enum([`architecture`,`dependencies`]).default(`architecture`).describe(`Type of diagram`),enrich:es}),ss=L.object({aspect:Qo.describe(`Analysis aspect to execute`),path:$o,max_depth:L.number().min(1).max(10).optional(),format:L.enum([`json`,`markdown`,`mermaid`]).optional(),max_tokens:Uo,filter:L.string().optional().describe(`Filter symbols by name substring`),diagram_type:L.enum([`architecture`,`dependencies`]).optional().describe(`Type of diagram when aspect="diagram"`),enrich:es});async function cs(e,t,n,r){return!n||!r?e:e+K(await G(r,{query:t,filePath:t}))}async function ls(e,{store:t,embedder:n,enrichDeps:r}){let i=new Ln,{path:a,max_depth:o,format:s,max_tokens:c,enrich:l}=ts.parse(e),u=await i.analyze(a,{format:s,maxDepth:o,maxTokens:c});Zo(t,n,`structure`,a,u.output);let d=u.data;return{content:[{type:`text`,text:Wo(await cs(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 us(e,{store:t,embedder:n,enrichDeps:r}){let i=new Mn,{path:a,format:o,max_tokens:s,enrich:c}=ns.parse(e),l=await i.analyze(a,{format:o});return Zo(t,n,`dependencies`,a,l.output),{content:[{type:`text`,text:Wo(await cs(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 ds(e,{store:t,embedder:n,enrichDeps:r}){let i=new Rn,{path:a,filter:o,format:s,enrich:c}=rs.parse(e),l=await i.analyze(a,{format:s,filter:o});return Zo(t,n,`symbols`,a,l.output),{content:[{type:`text`,text:await cs(l.output+Go()+'\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 fs(e,{store:t,embedder:n,enrichDeps:r}){let i=new In,{path:a,enrich:o}=is.parse(e),s=await i.analyze(a);return Zo(t,n,`patterns`,a,s.output),{content:[{type:`text`,text:await cs(s.output+Go()+'\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 ps(e,{store:t,embedder:n,enrichDeps:r}){let i=new Pn,{path:a,enrich:o}=as.parse(e),s=await i.analyze(a);return Zo(t,n,`entry-points`,a,s.output),{content:[{type:`text`,text:await cs(s.output+Go()+'\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 ms(e,{store:t,embedder:n,enrichDeps:r}){let i=new Nn,{path:a,diagram_type:o,enrich:s}=os.parse(e),c=await i.analyze(a,{diagramType:o});return Zo(t,n,`diagram`,a,c.output),{content:[{type:`text`,text:await cs(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 hs(e,t,n){switch(e){case`structure`:return ls(t,n);case`dependencies`:return us(t,n);case`symbols`:return ds(t,n);case`patterns`:return fs(t,n);case`entry_points`:return ps(t,n);case`diagram`:return ms(t,n)}}function gs(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:ss.shape,annotations:i.annotations},async e=>{try{let i=ss.parse(e);return await hs(i.aspect,i,{store:t,embedder:n,enrichDeps:r})}catch(e){return Ho.error(`Analysis failed`,I(e)),q(`INTERNAL`,`Analysis failed: ${e instanceof Error?e.message:String(e)}`)}})}function _s(e,t,n,r,i){let a=new jn,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:Eo,inputSchema:{path:L.string().describe(`Root path of the codebase`),files:L.array(L.string()).optional().describe(`Changed file paths (relative to root). If omitted, auto-detects from git status.`),max_depth:L.number().min(1).max(20).default(5).describe(`Maximum transitive dependency depth`),format:L.enum([`json`,`markdown`]).default(`markdown`).describe(`Output format`),max_tokens:Uo,enrich:L.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},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 nt({cwd:e,includeDiff:!1});if(d=Array.from(new Set([...Ko(t.status?.staged),...Ko(t.status?.modified),...Ko(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 Xo(r,d),p.length>0&&(m=`\n\n### Graph-discovered importers (${p.length})\n`+p.slice(0,20).map(e=>`- \`${e}\``).join(`
|
|
31
|
+
`),p.length>20&&(m+=`\n- ... and ${p.length-20} more`))}catch{}let h=Yo(d),g=qo(d),_=f.output+m+h+g+Go()+'\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)}Zo(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:Wo(_,l)}],structuredContent:{changedFiles:d,affectedFiles:v,totalAffected:v.length,riskLevel:y}}}catch(e){return Ho.error(`Blast radius analysis failed`,I(e)),q(`INTERNAL`,`Blast radius analysis failed: ${e instanceof Error?e.message:String(e)}`)}})}const vs=F(`task-manager`);let ys=0;function bs(e){let t=typeof e?.sendNotification==`function`;return{createTask(n,r){let i=`aikit-task-${++ys}`,a=(n,r,a)=>{t&&e.sendNotification?.({method:`notifications/progress`,params:{progressToken:i,progress:n,total:r,...a?{message:a}:{}}}).catch(e=>{vs.debug(`Progress notification failed`,{token:i,error:String(e)})})};return t&&vs.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 xs=F(`tools`);function Ss(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:Oo,inputSchema:{path:L.string().default(`.`).describe(`Root path to audit`),checks:L.array(L.enum([`structure`,`dependencies`,`patterns`,`health`,`dead_symbols`,`check`,`entry_points`])).optional().describe(`Which checks to run (default: all)`),detail:L.enum(pe).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 Ce(t,n,{path:e,checks:i,detail:a??r??`efficient`});return bs(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 xs.error(`Audit failed`,I(e)),q(`INTERNAL`,`Audit failed: ${e instanceof Error?e.message:String(e)}`)}})}const Cs=F(`tools`);function ws(e){if(!e?.enabled)return;let t=process.env.AIKIT_ER_API_KEY;if(!t){Cs.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 Ts(e){let t=ws(e);if(t)try{let e=new Un(t),n=new Hn({maxEntries:t.cacheMaxEntries,defaultTtl:t.cacheTtlMs}),r=new Kn(e);try{let e=new URL(t.baseUrl).hostname;Cs.info(`ER bridge initialized`,{host:e})}catch{Cs.info(`ER bridge initialized`)}return{client:e,cache:n,pushAdapter:r,config:t}}catch(e){Cs.warn(`ER bridge initialization failed`,I(e));return}}function Es(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:L.string().min(3).max(120).describe(`Title for the knowledge entry`),content:L.string().min(10).max(1e5).describe(`Markdown content to push (max 100KB)`),category:L.string().regex(/^[a-z][a-z0-9-]*$/).default(`conventions`).describe(`Category slug (e.g., "decisions", "patterns", "conventions")`),tags:L.array(L.string()).default([]).describe(`Optional tags`),rule_id:L.string().optional().describe(`ID of the classification rule that motivated this push (from remember classification signals). Improves rule effectiveness tracking.`)},annotations:r.annotations},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(Cs.error(`ER push failed`,I(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
|
|
32
32
|
|
|
33
|
-
_The local AI Kit is unaffected. You can retry or check ER health with \`er_sync_status\`._`)}})}function
|
|
33
|
+
_The local AI Kit is unaffected. You can retry or check ER health with \`er_sync_status\`._`)}})}function Ds(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:L.string().min(1).max(2e3).describe(`Search query for Enterprise RAG AI Kit (max 2000 chars)`),max_results:L.number().min(1).max(20).default(5).describe(`Maximum results to return`),bypass_cache:L.boolean().default(!0).describe(`Skip cache and fetch fresh results from ER (default: true per DR-001)`)},annotations:n.annotations},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(`
|
|
34
34
|
|
|
35
35
|
---
|
|
36
36
|
|
|
@@ -38,12 +38,12 @@ _The local AI Kit is unaffected. You can retry or check ER health with \`er_sync
|
|
|
38
38
|
|
|
39
39
|
---
|
|
40
40
|
|
|
41
|
-
`)}\n\n---\n_Source: Enterprise RAG (${i.length} results) | Results cached for ${Math.floor(t.config.cacheTtlMs/36e5)}h_`}]}}catch(e){return
|
|
41
|
+
`)}\n\n---\n_Source: Enterprise RAG (${i.length} results) | Results cached for ${Math.floor(t.config.cacheTtlMs/36e5)}h_`}]}}catch(e){return Cs.error(`ER pull failed`,I(e)),q(`INTERNAL`,`ER pull failed: search request unsuccessful
|
|
42
42
|
|
|
43
|
-
_Enterprise RAG may be unavailable. Local AI Kit search is unaffected._`)}})}function
|
|
43
|
+
_Enterprise RAG may be unavailable. Local AI Kit search is unaffected._`)}})}function Os(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:L.boolean().default(!0).describe(`Whether to ping ER health endpoint (adds latency)`)},annotations:n.annotations},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
|
|
44
44
|
`,`**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(`
|
|
45
|
-
`)}]}}catch(e){return
|
|
46
|
-
`)}function
|
|
45
|
+
`)}]}}catch(e){return Cs.error(`ER sync status failed`,I(e)),q(`INTERNAL`,`ER sync status failed: ${e instanceof Error?e.message:String(e)}`)}})}function J(e){return String(e??``).replace(/&/g,`&`).replace(/</g,`<`).replace(/>/g,`>`).replace(/"/g,`"`)}const ks=L.object({action:L.enum([`view`,`update`]).default(`view`).describe(`Action to perform: view current configuration or update it`),updates:L.record(L.string(),L.unknown()).optional().describe(`Partial configuration to merge when action is "update". Supports nested paths like { "indexing": { "chunkSize": 2000 } }`)}),As=F(`config-tool`),js=`ui://aikit/config.html`,Ms=[`serverName`,`toolPrefix`,`autoIndex`,`sources`,`indexing`,`tokenBudget`];function Ns(){let e=process.env.AIKIT_CONFIG_PATH;if(e&&D(e))return e;let t=P(process.cwd(),`aikit.config.json`);return D(t)?t:``}function Y(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Ps(e,t){let n={...e};for(let[e,r]of Object.entries(t)){let t=n[e];if(Y(t)&&Y(r)){n[e]=Ps(t,r);continue}n[e]=r}return n}function Fs(e){return e===void 0?`undefined`:JSON.stringify(e)}function Is(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(Y(o)&&Y(s)&&Y(c)){i.push(...Is(s,c,o,n));continue}Fs(s)!==Fs(c)&&i.push(`- ${n}: ${Fs(s)} -> ${Fs(c)}`)}return i}function Ls(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(!Y(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`||!pe.includes(r))&&t.push(`tokenBudget must be one of: ${pe.join(`, `)}.`);continue}t.push(`Field "${n}" is not updatable through this tool.`)}return t}function Rs(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.`),!Y(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 zs(e){let t=JSON.parse(k(e,`utf-8`));if(!Y(t))throw Error(`Config file must contain a JSON object.`);return t}function Bs(e,t){return[`AI Kit Configuration`,`Config file: ${t}`,``,JSON.stringify(e,null,2)].join(`
|
|
46
|
+
`)}function Vs(e){return e===void 0?``:Y(e)||Array.isArray(e)?JSON.stringify(e,null,2):String(e)}function Hs(e){let t=e.metrics??[],n={success:`#22c55e`,warning:`#f59e0b`,error:`#ef4444`,info:`#38bdf8`},r={up:`↑`,down:`↓`,neutral:`→`};return`
|
|
47
47
|
<style>
|
|
48
48
|
.db-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(200px,1fr));gap:14px}
|
|
49
49
|
.db-card{padding:14px;border:1px solid var(--aikit-border,#3c3c3c);border-left-width:4px;border-radius:8px;background:var(--aikit-surface,#252526)}
|
|
@@ -60,7 +60,7 @@ _Enterprise RAG may be unavailable. Local AI Kit search is unaffected._`)}})}fun
|
|
|
60
60
|
<div class="db-card" style="border-left-color:${t}">
|
|
61
61
|
<div class="db-label">${J(e.label)}</div>
|
|
62
62
|
${a}
|
|
63
|
-
</div>`}).join(``)}</div>`}function
|
|
63
|
+
</div>`}).join(``)}</div>`}function Us(e){let t=e.fields??[];return`
|
|
64
64
|
<style>
|
|
65
65
|
.fm-container{display:grid;grid-template-columns:1fr 280px;gap:24px}
|
|
66
66
|
@media(max-width:640px){.fm-container{grid-template-columns:1fr}}
|
|
@@ -125,9 +125,9 @@ _Enterprise RAG may be unavailable. Local AI Kit search is unaffected._`)}})}fun
|
|
|
125
125
|
}
|
|
126
126
|
});
|
|
127
127
|
})();
|
|
128
|
-
<\/script>`}function
|
|
129
|
-
`)}`}],ui:{type:`resource`,uri:
|
|
130
|
-
`)}`}],ui:{type:`resource`,uri:
|
|
128
|
+
<\/script>`}function Ws(e){return Hs({metrics:Object.entries(e).map(([e,t])=>({label:e,value:Y(t)||Array.isArray(t)?JSON.stringify(t,null,2):String(t),status:`info`}))})}function Gs(e){return Us({fields:Ms.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:Y(n)||Array.isArray(n)?`textarea`:`text`,value:Vs(n)}})})}function Ks(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 qs(e){let t=``,n=``,r=!1;return function(i,a){t=i,n=a,!r&&(r=!0,Yn(e,`AI Kit Config App`,js,{description:`View and update AI Kit configuration`},async()=>({contents:[{uri:js,mimeType:Jn,text:Ks(t,n)}]})))}}function Js(e,t){let n=W(`config`),r=qs(e);Xn(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:ks,annotations:n.annotations,_meta:{ui:{resourceUri:js}}},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=Ns(),n=e||`(runtime config only; no aikit.config.json found)`;try{let i=e?zs(e):t,a=Bs(i,n);return r(`Configuration`,Ws(i)),{content:[{type:`text`,text:a}],ui:{type:`resource`,uri:js}}}catch(t){return As.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`,Gs(t)),{content:[{type:`text`,text:`No updates provided. Pass an updates object when action is "update".`}],ui:{type:`resource`,uri:js}};let a=Ns();if(!a)return r(`Configuration Form`,Gs(t)),{content:[{type:`text`,text:`No config file found to update.`}],ui:{type:`resource`,uri:js}};let o=Ls(i);if(o.length>0)return r(`Configuration Form`,Gs(zs(a))),{content:[{type:`text`,text:`Configuration update rejected:\n${o.map(e=>`- ${e}`).join(`
|
|
129
|
+
`)}`}],ui:{type:`resource`,uri:js}};try{let e=zs(a),t=Ps(e,i),n=Rs(t);if(n.length>0)return r(`Configuration Form`,Gs(e)),{content:[{type:`text`,text:`Configuration update rejected:\n${n.map(e=>`- ${e}`).join(`
|
|
130
|
+
`)}`}],ui:{type:`resource`,uri:js}};ne(a,JSON.stringify(t,null,2),`utf-8`);let o=Is(e,t,i),s=`Configuration updated successfully.
|
|
131
131
|
|
|
132
132
|
Config file: ${a}
|
|
133
133
|
|
|
@@ -135,23 +135,23 @@ Changed values:
|
|
|
135
135
|
${o.length>0?o.join(`
|
|
136
136
|
`):`- No effective changes; requested values already matched the file.`}
|
|
137
137
|
|
|
138
|
-
These changes take effect on the next server restart.`;return r(`Configuration`,
|
|
139
|
-
`);if(f&&a){let e=await G(a,{query:c,filePath:p});h+=K(e)}return{content:[{type:`text`,text:h}],structuredContent:{originalChars:m.originalChars,compressedChars:m.compressedChars,ratio:m.ratio,segmentsKept:m.segmentsKept,segmentsTotal:m.segmentsTotal}}}catch(e){return
|
|
140
|
-
`)+"\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?sn(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
|
|
138
|
+
These changes take effect on the next server restart.`;return r(`Configuration`,Ws(t)),{content:[{type:`text`,text:s}],ui:{type:`resource`,uri:js}}}catch(e){return As.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`,Ws(t))}const Ys=F(`cross-workspace`);function Xs(e,t){if(!ve())return[];let n=ye();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 Zs(e){let t=new Map;for(let n of e)try{let e=await tr({backend:`sqlite-vec`,path:_e(n.partition)});await e.initialize(),t.set(n.partition,e)}catch(e){Ys.warn(`Failed to open workspace store`,{partition:n.partition,err:e})}return{stores:t,closeAll:async()=>{for(let[,e]of t)try{await e.close()}catch{}}}}async function Qs(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 Ys.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 $s(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 Ys.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 ec(e){return e.toLowerCase().replace(/[-_]/g,``)}function tc(e){let t=M(e),n=ec(re(e));try{let e=A(t);for(let r of e)if(ec(r)===n){let e=P(t,r);if(D(e))return e}}catch{}}function nc(e,t,n){if(ie(e))return D(e)?e:tc(e)||e;let r=P(t,e);if(D(r))return r;let i=tc(r);if(i)return i;if(n)for(let r of n){if(r===t)continue;let n=P(r,e);if(D(n))return n;let i=tc(n);if(i)return i}try{let n=A(t,{withFileTypes:!0});for(let r of n){if(!r.isDirectory()||r.name.startsWith(`.`)||r.name===`node_modules`)continue;let n=P(t,r.name,e);if(D(n))return n;let i=tc(n);if(i)return i}}catch{}return r}const rc=F(`tools:context`);function ic(e,t,n,r){if(!r||!e)return;let i=e.replace(/\\/g,`/`);if(![t,...n??[]].map(e=>e.replace(/\\/g,`/`)).some(e=>{let t=e.endsWith(`/`)?e.slice(0,-1):e;return i===t||i.startsWith(`${t}/`)}))try{r(e)}catch{}}function ac(e,t,n,r,i,a,o){let s=W(`compact`);e.registerTool(`compact`,{title:s.title,description:"Compress text to relevant sections using embedding similarity (no LLM). Provide either `text` or `path` (server reads the file — saves a round-trip). Segments by paragraph/sentence/line.",outputSchema:Fo,inputSchema:{text:L.string().optional().describe(`The text to compress (provide this OR path, not both)`),path:L.string().optional().describe(`File path to read server-side — avoids read_file round-trip + token doubling (provide this OR text)`),query:L.string().describe(`Focus query — what are you trying to understand?`),max_chars:L.number().min(100).max(5e4).default(3e3).describe(`Target output size in characters`),segmentation:L.enum([`paragraph`,`sentence`,`line`]).default(`paragraph`).describe(`How to split the text for scoring`),token_budget:L.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.`),enrich:L.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:s.annotations},async({text:e,path:s,query:c,max_chars:l,segmentation:u,token_budget:d,enrich:f})=>{try{let p=s?nc(s,r,i):void 0;if(!e&&!p)return q(`VALIDATION`,`Either "text" or "path" must be provided.`);let m=await Fe(t,{text:e,path:p,query:c,maxChars:l,tokenBudget:d,segmentation:u,cache:n});ic(p,r,i,o);let h=[`Compressed ${m.originalChars} → ${m.compressedChars} chars (${(m.ratio*100).toFixed(0)}%)`,`Kept ${m.segmentsKept}/${m.segmentsTotal} segments`,``,m.text].join(`
|
|
139
|
+
`);if(f&&a){let e=await G(a,{query:c,filePath:p});h+=K(e)}return{content:[{type:`text`,text:h}],structuredContent:{originalChars:m.originalChars,compressedChars:m.compressedChars,ratio:m.ratio,segmentsKept:m.segmentsKept,segmentsTotal:m.segmentsTotal}}}catch(e){return rc.error(`Compact failed`,I(e)),{...q(`INTERNAL`,`Compact failed: ${e instanceof Error?e.message:String(e)}`),structuredContent:{originalChars:0,compressedChars:0,ratio:0,segmentsKept:0,segmentsTotal:0}}}})}function oc(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:wo,inputSchema:{task:L.string().describe(`Description of the task to scope`),max_files:L.number().min(1).max(50).default(15).describe(`Maximum files to include`),content_type:L.enum(le).optional().describe(`Filter by content type`),max_tokens:L.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),enrich:L.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},async({task:e,max_files:i,content_type:a,max_tokens:o,enrich:s})=>{try{let c=await Kt(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(`
|
|
140
|
+
`)+"\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?sn(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 rc.error(`Scope map failed`,I(e)),q(`INTERNAL`,`Scope map failed: ${e instanceof Error?e.message:String(e)}`)}})}function sc(e,t,n,r,i){let a=W(`find`);e.registerTool(`find`,{title:a.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:So,inputSchema:{query:L.string().optional().describe(`Semantic/keyword search query (required for mode "examples")`),glob:L.string().optional().describe(`File glob pattern (search mode only)`),pattern:L.string().optional().describe(`Regex pattern to match in content (search mode only)`),limit:L.number().min(1).max(50).default(10).describe(`Max results`),content_type:L.enum(le).optional().describe(`Filter by content type`),mode:L.enum([`search`,`examples`]).default(`search`).describe(`Mode: "search" (default) for federated search, "examples" to find usage examples of a symbol/pattern`),max_tokens:L.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),workspaces:L.array(L.string()).optional().describe(`Cross-workspace search: partition names or folder basenames to include. Use ["*"] for all. User-level mode only.`),enrich:L.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:a.annotations},async({query:e,glob:a,pattern:o,limit:s,content_type:c,mode:l,max_tokens:u,workspaces:d,enrich:f})=>{try{if(l===`examples`){if(!e)return q(`VALIDATION`,`"query" is required for mode "examples".`);let r=await Qe(t,n,{query:e,limit:s,contentType:c}),a=JSON.stringify(r);if(f&&i){let t=await G(i,{query:e});a+=K(t)}return{content:[{type:`text`,text:u?sn(a,u):a}]}}let p=await Xe(t,n,{query:e,glob:a,pattern:o,limit:s,contentType:c,cwd:r}),m=``;if(d&&d.length>0&&e){let n=Xs(d,he(process.cwd()));if(n.length>0){let{stores:r,closeAll:i}=await Zs(n);try{let i=await Qs(r,await t.embedQuery(e),{limit:s,contentType:c});for(let e of i)p.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)});p.results.sort((e,t)=>t.score-e.score),p.results=p.results.slice(0,s),p.totalFound=p.results.length,m=` + ${n.length} workspace(s)`}finally{await i()}}}if(p.results.length===0){let t=`No results found.${p.failedStrategies?.length?`\nStrategies attempted: ${p.strategies.join(`, `)}\nFailed: ${p.failedStrategies.map(e=>`${e.strategy} (${e.reason})`).join(`, `)}`:p.strategies.length===0?`
|
|
141
141
|
No search strategies were activated. Provide at least one of: query, glob, or pattern.`:``}`;if(f&&i){let n=await G(i,{query:e});t+=K(n)}return{content:[{type:`text`,text:t}],structuredContent:{matches:[],totalMatches:0,pattern:e??a??o??``,truncated:!1}}}let h=[`Found ${p.totalFound} results via ${p.strategies.join(` + `)}${m}`,``,...p.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(`
|
|
142
|
-
`);if(f&&i){let t=await G(i,{query:e,filePath:p.results[0]?.path});h+=K(t)}return{content:[{type:`text`,text:u?sn(h,u):h}],structuredContent:{matches:p.results.map(e=>({path:e.path,...e.lineRange?{line:e.lineRange.start}:{},matchType:e.source,preview:e.preview?.slice(0,200)??``})),totalMatches:p.totalFound,pattern:e??a??o??``,truncated:p.results.length<p.totalFound}}}catch(e){return
|
|
143
|
-
`)}],structuredContent:{start:o.start,direction:o.direction,depth:o.depth,nodes:o.nodes,graphContext:o.graphContext??null}}}catch(e){return
|
|
144
|
-
`);if(s&&a){let t=await G(a,{query:`dead symbols ${e??c??``}`});d+=K(t)}return{content:[{type:`text`,text:d}],structuredContent:{symbols:[...l.deadInSource,...l.deadInDocs].map(e=>({name:e.name,path:e.path,...e.line===void 0?{}:{line:e.line},kind:e.kind})),totalDead:l.totalDeadSource+l.totalDeadDocs}}}catch(e){return
|
|
145
|
-
`)}function
|
|
146
|
-
`)}function
|
|
142
|
+
`);if(f&&i){let t=await G(i,{query:e,filePath:p.results[0]?.path});h+=K(t)}return{content:[{type:`text`,text:u?sn(h,u):h}],structuredContent:{matches:p.results.map(e=>({path:e.path,...e.lineRange?{line:e.lineRange.start}:{},matchType:e.source,preview:e.preview?.slice(0,200)??``})),totalMatches:p.totalFound,pattern:e??a??o??``,truncated:p.results.length<p.totalFound}}}catch(e){return rc.error(`Find failed`,I(e)),q(`INTERNAL`,`Find failed: ${e instanceof Error?e.message:String(e)}`)}})}function cc(e,t,n,r){let i=W(`symbol`);e.registerTool(`symbol`,{title:i.title,description:`Find definition, imports, and references of a named symbol (function, class, type). For tracing data flow across call sites use trace instead.`,inputSchema:{name:L.string().describe(`Symbol name to look up (function, class, type, etc.)`),limit:L.number().min(1).max(50).default(20).describe(`Max results per category`),workspaces:L.array(L.string()).optional().describe(`Cross-workspace search: partition names or folder basenames to include. Use ["*"] for all. User-level mode only.`)},outputSchema:vo,annotations:i.annotations},async({name:e,limit:i,workspaces:a})=>{try{let o=await nn(t,n,{name:e,limit:i,graphStore:r});if(a&&a.length>0){let n=Xs(a,he(process.cwd()));if(n.length>0){let{stores:r,closeAll:a}=await Zs(n);try{for(let[n,a]of r){let r=await nn(t,a,{name:e,limit:i});r.definedIn&&!o.definedIn&&(o.definedIn={...r.definedIn,path:`[${n}] ${r.definedIn.path}`});for(let e of r.referencedIn)o.referencedIn.push({...e,path:`[${n}] ${e.path}`});if(r.importedBy){o.importedBy=o.importedBy??[];for(let e of r.importedBy)o.importedBy.push({...e,path:`[${n}] ${e.path}`})}}}finally{await a()}}}let s={name:o.name,definedIn:o.definedIn??null,importedBy:o.importedBy??[],referencedIn:o.referencedIn??[],graphContext:o.graphContext??null};return{content:[{type:`text`,text:fc(o)}],structuredContent:s}}catch(e){return rc.error(`Symbol lookup failed`,I(e)),q(`INTERNAL`,`Symbol lookup failed: ${e instanceof Error?e.message:String(e)}`)}})}function lc(e,t,n,r,i,a){let o=new Ln,s=W(`file_summary`);e.registerTool(`file_summary`,{title:s.title,description:`Create a concise structural summary of a source file: imports, exports, functions, classes, interfaces, and types.`,outputSchema:No,inputSchema:{path:L.string().describe(`Absolute path to the file to summarize`),max_tokens:L.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response.`),enrich:L.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:s.annotations},async({path:e,max_tokens:s,enrich:c})=>{try{let l=nc(e,n,r);if((await _n(l)).isDirectory()){let t=await o.analyze(l,{format:`markdown`,maxDepth:3,maxTokens:s});ic(l,n,r,a);let u=t.data.stats?.languages??{},d=Object.entries(u).sort((e,t)=>t[1]-e[1])[0]?.[0],f=`📁 **Directory**: \`${e}\`\n\n${t.output}\n\n---\n_Path is a directory. Showing structure analysis. Use \`analyze({ aspect: "structure", ... })\` for deeper analysis with custom depth._`;if(c&&i){let t=await G(i,{query:e,filePath:l});f+=K(t)}return{content:[{type:`text`,text:s?sn(f,s):f}],structuredContent:{path:l,language:d??`directory`,lines:0,imports:0,exports:0,functions:0,classes:0}}}let u=await Ye({path:l,content:(await t.get(l)).content});ic(l,n,r,a);let d=pc(u);if(c&&i){let t=await G(i,{query:e,filePath:l});d+=K(t)}return{content:[{type:`text`,text:d}],structuredContent:{path:u.path,language:u.language,lines:u.lines,imports:u.imports?.length??0,exports:u.exports?.length??0,functions:u.functions?.length??0,classes:u.classes?.length??0}}}catch(e){return rc.error(`File summary failed`,I(e)),q(`INTERNAL`,`File summary failed: ${e instanceof Error?e.message:String(e)}`)}})}function uc(e,t,n,r){let i=W(`trace`);e.registerTool(`trace`,{title:i.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:{start:L.string().describe(`Starting point — symbol name or file:line reference`),direction:L.enum([`forward`,`backward`,`both`]).describe(`Which direction to trace relationships`),max_depth:L.number().min(1).max(10).default(3).optional().describe(`Maximum trace depth`)},annotations:i.annotations},async({start:e,direction:i,max_depth:a})=>{try{let o=await on(t,n,{start:e,direction:i,maxDepth:a,graphStore:r}),s=[`## Trace: ${o.start}`,`Direction: ${o.direction} | Depth: ${o.depth}`,``];if(o.graphContext&&(s.push(`### Graph Context`),o.graphContext.definingModule&&s.push(`- Module: ${o.graphContext.definingModule}`),o.graphContext.community&&s.push(`- Community: ${o.graphContext.community}`),o.graphContext.importedByModules.length>0&&s.push(`- Imported by modules: ${o.graphContext.importedByModules.join(`, `)}`),o.graphContext.siblingSymbols.length>0&&s.push(`- Sibling symbols: ${o.graphContext.siblingSymbols.join(`, `)}`),s.push(``)),o.nodes.length===0)s.push(`No connections found.`);else{let e=o.nodes.filter(e=>e.relationship===`calls`),t=o.nodes.filter(e=>e.relationship===`called-by`),n=o.nodes.filter(e=>e.relationship===`imports`),r=o.nodes.filter(e=>e.relationship===`imported-by`),i=o.nodes.filter(e=>e.relationship===`references`);if(e.length>0){s.push(`### Calls (${e.length})`);for(let t of e){let e=t.scope?` (from ${t.scope}())`:``;s.push(`- ${t.symbol}() — ${t.path}:${t.line}${e}`)}s.push(``)}if(t.length>0){s.push(`### Called by (${t.length})`);for(let e of t){let t=e.scope?` in ${e.scope}()`:``;s.push(`- ${e.symbol}()${t} — ${e.path}:${e.line}`)}s.push(``)}if(n.length>0){s.push(`### Imports (${n.length})`);for(let e of n)s.push(`- ${e.symbol} — ${e.path}:${e.line}`);s.push(``)}if(r.length>0){s.push(`### Imported by (${r.length})`);for(let e of r)s.push(`- ${e.path}:${e.line}`);s.push(``)}if(i.length>0){s.push(`### References (${i.length})`);for(let e of i)s.push(`- ${e.path}:${e.line}`);s.push(``)}}return s.push(`---`,"_Next: `symbol` for definition details | `compact` to read a referenced file | `blast_radius` for impact analysis_"),{content:[{type:`text`,text:s.join(`
|
|
143
|
+
`)}],structuredContent:{start:o.start,direction:o.direction,depth:o.depth,nodes:o.nodes,graphContext:o.graphContext??null}}}catch(e){return rc.error(`Trace failed`,I(e)),q(`INTERNAL`,`Trace failed: ${e instanceof Error?e.message:String(e)}`)}})}function dc(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:Mo,inputSchema:{path:L.string().optional().describe(`Root path to scope the search (default: cwd)`),limit:L.number().min(1).max(500).default(100).optional().describe(`Maximum exported symbols to scan`),enrich:L.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},async({path:e,limit:o,enrich:s})=>{try{let c=e&&r?nc(e,r,i):e,l=await Ze(t,n,{rootPath:c,limit:o}),u=[`## Dead Symbol Analysis`,``,`**Exports scanned:** ${l.totalExports}`,`**Dead in source:** ${l.totalDeadSource} (actionable)`,`**Dead in docs:** ${l.totalDeadDocs} (informational — code samples in .md files)`,``];if(l.deadInSource.length>0){u.push(`### Dead in Source (actionable)`);for(let e of l.deadInSource)u.push(`- \`${e.name}\` (${e.kind}) — ${e.path}:${e.line}`);u.push(``)}if(l.deadInDocs.length>0){u.push(`### Dead in Docs (informational)`),u.push(`_${l.totalDeadDocs} symbol(s) found only in documentation code samples — not actionable dead code._`);for(let e of l.deadInDocs.slice(0,5))u.push(`- \`${e.name}\` — ${e.path}:${e.line}`);l.deadInDocs.length>5&&u.push(`- _... ${l.deadInDocs.length-5} more omitted_`)}l.totalDeadSource>0?u.push(``,`---`,`_Next: \`codemod\` to remove ${l.totalDeadSource} unused exports | \`symbol\` to verify usage before removing_`):u.push(``,`---`,"_Next: `check` — no dead symbols found, validate types and lint_");let d=u.join(`
|
|
144
|
+
`);if(s&&a){let t=await G(a,{query:`dead symbols ${e??c??``}`});d+=K(t)}return{content:[{type:`text`,text:d}],structuredContent:{symbols:[...l.deadInSource,...l.deadInDocs].map(e=>({name:e.name,path:e.path,...e.line===void 0?{}:{line:e.line},kind:e.kind})),totalDead:l.totalDeadSource+l.totalDeadDocs}}}catch(e){return rc.error(`Dead symbol scan failed`,I(e)),q(`INTERNAL`,`Dead symbol scan failed: ${e instanceof Error?e.message:String(e)}`)}})}function fc(e){let t=[`Symbol: ${e.name}`];if(e.definedIn){let n=`Defined in: ${e.definedIn.path}:${e.definedIn.line} (${e.definedIn.kind})`;e.definedIn.signature&&(n+=`\nSignature: ${e.definedIn.signature}`),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(`, `)}`)}return t.join(`
|
|
145
|
+
`)}function pc(e){let t=[e.path,`Language: ${e.language}`,`Lines: ${e.lines}`,`Estimated tokens: ~${e.estimatedTokens}`,``,`Imports (${e.imports.length}):`,...mc(e.imports),``,`Exports (${e.exports.length}):`,...mc(e.exports),``,`Functions (${e.functions.length}):`,...mc(e.functions.map(e=>`${e.name} @ line ${e.line}${e.exported?` [exported]`:``}${`signature`in e&&e.signature?` — ${e.signature}`:``}`)),``,`Classes (${e.classes.length}):`,...mc(e.classes.map(e=>`${e.name} @ line ${e.line}${e.exported?` [exported]`:``}${e.signature?` — ${e.signature}`:``}`)),``,`Interfaces (${e.interfaces.length}):`,...mc(e.interfaces.map(e=>`${e.name} @ line ${e.line}${`exported`in e&&e.exported?` [exported]`:``}`)),``,`Types (${e.types.length}):`,...mc(e.types.map(e=>`${e.name} @ line ${e.line}${`exported`in e&&e.exported?` [exported]`:``}`))];if(`importDetails`in e&&e.importDetails&&e.importDetails.length>0){let n=e.importDetails.filter(e=>e.isExternal).length,r=e.importDetails.length-n;t.push(``,`Import breakdown: ${n} external, ${r} internal`)}if(`callEdges`in e&&e.callEdges&&e.callEdges.length>0){t.push(``,`Call edges (${e.callEdges.length} intra-file):`);for(let n of e.callEdges.slice(0,30))t.push(` - ${n.caller}() → ${n.callee}() @ line ${n.line}`);e.callEdges.length>30&&t.push(` - ... ${e.callEdges.length-30} more`)}return t.join(`
|
|
146
|
+
`)}function mc(e){return e.length===0?[` none`]:e.map(e=>` - ${e}`)}const hc=F(`tools`);function gc(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:L.boolean().default(!0).describe(`Include detailed breakdowns (top missed queries, rule stats)`),reset_after:L.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
|
|
147
147
|
`,`**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(`
|
|
148
|
-
**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&&(
|
|
148
|
+
**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&&(hc.info(`Evolution metrics reset requested`,{requestedAt:new Date().toISOString(),clearedEvents:r.period.totalEvents}),t.reset(),i.push(`
|
|
149
149
|
_Metrics have been reset._`)),{content:[{type:`text`,text:i.join(`
|
|
150
|
-
`)}]}}catch(e){return
|
|
151
|
-
`);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
|
|
152
|
-
`).replace(/\\t/g,` `),t);return{content:[{type:`text`,text:JSON.stringify(n)}]}}catch(e){return
|
|
153
|
-
`)}const
|
|
154
|
-
`);if(e&&typeof e==`object`&&`type`in e){let t=e;if(t.type===`text`&&typeof t.text==`string`)return t.text}return JSON.stringify(e)}function
|
|
150
|
+
`)}]}}catch(e){return hc.error(`Evolution review failed`,I(e)),q(`INTERNAL`,`Evolution review failed: unable to compute metrics`)}})}const _c=F(`tools:execution`);function vc(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:L.array(L.string()).optional().describe(`Specific files to check (if omitted, checks all)`),cwd:L.string().optional().describe(`Working directory`),skip_types:L.boolean().default(!1).describe(`Skip TypeScript typecheck`),skip_lint:L.boolean().default(!1).describe(`Skip Biome lint`),detail:L.enum(pe).optional().describe(`Output detail level: efficient (default, ~300 tokens — pass/fail + counts + top errors), normal (parsed error objects), full (includes raw terminal output)`),enrich:L.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:_o,annotations:r.annotations},async({files:e,cwd:r,skip_types:i,skip_lint:a,detail:o,enrich:s},c)=>{try{let l=o??n??`efficient`,u=await Ee({files:e,cwd:r,skipTypes:i,skipLint:a,detail:l===`efficient`?`normal`:l}),d=bs(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=tn(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(`
|
|
151
|
+
`);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 _c.error(`Check failed`,I(e)),q(`INTERNAL`,`Check failed: ${e instanceof Error?e.message:String(e)}`)}})}function yc(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:L.string().max(1e5).describe(`Code snippet to execute`),lang:L.enum([`js`,`ts`]).default(`js`).optional().describe(`Language mode: js executes directly, ts strips common type syntax first`),timeout:L.number().min(1).max(6e4).default(5e3).optional().describe(`Execution timeout in milliseconds`)},annotations:t.annotations},async({code:e,lang:t,timeout:n})=>{try{let r=qe({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 _c.error(`Eval failed`,I(e)),q(`INTERNAL`,`Eval failed: ${e instanceof Error?e.message:String(e)}`)}})}function bc(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:L.array(L.string()).optional().describe(`Specific test files or patterns to run`),grep:L.string().optional().describe(`Only run tests whose names match this pattern`),cwd:L.string().optional().describe(`Working directory for the test run`),enrich:L.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:Io},async({files:e,grep:n,cwd:r,enrich:i},a)=>{try{let o=await rn({files:e,grep:n,cwd:r}),s=bs(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=Cc(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 _c.error(`Test run failed`,I(e)),q(`INTERNAL`,`Test run failed: ${e instanceof Error?e.message:String(e)}`)}})}function xc(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:L.string().max(5e5).describe(`Raw output text from a build tool`),tool:L.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=yt(e.replace(/\\n/g,`
|
|
152
|
+
`).replace(/\\t/g,` `),t);return{content:[{type:`text`,text:JSON.stringify(n)}]}}catch(e){return _c.error(`Parse failed`,I(e)),q(`INTERNAL`,`Parse failed: ${e instanceof Error?e.message:String(e)}`)}})}function Sc(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:L.string().max(2e5).describe(`The task or question to send to the local model`),model:L.string().optional().describe(`Ollama model name (default: first available model)`),system:L.string().optional().describe(`System prompt for the model`),context:L.string().max(5e5).optional().describe(`Context text to include before the prompt (e.g. file contents)`),temperature:L.number().min(0).max(2).default(.3).optional().describe(`Sampling temperature (0=deterministic, default 0.3)`),timeout:L.number().min(1e3).max(6e5).default(12e4).optional().describe(`Timeout in milliseconds (default 120000)`),action:L.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 Be();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{_c.debug(`Sampling failed, falling back to Ollama`)}let c=await ze({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 _c.error(`Delegate failed`,I(e)),q(`INTERNAL`,`Delegate failed: ${e instanceof Error?e.message:String(e)}`)}})}function Cc(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(`
|
|
153
|
+
`)}const wc=F(`sampling`);function Tc(e){if(!e.modelPreferences)return;let t={...e.modelPreferences.costPriority===void 0?{}:{costPriority:e.modelPreferences.costPriority},...e.modelPreferences.speedPriority===void 0?{}:{speedPriority:e.modelPreferences.speedPriority},...e.modelPreferences.intelligencePriority===void 0?{}:{intelligencePriority:e.modelPreferences.intelligencePriority}};return Object.keys(t).length>0?t:void 0}function Ec(e){if(Array.isArray(e))return e.map(e=>Ec(e)).filter(e=>e.length>0).join(`
|
|
154
|
+
`);if(e&&typeof e==`object`&&`type`in e){let t=e;if(t.type===`text`&&typeof t.text==`string`)return t.text}return JSON.stringify(e)}function Dc(e){let t=e.server,n=typeof t?.createMessage==`function`;return{get available(){return n},async createMessage(e){if(!n)throw Error(`Sampling not available: client does not support createMessage`);let r=e.context?`${e.context}\n\n---\n\n${e.prompt}`:e.prompt;try{let n=await t.createMessage({messages:[{role:`user`,content:{type:`text`,text:r}}],systemPrompt:e.systemPrompt,modelPreferences:Tc(e),maxTokens:e.maxTokens??4e3});return{text:Ec(n.content),model:n.model,stopReason:n.stopReason}}catch(e){throw wc.warn(`Sampling createMessage failed`,{error:String(e)}),e}}}}const Oc=[],kc=[`_docs-sync`],Ac=new Map([[`_docs-sync`,`Synchronize project documentation — update docs/ folder based on changes made during the flow.`]]);function jc(e){function t(t,n,r){let i=n?.installPath?re(n.installPath):t.replaceAll(`:`,`-`),a=P(Sn(),`.copilot`,`flows`,i).replaceAll(`\\`,`/`);if(D(a))return a;let o=P(Sn(),`.claude`,`flows`,i).replaceAll(`\\`,`/`);if(D(o))return o;let s=P(r??e(),`.github`,`flows`,i).replaceAll(`\\`,`/`);return D(s)?s:n?.installPath&&D(n.installPath)?n.installPath.replaceAll(`\\`,`/`):null}function n(e,n,r){let i=t(e.name,e,r);return i?P(i,n).replaceAll(`\\`,`/`):n}function r(t,n){let r=t.replace(/^_/,``),i=n??e(),a=[N(i,`.github`,`flows`,`_epilogue`,`steps`,r,`README.md`),N(i,`.github`,`flows`,`_epilogue`,r,`README.md`)];for(let e of a)if(D(e))return e.replaceAll(`\\`,`/`);return null}function i(e){return[...Oc,...e.manifest.steps.map(e=>e.id),...kc]}function a(e,t,r){let i=t?e.manifest.steps.find(e=>e.id===t)??null:null,a=t?Ac.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=N(xn(`npm root -g`,{encoding:`utf-8`}).trim(),`@fission-ai`,`openspec`);if(D(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=P(e);if(D(N(t,`.claude-plugin`,`plugin.json`)))return{path:t,sourceType:`claude-plugin`};let n=Sn(),r=N(n,`.claude`,`plugins`,e);if(D(N(r,`.claude-plugin`,`plugin.json`)))return{path:r,sourceType:`claude-plugin`};let i=N(n,`.claude`,`plugins`);if(!D(i))return null;for(let t of A(i,{withFileTypes:!0})){if(!t.isDirectory())continue;let n=N(i,t.name,`.claude-plugin`,`plugin.json`);if(D(n))try{if(JSON.parse(k(n,`utf-8`)).name===e)return{path:N(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 Mc(e){function t(){return e.sources?.[0]?.path??process.cwd()}function n(e){let t=[];try{let n=A(e,{withFileTypes:!0});for(let r of n){if(!r.isDirectory()||r.name.startsWith(`.`))continue;let n=N(e,r.name);D(N(n,`.git`))&&t.push(n)}}catch{}return t}function r(){let r=e.allRoots?.length?e.allRoots:[t()],i=new Set(r);for(let e of r)for(let t of n(e))i.add(t);return[...i]}function i(n){let i=n.replaceAll(`\\`,`/`);if(r().map(e=>e.replaceAll(`\\`,`/`)).includes(i))return!0;let a=(e.allRoots?.length?e.allRoots:[t()]).map(e=>e.replaceAll(`\\`,`/`));for(let e of a)if(i.startsWith(`${e}/`)&&D(N(n,`.git`)))return!0;return!1}function a(e){return N(e??t(),`.flows`)}async function o(){let e=r();for(let t of e){let e=a(t);if(D(e))for(let n of A(e,{withFileTypes:!0})){if(!n.isDirectory())continue;let r=N(e,n.name,`meta.json`);if(D(r))try{let e=JSON.parse(k(r,`utf-8`));if(e.status===`active`)return e.primaryRoot?e.primaryRoot:t}catch{}}}return null}async function s(e){return e||(await o()??t())}function c(e,t,n){let r=N(a(t),e,`meta.json`),i=k(r,`utf-8`),o=JSON.parse(i);o.roots=n.map(e=>e.replaceAll(`\\`,`/`)),o.primaryRoot=t.replaceAll(`\\`,`/`);let s=`${r}.tmp`;ne(s,JSON.stringify(o,null,2),`utf-8`),j(s,r)}function l(e,t){let n=N(a(t),e,`meta.json`);if(!D(n))return;let r=k(n,`utf-8`),i=JSON.parse(r),o=i.roots;if(!o||o.length<=1)return;let s=t.replaceAll(`\\`,`/`);for(let t of o){if(t===s)continue;let n=N(t,`.flows`,e);O(n,{recursive:!0});let a=N(n,`meta.json`),o=`${a}.tmp`;ne(o,r,`utf-8`),j(o,a),O(N(n,i.artifactsDir??`.spec`),{recursive:!0})}}return{getWorkspaceRoot:t,getAllRoots:r,getFlowsDir:a,isValidFlowRoot:i,resolveFlowRoot:s,patchMetaRoots:c,syncMetaToRoots:l}}const Nc=F(`flow-tools`);function Pc(e){return Array.isArray(e)?e.filter(e=>typeof e==`string`&&e.trim().length>0):[]}function Fc(e){return{content:[{type:`text`,text:e}]}}function Ic(e){return e instanceof Error?e.message:String(e)}const Lc={before:[],after:[{id:`_docs-sync`,description:`Synchronize project documentation — update docs/ folder based on changes made during the flow.`,position:`after`,skills:[`docs`]}]};function Rc(e,t){let n=Mc(t),r=jc(n.getWorkspaceRoot);function i(){return N(ge(),`flows`,`registry.json`)}function a(){let t=Dc(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.
|
|
155
155
|
|
|
156
156
|
Convert the provided content into a well-structured README.md for a flow step named "${r}".
|
|
157
157
|
|
|
@@ -164,18 +164,18 @@ The output must:
|
|
|
164
164
|
6. Preserve ALL tool restrictions, constraints, and requirements from the source
|
|
165
165
|
7. Be formatted as clean Markdown
|
|
166
166
|
|
|
167
|
-
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){
|
|
167
|
+
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){Nc.debug(`Flow transform sampling failed; using fallback formatting`,{error:Ic(e),sourceFormat:n,stepName:r})}let c=typeof i?.description==`string`&&i.description.trim().length>0?i.description.trim():null,l=Pc(i?.produces),u=Pc(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(`
|
|
168
168
|
`).trimEnd().concat(`
|
|
169
|
-
`)}}async function o(e){let{FlowRegistryManager:r,FlowStateMachine:a,FlowLoader:o,GitInstaller:s}=await import(`../../flows/dist/index.js`),c=N(t.stateDir??``,`flows`,`installed`);return{registry:new r(i()),stateMachine:new a(n.getFlowsDir(e),Ic),loader:new o,installer:new s(c)}}return{server:e,config:t,log:Mc,toTextResponse:Pc,toErrorText:Fc,createFlowTransform:a,getFlows:o,stateDir:t.stateDir??``,...n,...r}}async function Rc(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 mn(c(t,e.instruction,s),`utf-8`);else{let e=l(n,s);if(!e)return null;u=await mn(e,`utf-8`)}let d=N(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 zc(e,t){let{getFlows:n,log:r,resolveEpilogueInstructionPath:i,resolveFlowRoot:a,resolveInstructionPath:o,toErrorText:s,toTextResponse:c}=t,{step:l}=e;try{let e=await a(),{registry:t,stateMachine:r}=await n(e),s=r.getStatus();if(!s.success||!s.data)return c(`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let u=s.data,d=t.get(u.flow);if(!d)return c(`Flow "${u.flow}" not found in registry.`);let f=l??u.currentStep;return c(f?await Rc({entry:d,stepId:f,runDir:u.runDir,slug:u.slug,primaryRoot:u.primaryRoot,roots:u.roots,activeRoot:e,resolveInstructionPath:o,resolveEpilogueInstructionPath:i})||`Step "${f}" not found in flow "${u.flow}".`:`No current step is available for the active flow.`)}catch(e){return r.error(`flow action read failed`,I(e)),e instanceof Error&&`code`in e&&e.code===`ENOENT`?c(`Could not read instruction file: ${e.message}`):c(`Error: ${s(e)}`)}}async function Bc(e,t){let{registry:n,loader:r,installer:i}=await e.getFlows(),a=e.createFlowTransform(),o=P(t.source);if(!D(o))return e.toTextResponse(`Source path no longer exists: ${o}`);let s=`${t.installPath}.updating`,c=`${t.installPath}.backup`;D(s)&&ee(s,{recursive:!0,force:!0}),D(c)&&ee(c,{recursive:!0,force:!0});let l=i.copyLocal(o,re(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{j(t.installPath,c),j(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}`)}ee(c,{recursive:!0,force:!0})}catch(r){return D(s)&&ee(s,{recursive:!0,force:!0}),D(c)&&(D(t.installPath)&&ee(t.installPath,{recursive:!0,force:!0}),j(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 Vc(e,t){let{registry:n,loader:r}=await e.getFlows(),i=e.createFlowTransform();try{xn(`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 Hc(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 Uc(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=P(m);h=e;let t=u||re(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`,I(e)),c(`Error: ${s(e)}`)}}async function Wc(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`,I(e)),a(`Error: ${i(e)}`)}}async function Gc(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`?Bc(s,t):t.sourceType===`npm-global`?Vc(s,t):Hc(s,t)}catch(e){return r.error(`flow action update failed`,I(e)),a(`Error: ${i(e)}`)}}async function Kc(e,t){let{getAllRoots:n,getFlows:r,getStepSequence:i,getWorkspaceRoot:a,isValidFlowRoot:o,log:s,patchMetaRoots:c,resolveCurrentStepInfo:l,stateDir:u,toErrorText:d,toTextResponse:f}=t,{flow:p,topic:m,roots:h}=e;try{if(h&&h.length>0){let e=h.filter(e=>!o(e));if(e.length>0)return f(`Invalid roots — not part of the workspace or a recognized sub-repository: ${e.join(`, `)}. Available roots: ${n().map(e=>e.replaceAll(`\\`,`/`)).join(`, `)}`)}let e=n(),s=e.length>1,d=!h&&s,g=h?.[0]??a(),{registry:_,stateMachine:v}=await r(g),y=_.get(p);if(!y)return f(`Flow "${p}" not found. Use flow({ action: "list" }) to see available flows.`);let b=v.start(y.name,y.manifest,m);if(!b.success||!b.data)return f(`Cannot start: ${b.error}`);let x=b.data;if(h&&h.length>1)try{c(x.slug,g,h),t.syncMetaToRoots(x.slug,g)}catch(e){return v.reset(),f(`Flow created but failed to sync to secondary roots — rolled back. Error: ${e instanceof Error?e.message:String(e)}`)}try{await pn(N(u,`flow-context`,x.slug),{recursive:!0})}catch{}let{instructionPath:S,description:C}=l(y,x.currentStep,g),w=i(y),T=await Rc({entry:y,stepId:x.currentStep,runDir:x.runDir,slug:x.slug,primaryRoot:null,roots:h??null,activeRoot:g,resolveInstructionPath:t.resolveInstructionPath,resolveEpilogueInstructionPath:t.resolveEpilogueInstructionPath}),E={started:!0,flow:x.flow,slug:x.slug,topic:x.topic,runDir:x.runDir,artifactsPath:N(x.runDir,y.manifest.artifacts_dir).replaceAll(`\\`,`/`),currentStep:x.currentStep,currentStepInstruction:S,currentStepDescription:C,currentStepContent:T,phase:x.phase,isEpilogue:x.isEpilogue,totalSteps:w.length,stepSequence:w,artifactsDir:y.manifest.artifacts_dir,roots:h??[g.replaceAll(`\\`,`/`)],_hint:`IMPORTANT: Follow the instructions in currentStepContent to execute this flow step. Do NOT proceed without reading them.`,...d?{multiRootWarning:`No roots specified in multi-root workspace. Flow created at workspace root. Pass roots parameter with target repo for precise placement.`,availableRoots:e.map(e=>e.replaceAll(`\\`,`/`))}:{}};return f(JSON.stringify(E,null,2))}catch(e){return s.error(`flow action start failed`,I(e)),f(`Error: ${d(e)}`)}}async function qc(e){let{config:t,getAllRoots:n,getFlows:r,getStepSequence:i,getWorkspaceRoot:a,log:o,resolveCurrentStepInfo:s,resolveFlowRoot:c,toErrorText:l,toTextResponse:u}=e;try{let o=await c(),{registry:l,stateMachine:d}=await r(o),f=d.getStatus();if(!f.success||!f.data)return u(`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let p=f.data,m=l.get(p.flow),h=m?s(m,p.currentStep,o):null,g=m?i(m):[],_=h?.instructionPath??null,v=m?await Rc({entry:m,stepId:p.currentStep,runDir:p.runDir,slug:p.slug,primaryRoot:p.primaryRoot,roots:p.roots,activeRoot:o,resolveInstructionPath:e.resolveInstructionPath,resolveEpilogueInstructionPath:e.resolveEpilogueInstructionPath}):null,y={flow:p.flow,status:p.status,slug:p.slug,topic:p.topic,runDir:p.runDir,artifactsPath:m?N(p.runDir,m.manifest.artifacts_dir).replaceAll(`\\`,`/`):null,currentStep:p.currentStep,currentStepInstruction:_,instructionPath:_,currentStepDescription:h?.description??null,currentStepContent:v,_hint:p.currentStep?`IMPORTANT: Follow the instructions in currentStepContent to execute this flow step. Do NOT proceed without reading them.`:void 0,phase:p.phase,isEpilogue:p.isEpilogue,completedSteps:p.completedSteps,skippedSteps:p.skippedSteps,artifacts:p.artifacts,startedAt:p.startedAt,updatedAt:p.updatedAt,totalSteps:g.length,progress:m?`${p.completedSteps.length+p.skippedSteps.length}/${g.length}`:`unknown`,workspaceRoot:o.replaceAll(`\\`,`/`),primaryRoot:(p.primaryRoot??o).replaceAll(`\\`,`/`),roots:p.roots??[o.replaceAll(`\\`,`/`)],allRoots:n().map(e=>e.replaceAll(`\\`,`/`)),discoveredRepos:(()=>{let e=(t.allRoots?.length?t.allRoots:[a()]).map(e=>e.replaceAll(`\\`,`/`)),r=n().map(e=>e.replaceAll(`\\`,`/`)).filter(t=>!e.includes(t));return r.length>0?r:void 0})()};return u(JSON.stringify(y,null,2))}catch(e){return o.error(`flow action status failed`,I(e)),u(`Error: ${l(e)}`)}}async function Jc(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 gn(N(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`,I(e)),s(`Error: ${o(e)}`)}}async function Yc(e,t){let{getFlows:n,getStepSequence:r,log:i,resolveCurrentStepInfo:a,resolveFlowRoot:o,syncMetaToRoots:s,toErrorText:c,toTextResponse:l}=t,{action:u}=e;try{let e=await o(),{registry:i,stateMachine:c}=await n(e),d=c.getStatus();if(!d.success||!d.data)return l(`No active flow. Use flow({ action: "start", name: "<flow>" }) first.`);let f=i.get(d.data.flow);if(!f)return l(`Flow "${d.data.flow}" not found in registry.`);let p=c.step(u,f.manifest);if(!p.success||!p.data)return l(`Cannot ${u}: ${p.error}`);s(p.data.slug,e);let m=p.data,{instructionPath:h,description:g}=a(f,m.currentStep,e),_=r(f),v=await Rc({entry:f,stepId:m.currentStep,runDir:m.runDir,slug:m.slug,primaryRoot:m.primaryRoot,roots:m.roots,activeRoot:e,resolveInstructionPath:t.resolveInstructionPath,resolveEpilogueInstructionPath:t.resolveEpilogueInstructionPath}),y={flow:m.flow,status:m.status,action:u,slug:m.slug,topic:m.topic,runDir:m.runDir,artifactsPath:N(m.runDir,f.manifest.artifacts_dir).replaceAll(`\\`,`/`),currentStep:m.currentStep,currentStepInstruction:h,currentStepDescription:g,currentStepContent:v,_hint:m.currentStep?`IMPORTANT: Follow the instructions in currentStepContent to execute this flow step. Do NOT proceed without reading them.`:void 0,phase:m.phase,isEpilogue:m.isEpilogue,completedSteps:m.completedSteps,skippedSteps:m.skippedSteps,totalSteps:_.length,remaining:_.filter(e=>!m.completedSteps.includes(e)&&!m.skippedSteps.includes(e)&&e!==m.currentStep)};return l(JSON.stringify(y,null,2))}catch(e){return i.error(`flow action step failed`,I(e)),l(`Error: ${c(e)}`)}}async function Xc(e){let{config:t,getAllRoots:n,getFlows:r,getWorkspaceRoot:i,log:a,resolveFlowRoot:o,toErrorText:s,toTextResponse:c}=e;try{let{registry:e,stateMachine:a,installer:s}=await r(await o()),l=e.list(),u=a.getStatus(),d={flows:l.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=s.hasUpdates(e.installPath);return{...t,commitSha:e.commitSha,updateAvailable:n.success&&n.data?n.data.hasUpdates:void 0}}return t}),activeFlow:u.success&&u.data?{flow:u.data.flow,status:u.data.status,currentStep:u.data.currentStep,slug:u.data.slug,topic:u.data.topic,runDir:u.data.runDir}:null,allRoots:n().map(e=>e.replaceAll(`\\`,`/`)),discoveredRepos:(()=>{let e=(t.allRoots?.length?t.allRoots:[i()]).map(e=>e.replaceAll(`\\`,`/`)),r=n().map(e=>e.replaceAll(`\\`,`/`)).filter(t=>!e.includes(t));return r.length>0?r:void 0})()};return c(JSON.stringify(d,null,2))}catch(e){return a.error(`flow action list failed`,I(e)),c(`Error: ${s(e)}`)}}async function Zc(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)return s(`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 r.error(`flow action info failed`,I(e)),s(`Error: ${o(e)}`)}}async function Qc(e,t){let{getAllRoots:n,getFlows:r,log:i,toErrorText:a,toTextResponse:o}=t,{flow:s,status:c}=e;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)});return a.length===0?o(`No flow runs found.`):o(JSON.stringify(a,null,2))}catch(e){return i.error(`flow action runs failed`,I(e)),o(`Error: ${a(e)}`)}}function $c(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 el(e,t,n){let r=Lc(e,t),i=W(`flow`);e.registerTool(`flow`,{title:i.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:i.annotations,inputSchema:{action:L.enum([`list`,`info`,`start`,`step`,`status`,`reset`,`read`,`runs`,`add`,`remove`,`update`]).describe(`The flow operation to perform.`),name:L.string().optional().describe(`Flow name — required for info, start, remove, update. Optional override for add.`),topic:L.string().optional().describe(`Human-readable topic for the run (used by start).`),roots:L.array(L.string()).optional().describe(`Workspace roots participating in this flow (used by start).`),advance:L.enum([`next`,`skip`,`redo`]).optional().describe(`Step navigation action — required for step.`),step:L.string().optional().describe(`Step id or name to read (used by read). Defaults to current step.`),source:L.string().optional().describe(`Git URL, local path, or "openspec" shorthand — required for add.`),token:L.string().optional().describe(`Auth token for private repos (used by add).`),filter_flow:L.string().optional().describe(`Filter runs by flow name (used by runs).`),filter_status:L.string().optional().describe(`Filter runs by status: active, completed, abandoned (used by runs).`)}},async e=>{switch(e.action){case`list`:return Xc(r);case`info`:return e.name?Zc({name:e.name},r):r.toTextResponse(`Missing required parameter: name`);case`start`:{if(!e.name)return r.toTextResponse(`Missing required parameter: name (flow to start)`);let t=await Kc({flow:e.name,topic:e.topic,roots:e.roots},r),i=$c(t);return i&&n&&n(i),t}case`step`:return e.advance?Yc({action:e.advance},r):r.toTextResponse(`Missing required parameter: advance (next/skip/redo)`);case`status`:{let e=await qc(r);return n&&n($c(e)),e}case`reset`:{let e=await Jc(r);return n&&n(null),e}case`read`:return zc({step:e.step},r);case`runs`:return Qc({flow:e.filter_flow,status:e.filter_status},r);case`add`:return e.source?Uc({source:e.source,name:e.name,token:e.token},r):r.toTextResponse(`Missing required parameter: source`);case`remove`:return e.name?Wc({name:e.name},r):r.toTextResponse(`Missing required parameter: name`);case`update`:return e.name?Gc({name:e.name},r):r.toTextResponse(`Missing required parameter: name`);default:return r.toTextResponse(`Unknown action: ${e.action}`)}})}const tl=F(`tools`);function nl(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:L.enum([`create`,`add`,`update`,`get`,`gate`,`list`,`delete`]).describe(`Operation to perform`),task_id:L.string().optional().describe(`Task identifier (required for all except list)`),tier:L.enum([`floor`,`standard`,`critical`]).optional().describe(`FORGE tier (required for create)`),claim:L.string().optional().describe(`Critical-path claim text (for add)`),status:L.enum([`V`,`A`,`U`]).optional().describe(`Evidence status: V=Verified, A=Assumed, U=Unresolved`),receipt:L.string().optional().describe(`Evidence receipt: tool→ref for V, reasoning for A, attempts for U`),id:L.number().optional().describe(`Entry ID (for update)`),critical_path:L.boolean().default(!0).describe(`Whether this claim is on the critical path`),unknown_type:L.enum([`contract`,`convention`,`freshness`,`runtime`,`data-flow`,`impact`]).optional().describe(`Typed unknown classification`),safety_gate:L.enum([`provenance`,`commitment`,`coverage`]).optional().describe(`Safety gate tag: provenance (claim→evidence), commitment (user-approved), coverage (nothing dropped)`),retry_count:L.number().default(0).describe(`Retry count for gate evaluation (0 = first attempt)`),max_retries:L.number().int().min(0).optional().describe(`Maximum retries before escalating. Default: 3`),timeout_action:L.enum([`iterate`,`retry`,`manual`,`terminate`]).optional().describe(`Action to take when gate retries are exhausted. Default: manual`),cwd:L.string().optional().describe(`Working directory for evidence map storage (default: server cwd). Use root_path from forge_ground to match.`)},annotations:t.annotations},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 Je({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=Je({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.formattedMap&&n.push(``,e.formattedMap),{content:[{type:`text`,text:n.join(`
|
|
169
|
+
`)}}async function o(e){let{FlowRegistryManager:r,FlowStateMachine:a,FlowLoader:o,GitInstaller:s}=await import(`../../flows/dist/index.js`),c=N(t.stateDir??``,`flows`,`installed`);return{registry:new r(i()),stateMachine:new a(n.getFlowsDir(e),Lc),loader:new o,installer:new s(c)}}return{server:e,config:t,log:Nc,toTextResponse:Fc,toErrorText:Ic,createFlowTransform:a,getFlows:o,stateDir:t.stateDir??``,...n,...r}}async function zc(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 mn(c(t,e.instruction,s),`utf-8`);else{let e=l(n,s);if(!e)return null;u=await mn(e,`utf-8`)}let d=N(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 Bc(e,t){let{getFlows:n,log:r,resolveEpilogueInstructionPath:i,resolveFlowRoot:a,resolveInstructionPath:o,toErrorText:s,toTextResponse:c}=t,{step:l}=e;try{let e=await a(),{registry:t,stateMachine:r}=await n(e),s=r.getStatus();if(!s.success||!s.data)return c(`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let u=s.data,d=t.get(u.flow);if(!d)return c(`Flow "${u.flow}" not found in registry.`);let f=l??u.currentStep;return c(f?await zc({entry:d,stepId:f,runDir:u.runDir,slug:u.slug,primaryRoot:u.primaryRoot,roots:u.roots,activeRoot:e,resolveInstructionPath:o,resolveEpilogueInstructionPath:i})||`Step "${f}" not found in flow "${u.flow}".`:`No current step is available for the active flow.`)}catch(e){return r.error(`flow action read failed`,I(e)),e instanceof Error&&`code`in e&&e.code===`ENOENT`?c(`Could not read instruction file: ${e.message}`):c(`Error: ${s(e)}`)}}async function Vc(e,t){let{registry:n,loader:r,installer:i}=await e.getFlows(),a=e.createFlowTransform(),o=P(t.source);if(!D(o))return e.toTextResponse(`Source path no longer exists: ${o}`);let s=`${t.installPath}.updating`,c=`${t.installPath}.backup`;D(s)&&ee(s,{recursive:!0,force:!0}),D(c)&&ee(c,{recursive:!0,force:!0});let l=i.copyLocal(o,re(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{j(t.installPath,c),j(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}`)}ee(c,{recursive:!0,force:!0})}catch(r){return D(s)&&ee(s,{recursive:!0,force:!0}),D(c)&&(D(t.installPath)&&ee(t.installPath,{recursive:!0,force:!0}),j(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 Hc(e,t){let{registry:n,loader:r}=await e.getFlows(),i=e.createFlowTransform();try{xn(`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 Uc(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 Wc(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=P(m);h=e;let t=u||re(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`,I(e)),c(`Error: ${s(e)}`)}}async function Gc(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`,I(e)),a(`Error: ${i(e)}`)}}async function Kc(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`?Vc(s,t):t.sourceType===`npm-global`?Hc(s,t):Uc(s,t)}catch(e){return r.error(`flow action update failed`,I(e)),a(`Error: ${i(e)}`)}}async function qc(e,t){let{getAllRoots:n,getFlows:r,getStepSequence:i,getWorkspaceRoot:a,isValidFlowRoot:o,log:s,patchMetaRoots:c,resolveCurrentStepInfo:l,stateDir:u,toErrorText:d,toTextResponse:f}=t,{flow:p,topic:m,roots:h}=e;try{if(h&&h.length>0){let e=h.filter(e=>!o(e));if(e.length>0)return f(`Invalid roots — not part of the workspace or a recognized sub-repository: ${e.join(`, `)}. Available roots: ${n().map(e=>e.replaceAll(`\\`,`/`)).join(`, `)}`)}let e=n(),s=e.length>1,d=!h&&s,g=h?.[0]??a(),{registry:_,stateMachine:v}=await r(g),y=_.get(p);if(!y)return f(`Flow "${p}" not found. Use flow({ action: "list" }) to see available flows.`);let b=v.start(y.name,y.manifest,m);if(!b.success||!b.data)return f(`Cannot start: ${b.error}`);let x=b.data;if(h&&h.length>1)try{c(x.slug,g,h),t.syncMetaToRoots(x.slug,g)}catch(e){return v.reset(),f(`Flow created but failed to sync to secondary roots — rolled back. Error: ${e instanceof Error?e.message:String(e)}`)}try{await pn(N(u,`flow-context`,x.slug),{recursive:!0})}catch{}let{instructionPath:S,description:C}=l(y,x.currentStep,g),w=i(y),T=await zc({entry:y,stepId:x.currentStep,runDir:x.runDir,slug:x.slug,primaryRoot:null,roots:h??null,activeRoot:g,resolveInstructionPath:t.resolveInstructionPath,resolveEpilogueInstructionPath:t.resolveEpilogueInstructionPath}),E={started:!0,flow:x.flow,slug:x.slug,topic:x.topic,runDir:x.runDir,artifactsPath:N(x.runDir,y.manifest.artifacts_dir).replaceAll(`\\`,`/`),currentStep:x.currentStep,currentStepInstruction:S,currentStepDescription:C,currentStepContent:T,phase:x.phase,isEpilogue:x.isEpilogue,totalSteps:w.length,stepSequence:w,artifactsDir:y.manifest.artifacts_dir,roots:h??[g.replaceAll(`\\`,`/`)],_hint:`IMPORTANT: Follow the instructions in currentStepContent to execute this flow step. Do NOT proceed without reading them.`,...d?{multiRootWarning:`No roots specified in multi-root workspace. Flow created at workspace root. Pass roots parameter with target repo for precise placement.`,availableRoots:e.map(e=>e.replaceAll(`\\`,`/`))}:{}};return f(JSON.stringify(E,null,2))}catch(e){return s.error(`flow action start failed`,I(e)),f(`Error: ${d(e)}`)}}async function Jc(e){let{config:t,getAllRoots:n,getFlows:r,getStepSequence:i,getWorkspaceRoot:a,log:o,resolveCurrentStepInfo:s,resolveFlowRoot:c,toErrorText:l,toTextResponse:u}=e;try{let o=await c(),{registry:l,stateMachine:d}=await r(o),f=d.getStatus();if(!f.success||!f.data)return u(`No active flow. Use flow({ action: "start", name: "<flow>" }) to begin one, or flow({ action: "list" }) to see available flows.`);let p=f.data,m=l.get(p.flow),h=m?s(m,p.currentStep,o):null,g=m?i(m):[],_=h?.instructionPath??null,v=m?await zc({entry:m,stepId:p.currentStep,runDir:p.runDir,slug:p.slug,primaryRoot:p.primaryRoot,roots:p.roots,activeRoot:o,resolveInstructionPath:e.resolveInstructionPath,resolveEpilogueInstructionPath:e.resolveEpilogueInstructionPath}):null,y={flow:p.flow,status:p.status,slug:p.slug,topic:p.topic,runDir:p.runDir,artifactsPath:m?N(p.runDir,m.manifest.artifacts_dir).replaceAll(`\\`,`/`):null,currentStep:p.currentStep,currentStepInstruction:_,instructionPath:_,currentStepDescription:h?.description??null,currentStepContent:v,_hint:p.currentStep?`IMPORTANT: Follow the instructions in currentStepContent to execute this flow step. Do NOT proceed without reading them.`:void 0,phase:p.phase,isEpilogue:p.isEpilogue,completedSteps:p.completedSteps,skippedSteps:p.skippedSteps,artifacts:p.artifacts,startedAt:p.startedAt,updatedAt:p.updatedAt,totalSteps:g.length,progress:m?`${p.completedSteps.length+p.skippedSteps.length}/${g.length}`:`unknown`,workspaceRoot:o.replaceAll(`\\`,`/`),primaryRoot:(p.primaryRoot??o).replaceAll(`\\`,`/`),roots:p.roots??[o.replaceAll(`\\`,`/`)],allRoots:n().map(e=>e.replaceAll(`\\`,`/`)),discoveredRepos:(()=>{let e=(t.allRoots?.length?t.allRoots:[a()]).map(e=>e.replaceAll(`\\`,`/`)),r=n().map(e=>e.replaceAll(`\\`,`/`)).filter(t=>!e.includes(t));return r.length>0?r:void 0})()};return u(JSON.stringify(y,null,2))}catch(e){return o.error(`flow action status failed`,I(e)),u(`Error: ${l(e)}`)}}async function Yc(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 gn(N(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`,I(e)),s(`Error: ${o(e)}`)}}async function Xc(e,t){let{getFlows:n,getStepSequence:r,log:i,resolveCurrentStepInfo:a,resolveFlowRoot:o,syncMetaToRoots:s,toErrorText:c,toTextResponse:l}=t,{action:u}=e;try{let e=await o(),{registry:i,stateMachine:c}=await n(e),d=c.getStatus();if(!d.success||!d.data)return l(`No active flow. Use flow({ action: "start", name: "<flow>" }) first.`);let f=i.get(d.data.flow);if(!f)return l(`Flow "${d.data.flow}" not found in registry.`);let p=c.step(u,f.manifest);if(!p.success||!p.data)return l(`Cannot ${u}: ${p.error}`);s(p.data.slug,e);let m=p.data,{instructionPath:h,description:g}=a(f,m.currentStep,e),_=r(f),v=await zc({entry:f,stepId:m.currentStep,runDir:m.runDir,slug:m.slug,primaryRoot:m.primaryRoot,roots:m.roots,activeRoot:e,resolveInstructionPath:t.resolveInstructionPath,resolveEpilogueInstructionPath:t.resolveEpilogueInstructionPath}),y={flow:m.flow,status:m.status,action:u,slug:m.slug,topic:m.topic,runDir:m.runDir,artifactsPath:N(m.runDir,f.manifest.artifacts_dir).replaceAll(`\\`,`/`),currentStep:m.currentStep,currentStepInstruction:h,currentStepDescription:g,currentStepContent:v,_hint:m.currentStep?`IMPORTANT: Follow the instructions in currentStepContent to execute this flow step. Do NOT proceed without reading them.`:void 0,phase:m.phase,isEpilogue:m.isEpilogue,completedSteps:m.completedSteps,skippedSteps:m.skippedSteps,totalSteps:_.length,remaining:_.filter(e=>!m.completedSteps.includes(e)&&!m.skippedSteps.includes(e)&&e!==m.currentStep)};return l(JSON.stringify(y,null,2))}catch(e){return i.error(`flow action step failed`,I(e)),l(`Error: ${c(e)}`)}}async function Zc(e){let{config:t,getAllRoots:n,getFlows:r,getWorkspaceRoot:i,log:a,resolveFlowRoot:o,toErrorText:s,toTextResponse:c}=e;try{let{registry:e,stateMachine:a,installer:s}=await r(await o()),l=e.list(),u=a.getStatus(),d={flows:l.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=s.hasUpdates(e.installPath);return{...t,commitSha:e.commitSha,updateAvailable:n.success&&n.data?n.data.hasUpdates:void 0}}return t}),activeFlow:u.success&&u.data?{flow:u.data.flow,status:u.data.status,currentStep:u.data.currentStep,slug:u.data.slug,topic:u.data.topic,runDir:u.data.runDir}:null,allRoots:n().map(e=>e.replaceAll(`\\`,`/`)),discoveredRepos:(()=>{let e=(t.allRoots?.length?t.allRoots:[i()]).map(e=>e.replaceAll(`\\`,`/`)),r=n().map(e=>e.replaceAll(`\\`,`/`)).filter(t=>!e.includes(t));return r.length>0?r:void 0})()};return c(JSON.stringify(d,null,2))}catch(e){return a.error(`flow action list failed`,I(e)),c(`Error: ${s(e)}`)}}async function Qc(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)return s(`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 r.error(`flow action info failed`,I(e)),s(`Error: ${o(e)}`)}}async function $c(e,t){let{getAllRoots:n,getFlows:r,log:i,toErrorText:a,toTextResponse:o}=t,{flow:s,status:c}=e;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)});return a.length===0?o(`No flow runs found.`):o(JSON.stringify(a,null,2))}catch(e){return i.error(`flow action runs failed`,I(e)),o(`Error: ${a(e)}`)}}function el(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 tl(e,t,n){let r=Rc(e,t),i=W(`flow`);e.registerTool(`flow`,{title:i.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:i.annotations,inputSchema:{action:L.enum([`list`,`info`,`start`,`step`,`status`,`reset`,`read`,`runs`,`add`,`remove`,`update`]).describe(`The flow operation to perform.`),name:L.string().optional().describe(`Flow name — required for info, start, remove, update. Optional override for add.`),topic:L.string().optional().describe(`Human-readable topic for the run (used by start).`),roots:L.array(L.string()).optional().describe(`Workspace roots participating in this flow (used by start).`),advance:L.enum([`next`,`skip`,`redo`]).optional().describe(`Step navigation action — required for step.`),step:L.string().optional().describe(`Step id or name to read (used by read). Defaults to current step.`),source:L.string().optional().describe(`Git URL, local path, or "openspec" shorthand — required for add.`),token:L.string().optional().describe(`Auth token for private repos (used by add).`),filter_flow:L.string().optional().describe(`Filter runs by flow name (used by runs).`),filter_status:L.string().optional().describe(`Filter runs by status: active, completed, abandoned (used by runs).`)}},async e=>{switch(e.action){case`list`:return Zc(r);case`info`:return e.name?Qc({name:e.name},r):r.toTextResponse(`Missing required parameter: name`);case`start`:{if(!e.name)return r.toTextResponse(`Missing required parameter: name (flow to start)`);let t=await qc({flow:e.name,topic:e.topic,roots:e.roots},r),i=el(t);return i&&n&&n(i),t}case`step`:return e.advance?Xc({action:e.advance},r):r.toTextResponse(`Missing required parameter: advance (next/skip/redo)`);case`status`:{let e=await Jc(r);return n&&n(el(e)),e}case`reset`:{let e=await Yc(r);return n&&n(null),e}case`read`:return Bc({step:e.step},r);case`runs`:return $c({flow:e.filter_flow,status:e.filter_status},r);case`add`:return e.source?Wc({source:e.source,name:e.name,token:e.token},r):r.toTextResponse(`Missing required parameter: source`);case`remove`:return e.name?Gc({name:e.name},r):r.toTextResponse(`Missing required parameter: name`);case`update`:return e.name?Kc({name:e.name},r):r.toTextResponse(`Missing required parameter: name`);default:return r.toTextResponse(`Unknown action: ${e.action}`)}})}const nl=F(`tools`);function rl(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:L.enum([`create`,`add`,`update`,`get`,`gate`,`list`,`delete`]).describe(`Operation to perform`),task_id:L.string().optional().describe(`Task identifier (required for all except list)`),tier:L.enum([`floor`,`standard`,`critical`]).optional().describe(`FORGE tier (required for create)`),claim:L.string().optional().describe(`Critical-path claim text (for add)`),status:L.enum([`V`,`A`,`U`]).optional().describe(`Evidence status: V=Verified, A=Assumed, U=Unresolved`),receipt:L.string().optional().describe(`Evidence receipt: tool→ref for V, reasoning for A, attempts for U`),id:L.number().optional().describe(`Entry ID (for update)`),critical_path:L.boolean().default(!0).describe(`Whether this claim is on the critical path`),unknown_type:L.enum([`contract`,`convention`,`freshness`,`runtime`,`data-flow`,`impact`]).optional().describe(`Typed unknown classification`),safety_gate:L.enum([`provenance`,`commitment`,`coverage`]).optional().describe(`Safety gate tag: provenance (claim→evidence), commitment (user-approved), coverage (nothing dropped)`),retry_count:L.number().default(0).describe(`Retry count for gate evaluation (0 = first attempt)`),max_retries:L.number().int().min(0).optional().describe(`Maximum retries before escalating. Default: 3`),timeout_action:L.enum([`iterate`,`retry`,`manual`,`terminate`]).optional().describe(`Action to take when gate retries are exhausted. Default: manual`),cwd:L.string().optional().describe(`Working directory for evidence map storage (default: server cwd). Use root_path from forge_ground to match.`)},annotations:t.annotations},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 Je({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=Je({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.formattedMap&&n.push(``,e.formattedMap),{content:[{type:`text`,text:n.join(`
|
|
170
170
|
`)}]}}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=Je({action:`update`,taskId:t,id:o,status:i,receipt:a??``},p),n=[`Updated entry #${o} in "${t}" → ${i}`];return e.formattedMap&&n.push(``,e.formattedMap),{content:[{type:`text`,text:n.join(`
|
|
171
171
|
`)}]}}case`get`:{if(!t)throw Error(`task_id required for get`);let e=Je({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(`
|
|
172
172
|
`)}]}:{content:[{type:`text`,text:`Evidence map "${t}" not found.`}]}}case`gate`:{if(!t)throw Error(`task_id required for gate`);let e=Je({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(`
|
|
173
173
|
`)}]}}case`list`:{let e=Je({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(`
|
|
174
|
-
`)}]}}case`delete`:if(!t)throw Error(`task_id required for delete`);return{content:[{type:`text`,text:Je({action:`delete`,taskId:t},p).deleted?`Deleted evidence map "${t}".`:`Evidence map "${t}" not found.`}]}}}catch(e){return
|
|
175
|
-
`)}]}}catch(e){return
|
|
176
|
-
`)}]}}catch(e){return
|
|
177
|
-
`)}]}}catch(e){return
|
|
178
|
-
`)}]}}catch(e){return
|
|
174
|
+
`)}]}}case`delete`:if(!t)throw Error(`task_id required for delete`);return{content:[{type:`text`,text:Je({action:`delete`,taskId:t},p).deleted?`Deleted evidence map "${t}".`:`Evidence map "${t}" not found.`}]}}}catch(e){return nl.error(`Evidence map error`,I(e)),q(`INTERNAL`,`Evidence map error: ${e instanceof Error?e.message:String(e)}`)}})}function il(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.`,inputSchema:{sources:L.array(L.object({id:L.string().describe(`Source identifier (e.g., "phase-2-handoff")`),text:L.string().max(5e5).describe(`Source text to compress`),weight:L.number().min(0).default(1).describe(`Priority weight (higher = more budget)`)})).min(1).max(20).describe(`Text sources to compress`),query:L.string().describe(`Focus query — what matters for the next step?`),max_chars:L.number().min(100).max(5e4).default(4e3).describe(`Target budget in characters`),pin_fields:L.array(L.string()).optional().describe(`Key fields to always extract (default: status, files, decisions, blockers, next)`),segmentation:L.enum([`paragraph`,`sentence`,`line`]).default(`paragraph`).describe(`How to split text for scoring`),token_budget:L.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 Ue(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)}%)`,``],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)`);return c.push(``,`---`,"_Next: Use the digest as compressed context for the next phase. Use `stash` to persist it if needed._"),{content:[{type:`text`,text:c.join(`
|
|
175
|
+
`)}]}}catch(e){return nl.error(`Digest failed`,I(e)),q(`INTERNAL`,`Digest failed: ${e instanceof Error?e.message:String(e)}`)}})}function al(e){let t=W(`forge_classify`);e.registerTool(`forge_classify`,{title:t.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:L.array(L.string()).min(1).max(100).describe(`Files being modified (paths)`),task:L.string().describe(`Task description`),root_path:L.string().describe(`Root path of the codebase`)},annotations:t.annotations},async({files:e,task:t,root_path:n})=>{try{let r=await $e({files:e,task:t,rootPath:n}),i=[`## FORGE Classification: **${r.tier.toUpperCase()}**`,``];if(r.triggers.length>0){i.push(`### Triggers`);for(let e of r.triggers)i.push(`- **${e.rule}** (${e.source}): ${e.detail}`);i.push(``)}if(r.packagesCrossed.length>0&&i.push(`**Packages crossed:** ${r.packagesCrossed.join(`, `)}`),r.typedUnknownSeeds.length>0){i.push(``,`### Typed Unknown Seeds`);for(let e of r.typedUnknownSeeds)i.push(`- [${e.type}] ${e.description} → use \`${e.suggestedTool}\``)}i.push(``,`### Ceremony`);let a=r.ceremony;return i.push(`- **Ground:** ${a.ground}`,`- **Build:** ${a.build}`,`- **Break:** ${a.break}`,`- **Evidence Map:** ${a.evidenceMap}`,`- **Gate:** ${a.gate}`),i.push(``,`---`,`_Next: ${r.tier===`floor`?`Proceed directly to implementation.`:"Run `forge_ground` to execute the full Ground phase."}_`),{content:[{type:`text`,text:i.join(`
|
|
176
|
+
`)}]}}catch(e){return nl.error(`FORGE classify failed`,I(e)),q(`INTERNAL`,`FORGE classify failed: ${e instanceof Error?e.message:String(e)}`)}})}function ol(e,t,n){let r=W(`stratum_card`);e.registerTool(`stratum_card`,{title:r.title,description:`Generate context cards from files — a compressed alternative to reading full files (10-100x token reduction). Tier 1 (T1): structure only (~100 tokens/file — imports, exports, functions). Tier 2 (T2): structure + query-relevant content (~300 tokens/file).`,inputSchema:{files:L.array(L.string()).min(1).max(50).describe(`Absolute file paths to generate cards for`),query:L.string().describe(`Current task query — guides relevance scoring`),tier:L.enum([`T1`,`T2`]).default(`T1`).describe(`Card tier: T1 = structural only, T2 = T1 + compressed content`),max_content_chars:L.number().min(100).max(5e3).default(800).describe(`For T2: max chars for compressed content section`)},annotations:r.annotations},async({files:e,query:r,tier:i,max_content_chars:a})=>{try{let o=await en(t,{files:e,query:r,tier:i,maxContentChars:a,cache:n}),s=[`## STRATUM Cards (${i}) — ${o.cards.length} files`,`Total: ~${o.totalTokenEstimate} tokens (was ~${o.totalOriginalTokenEstimate}, ${(o.compressionRatio*100).toFixed(0)}% of original)`,``];for(let e of o.cards)s.push(e.card,``);return s.push(`---`,"_Next: Use these cards as context instead of reading full files. Use `compact` for deeper content extraction on specific files._"),{content:[{type:`text`,text:s.join(`
|
|
177
|
+
`)}]}}catch(e){return nl.error(`STRATUM cards failed`,I(e)),q(`INTERNAL`,`STRATUM cards failed: ${e instanceof Error?e.message:String(e)}`)}})}function sl(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:L.string().describe(`Task description`),files:L.array(L.string()).min(1).max(100).describe(`Target files being modified (absolute paths)`),root_path:L.string().describe(`Root path of the codebase`),max_constraints:L.number().min(0).max(10).default(3).describe(`Max constraint entries to load from AI Kit memory`),force_tier:L.enum([`floor`,`standard`,`critical`]).optional().describe(`Force a specific tier (skips auto-classification)`),task_id:L.string().optional().describe(`Custom task ID for evidence map (auto-generated if omitted)`)},annotations:r.annotations},async({task:e,files:r,root_path:i,max_constraints:a,force_tier:o,task_id:s},c)=>{try{let l=await et(t,n,{task:e,files:r,rootPath:i,maxConstraints:a,forceTier:o,taskId:s}),u=bs(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(`
|
|
178
|
+
`)}]}}catch(e){return nl.error(`FORGE Ground failed`,I(e)),q(`INTERNAL`,`FORGE Ground failed: ${e instanceof Error?e.message:String(e)}`)}})}const cl=F(`tools`),ll=L.object({id:L.string().optional().describe(`Node ID (auto-generated if omitted)`),type:L.string().describe(`Node type (entity, service, api, concept, decision)`),name:L.string().describe(`Display name`),properties:L.record(L.string(),L.unknown()).optional().describe(`Arbitrary properties`),sourceRecordId:L.string().optional().describe(`Back-link to knowledge record ID`),sourcePath:L.string().optional().describe(`Source file path`)}),ul=L.object({id:L.string().optional().describe(`Edge ID (auto-generated if omitted)`),fromId:L.string().describe(`Source node ID`),toId:L.string().describe(`Target node ID`),type:L.string().describe(`Relationship type (depends-on, implements, calls, affects)`),weight:L.number().min(0).max(1).optional().describe(`Relationship weight`),properties:L.record(L.string(),L.unknown()).optional().describe(`Arbitrary properties`)});function dl(e,t){let n=W(`graph`);e.registerTool(`graph`,{title:n.title,description:`Query the auto-populated code knowledge graph (modules, symbols, imports) to answer
|
|
179
179
|
structural questions vector search cannot.
|
|
180
180
|
|
|
181
181
|
Common flow (when you don't have a node_id yet — TWO STEPS):
|
|
@@ -194,7 +194,7 @@ Single-step read actions:
|
|
|
194
194
|
Mutating actions (use deliberately): add, delete, clear, set_community,
|
|
195
195
|
detect_communities, trace_process, delete_process.
|
|
196
196
|
|
|
197
|
-
Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_radius\` (change impact).`,outputSchema:
|
|
197
|
+
Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_radius\` (change impact).`,outputSchema:jo,inputSchema:{action:L.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:L.string().optional().describe(`Node type filter (for find_nodes)`),name_pattern:L.string().optional().describe(`Name substring match (for find_nodes)`),source_path:L.string().optional().describe(`Source path filter`),node_id:L.string().optional().describe(`Node ID (for neighbors, traverse, delete)`),edge_type:L.string().optional().describe(`Edge type filter`),from_id:L.string().optional().describe(`Source node ID (for find_edges)`),to_id:L.string().optional().describe(`Target node ID (for find_edges)`),direction:L.enum([`outgoing`,`incoming`,`both`]).default(`both`).describe(`Traversal direction`),max_depth:L.number().min(1).max(5).default(2).describe(`Max traversal depth`),limit:L.number().min(1).max(100).default(50).describe(`Max results`),nodes:L.array(ll).max(500).optional().describe(`Nodes to add (for action=add)`),edges:L.array(ul).max(500).optional().describe(`Edges to add (for action=add)`),community:L.string().optional().describe(`Community label (for set_community, cohesion)`),process_id:L.string().optional().describe(`Process ID (for delete_process)`),label:L.string().optional().describe(`Label for process tracing (for trace_process)`)},annotations:n.annotations},async e=>{try{let n=await it(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}),r=[n.summary];if(n.nodes&&n.nodes.length>0){r.push(`
|
|
198
198
|
### Nodes`);for(let e of n.nodes){let t=Object.keys(e.properties).length>0?` — ${JSON.stringify(e.properties)}`:``;r.push(`- **${e.name}** (${e.type}, id: \`${e.id}\`)${t}`)}}if(n.edges&&n.edges.length>0){r.push(`
|
|
199
199
|
### Edges`);for(let e of n.edges)r.push(`- \`${e.fromId}\` —[${e.type}]→ \`${e.toId}\`${e.weight===1?``:` (weight: ${e.weight})`}`)}if(n.stats&&(r.push(`\nNode types: ${JSON.stringify(n.stats.nodeTypes)}`),r.push(`Edge types: ${JSON.stringify(n.stats.edgeTypes)}`)),n.validation){if(r.push(`
|
|
200
200
|
### Validation`),r.push(`- **Valid**: ${n.validation.valid?`yes`:`no`}`),n.validation.danglingEdges.length>0){r.push(`- **Dangling edges**:`);for(let e of n.validation.danglingEdges)r.push(` - \`${e.edgeId}\` references missing node \`${e.missingNodeId}\``)}n.validation.orphanNodes.length>0&&r.push(`- **Orphan nodes**: ${n.validation.orphanNodes.map(e=>`\`${e}\``).join(`, `)}`)}if(n.communities){r.push(`
|
|
@@ -203,41 +203,41 @@ Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_rad
|
|
|
203
203
|
### Processes`);for(let e of n.processes)r.push(`- **${e.label}** (id: \`${e.id}\`) — ${e.steps.length} step(s)`)}if(n.depthGroups){r.push(`
|
|
204
204
|
### Depth Groups`);for(let[e,t]of Object.entries(n.depthGroups))r.push(`- **Depth ${e}**: ${t.map(e=>`${e.name} (${e.type})`).join(`, `)}`)}if(n.cohesionScore!==void 0&&r.push(`\n**Cohesion Score**: ${(n.cohesionScore*100).toFixed(1)}%`),n.symbol360){let e=n.symbol360;r.push(`
|
|
205
205
|
### 360° Symbol View`),r.push(`- **Node**: ${e.node.name} (${e.node.type})`),r.push(`- **Community**: ${e.community??`none`}`),r.push(`- **Incoming**: ${e.incoming.length} edge(s)`),r.push(`- **Outgoing**: ${e.outgoing.length} edge(s)`),r.push(`- **Processes**: ${e.processes.length}`)}return r.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._"),{content:[{type:`text`,text:r.join(`
|
|
206
|
-
`)}],structuredContent:{nodes:(n.nodes??[]).map(e=>({id:e.id,name:e.name,type:e.type,...e.sourcePath?{sourcePath:e.sourcePath}:{}})),edges:(n.edges??[]).map(e=>({fromId:e.fromId,toId:e.toId,type:e.type})),totalNodes:n.stats?.nodeCount??n.nodes?.length??0,totalEdges:n.stats?.edgeCount??n.edges?.length??0,query:e.action}}}catch(e){return
|
|
207
|
-
`)};if(c.length===1)try{return{content:[{type:`text`,text:await l(c[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)?
|
|
206
|
+
`)}],structuredContent:{nodes:(n.nodes??[]).map(e=>({id:e.id,name:e.name,type:e.type,...e.sourcePath?{sourcePath:e.sourcePath}:{}})),edges:(n.edges??[]).map(e=>({fromId:e.fromId,toId:e.toId,type:e.type})),totalNodes:n.stats?.nodeCount??n.nodes?.length??0,totalEdges:n.stats?.edgeCount??n.edges?.length??0,query:e.action}}}catch(e){return cl.error(`Graph query failed`,I(e)),q(`INTERNAL`,`Graph query failed: ${e instanceof Error?e.message:String(e)}`)}})}const fl=F(`tools:infra`);function pl(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:L.enum([`start`,`stop`,`status`,`list`,`logs`]).describe(`Process action to perform`),id:L.string().optional().describe(`Managed process ID`),command:L.string().optional().describe(`Executable to start`),args:L.array(L.string()).optional().describe(`Arguments for start actions`),tail:L.number().min(1).max(500).optional().describe(`Log lines to return for logs actions`)},annotations:t.annotations},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(St(t,n,r??[]))}]};case`stop`:if(!t)throw Error(`id is required for stop`);return{content:[{type:`text`,text:JSON.stringify(wt(t)??null)}]};case`status`:if(!t)throw Error(`id is required for status`);return{content:[{type:`text`,text:JSON.stringify(Ct(t)??null)}]};case`list`:return{content:[{type:`text`,text:JSON.stringify(bt())}]};case`logs`:if(!t)throw Error(`id is required for logs`);return{content:[{type:`text`,text:JSON.stringify(xt(t,i))}]}}}catch(e){return fl.error(`Process action failed`,I(e)),q(`INTERNAL`,`Process action failed: ${e instanceof Error?e.message:String(e)}`)}})}function ml(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), stop (by ID), list (show active watchers). Events are emitted as structured JSON with path, event type, and timestamp.`,inputSchema:{action:L.enum([`start`,`stop`,`list`]).describe(`Watch action to perform`),path:L.string().optional().describe(`Directory path to watch for start actions`),id:L.string().optional().describe(`Watcher ID for stop actions`)},annotations:t.annotations},async({action:e,path:t,id:n})=>{try{switch(e){case`start`:if(!t)throw Error(`path is required for start`);return{content:[{type:`text`,text:JSON.stringify(ln({path:t}))}]};case`stop`:if(!n)throw Error(`id is required for stop`);return{content:[{type:`text`,text:JSON.stringify({stopped:un(n)})}]};case`list`:return{content:[{type:`text`,text:JSON.stringify(cn())}]}}}catch(e){return fl.error(`Watch action failed`,I(e)),q(`INTERNAL`,`Watch action failed: ${e instanceof Error?e.message:String(e)}`)}})}function hl(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:fo,inputSchema:{path:L.string().optional().describe(`Root directory to check (defaults to cwd)`)},annotations:t.annotations},async({path:e})=>{try{let t=ot(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 fl.error(`Health check failed`,I(e)),q(`INTERNAL`,`Health check failed: ${e instanceof Error?e.message:String(e)}`)}})}function gl(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:L.array(L.string().url()).min(1).max(10).describe('URLs to fetch (1–10). Single URL: `["https://..."]`. Multiple fetched in parallel.'),mode:L.enum([`markdown`,`raw`,`links`,`outline`]).default(`markdown`).describe(`Output mode: markdown (clean content), raw (HTML), links (extracted URLs), outline (heading hierarchy)`),selector:L.string().optional().describe(`CSS selector to extract a specific element instead of auto-detecting main content`),max_length:L.number().min(500).max(1e5).default(15e3).describe(`Max characters in output — truncates at paragraph boundaries`),include_metadata:L.boolean().default(!0).describe(`Include page title, description, and URL as a header`),include_links:L.boolean().default(!1).describe(`Append extracted links list at the end`),include_images:L.boolean().default(!1).describe(`Include image alt texts inline`),timeout:L.number().min(1e3).max(12e4).default(3e4).describe(`Request timeout in milliseconds`)},annotations:t.annotations},async({urls:e,mode:t,selector:n,max_length:r,include_metadata:i,include_links:a,include_images:o,timeout:s})=>{let c=e,l=async(e,c)=>{let l=await dn({url:e,mode:t,selector:n,maxLength:r,includeMetadata:i,includeLinks:a,includeImages:o,timeout:s}),u=[c?`## ${c} ${l.title||`Web Page`}\n> Source: ${e}`:`## ${l.title||`Web Page`}`,``,l.content];return l.truncated&&u.push(``,`_Original length: ${l.originalLength.toLocaleString()} chars_`),u.join(`
|
|
207
|
+
`)};if(c.length===1)try{return{content:[{type:`text`,text:await l(c[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)?fl.warn(`Web fetch failed`,{error:t}):fl.error(`Web fetch failed`,I(e)),{...q(`INTERNAL`,`Web fetch failed: ${t}`)}}let u=c.length,d=await Promise.allSettled(c.map((e,t)=>l(e,`[${t+1}/${u}]`))),f=[],p=0;for(let e=0;e<d.length;e++){let t=d[e];if(t.status===`fulfilled`)f.push(t.value);else{p++;let n=t.reason instanceof Error?t.reason.message:String(t.reason);/HTTP [45]\d{2}/.test(n)?fl.warn(`Web fetch failed`,{url:c[e],error:n}):fl.error(`Web fetch failed`,{url:c[e],...I(t.reason)}),f.push(`## ❌ Failed: ${c[e]}\n\n${n}`)}}let m=`_Fetched ${d.length-p}/${d.length} URLs successfully._`;f.push(``,`---`,m,"_Next: Use `remember` to save key findings, or `web_fetch` with a `selector` to extract a specific section._");let h=f.join(`
|
|
208
208
|
|
|
209
|
-
`);return p===d.length?q(`INTERNAL`,h):{content:[{type:`text`,text:h}]}})}function
|
|
210
|
-
`)}]}}catch(e){return
|
|
211
|
-
`)}`}async function
|
|
212
|
-
`);return{content:[{type:`text`,text:`## Lessons (${y.length})\n\n${b}`}],structuredContent:{entries:y,totalCount:y.length,archivedCount:v}}}async function
|
|
209
|
+
`);return p===d.length?q(`INTERNAL`,h):{content:[{type:`text`,text:h}]}})}function _l(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:L.string().describe(`What you want to accomplish (e.g., "audit this monorepo", "fix a failing test")`),max_recommendations:L.number().min(1).max(10).default(5).describe(`Maximum number of tool recommendations`)},annotations:n.annotations},async({goal:e,max_recommendations:n})=>{try{let r=at(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(`
|
|
210
|
+
`)}]}}catch(e){return fl.error(`Guide failed`,I(e)),q(`INTERNAL`,`Guide failed: ${e instanceof Error?e.message:String(e)}`)}})}const vl={decision:6,pattern:5,"file-card":4,analysis:3,"search-result":2,"step-summary":1},yl={implementer:{name:`implementer`,contextTypes:[`file-card`,`decision`,`pattern`],priority:{...vl}},documenter:{name:`documenter`,contextTypes:[`decision`,`pattern`,`step-summary`],priority:{...vl}},reviewer:{name:`reviewer`,contextTypes:[`file-card`,`search-result`,`decision`,`pattern`,`step-summary`,`analysis`],priority:{...vl}},researcher:{name:`researcher`,contextTypes:[`search-result`,`decision`,`analysis`],priority:{...vl}},debugger:{name:`debugger`,contextTypes:[`file-card`,`search-result`,`pattern`,`analysis`],priority:{...vl}}};function bl(e){return yl[e]}function xl(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=e.content.length;o+t>n||(a.push(e),o+=t)}return a}function Sl(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 Cl(e){let t=new Set,n=[];for(let r of e){let e=Sl(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 wl(e){if(e.startsWith(`.ai/curated/`))return e.slice(12)}const Tl=F(`tools`),El=L.enum([`remember`,`read`,`update`,`forget`,`list`,`history`,`diff`,`recover`,`orphaned`,`withdraw`,`flush`,`flagged`,`lesson`]),Dl=L.string().min(3).max(120).describe(`Short descriptive title for the knowledge entry`),Ol=L.string().min(10).max(1e5),kl=L.string().regex(/^[a-z][a-z0-9-]*$/).describe(`Category slug (e.g., "decisions", "patterns", "conventions", "api-contracts")`),Al=L.array(L.string()).default([]).describe(`Optional tags for filtering`),jl=L.string().describe(`Relative path within .ai/curated/ (e.g., "decisions/use-lancedb.md")`),Ml=L.string().min(3),Nl=L.object({title:Dl,content:Ol.describe(`The markdown content to store`),category:kl,tags:Al,force:L.boolean().optional().describe(`When true, supersede flagged similar entries without waiting for confirmation`)}),Pl=L.object({path:jl}),Fl=L.object({path:jl,content:Ol.describe(`New markdown content to replace existing content`),reason:Ml.max(1e3).describe(`Why this update is being made (recorded in changelog)`)}),Il=L.object({path:L.string().describe(`Relative path within .ai/curated/ (e.g., "decisions/deprecated-approach.md")`),reason:Ml.describe(`Why this entry is being removed`)}),Ll=L.object({category:L.string().optional().describe(`Filter by category (e.g., "decisions", "patterns")`),tag:L.string().optional().describe(`Filter by tag`)}),Rl=L.enum([`create`,`confirm`,`contradict`,`list-lessons`]),zl=L.enum([`confidence`,`recent`]),Bl=L.number().int().min(0).max(100).describe(`Lesson confidence from 0-100`),Vl=L.object({action:El.describe(`Knowledge operation to perform`),title:Dl.optional(),content:Ol.optional(),category:kl.optional(),tags:L.array(L.string()).optional().describe(`Optional tags for remember`),path:jl.optional(),reason:Ml.max(1e3).optional(),scope:L.enum([`curated`,`flow`]).optional().describe(`Storage scope: curated (default) or flow-scoped ephemeral context`),profile:L.string().optional().describe(`Role profile for withdraw filtering (e.g., "implementer", "reviewer", "debugger")`),budget:L.number().int().min(100).max(5e4).optional().describe(`Maximum character budget for withdraw results (default: 6000)`),tag:L.string().optional().describe(`Filter by tag when action="list"`),id:jl.optional().describe(`Alias for path when action="lesson"`),subAction:Rl.optional().describe(`Lesson sub-action when action="lesson"`),context:Ol.optional().describe(`What happened (the situation) for lesson creation`),insight:Ol.optional().describe(`What was learned (the lesson) for lesson creation`),evidence:Ol.optional().describe(`Proof or justification for lesson creation`),confidence:Bl.optional(),minConfidence:Bl.optional().describe(`Minimum confidence when listing lessons`),topic:L.string().optional().describe(`Topic filter when listing lessons`),sortBy:zl.optional().describe(`Sort lessons by confidence or recency`),includeArchived:L.boolean().optional().describe(`Include auto-archived lessons in list-lessons`),limit:L.number().int().min(1).max(100).optional().describe(`Maximum history entries to return (for action="history", default: 20)`),force:L.boolean().optional().describe(`When true, supersede flagged similar entries without waiting for confirmation`),from_sha:L.string().optional().describe(`Start SHA for diff (older version). If omitted with to_sha, shows full content.`),to_sha:L.string().optional().describe(`End SHA for diff (newer version). If omitted, uses the latest two versions.`)}),Hl=L.object({title:Dl,context:Ol.describe(`What happened (the situation)`),insight:Ol.describe(`What was learned (the lesson)`),evidence:Ol.describe(`Proof or justification`),confidence:Bl.default(50),tags:Al.optional().default([])}),Ul=L.object({path:jl.optional(),id:jl.optional(),reason:Ml.max(1e3).optional()}).refine(e=>!!(e.path??e.id),{message:`path or id is required`,path:[`path`]}),Wl=L.object({topic:L.string().optional(),minConfidence:Bl.optional(),tag:L.string().optional(),tags:L.array(L.string()).optional(),sortBy:zl.default(`confidence`),includeArchived:L.boolean().default(!1)});function Gl(e,t,i,a){r(e,t,i);let o=e.memoryMetaGet(t);if(!o)return;let s=_(o,{...n,...a});return s?(v(e,t,s),h(e,t,i)??e.memoryMetaGet(t)):o}function Kl(e,t){return`\n\n### ${e}\n${t.map(e=>`- **${e.title}** (${e.id}) — similarity ${e.similarity.toFixed(3)}`).join(`
|
|
211
|
+
`)}`}async function ql(e,t,n,r){if(typeof e.list!=`function`||typeof e.read!=`function`)return[];let i=c(r),a=await e.list({category:n});return a.length===0?[]:d(t,await Promise.all(a.slice(0,i.maxCompare).map(async t=>{let n=await e.read(t.path);return{id:t.path,title:n.title,content:n.content,path:t.path}})),i)}function Jl(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}))}}const Yl={decisions:`decision`,patterns:`pattern`,conventions:`pattern`,context:`analysis`,session:`step-summary`},Xl=new Set([`decision`,`pattern`,`file-card`,`analysis`,`search-result`,`step-summary`]);function Zl(e){if(!e)return`analysis`;let t=Yl[e]??e;return Xl.has(t)?t:`analysis`}function Ql(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 $l(e,t){return e??t??``}function eu(e){return[...new Set([...e??[],`lesson`])]}function tu(e,t,n){if(e)return e.memoryMetaCreate(t,`working`),e.memoryMetaUpdateConfidence(t,n),e.memoryMetaGet(t)}async function nu(e,t,n){let r=await e.read(n),i=p(r.content),a=t?.memoryMetaGet(n)?.confidence??i.confidence??50;return{entry:r,confidence:a,meta:tu(t,n,a)??t?.memoryMetaGet(n)}}async function ru(e,{curated:t,stateStore:n,resourceNotifier:r}){let{title:i,context:o,insight:s,evidence:c,confidence:l,tags:u}=Hl.parse(e),d=a({title:i,context:o,insight:s,evidence:c,confidence:l,tags:u}),f=await t.remember(i,d,`lessons`,eu(u));return tu(n,f.path,l),r&&r.notifyAfterCuratedWrite(f.path).catch(()=>{}),{content:[{type:`text`,text:`Recorded lesson: **${i}**\n\nStored at \`.ai/curated/${f.path}\` with confidence ${l}/100.`}],structuredContent:{path:f.path,confidence:l,category:`lessons`,tags:eu(u)}}}async function iu(e,t,n){let{curated:r,stateStore:a,resourceNotifier:o,retentionConfig:c,consolidationConfig:d,lessonConfig:f}=n,p=Ul.parse(e);if(t===`contradict`&&!p.reason)throw new L.ZodError([{code:`custom`,path:[`reason`],message:`reason is required`}]);let m=$l(p.path,p.id),h=u(f??l);a&&Gl(a,m,c,d);let{entry:g,confidence:_}=await nu(r,a,m),v=i(_,t,h),y=s(g.content,v),b=t===`confirm`?p.reason??`Confirmed lesson confidence`:`Contradicted lesson confidence: ${p.reason}`,x=await r.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 au(e,{curated:t,stateStore:n,lessonConfig:r}){let{topic:i,minConfidence:a,tag:s,tags:c,sortBy:d,includeArchived:f}=Wl.parse(e),p=eu([...c??[],...s?[s]:[]]),m=u(r??l),h=await t.list({category:`lessons`,...s?{tag:s}:{}}),_=await Promise.all(h.filter(e=>e.tags.includes(`lesson`)).map(async e=>{let t=n?.memoryMetaGet(e.path),r=t?.confidence??50,i=tu(n,e.path,r)??t;i&&i.supersededBy===null&&o(i,m)&&n?.memoryMetaSetSuperseded(e.path,g);let a=n?.memoryMetaGet(e.path)??i,s=a?.lastAccessedAt??a?.createdAt??null;return{path:e.path,title:e.title,category:e.category,tags:e.tags,version:e.version,preview:e.contentPreview,confidence:a?.confidence??r,createdAt:a?.createdAt??null,lastAccessedAt:a?.lastAccessedAt??null,recency:s,archived:a?.supersededBy===g,supersededBy:a?.supersededBy??null}})),v=_.filter(e=>e.archived).length,y=_.filter(e=>f?!0:e.supersededBy===null).filter(e=>a===void 0?!0:e.confidence>=a).filter(e=>p.length===0?!0:p.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)=>d===`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??``));if(y.length===0)return{content:[{type:`text`,text:`No lessons matched the requested filters.`}],structuredContent:{entries:[],totalCount:0,archivedCount:v}};let b=y.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(`
|
|
212
|
+
`);return{content:[{type:`text`,text:`## Lessons (${y.length})\n\n${b}`}],structuredContent:{entries:y,totalCount:y.length,archivedCount:v}}}async function ou(e,t){switch(e.subAction??`create`){case`create`:return ru(e,t);case`confirm`:return iu(e,`confirm`,t);case`contradict`:return iu(e,`contradict`,t);case`list-lessons`:return au(e,t)}}async function su(e,t){if(e.scope===`flow`){let{flowContextAdapter:n,stateStore:r}=t;if(!n)return{content:[{type:`text`,text:`Flow context not available.`}]};let{title:i,content:a,category:o}=Nl.parse(e),s=`${Zl(o)}/${i.toLowerCase().replace(/[^a-z0-9]+/g,`-`).slice(0,60)}.md`;return await n.write(s,`# ${i}\n\n${a}`),r?.memoryMetaCreate(s,`working`),{content:[{type:`text`,text:`Deposited flow context: **${i}** at \`${s}\``}]}}let{curated:n,policyStore:r,evolutionCollector:i,resourceNotifier:a,stateStore:o,supersessionConfig:s}=t,{title:l,content:u,category:d,tags:f,force:p=!1}=Nl.parse(e),h=c(s),g=await ql(n,u,d,h),_=await n.remember(l,u,d,f);o?.memoryMetaCreate(_.path,`working`);let v=Jl(g,h.autoThreshold,p);if(o)for(let e of v.superseded)m(o,e.id,_.path);let y=``;if(r){let e=r.classify(l,u,f);i&&i.recordClassification(l,e.matchingRules.map(e=>e.ruleId),e.pushRecommended),e.matchingRules.length>0&&(y=`\n\n### Classification Signals\n${e.matchingRules.map(e=>` - **${e.ruleId}** (${e.category}, weight: ${e.pushWeight}) — matched: ${e.matchedPatterns.join(`, `)}`).join(`
|
|
213
213
|
`)}\n- **Push recommended**: ${e.pushRecommended?`yes`:`no`} (max weight: ${e.maxPushWeight})`,e.pushRecommended&&(y+=`
|
|
214
214
|
|
|
215
|
-
> 💡 This entry matches push rules. Consider \`er_push\` to share with Enterprise RAG.`))}a&&a.notifyAfterCuratedWrite(_.path).catch(()=>{});let b=
|
|
216
|
-
`),l=
|
|
217
|
-
`);return{content:[{type:`text`,text:`## Flow Context (${e.length} entries)\n\n${a}`}],structuredContent:{entries:t.map(({entry:e,retentionMeta:t})=>({path:e.path,size:e.size,...t?{retentionScore:t.retentionScore,tier:t.tier}:{}})),totalCount:e.length}}}let{category:a,tag:o}=
|
|
218
|
-
`),d=
|
|
219
|
-
`);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
|
|
220
|
-
`);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
|
|
215
|
+
> 💡 This entry matches push rules. Consider \`er_push\` to share with Enterprise RAG.`))}a&&a.notifyAfterCuratedWrite(_.path).catch(()=>{});let b=Sl(_.path,l,`[${d}]`),x=v.superseded.length>0?Kl(`Superseded Entries`,v.superseded):``,S=v.supersessionCandidates.length>0?Kl(`Supersession Suggestions`,v.supersessionCandidates):``;return{content:[{type:`text`,text:`Remembered: **${l}**\n\nStored at \`.ai/curated/${_.path}\` and indexed for semantic search.${y}${x}${S}\n\n---\n_Next: Use \`search\` to verify the entry is findable, or \`knowledge({ action: "list" })\` to see all curated entries._`},...b?[b]:[]],structuredContent:{path:_.path,superseded:v.superseded,supersessionCandidates:v.supersessionCandidates}}}async function cu(e,{curated:t,stateStore:n,retentionConfig:r,consolidationConfig:i}){let{path:a}=Pl.parse(e),o=await t.read(a),s=n?Gl(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(`
|
|
216
|
+
`),l=Sl(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 lu(e,{curated:t,resourceNotifier:n}){let{path:r,content:i,reason:a}=Fl.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 uu(e,{curated:t,resourceNotifier:n}){let{path:r,reason:i}=Il.parse(e),a=P(t.curatedDir,r);if(D(a))try{Le(`forget`,[{path:a,content:k(a,`utf-8`)}],`forget: ${r}`)}catch{}let o=await t.forget(r,i);return Tl.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 du(e,{curated:t,flowContextAdapter:n,stateStore:r,retentionConfig:i}){if(e.scope===`flow`){if(!n)return{content:[{type:`text`,text:`Flow context not available.`}]};let e=await n.list();if(e.length===0)return{content:[{type:`text`,text:`No flow context entries.`}]};let t=e.map(e=>({entry:e,retentionMeta:r?h(r,e.path,i):void 0})),a=t.map(({entry:e,retentionMeta:t})=>{let n=t?`, tier ${t.tier}, retention ${t.retentionScore.toFixed(3)}`:``;return`- \`${e.path}\` (${e.size} bytes${n})`}).join(`
|
|
217
|
+
`);return{content:[{type:`text`,text:`## Flow Context (${e.length} entries)\n\n${a}`}],structuredContent:{entries:t.map(({entry:e,retentionMeta:t})=>({path:e.path,size:e.size,...t?{retentionScore:t.retentionScore,tier:t.tier}:{}})),totalCount:e.length}}}let{category:a,tag:o}=Ll.parse(e),s=await t.list({category:a,tag:o}),c=s.map(e=>({entry:e,retentionMeta:r?h(r,e.path,i):void 0})),l={entries:c.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:s.length};if(s.length===0)return{content:[{type:`text`,text:`No curated knowledge entries found.`+(a?` (category: ${a})`:``)+(o?` (tag: ${o})`:``)}],structuredContent:l};let u=c.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(`
|
|
218
|
+
`),d=Cl(s);return{content:[{type:`text`,text:`## Curated Knowledge (${s.length} entries)\n\n${u}\n\n---\n_Next: Use \`knowledge({ action: "read", path: "..." })\` to view full content of any entry, or \`knowledge({ action: "remember", ... })\` to store new knowledge._`},...d],structuredContent:l}}async function fu(e,{curated:t}){let{path:n}=Pl.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(`
|
|
219
|
+
`);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 pu(e,{curated:t}){let{path:n}=Pl.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 mu(e,{curated:t}){let{path:n}=Pl.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 hu(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(`
|
|
220
|
+
`);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 gu(e,{flowContextAdapter:t,stateStore:n,retentionConfig:r,consolidationConfig:i}){let a=L.object({profile:L.string(),budget:L.number().int().min(100).max(5e4).default(6e3)}).parse(e);if(!t)return{content:[{type:`text`,text:`Flow context not available — no active flow or adapter not configured.`}]};let o=bl(a.profile);if(!o)return{content:[{type:`text`,text:`Unknown profile: "${a.profile}". Available: implementer, documenter, reviewer, researcher, debugger`}]};let s=await t.list();if(s.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 c=(await Promise.all(s.map(async e=>{let a=e.path.split(`/`),o=a[0];if(a.length<2||!Xl.has(o))return null;let s=await t.read(e.path);return s?(n&&Gl(n,e.path,r,i),{type:o,content:s}):null}))).filter(e=>e!==null),l=xl(c,o,a.budget);if(l.length===0)return{content:[{type:`text`,text:`No relevant context for profile "${a.profile}". ${c.length} entries available but none match your role's context types.`}]};let u=l.map(e=>`### [${e.type}]\n${e.content}`).join(`
|
|
221
221
|
|
|
222
|
-
`),d=l.reduce((e,t)=>e+t.content.length,0);return{content:[{type:`text`,text:`## Flow Context (${l.length}/${c.length} entries, ${d} chars, profile: ${a.profile})\n\n${u}`}]}}async function
|
|
223
|
-
`);return{content:[{type:`text`,text:`## Flagged Knowledge Entries (${r.length})\n\n${i}`}],structuredContent:{entries:r,totalCount:r.length}}}async function
|
|
222
|
+
`),d=l.reduce((e,t)=>e+t.content.length,0);return{content:[{type:`text`,text:`## Flow Context (${l.length}/${c.length} entries, ${d} chars, profile: ${a.profile})\n\n${u}`}]}}async function _u(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 vu(e,{stateStore:t,retentionConfig:n}){if(!t)return{content:[{type:`text`,text:`Retention state store not available.`}],structuredContent:{entries:[],totalCount:0}};let r=f(t,n);if(r.length===0)return{content:[{type:`text`,text:`No flagged knowledge entries found below the current retention threshold.`}],structuredContent:{entries:[],totalCount:0}};let i=r.map(e=>`- \`${e.entryId}\` — score ${e.retentionScore.toFixed(3)}, tier ${e.tier}, accesses ${e.accessCount}`).join(`
|
|
223
|
+
`);return{content:[{type:`text`,text:`## Flagged Knowledge Entries (${r.length})\n\n${i}`}],structuredContent:{entries:r,totalCount:r.length}}}async function yu(e,t,n){switch(e){case`remember`:return su(t,n);case`read`:return cu(t,n);case`update`:return lu(t,n);case`forget`:return uu(t,n);case`list`:return du(t,n);case`history`:return fu(t,n);case`diff`:return pu(t,n);case`recover`:return mu(t,n);case`orphaned`:return hu(t,n);case`withdraw`:return gu(t,n);case`flush`:return _u(t,n);case`flagged`:return vu(t,n);case`lesson`:return ou(t,n)}}function bu(e,t,n,r,i,a,o,s,c,l,u){let d=W(`knowledge`),f={curated:t,policyStore:n,evolutionCollector:r,resourceNotifier:i,flowContextAdapter:a,stateStore:o,retentionConfig:s,consolidationConfig:l,supersessionConfig:c,lessonConfig:u};e.registerTool(`knowledge`,{title:d.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, or lesson entries.",inputSchema:Vl.shape,annotations:d.annotations},async({action:e,...t})=>{try{let n=Vl.parse({action:e,...t});return await yu(n.action,n,f)}catch(e){return e instanceof L.ZodError?q(`VALIDATION`,Ql(e)):(Tl.error(`Knowledge operation failed`,I(e)),q(`INTERNAL`,`Knowledge operation failed: ${e instanceof Error?e.message:String(e)}`))}})}const xu=F(`tools`);function Su(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:L.string().describe(`Relative file path to look up (e.g., "src/index.ts")`),enrich:L.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},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(`
|
|
224
224
|
|
|
225
|
-
`),s=
|
|
226
|
-
`).replace(/\\t/g,` `)}))}]}}catch(e){return
|
|
227
|
-
`)}function
|
|
228
|
-
`)}const
|
|
225
|
+
`),s=wl(e),c=s?Sl(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 xu.error(`Lookup failed`,I(e)),q(`INTERNAL`,`Lookup failed: ${e instanceof Error?e.message:String(e)}`)}})}const Cu=F(`tools:manipulation`);function wu(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:L.string().optional().describe(`Repository root or working directory`),commit_count:L.number().min(1).max(50).default(5).optional().describe(`How many recent commits to include`),include_diff:L.boolean().default(!1).optional().describe(`Include diff stat for working tree changes`)},annotations:t.annotations,outputSchema:Po},async({cwd:e,commit_count:t,include_diff:n})=>{try{let r=await nt({cwd:e,commitCount:t,includeDiff:n});return{content:[{type:`text`,text:ku(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 Cu.error(`Git context failed`,I(e)),q(`INTERNAL`,`Git context failed: ${e instanceof Error?e.message:String(e)}`)}})}function Tu(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:L.string().max(1e6).describe(`Raw unified diff text`)},annotations:t.annotations},async({diff:e})=>{try{return{content:[{type:`text`,text:Au(He({diff:e.replace(/\\n/g,`
|
|
226
|
+
`).replace(/\\t/g,` `)}))}]}}catch(e){return Cu.error(`Diff parse failed`,I(e)),q(`INTERNAL`,`Diff parse failed: ${e instanceof Error?e.message:String(e)}`)}})}function Eu(e){let t=W(`rename`);e.registerTool(`rename`,{title:t.title,description:`Rename a symbol across files using whole-word regex matching for exports, imports, and general usage references.`,inputSchema:{old_name:L.string().describe(`Existing symbol name to replace`),new_name:L.string().describe(`New symbol name to use`),root_path:L.string().describe(`Root directory to search within`),extensions:L.array(L.string()).optional().describe(`Optional file extensions to include, such as .ts,.tsx,.js,.jsx`),dry_run:L.boolean().default(!0).describe(`Preview changes without writing files`)},annotations:t.annotations},async({old_name:e,new_name:t,root_path:n,extensions:r,dry_run:i})=>{try{let a=await Rt({oldName:e,newName:t,rootPath:n,extensions:r,dryRun:i});return{content:[{type:`text`,text:JSON.stringify(a)}]}}catch(e){return Cu.error(`Rename failed`,I(e)),q(`INTERNAL`,`Rename failed: ${e instanceof Error?e.message:String(e)}`)}})}function Du(e){let t=W(`codemod`);e.registerTool(`codemod`,{title:t.title,description:`Apply regex-based codemod rules across files and return structured before/after changes for each affected line.`,inputSchema:{root_path:L.string().describe(`Root directory to transform within`),rules:L.array(L.object({description:L.string().describe(`What the codemod rule does`),pattern:L.string().describe(`Regex pattern in string form`),replacement:L.string().describe(`Replacement string with optional capture groups`)})).min(1).describe(`Codemod rules to apply`),dry_run:L.boolean().default(!0).describe(`Preview changes without writing files`)},annotations:t.annotations},async({root_path:e,rules:t,dry_run:n})=>{try{let r=await Pe({rootPath:e,rules:t,dryRun:n});return{content:[{type:`text`,text:JSON.stringify(r)}]}}catch(e){return Cu.error(`Codemod failed`,I(e)),q(`INTERNAL`,`Codemod failed: ${e instanceof Error?e.message:String(e)}`)}})}function Ou(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:L.string().max(5e5).describe(`Input JSON string`),expression:L.string().max(1e4).describe(`Transform expression to apply`)},annotations:t.annotations},async({input:e,expression:t})=>{try{return{content:[{type:`text`,text:Re({input:e,expression:t}).outputString}]}}catch(e){return Cu.error(`Data transform failed`,I(e)),q(`INTERNAL`,`Data transform failed: ${e instanceof Error?e.message:String(e)}`)}})}function ku(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(`
|
|
227
|
+
`)}function Au(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(`
|
|
228
|
+
`)}const ju=[`list_tools`,`describe_tool`,`search_tools`];function Mu(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:L.string().optional().describe(`Optional category filter`)},annotations:W(`list_tools`).annotations},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(`
|
|
229
229
|
`)||`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:L.string().describe(`The active tool name to describe`)},annotations:W(`describe_tool`).annotations},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:L.string().min(1).describe(`Keyword query to match against active tools`)},annotations:W(`search_tools`).annotations},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(`
|
|
230
|
-
`):`No tools found matching "${e}"`}]}})}const
|
|
231
|
-
`);if(c&&a){let e=await G(a,{query:`onboard codebase conventions`});h+=K(e)}return{content:[{type:`text`,text:h}]}}catch(e){return
|
|
232
|
-
`)}]}}case`delete`:if(!t)throw Error(`name required for delete`);return{content:[{type:`text`,text:Ve(t)?`Deleted workset "${t}".`:`Workset "${t}" not found.`}]};case`add`:{if(!t||!n)throw Error(`name and files required for add`);let e=Se(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=Lt(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
|
|
233
|
-
`)}]}}case`delete`:if(!n)throw Error(`key required for delete`);return{content:[{type:`text`,text:Xt(t,n)?`Deleted stash entry "${n}".`:`Stash entry "${n}" not found.`}]};case`clear`:{let e=Yt(t);return{content:[{type:`text`,text:`Cleared ${e} stash entr${e===1?`y`:`ies`}.`}]}}}}catch(e){return
|
|
234
|
-
`)}]}}case`latest`:{let e=Ae(t,{label:n});return{content:[{type:`text`,text:e?
|
|
230
|
+
`):`No tools found matching "${e}"`}]}})}const Nu=F(`tools`);let Pu=!1;async function Fu(e,t,n){for(let r of n.steps)if(!(r.status!==`success`||!r.output))try{let i=C(`sha256`).update(n.path).digest(`hex`).slice(0,12),a=`produced/onboard/${r.name}/${i}.md`,o=C(`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:C(`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 t.embedBatch(l.map(e=>e.content));await e.upsert(l,u)}catch(e){Nu.warn(`Auto-persist onboard step failed`,{stepName:r.name,...I(e)})}}async function Iu(e,t,n){if(n.autoRemember?.length)for(let r of n.autoRemember)try{let n=C(`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:C(`sha256`).update(r.content).digest(`hex`).slice(0,16),indexedAt:i,origin:`curated`,tags:r.tags,category:r.category,version:1},[o]=await t.embedBatch([a.content]);await e.upsert([a],[o])}catch(e){Nu.warn(`Auto-persist remember entry failed`,{title:r.title,...I(e)})}}function Lu(e,t,n,r,i,a){let o=W(`onboard`);e.registerTool(`onboard`,{title:o.title,description:`First-time codebase onboarding: runs all analysis tools (structure, dependencies, entry-points, symbols, patterns, diagram) in one command. Results are auto-persisted to AI Kit memory. Use mode=generate to also write structured output to .ai/context/ directory.`,inputSchema:{path:L.string().describe(`Root path of the codebase to onboard`),mode:L.enum([`memory`,`generate`]).default(`generate`).describe(`Output mode: generate (default) = persist to AI Kit + write .ai/context/ files; memory = AI Kit vector store only`),out_dir:L.string().optional().describe(`Custom output directory for generate mode (default: <path>/.ai/context)`),enrich:L.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},async({path:e,mode:o,out_dir:s,enrich:c},l)=>{try{if(Pu)return{content:[{type:`text`,text:`Onboard is already running. Please wait for it to complete before starting another.`}]};Pu=!0,Nu.info(`Starting onboard`,{path:e,mode:o});let u=await vt({path:e,mode:o,outDir:s??r?.onboardDir}),d=bs(l).createTask(`Onboard`,u.steps.length);for(let e=0;e<u.steps.length;e++){let t=u.steps[e];d.progress(e,`${t.name}: ${t.status}`)}d.complete(`Onboard complete: ${u.steps.filter(e=>e.status===`success`).length}/${u.steps.length} steps succeeded`),Fu(t,n,u),u.autoRemember?.length&&Iu(t,n,u).catch(e=>{Nu.warn(`Auto-persist autoRemember failed`,I(e))}),i&&(i.onboardComplete=!0,i.onboardTimestamp=new Date().toISOString());let f=[`## Onboard Complete`,``,`**Path:** \`${u.path}\``,`**Mode:** ${u.mode}`,`**Duration:** ${u.totalDurationMs}ms`,``];u.outDir&&(f.push(`**Output directory:** \`${u.outDir}\``),f.push(``)),f.push(`### Analysis Results`,``);let p=[],m=[];for(let e of u.steps)e.status===`success`?p.push(`- ✓ **${e.name}** (${e.durationMs}ms) — ${e.output.length} chars`):m.push(`- ✗ **${e.name}** — ${e.error}`);f.push(...p),m.length>0&&f.push(``,`### Failed`,``,...m),f.push(``,`---`,``);for(let e of u.steps)e.status===`success`&&f.push(`### ${e.name}`,``,e.output,``,`---`,``);f.push(`_All results auto-saved to AI Kit memory._`,u.mode===`generate`?` Files written to \`${u.outDir}\`.`:``,' Next: Use `search` to query the knowledge, or `knowledge({ action: "remember", ... })` to add custom insights.');let h=f.join(`
|
|
231
|
+
`);if(c&&a){let e=await G(a,{query:`onboard codebase conventions`});h+=K(e)}return{content:[{type:`text`,text:h}]}}catch(e){return Nu.error(`Onboard failed`,I(e)),q(`INTERNAL`,`Onboard failed: ${e instanceof Error?e.message:String(e)}`)}finally{Pu=!1}})}const Ru=F(`tools:persistence`);function zu(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 .aikit-state/worksets.json.`,inputSchema:{action:L.enum([`save`,`get`,`list`,`delete`,`add`,`remove`]).describe(`Operation to perform`),name:L.string().optional().describe(`Workset name (required for all except list)`),files:L.array(L.string()).optional().describe(`File paths (required for save, add, remove)`),description:L.string().optional().describe(`Description (for save)`)},annotations:t.annotations},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=Wt(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=tt(t);return e?{content:[{type:`text`,text:JSON.stringify(e)}]}:{content:[{type:`text`,text:`Workset "${t}" not found.`}]}}case`list`:{let e=gt();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(`
|
|
232
|
+
`)}]}}case`delete`:if(!t)throw Error(`name required for delete`);return{content:[{type:`text`,text:Ve(t)?`Deleted workset "${t}".`:`Workset "${t}" not found.`}]};case`add`:{if(!t||!n)throw Error(`name and files required for add`);let e=Se(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=Lt(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 Ru.error(`Workset operation failed`,I(e)),q(`INTERNAL`,`Workset operation failed: ${e instanceof Error?e.message:String(e)}`)}})}function Bu(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:L.enum([`set`,`get`,`list`,`delete`,`clear`]).describe(`Operation to perform on the stash`),key:L.string().optional().describe(`Entry key for set/get/delete operations`),value:L.string().optional().describe(`String or JSON value for set operations`)},annotations:n.annotations},async({action:e,key:n,value:r})=>{try{switch(e){case`set`:{if(!n)throw Error(`key required for set`);let e=$t(t,n,Gu(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=Zt(t,n);return{content:[{type:`text`,text:e?JSON.stringify(e):`Stash entry "${n}" not found.`}]}}case`list`:{let e=Qt(t);return{content:[{type:`text`,text:e.length===0?`Stash is empty.`:e.map(e=>`- ${e.key} (${e.type}) — ${e.storedAt}`).join(`
|
|
233
|
+
`)}]}}case`delete`:if(!n)throw Error(`key required for delete`);return{content:[{type:`text`,text:Xt(t,n)?`Deleted stash entry "${n}".`:`Stash entry "${n}" not found.`}]};case`clear`:{let e=Yt(t);return{content:[{type:`text`,text:`Cleared ${e} stash entr${e===1?`y`:`ies`}.`}]}}}}catch(e){return Ru.error(`Stash operation failed`,I(e)),q(`INTERNAL`,`Stash operation failed: ${e instanceof Error?e.message:String(e)}`)}})}function Vu(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 .aikit-state/checkpoints directories are imported automatically on first access.`,inputSchema:{action:L.enum([`save`,`load`,`list`,`latest`,`diff`,`history`,`gc`]).describe(`Checkpoint action to perform`),label:L.string().optional().describe(`Checkpoint label for save, or checkpoint id for load`),data:L.string().max(5e5).optional().describe(`JSON object string for save actions`),notes:L.string().max(1e4).optional().describe(`Optional notes for save actions`),from_id:L.string().optional().describe(`Checkpoint ID to diff FROM (for diff action)`),to_id:L.string().optional().describe(`Checkpoint ID to diff TO (for diff action)`),limit:L.number().min(1).max(50).optional().describe(`Max history entries to return`),keep_last:L.number().min(1).max(100).optional().describe(`Keep N most recent checkpoints per label (default: 10, for gc action)`),max_age_days:L.number().min(1).optional().describe(`Delete checkpoints older than N days (for gc action)`),dry_run:L.boolean().optional().describe(`Preview changes without deleting (default: true, for gc action)`)},annotations:n.annotations},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:Wu(Ne(t,n,Ku(r),{notes:i}))}]};case`load`:{if(!n)throw Error(`label required for load`);let e=Me(t,n);return{content:[{type:`text`,text:e?Wu(e):`Checkpoint "${n}" not found.`}]}}case`list`:{let e=je(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(`
|
|
234
|
+
`)}]}}case`latest`:{let e=Ae(t,{label:n});return{content:[{type:`text`,text:e?Wu(e):`No checkpoints saved.`}]}}case`diff`:{if(!a||!o)throw Error(`from_id and to_id required for diff`);let e=De(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(`
|
|
235
235
|
`)}]}:{content:[{type:`text`,text:`One or both checkpoints not found.`}]}}case`history`:{if(!n)throw Error(`label required for history`);let e=ke(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(`
|
|
236
236
|
`)}`}]}}case`gc`:{let e=Oe(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(`
|
|
237
|
-
`)}]}}}}catch(e){return
|
|
238
|
-
`)}function
|
|
239
|
-
`)}function
|
|
240
|
-
`)}\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:
|
|
237
|
+
`)}]}}}}catch(e){return Ru.error(`Checkpoint failed`,I(e)),q(`INTERNAL`,`Checkpoint failed: ${e instanceof Error?e.message:String(e)}`)}})}function Hu(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:L.enum([`create`,`list`,`status`,`diff`,`merge`,`discard`,`lease`,`unlease`,`leases`]).describe(`Lane action to perform`),name:L.string().optional().describe(`Lane name (required for create/status/diff/merge/discard)`),files:L.array(L.string()).optional().describe(`File paths to copy into the lane (required for create)`),agent:L.string().optional().describe(`Agent identifier (required for lease)`),intent:L.string().optional().describe(`What the agent plans to do (required for lease)`),id:L.string().optional().describe(`Lease ID (required for unlease)`),symbols:L.array(L.string()).optional().describe(`Symbol names within files (optional for lease)`),ttl_minutes:L.number().optional().describe(`Lease TTL in minutes (default 10, optional for lease)`)},annotations:t.annotations},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=ct(t,n);return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`list`:return{content:[{type:`text`,text:JSON.stringify(dt())}]};case`status`:if(!t)throw Error(`name is required for status`);return{content:[{type:`text`,text:JSON.stringify(pt(t))}]};case`diff`:if(!t)throw Error(`name is required for diff`);return{content:[{type:`text`,text:JSON.stringify(lt(t))}]};case`merge`:if(!t)throw Error(`name is required for merge`);return{content:[{type:`text`,text:JSON.stringify(ft(t))}]};case`discard`:if(!t)throw Error(`name is required for discard`);return{content:[{type:`text`,text:JSON.stringify({discarded:ut(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=xe({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=It({id:a});return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`leases`:{let e=mt({agent:r});return{content:[{type:`text`,text:JSON.stringify(e)}]}}}}catch(e){return Ru.error(`Lane action failed`,I(e)),q(`INTERNAL`,`Lane action failed: ${e instanceof Error?e.message:String(e)}`)}})}function Uu(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:L.enum([`create`,`push`,`next`,`done`,`fail`,`get`,`list`,`clear`,`delete`,`dag`]).describe(`Queue action`),name:L.string().optional().describe(`Queue name (required for most actions)`),title:L.string().optional().describe(`Item title (required for push)`),id:L.string().optional().describe(`Item ID (required for done/fail)`),data:L.unknown().optional().describe(`Arbitrary data to attach to a queue item`),error:L.string().optional().describe(`Error message (required for fail)`),dependsOn:L.array(L.string()).optional().describe(`Item IDs this task depends on. Dependent items start as blocked until deps complete.`)},annotations:t.annotations},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(Et(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(Pt(t,n,i,void 0,o))}]};case`next`:{if(!t)throw Error(`name is required for next`);let e=Nt(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(kt(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(At(t,r,a))}]};case`get`:if(!t)throw Error(`name is required for get`);return{content:[{type:`text`,text:JSON.stringify(jt(t))}]};case`list`:return{content:[{type:`text`,text:JSON.stringify(Mt())}]};case`clear`:if(!t)throw Error(`name is required for clear`);return{content:[{type:`text`,text:JSON.stringify({cleared:Tt(t)})}]};case`delete`:if(!t)throw Error(`name is required for delete`);return{content:[{type:`text`,text:JSON.stringify({deleted:Ot(t)})}]};case`dag`:if(!t)throw Error(`name is required for dag`);return{content:[{type:`text`,text:JSON.stringify(Dt(t))}]}}}catch(e){return Ru.error(`Queue action failed`,I(e)),q(`INTERNAL`,`Queue action failed: ${e instanceof Error?e.message:String(e)}`)}})}function Wu(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(`
|
|
238
|
+
`)}function Gu(e){let t=e.trim();if(!t)return``;try{return JSON.parse(t)}catch{return e}}function Ku(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 qu=F(`tools`);function Ju(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(`
|
|
239
|
+
`)}function Yu(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:L.enum([`list`,`get`,`update`,`create`,`delete`]).describe(`Action to perform on classification rules`),rule_id:L.string().optional().describe(`Rule ID (required for get, update, delete)`),changes:L.object({patterns:L.array(L.string()).optional(),category:L.string().optional(),pushWeight:L.number().min(0).max(1).optional(),description:L.string().optional(),examples:L.array(L.string()).optional(),enabled:L.boolean().optional()}).optional().describe(`Changes to apply (for update action)`),new_rule:L.object({id:L.string().regex(/^[a-z][a-z0-9-]*$/),patterns:L.array(L.string()).min(1),category:L.string(),pushWeight:L.number().min(0).max(1),description:L.string(),examples:L.array(L.string()).default([]),enabled:L.boolean().default(!0)}).optional().describe(`New rule definition (for create action)`)},annotations:n.annotations},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(`
|
|
240
|
+
`)}\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:Ju(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:`${Ju(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:`${Ju(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 qu.error(`Policy update failed`,I(e)),q(`INTERNAL`,`Policy update failed: ${e instanceof Error?e.message:String(e)}`)}})}const Xu=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:`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:`{
|
|
241
241
|
type: 'docs-browser',
|
|
242
242
|
value: {
|
|
243
243
|
title: 'Project Docs',
|
|
@@ -246,7 +246,7 @@ Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_rad
|
|
|
246
246
|
{ path: 'docs/api.md', title: 'API Reference', status: 'stale' },
|
|
247
247
|
],
|
|
248
248
|
},
|
|
249
|
-
}`},{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 }> }>`}].map(e=>[e.type,{...e}]));function Xu(){let e={};for(let[t,n]of Yu)n.vendorScripts?.length&&(e[t]=n.vendorScripts);return e}const Zu=1024,Qu=new Set([`user-closed`,`host-dismissed`,`replaced`]);function $u(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function ed(e,t,n){let r={code:e,message:t};return n!==void 0&&(r.details=n),{kind:`error`,error:r}}function td(e,t,n,r){e.writeHead(t,{"Content-Type":`application/json`,"Access-Control-Allow-Origin":r??`null`}),e.end(JSON.stringify(n))}async function nd(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 rd(e,t){if(typeof e!=`string`||e.length!==t.length)return!1;let n=Buffer.from(e,`utf8`),r=Buffer.from(t,`utf8`);return n.length===r.length?E(n,r):!1}function id(e,t){let n=e.headers.origin;if(n!=null)return n===t;let r=e.headers.referer;return r==null?!1:r.startsWith(t)}function ad(e){return(e.headers[`content-type`]??``).startsWith(`application/json`)}function od(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 sd(e){return Array.isArray(e)&&e.length>Zu?`Selection exceeds ${Zu} items (got ${e.length})`:null}function cd(e,t,n){let r=typeof e.actionId==`string`?e.actionId:``,i=n.find(e=>e.id===r);if(!i)return ed(`INVALID_ACTION`,`Unknown actionId: ${r||`(missing)`}`);let a=typeof e.selection==`string`||Array.isArray(e.selection)?e.selection:void 0,o=$u(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),typeof e.label==`string`?s.label=e.label:i.label&&(s.label=i.label),{kind:`result`,result:s}}function ld(e,t){let n=w(16).toString(`hex`),r=!1,i=!1,a,o,s=new Promise(e=>{o=e}),c=e=>r?a??e:(r=!0,a=e,o?.(e),e);return{nonce:n,promise:s,settleTimeout(e){return c({kind:`timeout`,waitedMs:e})},settleCancelled(e){return c({kind:`cancelled`,reason:e})},settleError(e,t,n){return c(ed(e,t,n))},async handle(r,a,o){if(!ad(r)){let e=c(ed(`INVALID_CONTENT_TYPE`,`Content-Type must be application/json`));return td(a,415,{ok:!1,error:`unsupported-media-type`},o),e}if(!id(r,o)){let e=c(ed(`INVALID_ORIGIN`,`Unexpected callback origin: ${r.headers.origin??r.headers.referer??`(missing)`}`));return td(a,403,{ok:!1,error:`invalid-origin`},o),e}let s=``;try{s=await nd(r)}catch(e){let t=c(ed(`INVALID_PAYLOAD`,e instanceof Error?e.message:`Unable to read callback payload`));return td(a,413,{ok:!1,error:`payload-too-large`},o),t}let l;try{let e=JSON.parse(s);if(!$u(e))throw Error(`Callback payload must be an object`);l=e}catch(e){let t=c(ed(`INVALID_PAYLOAD`,e instanceof Error?e.message:`Malformed callback payload`));return td(a,400,{ok:!1,error:`invalid-json`},o),t}if(i){let e=ed(`NONCE_CONSUMED`,`Nonce has already been used`);return td(a,403,{ok:!1,error:`nonce-consumed`},o),e}if(!rd(typeof l.nonce==`string`?l.nonce:``,n)){let e=c(ed(`INVALID_NONCE`,`Callback nonce did not match`));return td(a,403,{ok:!1,error:`invalid-nonce`},o),e}i=!0;let u=sd(l.selection);if(u){let e=c(ed(`SELECTION_TOO_LARGE`,u));return td(a,413,{ok:!1,error:`selection-too-large`},o),e}if($u(l.formData)){let e=od(l.formData);if(e){let t=c(ed(`PAYLOAD_FIELD_TOO_LARGE`,e));return td(a,413,{ok:!1,error:`field-too-large`},o),t}}if(l.kind===`cancelled`){let e=typeof l.reason==`string`?l.reason:``;if(!Qu.has(e)){let t=c(ed(`INVALID_CANCEL_REASON`,`Unsupported cancel reason: ${e||`(missing)`}`));return td(a,400,{ok:!1,error:`invalid-cancel-reason`},o),t}let t=c({kind:`cancelled`,reason:e});return td(a,200,{ok:!0,kind:`cancelled`},o),t}let d=c(cd(l,e,t));return td(a,d.kind===`error`?400:200,{ok:d.kind!==`error`,kind:d.kind},o),d}}}const ud=new Map;function dd(e){return e.replace(/[|\\{}()[\]^$+*?.]/g,`\\$&`)}function fd(e){let t=`(?=[^>]*\\bid=['"]${dd(e)}['"])`;return RegExp(`(<script\\b(?=[^>]*\\btype=['"]application\\/json['"])${t}[^>]*>)[\\s\\S]*?(<\/script>)`,`i`)}function pd(e){ud.has(e.id)&&console.warn(`[viewer-registry] Overwriting viewer template "${e.id}"`),ud.set(e.id,e)}function md(e){return ud.get(e)}function hd(e){return typeof e==`string`&&ud.has(e)}function gd(){return[...ud.values()]}function _d(e,t,n,r){let i=fd(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 vd=import.meta.dirname??M(se(import.meta.url)),yd={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`]},bd={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`]},xd={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 Sd(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Cd(e,t){return Sd(t)?{...t,kind:e}:{kind:e}}function wd(e){let t=[...e===`canvas.html`?[N(vd,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`canvas`,`index.html`),N(vd,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`canvas`,`index.html`)]:[],N(vd,`..`,`..`,`..`,`viewers`,e),N(vd,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`static`,e),N(vd,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`dist`,e),N(vd,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,e),N(vd,`..`,`..`,`scaffold`,`general`,`viewers`,`dist`,e),N(vd,`..`,`..`,`scaffold`,`general`,`viewers`,e),N(vd,`..`,`viewers`,`dist`,e),N(vd,`..`,`viewers`,e)];for(let e of t)try{return k(e,`utf8`)}catch{}throw Error(`Viewer HTML not found: ${e}. Searched: ${t.join(`, `)}`)}let Td,Ed,Dd,Od,kd,Ad;function jd(){return Td??=wd(`c4-viewer.html`),Td}function Md(){return Ed??=wd(`tour-viewer.html`),Ed}function Nd(){return Dd??=wd(`canvas.html`),Dd}function Pd(){return Od??=wd(`architecture-static.html`),Od}function Fd(){return kd??=wd(`process-flow-static.html`),kd}function Id(){return Ad??=wd(`task-plan-static.html`),Ad}function Ld(){pd({id:`c4@1`,label:`C4 Architecture Diagram`,description:`Interactive C4 architecture diagram with zoom, pan, and ELK auto-layout`,inputSchema:yd,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:jd}),pd({id:`c4-static@1`,label:`C4 Architecture Diagram (Static)`,description:`Static SVG architecture diagram for inline rendering`,inputSchema:yd,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:Pd}),pd({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:Md}),pd({id:`process-flow-static@1`,label:`Process Flow Diagram (Static)`,description:`Static SVG process flow diagram for inline rendering`,inputSchema:bd,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:Fd}),pd({id:`task-plan-static@1`,label:`Task Execution Plan (Static)`,description:`Static SVG task execution plan for inline rendering`,inputSchema:xd,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:Id}),pd({id:`task-plan@1`,label:`Task Execution Plan (Interactive)`,description:`Interactive task execution plan with ReactFlow, phase grouping, and dependency edges`,inputSchema:xd,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:Nd,transformData:e=>Cd(`task-plan`,e)}),pd({id:`process-flow@1`,label:`Process Flow Diagram (Interactive)`,description:`Interactive process flow diagram with ReactFlow`,inputSchema:bd,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:Nd,transformData:e=>Cd(`process-flow`,e)})}function Rd(){let e=new nr;for(let t of ar.list())e.register(t);return e.register(ir),e.register(lr),e.register(ur),e.register(or),e}function zd(e,t){return e?.supportedTransports.includes(t)??!1}const Bd=Rd();function Vd(e){if(e.template)return Bd.get(e.template)}function Hd(e){if((e.actions?.length??0)>0)return!0;if(e.template&&hd(e.template)){let t=md(e.template);return t?.supportedTransports.includes(`browser`)===!0&&!t.supportedTransports.includes(`mcp-app`)}let t=Vd(e);return zd(t,`browser`)&&!zd(t,`mcp-app`)}Ld();const Ud=String.raw`(function(){
|
|
249
|
+
}`},{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 }> }>`}].map(e=>[e.type,{...e}]));function Zu(){let e={};for(let[t,n]of Xu)n.vendorScripts?.length&&(e[t]=n.vendorScripts);return e}const Qu=1024,$u=new Set([`user-closed`,`host-dismissed`,`replaced`]);function ed(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function td(e,t,n){let r={code:e,message:t};return n!==void 0&&(r.details=n),{kind:`error`,error:r}}function X(e,t,n,r){e.writeHead(t,{"Content-Type":`application/json`,"Access-Control-Allow-Origin":r??`null`}),e.end(JSON.stringify(n))}async function nd(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 rd(e,t){if(typeof e!=`string`||e.length!==t.length)return!1;let n=Buffer.from(e,`utf8`),r=Buffer.from(t,`utf8`);return n.length===r.length?E(n,r):!1}function id(e,t){let n=e.headers.origin;if(n!=null)return n===t;let r=e.headers.referer;return r==null?!1:r.startsWith(t)}function ad(e){return(e.headers[`content-type`]??``).startsWith(`application/json`)}function od(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 sd(e){return Array.isArray(e)&&e.length>Qu?`Selection exceeds ${Qu} items (got ${e.length})`:null}function cd(e,t,n){let r=typeof e.actionId==`string`?e.actionId:``,i=n.find(e=>e.id===r);if(!i)return td(`INVALID_ACTION`,`Unknown actionId: ${r||`(missing)`}`);let a=typeof e.selection==`string`||Array.isArray(e.selection)?e.selection:void 0,o=ed(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),typeof e.label==`string`?s.label=e.label:i.label&&(s.label=i.label),{kind:`result`,result:s}}function ld(e,t){let n=w(16).toString(`hex`),r=!1,i=!1,a,o,s=new Promise(e=>{o=e}),c=e=>r?a??e:(r=!0,a=e,o?.(e),e);return{nonce:n,promise:s,settleTimeout(e){return c({kind:`timeout`,waitedMs:e})},settleCancelled(e){return c({kind:`cancelled`,reason:e})},settleError(e,t,n){return c(td(e,t,n))},async handle(r,a,o){if(!ad(r)){let e=c(td(`INVALID_CONTENT_TYPE`,`Content-Type must be application/json`));return X(a,415,{ok:!1,error:`unsupported-media-type`},o),e}if(!id(r,o)){let e=c(td(`INVALID_ORIGIN`,`Unexpected callback origin: ${r.headers.origin??r.headers.referer??`(missing)`}`));return X(a,403,{ok:!1,error:`invalid-origin`},o),e}let s=``;try{s=await nd(r)}catch(e){let t=c(td(`INVALID_PAYLOAD`,e instanceof Error?e.message:`Unable to read callback payload`));return X(a,413,{ok:!1,error:`payload-too-large`},o),t}let l;try{let e=JSON.parse(s);if(!ed(e))throw Error(`Callback payload must be an object`);l=e}catch(e){let t=c(td(`INVALID_PAYLOAD`,e instanceof Error?e.message:`Malformed callback payload`));return X(a,400,{ok:!1,error:`invalid-json`},o),t}if(i){let e=td(`NONCE_CONSUMED`,`Nonce has already been used`);return X(a,403,{ok:!1,error:`nonce-consumed`},o),e}if(!rd(typeof l.nonce==`string`?l.nonce:``,n)){let e=c(td(`INVALID_NONCE`,`Callback nonce did not match`));return X(a,403,{ok:!1,error:`invalid-nonce`},o),e}i=!0;let u=sd(l.selection);if(u){let e=c(td(`SELECTION_TOO_LARGE`,u));return X(a,413,{ok:!1,error:`selection-too-large`},o),e}if(ed(l.formData)){let e=od(l.formData);if(e){let t=c(td(`PAYLOAD_FIELD_TOO_LARGE`,e));return X(a,413,{ok:!1,error:`field-too-large`},o),t}}if(l.kind===`cancelled`){let e=typeof l.reason==`string`?l.reason:``;if(!$u.has(e)){let t=c(td(`INVALID_CANCEL_REASON`,`Unsupported cancel reason: ${e||`(missing)`}`));return X(a,400,{ok:!1,error:`invalid-cancel-reason`},o),t}let t=c({kind:`cancelled`,reason:e});return X(a,200,{ok:!0,kind:`cancelled`},o),t}let d=c(cd(l,e,t));return X(a,d.kind===`error`?400:200,{ok:d.kind!==`error`,kind:d.kind},o),d}}}const ud=new Map;function dd(e){return e.replace(/[|\\{}()[\]^$+*?.]/g,`\\$&`)}function fd(e){let t=`(?=[^>]*\\bid=['"]${dd(e)}['"])`;return RegExp(`(<script\\b(?=[^>]*\\btype=['"]application\\/json['"])${t}[^>]*>)[\\s\\S]*?(<\/script>)`,`i`)}function pd(e){ud.has(e.id)&&console.warn(`[viewer-registry] Overwriting viewer template "${e.id}"`),ud.set(e.id,e)}function md(e){return ud.get(e)}function hd(e){return typeof e==`string`&&ud.has(e)}function gd(){return[...ud.values()]}function _d(e,t,n,r){let i=fd(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 vd=import.meta.dirname??M(se(import.meta.url)),yd={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`]},bd={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`]},xd={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 Sd(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Cd(e,t){return Sd(t)?{...t,kind:e}:{kind:e}}function wd(e){let t=[...e===`canvas.html`?[N(vd,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`canvas`,`index.html`),N(vd,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`canvas`,`index.html`)]:[],N(vd,`..`,`..`,`..`,`viewers`,e),N(vd,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`src`,`static`,e),N(vd,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,`dist`,e),N(vd,`..`,`..`,`..`,`..`,`..`,`scaffold`,`general`,`viewers`,e),N(vd,`..`,`..`,`scaffold`,`general`,`viewers`,`dist`,e),N(vd,`..`,`..`,`scaffold`,`general`,`viewers`,e),N(vd,`..`,`viewers`,`dist`,e),N(vd,`..`,`viewers`,e)];for(let e of t)try{return k(e,`utf8`)}catch{}throw Error(`Viewer HTML not found: ${e}. Searched: ${t.join(`, `)}`)}let Td,Ed,Dd,Od,kd,Ad;function jd(){return Td??=wd(`c4-viewer.html`),Td}function Md(){return Ed??=wd(`tour-viewer.html`),Ed}function Nd(){return Dd??=wd(`canvas.html`),Dd}function Pd(){return Od??=wd(`architecture-static.html`),Od}function Fd(){return kd??=wd(`process-flow-static.html`),kd}function Id(){return Ad??=wd(`task-plan-static.html`),Ad}function Ld(){pd({id:`c4@1`,label:`C4 Architecture Diagram`,description:`Interactive C4 architecture diagram with zoom, pan, and ELK auto-layout`,inputSchema:yd,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:jd}),pd({id:`c4-static@1`,label:`C4 Architecture Diagram (Static)`,description:`Static SVG architecture diagram for inline rendering`,inputSchema:yd,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:Pd}),pd({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:Md}),pd({id:`process-flow-static@1`,label:`Process Flow Diagram (Static)`,description:`Static SVG process flow diagram for inline rendering`,inputSchema:bd,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:Fd}),pd({id:`task-plan-static@1`,label:`Task Execution Plan (Static)`,description:`Static SVG task execution plan for inline rendering`,inputSchema:xd,injectId:`diagram-data`,supportedTransports:[`mcp-app`],resolveHtml:Id}),pd({id:`task-plan@1`,label:`Task Execution Plan (Interactive)`,description:`Interactive task execution plan with ReactFlow, phase grouping, and dependency edges`,inputSchema:xd,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:Nd,transformData:e=>Cd(`task-plan`,e)}),pd({id:`process-flow@1`,label:`Process Flow Diagram (Interactive)`,description:`Interactive process flow diagram with ReactFlow`,inputSchema:bd,injectId:`diagram-data`,supportedTransports:[`browser`],resolveHtml:Nd,transformData:e=>Cd(`process-flow`,e)})}function Rd(){let e=new rr;for(let t of or.list())e.register(t);return e.register(ar),e.register(ur),e.register(dr),e.register(sr),e}function zd(e,t){return e?.supportedTransports.includes(t)??!1}const Bd=Rd();function Vd(e){if(e.template)return Bd.get(e.template)}function Hd(e){if((e.actions?.length??0)>0)return!0;if(e.template&&hd(e.template)){let t=md(e.template);return t?.supportedTransports.includes(`browser`)===!0&&!t.supportedTransports.includes(`mcp-app`)}let t=Vd(e);return zd(t,`browser`)&&!zd(t,`mcp-app`)}Ld();const Ud=String.raw`(function(){
|
|
250
250
|
'use strict';
|
|
251
251
|
|
|
252
252
|
var SVG_NS = 'http://www.w3.org/2000/svg';
|
|
@@ -2635,7 +2635,7 @@ Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_rad
|
|
|
2635
2635
|
}
|
|
2636
2636
|
mermaid.initialize({ startOnLoad: false, theme: theme });
|
|
2637
2637
|
mermaid.run();
|
|
2638
|
-
};`,onload:`window.__aikit_initMermaid&&window.__aikit_initMermaid()`,local:{route:`/vendor/mermaid.min.js`,getSource:Wd()}},Kd=new Map([[`mermaid`,Gd]]);function qd(e,t){if(!e?.length)return;let n=[];for(let r of e){let e=Kd.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 Jd(){let e=[];for(let t of Kd.values())t.local&&e.push({route:t.local.route,getSource:t.local.getSource,cdn:t.cdn});return e}const Yd=300*1e3;let
|
|
2638
|
+
};`,onload:`window.__aikit_initMermaid&&window.__aikit_initMermaid()`,local:{route:`/vendor/mermaid.min.js`,getSource:Wd()}},Kd=new Map([[`mermaid`,Gd]]);function qd(e,t){if(!e?.length)return;let n=[];for(let r of e){let e=Kd.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 Jd(){let e=[];for(let t of Kd.values())t.local&&e.push({route:t.local.route,getSource:t.local.getSource,cdn:t.cdn});return e}const Yd=300*1e3;let Z=null;process.on(`exit`,()=>{let e=Z;if(e){try{e.close()}catch{}Z=null}});function Xd(e){let t=typeof e.description==`string`&&e.description.trim().length>0?`<p class="present-surface-description">${J(e.description)}</p>`:``;return[`<h1 class="present-surface-title">${J(e.title)}</h1>`,t].filter(Boolean).join(`
|
|
2639
2639
|
`)}function Zd(e,t){return e.length===0?``:`
|
|
2640
2640
|
<section class="present-surface-actions">
|
|
2641
2641
|
<div class="present-action-bar">${e.map(e=>{let t=J(e.id),n=J(e.label);return e.type===`select`||e.type===`multi-select`?`<label class="present-action-field"><span>${n}</span><select data-action-id="${t}"${e.type===`multi-select`?` multiple`:``}>${(e.options??[]).map(e=>`<option value="${J(e.value)}">${J(e.label)}</option>`).join(``)}</select></label>`:`<button type="button" class="present-action-btn present-action-${J(e.variant??`default`)}" data-action-id="${t}" data-action-label="${n}">${n}</button>`}).join(``)}</div>
|
|
@@ -2763,8 +2763,8 @@ Complements: \`symbol\` (single lookup), \`trace\` (call-chain AST), \`blast_rad
|
|
|
2763
2763
|
navigator.sendBeacon('/callback', new Blob([body], { type: 'application/json' }));
|
|
2764
2764
|
});
|
|
2765
2765
|
})();
|
|
2766
|
-
<\/script>`}function Qd(e){try{bn(process.platform===`win32`?`start "" "${e}"`:process.platform===`darwin`?`open "${e}"`:`xdg-open "${e}"`)}catch{}}function $d(e,t,n){let r=[e.title];return e.description&&r.push(e.description),r.push(``,`Opened in browser at ${t}`,n),r.join(`
|
|
2767
|
-
`)}function
|
|
2766
|
+
<\/script>`}function Qd(e){try{bn(process.platform===`win32`?`start "" "${e}"`:process.platform===`darwin`?`open "${e}"`:`xdg-open "${e}"`)}catch{}}async function $d(e){try{let t=kn();await t.launch(`ui`),await(await t.getContext().newPage()).goto(e,{waitUntil:`domcontentloaded`})}catch{Qd(e)}}function ef(e,t,n){let r=[e.title];return e.description&&r.push(e.description),r.push(``,`Opened in browser at ${t}`,n),r.join(`
|
|
2767
|
+
`)}function tf(e){return e.some(e=>e.id!==`__dismiss`)}function nf(e){return e.replace(`</head>`,`<style>
|
|
2768
2768
|
.toolbar, .badge, body > header, body > footer { display: none !important; }
|
|
2769
2769
|
body { padding-top: 0 !important; margin-top: 0 !important; }
|
|
2770
2770
|
</style>
|
|
@@ -2775,8 +2775,8 @@ window.addEventListener('message', function(e) {
|
|
|
2775
2775
|
}
|
|
2776
2776
|
});
|
|
2777
2777
|
<\/script>
|
|
2778
|
-
</body>`)}function
|
|
2779
|
-
`);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=
|
|
2778
|
+
</body>`)}function rf(){let e=Z;e&&(e.close(),Z=null)}async function af(e,t){if(uf(`<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=Gt({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(`
|
|
2779
|
+
`);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=nf(_d(t.resolveHtml(),e.data??null,t.injectId,t.transformData)),r=ir({title:e.title,html:[Xd(e),`<div class="present-viewer-container">`,` <iframe class="present-viewer-iframe" src="/viewer" sandbox="allow-scripts allow-same-origin"></iframe>`,` <script>
|
|
2780
2780
|
(function() {
|
|
2781
2781
|
const iframe = document.querySelector('.present-viewer-iframe');
|
|
2782
2782
|
if (!iframe) return;
|
|
@@ -2792,11 +2792,11 @@ window.addEventListener('message', function(e) {
|
|
|
2792
2792
|
})();
|
|
2793
2793
|
<\/script>`,`</div>`].join(`
|
|
2794
2794
|
`),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(`
|
|
2795
|
-
`)],islands:[],payload:void 0,nonce:``,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`browser`,exportPolicy:`local-interactive`}),i=``;try{
|
|
2796
|
-
`),css:t.css,islands:t.islands,payload:t.payload,nonce:t.nonce,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`browser`,exportPolicy:t.exportPolicy,headScripts:r}),o=``,s=``;try{let e=
|
|
2797
|
-
`)}),r.length=0)},a=0;for(;a<t.length;){let e=t[a],o=t[a+1];if(o!==void 0&&
|
|
2798
|
-
`)}function
|
|
2799
|
-
`)}const
|
|
2795
|
+
`)],islands:[],payload:void 0,nonce:``,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`browser`,exportPolicy:`local-interactive`}),i=``;try{rf(),i=await new Promise((e,t)=>{let i=pr((e,t)=>{if(e.url===`/viewer`){t.writeHead(200,{"Content-Type":`text/html; charset=utf-8`}),t.end(n);return}t.writeHead(200,{"Content-Type":`text/html; charset=utf-8`}),t.end(r)});i.listen(0,`127.0.0.1`,()=>{let n=i.address();if(typeof n!=`object`||!n){t(Error(`Failed to resolve local browser address`));return}Z=i,e(`http://127.0.0.1:${n.port}`)})})}catch(t){return{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 $d(i),{content:[{type:`text`,text:ef(e,i,`Rendered.`)}],structuredContent:{kind:`rendered`,reason:`no-response-required`}}}async function of(e){uf(`<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=fr(e,{transport:`browser`,registry:Bd,blockVendorScripts:Zu()}),n=ld(t.surfaceId,t.actions),r=qd(t.vendorScripts,`browser`),i=Jd(),a=ir({title:e.title,html:[Xd(e),t.html,Zd(t.actions,n.nonce)].filter(Boolean).join(`
|
|
2796
|
+
`),css:t.css,islands:t.islands,payload:t.payload,nonce:t.nonce,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`browser`,exportPolicy:t.exportPolicy,headScripts:r}),o=``,s=``;try{let e=Z;e&&(e.close(),Z=null),o=await new Promise((e,t)=>{let r=pr((e,t)=>{if(e.method===`OPTIONS`){t.writeHead(204,{"Access-Control-Allow-Origin":s||`*`,"Access-Control-Allow-Methods":`POST`,"Access-Control-Allow-Headers":`Content-Type`}),t.end();return}if(e.method===`POST`&&e.url===`/callback`){n.handle(e,t,s);return}let r=i.find(t=>e.url===t.route);if(r){let e=r.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:r.cdn}),t.end();return}t.writeHead(200,{"Content-Type":`text/html; charset=utf-8`}),t.end(a)});r.listen(0,`127.0.0.1`,()=>{let n=r.address();if(typeof n!=`object`||!n){t(Error(`Failed to resolve local browser address`));return}Z=r,s=`http://127.0.0.1:${n.port}`,e(s)})})}catch(t){return{content:[{type:`text`,text:`${e.title}\n\nUnable to start local browser transport.`}],structuredContent:n.settleError(`BROWSER_START_FAILED`,t instanceof Error?t.message:`Unable to start browser transport`),isError:!0}}if($d(o),!tf(t.actions)){let t=Z;return t&&(n.promise.finally(()=>{Z===t&&(t.close(),Z=null)}),setTimeout(()=>{Z===t&&(t.close(),Z=null)},Yd)),{content:[{type:`text`,text:ef(e,o,`Rendered.`)}],structuredContent:{kind:`rendered`,reason:`no-response-required`}}}let c=await Promise.race([n.promise,new Promise(e=>{setTimeout(()=>e(n.settleTimeout(Yd)),Yd)})]),l=Z;l&&(l.close(),Z=null);let u=c.kind===`result`?`Selected action: ${c.result.actionId}`:c.kind===`timeout`?`Timed out after ${c.waitedMs}ms.`:c.kind===`cancelled`?`Cancelled: ${c.reason}.`:c.kind===`error`?`Error: ${c.error.message}`:`Rendered.`;return{content:[{type:`text`,text:ef(e,o,u)}],structuredContent:c,isError:c.kind===`error`}}const sf=`ui://aikit/present.html`;let cf=``;function lf(){return cf}function uf(e){cf=e}function df(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}const ff=/\\u[0-9a-fA-F]{4}/,pf=/^\s*\|(?:[^|\r\n]+\|){2,}\s*$/,mf=/^\s*\|?(?:\s*:?-{3,}:?\s*\|){2,}\s*$/,hf=/\b(cli|terminal|tty|console|command(?:-|\s)?line)\b/i;function gf(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 _f(e){let t=e.split(/\r?\n/);for(let e=0;e<t.length-1;e+=1)if(pf.test(t[e])&&mf.test(t[e+1]))return!0;return!1}function vf(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 yf(e,t){if(t<2)return!1;let n=e.trim();return n.startsWith(`|`)?vf(n).length===t:!1}function bf(e){let t=e.split(/\r?\n/),n=[],r=[],i=()=>{r.length!==0&&(n.push({type:`text`,content:r.join(`
|
|
2797
|
+
`)}),r.length=0)},a=0;for(;a<t.length;){let e=t[a],o=t[a+1];if(o!==void 0&&pf.test(e)&&mf.test(o)){let r=vf(e),o=[];i();let s=a+2;for(;s<t.length&&yf(t[s],r.length);)o.push(vf(t[s])),s+=1;n.push({type:`table`,headers:r,rows:o}),a=s;continue}r.push(e),a+=1}return i(),n}function xf(e){let t=gf(e);return!t||!_f(t)?[e]:bf(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 Sf(e){if(typeof e==`string`)return hf.test(e);if(Array.isArray(e))return e.some(e=>Sf(e));if(!df(e))return!1;let t=[`client`,`clientInfo`,`host`,`source`,`mode`,`name`,`title`,`channel`];return Object.entries(e).some(([e,n])=>t.includes(e)?Sf(n):!1)}function Cf(e,t){return{preferBrowser:[t,e._meta,df(e.metadata)?e.metadata.source:void 0].some(e=>Sf(e))}}function wf(e){if(!e.template)return!0;let t=md(e.template);return t?t.supportedTransports.includes(`browser`):Vd(e)?.supportedTransports.includes(`browser`)??!1}function Tf(e){let t=typeof e.description==`string`&&e.description.trim().length>0?`<p class="present-surface-description">${J(e.description)}</p>`:``;return[`<section class="present-surface-header">`,` <h1>${J(e.title)}</h1>`,t,`</section>`,`<style>`,` .present-surface-header { display: grid; gap: 0.75rem; margin-bottom: 1.5rem; }`,` .present-surface-header h1 { margin: 0; font-size: 1.875rem; }`,` .present-surface-description { margin: 0; color: var(--dt-text-secondary, #475467); }`,`</style>`].filter(Boolean).join(`
|
|
2798
|
+
`)}function Ef(e,t){let n=[e.title];return e.description&&n.push(e.description),lr(t)?n.push(``,`Selected action: ${t.result.actionId}`):cr(t)?n.push(``,`Error: ${t.error.message}`):t.kind===`timeout`?n.push(``,`Timed out after ${t.waitedMs}ms.`):t.kind===`cancelled`&&n.push(``,`Cancelled: ${t.reason}.`),n.join(`
|
|
2799
|
+
`)}const Df={id:`__dismiss`,type:`button`,label:`Done`,variant:`default`};function Of(e){if((e.actions?.length??0)>0||!e.template)return e;let t=Vd(e);return t?.supportedTransports.includes(`browser`)===!0&&!t.supportedTransports.includes(`mcp-app`)?{...e,actions:[Df]}:e}function kf(e){return e.replace(`</head>`,`<style>
|
|
2800
2800
|
.toolbar, .badge, body > header, body > footer { display: none !important; }
|
|
2801
2801
|
body { padding-top: 0 !important; margin-top: 0 !important; }
|
|
2802
2802
|
</style>
|
|
@@ -2818,7 +2818,7 @@ window.addEventListener('message', function(e) {
|
|
|
2818
2818
|
}
|
|
2819
2819
|
});
|
|
2820
2820
|
<\/script>
|
|
2821
|
-
</body>`)}function
|
|
2821
|
+
</body>`)}function Af(e){let t=`<script>
|
|
2822
2822
|
(function(){
|
|
2823
2823
|
var last=0;
|
|
2824
2824
|
function notify(){
|
|
@@ -2829,8 +2829,8 @@ window.addEventListener('message', function(e) {
|
|
|
2829
2829
|
if(typeof ResizeObserver!=="undefined"){new ResizeObserver(notify).observe(document.documentElement)}
|
|
2830
2830
|
else{setInterval(notify,500)}
|
|
2831
2831
|
})();
|
|
2832
|
-
<\/script>`;return e.includes(`</body>`)?e.replace(`</body>`,`${t}</body>`):`${e}${t}`}function
|
|
2833
|
-
`);return
|
|
2832
|
+
<\/script>`;return e.includes(`</body>`)?e.replace(`</body>`,`${t}</body>`):`${e}${t}`}function jf(e,t,n){return{content:[{type:`text`,text:`[ERROR:VALIDATION] ${t}`}],isError:!0}}function Mf(e,t){if(!df(e)||!(`schemaVersion`in e))return{ok:!1,response:jf(`INVALID_CHANNEL_SURFACE`,`present expects a ChannelSurface object with schemaVersion: 1`)};if(e.schemaVersion!==1)return{ok:!1,response:jf(`UNSUPPORTED_SCHEMA_VERSION`,`Unsupported ChannelSurface schemaVersion: ${String(e.schemaVersion)}`)};if(typeof e.title==`string`&&ff.test(e.title))return{ok:!1,response:jf(`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(!df(e)||e.type!==`markdown`)return[e];let t=gf(e);return!t||!_f(t)?[e]:xf(e)})}:e;return{ok:!0,surface:n,options:Cf(n,t)}}async function Nf(e,t={}){let n=Of(e);if(e.template){let r=md(e.template);if(r)return await Pf(n,r,t)}return Hd(n)||t.preferBrowser&&wf(n)?await of(n):Ff(n)}async function Pf(e,t,n={}){if(e.data!=null&&t.inputSchema){let n=Gt({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(`
|
|
2833
|
+
`);return jf(`VIEWER_DATA_INVALID`,`Template "${t.id}" data validation failed:\n${e}\n\nExpected schema: ${JSON.stringify(t.inputSchema,null,2)}`)}}let r=t.supportedTransports.includes(`browser`),i=t.supportedTransports.includes(`mcp-app`);if(n.preferBrowser&&r||r&&!i)return await af(e,t);if(!i)return jf(`VIEWER_TRANSPORT_UNSUPPORTED`,`Viewer template "${t.id}" does not support an available transport`);try{let n=kf(_d(t.resolveHtml(),e.data??null,t.injectId,t.transformData)).replace(/&/g,`&`).replace(/"/g,`"`);return uf(Af(ir({title:e.title,html:[Tf(e),`<div class="present-viewer-container">`,` <iframe class="present-viewer-iframe" srcdoc="${n}" sandbox="allow-scripts allow-same-origin"></iframe>`,` <script>
|
|
2834
2834
|
(function() {
|
|
2835
2835
|
const iframe = document.querySelector('.present-viewer-iframe');
|
|
2836
2836
|
if (!iframe) return;
|
|
@@ -2853,16 +2853,16 @@ window.addEventListener('message', function(e) {
|
|
|
2853
2853
|
});
|
|
2854
2854
|
<\/script>`,`</div>`].join(`
|
|
2855
2855
|
`),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(`
|
|
2856
|
-
`)],islands:[],payload:void 0,nonce:``,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`mcp-app`,exportPolicy:`local-interactive`}))),{content:[{type:`text`,text:[
|
|
2856
|
+
`)],islands:[],payload:void 0,nonce:``,generatedAt:new Date().toISOString(),colorScheme:e.colorScheme,lang:e.lang,dir:e.dir,transport:`mcp-app`,exportPolicy:`local-interactive`}))),{content:[{type:`text`,text:[Ef(e,{kind:`rendered`,reason:`no-response-required`}),`If this content doesn't render inline, retry with format: 'browser'.`].join(`
|
|
2857
2857
|
|
|
2858
|
-
`)}],ui:{type:`resource`,uri:
|
|
2859
|
-
`),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,headScripts:n})),{content:[{type:`text`,text:[
|
|
2858
|
+
`)}],ui:{type:`resource`,uri:sf}}}catch(e){return jf(`VIEWER_RENDER_FAILED`,e instanceof Error?e.message:`Failed to render viewer template`)}}function Ff(e){try{let t=fr(e,{transport:`mcp-app`,registry:Bd,blockVendorScripts:Zu()}),n=qd(t.vendorScripts,`mcp-app`);return cf=Af(ir({title:e.title,html:[Tf(e),t.html].filter(Boolean).join(`
|
|
2859
|
+
`),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,headScripts:n})),{content:[{type:`text`,text:[Ef(e,{kind:`rendered`,reason:`no-response-required`}),`If this content doesn't render inline, retry with format: 'browser'.`].join(`
|
|
2860
2860
|
|
|
2861
|
-
`)}],ui:{type:`resource`,uri:
|
|
2862
|
-
`);
|
|
2861
|
+
`)}],ui:{type:`resource`,uri:sf}}}catch(e){return jf(`RENDER_FAILED`,e instanceof Error?e.message:`Failed to render ChannelSurface`)}}const If=L.object({label:L.string(),value:L.string(),description:L.string().optional()}),Lf=L.object({id:L.string().describe(`Unique action identifier`),type:L.enum([`button`,`select`,`multi-select`,`form-submit`,`text-submit`,`confirm`,`custom`]).describe(`Interactive action type`),label:L.string().describe(`Visible action label`),variant:L.enum([`primary`,`danger`,`default`]).optional(),options:L.array(If).optional(),schema:L.record(L.string(),L.unknown()).optional()}),Rf=L.object({type:L.string(),title:L.string().optional(),value:L.unknown().optional(),language:L.string().optional()}).catchall(L.unknown()),zf={schemaVersion:L.literal(1).describe(`ChannelSurface schema version. Must be 1.`),title:L.string().describe(`Surface title shown to the user.`),description:L.string().optional().describe(`Optional supporting copy for the surface.`),template:L.string().optional().describe(`Optional template id such as report@1.`),layout:L.object({maxWidth:L.string().optional(),padding:L.string().optional(),columns:L.number().optional()}).optional(),blocks:L.array(Rf).optional().describe(`Typed block content for the surface.`),data:L.unknown().optional().describe(`Template data payload, if the template expands data.`),actions:L.array(Lf).optional().describe(`Interactive actions. Presence triggers browser transport.`),response:L.object({timeout:L.number().optional(),required:L.boolean().optional()}).optional(),metadata:L.object({surfaceId:L.string().optional(),createdAt:L.string().optional(),source:L.string().optional()}).optional(),colorScheme:L.enum([`light`,`dark`,`auto`]).optional(),lang:L.string().optional(),dir:L.enum([`ltr`,`rtl`,`auto`]).optional()};L.object({surfaceId:L.string(),actionId:L.string(),actionType:L.enum([`button`,`select`,`multi-select`,`form-submit`,`text-submit`,`confirm`,`custom`]),value:L.unknown().optional(),formData:L.record(L.string(),L.unknown()).optional(),selection:L.union([L.string(),L.array(L.string())]).optional(),label:L.string().optional(),timestamp:L.string(),sourceTransport:L.enum([`mcp-app`,`browser`,`export`])});function Bf(e,t){let n=W(`present`),r=[`Render a ChannelSurface for the user.`,`Quick ref:`,`- Full schema: aikit://schemas/channel-surface`,`- Required: schemaVersion: 1, title`,`- Content: blocks[] for direct rendering, or template + data for registry-backed rendering`,`- Actions: actions[] of SurfaceAction; interactive surfaces use browser transport and return ChannelOutcome`,`- Optional fields: description, layout, response, metadata, colorScheme, lang, dir`,`- Transports: mcp-app, browser, export`,`- Use schema resource for block enums and action details.`].join(`
|
|
2862
|
+
`);Xn(e,`present`,{title:n.title,description:r,inputSchema:zf,annotations:n.annotations,_meta:{ui:{resourceUri:sf}}},async(e,t)=>{let n=Mf(e,t);return n.ok?await Nf(n.surface,n.options):n.response});try{Yn(e,`Present View`,sf,{description:`AI Kit present tool viewer`},async()=>({contents:[{uri:sf,mimeType:Jn,text:lf()||`<html><body><p>No content generated yet. Call the present tool first.</p></body></html>`}]}))}catch{}try{e.registerResource(`present-templates`,`aikit://present/templates`,{description:`List all registered present viewer templates with their input schemas`},async()=>{let e=gd().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{}}const Vf=F(`tools`);function Hf(e,t){let n=new Fn({structure:new Ln,dependencies:new Mn,symbols:new Rn,patterns:new In,entryPoints:new Pn,diagrams:new Nn}),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:L.string().optional().describe(`Root path to analyze (defaults to workspace root)`),aspects:L.array(L.enum([`all`,`structure`,`dependencies`,`symbols`,`patterns`,`entry-points`,`diagrams`])).default([`all`]).describe(`Which analysis aspects to run`)},annotations:r.annotations},async({scope:e,aspects:r})=>{try{let i=e??`.`;Vf.info(`Running knowledge production`,{rootPath:i,aspects:r});let a=await n.runExtraction(i,r);try{let e=t?.onboardDir??``;if(!e)throw Vf.warn(`onboardDir not configured — skipping artifact persistence.`),Error(`skip`);O(e,{recursive:!0});let n=`<!-- Generated by produce_knowledge at ${new Date().toISOString()} -->\n\n`;for(let[t,r]of Object.entries(a))r&&typeof r==`string`&&ne(N(e,`${t}.md`),n+r,`utf-8`);Vf.info(`Knowledge persisted to .ai/context/`,{files:Object.keys(a).length})}catch(e){Vf.warn(`Failed to persist knowledge to .ai/context/`,{error:I(e)})}return{content:[{type:`text`,text:n.buildSynthesisInstructions(a,r)+`
|
|
2863
2863
|
|
|
2864
2864
|
---
|
|
2865
|
-
_Next: Review the baselines above and use \`remember\` to store synthesized knowledge entries._`}]}}catch(e){return
|
|
2865
|
+
_Next: Review the baselines above and use \`remember\` to store synthesized knowledge entries._`}]}}catch(e){return Vf.error(`Knowledge production failed`,I(e)),q(`INTERNAL`,`Knowledge production failed: ${e instanceof Error?e.message:String(e)}`)}})}const Uf=F(`tools`);function Wf(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:L.boolean().default(!1).describe(`If true, force full re-index ignoring file hashes`),force:L.boolean().default(!1).describe(`If true, override smart indexing guard and run reindex anyway`)},annotations:s.annotations},async({full:e,force:s},c)=>{try{if(t.isIndexing)return{content:[{type:`text`,text:`## Reindex Already in Progress
|
|
2866
2866
|
|
|
2867
2867
|
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
|
|
2868
2868
|
|
|
@@ -2870,40 +2870,40 @@ Smart indexing (trickle mode) is enabled — files are automatically indexed as
|
|
|
2870
2870
|
|
|
2871
2871
|
**If the index is severely outdated**, use \`reindex({ force: true })\` to override.
|
|
2872
2872
|
|
|
2873
|
-
Use \`status({})\` to check smart indexing queue status.`}]};let l=
|
|
2873
|
+
Use \`status({})\` to check smart indexing queue status.`}]};let l=bs(c).createTask(`Reindex`,1);l.progress(0,`Starting ${e?`full`:`incremental`} reindex`),Uf.info(`Starting background re-index`,{mode:e?`full`:`incremental`});let u=e=>t=>{t.phase===`chunking`&&t.currentFile&&Uf.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(Uf.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(),Uf.info(`FTS index rebuilt after reindex`)}catch(e){Uf.warn(`FTS index rebuild failed`,I(e))}try{let e=await r.reindexAll();Uf.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){Uf.warn(`Curated re-index failed`,I(e))}if(a)try{await a.notifyAfterReindex()}catch(e){Uf.warn(`Post-reindex resource notification failed`,I(e))}}).catch(e=>{l.fail(`Reindex failed: ${e instanceof Error?e.message:String(e)}`),Uf.error(`Background reindex failed`,I(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 Uf.error(`Reindex failed`,I(e)),q(`INTERNAL`,`Reindex failed: ${e instanceof Error?e.message:String(e)}`)}})}const Gf=F(`tools`);function Kf(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:L.enum([`list`,`clear`]).default(`list`).describe(`Action: "list" (default) to view entries, "clear" to wipe the log`),last:L.number().optional().describe(`Number of entries to return (default: 20, list only)`),tool:L.string().optional().describe(`Filter by tool name (list only)`),source:L.enum([`mcp`,`cli`]).optional().describe(`Filter by source: "mcp" or "cli" (list only)`),since:L.string().optional().describe(`ISO timestamp — only show entries after this time (list only)`)},annotations:t.annotations},async({action:e,last:t,tool:n,source:r,since:i})=>{try{if(e===`clear`)return Bt(),{content:[{type:`text`,text:`Replay log cleared.`}]};let a=Vt({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 Ht().catch(()=>{}),{content:[{type:`text`,text:`**Replay Log** (${a.length} entries)\n\n${o.join(`
|
|
2874
2874
|
|
|
2875
|
-
`)}`}]}}catch(e){return
|
|
2875
|
+
`)}`}]}}catch(e){return Gf.error(`Replay failed`,I(e)),q(`INTERNAL`,`Replay failed: ${e instanceof Error?e.message:String(e)}`)}})}const qf=F(`tools`);function Jf(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:L.enum([`list`,`restore`]).describe(`list: show restore points, restore: apply a restore point`),id:L.string().optional().describe(`Restore point ID (required for action=restore)`),limit:L.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=ht().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(`
|
|
2876
2876
|
`)}`}]}}if(!t)throw Error(`id is required for restore action`);let r=await Ut(t);return{content:[{type:`text`,text:`Restored ${r.length} files:\n${r.map(e=>`- \`${e}\``).join(`
|
|
2877
|
-
`)}`}]}}catch(e){return
|
|
2878
|
-
`)[0].slice(0,500);if(r&&r!==e){let i=await t.embedQuery(r),a=await n.search(i,S);a.length>0&&(C=a,E=`> _Original query "${e}" returned 0 results. Auto-reformulated to "${r}"._\n\n`,
|
|
2877
|
+
`)}`}]}}catch(e){return qf.error(`Restore failed`,I(e)),q(`INTERNAL`,`Restore failed: ${e instanceof Error?e.message:String(e)}`)}})}const Yf=/<\/?curated-context>/gi;function Xf(e){return e.replace(Yf,``)}function Zf(e){return`<curated-context>\n${Xf(e)}\n</curated-context>`}const Qf=F(`tools`);function $f(e,t,i,a){r(e,t,i);let o=e.memoryMetaGet(t);if(!o)return;let s=_(o,{...n,...a});s&&(v(e,t,s),h(e,t,i))}function ep(e,t){let n=[],r=re(process.cwd());r&&n.push(`[project: ${r}]`);let i=t?Zt(t,`__context_boost`):void 0;return i&&n.push(`[focus: ${i.value}]`),n.length===0?e:`${n.join(` `)} ${e}`}function tp(e,t,n){return n?e:t===`curated`?e*1.2:e}function np(e,t){return t?e:e.map(e=>({record:e.record,score:tp(e.score,e.record.origin,t)})).sort((e,t)=>t.score-e.score)}async function rp(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:qn(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 Qf.warn(`ER fallback failed`,I(e)),{results:n,triggered:!0,cacheHit:a}}}function ip(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}))}function ap(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 op(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 sp(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&&!cp.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 cp=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 lp(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 _n(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 up(e,t,n,r,i,a,o,s,c,l){let u=W(`search`);e.registerTool(`search`,{title:u.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:bo,inputSchema:{query:L.string().max(5e3).describe(`Natural language search query`),limit:L.number().min(1).max(20).default(5).describe(`Maximum results to return`),search_mode:L.enum([`hybrid`,`semantic`,`keyword`]).default(`hybrid`).describe(`Search strategy: hybrid (vector + FTS + RRF fusion, default), semantic (vector only), keyword (FTS only)`),content_type:L.enum(le).optional().describe(`Filter by content type`),source_type:L.enum(fe).optional().describe(`Coarse filter: "source" (code only), "documentation" (md, curated), "test", "config". Overrides content_type if both set.`),origin:L.enum(de).optional().describe(`Filter by knowledge origin`),category:L.string().optional().describe(`Filter by category (e.g., decisions, patterns, conventions)`),tags:L.array(L.string()).optional().describe(`Filter by tags (returns results matching ANY of the specified tags)`),min_score:L.number().min(0).max(1).default(.25).describe(`Minimum similarity score`),graph_hops:L.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:L.number().min(100).max(5e4).optional().describe(`Maximum token budget for the response. When set, output is truncated to fit.`),dedup:L.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:L.array(L.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:u.annotations},async({query:e,limit:u,search_mode:d,content_type:f,source_type:p,origin:m,category:h,tags:g,min_score:_,graph_hops:v,max_tokens:y,dedup:b,workspaces:x})=>{try{let S={limit:u,minScore:_,contentType:f,sourceType:p,origin:m,category:h,tags:g},C,w=!1,T=!1,E=``,D=ep(e,s);if(d===`keyword`)C=await n.ftsSearch(e,S),C=C.slice(0,u);else if(d===`semantic`){let r=await t.embedQuery(D);C=await n.search(r,S);let a=await rp(i,C[0]?.score??0,C,e,u);C=a.results,w=a.triggered,T=a.cacheHit}else{let r=await t.embedQuery(D),a=n.coarseSearch,o=a?a.bind(n):n.search.bind(n),[s,c]=await Promise.all([o(r,{...S,limit:u*2}),n.ftsSearch(e,{...S,limit:u*2}).catch(()=>[])]);s.length===0&&c.length>0?(C=c.slice(0,u),E=` (FTS-only: vector index rebuilding)`):C=c.length===0&&s.length>0?s.slice(0,u):ip(s,c).slice(0,u);let l=await rp(i,s[0]?.score??0,C,e,u);C=l.results,w=l.triggered,T=l.cacheHit}C=np(C,m).slice(0,u),a&&a.recordSearch(e,w,T),C.length>1&&(C=ap(C,e)),C=op(C);let O=``;if(x&&x.length>0){let n=Xs(x,he(process.cwd()));if(n.length>0){let{stores:r,closeAll:i}=await Zs(n);try{let i;i=d===`keyword`?await $s(r,e,{...S,limit:u}):await Qs(r,await t.embedQuery(e),{...S,limit:u});for(let e of i)C.push({record:{...e.record,sourcePath:`[${e.workspace}] ${e.record.sourcePath}`},score:e.score});C=C.sort((e,t)=>t.score-e.score).slice(0,u),O=` + ${n.length} workspace(s)`}finally{await i()}}}if(b===`file`&&C.length>1){let e=new Map;for(let t of C){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}]})}C=[...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(C.length>1){let e=C[0].score,t=Math.max(e*.4,.1);C=C.filter(e=>e.score>=t)}if(C.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})).text.trim().split(`
|
|
2878
|
+
`)[0].slice(0,500);if(r&&r!==e){let i=await t.embedQuery(r),a=await n.search(i,S);a.length>0&&(C=a,E=`> _Original query "${e}" returned 0 results. Auto-reformulated to "${r}"._\n\n`,Qf.info(`Smart search fallback succeeded`,{originalQuery:e,altQuery:r,resultCount:a.length}))}}catch(e){Qf.debug(`Smart search fallback failed`,{error:String(e)})}if(C.length===0)return{content:[{type:`text`,text:`No results found for the given query.`}],structuredContent:{results:[],totalResults:0,searchMode:d,query:e}}}let k,A;if(v>0&&!r&&(A="> **Note:** `graph_hops` was set but no graph store is available. Graph augmentation skipped."),v>0&&r)try{let e=await rt(r,C.map(e=>({recordId:e.record.id,score:e.score,sourcePath:e.record.sourcePath})),{hops:v,maxPerHit:5});k=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(`
|
|
2879
2879
|
`),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(`
|
|
2880
2880
|
`),i=[`- **Graph Context** (${v} hop${v>1?`s`:``}):`];e&&i.push(` Entities:\n${e}`),r&&i.push(` Relationships:\n${r}`),k.set(t.recordId,i.join(`
|
|
2881
|
-
`))}}catch(e){
|
|
2882
|
-
`)}\n\n${n.origin===`curated`?
|
|
2881
|
+
`))}}catch(e){Qf.warn(`Graph augmentation failed`,I(e)),A=`> **Note:** Graph augmentation failed. Results shown without graph context.`}let j=Date.now();for(let e of C)if(e.record.origin===`curated`&&e.record.indexedAt){let t=j-new Date(e.record.indexedAt).getTime(),n=Math.max(0,t/864e5);e.score*=.95**n}if(C.sort((e,t)=>t.score-e.score),C=we(C),s)for(let e of C){if(e.record.origin!==`curated`)continue;let t=wl(e.record.sourcePath);t&&$f(s,t,c,l)}let ee=C.map((e,t)=>{let n=e.record;return`${`### Result ${t+1} (score: ${e.score.toFixed(3)})`}\n${[`- **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,k?.get(n.id)??null].filter(Boolean).join(`
|
|
2882
|
+
`)}\n\n${n.origin===`curated`?Zf(n.content):n.content}`}).join(`
|
|
2883
2883
|
|
|
2884
2884
|
---
|
|
2885
2885
|
|
|
2886
|
-
`),te=(d===`hybrid`?`hybrid (vector + keyword RRF)`:d===`keyword`?`keyword (FTS)`:`semantic (vector)`)+O,ne=
|
|
2886
|
+
`),te=(d===`hybrid`?`hybrid (vector + keyword RRF)`:d===`keyword`?`keyword (FTS)`:`semantic (vector)`)+O,ne=sp(C,e),re=ne.length>0?`\n_Distinctive terms: ${ne.map(e=>`\`${e}\``).join(`, `)}_`:``,M=await lp(n,C),ie=[];if(C.length===0)ie.push("`reindex` — no results found, index may be stale"),ie.push("`find` — try federated search with glob/regex");else{let e=C[0]?.record.sourcePath;e&&ie.push(`\`lookup\` — see all chunks from \`${e}\``),ie.push("`symbol` — resolve a specific symbol from the results"),ie.push("`compact` — compress a result file for focused reading")}let N=[A?`${A}\n\n`:``,M?`${M}\n\n`:``,ee,`\n\n---\n_Search mode: ${te} | ${C.length} results_${re}`,`\n_Next: ${ie.join(` | `)}_`],ae=E+N.join(``);y&&(ae=sn(ae,y));let P=new Set,oe=[];for(let e of C){if(e.record.origin!==`curated`||e.record.sourcePath.startsWith(`[`))continue;let t=wl(e.record.sourcePath);if(!t)continue;let n=Sl(t,e.record.headingPath??t);n&&!P.has(n.uri)&&(P.add(n.uri),oe.push(n))}return{content:[{type:`text`,text:ae},...oe],structuredContent:{results:C.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}:{}})),totalResults:C.length,searchMode:d,query:e}}}catch(e){return Qf.error(`Search failed`,I(e)),q(`INTERNAL`,`Search failed: ${e instanceof Error?e.message:String(e)}`)}})}const dp=F(`tools`);function fp(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:L.enum([`tools`,`stash`,`all`]).default(`all`).describe(`What to include: tools (replay only), stash (stash + checkpoints only), or all`),since:L.string().optional().describe(`ISO timestamp — only include activity after this time`),last:L.number().min(1).max(500).optional().describe(`Max replay entries to consider (default: 50)`),focus:L.string().optional().describe(`Focus query — prioritize entries matching this topic`),mode:L.enum([`deterministic`,`sampling`]).default(`deterministic`).describe(`Summary mode: deterministic (fast, template-based) or sampling (LLM-assisted, richer)`),token_budget:L.number().min(100).max(8e3).default(2e3).describe(`Target token budget for the digest output`),persist:L.boolean().default(!0).describe(`Auto-save digest to stash for crash recovery`)},annotations:r.annotations},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 Jt(l,async(e,t,r)=>(await n.createMessage({prompt:e,systemPrompt:t,maxTokens:r})).text,u):qt(l,u)).digest}]}}catch(e){return dp.error(`Session digest failed`,I(e)),q(`INTERNAL`,`Session digest failed: ${e instanceof Error?e.message:String(e)}`)}})}const pp=1e4,mp={defaultTtlSeconds:300,defaultLeaseTtlMinutes:10,globalEnabled:!1};function hp(e){return e??mp}function gp(e,t){let n=e.trim();if(!n)throw Error(`${t} is required`);return n}function _p(e,t,n){let r=gp(e,t);if(r.length>n)throw Error(`${t} exceeds max length of ${n}`);return r}function vp(e,t){if(!Number.isFinite(e)||e<=0)throw Error(`${t} must be greater than 0`);return Math.trunc(e)}function yp(e,t=!1,n){gp(e,`workspace`);let r=hp(n);if(!t)return e;if(!r.globalEnabled)throw Error(`Global signal scope is disabled`);return`__global__`}function bp(e,t,n){let r=hp(n),i=yp(t.workspace,t.global??!1,r),a=_p(t.key,`key`,500),o=_p(t.value,`value`,pp),s=t.agent?_p(t.agent,`agent`,500):void 0,c=vp(t.ttlSeconds??r.defaultTtlSeconds,`ttlSeconds`);return e.signalPost(i,a,o,s,c)}function xp(e,t,n){let r=gp(t,`workspace`),i=_p(n,`key`,500);return e.signalGet(r,i)}function Sp(e,t){let n=gp(t,`workspace`);return e.signalList(n)}function Cp(e,t,n){let r=gp(t,`workspace`),i=n===void 0?void 0:_p(n,`key`,500);return e.signalClear(r,i)}function wp(e,t,n){let r=hp(n),i=_p(t.resource,`resource`,500),a=_p(t.holder,`holder`,500),o=gp(t.workspace,`workspace`),s=t.intent?_p(t.intent,`intent`,pp):void 0,c=vp(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 Tp(e,t,n,r){let i=gp(t,`workspace`),a=_p(n,`resource`,500),o=_p(r,`holder`,500);return e.leaseRelease(a,o,i)}function Ep(e,t){let n=gp(t,`workspace`);return e.leaseList(n)}const Dp=F(`tools:signal`);function Op(e){return JSON.stringify(e,null,2)}function kp(e,t,n){let r=W(`signal`),i={...mp,...n};e.registerTool(`signal`,{title:r.title,description:`Inter-agent signaling and lease coordination`,inputSchema:{action:L.enum([`post`,`get`,`list`,`clear`,`lease`,`unlease`,`leases`]).describe(`Signal action to perform`),workspace:L.string().describe(`Workspace identifier (required)`),key:L.string().optional().describe(`Signal key (for post/get/clear)`),value:L.string().optional().describe(`Signal value (for post)`),agent:L.string().optional().describe(`Agent identifier`),resource:L.string().optional().describe(`Resource path (for lease/unlease)`),holder:L.string().optional().describe(`Lease holder ID (for lease/unlease)`),intent:L.string().optional().describe(`What the holder plans to do`),ttl:L.number().optional().describe(`TTL (seconds for signals, minutes for leases)`),global:L.boolean().optional().describe(`Use global scope (default: false)`)},annotations:r.annotations},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=bp(t,{workspace:n,key:r,value:a,agent:o,ttlSeconds:u,global:d},i);return{content:[{type:`text`,text:Op({id:e})}],structuredContent:{id:e}}}case`get`:{if(!r)throw Error(`key is required for get`);let e=xp(t,yp(n,d??!1,i),r);return{content:[{type:`text`,text:e.length===0?`[]`:Op(e)}],structuredContent:{signals:e}}}case`list`:{let e=Sp(t,yp(n,d??!1,i));return{content:[{type:`text`,text:e.length===0?`[]`:Op(e)}],structuredContent:{signals:e}}}case`clear`:{let e=Cp(t,yp(n,d??!1,i),r);return{content:[{type:`text`,text:Op({cleared:e})}],structuredContent:{cleared:e}}}case`lease`:{if(!s||!c)throw Error(`resource and holder are required for lease`);let e=wp(t,{resource:s,holder:c,workspace:n,intent:l,ttlMinutes:u},i);return{content:[{type:`text`,text:Op(e)}],structuredContent:e}}case`unlease`:{if(!s||!c)throw Error(`resource and holder are required for unlease`);let e=Tp(t,n,s,c);return{content:[{type:`text`,text:Op({released:e})}],structuredContent:{released:e}}}case`leases`:{let e=Ep(t,n);return{content:[{type:`text`,text:e.length===0?`[]`:Op(e)}],structuredContent:{leases:e}}}}}catch(e){return Dp.error(`Signal operation failed`,I(e)),q(`INTERNAL`,`Signal operation failed: ${e instanceof Error?e.message:String(e)}`)}})}const Ap=F(`tools`);function jp(e,t,n,r=15e3){let i,a=new Promise(e=>{i=setTimeout(()=>{Ap.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),Ap.warn(`Status sub-operation "${n}" failed: ${e instanceof Error?e.message:String(e)}`),{value:t,timedOut:!1})),a])}function Mp(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 Np(){let e=Bn.get(),t=zn.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(`
|
|
2887
2887
|
`):` 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(`
|
|
2888
|
-
`)}const
|
|
2889
|
-
`)}],structuredContent:o}})}function
|
|
2890
|
-
`),ae={totalRecords:u.totalRecords,totalFiles:u.totalFiles,lastIndexedAt:u.lastIndexedAt??null,onboarded:_,onboardDir:h,contentTypes:u.contentTypeBreakdown,wasmAvailable:!!
|
|
2891
|
-
`)};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
|
|
2888
|
+
`)}const Pp=5*6e4;let Fp=null,Ip=null;function Lp(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 Rp(){let e=Date.now();if(Fp&&e-Fp.ts<Pp)return Fp.value;try{let t=P(Sn(),`.copilot`,`.aikit-scaffold.json`);if(!D(t))return Fp={value:null,ts:e},null;let n=JSON.parse(k(t,`utf-8`)).version??null;return Fp={value:n,ts:e},n}catch{return Fp={value:null,ts:e},null}}function zp(){let e=Date.now();if(Ip&&e-Ip.ts<Pp)return Ip.value;try{let t=P(process.cwd(),`.github`,`.aikit-scaffold.json`);if(!D(t))return Ip={value:null,ts:e},null;let n=JSON.parse(k(t,`utf-8`)).version??null;return Ip={value:n,ts:e},n}catch{return Ip={value:null,ts:e},null}}function Bp(e){let t=W(`status`);e.registerTool(`status`,{title:t.title,description:`Get the current status and statistics of the AI Kit index.`,outputSchema:uo,annotations:t.annotations},async()=>{let e=b(),t=Rp(),n=zp(),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)**: ${Bn.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=x(),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`?(y(),a.push(``,`### ⬆ Upgrade Available (auto-upgrade failed, retrying)`,`- Server v${e} ≠ ${c}`,`- Error: ${o.error??`unknown`}`)):(y(),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:!!Bn.get(),wasmDiagnostics:zn.get(),graphStats:null,curatedCount:0,serverVersion:e,scaffoldVersion:t??null,workspaceScaffoldVersion:n??null,upgradeAvailable:r||i,contextPressure:0,nextAction:Mp({onboarded:!1,indexStale:!1,contextPressure:0})};return{content:[{type:`text`,text:a.join(`
|
|
2889
|
+
`)}],structuredContent:o}})}function Vp(e,t,n,r,i,a,o,s){let c=W(`status`);e.registerTool(`status`,{title:c.title,description:`Get the current status and statistics of the AI Kit index.`,outputSchema:uo,annotations:c.annotations},async()=>{let e=[];try{let[c,l]=await Promise.all([jp(t.getStats(),{totalRecords:0,totalFiles:0,lastIndexedAt:null,contentTypeBreakdown:{}},`store.getStats`),jp(t.listSourcePaths(),[],`store.listSourcePaths`)]),u=c.value;c.timedOut&&e.push(`⚠ Index stats timed out — values may be incomplete`);let d=l.value;l.timedOut&&e.push(`⚠ File listing timed out`);let f=null,p=0,m=[`## AI Kit Status`,``,`- **Total Records**: ${u.totalRecords}`,`- **Total Files**: ${u.totalFiles}`,`- **Last Indexed**: ${u.lastIndexedAt??`Never`}`,``,`### Content Types`,...Object.entries(u.contentTypeBreakdown).map(([e,t])=>`- ${e}: ${t}`),``,`### Indexed Files`,...d.slice(0,50).map(e=>`- ${e}`),d.length>50?`\n... and ${d.length-50} more files`:``];if(n)try{let t=await jp(n.getStats(),{nodeCount:0,edgeCount:0,nodeTypes:{},edgeTypes:{}},`graphStore.getStats`);if(t.timedOut)e.push(`⚠ Graph stats timed out`),m.push(``,`### Knowledge Graph`,`- Graph stats timed out`);else{let e=t.value;f={nodes:e.nodeCount,edges:e.edgeCount},m.push(``,`### Knowledge Graph`,`- **Nodes**: ${e.nodeCount}`,`- **Edges**: ${e.edgeCount}`,...Object.entries(e.nodeTypes).map(([e,t])=>` - ${e}: ${t}`));try{let e=await jp(n.validate(),{valid:!0,danglingEdges:[],orphanNodes:[],stats:{nodeCount:0,edgeCount:0,nodeTypes:{},edgeTypes:{}}},`graphStore.validate`);if(!e.timedOut){let t=e.value;t.valid||m.push(`- **⚠ Integrity Issues**: ${t.danglingEdges.length} dangling edges`),t.orphanNodes.length>0&&m.push(`- **Orphan nodes**: ${t.orphanNodes.length}`)}}catch{}}}catch{m.push(``,`### Knowledge Graph`,`- Graph store unavailable`)}let h=a?.onboardDir??``,g=D(h),_=i?.onboardComplete||g;if(m.push(``,`### Onboard Status`,_?`- ✅ Complete${i?.onboardTimestamp?` (last: ${i.onboardTimestamp})`:``}`:'- ❌ Not run — call `onboard({ path: "." })` to analyze the codebase',`- **Onboard Directory**: \`${h}\``),r)try{let t=await jp(r.list(),[],`curated.list`);if(t.timedOut)e.push(`⚠ Curated knowledge listing timed out`),m.push(``,`### Curated Knowledge`,`- Listing timed out`);else{let e=t.value;p=e.length,m.push(``,`### Curated Knowledge`,e.length>0?`- ${e.length} entries`:'- Empty — use `knowledge({ action: "remember", ... })` to persist decisions')}}catch{m.push(``,`### Curated Knowledge`,`- Unable to read curated entries`)}let v=Lp(u.totalRecords,f?.nodes??0,f?.edges??0,p),S=u.lastIndexedAt?new Date(u.lastIndexedAt).getTime():0,C=S>0?Date.now()-S:1/0,w=Mp({onboarded:_,indexStale:_&&C>1440*60*1e3,contextPressure:v});m.push(``),m.push(`## 📊 Context Pressure: ${v}/100`),v>=80?m.push(`⚠️ High pressure — consider pruning stale entries or compacting context.`):v>=50?m.push(`ℹ️ Moderate pressure — AI Kit memory is well-populated.`):m.push(`✅ Low pressure — plenty of headroom for more content.`);let T=0;if(u.lastIndexedAt){T=new Date(u.lastIndexedAt).getTime();let e=(Date.now()-T)/(1e3*60*60);m.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`)}m.push(``,`### Next Action`,`- **${w.kind}**: ${w.reason}`);let E=null,O=t;if(typeof O.getDiagnostics==`function`)try{E=O.getDiagnostics(),m.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(m.push(``,`### Smart Indexing`),s){let e=s();e?m.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}`):m.push(`- **Mode**: Smart (trickle)`,`- **Status**: scheduler state unavailable (init may have failed)`)}else m.push(`- **Mode**: Smart (trickle) — scheduler state unavailable`);{try{let e=a?.stateDir?N(a.stateDir,`stash`):null;if(e&&D(e)){let t=te(e).mtimeMs;t>T&&(T=t)}}catch{}let e=[];if(r)try{let t=p>0?await r.list():[];for(let e of t){let t=new Date(e.updated||e.created).getTime();t>T&&(T=t)}e.push(...t.sort((e,t)=>new Date(t.updated).getTime()-new Date(e.updated).getTime()).slice(0,5))}catch{}let t=T>0?Date.now()-T:0;if(t>=144e5){let n=Math.floor(t/36e5);if(m.push(``,`### 🌅 Session Briefing`,`_${n}+ hours since last activity — here's what to pick up:_`,``),e.length>0){m.push(`**Recent decisions/notes:**`);for(let t of e)m.push(`- **${t.title}** (${t.category??`note`}) — ${(t.contentPreview??``).slice(0,80)}…`)}m.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')}}m.push(``,`### Runtime`,Np());let k=Rp(),A=zp(),j=b(),ee=k!=null&&k!==j,ne=A!=null&&A!==j;if(ee||ne){let e=x(),t=[];ee&&t.push(`user scaffold v${k}`),ne&&t.push(`workspace scaffold v${A}`);let n=t.join(`, `);e.state===`success`?m.push(``,`### ✅ Upgrade Applied`,`- Server v${j} — ${n} auto-upgraded successfully.`,`- _Restart the MCP server to use the updated version._`):e.state===`pending`?m.push(``,`### ⏳ Upgrade In Progress`,`- Server v${j} ≠ ${n}`,`- Auto-upgrade is running in the background…`):e.state===`failed`?(y(),m.push(``,`### ⬆ Upgrade Available (auto-upgrade failed, retrying)`,`- Server v${j} ≠ ${n}`,`- Error: ${e.error??`unknown`}`)):(y(),m.push(``,`### ⬆ Upgrade Available`,`- Server v${j} ≠ ${n}`,`- Auto-upgrade triggered — check again shortly.`))}e.length>0&&m.push(``,`### ⚠ Warnings`,...e.map(e=>`- ${e}`));let re=ba();if(re.length>0){let e=re.sort((e,t)=>t.callCount-e.callCount);m.push(``,`### Tool Usage This Session`,``),m.push(`| Tool | Calls | Tokens In | Tokens Out | Errors | Avg Latency |`),m.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);m.push(`| ${t.tool} | ${t.callCount} | ${e.toLocaleString()} | ${n.toLocaleString()} | ${t.errorCount} | ${r}ms |`)}}let M=fa();if(M.bufferSize>=10){let e=M.state===`healthy`?`🟢`:M.state===`degraded`?`🔴`:`🟡`;m.push(``,`### Auto-GC: ${e} ${M.state}`),m.push(`- p95 latency: ${M.p95}ms | buffer: ${M.bufferSize} samples`),M.gcCount>0&&m.push(`- GC cycles triggered: ${M.gcCount}`)}let ie=m.join(`
|
|
2890
|
+
`),ae={totalRecords:u.totalRecords,totalFiles:u.totalFiles,lastIndexedAt:u.lastIndexedAt??null,onboarded:_,onboardDir:h,contentTypes:u.contentTypeBreakdown,wasmAvailable:!!Bn.get(),wasmDiagnostics:zn.get(),graphStats:f,curatedCount:p,serverVersion:j,scaffoldVersion:k??null,workspaceScaffoldVersion:A??null,upgradeAvailable:ee||ne,storeBackend:a?.store?.backend,storeDiagnostics:E??null,contextPressure:v,nextAction:w};return{content:[{type:`text`,text:ie+(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:ae}}catch(e){return Ap.error(`Status failed`,I(e)),q(`INTERNAL`,`Status check failed: ${e instanceof Error?e.message:String(e)}`)}})}const Hp=F(`tools`);function Up(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:L.array(L.string().max(2e3)).min(1).max(5).describe('Search queries (1–5). Single: `["react hooks"]`. Multiple searched in parallel.'),limit:L.number().min(1).max(20).default(5).describe(`Max results per query`),site:L.string().optional().describe(`Restrict to domain (e.g., "docs.aws.amazon.com")`),provider:L.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},async({queries:e,limit:t,site:n,provider:r})=>{let i=e,a=async e=>{let i=await fn({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(`
|
|
2891
|
+
`)};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 Hp.error(`Web search failed`,I(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);Hp.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(`
|
|
2892
2892
|
|
|
2893
|
-
`);return c===o.length?q(`INTERNAL`,u):{content:[{type:`text`,text:u}]}})}function
|
|
2894
|
-
`)}]}}catch(e){return
|
|
2895
|
-
`)}]}})}function
|
|
2896
|
-
`)}],structuredContent:i}}catch(e){return
|
|
2893
|
+
`);return c===o.length?q(`INTERNAL`,u):{content:[{type:`text`,text:u}]}})}function Wp(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:L.string().url().describe(`Request URL (http/https only)`),method:L.enum([`GET`,`POST`,`PUT`,`PATCH`,`DELETE`,`HEAD`]).default(`GET`).describe(`HTTP method`),headers:L.record(L.string(),L.string()).optional().describe(`Request headers as key-value pairs`),body:L.string().optional().describe(`Request body (for POST/PUT/PATCH)`),timeout:L.number().min(1e3).max(6e4).default(15e3).describe(`Timeout in milliseconds`)},annotations:t.annotations},async({url:e,method:t,headers:n,body:r,timeout:i})=>{try{let a=await st({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(`
|
|
2894
|
+
`)}]}}catch(e){return Hp.error(`HTTP request failed`,I(e)),q(`INTERNAL`,`HTTP request failed: ${e instanceof Error?e.message:String(e)}`)}})}function Gp(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:L.string().max(500).describe(`Regex pattern (without delimiters)`),flags:L.string().max(10).regex(/^[gimsuy]*$/).default(``).describe(`Regex flags (g, i, m, s, etc.)`),test_strings:L.array(L.string().max(1e4)).max(50).describe(`Strings to test the pattern against`),mode:L.enum([`match`,`replace`,`split`]).default(`match`).describe(`Test mode`),replacement:L.string().optional().describe(`Replacement string (for replace mode)`)},annotations:t.annotations},async({pattern:e,flags:t,test_strings:n,mode:r,replacement:i})=>{let a=Ft({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(`
|
|
2895
|
+
`)}]}})}function Kp(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:L.enum([`base64_encode`,`base64_decode`,`url_encode`,`url_decode`,`sha256`,`md5`,`jwt_decode`,`hex_encode`,`hex_decode`]).describe(`Operation to perform`),input:L.string().max(1e6).describe(`Input text`)},annotations:t.annotations},async({operation:e,input:t})=>{try{let n=We({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 Hp.error(`Encode failed`,I(e)),q(`INTERNAL`,`Encode failed: ${e instanceof Error?e.message:String(e)}`)}})}function qp(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:po,inputSchema:{path:L.string().describe(`File or directory path to measure`),extensions:L.array(L.string()).optional().describe(`File extensions to include (default: .ts,.tsx,.js,.jsx)`)},annotations:t.annotations},async({path:e,extensions:t})=>{try{let n=await _t({path:e,extensions:t}),r=[`## Code Metrics`,``,`**Files:** ${n.summary.totalFiles}`,`**Total lines:** ${n.summary.totalLines} (${n.summary.totalCodeLines} code)`,`**Functions:** ${n.summary.totalFunctions}`,`**Avg complexity:** ${n.summary.avgComplexity}`,`**Max complexity:** ${n.summary.maxComplexity.value} (${n.summary.maxComplexity.file})`,``,`### Top files by complexity`,``,`| File | Lines | Code | Complexity | Cognitive | Functions | Imports |`,`|------|-------|------|------------|-----------|-----------|---------|`];for(let e of n.files.slice(0,20)){let t=e.cognitiveComplexity===void 0?`—`:String(e.cognitiveComplexity);r.push(`| ${e.path} | ${e.lines.total} | ${e.lines.code} | ${e.complexity} | ${t} | ${e.functions} | ${e.imports} |`)}n.files.length>20&&r.push(``,`_...and ${n.files.length-20} more files_`);let i={summary:{totalFiles:n.summary.totalFiles,totalLines:n.summary.totalLines,totalCodeLines:n.summary.totalCodeLines,totalFunctions:n.summary.totalFunctions,avgComplexity:n.summary.avgComplexity,maxComplexity:{value:n.summary.maxComplexity.value,file:n.summary.maxComplexity.file}},files:n.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.join(`
|
|
2896
|
+
`)}],structuredContent:i}}catch(e){return Hp.error(`Measure failed`,I(e)),q(`INTERNAL`,`Measure failed: ${e instanceof Error?e.message:String(e)}`)}})}function Jp(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:L.string().max(200).describe(`Start ref (tag, SHA, HEAD~N)`),to:L.string().max(200).default(`HEAD`).describe(`End ref (default: HEAD)`),format:L.enum([`grouped`,`chronological`,`per-scope`]).default(`grouped`).describe(`Output format`),include_breaking:L.boolean().default(!0).describe(`Highlight breaking changes`),cwd:L.string().optional().describe(`Repository root or working directory`)},annotations:t.annotations},async({from:e,to:t,format:n,include_breaking:r,cwd:i})=>{try{let a=Te({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 Hp.error(`Changelog failed`,I(e)),q(`INTERNAL`,`Changelog failed: ${e instanceof Error?e.message:String(e)}`)}})}function Yp(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:L.string().max(5e5).describe(`JSON data to validate (as string)`),schema:L.string().max(5e5).describe(`JSON Schema to validate against (as string)`)},annotations:t.annotations},async({data:e,schema:t})=>{try{let n=Gt({data:JSON.parse(e),schema:JSON.parse(t)});if(n.valid)return{content:[{type:`text`,text:`## Validation: PASSED
|
|
2897
2897
|
|
|
2898
2898
|
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(`
|
|
2899
|
-
`)}]}}catch(e){return
|
|
2900
|
-
`)}],structuredContent:a}})}function
|
|
2901
|
-
`)}],structuredContent:o}}catch(e){return
|
|
2899
|
+
`)}]}}catch(e){return Hp.error(`Schema validation failed`,I(e)),q(`INTERNAL`,`Schema validation failed: ${e instanceof Error?e.message:String(e)}`)}})}function Xp(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:mo,inputSchema:{include_env:L.boolean().default(!1).describe(`Include environment variables`),filter_env:L.string().optional().describe(`Filter env vars by name substring`),show_sensitive:L.boolean().default(!1).describe(`Show sensitive values (keys, tokens, etc.) — redacted by default`)},annotations:t.annotations},async({include_env:e,filter_env:t,show_sensitive:n})=>{let r=Ke({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(`
|
|
2900
|
+
`)}],structuredContent:a}})}function Zp(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:ho,inputSchema:{operation:L.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:L.string().optional().describe(`Date input (ISO, unix timestamp, or parseable string). For diff: two comma-separated dates`),timezone:L.string().optional().describe(`Target timezone (e.g., "America/New_York", "Asia/Tokyo")`),duration:L.string().optional().describe(`Duration to add (e.g., "2h30m", "1d", "30s") — for add operation`)},annotations:t.annotations},async({operation:e,input:t,timezone:n,duration:r})=>{try{let i=an({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(`
|
|
2901
|
+
`)}],structuredContent:o}}catch(e){return Hp.error(`Time failed`,I(e)),q(`INTERNAL`,`Time failed: ${e instanceof Error?e.message:String(e)}`)}})}function Qp(e){try{let t=N(e,`.flows`);if(!D(t))return null;let n=A(t,{withFileTypes:!0});for(let e of n){if(!e.isDirectory())continue;let n=N(t,e.name,`meta.json`);if(D(n)&&JSON.parse(k(n,`utf-8`)).status===`active`)return e.name}}catch{return null}return null}function $p(e,t,n,r,i,a,o,s,c,l){let u=new aa,d=n.sources[0]?.path??process.cwd(),f={activeSlug:null};f.activeSlug=Qp(d);let p=new Ti(N(n.stateDir??``,`flow-context`),()=>f.activeSlug),m=new gi;m.register(pi),m.register(Vr),m.register(ui),m.register(Rr),m.register(Pr),m.register(Fr),m.register(hi),m.register(li(()=>f.activeSlug?{active:!0,slug:f.activeSlug}:null));let h=new xi(m,t.curated,{},p),g=l??so(n,[...Ia,...Aa],U,Ma(n)),_=e=>g.has(e),v=new Set([...g].filter(e=>!ju.includes(e)&&!Gi.has(e))),y=new Yi;u.use(yi(h),{order:5,name:`auto-knowledge`}),u.use(Sa(),{order:10,name:`replay`}),u.use(Qi(y,{stateStore:t.stateStore,curatedStore:t.curated},{trackedTools:v}),{order:94,name:`procedural-memory`}),u.use(Vi(new zi(t.stateStore,t.curated)),{order:95,name:`observation-capture`}),u.use(Ra(),{order:1,name:`structured-content-guard`}),u.use(wi(Ci(n.tokenBudget)),{order:90,name:`compression`}),Ka(e,u,n.toolPrefix??``);let b=[...g].filter(e=>ja.has(e)?ka.includes(e)?!!t.bridge:e===`er_update_policy`?!!t.policyStore:e===`er_evolve_review`?!!t.evolutionCollector:!1:!0);_(`search`)&&up(e,t.embedder,t.store,t.graphStore,t.bridge,t.evolutionCollector,a,t.stateStore,n.memory?.retention,n.memory?.consolidation);let x={store:t.store,graphStore:t.graphStore,embedder:t.embedder},S=c?e=>{c()?.prioritize(e)}:void 0;_(`lookup`)&&Su(e,t.store,x);let C={onboardComplete:t.onboardComplete,onboardTimestamp:t.onboardTimestamp};_(`status`)&&Vp(e,t.store,t.graphStore,t.curated,C,n,o,s),_(`config`)&&Js(e,n),_(`reindex`)&&Wf(e,t.indexer,n,t.curated,t.store,i,o),_(`knowledge`)&&bu(e,t.curated,t.policyStore,t.evolutionCollector,i,p,t.stateStore,n.memory?.retention,n.memory?.supersession,n.memory?.consolidation,n.memory?.lessons),_(`analyze`)&&gs(e,t.store,t.embedder,x),_(`blast_radius`)&&_s(e,t.store,t.embedder,t.graphStore,x),_(`produce_knowledge`)&&Hf(e,n),_(`onboard`)&&Lu(e,t.store,t.embedder,n,C,x),_(`graph`)&&dl(e,t.graphStore),_(`audit`)&&Ss(e,t.store,t.embedder,n.tokenBudget),_(`compact`)&&ac(e,t.embedder,t.fileCache,d,n.allRoots,x,S),_(`scope_map`)&&oc(e,t.embedder,t.store,x),_(`find`)&&sc(e,t.embedder,t.store,d,x),_(`parse_output`)&&xc(e),_(`workset`)&&zu(e),_(`check`)&&vc(e,x,n.tokenBudget),_(`symbol`)&&cc(e,t.embedder,t.store,t.graphStore),_(`eval`)&&yc(e),_(`test_run`)&&bc(e,x),_(`stash`)&&Bu(e,t.stateStore),_(`signal`)&&kp(e,t.stateStore),_(`git_context`)&&wu(e),_(`diff_parse`)&&Tu(e),_(`rename`)&&Eu(e),_(`codemod`)&&Du(e),_(`restore`)&&Jf(e),_(`file_summary`)&&lc(e,t.fileCache,d,n.allRoots,x,S),_(`checkpoint`)&&Vu(e,t.stateStore),_(`data_transform`)&&Ou(e),_(`trace`)&&uc(e,t.embedder,t.store,t.graphStore),_(`process`)&&pl(e),_(`watch`)&&ml(e),_(`dead_symbols`)&&dc(e,t.embedder,t.store,d,n.allRoots,x),_(`delegate`)&&Sc(e,a),_(`health`)&&hl(e),_(`lane`)&&Hu(e),_(`queue`)&&Uu(e),_(`web_fetch`)&&gl(e),_(`guide`)&&_l(e,o),ju.some(e=>_(e))&&Mu(e,n,b),_(`evidence_map`)&&rl(e),_(`digest`)&&il(e,t.embedder),_(`forge_classify`)&&al(e),_(`stratum_card`)&&ol(e,t.embedder,t.fileCache),_(`forge_ground`)&&sl(e,t.embedder,t.store),_(`present`)&&Bf(e,r),_(`browser`)&&An(e,n),_(`web_search`)&&Up(e),_(`http`)&&Wp(e),_(`regex_test`)&&Gp(e),_(`encode`)&&Kp(e),_(`measure`)&&qp(e),_(`changelog`)&&Jp(e),_(`schema_validate`)&&Yp(e),_(`env`)&&Xp(e),_(`time`)&&Zp(e),_(`flow`)&&tl(e,n,e=>{f.activeSlug=e}),t.bridge&&ka.some(e=>_(e))&&(Es(e,t.bridge,t.evolutionCollector),Ds(e,t.bridge),Os(e,t.bridge)),t.policyStore&&_(`er_update_policy`)&&Yu(e,t.policyStore),t.evolutionCollector&&_(`er_evolve_review`)&&gc(e,t.evolutionCollector),Oa(e,t.store,t.curated),_(`replay`)&&Kf(e),_(`session_digest`)&&fp(e,t.stateStore,a)}function em(e,t,n){let r=e=>!n||n.has(e);r(`check`)&&vc(e,void 0,t.tokenBudget),r(`eval`)&&yc(e),r(`test_run`)&&bc(e),r(`parse_output`)&&xc(e),r(`delegate`)&&Sc(e),r(`git_context`)&&wu(e),r(`diff_parse`)&&Tu(e),r(`rename`)&&Eu(e),r(`codemod`)&&Du(e),r(`data_transform`)&&Ou(e),r(`workset`)&&zu(e),r(`restore`)&&Jf(e),r(`lane`)&&Hu(e),r(`queue`)&&Uu(e),r(`session_digest`)&&fp(e),r(`health`)&&hl(e),r(`process`)&&pl(e),r(`watch`)&&ml(e),r(`web_fetch`)&&gl(e),r(`guide`)&&_l(e),ju.some(e=>r(e))&&Mu(e,t,[...n??new Set(Ia)]),r(`evidence_map`)&&rl(e),r(`forge_classify`)&&al(e),r(`present`)&&Bf(e),r(`browser`)&&An(e,t),r(`produce_knowledge`)&&Hf(e),r(`replay`)&&Kf(e),r(`status`)&&Bp(e),r(`flow`)&&tl(e,t),r(`web_search`)&&Up(e),r(`http`)&&Wp(e),r(`regex_test`)&&Gp(e),r(`encode`)&&Kp(e),r(`measure`)&&qp(e),r(`changelog`)&&Jp(e),r(`schema_validate`)&&Yp(e),r(`env`)&&Xp(e),r(`time`)&&Zp(e)}const tm=F(`resource-notifier`);var nm=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){tm.debug(`sendResourceListChanged failed`,{error:String(e)})}}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){tm.debug(`sendResourceUpdated failed`,{uri:e,error:String(t)})}}};const Q=F(`server`);async function rm(n){Q.info(`Initializing AI Kit components`);let r=n.store.backend,i=n.store.path,a=null;if(r===`sqlite-vec`){let e=N(i,`aikit.db`);D(i)||O(i,{recursive:!0}),a=await $n(e),Q.info(`SQLite adapter ready`,{type:a.type,vectorCapable:a.vectorCapable,dbPath:e}),a.vectorCapable||Q.warn(`┌──────────────────────────────────────────────────────────────────┐
|
|
2902
2902
|
│ ⚠ SQLite vector extension unavailable — DEGRADED MODE │
|
|
2903
2903
|
│ Vector search is disabled. Hybrid search returns FTS only. │
|
|
2904
2904
|
│ To enable: install/rebuild better-sqlite3 (native module). │
|
|
2905
|
-
└──────────────────────────────────────────────────────────────────┘`);let t=N(i,`lance`);D(t)&&
|
|
2906
|
-
`)}const
|
|
2907
|
-
`),`utf8`)
|
|
2908
|
-
`):[`AI Kit is still initializing (loading embeddings model & store).`,``,`**${
|
|
2909
|
-
`);
|
|
2905
|
+
└──────────────────────────────────────────────────────────────────┘`);let t=N(i,`lance`);D(t)&&Q.info(`Old LanceDB data found at ${t} — ignored. Safe to delete after verifying sqlite-vec works.`)}let o;if(a)o=a;else{let e=N(i,`aikit-state.db`);D(i)||O(i,{recursive:!0}),o=await $n(e),nr(o,Qn),Q.info(`State store adapter ready`,{type:o.type,dbPath:e})}let[s,c,l,u]=await Promise.all([(async()=>{if(n.embedding.childProcess!==!1){let e=new mr({model:n.embedding.model,dimensions:n.embedding.dimensions,interOpNumThreads:n.embedding.interOpNumThreads,intraOpNumThreads:n.embedding.intraOpNumThreads,idleTimeoutMs:n.embedding.idleTimeoutMs});return await e.initialize(),Q.info(`Embedder loaded (child process)`,{modelId:e.modelId,dimensions:e.dimensions}),e}let{OnnxEmbedder:e}=await import(`../../embeddings/dist/index.js`),t=new e({model:n.embedding.model,dimensions:n.embedding.dimensions,interOpNumThreads:n.embedding.interOpNumThreads,intraOpNumThreads:n.embedding.intraOpNumThreads});return await t.initialize(),Q.info(`Embedder loaded (in-process)`,{modelId:t.modelId,dimensions:t.dimensions}),t})(),(async()=>{let e=await tr({backend:r,path:i,adapter:a??void 0,embeddingDim:n.embedding.dimensions});return await e.initialize(),Q.info(`Store initialized`,{backend:r}),e})(),(async()=>{let e=a?new Zn({adapter:a}):new Zn({path:i});return await e.initialize(),Q.info(`Graph store initialized`,{shared:!!a}),e})(),(async()=>{let e=await Vn();if(e){let e=zn.get();Q.info(`WASM tree-sitter enabled`,{grammars:e.grammarCount,dir:e.wasmDir})}else{let e=zn.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})()]),d=new gr(s,c),f=er(o),p=new hr(n.store.path);p.load(),d.setHashCache(p);let m=n.curated.path,h=new e(m);await h.initialize();let g=new t(m,c,s,h);d.setGraphStore(l);let _=Ts(n.er),v=_?new Gn(n.curated.path):void 0;v&&Q.info(`Policy store initialized`,{ruleCount:v.getRules().length});let y=_?new Wn:void 0,b=P(n.sources[0]?.path??process.cwd(),ce.aiContext),x=D(b),S=n.onboardDir?D(n.onboardDir):!1,C=x||S,w,T=x?b:n.onboardDir;if(C&&T)try{w=te(T).mtime.toISOString()}catch{}return Q.info(`Onboard state detected`,{onboardComplete:C,onboardTimestamp:w,aiKbExists:x,onboardDirExists:S}),{embedder:s,store:c,stateStore:f,closeStateStore:o===a?void 0:async()=>o.close(),indexer:d,curated:g,graphStore:l,fileCache:new be,bridge:_,policyStore:v,evolutionCollector:y,onboardComplete:C,onboardTimestamp:w}}function im(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 (structure) or compact (extract section)`,`- 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 or compact`,`- 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(`
|
|
2906
|
+
`)}const am=F(`background-task`);var om=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,am.info(`Background task started`,{task:e.name,pending:this.queue.length});let t=Date.now();try{await e.fn();let n=Date.now()-t;am.info(`Background task completed`,{task:e.name,durationMs:n}),e.resolve()}catch(n){let r=Date.now()-t;am.error(`Background task failed`,{task:e.name,durationMs:r,err:n}),e.reject(n instanceof Error?n:Error(String(n)))}}this.running=null}};const sm=F(`idle-timer`);var cm=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){sm.info(`Idle timeout reached with no active session — skipping cleanup (waiting for first tool call)`);return}if(this._busy){sm.info(`Skipping idle cleanup — background work in progress`);return}sm.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`&&sm.warn(`Idle cleanup callback failed`,{error:String(t.reason)})}};const lm=F(`memory-monitor`);var um=class{timer=null;warningBytes;criticalBytes;intervalMs;pressureFns=[];memoryPressureFns=[];lastLevel=`normal`;constructor(e){this.warningBytes=e?.warningBytes??4294967296,this.criticalBytes=e?.criticalBytes??8589934592,this.intervalMs=e?.intervalMs??6e4}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(),lm.info(`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`?lm.warn(`Memory CRITICAL: ${n}MB RSS — consider restarting the server`):t===`warning`?lm.warn(`Memory WARNING: ${n}MB RSS`):this.lastLevel!==`normal`&&lm.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 dm=F(`tool-timeout`),fm=new Set([`onboard`,`reindex`,`produce_knowledge`,`analyze`,`codemod`,`audit`]);var pm=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 mm(e){return fm.has(e)?6e5:12e4}function hm(e,t,n){return new Promise((r,i)=>{let a=!1,o=setTimeout(()=>{if(!a){a=!0;let e=new pm(n,t);dm.warn(e.message),i(e)}},t);o.unref&&o.unref(),e().then(e=>{a||(a=!0,clearTimeout(o),r(e))},e=>{a||(a=!0,clearTimeout(o),i(e))})})}const $=F(`server`),gm=new Set([`status`,`list_tools`,`describe_tool`,`config`,`env`]);function _m(e,t=28){let n=e.replace(/\s+/g,` `).trim();return n.length<=t?n:`${n.slice(0,t-3)}...`}function vm(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 ym(e,t,n){let r=[];try{t.statePath&&Ge(e.stateStore,{stateDir:t.statePath});let i=e.stateStore.stashList().map(e=>e.key);if(i.length>0){let e=n.toLowerCase().split(/\s+/).filter(e=>e.length>2);if(e.length===0)r.push(`stash: ${i.length} entries available`);else{let t=i.filter(t=>e.some(e=>t.toLowerCase().includes(e))).slice(0,3);t.length>0?r.push(`stash: ${t.map(e=>`"${_m(e)}"`).join(`, `)}${i.length>t.length?` (${i.length} total)`:``}`):r.push(`stash: ${i.length} entries available`)}}}catch{}try{if(n){let t=await Promise.race([e.store.ftsSearch(n,{limit:3}),new Promise(e=>setTimeout(()=>e(null),50))]);if(Array.isArray(t)&&t.length>0){let e=t.filter(e=>e&&typeof e==`object`&&`record`in e&&(e.record.origin===`produced`||e.record.origin===`curated`));if(e.length>0){let t=e.slice(0,2).map(e=>{let t=e.record;return`"${_m(t.headingPath||t.sourcePath||`knowledge`)}"`});r.push(`knowledge: ${t.join(`, `)}`)}}}}catch{}return r.length===0?null:`\n---\nContext available: ${r.join(` | `)}\nPull with: stash({action:'get', key:'...'}) or search({query:'...', origin:'produced'})\n---`}function bm(e,t,n){let r=3;for(let[i,a]of Object.entries(e)){let e=a.handler;a.handler=async(...a)=>{let o=await e(...a);if(!o||typeof o!=`object`||r<=0||o.isError||gm.has(i))return o;try{r--;let e=a[0],i=await ym(t,n,vm(e&&typeof e==`object`?e:{}));i&&(o.content=Array.isArray(o.content)?o.content:[],o.content.push({type:`text`,text:i}))}catch{}return o}}}function xm(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`,`module not found`].some(e=>t.includes(e))}function Sm(e){let t=e.indexOf(`node_modules`);return t>0?e.substring(0,t-1):null}async function Cm(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(`
|
|
2907
|
+
`),`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??ue.model,n=N(Sn(),`.cache`,`huggingface`,`transformers-js`,t);try{await r(n,{recursive:!0,force:!0}),$.info(`Auto-heal: cleared embedding model cache`,{path:n})}catch{}}if(n.includes(`lance`)||n.includes(`database`)||n.includes(`store`)){let t=N(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=N(e.store.path,`graph.db`);try{await r(t,{force:!0}),$.info(`Auto-heal: cleared graph database`,{path:t})}catch{}let n=N(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(n.includes(`cannot find module`)&&!n.includes(`huggingface`)&&!n.includes(`.cache`)){let{fileURLToPath:e}=await import(`node:url`),t=e(import.meta.url);if(t.includes(`_npx`)||t.includes(`npm-cache`)){let e=Sm(t);if(e)try{let{execSync:t}=await import(`node:child_process`);t(`npm install --prefer-offline --no-audit --no-fund`,{cwd:e,stdio:`ignore`,timeout:6e4}),$.info(`Auto-heal: re-ran npm install to restore missing module`,{path:e})}catch{$.warn(`Auto-heal: npm install failed during module restoration`,{hint:`Run: npm cache clean --force && npx -y @vpxa/aikit serve`})}}}}function wm(e,t){let n=so(e,Ia,U,Ma(e)),r=im(e,n,U),i=new Cn({name:e.serverName??`aikit`,version:b()},{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}`:``,``,`**${Fa.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.`,``,`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.`,``,`Try restarting the MCP server to retry initialization.`].filter(Boolean).join(`
|
|
2908
|
+
`):[`AI Kit is still initializing (loading embeddings model & store).`,``,`**${Fa.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(`
|
|
2909
|
+
`);yr(i);let p=new aa;p.use(Ra(),{order:1,name:`structured-content-guard`}),Ka(i,p,e.toolPrefix??``);let m=i.sendToolListChanged.bind(i);i.sendToolListChanged=()=>{};let h=[];for(let e of Ia){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()}]}));Fa.has(e)?r.remove():h.push(r)}em(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:On(L.string(),()=>[])}},async()=>({messages:[]})),v,y,x=new Promise((e,t)=>{v=e,y=t}),S,C=new Promise(e=>{S=e}),w=()=>S?.(),T=(async()=>{await C;let n=[];try{let{createRequire:e}=await import(`node:module`),{readFileSync:t}=await import(`node:fs`),{fileURLToPath:r}=await import(`node:url`),{resolve:i,dirname:a}=await import(`node:path`),o=e(import.meta.url),s=i(a(r(import.meta.url)),`..`,`package.json`),c=JSON.parse(t(s,`utf8`)),l=Object.keys(c.dependencies??{}),u=[`@mixmark-io/domino`],d=[...l,...u.filter(e=>!l.includes(e))];for(let e of d)try{o.resolve(e)}catch{n.push(e)}if(n.length>0){$.warn(`${n.length} dependencies not resolvable — attempting auto-repair`,{missing:n});let e=r(import.meta.url);if(e.includes(`_npx`)||e.includes(`npm-cache`))try{let{execSync:t}=await import(`node:child_process`),r=Sm(e);if(r){$.info(`Auto-heal: running npm install in npx cache to restore missing deps`,{path:r,missing:n}),t(`npm install --prefer-offline --no-audit --no-fund`,{cwd:r,stdio:`ignore`,timeout:6e4});let e=[];for(let t of n)try{o.resolve(t)}catch{e.push(t)}e.length===0?($.info(`Auto-heal: all missing dependencies restored successfully`),n=[]):($.warn(`Auto-heal: some deps still missing after npm install`,{stillMissing:e,hint:`Run: npm cache clean --force && npx -y @vpxa/aikit serve`}),n=e)}}catch(e){$.warn(`Auto-heal: npm install failed — server may operate in degraded mode`,{error:e instanceof Error?e.message:String(e),hint:`Run: npm cache clean --force && npx -y @vpxa/aikit serve`})}else $.warn(`Missing dependencies detected in non-npx environment`,{missing:n,hint:`Run: npm install (or pnpm install) to restore missing packages`})}}catch{}let r;try{r=await rm(e)}catch(t){let n=t instanceof Error?t.message:String(t);if(xm(n)){$.warn(`AI Kit initialization failed with recoverable error — attempting auto-heal retry`,{error:n}),await Cm(e,n);try{r=await rm(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:n}),y?.(e instanceof Error?e:Error(o));return}}else{a=`failed`,o=n,$.error(`AI Kit initialization failed — server continuing with zero-dep tools only`,{error:o}),y?.(t instanceof Error?t:Error(o));return}}let f=i.sendToolListChanged.bind(i);i.sendToolListChanged=()=>{};let p=i.sendPromptListChanged.bind(i);i.sendPromptListChanged=()=>{};let m=i.sendResourceListChanged.bind(i);i.sendResourceListChanged=()=>{};for(let e of h)e.remove();g.remove(),_.remove();let b=i._registeredTools??{};for(let e of Fa)b[e]?.remove();let x=new nm(i),S=Dc(i);$p(i,r,e,_r(i),x,S,t,t===`smart`?(()=>{let e=u;return e?.getState?e.getState():null}):null,t===`smart`?()=>{let e=u;return e?{prioritize:e.prioritize.bind(e)}:null}:null),Ar(i,{curated:r.curated,store:r.store,graphStore:r.graphStore,stateStore:r.stateStore},t),i.sendToolListChanged=f,i.sendPromptListChanged=p,i.sendResourceListChanged=m,Promise.resolve(i.sendToolListChanged()).catch(()=>{}),Promise.resolve(i.sendPromptListChanged()).catch(()=>{}),Promise.resolve(i.sendResourceListChanged()).catch(()=>{});let w=i._registeredTools??{};for(let[e,t]of Object.entries(w)){if(Na.has(e))continue;let n=t.handler;t.handler=async(...t)=>{if(!r.indexer.isIndexing)return n(...t);let i=s?`re-indexing`:`running initial index`,a=new Promise(t=>setTimeout(()=>t({content:[{type:`text`,text:`⏳ AI Kit is ${i}. The tool "${e}" timed out waiting for index data (${Pa/1e3}s).\n\nThe existing index may be temporarily locked. Please retry shortly — indexing will complete automatically.`}]}),Pa));return Promise.race([n(...t),a])}}for(let[e,t]of Object.entries(w)){let n=t.handler,r=mm(e);t.handler=async(...t)=>{try{return await hm(()=>n(...t),r,e)}catch(t){if(t instanceof pm)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.`}]};throw t}}}let T=Object.keys(w).length;T<Ia.length&&$.warn(`ALL_TOOL_NAMES count mismatch`,{expectedToolCount:Ia.length,registeredToolCount:T}),$.info(`MCP server configured`,{toolCount:Ia.length,resourceCount:4});let E=new um;E.onPressure((e,t)=>{e===`warning`&&Cr(),e===`critical`&&($.warn(`Memory pressure critical — consider restarting`,{rssMB:Math.round(t/1024/1024)}),Cr())}),E.registerMemoryPressureCallback(()=>r.embedder.shutdown?.()),E.start();let O=new cm;l=O,O.onIdle(async()=>{if(D.isRunning||r.indexer.isIndexing){$.info(`Idle cleanup deferred — background tasks still running`),O.touch();return}$.info(`Idle cleanup: releasing cached memory (connections stay open)`);try{r.store.releaseMemory?.(),r.graphStore.releaseMemory?.()}catch{}}),O.touch();let k=!1;for(let e of Object.values(w)){let t=e.handler;e.handler=async(...e)=>{if(k||(k=!0,O.markSessionActive()),O.touch(),u){let t=d(e[0]);t.length>0&&u.prioritize(...t)}return t(...e)}}bm(w,r,{statePath:e.stateDir??``}),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=r,v?.(r)})(),E=async()=>{let t;try{t=await x}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`,I(e))}try{let e=await t.curated.reindexAll();$.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){$.error(`Curated re-index failed`,I(e))}}catch(e){$.error(`Initial index failed; will retry on aikit_reindex`,I(e))}finally{l?.setBusy(!1)}},D=new om,O=()=>D.schedule({name:`initial-index`,fn:E}),k=process.ppid,A=setInterval(()=>{try{process.kill(k,0)}catch{$.info(`Parent process died; shutting down`,{parentPid:k}),clearInterval(A),u?.stop&&u.stop(),import(`../../tools/dist/index.js`).then(({processStopAll:e})=>e()).catch(()=>{}),x.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 A.unref(),{server:i,startInit:w,ready:T,runInitialIndex:O,get aikit(){return c},scheduler:D,setSmartScheduler(e){u=e}}}const Tm=F(`server`);function Em(e,t){let n=so(t,[...Ia,...Aa],U,Ma(t)),r=im(t,n,U),i=new Cn({name:t.serverName??`aikit`,version:b()},{capabilities:{logging:{},completions:{},prompts:{}},instructions:r});return yr(i),$p(i,e,t,_r(i),new nm(i),Dc(i),void 0,null,null,n),Ar(i,{curated:e.curated,store:e.store,graphStore:e.graphStore,stateStore:e.stateStore},t.indexMode),i}async function Dm(e){let t=await rm(e),n=Em(t,e);Tm.info(`MCP server configured`,{toolCount:Ia.length,resourceCount:2});let r=async()=>{try{let n=e.sources.map(e=>e.path).join(`, `);Tm.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&&Tm.debug(`Indexing file`,{current:e.filesProcessed+1,total:e.filesTotal,file:e.currentFile}),e.phase===`cleanup`&&Tm.debug(`Index cleanup`,{staleEntries:e.filesTotal-e.filesProcessed}))});Tm.info(`Initial index complete`,{filesProcessed:r.filesProcessed,filesSkipped:r.filesSkipped,chunksCreated:r.chunksCreated,durationMs:r.durationMs});try{await t.store.createFtsIndex()}catch(e){Tm.warn(`FTS index creation failed`,I(e))}try{let e=await t.curated.reindexAll();Tm.info(`Curated re-index complete`,{indexed:e.indexed})}catch(e){Tm.error(`Curated re-index failed`,I(e))}}catch(e){Tm.error(`Initial index failed; will retry on aikit_reindex`,I(e))}},i=async()=>{Tm.info(`Shutting down`),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{Tm.info(`Parent process died; shutting down`,{parentPid:a}),clearInterval(o),i()}},5e3);return o.unref(),{server:n,runInitialIndex:r,shutdown:i}}export{Ia as ALL_TOOL_NAMES,wm as createLazyServer,Em as createMcpServer,Dm as createServer,rm as initializeAikit,$p as registerMcpTools};
|