sidekick-shared 0.13.2

package/dist/search/sessionSearch.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * Provider-aware cross-session search.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchSessions = searchSessions;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+async function searchSessions(provider, query, opts) {
+    const maxResults = opts?.maxResults ?? 50;
+    const results = [];
+    const baseDir = provider.getProjectsBaseDir();
+    try {
+        if (!fs.existsSync(baseDir))
+            return results;
+        // Get all project folders
+        const folders = provider.getAllProjectFolders();
+        for (const folder of folders) {
+            if (results.length >= maxResults)
+                break;
+            // If projectSlug specified, filter by encoded name
+            if (opts?.projectSlug && folder.encodedName !== opts.projectSlug)
+                continue;
+            // Get session files in this folder
+            let sessionFiles = [];
+            try {
+                const dir = folder.dir;
+                if (fs.existsSync(dir)) {
+                    const entries = fs.readdirSync(dir).filter(f => f.endsWith('.jsonl') || f.endsWith('.json'));
+                    sessionFiles = entries.map(f => path.join(dir, f));
+                }
+            }
+            catch { /* skip */ }
+            // If no files found from dir scan, try findAllSessions with the folder name
+            if (sessionFiles.length === 0) {
+                // Use provider.findSessionFiles with the folder path as workspace
+                // This handles DB-backed providers
+                sessionFiles = provider.findSessionFiles(folder.name);
+            }
+            for (const sessionPath of sessionFiles) {
+                if (results.length >= maxResults)
+                    break;
+                const remaining = maxResults - results.length;
+                const hits = provider.searchInSession(sessionPath, query, remaining);
+                for (const hit of hits) {
+                    results.push({
+                        providerId: provider.id,
+                        projectPath: hit.projectPath || folder.name,
+                        sessionPath: hit.sessionPath,
+                        snippet: hit.line,
+                        eventType: hit.eventType,
+                        timestamp: hit.timestamp,
+                    });
+                }
+            }
+        }
+    }
+    catch { /* skip */ }
+    return results.slice(0, maxResults);
+}

package/dist/types/codex.d.ts

@@ -0,0 +1,276 @@
+/**
+ * @fileoverview Type definitions for Codex CLI (OpenAI) session rollout format.
+ *
+ * Codex stores sessions as JSONL rollout files in:
+ *   ~/.codex/sessions/YYYY/MM/DD/rollout-<timestamp>-<uuid>.jsonl
+ * with an optional SQLite index at ~/.codex/state.sqlite.
+ *
+ * Each line is a JSON object: { timestamp, type, payload }
+ * with 5 top-level types: session_meta, response_item, compacted, turn_context, event_msg.
+ *
+ * @module types/codex
+ */
+/** Top-level rollout line in a Codex JSONL file. */
+export interface CodexRolloutLine {
+    /** ISO 8601 timestamp */
+    timestamp: string;
+    /** Discriminator for the payload type */
+    type: 'session_meta' | 'response_item' | 'compacted' | 'turn_context' | 'event_msg';
+    /** Type-specific payload */
+    payload: CodexSessionMeta | CodexResponseItem | CodexCompacted | CodexTurnContext | CodexEventMsg;
+}
+/** Session metadata written at the start of a rollout file. */
+export interface CodexSessionMeta {
+    id: string;
+    timestamp?: string;
+    cwd: string;
+    originator?: string;
+    model_provider?: string;
+    cli_version?: string;
+    source?: string;
+    base_instructions?: {
+        text?: string;
+    };
+    git?: {
+        branch?: string;
+        commit?: string;
+        dirty?: boolean;
+    };
+    forked_from_id?: string;
+}
+/**
+ * A response item from the model.
+ * The payload IS the item directly (no .item wrapper).
+ * Tagged union on `type`.
+ */
+export type CodexResponseItem = CodexMessageItem | CodexReasoningItem | CodexFunctionCallItem | CodexFunctionCallOutputItem | CodexLocalShellCallItem | CodexWebSearchCallItem | CodexCustomToolCallItem | CodexCustomToolCallOutputItem;
+/** Chat message (user, assistant, or developer). */
+export interface CodexMessageItem {
+    type: 'message';
+    id?: string;
+    role: 'user' | 'assistant' | 'developer' | 'system';
+    content: CodexContentPart[] | string;
+    status?: string;
+    phase?: string;
+}
+/** Content part within a message. */
+export interface CodexContentPart {
+    type: 'output_text' | 'input_text' | 'refusal' | 'text';
+    text?: string;
+    annotations?: unknown[];
+}
+/** Reasoning / thinking output. */
+export interface CodexReasoningItem {
+    type: 'reasoning';
+    id?: string;
+    summary?: CodexReasoningSummary[];
+    content?: unknown;
+    encrypted_content?: string;
+}
+export interface CodexReasoningSummary {
+    type: 'summary_text';
+    text: string;
+}
+/** Function call initiated by the model. */
+export interface CodexFunctionCallItem {
+    type: 'function_call';
+    id?: string;
+    call_id: string;
+    name: string;
+    arguments: string;
+    status?: string;
+}
+/** Result of a function call. */
+export interface CodexFunctionCallOutputItem {
+    type: 'function_call_output';
+    call_id: string;
+    output: string;
+}
+/** Local shell command execution. */
+export interface CodexLocalShellCallItem {
+    type: 'local_shell_call';
+    id?: string;
+    call_id: string;
+    action: {
+        type: 'exec';
+        command: string[];
+        workdir?: string;
+        timeout?: number;
+    };
+    status?: string;
+}
+/** Web search call. */
+export interface CodexWebSearchCallItem {
+    type: 'web_search_call';
+    id?: string;
+    call_id?: string;
+    status?: string;
+}
+/** Custom tool call (e.g. apply_patch, web_search). */
+export interface CodexCustomToolCallItem {
+    type: 'custom_tool_call';
+    id?: string;
+    call_id: string;
+    name: string;
+    input: string;
+    status?: string;
+}
+/** Result of a custom tool call. */
+export interface CodexCustomToolCallOutputItem {
+    type: 'custom_tool_call_output';
+    call_id: string;
+    output: string;
+}
+/** Context compaction marker. */
+export interface CodexCompacted {
+    summary?: string;
+}
+/** Turn context providing model and policy info. */
+export interface CodexTurnContext {
+    model?: string;
+    cwd?: string;
+    approval_policy?: string;
+    sandbox_policy?: string;
+    effort?: string;
+}
+/**
+ * Event message. The payload IS the event directly (no .event wrapper).
+ * Tagged union on `type`.
+ */
+export type CodexEventMsg = CodexEvent;
+export type CodexEvent = CodexTurnStartedEvent | CodexTurnCompleteEvent | CodexTaskStartedEvent | CodexTaskCompleteEvent | CodexTurnAbortedEvent | CodexTokenCountEvent | CodexAgentMessageEvent | CodexAgentReasoningEvent | CodexUserMessageEvent | CodexExecCommandBeginEvent | CodexExecCommandEndEvent | CodexMcpToolCallBeginEvent | CodexMcpToolCallEndEvent | CodexErrorEvent | CodexContextCompactedEvent | CodexPatchAppliedEvent | CodexBackgroundEvent | CodexGenericEvent;
+export interface CodexTurnStartedEvent {
+    type: 'turn_started';
+    turn_id?: string;
+}
+export interface CodexTurnCompleteEvent {
+    type: 'turn_complete';
+    turn_id?: string;
+}
+export interface CodexTaskStartedEvent {
+    type: 'task_started';
+    turn_id?: string;
+    model_context_window?: number;
+    collaboration_mode_kind?: string;
+}
+export interface CodexTaskCompleteEvent {
+    type: 'task_complete';
+    turn_id?: string;
+    last_agent_message?: string;
+}
+export interface CodexTurnAbortedEvent {
+    type: 'turn_aborted';
+    reason?: string;
+}
+export interface CodexAgentReasoningEvent {
+    type: 'agent_reasoning';
+    text: string;
+}
+export interface CodexTokenCountEvent {
+    type: 'token_count';
+    info: {
+        total_token_usage?: CodexTokenUsage;
+        last_token_usage?: CodexTokenUsage;
+        model_context_window?: number;
+    } | null;
+    rate_limits?: CodexRateLimits;
+}
+export interface CodexRateLimits {
+    limit_id?: string;
+    limit_name?: string | null;
+    primary?: {
+        used_percent: number;
+        window_minutes: number;
+        resets_at: number;
+    };
+    secondary?: {
+        used_percent: number;
+        window_minutes: number;
+        resets_at: number;
+    };
+}
+export interface CodexTokenUsage {
+    input_tokens: number;
+    cached_input_tokens?: number;
+    output_tokens: number;
+    reasoning_output_tokens?: number;
+    total_tokens?: number;
+}
+export interface CodexAgentMessageEvent {
+    type: 'agent_message';
+    message: string;
+}
+export interface CodexUserMessageEvent {
+    type: 'user_message';
+    message: string;
+}
+export interface CodexExecCommandBeginEvent {
+    type: 'exec_command_begin';
+    call_id: string;
+    command: string[];
+    workdir?: string;
+    timeout?: number;
+}
+export interface CodexExecCommandEndEvent {
+    type: 'exec_command_end';
+    call_id: string;
+    exit_code: number;
+    stdout?: string;
+    stderr?: string;
+    duration_ms?: number;
+}
+export interface CodexMcpToolCallBeginEvent {
+    type: 'mcp_tool_call_begin';
+    call_id: string;
+    server_name?: string;
+    tool_name: string;
+    arguments?: Record<string, unknown>;
+}
+export interface CodexMcpToolCallEndEvent {
+    type: 'mcp_tool_call_end';
+    call_id: string;
+    result?: string;
+    is_error?: boolean;
+    duration_ms?: number;
+}
+export interface CodexErrorEvent {
+    type: 'error';
+    message: string;
+    code?: string;
+}
+export interface CodexContextCompactedEvent {
+    type: 'context_compacted';
+    summary?: string;
+    tokens_before?: number;
+    tokens_after?: number;
+}
+export interface CodexPatchAppliedEvent {
+    type: 'patch_applied';
+    file_path?: string;
+    additions?: number;
+    deletions?: number;
+}
+export interface CodexBackgroundEvent {
+    type: 'background';
+    message?: string;
+}
+/** Catch-all for unrecognized event types. */
+export interface CodexGenericEvent {
+    type: string;
+    [key: string]: unknown;
+}
+/** Row from the Codex state.sqlite threads table. */
+export interface CodexDbThread {
+    id: string;
+    rollout_path: string;
+    cwd: string;
+    created_at: number;
+    updated_at: number;
+    title?: string;
+    tokens_used?: number;
+    first_user_message?: string;
+    model_provider?: string;
+    git_branch?: string;
+    git_commit?: string;
+    forked_from_id?: string;
+}

package/dist/types/codex.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * @fileoverview Type definitions for Codex CLI (OpenAI) session rollout format.
+ *
+ * Codex stores sessions as JSONL rollout files in:
+ *   ~/.codex/sessions/YYYY/MM/DD/rollout-<timestamp>-<uuid>.jsonl
+ * with an optional SQLite index at ~/.codex/state.sqlite.
+ *
+ * Each line is a JSON object: { timestamp, type, payload }
+ * with 5 top-level types: session_meta, response_item, compacted, turn_context, event_msg.
+ *
+ * @module types/codex
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/decisionLog.d.ts

@@ -0,0 +1,23 @@
+/**
+ * On-disk schema types for cross-session decision log.
+ * Canonical source: sidekick-vscode/src/types/decisionLog.ts
+ */
+export declare const DECISION_LOG_SCHEMA_VERSION = 1;
+export type DecisionSource = 'recovery_pattern' | 'plan_mode' | 'user_question' | 'text_pattern';
+export interface DecisionEntry {
+    id: string;
+    description: string;
+    rationale: string;
+    alternatives?: string[];
+    chosenOption: string;
+    source: DecisionSource;
+    sessionId: string;
+    timestamp: string;
+    tags?: string[];
+}
+export interface DecisionLogStore {
+    schemaVersion: number;
+    decisions: Record<string, DecisionEntry>;
+    lastSessionId: string;
+    lastSaved: string;
+}

package/dist/types/decisionLog.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * On-disk schema types for cross-session decision log.
+ * Canonical source: sidekick-vscode/src/types/decisionLog.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DECISION_LOG_SCHEMA_VERSION = void 0;
+exports.DECISION_LOG_SCHEMA_VERSION = 1;

package/dist/types/historicalData.d.ts

@@ -0,0 +1,74 @@
+/**
+ * On-disk schema types for historical session data.
+ * Canonical source: sidekick-vscode/src/types/historicalData.ts
+ */
+export declare const HISTORICAL_DATA_SCHEMA_VERSION = 1;
+export interface TokenTotals {
+    inputTokens: number;
+    outputTokens: number;
+    cacheWriteTokens: number;
+    cacheReadTokens: number;
+}
+export interface ModelUsageRecord {
+    model: string;
+    calls: number;
+    tokens: number;
+    cost: number;
+}
+export interface ToolUsageRecord {
+    tool: string;
+    calls: number;
+    successCount: number;
+    failureCount: number;
+}
+export interface DailyData {
+    date: string;
+    tokens: TokenTotals;
+    totalCost: number;
+    messageCount: number;
+    sessionCount: number;
+    modelUsage: ModelUsageRecord[];
+    toolUsage: ToolUsageRecord[];
+    updatedAt: string;
+}
+export interface MonthlyData {
+    month: string;
+    tokens: TokenTotals;
+    totalCost: number;
+    messageCount: number;
+    sessionCount: number;
+    modelUsage: ModelUsageRecord[];
+    toolUsage: ToolUsageRecord[];
+    updatedAt: string;
+}
+export interface AllTimeStats {
+    tokens: TokenTotals;
+    totalCost: number;
+    messageCount: number;
+    sessionCount: number;
+    firstDate: string;
+    lastDate: string;
+    modelUsage: ModelUsageRecord[];
+    toolUsage: ToolUsageRecord[];
+    updatedAt: string;
+}
+export interface HistoricalDataStore {
+    schemaVersion: number;
+    daily: Record<string, DailyData>;
+    monthly: Record<string, MonthlyData>;
+    allTime: AllTimeStats;
+    lastSaved: string;
+    importedFiles?: string[];
+    lastImportTimestamp?: string;
+}
+export interface SessionSummary {
+    sessionId: string;
+    startTime: string;
+    endTime: string;
+    tokens: TokenTotals;
+    totalCost: number;
+    messageCount: number;
+    modelUsage: ModelUsageRecord[];
+    toolUsage: ToolUsageRecord[];
+}
+export declare function createEmptyTokenTotals(): TokenTotals;

package/dist/types/historicalData.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * On-disk schema types for historical session data.
+ * Canonical source: sidekick-vscode/src/types/historicalData.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HISTORICAL_DATA_SCHEMA_VERSION = void 0;
+exports.createEmptyTokenTotals = createEmptyTokenTotals;
+exports.HISTORICAL_DATA_SCHEMA_VERSION = 1;
+function createEmptyTokenTotals() {
+    return {
+        inputTokens: 0,
+        outputTokens: 0,
+        cacheWriteTokens: 0,
+        cacheReadTokens: 0,
+    };
+}

package/dist/types/knowledgeNote.d.ts

@@ -0,0 +1,40 @@
+/**
+ * On-disk schema types for knowledge notes.
+ * Canonical source: sidekick-vscode/src/types/knowledgeNote.ts
+ */
+export declare const KNOWLEDGE_NOTE_SCHEMA_VERSION = 1;
+export type KnowledgeNoteType = 'gotcha' | 'pattern' | 'guideline' | 'tip';
+export type KnowledgeNoteSource = 'manual' | 'auto_error' | 'auto_recovery' | 'auto_guidance';
+export type KnowledgeNoteStatus = 'active' | 'needs_review' | 'stale' | 'obsolete';
+export type KnowledgeNoteImportance = 'critical' | 'high' | 'medium' | 'low';
+export declare const IMPORTANCE_DECAY_FACTORS: Record<KnowledgeNoteImportance, number>;
+export declare const STALENESS_THRESHOLDS: {
+    needsReview: number;
+    stale: number;
+};
+export interface KnowledgeNote {
+    id: string;
+    noteType: KnowledgeNoteType;
+    content: string;
+    title?: string;
+    filePath: string;
+    lineRange?: {
+        start: number;
+        end: number;
+    };
+    codeSnippet?: string;
+    source: KnowledgeNoteSource;
+    status: KnowledgeNoteStatus;
+    importance: KnowledgeNoteImportance;
+    sessionId?: string;
+    createdAt: string;
+    updatedAt: string;
+    lastReviewedAt: string;
+    tags?: string[];
+}
+export interface KnowledgeNoteStore {
+    schemaVersion: number;
+    notesByFile: Record<string, KnowledgeNote[]>;
+    lastSaved: string;
+    totalNotes: number;
+}

package/dist/types/knowledgeNote.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * On-disk schema types for knowledge notes.
+ * Canonical source: sidekick-vscode/src/types/knowledgeNote.ts
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STALENESS_THRESHOLDS = exports.IMPORTANCE_DECAY_FACTORS = exports.KNOWLEDGE_NOTE_SCHEMA_VERSION = void 0;
+exports.KNOWLEDGE_NOTE_SCHEMA_VERSION = 1;
+exports.IMPORTANCE_DECAY_FACTORS = {
+    critical: 2.0,
+    high: 1.5,
+    medium: 1.0,
+    low: 0.5,
+};
+exports.STALENESS_THRESHOLDS = {
+    needsReview: 30,
+    stale: 90,
+};