aws-runtime-bridge 1.9.175 → 1.9.180

package/dist/services/workspace-index/indexer.js

@@ -0,0 +1,2 @@
+import{promises as k}from"node:fs";import g from"node:path";import{detectLanguage as v,extractFileIndex as C,getParserForLanguage as M}from"@agentswork/acode";import{createLogger as S}from"../../utils/logger.js";import{isIgnoredByGitIgnore as P,loadGitIgnoreRules as T}from"../gitignore.js";import{resolveImports as $}from"./resolver.js";import{DEFAULT_INDEX_OPTIONS as z,INDEX_SKIP_DIRS as L,INDEX_SUPPORTED_EXTENSIONS as _,symbolKey as B,toPosixPath as F}from"./types.js";const D=S("workspace-index"),A=4;async function R(i,n){const s=[];let e=0,r=!1,c=0,t=[];try{t=await T(i)}catch{}const y=[{dir:i,depth:0}];for(;y.length>0;){if(s.length>=n.maxFiles){r=!0;break}const l=y.shift();if(!l)break;if(l.depth>40){e+=1;continue}let h;try{h=await k.readdir(l.dir,{withFileTypes:!0})}catch{e+=1;continue}for(const u of h){const f=g.join(l.dir,u.name);if(u.isDirectory()){if(L.has(u.name))continue;const a=F(g.relative(i,f))+"/";if(P(a,!0,t))continue;y.push({dir:f,depth:l.depth+1});continue}if(!u.isFile())continue;const I=g.extname(u.name).toLowerCase();if(!_.has(I))continue;const d=F(g.relative(i,f));if(P(d,!1,t))continue;let m;try{m=await k.stat(f)}catch{e+=1;continue}if(m.size>n.maxFileBytes){e+=1;continue}if(c+=m.size,c>n.maxTotalBytes){r=!0;break}if(s.push(f),s.length>=n.maxFiles){r=!0;break}}}return{files:s,skipped:e,truncated:r}}async function O(i){const n=v(i);if(!n)return null;let s;try{s=await k.stat(i)}catch{return null}if(!s.isFile())return null;let e;try{e=await k.readFile(i,"utf8")}catch{return null}try{const r=await M(n);if(!r)return null;const c=r.parse(e);if(!c)return null;const t=C(c,n);return c.delete(),{index:t,mtimeMs:s.mtimeMs,size:s.size}}catch(r){return D.debug(`[workspace-index] \u89E3\u6790\u5931\u8D25 ${i}: ${r.message}`),null}}async function X(i,n,s){const e=new Array(i.length);let r=0;const c=Array.from({length:Math.min(n,i.length)},async()=>{for(;;){const t=r;if(r+=1,t>=i.length)return;e[t]=await s(i[t])}});return await Promise.all(c),e}async function H(i,n={}){const s=Date.now(),e=g.resolve(String(i||"").trim()),r={...z,...n.maxFiles!==void 0?{maxFiles:n.maxFiles}:{},...n.maxFileBytes!==void 0?{maxFileBytes:n.maxFileBytes}:{},...n.maxTotalBytes!==void 0?{maxTotalBytes:n.maxTotalBytes}:{}};let c;try{c=await k.stat(e)}catch{throw new Error(`workspace does not exist: ${e}`)}if(!c.isDirectory())throw new Error(`workspace is not a directory: ${e}`);const t=await R(e,r);D.info(`[workspace-index] \u626B\u63CF\u5B8C\u6210 workspace=${e} files=${t.files.length} skipped=${t.skipped} truncated=${t.truncated}`);const y=await X(t.files,A,O),l=new Map,h=new Map,u=new Map,f=new Map;let I=0;for(let d=0;d<t.files.length;d+=1){const m=t.files[d],a=y[d];if(!a)continue;const w=F(g.resolve(m)),E=F(g.relative(e,m)),N=a.index.symbols.map(o=>({name:o.name,kind:o.kind,filePath:w,line:o.line,column:o.column,endLine:o.endLine,endColumn:o.endColumn,signature:o.signature})),b={filePath:w,relativePath:E,language:a.index.language,mtimeMs:a.mtimeMs,size:a.size,symbols:N,imports:[],identifierNames:a.index.identifierNames,packageName:a.index.packageName};l.set(w,b),f.set(w,a.index),I+=N.length;for(const o of N){const p=B(o.name);if(!p)continue;const x=h.get(p);x?x.push(o):h.set(p,[o])}for(const o of a.index.identifierNames){const p=B(o);if(!p)continue;const x=u.get(p);x?x.add(w):u.set(p,new Set([w]))}}for(const[d,m]of l){const a=f.get(d);a&&(m.imports=$({workspaceRoot:F(e),filePath:d,language:a.language,packageName:a.packageName,rawImports:a.imports,files:l}))}return{workspacePath:e,builtAt:Date.now(),files:l,byName:h,filesByIdentifier:u,truncated:t.truncated,stats:{fileCount:l.size,symbolCount:I,skippedCount:t.skipped,durationMs:Date.now()-s}}}export{H as buildWorkspaceIndex};
+

package/dist/services/workspace-index/query.d.ts

@@ -0,0 +1,74 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+import { type WorkspaceIndexSnapshot } from "./types.js";
+export interface IndexLocation {
+    
+    filePath: string;
+    
+    line: number;
+    
+    column: number;
+    endLine: number;
+    endColumn: number;
+    
+    name: string;
+    kind: string;
+    
+    preview: string;
+    
+    isDeclaration: boolean;
+}
+export interface IndexQueryResult {
+    ok: boolean;
+    provider: "syntax-index";
+    kind: "definition" | "references" | "symbols" | "outline";
+    
+    symbol: string;
+    locations: IndexLocation[];
+    
+    truncated: boolean;
+    
+    indexed: boolean;
+    
+    stats?: WorkspaceIndexSnapshot["stats"];
+}
+
+export declare function resolveSymbolAtPosition(filePath: string, line: number, column: number): Promise<string | null>;
+
+export declare function querySymbols(snapshot: WorkspaceIndexSnapshot, name: string, limit?: number): IndexQueryResult;
+
+export declare function queryDefinition(snapshot: WorkspaceIndexSnapshot, params: {
+    filePath: string;
+    line: number;
+    column: number;
+    name?: string;
+}): Promise<IndexQueryResult>;
+
+export declare function queryReferences(snapshot: WorkspaceIndexSnapshot, params: {
+    filePath: string;
+    line: number;
+    column: number;
+    name?: string;
+    includeDeclaration?: boolean;
+}, limit?: number): Promise<IndexQueryResult>;
+
+export declare function queryOutline(snapshot: WorkspaceIndexSnapshot, params: {
+    filePath: string;
+}): Promise<IndexQueryResult>;
+
+export declare function readLine(filePath: string, line: number): Promise<string>;
+
+export declare function fillPreviews(snapshot: WorkspaceIndexSnapshot, locations: IndexLocation[]): Promise<IndexLocation[]>;

package/dist/services/workspace-index/query.js

@@ -0,0 +1,5 @@
+import{promises as p}from"node:fs";import m from"node:path";import{detectLanguage as b,findIdentifierOccurrences as I,getParserForLanguage as D,identifierAtPosition as M}from"@agentswork/acode";import{toPosixPath as x}from"./types.js";function C(e,t){if(e.filePath===t.currentFile)return 0;if(t.importedFiles.has(e.filePath))return 1;if(m.dirname(e.filePath)===t.currentDir)return 2;const r=t.files.get(e.filePath);return t.packageName&&r?.packageName===t.packageName?3:4}function N(e,t){return{filePath:x(e.filePath),line:e.line,column:e.column,endLine:e.endLine,endColumn:e.endColumn,name:e.name,kind:e.kind,preview:e.signature,isDeclaration:t}}function S(e,t){return x(m.relative(e.workspacePath,t))}function $(e,t){return{...t,filePath:S(e,t.filePath)}}function O(e,t){return m.resolve(e.workspacePath,t)}async function q(e,t,r){const i=b(e);if(!i)return null;let n;try{n=await p.readFile(e,"utf8")}catch{return null}const a=await D(i);if(!a)return null;const o=a.parse(n);if(!o)return null;try{const d=n.split(`
+`);let f=0;for(let u=0;u<t-1&&u<d.length;u+=1)f+=d[u].length+1;return f+=Math.max(0,r-1),M(o,f,i)}finally{o.delete()}}function j(e,t,r=100){const i=t.trim().toLowerCase(),n=[];let a=!1;if(i)for(const o of e.byName.get(i)??[]){if(n.length>=r){a=!0;break}n.push($(e,N(o,!0)))}return{ok:!0,provider:"syntax-index",kind:"symbols",symbol:t,locations:n,truncated:a,indexed:!0,stats:e.stats}}async function G(e,t){const r=x(m.resolve(e.workspacePath,t.filePath)),i=t.name?.trim()||await q(r,t.line,t.column);if(!i)return{ok:!0,provider:"syntax-index",kind:"definition",symbol:"",locations:[],truncated:!1,indexed:!0,stats:e.stats};const n=e.files.get(r),a=new Set;for(const l of n?.imports??[])l.resolvedFile&&a.add(l.resolvedFile);const o={currentFile:r,currentDir:m.dirname(r),importedFiles:a,packageName:n?.packageName??null,files:e.files},d=e.byName.get(i.trim().toLowerCase())??[],f=[...d].sort((l,y)=>C(l,o)-C(y,o)),u=new Set,s=[];for(const l of f){const y=`${l.filePath}:${l.line}:${l.column}`;if(!u.has(y)&&(u.add(y),s.push($(e,N(l,!0))),s.length>=50))break}return{ok:!0,provider:"syntax-index",kind:"definition",symbol:i,locations:s,truncated:d.length>s.length,indexed:!0,stats:e.stats}}async function H(e,t,r=300){const i=x(m.resolve(e.workspacePath,t.filePath)),n=t.name?.trim()||await q(i,t.line,t.column);if(!n)return{ok:!0,provider:"syntax-index",kind:"references",symbol:"",locations:[],truncated:!1,indexed:!0,stats:e.stats};const a=n.trim().toLowerCase(),o=new Set(e.filesByIdentifier.get(a)??[]);o.add(i);const d=t.includeDeclaration!==!1,f=new Map;for(const c of e.byName.get(a)??[])f.set(`${c.filePath}:${c.line}:${c.column}`,c);const u=e.files.get(i),s=new Set;for(const c of u?.imports??[])c.resolvedFile&&s.add(c.resolvedFile);const l={currentFile:i,currentDir:m.dirname(i),importedFiles:s,packageName:u?.packageName??null,files:e.files},y=[...o].sort((c,k)=>{const h=c===l.currentFile?0:l.importedFiles.has(c)?1:m.dirname(c)===l.currentDir?2:4,v=k===l.currentFile?0:l.importedFiles.has(k)?1:m.dirname(k)===l.currentDir?2:4;return h-v}),w=[];let P=!1;for(const c of y){if(w.length>=r){P=!0;break}const k=b(c);if(!k)continue;let h;try{h=await p.readFile(c,"utf8")}catch{continue}const v=await D(k);if(!v)continue;const L=v.parse(h);if(L)try{const A=I(L,k,n,r);for(const g of A){const B=`${c}:${g.line}:${g.column}`,F=f.get(B);if(!(F&&!d)&&(w.push({filePath:S(e,c),line:g.line,column:g.column,endLine:g.line,endColumn:g.column+n.length,name:F?.name??n,kind:F?.kind??"reference",preview:g.context,isDeclaration:!!F}),w.length>=r)){P=!0;break}}}finally{L.delete()}}return{ok:!0,provider:"syntax-index",kind:"references",symbol:n,locations:w,truncated:P,indexed:!0,stats:e.stats}}async function J(e,t){const r=x(m.resolve(e.workspacePath,t.filePath)),i=e.files.get(r);if(!i){const n=b(r);if(!n)return{ok:!0,provider:"syntax-index",kind:"outline",symbol:"",locations:[],truncated:!1,indexed:!0,stats:e.stats};try{const a=await p.readFile(r,"utf8"),o=await D(n),d=o?.parse(a);if(o&&d){const{extractFileIndex:f}=await import("@agentswork/acode"),u=f(d,n);return d.delete(),{ok:!0,provider:"syntax-index",kind:"outline",symbol:"",locations:u.symbols.map(s=>({filePath:x(t.filePath),line:s.line,column:s.column,endLine:s.endLine,endColumn:s.endColumn,name:s.name,kind:s.kind,preview:s.signature,isDeclaration:!0})),truncated:!1,indexed:!0,stats:e.stats}}}catch{}return{ok:!0,provider:"syntax-index",kind:"outline",symbol:"",locations:[],truncated:!1,indexed:!0,stats:e.stats}}return{ok:!0,provider:"syntax-index",kind:"outline",symbol:"",locations:i.symbols.map(n=>$(e,N(n,!0))),truncated:!1,indexed:!0,stats:e.stats}}async function Q(e,t){try{return((await p.readFile(e,"utf8")).split(`
+`)[t-1]??"").trim().slice(0,200)}catch{return""}}async function T(e,t){const r=new Map,i=[];for(const n of t){if(n.preview){i.push(n);continue}const a=O(e,n.filePath);let o=r.get(a);if(!o){try{o=(await p.readFile(a,"utf8")).split(`
+`)}catch{o=[]}r.set(a,o)}i.push({...n,preview:(o[n.line-1]??"").trim().slice(0,200)})}return i}export{T as fillPreviews,G as queryDefinition,J as queryOutline,H as queryReferences,j as querySymbols,Q as readLine,q as resolveSymbolAtPosition};
+

package/dist/services/workspace-index/resolver.d.ts

@@ -0,0 +1,26 @@
+
+
+
+
+
+
+
+
+import { type IndexedFile, type IndexedImport } from "./types.js";
+export interface ResolveImportsInput {
+    workspaceRoot: string;
+    filePath: string;
+    language: string;
+    packageName: string | null;
+    rawImports: Array<{
+        text: string;
+        line: number;
+    }>;
+    
+    files: Map<string, IndexedFile>;
+}
+
+
+
+
+export declare function resolveImports(input: ResolveImportsInput): IndexedImport[];

package/dist/services/workspace-index/resolver.js

@@ -0,0 +1,2 @@
+import a from"node:path";import{toPosixPath as k}from"./types.js";const b={typescript:[".ts",".tsx",".mts",".cts",".js",".jsx",".json"],javascript:[".js",".jsx",".mjs",".cjs",".ts",".tsx",".json"],python:[".py",".pyi"],go:[".go"],rust:[".rs"],java:[".java"],c:[".c",".h"],cpp:[".cpp",".cc",".cxx",".hpp",".hxx",".h"],"c-sharp":[".cs"],ruby:[".rb"],php:[".php"],lua:[".lua"]};function $(t){return k(a.resolve(t))}function u(t,s){const i=$(s);if(t.has(i))return i;const r=i.toLowerCase();for(const e of t.keys())if(e.toLowerCase()===r)return e;return null}function j(t,s,i,r){const e=a.dirname(t),o=a.resolve(e,s),c=b[i]??[],l=[o];for(const n of c)l.push(`${o}${n}`);for(const n of c)l.push(a.join(o,`index${n}`));for(const n of c)l.push(a.join(o,`mod${n}`));l.push(a.join(o,"__init__.py"));for(const n of l){const p=u(r,n);if(p)return p}return null}function N(t,s,i){const r=/\bfrom\s+['"]([^'"]+)['"]/.exec(s)??/\bimport\s+['"]([^'"]+)['"]/.exec(s);if(!r)return null;const e=r[1],o=[],c=/\{([^}]*)\}/.exec(s);if(c)for(const p of c[1].split(",")){const f=p.trim().split(/\s+as\s+/)[0]?.trim();f&&o.push(f)}const l=/^import\s+([A-Za-z_$][\w$]*)/.exec(s);l&&o.push(l[1]);const n=/\*\s+as\s+([A-Za-z_$][\w$]*)/.exec(s);return n&&o.push(n[1]),e.startsWith(".")?{text:s,line:0,resolvedFile:j(t,e,"typescript",i),importedNames:o,moduleSpecifier:e}:{text:s,line:0,resolvedFile:null,importedNames:o,moduleSpecifier:e}}function S(t,s,i){const r=/^\s*from\s+([.\w]+)\s+import\s+(.+)$/.exec(s);if(r){const o=r[1],c=r[2].replace(/[()]/g,"").split(",").map(n=>n.trim().split(/\s+as\s+/)[0]?.trim()).filter(Boolean);let l=null;if(o.startsWith(".")){const n=/^\.+/.exec(o)?.[0].length??1,p=o.slice(n).replace(/\./g,"/");let f=a.dirname(t);for(let d=1;d<n;d+=1)f=a.dirname(f);const m=a.join(f,p);l=u(i,`${m}.py`)??u(i,a.join(m,"__init__.py"))}else{const p=o.split(".").join("/");for(const f of i.keys())if(f.endsWith(`/${p}.py`)||f.endsWith(`/${p}/__init__.py`)){l=f;break}}return{text:s,line:0,resolvedFile:l,importedNames:c,moduleSpecifier:o}}const e=/^\s*import\s+(.+)$/.exec(s);if(e){const o=e[1].split(",")[0]?.trim().split(/\s+as\s+/)[0]?.trim();if(!o)return null;const c=o.replace(/\./g,"/");let l=null;for(const n of i.keys())if(n.endsWith(`/${c}.py`)||n.endsWith(`/${c}/__init__.py`)){l=n;break}return{text:s,line:0,resolvedFile:l,importedNames:[o.split(".").pop()??o],moduleSpecifier:o}}return null}function F(t,s,i){const r=/^\s*import\s+(static\s+)?([\w.]+)(?:\.\*)?\s*;/.exec(s);if(!r)return null;const e=!!r[1],o=r[2],c=o.split("."),l=c[c.length-1],n=c.join("/"),p=e?[`${n}.java`,`${c.slice(0,-1).join("/")}.java`]:[`${n}.java`];for(const f of p)for(const m of i.keys())if(m.endsWith(`/${f}`))return{text:s,line:0,resolvedFile:m,importedNames:[l],moduleSpecifier:o};return{text:s,line:0,resolvedFile:null,importedNames:[l],moduleSpecifier:o}}function g(t,s,i){const r=/"([^"]+)"/.exec(s);if(!r)return null;const e=r[1],o=e.split("/").pop()??e;let c=null;for(const l of i.keys())if(!l.endsWith(`/${e}/`)&&(l.includes(`/${e}/`)||l.endsWith(`/${o}/${o}.go`))){c=l;break}return{text:s,line:0,resolvedFile:c,importedNames:o?[o]:[],moduleSpecifier:e}}function x(t,s,i){const r=/^\s*use\s+([^;]+);/.exec(s);if(!r)return null;const e=r[1].trim(),o=e.startsWith("crate::")||e.startsWith("self::")||e.startsWith("super::"),c=[],l=/\{([^}]*)\}/.exec(e);if(l)for(const p of l[1].split(",")){const f=p.trim().split(/\s+as\s+/)[0]?.trim();f&&f!=="self"&&c.push(f.split("::").pop()??f)}else c.push(e.split("::").pop()??e);let n=null;if(o){const p=a.dirname(t),f=e.replace(/^(crate|self|super)::/,"").replace(/\{.*$/,"").split("::").filter(Boolean);for(let m=f.length;m>0;m-=1){const d=f.slice(0,m).join("/"),v=[a.join(p,`${d}.rs`),a.join(p,d,"mod.rs")];for(const y of v){const h=u(i,y);if(h){n=h;break}}if(n)break}}return{text:s,line:0,resolvedFile:n,importedNames:c,moduleSpecifier:e}}function _(t,s,i){const r=/#\s*include\s*[<"]([^>"]+)[>"]/.exec(s);if(!r)return null;const e=r[1],o=a.dirname(t),c=[a.resolve(o,e),a.resolve(o,"..",e)];for(const l of c){const n=u(i,l);if(n)return{text:s,line:0,resolvedFile:n,importedNames:[],moduleSpecifier:e}}for(const l of i.keys())if(l.endsWith(`/${e}`))return{text:s,line:0,resolvedFile:l,importedNames:[],moduleSpecifier:e};return{text:s,line:0,resolvedFile:null,importedNames:[],moduleSpecifier:e}}function P(t){const s=/^\s*using\s+(?:static\s+)?([\w.]+)\s*;/.exec(t);if(!s)return null;const i=s[1],r=[i.split(".").pop()??i];return{text:t,line:0,resolvedFile:null,importedNames:r,moduleSpecifier:i}}function W(t,s,i){const r=/^\s*require(?:_relative)?\s+['"]([^'"]+)['"]/.exec(s);if(!r)return null;const e=r[1],o=a.dirname(t),c=[a.resolve(o,`${e}.rb`),a.resolve(o,e),a.resolve(o,`${e}.rb`)];for(const l of c){const n=u(i,l);if(n)return{text:s,line:0,resolvedFile:n,importedNames:[],moduleSpecifier:e}}for(const l of i.keys())if(l.endsWith(`/${e}.rb`))return{text:s,line:0,resolvedFile:l,importedNames:[],moduleSpecifier:e};return{text:s,line:0,resolvedFile:null,importedNames:[],moduleSpecifier:e}}function I(t,s,i){const r=/^\s*use\s+([\w\\]+)(?:\s+as\s+(\w+))?\s*;/.exec(s);if(!r)return null;const e=r[1].replace(/\\/g,"."),o=e.split("."),c=r[2]||o[o.length-1],l=o.join("/");for(const n of i.keys())if(n.endsWith(`/${l}.php`))return{text:s,line:0,resolvedFile:n,importedNames:[c],moduleSpecifier:e};return{text:s,line:0,resolvedFile:null,importedNames:[c],moduleSpecifier:e}}function w(t,s,i){const r=/require\s*\(?\s*['"]([^'"]+)['"]/.exec(s);if(!r)return null;const e=r[1],o=a.dirname(t),c=e.replace(/\./g,"/"),l=[a.resolve(o,`${c}.lua`),a.resolve(o,`${e}.lua`)];for(const n of l){const p=u(i,n);if(p)return{text:s,line:0,resolvedFile:p,importedNames:[],moduleSpecifier:e}}for(const n of i.keys())if(n.endsWith(`/${c}.lua`))return{text:s,line:0,resolvedFile:n,importedNames:[],moduleSpecifier:e};return{text:s,line:0,resolvedFile:null,importedNames:[],moduleSpecifier:e}}function L(t){const s=[];for(const i of t.rawImports){let r=null;switch(t.language){case"typescript":case"tsx":case"javascript":case"jsx":r=N(t.filePath,i.text,t.files);break;case"python":r=S(t.filePath,i.text,t.files);break;case"java":r=F(t.filePath,i.text,t.files);break;case"go":r=g(t.filePath,i.text,t.files);break;case"rust":r=x(t.filePath,i.text,t.files);break;case"c":case"cpp":r=_(t.filePath,i.text,t.files);break;case"c-sharp":r=P(i.text);break;case"ruby":r=W(t.filePath,i.text,t.files);break;case"php":r=I(t.filePath,i.text,t.files);break;case"lua":r=w(t.filePath,i.text,t.files);break;default:r=null}r&&s.push({...r,line:i.line})}return s}export{L as resolveImports};
+

package/dist/services/workspace-index/types.d.ts

@@ -0,0 +1,89 @@
+
+
+
+
+
+
+
+
+
+
+
+
+export interface IndexedSymbol {
+    name: string;
+    kind: string;
+    filePath: string;
+    
+    line: number;
+    
+    column: number;
+    endLine: number;
+    endColumn: number;
+    signature: string;
+}
+
+export interface IndexedImport {
+    
+    text: string;
+    line: number;
+    
+    resolvedFile: string | null;
+    
+    importedNames: string[];
+    
+    moduleSpecifier: string;
+}
+
+export interface IndexedFile {
+    
+    filePath: string;
+    
+    relativePath: string;
+    language: string;
+    mtimeMs: number;
+    size: number;
+    symbols: IndexedSymbol[];
+    imports: IndexedImport[];
+    
+    identifierNames: string[];
+    
+    packageName: string | null;
+}
+export interface WorkspaceIndexSnapshot {
+    workspacePath: string;
+    
+    builtAt: number;
+    files: Map<string, IndexedFile>;
+    
+    byName: Map<string, IndexedSymbol[]>;
+    
+    filesByIdentifier: Map<string, Set<string>>;
+    
+    truncated: boolean;
+    
+    stats: {
+        fileCount: number;
+        symbolCount: number;
+        skippedCount: number;
+        durationMs: number;
+    };
+}
+export interface IndexBuildOptions {
+    
+    maxFiles?: number;
+    
+    maxFileBytes?: number;
+    
+    maxTotalBytes?: number;
+    
+    force?: boolean;
+}
+export declare const DEFAULT_INDEX_OPTIONS: Required<Omit<IndexBuildOptions, "force">>;
+
+export declare const INDEX_SKIP_DIRS: Set<string>;
+
+export declare const INDEX_SUPPORTED_EXTENSIONS: Set<string>;
+export declare function toPosixPath(value: string): string;
+
+export declare function symbolKey(name: string): string;

package/dist/services/workspace-index/types.js

@@ -0,0 +1,2 @@
+const t={maxFiles:Number(process.env.AWS_WORKSPACE_INDEX_MAX_FILES||2e4),maxFileBytes:Number(process.env.AWS_WORKSPACE_INDEX_MAX_FILE_BYTES||1048576),maxTotalBytes:Number(process.env.AWS_WORKSPACE_INDEX_MAX_TOTAL_BYTES||268435456)},s=new Set([".git",".svn",".hg",".idea",".vscode",".gradle",".next",".nuxt",".turbo",".cache","node_modules","bower_components","vendor","target","dist","build","out","bin","obj","coverage","__pycache__",".venv","venv"]),o=new Set([".ts",".tsx",".mts",".cts",".js",".jsx",".mjs",".cjs",".py",".go",".rs",".java",".c",".h",".cpp",".cc",".cxx",".hpp",".hxx",".cs",".rb",".php",".lua",".sh",".bash"]);function r(e){return String(e||"").replace(/\\/g,"/")}function _(e){return String(e||"").trim().toLowerCase()}export{t as DEFAULT_INDEX_OPTIONS,s as INDEX_SKIP_DIRS,o as INDEX_SUPPORTED_EXTENSIONS,_ as symbolKey,r as toPosixPath};
+

package/dist/services/workspace-watch.d.ts

@@ -3,12 +3,16 @@ interface WorkspaceFileWatchParams {
     filePath: string;
 }
 
+
+
 export declare function watchWorkspaceFile(params: WorkspaceFileWatchParams): Promise<{
     ok: true;
     workspacePath: string;
     filePath: string;
 }>;
 
+
+
 export declare function unwatchWorkspaceFile(params: WorkspaceFileWatchParams): Promise<{
     ok: true;
 }>;

package/dist/services/workspaceTaskChangeWatcher.d.ts

@@ -1,4 +1,16 @@
 
+
+
+
+
+
+
+
+
+
+
+
+
 export interface TaskContext {
     agentId: string;
     taskInstanceId: string;
@@ -20,30 +32,67 @@ export interface FileChangeRecord {
     reason: string;
 }
 
+
+
+
 export declare function setTaskContext(ctx: TaskContext): void;
 
+
+
+
 export declare function clearTaskContext(): void;
 
+
+
 export declare function getTaskContext(): TaskContext | null;
 
+
+
 export declare function hasActiveTask(): boolean;
 
+
+
+
 export declare function startWatching(targetWorkspacePath: string): Promise<void>;
 
+
+
 export declare function stopWatching(): Promise<void>;
 
+
+
 export declare function readBeforeContentFromCache(workspacePath: string, cacheKey: string): Promise<string | null>;
 
+
+
 export declare function readDiffFromCache(workspacePath: string, cacheKey: string): Promise<string | null>;
 
+
+
+
+
+
+
+
 export declare function sweepExpiredChangeCache(): Promise<void>;
 
+
+
 export declare function getPendingChangeCountForTest(): number;
 
+
+
 export declare function isWatching(): boolean;
 
+
+
 export declare function getWorkspaceRoot(): string;
 
+
+
+
+
+
 export declare function recordAgentFileChange(record: {
     filePath: string;
     operation: 'CREATE' | 'UPDATE' | 'DELETE';

package/dist/services/workspaceTaskChangeWatcher.js

@@ -1,4 +1,4 @@
-import{createHash as E}from"node:crypto";import{promises as r}from"node:fs";import c from"node:path";import X from"axios";import*as J from"diff";import{resolveSchedulerBaseUrl as V,getRuntimeHomeDir as C}from"../config.js";import{createLogger as Z}from"../utils/logger.js";import{getChangeCacheRetentionDays as $,setChangeCacheRetentionDays as q}from"./change-cache-retention.js";import{getSnapshotRetentionDays as T,setSnapshotRetentionDays as Q}from"./snapshot-retention.js";import{sweepExpiredSnapshots as Y}from"./fileSnapshotStore.js";import{getRuntimeAccessToken as L}from"./runtime-binding.js";const h=Z("workspace-task-change-watcher"),ee=10*1024*1024,te=".agentswork/change-cache",m="change-cache",ne=60*60*1e3,ae=24*60*60*1e3;let l=null,b=!1,y="",p=null;const g=new Map,d=new Map;let R=!1;function me(e){l&&l.taskNodeId!==e.taskNodeId&&z().catch(()=>{}),l=e,h.info(`Task context set: agent=${e.agentId}, taskInstance=${e.taskInstanceId}, node=${e.taskNodeId}`)}function ye(){l&&(h.info(`Task context cleared: agent=${l.agentId}`),z().catch(()=>{})),l=null}function ke(){return l}function De(){return l!==null}async function Ie(e){const t=c.resolve(e.trim());try{if(!(await r.stat(t)).isDirectory())throw new Error(`Not a directory: ${t}`)}catch{throw new Error(`Workspace path does not exist or inaccessible: ${t}`)}if(p){try{p.close()}catch{}p=null}y=t,b=!0,h.info(`Workspace path set (fs.watch disabled, using tool interception only): ${y}`)}async function Ee(){if(b=!1,p){try{p.close()}catch{}p=null}g.clear(),d.clear(),y="",h.info("Workspace watch stopped")}function F(e,t,a){return E("sha256").update(`${e||"no-task"}:${t}:${a}`,"utf-8").digest("hex").slice(0,32)}function N(e){return E("sha256").update(c.resolve(e),"utf-8").digest("hex").slice(0,16)}function k(e){return c.join(C(),".aws-bridge",m,N(e))}function oe(e){return c.join(C(),m,N(e))}function W(e){return c.join(e,te)}const j=new Set;async function _(e){if(!j.has(e)){j.add(e);try{const t=W(e),a=k(e);await r.access(t),await r.mkdir(c.dirname(a),{recursive:!0}),await r.rename(t,a),h.info(`Migrated legacy change-cache: ${t} -> ${a}`)}catch{}}}async function v(e,t,a){if(a===null)return;await _(e);const o=k(e);await r.mkdir(o,{recursive:!0});const n=c.join(o,`${t}.before`);await r.writeFile(n,a,"utf-8"),B(),h.debug(`Saved beforeContent cache: ${n}`)}async function M(e,t,a,o){const n=J.createPatch("file",a,o);await _(e);const i=k(e);await r.mkdir(i,{recursive:!0});const f=c.join(i,`${t}.diff`);await r.writeFile(f,n,"utf-8"),B(),h.debug(`Saved diff cache: ${f}`)}async function U(e,t){const a=[c.join(k(e),t),c.join(oe(e),t),c.join(W(e),t)];for(const o of a)try{return await r.readFile(o,"utf-8")}catch{}return null}async function $e(e,t){return U(e,`${t}.before`)}async function Te(e,t){return U(e,`${t}.diff`)}let x=0,S=null,A=Promise.resolve();function P(){return A=A.then(()=>ie()),A}async function ie(){const e=$();if(!(e===null||e<=0))try{const t=[c.join(C(),".aws-bridge",m),c.join(C(),m)],a=Date.now()-e*24*60*60*1e3;let o=0;for(const n of t){let i=[];try{i=(await r.readdir(n)).filter(f=>!f.startsWith("."))}catch{continue}for(const f of i){const s=c.join(n,f);try{const u=await r.readdir(s);let w=!0;for(const I of u){if(!I.endsWith(".diff")&&!I.endsWith(".before")){w=!1;continue}const H=c.join(s,I);try{(await r.stat(H)).mtimeMs<a?(await r.unlink(H),o++):w=!1}catch{w=!1}}w&&await r.rmdir(s).catch(()=>{})}catch{}}}o>0&&h.info(`Change-cache TTL sweep: removed ${o} expired file(s), retentionDays=${e}`)}catch(t){h.warn(`Change-cache TTL sweep failed: ${t.message}`)}}function B(){const e=Date.now();e-x>=ne&&(x=e,P().catch(()=>{})),S||(S=setInterval(()=>{P().catch(()=>{})},ae),S.unref?.())}async function O(e){try{return(await r.stat(e)).size>ee?null:await r.readFile(e,"utf-8")}catch{return null}}function D(e){return e===null?null:E("sha256").update(e,"utf-8").digest("hex").slice(0,16)}async function se(e){const t=g.get(e);if(!t)return;g.delete(e),t.timer&&clearTimeout(t.timer);const a=l;if(!a){if(t.operation==="DELETE")d.delete(e);else{const u=await O(e);u!==null&&d.set(e,u)}return}const o=c.relative(a.workspacePath,e).replace(/\\/g,"/");if(o.startsWith(".."))return;let n=t.beforeContent,i=null;t.operation==="DELETE"?(n=n??d.get(e)??null,i=null):(i=await O(e),t.operation==="UPDATE"&&n===null&&(n=d.get(e)??null)),t.operation==="DELETE"?d.delete(e):d.set(e,i);const f=new Date().toISOString(),s=F(a.taskInstanceId,o,f);t.operation==="UPDATE"&&n!==null&&i!==null?await M(a.workspacePath,s,n,i):t.operation==="DELETE"&&await v(a.workspacePath,s,n),await K(a,{workspacePath:a.workspacePath,filePath:o,operation:t.operation,beforeContent:n,afterContent:i,beforeHash:D(n),afterHash:D(i),timestamp:f,reason:G(t.operation,n,i)},s)}async function K(e,t,a){try{const o=V().url,n=L(o)||L();if(!n){h.warn("Cannot send change record: no auth token");return}const i=JSON.stringify({toolRecorded:!0,cacheKey:a,timestamp:t.timestamp}),s=(await X.post(`${o}/api/runtime/callback/task-file-changed`,{agentId:e.agentId,taskInstanceId:e.taskInstanceId,taskNodeId:e.taskNodeId,tenantId:e.tenantId,operation:t.operation,targetType:"FILE",targetPath:t.filePath,beforeHash:t.beforeHash,afterHash:t.afterHash,metadata:i,reason:t.reason,workspacePath:e.workspacePath},{headers:{"X-Runtime-Token":n},timeout:1e4})).data;if(s?.ignored===!0?h.warn(`Change record ignored by server: ${t.filePath} (${t.operation}), reason: ${String(s.reason??"unknown")}`):h.info(`Change record sent: ${t.filePath} (${t.operation})`),s&&s.changeCacheRetentionDays!==void 0){const u=$();q(s.changeCacheRetentionDays),u!==$()&&(x=0,P().catch(()=>{}))}if(s&&s.snapshotRetentionDays!==void 0){const u=T();Q(s.snapshotRetentionDays),u!==T()&&Y(T()).catch(()=>{})}}catch(o){h.warn(`Failed to send change record: ${o.message}`)}}async function z(){if(R)return;R=!0;const e=Array.from(g.keys());for(const t of e)try{await se(t)}catch{}R=!1}function be(){return g.size}function Re(){return b&&p!==null}function ve(){return y}function G(e,t,a){const o=t?t.split(`
+import{createHash as E}from"node:crypto";import{promises as r}from"node:fs";import c from"node:path";import X from"axios";import*as J from"diff";import{resolveSchedulerBaseUrl as V,getRuntimeHomeDir as C}from"../config.js";import{createLogger as Z}from"../utils/logger.js";import{getChangeCacheRetentionDays as $,setChangeCacheRetentionDays as q}from"./change-cache-retention.js";import{sweepExpiredSnapshots as Q}from"./fileSnapshotStore.js";import{getRuntimeAccessToken as L}from"./runtime-binding.js";import{getSnapshotRetentionDays as T,setSnapshotRetentionDays as Y}from"./snapshot-retention.js";const h=Z("workspace-task-change-watcher"),ee=10*1024*1024,te=".agentswork/change-cache",m="change-cache",ne=60*60*1e3,ae=24*60*60*1e3;let l=null,b=!1,y="",p=null;const g=new Map,d=new Map;let R=!1;function me(e){l&&l.taskNodeId!==e.taskNodeId&&z().catch(()=>{}),l=e,h.info(`Task context set: agent=${e.agentId}, taskInstance=${e.taskInstanceId}, node=${e.taskNodeId}`)}function ye(){l&&(h.info(`Task context cleared: agent=${l.agentId}`),z().catch(()=>{})),l=null}function ke(){return l}function De(){return l!==null}async function Ie(e){const t=c.resolve(e.trim());try{if(!(await r.stat(t)).isDirectory())throw new Error(`Not a directory: ${t}`)}catch{throw new Error(`Workspace path does not exist or inaccessible: ${t}`)}if(p){try{p.close()}catch{}p=null}y=t,b=!0,h.info(`Workspace path set (fs.watch disabled, using tool interception only): ${y}`)}async function Ee(){if(b=!1,p){try{p.close()}catch{}p=null}g.clear(),d.clear(),y="",h.info("Workspace watch stopped")}function F(e,t,a){return E("sha256").update(`${e||"no-task"}:${t}:${a}`,"utf-8").digest("hex").slice(0,32)}function N(e){return E("sha256").update(c.resolve(e),"utf-8").digest("hex").slice(0,16)}function k(e){return c.join(C(),".aws-bridge",m,N(e))}function oe(e){return c.join(C(),m,N(e))}function W(e){return c.join(e,te)}const j=new Set;async function _(e){if(!j.has(e)){j.add(e);try{const t=W(e),a=k(e);await r.access(t),await r.mkdir(c.dirname(a),{recursive:!0}),await r.rename(t,a),h.info(`Migrated legacy change-cache: ${t} -> ${a}`)}catch{}}}async function v(e,t,a){if(a===null)return;await _(e);const o=k(e);await r.mkdir(o,{recursive:!0});const n=c.join(o,`${t}.before`);await r.writeFile(n,a,"utf-8"),B(),h.debug(`Saved beforeContent cache: ${n}`)}async function M(e,t,a,o){const n=J.createPatch("file",a,o);await _(e);const i=k(e);await r.mkdir(i,{recursive:!0});const f=c.join(i,`${t}.diff`);await r.writeFile(f,n,"utf-8"),B(),h.debug(`Saved diff cache: ${f}`)}async function U(e,t){const a=[c.join(k(e),t),c.join(oe(e),t),c.join(W(e),t)];for(const o of a)try{return await r.readFile(o,"utf-8")}catch{}return null}async function $e(e,t){return U(e,`${t}.before`)}async function Te(e,t){return U(e,`${t}.diff`)}let x=0,S=null,A=Promise.resolve();function P(){return A=A.then(()=>ie()),A}async function ie(){const e=$();if(!(e===null||e<=0))try{const t=[c.join(C(),".aws-bridge",m),c.join(C(),m)],a=Date.now()-e*24*60*60*1e3;let o=0;for(const n of t){let i=[];try{i=(await r.readdir(n)).filter(f=>!f.startsWith("."))}catch{continue}for(const f of i){const s=c.join(n,f);try{const u=await r.readdir(s);let w=!0;for(const I of u){if(!I.endsWith(".diff")&&!I.endsWith(".before")){w=!1;continue}const H=c.join(s,I);try{(await r.stat(H)).mtimeMs<a?(await r.unlink(H),o++):w=!1}catch{w=!1}}w&&await r.rmdir(s).catch(()=>{})}catch{}}}o>0&&h.info(`Change-cache TTL sweep: removed ${o} expired file(s), retentionDays=${e}`)}catch(t){h.warn(`Change-cache TTL sweep failed: ${t.message}`)}}function B(){const e=Date.now();e-x>=ne&&(x=e,P().catch(()=>{})),S||(S=setInterval(()=>{P().catch(()=>{})},ae),S.unref?.())}async function O(e){try{return(await r.stat(e)).size>ee?null:await r.readFile(e,"utf-8")}catch{return null}}function D(e){return e===null?null:E("sha256").update(e,"utf-8").digest("hex").slice(0,16)}async function se(e){const t=g.get(e);if(!t)return;g.delete(e),t.timer&&clearTimeout(t.timer);const a=l;if(!a){if(t.operation==="DELETE")d.delete(e);else{const u=await O(e);u!==null&&d.set(e,u)}return}const o=c.relative(a.workspacePath,e).replace(/\\/g,"/");if(o.startsWith(".."))return;let n=t.beforeContent,i=null;t.operation==="DELETE"?(n=n??d.get(e)??null,i=null):(i=await O(e),t.operation==="UPDATE"&&n===null&&(n=d.get(e)??null)),t.operation==="DELETE"?d.delete(e):d.set(e,i);const f=new Date().toISOString(),s=F(a.taskInstanceId,o,f);t.operation==="UPDATE"&&n!==null&&i!==null?await M(a.workspacePath,s,n,i):t.operation==="DELETE"&&await v(a.workspacePath,s,n),await K(a,{workspacePath:a.workspacePath,filePath:o,operation:t.operation,beforeContent:n,afterContent:i,beforeHash:D(n),afterHash:D(i),timestamp:f,reason:G(t.operation,n,i)},s)}async function K(e,t,a){try{const o=V().url,n=L(o)||L();if(!n){h.warn("Cannot send change record: no auth token");return}const i=JSON.stringify({toolRecorded:!0,cacheKey:a,timestamp:t.timestamp}),s=(await X.post(`${o}/api/runtime/callback/task-file-changed`,{agentId:e.agentId,taskInstanceId:e.taskInstanceId,taskNodeId:e.taskNodeId,tenantId:e.tenantId,operation:t.operation,targetType:"FILE",targetPath:t.filePath,beforeHash:t.beforeHash,afterHash:t.afterHash,metadata:i,reason:t.reason,workspacePath:e.workspacePath},{headers:{"X-Runtime-Token":n},timeout:1e4})).data;if(s?.ignored===!0?h.warn(`Change record ignored by server: ${t.filePath} (${t.operation}), reason: ${String(s.reason??"unknown")}`):h.info(`Change record sent: ${t.filePath} (${t.operation})`),s&&s.changeCacheRetentionDays!==void 0){const u=$();q(s.changeCacheRetentionDays),u!==$()&&(x=0,P().catch(()=>{}))}if(s&&s.snapshotRetentionDays!==void 0){const u=T();Y(s.snapshotRetentionDays),u!==T()&&Q(T()).catch(()=>{})}}catch(o){h.warn(`Failed to send change record: ${o.message}`)}}async function z(){if(R)return;R=!0;const e=Array.from(g.keys());for(const t of e)try{await se(t)}catch{}R=!1}function be(){return g.size}function Re(){return b&&p!==null}function ve(){return y}function G(e,t,a){const o=t?t.split(`
 `).length:0,n=a?a.split(`
 `).length:0;if(e==="CREATE")return`\u521B\u5EFA\u6587\u4EF6\uFF0C\u5171 ${n} \u884C`;if(e==="DELETE")return`\u5220\u9664\u6587\u4EF6\uFF0C\u539F ${o} \u884C`;if(o===n)return`\u4FEE\u6539\u6587\u4EF6\uFF08\u884C\u6570\u4E0D\u53D8\uFF0C${n} \u884C\uFF09`;const i=n-o;return`\u4FEE\u6539\u6587\u4EF6\uFF1A${o} \u884C -> ${n} \u884C\uFF08${i>0?"+":""}${i} \u884C\uFF09`}async function xe(e){const t=l,a=e.agentId||t?.agentId,o=e.workspacePath||t?.workspacePath;if(!a||!o){h.warn(`Agent file change skipped (no identity): ${e.filePath} (${e.operation})`);return}h.info(`Recording agent file change: ${e.filePath} (${e.operation}), taskNode=${t?.taskNodeId??"(no task)"}`);const n=t??{agentId:a,taskInstanceId:"",taskNodeId:"",tenantId:"",workspacePath:o,projectId:""},i=new Date().toISOString(),f=F(n.taskInstanceId,e.filePath,i);e.operation==="UPDATE"&&e.beforeContent!==null&&e.afterContent!==null?(await M(n.workspacePath,f,e.beforeContent,e.afterContent),await v(n.workspacePath,f,e.beforeContent)):e.operation==="DELETE"&&await v(n.workspacePath,f,e.beforeContent);const s=e.reason?.trim()||G(e.operation,e.beforeContent,e.afterContent);await K(n,{workspacePath:n.workspacePath,filePath:e.filePath,operation:e.operation,beforeContent:e.beforeContent,afterContent:e.afterContent,beforeHash:D(e.beforeContent),afterHash:D(e.afterContent),timestamp:i,reason:s},f)}export{ye as clearTaskContext,be as getPendingChangeCountForTest,ke as getTaskContext,ve as getWorkspaceRoot,De as hasActiveTask,Re as isWatching,$e as readBeforeContentFromCache,Te as readDiffFromCache,xe as recordAgentFileChange,me as setTaskContext,Ie as startWatching,Ee as stopWatching,P as sweepExpiredChangeCache};
 

package/dist/types.d.ts

@@ -1,5 +1,8 @@
 import type { Request, Response, NextFunction } from 'express';
 
+
+
+
 export interface CreateMcpServerInput {
     name: string;
     server: McpServerConfig;
@@ -7,6 +10,9 @@ export interface CreateMcpServerInput {
     apps?: Partial<SdkApps>;
 }
 
+
+
+
 export interface UpdateMcpServerInput {
     name?: string;
     server?: McpServerConfig;
@@ -50,6 +56,9 @@ export interface McpPayload {
     
     description?: string;
     
+
+
+
     packageUrl?: string;
     
     packageSha256?: string;

package/dist/utils/config-write-queue.d.ts

@@ -1,3 +1,14 @@
 
 
+
+
+
+
+
+
+
+
+
+
+
 export declare function runExclusiveConfigWrite<T>(filePath: string, task: () => T | Promise<T>): Promise<T>;

package/dist/utils/env-safety.d.ts

@@ -1,8 +1,20 @@
 
+
+
+
+
+
+
+
+
 export declare const BLOCKED_ENV_KEYS: ReadonlySet<string>;
 
 export declare const ENV_KEY_PATTERN: RegExp;
 
+
+
+
+
 export declare const SPAWN_ENV_KEY_PATTERN: RegExp;
 
 export interface RejectedEnvKey {
@@ -10,6 +22,15 @@ export interface RejectedEnvKey {
     reason: "blocked" | "invalid-name" | "empty-value";
 }
 
+
+
+
+
+
+
+
+
+
 export declare function sanitizeEnvForChild(env: unknown, options?: {
     onReject?: (item: RejectedEnvKey) => void;
 }): Record<string, string>;

package/dist/utils/file-utils.d.ts

@@ -3,11 +3,23 @@ export declare function ensureDir(targetDir: string): Promise<string>;
 export declare function withFileLock<T>(targetPath: string, operation: () => Promise<T>): Promise<T>;
 export declare function stringifyStableJson(value: unknown): string;
 
+
+
+
+
+
+
 export declare function sanitizeAgentId(agentId: string): string;
 
+
+
+
 export declare function sanitizeArchiveFileName(fileName: string, fallback: string): string;
 export declare function atomicWriteFile(targetPath: string, content: string): Promise<void>;
 
+
+
+
 export declare function renameFileWithRetry(fromPath: string, toPath: string, attempts?: number): Promise<void>;
 
 export declare function atomicWriteFileSync(targetPath: string, content: string): void;
@@ -16,6 +28,9 @@ export declare function downloadSkillZip(skillPackage: SkillPackage, targetDir:
 export declare function runCommand(command: string, args: string[]): Promise<void>;
 export declare function escapePowerShellLiteral(text: string): string;
 
+
+
+
 export declare function extractSkillZip(zipFilePath: string, extractRootDir: string): Promise<void>;
 export declare function resolveSkillSourceDirFromExtractRoot(extractRootDir: string): Promise<string>;
 export declare function downloadPluginZip(pluginPackage: PluginPackage, targetDir: string): Promise<DownloadResult | null>;

package/dist/utils/instance-ai-config-debug-logger.d.ts

@@ -1,4 +1,9 @@
 
+
+
+
+
+
 export interface DebugLogEntry {
     level: "info" | "warn" | "error";
     category: string;
@@ -9,13 +14,23 @@ export interface DebugLogEntry {
     details?: Record<string, unknown>;
 }
 
+
+
+
 export declare class InstanceAiConfigDebugLogger {
     private readonly logPath;
     constructor(logPath?: string);
     
+
+
+
     log(entry: DebugLogEntry): Promise<void>;
     
+
+
     flush(): Promise<void>;
 }
 
+
+
 export declare function getInstanceAiConfigDebugLogger(): InstanceAiConfigDebugLogger;

package/dist/utils/lifecycle-log.d.ts

@@ -1,4 +1,9 @@
 
 export declare function flushLifecycleLogForTest(): Promise<void>;
 
+
+
+
+
+
 export declare function recordLifecycleEvent(event: string, fields: Record<string, unknown>): void;

package/dist/utils/logger.d.ts

@@ -1,8 +1,17 @@
 
+
+
+
+
+
 export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
 
 export declare function pushLog(level: LogLevel, prefix: string, message: string): void;
 
+
+
+
+
 export declare function getRecentLogs(maxCount?: number, filterLevel?: LogLevel): Array<{
     level: LogLevel;
     timestamp: string;
@@ -19,6 +28,8 @@ export interface LogConfig {
     timestamp?: boolean;
 }
 
+
+
 export declare class Logger {
     private readonly level;
     private readonly prefix;
@@ -31,6 +42,8 @@ export declare class Logger {
     warn(...args: unknown[]): void;
     error(...args: unknown[]): void;
     
+
+
     child(prefix: string): Logger;
 }
 export declare const logger: {

package/dist/utils/logger.js

@@ -1,2 +1,3 @@
-const g=500,s=[];let u=!0;function f(t,e,r){u&&(s.push({level:t,timestamp:new Date().toISOString(),prefix:e,message:r}),s.length>500&&s.splice(0,s.length-500))}function m(t=200,e){let r=s;if(e){const o=["debug","info","warn","error"],p=o.indexOf(e);r=r.filter(c=>o.indexOf(c.level)>=p)}return r.slice(-t).reverse()}function d(t){u=t}function L(){s.length=0}const h={debug:0,info:1,warn:2,error:3};function a(){return new Date().toISOString()}function n(t){return t.map(e=>{if(typeof e=="object"&&e!==null)try{return JSON.stringify(e,null,2)}catch{return String(e)}return String(e)}).join(" ")}class l{constructor(e={level:"info"}){this.level=e.level,this.prefix=e.prefix||"",this.timestamp=e.timestamp??!0}shouldLog(e){return h[e]>=h[this.level]}formatMessage(e,r){const o=[];return this.timestamp&&o.push(`[${a()}]`),o.push(`[${e.toUpperCase()}]`),this.prefix&&o.push(`[${this.prefix}]`),o.push(n(r)),o.join(" ")}debug(...e){if(this.shouldLog("debug")){const r=this.formatMessage("debug",e);console.debug(r),f("debug",this.prefix,n(e))}}info(...e){if(this.shouldLog("info")){const r=this.formatMessage("info",e);console.info(r),f("info",this.prefix,n(e))}}warn(...e){if(this.shouldLog("warn")){const r=this.formatMessage("warn",e);console.warn(r),f("warn",this.prefix,n(e))}}error(...e){if(this.shouldLog("error")){const r=this.formatMessage("error",e);console.error(r),f("error",this.prefix,n(e))}}child(e){return new l({level:this.level,prefix:this.prefix?`${this.prefix}:${e}`:e,timestamp:this.timestamp})}}const i=new l({level:process.env.LOG_LEVEL||"info"}),x={debug:(...t)=>i.debug(...t),info:(...t)=>i.info(...t),warn:(...t)=>i.warn(...t),error:(...t)=>i.error(...t),child:t=>i.child(t)};function w(t,e){return new l({level:e?.level||process.env.LOG_LEVEL||"info",prefix:t,timestamp:e?.timestamp})}export{l as Logger,L as clearLogBuffer,w as createLogger,m as getRecentLogs,x as logger,f as pushLog,d as setLogBufferEnabled};
+const m=500,s=[];let u=!0;function f(t,e,r){u&&(s.push({level:t,timestamp:new Date().toISOString(),prefix:e,message:r}),s.length>500&&s.splice(0,s.length-500))}function g(t=200,e){let r=s;if(e){const o=["debug","info","warn","error"],h=o.indexOf(e);r=r.filter(p=>o.indexOf(p.level)>=h)}return r.slice(-t).reverse()}function d(t){u=t}function L(){s.length=0}const c={debug:0,info:1,warn:2,error:3};function a(){return new Date().toISOString()}function n(t){return t.map(e=>{if(e instanceof Error){const r=e.code,o=`${e.name||"Error"}${r?` [${r}]`:""}: ${e.message}`;return e.stack?`${o}
+${e.stack}`:o}if(typeof e=="object"&&e!==null)try{return JSON.stringify(e,null,2)}catch{return String(e)}return String(e)}).join(" ")}class l{constructor(e={level:"info"}){this.level=e.level,this.prefix=e.prefix||"",this.timestamp=e.timestamp??!0}shouldLog(e){return c[e]>=c[this.level]}formatMessage(e,r){const o=[];return this.timestamp&&o.push(`[${a()}]`),o.push(`[${e.toUpperCase()}]`),this.prefix&&o.push(`[${this.prefix}]`),o.push(n(r)),o.join(" ")}debug(...e){if(this.shouldLog("debug")){const r=this.formatMessage("debug",e);console.debug(r),f("debug",this.prefix,n(e))}}info(...e){if(this.shouldLog("info")){const r=this.formatMessage("info",e);console.info(r),f("info",this.prefix,n(e))}}warn(...e){if(this.shouldLog("warn")){const r=this.formatMessage("warn",e);console.warn(r),f("warn",this.prefix,n(e))}}error(...e){if(this.shouldLog("error")){const r=this.formatMessage("error",e);console.error(r),f("error",this.prefix,n(e))}}child(e){return new l({level:this.level,prefix:this.prefix?`${this.prefix}:${e}`:e,timestamp:this.timestamp})}}const i=new l({level:process.env.LOG_LEVEL||"info"}),x={debug:(...t)=>i.debug(...t),info:(...t)=>i.info(...t),warn:(...t)=>i.warn(...t),error:(...t)=>i.error(...t),child:t=>i.child(t)};function E(t,e){return new l({level:e?.level||process.env.LOG_LEVEL||"info",prefix:t,timestamp:e?.timestamp})}export{l as Logger,L as clearLogBuffer,E as createLogger,g as getRecentLogs,x as logger,f as pushLog,d as setLogBufferEnabled};
 

package/dist/utils/npm-version.d.ts

@@ -1,8 +1,18 @@
 
+
+
+
+
 export declare function compareVersions(a: string, b: string): number;
 
+
+
+
 export declare function fetchLatestNpmVersion(): Promise<string>;
 
+
+
+
 export declare function checkBridgeUpdate(): Promise<{
     ok: boolean;
     hasUpdate: boolean;

package/dist/utils/path-utils.d.ts

@@ -1,5 +1,11 @@
 
 
+
+
+
+
+
+
 export interface PropertiesPathResult {
     normalizedWorkspace: string;
     resolvedTarget: string;
@@ -8,4 +14,10 @@ export declare function resolveWorkspaceRoot(workspacePath: string | unknown): s
 export declare function ensureInsideWorkspace(workspaceRoot: string, targetPath: string): string;
 export declare function resolveWorkspaceFilePath(workspacePath: string | unknown, relativeOrAbsolutePath: string | unknown, defaultRelativePath: string): PropertiesPathResult;
 
+
+
+
+
+
+
 export declare function resolvePropertiesTargetPath(workspacePath: string | unknown, relativeOrAbsolutePath: string | unknown): PropertiesPathResult;

package/dist/utils/scheduler-url.d.ts

@@ -0,0 +1,18 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+export declare function normalizeSchedulerUrl(value: unknown): string | undefined;

package/dist/utils/scheduler-url.js

@@ -0,0 +1,2 @@
+function n(t){return t.replace(/^((?:https?|wss?):\/\/(?:\[[^\]]+\]|[^/:?#]+):\d+):\d+(?=\/|$)/i,"$1")}function c(t){const r=t.toLowerCase();return r==="localhost"||r==="::1"||r==="[::1]"?"127.0.0.1":r}function i(t){const r=String(t??"").trim();if(!r)return;const e=n(r);try{const o=new URL(e);return o.protocol==="ws:"?o.protocol="http:":o.protocol==="wss:"?o.protocol="https:":o.protocol=o.protocol.toLowerCase(),o.hostname=c(o.hostname),o.origin}catch{return e.replace(/\/+$/,"")}}export{i as normalizeSchedulerUrl};
+