@gitkraken/core-gitlens 0.2.0 → 0.3.1

package/dist/plus/agents/stateMachine.js

@@ -0,0 +1,180 @@
+import { kill } from 'process';
+/** Cap for derived plan / question summaries — short enough to clamp into a card row without
+ *  truncation eating the leading content, long enough to convey what the prompt is about. */
+const summaryMaxLength = 120;
+export function deriveStatusFromEvent(event) {
+    switch (event) {
+        case 'SessionStart':
+        case 'Stop':
+        case 'StopFailure':
+            return 'idle';
+        case 'PreToolUse':
+            return 'tool_use';
+        case 'PreCompact':
+            return 'compacting';
+        case 'PermissionRequest':
+        case 'Elicitation':
+            return 'permission_requested';
+        case 'UserPromptSubmit':
+        case 'PostToolUse':
+        case 'PostToolUseFailure':
+        case 'PostCompact':
+        case 'PermissionDenied':
+        case 'ElicitationResult':
+        case 'SubagentStart':
+        case 'SubagentStop':
+            return 'thinking';
+        default:
+            return 'idle';
+    }
+}
+export function isProcessAlive(pid) {
+    // `kill(0, ...)` and `kill(<negative>, ...)` have process-group semantics on POSIX
+    // (and target the current process under libuv on Windows), so they don't tell us
+    // anything about a specific pid. Reject anything that isn't a real, positive pid.
+    if (!Number.isInteger(pid) || pid <= 0)
+        return false;
+    try {
+        kill(pid, 0);
+        return true;
+    }
+    catch (ex) {
+        // The process exists but we can't signal it: sandboxed/different uid (POSIX
+        // EPERM) or `OpenProcess` access-denied (Windows EACCES). Treat as alive.
+        // ESRCH and everything else mean dead.
+        const code = ex?.code;
+        return code === 'EPERM' || code === 'EACCES';
+    }
+}
+export function rehydrateSubagents(subagents) {
+    if (subagents == null || subagents.length === 0)
+        return undefined;
+    return subagents.map(s => ({
+        ...s,
+        lastActivity: new Date(s.lastActivity),
+        phaseSince: new Date(s.phaseSince),
+    }));
+}
+export function describeToolInput(toolName, toolInput) {
+    let detail;
+    switch (toolName) {
+        case 'Bash':
+            detail = toolInput.command;
+            break;
+        case 'Edit':
+        case 'MultiEdit':
+        case 'Write':
+        case 'Read':
+            detail = toolInput.file_path;
+            break;
+        case 'Grep':
+        case 'Glob':
+            detail = toolInput.pattern;
+            break;
+        case 'WebFetch':
+            detail = toolInput.url;
+            break;
+        case 'WebSearch':
+            detail = toolInput.query;
+            break;
+        case 'NotebookEdit':
+            detail = toolInput.notebook_path;
+            break;
+        case 'ExitPlanMode':
+            detail = extractPlanSummary(toolInput);
+            break;
+        case 'AskUserQuestion':
+            detail = extractQuestionDetails(toolInput)?.text;
+            break;
+    }
+    return detail != null ? `${toolName}(${detail})` : toolName;
+}
+/** Maps a Claude Code tool name to its UX-relevant prompt kind. `ExitPlanMode` and
+ *  `AskUserQuestion` are the two tools whose semantics differ from a regular permission
+ *  request — everything else falls through to the generic tool kind. */
+export function classifyPermissionKind(toolName) {
+    switch (toolName) {
+        case 'ExitPlanMode':
+            return 'plan';
+        case 'AskUserQuestion':
+            return 'question';
+        default:
+            return 'tool';
+    }
+}
+/** Extracts a short, scannable summary from an ExitPlanMode plan body. Prefers the first
+ *  Markdown heading (stripped of leading `#`s) so the plan's title surfaces; falls back to
+ *  the first non-empty line if no heading appears. Capped at {@link summaryMaxLength} with an
+ *  ellipsis. */
+export function extractPlanSummary(toolInput) {
+    const plan = toolInput.plan;
+    if (!plan)
+        return undefined;
+    let heading;
+    let firstNonEmpty;
+    for (const line of plan.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        if (trimmed.startsWith('#')) {
+            const stripped = trimmed.replace(/^#+\s*/, '').trim();
+            if (stripped) {
+                heading = stripped;
+                break;
+            }
+        }
+        firstNonEmpty ??= trimmed;
+    }
+    const summary = heading ?? firstNonEmpty;
+    if (!summary)
+        return undefined;
+    return summary.length > summaryMaxLength ? `${summary.slice(0, summaryMaxLength).trimEnd()}…` : summary;
+}
+/** Extracts the leading question text + total question count from an AskUserQuestion call.
+ *  Returns undefined if the input doesn't carry a recognisable `questions` array. */
+export function extractQuestionDetails(toolInput) {
+    const questions = toolInput.questions;
+    if (!Array.isArray(questions) || questions.length === 0)
+        return undefined;
+    const first = questions[0]?.question;
+    if (typeof first !== 'string')
+        return undefined;
+    const trimmed = first.trim();
+    if (!trimmed)
+        return undefined;
+    const text = trimmed.length > summaryMaxLength ? `${trimmed.slice(0, summaryMaxLength).trimEnd()}…` : trimmed;
+    return { text: text, count: questions.length };
+}
+/** Returns the file path a file-mutating tool is targeting, or `undefined` for non-mutating /
+ *  non-file tools. `Read` is intentionally excluded — "working on a file" means writing to it.
+ *  Reads are surfaced separately via {@link getToolReadPath} so consumers (e.g. the treemap
+ *  activity overlay) can render reads with a distinct visual treatment. */
+export function getToolFilePath(toolName, toolInput) {
+    if (toolInput == null)
+        return undefined;
+    switch (toolName) {
+        case 'Edit':
+        case 'MultiEdit':
+        case 'Write':
+            return toolInput.file_path;
+        case 'NotebookEdit':
+            return toolInput.notebook_path;
+        default:
+            return undefined;
+    }
+}
+/** Returns the file path a read-only file tool is targeting, or `undefined` for non-read /
+ *  non-file tools. Mirrors {@link getToolFilePath} but for `Read`/`NotebookRead`. */
+export function getToolReadPath(toolName, toolInput) {
+    if (toolInput == null)
+        return undefined;
+    switch (toolName) {
+        case 'Read':
+            return toolInput.file_path;
+        case 'NotebookRead':
+            return toolInput.notebook_path;
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=stateMachine.js.map

package/dist/plus/agents/stateMachine.js.map

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

package/dist/plus/agents/types.d.ts

@@ -0,0 +1,254 @@
+import type { IpcHandler } from '../../ipc/ipcServer.js';
+import type { UnifiedDisposable } from '../../utils/disposable.js';
+import type { Event } from '../../utils/event.js';
+export declare const claudeCodeNonBlockingHookEvents: readonly ["SessionStart", "SessionEnd", "UserPromptSubmit", "PreToolUse", "PostToolUse", "PostToolUseFailure", "Notification", "Stop", "StopFailure", "SubagentStart", "SubagentStop", "TeammateIdle", "TaskCompleted", "InstructionsLoaded", "ConfigChange", "WorktreeCreate", "WorktreeRemove", "PreCompact", "PostCompact", "Elicitation", "ElicitationResult", "PermissionDenied", "CwdChanged"];
+export declare const claudeCodeBlockingHookEvents: readonly ["PermissionRequest"];
+export type ClaudeCodeHookEvent = (typeof claudeCodeNonBlockingHookEvents)[number] | (typeof claudeCodeBlockingHookEvents)[number];
+export type PermissionDecision = 'allow' | 'deny';
+export type AgentSessionStatus = 'thinking' | 'tool_use' | 'responding' | 'waiting' | 'idle' | 'compacting' | 'permission_requested';
+export type AgentSessionPhase = 'idle' | 'working' | 'waiting';
+export declare function getPhaseForStatus(status: AgentSessionStatus): AgentSessionPhase;
+/**
+ * Returns whether the given phase represents an agent that is actively doing work or
+ * awaiting input (as opposed to fully idle). Uses an explicit allowlist so new phases
+ * default to "not active" rather than being silently treated as live.
+ */
+export declare function isActiveAgentPhase(phase: AgentSessionPhase): boolean;
+export interface PermissionSuggestion {
+    readonly type: string;
+    readonly tool?: string;
+    readonly rules?: readonly {
+        readonly toolName: string;
+        readonly ruleContent?: string;
+    }[];
+    readonly destination?: string;
+}
+/** Classification of what the agent is awaiting input for. Drives kind-aware UI: action button
+ *  labels, phase wording, and which payload field carries the body. Detected at the provider
+ *  boundary from the tool name / event so webviews don't grow their own classifiers.
+ *  - `tool`: a regular tool permission (Bash, Edit, Read, …) — body is `toolDescription`.
+ *  - `plan`: ExitPlanMode — body is `planSummary`; `planFilePath` may link the written plan.
+ *  - `question`: AskUserQuestion — body is `questionText`; `questionCount` describes the batch.
+ *  - `elicitation`: MCP elicitation — body is just `toolName`; user must respond in-session. */
+export type PendingPermissionKind = 'tool' | 'plan' | 'question' | 'elicitation';
+export interface PendingPermission {
+    readonly kind: PendingPermissionKind;
+    readonly toolName: string;
+    readonly toolDescription: string;
+    readonly toolInputDescription?: string;
+    readonly suggestions?: readonly PermissionSuggestion[];
+    /** Plan-mode (`kind === 'plan'`): on-disk path of the plan markdown, when the agent wrote one. */
+    readonly planFilePath?: string;
+    /** Plan-mode: short summary extracted from the plan content (first heading or leading sentence). */
+    readonly planSummary?: string;
+    /** Question-mode (`kind === 'question'`): the leading question text. */
+    readonly questionText?: string;
+    /** Question-mode: total number of questions in the batch. */
+    readonly questionCount?: number;
+}
+export interface AgentSession {
+    readonly id: string;
+    readonly providerId: string;
+    readonly providerName: string;
+    readonly name?: string;
+    readonly status: AgentSessionStatus;
+    readonly phase: AgentSessionPhase;
+    readonly statusDetail?: string;
+    readonly worktreePath?: string;
+    /** Common (parent) repo path shared by every worktree in this session's repo. Set together
+     *  with `worktreePath` by `resolveGitInfo` — equal to `worktreePath` for a default-worktree
+     *  session, otherwise the parent repo's common path. Use this for "same repo" identity
+     *  checks; {@link workspacePath} is the matched workspace folder, not repo identity.
+     *
+     *  `undefined` carries two meanings the host distinguishes internally (via the
+     *  `gitInfoUnresolvable` bookkeeping flag) but consumers should treat identically: either
+     *  "not yet resolved" (no probe completed) or "resolved but cwd is not inside any git repo".
+     *  Either way, no repo identity is available — never attempt to `path.join`/`path.resolve`
+     *  against it without an explicit `!= null` check. */
+    readonly commonPath?: string;
+    readonly pid?: number;
+    readonly lastActivity: Date;
+    readonly phaseSince: Date;
+    readonly isSubagent: boolean;
+    readonly parentId?: string;
+    readonly subagents?: readonly AgentSession[];
+    readonly pendingPermission?: PendingPermission;
+    /** The VS Code workspace folder containing the agent's cwd, or `undefined` if cwd is outside
+     *  any open workspace folder. Used for `isInWorkspace` and "Open Folder" only — NOT for repo
+     *  identity. For "what repo is this session in", use {@link commonPath}. */
+    readonly workspacePath?: string;
+    readonly cwd?: string;
+    /** The session's `cwd` at first observation. Set once and never overwritten — captures the
+     *  agent's launch directory so consumers can detect drift (e.g. an agent that `cd`'d into a
+     *  sibling worktree). Pairs with {@link initialWorktreePath} / {@link initialCommonPath}; for
+     *  the live cwd, see {@link cwd}. */
+    readonly initialCwd?: string;
+    /** The session's `worktreePath` at first successful git-info resolution. Set once and never
+     *  overwritten — compare against {@link worktreePath} to detect cross-worktree drift. Undefined
+     *  if the session has never resolved into a git repo. */
+    readonly initialWorktreePath?: string;
+    /** The session's `commonPath` at first successful git-info resolution. Set once and never
+     *  overwritten — compare against {@link commonPath} to detect cross-repo drift. Undefined if
+     *  the session has never resolved into a git repo. */
+    readonly initialCommonPath?: string;
+    readonly planFile?: string;
+    readonly isInWorkspace: boolean;
+    readonly lastPrompt?: string;
+    readonly firstPrompt?: string;
+    /** Per-file activity record covering both read-class (Read/NotebookRead) and edit-class
+     *  (Edit/Write/MultiEdit/NotebookEdit) tool calls. Populated on PreToolUse; each path is retained
+     *  and fades for the configured decay window measured from its own last PostToolUse — the tail
+     *  survives the turn-end Stop (which only drops the live `editing`/`reading` flags) and is fully
+     *  cleared only on SessionEnd or once the decay window elapses.
+     *
+     *  A sub-agent's file activity appears on its PARENT's `fileActivity`, not the sub-agent's own:
+     *  the GK CLI keys a sub-agent's tool events under the parent session id (with `agentId` set), so
+     *  they accumulate in the parent's bookkeeping directly. Consumers never need to recurse into
+     *  `subagents[]`; sub-agent `AgentSession` objects carry `fileActivity: undefined`.
+     *
+     *  Field semantics:
+     *  - `path`: absolute path on the agent's filesystem.
+     *  - `readAt` / `editedAt`: milliseconds since the last PreToolUse for that kind, computed by
+     *    the host at serialization time (relative — avoids clock-skew). Omitted when never touched
+     *    by that kind within the window.
+     *  - `reading` / `editing`: `true` when at least one tool of that kind is in flight on this
+     *    path right now (refcount > 0 in the host bookkeeping). Omitted when false to keep the
+     *    wire minimal.
+     *
+     *  Mutable array form so `Shape<AgentSession>` projects it cleanly (the `Shape<>` type mangles
+     *  `readonly T[]` into a mapped object that loses its iterator). Treat as immutable. */
+    fileActivity?: {
+        path: string;
+        readAt?: number;
+        editedAt?: number;
+        reading?: true;
+        editing?: true;
+    }[];
+    /** `true` when the session was discovered via peer IPC sync (i.e. another GitLens window hosts
+     *  the agent's hook flow and Claude Code extension panel). Locally-owned sessions leave this
+     *  unset. The dispatcher uses this to route opens through the peer's IPC route + an OS-level
+     *  window focus, since calling `claude-vscode.editor.open` in *our* extension only opens an
+     *  inert local view that isn't connected to the live session running in the peer.
+     *
+     *  Window-local: never serialized faithfully across the IPC wire. Each window decides locally
+     *  based on how it received the session — `querySiblingWindowSessions` always overrides to
+     *  `true` regardless of what the peer published. */
+    readonly isPeerOwned?: boolean;
+    /**
+     * Titles discovered by tailing the Claude Code transcript JSONL at
+     * `~/.claude/projects/<encoded-cwd>/<sessionId>.jsonl`. Populated by
+     * `ClaudeCodeTranscriptReader`; used by `getSessionDisplayName` as a fallback when no
+     * harness-supplied `name` is available. Last occurrence in the transcript wins per type.
+     */
+    readonly transcriptTitles?: {
+        readonly custom?: string;
+        readonly ai?: string;
+        readonly agent?: string;
+    };
+}
+export interface AgentSessionProvider extends UnifiedDisposable {
+    readonly id: string;
+    readonly name: string;
+    readonly icon: string;
+    readonly onDidChangeSessions: Event<void>;
+    readonly sessions: readonly AgentSession[];
+    start(workspacePaths: string[]): void;
+    stop(): void;
+    updateWorkspacePaths?(workspacePaths: string[]): void;
+    /** Pushed by the host from its cached agent detection. Lets the provider gate its reconciliation
+     *  poll (the CLI `list-sessions` call) so an idle window with no sessions and no installed hooks
+     *  doesn't spawn the CLI every interval. */
+    setClaudeHooksInstalled?(installed: boolean): void;
+    /** Resolves a pending permission. Returns `true` when the resolve was routed (the local IPC
+     *  owns the session's pending entry); `false` when no local entry exists (typically a peer-
+     *  discovered session owned by another GitLens window). Callers use this to give the user
+     *  feedback rather than a silent no-op. */
+    resolvePermission?(sessionId: string, decision: PermissionDecision, updatedPermissions?: PermissionSuggestion[]): boolean;
+    /** Asks the peer GitLens window that has `workspacePath` open (or any peer whose workspacePath
+     *  contains, or is contained by, it) to open the given session in its Claude Code extension
+     *  via the `agents/sessions/open` IPC route. Resolves to `true` when at least one peer claimed
+     *  the workspace AND was reachable; `false` otherwise. Best-effort: never rejects. The boolean
+     *  is currently a diagnostic signal only — the dispatcher fires this in parallel with
+     *  `vscode.openFolder` and relies on VS Code's window-folder matching to focus the owning
+     *  window (which works whether or not the peer runs GitLens). */
+    notifyPeerOpenSession?(workspacePath: string, sessionId: string): Promise<boolean>;
+}
+/**
+ * Host-supplied IPC service. The agents package registers handlers and publishes
+ * the agents discovery file via this interface so it doesn't depend on the host's
+ * IPC service directly.
+ *
+ * The agents package is the source of truth for the workspacePaths advertised in
+ * the agents discovery file — `publishAgents` takes them as an argument and the host
+ * is expected to re-publish whenever those paths change.
+ */
+export interface IpcRegistrar {
+    readonly port: number | undefined;
+    /** Directory scanned for peer-window agent discovery files. Omit to disable peer discovery (tests). */
+    readonly agentDiscoveryDir?: string;
+    registerHandler<Request = unknown, Response = unknown>(name: string, handler: IpcHandler<Request, Response>): UnifiedDisposable;
+    publishAgents(workspacePaths: string[]): Promise<void>;
+    unpublishAgents(): Promise<void>;
+}
+export interface AgentProviderCallbacks {
+    /** Host-supplied IPC service. Required for agents to receive hook events from the GK CLI. */
+    ipc: IpcRegistrar;
+    /** Returns the current "activity decay" window in milliseconds — the cooldown between a tool
+     *  call finishing and the file being dropped from `AgentSession.fileActivity`. Optional — when
+     *  omitted the provider falls back to its built-in default (5 min). Read by the provider at
+     *  schedule time so changes to the host setting take effect on the next tool call without
+     *  needing a re-wiring step. */
+    getActivityDecayMs?(): number;
+    /** Report that an agent session started. No-op if the host has no telemetry. */
+    onSessionStarted?(provider: string): void;
+    /** Report that an agent session ended. No-op if the host has no telemetry. */
+    onSessionEnded?(provider: string): void;
+    /** Report that a permission request was resolved. No-op if the host has no telemetry. */
+    onPermissionResolved?(info: {
+        provider: string;
+        tool: string;
+        decision: PermissionDecision;
+    }): void;
+    /** Report that a reconciliation poll found the polled session set drift from what the live IPC
+     *  path had already tracked — `discovered` sessions the poll saw but we weren't tracking,
+     *  `missing` sessions we track that the poll no longer reports alive. Ideally always zero. No-op
+     *  if the host has no telemetry. */
+    onSyncDiscrepancy?(info: {
+        provider: string;
+        discovered: number;
+        missing: number;
+        polled: number;
+        tracked: number;
+    }): void;
+    /** Notify the host that a branch has agent activity. */
+    onBranchAgentActivity?(cwd: string): void;
+    /**
+     * Run the GK CLI with the given args. Returns stdout.
+     *
+     * Host responsibilities:
+     * - Resolve the CLI executable path (e.g. via `resolveCLIExecutable`)
+     * - Provide the default `cwd` if `options.cwd` is not set (e.g. `globalStorageUri.fsPath` in VS Code)
+     * - Inject any environment-specific flags (e.g. `--insiders` when the host has insiders mode enabled)
+     */
+    runCLICommand(args: string[], options?: {
+        cwd?: string;
+    }): Promise<string>;
+    /**
+     * Resolve git metadata for a session's cwd. Returns the stable worktree path; the worktree's
+     * display name (branch name for branch-type worktrees) is intentionally NOT returned — it's
+     * resolved live at serialization time so `git checkout` updates display without restarting.
+     * Optional — if omitted, sessions won't have worktree metadata.
+     */
+    resolveGitInfo?(cwd: string): Promise<{
+        repoRoot: string;
+        isWorktree: boolean;
+        worktreePath?: string;
+    } | undefined>;
+    /**
+     * Open a Claude Code session in the Claude Code VS Code extension. Invoked by the IPC handler
+     * when a peer GitLens window asks this window to open a session on its behalf — the host wires
+     * this to `claude-vscode.editor.open`. Throws if the extension isn't installed/active.
+     */
+    openSessionInClaudeExtension?(sessionId: string): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/plus/agents/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/plus/agents/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAErD,eAAO,MAAM,+BAA+B,sYAwBlC,CAAC;AAEX,eAAO,MAAM,4BAA4B,gCAAiC,CAAC;AAE3E,MAAM,MAAM,mBAAmB,GAC5B,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,GAChD,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,MAAM,CAAC;AAElD,MAAM,MAAM,kBAAkB,GAC3B,UAAU,GACV,UAAU,GACV,YAAY,GACZ,SAAS,GACT,MAAM,GACN,YAAY,GACZ,sBAAsB,CAAC;AAE1B,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,GAAG,iBAAiB,CAa/E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAEpE;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;gGAMgG;AAChG,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,aAAa,CAAC;AAEjF,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACvD,kGAAkG;IAClG,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,oGAAoG;IACpG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,6DAA6D;IAC7D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;;;;;0DASsD;IACtD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAC7C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAC/C;;gFAE4E;IAC5E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;yCAGqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;6DAEyD;IACzD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC;;0DAEsD;IACtD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;;;;;;;;;;;;;;;;4FAqBwF;IACxF,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,IAAI,CAAC;QAAC,OAAO,CAAC,EAAE,IAAI,CAAA;KAAE,EAAE,CAAC;IACtG;;;;;;;;wDAQoD;IACpD,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE;QAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACF;AAED,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC9D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAE3C,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACtC,IAAI,IAAI,IAAI,CAAC;IACb,oBAAoB,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEtD;;gDAE4C;IAC5C,uBAAuB,CAAC,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAEnD;;;+CAG2C;IAC3C,iBAAiB,CAAC,CACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,kBAAkB,EAC5B,kBAAkB,CAAC,EAAE,oBAAoB,EAAE,GACzC,OAAO,CAAC;IAEX;;;;;;qEAMiE;IACjE,qBAAqB,CAAC,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnF;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,uGAAuG;IACvG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,eAAe,CAAC,OAAO,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,EACpD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,GACpC,iBAAiB,CAAC;IACrB,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACtC,6FAA6F;IAC7F,GAAG,EAAE,YAAY,CAAC;IAElB;;;;oCAIgC;IAChC,kBAAkB,CAAC,IAAI,MAAM,CAAC;IAE9B,gFAAgF;IAChF,gBAAgB,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1C,8EAA8E;IAC9E,cAAc,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExC,yFAAyF;IACzF,oBAAoB,CAAC,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,kBAAkB,CAAA;KAAE,GAAG,IAAI,CAAC;IAEpG;;;wCAGoC;IACpC,iBAAiB,CAAC,CAAC,IAAI,EAAE;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;KAChB,GAAG,IAAI,CAAC;IAET,wDAAwD;IACxD,qBAAqB,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1C;;;;;;;OAOG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3E;;;;;OAKG;IACH,cAAc,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAClC;QACA,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,OAAO,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,CAAC;KACrB,GACD,SAAS,CACX,CAAC;IAEF;;;;OAIG;IACH,4BAA4B,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE"}

package/dist/plus/agents/types.js

@@ -0,0 +1,49 @@
+export const claudeCodeNonBlockingHookEvents = [
+    'SessionStart',
+    'SessionEnd',
+    'UserPromptSubmit',
+    'PreToolUse',
+    'PostToolUse',
+    'PostToolUseFailure',
+    'Notification',
+    'Stop',
+    'StopFailure',
+    'SubagentStart',
+    'SubagentStop',
+    'TeammateIdle',
+    'TaskCompleted',
+    'InstructionsLoaded',
+    'ConfigChange',
+    'WorktreeCreate',
+    'WorktreeRemove',
+    'PreCompact',
+    'PostCompact',
+    'Elicitation',
+    'ElicitationResult',
+    'PermissionDenied',
+    'CwdChanged',
+];
+export const claudeCodeBlockingHookEvents = ['PermissionRequest'];
+export function getPhaseForStatus(status) {
+    switch (status) {
+        case 'thinking':
+        case 'tool_use':
+        case 'responding':
+        case 'compacting':
+            return 'working';
+        case 'waiting':
+        case 'permission_requested':
+            return 'waiting';
+        case 'idle':
+            return 'idle';
+    }
+}
+/**
+ * Returns whether the given phase represents an agent that is actively doing work or
+ * awaiting input (as opposed to fully idle). Uses an explicit allowlist so new phases
+ * default to "not active" rather than being silently treated as live.
+ */
+export function isActiveAgentPhase(phase) {
+    return phase === 'working' || phase === 'waiting';
+}
+//# sourceMappingURL=types.js.map

package/dist/plus/agents/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/plus/agents/types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC9C,cAAc;IACd,YAAY;IACZ,kBAAkB;IAClB,YAAY;IACZ,aAAa;IACb,oBAAoB;IACpB,cAAc;IACd,MAAM;IACN,aAAa;IACb,eAAe;IACf,cAAc;IACd,cAAc;IACd,eAAe;IACf,oBAAoB;IACpB,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,YAAY;IACZ,aAAa;IACb,aAAa;IACb,mBAAmB;IACnB,kBAAkB;IAClB,YAAY;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,mBAAmB,CAAU,CAAC;AAmB3E,MAAM,UAAU,iBAAiB,CAAC,MAA0B;IAC3D,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,UAAU,CAAC;QAChB,KAAK,UAAU,CAAC;QAChB,KAAK,YAAY,CAAC;QAClB,KAAK,YAAY;YAChB,OAAO,SAAS,CAAC;QAClB,KAAK,SAAS,CAAC;QACf,KAAK,sBAAsB;YAC1B,OAAO,SAAS,CAAC;QAClB,KAAK,MAAM;YACV,OAAO,MAAM,CAAC;IAChB,CAAC;AACF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAwB;IAC1D,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,CAAC;AACnD,CAAC"}

package/dist/plus/ai/errors.d.ts

@@ -9,7 +9,9 @@ export declare const enum AIErrorReason {
     ModelNotSupported = 7,
     ServiceCapacityExceeded = 8,
     Unauthorized = 9,
-    UserQuotaExceeded = 10
+    UserQuotaExceeded = 10,
+    NoNetwork = 11,
+    Unreachable = 12
 }
 export declare class AIError extends Error {
     readonly original?: Error;
@@ -22,4 +24,5 @@ export declare class AuthenticationRequiredError extends Error {
 export declare class AINoRequestDataError extends AIError {
     constructor(message?: string);
 }
+export declare function classifyNetworkError(ex: unknown): AIErrorReason.NoNetwork | AIErrorReason.Unreachable | undefined;
 //# sourceMappingURL=errors.d.ts.map

package/dist/plus/ai/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/plus/ai/errors.ts"],"names":[],"mappings":"AAAA,0BAAkB,aAAa;IAC9B,oBAAoB,IAAA;IACpB,YAAY,IAAA;IACZ,aAAa,IAAA;IACb,aAAa,IAAA;IACb,iBAAiB,IAAA;IACjB,wBAAwB,IAAA;IACxB,eAAe,IAAA;IACf,iBAAiB,IAAA;IACjB,uBAAuB,IAAA;IACvB,YAAY,IAAA;IACZ,iBAAiB,KAAA;CACjB;AAED,qBAAa,OAAQ,SAAQ,KAAK;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;gBAE/B,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,KAAK;CA+CnD;AAED,qBAAa,2BAA4B,SAAQ,KAAK;;CAMrD;AAED,qBAAa,oBAAqB,SAAQ,OAAO;gBACpC,OAAO,CAAC,EAAE,MAAM;CAK5B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/plus/ai/errors.ts"],"names":[],"mappings":"AAAA,0BAAkB,aAAa;IAC9B,oBAAoB,IAAA;IACpB,YAAY,IAAA;IACZ,aAAa,IAAA;IACb,aAAa,IAAA;IACb,iBAAiB,IAAA;IACjB,wBAAwB,IAAA;IACxB,eAAe,IAAA;IACf,iBAAiB,IAAA;IACjB,uBAAuB,IAAA;IACvB,YAAY,IAAA;IACZ,iBAAiB,KAAA;IACjB,SAAS,KAAA;IACT,WAAW,KAAA;CACX;AAED,qBAAa,OAAQ,SAAQ,KAAK;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;gBAE/B,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,KAAK;CAqDnD;AAED,qBAAa,2BAA4B,SAAQ,KAAK;;CAMrD;AAED,qBAAa,oBAAqB,SAAQ,OAAO;gBACpC,OAAO,CAAC,EAAE,MAAM;CAK5B;AAcD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,OAAO,GAAG,aAAa,CAAC,SAAS,GAAG,aAAa,CAAC,WAAW,GAAG,SAAS,CAkBjH"}

package/dist/plus/ai/errors.js

@@ -11,6 +11,8 @@ export var AIErrorReason;
     AIErrorReason[AIErrorReason["ServiceCapacityExceeded"] = 8] = "ServiceCapacityExceeded";
     AIErrorReason[AIErrorReason["Unauthorized"] = 9] = "Unauthorized";
     AIErrorReason[AIErrorReason["UserQuotaExceeded"] = 10] = "UserQuotaExceeded";
+    AIErrorReason[AIErrorReason["NoNetwork"] = 11] = "NoNetwork";
+    AIErrorReason[AIErrorReason["Unreachable"] = 12] = "Unreachable";
 })(AIErrorReason || (AIErrorReason = {}));
 export class AIError extends Error {
     original;
@@ -36,6 +38,12 @@ export class AIError extends Error {
             case AIErrorReason.ServiceCapacityExceeded:
                 message = 'Service capacity exceeded';
                 break;
+            case AIErrorReason.NoNetwork:
+                message = 'Unable to reach the AI service. Please check your internet connection.';
+                break;
+            case AIErrorReason.Unreachable:
+                message = 'The AI service is temporarily unreachable.';
+                break;
             case AIErrorReason.NoRequestData:
                 message = original?.message ?? 'No data was provided for the request';
                 break;
@@ -73,4 +81,34 @@ export class AINoRequestDataError extends AIError {
         Error.captureStackTrace?.(this, new.target);
     }
 }
+const noNetworkErrorCodes = new Set([
+    'ENOTFOUND',
+    'ECONNREFUSED',
+    'EAI_AGAIN',
+    'EHOSTUNREACH',
+    'ENETUNREACH',
+    'ENETDOWN',
+    'UND_ERR_CONNECT_TIMEOUT',
+]);
+const unreachableErrorCodes = new Set(['ECONNRESET', 'ETIMEDOUT', 'UND_ERR_SOCKET']);
+export function classifyNetworkError(ex) {
+    let current = ex;
+    let sawFetchFailed = false;
+    for (let depth = 0; depth < 5 && current != null; depth++) {
+        if (!(current instanceof Error))
+            break;
+        if (current.name === 'TypeError' && current.message === 'fetch failed') {
+            sawFetchFailed = true;
+        }
+        const code = current.code;
+        if (typeof code === 'string') {
+            if (noNetworkErrorCodes.has(code))
+                return AIErrorReason.NoNetwork;
+            if (unreachableErrorCodes.has(code))
+                return AIErrorReason.Unreachable;
+        }
+        current = current.cause;
+    }
+    return sawFetchFailed ? AIErrorReason.NoNetwork : undefined;
+}
 //# sourceMappingURL=errors.js.map

package/dist/plus/ai/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/plus/ai/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAkB,aAYjB;AAZD,WAAkB,aAAa;IAC9B,iFAAoB,CAAA;IACpB,iEAAY,CAAA;IACZ,mEAAa,CAAA;IACb,mEAAa,CAAA;IACb,2EAAiB,CAAA;IACjB,yFAAwB,CAAA;IACxB,uEAAe,CAAA;IACf,2EAAiB,CAAA;IACjB,uFAAuB,CAAA;IACvB,iEAAY,CAAA;IACZ,4EAAiB,CAAA;AAClB,CAAC,EAZiB,aAAa,KAAb,aAAa,QAY9B;AAED,MAAM,OAAO,OAAQ,SAAQ,KAAK;IACxB,QAAQ,CAAS;IACjB,MAAM,CAA4B;IAE3C,YAAY,MAAqB,EAAE,QAAgB;QAClD,IAAI,OAAO,CAAC;QACZ,QAAQ,MAAM,EAAE,CAAC;YAChB,KAAK,aAAa,CAAC,aAAa;gBAC/B,OAAO,GAAG,8DAA8D,CAAC;gBACzE,MAAM;YACP,KAAK,aAAa,CAAC,eAAe;gBACjC,OAAO,GAAG,0BAA0B,CAAC;gBACrC,MAAM;YACP,KAAK,aAAa,CAAC,iBAAiB;gBACnC,OAAO,GAAG,yCAAyC,CAAC;gBACpD,MAAM;YACP,KAAK,aAAa,CAAC,iBAAiB;gBACnC,OAAO,GAAG,qBAAqB,CAAC;gBAChC,MAAM;YACP,KAAK,aAAa,CAAC,wBAAwB;gBAC1C,OAAO,GAAG,qDAAqD,CAAC;gBAChE,MAAM;YACP,KAAK,aAAa,CAAC,uBAAuB;gBACzC,OAAO,GAAG,2BAA2B,CAAC;gBACtC,MAAM;YACP,KAAK,aAAa,CAAC,aAAa;gBAC/B,OAAO,GAAG,QAAQ,EAAE,OAAO,IAAI,sCAAsC,CAAC;gBACtE,MAAM;YACP,KAAK,aAAa,CAAC,iBAAiB;gBACnC,OAAO,GAAG,sCAAsC,CAAC;gBACjD,MAAM;YACP,KAAK,aAAa,CAAC,YAAY;gBAC9B,OAAO,GAAG,+DAA+D,CAAC;gBAC1E,MAAM;YACP,KAAK,aAAa,CAAC,oBAAoB;gBACtC,OAAO,GAAG,wEAAwE,CAAC;gBACnF,MAAM;YACP,KAAK,aAAa,CAAC,YAAY;gBAC9B,OAAO,GAAG,2DAA2D,CAAC;gBACtE,MAAM;YACP;gBACC,OAAO,GAAG,QAAQ,EAAE,OAAO,IAAI,2BAA2B,CAAC;gBAC3D,MAAM;QACR,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,KAAK,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;CACD;AAED,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IACrD;QACC,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAEjC,KAAK,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;CACD;AAED,MAAM,OAAO,oBAAqB,SAAQ,OAAO;IAChD,YAAY,OAAgB;QAC3B,KAAK,CAAC,aAAa,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAE7E,KAAK,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;CACD"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/plus/ai/errors.ts"],"names":[],"mappings":"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"}

package/dist/plus/ai/models/model.d.ts

@@ -18,7 +18,7 @@ export interface AIModelDescriptor<Provider extends AIProviders = AIProviders, M
     readonly provider: Provider;
     readonly model: Model;
 }
-export type AIActionType = 'explain-changes' | 'review-changes' | 'generate-commitMessage' | 'generate-stashMessage' | 'generate-changelog' | `generate-create-${'cloudPatch' | 'codeSuggestion' | 'pullRequest'}` | 'generate-commits' | 'generate-searchQuery';
+export type AIActionType = 'explain-changes' | 'review-changes' | 'generate-commitMessage' | 'generate-stashMessage' | 'generate-changelog' | `generate-create-${'cloudPatch' | 'codeSuggestion' | 'pullRequest'}` | 'generate-commits' | 'conflict-resolution' | 'generate-searchQuery';
 export interface AIProviderDescriptor<T extends AIProviders = AIProviders> {
     readonly id: T;
     readonly name: string;

package/dist/plus/ai/models/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/models/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAExF,MAAM,WAAW,OAAO,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW,EAAE,KAAK,SAAS,MAAM,GAAG,MAAM;IACjG,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IACpF,QAAQ,CAAC,QAAQ,EAAE;QAClB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAE1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW,EAAE,KAAK,SAAS,MAAM,GAAG,MAAM;IAC3G,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACtB;AAED,MAAM,MAAM,YAAY,GACrB,iBAAiB,GACjB,gBAAgB,GAChB,wBAAwB,GACxB,uBAAuB,GACvB,oBAAoB,GACpB,mBAAmB,YAAY,GAAG,gBAAgB,GAAG,aAAa,EAAE,GACpE,kBAAkB,GAClB,sBAAsB,CAAC;AAE1B,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACxE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,kBAAkB,GAAG,IAAI,GAAG,KAAK,CAAC;IAC9D,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAElC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,qCAAqC,CACrD,CAAC,SAAS,WAAW,GAAG,WAAW,CAClC,SAAQ,oBAAoB,CAAC,CAAC,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC7B;AAED,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,eAAe,EAAE,UAAU,oBAAoB,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAAC,EAyXrG,CAAC"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/models/model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAExF,MAAM,WAAW,OAAO,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW,EAAE,KAAK,SAAS,MAAM,GAAG,MAAM;IACjG,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC;IACpF,QAAQ,CAAC,QAAQ,EAAE;QAClB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAE1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW,EAAE,KAAK,SAAS,MAAM,GAAG,MAAM;IAC3G,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACtB;AAED,MAAM,MAAM,YAAY,GACrB,iBAAiB,GACjB,gBAAgB,GAChB,wBAAwB,GACxB,uBAAuB,GACvB,oBAAoB,GACpB,mBAAmB,YAAY,GAAG,gBAAgB,GAAG,aAAa,EAAE,GACpE,kBAAkB,GAClB,qBAAqB,GACrB,sBAAsB,CAAC;AAE1B,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACxE,QAAQ,CAAC,EAAE,EAAE,CAAC,CAAC;IACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,kBAAkB,GAAG,IAAI,GAAG,KAAK,CAAC;IAC9D,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAElC,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,qCAAqC,CACrD,CAAC,SAAS,WAAW,GAAG,WAAW,CAClC,SAAQ,oBAAoB,CAAC,CAAC,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC7B;AAED,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,eAAe,EAAE,UAAU,oBAAoB,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAAC,EAyXrG,CAAC"}