@cdoing/core 0.1.0

package/dist/context-providers/problems.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * Problems Context Provider — @problems
+ *
+ * Injects VS Code diagnostics (errors, warnings) into the conversation.
+ * Helps the AI understand what's broken without the user copying error messages.
+ *
+ * How it works:
+ *   1. VS Code extension collects diagnostics from all open files
+ *   2. Groups them by file and severity
+ *   3. Formats as a structured list for the LLM
+ *
+ * Learning note: Diagnostics come from VS Code's Language Server Protocol (LSP).
+ * Each diagnostic has a file path, line number, severity, and message.
+ * We pass them via the `options.diagnostics` array from the extension host.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProblemsContextProvider = void 0;
+/** Emoji icons for each severity level */
+const SEVERITY_ICONS = {
+    error: "❌",
+    warning: "⚠️",
+    info: "ℹ️",
+    hint: "💡",
+};
+/** Priority order for sorting (errors first) */
+const SEVERITY_ORDER = {
+    error: 0,
+    warning: 1,
+    info: 2,
+    hint: 3,
+};
+class ProblemsContextProvider {
+    id = "problems";
+    trigger = "@problems";
+    description = "Include current file diagnostics (errors, warnings)";
+    requiresArg = false;
+    async resolve(_arg, options) {
+        const diagnostics = options?.diagnostics || [];
+        if (diagnostics.length === 0) {
+            return {
+                label: "Problems",
+                content: "[No diagnostics found. All files are clean!]",
+                metadata: { source: "diagnostics", itemCount: 0 },
+            };
+        }
+        // Sort by severity (errors first), then by file path
+        const sorted = [...diagnostics].sort((a, b) => {
+            const severityDiff = (SEVERITY_ORDER[a.severity] ?? 4) - (SEVERITY_ORDER[b.severity] ?? 4);
+            if (severityDiff !== 0)
+                return severityDiff;
+            return a.file.localeCompare(b.file);
+        });
+        // Group diagnostics by file for cleaner formatting
+        const byFile = new Map();
+        for (const diag of sorted) {
+            const existing = byFile.get(diag.file) || [];
+            existing.push(diag);
+            byFile.set(diag.file, existing);
+        }
+        // Count by severity
+        const counts = { error: 0, warning: 0, info: 0, hint: 0 };
+        for (const diag of sorted) {
+            counts[diag.severity] = (counts[diag.severity] || 0) + 1;
+        }
+        // Format output
+        const sections = [];
+        for (const [file, diags] of byFile) {
+            const lines = diags.map((d) => {
+                const icon = SEVERITY_ICONS[d.severity] || "•";
+                return `  ${icon} Line ${d.line}: ${d.message}`;
+            });
+            sections.push(`### ${file}\n${lines.join("\n")}`);
+        }
+        // Build summary line
+        const summaryParts = [];
+        if (counts.error > 0)
+            summaryParts.push(`${counts.error} error${counts.error > 1 ? "s" : ""}`);
+        if (counts.warning > 0)
+            summaryParts.push(`${counts.warning} warning${counts.warning > 1 ? "s" : ""}`);
+        if (counts.info > 0)
+            summaryParts.push(`${counts.info} info`);
+        if (counts.hint > 0)
+            summaryParts.push(`${counts.hint} hint${counts.hint > 1 ? "s" : ""}`);
+        const summary = summaryParts.join(", ");
+        return {
+            label: `Problems (${summary})`,
+            content: `## Diagnostics: ${summary}\n\n${sections.join("\n\n")}`,
+            metadata: {
+                source: "diagnostics",
+                itemCount: diagnostics.length,
+            },
+        };
+    }
+}
+exports.ProblemsContextProvider = ProblemsContextProvider;
+//# sourceMappingURL=problems.js.map

package/dist/context-providers/problems.js.map

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

package/dist/context-providers/registry.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Context Provider Registry — Manages all available @ context providers.
+ *
+ * Responsibilities:
+ *   1. Register/unregister providers
+ *   2. Match user input (e.g., "@terminal") to the right provider
+ *   3. Resolve context by delegating to the matched provider
+ *
+ * Learning note: This is a Service Locator pattern — it decouples
+ * the chat input from specific provider implementations. You can
+ * add new @ providers without touching the input handling code.
+ */
+import type { ContextProvider, ContextResult, ContextResolveOptions } from "./types";
+export declare class ContextProviderRegistry {
+    /** Map of provider ID → provider instance */
+    private providers;
+    /**
+     * Register a new context provider.
+     * Replaces any existing provider with the same ID.
+     */
+    register(provider: ContextProvider): void;
+    /**
+     * Remove a provider by ID.
+     */
+    unregister(id: string): void;
+    /**
+     * Get a provider by its ID.
+     */
+    get(id: string): ContextProvider | undefined;
+    /**
+     * Get all registered providers (for autocomplete suggestions).
+     */
+    getAll(): ContextProvider[];
+    /**
+     * Match a trigger string (e.g., "@terminal", "@url https://...") to a provider.
+     *
+     * Returns the matched provider and any argument after the trigger,
+     * or null if no provider matches.
+     *
+     * Learning note: This parsing is intentionally simple — we split on
+     * the first space to separate trigger from argument.
+     */
+    match(input: string): {
+        provider: ContextProvider;
+        arg?: string;
+    } | null;
+    /**
+     * Resolve context from a trigger string.
+     * Convenience method that combines match() + resolve().
+     */
+    resolve(input: string, options?: ContextResolveOptions): Promise<ContextResult | null>;
+    /**
+     * Get autocomplete suggestions for a partial @ input.
+     * E.g., "@ter" → ["@terminal"]
+     */
+    getSuggestions(partial: string): Array<{
+        trigger: string;
+        description: string;
+    }>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/context-providers/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/context-providers/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAErF,qBAAa,uBAAuB;IAClC,6CAA6C;IAC7C,OAAO,CAAC,SAAS,CAAsC;IAEvD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAIzC;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAI5C;;OAEG;IACH,MAAM,IAAI,eAAe,EAAE;IAI3B;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,eAAe,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAoBxE;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAO5F;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CAMjF"}

package/dist/context-providers/registry.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * Context Provider Registry — Manages all available @ context providers.
+ *
+ * Responsibilities:
+ *   1. Register/unregister providers
+ *   2. Match user input (e.g., "@terminal") to the right provider
+ *   3. Resolve context by delegating to the matched provider
+ *
+ * Learning note: This is a Service Locator pattern — it decouples
+ * the chat input from specific provider implementations. You can
+ * add new @ providers without touching the input handling code.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextProviderRegistry = void 0;
+class ContextProviderRegistry {
+    /** Map of provider ID → provider instance */
+    providers = new Map();
+    /**
+     * Register a new context provider.
+     * Replaces any existing provider with the same ID.
+     */
+    register(provider) {
+        this.providers.set(provider.id, provider);
+    }
+    /**
+     * Remove a provider by ID.
+     */
+    unregister(id) {
+        this.providers.delete(id);
+    }
+    /**
+     * Get a provider by its ID.
+     */
+    get(id) {
+        return this.providers.get(id);
+    }
+    /**
+     * Get all registered providers (for autocomplete suggestions).
+     */
+    getAll() {
+        return Array.from(this.providers.values());
+    }
+    /**
+     * Match a trigger string (e.g., "@terminal", "@url https://...") to a provider.
+     *
+     * Returns the matched provider and any argument after the trigger,
+     * or null if no provider matches.
+     *
+     * Learning note: This parsing is intentionally simple — we split on
+     * the first space to separate trigger from argument.
+     */
+    match(input) {
+        // Input should start with @
+        const trimmed = input.trim();
+        if (!trimmed.startsWith("@"))
+            return null;
+        // Split into trigger and argument: "@url https://example.com" → ["@url", "https://example.com"]
+        const spaceIndex = trimmed.indexOf(" ");
+        const trigger = spaceIndex >= 0 ? trimmed.substring(0, spaceIndex) : trimmed;
+        const arg = spaceIndex >= 0 ? trimmed.substring(spaceIndex + 1).trim() : undefined;
+        // Find a provider whose trigger matches
+        for (const provider of this.providers.values()) {
+            if (provider.trigger === trigger) {
+                return { provider, arg };
+            }
+        }
+        return null;
+    }
+    /**
+     * Resolve context from a trigger string.
+     * Convenience method that combines match() + resolve().
+     */
+    async resolve(input, options) {
+        const match = this.match(input);
+        if (!match)
+            return null;
+        return match.provider.resolve(match.arg, options);
+    }
+    /**
+     * Get autocomplete suggestions for a partial @ input.
+     * E.g., "@ter" → ["@terminal"]
+     */
+    getSuggestions(partial) {
+        const query = partial.toLowerCase();
+        return this.getAll()
+            .filter((p) => p.trigger.toLowerCase().startsWith(query))
+            .map((p) => ({ trigger: p.trigger, description: p.description }));
+    }
+}
+exports.ContextProviderRegistry = ContextProviderRegistry;
+//# sourceMappingURL=registry.js.map

package/dist/context-providers/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/context-providers/registry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAIH,MAAa,uBAAuB;IAClC,6CAA6C;IACrC,SAAS,GAAG,IAAI,GAAG,EAA2B,CAAC;IAEvD;;;OAGG;IACH,QAAQ,CAAC,QAAyB;QAChC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,EAAU;QACnB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,KAAa;QACjB,4BAA4B;QAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAE1C,gGAAgG;QAChG,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAC7E,MAAM,GAAG,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAEnF,wCAAwC;QACxC,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;YAC/C,IAAI,QAAQ,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;gBACjC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,OAA+B;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QAExB,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,cAAc,CAAC,OAAe;QAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC,MAAM,EAAE;aACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;aACxD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACtE,CAAC;CACF;AAnFD,0DAmFC"}

package/dist/context-providers/terminal.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Terminal Context Provider — @terminal
+ *
+ * Injects recent terminal output into the conversation.
+ * Useful when the user wants the AI to analyze command output,
+ * debug errors, or understand build/test results.
+ *
+ * How it works:
+ *   1. In VS Code: captures output from the integrated terminal
+ *   2. In CLI: captures the last shell command output
+ *   3. Formats it with a clear header for the LLM
+ *
+ * Learning note: Terminal output is inherently ephemeral — we only
+ * capture what's available at resolve time. In VS Code, this comes
+ * from the Terminal API; in CLI, from the last !command output.
+ */
+import type { ContextProvider, ContextResult, ContextResolveOptions } from "./types";
+export declare class TerminalContextProvider implements ContextProvider {
+    id: string;
+    trigger: string;
+    description: string;
+    requiresArg: boolean;
+    resolve(_arg?: string, options?: ContextResolveOptions): Promise<ContextResult>;
+}
+//# sourceMappingURL=terminal.d.ts.map

package/dist/context-providers/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../src/context-providers/terminal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAKrF,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,EAAE,SAAc;IAChB,OAAO,SAAe;IACtB,WAAW,SAAoC;IAC/C,WAAW,UAAS;IAEd,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC;CA6BtF"}

package/dist/context-providers/terminal.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Terminal Context Provider — @terminal
+ *
+ * Injects recent terminal output into the conversation.
+ * Useful when the user wants the AI to analyze command output,
+ * debug errors, or understand build/test results.
+ *
+ * How it works:
+ *   1. In VS Code: captures output from the integrated terminal
+ *   2. In CLI: captures the last shell command output
+ *   3. Formats it with a clear header for the LLM
+ *
+ * Learning note: Terminal output is inherently ephemeral — we only
+ * capture what's available at resolve time. In VS Code, this comes
+ * from the Terminal API; in CLI, from the last !command output.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalContextProvider = void 0;
+/** Default max characters for terminal output (prevents context window overflow) */
+const DEFAULT_MAX_CHARS = 10000;
+class TerminalContextProvider {
+    id = "terminal";
+    trigger = "@terminal";
+    description = "Include recent terminal output";
+    requiresArg = false;
+    async resolve(_arg, options) {
+        const maxChars = options?.maxContentLength ?? DEFAULT_MAX_CHARS;
+        let output = options?.terminalOutput || "";
+        // If no terminal output is available, return a helpful message
+        if (!output.trim()) {
+            return {
+                label: "Terminal Output",
+                content: "[No recent terminal output available. Run a command first, then use @terminal.]",
+                metadata: { source: "terminal", itemCount: 0 },
+            };
+        }
+        // Truncate if too long — keep the tail (most recent output is most relevant)
+        let truncated = false;
+        if (output.length > maxChars) {
+            output = output.slice(-maxChars);
+            truncated = true;
+        }
+        return {
+            label: "Terminal Output",
+            content: `## Recent Terminal Output\n\n\`\`\`\n${output}\n\`\`\``,
+            metadata: {
+                source: "terminal",
+                truncated,
+            },
+        };
+    }
+}
+exports.TerminalContextProvider = TerminalContextProvider;
+//# sourceMappingURL=terminal.js.map

package/dist/context-providers/terminal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.js","sourceRoot":"","sources":["../../src/context-providers/terminal.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAIH,oFAAoF;AACpF,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEhC,MAAa,uBAAuB;IAClC,EAAE,GAAG,UAAU,CAAC;IAChB,OAAO,GAAG,WAAW,CAAC;IACtB,WAAW,GAAG,gCAAgC,CAAC;IAC/C,WAAW,GAAG,KAAK,CAAC;IAEpB,KAAK,CAAC,OAAO,CAAC,IAAa,EAAE,OAA+B;QAC1D,MAAM,QAAQ,GAAG,OAAO,EAAE,gBAAgB,IAAI,iBAAiB,CAAC;QAChE,IAAI,MAAM,GAAG,OAAO,EAAE,cAAc,IAAI,EAAE,CAAC;QAE3C,+DAA+D;QAC/D,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACnB,OAAO;gBACL,KAAK,EAAE,iBAAiB;gBACxB,OAAO,EAAE,iFAAiF;gBAC1F,QAAQ,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,EAAE;aAC/C,CAAC;QACJ,CAAC;QAED,6EAA6E;QAC7E,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,MAAM,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;YAC7B,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC;YACjC,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;QAED,OAAO;YACL,KAAK,EAAE,iBAAiB;YACxB,OAAO,EAAE,wCAAwC,MAAM,UAAU;YACjE,QAAQ,EAAE;gBACR,MAAM,EAAE,UAAU;gBAClB,SAAS;aACV;SACF,CAAC;IACJ,CAAC;CACF;AAnCD,0DAmCC"}

package/dist/context-providers/tree.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Tree Context Provider — @tree
+ *
+ * Generates a file tree visualization of the workspace.
+ * Helps the AI understand the project structure at a glance.
+ *
+ * Usage:
+ *   @tree          → full tree (default depth 3)
+ *   @tree src      → tree of a subdirectory
+ *   @tree 5        → custom depth
+ *
+ * How it works:
+ *   1. Walks the directory recursively up to the configured depth
+ *   2. Respects .gitignore patterns
+ *   3. Formats as an ASCII tree (like the `tree` command)
+ *
+ * Learning note: We use recursion with a depth limit to prevent
+ * scanning massive directories. The .gitignore filtering ensures
+ * we don't include node_modules, dist, etc.
+ */
+import type { ContextProvider, ContextResult, ContextResolveOptions } from "./types";
+export declare class TreeContextProvider implements ContextProvider {
+    id: string;
+    trigger: string;
+    description: string;
+    requiresArg: boolean;
+    resolve(arg?: string, options?: ContextResolveOptions): Promise<ContextResult>;
+}
+//# sourceMappingURL=tree.d.ts.map

package/dist/context-providers/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/context-providers/tree.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAgBrF,qBAAa,mBAAoB,YAAW,eAAe;IACzD,EAAE,SAAU;IACZ,OAAO,SAAW;IAClB,WAAW,SAAwC;IACnD,WAAW,UAAS;IAEd,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC;CA6CrF"}

package/dist/context-providers/tree.js

@@ -0,0 +1,172 @@
+"use strict";
+/**
+ * Tree Context Provider — @tree
+ *
+ * Generates a file tree visualization of the workspace.
+ * Helps the AI understand the project structure at a glance.
+ *
+ * Usage:
+ *   @tree          → full tree (default depth 3)
+ *   @tree src      → tree of a subdirectory
+ *   @tree 5        → custom depth
+ *
+ * How it works:
+ *   1. Walks the directory recursively up to the configured depth
+ *   2. Respects .gitignore patterns
+ *   3. Formats as an ASCII tree (like the `tree` command)
+ *
+ * Learning note: We use recursion with a depth limit to prevent
+ * scanning massive directories. The .gitignore filtering ensures
+ * we don't include node_modules, dist, etc.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TreeContextProvider = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/** Default max depth for tree traversal */
+const DEFAULT_DEPTH = 3;
+/** Max items to include in the tree output */
+const MAX_ITEMS = 500;
+/** Directories to always skip (even without .gitignore) */
+const ALWAYS_SKIP = new Set([
+    "node_modules", ".git", ".next", ".nuxt", "__pycache__",
+    ".cache", ".turbo", "dist", "build", ".DS_Store",
+    "coverage", ".nyc_output", ".pytest_cache", "venv",
+    ".venv", "env", ".env", ".tox",
+]);
+class TreeContextProvider {
+    id = "tree";
+    trigger = "@tree";
+    description = "Show workspace file tree structure";
+    requiresArg = false;
+    async resolve(arg, options) {
+        const workingDir = options?.workingDir || process.cwd();
+        // Parse argument: could be a path, a depth number, or "path depth"
+        let targetDir = workingDir;
+        let maxDepth = DEFAULT_DEPTH;
+        if (arg) {
+            const parts = arg.trim().split(/\s+/);
+            for (const part of parts) {
+                const num = parseInt(part, 10);
+                if (!isNaN(num) && num > 0 && num <= 10) {
+                    maxDepth = num;
+                }
+                else {
+                    // Treat as a subdirectory path
+                    const resolved = path.resolve(workingDir, part);
+                    if (fs.existsSync(resolved) && fs.statSync(resolved).isDirectory()) {
+                        targetDir = resolved;
+                    }
+                }
+            }
+        }
+        // Build the tree
+        let itemCount = 0;
+        const lines = [];
+        const rootName = path.basename(targetDir);
+        lines.push(rootName + "/");
+        buildTree(targetDir, "", maxDepth, 0, lines, { count: 0, max: MAX_ITEMS });
+        itemCount = lines.length - 1; // Subtract the root line
+        const treeOutput = lines.join("\n");
+        const relativePath = path.relative(workingDir, targetDir) || ".";
+        return {
+            label: `File Tree: ${relativePath}`,
+            content: `## File Tree: ${relativePath} (depth: ${maxDepth})\n\n\`\`\`\n${treeOutput}\n\`\`\``,
+            metadata: {
+                source: targetDir,
+                truncated: itemCount >= MAX_ITEMS,
+                itemCount,
+            },
+        };
+    }
+}
+exports.TreeContextProvider = TreeContextProvider;
+/**
+ * Recursively build an ASCII tree representation.
+ *
+ * Uses box-drawing characters for a clean visual:
+ *   ├── file.ts
+ *   ├── src/
+ *   │   ├── index.ts
+ *   │   └── utils/
+ *   └── package.json
+ *
+ * Learning note: The `prefix` parameter builds up as we recurse deeper,
+ * adding "│   " or "    " to maintain the visual tree structure.
+ */
+function buildTree(dir, prefix, maxDepth, currentDepth, lines, counter) {
+    if (currentDepth >= maxDepth || counter.count >= counter.max)
+        return;
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return; // Permission denied or other read errors
+    }
+    // Filter out hidden/ignored directories and sort (dirs first, then files)
+    const filtered = entries
+        .filter((e) => !e.name.startsWith(".") || e.name === ".cdoing")
+        .filter((e) => !ALWAYS_SKIP.has(e.name))
+        .sort((a, b) => {
+        // Directories first, then alphabetical
+        if (a.isDirectory() && !b.isDirectory())
+            return -1;
+        if (!a.isDirectory() && b.isDirectory())
+            return 1;
+        return a.name.localeCompare(b.name);
+    });
+    for (let i = 0; i < filtered.length; i++) {
+        if (counter.count >= counter.max) {
+            lines.push(`${prefix}... [truncated at ${counter.max} items]`);
+            return;
+        }
+        const entry = filtered[i];
+        const isLast = i === filtered.length - 1;
+        const connector = isLast ? "└── " : "├── ";
+        const childPrefix = isLast ? "    " : "│   ";
+        if (entry.isDirectory()) {
+            lines.push(`${prefix}${connector}${entry.name}/`);
+            counter.count++;
+            buildTree(path.join(dir, entry.name), prefix + childPrefix, maxDepth, currentDepth + 1, lines, counter);
+        }
+        else {
+            lines.push(`${prefix}${connector}${entry.name}`);
+            counter.count++;
+        }
+    }
+}
+//# sourceMappingURL=tree.js.map

package/dist/context-providers/tree.js.map

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

package/dist/context-providers/types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Context Provider Types — Defines the contract for all context providers.
+ *
+ * Learning note: Using interfaces (not classes) keeps this flexible.
+ * Any object that satisfies these shapes can be a context provider,
+ * whether it's a simple object literal or a full class instance.
+ */
+/**
+ * The result returned by a context provider after resolving.
+ * Contains the formatted content ready to inject into the prompt.
+ */
+export interface ContextResult {
+    /** Human-readable label shown in the UI (e.g., "Terminal Output") */
+    label: string;
+    /** The actual content to inject into the conversation */
+    content: string;
+    /** Optional metadata for display purposes */
+    metadata?: {
+        source?: string;
+        truncated?: boolean;
+        itemCount?: number;
+    };
+}
+/**
+ * A context provider resolves an @ mention into content.
+ *
+ * Example: "@terminal" → last terminal output
+ *          "@url https://example.com" → fetched page content
+ */
+export interface ContextProvider {
+    /** Unique identifier (e.g., "terminal", "open", "url") */
+    id: string;
+    /** The @ trigger keyword (e.g., "@terminal") */
+    trigger: string;
+    /** Short description shown in autocomplete */
+    description: string;
+    /**
+     * Whether this provider needs an argument after the trigger.
+     * E.g., "@url" needs a URL, but "@terminal" doesn't.
+     */
+    requiresArg: boolean;
+    /**
+     * Resolve the context — fetch the actual content.
+     *
+     * @param arg - Optional argument (e.g., URL for @url provider)
+     * @param options - Runtime context (working dir, VS Code API, etc.)
+     * @returns The resolved context content
+     */
+    resolve(arg?: string, options?: ContextResolveOptions): Promise<ContextResult>;
+}
+/**
+ * Options passed to context providers at resolve time.
+ * Provides access to runtime environment without tight coupling.
+ */
+export interface ContextResolveOptions {
+    /** Current working directory */
+    workingDir?: string;
+    /** Open file paths (for @open provider) */
+    openFiles?: string[];
+    /** Recent terminal output (for @terminal provider) */
+    terminalOutput?: string;
+    /** Diagnostics/problems (for @problems provider) */
+    diagnostics?: Array<{
+        file: string;
+        line: number;
+        severity: "error" | "warning" | "info" | "hint";
+        message: string;
+    }>;
+    /** Max content length (chars) before truncation */
+    maxContentLength?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/context-providers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context-providers/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IAEd,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAEhB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IAEX,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAEhB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IAErB;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAChF;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,oDAAoD;IACpD,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;QAChD,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IAEH,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/context-providers/types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Context Provider Types — Defines the contract for all context providers.
+ *
+ * Learning note: Using interfaces (not classes) keeps this flexible.
+ * Any object that satisfies these shapes can be a context provider,
+ * whether it's a simple object literal or a full class instance.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map