@thoughtflow/core 0.1.2

package/dist/libs/fallback-decoder.class.js

@@ -0,0 +1,302 @@
+"use strict";
+/**
+ * FallbackDecoder — Regex-based structural extraction for any language.
+ *
+ * Uses pattern matching to extract: classes, functions, interfaces, imports.
+ * Less accurate than language-specific decoders, but works everywhere.
+ * Used when no specialized decoder (ts-morph, tree-sitter) is available.
+ *
+ * Supported patterns: Python, Java, Go, Rust, C#, Ruby, PHP, C/C++, generic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FallbackDecoder = void 0;
+const crypto_1 = require("crypto");
+const LANGUAGE_PATTERNS = [
+    {
+        language: "python",
+        extensions: [".py", ".pyw"],
+        classPattern: /^class\s+(\w+)(?:\(([^)]*)\))?\s*:/gm,
+        functionPattern: /^(?:async\s+)?def\s+(\w+)\(([^)]*)\)(?:\s*->\s*(\S+))?\s*:/gm,
+        importPattern: /^(?:from\s+(\S+)\s+)?import\s+(.+)$/gm,
+    },
+    {
+        language: "java",
+        extensions: [".java"],
+        classPattern: /(?:public\s+|private\s+|protected\s+)?(?:abstract\s+)?(?:final\s+)?class\s+(\w+)(?:\s+extends\s+(\w+))?(?:\s+implements\s+([^{]+))?\s*\{/gm,
+        functionPattern: /(?:public|private|protected)?\s*(?:static\s+)?(?:final\s+)?(?:synchronized\s+)?(?:abstract\s+)?(?:\w+(?:<[^>]+>)?)\s+(\w+)\s*\(([^)]*)\)/gm,
+        interfacePattern: /(?:public\s+)?interface\s+(\w+)(?:\s+extends\s+([^{]+))?\s*\{/gm,
+        importPattern: /^import\s+(?:static\s+)?(\S+)\s*;$/gm,
+        enumPattern: /(?:public\s+)?enum\s+(\w+)\s*\{/gm,
+    },
+    {
+        language: "go",
+        extensions: [".go"],
+        structPattern: /^type\s+(\w+)\s+struct\s*\{/gm,
+        interfacePattern: /^type\s+(\w+)\s+interface\s*\{/gm,
+        functionPattern: /^func\s+(?:\(\w+\s+\*?(\w+)\)\s+)?(\w+)\s*\(([^)]*)\)/gm,
+        importPattern: /^import\s+(?:\(\s*([\s\S]*?)\s*\)|"([^"]+)")/gm,
+    },
+    {
+        language: "rust",
+        extensions: [".rs"],
+        structPattern: /^(?:pub\s+)?struct\s+(\w+)(?:<[^>]+>)?\s*[({]/gm,
+        traitPattern: /^(?:pub\s+)?trait\s+(\w+)(?:<[^>]+>)?\s*\{/gm,
+        enumPattern: /^(?:pub\s+)?enum\s+(\w+)(?:<[^>]+>)?\s*\{/gm,
+        functionPattern: /^(?:pub\s+)?(?:async\s+)?fn\s+(\w+)(?:<[^>]+>)?\s*\(([^)]*)\)(?:\s*->\s*(\S+))?/gm,
+        importPattern: /^use\s+(.+);$/gm,
+    },
+    {
+        language: "csharp",
+        extensions: [".cs"],
+        classPattern: /(?:public|private|protected|internal)?\s*(?:abstract\s+|sealed\s+|static\s+)?class\s+(\w+)(?:<[^>]+>)?(?:\s*:\s*([^{]+))?\s*\{/gm,
+        interfacePattern: /(?:public|private|protected|internal)?\s*interface\s+(\w+)(?:<[^>]+>)?(?:\s*:\s*([^{]+))?\s*\{/gm,
+        functionPattern: /(?:public|private|protected|internal)?\s*(?:static\s+)?(?:async\s+)?(?:virtual\s+)?(?:override\s+)?(?:\w+(?:<[^>]+>)?)\s+(\w+)\s*\(([^)]*)\)/gm,
+        importPattern: /^using\s+(.+);$/gm,
+        enumPattern: /(?:public|private|protected|internal)?\s*enum\s+(\w+)\s*\{/gm,
+    },
+    {
+        language: "ruby",
+        extensions: [".rb", ".rake"],
+        classPattern: /^class\s+(\w+)(?:\s*<\s*(\w+))?\s*$/gm,
+        functionPattern: /^\s*def\s+(?:self\.)?(\w+[?!]?)(?:\(([^)]*)\))?$/gm,
+        importPattern: /^require(?:_relative)?\s+['"](.+)['"]/gm,
+    },
+    {
+        language: "php",
+        extensions: [".php"],
+        classPattern: /(?:abstract\s+)?class\s+(\w+)(?:\s+extends\s+(\w+))?(?:\s+implements\s+([^{]+))?\s*\{/gm,
+        interfacePattern: /interface\s+(\w+)(?:\s+extends\s+([^{]+))?\s*\{/gm,
+        functionPattern: /(?:public|private|protected)?\s*(?:static\s+)?function\s+(\w+)\s*\(([^)]*)\)/gm,
+        importPattern: /^use\s+(.+);$/gm,
+        traitPattern: /trait\s+(\w+)\s*\{/gm,
+    },
+];
+class FallbackDecoder {
+    name = "fallback-regex";
+    supportedExtensions;
+    supportedLanguages;
+    constructor() {
+        this.supportedExtensions = LANGUAGE_PATTERNS.flatMap((p) => p.extensions);
+        this.supportedLanguages = LANGUAGE_PATTERNS.map((p) => p.language);
+    }
+    canDecode(filePath, _content) {
+        const ext = this.getExtension(filePath);
+        return this.supportedExtensions.includes(ext);
+    }
+    decode(filePath, content, _projectRoot) {
+        const contentHash = (0, crypto_1.createHash)("sha256").update(content).digest("hex");
+        const totalLines = content.split("\n").length;
+        const lines = content.split("\n");
+        const ext = this.getExtension(filePath);
+        const langPatterns = LANGUAGE_PATTERNS.find((p) => p.extensions.includes(ext));
+        const language = langPatterns?.language ?? "unknown";
+        const symbols = this.extractSymbols(content, lines, langPatterns);
+        const imports = this.extractImports(content, langPatterns);
+        return {
+            filePath,
+            language,
+            totalLines,
+            symbols,
+            imports,
+            exports: [], // Hard to detect generically
+            contentHash,
+            decodedAt: new Date().toISOString(),
+            decoderName: this.name,
+        };
+    }
+    // ── Symbol Extraction ─────────────────────────────────────────────────
+    extractSymbols(content, lines, patterns) {
+        if (!patterns)
+            return [];
+        const symbols = [];
+        if (patterns.classPattern) {
+            for (const match of content.matchAll(new RegExp(patterns.classPattern))) {
+                const line = this.getLineNumber(content, match.index);
+                const endLine = this.findBlockEnd(lines, line - 1, patterns.language);
+                symbols.push({
+                    name: match[1],
+                    kind: "class",
+                    startLine: line,
+                    endLine,
+                    exported: this.isExported(content, match.index, patterns.language),
+                    extends: match[2] || undefined,
+                    implements: match[3]?.split(",").map((s) => s.trim()).filter(Boolean),
+                });
+            }
+        }
+        if (patterns.interfacePattern) {
+            for (const match of content.matchAll(new RegExp(patterns.interfacePattern))) {
+                const line = this.getLineNumber(content, match.index);
+                const endLine = this.findBlockEnd(lines, line - 1, patterns.language);
+                symbols.push({
+                    name: match[1],
+                    kind: "interface",
+                    startLine: line,
+                    endLine,
+                    exported: this.isExported(content, match.index, patterns.language),
+                    extends: match[2]?.trim() || undefined,
+                });
+            }
+        }
+        if (patterns.structPattern) {
+            for (const match of content.matchAll(new RegExp(patterns.structPattern))) {
+                const line = this.getLineNumber(content, match.index);
+                const endLine = this.findBlockEnd(lines, line - 1, patterns.language);
+                symbols.push({
+                    name: match[1],
+                    kind: "struct",
+                    startLine: line,
+                    endLine,
+                    exported: this.isExported(content, match.index, patterns.language),
+                });
+            }
+        }
+        if (patterns.traitPattern) {
+            for (const match of content.matchAll(new RegExp(patterns.traitPattern))) {
+                const line = this.getLineNumber(content, match.index);
+                const endLine = this.findBlockEnd(lines, line - 1, patterns.language);
+                symbols.push({
+                    name: match[1],
+                    kind: "trait",
+                    startLine: line,
+                    endLine,
+                    exported: this.isExported(content, match.index, patterns.language),
+                });
+            }
+        }
+        if (patterns.enumPattern) {
+            for (const match of content.matchAll(new RegExp(patterns.enumPattern))) {
+                const line = this.getLineNumber(content, match.index);
+                const endLine = this.findBlockEnd(lines, line - 1, patterns.language);
+                symbols.push({
+                    name: match[1],
+                    kind: "enum",
+                    startLine: line,
+                    endLine,
+                    exported: this.isExported(content, match.index, patterns.language),
+                });
+            }
+        }
+        if (patterns.functionPattern) {
+            for (const match of content.matchAll(new RegExp(patterns.functionPattern))) {
+                const line = this.getLineNumber(content, match.index);
+                // Skip functions inside classes (indented)
+                if (this.isInsideBlock(symbols, line))
+                    continue;
+                const endLine = this.findBlockEnd(lines, line - 1, patterns.language);
+                // For Go methods: match[1] is receiver type, match[2] is function name
+                const name = patterns.language === "go" ? (match[2] ?? match[1]) : match[1];
+                symbols.push({
+                    name,
+                    kind: "function",
+                    startLine: line,
+                    endLine,
+                    exported: this.isExported(content, match.index, patterns.language),
+                    isAsync: match[0].includes("async"),
+                });
+            }
+        }
+        return symbols.sort((a, b) => a.startLine - b.startLine);
+    }
+    // ── Import Extraction ─────────────────────────────────────────────────
+    extractImports(content, patterns) {
+        if (!patterns?.importPattern)
+            return [];
+        const imports = [];
+        for (const match of content.matchAll(new RegExp(patterns.importPattern))) {
+            const line = this.getLineNumber(content, match.index);
+            let source;
+            let names = null;
+            if (patterns.language === "python") {
+                source = match[1] || match[2] || "";
+                if (match[2]) {
+                    names = match[2].split(",").map((s) => s.trim()).filter(Boolean);
+                }
+            }
+            else if (patterns.language === "go") {
+                // Handle multi-import blocks
+                source = match[2] || match[1] || "";
+                if (match[1]) {
+                    names = match[1].split("\n")
+                        .map((line) => line.trim().replace(/^"|"$/g, ""))
+                        .filter(Boolean);
+                }
+            }
+            else {
+                source = match[1] || "";
+            }
+            imports.push({
+                source,
+                names,
+                isDefault: false,
+                isNamespace: false,
+                isTypeOnly: false,
+                line,
+            });
+        }
+        return imports;
+    }
+    // ── Helpers ───────────────────────────────────────────────────────────
+    getExtension(filePath) {
+        const idx = filePath.lastIndexOf(".");
+        return idx >= 0 ? filePath.slice(idx).toLowerCase() : "";
+    }
+    getLineNumber(content, charIndex) {
+        return content.slice(0, charIndex).split("\n").length;
+    }
+    isExported(content, matchIndex, language) {
+        // Check characters before match for export keywords
+        const before = content.slice(Math.max(0, matchIndex - 30), matchIndex);
+        if (language === "go" || language === "rust") {
+            // Go: capitalized names are exported; Rust: pub keyword
+            return before.includes("pub") || /[A-Z]/.test(content[matchIndex] ?? "");
+        }
+        return before.includes("export") || before.includes("public");
+    }
+    /**
+     * Simple brace/indent-based block end detection.
+     */
+    findBlockEnd(lines, startIdx, language) {
+        // For Python/Ruby: indent-based
+        if (language === "python" || language === "ruby") {
+            const baseIndent = this.getIndent(lines[startIdx] ?? "");
+            for (let i = startIdx + 1; i < lines.length; i++) {
+                const line = lines[i];
+                if (line.trim() === "")
+                    continue;
+                if (this.getIndent(line) <= baseIndent && i > startIdx + 1) {
+                    return i; // 1-based
+                }
+            }
+            return lines.length;
+        }
+        // For brace-based languages
+        let depth = 0;
+        let foundOpen = false;
+        for (let i = startIdx; i < lines.length; i++) {
+            const line = lines[i];
+            for (const ch of line) {
+                if (ch === "{") {
+                    depth++;
+                    foundOpen = true;
+                }
+                if (ch === "}") {
+                    depth--;
+                }
+                if (foundOpen && depth === 0)
+                    return i + 1; // 1-based
+            }
+        }
+        return startIdx + 1;
+    }
+    getIndent(line) {
+        const match = line.match(/^(\s*)/);
+        return match ? match[1].length : 0;
+    }
+    isInsideBlock(symbols, line) {
+        return symbols.some((s) => s.startLine < line && s.endLine >= line &&
+            (s.kind === "class" || s.kind === "struct" || s.kind === "interface"));
+    }
+}
+exports.FallbackDecoder = FallbackDecoder;
+//# sourceMappingURL=fallback-decoder.class.js.map

package/dist/libs/fallback-decoder.class.js.map

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

package/dist/libs/general-purpose-subagent.d.ts

@@ -0,0 +1,160 @@
+import { SubAgent } from "../contracts/subagent.types";
+import { ConversationTool } from "../contracts/tool.types";
+import { SkillDefinition } from "../contracts/skill.types";
+/**
+ * Context isolation configuration for a subagent
+ */
+export interface ContextIsolationConfig {
+    /** Unique context identifier to prevent cross-talk */
+    contextId: string;
+    /** Whether to sandbox tool access */
+    sandboxTools?: boolean;
+    /** Which tool names are allowed (whitelist) */
+    allowedTools?: string[];
+    /** Which tool names are blocked (blacklist) */
+    blockedTools?: string[];
+    /** Whether to isolate memory between invocations */
+    isolateMemory?: boolean;
+    /** Whether to clear history before each invocation */
+    clearHistoryBeforeEach?: boolean;
+    /** TTL for context data in milliseconds */
+    contextTtlMs?: number;
+    /** Maximum context size in tokens */
+    maxContextTokens?: number;
+    /** Whether to encrypt sensitive context data */
+    encryptContext?: boolean;
+}
+/**
+ * Context storage for an isolated subagent instance
+ */
+export interface IsolatedContext {
+    /** Unique context identifier */
+    contextId: string;
+    /** Context-specific metadata */
+    metadata: Record<string, unknown>;
+    /** Conversation history within this context */
+    history: Array<{
+        role: string;
+        content: string;
+    }>;
+    /** Context creation timestamp */
+    createdAt: Date;
+    /** Last accessed timestamp */
+    lastAccessedAt: Date;
+    /** Context namespace (prevents collisions) */
+    namespace: string;
+}
+/**
+ * GeneralPurposeSubAgent provides a reusable, context-isolated subagent
+ * suitable for generic conversations and multi-tenant scenarios.
+ *
+ * Key features:
+ * - Isolated context per instance (no cross-talk between conversations)
+ * - Flexible tool access control (whitelist/blacklist)
+ * - Memory isolation options
+ * - Conversation history management
+ * - Metadata context tracking
+ *
+ * Usage:
+ *   const gpsa = new GeneralPurposeSubAgent("general", [], { contextId: "user-123" });
+ *   const subagent = gpsa.create();
+ */
+export declare class GeneralPurposeSubAgent {
+    private readonly name;
+    private readonly tools;
+    private readonly skills?;
+    private readonly isolationConfig;
+    private readonly contexts;
+    private readonly systemPromptTemplate;
+    constructor(name?: string, tools?: ConversationTool[], isolationConfig?: Partial<ContextIsolationConfig>, skills?: SkillDefinition[], systemPromptTemplate?: string);
+    /**
+     * Initialize isolated context for this subagent instance
+     */
+    private initializeContext;
+    /**
+     * Generate unique namespace to prevent context collisions
+     */
+    private generateNamespace;
+    /**
+     * Default system prompt for general-purpose agent
+     */
+    private defaultSystemPrompt;
+    /**
+     * Create a SubAgent instance with isolation
+     */
+    create(): SubAgent;
+    /**
+     * Get tools with isolation applied (filtering, sandboxing)
+     */
+    private getIsolatedTools;
+    /**
+     * Sandbox a tool to prevent context leakage
+     */
+    private sandboxTool;
+    /**
+     * Add metadata to context
+     */
+    setContextMetadata(key: string, value: unknown): void;
+    /**
+     * Get context metadata
+     */
+    getContextMetadata(key: string): unknown;
+    /**
+     * Clear context metadata
+     */
+    clearContextMetadata(): void;
+    /**
+     * Add message to conversation history
+     */
+    addToHistory(role: string, content: string): void;
+    /**
+     * Get conversation history
+     */
+    getHistory(): Array<{
+        role: string;
+        content: string;
+    }>;
+    /**
+     * Clear conversation history
+     */
+    clearHistory(): void;
+    /**
+     * Get isolation configuration
+     */
+    getIsolationConfig(): Readonly<ContextIsolationConfig>;
+    /**
+     * Get context information
+     */
+    getContext(): IsolatedContext | undefined;
+    /**
+     * Check if context has expired
+     */
+    isContextExpired(): boolean;
+    /**
+     * Refresh context (reset expiration)
+     */
+    refreshContext(): void;
+    /**
+     * Dispose of context (cleanup)
+     */
+    dispose(): void;
+    /**
+     * Get all available tool names
+     */
+    getAvailableTools(): string[];
+    /**
+     * Check if a tool is available
+     */
+    isToolAvailable(toolName: string): boolean;
+    /**
+     * Create multiple isolated instances for multi-tenant scenario
+     */
+    static createMultiple(count: number, baseConfig: {
+        name?: string;
+        tools?: ConversationTool[];
+        skills?: SkillDefinition[];
+        isolationConfig?: Partial<ContextIsolationConfig>;
+        systemPrompt?: string;
+    }): GeneralPurposeSubAgent[];
+}
+//# sourceMappingURL=general-purpose-subagent.d.ts.map

package/dist/libs/general-purpose-subagent.d.ts.map

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