hammoc 1.0.0

package/packages/shared/dist/types/preferences.d.ts

@@ -0,0 +1,95 @@
+/**
+ * User Preferences Types
+ * Server-side persistent settings (replaces localStorage)
+ */
+import type { PermissionMode } from './sdk.js';
+/** Supported i18n languages (Epic 22) */
+export declare const SUPPORTED_LANGUAGES: readonly ["en", "ko", "zh-CN", "ja", "es", "pt"];
+export type SupportedLanguage = typeof SUPPORTED_LANGUAGES[number];
+/**
+ * Global user preferences stored at ~/.hammoc/preferences.json
+ */
+export interface UserPreferences {
+    theme?: 'light' | 'dark' | 'system';
+    layoutMode?: 'narrow' | 'wide';
+    diffLayout?: 'side-by-side' | 'inline';
+    permissionMode?: PermissionMode | 'latest';
+    /** Stores the actual last-used mode when permissionMode is 'latest' */
+    lastPermissionMode?: PermissionMode;
+    commandFavorites?: string[];
+    starFavorites?: Record<string, string[]>;
+    defaultModel?: string;
+    chatTimeoutMs?: number;
+    markdownDefaultMode?: 'edit' | 'preview';
+    fileExplorerViewMode?: 'list' | 'grid';
+    telegram?: TelegramSettings;
+    customSystemPrompt?: string;
+    maxThinkingTokens?: number;
+    maxTurns?: number;
+    maxBudgetUsd?: number;
+    terminalEnabled?: boolean;
+    language?: SupportedLanguage;
+}
+/** Default values for global settings */
+export declare const DEFAULT_PREFERENCES: Required<Pick<UserPreferences, 'theme' | 'defaultModel' | 'permissionMode' | 'chatTimeoutMs' | 'fileExplorerViewMode'>>;
+/** API response type — includes server-only metadata */
+export interface PreferencesApiResponse extends UserPreferences {
+    _overrides?: string[];
+}
+/** Telegram notification settings stored in preferences */
+export interface TelegramSettings {
+    botToken?: string;
+    chatId?: string;
+    enabled?: boolean;
+    /** Base URL for access links in notifications (e.g. "http://192.168.1.100:3000") */
+    baseUrl?: string;
+    notifyPermission?: boolean;
+    notifyComplete?: boolean;
+    notifyError?: boolean;
+    notifyQueueStart?: boolean;
+    notifyQueueComplete?: boolean;
+    notifyQueueError?: boolean;
+    notifyQueueInputRequired?: boolean;
+    /** Send notifications even when the session is visible (socket connected) */
+    alwaysNotify?: boolean;
+}
+/** GET /api/preferences/telegram response type */
+export interface TelegramSettingsApiResponse {
+    maskedBotToken: string;
+    chatId: string;
+    enabled: boolean;
+    baseUrl: string;
+    notifyPermission: boolean;
+    notifyComplete: boolean;
+    notifyError: boolean;
+    notifyQueueStart: boolean;
+    notifyQueueComplete: boolean;
+    notifyQueueError: boolean;
+    notifyQueueInputRequired: boolean;
+    alwaysNotify: boolean;
+    envOverrides: string[];
+    hasBotToken: boolean;
+    hasChatId: boolean;
+}
+/** PATCH /api/preferences/telegram request body */
+export interface UpdateTelegramSettingsRequest {
+    botToken?: string | null;
+    chatId?: string | null;
+    enabled?: boolean;
+    baseUrl?: string | null;
+    notifyPermission?: boolean;
+    notifyComplete?: boolean;
+    notifyError?: boolean;
+    notifyQueueStart?: boolean;
+    notifyQueueComplete?: boolean;
+    notifyQueueError?: boolean;
+    notifyQueueInputRequired?: boolean;
+    alwaysNotify?: boolean;
+}
+/**
+ * Per-session prompt history stored at {projectPath}/.hammoc/prompt-history/{sessionId}.json
+ */
+export interface PromptHistoryData {
+    history: string[];
+}
+//# sourceMappingURL=preferences.d.ts.map

package/packages/shared/dist/types/preferences.d.ts.map

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

package/packages/shared/dist/types/preferences.js

@@ -0,0 +1,15 @@
+/**
+ * User Preferences Types
+ * Server-side persistent settings (replaces localStorage)
+ */
+/** Supported i18n languages (Epic 22) */
+export const SUPPORTED_LANGUAGES = ['en', 'ko', 'zh-CN', 'ja', 'es', 'pt'];
+/** Default values for global settings */
+export const DEFAULT_PREFERENCES = {
+    theme: 'dark',
+    defaultModel: '',
+    permissionMode: 'default',
+    chatTimeoutMs: 300000,
+    fileExplorerViewMode: 'grid',
+};
+//# sourceMappingURL=preferences.js.map

package/packages/shared/dist/types/preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preferences.js","sourceRoot":"","sources":["../../src/types/preferences.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,yCAAyC;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAU,CAAC;AA+BpF,yCAAyC;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAA4H;IAC1J,KAAK,EAAE,MAAM;IACb,YAAY,EAAE,EAAE;IAChB,cAAc,EAAE,SAAS;IACzB,aAAa,EAAE,MAAM;IACrB,oBAAoB,EAAE,MAAM;CAC7B,CAAC"}

package/packages/shared/dist/types/project.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Project Types
+ * Types for project list API
+ * [Source: Story 3.1 - Task 1]
+ * [Extended: Story 3.6 - Task 1: New Project Creation types]
+ * [Extended: Story 10.3 - Task 1: Project settings overrides]
+ */
+import type { PermissionMode } from './sdk.js';
+import type { BoardConfig } from './board.js';
+/**
+ * Project information returned by the API
+ */
+export interface ProjectInfo {
+    /** Original project path (e.g., /Users/user/my-project) */
+    originalPath: string;
+    /** Project hash/slug (folder name in ~/.claude/projects/) */
+    projectSlug: string;
+    /** Number of sessions in this project */
+    sessionCount: number;
+    /** ISO 8601 formatted last modified date */
+    lastModified: string;
+    /** Whether this project has .bmad-core folder */
+    isBmadProject: boolean;
+    /** Whether this project is hidden (from .hammoc/settings.json) */
+    hidden?: boolean;
+}
+/**
+ * Project-level settings stored in <project>/.hammoc/settings.json
+ */
+export interface ProjectSettings {
+    hidden?: boolean;
+    /** undefined = use global, '' = CLI default, 'model-id' = specific model */
+    modelOverride?: string;
+    /** undefined = use global */
+    permissionModeOverride?: PermissionMode;
+    /** Custom board column configuration */
+    boardConfig?: BoardConfig;
+}
+/**
+ * Request for PATCH /api/projects/:projectSlug/settings
+ * null = clear override (use global), undefined = no change
+ */
+export interface UpdateProjectSettingsRequest {
+    hidden?: boolean;
+    modelOverride?: string | null;
+    permissionModeOverride?: PermissionMode | null;
+    /** null = reset to default board config */
+    boardConfig?: BoardConfig | null;
+}
+/**
+ * Response for GET /api/projects/:projectSlug/settings
+ * Includes effective values after merging with global preferences
+ */
+export interface ProjectSettingsApiResponse extends ProjectSettings {
+    /** Effective model after merging with global preferences */
+    effectiveModel: string;
+    /** Effective permission mode after merging with global preferences */
+    effectivePermissionMode: PermissionMode;
+    /** Which fields have project-level overrides (for UI indicator) */
+    _overrides: string[];
+}
+/**
+ * Response for GET /api/projects
+ */
+export interface ProjectListResponse {
+    projects: ProjectInfo[];
+}
+/**
+ * Project error codes and messages
+ */
+export declare const PROJECT_ERRORS: {
+    readonly SCAN_ERROR: {
+        readonly code: "PROJECT_SCAN_ERROR";
+        readonly message: "프로젝트 목록을 가져오는 중 오류가 발생했습니다.";
+        readonly httpStatus: 500;
+    };
+    readonly DIR_NOT_FOUND: {
+        readonly code: "PROJECTS_DIR_NOT_FOUND";
+        readonly message: "Claude projects 디렉토리가 없습니다.";
+        readonly httpStatus: 200;
+    };
+    readonly PERMISSION_DENIED: {
+        readonly code: "PERMISSION_DENIED";
+        readonly message: "디렉토리 접근 권한이 없습니다.";
+        readonly httpStatus: 500;
+    };
+    readonly INVALID_SESSION_INDEX: {
+        readonly code: "INVALID_SESSION_INDEX";
+        readonly message: "sessions-index.json 파일 형식이 올바르지 않습니다.";
+        readonly httpStatus: 500;
+    };
+    readonly PATH_NOT_FOUND: {
+        readonly code: "PATH_NOT_FOUND";
+        readonly message: "지정한 경로가 존재하지 않습니다.";
+        readonly httpStatus: 400;
+    };
+    readonly PATH_NOT_DIRECTORY: {
+        readonly code: "PATH_NOT_DIRECTORY";
+        readonly message: "지정한 경로가 디렉토리가 아닙니다.";
+        readonly httpStatus: 400;
+    };
+    readonly INVALID_PATH_FORMAT: {
+        readonly code: "INVALID_PATH_FORMAT";
+        readonly message: "경로 형식이 올바르지 않습니다.";
+        readonly httpStatus: 400;
+    };
+    readonly BMAD_SETUP_FAILED: {
+        readonly code: "BMAD_SETUP_FAILED";
+        readonly message: "BMad 설정 중 오류가 발생했습니다.";
+        readonly httpStatus: 500;
+    };
+    readonly ALREADY_BMAD: {
+        readonly code: "ALREADY_BMAD";
+        readonly message: "이미 BMad가 설정된 프로젝트입니다. 재설정하려면 force 옵션을 사용하세요.";
+        readonly httpStatus: 409;
+    };
+    readonly PROJECT_ALREADY_EXISTS: {
+        readonly code: "PROJECT_ALREADY_EXISTS";
+        readonly message: "이미 등록된 프로젝트입니다.";
+        readonly httpStatus: 409;
+    };
+};
+/**
+ * Request for POST /api/projects
+ * [Source: Story 3.6 - Task 1]
+ */
+export interface CreateProjectRequest {
+    /** Absolute path to the project directory */
+    path: string;
+    /** Whether to initialize .bmad-core folder (default: true) */
+    setupBmad?: boolean;
+    /** BMad method version to install (e.g., "4.44.3"). Required when setupBmad is true. */
+    bmadVersion?: string;
+}
+/**
+ * Response for GET /api/projects/bmad-versions
+ */
+export interface BmadVersionsResponse {
+    /** Available BMad method versions, sorted descending (latest first) */
+    versions: string[];
+}
+/**
+ * Request for POST /api/projects/:projectSlug/setup-bmad
+ * [Source: Story 9.1 - Task 1]
+ */
+export interface SetupBmadRequest {
+    /** BMad method version to install (e.g., "4.44.3"). Defaults to latest. */
+    bmadVersion?: string;
+    /** Force setup even if project already has .bmad-core (default: false) */
+    force?: boolean;
+}
+/**
+ * Response for POST /api/projects/:projectSlug/setup-bmad
+ * [Source: Story 9.1 - Task 1]
+ */
+export interface SetupBmadResponse {
+    /** Updated project info with isBmadProject = true */
+    project: ProjectInfo;
+    /** BMad version that was installed */
+    installedVersion: string;
+}
+/**
+ * Response for POST /api/projects
+ * [Source: Story 3.6 - Task 1]
+ */
+export interface CreateProjectResponse {
+    /** Created or existing project info */
+    project: ProjectInfo;
+    /** True if project already existed */
+    isExisting: boolean;
+    /** BMad setup error message if project was created but BMad setup failed */
+    bmadSetupError?: string;
+}
+/**
+ * Request for POST /api/projects/validate-path
+ * [Source: Story 3.6 - Task 1]
+ */
+export interface ValidatePathRequest {
+    /** Path to validate */
+    path: string;
+}
+/**
+ * Response for DELETE /api/projects/:projectSlug
+ */
+export interface DeleteProjectResponse {
+    /** Whether deletion was successful */
+    success: boolean;
+}
+/**
+ * Response for POST /api/projects/validate-path
+ * [Source: Story 3.6 - Task 1]
+ */
+export interface ValidatePathResponse {
+    /** Whether path is valid (exists and is directory) */
+    valid: boolean;
+    /** Whether directory exists */
+    exists: boolean;
+    /** Whether path is already a Claude project */
+    isProject: boolean;
+    /** Project slug if isProject is true */
+    projectSlug?: string;
+    /** Error message if not valid */
+    error?: string;
+}
+//# sourceMappingURL=project.d.ts.map

package/packages/shared/dist/types/project.d.ts.map

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

package/packages/shared/dist/types/project.js

@@ -0,0 +1,64 @@
+/**
+ * Project Types
+ * Types for project list API
+ * [Source: Story 3.1 - Task 1]
+ * [Extended: Story 3.6 - Task 1: New Project Creation types]
+ * [Extended: Story 10.3 - Task 1: Project settings overrides]
+ */
+/**
+ * Project error codes and messages
+ */
+export const PROJECT_ERRORS = {
+    SCAN_ERROR: {
+        code: 'PROJECT_SCAN_ERROR',
+        message: '프로젝트 목록을 가져오는 중 오류가 발생했습니다.',
+        httpStatus: 500,
+    },
+    DIR_NOT_FOUND: {
+        code: 'PROJECTS_DIR_NOT_FOUND',
+        message: 'Claude projects 디렉토리가 없습니다.',
+        httpStatus: 200, // Return empty array (AC 6)
+    },
+    PERMISSION_DENIED: {
+        code: 'PERMISSION_DENIED',
+        message: '디렉토리 접근 권한이 없습니다.',
+        httpStatus: 500,
+    },
+    INVALID_SESSION_INDEX: {
+        code: 'INVALID_SESSION_INDEX',
+        message: 'sessions-index.json 파일 형식이 올바르지 않습니다.',
+        httpStatus: 500,
+    },
+    // Story 3.6 - Project Creation Error Codes
+    PATH_NOT_FOUND: {
+        code: 'PATH_NOT_FOUND',
+        message: '지정한 경로가 존재하지 않습니다.',
+        httpStatus: 400,
+    },
+    PATH_NOT_DIRECTORY: {
+        code: 'PATH_NOT_DIRECTORY',
+        message: '지정한 경로가 디렉토리가 아닙니다.',
+        httpStatus: 400,
+    },
+    INVALID_PATH_FORMAT: {
+        code: 'INVALID_PATH_FORMAT',
+        message: '경로 형식이 올바르지 않습니다.',
+        httpStatus: 400,
+    },
+    BMAD_SETUP_FAILED: {
+        code: 'BMAD_SETUP_FAILED',
+        message: 'BMad 설정 중 오류가 발생했습니다.',
+        httpStatus: 500,
+    },
+    ALREADY_BMAD: {
+        code: 'ALREADY_BMAD',
+        message: '이미 BMad가 설정된 프로젝트입니다. 재설정하려면 force 옵션을 사용하세요.',
+        httpStatus: 409,
+    },
+    PROJECT_ALREADY_EXISTS: {
+        code: 'PROJECT_ALREADY_EXISTS',
+        message: '이미 등록된 프로젝트입니다.',
+        httpStatus: 409,
+    },
+};
+//# sourceMappingURL=project.js.map

package/packages/shared/dist/types/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/types/project.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoEH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,UAAU,EAAE;QACV,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,6BAA6B;QACtC,UAAU,EAAE,GAAG;KAChB;IACD,aAAa,EAAE;QACb,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,6BAA6B;QACtC,UAAU,EAAE,GAAG,EAAE,4BAA4B;KAC9C;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,mBAAmB;QAC5B,UAAU,EAAE,GAAG;KAChB;IACD,qBAAqB,EAAE;QACrB,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,uCAAuC;QAChD,UAAU,EAAE,GAAG;KAChB;IACD,2CAA2C;IAC3C,cAAc,EAAE;QACd,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,oBAAoB;QAC7B,UAAU,EAAE,GAAG;KAChB;IACD,kBAAkB,EAAE;QAClB,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,qBAAqB;QAC9B,UAAU,EAAE,GAAG;KAChB;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,mBAAmB;QAC5B,UAAU,EAAE,GAAG;KAChB;IACD,iBAAiB,EAAE;QACjB,IAAI,EAAE,mBAAmB;QACzB,OAAO,EAAE,uBAAuB;QAChC,UAAU,EAAE,GAAG;KAChB;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,+CAA+C;QACxD,UAAU,EAAE,GAAG;KAChB;IACD,sBAAsB,EAAE;QACtB,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,iBAAiB;QAC1B,UAAU,EAAE,GAAG;KAChB;CACO,CAAC"}

package/packages/shared/dist/types/queue.d.ts

@@ -0,0 +1,94 @@
+export interface QueueItem {
+    /** Prompt text (empty string for non-prompt items) */
+    prompt: string;
+    /** @new: whether to start a new session */
+    isNewSession: boolean;
+    /** @pause: whether this is a breakpoint */
+    isBreakpoint?: boolean;
+    /** @save: session name to save */
+    saveSessionName?: string;
+    /** @load: session name to load */
+    loadSessionName?: string;
+    /** @( ... @): whether this is a multiline block */
+    isMultiline?: boolean;
+    /** @model: model name to use */
+    modelName?: string;
+    /** @delay: delay in milliseconds */
+    delayMs?: number;
+}
+export interface QueueParseWarning {
+    /** Line number (1-based) */
+    line: number;
+    /** Warning message */
+    message: string;
+}
+export interface QueueParseResult {
+    /** Parsed queue items */
+    items: QueueItem[];
+    /** Parse warnings */
+    warnings: QueueParseWarning[];
+}
+export interface QueueExecutionState {
+    isRunning: boolean;
+    isPaused: boolean;
+    /** Queue finished successfully (persists until dismissed) */
+    isCompleted: boolean;
+    /** Queue finished with error (persists until dismissed) */
+    isErrored: boolean;
+    currentIndex: number;
+    totalItems: number;
+    pauseReason?: string;
+    lockedSessionId: string | null;
+    currentModel?: string;
+    /** Last error from the most recent queue run (persists after run ends) */
+    lastError?: {
+        itemIndex: number;
+        error: string;
+    } | null;
+    /** Queue items (included during active execution for page re-entry) */
+    items?: QueueItem[];
+    /** Map of itemIndex -> sessionId for completed items (for session links) */
+    completedSessionIds?: Record<number, string>;
+}
+export interface QueueItemsUpdatedEvent {
+    items: QueueItem[];
+    totalItems: number;
+    currentIndex: number;
+}
+export interface QueueProgressEvent {
+    currentIndex: number;
+    totalItems: number;
+    status: 'running' | 'paused' | 'completed' | 'error' | 'aborted';
+    pauseReason?: string;
+    sessionId: string;
+}
+export interface QueueItemCompleteEvent {
+    itemIndex: number;
+    sessionId: string;
+    markerDetected?: 'QUEUE_STOP' | 'QUEUE_PASS';
+}
+export interface QueueErrorEvent {
+    itemIndex: number;
+    error: string;
+    sessionId: string;
+}
+/** A story number extracted from PRD (e.g. "1.1", "2.3") */
+export interface QueueStoryInfo {
+    /** Full story number string, e.g. "1.1" */
+    storyNum: string;
+    /** Epic number, e.g. 1 */
+    epicNum: number;
+    /** Story number within epic, e.g. 1 */
+    storyIndex: number;
+    /** Optional story title if extracted */
+    title?: string;
+}
+/** Saved queue template */
+export interface QueueTemplate {
+    id: string;
+    name: string;
+    template: string;
+    createdAt: string;
+    updatedAt: string;
+}
+//# sourceMappingURL=queue.d.ts.map

package/packages/shared/dist/types/queue.d.ts.map

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

package/packages/shared/dist/types/queue.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue.js.map

package/packages/shared/dist/types/queue.js.map

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

package/packages/shared/dist/types/sdk.d.ts

@@ -0,0 +1,156 @@
+/**
+ * SDK Types for ChatService
+ * These types wrap the @anthropic-ai/claude-agent-sdk types for use in the application
+ */
+import type { ImageAttachment } from './message.js';
+/**
+ * Configuration for initializing ChatService
+ */
+export interface ChatServiceConfig {
+    /** Working directory for the Claude session */
+    workingDirectory?: string;
+    /** Permission mode for tool usage */
+    permissionMode?: PermissionMode;
+}
+/**
+ * Options for sending a chat message
+ */
+export interface ChatOptions {
+    /** List of tools that are allowed to be used */
+    allowedTools?: string[];
+    /** List of tools that are disallowed */
+    disallowedTools?: string[];
+    /** Maximum number of turns before stopping */
+    maxTurns?: number;
+    /** Abort controller for cancellation */
+    abortController?: AbortController;
+    /** Model to use for the query */
+    model?: string;
+    /** Session ID to resume (pass the session ID string to resume) */
+    resume?: string;
+    /** Pre-allocated session ID for new sessions (must be a valid UUID) */
+    sessionId?: string;
+    /** Image attachments to include in the message (Story 5.5) */
+    images?: ImageAttachment[];
+    /** Custom system prompt (replaces Claude Code default when set) */
+    customSystemPrompt?: string;
+    /** Max thinking tokens for reasoning */
+    maxThinkingTokens?: number;
+    /** Max budget in USD per query */
+    maxBudgetUsd?: number;
+}
+/**
+ * Response from a chat message
+ */
+export interface ChatResponse {
+    /** Unique identifier for the response */
+    id: string;
+    /** Session ID */
+    sessionId: string;
+    /** Response content */
+    content: string;
+    /** Whether the response is complete */
+    done: boolean;
+    /** Whether this is an error response */
+    isError: boolean;
+    /** Usage statistics */
+    usage?: ChatUsage;
+}
+/**
+ * Rate limit window info (for subscription users via OAuth beta header)
+ */
+interface RateLimitWindow {
+    utilization: number;
+    reset: string | null;
+    status: string;
+}
+/**
+ * Subscription rate limit info from anthropic-ratelimit-unified-* headers
+ */
+export interface SubscriptionRateLimit {
+    fiveHour?: RateLimitWindow;
+    sevenDay?: RateLimitWindow;
+    overallStatus?: string;
+}
+/**
+ * API health status from periodic probe
+ */
+export interface ApiHealthStatus {
+    /** Whether the Anthropic API is reachable */
+    healthy: boolean;
+    /** ISO timestamp of last health check */
+    lastCheckedAt: string;
+    /** Human-readable error message if unhealthy */
+    error?: string;
+}
+/**
+ * Usage statistics for a chat response
+ */
+export interface ChatUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadInputTokens: number;
+    cacheCreationInputTokens: number;
+    totalCostUSD: number;
+    contextWindow: number;
+    /** Primary model used (extracted from result modelUsage) */
+    model?: string;
+    /** Subscription rate limit info (optional, only available with OAuth) */
+    rateLimit?: SubscriptionRateLimit;
+}
+/**
+ * Context usage thresholds for visual indicators (percentage)
+ */
+export declare const CONTEXT_USAGE_THRESHOLDS: {
+    readonly WARNING: 50;
+    readonly DANGER: 80;
+    readonly CRITICAL: 90;
+};
+/**
+ * Permission modes for tool usage
+ */
+export type PermissionMode = 'default' | 'acceptEdits' | 'bypassPermissions' | 'plan' | 'dontAsk';
+/**
+ * Stream chunk for real-time message streaming
+ */
+export interface StreamChunk {
+    sessionId: string;
+    messageId: string;
+    content: string;
+    done: boolean;
+}
+/**
+ * Tool call information
+ */
+export interface ToolCall {
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+    /** Server timestamp (ms) for timer preservation on reconnect */
+    startedAt?: number;
+}
+/**
+ * Permission request for tool approval
+ */
+export interface PermissionRequest {
+    id: string;
+    sessionId: string;
+    toolCall: ToolCall;
+    requiresApproval: boolean;
+}
+/**
+ * Message in a chat session
+ */
+export interface Message {
+    id: string;
+    sessionId: string;
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp: Date;
+    toolCalls?: ToolCall[];
+    streaming?: boolean;
+    /** Usage data included in message:complete for reliable delivery */
+    usage?: ChatUsage;
+}
+export {};
+//# sourceMappingURL=sdk.d.ts.map

package/packages/shared/dist/types/sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/types/sdk.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qCAAqC;IACrC,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,mEAAmE;IACnE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wCAAwC;IACxC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,EAAE,OAAO,CAAC;IACd,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,uBAAuB;IACvB,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wBAAwB,EAAE,MAAM,CAAC;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACnC;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;CAI3B,CAAC;AAGX;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,aAAa,GAAG,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAAC;AAElG;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB"}