@kortix/sdk 0.9.98

package/dist/state/chat-events.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Curated OpenCode event union for building a product chat UI — framework-free.
+ *
+ * `OpenCodeEvent` (`./event-stream.ts`) is the FULL raw wire union: ~50+
+ * variants covering LSP, PTY, worktrees, plugins, projects, MCP, installation,
+ * and more. A chat surface only ever cares about a small slice of that —
+ * message/part updates, session status, questions, permissions, todos, and
+ * connection health. `narrowChatEvent` filters + reshapes the raw stream down
+ * to `KortixChatEvent`, so a host's dispatch switch only has to handle events
+ * that actually matter to chat, each carrying a purpose-shaped payload
+ * instead of the raw untyped `properties` bag.
+ *
+ * `heartbeat-gap` has no wire representation of its own — `openEventStream`'s
+ * `onGapRehydrate(gapMs)` callback fires out-of-band when the SSE stream
+ * reconnects after a gap large enough that cached state may be stale. Build
+ * it with `heartbeatGapEvent(gapMs)` and dispatch it the same way as
+ * `narrowChatEvent`'s output:
+ *
+ * ```ts
+ * openEventStream({
+ *   client,
+ *   onEvent: (e) => {
+ *     const chatEvent = narrowChatEvent(e);
+ *     if (chatEvent) dispatch(chatEvent);
+ *   },
+ *   onGapRehydrate: (gapMs) => dispatch(heartbeatGapEvent(gapMs)),
+ * });
+ * ```
+ */
+import type { Message, Part, QuestionAnswer, SessionStatus, Todo } from '../opencode/client.js';
+import type { OpenCodeEvent } from './event-stream.js';
+export interface KortixChatEventMessageUpdated {
+    type: 'message.updated';
+    sessionID: string;
+    message: Message;
+}
+export interface KortixChatEventMessageRemoved {
+    type: 'message.removed';
+    sessionID: string;
+    messageID: string;
+}
+export interface KortixChatEventPartUpdated {
+    type: 'message.part.updated';
+    sessionID: string;
+    part: Part;
+}
+export interface KortixChatEventPartRemoved {
+    type: 'message.part.removed';
+    sessionID: string;
+    messageID: string;
+    partID: string;
+}
+export interface KortixChatEventSessionStatus {
+    type: 'session.status';
+    sessionID: string;
+    status: SessionStatus;
+}
+export interface KortixChatEventSessionIdle {
+    type: 'session.idle';
+    sessionID: string;
+}
+export interface KortixChatEventSessionError {
+    type: 'session.error';
+    sessionID?: string;
+    error?: unknown;
+}
+export interface KortixChatQuestionOption {
+    label: string;
+    description: string;
+}
+export interface KortixChatQuestionInfo {
+    question: string;
+    header: string;
+    options: KortixChatQuestionOption[];
+    multiple?: boolean;
+    custom?: boolean;
+}
+export interface KortixChatToolRef {
+    messageID: string;
+    callID: string;
+}
+export interface KortixChatEventQuestionAsked {
+    type: 'question.asked';
+    sessionID: string;
+    requestID: string;
+    questions: KortixChatQuestionInfo[];
+    tool?: KortixChatToolRef;
+}
+/** Merges the wire's `question.replied` / `question.rejected` events — a host
+ *  usually just needs to know "this pending question resolved" plus how. */
+export interface KortixChatEventQuestionAnswered {
+    type: 'question.answered';
+    sessionID: string;
+    requestID: string;
+    outcome: 'replied' | 'rejected';
+    answers?: QuestionAnswer[];
+}
+export interface KortixChatEventPermissionAsked {
+    type: 'permission.asked';
+    sessionID: string;
+    requestID: string;
+    permission: string;
+    patterns: string[];
+    tool?: KortixChatToolRef;
+}
+export interface KortixChatEventPermissionReplied {
+    type: 'permission.replied';
+    sessionID: string;
+    requestID: string;
+    reply: 'once' | 'always' | 'reject';
+}
+export interface KortixChatEventTodoUpdated {
+    type: 'todo.updated';
+    sessionID: string;
+    todos: Todo[];
+}
+/** Fired once per SSE (re)connect — a host can use it to clear a "reconnecting…" banner. */
+export interface KortixChatEventConnection {
+    type: 'connection';
+    status: 'connected';
+}
+/** Synthetic — see the module doc comment. Not derived from `narrowChatEvent`;
+ *  built directly from `openEventStream`'s `onGapRehydrate(gapMs)`. */
+export interface KortixChatEventHeartbeatGap {
+    type: 'heartbeat-gap';
+    gapMs: number;
+}
+export type KortixChatEvent = KortixChatEventMessageUpdated | KortixChatEventMessageRemoved | KortixChatEventPartUpdated | KortixChatEventPartRemoved | KortixChatEventSessionStatus | KortixChatEventSessionIdle | KortixChatEventSessionError | KortixChatEventQuestionAsked | KortixChatEventQuestionAnswered | KortixChatEventPermissionAsked | KortixChatEventPermissionReplied | KortixChatEventTodoUpdated | KortixChatEventConnection | KortixChatEventHeartbeatGap;
+/** Build the synthetic heartbeat-gap chat event from `openEventStream`'s `onGapRehydrate` callback. */
+export declare function heartbeatGapEvent(gapMs: number): KortixChatEventHeartbeatGap;
+/**
+ * Narrow a raw `OpenCodeEvent` down to the curated `KortixChatEvent` union a
+ * chat UI needs, reshaping `properties` into a purpose-built payload.
+ *
+ * Returns `null` for every event outside the curated set (LSP, PTY,
+ * worktrees, plugins, projects, MCP, installation, session lifecycle CRUD,
+ * …) — callers should treat `null` as "not a chat event, ignore" rather than
+ * an error; this is a deliberate filter, not an exhaustive switch.
+ */
+export declare function narrowChatEvent(event: OpenCodeEvent): KortixChatEvent | null;
+//# sourceMappingURL=chat-events.d.ts.map

package/dist/state/chat-events.d.ts.map

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

package/dist/state/chat-events.js

@@ -0,0 +1,135 @@
+/**
+ * Curated OpenCode event union for building a product chat UI — framework-free.
+ *
+ * `OpenCodeEvent` (`./event-stream.ts`) is the FULL raw wire union: ~50+
+ * variants covering LSP, PTY, worktrees, plugins, projects, MCP, installation,
+ * and more. A chat surface only ever cares about a small slice of that —
+ * message/part updates, session status, questions, permissions, todos, and
+ * connection health. `narrowChatEvent` filters + reshapes the raw stream down
+ * to `KortixChatEvent`, so a host's dispatch switch only has to handle events
+ * that actually matter to chat, each carrying a purpose-shaped payload
+ * instead of the raw untyped `properties` bag.
+ *
+ * `heartbeat-gap` has no wire representation of its own — `openEventStream`'s
+ * `onGapRehydrate(gapMs)` callback fires out-of-band when the SSE stream
+ * reconnects after a gap large enough that cached state may be stale. Build
+ * it with `heartbeatGapEvent(gapMs)` and dispatch it the same way as
+ * `narrowChatEvent`'s output:
+ *
+ * ```ts
+ * openEventStream({
+ *   client,
+ *   onEvent: (e) => {
+ *     const chatEvent = narrowChatEvent(e);
+ *     if (chatEvent) dispatch(chatEvent);
+ *   },
+ *   onGapRehydrate: (gapMs) => dispatch(heartbeatGapEvent(gapMs)),
+ * });
+ * ```
+ */
+/** Build the synthetic heartbeat-gap chat event from `openEventStream`'s `onGapRehydrate` callback. */
+export function heartbeatGapEvent(gapMs) {
+    return { type: 'heartbeat-gap', gapMs };
+}
+/**
+ * Narrow a raw `OpenCodeEvent` down to the curated `KortixChatEvent` union a
+ * chat UI needs, reshaping `properties` into a purpose-built payload.
+ *
+ * Returns `null` for every event outside the curated set (LSP, PTY,
+ * worktrees, plugins, projects, MCP, installation, session lifecycle CRUD,
+ * …) — callers should treat `null` as "not a chat event, ignore" rather than
+ * an error; this is a deliberate filter, not an exhaustive switch.
+ */
+export function narrowChatEvent(event) {
+    switch (event.type) {
+        case 'message.updated':
+            return {
+                type: 'message.updated',
+                sessionID: event.properties.sessionID,
+                message: event.properties.info,
+            };
+        case 'message.removed':
+            return {
+                type: 'message.removed',
+                sessionID: event.properties.sessionID,
+                messageID: event.properties.messageID,
+            };
+        case 'message.part.updated':
+            return {
+                type: 'message.part.updated',
+                sessionID: event.properties.sessionID,
+                part: event.properties.part,
+            };
+        case 'message.part.removed':
+            return {
+                type: 'message.part.removed',
+                sessionID: event.properties.sessionID,
+                messageID: event.properties.messageID,
+                partID: event.properties.partID,
+            };
+        case 'session.status':
+            return {
+                type: 'session.status',
+                sessionID: event.properties.sessionID,
+                status: event.properties.status,
+            };
+        case 'session.idle':
+            return { type: 'session.idle', sessionID: event.properties.sessionID };
+        case 'session.error':
+            return {
+                type: 'session.error',
+                sessionID: event.properties.sessionID,
+                error: event.properties.error,
+            };
+        case 'question.asked':
+            return {
+                type: 'question.asked',
+                sessionID: event.properties.sessionID,
+                requestID: event.properties.id,
+                questions: event.properties.questions,
+                tool: event.properties.tool,
+            };
+        case 'question.replied':
+            return {
+                type: 'question.answered',
+                sessionID: event.properties.sessionID,
+                requestID: event.properties.requestID,
+                outcome: 'replied',
+                answers: event.properties.answers,
+            };
+        case 'question.rejected':
+            return {
+                type: 'question.answered',
+                sessionID: event.properties.sessionID,
+                requestID: event.properties.requestID,
+                outcome: 'rejected',
+            };
+        case 'permission.asked':
+            return {
+                type: 'permission.asked',
+                sessionID: event.properties.sessionID,
+                requestID: event.properties.id,
+                permission: event.properties.permission,
+                patterns: event.properties.patterns,
+                tool: event.properties.tool,
+            };
+        case 'permission.replied':
+            return {
+                type: 'permission.replied',
+                sessionID: event.properties.sessionID,
+                requestID: event.properties.requestID,
+                reply: event.properties.reply,
+            };
+        case 'todo.updated':
+            return {
+                type: 'todo.updated',
+                sessionID: event.properties.sessionID,
+                todos: event.properties.todos,
+            };
+        case 'server.connected':
+            return { type: 'connection', status: 'connected' };
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=chat-events.js.map

package/dist/state/chat-events.js.map

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

package/dist/state/current-runtime.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The current session runtime — the ONE OpenCode daemon the app is talking to
+ * right now (the sandbox of the session being viewed), as a proxy URL
+ * `${backendUrl}/p/<external_id>/8000`.
+ *
+ * This replaces the old global "active server" machinery. A session binds here
+ * (`useSession` sets it on open, clears it on unmount); every runtime read —
+ * `getClient()`, the SSE stream, the file/terminal/git hooks — resolves through
+ * it; switching sessions just sets a new url. There is no servers[] registry, no
+ * `serverVersion`, no reset-cascade. `version` bumps on every change so the SSE
+ * stream re-subscribes to the new daemon.
+ *
+ * This module is part of the isomorphic core (reachable from the root
+ * `@kortix/sdk` export), so it is a plain hand-rolled store — no zustand, no
+ * React. The React selector hook lives at `react/use-current-runtime`.
+ */
+export interface CurrentRuntimeState {
+    url: string | null;
+    /** The sandbox's external_id (Daytona id) — used for proxy routing. */
+    sandboxId: string | null;
+    /** The sandbox's DB instance id (platform `sandbox_id`) — used by ownership-
+     *  scoped APIs like per-sandbox API keys that key on the DB row, not the
+     *  external id (which the backend would mistake for the primary key). */
+    dbSandboxId: string | null;
+    version: number;
+}
+/** Framework-free store over the current runtime (getState/subscribe). */
+export declare const currentRuntimeStore: {
+    getState(): CurrentRuntimeState;
+    subscribe(listener: () => void): () => void;
+};
+/**
+ * Point the app at a session's runtime. `null` clears it (no active session) — the
+ * next runtime read then has no url and callers wait, exactly as before a session
+ * is open.
+ */
+export declare function setCurrentRuntime(url: string | null, sandboxId?: string | null, dbSandboxId?: string | null): void;
+/** Read the current runtime url outside React (API modules, the client factory). */
+export declare function getCurrentRuntimeUrl(): string | null;
+/** Read the current runtime sandbox id (external_id) outside React. */
+export declare function getCurrentRuntimeSandboxId(): string | null;
+/** Read the current runtime DB sandbox id (platform `sandbox_id`) outside React. */
+export declare function getCurrentRuntimeDbSandboxId(): string | null;
+//# sourceMappingURL=current-runtime.d.ts.map

package/dist/state/current-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-runtime.d.ts","sourceRoot":"","sources":["../../src/state/current-runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,uEAAuE;IACvE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;6EAEyE;IACzE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAWD,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB;gBAClB,mBAAmB;wBAGX,MAAM,IAAI,GAAG,MAAM,IAAI;CAM5C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,WAAW,GAAE,MAAM,GAAG,IAAW,GAChC,IAAI,CAKN;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAEpD;AAED,uEAAuE;AACvE,wBAAgB,0BAA0B,IAAI,MAAM,GAAG,IAAI,CAE1D;AAED,oFAAoF;AACpF,wBAAgB,4BAA4B,IAAI,MAAM,GAAG,IAAI,CAE5D"}

package/dist/state/current-runtime.js

@@ -0,0 +1,44 @@
+let state = {
+    url: null,
+    sandboxId: null,
+    dbSandboxId: null,
+    version: 0,
+};
+const listeners = new Set();
+/** Framework-free store over the current runtime (getState/subscribe). */
+export const currentRuntimeStore = {
+    getState() {
+        return state;
+    },
+    subscribe(listener) {
+        listeners.add(listener);
+        return () => {
+            listeners.delete(listener);
+        };
+    },
+};
+/**
+ * Point the app at a session's runtime. `null` clears it (no active session) — the
+ * next runtime read then has no url and callers wait, exactly as before a session
+ * is open.
+ */
+export function setCurrentRuntime(url, sandboxId = null, dbSandboxId = null) {
+    if (state.url === url && state.sandboxId === sandboxId && state.dbSandboxId === dbSandboxId)
+        return;
+    state = { url, sandboxId, dbSandboxId, version: state.version + 1 };
+    for (const listener of listeners)
+        listener();
+}
+/** Read the current runtime url outside React (API modules, the client factory). */
+export function getCurrentRuntimeUrl() {
+    return state.url;
+}
+/** Read the current runtime sandbox id (external_id) outside React. */
+export function getCurrentRuntimeSandboxId() {
+    return state.sandboxId;
+}
+/** Read the current runtime DB sandbox id (platform `sandbox_id`) outside React. */
+export function getCurrentRuntimeDbSandboxId() {
+    return state.dbSandboxId;
+}
+//# sourceMappingURL=current-runtime.js.map

package/dist/state/current-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-runtime.js","sourceRoot":"","sources":["../../src/state/current-runtime.ts"],"names":[],"mappings":"AA2BA,IAAI,KAAK,GAAwB;IAC/B,GAAG,EAAE,IAAI;IACT,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,CAAC;CACX,CAAC;AAEF,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAC;AAExC,0EAA0E;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ;QACN,OAAO,KAAK,CAAC;IACf,CAAC;IACD,SAAS,CAAC,QAAoB;QAC5B,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC7B,CAAC,CAAC;IACJ,CAAC;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAkB,EAClB,YAA2B,IAAI,EAC/B,cAA6B,IAAI;IAEjC,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,KAAK,WAAW;QACzF,OAAO;IACT,KAAK,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;IACpE,KAAK,MAAM,QAAQ,IAAI,SAAS;QAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,oBAAoB;IAClC,OAAO,KAAK,CAAC,GAAG,CAAC;AACnB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,0BAA0B;IACxC,OAAO,KAAK,CAAC,SAAS,CAAC;AACzB,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,4BAA4B;IAC1C,OAAO,KAAK,CAAC,WAAW,CAAC;AAC3B,CAAC"}

package/dist/state/diagnostics-store.d.ts

@@ -0,0 +1,114 @@
+export type DiagnosticSeverity = 1 | 2 | 3 | 4;
+export interface LspDiagnostic {
+    file: string;
+    line: number;
+    column: number;
+    endLine?: number;
+    endColumn?: number;
+    severity: DiagnosticSeverity;
+    message: string;
+    source?: string;
+}
+export interface DiagnosticsState {
+    /** All diagnostics keyed by file path (may be absolute or relative) */
+    byFile: Record<string, LspDiagnostic[]>;
+    /** Set all diagnostics for a given file (replaces existing) */
+    setFileDiagnostics: (file: string, diagnostics: LspDiagnostic[]) => void;
+    /** Bulk-set diagnostics from an lsp.updated event payload (Record<string, RawDiag[]>) */
+    setFromLspEvent: (diagnosticsByFile: Record<string, RawDiagnostic[]>) => void;
+    /** Clear diagnostics for a file */
+    clearFile: (file: string) => void;
+    /** Clear all diagnostics */
+    clearAll: () => void;
+    /** Total error count (severity 1) */
+    getErrorCount: () => number;
+    /** Total warning count (severity 2) */
+    getWarningCount: () => number;
+    /** Get all diagnostics across all files, sorted by severity then file */
+    getAllDiagnostics: () => LspDiagnostic[];
+}
+/**
+ * Raw diagnostic shape from LSP / tool metadata.
+ * Supports both the range-based format (from tool metadata) and flat format.
+ */
+export interface RawDiagnostic {
+    range?: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end?: {
+            line: number;
+            character: number;
+        };
+    };
+    line?: number;
+    column?: number;
+    character?: number;
+    endLine?: number;
+    endColumn?: number;
+    severity?: number;
+    message: string;
+    source?: string;
+}
+/**
+ * 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 declare function findDiagnosticsForFile(byFile: Record<string, LspDiagnostic[]>, filePath: string): LspDiagnostic[] | 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 declare function buildDiagnosticCountsMap(byFile: Record<string, LspDiagnostic[]>): Record<string, {
+    errors: number;
+    warnings: number;
+}>;
+/**
+ * Extract the relative filename from a diagnostic's file path.
+ * Used by the diagnostics panel to show short names.
+ */
+export declare function getRelativePath(absPath: string): string;
+/**
+ * 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 declare function parseDiagnosticsFromToolOutput(output: string): Record<string, LspDiagnostic[]>;
+export declare const useDiagnosticsStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<DiagnosticsState>, "setState" | "persist"> & {
+    setState(partial: DiagnosticsState | Partial<DiagnosticsState> | ((state: DiagnosticsState) => DiagnosticsState | Partial<DiagnosticsState>), replace?: false | undefined): unknown;
+    setState(state: DiagnosticsState | ((state: DiagnosticsState) => DiagnosticsState), replace: true): unknown;
+    persist: {
+        setOptions: (options: Partial<import("zustand/middleware").PersistOptions<DiagnosticsState, DiagnosticsState, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: DiagnosticsState) => void) => () => void;
+        onFinishHydration: (fn: (state: DiagnosticsState) => void) => () => void;
+        getOptions: () => Partial<import("zustand/middleware").PersistOptions<DiagnosticsState, DiagnosticsState, unknown>>;
+    };
+}>;
+//# sourceMappingURL=diagnostics-store.d.ts.map

package/dist/state/diagnostics-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-store.d.ts","sourceRoot":"","sources":["../../src/state/diagnostics-store.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;IAIxC,+DAA+D;IAC/D,kBAAkB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;IAEzE,yFAAyF;IACzF,eAAe,EAAE,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,KAAK,IAAI,CAAC;IAE9E,mCAAmC;IACnC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAElC,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,IAAI,CAAC;IAIrB,qCAAqC;IACrC,aAAa,EAAE,MAAM,MAAM,CAAC;IAE5B,uCAAuC;IACvC,eAAe,EAAE,MAAM,MAAM,CAAC;IAE9B,yEAAyE;IACzE,iBAAiB,EAAE,MAAM,aAAa,EAAE,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE;QACN,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3C,GAAG,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3C,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,EACvC,QAAQ,EAAE,MAAM,GACf,aAAa,EAAE,GAAG,SAAS,CAsB7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,GACtC,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAwCtD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAqBvD;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAiEjC;AA6BD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EA4G9B,CAAC"}