@kortix/sdk 0.9.98

package/dist/state/diagnostics-store.js

@@ -0,0 +1,319 @@
+'use client';
+import { create } from 'zustand';
+import { persist } from 'zustand/middleware';
+// ============================================================================
+// Path matching helpers
+// ============================================================================
+/**
+ * Find diagnostics for a file using flexible path matching.
+ *
+ * LSP servers store diagnostics keyed by absolute sandbox paths (e.g.
+ * `/workspace/desktop/express-crud-app/src/server.js`), but the frontend
+ * uses project-relative paths (e.g. `src/server.js`). This function
+ * handles the mismatch by:
+ *
+ *  1. Exact match (covers relative-to-relative)
+ *  2. The store key ends with `/<relativePath>` (abs→rel match)
+ *  3. The lookup path ends with `/<storeKey>` (rel→abs, unlikely but safe)
+ */
+export function findDiagnosticsForFile(byFile, filePath) {
+    // 1. Exact match
+    if (byFile[filePath])
+        return byFile[filePath];
+    // Normalise: strip leading slashes and any `file://` prefix for comparison
+    const cleanPath = filePath.replace(/^file:\/\//, '').replace(/^\/+/, '');
+    // 2. Store key ends with the relative path
+    for (const key of Object.keys(byFile)) {
+        const cleanKey = key.replace(/^file:\/\//, '').replace(/^\/+/, '');
+        // Exact after normalisation
+        if (cleanKey === cleanPath)
+            return byFile[key];
+        // Store key is absolute, lookup path is relative
+        if (cleanKey.endsWith('/' + cleanPath))
+            return byFile[key];
+        // Lookup path is absolute, store key is relative (rare)
+        if (cleanPath.endsWith('/' + cleanKey))
+            return byFile[key];
+    }
+    return undefined;
+}
+/**
+ * Build a map from relative file path → { errors, warnings } by iterating
+ * the diagnostics store. Uses the last N segments of each store key so that
+ * both `sidebar-explorer` (uses `node.path` which is relative) and
+ * `file-browser` can compute diagnostic counts.
+ *
+ * Returns a map where keys are every possible suffix of the store keys
+ * (e.g. for `/workspace/project/src/app.ts` it includes entries for
+ * `src/app.ts`, `project/src/app.ts`, `app.ts`, etc.) This is O(totalKeys * avgDepth)
+ * but in practice the number of files with diagnostics is small.
+ */
+export function buildDiagnosticCountsMap(byFile) {
+    const map = {};
+    for (const [key, diags] of Object.entries(byFile)) {
+        if (!diags || diags.length === 0)
+            continue;
+        let errors = 0;
+        let warnings = 0;
+        for (const d of diags) {
+            if (d.severity === 1)
+                errors++;
+            else if (d.severity === 2)
+                warnings++;
+        }
+        if (errors === 0 && warnings === 0)
+            continue;
+        const counts = { errors, warnings };
+        // Register under every suffix of the path so both absolute and
+        // relative lookups work.
+        const cleanKey = key.replace(/^file:\/\//, '');
+        const parts = cleanKey.split('/').filter(Boolean);
+        // Full path (with leading slash removed)
+        map[parts.join('/')] = counts;
+        // Also register with leading slash for absolute lookups
+        if (cleanKey.startsWith('/')) {
+            map[cleanKey] = counts;
+        }
+        // Progressive suffixes: src/app.ts, app.ts
+        for (let i = 1; i < parts.length; i++) {
+            const suffix = parts.slice(i).join('/');
+            // Don't overwrite — first match (longest key) wins
+            if (!map[suffix]) {
+                map[suffix] = counts;
+            }
+        }
+    }
+    return map;
+}
+/**
+ * Extract the relative filename from a diagnostic's file path.
+ * Used by the diagnostics panel to show short names.
+ */
+export function getRelativePath(absPath) {
+    const clean = absPath.replace(/^file:\/\//, '');
+    // If it looks absolute, try common sandbox prefixes
+    if (clean.startsWith('/')) {
+        // Strip /workspace/desktop/.../ or /home/user/project/.../ patterns
+        // Strategy: find the deepest "project root" heuristic and strip it
+        // Common patterns: /workspace/X/Y/ where Y is the project
+        const parts = clean.split('/').filter(Boolean);
+        // Look for common project markers going from right to left
+        for (let i = 0; i < parts.length; i++) {
+            if (['src', 'lib', 'app', 'pages', 'components', 'public', 'test', 'tests', 'pkg', 'cmd', 'internal'].includes(parts[i])) {
+                return parts.slice(i).join('/');
+            }
+        }
+        // If no marker found, take the last 3 segments max
+        if (parts.length > 3) {
+            return parts.slice(-3).join('/');
+        }
+        return parts.join('/');
+    }
+    return clean;
+}
+// ============================================================================
+// Parse diagnostics from tool output text
+// ============================================================================
+/**
+ * Parse diagnostics from OpenCode tool output text.
+ *
+ * The Go backend embeds diagnostics as plain text in `<file_diagnostics>`
+ * and `<project_diagnostics>` XML tags within the tool result. Each line
+ * follows the format:
+ *
+ *   Severity: /path/to/file.ts:line:col [source][code] (tags) message
+ *
+ * Examples:
+ *   Error: /workspace/src/server.js:4:1 [typescript] Cannot find module './utils/nonexistent'
+ *   Warn: /workspace/src/server.js:5:7 [typescript][6133] (unnecessary) 'unused_import' is declared but never read
+ */
+export function parseDiagnosticsFromToolOutput(output) {
+    const result = {};
+    // Extract content from both tag types
+    const tagPattern = /<(?:file_diagnostics|project_diagnostics)>([\s\S]*?)<\/(?:file_diagnostics|project_diagnostics)>/g;
+    let tagMatch;
+    const allLines = [];
+    while ((tagMatch = tagPattern.exec(output)) !== null) {
+        const content = tagMatch[1].trim();
+        if (content) {
+            for (const line of content.split('\n')) {
+                const trimmed = line.trim();
+                if (trimmed && !trimmed.startsWith('...')) {
+                    allLines.push(trimmed);
+                }
+            }
+        }
+    }
+    if (allLines.length === 0)
+        return result;
+    // Parse each diagnostic line
+    // Format: Severity: /path/to/file:line:col [source][code] (tags) message
+    const linePattern = /^(Error|Warn|Info|Hint):\s+(.+?):(\d+):(\d+)\s+\[([^\]]*)\](.*)$/;
+    for (const line of allLines) {
+        const match = linePattern.exec(line);
+        if (!match)
+            continue;
+        const [, severityStr, filePath, lineStr, colStr, source, rest] = match;
+        const severity = severityStr === 'Error' ? 1 :
+            severityStr === 'Warn' ? 2 :
+                severityStr === 'Hint' ? 4 : 3;
+        // Parse optional [code] and message from the rest
+        // rest might be: [6133] (unnecessary) message text
+        //            or: message text
+        let message = rest.trim();
+        // Strip optional [code] prefix
+        message = message.replace(/^\[\w+\]\s*/, '');
+        // Strip optional (tags) prefix
+        message = message.replace(/^\([^)]*\)\s*/, '');
+        const lineNum = parseInt(lineStr, 10) - 1; // Convert to 0-indexed
+        const colNum = parseInt(colStr, 10) - 1;
+        const diag = {
+            file: filePath,
+            line: Math.max(0, lineNum),
+            column: Math.max(0, colNum),
+            severity,
+            message: message || `${severityStr} at ${lineStr}:${colStr}`,
+            source: source || undefined,
+        };
+        if (!result[filePath]) {
+            result[filePath] = [];
+        }
+        result[filePath].push(diag);
+    }
+    return result;
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function normalizeRawDiagnostic(file, raw) {
+    const line = raw.range?.start?.line ?? raw.line ?? 0;
+    const column = raw.range?.start?.character ?? raw.column ?? raw.character ?? 0;
+    const endLine = raw.range?.end?.line ?? raw.endLine;
+    const endColumn = raw.range?.end?.character ?? raw.endColumn;
+    const severity = (raw.severity ?? 1);
+    return {
+        file,
+        line,
+        column,
+        endLine,
+        endColumn,
+        severity,
+        message: raw.message,
+        source: raw.source,
+    };
+}
+// ============================================================================
+// Store
+// ============================================================================
+export const useDiagnosticsStore = create()(persist((set, get) => ({
+    byFile: {},
+    setFileDiagnostics: (file, diagnostics) => set((state) => ({
+        byFile: {
+            ...state.byFile,
+            [file]: diagnostics,
+        },
+    })),
+    setFromLspEvent: (diagnosticsByFile) => set((state) => {
+        const next = { ...state.byFile };
+        for (const [file, rawDiags] of Object.entries(diagnosticsByFile)) {
+            if (!Array.isArray(rawDiags))
+                continue;
+            const normalized = rawDiags.map((d) => normalizeRawDiagnostic(file, d));
+            if (normalized.length === 0) {
+                delete next[file];
+            }
+            else {
+                next[file] = normalized;
+            }
+        }
+        return { byFile: next };
+    }),
+    clearFile: (file) => set((state) => {
+        const { [file]: _, ...rest } = state.byFile;
+        return { byFile: rest };
+    }),
+    clearAll: () => set({ byFile: {} }),
+    getErrorCount: () => {
+        const { byFile } = get();
+        let count = 0;
+        for (const diags of Object.values(byFile)) {
+            for (const d of diags) {
+                if (d.severity === 1)
+                    count++;
+            }
+        }
+        return count;
+    },
+    getWarningCount: () => {
+        const { byFile } = get();
+        let count = 0;
+        for (const diags of Object.values(byFile)) {
+            for (const d of diags) {
+                if (d.severity === 2)
+                    count++;
+            }
+        }
+        return count;
+    },
+    getAllDiagnostics: () => {
+        const { byFile } = get();
+        const all = [];
+        for (const diags of Object.values(byFile)) {
+            all.push(...diags);
+        }
+        // Sort: errors first, then warnings, then by file, then by line
+        all.sort((a, b) => {
+            if (a.severity !== b.severity)
+                return a.severity - b.severity;
+            if (a.file !== b.file)
+                return a.file.localeCompare(b.file);
+            return a.line - b.line;
+        });
+        return all;
+    },
+}), {
+    name: 'kortix-diagnostics',
+    storage: {
+        // Guarded with try/catch (not just `typeof window`): React Native sets a
+        // global `window` shim but has no `sessionStorage`, so a bare reference
+        // throws a ReferenceError there. Degrading to "diagnostics didn't
+        // persist" is fine; crashing the store is not.
+        getItem: (name) => {
+            try {
+                if (typeof window === 'undefined' || typeof sessionStorage === 'undefined')
+                    return null;
+                const str = sessionStorage.getItem(name);
+                return str ? JSON.parse(str) : null;
+            }
+            catch {
+                return null;
+            }
+        },
+        setItem: (name, value) => {
+            try {
+                if (typeof window === 'undefined' || typeof sessionStorage === 'undefined')
+                    return;
+                sessionStorage.setItem(name, JSON.stringify(value));
+            }
+            catch {
+                /* ignore — quota or unavailable storage */
+            }
+        },
+        removeItem: (name) => {
+            try {
+                if (typeof window === 'undefined' || typeof sessionStorage === 'undefined')
+                    return;
+                sessionStorage.removeItem(name);
+            }
+            catch {
+                /* ignore */
+            }
+        },
+    },
+    partialize: (state) => ({ byFile: state.byFile }),
+}));
+// Expose on window for console debugging
+if (typeof window !== 'undefined') {
+    window.__diagStore = useDiagnosticsStore;
+}
+//# sourceMappingURL=diagnostics-store.js.map

package/dist/state/diagnostics-store.js.map

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

package/dist/state/event-stream.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Framework-free SSE event-stream machine, extracted verbatim (same constants,
+ * same branch order, same semantics) from the connect/reconnect loop that used
+ * to live inline inside `react/use-opencode-events/index.ts`'s `useEffect`.
+ *
+ * Zero imports of `react`, `react-query`, or any `react/*` module — this file
+ * can run in any JS host (a worker, a CLI, a non-React UI). Everything that
+ * depended on React Query in the original hook (cache writes, toasts, ref
+ * lookups) stays in the React wrapper and reaches this module only through the
+ * injected `onEvent` / `onGapRehydrate` callbacks.
+ *
+ * Owns: connecting to the opencode SSE endpoint (with a connect timeout), the
+ * idle heartbeat watchdog, event coalescing + 16ms flush batching, gap
+ * detection on reconnect, the exponential-backoff reconnect loop (fast 250ms
+ * resume after an eventful stream, capped exponential backoff otherwise), and
+ * the give-up "parked" terminal state for streams pointed at dead sandboxes
+ * (see `maxConsecutiveHardFailures`/`onParked`).
+ */
+import type { Event as OpenCodeSdkEvent } from '@opencode-ai/sdk/v2/client';
+/**
+ * The event union this stream dispatches. Re-exported (unchanged shape) from
+ * `react/use-opencode-events/types.ts` so existing importers keep working —
+ * this module is now the canonical definition.
+ */
+export type OpenCodeEvent = OpenCodeSdkEvent | {
+    id: string;
+    type: 'lsp.client.diagnostics';
+    properties: {
+        serverID: string;
+        path: string;
+    };
+};
+/** The minimal slice of `OpencodeClient` this machine actually calls. */
+export interface EventStreamClient {
+    global: {
+        event: (opts: {
+            signal: AbortSignal;
+            sseDefaultRetryDelay?: number;
+            sseMaxRetryDelay?: number;
+        }) => Promise<{
+            stream: AsyncIterable<unknown>;
+        }>;
+    };
+}
+/** A timer handle — opaque, only ever round-tripped through `setTimeout`/`clearTimeout`. */
+export type EventStreamTimerHandle = ReturnType<typeof setTimeout>;
+/** Injectable clock/timer seam — defaults to the real globals. Lets tests
+ *  drive the reconnect/backoff/heartbeat/coalescing timing deterministically
+ *  (a manual fake clock) instead of depending on real wall-clock delays. */
+export interface EventStreamTimers {
+    now: () => number;
+    setTimeout: (handler: () => void, timeoutMs?: number) => EventStreamTimerHandle;
+    clearTimeout: (handle: EventStreamTimerHandle | undefined) => void;
+}
+export interface OpenEventStreamOptions {
+    /** The opencode client to stream events from (same client the rest of the
+     *  SDK obtains via `getClient()`). */
+    client: EventStreamClient;
+    /** Called once per event, in dispatch order, after coalescing/flush. A
+     *  throw here is caught and logged — one bad handler must never break the
+     *  stream or crash the host. */
+    onEvent: (event: OpenCodeEvent) => void;
+    /** Called when a reconnect follows a stream gap > 5s, with the gap size in
+     *  ms. Lets the host re-hydrate anything it fears went stale (e.g. replay
+     *  messages for busy sessions) — the machine itself holds no host state to
+     *  re-hydrate. */
+    onGapRehydrate?: (gapMs: number) => void;
+    /** External signal that also stops the stream when aborted (in addition to
+     *  calling `close()` on the returned handle). Optional — most hosts just use
+     *  `close()`. */
+    signal?: AbortSignal;
+    /**
+     * Max time to wait for the initial `client.global.event()` call to resolve
+     * before treating the attempt as hung, aborting it, and retrying through the
+     * normal reconnect/backoff path. Guards against a black-holed proxy that
+     * swallows the connect request silently (no error, no data, no close) —
+     * the heartbeat watchdog can't help here since it only starts AFTER connect
+     * resolves. Defaults to 20s.
+     */
+    connectTimeoutMs?: number;
+    /**
+     * Max quiet time on an ESTABLISHED stream before the heartbeat watchdog
+     * declares it dead, aborts it, and reconnects. Defaults to 60s — see the
+     * `HEARTBEAT_MS` comment for why it must stay well above any real idle gap
+     * until the server ships keepalive frames.
+     */
+    heartbeatTimeoutMs?: number;
+    /**
+     * Give-up threshold: after this many CONSECUTIVE hard failures (attempts
+     * that never delivered a single event and died to an HTTP-level error or
+     * within 2s — the signature of a dead/archived sandbox whose proxy 503s
+     * every connect), the stream stops retrying and parks (see `onParked`).
+     * Any attempt that delivers an event, or that fails slowly without an HTTP
+     * status (e.g. a connect-timeout on a black-holed proxy), resets the
+     * counter. Defaults to 8 — combined with exponential backoff (1s → 30s
+     * cap) that spreads the give-up over roughly two minutes.
+     */
+    maxConsecutiveHardFailures?: number;
+    /**
+     * Fired ONCE if the stream parks (gives up) after
+     * `maxConsecutiveHardFailures` consecutive hard failures. A parked stream
+     * is TERMINAL for this handle: no further connect attempts are made, and
+     * there is no resume — the host should treat the runtime as gone (drop the
+     * stream, surface UI) and, if it believes the sandbox is back, open a
+     * fresh stream with a new `openEventStream()` call. `close()` on a parked
+     * handle stays safe/idempotent.
+     */
+    onParked?: (reason: EventStreamParkedInfo) => void;
+    /** Test-only clock/timer override. Defaults to real `Date.now`/`setTimeout`. */
+    timers?: EventStreamTimers;
+}
+/** Payload for {@link OpenEventStreamOptions.onParked}. */
+export interface EventStreamParkedInfo {
+    /** How many consecutive hard failures triggered the park. */
+    consecutiveFailures: number;
+    /** The error from the final failed attempt (null if it ended without one). */
+    lastError: unknown;
+}
+export interface EventStreamHandle {
+    /** Aborts the in-flight connection (if any), stops all reconnect/backoff
+     *  activity, and clears the pending coalescing flush. Idempotent — safe to
+     *  call on a stream that has already parked (see `onParked`). */
+    close: () => void;
+}
+/**
+ * Connects to the opencode SSE event stream and keeps it alive: heartbeat
+ * watchdog, event coalescing + batched flush, gap-triggered rehydrate signal,
+ * and exponential-backoff reconnect. Framework-free — safe to call from any
+ * host (the React wrapper calls this once per effect run; a non-React host can
+ * call it directly).
+ */
+export declare function openEventStream(opts: OpenEventStreamOptions): EventStreamHandle;
+export { heartbeatGapEvent, narrowChatEvent, type KortixChatEvent, type KortixChatEventConnection, type KortixChatEventHeartbeatGap, type KortixChatEventMessageRemoved, type KortixChatEventMessageUpdated, type KortixChatEventPartRemoved, type KortixChatEventPartUpdated, type KortixChatEventPermissionAsked, type KortixChatEventPermissionReplied, type KortixChatEventQuestionAnswered, type KortixChatEventQuestionAsked, type KortixChatEventSessionError, type KortixChatEventSessionIdle, type KortixChatEventSessionStatus, type KortixChatEventTodoUpdated, type KortixChatQuestionInfo, type KortixChatQuestionOption, type KortixChatToolRef, } from './chat-events.js';
+//# sourceMappingURL=event-stream.d.ts.map

package/dist/state/event-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-stream.d.ts","sourceRoot":"","sources":["../../src/state/event-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,KAAK,IAAI,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAI5E;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB,gBAAgB,GAChB;IACE,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,wBAAwB,CAAC;IAC/B,UAAU,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD,CAAC;AAEN,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE;QACN,KAAK,EAAE,CAAC,IAAI,EAAE;YACZ,MAAM,EAAE,WAAW,CAAC;YACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;YAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;SAC3B,KAAK,OAAO,CAAC;YAAE,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;SAAE,CAAC,CAAC;KACnD,CAAC;CACH;AAED,4FAA4F;AAC5F,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAEnE;;4EAE4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,sBAAsB,CAAC;IAChF,YAAY,EAAE,CAAC,MAAM,EAAE,sBAAsB,GAAG,SAAS,KAAK,IAAI,CAAC;CACpE;AAQD,MAAM,WAAW,sBAAsB;IACrC;0CACsC;IACtC,MAAM,EAAE,iBAAiB,CAAC;IAC1B;;oCAEgC;IAChC,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACxC;;;sBAGkB;IAClB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC;;qBAEiB;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;;;OASG;IACH,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACnD,gFAAgF;IAChF,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,2DAA2D;AAC3D,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,8EAA8E;IAC9E,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC;;qEAEiE;IACjE,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAsED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,iBAAiB,CAyU/E;AAOD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,gCAAgC,EACrC,KAAK,+BAA+B,EACpC,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC"}