@vpxa/aikit 0.1.59 → 0.1.61

package/packages/tools/dist/watch.d.ts

@@ -1,32 +0,0 @@
-//#region packages/tools/src/watch.d.ts
-interface WatchEvent {
-  type: 'change' | 'rename';
-  path: string;
-  timestamp: string;
-}
-interface WatchOptions {
-  /** Directory to watch */
-  path: string;
-  /** Glob patterns to exclude */
-  exclude?: string[];
-  /** Max events to buffer (default: 100) */
-  maxEvents?: number;
-}
-interface WatchHandle {
-  id: string;
-  path: string;
-  events: WatchEvent[];
-  status: 'watching' | 'stopped';
-  stop: () => void;
-  getEvents: (since?: string) => WatchEvent[];
-}
-declare function watchStart(options: WatchOptions): WatchHandle;
-declare function watchStop(id: string): boolean;
-declare function watchList(): Array<{
-  id: string;
-  path: string;
-  status: string;
-  eventCount: number;
-}>;
-//#endregion
-export { WatchEvent, WatchHandle, WatchOptions, watchList, watchStart, watchStop };

package/packages/tools/dist/watch.js

@@ -1 +0,0 @@
-import{watch as e}from"node:fs";import{AIKIT_PATHS as t}from"../../core/dist/index.js";const n=new Map,r=[`node_modules`,`.git`,`dist`,`.turbo`,t.data,`cdk.out`];function i(t){if(n.size>=20)throw Error(`Watcher limit reached (20). Stop existing watchers first.`);let{path:i,maxEvents:a=100}=t,o=t.exclude??r,c=`watch-${Date.now()}`,l=[],u=e=>o.some(t=>s(e).includes(s(t))),d=e(i,{recursive:!0},(e,t)=>{if(t==null)return;let n=String(t);!n||u(n)||(l.push({type:e,path:s(n),timestamp:new Date().toISOString()}),l.length>a&&l.shift())});d.on(`error`,()=>{f.status=`stopped`,n.delete(c);try{d.close()}catch{}});let f={id:c,path:i,events:l,status:`watching`,stop:()=>{d.close(),f.status=`stopped`,n.delete(c)},getEvents:e=>e?l.filter(t=>t.timestamp>e):l};return n.set(c,{watcher:d,handle:f}),f}function a(e){let t=n.get(e);return t?(t.handle.stop(),!0):!1}function o(){return[...n.values()].map(e=>({id:e.handle.id,path:e.handle.path,status:e.handle.status,eventCount:e.handle.events.length}))}function s(e){return e.replace(/\\/g,`/`)}export{o as watchList,i as watchStart,a as watchStop};

package/packages/tools/dist/web-fetch.d.ts

@@ -1,47 +0,0 @@
-//#region packages/tools/src/web-fetch.d.ts
-/**
- * aikit_web_fetch — Fetch a web page and convert to LLM-friendly format.
- *
- * Supports multiple output modes: markdown (default), raw HTML,
- * extracted links, or heading outline. Strips scripts, styles,
- * and non-content elements for compact, token-efficient output.
- */
-type WebFetchMode = 'markdown' | 'raw' | 'links' | 'outline';
-interface WebFetchOptions {
-  /** URL to fetch */
-  url: string;
-  /** Output mode */
-  mode?: WebFetchMode;
-  /** CSS selector to extract specific element (default: auto-detect main content) */
-  selector?: string;
-  /** Max characters in output — smart truncation at paragraph boundaries */
-  maxLength?: number;
-  /** Include page metadata header (title, description, URL) */
-  includeMetadata?: boolean;
-  /** Append extracted links list at the end */
-  includeLinks?: boolean;
-  /** Include image alt texts inline */
-  includeImages?: boolean;
-  /** Request timeout in milliseconds */
-  timeout?: number;
-}
-interface WebFetchResult {
-  /** The converted content */
-  content: string;
-  /** Page title */
-  title: string;
-  /** Page description (from meta) */
-  description: string;
-  /** Final URL after redirects */
-  url: string;
-  /** Content length before truncation */
-  originalLength: number;
-  /** Whether content was truncated */
-  truncated: boolean;
-}
-/**
- * Fetch a web page and convert to an LLM-friendly format.
- */
-declare function webFetch(options: WebFetchOptions): Promise<WebFetchResult>;
-//#endregion
-export { WebFetchMode, WebFetchOptions, WebFetchResult, webFetch };

package/packages/tools/dist/web-fetch.js

@@ -1,8 +0,0 @@
-import{paragraphTruncate as e}from"./truncation.js";import t from"turndown";const n=`script,style,noscript,iframe,svg,nav,footer,header,aside,form,button,input,select,textarea,[role="navigation"],[role="banner"],[role="contentinfo"],[aria-hidden="true"],.sidebar,.nav,.menu,.footer,.header,.ad,.advertisement,.cookie-banner,.popup,.modal`.split(`,`),r=[`article`,`[role="main"]`,`main`,`.post-content`,`.article-content`,`.entry-content`,`.content`,`#content`,`.prose`,`.markdown-body`,`.documentation`,`.doc-content`];async function i(e){let{url:t,mode:i=`markdown`,selector:d,maxLength:f=15e3,includeMetadata:p=!0,includeLinks:m=!1,includeImages:h=!1,timeout:g=6e4}=e,_=new URL(t);if(_.protocol!==`http:`&&_.protocol!==`https:`)throw Error(`Unsupported protocol: ${_.protocol} — only http/https allowed`);let v=new AbortController,y=setTimeout(()=>v.abort(),g),b,x,S=``,C=!1,w=``;try{if(b=await fetch(t,{signal:v.signal,headers:{"User-Agent":`aikit-web-fetch/1.0 (LLM context tool)`,Accept:`text/html,application/xhtml+xml,text/plain`},redirect:`follow`}),!b.ok)throw Error(`HTTP ${b.status}: ${b.statusText}`);x=await b.text(),S=b.headers.get(`content-type`)??``,C=/text\/html|application\/xhtml\+xml/i.test(S),w=b.url}catch(e){throw e instanceof DOMException&&e.name===`AbortError`?Error(`Request to ${t} timed out after ${g}ms. Try increasing the timeout parameter.`):e}finally{clearTimeout(y)}if(!C){let e=x,t=w.split(`/`).pop()??``;p&&(e=c(t,``,w)+e);let n=e.length,r=n>f;return r&&(e=u(e,f)),{content:e,title:t,description:``,url:w,originalLength:n,truncated:r}}let{parseHTML:T}=await import(`linkedom`),{document:E}=T(x),D=E.querySelector(`title`)?.textContent?.trim()??E.querySelector(`meta[property="og:title"]`)?.getAttribute(`content`)?.trim()??``,O=E.querySelector(`meta[name="description"]`)?.getAttribute(`content`)?.trim()??E.querySelector(`meta[property="og:description"]`)?.getAttribute(`content`)?.trim()??``;for(let e of n)for(let t of E.querySelectorAll(e))t.remove();if(!h)for(let e of E.querySelectorAll(`img`))e.remove();let k=null;if(d){if(k=E.querySelector(d),!k)throw Error(`Selector "${d}" matched no elements on the page`)}else{for(let e of r)if(k=E.querySelector(e),k)break;k||=E.querySelector(`body`)}if(!k)return{content:`(empty page — no content found)`,title:D,description:O,url:w,originalLength:0,truncated:!1};let A=k.innerHTML,j=[];if(m||i===`links`)for(let e of k.querySelectorAll(`a[href]`)){let t=e.textContent?.trim(),n=e.getAttribute(`href`);t&&n&&!n.startsWith(`#`)&&!n.startsWith(`javascript:`)&&j.push({text:t,href:l(n,w)})}let M;switch(i){case`raw`:M=A;break;case`links`:M=s(j);break;case`outline`:M=o(k);break;default:M=a(A,h);break}p&&i!==`links`&&(M=c(D,O,w)+M),m&&i!==`links`&&j.length>0&&(M+=`\n\n---\n\n## Links\n\n${s(j)}`);let N=M.length,P=N>f;return P&&(M=u(M,f)),{content:M,title:D,description:O,url:w,originalLength:N,truncated:P}}function a(e,n){let r=new t({headingStyle:`atx`,codeBlockStyle:`fenced`,bulletListMarker:`-`});r.addRule(`emptyLinks`,{filter:e=>e.nodeName===`A`&&!e.textContent?.trim(),replacement:()=>``}),n||r.addRule(`removeImages`,{filter:`img`,replacement:()=>``});let i=r.turndown(e);return i=i.replace(/\n{3,}/g,`
-
-`).trim(),i}function o(e){let t=e.querySelectorAll(`h1, h2, h3, h4, h5, h6`),n=[];for(let e of t){let t=Number.parseInt(e.tagName.slice(1),10),r=`  `.repeat(t-1),i=e.textContent?.trim()??``;i&&n.push(`${r}- ${i}`)}return n.length>0?n.join(`
-`):`(no headings found)`}function s(e){if(e.length===0)return`(no links found)`;let t=new Set,n=[];for(let r of e)t.has(r.href)||(t.add(r.href),n.push(r));return n.map(e=>`- [${e.text}](${e.href})`).join(`
-`)}function c(e,t,n){let r=[`---`];return e&&r.push(`**${e}**`),r.push(`URL: ${n}`),t&&r.push(`> ${t}`),r.push(`---
-
-`),r.join(`
-`)}function l(e,t){try{return new URL(e,t).href}catch{return e}}const u=e;export{i as webFetch};

package/packages/tools/dist/web-search.d.ts

@@ -1,25 +0,0 @@
-//#region packages/tools/src/web-search.d.ts
-/**
- * aikit_web_search — Search the web and return structured results.
- *
- * Uses DuckDuckGo HTML search (no API key required).
- */
-interface WebSearchOptions {
-  query: string;
-  limit?: number;
-  site?: string;
-}
-interface WebSearchResultItem {
-  title: string;
-  url: string;
-  snippet: string;
-}
-interface WebSearchResult {
-  results: WebSearchResultItem[];
-  query: string;
-}
-declare function webSearch(options: WebSearchOptions): Promise<WebSearchResult>;
-/** Parse search results from DuckDuckGo HTML. Exported for testing. */
-declare function parseSearchResults(html: string, query: string, limit: number): WebSearchResult;
-//#endregion
-export { WebSearchOptions, WebSearchResult, WebSearchResultItem, parseSearchResults, webSearch };

package/packages/tools/dist/web-search.js

@@ -1 +0,0 @@
-async function e(e){let{query:n,limit:r=5,site:i}=e;if(!n.trim())throw Error(`Search query cannot be empty`);let a=i?`${n} site:${i}`:n,o=new AbortController,s=setTimeout(()=>o.abort(),15e3),c;try{c=await fetch(`https://html.duckduckgo.com/html/`,{method:`POST`,headers:{"Content-Type":`application/x-www-form-urlencoded`,"User-Agent":`aikit-web-search/1.0 (LLM developer tool)`},body:`q=${encodeURIComponent(a)}`,signal:o.signal})}finally{clearTimeout(s)}if(!c.ok)throw Error(`Search failed: HTTP ${c.status}`);return t(await c.text(),a,r)}function t(e,t,r){let i=[],a=/<a[^>]+class="result__a"[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>[\s\S]*?<a[^>]+class="result__snippet"[^>]*>([\s\S]*?)<\/a>/gi,o=a.exec(e);for(;o!==null&&i.length<r;){let t=o[1],r=n(o[2]).trim(),s=n(o[3]).trim();if(t.includes(`uddg=`)){let e=t.match(/uddg=([^&]+)/)?.[1];e&&(t=decodeURIComponent(e))}r&&t?.startsWith(`http`)&&i.push({title:r,url:t,snippet:s}),o=a.exec(e)}return{results:i,query:t}}function n(e){return e.replace(/<[^>]+>/g,``).replace(/&amp;/g,`&`).replace(/&lt;/g,`<`).replace(/&gt;/g,`>`).replace(/&quot;/g,`"`).replace(/&#x27;/g,`'`)}export{t as parseSearchResults,e as webSearch};

package/packages/tools/dist/workset.d.ts

@@ -1,47 +0,0 @@
-//#region packages/tools/src/workset.d.ts
-/**
- * aikit_workset — Named file set management.
- *
- * Persistent worksets stored in .aikit-state/worksets.json.
- * Use cases: "remember this set of files I'm working on",
- * "load my previous context", "share file sets between sessions".
- */
-interface Workset {
-  name: string;
-  files: string[];
-  created: string;
-  updated: string;
-  description?: string;
-}
-interface WorksetStore {
-  worksets: Record<string, Workset>;
-}
-/**
- * Create or update a workset.
- */
-declare function saveWorkset(name: string, files: string[], options?: {
-  description?: string;
-  cwd?: string;
-}): Workset;
-/**
- * Get a workset by name.
- */
-declare function getWorkset(name: string, cwd?: string): Workset | null;
-/**
- * List all worksets.
- */
-declare function listWorksets(cwd?: string): Workset[];
-/**
- * Delete a workset.
- */
-declare function deleteWorkset(name: string, cwd?: string): boolean;
-/**
- * Add files to an existing workset (creates if not exists).
- */
-declare function addToWorkset(name: string, files: string[], cwd?: string): Workset;
-/**
- * Remove files from a workset.
- */
-declare function removeFromWorkset(name: string, files: string[], cwd?: string): Workset | null;
-//#endregion
-export { Workset, WorksetStore, addToWorkset, deleteWorkset, getWorkset, listWorksets, removeFromWorkset, saveWorkset };

package/packages/tools/dist/workset.js

@@ -1 +0,0 @@
-import{dirname as e,resolve as t}from"node:path";import{existsSync as n,mkdirSync as r,readFileSync as i,renameSync as a,writeFileSync as o}from"node:fs";import{resolveStateDir as s}from"../../core/dist/index.js";function c(e){return t(s(e??process.cwd()),`worksets.json`)}function l(e){let t=c(e);if(!n(t))return{worksets:{}};try{let e=i(t,`utf-8`);return JSON.parse(e)}catch(e){return e?.code===`ENOENT`||console.warn(`Corrupt state file ${t}: ${e instanceof Error?e.message:String(e)}`),{worksets:{}}}}function u(t,i){let s=c(i),l=e(s);n(l)||r(l,{recursive:!0});let u=`${s}.tmp`;o(u,`${JSON.stringify(t,null,2)}\n`,`utf-8`),a(u,s)}function d(e,t,n){let r=l(n?.cwd),i=new Date().toISOString(),a=r.worksets[e],o={name:e,files:t,created:a?.created??i,updated:i,description:n?.description??a?.description};return r.worksets[e]=o,u(r,n?.cwd),o}function f(e,t){return l(t).worksets[e]??null}function p(e){let t=l(e);return Object.values(t.worksets).sort((e,t)=>new Date(t.updated).getTime()-new Date(e.updated).getTime())}function m(e,t){let n=l(t);return n.worksets[e]?(delete n.worksets[e],u(n,t),!0):!1}function h(e,t,n){let r=l(n).worksets[e]?.files??[];return d(e,[...new Set([...r,...t])],{cwd:n})}function g(e,t,n){let r=l(n).worksets[e];if(!r)return null;let i=new Set(t);return d(e,r.files.filter(e=>!i.has(e)),{cwd:n})}export{h as addToWorkset,m as deleteWorkset,f as getWorkset,p as listWorksets,g as removeFromWorkset,d as saveWorkset};

package/scaffold/__tests__/copilot-inline-shared-protocols.test.mjs

@@ -1,39 +0,0 @@
-import { describe, expect, it } from 'vitest';
-
-import { generateCopilot } from '../adapters/copilot.mjs';
-import { PROTOCOLS } from '../definitions/protocols.mjs';
-
-function getGeneratedFile(files, path) {
-  const file = files.find((entry) => entry.path === path);
-  expect(file, `Missing generated file: ${path}`).toBeTruthy();
-  return file;
-}
-
-describe('generateCopilot shared protocol inlining', () => {
-  it('inlines shared protocol content into generated agent files while still emitting shared files', () => {
-    const files = generateCopilot();
-
-    const implementer = getGeneratedFile(files, 'agents/Implementer.agent.md');
-    const security = getGeneratedFile(files, 'agents/Security.agent.md');
-    const documenter = getGeneratedFile(files, 'agents/Documenter.agent.md');
-    const researcher = getGeneratedFile(files, 'agents/Researcher-Alpha.agent.md');
-    const orchestrator = getGeneratedFile(files, 'agents/Orchestrator.agent.md');
-    const sharedProtocol = getGeneratedFile(files, 'agents/_shared/code-agent-base.md');
-
-    expect(implementer.content).toContain(PROTOCOLS['code-agent-base']);
-    expect(security.content).toContain(PROTOCOLS['code-agent-base']);
-    expect(documenter.content).toContain(PROTOCOLS['code-agent-base']);
-    expect(researcher.content).toContain(PROTOCOLS['researcher-base']);
-    expect(orchestrator.content).toContain(PROTOCOLS['decision-protocol']);
-    expect(orchestrator.content).toContain(PROTOCOLS['forge-protocol']);
-
-    expect(implementer.content).not.toContain('Read _shared/code-agent-base.md NOW');
-    expect(security.content).not.toContain('Read _shared/code-agent-base.md NOW');
-    expect(documenter.content).not.toContain('Read _shared/code-agent-base.md NOW');
-    expect(researcher.content).not.toContain('Read .github/agents/_shared/');
-    expect(orchestrator.content).not.toContain('_shared/decision-protocol.md');
-    expect(orchestrator.content).not.toContain('_shared/forge-protocol.md');
-
-    expect(sharedProtocol.content).toBe(PROTOCOLS['code-agent-base']);
-  });
-});