@phuetz/code-buddy 0.1.18 → 0.1.19

package/dist/utils/shell-snapshot.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Shell Environment Snapshots
+ *
+ * Captures the user's shell environment for better context awareness.
+ * Includes shell type, env vars (filtered for safety), aliases, rc files,
+ * and common tool versions.
+ *
+ * Can be injected into the system prompt to help the agent understand
+ * the user's development environment.
+ */
+export interface ShellSnapshot {
+    /** Detected shell (bash, zsh, fish, sh) */
+    shell: string;
+    /** Filtered environment variables (safe ones only) */
+    env: Record<string, string>;
+    /** Parsed aliases from rc files */
+    aliases: string[];
+    /** Shell function names */
+    functions: string[];
+    /** Which rc files exist */
+    rcFiles: string[];
+    /** Node.js version */
+    nodeVersion?: string;
+    /** npm version */
+    npmVersion?: string;
+    /** Git version */
+    gitVersion?: string;
+    /** Python version */
+    pythonVersion?: string;
+}
+/**
+ * Capture a snapshot of the current shell environment.
+ */
+export declare function captureShellSnapshot(): Promise<ShellSnapshot>;
+/**
+ * Format a shell snapshot as a concise prompt string for system prompt injection.
+ */
+export declare function formatSnapshotForPrompt(snapshot: ShellSnapshot): string;

package/dist/utils/shell-snapshot.js

@@ -0,0 +1,323 @@
+/**
+ * Shell Environment Snapshots
+ *
+ * Captures the user's shell environment for better context awareness.
+ * Includes shell type, env vars (filtered for safety), aliases, rc files,
+ * and common tool versions.
+ *
+ * Can be injected into the system prompt to help the agent understand
+ * the user's development environment.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { execSync } from 'child_process';
+import os from 'os';
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Environment variables that are safe and useful to include.
+ * Explicitly listed to avoid leaking secrets.
+ */
+const SAFE_ENV_VARS = new Set([
+    'SHELL',
+    'HOME',
+    'USER',
+    'LOGNAME',
+    'PATH',
+    'EDITOR',
+    'VISUAL',
+    'TERM',
+    'LANG',
+    'LC_ALL',
+    'COLORTERM',
+    'TERM_PROGRAM',
+    'PWD',
+    'OLDPWD',
+    'HOSTNAME',
+    'XDG_CONFIG_HOME',
+    'XDG_DATA_HOME',
+    'XDG_CACHE_HOME',
+    'XDG_RUNTIME_DIR',
+    'NODE_ENV',
+    'NPM_CONFIG_PREFIX',
+    'GOPATH',
+    'GOROOT',
+    'CARGO_HOME',
+    'RUSTUP_HOME',
+    'JAVA_HOME',
+    'VIRTUAL_ENV',
+    'CONDA_DEFAULT_ENV',
+    'PYENV_ROOT',
+    'NVM_DIR',
+    'FNM_DIR',
+    'VOLTA_HOME',
+    'PNPM_HOME',
+    'BUN_INSTALL',
+    'DOCKER_HOST',
+    'KUBECONFIG',
+    'WSL_DISTRO_NAME',
+    'DISPLAY',
+    'WAYLAND_DISPLAY',
+    'SSH_AUTH_SOCK',
+]);
+/**
+ * Patterns that indicate a secret - never include these.
+ */
+const SECRET_PATTERNS = [
+    /api[_-]?key/i,
+    /secret/i,
+    /token/i,
+    /password/i,
+    /credential/i,
+    /private[_-]?key/i,
+    /auth/i,
+    /access[_-]?key/i,
+];
+// ============================================================================
+// Helpers
+// ============================================================================
+function execSafe(command, timeoutMs = 3000) {
+    try {
+        return execSync(command, {
+            encoding: 'utf-8',
+            timeout: timeoutMs,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+function fileExists(filePath) {
+    try {
+        return fs.existsSync(filePath);
+    }
+    catch {
+        return false;
+    }
+}
+function readFileSafe(filePath) {
+    try {
+        if (!fileExists(filePath)) {
+            return null;
+        }
+        const stat = fs.statSync(filePath);
+        // Skip files larger than 100KB to avoid loading huge rc files
+        if (stat.size > 100 * 1024) {
+            return null;
+        }
+        return fs.readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+function isSafeEnvVar(key) {
+    if (SAFE_ENV_VARS.has(key)) {
+        return true;
+    }
+    // Reject anything matching secret patterns
+    for (const pattern of SECRET_PATTERNS) {
+        if (pattern.test(key)) {
+            return false;
+        }
+    }
+    return false;
+}
+// ============================================================================
+// Alias Parsing
+// ============================================================================
+function parseAliasesFromContent(content) {
+    const aliases = [];
+    const aliasRegex = /^\s*alias\s+([^\s=]+)=['"]?([^'"]*?)['"]?\s*$/gm;
+    let match;
+    while ((match = aliasRegex.exec(content)) !== null) {
+        aliases.push(`${match[1]}=${match[2]}`);
+    }
+    return aliases;
+}
+function parseFunctionsFromContent(content) {
+    const functions = [];
+    // Match bash/zsh function declarations
+    const funcRegex = /^\s*(?:function\s+)?(\w+)\s*\(\)\s*\{/gm;
+    let match;
+    while ((match = funcRegex.exec(content)) !== null) {
+        functions.push(match[1]);
+    }
+    return functions;
+}
+function parseFishAliases(content) {
+    const aliases = [];
+    // Fish uses: abbr -a name command  or  alias name command
+    const abbrRegex = /^\s*abbr\s+(?:-a\s+)?(\S+)\s+(.+)$/gm;
+    let match;
+    while ((match = abbrRegex.exec(content)) !== null) {
+        aliases.push(`${match[1]}=${match[2]}`);
+    }
+    const aliasRegex = /^\s*alias\s+(\S+)\s+['"]?(.+?)['"]?\s*$/gm;
+    while ((match = aliasRegex.exec(content)) !== null) {
+        aliases.push(`${match[1]}=${match[2]}`);
+    }
+    return aliases;
+}
+function parseFishFunctions(content) {
+    const functions = [];
+    const funcRegex = /^\s*function\s+(\w+)/gm;
+    let match;
+    while ((match = funcRegex.exec(content)) !== null) {
+        functions.push(match[1]);
+    }
+    return functions;
+}
+// ============================================================================
+// Core Implementation
+// ============================================================================
+/**
+ * Capture a snapshot of the current shell environment.
+ */
+export async function captureShellSnapshot() {
+    const home = os.homedir();
+    const shell = detectShell();
+    const env = captureFilteredEnv();
+    const rcFiles = detectRcFiles(home, shell);
+    // Parse aliases and functions from rc files
+    let aliases = [];
+    let functions = [];
+    for (const rcFile of rcFiles) {
+        const content = readFileSafe(rcFile);
+        if (!content)
+            continue;
+        if (shell === 'fish') {
+            aliases.push(...parseFishAliases(content));
+            functions.push(...parseFishFunctions(content));
+        }
+        else {
+            aliases.push(...parseAliasesFromContent(content));
+            functions.push(...parseFunctionsFromContent(content));
+        }
+    }
+    // Deduplicate
+    aliases = [...new Set(aliases)];
+    functions = [...new Set(functions)];
+    // Tool versions
+    const nodeVersion = execSafe('node --version');
+    const npmVersion = execSafe('npm --version');
+    const gitVersion = execSafe('git --version')?.replace('git version ', '');
+    const pythonVersion = execSafe('python3 --version')?.replace('Python ', '')
+        ?? execSafe('python --version')?.replace('Python ', '');
+    return {
+        shell,
+        env,
+        aliases,
+        functions,
+        rcFiles,
+        nodeVersion,
+        npmVersion,
+        gitVersion,
+        pythonVersion,
+    };
+}
+/**
+ * Detect the current shell.
+ */
+function detectShell() {
+    const shellEnv = process.env['SHELL'] || '';
+    const shellName = path.basename(shellEnv);
+    if (['bash', 'zsh', 'fish', 'sh', 'dash', 'ksh', 'tcsh', 'csh'].includes(shellName)) {
+        return shellName;
+    }
+    // Fallback: try to detect from parent process
+    const parentShell = execSafe('ps -p $PPID -o comm=');
+    if (parentShell) {
+        const name = path.basename(parentShell);
+        if (['bash', 'zsh', 'fish'].includes(name)) {
+            return name;
+        }
+    }
+    return shellName || 'sh';
+}
+/**
+ * Capture filtered environment variables (exclude secrets).
+ */
+function captureFilteredEnv() {
+    const filtered = {};
+    for (const [key, value] of Object.entries(process.env)) {
+        if (value && isSafeEnvVar(key)) {
+            // Truncate very long values (e.g., PATH)
+            filtered[key] = value.length > 500 ? value.substring(0, 500) + '...' : value;
+        }
+    }
+    return filtered;
+}
+/**
+ * Detect which rc/config files exist for the user's shell.
+ */
+function detectRcFiles(home, shell) {
+    const candidates = [];
+    // Common rc files
+    const possibleFiles = [
+        '.profile',
+        '.bashrc',
+        '.bash_profile',
+        '.bash_aliases',
+        '.zshrc',
+        '.zprofile',
+        '.zshenv',
+        '.config/fish/config.fish',
+        '.config/fish/fish_variables',
+    ];
+    for (const file of possibleFiles) {
+        const fullPath = path.join(home, file);
+        if (fileExists(fullPath)) {
+            candidates.push(fullPath);
+        }
+    }
+    return candidates;
+}
+/**
+ * Format a shell snapshot as a concise prompt string for system prompt injection.
+ */
+export function formatSnapshotForPrompt(snapshot) {
+    const lines = [];
+    lines.push(`## Shell Environment`);
+    lines.push(`- Shell: ${snapshot.shell}`);
+    if (snapshot.nodeVersion) {
+        lines.push(`- Node: ${snapshot.nodeVersion}`);
+    }
+    if (snapshot.npmVersion) {
+        lines.push(`- npm: ${snapshot.npmVersion}`);
+    }
+    if (snapshot.gitVersion) {
+        lines.push(`- Git: ${snapshot.gitVersion}`);
+    }
+    if (snapshot.pythonVersion) {
+        lines.push(`- Python: ${snapshot.pythonVersion}`);
+    }
+    // Key env vars
+    const editor = snapshot.env['EDITOR'] || snapshot.env['VISUAL'];
+    if (editor) {
+        lines.push(`- Editor: ${editor}`);
+    }
+    const term = snapshot.env['TERM_PROGRAM'] || snapshot.env['TERM'];
+    if (term) {
+        lines.push(`- Terminal: ${term}`);
+    }
+    const wsl = snapshot.env['WSL_DISTRO_NAME'];
+    if (wsl) {
+        lines.push(`- WSL: ${wsl}`);
+    }
+    const virtualEnv = snapshot.env['VIRTUAL_ENV'] || snapshot.env['CONDA_DEFAULT_ENV'];
+    if (virtualEnv) {
+        lines.push(`- Virtual env: ${virtualEnv}`);
+    }
+    // Aliases (show count, not full list to save tokens)
+    if (snapshot.aliases.length > 0) {
+        lines.push(`- Shell aliases: ${snapshot.aliases.length} defined`);
+    }
+    if (snapshot.functions.length > 0) {
+        lines.push(`- Shell functions: ${snapshot.functions.length} defined`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=shell-snapshot.js.map

package/dist/utils/shell-snapshot.js.map

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

package/dist/utils/stream-json-formatter.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Stream JSON Formatter
+ *
+ * Formats streaming output as newline-delimited JSON (NDJSON).
+ * Each event is a JSON object on its own line, suitable for
+ * machine-readable streaming output via --output-format stream-json.
+ */
+export interface StartEvent {
+    type: 'start';
+    session_id: string;
+    model: string;
+}
+export interface TextEvent {
+    type: 'text';
+    content: string;
+}
+export interface ToolUseEvent {
+    type: 'tool_use';
+    tool: string;
+    input: Record<string, unknown>;
+}
+export interface ToolResultEvent {
+    type: 'tool_result';
+    tool: string;
+    output: string;
+    success: boolean;
+}
+export interface ThinkingEvent {
+    type: 'thinking';
+    content: string;
+}
+export interface DoneEvent {
+    type: 'done';
+    cost: number;
+    tokens: {
+        input: number;
+        output: number;
+    };
+}
+export type StreamEvent = StartEvent | TextEvent | ToolUseEvent | ToolResultEvent | ThinkingEvent | DoneEvent;
+export declare class StreamJsonFormatter {
+    /**
+     * Format a single event as an NDJSON line (JSON + newline).
+     */
+    formatEvent(event: StreamEvent): string;
+    /**
+     * Format multiple events as NDJSON.
+     */
+    formatEvents(events: StreamEvent[]): string;
+    /**
+     * Create a start event.
+     */
+    start(sessionId: string, model: string): string;
+    /**
+     * Create a text event.
+     */
+    text(content: string): string;
+    /**
+     * Create a tool_use event.
+     */
+    toolUse(tool: string, input: Record<string, unknown>): string;
+    /**
+     * Create a tool_result event.
+     */
+    toolResult(tool: string, output: string, success: boolean): string;
+    /**
+     * Create a thinking event.
+     */
+    thinking(content: string): string;
+    /**
+     * Create a done event.
+     */
+    done(cost: number, tokens: {
+        input: number;
+        output: number;
+    }): string;
+}

package/dist/utils/stream-json-formatter.js

@@ -0,0 +1,61 @@
+/**
+ * Stream JSON Formatter
+ *
+ * Formats streaming output as newline-delimited JSON (NDJSON).
+ * Each event is a JSON object on its own line, suitable for
+ * machine-readable streaming output via --output-format stream-json.
+ */
+// ============================================================================
+// Formatter
+// ============================================================================
+export class StreamJsonFormatter {
+    /**
+     * Format a single event as an NDJSON line (JSON + newline).
+     */
+    formatEvent(event) {
+        return JSON.stringify(event) + '\n';
+    }
+    /**
+     * Format multiple events as NDJSON.
+     */
+    formatEvents(events) {
+        return events.map(e => this.formatEvent(e)).join('');
+    }
+    /**
+     * Create a start event.
+     */
+    start(sessionId, model) {
+        return this.formatEvent({ type: 'start', session_id: sessionId, model });
+    }
+    /**
+     * Create a text event.
+     */
+    text(content) {
+        return this.formatEvent({ type: 'text', content });
+    }
+    /**
+     * Create a tool_use event.
+     */
+    toolUse(tool, input) {
+        return this.formatEvent({ type: 'tool_use', tool, input });
+    }
+    /**
+     * Create a tool_result event.
+     */
+    toolResult(tool, output, success) {
+        return this.formatEvent({ type: 'tool_result', tool, output, success });
+    }
+    /**
+     * Create a thinking event.
+     */
+    thinking(content) {
+        return this.formatEvent({ type: 'thinking', content });
+    }
+    /**
+     * Create a done event.
+     */
+    done(cost, tokens) {
+        return this.formatEvent({ type: 'done', cost, tokens });
+    }
+}
+//# sourceMappingURL=stream-json-formatter.js.map

package/dist/utils/stream-json-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-json-formatter.js","sourceRoot":"","sources":["../../src/utils/stream-json-formatter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoDH,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,MAAM,OAAO,mBAAmB;IAC9B;;OAEG;IACH,WAAW,CAAC,KAAkB;QAC5B,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAqB;QAChC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAiB,EAAE,KAAa;QACpC,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAe;QAClB,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAY,EAAE,KAA8B;QAClD,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY,EAAE,MAAc,EAAE,OAAgB;QACvD,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,OAAe;QACtB,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAY,EAAE,MAAyC;QAC1D,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/workflows/lobster-engine.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Lobster Typed Workflow Engine
+ * DAG-based workflow definition, validation, and execution ordering.
+ */
+export interface LobsterStep {
+    id: string;
+    name: string;
+    command: string;
+    inputs?: Record<string, string>;
+    outputs?: string[];
+    dependsOn?: string[];
+    timeout?: number;
+}
+export interface LobsterWorkflow {
+    name: string;
+    version: string;
+    steps: LobsterStep[];
+    variables?: Record<string, string>;
+}
+export interface StepResult {
+    stepId: string;
+    status: 'success' | 'failed' | 'skipped';
+    stdout: string;
+    exitCode: number;
+    duration: number;
+}
+export declare class LobsterEngine {
+    private static instance;
+    static getInstance(): LobsterEngine;
+    static resetInstance(): void;
+    parseWorkflow(yaml: string): LobsterWorkflow;
+    validateWorkflow(workflow: LobsterWorkflow): {
+        valid: boolean;
+        errors: string[];
+    };
+    resolveVariables(template: string, context: Record<string, string>): string;
+    getExecutionOrder(workflow: LobsterWorkflow): string[];
+    generateResumeToken(completedSteps: string[]): string;
+    parseResumeToken(token: string): string[];
+    getWorkflowStatus(results: StepResult[]): 'success' | 'failed' | 'partial';
+    private hasCycle;
+    private parseSimpleYaml;
+}