@crewx/sdk 0.8.0-rc.80 → 0.8.0-rc.83

package/dist/esm/plugins/index.js

@@ -0,0 +1,52 @@
+import {existsSync,mkdirSync,writeFileSync,appendFileSync}from'fs';import*as x from'path';import {join,dirname,basename}from'path';import {homedir}from'os';import $ from'better-sqlite3';import {createHash}from'crypto';var d=class{detach(s){}};function S(i){let s=t=>String(t).padStart(2,"0");return `${i.getFullYear()}${s(i.getMonth()+1)}${s(i.getDate())}T${s(i.getHours())}${s(i.getMinutes())}${s(i.getSeconds())}`}var h=class extends d{name="file-logger";unsubs=[];logFiles=new Map;logsDir;version;constructor(s){super(),this.logsDir=join(s?.workspaceRoot??process.cwd(),".crewx","logs"),this.version=s?.version??"unknown";}attach(s){this.unsubs.push(s.on("task:start",t=>{try{existsSync(this.logsDir)||mkdirSync(this.logsDir,{recursive:!0});let r=S(t.timestamp),a=join(this.logsDir,`${r}_${t.traceId}.log`);this.logFiles.set(t.traceId,a);let n=`=== TASK LOG: ${t.traceId} ===
+CrewX Version: ${this.version}
+Mode: ${t.mode}
+Agent: ${t.agentRef}
+Started: ${t.timestamp.toLocaleString()}
+Message: ${t.message}
+
+`;writeFileSync(a,n,{encoding:"utf8",mode:384});}catch{}}),s.on("task:output",t=>{try{let r=this.logFiles.get(t.traceId);if(!r)return;let a=new Date().toISOString();appendFileSync(r,`[${a}] STDOUT: ${t.output}
+`,"utf8");}catch{}}),s.on("task:end",t=>{try{let r=this.logFiles.get(t.traceId);if(!r)return;let a=new Date().toLocaleString(),n=t.error?`failed: ${t.error.message}`:"completed successfully",p=`[${a}] INFO: Task ${n} in ${t.durationMs}ms
+[${a}] INFO: Process closed with exit code: ${t.error?1:0}
+`;appendFileSync(r,p,"utf8"),this.logFiles.delete(t.traceId);}catch{}}));}detach(s){this.unsubs.forEach(t=>t()),this.unsubs=[],this.logFiles.clear();}};function P(i){let s=x.resolve(i);return process.platform==="win32"&&(s=s.replace(/\\/g,"/"),s=s.replace(/^([A-Z]):/,(t,r)=>`${r.toLowerCase()}:`)),s.length>1&&!/^[a-zA-Z]:\/$/.test(s)&&(s=s.replace(/\/+$/,"")),s}function C(i){let s=P(i);return createHash("sha256").update(s).digest("hex")}var T=class extends d{name="sqlite-tracing";db=null;unsubs=[];dbPath;version;constructor(s){super(),this.dbPath=join(s?.dbRoot??homedir(),".crewx","crewx.db"),this.version=s?.version??"unknown";}attach(s){let t=dirname(this.dbPath);existsSync(t)||mkdirSync(t,{recursive:true}),this.db=new $(this.dbPath);let r=this.db.prepare("PRAGMA table_info(tasks)").all(),a=e=>r.some(o=>o.name===e);a("parent_task_id")||this.db.exec("ALTER TABLE tasks ADD COLUMN parent_task_id TEXT"),a("caller_agent_id")||this.db.exec("ALTER TABLE tasks ADD COLUMN caller_agent_id TEXT"),a("trace_id")||this.db.exec("ALTER TABLE tasks ADD COLUMN trace_id TEXT");let n=process.cwd(),p=existsSync(join(n,"crewx.yaml"))||existsSync(join(n,"crewx.yml")),w=p?C(n):null,g=p?basename(n):null,f=process.argv.join(" ");this.unsubs.push(s.on("task:start",e=>{try{let o=process.env.CREWX_CALLER_AGENT_ID||null,u=process.env.CREWX_PARENT_TASK_ID||null,v=process.env.CREWX_TRACE_ID||e.traceId,I=e.metadata?JSON.stringify(e.metadata):JSON.stringify({provider:e.provider??"cli/claude"});this.db.prepare(`INSERT OR IGNORE INTO tasks
+               (id, agent_id, prompt, mode, status, pid, started_at,
+                crewx_version, platform,
+                model, rendered_prompt, command, coding_agent_command,
+                workspace_id, workspace_name,
+                caller_agent_id, parent_task_id, trace_id, metadata, thread_id)
+             VALUES (?, ?, ?, ?, 'running', ?, ?,
+                     ?, ?,
+                     ?, ?, ?, ?,
+                     ?, ?,
+                     ?, ?, ?, ?, ?)`).run(e.traceId,e.agentRef.replace(/^@/,""),e.message,e.mode,e.pid??null,e.timestamp.toISOString(),this.version,e.platform??"cli",e.model??null,e.renderedPrompt??null,f,e.codingAgentCommand??null,e.workspaceId??w,e.workspaceName??g,o,u,v,I,e.threadId??null);}catch{}}),s.on("task:output",e=>{try{let o=this.db.prepare("SELECT logs FROM tasks WHERE id=?").get(e.traceId),u=o?.logs?JSON.parse(o.logs):[];u.push({timestamp:e.timestamp.toISOString(),level:e.level??"stdout",message:e.output}),this.db.prepare("UPDATE tasks SET logs=? WHERE id=?").run(JSON.stringify(u),e.traceId);}catch{}}),s.on("task:end",e=>{try{let o=e.error?"failed":"success";this.db.prepare(`UPDATE tasks
+             SET status=?, result=?, error=?,
+                 completed_at=?, duration_ms=?,
+                 exit_code=?,
+                 input_tokens=?, output_tokens=?, cached_input_tokens=?,
+                 cost_usd=?,
+                 model=COALESCE(?, model)
+             WHERE id=?`).run(o,e.result??null,e.error?JSON.stringify(e.error):null,e.timestamp.toISOString(),e.durationMs,e.exitCode??null,e.inputTokens??0,e.outputTokens??0,e.cachedInputTokens??0,e.costUsd??0,e.model??null,e.traceId);}catch{}}));}detach(s){this.unsubs.forEach(t=>t()),this.unsubs=[],this.db?.close(),this.db=null;}};var X=`
+  CREATE TABLE IF NOT EXISTS threads (
+    id TEXT PRIMARY KEY,
+    workspace_id TEXT,
+    platform TEXT NOT NULL DEFAULT 'cli',
+    title TEXT,
+    first_message TEXT,
+    last_message TEXT,
+    message_count INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL,
+    updated_at TEXT NOT NULL,
+    metadata TEXT
+  )
+`,q=["id","thread_id","prompt","result","started_at","trace_id","status","parent_task_id","agent_id"];function j(i){return i.replace(/<conversation_history[^>]*>[\s\S]*?<\/conversation_history>/g,"").split(`
+`).filter(a=>!(a.startsWith("Loaded ")&&a.includes("layouts from")||a.includes("[dotenv@")||a.includes("[Nest]")&&a.includes("DEBUG")||a.startsWith("Registered custom layout:")||a.startsWith("Updated custom layout:"))).join(`
+`).trim()}function B(i){if(!i)return "";let s=i;try{let t=JSON.parse(s);Array.isArray(t)?s=t.filter(r=>r?.type==="text"&&r?.text).map(r=>r.text).join(`
+`):t&&typeof t=="object"&&t.result!==void 0&&(s=t.result||"");}catch{s=j(s);}return s}var m=class{db;constructor(s){let t=s??join(homedir(),".crewx","crewx.db");this.db=new $(t),this.init();}init(){this.db.pragma("journal_mode = WAL"),this.db.exec(X);}async ensureThread(s,t,r){let a=this.db.prepare("SELECT platform FROM threads WHERE id = ?").get(s);if(a){if(a.platform!==t)throw new Error(`Thread '${s}' already exists with platform '${a.platform}' \u2014 cannot change to '${t}' (platform is immutable)`);r&&this.db.prepare("UPDATE threads SET workspace_id = COALESCE(workspace_id, ?) WHERE id = ?").run(r,s);return}let n=new Date().toISOString();this.db.prepare("INSERT INTO threads (id, platform, workspace_id, message_count, created_at, updated_at) VALUES (?, ?, ?, 0, ?, ?)").run(s,t,r??null,n,n);}async fetchHistory(s,t){let r=t?.limit??100,a=["thread_id = ?","(parent_task_id IS NULL OR parent_task_id = '')","(status IN ('done', 'completed', 'success') OR status IS NULL)"],n=[s];t?.currentTraceId&&(a.push("trace_id != ?"),n.push(t.currentTraceId));let p=a.join(" AND "),g=`SELECT ${q.join(", ")} FROM tasks WHERE ${p} ORDER BY started_at ASC LIMIT ?`;n.push(r);let f=this.db.prepare(g).all(...n),e=this.db.prepare("SELECT platform, title, first_message, last_message, message_count, updated_at FROM threads WHERE id = ?").get(s),o=e?.platform??"cli",u=this.rowsToMessages(f);return {threadId:s,platform:o,messages:u,metadata:{title:e?.title??void 0,firstMessage:e?.first_message??void 0,lastMessage:e?.last_message??void 0,messageCount:e?.message_count??0,updatedAt:e?.updated_at?new Date(e.updated_at).getTime():void 0}}}async saveUserMessage(s,t,r,a){let n=new Date().toISOString();this.db.prepare(`UPDATE threads
+       SET first_message = COALESCE(first_message, ?),
+           last_message = ?,
+           message_count = message_count + 1,
+           updated_at = ?
+       WHERE id = ?`).run(t,t,n,s);}async saveAssistantMessage(s,t,r,a){let n=new Date().toISOString();this.db.prepare(`UPDATE threads
+       SET last_message = ?,
+           updated_at = ?
+       WHERE id = ?`).run(t,n,s);}close(){this.db.close();}rowsToMessages(s){let t=[];for(let r of s){r.prompt&&t.push({id:`${r.id}-user`,text:r.prompt,isAssistant:false,timestamp:new Date(r.started_at).getTime()});let a=B(r.result);a&&t.push({id:`${r.id}-assistant`,text:a,isAssistant:true,timestamp:new Date(r.started_at).getTime()});}return t}};var y=class extends d{name="conversation";_provider;unsubStart=null;unsubEnd=null;constructor(s){super(),this._provider=new m(s?.dbPath);}get conversationProvider(){return this._provider}attach(s){this.unsubStart=s.on("task:start",async t=>{if(!t.threadId)return;let r=t.platform??"cli";try{await this._provider.ensureThread(t.threadId,r,t.workspaceId),await this._provider.saveUserMessage(t.threadId,t.message??"");}catch{}}),this.unsubEnd=s.on("task:end",async t=>{if(!t.result)return;let r=t.metadata?.threadId;if(!r)return;let a=t.agentRef?.replace(/^@/,"")??"";try{await this._provider.saveAssistantMessage(r,t.result,a);}catch{}});}detach(s){this.unsubStart?.(),this.unsubStart=null,this.unsubEnd?.(),this.unsubEnd=null,this._provider.close?.();}};export{y as ConversationPlugin,h as FileLoggerPlugin,T as SqliteTracingPlugin};

package/dist/esm/testing/index.js

@@ -0,0 +1 @@
+function y(){let e=[];return {events:e,async log(t,r){e.push({event:t,payload:r});}}}function R(){let e={debug:[],info:[],warn:[],error:[]};return {entries:e,debug(t,r){e.debug.push({msg:t,meta:r});},info(t,r){e.info.push({msg:t,meta:r});},warn(t,r){e.warn.push({msg:t,meta:r});},error(t,r){e.error.push({msg:t,meta:r});}}}function E(){let e=200,t,r,n={},o={status(s){return e=s,o},set(s,i){return n[s]=i,o},send(s){return r=s,o},json(s){return t=s,o},end(){return o},getStatusCode:()=>e,getJsonBody:()=>t,getSentBody:()=>r,getHeaders:()=>({...n})};return o}function k(){let e=[];return {routes:e,registerRoute(r,n,o){e.push({path:r,handler:n,opts:o});},async simulate(r,n,o=Buffer.alloc(0),s={},i={},p={}){let d=e.find(m=>m.path===n);if(!d)return {status:404,body:{error:"Not found"},headers:{}};let f={method:r,url:n,headers:s,body:o,params:i,query:p},u=E();return await d.handler(f,u),{status:u.getStatusCode(),body:u.getJsonBody()??u.getSentBody(),headers:u.getHeaders()}}}}function b(e){let t=new Map,r=n=>n.startsWith(`${e}::`)?n:`${e}::${n}`;return {async get(n){let o=t.get(r(n));return o?o.value:void 0},async set(n,o){t.set(r(n),{value:o});},async delete(n){return t.delete(r(n))},async list(n){let o=n?r(n):`${e}::`,s=[];for(let i of t.keys())i.startsWith(o)&&s.push(i.slice(e.length+2));return s}}}function l(e){return b(e)}function M(){let e=new Map;return {blobs:e,async put(t,r,n){return e.set(t,{data:r,contentType:n}),t},async get(t){let r=e.get(t);return r?r.data:void 0},async delete(t){return e.delete(t)}}}function P(e){let t=e.instanceId??"mock-instance",r=y(),n=R(),o=k(),s=l(t),i=M(),p=[],d=[],f=[],u={run:async()=>({output:""}),...e.agentRunner},m=new AbortController,x=async a=>(p.push(a),{accepted:true}),S=async a=>(d.push(a),{accepted:true}),w=async(a,h)=>{f.push({messageId:a,patch:h});},A=async a=>({userId:a,displayName:a}),v=async()=>{},C=async()=>({messageId:"mock-proactive",sentAt:Date.now()});return {instanceId:t,installationId:e.installationId,config:e.config,capabilities:new Set(e.capabilities??[]),log:n,agentRunner:u,db:s,storage:i,audit:r,abortSignal:e.abortSignal??m.signal,httpRouter:o,router:o,inbound:x,emitEvent:S,updateMessage:w,resolveUser:A,respondSync:v,proactive:C,inboundCalls:p,emittedEvents:d,sentMessages:f}}export{y as createMockAudit,P as createMockContext,R as createMockLogger,k as createMockRouter,M as createMockStorage,l as createMockStore};

package/dist/esm/tools/node/index.js

@@ -0,0 +1,36 @@
+import p from'path';import u from'fs/promises';import {exec}from'child_process';import {promisify}from'util';var F=promisify(exec),g=new Set(["node_modules",".git","dist","build",".next"]);async function $(r,s,o=5,t=0){if(t>=o)return [`${p.relative(s,r)}/ (max depth reached)`];let e=[],n;try{n=await u.readdir(r,{withFileTypes:!0});}catch{return [`${p.relative(s,r)}/ (permission denied)`]}for(let c of n){let i=p.join(r,c.name),a=p.relative(s,i);if(c.isDirectory()){e.push(`${a}/`);let l=await $(i,s,o,t+1);e.push(...l);}else {let l=await u.stat(i);e.push(`${a} (${l.size} bytes)`);}}return e}async function x(r,s){let{currentDepth:o,maxDepth:t}=s,e="  ".repeat(o),n;try{n=await u.readdir(r,{withFileTypes:!0});}catch(i){let a=i.code??"unknown";return [`${e}(error: ${a})`]}n.sort((i,a)=>i.isDirectory()&&!a.isDirectory()?-1:!i.isDirectory()&&a.isDirectory()?1:i.name.localeCompare(a.name));let c=[];for(let i of n){let a=p.join(r,i.name);if(i.isDirectory())if(c.push(`${e}[DIR] ${i.name}/`),o<t){let l=await x(a,{currentDepth:o+1,maxDepth:t});c.push(...l);}else c.push(`${"  ".repeat(o+1)}(max depth reached)`);else try{let l=await u.stat(a);c.push(`${e}[FILE] ${i.name} (${l.size} bytes)`);}catch{c.push(`${e}[FILE] ${i.name} (stat error)`);}}return c}async function h(r,s,o){try{let e=(await u.readFile(r,"utf-8")).split(`
+`),n=p.relative(o,r);return e.flatMap((c,i)=>s.test(c)?[`${n}:${i+1}: ${c}`]:[])}catch{return []}}async function b(r,s,o,t=10,e=0){if(e>=t)return [];let n=[],c;try{c=await u.readdir(r,{withFileTypes:!0});}catch{return []}for(let i of c){let a=p.join(r,i.name);if(i.isDirectory()){if(!g.has(i.name)){let l=await b(a,s,o,t,e+1);n.push(...l);}}else {let l=await h(a,s,o);n.push(...l);}}return n}function j(r,s,o){let t=o?r:r.toLowerCase(),n=(o?s:s.toLowerCase()).replace(/[.+^${}()|[\]\\]/g,"\\$&").replace(/\*/g,".*").replace(/\?/g,".");return new RegExp(`^${n}$`).test(t)}async function T(r,s,o,t,e,n=0){if(t.length>=e||n>10)return;let c;try{c=await u.readdir(r,{withFileTypes:!0});}catch{return}for(let i of c){if(t.length>=e)break;let a=p.join(r,i.name);i.isDirectory()?g.has(i.name)||await T(a,s,o,t,e,n+1):j(i.name,s,o)&&t.push(a);}}function L(r,s){let o=r.replace(/\\/g,"/"),e=s.replace(/\\/g,"/").replace(/[.+^${}()|[\]\\]/g,"\\$&").replace(/\*\*\//g,"\xA7\xA7\xA7").replace(/\*\*/g,"\xA7\xA7\xA7").replace(/\*/g,"[^/]*").replace(/\?/g,"[^/]").replace(/§§§/g,".*");return new RegExp(`^${e}$`).test(o)}async function v(r,s,o,t,e,n=0){if(t.length>=e||n>15)return;let c;try{c=await u.readdir(r,{withFileTypes:!0});}catch{return}for(let i of c){if(t.length>=e)break;let a=p.join(r,i.name);if(i.isDirectory())g.has(i.name)||await v(a,s,o,t,e,n+1);else {let l=p.relative(o,a).replace(/\\/g,"/");L(l,s)&&t.push(a);}}}var P={description:"Reads and returns the content of a specified file. Use offset/limit to paginate large text files.",parameters:{type:"object",properties:{file_path:{type:"string",description:"Path to the file to read."},offset:{type:"integer",description:"Optional 0-based line number to start reading from."},limit:{type:"integer",description:"Optional maximum number of lines to read."}},required:["file_path"]},execute:async r=>{let s=r.file_path,o=r.offset,t=r.limit;if(!s.trim())throw new Error("The 'file_path' parameter must be non-empty.");let e=p.resolve(s),n=await u.readFile(e,"utf-8");if(o!==void 0||t!==void 0){let c=n.split(`
+`),i=o??0,a=t!==void 0?i+t:c.length,l=c.slice(i,a),d=a<c.length,f=l.join(`
+`);return d?`IMPORTANT: Content truncated. Showing lines ${i}-${a-1} of ${c.length}.
+
+${f}`:f}return n}},I={description:"Creates a new file or overwrites an existing file with the provided content.",parameters:{type:"object",properties:{file_path:{type:"string",description:"Path to the file to create or overwrite."},content:{type:"string",description:"The content to write to the file."}},required:["file_path","content"]},execute:async r=>{let s=r.file_path,o=r.content;if(!s.trim())throw new Error("The 'file_path' parameter must be non-empty.");let t=p.resolve(s);await u.mkdir(p.dirname(t),{recursive:true});let e=false;try{await u.access(t),e=!0;}catch{}await u.writeFile(t,o,"utf-8");let n=Buffer.byteLength(o,"utf-8");return `${e?"Updated":"Created"} file: ${s} (${n} bytes)`}},B={description:"Replaces a range of lines in a file with new text. Line numbers are 1-based.",parameters:{type:"object",properties:{file_path:{type:"string",description:"Path to the file to modify."},start_line:{type:"integer",description:"Starting line number (1-based, inclusive)."},end_line:{type:"integer",description:"Ending line number (1-based, inclusive)."},new_text:{type:"string",description:"New text to insert in place of the specified lines."}},required:["file_path","start_line","end_line","new_text"]},execute:async r=>{let s=r.file_path,o=r.start_line,t=r.end_line,e=r.new_text;if(!s.trim())throw new Error("The 'file_path' parameter must be non-empty.");if(o>t)throw new Error(`start_line (${o}) must be <= end_line (${t}).`);let n=p.resolve(s),i=(await u.readFile(n,"utf-8")).split(`
+`);if(o<1||o>i.length)throw new Error(`start_line (${o}) out of range. File has ${i.length} lines.`);if(t>i.length)throw new Error(`end_line (${t}) out of range. File has ${i.length} lines.`);let a=e.split(`
+`);return i.splice(o-1,t-o+1,...a),await u.writeFile(n,i.join(`
+`),"utf-8"),`Successfully replaced lines ${o}-${t} in ${s}`}},k={description:"Lists contents of a directory. Shows file sizes and marks directories with trailing slashes.",parameters:{type:"object",properties:{path:{type:"string",description:"Directory path to list (default: current directory)."},recursive:{type:"boolean",description:"List contents recursively (default: false)."}}},execute:async r=>{let s=r.path??".",o=r.recursive??false,t=p.resolve(s);if(!(await u.stat(t)).isDirectory())throw new Error(`Path is not a directory: ${s}`);let n=`Directory listing: ${s}
+
+`;if(o){let c=await $(t,t);n+=c.join(`
+`);}else {let c=await u.readdir(t,{withFileTypes:true}),i=[];for(let a of c)if(a.isDirectory())i.push(`${a.name}/`);else {let l=await u.stat(p.join(t,a.name));i.push(`${a.name} (${l.size} bytes)`);}n+=i.join(`
+`);}return n||"Directory is empty"}},C={description:"Displays a directory tree with [DIR]/[FILE] labels up to max_depth levels.",parameters:{type:"object",properties:{path:{type:"string",description:"Directory to inspect (default: current directory)."},max_depth:{type:"integer",description:"Maximum depth to traverse (default: 3)."}}},execute:async r=>{let s=r.path??".",o=r.max_depth??3,t=p.resolve(s);if(!(await u.stat(t)).isDirectory())throw new Error(`Path is not a directory: ${s}`);let n=p.relative(process.cwd(),t),c=n===""?".":n,i=[`Tree for ${c} (max depth: ${o})`,`[DIR] ${c}/`],a=await x(t,{currentDepth:1,maxDepth:o});return i.push(...a),i.join(`
+`)}},O={description:"Searches for a regex pattern in files. Returns matching lines with file paths and line numbers.",parameters:{type:"object",properties:{pattern:{type:"string",description:"Regular expression pattern to search for."},path:{type:"string",description:"File or directory path to search in (default: current directory)."},recursive:{type:"boolean",description:"Search recursively through subdirectories (default: true)."}},required:["pattern"]},execute:async r=>{let s=r.pattern,o=r.path??".",t=r.recursive??true;if(!s.trim())throw new Error("The 'pattern' parameter must be non-empty.");let e;try{e=new RegExp(s);}catch(m){throw new Error(`Invalid regular expression: ${m.message}`)}let n=p.resolve(o),c=await u.stat(n),i=c.isDirectory()?n:p.dirname(n),a=[];if(c.isDirectory())if(t)a=await b(n,e,i);else {let m=await u.readdir(n,{withFileTypes:true});for(let w of m)if(!w.isDirectory()){let _=await h(p.join(n,w.name),e,i);a.push(..._);}}else a=await h(n,e,i);if(a.length===0)return `No matches found for pattern: ${s}`;let l=100,d=a.slice(0,l),f=`Found ${a.length} match(es) for pattern: ${s}
+
+${d.join(`
+`)}`;return a.length>l&&(f+=`
+
+... and ${a.length-l} more (output truncated)`),f}},q={description:"Searches for files by filename pattern. Supports * and ? wildcards.",parameters:{type:"object",properties:{pattern:{type:"string",description:"Filename pattern. Supports * and ? wildcards."},dir_path:{type:"string",description:"Directory to search in (default: current directory)."},case_sensitive:{type:"boolean",description:"Case-sensitive matching (default: false)."},max_results:{type:"integer",description:"Maximum results to return (default: 50)."}},required:["pattern"]},execute:async r=>{let s=r.pattern,o=r.dir_path??".",t=r.case_sensitive??false,e=r.max_results??50,n=p.resolve(o),c=[];if(await T(n,s,t,c,e),c.length===0)return `No files found matching pattern: ${s}
+Searched in: ${n}`;let i=c.map((l,d)=>`  ${d+1}. ${p.relative(process.cwd(),l)}`),a=c.length>=e?`
+(Limited to ${e} results)`:"";return `Found ${c.length} file(s) matching "${s}":
+${i.join(`
+`)}${a}`}},A={description:'Finds files matching glob patterns (e.g., "**/*.ts", "src/**/*.yaml"). Returns file paths.',parameters:{type:"object",properties:{pattern:{type:"string",description:"Glob pattern to match files against."},dir_path:{type:"string",description:"Directory to search in (default: current directory)."},max_results:{type:"integer",description:"Maximum results to return (default: 100)."}},required:["pattern"]},execute:async r=>{let s=r.pattern,o=r.dir_path??".",t=r.max_results??100,e=p.resolve(o),n=[];if(await v(e,s,e,n,t),n.length===0)return `No files found matching pattern: ${s}
+Searched in: ${e}`;let c=n.map((a,l)=>`  ${l+1}. ${p.relative(process.cwd(),a)}`),i=n.length>=t?`
+(Limited to ${t} results)`:"";return `Found ${n.length} file(s) matching "${s}":
+${c.join(`
+`)}${i}`}},N={description:"Executes a shell command and returns its output (stdout and stderr). Use with caution.",parameters:{type:"object",properties:{command:{type:"string",description:"The shell command to execute."},timeout_seconds:{type:"integer",description:"Maximum execution time in seconds (default: 30)."}},required:["command"]},execute:async r=>{let s=r.command,o=r.timeout_seconds??30;if(!s.trim())throw new Error("The 'command' parameter must be non-empty.");try{let{stdout:t,stderr:e}=await F(s,{timeout:o*1e3,maxBuffer:10485760,cwd:process.cwd()}),n="";return t&&(n+=`STDOUT:
+${t}`),e&&(n+=(t?`
+
+`:"")+`STDERR:
+${e}`),n||"Command executed successfully (no output)"}catch(t){let e=t;if(e.killed&&e.signal==="SIGTERM")throw new Error(`Command timed out after ${o} seconds`);let n=`Command failed: ${s}`;throw e.stdout&&(n+=`
+STDOUT:
+${e.stdout}`),e.stderr&&(n+=`
+STDERR:
+${e.stderr}`),e.code!==void 0&&(n+=`
+Exit code: ${e.code}`),new Error(n)}}},y={read_file:P,write_file:I,replace:B,ls:k,tree:C,grep:O,find:q,glob:A,run_shell_command:N};function K(r){let s=r.config;if(!s)return;let o=s.agents??[],t=new Set;for(let e of o){if(!(Array.isArray(e.provider)?e.provider:[e.provider]).some(a=>typeof a=="string"&&a.startsWith("api/")))continue;let i=e.options;if(Array.isArray(i?.query?.tools))for(let a of i.query.tools)t.add(a);if(Array.isArray(i?.execute?.tools))for(let a of i.execute.tools)t.add(a);}for(let e of t){let n=y[e];n&&r.registerTool(e,n);}}export{y as BUILTIN_TOOL_REGISTRY,K as registerBuiltinTools};

package/dist/events/TypedEventEmitter.d.ts

@@ -1,31 +1,7 @@
-/**
- * TypedEventEmitter — typed wrapper around Node's EventEmitter.
- *
- * Design:
- * - `on` / `once` are public (callers subscribe)
- * - `emit` is protected (only subclasses like Crewx can emit)
- * - Async listeners are supported (fire-and-forget, errors isolated)
- * - Returns an UnsubscribeFn from on/once for easy cleanup
- */
 import type { CrewxEventName, CrewxEventPayload, UnsubscribeFn } from './types';
 export declare class TypedEventEmitter {
     private readonly _emitter;
-    /**
-     * Subscribe to an event. Returns an unsubscribe function.
-     *
-     * @example
-     * const unsub = crewx.on('task:start', (e) => console.log(e.agentRef));
-     * // later:
-     * unsub();
-     */
     on<K extends CrewxEventName>(event: K, listener: (payload: CrewxEventPayload<K>) => void | Promise<void>): UnsubscribeFn;
-    /**
-     * Subscribe to an event exactly once.
-     */
     once<K extends CrewxEventName>(event: K, listener: (payload: CrewxEventPayload<K>) => void | Promise<void>): UnsubscribeFn;
-    /**
-     * Emit an event with payload. Only accessible to subclasses.
-     */
     protected emit<K extends CrewxEventName>(event: K, payload: CrewxEventPayload<K>): void;
 }
-//# sourceMappingURL=TypedEventEmitter.d.ts.map

package/dist/events/types.d.ts

@@ -1,83 +1,43 @@
-/**
- * Event types for the CrewX SDK event system.
- *
- * SDK emits events; callers (CLI, users) subscribe to persist or react.
- * No DB dependencies in the SDK — storage is the caller's responsibility.
- */
 import type { Platform } from '../conversation/types';
-/** Base fields present on every event. */
 export interface BaseEvent {
-    /** Unique trace ID for correlating start/end events. Format: tsk_XXXXXXXX */
     traceId: string;
-    /** Event timestamp */
     timestamp: Date;
 }
-/** Emitted when a query() or execute() call begins. */
 export interface TaskStartEvent extends BaseEvent {
-    /** Agent reference (e.g. "@claude", "claude") */
     agentRef: string;
-    /** The message/prompt being sent */
     message: string;
-    /** "query" or "execute" */
     mode: 'query' | 'execute';
-    /** PID of the spawned child process (undefined for non-process providers) */
     pid?: number;
-    /** Effective model used (e.g. "claude-sonnet-4-6") */
     model?: string;
-    /** Provider string (e.g. "cli/claude") */
     provider?: string;
-    /** Full CLI command spawned (e.g. "claude -p ... --output-format stream-json") */
     codingAgentCommand?: string;
-    /** Full rendered agent system prompt (Handlebars-rendered) */
     renderedPrompt?: string;
-    /** Extra metadata (e.g. { provider: "cli/claude" }) */
     metadata?: Record<string, unknown>;
-    /** Conversation thread ID */
     threadId?: string;
-    /** Platform origin. Defaults to 'cli'. */
     platform?: Platform;
-    /** Workspace ID (SHA-256 hash of normalized cwd). Single source of truth from Crewx instance. */
     workspaceId?: string;
-    /** Human-readable workspace name (basename of cwd). */
     workspaceName?: string;
 }
-/** Emitted when a query() or execute() call completes (success or failure). */
 export interface TaskEndEvent extends BaseEvent {
-    /** Agent reference */
     agentRef: string;
-    /** "query" or "execute" */
     mode: 'query' | 'execute';
-    /** Result data (on success) */
     result?: string;
-    /** Elapsed time in milliseconds */
     durationMs: number;
-    /** Error info (on failure) */
     error?: {
         code: string;
         message: string;
     };
-    /** Provider process exit code (0 = success) */
     exitCode?: number;
-    /** Total input tokens consumed */
     inputTokens?: number;
-    /** Total output tokens consumed */
     outputTokens?: number;
-    /** Cache-read input tokens */
     cachedInputTokens?: number;
-    /** Total cost in USD */
     costUsd?: number;
-    /** Actual model used (may differ from agent config when resolved at runtime) */
     model?: string;
-    /** Extra metadata propagated from QueryOptions/ExecuteOptions.metadata (e.g. workflow info) */
     metadata?: Record<string, unknown>;
 }
-/** Emitted for each output line from the provider process. */
 export interface TaskOutputEvent extends BaseEvent {
-    /** Agent reference */
     agentRef: string;
-    /** One line of raw output */
     output: string;
-    /** Output stream origin */
     level?: 'stdout' | 'stderr' | 'info';
 }
 export interface ToolBeforeEvent extends BaseEvent {
@@ -122,7 +82,6 @@ export interface AdapterMessageEvent {
     threadId: string;
     timestamp: Date;
 }
-/** All events emitted by the Crewx SDK. */
 export interface CrewxEvents {
     'task:start': TaskStartEvent;
     'task:end': TaskEndEvent;
@@ -134,6 +93,4 @@ export interface CrewxEvents {
 }
 export type CrewxEventName = keyof CrewxEvents;
 export type CrewxEventPayload<K extends CrewxEventName> = CrewxEvents[K];
-/** Call to remove a specific event listener. */
 export type UnsubscribeFn = () => void;
-//# sourceMappingURL=types.d.ts.map

package/dist/facade/Crewx.browser.d.ts

@@ -1,34 +1,18 @@
-/**
- * Browser-safe Crewx facade.
- *
- * Stripped of all Node.js dependencies (path, fs, child_process, crypto, events).
- * Supports: fromConfig(), query(), execute(), registerTool(), agents, tools.
- *
- * Built-in providers (e.g. api/webllm) are auto-initialised when detected
- * in the agents list — no manual registerProviderFactory required.
- */
 import type { AgentConfig, CrewxProjectConfig, QueryOptions as BaseQueryOptions, QueryResult, ExecuteOptions, ExecuteResult } from '../types/index.js';
-/**
- * Definition for a custom tool that can be registered via crewx.registerTool().
- */
 export interface ToolDefinition {
     name: string;
     description: string;
     parameters?: Record<string, unknown>;
     execute: (args: Record<string, unknown>) => Promise<unknown>;
 }
-/** Extended query options with browser streaming callback. */
 export interface BrowserQueryOptions extends BaseQueryOptions {
     onOutput?: (partial: string) => void;
 }
-/** Options for Crewx.fromConfig() in the browser environment. */
 export interface BrowserFromConfigOptions {
-    /** Progress callback for model loading (web-llm). */
     onProgress?: (report: {
         progress?: number;
         text?: string;
     }) => void;
-    /** API key for OpenRouter provider. Required when any agent uses api/openrouter. */
     openrouterApiKey?: string;
 }
 export declare class Crewx {
@@ -37,37 +21,13 @@ export declare class Crewx {
     private readonly _tools;
     private readonly _apiProviders;
     private constructor();
-    /**
-     * Create a Crewx instance from an already-parsed config object.
-     *
-     * Built-in browser providers (api/webllm, api/openrouter) are auto-initialised
-     * when detected in the agents list — no manual registerProviderFactory required.
-     */
     static fromConfig(config: CrewxProjectConfig, options?: BrowserFromConfigOptions): Promise<Crewx>;
-    /**
-     * Load web-llm from CDN, create the inference engine, and store
-     * the provider runtime.  Called automatically by fromConfig().
-     */
     private _initWebLLM;
-    /**
-     * Initialise the OpenRouter API provider.
-     * Uses fetch + SSE streaming against the OpenAI-compatible endpoint.
-     */
     private _initOpenRouter;
     get agents(): ReadonlyMap<string, AgentConfig>;
     get config(): CrewxProjectConfig | undefined;
     get tools(): ReadonlyMap<string, ToolDefinition>;
     registerTool(name: string, definition: Omit<ToolDefinition, 'name'>): void;
-    /**
-     * Query an agent with a message.
-     * Browser version — delegates directly to the registered provider factory.
-     * Passes onOutput through for streaming support.
-     */
     query(agentRef: string, message: string, options?: BrowserQueryOptions): Promise<QueryResult>;
-    /**
-     * Execute a task with an agent.
-     * Browser version — same delegation pattern as query().
-     */
     execute(agentRef: string, message: string, options?: ExecuteOptions): Promise<ExecuteResult>;
 }
-//# sourceMappingURL=Crewx.browser.d.ts.map

package/dist/facade/Crewx.d.ts

@@ -1,8 +1,3 @@
-/**
- * Crewx facade — main entry point for the CrewX SDK.
- * Provides loadYaml(), fromConfig(), query(), execute(), renderAgentPromptFull(),
- * and registerLayout() methods.
- */
 import { TypedEventEmitter } from '../events/TypedEventEmitter';
 import type { CrewxPlugin } from '../plugin';
 import type { IFsAdapter } from '../platform/IFsAdapter';
@@ -13,33 +8,18 @@ import type { CustomLayoutDefinition } from '../layout/types';
 import type { TemplateMessage } from '../conversation/types';
 import type { HandlerOptions, CrewxHandler } from '../server/handler';
 import type { RemoteProviderConfig } from '../remote/types.js';
-/**
- * Definition for a custom tool that can be registered via crewx.registerTool().
- * Tools are made available in the agent prompt context for browser/API environments.
- */
 export interface ToolDefinition {
-    /** Tool name (unique identifier). */
     name: string;
-    /** Human-readable description of what the tool does. */
     description: string;
-    /** JSON Schema for tool parameters (optional). */
     parameters?: Record<string, unknown>;
-    /** Tool execution function. Omit for client-side tools (Vercel AI SDK client tools). */
     execute?: (args: Record<string, unknown>) => Promise<unknown>;
 }
-/**
- * Layout specification for renderAgentPromptFull options.
- * Matches the crewx.yaml inline.layout schema.
- */
 export type LayoutSpec = string | {
     id: string;
     props?: Record<string, any>;
 } | {
     template: string;
 };
-/**
- * Skill entry for available_skills rendering in agent prompts.
- */
 export interface SkillEntry {
     metadata: {
         name: string;
@@ -48,25 +28,16 @@ export interface SkillEntry {
     };
     filePath: string;
 }
-/**
- * Options for renderAgentPromptFull().
- */
 export interface RenderAgentPromptOptions {
-    /** Override layout resolution. Priority: options.layout > agent.inline.layout > project default > SDK default. */
     layout?: LayoutSpec;
-    /** Override session info (default: { mode: 'query', platform: 'cli' }). */
     session?: {
         mode?: string;
         platform?: string;
         options?: string[];
     };
-    /** Override env (default: process.env). */
     env?: Record<string, string>;
-    /** Override vars (e.g. security_key). Default: auto-generated. */
     vars?: Record<string, unknown>;
-    /** Skills to inject as available_skills context. Default: []. */
     skills?: SkillEntry[];
-    /** Conversation history messages for layout rendering (WI-CONV-002). Caller-provided takes priority over auto-fetch. */
     messages?: TemplateMessage[];
 }
 export declare class Crewx extends TypedEventEmitter {
@@ -83,185 +54,51 @@ export declare class Crewx extends TypedEventEmitter {
     private readonly _tools;
     private readonly _activeAdapters;
     private readonly _pendingThreads;
-    /**
-     * Bootstrap factory for target Crewx instances when delegating file:// remote agents.
-     * Consumers (CLI / server / Slack) provide their own bootstrap wrapper so that the
-     * target inherits the same plugin/environment setup as the caller.
-     */
     private readonly _remoteFactory?;
-    /** Lazily-created target Crewx instances, keyed by absolute configPath. */
     private readonly _remoteTargets;
     private constructor();
-    /**
-     * If `agentRef` resolves to a `remote/*` provider backed by `file://`, return
-     * the target Crewx (lazily bootstrapped) together with the agent ref to use
-     * inside the target. Returns null for local agents or non-file remotes.
-     *
-     * The caller's Crewx.query/execute delegates entirely to the returned target
-     * (including task:start/end emit, renderContext, plugins) so execution
-     * semantics exactly match running `crewx q` inside the target workspace.
-     */
     private resolveFileRemoteTarget;
-    /**
-     * Load crewx.yaml from the given file path and create a Crewx instance.
-     */
     static loadYaml(path: string, options?: CrewxOptions, fsAdapter?: IFsAdapter): Promise<Crewx>;
-    /**
-     * Create a Crewx instance from an already-parsed config object.
-     */
     static fromConfig(config: CrewxProjectConfig, options?: CrewxOptions, projectRoot?: string, fsAdapter?: IFsAdapter): Promise<Crewx>;
-    /** All loaded agents, keyed by agent id. */
     get agents(): ReadonlyMap<string, AgentConfig>;
-    /** The raw project config (includes providers, settings, etc.). */
     get config(): CrewxProjectConfig | undefined;
-    /** All registered plugins. */
     get plugins(): readonly CrewxPlugin[];
-    /** All registered custom tools. */
     get tools(): ReadonlyMap<string, ToolDefinition>;
-    /** Workspace ID (SHA-256 hash). Single source of truth for all plugins. */
     get workspaceId(): string;
-    /** Human-readable workspace name (basename of cwd). */
     get workspaceName(): string;
-    /**
-     * Return an agent config by ref (with or without leading '@').
-     * Returns undefined if the agent is not found.
-     */
     getAgent(agentRef: string): AgentConfig | undefined;
-    /**
-     * Return a remote provider config by provider ID from the crewx.yaml `providers:` section.
-     * Returns undefined if not found or if config has no providers.
-     */
     getRemoteProviderConfig(providerId: string): RemoteProviderConfig | undefined;
     private computeTaskLogPath;
-    /**
-     * Register a custom tool for use in agent prompts.
-     *
-     * Registered tools are included in the `tools` context of renderAgentPromptFull(),
-     * and can be invoked programmatically (e.g. in browser environments with API providers).
-     *
-     * @param name - Unique tool name (overwrites if already registered)
-     * @param definition - Tool definition with description, parameters, and execute function
-     */
     registerTool(name: string, definition: Omit<ToolDefinition, 'name'>): void;
-    /**
-     * Register a plugin and immediately call attach().
-     * Same instance registered twice is silently ignored (by reference).
-     */
     use(plugin: CrewxPlugin): Promise<void>;
-    /**
-     * Create a Web Standard MCP HTTP handler for exposing agents over the network.
-     *
-     * @param options - Handler config. `agents` list is required for security.
-     * @returns `(req: Request) => Promise<Response>` handler
-     */
     handler(options: HandlerOptions): CrewxHandler;
-    /**
-     * Register a channel adapter and start it.
-     */
     registerChannelAdapter<TConfig = unknown>(reg: ChannelAdapterRegistration<TConfig>): Promise<void>;
-    /**
-     * Unregister and stop a channel adapter by instanceId.
-     */
     unregisterChannelAdapter(instanceId: string): Promise<void>;
-    /**
-     * Stop all registered adapters with a timeout.
-     */
     stopAllAdapters(opts?: {
         timeoutMs?: number;
     }): Promise<void>;
-    /**
-     * Detach all plugins in LIFO order and release resources.
-     * Call before process exit for clean shutdown.
-     */
     close(): Promise<void>;
-    /**
-     * Filter agents by role, team, and/or provider.
-     */
     filterAgents(filters: {
         role?: string;
         team?: string;
         provider?: string;
     }): AgentConfig[];
-    /**
-     * Return the raw system prompt for the given agent (no template expansion, no layout).
-     * @throws AgentNotFoundError if agentId is not found
-     */
     renderAgentPrompt(agentId: string): string;
-    /**
-     * Render a Handlebars template string with the given context.
-     * Documents from crewx.yaml are automatically merged into context.documents.
-     */
     renderPrompt(template: string, context?: TemplateContext): Promise<string>;
-    /**
-     * Register a custom layout template at runtime.
-     *
-     * @param name     - Layout identifier (used as-is, no forced namespace)
-     * @param template - Handlebars template string or CustomLayoutDefinition
-     */
     registerLayout(name: string, template: string | CustomLayoutDefinition): void;
-    /**
-     * Render the full agent prompt using the layout system.
-     *
-     * Resolution priority (first match wins):
-     *   1. options.layout           (call-site override)
-     *   2. agent.inline.layout      (agent YAML definition)
-     *   3. config.layouts.default   (project-level default)
-     *   4. SDK built-in default     (crewx/default)
-     *
-     * @param agentId - Agent ID (with or without leading '@')
-     * @param options - Optional layout/session/env/vars overrides
-     * @throws AgentNotFoundError if agentId is not found
-     */
     renderAgentPromptFull(agentId: string, options?: RenderAgentPromptOptions): Promise<string>;
-    /**
-     * Filter tools by allowed names from agent options (query/execute mode).
-     * If allowedNames is undefined, return all registered tools.
-     */
     private _filterToolsByMode;
-    /**
-     * Resolve layout spec following the priority order.
-     */
     private _resolveLayoutSpec;
-    /** Extract the layout ID string from a LayoutSpec. */
     private _extractLayoutId;
-    /** Extract layout props overrides from agent inline.layout and call-site options. */
     private _extractLayoutProps;
-    /**
-     * Get the ConversationPlugin's provider for history auto-fetch (WI-CONV-002).
-     * Returns undefined if no ConversationPlugin is registered.
-     */
     private _getConversationProvider;
-    /**
-     * Auto-fetch conversation history and convert to TemplateMessage[] (WI-CONV-002).
-     * Returns undefined if no threadId, no provider, or fetch fails.
-     */
     private _fetchHistoryMessages;
     private emitToolEvents;
     private tryParseJson;
-    /**
-     * Query an agent with a message.
-     *
-     * Emits task:start (with child pid when available) then task:output per
-     * stdout/stderr line, then task:end on completion or error.
-     */
     query(agentRef: string, message: string, options?: QueryOptions): Promise<QueryResult>;
-    /**
-     * Continue a conversation after providing client-side tool results.
-     *
-     * Called when a previous query() returned status: 'requires_action'.
-     * Feeds the tool result back to the agent and resumes generation.
-     * May return 'requires_action' again if the agent calls another client tool.
-     */
     continueQuery(threadId: string, toolResults: Array<{
         toolCallId: string;
         result: unknown;
     }>): Promise<QueryResult>;
-    /**
-     * Execute a task with an agent.
-     *
-     * Emits task:start (with child pid when available) then task:output per
-     * stdout/stderr line, then task:end on completion or error.
-     */
     execute(agentRef: string, message: string, options?: ExecuteOptions): Promise<ExecuteResult>;
 }
-//# sourceMappingURL=Crewx.d.ts.map

package/dist/hooks/define.d.ts

@@ -7,4 +7,3 @@ export interface PluginDefinition {
     run(ctx: ObserverContext): Promise<ObserverResult>;
 }
 export declare function definePlugin(def: PluginDefinition): ToolObserverPlugin;
-//# sourceMappingURL=define.d.ts.map

package/dist/hooks/dispatch.d.ts

@@ -1,14 +1,3 @@
-/**
- * Security notes:
- *
- * (M1) Codex `systemMessage` is merged into the agent's system prompt directly.
- *      Guide messages MUST NOT contain dynamic external input (tool_input,
- *      external API results, etc.) to prevent prompt injection via hook inject.
- *
- * Provider matching: When `provider` is not specified in a hook definition,
- * it applies to ALL providers (§4.1.1 2-Layer Selector design).
- * This is intentional — allows catch-all safety rules.
- */
 import type { HookContext } from '../hooks/types';
 import type { HookPlugin } from '../hooks/plugin';
 export interface ClaudeHookInput {
@@ -58,4 +47,3 @@ export declare function formatInjectOutput(provider: Provider, hookEventName: st
 export declare function formatDenyOutput(_provider: Provider, hookEventName: string, reason: string): ProviderHookOutput;
 export declare function buildHookContext(input: ClaudeHookInput, cwd: string, provider?: string): HookContext;
 export declare function evaluateHook(plugin: HookPlugin, input: ClaudeHookInput, cwd: string, provider?: string): Promise<HookDispatchResult>;
-//# sourceMappingURL=dispatch.d.ts.map

package/dist/hooks/index.d.ts

@@ -10,4 +10,3 @@ export { Tools } from './types';
 export type { ObserverContext, ObserverResult, ObserverEvent, HookContext, HookResult, HookEvent, ToolName, ToolInputPatch, Capability, } from './types';
 export { evaluateHook, sanitizeDenyReason, sanitizeInjectMessage, isPathSafe, buildHookContext, formatInjectOutput, formatDenyOutput, } from './dispatch';
 export type { ClaudeHookInput, ClaudeHookOutput, CodexHookOutput, ProviderHookOutput, Provider, HookDispatchResult, } from './dispatch';
-//# sourceMappingURL=index.d.ts.map