@lingxiao-office/sdk 1.0.0

package/dist/core/AstStructuralEngine.d.ts

@@ -0,0 +1,91 @@
+export type AstDefinitionKind = 'function' | 'class' | 'interface' | 'type' | 'enum' | 'variable' | 'method' | 'property' | 'constructor' | 'parameter' | 'unknown';
+export interface AstLocation {
+    file: string;
+    line: number;
+    column: number;
+    start: number;
+    end: number;
+}
+export interface AstSymbolSummary {
+    name: string;
+    kind: AstDefinitionKind;
+    exported: boolean;
+    location: AstLocation;
+    container?: string;
+}
+export interface AstReference {
+    name: string;
+    kind: AstDefinitionKind;
+    location: AstLocation;
+    isDefinition: boolean;
+    container?: string;
+}
+export interface AstCallGraphEdge {
+    caller: AstSymbolSummary;
+    callee: AstSymbolSummary;
+    depth: number;
+    location: AstLocation;
+}
+export interface AstStructuralEngineOptions {
+    projectRoot: string;
+    sourceDirs?: string[];
+    extensions?: string[];
+    excludeDirs?: string[];
+}
+export interface AstPatternQuery {
+    namePattern?: string;
+    kinds?: AstDefinitionKind[];
+    file?: string;
+    limit?: number;
+}
+export declare class AstStructuralEngine {
+    private readonly projectRoot;
+    private readonly sourceDirs;
+    private readonly extensions;
+    private readonly excludeDirs;
+    private cachedProject;
+    private cachedDefinitions;
+    private cachedSourceFiles;
+    constructor(options: AstStructuralEngineOptions);
+    getSourceFiles(): string[];
+    findDefinitions(symbolName?: string, options?: {
+        file?: string;
+        exportedOnly?: boolean;
+        limit?: number;
+    }): AstSymbolSummary[];
+    findReferences(symbolName: string, options?: {
+        file?: string;
+        limit?: number;
+    }): AstReference[];
+    getPublicApi(options?: {
+        file?: string;
+        limit?: number;
+    }): AstSymbolSummary[];
+    searchPattern(query: AstPatternQuery): AstSymbolSummary[];
+    findImplementors(symbolName: string, options?: {
+        limit?: number;
+    }): AstSymbolSummary[];
+    getCallGraph(options?: {
+        symbolName?: string;
+        maxDepth?: number;
+        limit?: number;
+    }): AstCallGraphEdge[];
+    private collectDirectCallEdges;
+    private enclosingCallableDefinition;
+    private collectDefinitions;
+    private shouldIncludeDefinition;
+    private summaryForNode;
+    private isExported;
+    private exportNames;
+    private buildProject;
+    private collectSourceFiles;
+    private walk;
+    private projectSourceFiles;
+    private isProjectFile;
+    private normalizeInputFile;
+    private relativeFile;
+    private location;
+    private symbolKeyAt;
+}
+export declare function readAstSourcePreview(projectRoot: string, location: AstLocation, maxChars?: number): string;
+//# sourceMappingURL=AstStructuralEngine.d.ts.map

package/dist/core/AstStructuralEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AstStructuralEngine.d.ts","sourceRoot":"","sources":["../../src/core/AstStructuralEngine.ts"],"names":[],"mappings":"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"}

package/dist/core/AstStructuralEngine.js

@@ -0,0 +1,436 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { extname, isAbsolute, join, relative, resolve } from 'node:path';
+import ts from 'typescript';
+const DEFAULT_SOURCE_DIRS = ['src'];
+const DEFAULT_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx', '.mts', '.mjs'];
+const DEFAULT_EXCLUDE_DIRS = ['node_modules', 'dist', '.git', 'coverage', '__pycache__'];
+function unixPath(path) {
+    return path.replaceAll('\\', '/');
+}
+function uniqueByLocation(values) {
+    const seen = new Set();
+    const out = [];
+    for (const value of values) {
+        const key = `${value.location.file}:${value.location.start}:${value.location.end}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        out.push(value);
+    }
+    return out;
+}
+function hasModifier(node, kind) {
+    return Boolean(ts.canHaveModifiers(node) && ts.getModifiers(node)?.some((modifier) => modifier.kind === kind));
+}
+function declarationKind(node) {
+    if (ts.isFunctionDeclaration(node))
+        return 'function';
+    if (ts.isClassDeclaration(node))
+        return 'class';
+    if (ts.isInterfaceDeclaration(node))
+        return 'interface';
+    if (ts.isTypeAliasDeclaration(node))
+        return 'type';
+    if (ts.isEnumDeclaration(node))
+        return 'enum';
+    if (ts.isVariableDeclaration(node))
+        return 'variable';
+    if (ts.isMethodDeclaration(node) || ts.isMethodSignature(node))
+        return 'method';
+    if (ts.isPropertyDeclaration(node) || ts.isPropertySignature(node))
+        return 'property';
+    if (ts.isConstructorDeclaration(node))
+        return 'constructor';
+    if (ts.isParameter(node))
+        return 'parameter';
+    return null;
+}
+function getDeclarationNameNode(node) {
+    if (ts.isConstructorDeclaration(node)) {
+        const parent = node.parent;
+        return ts.isClassDeclaration(parent) && parent.name ? parent.name : null;
+    }
+    if (!('name' in node))
+        return null;
+    const name = node.name;
+    return name && ts.isIdentifier(name) ? name : null;
+}
+function getContainerName(node) {
+    let current = node.parent;
+    while (current) {
+        const name = getDeclarationNameNode(current);
+        const kind = declarationKind(current);
+        if (name && kind && kind !== 'parameter')
+            return name.text;
+        current = current.parent;
+    }
+    return undefined;
+}
+function isDefinitionIdentifier(node) {
+    return getDeclarationNameNode(node.parent) === node;
+}
+function compilerOptions() {
+    return {
+        allowJs: true,
+        checkJs: false,
+        jsx: ts.JsxEmit.ReactJSX,
+        target: ts.ScriptTarget.ES2022,
+        module: ts.ModuleKind.ESNext,
+        moduleResolution: ts.ModuleResolutionKind.Bundler,
+        noEmit: true,
+        skipLibCheck: true,
+    };
+}
+export class AstStructuralEngine {
+    projectRoot;
+    sourceDirs;
+    extensions;
+    excludeDirs;
+    cachedProject = null;
+    cachedDefinitions = null;
+    cachedSourceFiles = null;
+    constructor(options) {
+        this.projectRoot = resolve(options.projectRoot);
+        this.sourceDirs = options.sourceDirs ?? DEFAULT_SOURCE_DIRS;
+        this.extensions = new Set(options.extensions ?? DEFAULT_EXTENSIONS);
+        this.excludeDirs = new Set(options.excludeDirs ?? DEFAULT_EXCLUDE_DIRS);
+    }
+    getSourceFiles() {
+        return this.collectSourceFiles();
+    }
+    findDefinitions(symbolName, options = {}) {
+        const ast = this.buildProject();
+        const definitions = this.collectDefinitions(ast);
+        return definitions
+            .map((definition) => definition.summary)
+            .filter((definition) => !symbolName || definition.name === symbolName)
+            .filter((definition) => !options.file || definition.location.file === this.normalizeInputFile(options.file))
+            .filter((definition) => !options.exportedOnly || definition.exported)
+            .slice(0, options.limit ?? 200);
+    }
+    findReferences(symbolName, options = {}) {
+        const ast = this.buildProject();
+        const definitions = this.collectDefinitions(ast).filter((definition) => definition.summary.name === symbolName);
+        const targetKeys = new Set(definitions.map((definition) => definition.symbolKey).filter((key) => Boolean(key)));
+        if (targetKeys.size === 0)
+            return [];
+        const references = [];
+        for (const sourceFile of this.projectSourceFiles(ast.program)) {
+            if (options.file && this.relativeFile(sourceFile.fileName) !== this.normalizeInputFile(options.file))
+                continue;
+            const visit = (node) => {
+                if (ts.isIdentifier(node)) {
+                    const key = this.symbolKeyAt(ast.checker, node);
+                    if (key && targetKeys.has(key)) {
+                        references.push({
+                            name: node.text,
+                            kind: declarationKind(node.parent) ?? 'unknown',
+                            location: this.location(sourceFile, node),
+                            isDefinition: isDefinitionIdentifier(node),
+                            container: getContainerName(node),
+                        });
+                    }
+                }
+                ts.forEachChild(node, visit);
+            };
+            ts.forEachChild(sourceFile, visit);
+        }
+        return uniqueByLocation(references).slice(0, options.limit ?? 500);
+    }
+    getPublicApi(options = {}) {
+        return this.findDefinitions(undefined, {
+            file: options.file,
+            exportedOnly: true,
+            limit: options.limit ?? 300,
+        });
+    }
+    searchPattern(query) {
+        const pattern = query.namePattern ? new RegExp(query.namePattern) : null;
+        const kindSet = query.kinds ? new Set(query.kinds) : null;
+        return this.findDefinitions(undefined, { file: query.file, limit: Number.MAX_SAFE_INTEGER })
+            .filter((definition) => !pattern || pattern.test(definition.name))
+            .filter((definition) => !kindSet || kindSet.has(definition.kind))
+            .slice(0, query.limit ?? 200);
+    }
+    findImplementors(symbolName, options = {}) {
+        const ast = this.buildProject();
+        const definitions = this.collectDefinitions(ast);
+        const targetKeys = new Set(definitions
+            .filter((definition) => definition.summary.name === symbolName && ['class', 'interface'].includes(definition.summary.kind))
+            .map((definition) => definition.symbolKey)
+            .filter((key) => Boolean(key)));
+        if (targetKeys.size === 0)
+            return [];
+        const implementors = [];
+        for (const definition of definitions) {
+            if (!ts.isClassDeclaration(definition.node) && !ts.isInterfaceDeclaration(definition.node))
+                continue;
+            const clauses = definition.node.heritageClauses ?? [];
+            for (const clause of clauses) {
+                for (const typeNode of clause.types) {
+                    const key = this.symbolKeyAt(ast.checker, typeNode.expression);
+                    if (key && targetKeys.has(key)) {
+                        implementors.push(definition.summary);
+                    }
+                }
+            }
+        }
+        return uniqueByLocation(implementors).slice(0, options.limit ?? 100);
+    }
+    getCallGraph(options = {}) {
+        const ast = this.buildProject();
+        const definitions = this.collectDefinitions(ast);
+        const definitionsByKey = new Map();
+        const keyBySummary = new Map();
+        for (const definition of definitions) {
+            if (definition.symbolKey) {
+                definitionsByKey.set(definition.symbolKey, definition);
+                keyBySummary.set(definition.summary, definition.symbolKey);
+            }
+        }
+        const directEdges = this.collectDirectCallEdges(ast, definitionsByKey);
+        const limit = options.limit ?? 300;
+        if (!options.symbolName)
+            return directEdges.slice(0, limit);
+        const startKeys = new Set(definitions
+            .filter((definition) => definition.summary.name === options.symbolName)
+            .map((definition) => definition.symbolKey)
+            .filter((key) => Boolean(key)));
+        if (startKeys.size === 0)
+            return [];
+        const maxDepth = Math.max(1, Math.min(options.maxDepth ?? 2, 8));
+        const adjacency = new Map();
+        for (const edge of directEdges) {
+            const callerKey = keyBySummary.get(edge.caller);
+            const calleeKey = keyBySummary.get(edge.callee);
+            if (!callerKey || !calleeKey)
+                continue;
+            const list = adjacency.get(callerKey) ?? [];
+            list.push({ calleeKey, edge });
+            adjacency.set(callerKey, list);
+        }
+        const out = [];
+        const queue = [...startKeys].map((key) => ({ key, depth: 0 }));
+        const visited = new Set();
+        while (queue.length > 0 && out.length < limit) {
+            const current = queue.shift();
+            if (current.depth >= maxDepth)
+                continue;
+            const next = adjacency.get(current.key) ?? [];
+            for (const item of next) {
+                const depth = current.depth + 1;
+                const edgeKey = `${current.key}->${item.calleeKey}:${item.edge.location.start}`;
+                if (visited.has(edgeKey))
+                    continue;
+                visited.add(edgeKey);
+                out.push({ ...item.edge, depth });
+                queue.push({ key: item.calleeKey, depth });
+            }
+        }
+        return out;
+    }
+    collectDirectCallEdges(ast, definitionsByKey) {
+        const out = [];
+        for (const sourceFile of this.projectSourceFiles(ast.program)) {
+            const visit = (node) => {
+                if (ts.isCallExpression(node)) {
+                    const caller = this.enclosingCallableDefinition(ast.checker, node, definitionsByKey);
+                    const calleeKey = this.symbolKeyAt(ast.checker, node.expression);
+                    const callee = calleeKey ? definitionsByKey.get(calleeKey) : undefined;
+                    if (caller && callee) {
+                        out.push({
+                            caller: caller.summary,
+                            callee: callee.summary,
+                            depth: 1,
+                            location: this.location(sourceFile, node.expression),
+                        });
+                    }
+                }
+                ts.forEachChild(node, visit);
+            };
+            ts.forEachChild(sourceFile, visit);
+        }
+        return out;
+    }
+    enclosingCallableDefinition(checker, node, definitionsByKey) {
+        let current = node.parent;
+        while (current) {
+            const nameNode = getDeclarationNameNode(current);
+            if (nameNode) {
+                const kind = declarationKind(current);
+                if (kind && ['function', 'method', 'constructor', 'variable'].includes(kind)) {
+                    const key = this.symbolKeyAt(checker, nameNode);
+                    if (key && definitionsByKey.has(key))
+                        return definitionsByKey.get(key);
+                }
+            }
+            current = current.parent;
+        }
+        return null;
+    }
+    collectDefinitions(ast) {
+        if (this.cachedDefinitions)
+            return this.cachedDefinitions;
+        const out = [];
+        const exportNamesByFile = new Map();
+        for (const sourceFile of this.projectSourceFiles(ast.program)) {
+            exportNamesByFile.set(this.relativeFile(sourceFile.fileName), this.exportNames(ast.checker, sourceFile));
+            const visit = (node) => {
+                const kind = declarationKind(node);
+                const nameNode = kind ? getDeclarationNameNode(node) : null;
+                if (kind && nameNode && this.shouldIncludeDefinition(node, kind)) {
+                    const summary = this.summaryForNode(ast.checker, sourceFile, node, nameNode, kind, exportNamesByFile.get(this.relativeFile(sourceFile.fileName)) ?? new Set());
+                    out.push({
+                        node,
+                        nameNode,
+                        summary,
+                        symbolKey: this.symbolKeyAt(ast.checker, nameNode),
+                    });
+                }
+                ts.forEachChild(node, visit);
+            };
+            ts.forEachChild(sourceFile, visit);
+        }
+        this.cachedDefinitions = out;
+        return out;
+    }
+    shouldIncludeDefinition(node, kind) {
+        if (kind === 'parameter')
+            return false;
+        if (kind === 'property' && ts.isPropertySignature(node))
+            return true;
+        if (kind === 'method' && ts.isMethodSignature(node))
+            return true;
+        if (ts.isVariableDeclaration(node)) {
+            return ts.isIdentifier(node.name);
+        }
+        return true;
+    }
+    summaryForNode(checker, sourceFile, node, nameNode, kind, exportNames) {
+        const symbolName = nameNode.text;
+        return {
+            name: kind === 'constructor' ? 'constructor' : symbolName,
+            kind,
+            exported: this.isExported(checker, node, nameNode, exportNames),
+            location: this.location(sourceFile, nameNode),
+            container: getContainerName(node),
+        };
+    }
+    isExported(checker, node, nameNode, exportNames) {
+        if (hasModifier(node, ts.SyntaxKind.ExportKeyword))
+            return true;
+        if (ts.isVariableDeclaration(node) && ts.isVariableDeclarationList(node.parent)) {
+            const statement = node.parent.parent;
+            if (statement && hasModifier(statement, ts.SyntaxKind.ExportKeyword))
+                return true;
+        }
+        const symbol = checker.getSymbolAtLocation(nameNode);
+        const rawName = symbol?.getName() ?? nameNode.text;
+        return exportNames.has(rawName) || exportNames.has(nameNode.text);
+    }
+    exportNames(checker, sourceFile) {
+        const symbol = checker.getSymbolAtLocation(sourceFile);
+        if (!symbol)
+            return new Set();
+        return new Set(checker.getExportsOfModule(symbol).map((item) => item.getName()));
+    }
+    buildProject() {
+        if (this.cachedProject)
+            return this.cachedProject;
+        const files = this.collectSourceFiles();
+        const program = ts.createProgram(files.map((file) => join(this.projectRoot, file)), compilerOptions());
+        this.cachedProject = { program, checker: program.getTypeChecker(), files };
+        return this.cachedProject;
+    }
+    collectSourceFiles() {
+        if (this.cachedSourceFiles)
+            return this.cachedSourceFiles;
+        const out = [];
+        for (const dir of this.sourceDirs) {
+            const abs = join(this.projectRoot, dir);
+            if (existsSync(abs))
+                this.walk(abs, out);
+        }
+        this.cachedSourceFiles = out.map((file) => unixPath(relative(this.projectRoot, file))).sort();
+        return this.cachedSourceFiles;
+    }
+    walk(dir, out) {
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch { /* expected: non-critical failure */
+            return;
+        }
+        for (const entry of entries) {
+            if (this.excludeDirs.has(entry))
+                continue;
+            const full = join(dir, entry);
+            let stat;
+            try {
+                stat = statSync(full);
+            }
+            catch { /* expected: skip invalid entry */
+                continue;
+            }
+            if (stat.isDirectory()) {
+                this.walk(full, out);
+            }
+            else if (this.extensions.has(extname(entry))) {
+                out.push(full);
+            }
+        }
+    }
+    projectSourceFiles(program) {
+        return program.getSourceFiles()
+            .filter((file) => !file.isDeclarationFile)
+            .filter((file) => this.isProjectFile(file.fileName));
+    }
+    isProjectFile(file) {
+        const rel = unixPath(relative(this.projectRoot, file));
+        return Boolean(rel && !rel.startsWith('..') && !isAbsolute(rel));
+    }
+    normalizeInputFile(file) {
+        return unixPath(isAbsolute(file) ? relative(this.projectRoot, file) : file);
+    }
+    relativeFile(file) {
+        return unixPath(relative(this.projectRoot, file));
+    }
+    location(sourceFile, node) {
+        const start = node.getStart(sourceFile);
+        const end = node.getEnd();
+        const pos = sourceFile.getLineAndCharacterOfPosition(start);
+        return {
+            file: this.relativeFile(sourceFile.fileName),
+            line: pos.line + 1,
+            column: pos.character + 1,
+            start,
+            end,
+        };
+    }
+    symbolKeyAt(checker, node) {
+        let symbol = checker.getSymbolAtLocation(node);
+        if (!symbol)
+            return undefined;
+        if (symbol.flags & ts.SymbolFlags.Alias) {
+            symbol = checker.getAliasedSymbol(symbol);
+        }
+        const declarations = symbol.getDeclarations() ?? [];
+        const declaration = declarations.find((item) => this.isProjectFile(item.getSourceFile().fileName)) ?? declarations[0];
+        if (!declaration)
+            return `${checker.getFullyQualifiedName(symbol)}:${symbol.getName()}`;
+        const sourceFile = declaration.getSourceFile();
+        return `${this.relativeFile(sourceFile.fileName)}:${declaration.getStart(sourceFile)}:${symbol.getName()}`;
+    }
+}
+export function readAstSourcePreview(projectRoot, location, maxChars = 240) {
+    const file = join(projectRoot, location.file);
+    try {
+        const content = readFileSync(file, 'utf8');
+        return content.slice(location.start, Math.min(location.end, location.start + maxChars));
+    }
+    catch { /* expected: fallback to default */
+        return '';
+    }
+}
+//# sourceMappingURL=AstStructuralEngine.js.map

package/dist/core/AstStructuralEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AstStructuralEngine.js","sourceRoot":"","sources":["../../src/core/AstStructuralEngine.ts"],"names":[],"mappings":"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"}

package/dist/core/AutonomousFaultPolicy.d.ts

@@ -0,0 +1,17 @@
+import type { LLMErrorKind } from '../llm/errors.js';
+import type { RecoveryFaultClass } from './RecoveryRecords.js';
+export type AutonomousFaultCategory = 'internal_recoverable' | 'external_retryable' | 'external_blocking';
+export type AutonomousRecoveryAction = 'leader_takeover' | 'worker_restart' | 'worker_redispatch' | 'waiting_external';
+export interface AutonomousFaultDecision {
+    category: AutonomousFaultCategory;
+    recoveryAction: AutonomousRecoveryAction;
+    status: 'recovering' | 'blocked';
+    reason: string;
+}
+export declare function applyRecoveryAttemptBudget(decision: AutonomousFaultDecision, attempt: number, maxAttempts: number): AutonomousFaultDecision;
+export declare function classifyAutonomousFault(input: {
+    reason: string;
+    faultClass?: RecoveryFaultClass;
+    llmErrorKind?: LLMErrorKind;
+}): AutonomousFaultDecision;
+//# sourceMappingURL=AutonomousFaultPolicy.d.ts.map

package/dist/core/AutonomousFaultPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutonomousFaultPolicy.d.ts","sourceRoot":"","sources":["../../src/core/AutonomousFaultPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,MAAM,uBAAuB,GAC/B,sBAAsB,GACtB,oBAAoB,GACpB,mBAAmB,CAAC;AAExB,MAAM,MAAM,wBAAwB,GAChC,iBAAiB,GACjB,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,uBAAuB,CAAC;IAClC,cAAc,EAAE,wBAAwB,CAAC;IACzC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,uBAAuB,EACjC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,uBAAuB,CAezB;AAMD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,GAAG,uBAAuB,CAoG1B"}