@vpxa/kb 0.1.23 → 0.1.25

package/packages/server/dist/tools/manipulation.tools.js

@@ -1,4 +1,4 @@
-import{getToolMeta as e}from"../tool-metadata.js";import{z as t}from"zod";import{createLogger as n,serializeError as r}from"../../../core/dist/index.js";import{codemod as i,dataTransform as a,diffParse as o,gitContext as s,rename as c}from"../../../tools/dist/index.js";const l=n(`tools:manipulation`);function u(n){let i=e(`git_context`);n.registerTool(`git_context`,{title:i.title,description:`Summarize the current Git branch, working tree state, recent commits, and optional diff statistics for the repository.`,inputSchema:{cwd:t.string().optional().describe(`Repository root or working directory`),commit_count:t.number().min(1).max(50).default(5).optional().describe(`How many recent commits to include`),include_diff:t.boolean().default(!1).optional().describe(`Include diff stat for working tree changes`)},annotations:i.annotations},async({cwd:e,commit_count:t,include_diff:n})=>{try{return{content:[{type:`text`,text:h(await s({cwd:e,commitCount:t,includeDiff:n}))}]}}catch(e){return l.error(`Git context failed`,r(e)),{content:[{type:`text`,text:`Git context failed. Check server logs for details.`}],isError:!0}}})}function d(n){let i=e(`diff_parse`);n.registerTool(`diff_parse`,{title:i.title,description:`Parse raw unified diff text into file-level and hunk-level structural changes.`,inputSchema:{diff:t.string().max(1e6).describe(`Raw unified diff text`)},annotations:i.annotations},async({diff:e})=>{try{return{content:[{type:`text`,text:g(o({diff:e.replace(/\\n/g,`
-`).replace(/\\t/g,`	`)}))}]}}catch(e){return l.error(`Diff parse failed`,r(e)),{content:[{type:`text`,text:`Diff parse failed. Check server logs for details.`}],isError:!0}}})}function f(n){let i=e(`rename`);n.registerTool(`rename`,{title:i.title,description:`Rename a symbol across files using whole-word regex matching for exports, imports, and general usage references.`,inputSchema:{old_name:t.string().describe(`Existing symbol name to replace`),new_name:t.string().describe(`New symbol name to use`),root_path:t.string().describe(`Root directory to search within`),extensions:t.array(t.string()).optional().describe(`Optional file extensions to include, such as .ts,.tsx,.js,.jsx`),dry_run:t.boolean().default(!0).describe(`Preview changes without writing files`)},annotations:i.annotations},async({old_name:e,new_name:t,root_path:n,extensions:i,dry_run:a})=>{try{let r=await c({oldName:e,newName:t,rootPath:n,extensions:i,dryRun:a});return{content:[{type:`text`,text:JSON.stringify(r,null,2)}]}}catch(e){return l.error(`Rename failed`,r(e)),{content:[{type:`text`,text:`Rename failed. Check server logs for details.`}],isError:!0}}})}function p(n){let a=e(`codemod`);n.registerTool(`codemod`,{title:a.title,description:`Apply regex-based codemod rules across files and return structured before/after changes for each affected line.`,inputSchema:{root_path:t.string().describe(`Root directory to transform within`),rules:t.array(t.object({description:t.string().describe(`What the codemod rule does`),pattern:t.string().describe(`Regex pattern in string form`),replacement:t.string().describe(`Replacement string with optional capture groups`)})).min(1).describe(`Codemod rules to apply`),dry_run:t.boolean().default(!0).describe(`Preview changes without writing files`)},annotations:a.annotations},async({root_path:e,rules:t,dry_run:n})=>{try{let r=await i({rootPath:e,rules:t,dryRun:n});return{content:[{type:`text`,text:JSON.stringify(r,null,2)}]}}catch(e){return l.error(`Codemod failed`,r(e)),{content:[{type:`text`,text:`Codemod failed. Check server logs for details.`}],isError:!0}}})}function m(n){let i=e(`data_transform`);n.registerTool(`data_transform`,{title:i.title,description:`Apply small jq-like transforms to JSON input for filtering, projection, grouping, and path extraction.`,inputSchema:{input:t.string().max(5e5).describe(`Input JSON string`),expression:t.string().max(1e4).describe(`Transform expression to apply`)},annotations:i.annotations},async({input:e,expression:t})=>{try{return{content:[{type:`text`,text:a({input:e,expression:t}).outputString}]}}catch(e){return l.error(`Data transform failed`,r(e)),{content:[{type:`text`,text:`Data transform failed. Check server logs for details.`}],isError:!0}}})}function h(e){let t=[`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(`
-`)}function g(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(`
-`)}export{p as registerCodemodTool,m as registerDataTransformTool,d as registerDiffParseTool,u as registerGitContextTool,f as registerRenameTool};
+import{getToolMeta as e}from"../tool-metadata.js";import{GitContextOutputSchema as t}from"../output-schemas.js";import{z as n}from"zod";import{createLogger as r,serializeError as i}from"../../../core/dist/index.js";import{codemod as a,dataTransform as o,diffParse as s,gitContext as c,rename as l}from"../../../tools/dist/index.js";const u=r(`tools:manipulation`);function d(r){let a=e(`git_context`);r.registerTool(`git_context`,{title:a.title,description:`Summarize the current Git branch, working tree state, recent commits, and optional diff statistics for the repository.`,inputSchema:{cwd:n.string().optional().describe(`Repository root or working directory`),commit_count:n.number().min(1).max(50).default(5).optional().describe(`How many recent commits to include`),include_diff:n.boolean().default(!1).optional().describe(`Include diff stat for working tree changes`)},annotations:a.annotations,outputSchema:t},async({cwd:e,commit_count:t,include_diff:n})=>{try{let r=await c({cwd:e,commitCount:t,includeDiff:n});return{content:[{type:`text`,text:g(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 u.error(`Git context failed`,i(e)),{content:[{type:`text`,text:`Git context failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}function f(t){let r=e(`diff_parse`);t.registerTool(`diff_parse`,{title:r.title,description:`Parse raw unified diff text into file-level and hunk-level structural changes.`,inputSchema:{diff:n.string().max(1e6).describe(`Raw unified diff text`)},annotations:r.annotations},async({diff:e})=>{try{return{content:[{type:`text`,text:_(s({diff:e.replace(/\\n/g,`
+`).replace(/\\t/g,`	`)}))}]}}catch(e){return u.error(`Diff parse failed`,i(e)),{content:[{type:`text`,text:`Diff parse failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}function p(t){let r=e(`rename`);t.registerTool(`rename`,{title:r.title,description:`Rename a symbol across files using whole-word regex matching for exports, imports, and general usage references.`,inputSchema:{old_name:n.string().describe(`Existing symbol name to replace`),new_name:n.string().describe(`New symbol name to use`),root_path:n.string().describe(`Root directory to search within`),extensions:n.array(n.string()).optional().describe(`Optional file extensions to include, such as .ts,.tsx,.js,.jsx`),dry_run:n.boolean().default(!0).describe(`Preview changes without writing files`)},annotations:r.annotations},async({old_name:e,new_name:t,root_path:n,extensions:r,dry_run:a})=>{try{let i=await l({oldName:e,newName:t,rootPath:n,extensions:r,dryRun:a});return{content:[{type:`text`,text:JSON.stringify(i)}]}}catch(e){return u.error(`Rename failed`,i(e)),{content:[{type:`text`,text:`Rename failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}function m(t){let r=e(`codemod`);t.registerTool(`codemod`,{title:r.title,description:`Apply regex-based codemod rules across files and return structured before/after changes for each affected line.`,inputSchema:{root_path:n.string().describe(`Root directory to transform within`),rules:n.array(n.object({description:n.string().describe(`What the codemod rule does`),pattern:n.string().describe(`Regex pattern in string form`),replacement:n.string().describe(`Replacement string with optional capture groups`)})).min(1).describe(`Codemod rules to apply`),dry_run:n.boolean().default(!0).describe(`Preview changes without writing files`)},annotations:r.annotations},async({root_path:e,rules:t,dry_run:n})=>{try{let r=await a({rootPath:e,rules:t,dryRun:n});return{content:[{type:`text`,text:JSON.stringify(r)}]}}catch(e){return u.error(`Codemod failed`,i(e)),{content:[{type:`text`,text:`Codemod failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}function h(t){let r=e(`data_transform`);t.registerTool(`data_transform`,{title:r.title,description:`Apply small jq-like transforms to JSON input for filtering, projection, grouping, and path extraction.`,inputSchema:{input:n.string().max(5e5).describe(`Input JSON string`),expression:n.string().max(1e4).describe(`Transform expression to apply`)},annotations:r.annotations},async({input:e,expression:t})=>{try{return{content:[{type:`text`,text:o({input:e,expression:t}).outputString}]}}catch(e){return u.error(`Data transform failed`,i(e)),{content:[{type:`text`,text:`Data transform failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}function g(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(`
+`)}function _(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(`
+`)}export{m as registerCodemodTool,h as registerDataTransformTool,f as registerDiffParseTool,d as registerGitContextTool,p as registerRenameTool};

package/packages/server/dist/tools/onboard.tool.js

@@ -1,2 +1,2 @@
-import{getToolMeta as e}from"../tool-metadata.js";import{createHash as t}from"node:crypto";import{z as n}from"zod";import{createLogger as r,serializeError as i}from"../../../core/dist/index.js";import{onboard as a}from"../../../tools/dist/index.js";const o=r(`tools`);async function s(e,n,r){for(let a of r.steps)if(!(a.status!==`success`||!a.output))try{let i=t(`sha256`).update(r.path).digest(`hex`).slice(0,12),o=`produced/onboard/${a.name}/${i}.md`,s=t(`sha256`).update(a.output).digest(`hex`).slice(0,16),c=new Date().toISOString(),l=a.output.length>2e3?a.output.split(/(?=^## )/m).filter(e=>e.trim().length>0):[a.output],u=l.map((e,n)=>({id:t(`sha256`).update(`${o}::${n}`).digest(`hex`).slice(0,16),content:e.trim(),sourcePath:o,contentType:`produced-knowledge`,chunkIndex:n,totalChunks:l.length,startLine:0,endLine:0,fileHash:s,indexedAt:c,origin:`produced`,tags:[`onboard`,a.name],category:`analysis`,version:1})),d=await n.embedBatch(u.map(e=>e.content));await e.upsert(u,d)}catch(e){o.warn(`Auto-persist onboard step failed`,{stepName:a.name,...i(e)})}}function c(t,r,c){let l=e(`onboard`);t.registerTool(`onboard`,{title:l.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 KB. Use mode=generate to also write structured output to .ai/kb/ directory.`,inputSchema:{path:n.string().describe(`Root path of the codebase to onboard`),mode:n.enum([`memory`,`generate`]).default(`memory`).describe(`Output mode: memory = KB vector store only; generate = also write to .ai/kb/ directory`),out_dir:n.string().optional().describe(`Custom output directory for generate mode (default: <path>/.ai/kb)`)},annotations:l.annotations},async({path:e,mode:t,out_dir:n})=>{try{o.info(`Starting onboard`,{path:e,mode:t});let i=await a({path:e,mode:t,outDir:n});s(r,c,i);let l=[`## Onboard Complete`,``,`**Path:** \`${i.path}\``,`**Mode:** ${i.mode}`,`**Duration:** ${i.totalDurationMs}ms`,``];i.outDir&&(l.push(`**Output directory:** \`${i.outDir}\``),l.push(``)),l.push(`### Analysis Results`,``);let u=[],d=[];for(let e of i.steps)e.status===`success`?u.push(`- ✓ **${e.name}** (${e.durationMs}ms) — ${e.output.length} chars`):d.push(`- ✗ **${e.name}** — ${e.error}`);l.push(...u),d.length>0&&l.push(``,`### Failed`,``,...d),l.push(``,`---`,``);for(let e of i.steps)e.status===`success`&&l.push(`### ${e.name}`,``,e.output,``,`---`,``);return l.push(`_All results auto-saved to KB.`,i.mode===`generate`?` Files written to \`${i.outDir}\`.`:``," Next: Use `search` to query the knowledge, or `remember` to add custom insights._"),{content:[{type:`text`,text:l.join(`
-`)}]}}catch(e){return o.error(`Onboard failed`,i(e)),{content:[{type:`text`,text:`Onboard failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}export{c as registerOnboardTool};
+import{getToolMeta as e}from"../tool-metadata.js";import{createTaskRunner as t}from"../task-manager.js";import{createHash as n}from"node:crypto";import{z as r}from"zod";import{createLogger as i,serializeError as a}from"../../../core/dist/index.js";import{onboard as o}from"../../../tools/dist/index.js";const s=i(`tools`);let c=!1;async function l(e,t,r){for(let i of r.steps)if(!(i.status!==`success`||!i.output))try{let a=n(`sha256`).update(r.path).digest(`hex`).slice(0,12),o=`produced/onboard/${i.name}/${a}.md`,s=n(`sha256`).update(i.output).digest(`hex`).slice(0,16),c=new Date().toISOString(),l=i.output.length>2e3?i.output.split(/(?=^## )/m).filter(e=>e.trim().length>0):[i.output],u=l.map((e,t)=>({id:n(`sha256`).update(`${o}::${t}`).digest(`hex`).slice(0,16),content:e.trim(),sourcePath:o,contentType:`produced-knowledge`,chunkIndex:t,totalChunks:l.length,startLine:0,endLine:0,fileHash:s,indexedAt:c,origin:`produced`,tags:[`onboard`,i.name],category:`analysis`,version:1})),d=await t.embedBatch(u.map(e=>e.content));await e.upsert(u,d)}catch(e){s.warn(`Auto-persist onboard step failed`,{stepName:i.name,...a(e)})}}function u(n,i,u){let d=e(`onboard`);n.registerTool(`onboard`,{title:d.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 KB. Use mode=generate to also write structured output to .ai/kb/ directory.`,inputSchema:{path:r.string().describe(`Root path of the codebase to onboard`),mode:r.enum([`memory`,`generate`]).default(`memory`).describe(`Output mode: memory = KB vector store only; generate = also write to .ai/kb/ directory`),out_dir:r.string().optional().describe(`Custom output directory for generate mode (default: <path>/.ai/kb)`)},annotations:d.annotations},async({path:e,mode:n,out_dir:r},d)=>{try{if(c)return{content:[{type:`text`,text:`Onboard is already running. Please wait for it to complete before starting another.`}]};c=!0,s.info(`Starting onboard`,{path:e,mode:n});let a=await o({path:e,mode:n,outDir:r}),f=t(d).createTask(`Onboard`,a.steps.length);for(let e=0;e<a.steps.length;e++){let t=a.steps[e];f.progress(e,`${t.name}: ${t.status}`)}f.complete(`Onboard complete: ${a.steps.filter(e=>e.status===`success`).length}/${a.steps.length} steps succeeded`),l(i,u,a);let p=[`## Onboard Complete`,``,`**Path:** \`${a.path}\``,`**Mode:** ${a.mode}`,`**Duration:** ${a.totalDurationMs}ms`,``];a.outDir&&(p.push(`**Output directory:** \`${a.outDir}\``),p.push(``)),p.push(`### Analysis Results`,``);let m=[],h=[];for(let e of a.steps)e.status===`success`?m.push(`- ✓ **${e.name}** (${e.durationMs}ms) — ${e.output.length} chars`):h.push(`- ✗ **${e.name}** — ${e.error}`);p.push(...m),h.length>0&&p.push(``,`### Failed`,``,...h),p.push(``,`---`,``);for(let e of a.steps)e.status===`success`&&p.push(`### ${e.name}`,``,e.output,``,`---`,``);return p.push(`_All results auto-saved to KB.`,a.mode===`generate`?` Files written to \`${a.outDir}\`.`:``," Next: Use `search` to query the knowledge, or `remember` to add custom insights._"),{content:[{type:`text`,text:p.join(`
+`)}]}}catch(e){return s.error(`Onboard failed`,a(e)),{content:[{type:`text`,text:`Onboard failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}finally{c=!1}})}export{u as registerOnboardTool};

package/packages/server/dist/tools/persistence.tools.js

@@ -1,5 +1,5 @@
-import{getToolMeta as e}from"../tool-metadata.js";import{z as t}from"zod";import{createLogger as n,serializeError as r}from"../../../core/dist/index.js";import{addToWorkset as i,checkpointLatest as a,checkpointList as o,checkpointLoad as s,checkpointSave as c,deleteWorkset as l,getWorkset as u,laneCreate as d,laneDiff as f,laneDiscard as p,laneList as m,laneMerge as h,laneStatus as g,listWorksets as _,queueClear as v,queueCreate as y,queueDelete as b,queueDone as x,queueFail as S,queueGet as C,queueList as w,queueNext as T,queuePush as E,removeFromWorkset as D,saveWorkset as O,stashClear as k,stashDelete as A,stashGet as j,stashList as M,stashSet as N}from"../../../tools/dist/index.js";const P=n(`tools:persistence`);function F(n){let a=e(`workset`);n.registerTool(`workset`,{title:a.title,description:`Manage named file sets (worksets). Save, load, list, add/remove files. Worksets persist across sessions in .kb-state/worksets.json.`,inputSchema:{action:t.enum([`save`,`get`,`list`,`delete`,`add`,`remove`]).describe(`Operation to perform`),name:t.string().optional().describe(`Workset name (required for all except list)`),files:t.array(t.string()).optional().describe(`File paths (required for save, add, remove)`),description:t.string().optional().describe(`Description (for save)`)},annotations:a.annotations},async({action:e,name:t,files:n,description:a})=>{try{switch(e){case`save`:{if(!t||!n)throw Error(`name and files required for save`);let e=O(t,n,{description:a});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=u(t);return e?{content:[{type:`text`,text:JSON.stringify(e,null,2)}]}:{content:[{type:`text`,text:`Workset "${t}" not found.`}]}}case`list`:{let e=_();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(`
-`)}]}}case`delete`:if(!t)throw Error(`name required for delete`);return{content:[{type:`text`,text:l(t)?`Deleted workset "${t}".`:`Workset "${t}" not found.`}]};case`add`:{if(!t||!n)throw Error(`name and files required for add`);let e=i(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=D(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 P.error(`Workset operation failed`,r(e)),{content:[{type:`text`,text:`Workset operation failed. Check server logs for details.`}],isError:!0}}})}function I(n){let i=e(`stash`);n.registerTool(`stash`,{title:i.title,description:`Persist and retrieve named values in .kb-state/stash.json for intermediate results between tool calls.`,inputSchema:{action:t.enum([`set`,`get`,`list`,`delete`,`clear`]).describe(`Operation to perform on the stash`),key:t.string().optional().describe(`Entry key for set/get/delete operations`),value:t.string().optional().describe(`String or JSON value for set operations`)},annotations:i.annotations},async({action:e,key:t,value:n})=>{try{switch(e){case`set`:{if(!t)throw Error(`key required for set`);let e=N(t,V(n??``));return{content:[{type:`text`,text:`Stored stash entry "${e.key}" (${e.type}) at ${e.storedAt}.`}]}}case`get`:{if(!t)throw Error(`key required for get`);let e=j(t);return{content:[{type:`text`,text:e?JSON.stringify(e,null,2):`Stash entry "${t}" not found.`}]}}case`list`:{let e=M();return{content:[{type:`text`,text:e.length===0?`Stash is empty.`:e.map(e=>`- ${e.key} (${e.type}) — ${e.storedAt}`).join(`
-`)}]}}case`delete`:if(!t)throw Error(`key required for delete`);return{content:[{type:`text`,text:A(t)?`Deleted stash entry "${t}".`:`Stash entry "${t}" not found.`}]};case`clear`:{let e=k();return{content:[{type:`text`,text:`Cleared ${e} stash entr${e===1?`y`:`ies`}.`}]}}}}catch(e){return P.error(`Stash operation failed`,r(e)),{content:[{type:`text`,text:`Stash operation failed. Check server logs for details.`}],isError:!0}}})}function L(n){let i=e(`checkpoint`);n.registerTool(`checkpoint`,{title:i.title,description:`Save and restore lightweight session checkpoints in .kb-state/checkpoints for cross-session continuity.`,inputSchema:{action:t.enum([`save`,`load`,`list`,`latest`]).describe(`Checkpoint action to perform`),label:t.string().optional().describe(`Checkpoint label for save, or checkpoint id for load`),data:t.string().max(5e5).optional().describe(`JSON object string for save actions`),notes:t.string().max(1e4).optional().describe(`Optional notes for save actions`)},annotations:i.annotations},async({action:e,label:t,data:n,notes:i})=>{try{switch(e){case`save`:if(!t)throw Error(`label required for save`);return{content:[{type:`text`,text:B(c(t,H(n),{notes:i}))}]};case`load`:{if(!t)throw Error(`label required for load`);let e=s(t);return{content:[{type:`text`,text:e?B(e):`Checkpoint "${t}" not found.`}]}}case`list`:{let e=o();return{content:[{type:`text`,text:e.length===0?`No checkpoints saved.`:e.map(e=>`- ${e.id} — ${e.label} (${e.createdAt})`).join(`
-`)}]}}case`latest`:{let e=a();return{content:[{type:`text`,text:e?B(e):`No checkpoints saved.`}]}}}}catch(e){return P.error(`Checkpoint failed`,r(e)),{content:[{type:`text`,text:`Checkpoint failed. Check server logs for details.`}],isError:!0}}})}function R(n){let i=e(`lane`);n.registerTool(`lane`,{title:i.title,description:`Manage verified lanes — isolated file copies for parallel exploration. Create a lane, make changes, diff, merge back, or discard.`,inputSchema:{action:t.enum([`create`,`list`,`status`,`diff`,`merge`,`discard`]).describe(`Lane action to perform`),name:t.string().optional().describe(`Lane name (required for create/status/diff/merge/discard)`),files:t.array(t.string()).optional().describe(`File paths to copy into the lane (required for create)`)},annotations:i.annotations},async({action:e,name:t,files:n})=>{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=d(t,n);return{content:[{type:`text`,text:JSON.stringify(e,null,2)}]}}case`list`:return{content:[{type:`text`,text:JSON.stringify(m(),null,2)}]};case`status`:if(!t)throw Error(`name is required for status`);return{content:[{type:`text`,text:JSON.stringify(g(t),null,2)}]};case`diff`:if(!t)throw Error(`name is required for diff`);return{content:[{type:`text`,text:JSON.stringify(f(t),null,2)}]};case`merge`:if(!t)throw Error(`name is required for merge`);return{content:[{type:`text`,text:JSON.stringify(h(t),null,2)}]};case`discard`:if(!t)throw Error(`name is required for discard`);return{content:[{type:`text`,text:JSON.stringify({discarded:p(t)},null,2)}]}}}catch(e){return P.error(`Lane action failed`,r(e)),{content:[{type:`text`,text:`Lane action failed. Check server logs for details.`}],isError:!0}}})}function z(n){let i=e(`queue`);n.registerTool(`queue`,{title:i.title,description:`Manage task queues for sequential agent operations. Push items, take next, mark done/failed, list queues.`,inputSchema:{action:t.enum([`create`,`push`,`next`,`done`,`fail`,`get`,`list`,`clear`,`delete`]).describe(`Queue action`),name:t.string().optional().describe(`Queue name (required for most actions)`),title:t.string().optional().describe(`Item title (required for push)`),id:t.string().optional().describe(`Item ID (required for done/fail)`),data:t.unknown().optional().describe(`Arbitrary data to attach to a queue item`),error:t.string().optional().describe(`Error message (required for fail)`)},annotations:i.annotations},async({action:e,name:t,title:n,id:i,data:a,error:o})=>{try{switch(e){case`create`:if(!t)throw Error(`name is required for create`);return{content:[{type:`text`,text:JSON.stringify(y(t),null,2)}]};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(E(t,n,a),null,2)}]};case`next`:{if(!t)throw Error(`name is required for next`);let e=T(t);return{content:[{type:`text`,text:JSON.stringify(e,null,2)}]}}case`done`:if(!t)throw Error(`name is required for done`);if(!i)throw Error(`id is required for done`);return{content:[{type:`text`,text:JSON.stringify(x(t,i),null,2)}]};case`fail`:if(!t)throw Error(`name is required for fail`);if(!i)throw Error(`id is required for fail`);if(!o)throw Error(`error is required for fail`);return{content:[{type:`text`,text:JSON.stringify(S(t,i,o),null,2)}]};case`get`:if(!t)throw Error(`name is required for get`);return{content:[{type:`text`,text:JSON.stringify(C(t),null,2)}]};case`list`:return{content:[{type:`text`,text:JSON.stringify(w(),null,2)}]};case`clear`:if(!t)throw Error(`name is required for clear`);return{content:[{type:`text`,text:JSON.stringify({cleared:v(t)},null,2)}]};case`delete`:if(!t)throw Error(`name is required for delete`);return{content:[{type:`text`,text:JSON.stringify({deleted:b(t)},null,2)}]}}}catch(e){return P.error(`Queue action failed`,r(e)),{content:[{type:`text`,text:`Queue action failed. Check server logs for details.`}],isError:!0}}})}function B(e){let t=[e.id,`Label: ${e.label}`,`Created: ${e.createdAt}`];if(e.notes&&t.push(`Notes: ${e.notes}`),e.files?.length){t.push(`Files: ${e.files.length}`);for(let n of e.files)t.push(`  - ${n}`)}return t.push(``,`Data:`,JSON.stringify(e.data,null,2)),t.join(`
+import{getToolMeta as e}from"../tool-metadata.js";import{z as t}from"zod";import{createLogger as n,serializeError as r}from"../../../core/dist/index.js";import{addToWorkset as i,checkpointLatest as a,checkpointList as o,checkpointLoad as s,checkpointSave as c,deleteWorkset as l,getWorkset as u,laneCreate as d,laneDiff as f,laneDiscard as p,laneList as m,laneMerge as h,laneStatus as g,listWorksets as _,queueClear as v,queueCreate as y,queueDelete as b,queueDone as x,queueFail as S,queueGet as C,queueList as w,queueNext as T,queuePush as E,removeFromWorkset as D,saveWorkset as O,stashClear as k,stashDelete as A,stashGet as j,stashList as M,stashSet as N}from"../../../tools/dist/index.js";const P=n(`tools:persistence`);function F(n){let a=e(`workset`);n.registerTool(`workset`,{title:a.title,description:`Manage named file sets (worksets). Save, load, list, add/remove files. Worksets persist across sessions in .kb-state/worksets.json.`,inputSchema:{action:t.enum([`save`,`get`,`list`,`delete`,`add`,`remove`]).describe(`Operation to perform`),name:t.string().optional().describe(`Workset name (required for all except list)`),files:t.array(t.string()).optional().describe(`File paths (required for save, add, remove)`),description:t.string().optional().describe(`Description (for save)`)},annotations:a.annotations},async({action:e,name:t,files:n,description:a})=>{try{switch(e){case`save`:{if(!t||!n)throw Error(`name and files required for save`);let e=O(t,n,{description:a});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=u(t);return e?{content:[{type:`text`,text:JSON.stringify(e)}]}:{content:[{type:`text`,text:`Workset "${t}" not found.`}]}}case`list`:{let e=_();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(`
+`)}]}}case`delete`:if(!t)throw Error(`name required for delete`);return{content:[{type:`text`,text:l(t)?`Deleted workset "${t}".`:`Workset "${t}" not found.`}]};case`add`:{if(!t||!n)throw Error(`name and files required for add`);let e=i(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=D(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 P.error(`Workset operation failed`,r(e)),{content:[{type:`text`,text:`Workset operation failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}function I(n){let i=e(`stash`);n.registerTool(`stash`,{title:i.title,description:`Persist and retrieve named values in .kb-state/stash.json for intermediate results between tool calls.`,inputSchema:{action:t.enum([`set`,`get`,`list`,`delete`,`clear`]).describe(`Operation to perform on the stash`),key:t.string().optional().describe(`Entry key for set/get/delete operations`),value:t.string().optional().describe(`String or JSON value for set operations`)},annotations:i.annotations},async({action:e,key:t,value:n})=>{try{switch(e){case`set`:{if(!t)throw Error(`key required for set`);let e=N(t,V(n??``));return{content:[{type:`text`,text:`Stored stash entry "${e.key}" (${e.type}) at ${e.storedAt}.`}]}}case`get`:{if(!t)throw Error(`key required for get`);let e=j(t);return{content:[{type:`text`,text:e?JSON.stringify(e):`Stash entry "${t}" not found.`}]}}case`list`:{let e=M();return{content:[{type:`text`,text:e.length===0?`Stash is empty.`:e.map(e=>`- ${e.key} (${e.type}) — ${e.storedAt}`).join(`
+`)}]}}case`delete`:if(!t)throw Error(`key required for delete`);return{content:[{type:`text`,text:A(t)?`Deleted stash entry "${t}".`:`Stash entry "${t}" not found.`}]};case`clear`:{let e=k();return{content:[{type:`text`,text:`Cleared ${e} stash entr${e===1?`y`:`ies`}.`}]}}}}catch(e){return P.error(`Stash operation failed`,r(e)),{content:[{type:`text`,text:`Stash operation failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}function L(n){let i=e(`checkpoint`);n.registerTool(`checkpoint`,{title:i.title,description:`Save and restore lightweight session checkpoints in .kb-state/checkpoints for cross-session continuity.`,inputSchema:{action:t.enum([`save`,`load`,`list`,`latest`]).describe(`Checkpoint action to perform`),label:t.string().optional().describe(`Checkpoint label for save, or checkpoint id for load`),data:t.string().max(5e5).optional().describe(`JSON object string for save actions`),notes:t.string().max(1e4).optional().describe(`Optional notes for save actions`)},annotations:i.annotations},async({action:e,label:t,data:n,notes:i})=>{try{switch(e){case`save`:if(!t)throw Error(`label required for save`);return{content:[{type:`text`,text:B(c(t,H(n),{notes:i}))}]};case`load`:{if(!t)throw Error(`label required for load`);let e=s(t);return{content:[{type:`text`,text:e?B(e):`Checkpoint "${t}" not found.`}]}}case`list`:{let e=o();return{content:[{type:`text`,text:e.length===0?`No checkpoints saved.`:e.map(e=>`- ${e.id} — ${e.label} (${e.createdAt})`).join(`
+`)}]}}case`latest`:{let e=a();return{content:[{type:`text`,text:e?B(e):`No checkpoints saved.`}]}}}}catch(e){return P.error(`Checkpoint failed`,r(e)),{content:[{type:`text`,text:`Checkpoint failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}function R(n){let i=e(`lane`);n.registerTool(`lane`,{title:i.title,description:`Manage verified lanes — isolated file copies for parallel exploration. Create a lane, make changes, diff, merge back, or discard.`,inputSchema:{action:t.enum([`create`,`list`,`status`,`diff`,`merge`,`discard`]).describe(`Lane action to perform`),name:t.string().optional().describe(`Lane name (required for create/status/diff/merge/discard)`),files:t.array(t.string()).optional().describe(`File paths to copy into the lane (required for create)`)},annotations:i.annotations},async({action:e,name:t,files:n})=>{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=d(t,n);return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`list`:return{content:[{type:`text`,text:JSON.stringify(m())}]};case`status`:if(!t)throw Error(`name is required for status`);return{content:[{type:`text`,text:JSON.stringify(g(t))}]};case`diff`:if(!t)throw Error(`name is required for diff`);return{content:[{type:`text`,text:JSON.stringify(f(t))}]};case`merge`:if(!t)throw Error(`name is required for merge`);return{content:[{type:`text`,text:JSON.stringify(h(t))}]};case`discard`:if(!t)throw Error(`name is required for discard`);return{content:[{type:`text`,text:JSON.stringify({discarded:p(t)})}]}}}catch(e){return P.error(`Lane action failed`,r(e)),{content:[{type:`text`,text:`Lane action failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}function z(n){let i=e(`queue`);n.registerTool(`queue`,{title:i.title,description:`Manage task queues for sequential agent operations. Push items, take next, mark done/failed, list queues.`,inputSchema:{action:t.enum([`create`,`push`,`next`,`done`,`fail`,`get`,`list`,`clear`,`delete`]).describe(`Queue action`),name:t.string().optional().describe(`Queue name (required for most actions)`),title:t.string().optional().describe(`Item title (required for push)`),id:t.string().optional().describe(`Item ID (required for done/fail)`),data:t.unknown().optional().describe(`Arbitrary data to attach to a queue item`),error:t.string().optional().describe(`Error message (required for fail)`)},annotations:i.annotations},async({action:e,name:t,title:n,id:i,data:a,error:o})=>{try{switch(e){case`create`:if(!t)throw Error(`name is required for create`);return{content:[{type:`text`,text:JSON.stringify(y(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(E(t,n,a))}]};case`next`:{if(!t)throw Error(`name is required for next`);let e=T(t);return{content:[{type:`text`,text:JSON.stringify(e)}]}}case`done`:if(!t)throw Error(`name is required for done`);if(!i)throw Error(`id is required for done`);return{content:[{type:`text`,text:JSON.stringify(x(t,i))}]};case`fail`:if(!t)throw Error(`name is required for fail`);if(!i)throw Error(`id is required for fail`);if(!o)throw Error(`error is required for fail`);return{content:[{type:`text`,text:JSON.stringify(S(t,i,o))}]};case`get`:if(!t)throw Error(`name is required for get`);return{content:[{type:`text`,text:JSON.stringify(C(t))}]};case`list`:return{content:[{type:`text`,text:JSON.stringify(w())}]};case`clear`:if(!t)throw Error(`name is required for clear`);return{content:[{type:`text`,text:JSON.stringify({cleared:v(t)})}]};case`delete`:if(!t)throw Error(`name is required for delete`);return{content:[{type:`text`,text:JSON.stringify({deleted:b(t)})}]}}}catch(e){return P.error(`Queue action failed`,r(e)),{content:[{type:`text`,text:`Queue action failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}function B(e){let t=[e.id,`Label: ${e.label}`,`Created: ${e.createdAt}`];if(e.notes&&t.push(`Notes: ${e.notes}`),e.files?.length){t.push(`Files: ${e.files.length}`);for(let n of e.files)t.push(`  - ${n}`)}return t.push(``,`Data:`,JSON.stringify(e.data)),t.join(`
 `)}function V(e){let t=e.trim();if(!t)return``;try{return JSON.parse(t)}catch{return e}}function H(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}export{L as registerCheckpointTool,R as registerLaneTool,z as registerQueueTool,I as registerStashTool,F as registerWorksetTool};

package/packages/server/dist/tools/policy.tools.js

@@ -1,2 +1,3 @@
-import{getToolMeta as e}from"../tool-metadata.js";import{z as t}from"zod";import{createLogger as n,serializeError as r}from"../../../core/dist/index.js";const i=n(`tools`);function a(n,a){let o=e(`er_update_policy`);n.registerTool(`er_update_policy`,{title:o.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:t.enum([`list`,`get`,`update`,`create`,`delete`]).describe(`Action to perform on classification rules`),rule_id:t.string().optional().describe(`Rule ID (required for get, update, delete)`),changes:t.object({patterns:t.array(t.string()).optional(),category:t.string().optional(),pushWeight:t.number().min(0).max(1).optional(),description:t.string().optional(),examples:t.array(t.string()).optional(),enabled:t.boolean().optional()}).optional().describe(`Changes to apply (for update action)`),new_rule:t.object({id:t.string().regex(/^[a-z][a-z0-9-]*$/),patterns:t.array(t.string()).min(1),category:t.string(),pushWeight:t.number().min(0).max(1),description:t.string(),examples:t.array(t.string()).default([]),enabled:t.boolean().default(!0)}).optional().describe(`New rule definition (for create action)`)},annotations:o.annotations},async({action:e,rule_id:t,changes:n,new_rule:o})=>{try{if(e===`list`){let e=a.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(`
-`)}\n\n---\n_${e.length} rules total. Use \`action: "update"\` to modify a rule._`}]}}if(e===`get`){if(!t)return{content:[{type:`text`,text:'`rule_id` is required for "get" action.'}],isError:!0};let e=a.getRule(t);return e?{content:[{type:`text`,text:`## Rule: ${e.id}\n\n${JSON.stringify(e,null,2)}`}]}:{content:[{type:`text`,text:`Rule "${t}" not found.`}],isError:!0}}if(e===`update`){if(!t||!n)return{content:[{type:`text`,text:'`rule_id` and `changes` are required for "update" action.'}],isError:!0};let e=a.updateRule(t,n);return e?{content:[{type:`text`,text:`Updated rule **${t}**.\n\n${JSON.stringify(e,null,2)}\n\n---\n_Next: Use \`action: "list"\` to verify all rules._`}]}:{content:[{type:`text`,text:`Rule "${t}" not found.`}],isError:!0}}if(e===`create`){if(!o)return{content:[{type:`text`,text:'`new_rule` is required for "create" action.'}],isError:!0};let e=a.addRule(o);return{content:[{type:`text`,text:`Created rule **${e.id}**.\n\n${JSON.stringify(e,null,2)}\n\n---\n_Next: Test classification with \`remember\` and check signals._`}]}}return e===`delete`?t?a.deleteRule(t)?{content:[{type:`text`,text:`Deleted rule **${t}**.\n\n---\n_Next: Use \`action: "list"\` to verify._`}]}:{content:[{type:`text`,text:`Rule "${t}" not found.`}],isError:!0}:{content:[{type:`text`,text:'`rule_id` is required for "delete" action.'}],isError:!0}:{content:[{type:`text`,text:`Unknown action: ${e}`}],isError:!0}}catch(e){return i.error(`Policy update failed`,r(e)),{content:[{type:`text`,text:`Policy update failed. Check server logs for details.`}],isError:!0}}})}export{a as registerErUpdatePolicyTool};
+import{getToolMeta as e}from"../tool-metadata.js";import{z as t}from"zod";import{createLogger as n,serializeError as r}from"../../../core/dist/index.js";const i=n(`tools`);function a(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(`
+`)}function o(n,o){let s=e(`er_update_policy`);n.registerTool(`er_update_policy`,{title:s.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:t.enum([`list`,`get`,`update`,`create`,`delete`]).describe(`Action to perform on classification rules`),rule_id:t.string().optional().describe(`Rule ID (required for get, update, delete)`),changes:t.object({patterns:t.array(t.string()).optional(),category:t.string().optional(),pushWeight:t.number().min(0).max(1).optional(),description:t.string().optional(),examples:t.array(t.string()).optional(),enabled:t.boolean().optional()}).optional().describe(`Changes to apply (for update action)`),new_rule:t.object({id:t.string().regex(/^[a-z][a-z0-9-]*$/),patterns:t.array(t.string()).min(1),category:t.string(),pushWeight:t.number().min(0).max(1),description:t.string(),examples:t.array(t.string()).default([]),enabled:t.boolean().default(!0)}).optional().describe(`New rule definition (for create action)`)},annotations:s.annotations},async({action:e,rule_id:t,changes:n,new_rule:s})=>{try{if(e===`list`){let e=o.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(`
+`)}\n\n---\n_${e.length} rules total. Use \`action: "update"\` to modify a rule._`}]}}if(e===`get`){if(!t)return{content:[{type:`text`,text:'`rule_id` is required for "get" action.'}],isError:!0};let e=o.getRule(t);return e?{content:[{type:`text`,text:a(e)}]}:{content:[{type:`text`,text:`Rule "${t}" not found.`}],isError:!0}}if(e===`update`){if(!t||!n)return{content:[{type:`text`,text:'`rule_id` and `changes` are required for "update" action.'}],isError:!0};let e=o.updateRule(t,n);return e?{content:[{type:`text`,text:`${a(e)}\n\n---\n_Updated. Next: Use \`action: "list"\` to verify._`}]}:{content:[{type:`text`,text:`Rule "${t}" not found.`}],isError:!0}}return e===`create`?s?{content:[{type:`text`,text:`${a(o.addRule(s))}\n\n---\n_Created. Next: Test classification with \`remember\`._`}]}:{content:[{type:`text`,text:'`new_rule` is required for "create" action.'}],isError:!0}:e===`delete`?t?o.deleteRule(t)?{content:[{type:`text`,text:`Deleted rule **${t}**.\n\n---\n_Next: Use \`action: "list"\` to verify._`}]}:{content:[{type:`text`,text:`Rule "${t}" not found.`}],isError:!0}:{content:[{type:`text`,text:'`rule_id` is required for "delete" action.'}],isError:!0}:{content:[{type:`text`,text:`Unknown action: ${e}`}],isError:!0}}catch(e){return i.error(`Policy update failed`,r(e)),{content:[{type:`text`,text:`Policy update failed: ${e instanceof Error?e.message:String(e)}`}],isError:!0}}})}export{o as registerErUpdatePolicyTool};

package/packages/server/dist/tools/present-blocks.d.ts

@@ -0,0 +1,46 @@
+//#region packages/server/src/tools/present-blocks.d.ts
+/**
+ * Present Blocks — New block-type renderers.
+ *
+ * Each function returns an HTML string that pairs with classes
+ * already defined in present-theme.ts.
+ */
+interface TimelineItem {
+  phase?: string;
+  title: string;
+  description?: string;
+  status?: 'done' | 'active' | 'pending' | 'error';
+}
+interface ChecklistItem {
+  label: string;
+  checked?: boolean;
+  note?: string;
+}
+interface ComparisonColumn {
+  title: string;
+  items: string[];
+}
+interface StatusItem {
+  label: string;
+  status: 'success' | 'warning' | 'error' | 'info' | 'pending';
+  detail?: string;
+}
+interface PromptValue {
+  question: string;
+  context?: string;
+  placeholder?: string;
+}
+interface ProgressItem {
+  label: string;
+  value: number;
+  max?: number;
+  color?: string;
+}
+declare function renderTimelineHtml(value: unknown): string;
+declare function renderChecklistHtml(value: unknown): string;
+declare function renderComparisonHtml(value: unknown): string;
+declare function renderStatusBoardHtml(value: unknown): string;
+declare function renderPromptHtml(value: unknown): string;
+declare function renderProgressHtml(value: unknown): string;
+//#endregion
+export { ChecklistItem, ComparisonColumn, ProgressItem, PromptValue, StatusItem, TimelineItem, renderChecklistHtml, renderComparisonHtml, renderProgressHtml, renderPromptHtml, renderStatusBoardHtml, renderTimelineHtml };

package/packages/server/dist/tools/present-blocks.js

@@ -0,0 +1,27 @@
+import{escHtml as e}from"./present-utils.js";const t=e;function n(e){let n=e;return!n?.items||!Array.isArray(n.items)?``:`<div class="timeline">${n.items.map(e=>{let n=e.status??`pending`,r=e.phase?`<div class="timeline-phase">${t(e.phase)}</div>`:``,i=e.description?`<div class="timeline-desc">${t(e.description)}</div>`:``;return`<div class="timeline-item">
+      <div class="timeline-dot ${n}"></div>
+      ${r}
+      <div class="timeline-title">${t(e.title)}</div>
+      ${i}
+    </div>`}).join(``)}</div>`}function r(e){let n=e;return!n?.items||!Array.isArray(n.items)?``:`<div class="checklist">${n.items.map(e=>{let n=e.checked?`checked`:``,r=e.checked?`✓`:``,i=e.note?`<div class="checklist-note">${t(e.note)}</div>`:``;return`<div class="checklist-item ${n}">
+      <div class="checklist-check ${n}">${r}</div>
+      <div>
+        <div class="checklist-label">${t(e.label)}</div>
+        ${i}
+      </div>
+    </div>`}).join(``)}</div>`}function i(e){let n=e;if(!n?.columns||!Array.isArray(n.columns)||n.columns.length===0)return``;let r=n.columns.length,i=Math.max(...n.columns.map(e=>e.items?.length??0));return`<div class="comparison-grid" style="grid-template-columns:repeat(${r},1fr)">${n.columns.map(e=>{let n=`<div class="comparison-header">${t(e.title)}</div>`,r=[];for(let n=0;n<i;n++){let i=e.items?.[n]??``;r.push(`<div class="comparison-item">${t(i)}</div>`)}return`<div class="comparison-col">${n}${r.join(``)}</div>`}).join(``)}</div>`}function a(e){let n=e;return!n?.items||!Array.isArray(n.items)?``:`<div class="status-board">${n.items.map(e=>{let n=e.detail?`<span class="status-detail">${t(e.detail)}</span>`:``;return`<div class="status-row">
+      <div class="status-indicator ${e.status??`pending`}"></div>
+      <span class="status-label">${t(e.label)}</span>
+      ${n}
+    </div>`}).join(``)}</div>`}function o(e){let n=e;if(!n?.question)return``;let r=n.context?`<div class="prompt-context">${t(n.context)}</div>`:``,i=n.placeholder?`<div class="prompt-placeholder">${t(n.placeholder)}</div>`:``;return`<div class="prompt-block">
+    <div class="prompt-question">${t(n.question)}</div>
+    ${r}${i}
+  </div>`}function s(e){let n=e;if(!n?.items||!Array.isArray(n.items))return``;let r=e=>e>=100?`var(--success)`:e>=60?`var(--primary)`:e>=30?`var(--warning)`:`var(--error)`;return`<div class="progress-list">${n.items.map(e=>{let n=e.max??100,i=n>0?Math.min(100,e.value/n*100):0,a=e.color??r(i);return`<div class="progress-item">
+      <div class="progress-header">
+        <span class="progress-label">${t(e.label)}</span>
+        <span class="progress-value">${e.value}/${n}</span>
+      </div>
+      <div class="progress-track">
+        <div class="progress-fill" style="width:${i.toFixed(1)}%;background:${a}"></div>
+      </div>
+    </div>`}).join(``)}</div>`}export{r as renderChecklistHtml,i as renderComparisonHtml,s as renderProgressHtml,o as renderPromptHtml,a as renderStatusBoardHtml,n as renderTimelineHtml};

package/packages/server/dist/tools/present-charts.d.ts

@@ -0,0 +1,31 @@
+//#region packages/server/src/tools/present-charts.d.ts
+/**
+ * Present Charts — Pure SVG chart rendering engine.
+ *
+ * Supports: line, area, bar, horizontal-bar, pie, donut, sparkline, heatmap.
+ * Uses CSS custom properties (--chart-1 … --chart-12) from present-theme.ts.
+ * Zero external dependencies.
+ */
+interface ChartBlock {
+  type: 'chart';
+  title?: string;
+  value: ChartValue;
+}
+interface ChartValue {
+  chartType: 'line' | 'area' | 'bar' | 'horizontal-bar' | 'pie' | 'donut' | 'sparkline' | 'heatmap';
+  data: Record<string, unknown>[];
+  xKey: string;
+  yKeys: string[];
+  title?: string;
+  height?: number;
+  showLegend?: boolean;
+  showGrid?: boolean;
+  config?: Record<string, unknown>;
+}
+/**
+ * Render a chart block as an HTML string containing an inline SVG.
+ * Returns a wrapping `<div class="chart-container">` with optional title and legend.
+ */
+declare function renderChartAsHtml(block: ChartBlock): string;
+//#endregion
+export { ChartBlock, ChartValue, renderChartAsHtml };

package/packages/server/dist/tools/present-charts.js

@@ -0,0 +1,34 @@
+import{escHtml as e}from"./present-utils.js";const t=e;function n(e){return Math.abs(e)>=1e6?`${(e/1e6).toFixed(1).replace(/\.0$/,``)}M`:Math.abs(e)>=1e3?`${(e/1e3).toFixed(1).replace(/\.0$/,``)}k`:Number.isInteger(e)?String(e):e.toFixed(1)}function r(e){return`var(--chart-${e%12+1})`}let i=0;function a(e){let n=e.value;if(!n?.data?.length||!n.chartType)return`<pre>${t(JSON.stringify(e.value,null,2))}</pre>`;i++;let r=e.title||n.title?`<div class="chart-title">${t(String(e.title||n.title))}</div>`:``,a;switch(n.chartType){case`line`:a=m(n,!1);break;case`area`:a=m(n,!0);break;case`bar`:a=h(n,!1);break;case`horizontal-bar`:a=h(n,!0);break;case`pie`:a=g(n,!1);break;case`donut`:a=g(n,!0);break;case`sparkline`:a=_(n);break;case`heatmap`:a=v(n);break;default:a=`<pre>${t(JSON.stringify(n,null,2))}</pre>`}let s=n.showLegend!==!1&&n.yKeys.length>1&&n.chartType!==`sparkline`?o(n.yKeys):``;return`<div class="chart-container">${r}${a}${s}</div>`}function o(e){return`<div class="chart-legend">${e.map((e,n)=>`<span class="chart-legend-item"><span class="chart-legend-swatch" style="background:${r(n)}"></span>${t(e)}</span>`).join(``)}</div>`}const s={top:20,right:20,bottom:35,left:55};function c(e,t){return e.map(e=>Number(e[t])||0)}function l(e,t){return e.map(e=>String(e[t]??``))}function u(e){let t=1/0,n=-1/0;for(let r of e)r<t&&(t=r),r>n&&(n=r);return t===n&&(t=t===0?0:t*.9,n=n===0?1:n*1.1),[t,n]}function d(e){return e>=0?0:e}function f(e,t,r,i=5){let a=[];for(let o=0;o<=i;o++){let c=o/i,l=s.top+r-c*r,u=e+c*(t-e);a.push(`<line class="chart-grid-line" x1="${s.left}" x2="${600-s.right}" y1="${l}" y2="${l}"/>`),a.push(`<text class="chart-axis-label" x="${s.left-8}" y="${l+4}" text-anchor="end">${n(u)}</text>`)}return a.join(``)}function p(e,n,r,i){let a=Math.floor(n/50),o=Math.max(1,Math.ceil(e.length/a));return e.map((e,n)=>n%o===0?`<text class="chart-axis-label" x="${s.left+n*i+i/2}" y="${s.top+r+18}" text-anchor="middle">${t(e.length>10?`${e.slice(0,9)}…`:e)}</text>`:``).join(``)}function m(e,t){let n=(e.height??300)-s.top-s.bottom,a=600-s.left-s.right,o=l(e.data,e.xKey),m=e.data.length;if(m===0)return``;let h=a/Math.max(m-1,1),g=1/0,_=-1/0;for(let t of e.yKeys){let[n,r]=u(c(e.data,t));n<g&&(g=n),r>_&&(_=r)}g=d(g);let v=_-g||1,y=e=>s.top+n-(e-g)/v*n,b=e=>s.left+e*h,x=``,S=[];for(let a=0;a<e.yKeys.length;a++){let o=c(e.data,e.yKeys[a]),l=r(a),u=`M${o.map((e,t)=>`${b(t).toFixed(1)},${y(e).toFixed(1)}`).join(`L`)}`;if(t){let e=`ag${i}_${a}`;x+=`<linearGradient id="${e}" x1="0" y1="0" x2="0" y2="1">
+        <stop offset="0%" stop-color="${l}" stop-opacity="0.3"/>
+        <stop offset="100%" stop-color="${l}" stop-opacity="0"/>
+      </linearGradient>`;let t=`${u}L${b(m-1).toFixed(1)},${(s.top+n).toFixed(1)}L${b(0).toFixed(1)},${(s.top+n).toFixed(1)}Z`;S.push(`<path d="${t}" fill="url(#${e})" stroke="none"/>`)}S.push(`<path d="${u}" fill="none" stroke="${l}" stroke-width="2" stroke-linejoin="round" stroke-linecap="round"/>`);for(let e=0;e<o.length;e++)S.push(`<circle cx="${b(e).toFixed(1)}" cy="${y(o[e]).toFixed(1)}" r="3" fill="${l}" stroke="var(--card)" stroke-width="1.5"/>`)}let C=e.height??300,w=e.showGrid===!1?``:f(g,_,n),T=p(o,a,n,m>1?h:a);return`<svg class="chart-svg" viewBox="0 0 600 ${C}" preserveAspectRatio="xMidYMid meet">
+    ${x?`<defs>${x}</defs>`:``}
+    ${w}${T}${S.join(``)}
+  </svg>`}function h(e,i){let a=(e.height??300)-s.top-s.bottom,o=600-s.left-s.right,u=l(e.data,e.xKey),d=e.data.length;if(d===0)return``;let m=e.yKeys.length,h=0;for(let t of e.yKeys)for(let n of c(e.data,t))n>h&&(h=n);h===0&&(h=1);let g=e.height??300,_=[];if(i){let i=Math.min(24,(a-(d-1)*4)/(d*m)),c=i*m+4,l=e.showGrid===!1?``:f(0,h,a),p=u.map((e,n)=>{let r=s.top+n*c+c/2,i=e.length>15?`${e.slice(0,14)}…`:e;return`<text class="chart-axis-label" x="${s.left-8}" y="${r+4}" text-anchor="end">${t(i)}</text>`}).join(``);for(let a=0;a<d;a++)for(let l=0;l<m;l++){let u=Number(e.data[a][e.yKeys[l]])||0,d=u/h*o,f=s.top+a*c+l*i;_.push(`<rect x="${s.left}" y="${f}" width="${d.toFixed(1)}" height="${i-2}" rx="3" fill="${r(l)}" opacity="0.85">
+          <title>${t(e.yKeys[l])}: ${n(u)}</title>
+        </rect>`)}return`<svg class="chart-svg" viewBox="0 0 600 ${Math.max(g,d*c+s.top+s.bottom)}" preserveAspectRatio="xMidYMid meet">
+      ${l}${p}${_.join(``)}
+    </svg>`}else{let i=o/d,c=Math.min(40,(i-8)/m),l=e.showGrid===!1?``:f(0,h,a),v=p(u,o,a,i);for(let o=0;o<d;o++)for(let l=0;l<m;l++){let u=Number(e.data[o][e.yKeys[l]])||0,d=u/h*a,f=s.left+o*i+(i-c*m)/2+l*c,p=s.top+a-d;_.push(`<rect x="${f.toFixed(1)}" y="${p.toFixed(1)}" width="${(c-2).toFixed(1)}" height="${d.toFixed(1)}" rx="3" fill="${r(l)}" opacity="0.85">
+          <title>${t(e.yKeys[l])}: ${n(u)}</title>
+        </rect>`)}return`<svg class="chart-svg" viewBox="0 0 600 ${g}" preserveAspectRatio="xMidYMid meet">
+      ${l}${v}${_.join(``)}
+    </svg>`}}function g(e,i){let a=e.height??300,s=a/2,c=a/2,u=a/2-10,d=i?u*.55:0,f=e.yKeys[0]||`value`,p=e.data.map(e=>Math.max(0,Number(e[f])||0)),m=l(e.data,e.xKey),h=p.reduce((e,t)=>e+t,0);if(h===0)return`<div style="color:var(--muted-foreground);text-align:center;padding:20px">No data</div>`;let g=[],_=-Math.PI/2;for(let e=0;e<p.length;e++){let i=p[e]/h;if(i===0)continue;let a=i*Math.PI*2,o=_,l=_+a,f=s+u*Math.cos(o),v=c+u*Math.sin(o),y=s+u*Math.cos(l),b=c+u*Math.sin(l),x=a>Math.PI?1:0,S;if(d>0){let e=s+d*Math.cos(o),t=c+d*Math.sin(o),n=s+d*Math.cos(l),r=c+d*Math.sin(l);S=`M${f.toFixed(2)},${v.toFixed(2)} A${u},${u} 0 ${x},1 ${y.toFixed(2)},${b.toFixed(2)} L${n.toFixed(2)},${r.toFixed(2)} A${d},${d} 0 ${x},0 ${e.toFixed(2)},${t.toFixed(2)}Z`}else S=`M${s},${c} L${f.toFixed(2)},${v.toFixed(2)} A${u},${u} 0 ${x},1 ${y.toFixed(2)},${b.toFixed(2)}Z`;g.push(`<path d="${S}" fill="${r(e)}" stroke="var(--background)" stroke-width="2" opacity="0.9">
+      <title>${t(m[e]||`Item ${e+1}`)}: ${n(p[e])} (${(i*100).toFixed(1)}%)</title>
+    </path>`),_=l}let v=i?`<text x="${s}" y="${c-6}" text-anchor="middle" fill="var(--foreground)" font-size="18" font-weight="700">${n(h)}</text>
+       <text x="${s}" y="${c+12}" text-anchor="middle" fill="var(--muted-foreground)" font-size="11">Total</text>`:``,y=o(m.filter((e,t)=>p[t]>0));return`<svg class="chart-svg" viewBox="0 0 ${a} ${a}" preserveAspectRatio="xMidYMid meet">
+    ${g.join(``)}${v}
+  </svg>${y}`}function _(e){let t=e.height??40,n=e.yKeys[0]||`value`,a=c(e.data,n),o=a.length;if(o===0)return``;let[s,l]=u(a),d=l-s||1,f=200/Math.max(o-1,1),p=a.map((e,n)=>`${(n*f).toFixed(1)},${(t-4-(e-s)/d*(t-8)).toFixed(1)}`),m=`spk${i}`,h=r(0);return`<svg class="chart-svg" viewBox="0 0 200 ${t}" preserveAspectRatio="xMidYMid meet" style="max-width:200px;height:${t}px">
+    <defs>
+      <linearGradient id="${m}" x1="0" y1="0" x2="0" y2="1">
+        <stop offset="0%" stop-color="${h}" stop-opacity="0.2"/>
+        <stop offset="100%" stop-color="${h}" stop-opacity="0"/>
+      </linearGradient>
+    </defs>
+    <path d="M${p.join(`L`)}L${((o-1)*f).toFixed(1)},${t}L0,${t}Z" fill="url(#${m})" stroke="none"/>
+    <polyline points="${p.join(` `)}" fill="none" stroke="${h}" stroke-width="1.5" stroke-linejoin="round"/>
+    <circle cx="${((o-1)*f).toFixed(1)}" cy="${p[o-1].split(`,`)[1]}" r="2.5" fill="${h}"/>
+  </svg>`}function v(e){let r=l(e.data,e.xKey),i=e.data.length,a=e.yKeys.length;if(i===0||a===0)return``;let o=1/0,u=-1/0;for(let t of e.yKeys)for(let n of c(e.data,t))n<o&&(o=n),n>u&&(u=n);let d=u-o||1,f=Math.min(50,(600-s.left-s.right)/i),p=Math.min(30,200/a),m=s.left+i*f+s.right,h=s.top+a*p+s.bottom,g=[];for(let n=0;n<a;n++){let r=s.top+n*p+p/2+4,i=e.yKeys[n].length>8?`${e.yKeys[n].slice(0,7)}…`:e.yKeys[n];g.push(`<text class="chart-axis-label" x="${s.left-8}" y="${r}" text-anchor="end">${t(i)}</text>`)}let _=Math.floor((m-s.left)/40),v=Math.max(1,Math.ceil(i/_));for(let e=0;e<i;e++){if(e%v!==0)continue;let n=s.left+e*f+f/2,i=r[e].length>6?`${r[e].slice(0,5)}…`:r[e];g.push(`<text class="chart-axis-label" x="${n}" y="${h-8}" text-anchor="middle">${t(i)}</text>`)}for(let c=0;c<i;c++)for(let i=0;i<a;i++){let a=Number(e.data[c][e.yKeys[i]])||0,l=(a-o)/d,u=s.left+c*f,m=s.top+i*p;g.push(`<rect x="${u}" y="${m}" width="${f-1}" height="${p-1}" rx="2" fill="var(--primary)" opacity="${(.1+l*.8).toFixed(2)}">
+        <title>${t(r[c])} / ${t(e.yKeys[i])}: ${n(a)}</title>
+      </rect>`)}return`<svg class="chart-svg" viewBox="0 0 ${m} ${h}" preserveAspectRatio="xMidYMid meet">
+    ${g.join(``)}
+  </svg>`}export{a as renderChartAsHtml};

package/packages/server/dist/tools/present-theme.d.ts

@@ -0,0 +1,14 @@
+//#region packages/server/src/tools/present-theme.d.ts
+/**
+ * Present Design System — CSS tokens and component styles.
+ *
+ * Based on notification-dashboard design tokens.
+ * Dark mode by default, professional clean aesthetic.
+ * Font: Plus Jakarta Sans via Google Fonts CDN.
+ */
+/** Google Fonts <link> tag to inject into <head>. */
+declare const FONT_LINK = "<link href=\"https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap\" rel=\"stylesheet\">";
+/** Returns the full design system CSS string for browser-mode HTML pages. */
+declare function getDesignSystemCSS(): string;
+//#endregion
+export { FONT_LINK, getDesignSystemCSS };