@compass-ai/nova 1.0.73 → 1.0.74

package/dist/types/approval.d.ts

@@ -0,0 +1,332 @@
+/**
+ * Type definitions for the three-tier approval system
+ *
+ * This module defines all types, interfaces, and enums related to the
+ * approval workflow in Compass CLI. The approval system supports three modes:
+ * - MANUAL: Requires explicit user approval for each operation
+ * - AUTO: Automatically approves safe operations based on patterns and thresholds
+ * - STRICT: Requires approval for all operations including low-risk ones
+ *
+ * The approval system is designed to:
+ * - Protect users from unintended file modifications
+ * - Provide transparency about what operations will be performed
+ * - Allow power users to streamline their workflow with auto-approval
+ * - Maintain an audit trail of all approval decisions
+ */
+/**
+ * Approval mode enum defining the four tiers of the approval system.
+ *
+ * @example
+ * ```typescript
+ * import { ApprovalMode } from './types/approval.js';
+ *
+ * // Set to manual mode for careful review
+ * const mode = ApprovalMode.MANUAL;
+ *
+ * // Set to auto mode for faster workflow
+ * const mode = ApprovalMode.AUTO;
+ *
+ * // Set to smart mode for complexity-aware auto-approval
+ * const mode = ApprovalMode.SMART;
+ * ```
+ */
+export declare enum ApprovalMode {
+    /** Requires explicit approval for each operation */
+    MANUAL = "manual",
+    /** Automatically approves safe operations based on configuration */
+    AUTO = "auto",
+    /** Requires approval for all operations, even low-risk ones */
+    STRICT = "strict",
+    /** Smart mode: auto-approves DIRECT complexity tasks with low risk, requires approval otherwise */
+    SMART = "smart"
+}
+/**
+ * Types of operations that can require approval.
+ * Each type has different risk characteristics and approval behavior.
+ */
+export type ApprovalType = 'file_create' | 'file_modify' | 'file_delete' | 'file_rename' | 'file_read_external' | 'shell_command' | 'git_commit' | 'git_push' | 'multi_file_operation';
+/**
+ * Risk level assessment for operations.
+ * Used to determine whether auto-approval is appropriate.
+ *
+ * - low: Safe operations like creating new files or small modifications
+ * - medium: Operations that modify existing code or run shell commands
+ * - high: Destructive operations like file deletion or large changes
+ * - critical: Operations that cannot be easily undone like git push
+ */
+export type RiskLevel = 'low' | 'medium' | 'high' | 'critical';
+/**
+ * User choices available in the approval dialog.
+ *
+ * - approve: Accept and execute the operation
+ * - approve_all_session: Approve this and auto-approve all subsequent operations this session
+ * - approve_command_type: Approve this and auto-approve this command type (e.g., npm, git)
+ * - reject: Decline the operation
+ * - view_diff: Toggle diff preview (for file modifications)
+ * - edit: Modify the operation before approval (future feature)
+ * - cancel: Cancel the entire workflow
+ */
+export type ApprovalChoice = 'approve' | 'approve_all_session' | 'approve_command_type' | 'reject' | 'view_diff' | 'edit' | 'cancel';
+/**
+ * Complexity mode from the complexity classifier.
+ * Used by SMART approval mode to make intelligent auto-approval decisions.
+ */
+export type ComplexityMode = 'direct' | 'clarification' | 'plan';
+/**
+ * Detailed information about an operation requiring approval.
+ * Contains all the context needed for the user to make an informed decision.
+ */
+export interface ApprovalDetails {
+    /** Array of file paths affected by the operation */
+    filePaths?: string[];
+    /** Unified diff string for file modifications */
+    diff?: string;
+    /** Shell command to be executed (for shell_command type) */
+    command?: string;
+    /** Total number of files affected */
+    affectedFiles?: number;
+    /** Number of lines being added */
+    linesAdded?: number;
+    /** Number of lines being removed */
+    linesRemoved?: number;
+    /** Complexity mode from the classifier (for SMART mode decisions) */
+    complexityMode?: ComplexityMode;
+    /** Confidence score from complexity classification (0-100) */
+    complexityConfidence?: number;
+    /** Path to a temporary preview file for VS Code integration */
+    previewFilePath?: string;
+}
+/**
+ * Represents a request for user approval.
+ * Created when an operation needs user consent before execution.
+ *
+ * @example
+ * ```typescript
+ * const request: ApprovalRequest = {
+ *   id: 'abc-123',
+ *   type: 'file_modify',
+ *   timestamp: '2025-12-26T10:30:00.000Z',
+ *   description: 'Update configuration file',
+ *   details: {
+ *     filePaths: ['config.json'],
+ *     affectedFiles: 1,
+ *     linesAdded: 5,
+ *     linesRemoved: 2,
+ *     diff: '--- a/config.json\n+++ b/config.json\n...',
+ *   },
+ *   riskLevel: 'low',
+ *   estimatedImpact: '1 file, +5 additions, -2 removed',
+ * };
+ * ```
+ */
+export interface ApprovalRequest {
+    /** Unique identifier for the request (UUID) */
+    id: string;
+    /** Type of operation requiring approval */
+    type: ApprovalType;
+    /** ISO-8601 timestamp when the request was created */
+    timestamp: string;
+    /** Human-readable description of the operation */
+    description: string;
+    /** Detailed information about the operation */
+    details: ApprovalDetails;
+    /** Assessed risk level of the operation */
+    riskLevel: RiskLevel;
+    /** Human-readable summary of the operation's impact */
+    estimatedImpact: string;
+}
+/**
+ * Represents the user's response to an approval request.
+ * Recorded for audit purposes and to complete the approval workflow.
+ *
+ * @example
+ * ```typescript
+ * const response: ApprovalResponse = {
+ *   requestId: 'abc-123',
+ *   approved: true,
+ *   timestamp: '2025-12-26T10:30:05.000Z',
+ *   mode: ApprovalMode.MANUAL,
+ *   reason: 'Reviewed and approved by user',
+ * };
+ * ```
+ */
+export interface ApprovalResponse {
+    /** ID of the request this response is for */
+    requestId: string;
+    /** Whether the operation was approved */
+    approved: boolean;
+    /** ISO-8601 timestamp when the response was recorded */
+    timestamp: string;
+    /** The approval mode that was active when the decision was made */
+    mode: ApprovalMode;
+    /** Optional reason for the decision (useful for audit) */
+    reason?: string;
+    /** Optional modifications to the original request (for edit feature) */
+    modifiedRequest?: Partial<ApprovalDetails>;
+}
+/**
+ * History of all approval requests and responses in a session.
+ * Used for audit logging and undo functionality.
+ */
+export interface ApprovalHistory {
+    /** All approval requests made during the session */
+    requests: ApprovalRequest[];
+    /** All responses to approval requests */
+    responses: ApprovalResponse[];
+}
+/**
+ * Configuration options for the approval manager.
+ * Controls auto-approval behavior and thresholds.
+ *
+ * @example
+ * ```typescript
+ * const config: ApprovalConfig = {
+ *   mode: ApprovalMode.AUTO,
+ *   autoApprovePatterns: ['*.test.ts', '*.spec.ts'],
+ *   requireApprovalPatterns: ['.env*', 'secrets/**'],
+ *   maxAutoApproveFiles: 5,
+ *   maxAutoApproveLines: 100,
+ * };
+ * ```
+ */
+export interface ApprovalConfig {
+    /** Current approval mode */
+    mode: ApprovalMode;
+    /** Glob patterns for files that can be auto-approved */
+    autoApprovePatterns: string[];
+    /** Glob patterns for files that always require manual approval */
+    requireApprovalPatterns: string[];
+    /** Maximum number of files that can be auto-approved in one operation */
+    maxAutoApproveFiles: number;
+    /** Maximum number of lines changed that can be auto-approved */
+    maxAutoApproveLines: number;
+}
+/**
+ * Statistics about approval history for reporting.
+ */
+export interface ApprovalStatistics {
+    /** Total number of approval requests */
+    totalRequests: number;
+    /** Number of approved requests */
+    approved: number;
+    /** Number of rejected requests */
+    rejected: number;
+    /** Number of requests that were auto-approved */
+    autoApproved: number;
+    /** Breakdown by operation type */
+    byType?: Record<ApprovalType, number>;
+    /** Breakdown by risk level */
+    byRiskLevel?: Record<RiskLevel, number>;
+}
+/**
+ * Event payload emitted when approval is required.
+ * Used for UI integration via the event emitter.
+ */
+export interface ApprovalRequiredEvent {
+    /** The approval request that needs user attention */
+    request: ApprovalRequest;
+}
+/**
+ * Event payload emitted when an approval decision is made.
+ */
+export interface ApprovalDecisionEvent {
+    /** The original request */
+    request: ApprovalRequest;
+    /** The user's response */
+    response: ApprovalResponse;
+}
+import type { ImplementationPlan, ContextGatheringResult, ComplexityClassificationResult } from './workflow.js';
+/**
+ * User choices available in the plan approval dialog.
+ *
+ * - approve: Accept the plan and proceed with execution
+ * - clarify: Ask clarifying questions (shows input + returns to LLM)
+ * - edit: Modify the plan (shows editor for user input)
+ * - reject: Reject the plan and cancel workflow
+ * - approve-auto-edits: Approve and auto-accept file writes and edits
+ */
+export type PlanApprovalChoice = 'approve' | 'approve-compact' | 'approve-auto-edits' | 'clarify' | 'edit' | 'reject';
+/**
+ * Represents a request for plan approval.
+ * Created when an implementation plan needs user consent before execution.
+ */
+export interface PlanApprovalRequest {
+    /** Unique identifier for the request (UUID) */
+    id: string;
+    /** ISO-8601 timestamp when the request was created */
+    timestamp: string;
+    /** The generated implementation plan requiring approval */
+    plan: ImplementationPlan;
+    /** Context gathered about the project */
+    context: ContextGatheringResult;
+    /** Complexity assessment results */
+    complexity: ComplexityClassificationResult;
+    /** Task IDs that were already completed before the update (for plan updates) */
+    completedTaskIds?: string[];
+}
+/**
+ * Represents the user's response to a plan approval request.
+ */
+export interface PlanApprovalResponse {
+    /** ID of the request this response is for */
+    requestId: string;
+    /** Whether the plan was approved */
+    approved: boolean;
+    /** ISO-8601 timestamp when the response was recorded */
+    timestamp: string;
+    /** The specific choice made by the user */
+    choice: PlanApprovalChoice;
+    /** User's modifications when choice is 'edit' */
+    modifications?: string;
+    /** User's clarifying questions when choice is 'clarify' */
+    clarifications?: string;
+}
+/**
+ * Event payload emitted when plan approval is required.
+ * Used for UI integration via the event emitter.
+ */
+export interface PlanApprovalRequiredEvent {
+    /** The plan approval request that needs user attention */
+    request: PlanApprovalRequest;
+}
+import type { ClarificationQuestion, ClarificationAnswer, ClarificationResult } from './workflow.js';
+/**
+ * Request for clarification wizard to be displayed.
+ * Triggers the wizard UI to collect user preferences.
+ */
+export interface ClarificationWizardRequest {
+    /** Unique identifier for the request (UUID) */
+    id: string;
+    /** ISO-8601 timestamp when the request was created */
+    timestamp: string;
+    /** The task summary requiring clarification */
+    taskSummary: string;
+    /** The questions to ask the user */
+    questions: ClarificationQuestion[];
+    /** Reasoning from complexity classifier */
+    reasoning: string;
+}
+/**
+ * Response from the clarification wizard.
+ */
+export interface ClarificationWizardResponse {
+    /** ID of the request this response is for */
+    requestId: string;
+    /** Whether clarification was completed (not cancelled) */
+    completed: boolean;
+    /** ISO-8601 timestamp when the response was recorded */
+    timestamp: string;
+    /** The user's answers to questions */
+    answers?: ClarificationAnswer[];
+    /** Formatted result for LLM consumption */
+    result?: ClarificationResult;
+}
+/**
+ * Event payload emitted when clarification is required.
+ * Used for UI integration via the event emitter.
+ */
+export interface ClarificationRequiredEvent {
+    /** The clarification request that needs user attention */
+    request: ClarificationWizardRequest;
+}
+//# sourceMappingURL=approval.d.ts.map

package/dist/types/approval.d.ts.map

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

package/dist/types/approval.js

@@ -0,0 +1,44 @@
+/**
+ * Type definitions for the three-tier approval system
+ *
+ * This module defines all types, interfaces, and enums related to the
+ * approval workflow in Compass CLI. The approval system supports three modes:
+ * - MANUAL: Requires explicit user approval for each operation
+ * - AUTO: Automatically approves safe operations based on patterns and thresholds
+ * - STRICT: Requires approval for all operations including low-risk ones
+ *
+ * The approval system is designed to:
+ * - Protect users from unintended file modifications
+ * - Provide transparency about what operations will be performed
+ * - Allow power users to streamline their workflow with auto-approval
+ * - Maintain an audit trail of all approval decisions
+ */
+/**
+ * Approval mode enum defining the four tiers of the approval system.
+ *
+ * @example
+ * ```typescript
+ * import { ApprovalMode } from './types/approval.js';
+ *
+ * // Set to manual mode for careful review
+ * const mode = ApprovalMode.MANUAL;
+ *
+ * // Set to auto mode for faster workflow
+ * const mode = ApprovalMode.AUTO;
+ *
+ * // Set to smart mode for complexity-aware auto-approval
+ * const mode = ApprovalMode.SMART;
+ * ```
+ */
+export var ApprovalMode;
+(function (ApprovalMode) {
+    /** Requires explicit approval for each operation */
+    ApprovalMode["MANUAL"] = "manual";
+    /** Automatically approves safe operations based on configuration */
+    ApprovalMode["AUTO"] = "auto";
+    /** Requires approval for all operations, even low-risk ones */
+    ApprovalMode["STRICT"] = "strict";
+    /** Smart mode: auto-approves DIRECT complexity tasks with low risk, requires approval otherwise */
+    ApprovalMode["SMART"] = "smart";
+})(ApprovalMode || (ApprovalMode = {}));
+//# sourceMappingURL=approval.js.map

package/dist/types/approval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval.js","sourceRoot":"","sources":["../../src/types/approval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAN,IAAY,YASX;AATD,WAAY,YAAY;IACtB,oDAAoD;IACpD,iCAAiB,CAAA;IACjB,oEAAoE;IACpE,6BAAa,CAAA;IACb,+DAA+D;IAC/D,iCAAiB,CAAA;IACjB,mGAAmG;IACnG,+BAAe,CAAA;AACjB,CAAC,EATW,YAAY,KAAZ,YAAY,QASvB"}

package/dist/types/autocomplete.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Type definitions for autocomplete functionality.
+ * These types support enhanced autocomplete behavior including immediate suggestions
+ * and auto-execution of commands when selected from autocomplete.
+ */
+/**
+ * Metadata about autocomplete selection state.
+ * Tracks whether a command was selected from autocomplete and should auto-execute.
+ */
+export interface AutocompleteSelectionMetadata {
+    /**
+     * Whether the current command was selected from autocomplete suggestions.
+     * When true, indicates the user pressed Enter on an autocomplete suggestion
+     * rather than typing the command manually.
+     */
+    isAutocompleteSelected: boolean;
+    /**
+     * Whether the command should auto-execute without requiring additional Enter press.
+     * When true, the command will execute immediately after selection from autocomplete.
+     */
+    shouldAutoExecute: boolean;
+    /**
+     * The original input text before autocomplete selection (optional).
+     * Useful for debugging and tracking user intent.
+     */
+    originalInput?: string;
+    /**
+     * The selected completion text (optional).
+     * The full text that was inserted when the user selected from autocomplete.
+     */
+    selectedCompletion?: string;
+}
+/**
+ * Context for command execution including autocomplete metadata.
+ * Extends command execution with information about how the command was invoked.
+ */
+export interface CommandExecutionContext {
+    /**
+     * The raw command string to execute.
+     */
+    command: string;
+    /**
+     * Autocomplete selection metadata, if applicable.
+     * Undefined if command was typed manually without autocomplete.
+     */
+    autocompleteMetadata?: AutocompleteSelectionMetadata;
+    /**
+     * Whether to auto-execute the command without confirmation.
+     * Derived from autocompleteMetadata.shouldAutoExecute or set explicitly.
+     */
+    autoExecute?: boolean;
+    /**
+     * Timestamp when the command was initiated.
+     */
+    timestamp?: number;
+}
+//# sourceMappingURL=autocomplete.d.ts.map

package/dist/types/autocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.d.ts","sourceRoot":"","sources":["../../src/types/autocomplete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C;;;;OAIG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAEhC;;;OAGG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,6BAA6B,CAAC;IAErD;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/autocomplete.js

@@ -0,0 +1,7 @@
+/**
+ * Type definitions for autocomplete functionality.
+ * These types support enhanced autocomplete behavior including immediate suggestions
+ * and auto-execution of commands when selected from autocomplete.
+ */
+export {};
+//# sourceMappingURL=autocomplete.js.map

package/dist/types/autocomplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.js","sourceRoot":"","sources":["../../src/types/autocomplete.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/types/chat-archive.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Type definitions for chat archive functionality
+ *
+ * This module defines all TypeScript interfaces and types used for archiving
+ * conversation history, enabling the LLM to access previous sessions and
+ * maintaining a clean session.json while preserving conversation context.
+ */
+import type { Operation } from './session.js';
+/**
+ * Schema version for chat archives.
+ * Increment this when making breaking changes to the archive format.
+ */
+export declare const CHAT_ARCHIVE_VERSION = "1.0";
+/**
+ * Represents a complete archived conversation with all metadata.
+ * Designed to be LLM-friendly with rich contextual information.
+ */
+export interface ChatArchive {
+    /** Schema version for future migration */
+    version: typeof CHAT_ARCHIVE_VERSION;
+    /** Unique archive ID (ULID format) */
+    id: string;
+    /** Original session ID this archive was created from */
+    sessionId: string;
+    /** Absolute path to the project where this conversation happened */
+    projectPath: string;
+    /** ISO-8601 timestamp when conversation started (first message) */
+    startedAt: string;
+    /** ISO-8601 timestamp when conversation ended (last message) */
+    endedAt: string;
+    /** Duration of the conversation in seconds */
+    durationSeconds: number;
+    /** Total number of messages in the conversation */
+    messageCount: number;
+    /** Breakdown of messages by role */
+    messageCounts: MessageCounts;
+    /** Token usage statistics for the conversation */
+    tokenUsage: ArchiveTokenUsage;
+    /** Model(s) used during the conversation */
+    model: string;
+    /**
+     * @deprecated Use `operations` instead. Kept as optional for backward compat with old archives.
+     */
+    toolsUsed?: string[];
+    /**
+     * @deprecated Use `operations` instead. Kept as optional for backward compat with old archives.
+     */
+    filesModified?: string[];
+    /**
+     * @deprecated Use `operations` instead. Kept as optional for backward compat with old archives.
+     */
+    filesRead?: string[];
+    /** Auto-generated summary of the conversation (first user message + key context) */
+    summary: string;
+    /** Key topics/keywords extracted from the conversation */
+    topics: string[];
+    /** Whether the conversation was compacted before archival */
+    wasCompacted: boolean;
+    /** The compacted summary if it existed */
+    compactedSummary?: string;
+    /** The actual conversation messages */
+    messages: ArchivedMessage[];
+    /** Operations performed during the conversation (optional for backward compat) */
+    operations?: Operation[];
+}
+/**
+ * Message count breakdown by role.
+ */
+export interface MessageCounts {
+    user: number;
+    assistant: number;
+    system: number;
+}
+/**
+ * Token usage statistics for an archived conversation.
+ */
+export interface ArchiveTokenUsage {
+    /** Total tokens used in the conversation */
+    total: number;
+    /** Estimated cost in USD */
+    estimatedCost: number;
+}
+/**
+ * Represents a single message in an archived conversation.
+ * Simplified from ConversationMessage for storage efficiency.
+ */
+export interface ArchivedMessage {
+    /** Role of the message sender */
+    role: 'user' | 'assistant' | 'system';
+    /** Content of the message */
+    content: string;
+    /** ISO-8601 timestamp when the message was created */
+    timestamp: string;
+    /** Token count for this message (if available) */
+    tokenCount?: number;
+    /** Model that generated this message (for assistant messages) */
+    model?: string;
+}
+/**
+ * Summary information about an archived chat for listing purposes.
+ * Contains metadata only, no messages - used for efficient browsing.
+ */
+export interface ChatArchiveSummary {
+    /** Archive ID */
+    id: string;
+    /** Filename of the archive (without path) */
+    filename: string;
+    /** ISO-8601 timestamp when conversation started */
+    startedAt: string;
+    /** ISO-8601 timestamp when conversation ended */
+    endedAt: string;
+    /** Duration in seconds */
+    durationSeconds: number;
+    /** Total message count */
+    messageCount: number;
+    /** Auto-generated summary */
+    summary: string;
+    /** Key topics */
+    topics: string[];
+    /** Model used */
+    model: string;
+    /** Token usage */
+    tokenUsage: ArchiveTokenUsage;
+}
+/**
+ * Options for listing archived chats.
+ */
+export interface ChatArchiveListOptions {
+    /** Maximum number of archives to return */
+    limit?: number;
+    /** Search query to filter by summary/topics */
+    search?: string;
+    /** Filter by date range - archives after this date */
+    after?: string;
+    /** Filter by date range - archives before this date */
+    before?: string;
+    /** Sort order */
+    sortBy?: 'date' | 'messageCount' | 'duration';
+    /** Sort direction */
+    sortOrder?: 'asc' | 'desc';
+}
+/**
+ * Result of an archive operation.
+ */
+export interface ArchiveResult {
+    /** Whether the archive was successful */
+    success: boolean;
+    /** Archive ID if successful */
+    archiveId?: string;
+    /** Filename of the created archive */
+    filename?: string;
+    /** Full path to the archive file */
+    path?: string;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Type guard to check if an object is a valid ChatArchive.
+ */
+export declare function isValidChatArchive(obj: unknown): obj is ChatArchive;
+//# sourceMappingURL=chat-archive.d.ts.map

package/dist/types/chat-archive.d.ts.map

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

package/dist/types/chat-archive.js

@@ -0,0 +1,36 @@
+/**
+ * Type definitions for chat archive functionality
+ *
+ * This module defines all TypeScript interfaces and types used for archiving
+ * conversation history, enabling the LLM to access previous sessions and
+ * maintaining a clean session.json while preserving conversation context.
+ */
+/**
+ * Schema version for chat archives.
+ * Increment this when making breaking changes to the archive format.
+ */
+export const CHAT_ARCHIVE_VERSION = '1.0';
+/**
+ * Type guard to check if an object is a valid ChatArchive.
+ */
+export function isValidChatArchive(obj) {
+    if (!obj || typeof obj !== 'object')
+        return false;
+    const archive = obj;
+    return (typeof archive.version === 'string' &&
+        typeof archive.id === 'string' &&
+        typeof archive.sessionId === 'string' &&
+        typeof archive.projectPath === 'string' &&
+        typeof archive.startedAt === 'string' &&
+        typeof archive.endedAt === 'string' &&
+        typeof archive.messageCount === 'number' &&
+        typeof archive.summary === 'string' &&
+        Array.isArray(archive.messages) &&
+        Array.isArray(archive.topics) &&
+        // Accept archives with operations OR legacy top-level fields
+        (Array.isArray(archive.operations) ||
+            (Array.isArray(archive.toolsUsed) &&
+                Array.isArray(archive.filesModified) &&
+                Array.isArray(archive.filesRead))));
+}
+//# sourceMappingURL=chat-archive.js.map

package/dist/types/chat-archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-archive.js","sourceRoot":"","sources":["../../src/types/chat-archive.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAyJ1C;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,OAAO,GAAG,GAAkB,CAAC;IACnC,OAAO,CACL,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;QACnC,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ;QAC9B,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ;QACrC,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ;QACvC,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ;QACrC,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;QACnC,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ;QACxC,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ;QACnC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC/B,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QAC7B,6DAA6D;QAC7D,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;YAChC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;gBAC/B,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;gBACpC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CACvC,CAAC;AACJ,CAAC"}