@pellux/goodvibes-sdk 0.18.3 → 0.18.11

package/dist/platform/integrations/slack.js

@@ -0,0 +1,374 @@
+import { createHmac, timingSafeEqual } from 'crypto';
+import { logger } from '../utils/logger.js';
+import { summarizeError } from '../utils/error-display.js';
+// ---------------------------------------------------------------------------
+// SlackIntegration
+// ---------------------------------------------------------------------------
+/**
+ * SlackIntegration — handles inbound webhook verification/parsing and outbound
+ * message posting for Slack slash commands and interactions.
+ *
+ * Env vars:
+ *   SLACK_WEBHOOK_URL      — incoming webhook URL for outbound posting
+ *   SLACK_BOT_TOKEN        — Bot User OAuth token (xoxb-…) for API calls
+ *   SLACK_SIGNING_SECRET   — used to verify X-Slack-Signature on inbound
+ */
+export class SlackIntegration {
+    webhookUrl;
+    botToken;
+    constructor(webhookUrl, botToken) {
+        this.webhookUrl = webhookUrl;
+        this.botToken = botToken;
+    }
+    static buildOAuthAuthorizeUrl(options) {
+        const url = new URL('https://slack.com/oauth/v2/authorize');
+        url.searchParams.set('client_id', options.clientId);
+        const scopes = options.scopes?.length ? options.scopes : ['commands', 'chat:write'];
+        url.searchParams.set('scope', scopes.join(','));
+        if (options.userScopes?.length)
+            url.searchParams.set('user_scope', options.userScopes.join(','));
+        if (options.redirectUri)
+            url.searchParams.set('redirect_uri', options.redirectUri);
+        if (options.state)
+            url.searchParams.set('state', options.state);
+        if (options.teamId)
+            url.searchParams.set('team', options.teamId);
+        return url.toString();
+    }
+    async authTest(token = this.botToken) {
+        return this.callApi('auth.test', {}, token);
+    }
+    async appsConnectionsOpen(appToken) {
+        return this.callApi('apps.connections.open', {}, appToken);
+    }
+    async exchangeOAuthCode(options) {
+        const body = new URLSearchParams({
+            client_id: options.clientId,
+            client_secret: options.clientSecret,
+            code: options.code,
+        });
+        if (options.redirectUri)
+            body.set('redirect_uri', options.redirectUri);
+        const res = await fetch('https://slack.com/api/oauth.v2.access', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded',
+            },
+            body,
+        });
+        if (!res.ok) {
+            const err = await res.text();
+            throw new Error(`SlackIntegration.exchangeOAuthCode failed (${res.status}): ${err}`);
+        }
+        return await res.json();
+    }
+    async listConversations(options = {}) {
+        const data = await this.callApi('conversations.list', {
+            limit: String(Math.max(1, Math.min(1000, options.limit ?? 200))),
+            types: (options.types?.length ? options.types : ['public_channel', 'private_channel', 'mpim', 'im']).join(','),
+            exclude_archived: options.excludeArchived === false ? 'false' : 'true',
+            ...(options.cursor ? { cursor: options.cursor } : {}),
+            ...(options.teamId ? { team_id: options.teamId } : {}),
+        }, options.token ?? this.botToken);
+        return {
+            ok: data.ok,
+            entries: data.channels ?? [],
+            nextCursor: data.response_metadata?.next_cursor ?? '',
+            ...(data.error ? { error: data.error } : {}),
+        };
+    }
+    async listUsers(options = {}) {
+        const data = await this.callApi('users.list', {
+            limit: String(Math.max(1, Math.min(1000, options.limit ?? 200))),
+            ...(options.cursor ? { cursor: options.cursor } : {}),
+            ...(options.teamId ? { team_id: options.teamId } : {}),
+        }, options.token ?? this.botToken);
+        return {
+            ok: data.ok,
+            entries: data.members ?? [],
+            nextCursor: data.response_metadata?.next_cursor ?? '',
+            ...(data.error ? { error: data.error } : {}),
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Inbound: verification
+    // -------------------------------------------------------------------------
+    /**
+     * Verify an inbound Slack request using HMAC-SHA256.
+     * Slack signs requests with: v0={HMAC-SHA256("v0:{timestamp}:{body}")}
+     */
+    verifySignature(body, timestamp, signature, signingSecret) {
+        // Guard against replay attacks (5-minute window)
+        const now = Math.floor(Date.now() / 1000);
+        const ts = parseInt(timestamp, 10);
+        if (Number.isNaN(ts) || Math.abs(now - ts) > 300) {
+            logger.warn('SlackIntegration.verifySignature: timestamp too old');
+            return false;
+        }
+        const baseString = `v0:${timestamp}:${body}`;
+        const hmac = createHmac('sha256', signingSecret).update(baseString).digest('hex');
+        const expected = `v0=${hmac}`;
+        if (expected.length !== signature.length)
+            return false;
+        return timingSafeEqual(Buffer.from(expected), Buffer.from(signature));
+    }
+    // -------------------------------------------------------------------------
+    // Inbound: parsing
+    // -------------------------------------------------------------------------
+    /**
+     * Parse an inbound Slack payload into a typed SlackEvent.
+     * Supports slash commands (application/x-www-form-urlencoded) and
+     * interaction payloads (JSON-encoded in a "payload" field).
+     */
+    parseEvent(body) {
+        // Interaction payloads arrive as a JSON string in the "payload" field
+        if (typeof body.payload === 'string' || (typeof body.payload === 'object' && body.payload !== null)) {
+            let parsed;
+            if (typeof body.payload === 'string') {
+                try {
+                    parsed = JSON.parse(body.payload);
+                }
+                catch {
+                    parsed = body;
+                }
+            }
+            else {
+                parsed = body.payload;
+            }
+            const user = (parsed.user ?? {});
+            const channel = (parsed.channel ?? {});
+            return {
+                type: 'interaction',
+                interactionType: typeof parsed.type === 'string' ? parsed.type : 'unknown',
+                payload: parsed,
+                userId: typeof user.id === 'string' ? user.id : '',
+                channelId: typeof channel.id === 'string' ? channel.id : '',
+                responseUrl: typeof parsed.response_url === 'string' ? parsed.response_url : undefined,
+            };
+        }
+        const eventPayload = (body.event ?? null);
+        if (body.type === 'event_callback' && eventPayload && typeof eventPayload === 'object') {
+            return {
+                type: 'event_callback',
+                eventType: typeof eventPayload.type === 'string' ? eventPayload.type : 'unknown',
+                text: typeof eventPayload.text === 'string' ? eventPayload.text : '',
+                userId: typeof eventPayload.user === 'string' ? eventPayload.user : '',
+                channelId: typeof eventPayload.channel === 'string' ? eventPayload.channel : '',
+                teamId: typeof body.team_id === 'string' ? body.team_id : '',
+                threadTs: typeof eventPayload.thread_ts === 'string' ? eventPayload.thread_ts : undefined,
+                eventTs: typeof eventPayload.ts === 'string' ? eventPayload.ts : undefined,
+                raw: body,
+            };
+        }
+        if (typeof body.type === 'string' && (body.type === 'block_actions' || body.type === 'message_action' || body.type === 'view_submission')) {
+            const user = (body.user ?? {});
+            const channel = (body.channel ?? {});
+            return {
+                type: 'interaction',
+                interactionType: body.type,
+                payload: body,
+                userId: typeof user.id === 'string' ? user.id : '',
+                channelId: typeof channel.id === 'string' ? channel.id : '',
+                responseUrl: typeof body.response_url === 'string' ? body.response_url : undefined,
+            };
+        }
+        // Slash command — fields come as top-level form values
+        return {
+            type: 'slash_command',
+            command: typeof body.command === 'string' ? body.command : '',
+            text: typeof body.text === 'string' ? body.text : '',
+            userId: typeof body.user_id === 'string' ? body.user_id : '',
+            userName: typeof body.user_name === 'string' ? body.user_name : '',
+            channelId: typeof body.channel_id === 'string' ? body.channel_id : '',
+            channelName: typeof body.channel_name === 'string' ? body.channel_name : '',
+            teamId: typeof body.team_id === 'string' ? body.team_id : '',
+            responseUrl: typeof body.response_url === 'string' ? body.response_url : '',
+        };
+    }
+    async callApi(method, params = {}, token = this.botToken) {
+        if (!token) {
+            throw new Error(`SlackIntegration: token is required for ${method}`);
+        }
+        const body = new URLSearchParams(params);
+        const res = await fetch(`https://slack.com/api/${method}`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/x-www-form-urlencoded',
+                Authorization: `Bearer ${token}`,
+            },
+            body,
+        });
+        if (!res.ok) {
+            const err = await res.text();
+            throw new Error(`SlackIntegration.${method} failed (${res.status}): ${err}`);
+        }
+        return await res.json();
+    }
+    // -------------------------------------------------------------------------
+    // Outbound: posting
+    // -------------------------------------------------------------------------
+    /**
+     * Post a message to a channel using the Slack Web API (chat.postMessage).
+     * Requires SLACK_BOT_TOKEN.
+     */
+    async postMessage(channel, text, blocks) {
+        if (!this.botToken) {
+            throw new Error('SlackIntegration: botToken is required for postMessage');
+        }
+        const payload = { channel, text };
+        if (blocks && blocks.length > 0) {
+            payload.blocks = blocks;
+        }
+        const res = await fetch('https://slack.com/api/chat.postMessage', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json; charset=utf-8',
+                Authorization: `Bearer ${this.botToken}`,
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!res.ok) {
+            const err = await res.text();
+            throw new Error(`SlackIntegration.postMessage failed (${res.status}): ${err}`);
+        }
+        const data = (await res.json());
+        if (!data.ok) {
+            throw new Error(`SlackIntegration.postMessage API error: ${data.error ?? 'unknown'}`);
+        }
+    }
+    /**
+     * Post a message via an Incoming Webhook URL.
+     * Requires SLACK_WEBHOOK_URL or a URL passed at call time.
+     */
+    async postWebhook(text, blocks, url) {
+        const target = url ?? this.webhookUrl;
+        if (!target) {
+            throw new Error('SlackIntegration: webhookUrl is required for postWebhook');
+        }
+        const payload = { text };
+        if (blocks && blocks.length > 0) {
+            payload.blocks = blocks;
+        }
+        const res = await fetch(target, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(payload),
+        });
+        if (!res.ok) {
+            const err = await res.text();
+            throw new Error(`SlackIntegration.postWebhook failed (${res.status}): ${err}`);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Formatting helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Format an agent result as Slack Block Kit blocks.
+     */
+    formatAgentResult(agentId, task, result) {
+        const truncated = result.length > 2900 ? `${result.slice(0, 2900)}\n\n_…truncated_` : result;
+        return [
+            {
+                type: 'header',
+                text: { type: 'plain_text', text: 'Agent Complete', emoji: true },
+            },
+            {
+                type: 'section',
+                fields: [
+                    { type: 'mrkdwn', text: `*Task:*\n${task}` },
+                    { type: 'mrkdwn', text: `*Agent ID:*\n\`${agentId}\`` },
+                ],
+            },
+            { type: 'divider' },
+            {
+                type: 'section',
+                text: { type: 'mrkdwn', text: truncated },
+            },
+        ];
+    }
+    /**
+     * Format a session summary as Slack Block Kit blocks.
+     */
+    formatSessionSummary(sessionId, messageCount, tokensUsed) {
+        return [
+            {
+                type: 'header',
+                text: { type: 'plain_text', text: 'Session Summary', emoji: true },
+            },
+            {
+                type: 'section',
+                fields: [
+                    { type: 'mrkdwn', text: `*Session ID:*\n\`${sessionId}\`` },
+                    { type: 'mrkdwn', text: `*Messages:*\n${messageCount}` },
+                    { type: 'mrkdwn', text: `*Tokens Used:*\n${tokensUsed.toLocaleString()}` },
+                ],
+            },
+        ];
+    }
+}
+export class SlackSocketModeClient {
+    options;
+    socket = null;
+    started = false;
+    WebSocketImpl;
+    constructor(options) {
+        this.options = options;
+        this.WebSocketImpl = options.WebSocketImpl ?? WebSocket;
+    }
+    async start() {
+        if (this.started) {
+            return { ok: true, url: undefined };
+        }
+        const connection = await this.options.integration.appsConnectionsOpen(this.options.appToken);
+        if (!connection.ok || !connection.url) {
+            return connection;
+        }
+        this.started = true;
+        const socket = new this.WebSocketImpl(connection.url);
+        this.socket = socket;
+        socket.addEventListener('message', (event) => {
+            void this.handleMessage(event.data);
+        });
+        socket.addEventListener('close', () => {
+            this.started = false;
+            this.socket = null;
+        });
+        return connection;
+    }
+    stop() {
+        this.started = false;
+        this.socket?.close();
+        this.socket = null;
+    }
+    ack(envelopeId, payload) {
+        this.send({
+            envelope_id: envelopeId,
+            ...(payload ? { payload } : {}),
+        });
+    }
+    send(payload) {
+        if (!this.socket || this.socket.readyState !== this.WebSocketImpl.OPEN)
+            return;
+        this.socket.send(JSON.stringify(payload));
+    }
+    get isStarted() {
+        return this.started;
+    }
+    async handleMessage(data) {
+        const raw = typeof data === 'string' ? data : data instanceof Buffer ? data.toString('utf-8') : String(data);
+        let envelope;
+        try {
+            envelope = JSON.parse(raw);
+        }
+        catch (error) {
+            logger.warn('SlackSocketModeClient: invalid JSON envelope', {
+                error: summarizeError(error),
+            });
+            return;
+        }
+        if (envelope.envelope_id) {
+            this.ack(envelope.envelope_id);
+        }
+        await this.options.onEnvelope(envelope, this);
+    }
+}

package/dist/platform/intelligence/config.d.ts

@@ -0,0 +1,35 @@
+import type { ShellPathService } from '../runtime/shell-paths.js';
+export interface LanguageConfig {
+    lsp?: {
+        command: string;
+        args: string[];
+        initializationOptions?: Record<string, unknown>;
+    };
+    /** Grammar ID passed to the tree-sitter service (usually the same as langId). */
+    treeSitter?: string;
+    formatter?: {
+        command: string;
+        args: string[];
+    };
+    linter?: {
+        command: string;
+        args: string[];
+    };
+}
+export type IntelligenceRoots = Pick<ShellPathService, 'workingDirectory' | 'homeDirectory'>;
+/**
+ * Built-in defaults for common languages.
+ * These are used when no user or project override exists.
+ */
+export declare function getDefaultConfigs(): Map<string, LanguageConfig>;
+/**
+ * Load all language configs, merging defaults with user and project overrides.
+ * Project-level configs override user-level, which override defaults.
+ */
+export declare function loadLanguageConfigs(roots: IntelligenceRoots): Map<string, LanguageConfig>;
+/**
+ * Get config for a specific language ID.
+ * Loads configs on demand.
+ */
+export declare function getLanguageConfig(langId: string, roots: IntelligenceRoots): LanguageConfig | null;
+//# sourceMappingURL=config.d.ts.map

package/dist/platform/intelligence/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/platform/intelligence/config.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjD,CAAC;IACF,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAChD,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,GAAG,eAAe,CAAC,CAAC;AAM7F;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAsD/D;AAuBD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAwBzF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,GAAG,cAAc,GAAG,IAAI,CAEjG"}

package/dist/platform/intelligence/config.js

@@ -0,0 +1,116 @@
+/**
+ * Per-language configuration for CodeIntelligence.
+ *
+ * Config is loaded from (in priority order, higher overrides lower):
+ *   1. .goodvibes/sdk/languages/{langId}.json  (project-level)
+ *   2. ~/.goodvibes/sdk/languages/{langId}.json (user-level)
+ *   3. Built-in defaults (this file)
+ */
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { logger } from '../utils/logger.js';
+import { summarizeError } from '../utils/error-display.js';
+// ---------------------------------------------------------------------------
+// Default configurations
+// ---------------------------------------------------------------------------
+/**
+ * Built-in defaults for common languages.
+ * These are used when no user or project override exists.
+ */
+export function getDefaultConfigs() {
+    const defaults = new Map();
+    defaults.set('typescript', {
+        lsp: { command: 'typescript-language-server', args: ['--stdio'] },
+        treeSitter: 'typescript',
+    });
+    defaults.set('tsx', {
+        lsp: { command: 'typescript-language-server', args: ['--stdio'] },
+        treeSitter: 'tsx',
+    });
+    defaults.set('javascript', {
+        lsp: { command: 'typescript-language-server', args: ['--stdio'] },
+        treeSitter: 'javascript',
+    });
+    defaults.set('python', {
+        lsp: { command: 'pyright-langserver', args: ['--stdio'] },
+        treeSitter: 'python',
+    });
+    defaults.set('rust', {
+        lsp: { command: 'rust-analyzer', args: [] },
+        treeSitter: 'rust',
+    });
+    defaults.set('go', {
+        lsp: { command: 'gopls', args: ['serve'] },
+        treeSitter: 'go',
+    });
+    defaults.set('bash', {
+        lsp: { command: 'bash-language-server', args: ['start'] },
+        treeSitter: 'bash',
+    });
+    defaults.set('css', {
+        lsp: { command: 'vscode-css-language-server', args: ['--stdio'] },
+        treeSitter: 'css',
+    });
+    defaults.set('html', {
+        lsp: { command: 'vscode-html-language-server', args: ['--stdio'] },
+        treeSitter: 'html',
+    });
+    defaults.set('json', {
+        lsp: { command: 'vscode-json-language-server', args: ['--stdio'] },
+        treeSitter: 'json',
+    });
+    return defaults;
+}
+// ---------------------------------------------------------------------------
+// Config loading
+// ---------------------------------------------------------------------------
+/**
+ * Read a JSON config file from disk, returning null on any error.
+ */
+function readConfigFile(filePath) {
+    try {
+        if (!existsSync(filePath))
+            return null;
+        const raw = readFileSync(filePath, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch (err) {
+        logger.debug('config: failed to read language config', {
+            filePath,
+            error: summarizeError(err),
+        });
+        return null;
+    }
+}
+/**
+ * Load all language configs, merging defaults with user and project overrides.
+ * Project-level configs override user-level, which override defaults.
+ */
+export function loadLanguageConfigs(roots) {
+    const result = getDefaultConfigs();
+    const userDir = join(roots.homeDirectory, '.goodvibes', 'sdk', 'languages');
+    const projectDir = join(roots.workingDirectory, '.goodvibes', 'sdk', 'languages');
+    // Collect all known language IDs (from defaults + scan would go here).
+    // For now we apply overrides only for IDs we already know about.
+    for (const [langId, defaultCfg] of result.entries()) {
+        // User-level override
+        const userCfg = readConfigFile(join(userDir, `${langId}.json`));
+        // Project-level override
+        const projectCfg = readConfigFile(join(projectDir, `${langId}.json`));
+        // Merge: defaults < user < project
+        const merged = {
+            ...defaultCfg,
+            ...(userCfg ?? {}),
+            ...(projectCfg ?? {}),
+        };
+        result.set(langId, merged);
+    }
+    return result;
+}
+/**
+ * Get config for a specific language ID.
+ * Loads configs on demand.
+ */
+export function getLanguageConfig(langId, roots) {
+    return loadLanguageConfigs(roots).get(langId) ?? null;
+}

package/dist/platform/intelligence/facade.d.ts

@@ -0,0 +1,99 @@
+import { TreeSitterService } from './tree-sitter/service.js';
+import type { Tree, Language } from 'web-tree-sitter';
+/** Result of parsing a file with tree-sitter. */
+export interface ParseResult {
+    tree: Tree;
+    language: Language;
+    lang: string;
+}
+import { LspService } from './lsp/service.js';
+import type { SymbolInfo, OutlineEntry } from './tree-sitter/queries.js';
+import type { Location, DocumentSymbol, Diagnostic, Hover } from './lsp/protocol.js';
+import type { ShellPathService } from '../runtime/shell-paths.js';
+/**
+ * Convert a filesystem path to a file:// URI.
+ * Correctly handles paths with spaces and special characters.
+ */
+export declare function pathToUri(filePath: string): string;
+/**
+ * Convert a file:// URI back to a filesystem path.
+ * Correctly handles percent-encoded URIs.
+ */
+export declare function uriToPath(uri: string): string;
+export declare class CodeIntelligence {
+    private treeSitter;
+    private lsp;
+    private readonly shellPaths;
+    constructor(options?: {
+        shellPaths?: Pick<ShellPathService, 'workingDirectory' | 'homeDirectory' | 'resolveProjectPath'>;
+        treeSitter?: TreeSitterService;
+        lsp?: LspService;
+    });
+    /**
+     * Initialize all services. Call once at startup.
+     * Loads language configs and registers LSP server commands with LspService
+     * so that user/project overrides in .goodvibes/sdk/languages/ are respected.
+     */
+    initialize(): Promise<void>;
+    /** Shutdown all owned services for this facade instance. */
+    dispose(): Promise<void>;
+    /**
+     * Parse a file and load its tree-sitter language in one step.
+     * Returns null if the language is unknown or grammar unavailable.
+     */
+    private _parseFile;
+    /** Detect the language of a file by its extension. */
+    detectLanguage(filePath: string): string | null;
+    /** Check if a tree-sitter grammar is loaded for a file's language. */
+    hasTreeSitter(filePath: string): boolean;
+    /**
+     * Parse a file and extract symbols.
+     * Returns empty array if no grammar is loaded for the language.
+     */
+    getSymbols(filePath: string, content: string): Promise<SymbolInfo[]>;
+    /**
+     * Parse a file and extract an outline (signatures only).
+     * Returns empty array if no grammar is loaded for the language.
+     */
+    getOutline(filePath: string, content: string): Promise<OutlineEntry[]>;
+    /**
+     * Find the scope (function/class) enclosing a line.
+     * Returns null if unavailable.
+     */
+    getEnclosingScope(filePath: string, content: string, line: number): Promise<{
+        kind: string;
+        name: string;
+        startLine: number;
+        endLine: number;
+    } | null>;
+    /** Check if an LSP server is available for a file's language. */
+    hasLsp(filePath: string): Promise<boolean>;
+    /**
+     * Get definition location.
+     * Returns null if LSP not available for the file's language.
+     */
+    getDefinition(filePath: string, line: number, column: number): Promise<Location | null>;
+    /**
+     * Get all references to a symbol.
+     * Returns empty array if LSP not available.
+     */
+    getReferences(filePath: string, line: number, column: number): Promise<Location[]>;
+    /**
+     * Get document symbols.
+     * Tries LSP first; falls back to tree-sitter if LSP is unavailable.
+     */
+    getDocumentSymbols(filePath: string, content: string): Promise<DocumentSymbol[] | SymbolInfo[]>;
+    /**
+     * Get hover information.
+     * Returns null if LSP not available.
+     */
+    getHover(filePath: string, line: number, column: number): Promise<Hover | null>;
+    /**
+     * Get diagnostics for a file.
+     * Returns empty array if LSP not available.
+     * Note: LSP pushes diagnostics via textDocument/publishDiagnostics notifications;
+     * this method is a best-effort pull (not all servers support textDocument/diagnostic).
+     */
+    getDiagnostics(filePath: string): Promise<Diagnostic[]>;
+}
+//# sourceMappingURL=facade.d.ts.map

package/dist/platform/intelligence/facade.d.ts.map

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