@percena/weft 0.4.0-next.1 → 0.4.0-next.3

package/dist/automations.d.cts

@@ -1,4774 +0,0 @@
-
-
-// ── inlined from @weft/core ──
-// -- @weft/core/index.d.ts --
-
-/**
- * Mode Types and Constants
- *
- * Pure types and UI configuration for permission modes.
- * Note: This file imports zod for schema definitions.
- * Type-only imports (PermissionMode, PermissionModeCanonical) have no runtime cost.
- */
-
-/**
- * Available permission modes (internal storage keys).
- *
- * UI-facing canonical names are:
- * - explore  -> safe
- * - ask      -> ask
- * - execute  -> allow-all
- */
-type PermissionMode = 'safe' | 'ask' | 'allow-all';
-/**
- * Canonical mode names used in user-facing/session-state surfaces.
- */
-type PermissionModeCanonical = 'explore' | 'ask' | 'execute';
-
-/**
- * Thinking Level Configuration
- *
- * Six-tier thinking system for extended reasoning:
- * - OFF: No extended thinking (disabled)
- * - Low: Light reasoning, faster responses
- * - Medium: Balanced speed and reasoning (default)
- * - High: Deep reasoning for complex tasks
- * - XHigh: Extra-high reasoning — Anthropic's recommended level for Opus 4.7 agentic/coding work
- * - Max: Maximum effort reasoning
- *
- * Session-level setting with workspace defaults.
- *
- * Provider mappings:
- * - Anthropic: adaptive thinking + effort levels (Opus 4.7+). On models that
- *   don't accept `xhigh`, the Anthropic SDK silently falls back to `high`.
- * - Pi/OpenAI: reasoning_effort via Pi SDK levels. Pi's ceiling is `xhigh`,
- *   so Weft's `max` saturates there.
- */
-/**
- * Ordered list of valid thinking level IDs. Single source of truth — the
- * `ThinkingLevel` type, `THINKING_LEVELS` metadata, the Zod schema in
- * `validators.ts`, and runtime validation/error messages all derive from this.
- *
- * Order is significant: it determines UI ordering (low → max).
- */
-declare const THINKING_LEVEL_IDS: readonly ["off", "low", "medium", "high", "xhigh", "max"];
-type ThinkingLevel = (typeof THINKING_LEVEL_IDS)[number];
-interface ThinkingLevelDefinition {
-    id: ThinkingLevel;
-    /** Translation key for the display name (resolve with t() at render site) */
-    nameKey: string;
-    /** Translation key for the description (resolve with t() at render site) */
-    descriptionKey: string;
-}
-/**
- * Available thinking levels with display metadata.
- * Used in UI dropdowns and for validation.
- *
- * Labels use translation keys — resolve with t(level.nameKey) in components.
- */
-declare const THINKING_LEVELS: readonly ThinkingLevelDefinition[];
-/**
- * Map ThinkingLevel to Anthropic SDK effort parameter.
- * Used with adaptive thinking (thinking: { type: 'adaptive' }).
- * Returns null for 'off' (thinking should be disabled entirely).
- */
-declare const THINKING_TO_EFFORT: Record<ThinkingLevel, 'low' | 'medium' | 'high' | 'xhigh' | 'max' | null>;
-/**
- * Get the thinking token budget for a given level and model.
- * Used as fallback for models that don't support adaptive thinking.
- *
- * @param level - The thinking level
- * @param modelId - The model ID (e.g., 'claude-haiku-4-5-20251001')
- * @returns Number of thinking tokens to allocate
- */
-declare function getThinkingTokens(level: ThinkingLevel, modelId: string): number;
-/**
- * Get the translation key for a thinking level's display name.
- * Resolve with t() or i18n.t() at the call site.
- */
-declare function getThinkingLevelNameKey(level: ThinkingLevel): string;
-/**
- * Validate that a value is a valid ThinkingLevel.
- */
-declare function isValidThinkingLevel(value: unknown): value is ThinkingLevel;
-/**
- * Normalize a persisted thinking level value, handling legacy values.
- * Maps the old 'think' value to 'medium' for backward compatibility.
- *
- * TODO: Remove the legacy 'think' compatibility path after old persisted session
- * and workspace data has realistically aged out across upgrades.
- *
- * @returns The normalized ThinkingLevel, or undefined if the value is invalid
- */
-declare function normalizeThinkingLevel(value: unknown): ThinkingLevel | undefined;
-
-/**
- * Server DTO types — data shapes used by RPC handlers and SessionManager.
- *
- * Extracted here so handler code in @weft can import
- * from @weft/protocol without reaching into the app.
- */
-
-/**
- * Dynamic status ID referencing workspace status config.
- * Validated at runtime via validateSessionStatus().
- * Falls back to 'todo' if status doesn't exist.
- */
-type SessionStatus = string;
-type BuiltInStatusId = 'todo' | 'in-progress' | 'needs-review' | 'done' | 'cancelled';
-/**
- * Electron-specific Session type (includes runtime state).
- * Extends core Session with messages array and processing state.
- */
-interface Session {
-    id: string;
-    workspaceId: string;
-    workspaceName: string;
-    name?: string;
-    /** Preview of first user message (from JSONL header, for lazy-loaded sessions) */
-    preview?: string;
-    lastMessageAt: number;
-    messages: Message[];
-    isProcessing: boolean;
-    isFlagged?: boolean;
-    /** Permission mode for this session ('safe', 'ask', 'allow-all') */
-    permissionMode?: PermissionMode;
-    sessionStatus?: SessionStatus;
-    /** Labels (additive tags, many-per-session — bare IDs or "id::value" entries) */
-    labels?: string[];
-    lastReadMessageId?: string;
-    /**
-     * Explicit unread flag - single source of truth for NEW badge.
-     * Set to true when assistant message completes while user is NOT viewing.
-     * Set to false when user views the session (and not processing).
-     */
-    hasUnread?: boolean;
-    enabledSourceSlugs?: string[];
-    workingDirectory?: string;
-    sessionFolderPath?: string;
-    sharedUrl?: string;
-    sharedId?: string;
-    model?: string;
-    llmConnection?: string;
-    thinkingLevel?: ThinkingLevel;
-    lastMessageRole?: 'user' | 'assistant' | 'plan' | 'tool' | 'error';
-    lastFinalMessageId?: string;
-    isAsyncOperationOngoing?: boolean;
-    /** @deprecated Use isAsyncOperationOngoing instead */
-    isRegeneratingTitle?: boolean;
-    currentStatus?: {
-        message: string;
-        statusType?: string;
-    };
-    createdAt?: number;
-    messageCount?: number;
-    tokenUsage?: {
-        inputTokens: number;
-        outputTokens: number;
-        totalTokens: number;
-        contextTokens: number;
-        costUsd: number;
-        cacheReadTokens?: number;
-        cacheCreationTokens?: number;
-        /** Model's context window size in tokens (from SDK modelUsage) */
-        contextWindow?: number;
-    };
-    /** When true, session is hidden from session list (e.g., mini edit sessions) */
-    hidden?: boolean;
-    isArchived?: boolean;
-    archivedAt?: number;
-    supportsBranching?: boolean;
-}
-interface CreateSessionOptions {
-    name?: string;
-    permissionMode?: PermissionMode;
-    /**
-     * Reasoning/thinking level override. When set, takes precedence over workspace
-     * and global defaults. Silently ignored by the underlying SDK on non-reasoning
-     * models (e.g. gpt-4o) — provider drivers don't attach the reasoning param to
-     * the API request for models with `reasoning: false` in the Pi SDK catalog.
-     */
-    thinkingLevel?: ThinkingLevel;
-    /**
-     * Working directory for the session:
-     * - 'user_default' or undefined: Use workspace's configured default working directory
-     * - 'none': No working directory (session folder only)
-     * - Absolute path string: Use this specific path
-     */
-    workingDirectory?: string | 'user_default' | 'none';
-    model?: string;
-    llmConnection?: string;
-    systemPromptPreset?: 'default' | 'mini' | string;
-    hidden?: boolean;
-    sessionStatus?: SessionStatus;
-    labels?: string[];
-    isFlagged?: boolean;
-    enabledSourceSlugs?: string[];
-    /**
-     * Message ID to branch from. This is a hard context cutoff:
-     * the new session must not include model context from later parent messages.
-     */
-    branchFromMessageId?: string;
-    /** Parent session ID used together with branchFromMessageId. */
-    branchFromSessionId?: string;
-}
-interface RemoteSessionTransferPayload {
-    sourceSessionId: string;
-    name?: string;
-    sessionStatus?: SessionStatus;
-    labels?: string[];
-    permissionMode?: PermissionMode;
-    summary: string;
-}
-interface ImportRemoteSessionTransferResult {
-    sessionId: string;
-}
-interface PermissionModeState {
-    permissionMode: PermissionMode;
-    previousPermissionMode?: PermissionMode;
-    transitionDisplay?: string;
-    modeVersion: number;
-    changedAt: string;
-    changedBy: 'user' | 'system' | 'restore' | 'automation' | 'unknown';
-}
-type SessionEvent = {
-    type: 'text_delta';
-    sessionId: string;
-    delta: string;
-    turnId?: string;
-} | {
-    type: 'text_complete';
-    sessionId: string;
-    text: string;
-    isIntermediate?: boolean;
-    turnId?: string;
-    parentToolUseId?: string;
-    timestamp?: number;
-    messageId?: string;
-} | {
-    type: 'tool_start';
-    sessionId: string;
-    toolName: string;
-    toolUseId: string;
-    toolInput: Record<string, unknown>;
-    toolIntent?: string;
-    toolDisplayName?: string;
-    toolDisplayMeta?: ToolDisplayMeta;
-    turnId?: string;
-    parentToolUseId?: string;
-    timestamp?: number;
-} | {
-    type: 'tool_result';
-    sessionId: string;
-    toolUseId: string;
-    toolName: string;
-    result: string;
-    turnId?: string;
-    parentToolUseId?: string;
-    isError?: boolean;
-    timestamp?: number;
-} | {
-    type: 'error';
-    sessionId: string;
-    error: string;
-    timestamp?: number;
-} | {
-    type: 'typed_error';
-    sessionId: string;
-    error: TypedError;
-    timestamp?: number;
-} | {
-    type: 'complete';
-    sessionId: string;
-    tokenUsage?: Session['tokenUsage'];
-    hasUnread?: boolean;
-} | {
-    type: 'interrupted';
-    sessionId: string;
-    message?: Message;
-    queuedMessages?: string[];
-} | {
-    type: 'status';
-    sessionId: string;
-    message: string;
-    statusType?: 'compacting';
-} | {
-    type: 'info';
-    sessionId: string;
-    message: string;
-    statusType?: 'compaction_complete';
-    level?: 'info' | 'warning' | 'error' | 'success';
-    timestamp?: number;
-} | {
-    type: 'title_generated';
-    sessionId: string;
-    title: string;
-} | {
-    type: 'title_regenerating';
-    sessionId: string;
-    isRegenerating: boolean;
-} | {
-    type: 'async_operation';
-    sessionId: string;
-    isOngoing: boolean;
-} | {
-    type: 'working_directory_changed';
-    sessionId: string;
-    workingDirectory: string;
-} | {
-    type: 'permission_request';
-    sessionId: string;
-    request: PermissionRequest;
-} | {
-    type: 'credential_request';
-    sessionId: string;
-    request: CredentialRequest;
-} | {
-    type: 'permission_mode_changed';
-    sessionId: string;
-    permissionMode: PermissionMode;
-    previousPermissionMode?: PermissionMode;
-    transitionDisplay?: string;
-    modeVersion?: number;
-    changedAt?: string;
-    changedBy?: PermissionModeState['changedBy'];
-} | {
-    type: 'plan_submitted';
-    sessionId: string;
-    message: Message;
-} | {
-    type: 'sources_changed';
-    sessionId: string;
-    enabledSourceSlugs: string[];
-} | {
-    type: 'labels_changed';
-    sessionId: string;
-    labels: string[];
-} | {
-    type: 'connection_changed';
-    sessionId: string;
-    connectionSlug: string;
-    supportsBranching?: boolean;
-} | {
-    type: 'task_backgrounded';
-    sessionId: string;
-    toolUseId: string;
-    taskId: string;
-    intent?: string;
-    turnId?: string;
-} | {
-    type: 'shell_backgrounded';
-    sessionId: string;
-    toolUseId: string;
-    shellId: string;
-    intent?: string;
-    command?: string;
-    turnId?: string;
-} | {
-    type: 'task_progress';
-    sessionId: string;
-    toolUseId: string;
-    elapsedSeconds: number;
-    turnId?: string;
-} | {
-    type: 'task_completed';
-    sessionId: string;
-    taskId: string;
-    status: 'completed' | 'failed' | 'stopped';
-    outputFile?: string;
-    summary?: string;
-    turnId?: string;
-} | {
-    type: 'shell_killed';
-    sessionId: string;
-    shellId: string;
-} | {
-    type: 'user_message';
-    sessionId: string;
-    message: Message;
-    status: 'accepted' | 'queued' | 'processing';
-    optimisticMessageId?: string;
-} | {
-    type: 'session_flagged';
-    sessionId: string;
-} | {
-    type: 'session_unflagged';
-    sessionId: string;
-} | {
-    type: 'session_archived';
-    sessionId: string;
-} | {
-    type: 'session_unarchived';
-    sessionId: string;
-} | {
-    type: 'name_changed';
-    sessionId: string;
-    name?: string;
-} | {
-    type: 'session_model_changed';
-    sessionId: string;
-    model: string | null;
-} | {
-    type: 'session_status_changed';
-    sessionId: string;
-    sessionStatus: SessionStatus;
-} | {
-    type: 'session_deleted';
-    sessionId: string;
-} | {
-    type: 'session_created';
-    sessionId: string;
-} | {
-    type: 'session_shared';
-    sessionId: string;
-    sharedUrl: string;
-} | {
-    type: 'session_unshared';
-    sessionId: string;
-} | {
-    type: 'auth_request';
-    sessionId: string;
-    message: Message;
-    request: AuthRequest;
-} | {
-    type: 'auth_completed';
-    sessionId: string;
-    requestId: string;
-    success: boolean;
-    cancelled?: boolean;
-    error?: string;
-} | {
-    type: 'source_activated';
-    sessionId: string;
-    sourceSlug: string;
-    originalMessage: string;
-} | {
-    type: 'usage_update';
-    sessionId: string;
-    tokenUsage: {
-        inputTokens: number;
-        contextWindow?: number;
-    };
-} | {
-    type: 'message_annotations_updated';
-    sessionId: string;
-    messageId: string;
-    annotations: AnnotationV1[];
-} | {
-    type: 'working_directory_error';
-    sessionId: string;
-    error: string;
-};
-interface SendMessageOptions {
-    skillSlugs?: string[];
-    badges?: ContentBadge[];
-    optimisticMessageId?: string;
-}
-type SessionCommand = {
-    type: 'flag';
-} | {
-    type: 'unflag';
-} | {
-    type: 'archive';
-} | {
-    type: 'unarchive';
-} | {
-    type: 'rename';
-    name: string;
-} | {
-    type: 'setSessionStatus';
-    state: SessionStatus;
-} | {
-    type: 'markRead';
-} | {
-    type: 'markUnread';
-} | {
-    type: 'setActiveViewing';
-    workspaceId: string;
-} | {
-    type: 'setPermissionMode';
-    mode: PermissionMode;
-} | {
-    type: 'setThinkingLevel';
-    level: ThinkingLevel;
-} | {
-    type: 'updateWorkingDirectory';
-    dir: string;
-} | {
-    type: 'setSources';
-    sourceSlugs: string[];
-} | {
-    type: 'setLabels';
-    labels: string[];
-} | {
-    type: 'showInFinder';
-} | {
-    type: 'copyPath';
-} | {
-    type: 'shareToViewer';
-} | {
-    type: 'updateShare';
-} | {
-    type: 'revokeShare';
-} | {
-    type: 'refreshTitle';
-} | {
-    type: 'setConnection';
-    connectionSlug: string;
-} | {
-    type: 'setPendingPlanExecution';
-    planPath: string;
-    draftInputSnapshot?: string;
-} | {
-    type: 'markCompactionComplete';
-} | {
-    type: 'markPendingPlanExecutionDispatched';
-} | {
-    type: 'clearPendingPlanExecution';
-} | {
-    type: 'addAnnotation';
-    messageId: string;
-    annotation: AnnotationV1;
-} | {
-    type: 'removeAnnotation';
-    messageId: string;
-    annotationId: string;
-} | {
-    type: 'updateAnnotation';
-    messageId: string;
-    annotationId: string;
-    patch: Partial<AnnotationV1>;
-};
-interface NewChatActionParams {
-    input?: string;
-    name?: string;
-}
-
-/**
- * Permission request with session context (for multi-session Electron app)
- */
-interface PermissionRequest extends PermissionRequest$1 {
-    sessionId: string;
-}
-interface PermissionResponseOptions {
-    rememberForMinutes?: number;
-}
-
-/**
- * Credential request from agent — prompts user for credentials
- * (e.g., API key, username/password, OAuth token)
- */
-interface CredentialRequest {
-    requestId: string;
-    toolName: string;
-    description: string;
-    credentialMode?: CredentialInputMode;
-    headerName?: string;
-    headerNames?: string[];
-    labels?: {
-        credential?: string;
-        username?: string;
-        password?: string;
-    };
-    hint?: string;
-    sourceUrl?: string;
-    passwordRequired?: boolean;
-}
-/**
- * Auth request — unified auth flow (credential or OAuth)
- */
-interface AuthRequest {
-    requestId: string;
-    type: AuthRequestType;
-    sourceSlug?: string;
-    sourceName?: string;
-    description?: string;
-    credentialMode?: CredentialInputMode;
-    headerName?: string;
-    headerNames?: string[];
-    labels?: {
-        credential?: string;
-        username?: string;
-        password?: string;
-    };
-    hint?: string;
-    sourceUrl?: string;
-    passwordRequired?: boolean;
-}
-interface CredentialResponse {
-    type: 'credential';
-    value?: string;
-    username?: string;
-    password?: string;
-    headers?: Record<string, string>;
-    cancelled: boolean;
-}
-/** Server-side directory listing result (for remote directory browsing). */
-interface DirectoryListingResult {
-    /** Normalized absolute path of the listed directory (after resolve(), not symlink-resolved). */
-    currentPath: string;
-    /** Parent directory path, or null if at root. */
-    parentPath: string | null;
-    /** Pre-split breadcrumb segments for display (computed server-side). */
-    breadcrumbs: Array<{
-        name: string;
-        path: string;
-    }>;
-    /** Server platform info. */
-    platform: 'win32' | 'darwin' | 'linux';
-    /** Whether the server truncated the directory list for safety/performance. */
-    truncated: boolean;
-    /** Total number of matching child directories before truncation. */
-    totalEntries: number;
-    /** Child directory entries. */
-    entries: Array<{
-        name: string;
-        path: string;
-        isSymlink: boolean;
-    }>;
-}
-interface FileAttachment {
-    type: 'image' | 'text' | 'pdf' | 'office' | 'audio' | 'unknown';
-    path: string;
-    name: string;
-    mimeType: string;
-    base64?: string;
-    text?: string;
-    size: number;
-    thumbnailBase64?: string;
-}
-interface SessionFile {
-    name: string;
-    path: string;
-    type: 'file' | 'directory';
-    size?: number;
-    children?: SessionFile[];
-}
-interface FileSearchResult {
-    name: string;
-    path: string;
-    type: 'file' | 'directory';
-    relativePath: string;
-}
-interface LlmConnectionSetup {
-    slug: string;
-    credential?: string;
-    baseUrl?: string | null;
-    defaultModel?: string | null;
-    models?: string[] | null;
-    piAuthProvider?: string;
-    modelSelectionMode?: 'automaticallySyncedFromProvider' | 'userDefined3Tier';
-    /** When true, reject setup if the connection doesn't already exist (reauth guard). */
-    updateOnly?: boolean;
-    /** Custom endpoint protocol for arbitrary OpenAI/Anthropic-compatible APIs */
-    customEndpoint?: Record<string, unknown>;
-    /** IAM credentials for Pi+Bedrock (piAuthProvider='amazon-bedrock') connections */
-    iamCredentials?: {
-        accessKeyId: string;
-        secretAccessKey: string;
-        sessionToken?: string;
-    };
-    /** AWS region for Pi+Bedrock connections */
-    awsRegion?: string;
-    /** Bedrock authentication method — determines auth type for Pi+Bedrock connections */
-    bedrockAuthMethod?: 'iam_credentials' | 'environment';
-}
-interface TestLlmConnectionParams {
-    provider: 'anthropic' | 'pi';
-    apiKey: string;
-    baseUrl?: string;
-    model?: string;
-    piAuthProvider?: string;
-    /** Optional custom endpoint protocol hint so setup tests mirror runtime routing */
-    customEndpoint?: Record<string, unknown>;
-}
-interface TestLlmConnectionResult {
-    success: boolean;
-    error?: string;
-}
-interface SkillFile {
-    name: string;
-    type: 'file' | 'directory';
-    size?: number;
-    children?: SkillFile[];
-}
-interface OAuthResult {
-    success: boolean;
-    error?: string;
-}
-interface McpValidationResult {
-    success: boolean;
-    error?: string;
-    tools?: string[];
-}
-interface McpToolWithPermission {
-    name: string;
-    description?: string;
-    allowed: boolean;
-}
-interface McpToolsResult {
-    success: boolean;
-    error?: string;
-    tools?: McpToolWithPermission[];
-}
-interface SessionSearchMatch {
-    sessionId: string;
-    lineNumber: number;
-    snippet: string;
-}
-interface SessionSearchResult {
-    sessionId: string;
-    matchCount: number;
-    matches: SessionSearchMatch[];
-}
-interface UnreadSummary {
-    totalUnreadSessions: number;
-    byWorkspace: Record<string, number>;
-    hasUnreadByWorkspace: Record<string, boolean>;
-}
-interface ShareResult {
-    success: boolean;
-    url?: string;
-    error?: string;
-}
-interface RefreshTitleResult {
-    success: boolean;
-    title?: string;
-    error?: string;
-}
-interface PlanStep {
-    id: string;
-    description: string;
-    tools?: string[];
-    status?: 'pending' | 'in_progress' | 'completed' | 'failed' | 'skipped';
-}
-interface Plan {
-    id: string;
-    title: string;
-    summary?: string;
-    steps: PlanStep[];
-    questions?: string[];
-    state?: 'creating' | 'refining' | 'ready' | 'executing' | 'completed' | 'cancelled';
-    createdAt?: number;
-    updatedAt?: number;
-}
-interface GitBashStatus {
-    found: boolean;
-    path: string | null;
-    platform: 'win32' | 'darwin' | 'linux';
-}
-interface UpdateInfo {
-    available: boolean;
-    currentVersion: string;
-    latestVersion: string | null;
-    downloadState: 'idle' | 'downloading' | 'ready' | 'installing' | 'error';
-    downloadProgress: number;
-    error?: string;
-}
-interface WorkspaceSettings {
-    name?: string;
-    model?: string;
-    permissionMode?: PermissionMode;
-    cyclablePermissionModes?: PermissionMode[];
-    thinkingLevel?: ThinkingLevel;
-    workingDirectory?: string;
-    localMcpEnabled?: boolean;
-    defaultLlmConnection?: string;
-    enabledSourceSlugs?: string[];
-}
-interface ClaudeOAuthResult {
-    success: boolean;
-    token?: string;
-    error?: string;
-}
-type TestAutomationAction = {
-    type: 'prompt';
-    prompt: string;
-    llmConnection?: string;
-    model?: string;
-    thinkingLevel?: ThinkingLevel;
-} | {
-    type: 'webhook';
-    url: string;
-    method?: string;
-    headers?: Record<string, string>;
-    bodyFormat?: 'json' | 'form' | 'raw';
-    body?: unknown;
-    captureResponse?: boolean;
-    auth?: {
-        type: 'basic';
-        username: string;
-        password: string;
-    } | {
-        type: 'bearer';
-        token: string;
-    };
-};
-interface TestAutomationPayload {
-    workspaceId: string;
-    automationId?: string;
-    automationName?: string;
-    actions: TestAutomationAction[];
-    permissionMode?: PermissionMode;
-    labels?: string[];
-    /** Forwarded from the matcher; routes test-run sessions into a Telegram topic when paired. */
-    telegramTopic?: string;
-}
-type TestAutomationActionResult = {
-    type: 'prompt';
-    success: boolean;
-    stderr?: string;
-    sessionId?: string;
-    duration: number;
-} | {
-    type: 'webhook';
-    success: boolean;
-    url: string;
-    statusCode: number;
-    error?: string;
-    duration: number;
-};
-interface TestAutomationResult {
-    actions: TestAutomationActionResult[];
-}
-type WindowCloseRequestSource = 'keyboard-shortcut' | 'window-button' | 'unknown';
-interface WindowCloseRequest {
-    source: WindowCloseRequestSource;
-}
-interface BrowserInstanceInfo {
-    id: string;
-    url: string;
-    title: string;
-    favicon: string | null;
-    isLoading: boolean;
-    canGoBack: boolean;
-    canGoForward: boolean;
-    boundSessionId: string | null;
-    ownerType: 'session' | 'manual';
-    ownerSessionId: string | null;
-    isVisible: boolean;
-    agentControlActive: boolean;
-    themeColor: string | null;
-}
-interface DeepLinkNavigation {
-    view?: string;
-    tabType?: string;
-    tabParams?: Record<string, string>;
-    action?: string;
-    actionParams?: Record<string, string>;
-}
-
-/**
- * RPC channel names — organized by domain namespace.
- * Wire-format strings (values) are the stable API contract.
- * Key paths are internal and may be reorganized freely.
- */
-declare const RPC_CHANNELS: {
-    readonly remote: {
-        readonly TEST_CONNECTION: "remote:testConnection";
-    };
-    readonly server: {
-        readonly GET_WORKSPACES: "server:getWorkspaces";
-        readonly CREATE_WORKSPACE: "server:createWorkspace";
-        readonly GET_STATUS: "server:getStatus";
-        readonly GET_HEALTH: "server:getHealth";
-        readonly GET_ACTIVE_SESSIONS: "server:getActiveSessions";
-        readonly SHUTTING_DOWN: "server:shuttingDown";
-        readonly STATUS_CHANGED: "server:statusChanged";
-        readonly HOME_DIR: "server:homeDir";
-    };
-    readonly sessions: {
-        readonly GET: "sessions:get";
-        readonly GET_UNREAD_SUMMARY: "sessions:getUnreadSummary";
-        readonly MARK_ALL_READ: "sessions:markAllRead";
-        readonly UNREAD_SUMMARY_CHANGED: "sessions:unreadSummaryChanged";
-        readonly CREATE: "sessions:create";
-        readonly DELETE: "sessions:delete";
-        readonly GET_MESSAGES: "sessions:getMessages";
-        readonly SEND_MESSAGE: "sessions:sendMessage";
-        readonly CANCEL: "sessions:cancel";
-        readonly KILL_SHELL: "sessions:killShell";
-        readonly RESPOND_TO_PERMISSION: "sessions:respondToPermission";
-        readonly RESPOND_TO_CREDENTIAL: "sessions:respondToCredential";
-        readonly COMMAND: "sessions:command";
-        readonly GET_PENDING_PLAN_EXECUTION: "sessions:getPendingPlanExecution";
-        readonly GET_PERMISSION_MODE_STATE: "sessions:getPermissionModeState";
-        readonly EVENT: "session:event";
-        readonly GET_MODEL: "session:getModel";
-        readonly SET_MODEL: "session:setModel";
-        readonly GET_FILES: "sessions:getFiles";
-        readonly GET_NOTES: "sessions:getNotes";
-        readonly SET_NOTES: "sessions:setNotes";
-        readonly WATCH_FILES: "sessions:watchFiles";
-        readonly UNWATCH_FILES: "sessions:unwatchFiles";
-        readonly FILES_CHANGED: "sessions:filesChanged";
-        readonly SEARCH_CONTENT: "sessions:searchContent";
-        readonly EXPORT: "sessions:export";
-        readonly IMPORT: "sessions:import";
-        readonly EXPORT_REMOTE_TRANSFER: "sessions:exportRemoteTransfer";
-        readonly IMPORT_REMOTE_TRANSFER: "sessions:importRemoteTransfer";
-    };
-    readonly transfer: {
-        readonly START: "transfer:start";
-        readonly CHUNK: "transfer:chunk";
-        readonly COMMIT: "transfer:commit";
-        readonly ABORT: "transfer:abort";
-    };
-    readonly tasks: {
-        readonly GET_OUTPUT: "tasks:getOutput";
-    };
-    readonly workspaces: {
-        readonly GET: "workspaces:get";
-        readonly CREATE: "workspaces:create";
-        readonly CHECK_SLUG: "workspaces:checkSlug";
-        readonly UPDATE_REMOTE: "workspaces:updateRemote";
-    };
-    readonly window: {
-        readonly GET_WORKSPACE: "window:getWorkspace";
-        readonly GET_MODE: "window:getMode";
-        readonly OPEN_WORKSPACE: "window:openWorkspace";
-        readonly OPEN_SESSION_IN_NEW_WINDOW: "window:openSessionInNewWindow";
-        readonly SWITCH_WORKSPACE: "window:switchWorkspace";
-        readonly CLOSE: "window:close";
-        readonly CLOSE_REQUESTED: "window:closeRequested";
-        readonly CONFIRM_CLOSE: "window:confirmClose";
-        readonly CANCEL_CLOSE: "window:cancelClose";
-        readonly SET_TRAFFIC_LIGHTS: "window:setTrafficLights";
-        readonly FOCUS_STATE: "window:focusState";
-        readonly GET_FOCUS_STATE: "window:getFocusState";
-    };
-    readonly file: {
-        readonly READ: "file:read";
-        readonly READ_DATA_URL: "file:readDataUrl";
-        readonly READ_PREVIEW_DATA_URL: "file:readPreviewDataUrl";
-        readonly READ_BINARY: "file:readBinary";
-        readonly OPEN_DIALOG: "file:openDialog";
-        readonly READ_ATTACHMENT: "file:readAttachment";
-        readonly READ_USER_ATTACHMENT: "file:readUserAttachment";
-        readonly STORE_ATTACHMENT: "file:storeAttachment";
-        readonly GENERATE_THUMBNAIL: "file:generateThumbnail";
-    };
-    readonly fs: {
-        readonly SEARCH: "fs:search";
-        readonly LIST_DIRECTORY: "fs:listDirectory";
-    };
-    readonly debug: {
-        readonly LOG: "debug:log";
-    };
-    readonly theme: {
-        readonly GET_SYSTEM_PREFERENCE: "theme:getSystemPreference";
-        readonly SYSTEM_CHANGED: "theme:systemChanged";
-        readonly APP_CHANGED: "theme:appChanged";
-        readonly GET_APP: "theme:getApp";
-        readonly GET_PRESETS: "theme:getPresets";
-        readonly LOAD_PRESET: "theme:loadPreset";
-        readonly GET_COLOR_THEME: "theme:getColorTheme";
-        readonly SET_COLOR_THEME: "theme:setColorTheme";
-        readonly BROADCAST_PREFERENCES: "theme:broadcastPreferences";
-        readonly PREFERENCES_CHANGED: "theme:preferencesChanged";
-        readonly GET_WORKSPACE_COLOR_THEME: "theme:getWorkspaceColorTheme";
-        readonly SET_WORKSPACE_COLOR_THEME: "theme:setWorkspaceColorTheme";
-        readonly GET_ALL_WORKSPACE_THEMES: "theme:getAllWorkspaceThemes";
-        readonly BROADCAST_WORKSPACE_THEME: "theme:broadcastWorkspaceTheme";
-        readonly WORKSPACE_THEME_CHANGED: "theme:workspaceThemeChanged";
-    };
-    readonly system: {
-        readonly VERSIONS: "system:versions";
-        readonly HOME_DIR: "system:homeDir";
-        readonly IS_DEBUG_MODE: "system:isDebugMode";
-    };
-    readonly update: {
-        readonly CHECK: "update:check";
-        readonly GET_INFO: "update:getInfo";
-        readonly INSTALL: "update:install";
-        readonly DISMISS: "update:dismiss";
-        readonly GET_DISMISSED: "update:getDismissed";
-        readonly AVAILABLE: "update:available";
-        readonly DOWNLOAD_PROGRESS: "update:downloadProgress";
-    };
-    readonly shell: {
-        readonly OPEN_URL: "shell:openUrl";
-        readonly OPEN_FILE: "shell:openFile";
-        readonly SHOW_IN_FOLDER: "shell:showInFolder";
-    };
-    readonly menu: {
-        readonly NEW_CHAT: "menu:newChat";
-        readonly NEW_WINDOW: "menu:newWindow";
-        readonly OPEN_SETTINGS: "menu:openSettings";
-        readonly KEYBOARD_SHORTCUTS: "menu:keyboardShortcuts";
-        readonly TOGGLE_FOCUS_MODE: "menu:toggleFocusMode";
-        readonly TOGGLE_SIDEBAR: "menu:toggleSidebar";
-        readonly QUIT: "menu:quit";
-        readonly MINIMIZE: "menu:minimize";
-        readonly MAXIMIZE: "menu:maximize";
-        readonly ZOOM_IN: "menu:zoomIn";
-        readonly ZOOM_OUT: "menu:zoomOut";
-        readonly ZOOM_RESET: "menu:zoomReset";
-        readonly TOGGLE_DEV_TOOLS: "menu:toggleDevTools";
-        readonly UNDO: "menu:undo";
-        readonly REDO: "menu:redo";
-        readonly CUT: "menu:cut";
-        readonly COPY: "menu:copy";
-        readonly PASTE: "menu:paste";
-        readonly SELECT_ALL: "menu:selectAll";
-    };
-    readonly deeplink: {
-        readonly NAVIGATE: "deeplink:navigate";
-    };
-    readonly auth: {
-        readonly LOGOUT: "auth:logout";
-        readonly SHOW_LOGOUT_CONFIRMATION: "auth:showLogoutConfirmation";
-        readonly SHOW_DELETE_SESSION_CONFIRMATION: "auth:showDeleteSessionConfirmation";
-    };
-    readonly credentials: {
-        readonly HEALTH_CHECK: "credentials:healthCheck";
-    };
-    readonly onboarding: {
-        readonly GET_AUTH_STATE: "onboarding:getAuthState";
-        readonly VALIDATE_MCP: "onboarding:validateMcp";
-        readonly START_MCP_OAUTH: "onboarding:startMcpOAuth";
-        readonly START_CLAUDE_OAUTH: "onboarding:startClaudeOAuth";
-        readonly EXCHANGE_CLAUDE_CODE: "onboarding:exchangeClaudeCode";
-        readonly HAS_CLAUDE_OAUTH_STATE: "onboarding:hasClaudeOAuthState";
-        readonly CLEAR_CLAUDE_OAUTH_STATE: "onboarding:clearClaudeOAuthState";
-        readonly DEFER_SETUP: "onboarding:deferSetup";
-    };
-    readonly llmConnections: {
-        readonly LIST: "LLM_Connection:list";
-        readonly LIST_WITH_STATUS: "LLM_Connection:listWithStatus";
-        readonly GET: "LLM_Connection:get";
-        readonly GET_API_KEY: "LLM_Connection:getApiKey";
-        readonly SAVE: "LLM_Connection:save";
-        readonly DELETE: "LLM_Connection:delete";
-        readonly TEST: "LLM_Connection:test";
-        readonly SET_DEFAULT: "LLM_Connection:setDefault";
-        readonly SET_WORKSPACE_DEFAULT: "LLM_Connection:setWorkspaceDefault";
-        readonly REFRESH_MODELS: "LLM_Connection:refreshModels";
-        readonly CHANGED: "LLM_Connection:changed";
-    };
-    readonly chatgpt: {
-        readonly START_OAUTH: "chatgpt:startOAuth";
-        readonly COMPLETE_OAUTH: "chatgpt:completeOAuth";
-        readonly CANCEL_OAUTH: "chatgpt:cancelOAuth";
-        readonly GET_AUTH_STATUS: "chatgpt:getAuthStatus";
-        readonly LOGOUT: "chatgpt:logout";
-    };
-    readonly copilot: {
-        readonly START_OAUTH: "copilot:startOAuth";
-        readonly CANCEL_OAUTH: "copilot:cancelOAuth";
-        readonly GET_AUTH_STATUS: "copilot:getAuthStatus";
-        readonly LOGOUT: "copilot:logout";
-        readonly DEVICE_CODE: "copilot:deviceCode";
-    };
-    readonly settings: {
-        readonly SETUP_LLM_CONNECTION: "settings:setupLlmConnection";
-        readonly TEST_LLM_CONNECTION_SETUP: "settings:testLlmConnectionSetup";
-        readonly GET_DEFAULT_THINKING_LEVEL: "settings:getDefaultThinkingLevel";
-        readonly SET_DEFAULT_THINKING_LEVEL: "settings:setDefaultThinkingLevel";
-        readonly GET_NETWORK_PROXY: "settings:getNetworkProxy";
-        readonly SET_NETWORK_PROXY: "settings:setNetworkProxy";
-        readonly GET_SERVER_CONFIG: "settings:getServerConfig";
-        readonly SET_SERVER_CONFIG: "settings:setServerConfig";
-        readonly GET_SERVER_STATUS: "settings:getServerStatus";
-    };
-    readonly pi: {
-        readonly GET_API_KEY_PROVIDERS: "pi:getApiKeyProviders";
-        readonly GET_PROVIDER_BASE_URL: "pi:getProviderBaseUrl";
-        readonly GET_PROVIDER_MODELS: "pi:getProviderModels";
-    };
-    readonly dialog: {
-        readonly OPEN_FOLDER: "dialog:openFolder";
-    };
-    readonly preferences: {
-        readonly READ: "preferences:read";
-        readonly WRITE: "preferences:write";
-    };
-    readonly drafts: {
-        readonly GET: "drafts:get";
-        readonly SET: "drafts:set";
-        readonly DELETE: "drafts:delete";
-        readonly GET_ALL: "drafts:getAll";
-    };
-    readonly sources: {
-        readonly GET: "sources:get";
-        readonly CREATE: "sources:create";
-        readonly DELETE: "sources:delete";
-        readonly START_OAUTH: "sources:startOAuth";
-        readonly SAVE_CREDENTIALS: "sources:saveCredentials";
-        readonly CHANGED: "sources:changed";
-        readonly GET_PERMISSIONS: "sources:getPermissions";
-        readonly GET_MCP_TOOLS: "sources:getMcpTools";
-    };
-    readonly oauth: {
-        readonly START: "oauth:start";
-        readonly COMPLETE: "oauth:complete";
-        readonly CANCEL: "oauth:cancel";
-        readonly REVOKE: "oauth:revoke";
-    };
-    readonly workspace: {
-        readonly GET_PERMISSIONS: "workspace:getPermissions";
-        readonly READ_IMAGE: "workspace:readImage";
-        readonly WRITE_IMAGE: "workspace:writeImage";
-        readonly SETTINGS_GET: "workspaceSettings:get";
-        readonly SETTINGS_UPDATE: "workspaceSettings:update";
-    };
-    readonly permissions: {
-        readonly GET_DEFAULTS: "permissions:getDefaults";
-        readonly DEFAULTS_CHANGED: "permissions:defaultsChanged";
-    };
-    readonly skills: {
-        readonly GET: "skills:get";
-        readonly GET_FILES: "skills:getFiles";
-        readonly DELETE: "skills:delete";
-        readonly OPEN_EDITOR: "skills:openEditor";
-        readonly OPEN_FINDER: "skills:openFinder";
-        readonly CHANGED: "skills:changed";
-    };
-    readonly statuses: {
-        readonly LIST: "statuses:list";
-        readonly REORDER: "statuses:reorder";
-        readonly CHANGED: "statuses:changed";
-    };
-    readonly labels: {
-        readonly LIST: "labels:list";
-        readonly CREATE: "labels:create";
-        readonly DELETE: "labels:delete";
-        readonly CHANGED: "labels:changed";
-    };
-    readonly views: {
-        readonly LIST: "views:list";
-        readonly SAVE: "views:save";
-    };
-    readonly toolIcons: {
-        readonly GET_MAPPINGS: "toolIcons:getMappings";
-    };
-    readonly logo: {
-        readonly GET_URL: "logo:getUrl";
-    };
-    readonly notification: {
-        readonly SHOW: "notification:show";
-        readonly NAVIGATE: "notification:navigate";
-        readonly GET_ENABLED: "notification:getEnabled";
-        readonly SET_ENABLED: "notification:setEnabled";
-    };
-    readonly input: {
-        readonly GET_AUTO_CAPITALISATION: "input:getAutoCapitalisation";
-        readonly SET_AUTO_CAPITALISATION: "input:setAutoCapitalisation";
-        readonly GET_SEND_MESSAGE_KEY: "input:getSendMessageKey";
-        readonly SET_SEND_MESSAGE_KEY: "input:setSendMessageKey";
-        readonly GET_SPELL_CHECK: "input:getSpellCheck";
-        readonly SET_SPELL_CHECK: "input:setSpellCheck";
-    };
-    readonly power: {
-        readonly GET_KEEP_AWAKE: "power:getKeepAwake";
-        readonly SET_KEEP_AWAKE: "power:setKeepAwake";
-    };
-    readonly appearance: {
-        readonly GET_RICH_TOOL_DESCRIPTIONS: "appearance:getRichToolDescriptions";
-        readonly SET_RICH_TOOL_DESCRIPTIONS: "appearance:setRichToolDescriptions";
-    };
-    readonly tools: {
-        readonly GET_BROWSER_TOOL_ENABLED: "tools:getBrowserToolEnabled";
-        readonly SET_BROWSER_TOOL_ENABLED: "tools:setBrowserToolEnabled";
-    };
-    readonly caching: {
-        readonly GET_EXTENDED_PROMPT_CACHE: "caching:getExtendedPromptCache";
-        readonly SET_EXTENDED_PROMPT_CACHE: "caching:setExtendedPromptCache";
-        readonly GET_ENABLE_1M_CONTEXT: "caching:getEnable1MContext";
-        readonly SET_ENABLE_1M_CONTEXT: "caching:setEnable1MContext";
-    };
-    readonly badge: {
-        readonly REFRESH: "badge:refresh";
-        readonly SET_ICON: "badge:setIcon";
-        readonly DRAW: "badge:draw";
-        readonly DRAW_WINDOWS: "badge:draw-windows";
-    };
-    readonly releaseNotes: {
-        readonly GET: "releaseNotes:get";
-        readonly GET_LATEST_VERSION: "releaseNotes:getLatestVersion";
-    };
-    readonly git: {
-        readonly GET_BRANCH: "git:getBranch";
-    };
-    readonly gitbash: {
-        readonly CHECK: "gitbash:check";
-        readonly BROWSE: "gitbash:browse";
-        readonly SET_PATH: "gitbash:setPath";
-    };
-    readonly browserPane: {
-        readonly CREATE: "browser-pane:create";
-        readonly DESTROY: "browser-pane:destroy";
-        readonly LIST: "browser-pane:list";
-        readonly NAVIGATE: "browser-pane:navigate";
-        readonly GO_BACK: "browser-pane:go-back";
-        readonly GO_FORWARD: "browser-pane:go-forward";
-        readonly RELOAD: "browser-pane:reload";
-        readonly STOP: "browser-pane:stop";
-        readonly FOCUS: "browser-pane:focus";
-        readonly SNAPSHOT: "browser-pane:snapshot";
-        readonly CLICK: "browser-pane:click";
-        readonly FILL: "browser-pane:fill";
-        readonly SELECT: "browser-pane:select";
-        readonly SCREENSHOT: "browser-pane:screenshot";
-        readonly EVALUATE: "browser-pane:evaluate";
-        readonly SCROLL: "browser-pane:scroll";
-        readonly LAUNCH: "browser-empty-state:launch";
-        readonly STATE_CHANGED: "browser-pane:state-changed";
-        readonly REMOVED: "browser-pane:removed";
-        readonly INTERACTED: "browser-pane:interacted";
-    };
-    readonly automations: {
-        readonly GET: "automations:get";
-        readonly TEST: "automations:test";
-        readonly SET_ENABLED: "automations:setEnabled";
-        readonly DUPLICATE: "automations:duplicate";
-        readonly DELETE: "automations:delete";
-        readonly GET_HISTORY: "automations:getHistory";
-        readonly GET_LAST_EXECUTED: "automations:getLastExecuted";
-        readonly REPLAY: "automations:replay";
-        readonly CHANGED: "automations:changed";
-    };
-    readonly resources: {
-        readonly EXPORT: "resources:export";
-        readonly IMPORT: "resources:import";
-    };
-    readonly messaging: {
-        readonly WA_REGISTER: "messaging:wa:register";
-        readonly WA_INCOMING: "messaging:wa:incoming";
-        readonly WA_BUTTON_PRESS: "messaging:wa:buttonPress";
-        readonly WA_STATUS: "messaging:wa:status";
-        readonly WA_QR: "messaging:wa:qr";
-        readonly WA_SEND: "messaging:wa:send";
-        readonly WA_SEND_BUTTONS: "messaging:wa:sendButtons";
-        readonly WA_SEND_TYPING: "messaging:wa:sendTyping";
-        readonly WA_SEND_FILE: "messaging:wa:sendFile";
-        readonly WA_CONNECT: "messaging:wa:connect";
-        readonly WA_DISCONNECT: "messaging:wa:disconnect";
-        readonly BINDING_CHANGED: "messaging:bindingChanged";
-        readonly PLATFORM_STATUS: "messaging:platformStatus";
-        /** Broadcast when the workspace's pending-senders list mutates. */
-        readonly PENDING_CHANGED: "messaging:pendingChanged";
-        readonly GET_CONFIG: "messaging:getConfig";
-        readonly UPDATE_CONFIG: "messaging:updateConfig";
-        readonly TEST_TELEGRAM: "messaging:testTelegram";
-        readonly SAVE_TELEGRAM: "messaging:saveTelegram";
-        readonly TEST_LARK: "messaging:testLark";
-        readonly SAVE_LARK: "messaging:saveLark";
-        readonly DISCONNECT: "messaging:disconnect";
-        readonly FORGET: "messaging:forget";
-        readonly GET_BINDINGS: "messaging:getBindings";
-        readonly GENERATE_CODE: "messaging:generateCode";
-        readonly UNBIND: "messaging:unbind";
-        readonly UNBIND_BINDING: "messaging:unbindBinding";
-        /** Workspace-supergroup pairing (Telegram forum support). UI ↔ Server. */
-        readonly GENERATE_SUPERGROUP_CODE: "messaging:generateSupergroupCode";
-        readonly GET_SUPERGROUP: "messaging:getSupergroup";
-        readonly UNBIND_SUPERGROUP: "messaging:unbindSupergroup";
-        readonly WA_START_CONNECT: "messaging:wa:startConnect";
-        readonly WA_SUBMIT_PHONE: "messaging:wa:submitPhone";
-        /** Broadcast to UI clients: QR string, pairing code, status, unavailable, error. */
-        readonly WA_UI_EVENT: "messaging:wa:uiEvent";
-        readonly GET_PLATFORM_OWNERS: "messaging:access:getOwners";
-        readonly SET_PLATFORM_OWNERS: "messaging:access:setOwners";
-        readonly GET_PLATFORM_ACCESS_MODE: "messaging:access:getMode";
-        readonly SET_PLATFORM_ACCESS_MODE: "messaging:access:setMode";
-        readonly GET_PENDING_SENDERS: "messaging:access:getPending";
-        readonly DISMISS_PENDING_SENDER: "messaging:access:dismissPending";
-        readonly ALLOW_PENDING_SENDER: "messaging:access:allowPending";
-        readonly SET_BINDING_ACCESS: "messaging:access:setBindingAccess";
-    };
-};
-
-/**
- * Typed event map for server → client push channels.
- * Keys are channel string literals, values are argument tuples.
- */
-
-interface BroadcastEventMap {
-    [RPC_CHANNELS.sessions.EVENT]: [event: SessionEvent];
-    [RPC_CHANNELS.sessions.UNREAD_SUMMARY_CHANGED]: [summary: UnreadSummary];
-    [RPC_CHANNELS.sessions.FILES_CHANGED]: [sessionId: string];
-    [RPC_CHANNELS.sources.CHANGED]: [workspaceId: string, sources: unknown[]];
-    [RPC_CHANNELS.labels.CHANGED]: [workspaceId: string];
-    [RPC_CHANNELS.statuses.CHANGED]: [workspaceId: string];
-    [RPC_CHANNELS.automations.CHANGED]: [workspaceId: string];
-    [RPC_CHANNELS.skills.CHANGED]: [workspaceId: string, skills: unknown[]];
-    [RPC_CHANNELS.llmConnections.CHANGED]: [];
-    [RPC_CHANNELS.permissions.DEFAULTS_CHANGED]: [value: null];
-    [RPC_CHANNELS.theme.APP_CHANGED]: [theme: Record<string, unknown> | null];
-    [RPC_CHANNELS.theme.SYSTEM_CHANGED]: [isDark: boolean];
-    [RPC_CHANNELS.theme.PREFERENCES_CHANGED]: [preferences: {
-        mode: string;
-        colorTheme: string;
-        font: string;
-    }];
-    [RPC_CHANNELS.theme.WORKSPACE_THEME_CHANGED]: [data: {
-        workspaceId: string;
-        themeId: string | null;
-    }];
-    [RPC_CHANNELS.update.AVAILABLE]: [info: UpdateInfo];
-    [RPC_CHANNELS.update.DOWNLOAD_PROGRESS]: [progress: number];
-    [RPC_CHANNELS.badge.DRAW]: [data: {
-        count: number;
-        iconDataUrl: string;
-    }];
-    [RPC_CHANNELS.badge.DRAW_WINDOWS]: [data: {
-        count: number;
-    }];
-    [RPC_CHANNELS.window.FOCUS_STATE]: [isFocused: boolean];
-    [RPC_CHANNELS.window.CLOSE_REQUESTED]: [];
-    [RPC_CHANNELS.browserPane.STATE_CHANGED]: [info: BrowserInstanceInfo];
-    [RPC_CHANNELS.browserPane.REMOVED]: [id: string];
-    [RPC_CHANNELS.browserPane.INTERACTED]: [id: string];
-    [RPC_CHANNELS.notification.NAVIGATE]: [data: {
-        workspaceId: string;
-        sessionId: string;
-    }];
-    [RPC_CHANNELS.deeplink.NAVIGATE]: [navigation: DeepLinkNavigation];
-    [RPC_CHANNELS.copilot.DEVICE_CODE]: [data: {
-        userCode: string;
-        verificationUri: string;
-    }];
-    [RPC_CHANNELS.menu.NEW_CHAT]: [];
-    [RPC_CHANNELS.menu.OPEN_SETTINGS]: [];
-    [RPC_CHANNELS.menu.KEYBOARD_SHORTCUTS]: [];
-    [RPC_CHANNELS.menu.TOGGLE_FOCUS_MODE]: [];
-    [RPC_CHANNELS.menu.TOGGLE_SIDEBAR]: [];
-    [RPC_CHANNELS.messaging.BINDING_CHANGED]: [workspaceId: string];
-    [RPC_CHANNELS.messaging.PLATFORM_STATUS]: [workspaceId: string, platform: string, connected: boolean];
-}
-
-interface ParsedMentions {
-    skills: string[];
-    invalidSkills: string[];
-    sources: string[];
-    files: string[];
-    folders: string[];
-}
-interface MentionMatch {
-    type: 'skill' | 'source' | 'file' | 'folder';
-    id: string;
-    fullMatch: string;
-    startIndex: number;
-}
-
-declare function parseMentions(text: string, availableSkillSlugs: string[], availableSourceSlugs: string[]): ParsedMentions;
-declare function resolveSkillMentions(text: string, skillNames: Map<string, string>): string;
-declare function resolveSourceMentions(text: string): string;
-declare function resolvePathMentions(text: string, workingDirectory?: string): Promise<string>;
-declare function resolveFileMentions(text: string, workingDirectory?: string): Promise<string>;
-declare function stripAllMentions(text: string): string;
-declare function findMentionMatches(text: string, availableSkillSlugs: string[], availableSourceSlugs: string[]): MentionMatch[];
-
-export { AnnotationV1, type AuthRequest, AuthRequestType, type BroadcastEventMap, type BrowserInstanceInfo, type BuiltInStatusId, type ClaudeOAuthResult, ContentBadge, type CreateSessionOptions, CredentialInputMode, type CredentialRequest, type CredentialResponse, type DeepLinkNavigation, type DirectoryListingResult, type FileAttachment, type FileSearchResult, type GitBashStatus, type ImportRemoteSessionTransferResult, type LlmConnectionSetup, type McpToolWithPermission, type McpToolsResult, type McpValidationResult, type MentionMatch, Message, type NewChatActionParams, type OAuthResult, type ParsedMentions, type PermissionMode, type PermissionModeCanonical, type PermissionModeState, PermissionRequest$1 as PermissionRequest, type PermissionResponseOptions, type Plan, type PlanStep, type Session as ProtocolSession, RPC_CHANNELS, type RefreshTitleResult, type RemoteSessionTransferPayload, type SendMessageOptions, type SessionCommand, type SessionEvent, type SessionFile, type PermissionRequest as SessionPermissionRequest, type SessionSearchMatch, type SessionSearchResult, type ShareResult, type SkillFile, THINKING_LEVELS, THINKING_LEVEL_IDS, THINKING_TO_EFFORT, type TestAutomationAction, type TestAutomationActionResult, type TestAutomationPayload, type TestAutomationResult, type TestLlmConnectionParams, type TestLlmConnectionResult, type ThinkingLevel, ToolDisplayMeta, TypedError, type UnreadSummary, type UpdateInfo, type WindowCloseRequest, type WindowCloseRequestSource, type WorkspaceSettings, findMentionMatches, getThinkingLevelNameKey, getThinkingTokens, isValidThinkingLevel, normalizeThinkingLevel, parseMentions, resolveFileMentions, resolvePathMentions, resolveSkillMentions, resolveSourceMentions, stripAllMentions };
-
-// -- @weft/core/types/index.d.ts --
-/**
- * Workspace and authentication types
- */
-/**
- * How MCP server should be authenticated (workspace-level)
- * Note: Different from SourceMcpAuthType which uses 'oauth' | 'bearer' | 'none' for individual sources
- */
-type McpAuthType = 'workspace_oauth' | 'workspace_bearer' | 'public';
-/**
- * Configuration for a remote Agent Server.
- * When set on a workspace, handler calls are proxied over WebSocket.
- */
-interface RemoteServerConfig {
-    url: string;
-    token: string;
-    remoteWorkspaceId: string;
-}
-/**
- * Client-facing workspace DTO — safe to send over RPC to remote clients.
- * Does not expose server-internal filesystem paths.
- */
-interface WorkspaceInfo {
-    id: string;
-    name: string;
-    slug: string;
-    lastAccessedAt?: number;
-    iconUrl?: string;
-    mcpUrl?: string;
-    mcpAuthType?: McpAuthType;
-    remoteServer?: RemoteServerConfig;
-}
-/**
- * Full workspace with server-internal details.
- * Used by server code and local Electron renderer (LOCAL_ONLY channels).
- */
-interface Workspace extends WorkspaceInfo {
-    rootPath: string;
-    createdAt: number;
-}
-/**
- * Authentication type for AI provider
- * - api_key: Anthropic API key
- * - oauth_token: Claude Max OAuth (Anthropic)
- * - codex_oauth: ChatGPT Plus OAuth via Codex app-server
- * - codex_api_key: OpenAI API key via Codex (OpenRouter, Vercel AI Gateway compatible)
- * - provider_owned: Auth is owned by the provider tool itself
- *   (Claude Code uses `~/.claude`, Codex uses `~/.codex`).
- *   Weft never injects credentials — it detects and delegates.
- */
-type AuthType = 'api_key' | 'oauth_token' | 'codex_oauth' | 'codex_api_key' | 'provider_owned';
-/**
- * OAuth credentials from a fresh authentication flow.
- * Used for temporary state in UI components before saving to credential store.
- */
-interface OAuthCredentials {
-    accessToken: string;
-    refreshToken?: string;
-    expiresAt?: number;
-    clientId: string;
-    tokenType: string;
-}
-interface StoredConfig {
-    authType?: AuthType;
-    workspaces: Workspace[];
-    activeWorkspaceId: string | null;
-    activeSessionId: string | null;
-    model?: string;
-}
-
-/**
- * Message types for conversations
- */
-/**
- * Message roles for display (runtime)
- */
-type MessageRole = 'user' | 'assistant' | 'tool' | 'error' | 'status' | 'info' | 'warning' | 'plan' | 'auth-request';
-/**
- * Credential input modes for different auth types
- */
-type CredentialInputMode = 'bearer' | 'basic' | 'header' | 'query' | 'multi-header';
-/**
- * Auth request types
- */
-type AuthRequestType = 'credential' | 'oauth' | 'oauth-google' | 'oauth-slack' | 'oauth-microsoft';
-/**
- * Auth request status
- */
-type AuthStatus = 'pending' | 'completed' | 'cancelled' | 'failed';
-/**
- * Tool execution status
- */
-type ToolStatus = 'pending' | 'executing' | 'completed' | 'error' | 'backgrounded';
-/**
- * Tool display metadata - embedded at storage time for viewer compatibility
- * Icons are base64-encoded to work in both Electron and web viewer
- */
-interface ToolDisplayMeta {
-    /** Display name for the tool (e.g., "Commit", "Linear") */
-    displayName: string;
-    /** Base64-encoded icon as data URL (e.g., "data:image/png;base64,...") - 32x32px */
-    iconDataUrl?: string;
-    /** Description of what this tool does */
-    description?: string;
-    /** Category for grouping/styling */
-    category?: 'skill' | 'source' | 'native' | 'mcp';
-}
-/**
- * Attachment type categories
- */
-type AttachmentType = 'image' | 'text' | 'pdf' | 'office' | 'audio' | 'unknown';
-/**
- * Attachment preview for display in user messages (runtime, before storage)
- */
-interface MessageAttachment {
-    type: AttachmentType;
-    name: string;
-    mimeType: string;
-    size: number;
-    base64?: string;
-}
-/**
- * Content badge for inline display in user messages
- * Badges are self-contained with all display data (label, icon)
- */
-interface ContentBadge {
-    /** Badge type - used for fallback icon if iconBase64 not available */
-    type: 'source' | 'skill' | 'context' | 'command' | 'file' | 'folder';
-    /** Display label (e.g., "Linear", "Commit") */
-    label: string;
-    /** Original text pattern (e.g., "@linear", "@commit") */
-    rawText: string;
-    /** Icon as data URL (e.g., "data:image/png;base64,...") - preserves mime type */
-    iconDataUrl?: string;
-    /** Start position in content string */
-    start: number;
-    /** End position in content string */
-    end: number;
-    /**
-     * Collapsed label for context badges (e.g., "Edit: Permissions")
-     * When set, the badge replaces the entire marked range with this label
-     * and hides the original content
-     */
-    collapsedLabel?: string;
-    /**
-     * File path for file badges - stores the full path for click handler
-     * Used when the badge represents a clickable file reference
-     */
-    filePath?: string;
-}
-/**
- * Author metadata for annotations
- */
-interface AnnotationAuthor {
-    id: string;
-    name?: string;
-    type?: 'user' | 'agent' | 'system';
-}
-/**
- * Annotation body payloads (extensible)
- */
-type AnnotationBody = {
-    type: 'highlight';
-} | {
-    type: 'note';
-    text: string;
-    format?: 'plain' | 'markdown';
-} | {
-    type: 'tag';
-    value: string;
-};
-/**
- * Annotation intent (tight v1 semantics).
- */
-type AnnotationIntent = 'highlight' | 'comment' | 'question';
-/**
- * Optional lifecycle status for annotation workflows.
- */
-type AnnotationStatus = 'pending' | 'acknowledged' | 'resolved' | 'dismissed';
-/**
- * Block types for block selectors.
- */
-type AnnotationBlockType = 'paragraph' | 'code' | 'latex' | 'mermaid' | 'datatable' | 'spreadsheet' | 'image-preview' | 'pdf-preview' | 'html-preview';
-/**
- * Selector union used to anchor an annotation target.
- * Multiple selectors can be stored for robust fallback resolution.
- */
-type AnnotationSelector = {
-    type: 'text-quote';
-    exact: string;
-    prefix?: string;
-    suffix?: string;
-} | {
-    type: 'text-position';
-    start: number;
-    end: number;
-    textVersion?: string;
-} | {
-    type: 'block';
-    blockType: AnnotationBlockType;
-    path: string;
-    blockId?: string;
-} | {
-    type: 'xywh';
-    unit: 'pixel' | 'percent';
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-    page?: number;
-    rotation?: number;
-} | {
-    type: 'table-cell';
-    rowKey: string | number;
-    columnKey: string;
-};
-/**
- * Annotation target definition.
- */
-interface AnnotationTarget {
-    source: {
-        sessionId: string;
-        messageId: string;
-    };
-    selectors: AnnotationSelector[];
-}
-/**
- * Persisted annotation payload (schema-versioned for migration safety).
- */
-interface AnnotationV1 {
-    id: string;
-    schemaVersion: 1;
-    createdAt: number;
-    updatedAt?: number;
-    createdBy?: AnnotationAuthor;
-    deletedAt?: number;
-    body: AnnotationBody[];
-    target: AnnotationTarget;
-    /** Optional workflow intent (tight v1 semantics). */
-    intent?: AnnotationIntent;
-    /** Optional lifecycle status. */
-    status?: AnnotationStatus;
-    /** Optional reference to the conversation/thread around this annotation. */
-    threadRef?: {
-        threadId?: string;
-        sessionId?: string;
-    };
-    style?: {
-        color?: 'yellow' | 'green' | 'blue' | 'pink' | string;
-        opacity?: number;
-    };
-    meta?: Record<string, unknown>;
-}
-/**
- * Stored attachment metadata (persisted to disk, no base64)
- * Created when user sends a message with attachments
- */
-interface StoredAttachment {
-    id: string;
-    type: AttachmentType;
-    name: string;
-    mimeType: string;
-    size: number;
-    originalSize?: number;
-    storedPath: string;
-    thumbnailPath?: string;
-    thumbnailBase64?: string;
-    markdownPath?: string;
-    wasResized?: boolean;
-    resizedBase64?: string;
-}
-/**
- * Runtime message type (includes transient fields like isStreaming)
- */
-interface Message {
-    id: string;
-    role: MessageRole;
-    content: string;
-    timestamp: number;
-    toolName?: string;
-    toolUseId?: string;
-    toolInput?: Record<string, unknown>;
-    toolResult?: string;
-    toolStatus?: ToolStatus;
-    toolDuration?: number;
-    toolIntent?: string;
-    toolDisplayName?: string;
-    /** Tool display metadata with base64 icon - embedded at storage time for viewer */
-    toolDisplayMeta?: ToolDisplayMeta;
-    parentToolUseId?: string;
-    taskId?: string;
-    shellId?: string;
-    elapsedSeconds?: number;
-    isBackground?: boolean;
-    attachments?: StoredAttachment[];
-    badges?: ContentBadge[];
-    /** Annotation payloads for this message */
-    annotations?: AnnotationV1[];
-    isError?: boolean;
-    isStreaming?: boolean;
-    isPending?: boolean;
-    isQueued?: boolean;
-    isIntermediate?: boolean;
-    turnId?: string;
-    statusType?: 'compacting' | 'compaction_complete';
-    infoLevel?: 'info' | 'warning' | 'error' | 'success';
-    errorCode?: string;
-    errorTitle?: string;
-    errorDetails?: string[];
-    errorOriginal?: string;
-    errorCanRetry?: boolean;
-    errorActions?: Array<{
-        key: string;
-        label: string;
-        action?: 'retry' | 'settings' | 'reauth' | 'open_url' | 'reconnect_source';
-        url?: string;
-        sourceSlug?: string;
-    }>;
-    planPath?: string;
-    authRequestId?: string;
-    authRequestType?: AuthRequestType;
-    authSourceSlug?: string;
-    authSourceName?: string;
-    authStatus?: AuthStatus;
-    authCredentialMode?: CredentialInputMode;
-    authHeaderName?: string;
-    authHeaderNames?: string[];
-    authLabels?: {
-        credential?: string;
-        username?: string;
-        password?: string;
-    };
-    authDescription?: string;
-    authHint?: string;
-    authSourceUrl?: string;
-    authPasswordRequired?: boolean;
-    authError?: string;
-    authEmail?: string;
-    authWorkspace?: string;
-}
-/**
- * Stored message format (persistence)
- * Excludes transient runtime-only fields (isStreaming, isPending)
- */
-interface StoredMessage {
-    id: string;
-    type: MessageRole;
-    content: string;
-    timestamp?: number;
-    toolName?: string;
-    toolUseId?: string;
-    toolInput?: Record<string, unknown>;
-    toolResult?: string;
-    toolStatus?: ToolStatus;
-    toolDuration?: number;
-    toolIntent?: string;
-    toolDisplayName?: string;
-    /** Tool display metadata with base64 icon - embedded at storage time for viewer */
-    toolDisplayMeta?: ToolDisplayMeta;
-    parentToolUseId?: string;
-    taskId?: string;
-    shellId?: string;
-    elapsedSeconds?: number;
-    isBackground?: boolean;
-    isError?: boolean;
-    /** Stored attachments for user messages (persisted to disk) */
-    attachments?: StoredAttachment[];
-    /** Content badges for inline display (sources, skills) */
-    badges?: ContentBadge[];
-    /** Annotations persisted at message level */
-    annotations?: AnnotationV1[];
-    isIntermediate?: boolean;
-    turnId?: string;
-    statusType?: 'compacting' | 'compaction_complete';
-    infoLevel?: 'info' | 'warning' | 'error' | 'success';
-    errorCode?: string;
-    errorTitle?: string;
-    errorDetails?: string[];
-    errorOriginal?: string;
-    errorCanRetry?: boolean;
-    errorActions?: Array<{
-        key: string;
-        label: string;
-        action?: 'retry' | 'settings' | 'reauth' | 'open_url' | 'reconnect_source';
-        url?: string;
-        sourceSlug?: string;
-    }>;
-    planPath?: string;
-    authRequestId?: string;
-    authRequestType?: AuthRequestType;
-    authSourceSlug?: string;
-    authSourceName?: string;
-    authStatus?: AuthStatus;
-    authCredentialMode?: CredentialInputMode;
-    authHeaderName?: string;
-    authHeaderNames?: string[];
-    authLabels?: {
-        credential?: string;
-        username?: string;
-        password?: string;
-    };
-    authDescription?: string;
-    authHint?: string;
-    authSourceUrl?: string;
-    authPasswordRequired?: boolean;
-    authError?: string;
-    authEmail?: string;
-    authWorkspace?: string;
-    isQueued?: boolean;
-}
-/**
- * Token usage tracking
- */
-interface TokenUsage {
-    inputTokens: number;
-    outputTokens: number;
-    totalTokens: number;
-    contextTokens: number;
-    costUsd: number;
-    cacheReadTokens?: number;
-    cacheCreationTokens?: number;
-}
-/**
- * Recovery action for typed errors
- */
-interface RecoveryAction {
-    /** Keyboard shortcut (single letter) */
-    key: string;
-    /** Description of the action */
-    label: string;
-    /** Slash command to execute (e.g., '/settings') */
-    command?: string;
-    /** Custom action type for special handling */
-    action?: 'retry' | 'settings' | 'reauth' | 'open_url' | 'reconnect_source';
-    /** URL to open (for open_url action) */
-    url?: string;
-    /** Source slug (for reconnect_source action) */
-    sourceSlug?: string;
-}
-/**
- * Error codes for typed errors - must match AgentError.code in shared/agent/errors.ts
- */
-type ErrorCode = 'invalid_api_key' | 'invalid_credentials' | 'response_too_large' | 'expired_oauth_token' | 'token_expired' | 'rate_limited' | 'service_error' | 'service_unavailable' | 'network_error' | 'proxy_error' | 'mcp_auth_required' | 'mcp_unreachable' | 'billing_error' | 'model_no_tool_support' | 'invalid_model' | 'data_policy_error' | 'invalid_request' | 'image_too_large' | 'provider_error' | 'queued_message_replay_failed' | 'sdk_binary_missing' | 'sdk_cwd_missing' | 'unknown_error';
-/**
- * Typed error from agent
- */
-interface TypedError {
-    /** Error code for programmatic handling */
-    code: ErrorCode;
-    /** User-friendly title */
-    title: string;
-    /** Detailed message explaining what went wrong */
-    message: string;
-    /** Suggested recovery actions */
-    actions: RecoveryAction[];
-    /** Whether auto-retry is possible */
-    canRetry: boolean;
-    /** Retry delay in ms (if canRetry is true) */
-    retryDelayMs?: number;
-    /** Diagnostic check results for debugging */
-    details?: string[];
-    /** Original error message for debugging */
-    originalError?: string;
-}
-/**
- * Permission request type categories
- */
-type PermissionRequestType = 'bash' | 'file_write' | 'mcp_mutation' | 'api_mutation' | 'admin_approval';
-/**
- * Permission request from agent (e.g., bash command approval)
- */
-interface PermissionRequest {
-    requestId: string;
-    toolName: string;
-    command?: string;
-    description: string;
-    type?: PermissionRequestType;
-    /** Friendly app/package label for admin approval prompts */
-    appName?: string;
-    /** Plain-language reason shown in admin approval prompt */
-    reason?: string;
-    /** Plain-language impact shown in admin approval prompt */
-    impact?: string;
-    /** Whether native OS auth prompt is expected */
-    requiresSystemPrompt?: boolean;
-    /** Optional remember window for this exact command */
-    rememberForMinutes?: number;
-    /** Hash binding for approval integrity checks */
-    commandHash?: string;
-    /** Approval validity window */
-    approvalTtlSeconds?: number;
-}
-/**
- * Usage data emitted by the agent runtime in 'complete' events
- * Note: This is a subset of TokenUsage - totalTokens/contextTokens are computed by consumers
- */
-interface AgentEventUsage {
-    inputTokens: number;
-    outputTokens: number;
-    cacheReadTokens?: number;
-    cacheCreationTokens?: number;
-    costUsd?: number;
-    /** Model's context window size in tokens (from SDK modelUsage) */
-    contextWindow?: number;
-}
-/**
- * Events emitted by the agent runtime during chat
- * turnId: Correlation ID from the API's message.id, groups all events in an assistant turn
- */
-type AgentEvent = {
-    type: 'status';
-    message: string;
-} | {
-    type: 'info';
-    message: string;
-} | {
-    type: 'text_delta';
-    text: string;
-    turnId?: string;
-    parentToolUseId?: string;
-} | {
-    type: 'text_complete';
-    text: string;
-    isIntermediate?: boolean;
-    turnId?: string;
-    parentToolUseId?: string;
-    sdkTurnAnchor?: string;
-} | {
-    type: 'tool_start';
-    toolName: string;
-    toolUseId: string;
-    input: Record<string, unknown>;
-    intent?: string;
-    displayName?: string;
-    turnId?: string;
-    parentToolUseId?: string;
-    toolDisplayMeta?: ToolDisplayMeta;
-} | {
-    type: 'tool_result';
-    toolUseId: string;
-    toolName?: string;
-    result: string;
-    isError: boolean;
-    input?: Record<string, unknown>;
-    turnId?: string;
-    parentToolUseId?: string;
-} | {
-    type: 'permission_request';
-    requestId: string;
-    toolName: string;
-    command?: string;
-    description: string;
-    permissionType?: PermissionRequestType;
-    appName?: string;
-    reason?: string;
-    impact?: string;
-    requiresSystemPrompt?: boolean;
-    rememberForMinutes?: number;
-    commandHash?: string;
-    approvalTtlSeconds?: number;
-} | {
-    type: 'reasoning_delta';
-    text: string;
-    turnId?: string;
-} | {
-    type: 'reasoning';
-    text: string;
-    turnId?: string;
-} | {
-    type: 'permission_response';
-    requestId: string;
-    allowed: boolean;
-    remember?: boolean;
-} | {
-    type: 'error';
-    message: string;
-} | {
-    type: 'typed_error';
-    error: TypedError;
-} | {
-    type: 'complete';
-    usage?: AgentEventUsage;
-} | {
-    type: 'working_directory_changed';
-    workingDirectory: string;
-} | {
-    type: 'task_backgrounded';
-    toolUseId: string;
-    taskId: string;
-    intent?: string;
-    turnId?: string;
-} | {
-    type: 'shell_backgrounded';
-    toolUseId: string;
-    shellId: string;
-    intent?: string;
-    command?: string;
-    turnId?: string;
-} | {
-    type: 'task_progress';
-    toolUseId: string;
-    elapsedSeconds: number;
-    turnId?: string;
-} | {
-    type: 'task_completed';
-    taskId: string;
-    status: 'completed' | 'failed' | 'stopped';
-    outputFile?: string;
-    summary?: string;
-    turnId?: string;
-} | {
-    type: 'shell_killed';
-    shellId: string;
-    turnId?: string;
-} | {
-    type: 'source_activated';
-    sourceSlug: string;
-    originalMessage: string;
-} | {
-    type: 'usage_update';
-    usage: Pick<AgentEventUsage, 'inputTokens' | 'contextWindow'>;
-} | {
-    type: 'steer_undelivered';
-    message: string;
-} | {
-    type: 'compaction_started';
-} | {
-    type: 'compaction_boundary';
-    summary?: string;
-};
-/**
- * Generate a unique message ID
- */
-declare function generateMessageId(): string;
-
-/**
- * Session types for conversation management
- *
- * Sessions are the primary isolation boundary. Each session maps 1:1
- * with an agent runtime instance and SDK conversation.
- */
-
-/**
- * Session status for workflow tracking
- * Agents can update this to reflect the current state of the conversation
- */
-type SessionStatus = 'todo' | 'in_progress' | 'needs_review' | 'done' | 'cancelled';
-/**
- * Session represents a conversation scope (SDK session = our scope boundary)
- */
-interface Session {
-    id: string;
-    sdkSessionId?: string;
-    workspaceId: string;
-    name?: string;
-    createdAt: number;
-    lastUsedAt: number;
-    isArchived?: boolean;
-    isFlagged?: boolean;
-    status?: SessionStatus;
-    lastReadMessageId?: string;
-}
-/**
- * Stored session with conversation data (for persistence)
- */
-interface StoredSession extends Session {
-    messages: StoredMessage[];
-    tokenUsage: TokenUsage;
-}
-/**
- * Session metadata for listing (without loading full messages)
- * Extended with archive status for Inbox/Archive features
- */
-interface SessionMetadata {
-    id: string;
-    workspaceId: string;
-    name?: string;
-    createdAt: number;
-    lastUsedAt: number;
-    messageCount: number;
-    preview?: string;
-    sdkSessionId?: string;
-    isArchived?: boolean;
-    isFlagged?: boolean;
-    status?: SessionStatus;
-    hidden?: boolean;
-}
-
-/**
- * Convert runtime Message to StoredMessage for persistence.
- *
- * Excludes transient runtime-only fields:
- * - isStreaming
- * - isPending
- */
-declare function messageToStored(msg: Message): StoredMessage;
-/**
- * Convert StoredMessage to runtime Message.
- *
- * Adds a timestamp fallback for legacy messages where timestamp was omitted.
- */
-declare function storedToMessage(stored: StoredMessage): Message;
-
-/**
- * Server-level types for headless server operations.
- *
- * These types are used by the `server:` RPC namespace for
- * server status, health checks, active session discovery,
- * and headless configuration bootstrap.
- */
-interface ServerStatus {
-    serverId: string;
-    version: string;
-    uptime: number;
-    connectedClients: number;
-    workspaces: {
-        id: string;
-        name: string;
-        slug: string;
-        activeSessions: number;
-        automationCount: number;
-        schedulerRunning: boolean;
-    }[];
-    memory: {
-        heapUsed: number;
-        heapTotal: number;
-        rss: number;
-    };
-}
-interface ServerHealth {
-    status: 'ok' | 'degraded' | 'unhealthy';
-    checks: {
-        name: string;
-        status: 'pass' | 'fail';
-        message?: string;
-    }[];
-}
-/** Session processing state — typed union, not stringly. */
-type SessionProcessingStatus = 'idle' | 'processing' | 'waiting_input' | 'error' | 'completed';
-/** Server-level active session info (cross-workspace, client-safe). */
-interface ActiveSessionInfo {
-    sessionId: string;
-    workspaceId: string;
-    workspaceName: string;
-    title?: string;
-    status: SessionProcessingStatus;
-    triggeredBy?: {
-        automationName: string;
-        timestamp: number;
-    };
-    createdAt: number;
-}
-
-export { type ActiveSessionInfo, type AgentEvent, type AgentEventUsage, type AnnotationAuthor, type AnnotationBlockType, type AnnotationBody, type AnnotationIntent, type AnnotationSelector, type AnnotationStatus, type AnnotationTarget, type AnnotationV1, type AttachmentType, type AuthRequestType, type AuthStatus, type AuthType, type ContentBadge, type CredentialInputMode, type ErrorCode, type McpAuthType, type Message, type MessageAttachment, type MessageRole, type OAuthCredentials, type PermissionRequest, type PermissionRequestType, type RecoveryAction, type RemoteServerConfig, type ServerHealth, type ServerStatus, type Session, type SessionMetadata, type SessionProcessingStatus, type SessionStatus, type StoredAttachment, type StoredConfig, type StoredMessage, type StoredSession, type TokenUsage, type ToolDisplayMeta, type ToolStatus, type TypedError, type Workspace, type WorkspaceInfo, generateMessageId, messageToStored, storedToMessage };
-
-// -- @weft/core/utils/index.d.ts --
-/**
- * Debug utility for core package
- *
- * This is a stub that can be enhanced to support debug logging.
- * Currently a no-op - use @weft debug utilities for full logging.
- */
-declare function debug(..._args: any[]): void;
-
-/**
- * Cross-Platform Path Utilities
- *
- * Functions for consistent path handling across Windows, macOS, and Linux.
- * Always normalize paths to forward slashes before comparison operations.
- */
-/**
- * Normalize a path to use forward slashes for consistent cross-platform comparison.
- * Use this before comparing paths or using regex patterns on paths.
- *
- * @example
- * normalizePath('C:\\Users\\foo\\bar') // 'C:/Users/foo/bar'
- * normalizePath('/Users/foo/bar')      // '/Users/foo/bar' (unchanged)
- */
-declare function normalizePath(path: string): string;
-/**
- * Check if a file path starts with a directory path (cross-platform).
- * Handles both Windows backslashes and Unix forward slashes.
- *
- * @example
- * pathStartsWith('C:\\Users\\foo\\file.txt', 'C:\\Users\\foo') // true
- * pathStartsWith('/home/user/file.txt', '/home/user')          // true
- * pathStartsWith('/home/user2/file.txt', '/home/user')         // false
- */
-declare function pathStartsWith(filePath: string, dirPath: string): boolean;
-/**
- * Strip a directory prefix from a path (cross-platform).
- * Returns the relative path portion after the prefix.
- *
- * @example
- * stripPathPrefix('/home/user/docs/file.txt', '/home/user') // 'docs/file.txt'
- * stripPathPrefix('C:\\foo\\bar\\baz.txt', 'C:\\foo')       // 'bar/baz.txt'
- */
-declare function stripPathPrefix(filePath: string, prefix: string): string;
-
-export { debug, normalizePath, pathStartsWith, stripPathPrefix };
-
-// ── inlined from @weft/timeline ──
-// -- @weft/timeline/index.d.ts --
-type TimelineProvider = string;
-type TimelinePermissionScope = {
-    type: 'session';
-    sessionId: string;
-} | {
-    type: 'workspace';
-    workspaceId: string;
-} | {
-    type: 'source';
-    sourceSlug: string;
-} | {
-    type: 'skill';
-    skillSlug: string;
-} | {
-    type: 'automation';
-    automationId: string;
-} | {
-    type: 'tool-call';
-    callId: string;
-};
-type TimelineCommandOrigin = {
-    type: 'user';
-    id?: string;
-} | {
-    type: 'automation';
-    id: string;
-} | {
-    type: 'scheduler';
-    id?: string;
-} | {
-    type: 'host';
-    id?: string;
-} | {
-    type: 'replay';
-    id?: string;
-} | {
-    type: 'system';
-    id?: string;
-};
-interface ToolIntent {
-    kind: string;
-    command?: string;
-    baseCommand?: string;
-    path?: string;
-    toolName?: string;
-    name?: string;
-    method?: string;
-    url?: string;
-}
-interface TimelinePermissionRequest {
-    requestId: string;
-    toolName: string;
-    scope?: TimelinePermissionScope;
-    input?: Record<string, unknown>;
-    reason?: string;
-    intent?: ToolIntent;
-}
-interface TimelinePermissionResolution {
-    allowed: boolean;
-    remember?: boolean;
-    reason?: string;
-}
-type TimelineToolStatus = 'pending' | 'running' | 'completed' | 'failed';
-type TimelineItem = {
-    type: 'user_message';
-    text: string;
-    messageId: string;
-    turnId?: string;
-} | {
-    type: 'assistant_message_delta';
-    text: string;
-    messageId: string;
-    turnId: string;
-} | {
-    type: 'assistant_message';
-    text: string;
-    messageId: string;
-    turnId: string;
-} | {
-    type: 'reasoning_delta';
-    text: string;
-    messageId: string;
-    turnId: string;
-} | {
-    type: 'reasoning';
-    text: string;
-    messageId: string;
-    turnId: string;
-} | {
-    type: 'tool_call';
-    callId: string;
-    name: string;
-    status: TimelineToolStatus;
-    detail?: unknown;
-    turnId?: string;
-} | {
-    type: 'tool_output_delta';
-    callId: string;
-    text: string;
-    stream?: 'stdout' | 'stderr' | string;
-    turnId?: string;
-} | {
-    type: 'tool_result';
-    callId: string;
-    result: unknown;
-    isError?: boolean;
-    turnId?: string;
-} | {
-    type: 'permission_requested';
-    request: TimelinePermissionRequest;
-} | {
-    type: 'permission_resolved';
-    requestId: string;
-    resolution: TimelinePermissionResolution;
-} | {
-    type: 'permission_policy_changed';
-    policy: unknown;
-} | {
-    type: 'source_state_changed';
-    source: unknown;
-} | {
-    type: 'skill_activated';
-    skill: unknown;
-} | {
-    type: 'host_state_changed';
-    state: unknown;
-} | {
-    type: 'automation_triggered';
-    automation: {
-        automationId: string;
-        origin: TimelineCommandOrigin;
-        detail?: unknown;
-    };
-} | {
-    type: 'automation_action_result';
-    result: unknown;
-} | {
-    type: 'runtime_capability_report';
-    report: unknown;
-} | {
-    type: 'runtime_fallback';
-    reason: string;
-    from?: string;
-    to: string;
-} | {
-    type: 'turn_started';
-    turnId: string;
-} | {
-    type: 'turn_completed';
-    turnId: string;
-    usage?: unknown;
-} | {
-    type: 'turn_failed';
-    turnId: string;
-    error: unknown;
-} | {
-    type: 'session_status';
-    status: string;
-} | {
-    type: 'tool_suspended';
-    callId: string;
-    name: string;
-    stepId?: string;
-} | {
-    type: 'tool_resumed';
-    callId: string;
-    name: string;
-    stepId?: string;
-} | {
-    type: 'compaction_started';
-} | {
-    type: 'compaction_boundary';
-    summary?: string;
-};
-interface TimelineRawRef {
-    providerEventType?: string;
-    logPath?: string;
-    offset?: number;
-}
-interface TimelineEnvelope {
-    sessionId: string;
-    provider: TimelineProvider;
-    seq: number;
-    epoch: string;
-    timestamp: number;
-    item: TimelineItem;
-    rawRef?: TimelineRawRef;
-}
-interface TimelineCursor {
-    epoch: string;
-    afterSeq: number;
-}
-interface TimelineFetchRequest {
-    cursor?: TimelineCursor;
-    limit?: number;
-}
-interface TimelineFetchResult {
-    items: TimelineEnvelope[];
-    nextCursor: TimelineCursor;
-    hasGap: boolean;
-}
-interface CreateTimelineSequencerOptions {
-    sessionId: string;
-    provider: TimelineProvider;
-    epoch: string;
-    startSeq?: number;
-    now?: () => number;
-}
-interface TimelineSequencer {
-    append(item: TimelineItem, rawRef?: TimelineRawRef): TimelineEnvelope;
-}
-declare function createTimelineSequencer(options: CreateTimelineSequencerOptions): TimelineSequencer;
-declare function appendTimelineItem(envelope: TimelineEnvelope): TimelineEnvelope;
-declare function createTimelineCursor(cursor: TimelineCursor): TimelineCursor;
-declare function fetchTimeline(timeline: TimelineEnvelope[], request?: TimelineFetchRequest): TimelineFetchResult;
-declare function mergeTimeline(existing: TimelineEnvelope[], incoming: TimelineEnvelope[]): TimelineEnvelope[];
-
-export { type CreateTimelineSequencerOptions, type TimelineCommandOrigin, type TimelineCursor, type TimelineEnvelope, type TimelineFetchRequest, type TimelineFetchResult, type TimelineItem, type TimelinePermissionRequest, type TimelinePermissionResolution, type TimelinePermissionScope, type TimelineProvider, type TimelineRawRef, type TimelineSequencer, type TimelineToolStatus, type ToolIntent, appendTimelineItem, createTimelineCursor, createTimelineSequencer, fetchTimeline, mergeTimeline };
-
-// ── inlined from @weft/runtime-core ──
-// -- @weft/runtime-core/index.d.ts --
-
-declare const RUNTIME_KINDS: readonly ["native-sdk", "app-server", "compatible-sdk", "cli-fallback"];
-type AgentRuntimeKind = typeof RUNTIME_KINDS[number];
-type AgentRuntimeStatus = 'idle' | 'preflighting' | 'ready' | 'starting' | 'running' | 'waiting_for_permission' | 'turn_completed' | 'completed' | 'failed' | 'disposed';
-
-/**
- * How a provider's authentication is managed.
- * Provider-neutral auth mode — covers native SDK, app-server, compatible SDK, and CLI fallback.
- */
-type ProviderAuthMode = 'provider-owned' | 'managed' | 'none';
-/**
- * Result of probing a provider's auth configuration.
- *
- * For provider-owned auth: checks whether the provider binary reports
- * authentication as configured (e.g. `claude auth status --json` returns
- * `loggedIn: true`, or `codex app-server account/read` returns an account).
- *
- * For managed auth: checks whether required env vars are present.
- * For 'none': no auth required (e.g. fake backend for testing).
- */
-interface ProviderAuthDetection {
-    /** Which auth mode this provider uses */
-    mode: ProviderAuthMode;
-    /** Whether auth credentials are available and valid */
-    configured: boolean;
-    /** How auth was detected (e.g. "claude auth status --json", "env vars") */
-    source: string;
-    /** Whether an account was found (provider-owned: from CLI output) */
-    accountPresent?: boolean;
-    /** Whether OpenAI auth is required (Codex-specific) */
-    requiresOpenaiAuth?: boolean;
-    /** Auth method reported by provider (e.g. "oauth", "api_key") */
-    method?: string;
-    /** Provider name reported by CLI (e.g. "anthropic") */
-    provider?: string;
-    /** Error message if auth detection failed */
-    error?: string;
-}
-/**
- * Narrowed auth detection for runtime capability reports.
- * Only covers provider-owned auth, which is the SDK-first default.
- */
-interface RuntimeAuthDetection extends ProviderAuthDetection {
-    mode: 'provider-owned';
-}
-interface RuntimeCandidate {
-    kind: AgentRuntimeKind;
-    available: boolean;
-    reason?: string;
-}
-interface RuntimeSelectionOptions {
-    provider?: string;
-    candidates: RuntimeCandidate[];
-    preferredRuntime?: AgentRuntimeKind;
-    allowFallback?: boolean;
-}
-interface RuntimeSelection {
-    selected?: AgentRuntimeKind;
-    fallback: boolean;
-    fallbackReason?: string;
-    error?: string;
-}
-interface RuntimeCapabilityReport extends RuntimeSelection {
-    provider: string;
-    candidates: RuntimeCandidate[];
-    preferredRuntime?: AgentRuntimeKind;
-    allowFallback: boolean;
-    auth: RuntimeAuthDetection;
-    policyCapabilities: RuntimePolicyCapabilities;
-    sourceCapabilities: RuntimeSourceCapabilities;
-    skillCapabilities: RuntimeSkillCapabilities;
-    automationCapabilities: RuntimeAutomationCapabilities;
-    hostToolCapabilities: RuntimeHostToolCapabilities;
-}
-interface CreateRuntimeCapabilityReportOptions extends RuntimeSelectionOptions {
-    provider: string;
-    auth: RuntimeAuthDetection;
-    extensionCapabilities?: RuntimeExtensionCapabilities;
-}
-interface AgentRuntimeOptions {
-    provider: string;
-    cwd: string;
-    sessionId?: string;
-    model?: string;
-    reasoningEffort?: string;
-    permissionMode?: PermissionMode;
-    authMode?: 'provider-owned';
-    preferredRuntime?: AgentRuntimeKind;
-    allowFallback?: boolean;
-    executable?: string;
-    env?: Record<string, string>;
-    extensions?: RuntimeExtensionContext;
-}
-interface SendMessageOptions {
-    turnId?: string;
-    model?: string;
-    reasoningEffort?: string;
-    permissionMode?: PermissionMode;
-    commandOrigin?: CommandOrigin;
-}
-type ToolPolicyDecision = {
-    decision: 'allow';
-} | {
-    decision: 'ask';
-    reason: string;
-} | {
-    decision: 'deny';
-    reason: string;
-};
-interface CodexPermissionParams {
-    approvalPolicy: string;
-    approvalsReviewer: string;
-    sandbox: string;
-}
-/**
- * Canonical PermissionMode → Codex permission parameters mapping, shared by
- * the app-server driver (thread/start, turn/start), the host controller, and
- * the CLI fallback runtime. `sandbox` is a Codex `SandboxMode` string as used
- * by `thread/start` and `codex exec --sandbox`.
- */
-declare function mapPermissionModeToCodexParams(mode: PermissionMode): CodexPermissionParams;
-/**
- * Codex app-server v2 `turn/start` takes a tagged `SandboxPolicy` object,
- * unlike `thread/start` which takes a plain `SandboxMode` string. Variant
- * fields are all serde-defaulted, so the minimal `{ type }` form is valid.
- */
-declare function mapCodexSandboxModeToSandboxPolicy(sandbox: string): {
-    type: string;
-};
-type RuntimePermissionScope = {
-    type: 'session';
-    sessionId: string;
-} | {
-    type: 'workspace';
-    workspaceId: string;
-} | {
-    type: 'source';
-    sourceSlug: string;
-} | {
-    type: 'skill';
-    skillSlug: string;
-} | {
-    type: 'automation';
-    automationId: string;
-} | {
-    type: 'tool-call';
-    callId: string;
-};
-type RuntimePermissionScopeInput = string | RuntimePermissionScope;
-type RuntimeToolIntent = {
-    kind: 'bash';
-    command: string;
-    baseCommand: string;
-} | {
-    kind: 'file_write';
-    path: string;
-    toolName: string;
-} | {
-    kind: 'mcp';
-    name: string;
-} | {
-    kind: 'api';
-    method: string;
-    path: string;
-    url?: string;
-} | {
-    kind: 'unknown';
-    toolName: string;
-};
-interface ToolPolicyRequest {
-    toolName: string;
-    input?: Record<string, unknown>;
-    toolIntent?: RuntimeToolIntent;
-    scope?: RuntimePermissionScopeInput;
-}
-type RuntimePolicyHook = (request: ToolPolicyRequest) => ToolPolicyDecision | Promise<ToolPolicyDecision>;
-interface RuntimeFeatureCapabilities {
-    supported: boolean;
-    degraded?: boolean;
-    reason?: string;
-}
-interface RuntimePolicyCapabilities extends RuntimeFeatureCapabilities {
-    modes: PermissionMode[];
-    approvals: boolean;
-    toolPolicy: boolean;
-}
-interface RuntimeSourceCapabilities extends RuntimeFeatureCapabilities {
-    registry?: boolean;
-    credentialGateway?: boolean;
-    mcpTools?: boolean;
-}
-interface RuntimeSkillCapabilities extends RuntimeFeatureCapabilities {
-    registry?: boolean;
-    activationPlan?: boolean;
-    scopedPolicy?: boolean;
-}
-interface RuntimeAutomationCapabilities extends RuntimeFeatureCapabilities {
-    eventBus: boolean;
-    schedulerHost: boolean;
-    promptAction: boolean;
-    webhookAction: boolean;
-}
-interface RuntimeHostToolCapabilities extends RuntimeFeatureCapabilities {
-    sessionTools: boolean;
-    workflowTransitions: boolean;
-    browserActions: boolean;
-    metadataWrites: boolean;
-}
-interface RuntimeExtensionCapabilities {
-    policy?: RuntimePolicyCapabilities;
-    sources?: RuntimeSourceCapabilities;
-    skills?: RuntimeSkillCapabilities;
-    automations?: RuntimeAutomationCapabilities;
-    hostTools?: RuntimeHostToolCapabilities;
-}
-interface RuntimePolicyExtension {
-    mode: PermissionMode;
-    hook?: RuntimePolicyHook;
-    degraded?: boolean;
-}
-interface SourceSelection {
-    enabledSourceSlugs: string[];
-}
-interface ProviderSourceCredentialRef {
-    type: string;
-    sourceSlug: string;
-    workspaceId?: string;
-}
-type ProviderSourceToolDescriptor = {
-    kind: 'api-source';
-    sourceSlug: string;
-    baseUrl: string;
-    authType: string;
-    defaultHeaders?: Record<string, string>;
-    credentialRef?: ProviderSourceCredentialRef;
-    [key: string]: unknown;
-} | {
-    kind: 'local-source';
-    sourceSlug: string;
-    path: string;
-    format?: string;
-    [key: string]: unknown;
-} | {
-    kind: 'mcp-server';
-    sourceSlug: string;
-    transport: 'stdio' | 'http' | 'sse';
-    url?: string;
-    command?: string;
-    args?: string[];
-    env?: Record<string, string>;
-    headers?: Record<string, string>;
-    credentialRef?: ProviderSourceCredentialRef;
-    [key: string]: unknown;
-};
-interface SkillSelection {
-    activeSkillSlugs: string[];
-}
-type CommandOrigin = {
-    type: 'user';
-    id?: string;
-} | {
-    type: 'automation';
-    id: string;
-} | {
-    type: 'scheduler';
-    id?: string;
-} | {
-    type: 'host';
-    id?: string;
-} | {
-    type: 'replay';
-    id?: string;
-} | {
-    type: 'system';
-    id?: string;
-};
-interface SubmitPlanRequest {
-    sessionId?: string;
-    planRef: string;
-    origin?: CommandOrigin;
-}
-interface SubmitPlanReceipt {
-    accepted: boolean;
-    planRef?: string;
-    reason?: string;
-}
-interface SourceAuthRequest {
-    sessionId?: string;
-    sourceSlug: string;
-    reason?: string;
-}
-interface SourceAuthReceipt {
-    ok: boolean;
-    sourceSlug: string;
-    reason?: string;
-}
-interface SourceActivationRequest {
-    sessionId?: string;
-    sourceSlug: string;
-}
-interface SourceActivationReceipt {
-    ok: boolean;
-    sourceSlug: string;
-    availability?: 'immediate' | 'next-turn';
-    reason?: string;
-}
-interface BrowserActionRequest {
-    sessionId?: string;
-    action: string;
-    input?: unknown;
-}
-interface BrowserActionReceipt {
-    ok: boolean;
-    result?: unknown;
-    reason?: string;
-}
-interface SpawnSessionRequest {
-    parentSessionId?: string;
-    prompt: string;
-    model?: string;
-    commandOrigin?: CommandOrigin;
-}
-interface SpawnSessionReceipt {
-    sessionId: string;
-}
-interface InterSessionMessageRequest {
-    sessionId: string;
-    message: string;
-    attachments?: Array<{
-        path: string;
-        name?: string;
-    }>;
-    commandOrigin?: CommandOrigin;
-}
-interface CommandReceipt {
-    ok: boolean;
-    commandId?: string;
-    reason?: string;
-}
-interface SessionMetadataPatch {
-    sessionId?: string;
-    labels?: string[];
-    status?: string;
-    flagged?: boolean;
-    topic?: string;
-}
-interface SessionMetadataSnapshot {
-    sessionId?: string;
-    labels?: string[];
-    status?: string;
-    flagged?: boolean;
-    topic?: string;
-}
-interface SessionListRequest {
-    status?: string;
-    labels?: string[];
-    limit?: number;
-}
-interface SessionListResult {
-    sessions: SessionMetadataSnapshot[];
-}
-interface LlmToolRequest {
-    prompt: string;
-    model?: string;
-    commandOrigin?: CommandOrigin;
-}
-interface LlmToolResult {
-    text: string;
-    model?: string;
-    usage?: unknown;
-}
-interface ListSourcesRequest {
-    sessionId?: string;
-    enabledOnly?: boolean;
-}
-interface SourceSummary {
-    slug: string;
-    name: string;
-    provider: string;
-    type: string;
-    enabled: boolean;
-    isAuthenticated?: boolean;
-    connectionStatus?: string;
-    tagline?: string;
-}
-interface ListSourcesResult {
-    sources: SourceSummary[];
-}
-interface GetSourceRequest {
-    sessionId?: string;
-    sourceSlug: string;
-}
-interface GetSourceResult {
-    source: SourceSummary & {
-        createdAt?: number;
-        updatedAt?: number;
-        mcp?: Record<string, unknown>;
-        api?: Record<string, unknown>;
-        local?: Record<string, unknown>;
-    };
-}
-interface CreateSourceRequest {
-    sessionId?: string;
-    name: string;
-    provider: string;
-    type: string;
-    mcp?: Record<string, unknown>;
-    api?: Record<string, unknown>;
-    local?: Record<string, unknown>;
-    icon?: string;
-    enabled?: boolean;
-}
-interface CreateSourceResult {
-    ok: boolean;
-    source?: SourceSummary;
-    reason?: string;
-}
-interface UpdateSourceRequest {
-    sessionId?: string;
-    sourceSlug: string;
-    enabled?: boolean;
-    name?: string;
-    icon?: string;
-    tagline?: string;
-}
-interface UpdateSourceResult {
-    ok: boolean;
-    source?: SourceSummary;
-    reason?: string;
-}
-interface DeleteSourceRequest {
-    sessionId?: string;
-    sourceSlug: string;
-}
-interface DeleteSourceResult {
-    ok: boolean;
-    sourceSlug: string;
-    reason?: string;
-}
-interface ListSkillsRequest {
-    sessionId?: string;
-}
-interface SkillSummary {
-    slug: string;
-    name: string;
-    description: string;
-    source: string;
-    icon?: string;
-    globs?: string[];
-    requiredSources?: string[];
-}
-interface ListSkillsResult {
-    skills: SkillSummary[];
-}
-interface GetSkillRequest {
-    sessionId?: string;
-    skillSlug: string;
-}
-interface GetSkillResult {
-    skill: SkillSummary & {
-        content: string;
-        alwaysAllow?: string[];
-    };
-}
-interface CreateSkillRequest {
-    sessionId?: string;
-    slug: string;
-    name: string;
-    description: string;
-    content: string;
-    globs?: string[];
-    alwaysAllow?: string[];
-    icon?: string;
-    requiredSources?: string[];
-}
-interface CreateSkillResult {
-    ok: boolean;
-    skill?: SkillSummary;
-    reason?: string;
-}
-interface UpdateSkillRequest {
-    sessionId?: string;
-    skillSlug: string;
-    name?: string;
-    description?: string;
-    content?: string;
-    globs?: string[];
-    alwaysAllow?: string[];
-    icon?: string;
-    requiredSources?: string[];
-}
-interface UpdateSkillResult {
-    ok: boolean;
-    skill?: SkillSummary;
-    reason?: string;
-}
-interface DeleteSkillRequest {
-    sessionId?: string;
-    skillSlug: string;
-}
-interface DeleteSkillResult {
-    ok: boolean;
-    skillSlug: string;
-    reason?: string;
-}
-interface GetAutomationsConfigRequest {
-    sessionId?: string;
-}
-interface GetAutomationsConfigResult {
-    config: Record<string, unknown> | null;
-    configPath: string;
-}
-interface UpdateAutomationsConfigRequest {
-    sessionId?: string;
-    config: Record<string, unknown>;
-}
-interface UpdateAutomationsConfigResult {
-    ok: boolean;
-    automationCount?: number;
-    errors?: string[];
-}
-interface ListSchedulesRequest {
-    sessionId?: string;
-}
-interface ScheduleSummary {
-    schedulerId: string;
-    workspaceId: string;
-    cron: string;
-    timezone: string;
-}
-interface ListSchedulesResult {
-    schedules: ScheduleSummary[];
-}
-interface StartScheduleRequest {
-    sessionId?: string;
-    schedulerId: string;
-    workspaceId: string;
-    cron: string;
-    timezone: string;
-}
-interface StartScheduleResult {
-    schedulerId: string;
-    state: 'started' | 'stopped';
-    timestamp: number;
-}
-interface StopScheduleRequest {
-    sessionId?: string;
-    schedulerId: string;
-}
-interface StopScheduleResult {
-    ok: boolean;
-    schedulerId: string;
-    state?: 'stopped';
-    reason?: string;
-}
-interface SessionToolBridge {
-    submitPlan?(request: SubmitPlanRequest): Promise<SubmitPlanReceipt>;
-    requestSourceAuth?(request: SourceAuthRequest): Promise<SourceAuthReceipt>;
-    activateSource?(request: SourceActivationRequest): Promise<SourceActivationReceipt>;
-    runBrowserAction?(request: BrowserActionRequest): Promise<BrowserActionReceipt>;
-    spawnSession?(request: SpawnSessionRequest): Promise<SpawnSessionReceipt>;
-    sendSessionMessage?(request: InterSessionMessageRequest): Promise<CommandReceipt>;
-    updateSessionMetadata?(request: SessionMetadataPatch): Promise<SessionMetadataSnapshot>;
-    listSessions?(request: SessionListRequest): Promise<SessionListResult>;
-    queryLlm?(request: LlmToolRequest): Promise<LlmToolResult>;
-    listSources?(request: ListSourcesRequest): Promise<ListSourcesResult>;
-    getSource?(request: GetSourceRequest): Promise<GetSourceResult>;
-    createSource?(request: CreateSourceRequest): Promise<CreateSourceResult>;
-    updateSource?(request: UpdateSourceRequest): Promise<UpdateSourceResult>;
-    deleteSource?(request: DeleteSourceRequest): Promise<DeleteSourceResult>;
-    listSkills?(request: ListSkillsRequest): Promise<ListSkillsResult>;
-    getSkill?(request: GetSkillRequest): Promise<GetSkillResult>;
-    createSkill?(request: CreateSkillRequest): Promise<CreateSkillResult>;
-    updateSkill?(request: UpdateSkillRequest): Promise<UpdateSkillResult>;
-    deleteSkill?(request: DeleteSkillRequest): Promise<DeleteSkillResult>;
-    getAutomationsConfig?(request: GetAutomationsConfigRequest): Promise<GetAutomationsConfigResult>;
-    updateAutomationsConfig?(request: UpdateAutomationsConfigRequest): Promise<UpdateAutomationsConfigResult>;
-    listSchedules?(request: ListSchedulesRequest): Promise<ListSchedulesResult>;
-    startSchedule?(request: StartScheduleRequest): Promise<StartScheduleResult>;
-    stopSchedule?(request: StopScheduleRequest): Promise<StopScheduleResult>;
-}
-type SessionToolName = keyof SessionToolBridge;
-type SessionToolRequest = SubmitPlanRequest | SourceAuthRequest | SourceActivationRequest | BrowserActionRequest | SpawnSessionRequest | InterSessionMessageRequest | SessionMetadataPatch | SessionListRequest | LlmToolRequest | ListSourcesRequest | GetSourceRequest | CreateSourceRequest | UpdateSourceRequest | DeleteSourceRequest | ListSkillsRequest | GetSkillRequest | CreateSkillRequest | UpdateSkillRequest | DeleteSkillRequest | GetAutomationsConfigRequest | UpdateAutomationsConfigRequest | ListSchedulesRequest | StartScheduleRequest | StopScheduleRequest;
-interface SessionToolTimelineRef {
-    epoch: string;
-    seq: number;
-}
-interface SessionToolInvocationReceipt {
-    ok: boolean;
-    requestId: string;
-    toolName: SessionToolName;
-    origin?: CommandOrigin;
-    policyDecision: ToolPolicyDecision;
-    result?: unknown;
-    reason?: string;
-    timelineRefs: SessionToolTimelineRef[];
-}
-interface InvokeSessionToolOptions {
-    sessionId: string;
-    toolName: SessionToolName;
-    request: SessionToolRequest;
-    bridge: SessionToolBridge;
-    policy?: RuntimePolicyHook;
-    commandOrigin?: CommandOrigin;
-    appendTimeline?: (item: TimelineItem) => TimelineEnvelope;
-}
-interface RuntimeHostServices {
-    sessionTools?: SessionToolBridge;
-}
-interface RuntimeExtensionContext {
-    policy?: RuntimePolicyExtension;
-    sources?: SourceSelection;
-    skills?: SkillSelection;
-    commandOrigin?: CommandOrigin;
-    hostServices?: RuntimeHostServices;
-}
-interface AgentCommandSink {
-    sendMessage(message: string, options?: SendMessageOptions): Promise<void>;
-    abort(reason?: string): Promise<void>;
-    respondToPermission(requestId: string, allowed: boolean, remember?: boolean): Promise<void>;
-    resumeTool?(runId: string, resumeData: Record<string, unknown>): Promise<void>;
-    dispose(): Promise<void>;
-}
-interface AgentEventStream {
-    connect(onEvent: (event: AgentEvent) => void, onError?: (error: Error) => void, onClose?: () => void): void;
-    disconnect(): void;
-    isConnected(): boolean;
-}
-interface AgentTimelineStream {
-    connect(onEvent: (event: TimelineEnvelope) => void, onError?: (error: Error) => void, onClose?: () => void): void;
-    disconnect(): void;
-    isConnected(): boolean;
-}
-interface AgentRuntimeState {
-    status: AgentRuntimeStatus;
-    acceptedMessages: string[];
-    queuedMessages: string[];
-    lastError?: string;
-    waitingPermissionRequestId?: string;
-}
-type RuntimeAction = {
-    type: 'preflight_start';
-} | {
-    type: 'preflight_ok';
-} | {
-    type: 'preflight_error';
-    error: string;
-} | {
-    type: 'starting';
-} | {
-    type: 'send_message';
-    message: string;
-} | {
-    type: 'permission_request';
-    requestId: string;
-} | {
-    type: 'permission_response';
-} | {
-    type: 'turn_completed';
-} | {
-    type: 'complete';
-} | {
-    type: 'abort';
-    reason?: string;
-} | {
-    type: 'error';
-    error: string;
-} | {
-    type: 'dispose';
-};
-declare const initialRuntimeState: AgentRuntimeState;
-/**
- * Canonical state machine reducer for AgentRuntime lifecycle.
- *
- * Transitions follow the architecture spec:
- *   idle → preflighting → ready → starting → running
- *   running → waiting_for_permission → running
- *   running → turn_completed → ready
- *   running → ready (via complete with empty queue)
- *   any → failed / disposed
- *   any non-disposed → ready (via abort)
- *
- * `send_message` while running enqueues (session manager semantics).
- * `complete` drains the queue: if a queued message exists, it is
- * immediately accepted and the state stays running.
- */
-declare function reduceRuntimeState(state: AgentRuntimeState | undefined, action: RuntimeAction): AgentRuntimeState;
-interface AgentRuntime {
-    readonly sessionId: string;
-    readonly provider: string;
-    readonly runtimeKind: AgentRuntimeKind;
-    readonly events: AgentTimelineStream;
-    readonly commands: AgentCommandSink;
-    preflight(): Promise<RuntimeCapabilityReport>;
-    fetchTimeline(request: TimelineFetchRequest): Promise<TimelineFetchResult>;
-    getState(): AgentRuntimeState;
-}
-declare function createRuntimeExtensionContext(context?: RuntimeExtensionContext): RuntimeExtensionContext;
-declare function sanitizeProviderSourceTools(sourceTools: ProviderSourceToolDescriptor[] | undefined): ProviderSourceToolDescriptor[];
-declare function invokeSessionTool(options: InvokeSessionToolOptions): Promise<SessionToolInvocationReceipt>;
-declare function selectRuntimeCandidate(options: RuntimeSelectionOptions): RuntimeSelection;
-declare function createRuntimeCapabilityReport(options: CreateRuntimeCapabilityReportOptions): RuntimeCapabilityReport;
-
-export { type AgentCommandSink, type AgentEventStream, type AgentRuntime, type AgentRuntimeKind, type AgentRuntimeOptions, type AgentRuntimeState, type AgentRuntimeStatus, type AgentTimelineStream, type BrowserActionReceipt, type BrowserActionRequest, type CodexPermissionParams, type CommandOrigin, type CommandReceipt, type CreateRuntimeCapabilityReportOptions, type CreateSkillRequest, type CreateSkillResult, type CreateSourceRequest, type CreateSourceResult, type DeleteSkillRequest, type DeleteSkillResult, type DeleteSourceRequest, type DeleteSourceResult, type GetAutomationsConfigRequest, type GetAutomationsConfigResult, type GetSkillRequest, type GetSkillResult, type GetSourceRequest, type GetSourceResult, type InterSessionMessageRequest, type InvokeSessionToolOptions, type ListSchedulesRequest, type ListSchedulesResult, type ListSkillsRequest, type ListSkillsResult, type ListSourcesRequest, type ListSourcesResult, type LlmToolRequest, type LlmToolResult, type ProviderAuthDetection, type ProviderAuthMode, type ProviderSourceCredentialRef, type ProviderSourceToolDescriptor, RUNTIME_KINDS, type RuntimeAction, type RuntimeAuthDetection, type RuntimeAutomationCapabilities, type RuntimeCandidate, type RuntimeCapabilityReport, type RuntimeExtensionCapabilities, type RuntimeExtensionContext, type RuntimeFeatureCapabilities, type RuntimeHostServices, type RuntimeHostToolCapabilities, type RuntimePermissionScope, type RuntimePermissionScopeInput, type RuntimePolicyCapabilities, type RuntimePolicyExtension, type RuntimePolicyHook, type RuntimeSelection, type RuntimeSelectionOptions, type RuntimeSkillCapabilities, type RuntimeSourceCapabilities, type RuntimeToolIntent, type ScheduleSummary, type SendMessageOptions, type SessionListRequest, type SessionListResult, type SessionMetadataPatch, type SessionMetadataSnapshot, type SessionToolBridge, type SessionToolInvocationReceipt, type SessionToolName, type SessionToolRequest, type SessionToolTimelineRef, type SkillSelection, type SkillSummary, type SourceActivationReceipt, type SourceActivationRequest, type SourceAuthReceipt, type SourceAuthRequest, type SourceSelection, type SourceSummary, type SpawnSessionReceipt, type SpawnSessionRequest, type StartScheduleRequest, type StartScheduleResult, type StopScheduleRequest, type StopScheduleResult, type SubmitPlanReceipt, type SubmitPlanRequest, type ToolPolicyDecision, type ToolPolicyRequest, type UpdateAutomationsConfigRequest, type UpdateAutomationsConfigResult, type UpdateSkillRequest, type UpdateSkillResult, type UpdateSourceRequest, type UpdateSourceResult, createRuntimeCapabilityReport, createRuntimeExtensionContext, initialRuntimeState, invokeSessionTool, mapCodexSandboxModeToSandboxPolicy, mapPermissionModeToCodexParams, reduceRuntimeState, sanitizeProviderSourceTools, selectRuntimeCandidate };
-
-// ── inlined from @weft/automations ──
-// -- @weft/automations/index.d.ts --
-import { z } from 'zod';
-
-/**
- * Automation System Type Definitions
- *
- * All types, interfaces, and type exports for the automations system.
- */
-
-/** App events - handled by the host runtime */
-type AppEvent = 'LabelAdd' | 'LabelRemove' | 'LabelConfigChange' | 'PermissionModeChange' | 'FlagChange' | 'SessionStatusChange' | 'SchedulerTick';
-/** Agent events - passed to Claude SDK */
-type AgentEvent = 'PreToolUse' | 'PostToolUse' | 'PostToolUseFailure' | 'Notification' | 'UserPromptSubmit' | 'SessionStart' | 'SessionEnd' | 'Stop' | 'SubagentStart' | 'SubagentStop' | 'PreCompact' | 'PermissionRequest' | 'Setup';
-type AutomationEvent = AppEvent | AgentEvent;
-declare const APP_EVENTS: AppEvent[];
-declare const AGENT_EVENTS: AgentEvent[];
-/** A prompt action - sends a prompt to the agent runtime */
-interface PromptAction {
-    type: 'prompt';
-    prompt: string;
-    /** LLM connection slug for the created session (falls back to default if not found) */
-    llmConnection?: string;
-    /** Model ID for the created session (falls back to provider default if invalid) */
-    model?: string;
-    /**
-     * Thinking level for the created session.
-     * When omitted, falls back to the workspace default (then DEFAULT_THINKING_LEVEL).
-     */
-    thinkingLevel?: ThinkingLevel;
-}
-/** HTTP method for webhook actions */
-type WebhookHttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
-/** Body format for webhook actions */
-type WebhookBodyFormat = 'json' | 'form' | 'raw';
-/** Authentication shorthand for webhook actions */
-type WebhookAuth = {
-    type: 'basic';
-    username: string;
-    password: string;
-} | {
-    type: 'bearer';
-    token: string;
-};
-/** A webhook action - sends an HTTP request to an endpoint */
-interface WebhookAction {
-    type: 'webhook';
-    /** The URL to send the webhook to (http or https) */
-    url: string;
-    /** HTTP method (default: POST) */
-    method?: WebhookHttpMethod;
-    /** HTTP headers as key-value pairs */
-    headers?: Record<string, string>;
-    /** Body format: 'json' sends Content-Type application/json, 'form' URL-encodes, 'raw' sends as-is */
-    bodyFormat?: WebhookBodyFormat;
-    /** Request body — JSON object when bodyFormat is 'json' or 'form', string when 'raw' */
-    body?: unknown;
-    /** Capture response body in result (truncated to 4KB). Default: false */
-    captureResponse?: boolean;
-    /** Authentication shorthand (applied before custom headers) */
-    auth?: WebhookAuth;
-}
-type AutomationAction = PromptAction | WebhookAction;
-/** Time-of-day and day-of-week condition */
-interface TimeCondition {
-    condition: 'time';
-    /** Start time in 24h HH:MM format */
-    after?: string;
-    /** End time in 24h HH:MM format */
-    before?: string;
-    /** Days of week (3-letter lowercase: mon, tue, wed, thu, fri, sat, sun) */
-    weekday?: string[];
-    /** IANA timezone (falls back to matcher timezone, then system local) */
-    timezone?: string;
-}
-/** State/field check condition with HA-style from/to for transitions */
-interface StateCondition {
-    condition: 'state';
-    /** Field name to check (e.g. 'permissionMode', 'sessionStatus', 'labels', 'isFlagged') */
-    field: string;
-    /** Exact value match */
-    value?: unknown;
-    /** Transition: previous value (mapped via TRANSITION_FIELDS) */
-    from?: unknown;
-    /** Transition: new value (mapped via TRANSITION_FIELDS) */
-    to?: unknown;
-    /** Array membership check */
-    contains?: string;
-    /** Negation: matches anything except this value */
-    not_value?: unknown;
-}
-/** Logical composition condition (and/or/not) */
-interface LogicalCondition {
-    condition: 'and' | 'or' | 'not';
-    conditions: AutomationCondition[];
-}
-/** Union of all condition types */
-type AutomationCondition = TimeCondition | StateCondition | LogicalCondition;
-interface AutomationMatcher {
-    /** Short 6-character hex ID for stable identification across config changes. */
-    id?: string;
-    /** Optional display name. If omitted, derived from the first action. */
-    name?: string;
-    /** Regex pattern for matching event data (not used for SchedulerTick) */
-    matcher?: string;
-    /** Cron expression for SchedulerTick events (5-field format) */
-    cron?: string;
-    /** IANA timezone for cron evaluation (e.g., "Europe/Budapest", "America/New_York") */
-    timezone?: string;
-    /** Permission mode for sessions created by prompt actions. */
-    permissionMode?: PermissionMode;
-    /** Labels to apply to sessions created by prompt actions */
-    labels?: string[];
-    /** Whether this automation matcher is enabled. Defaults to true. Set to false to disable without removing. */
-    enabled?: boolean;
-    /** Optional conditions that must all pass (AND) after matcher matches, before actions fire */
-    conditions?: AutomationCondition[];
-    /**
-     * Optional Telegram forum-topic name. When set, sessions spawned by this
-     * matcher are bound to a forum topic of this name in the workspace's paired
-     * supergroup. The topic is created on first use and reused thereafter.
-     * Multiple matchers using the same value share one topic.
-     *
-     * Silently ignored when:
-     *   - No supergroup is paired in Settings → Messaging → Telegram
-     *   - The Telegram bot is not connected
-     *   - The bot lacks "Manage Topics" permission in the supergroup
-     */
-    telegramTopic?: string;
-    actions: AutomationAction[];
-}
-interface AutomationsConfig {
-    automations: Partial<Record<AutomationEvent, AutomationMatcher[]>>;
-}
-/** References parsed from a prompt (@name for sources and skills) */
-interface PromptReferences {
-    /**
-     * All @name references found in the prompt.
-     * These could be sources (@linear, @github) or skills (@commit, @review-pr).
-     * The caller should resolve which are sources vs skills based on available configurations.
-     */
-    mentions: string[];
-}
-/** Result of a prompt action - returns the prompt to be executed by caller */
-interface PromptActionResult {
-    type: 'prompt';
-    prompt: string;
-    /** The expanded prompt with environment variables substituted */
-    expandedPrompt: string;
-    /** References to sources and skills found in the prompt */
-    references: PromptReferences;
-}
-/** Result of a webhook action */
-interface WebhookActionResult {
-    type: 'webhook';
-    /** The URL that was called */
-    url: string;
-    /** HTTP status code from the response */
-    statusCode: number;
-    /** Whether the request was successful (2xx status) */
-    success: boolean;
-    /** Error message if the request failed */
-    error?: string;
-    /** Number of attempts made (1 = no retry, 2+ = retried) */
-    attempts?: number;
-    /** Total duration including retries, in ms */
-    durationMs?: number;
-    /** Captured response body (only when captureResponse is true, truncated to 4KB) */
-    responseBody?: string;
-}
-type ActionExecutionResult = PromptActionResult | WebhookActionResult;
-/** A pending prompt with its metadata */
-interface PendingPrompt {
-    /** The session ID this prompt should be sent to */
-    sessionId: string | undefined;
-    /** The automation matcher ID this prompt originated from */
-    matcherId?: string;
-    /** Human-readable automation name (from matcher.name or derived fallback) */
-    automationName?: string;
-    /** The expanded prompt text */
-    prompt: string;
-    /**
-     * All @mentions found in the prompt (sources and skills).
-     * The caller should resolve which are sources vs skills based on available configurations.
-     */
-    mentions: string[];
-    /** Labels to apply to the created session */
-    labels?: string[];
-    /** Permission mode for the created session (from matcher config) */
-    permissionMode?: PermissionMode;
-    /** LLM connection slug for the created session (falls back to default if not found) */
-    llmConnection?: string;
-    /** Model ID for the created session (falls back to provider default if invalid) */
-    model?: string;
-    /** Thinking level for the created session (falls back to workspace default when omitted) */
-    thinkingLevel?: ThinkingLevel;
-    /** Forum-topic name to bind the new session to (Telegram supergroup, when paired). */
-    telegramTopic?: string;
-}
-interface AutomationResult {
-    event: string;
-    matched: number;
-    results: ActionExecutionResult[];
-    /** Prompts that should be executed by the agent runtime (with metadata) */
-    pendingPrompts: PendingPrompt[];
-}
-/** Internal validation result that includes the parsed config */
-type AutomationsValidationResult = {
-    valid: boolean;
-    errors: string[];
-    config: AutomationsConfig | null;
-};
-/**
- * SDK automation input type - union of all possible SDK event inputs
- */
-interface SdkAutomationInput {
-    hook_event_name: string;
-    tool_name?: string;
-    tool_input?: Record<string, unknown>;
-    tool_response?: string;
-    tool_use_id?: string;
-    source?: string;
-    model?: string;
-    agent_id?: string;
-    agent_type?: string;
-    prompt?: string;
-    message?: string;
-    title?: string;
-    error?: string;
-}
-/**
- * SDK automation callback signature (matches Claude SDK HookCallback type)
- */
-type SdkAutomationCallback = (input: SdkAutomationInput, toolUseId: string, options: {
-    signal?: AbortSignal;
-}) => Promise<{
-    continue: boolean;
-    reason?: string;
-}>;
-/**
- * SDK automation matcher format (matches Claude SDK HookCallbackMatcher type)
- * Note: The `hooks` field name is kept as-is to match the Claude SDK interface.
- */
-interface SdkAutomationCallbackMatcher {
-    matcher?: string;
-    timeout?: number;
-    hooks: SdkAutomationCallback[];
-}
-/**
- * Lightweight session metadata for diffing.
- * Only includes fields that trigger automations.
- */
-interface SessionMetadataSnapshot {
-    permissionMode?: string;
-    labels?: string[];
-    isFlagged?: boolean;
-    sessionStatus?: string;
-    /** Session name (user-defined or auto-generated) */
-    sessionName?: string;
-}
-
-/**
- * Config Validators Stub
- *
- * Provides validation types used by automations.
- * Stubbed for OSS extraction — the real validators are in the main app.
- */
-interface ValidationIssue {
-    /** File being validated */
-    file: string;
-    /** Path to the issue within the config */
-    path: string;
-    /** Human-readable error/warning message */
-    message: string;
-    /** Issue severity */
-    severity: 'error' | 'warning' | 'info';
-    /** Optional suggestion for fixing the issue */
-    suggestion?: string;
-}
-interface ValidationResult {
-    /** Whether the config is valid (no errors) */
-    valid: boolean;
-    /** Error issues (blocking) */
-    errors: ValidationIssue[];
-    /** Warning issues (non-blocking) */
-    warnings: ValidationIssue[];
-}
-
-/**
- * Automation System Validation
- *
- * Validators for automations.json configuration files.
- * Used by PreToolUse automations and workspace validators.
- */
-
-interface AutomationsConfigDoctorReport extends ValidationResult {
-    domain: 'automations';
-    summary: {
-        matcherCount: number;
-        actionCount: number;
-    };
-}
-/**
- * Validate automations config (internal - returns parsed config)
- */
-declare function validateAutomationsConfig(content: unknown): AutomationsValidationResult;
-/**
- * Validate automations config from a JSON string (no disk reads).
- * Used by PreToolUse automation to validate before writing to disk.
- * Follows the same pattern as other config validators in validators.ts.
- */
-declare function validateAutomationsContent(jsonString: string, fileName?: string): ValidationResult;
-declare function createAutomationsConfigDoctorReport(jsonString: string, fileName?: string): AutomationsConfigDoctorReport;
-/**
- * Validate automations.json from workspace path (reads from disk).
- * Follows the same pattern as other validators in validators.ts.
- */
-declare function validateAutomations(workspaceRoot: string): ValidationResult;
-
-/**
- * SDK Bridge - Environment variable building for Claude SDK automation integration
- *
- * Maps SDK automation input fields to WEFT_* environment variables for command execution.
- */
-
-/**
- * Build environment variables from SDK automation input.
- * Maps SDK input fields to WEFT_* environment variables.
- */
-declare function buildEnvFromSdkInput(event: AgentEvent, input: SdkAutomationInput): Record<string, string>;
-
-/**
- * WorkspaceEventBus - Typed Event Bus for Automations System
- *
- * Per-workspace event bus that enables loose coupling between:
- * - Event producers (ConfigWatcher, SchedulerService)
- * - Event consumers (CommandHandler, PromptHandler, EventLogHandler)
- *
- * Benefits over the current callback-based approach:
- * - No global state - each workspace has its own bus instance
- * - Type-safe events with payload validation
- * - Easy to add/remove handlers dynamically
- * - Testable in isolation
- */
-
-/** Base event payload with common fields */
-interface BaseEventPayload {
-    sessionId?: string;
-    sessionName?: string;
-    workspaceId: string;
-    timestamp: number;
-    labels?: string[];
-}
-/** Label events payload */
-interface LabelEventPayload extends BaseEventPayload {
-    label: string;
-}
-/** Permission mode change payload */
-interface PermissionModeChangePayload extends BaseEventPayload {
-    oldMode: string;
-    newMode: string;
-}
-/** Flag change payload */
-interface FlagChangePayload extends BaseEventPayload {
-    isFlagged: boolean;
-}
-/** Session status change payload */
-interface SessionStatusChangePayload extends BaseEventPayload {
-    oldState: string;
-    newState: string;
-}
-/** Scheduler tick payload */
-interface SchedulerTickPayload extends BaseEventPayload {
-    localTime: string;
-    utcTime: string;
-}
-/** Label config change payload */
-interface LabelConfigChangePayload extends BaseEventPayload {
-}
-/** Generic event payload for agent events */
-interface GenericEventPayload extends BaseEventPayload {
-    data: Record<string, unknown>;
-}
-/**
- * Maps event types to their payload types for type safety.
- */
-interface EventPayloadMap {
-    LabelAdd: LabelEventPayload;
-    LabelRemove: LabelEventPayload;
-    LabelConfigChange: LabelConfigChangePayload;
-    PermissionModeChange: PermissionModeChangePayload;
-    FlagChange: FlagChangePayload;
-    SessionStatusChange: SessionStatusChangePayload;
-    SchedulerTick: SchedulerTickPayload;
-    PreToolUse: GenericEventPayload;
-    PostToolUse: GenericEventPayload;
-    PostToolUseFailure: GenericEventPayload;
-    Notification: GenericEventPayload;
-    UserPromptSubmit: GenericEventPayload;
-    SessionStart: GenericEventPayload;
-    SessionEnd: GenericEventPayload;
-    Stop: GenericEventPayload;
-    SubagentStart: GenericEventPayload;
-    SubagentStop: GenericEventPayload;
-    PreCompact: GenericEventPayload;
-    PermissionRequest: GenericEventPayload;
-    Setup: GenericEventPayload;
-}
-type EventHandler<T extends AutomationEvent> = (payload: EventPayloadMap[T]) => void | Promise<void>;
-type AnyEventHandler = (event: AutomationEvent, payload: BaseEventPayload) => void | Promise<void>;
-interface EventBus {
-    /** Emit an event to all registered handlers */
-    emit<T extends AutomationEvent>(event: T, payload: EventPayloadMap[T]): Promise<void>;
-    /** Register a handler for a specific event type */
-    on<T extends AutomationEvent>(event: T, handler: EventHandler<T>): void;
-    /** Unregister a handler for a specific event type */
-    off<T extends AutomationEvent>(event: T, handler: EventHandler<T>): void;
-    /** Register a handler for all events (useful for logging) */
-    onAny(handler: AnyEventHandler): void;
-    /** Unregister an all-events handler */
-    offAny(handler: AnyEventHandler): void;
-    /** Clean up all handlers */
-    dispose(): void;
-}
-declare class WorkspaceEventBus implements EventBus {
-    private readonly workspaceId;
-    private readonly handlers;
-    private readonly anyHandlers;
-    private readonly rateCounts;
-    private disposed;
-    constructor(workspaceId: string);
-    /**
-     * Emit an event to all registered handlers.
-     * Handlers are called in parallel, errors are caught and logged.
-     */
-    emit<T extends AutomationEvent>(event: T, payload: EventPayloadMap[T]): Promise<void>;
-    /**
-     * Register a handler for a specific event type.
-     */
-    on<T extends AutomationEvent>(event: T, handler: EventHandler<T>): void;
-    /**
-     * Unregister a handler for a specific event type.
-     */
-    off<T extends AutomationEvent>(event: T, handler: EventHandler<T>): void;
-    /**
-     * Register a handler for all events.
-     * Useful for logging, metrics, or debugging.
-     */
-    onAny(handler: AnyEventHandler): void;
-    /**
-     * Unregister an all-events handler.
-     */
-    offAny(handler: AnyEventHandler): void;
-    /**
-     * Clean up all handlers and mark as disposed.
-     */
-    dispose(): void;
-    /**
-     * Check if the bus has been disposed.
-     */
-    isDisposed(): boolean;
-    /**
-     * Get the workspace ID this bus belongs to.
-     */
-    getWorkspaceId(): string;
-    /**
-     * Get handler count for debugging.
-     */
-    getHandlerCount(event?: AutomationEvent): number;
-}
-
-/**
- * Shared Utilities for Automations System
- *
- * Common helper functions used by both the legacy functional API (index.ts)
- * and the new Event Bus handlers (command-handler.ts, prompt-handler.ts).
- */
-
-/**
- * Parse @mentions from a prompt (sources and skills both use @name syntax).
- *
- * Syntax:
- * - @name - references a source or skill (e.g., @linear, @github, @commit, @review-pr)
- *
- * References are case-insensitive and support hyphens (e.g., @my-source, @my-skill).
- * The caller should resolve which mentions are sources vs skills based on available configurations.
- */
-declare function parsePromptReferences(prompt: string): PromptReferences;
-
-interface AutomationRuntimeGuard {
-    shouldDispatch(key: AutomationDispatchKey): boolean;
-    remember(key: AutomationDispatchKey): void;
-}
-interface AutomationDispatchKey {
-    runtimeSessionId: string;
-    automationId: string;
-    prompt: string;
-}
-interface ExecuteAutomationPromptOptions {
-    runtime: AgentRuntime;
-    prompt: PendingPrompt;
-    guard?: AutomationRuntimeGuard;
-}
-interface ExecuteAutomationPromptResult {
-    skipped: boolean;
-    timelineItems: TimelineItem[];
-}
-declare function createAutomationRuntimeGuard(): AutomationRuntimeGuard;
-declare function executeAutomationPrompt(options: ExecuteAutomationPromptOptions): Promise<ExecuteAutomationPromptResult>;
-
-type AutomationInputEventSource = 'timeline' | 'host' | 'policy' | 'source' | 'skill';
-interface AutomationInputEvent {
-    event: string;
-    source: AutomationInputEventSource;
-    sessionId: string;
-    matchValue?: string;
-    payload: unknown;
-    timestamp: number;
-}
-interface AutomationTimelineBridge {
-    handleTimelineEnvelope(envelope: TimelineEnvelope): void;
-}
-interface CreateAutomationTimelineBridgeOptions {
-    publish(event: AutomationInputEvent): void;
-}
-declare function createAutomationTimelineBridge(options: CreateAutomationTimelineBridgeOptions): AutomationTimelineBridge;
-declare function projectTimelineEnvelopeToAutomationInput(envelope: TimelineEnvelope): AutomationInputEvent[];
-
-type AutomationHistoryActionType = 'prompt' | 'webhook' | 'scheduler' | 'metadata';
-type AutomationHistoryStatus = 'success' | 'failed' | 'skipped';
-interface AutomationHistoryRecordInput {
-    matcherId: string;
-    automationName?: string;
-    sessionId?: string;
-    actionType: AutomationHistoryActionType;
-    status: AutomationHistoryStatus;
-    skipped?: boolean;
-    attempt?: number;
-    promptPreview?: string;
-    error?: string;
-    timelineItemCount?: number;
-    metadata?: Record<string, unknown>;
-}
-interface AutomationHistoryRecord extends AutomationHistoryRecordInput {
-    recordId: string;
-    attempt: number;
-    timestamp: number;
-}
-interface AutomationHistoryListFilter {
-    matcherId?: string;
-    sessionId?: string;
-    status?: AutomationHistoryStatus;
-    limit?: number;
-}
-interface AutomationHistoryStore {
-    record(input: AutomationHistoryRecordInput): Promise<AutomationHistoryRecord>;
-    list(filter?: AutomationHistoryListFilter): Promise<AutomationHistoryRecord[]>;
-    getLastExecuted(matcherId: string): Promise<AutomationHistoryRecord | undefined>;
-    getSnapshot(): {
-        records: AutomationHistoryRecord[];
-    };
-}
-interface InMemoryAutomationHistoryStoreOptions {
-    now?: () => number;
-    maxEntries?: number;
-}
-declare function createInMemoryAutomationHistoryStore(options?: InMemoryAutomationHistoryStoreOptions): AutomationHistoryStore;
-declare function automationHistoryInputForPromptResult(prompt: PendingPrompt, result: ExecuteAutomationPromptResult): AutomationHistoryRecordInput;
-interface AutomationScheduleRegistration {
-    schedulerId: string;
-    workspaceId: string;
-    cron: string;
-    timezone: string;
-}
-interface AutomationSchedulerLifecycleReceipt extends AutomationScheduleRegistration {
-    state: 'started' | 'stopped';
-    timestamp: number;
-}
-interface AutomationSchedulerTickOptions {
-    reason?: string;
-}
-interface AutomationSchedulerHost {
-    start(input: AutomationScheduleRegistration): AutomationSchedulerLifecycleReceipt;
-    stop(schedulerId: string): AutomationSchedulerLifecycleReceipt | undefined;
-    tick(schedulerId: string, options?: AutomationSchedulerTickOptions): boolean;
-    getSnapshot(): {
-        schedules: AutomationScheduleRegistration[];
-    };
-}
-interface AutomationSchedulerHostOptions {
-    now?: () => number;
-    publish(event: AutomationInputEvent): void | Promise<void>;
-}
-declare function createAutomationSchedulerHost(options: AutomationSchedulerHostOptions): AutomationSchedulerHost;
-
-interface RuntimeAutomationBridge {
-    handlePromptsReady(prompts: PendingPrompt[]): Promise<ExecuteAutomationPromptResult[]>;
-    dispose(): void;
-}
-interface CreateRuntimeAutomationBridgeOptions {
-    runtime: AgentRuntime;
-    publish(event: AutomationInputEvent): void | Promise<void>;
-    emitTimelineItem?: (item: TimelineItem) => void | Promise<void>;
-    historyStore?: AutomationHistoryStore;
-    guard?: AutomationRuntimeGuard;
-    onError?: (error: Error) => void;
-}
-declare function createRuntimeAutomationBridge(options: CreateRuntimeAutomationBridgeOptions): RuntimeAutomationBridge;
-
-/**
- * Automation Event Logger Stub
- *
- * Provides event logging interface for automations.
- * Stubbed for OSS extraction — the real logger writes to JSONL files.
- */
-interface LoggedAutomationEvent {
-    timestamp: number;
-    /** Event type (renamed from 'type' to match LoggedAutomationEventInput) */
-    event: string;
-    workspaceId: string;
-    sessionId?: string;
-    data?: Record<string, unknown>;
-}
-interface LoggedAutomationEventInput {
-    /** Event name */
-    event: string;
-    workspaceId: string;
-    sessionId?: string;
-    data?: Record<string, unknown>;
-}
-/**
- * Automation Event Logger — stub implementation.
- * The real logger persists events to workspace-scoped JSONL files.
- */
-declare class AutomationEventLogger {
-    /** Callback when an event is lost due to buffer overflow */
-    onEventLost: ((event: LoggedAutomationEvent) => void) | null;
-    constructor(_workspaceRootPath?: string);
-    /**
-     * Log an automation event.
-     * Stub: no persistence in OSS package.
-     */
-    log(input: LoggedAutomationEventInput): void;
-    /**
-     * Get the path to the event log file.
-     * Stub: returns empty string.
-     */
-    getLogPath(): string;
-    /**
-     * Dispose the logger, flushing buffered events.
-     * Stub: no-op.
-     */
-    dispose(): Promise<void>;
-}
-
-/**
- * Automations Schema Definitions
- *
- * Zod schemas for validating automations.json configuration.
- * Extracted from index.ts for better separation of concerns.
- */
-
-declare const TimeConditionSchema: z.ZodObject<{
-    condition: z.ZodLiteral<"time">;
-    after: z.ZodOptional<z.ZodString>;
-    before: z.ZodOptional<z.ZodString>;
-    weekday: z.ZodOptional<z.ZodArray<z.ZodEnum<["mon", "tue", "wed", "thu", "fri", "sat", "sun"]>, "many">>;
-    timezone: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    condition: "time";
-    after?: string | undefined;
-    before?: string | undefined;
-    weekday?: ("mon" | "tue" | "wed" | "thu" | "fri" | "sat" | "sun")[] | undefined;
-    timezone?: string | undefined;
-}, {
-    condition: "time";
-    after?: string | undefined;
-    before?: string | undefined;
-    weekday?: ("mon" | "tue" | "wed" | "thu" | "fri" | "sat" | "sun")[] | undefined;
-    timezone?: string | undefined;
-}>;
-declare const StateConditionSchema: z.ZodEffects<z.ZodObject<{
-    condition: z.ZodLiteral<"state">;
-    field: z.ZodString;
-    value: z.ZodOptional<z.ZodUnknown>;
-    from: z.ZodOptional<z.ZodUnknown>;
-    to: z.ZodOptional<z.ZodUnknown>;
-    contains: z.ZodOptional<z.ZodString>;
-    not_value: z.ZodOptional<z.ZodUnknown>;
-}, "strip", z.ZodTypeAny, {
-    condition: "state";
-    field: string;
-    value?: unknown;
-    from?: unknown;
-    to?: unknown;
-    contains?: string | undefined;
-    not_value?: unknown;
-}, {
-    condition: "state";
-    field: string;
-    value?: unknown;
-    from?: unknown;
-    to?: unknown;
-    contains?: string | undefined;
-    not_value?: unknown;
-}>, {
-    condition: "state";
-    field: string;
-    value?: unknown;
-    from?: unknown;
-    to?: unknown;
-    contains?: string | undefined;
-    not_value?: unknown;
-}, {
-    condition: "state";
-    field: string;
-    value?: unknown;
-    from?: unknown;
-    to?: unknown;
-    contains?: string | undefined;
-    not_value?: unknown;
-}>;
-declare const AutomationConditionSchema: z.ZodType;
-/** All valid event names: canonical events + deprecated aliases. Derived from types.ts. */
-declare const VALID_EVENTS: readonly string[];
-declare const AutomationsConfigSchema: z.ZodEffects<z.ZodObject<{
-    version: z.ZodOptional<z.ZodNumber>;
-    automations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodObject<{
-        id: z.ZodOptional<z.ZodString>;
-        name: z.ZodOptional<z.ZodString>;
-        matcher: z.ZodOptional<z.ZodString>;
-        cron: z.ZodOptional<z.ZodString>;
-        timezone: z.ZodOptional<z.ZodString>;
-        permissionMode: z.ZodOptional<z.ZodEnum<["safe", "ask", "allow-all"]>>;
-        labels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        enabled: z.ZodOptional<z.ZodBoolean>;
-        conditions: z.ZodOptional<z.ZodArray<z.ZodType<any, z.ZodTypeDef, any>, "many">>;
-        telegramTopic: z.ZodOptional<z.ZodString>;
-        actions: z.ZodArray<z.ZodUnion<[z.ZodObject<{
-            type: z.ZodLiteral<"prompt">;
-            prompt: z.ZodString;
-            llmConnection: z.ZodOptional<z.ZodString>;
-            model: z.ZodOptional<z.ZodString>;
-            thinkingLevel: z.ZodOptional<z.ZodEffects<z.ZodEnum<[string, ...string[]]>, "off" | "low" | "medium" | "high" | "xhigh" | "max" | undefined, string>>;
-        }, "strip", z.ZodTypeAny, {
-            prompt: string;
-            type: "prompt";
-            llmConnection?: string | undefined;
-            model?: string | undefined;
-            thinkingLevel?: "off" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-        }, {
-            prompt: string;
-            type: "prompt";
-            llmConnection?: string | undefined;
-            model?: string | undefined;
-            thinkingLevel?: string | undefined;
-        }>, z.ZodObject<{
-            type: z.ZodLiteral<"webhook">;
-            url: z.ZodEffects<z.ZodString, string, string>;
-            method: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "PATCH", "DELETE"]>>;
-            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-            bodyFormat: z.ZodOptional<z.ZodEnum<["json", "form", "raw"]>>;
-            body: z.ZodOptional<z.ZodUnknown>;
-            captureResponse: z.ZodOptional<z.ZodBoolean>;
-            auth: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
-                type: z.ZodLiteral<"basic">;
-                username: z.ZodString;
-                password: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                type: "basic";
-                username: string;
-                password: string;
-            }, {
-                type: "basic";
-                username: string;
-                password: string;
-            }>, z.ZodObject<{
-                type: z.ZodLiteral<"bearer">;
-                token: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                type: "bearer";
-                token: string;
-            }, {
-                type: "bearer";
-                token: string;
-            }>]>>;
-        }, "strip", z.ZodTypeAny, {
-            type: "webhook";
-            url: string;
-            method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
-            headers?: Record<string, string> | undefined;
-            bodyFormat?: "json" | "form" | "raw" | undefined;
-            body?: unknown;
-            captureResponse?: boolean | undefined;
-            auth?: {
-                type: "basic";
-                username: string;
-                password: string;
-            } | {
-                type: "bearer";
-                token: string;
-            } | undefined;
-        }, {
-            type: "webhook";
-            url: string;
-            method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
-            headers?: Record<string, string> | undefined;
-            bodyFormat?: "json" | "form" | "raw" | undefined;
-            body?: unknown;
-            captureResponse?: boolean | undefined;
-            auth?: {
-                type: "basic";
-                username: string;
-                password: string;
-            } | {
-                type: "bearer";
-                token: string;
-            } | undefined;
-        }>, z.ZodObject<{
-            type: z.ZodString;
-        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
-            type: z.ZodString;
-        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
-            type: z.ZodString;
-        }, z.ZodTypeAny, "passthrough">>]>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        actions: ({
-            prompt: string;
-            type: "prompt";
-            llmConnection?: string | undefined;
-            model?: string | undefined;
-            thinkingLevel?: "off" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-        } | {
-            type: "webhook";
-            url: string;
-            method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
-            headers?: Record<string, string> | undefined;
-            bodyFormat?: "json" | "form" | "raw" | undefined;
-            body?: unknown;
-            captureResponse?: boolean | undefined;
-            auth?: {
-                type: "basic";
-                username: string;
-                password: string;
-            } | {
-                type: "bearer";
-                token: string;
-            } | undefined;
-        } | z.objectOutputType<{
-            type: z.ZodString;
-        }, z.ZodTypeAny, "passthrough">)[];
-        timezone?: string | undefined;
-        conditions?: any[] | undefined;
-        id?: string | undefined;
-        name?: string | undefined;
-        matcher?: string | undefined;
-        cron?: string | undefined;
-        permissionMode?: "safe" | "ask" | "allow-all" | undefined;
-        labels?: string[] | undefined;
-        enabled?: boolean | undefined;
-        telegramTopic?: string | undefined;
-    }, {
-        actions: ({
-            prompt: string;
-            type: "prompt";
-            llmConnection?: string | undefined;
-            model?: string | undefined;
-            thinkingLevel?: string | undefined;
-        } | {
-            type: "webhook";
-            url: string;
-            method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
-            headers?: Record<string, string> | undefined;
-            bodyFormat?: "json" | "form" | "raw" | undefined;
-            body?: unknown;
-            captureResponse?: boolean | undefined;
-            auth?: {
-                type: "basic";
-                username: string;
-                password: string;
-            } | {
-                type: "bearer";
-                token: string;
-            } | undefined;
-        } | z.objectInputType<{
-            type: z.ZodString;
-        }, z.ZodTypeAny, "passthrough">)[];
-        timezone?: string | undefined;
-        conditions?: any[] | undefined;
-        id?: string | undefined;
-        name?: string | undefined;
-        matcher?: string | undefined;
-        cron?: string | undefined;
-        permissionMode?: "safe" | "ask" | "allow-all" | undefined;
-        labels?: string[] | undefined;
-        enabled?: boolean | undefined;
-        telegramTopic?: string | undefined;
-    }>, "many">>>;
-}, "strip", z.ZodTypeAny, {
-    version?: number | undefined;
-    automations?: Record<string, {
-        actions: ({
-            prompt: string;
-            type: "prompt";
-            llmConnection?: string | undefined;
-            model?: string | undefined;
-            thinkingLevel?: "off" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-        } | {
-            type: "webhook";
-            url: string;
-            method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
-            headers?: Record<string, string> | undefined;
-            bodyFormat?: "json" | "form" | "raw" | undefined;
-            body?: unknown;
-            captureResponse?: boolean | undefined;
-            auth?: {
-                type: "basic";
-                username: string;
-                password: string;
-            } | {
-                type: "bearer";
-                token: string;
-            } | undefined;
-        } | z.objectOutputType<{
-            type: z.ZodString;
-        }, z.ZodTypeAny, "passthrough">)[];
-        timezone?: string | undefined;
-        conditions?: any[] | undefined;
-        id?: string | undefined;
-        name?: string | undefined;
-        matcher?: string | undefined;
-        cron?: string | undefined;
-        permissionMode?: "safe" | "ask" | "allow-all" | undefined;
-        labels?: string[] | undefined;
-        enabled?: boolean | undefined;
-        telegramTopic?: string | undefined;
-    }[]> | undefined;
-}, {
-    version?: number | undefined;
-    automations?: Record<string, {
-        actions: ({
-            prompt: string;
-            type: "prompt";
-            llmConnection?: string | undefined;
-            model?: string | undefined;
-            thinkingLevel?: string | undefined;
-        } | {
-            type: "webhook";
-            url: string;
-            method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
-            headers?: Record<string, string> | undefined;
-            bodyFormat?: "json" | "form" | "raw" | undefined;
-            body?: unknown;
-            captureResponse?: boolean | undefined;
-            auth?: {
-                type: "basic";
-                username: string;
-                password: string;
-            } | {
-                type: "bearer";
-                token: string;
-            } | undefined;
-        } | z.objectInputType<{
-            type: z.ZodString;
-        }, z.ZodTypeAny, "passthrough">)[];
-        timezone?: string | undefined;
-        conditions?: any[] | undefined;
-        id?: string | undefined;
-        name?: string | undefined;
-        matcher?: string | undefined;
-        cron?: string | undefined;
-        permissionMode?: "safe" | "ask" | "allow-all" | undefined;
-        labels?: string[] | undefined;
-        enabled?: boolean | undefined;
-        telegramTopic?: string | undefined;
-    }[]> | undefined;
-}>, {
-    version: number | undefined;
-    automations: Record<string, {
-        actions: ({
-            prompt: string;
-            type: "prompt";
-            llmConnection?: string | undefined;
-            model?: string | undefined;
-            thinkingLevel?: "off" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-        } | {
-            type: "webhook";
-            url: string;
-            method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
-            headers?: Record<string, string> | undefined;
-            bodyFormat?: "json" | "form" | "raw" | undefined;
-            body?: unknown;
-            captureResponse?: boolean | undefined;
-            auth?: {
-                type: "basic";
-                username: string;
-                password: string;
-            } | {
-                type: "bearer";
-                token: string;
-            } | undefined;
-        } | z.objectOutputType<{
-            type: z.ZodString;
-        }, z.ZodTypeAny, "passthrough">)[];
-        timezone?: string | undefined;
-        conditions?: any[] | undefined;
-        id?: string | undefined;
-        name?: string | undefined;
-        matcher?: string | undefined;
-        cron?: string | undefined;
-        permissionMode?: "safe" | "ask" | "allow-all" | undefined;
-        labels?: string[] | undefined;
-        enabled?: boolean | undefined;
-        telegramTopic?: string | undefined;
-    }[]>;
-}, {
-    version?: number | undefined;
-    automations?: Record<string, {
-        actions: ({
-            prompt: string;
-            type: "prompt";
-            llmConnection?: string | undefined;
-            model?: string | undefined;
-            thinkingLevel?: string | undefined;
-        } | {
-            type: "webhook";
-            url: string;
-            method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
-            headers?: Record<string, string> | undefined;
-            bodyFormat?: "json" | "form" | "raw" | undefined;
-            body?: unknown;
-            captureResponse?: boolean | undefined;
-            auth?: {
-                type: "basic";
-                username: string;
-                password: string;
-            } | {
-                type: "bearer";
-                token: string;
-            } | undefined;
-        } | z.objectInputType<{
-            type: z.ZodString;
-        }, z.ZodTypeAny, "passthrough">)[];
-        timezone?: string | undefined;
-        conditions?: any[] | undefined;
-        id?: string | undefined;
-        name?: string | undefined;
-        matcher?: string | undefined;
-        cron?: string | undefined;
-        permissionMode?: "safe" | "ask" | "allow-all" | undefined;
-        labels?: string[] | undefined;
-        enabled?: boolean | undefined;
-        telegramTopic?: string | undefined;
-    }[]> | undefined;
-}>;
-/**
- * Convert Zod error to ValidationIssues (matches validators.ts pattern)
- */
-declare function zodErrorToIssues(error: z.ZodError, file: string): ValidationIssue[];
-
-/**
- * Automation Condition Evaluator
- *
- * Pure synchronous evaluation engine for automation conditions.
- * Inspired by Home Assistant's condition system.
- *
- * Supports:
- * - time: Time-of-day and day-of-week checks
- * - state: Event payload field checks with HA-style from/to for transitions
- * - and/or/not: Logical composition with short-circuit evaluation
- */
-
-/** Context passed to condition evaluators */
-interface ConditionContext {
-    /** Event payload fields */
-    payload: Record<string, unknown>;
-    /** Injectable current time (for testing) */
-    now?: Date;
-    /** Fallback timezone from the matcher */
-    matcherTimezone?: string;
-}
-/**
- * Evaluate an array of conditions (top-level AND).
- * Returns true if all conditions pass, or if the array is empty/undefined.
- */
-declare function evaluateConditions(conditions: AutomationCondition[], context: ConditionContext): boolean;
-
-/**
- * Security Utilities for Automations
- *
- * Shell sanitization and security-related utilities.
- * Prevents command injection attacks via environment variables.
- */
-/**
- * Sanitize a value for safe use in shell environment variables.
- * Escapes characters that could be used for shell injection.
- *
- * @param value - The string value to sanitize
- * @returns Sanitized string safe for shell environment variables
- *
- * @example
- * sanitizeForShell('$(rm -rf /)') // Returns '\\$(rm -rf /)'
- * sanitizeForShell('`whoami`')    // Returns '\\`whoami\\`'
- */
-declare function sanitizeForShell(value: string): string;
-
-/**
- * Webhook Execution Utilities
- *
- * Shared webhook HTTP execution logic used by both the production WebhookHandler
- * and the RPC test handler. Centralizes timeout, body consumption, request building,
- * env var expansion, and retry logic so the two code paths can't diverge.
- */
-
-/**
- * Create a webhook history entry for appending to the history JSONL file.
- */
-declare function createWebhookHistoryEntry(opts: {
-    matcherId: string;
-    ok: boolean;
-    method?: string;
-    url: string;
-    statusCode: number;
-    durationMs: number;
-    attempts?: number;
-    error?: string;
-    responseBody?: string;
-}): Record<string, unknown>;
-/**
- * Create a prompt-action history entry for appending to the history JSONL file.
- */
-declare function createPromptHistoryEntry(opts: {
-    matcherId: string;
-    ok: boolean;
-    sessionId?: string;
-    prompt?: string;
-    error?: string;
-}): Record<string, unknown>;
-interface RetryConfig {
-    /** Max retry attempts (default: 0 = no retry) */
-    maxAttempts: number;
-    /** Initial delay in ms (default: 1000). Doubles each attempt. */
-    initialDelayMs?: number;
-    /** Max delay cap in ms (default: 10000) */
-    maxDelayMs?: number;
-}
-interface ExecuteWebhookOptions {
-    /** Timeout in milliseconds (default: 30000) */
-    timeoutMs?: number;
-    /** Environment variables for $VAR expansion. If undefined, no expansion is performed (raw mode for tests) */
-    env?: Record<string, string>;
-    /** Retry config for transient failures. Disabled by default. */
-    retry?: RetryConfig;
-}
-/**
- * Execute a single webhook HTTP request.
- *
- * Handles: request building, env var expansion, timeout via AbortController,
- * response body consumption (prevents memory leaks), and error wrapping.
- * Includes durationMs in the result for observability.
- *
- * @param action - The webhook action definition from automations config
- * @param options - Execution options (timeout, env vars for expansion)
- * @returns WebhookActionResult with status, success flag, timing, and any error
- */
-declare function executeWebhookRequest(action: WebhookAction, options?: ExecuteWebhookOptions): Promise<WebhookActionResult>;
-/**
- * Execute a webhook request with optional retry for transient failures.
- *
- * Wraps executeWebhookRequest with exponential backoff + jitter.
- * If retry is not configured (or maxAttempts=0), behaves identically to executeWebhookRequest.
- *
- * @param action - The webhook action definition
- * @param options - Execution options including retry config
- * @returns WebhookActionResult with attempts count and total duration
- */
-declare function executeWithRetry(action: WebhookAction, options?: ExecuteWebhookOptions): Promise<WebhookActionResult>;
-
-/**
- * RetryScheduler - Persistent retry queue for failed webhooks
- *
- * When immediate retries (seconds-scale) are exhausted and a webhook still fails,
- * it's added to a persistent JSONL queue file. The scheduler checks the queue
- * every 60 seconds and retries at increasing intervals:
- *   - 1st deferred: 5 minutes
- *   - 2nd deferred: 30 minutes
- *   - 3rd deferred: 1 hour
- *
- * After all deferred attempts fail, the entry is removed and a final history
- * entry is written. Queue entries survive app restarts.
- */
-
-interface RetryQueueEntry {
-    /** Unique entry ID */
-    id: string;
-    /** Matcher ID (for history correlation) */
-    matcherId: string;
-    /** The webhook action with expanded values (no env vars needed at retry time) */
-    action: WebhookAction;
-    /** Expanded URL (post-env-expansion) for safe logging */
-    expandedUrl: string;
-    /** Number of deferred attempts already made (0 = first deferred pending) */
-    deferredAttempt: number;
-    /** Timestamp when the next retry should happen */
-    nextRetryAt: number;
-    /** Timestamp when this entry was created */
-    createdAt: number;
-    /** Last error message */
-    lastError?: string;
-}
-interface RetrySchedulerOptions {
-    workspaceRootPath: string;
-}
-declare class RetryScheduler {
-    private readonly workspaceRootPath;
-    private timer;
-    private processing;
-    constructor(options: RetrySchedulerOptions);
-    /**
-     * Start the scheduler. Checks queue every minute.
-     */
-    start(): void;
-    /**
-     * Stop the scheduler and clean up.
-     */
-    dispose(): void;
-    /**
-     * Enqueue a failed webhook for deferred retry.
-     * Called by WebhookHandler when immediate retries are exhausted.
-     */
-    enqueue(matcherId: string, action: WebhookAction, expandedUrl: string, lastError?: string): Promise<void>;
-    /**
-     * Process the queue: read entries, retry those that are due, rewrite the queue.
-     */
-    private tick;
-}
-
-/** Canonical config filename */
-declare const AUTOMATIONS_CONFIG_FILE = "automations.json";
-/** History log filename */
-declare const AUTOMATIONS_HISTORY_FILE = "automations-history.jsonl";
-/** Persistent retry queue filename */
-declare const AUTOMATIONS_RETRY_QUEUE_FILE = "automations-retry-queue.jsonl";
-/** Maximum length for string fields written to automations-history.jsonl (error, responseBody, prompt). */
-declare const HISTORY_FIELD_MAX_LENGTH = 2000;
-/** Max history entries retained per automation ID. */
-declare const AUTOMATION_HISTORY_MAX_RUNS_PER_MATCHER = 20;
-/** Max total history entries across all automations (global safety cap). */
-declare const AUTOMATION_HISTORY_MAX_ENTRIES = 1000;
-
-/**
- * History Store — single source of truth for automations-history.jsonl writes
- * and compaction.
- *
- * Provides:
- * - `appendAutomationHistoryEntry()` — serialized append, triggers compaction at the global cap
- * - `compactAutomationHistory()` — async two-tier retention (runtime, under mutex)
- * - `compactAutomationHistorySync()` — sync two-tier retention (startup, no mutex needed)
- *
- * Both sync and async compaction share the same pure algorithm (`compactEntries`).
- * All history writes should go through `appendAutomationHistoryEntry` so the mutex
- * prevents concurrent file corruption.
- */
-/**
- * Append a history entry to the JSONL file.
- * Triggers compaction when appends since startup reach the global cap.
- *
- * The entry must already be a fully-formed history object (use `createWebhookHistoryEntry`
- * or `createPromptHistoryEntry` from `webhook-utils.ts` to build one).
- */
-declare function appendAutomationHistoryEntry(workspaceRootPath: string, entry: Record<string, unknown>): Promise<void>;
-/**
- * Compact the history file asynchronously (runtime path, under mutex).
- */
-declare function compactAutomationHistory(workspaceRootPath: string, maxPerMatcher?: number, maxTotal?: number): Promise<void>;
-/**
- * Compact the history file synchronously (startup path).
- * Safe to call without the mutex — startup is single-threaded and runs
- * before any async appends.
- */
-declare function compactAutomationHistorySync(workspaceRootPath: string, maxPerMatcher?: number, maxTotal?: number): void;
-
-/**
- * Automations Config Path Resolver
- */
-/**
- * Generate a short 6-character hex ID for matcher identification.
- * Uses crypto.randomBytes for uniqueness (24 bits of entropy = 16M possibilities).
- */
-declare function generateShortId(): string;
-/**
- * Resolve the automations config path for a workspace.
- */
-declare function resolveAutomationsConfigPath(workspaceRoot: string): string;
-
-interface LoadAutomationsConfigResult {
-    config: Record<string, unknown> | null;
-    configPath: string;
-}
-interface SaveAutomationsConfigResult {
-    ok: boolean;
-    automationCount: number;
-    errors: string[];
-}
-declare function loadAutomationsConfig(workspaceRootPath: string): LoadAutomationsConfigResult;
-declare function saveAutomationsConfig(workspaceRootPath: string, config: unknown): SaveAutomationsConfigResult;
-
-/**
- * Cron Matching Utilities for Automations
- *
- * Determines if a cron expression matches the current time.
- * Used by SchedulerTick automations to trigger at specific intervals.
- */
-/**
- * Check if a cron expression matches the current time.
- * Uses croner's nextRun to determine if the current minute matches the cron pattern.
- *
- * @param cronExpr - Cron expression in 5-field format (minute hour day-of-month month day-of-week)
- * @param timezone - Optional IANA timezone (e.g., "Europe/Budapest", "America/New_York")
- * @returns true if the cron expression matches the current minute
- *
- * @example
- * matchesCron('* * * * *')                    // Matches every minute
- * matchesCron('0 9 * * *', 'Europe/Budapest') // Matches 9:00 AM Budapest time
- */
-declare function matchesCron(cronExpr: string, timezone?: string): boolean;
-
-/**
- * AutomationHandler Interface and Common Types
- *
- * Defines the contract for all automation handlers in the Event Bus system.
- * Each handler:
- * - Subscribes to relevant events on the bus
- * - Executes its specific logic
- * - Is self-contained and testable in isolation
- */
-
-/**
- * Base interface for all automation handlers.
- * Handlers subscribe to events and process them independently.
- */
-interface AutomationHandler {
-    /** Subscribe to events on the bus */
-    subscribe(bus: EventBus): void;
-    /** Clean up resources and unsubscribe from events */
-    dispose(): void | Promise<void>;
-}
-/** Options for creating a PromptHandler */
-interface PromptHandlerOptions {
-    /** Workspace ID */
-    workspaceId: string;
-    /** Workspace root path for history file location */
-    workspaceRootPath: string;
-    /** Session ID (if executing in a session context) */
-    sessionId?: string;
-    /** Called when prompts are ready to be executed */
-    onPromptsReady?: (prompts: PendingPrompt[]) => void;
-    /** Called when a prompt execution fails */
-    onError?: (event: AutomationEvent, error: Error) => void;
-}
-/** Options for creating an EventLogHandler */
-interface EventLogHandlerOptions {
-    /** Workspace root path for log file location */
-    workspaceRootPath: string;
-    /** Workspace ID for log entries */
-    workspaceId: string;
-    /** Called when logging fails after retries */
-    onEventLost?: (events: string[], error: Error) => void;
-}
-/**
- * Interface for getting automations configuration.
- * Allows handlers to be decoupled from config loading.
- */
-interface AutomationsConfigProvider {
-    /** Get the current automations configuration */
-    getConfig(): AutomationsConfig | null;
-    /** Get matchers for a specific event */
-    getMatchersForEvent(event: AutomationEvent): AutomationMatcher[];
-}
-
-/**
- * PromptHandler - Processes prompt actions for App events
- *
- * Subscribes to App events and collects prompt actions to be executed.
- * Prompts are queued and delivered via callback for the caller to execute.
- */
-
-declare class PromptHandler implements AutomationHandler {
-    private readonly options;
-    private readonly configProvider;
-    private bus;
-    private boundHandler;
-    constructor(options: PromptHandlerOptions, configProvider: AutomationsConfigProvider);
-    /**
-     * Subscribe to App events on the bus.
-     */
-    subscribe(bus: EventBus): void;
-    /**
-     * Handle an event by processing matching prompt actions.
-     */
-    private handleEvent;
-    /**
-     * Clean up resources.
-     */
-    dispose(): void;
-}
-
-/**
- * EventLogHandler - Logs all automation events to events.jsonl
- *
- * Subscribes to all events and logs them for audit trail and replay.
- * Uses the existing AutomationEventLogger for buffered I/O.
- */
-
-declare class EventLogHandler implements AutomationHandler {
-    private readonly options;
-    private readonly logger;
-    private bus;
-    private boundHandler;
-    constructor(options: EventLogHandlerOptions);
-    /**
-     * Subscribe to all events on the bus.
-     */
-    subscribe(bus: EventBus): void;
-    /**
-     * Handle an event by logging it.
-     */
-    private handleEvent;
-    /**
-     * Get the path to the event log file.
-     */
-    getLogPath(): string;
-    /**
-     * Clean up resources.
-     */
-    dispose(): Promise<void>;
-}
-
-/**
- * WebhookHandler - Processes webhook actions for App events
- *
- * Subscribes to App events and executes HTTP webhook requests.
- * Sends requests to configured HTTP/HTTPS endpoints with configurable
- * method, headers, and body format (JSON or raw).
- */
-
-interface WebhookHandlerOptions {
-    /** Workspace ID */
-    workspaceId: string;
-    /** Workspace root path */
-    workspaceRootPath: string;
-    /** Called when webhook results are available */
-    onWebhookResults?: (results: WebhookActionResult[]) => void;
-    /** Called when a webhook execution fails */
-    onError?: (event: AutomationEvent, error: Error) => void;
-}
-declare class WebhookHandler implements AutomationHandler {
-    private readonly options;
-    private readonly configProvider;
-    private readonly rateLimiter;
-    private readonly retryScheduler;
-    private bus;
-    private boundHandler;
-    constructor(options: WebhookHandlerOptions, configProvider: AutomationsConfigProvider);
-    /**
-     * Subscribe to App events on the bus.
-     */
-    subscribe(bus: EventBus): void;
-    /**
-     * Handle an event by processing matching webhook actions.
-     */
-    private handleEvent;
-    /**
-     * Clean up resources.
-     */
-    dispose(): void;
-}
-
-/**
- * AutomationSystem - Unified Facade for the Automations System
- *
- * Single entry point that:
- * - Creates EventBus instance (per workspace)
- * - Creates and registers all handlers
- * - Loads automations.json configuration
- * - Manages scheduler service
- * - Provides diffing for session metadata changes
- * - Provides dispose() for cleanup
- *
- * Benefits:
- * - No global state - each AutomationSystem instance is self-contained
- * - Easy to create for testing
- * - SessionManager uses ~30 lines instead of ~300
- */
-
-interface AutomationSystemOptions {
-    /** Workspace root path (where automations.json lives) */
-    workspaceRootPath: string;
-    /** Workspace ID for logging and events */
-    workspaceId: string;
-    /** Working directory for command execution */
-    workingDir?: string;
-    /** Active source slugs for permission rules */
-    activeSourceSlugs?: string[];
-    /** Whether to start the scheduler service (default: false) */
-    enableScheduler?: boolean;
-    /** Called when prompts are ready to be executed */
-    onPromptsReady?: (prompts: PendingPrompt[]) => void;
-    /** Called when webhook results are available */
-    onWebhookResults?: (results: WebhookActionResult[]) => void;
-    /** Called when an error occurs during automation execution */
-    onError?: (event: AutomationEvent, error: Error) => void;
-    /** Called when events are lost after retries */
-    onEventLost?: (events: string[], error: Error) => void;
-}
-declare class AutomationSystem implements AutomationsConfigProvider {
-    readonly eventBus: WorkspaceEventBus;
-    private readonly options;
-    private config;
-    private promptHandler;
-    private webhookHandler;
-    private eventLogHandler;
-    private scheduler;
-    private disposed;
-    private readonly lastKnownMetadata;
-    constructor(options: AutomationSystemOptions);
-    /**
-     * Read, parse, and validate automations.json. Shared pipeline for loadConfig/reloadConfig.
-     * Returns the raw parsed JSON alongside validation results (avoids re-reading for backfillIds).
-     */
-    private readAndValidateConfig;
-    /**
-     * Load automations configuration from automations.json.
-     */
-    private loadConfig;
-    /**
-     * Reload automations configuration.
-     * Call this when automations.json changes.
-     */
-    reloadConfig(): {
-        success: boolean;
-        automationCount: number;
-        errors: string[];
-    };
-    /**
-     * Backfill missing IDs on matchers in the raw config.
-     * Operates on the already-parsed raw JSON to avoid re-reading from disk.
-     * Only writes if IDs were actually missing — no-op on subsequent loads.
-     */
-    private backfillIds;
-    /**
-     * Compact automations-history.jsonl on startup: two-tier retention.
-     * 1) Keep only the last N entries per automation ID.
-     * 2) If total still exceeds the global cap, drop oldest globally.
-     * Runs synchronously during init — single-threaded, no race with concurrent appends.
-     */
-    private rotateHistory;
-    /**
-     * Get total number of actions.
-     */
-    private getActionCount;
-    getConfig(): AutomationsConfig | null;
-    getMatchersForEvent(event: AutomationEvent): AutomationMatcher[];
-    /**
-     * Create and register all handlers.
-     */
-    private createHandlers;
-    /**
-     * Start the scheduler service.
-     */
-    private startScheduler;
-    /**
-     * Stop the scheduler service.
-     */
-    stopScheduler(): void;
-    /**
-     * Update session metadata and emit events for changes.
-     *
-     * This replaces the diffing logic that was in SessionManager.
-     * Call this whenever session metadata changes.
-     *
-     * @param sessionId - The session ID
-     * @param next - The new metadata snapshot
-     * @returns The events that were emitted
-     */
-    updateSessionMetadata(sessionId: string, next: SessionMetadataSnapshot): Promise<AppEvent[]>;
-    /**
-     * Remove session metadata tracking.
-     * Call this when a session is deleted.
-     */
-    removeSessionMetadata(sessionId: string): void;
-    /**
-     * Get stored metadata for a session.
-     */
-    getSessionMetadata(sessionId: string): SessionMetadataSnapshot | undefined;
-    /**
-     * Set initial metadata for a session (without emitting events).
-     * Call this when loading existing sessions.
-     */
-    setInitialSessionMetadata(sessionId: string, metadata: SessionMetadataSnapshot): void;
-    /**
-     * Emit a LabelConfigChange event.
-     * Call this when labels/config.json changes.
-     */
-    emitLabelConfigChange(): Promise<void>;
-    /**
-     * Emit an event directly (for edge cases).
-     */
-    emit<T extends AutomationEvent>(event: T, payload: EventPayloadMap[T]): Promise<void>;
-    /**
-     * Execute agent event automations directly (without going through the Claude SDK).
-     * This is the backend-agnostic entry point for non-Claude backends (Codex, Copilot, Pi)
-     * to fire agent events from automations.json.
-     *
-     * For each matching automation matcher, builds env vars and evaluates matching.
-     * Command execution has been removed — all automation actions now go through prompt-based
-     * execution (creating agent sessions via PromptHandler).
-     * Catches all errors — automations must never break the agent flow.
-     *
-     * @param signal - Optional AbortSignal for cancelling automation execution on abort
-     * @returns Number of matched matchers (for diagnostics/testing)
-     */
-    executeAgentEvent(event: AgentEvent, input: SdkAutomationInput, signal?: AbortSignal): Promise<number>;
-    /**
-     * Build SDK hook callbacks from automations.json definitions.
-     *
-     * Command execution has been removed — all automation actions now go through prompt-based
-     * execution (creating agent sessions via PromptHandler). Agent event automations are not
-     * currently supported via prompts, so this returns empty.
-     */
-    buildSdkHooks(): Partial<Record<AgentEvent, SdkAutomationCallbackMatcher[]>>;
-    /**
-     * Check if the system has been disposed.
-     */
-    isDisposed(): boolean;
-    /**
-     * Dispose the automation system, cleaning up all resources.
-     */
-    dispose(): Promise<void>;
-}
-
-interface AutoLabelRule {
-    pattern: string;
-    flags?: string;
-    valueTemplate?: string;
-    description?: string;
-}
-interface AutoLabelConfig {
-    labelId: string;
-    rules: AutoLabelRule[];
-}
-interface AutoLabelMatch {
-    labelId: string;
-    value: string;
-    matchedText: string;
-}
-
-declare function evaluateAutoLabels(text: string, configs: AutoLabelConfig[]): AutoLabelMatch[];
-
-declare function normalizeNumberValue(raw: string): string;
-
-interface AutoLabelRuleValidation {
-    errors: string[];
-    warnings: string[];
-}
-declare function validateAutoLabelPattern(pattern: string, flags?: string): AutoLabelRuleValidation;
-
-/**
- * Labels Values Stub
- *
- * Provides label ID extraction used by automations.
- * Stubbed for OSS extraction — the real label utilities are in the main app.
- */
-/**
- * Extract the label ID from a label string.
- * Handles formats like "priority::3" → "priority".
- * Stub: returns the label string itself (no structured labels in OSS package).
- */
-declare function extractLabelId(label: string): string;
-
-export { AGENT_EVENTS, APP_EVENTS, AUTOMATIONS_CONFIG_FILE, AUTOMATIONS_HISTORY_FILE, AUTOMATIONS_RETRY_QUEUE_FILE, AUTOMATION_HISTORY_MAX_ENTRIES, AUTOMATION_HISTORY_MAX_RUNS_PER_MATCHER, type ActionExecutionResult, type AgentEvent, type AnyEventHandler, type AppEvent, type AutoLabelConfig, type AutoLabelMatch, type AutoLabelRule, type AutoLabelRuleValidation, type AutomationAction, type AutomationCondition, AutomationConditionSchema, type AutomationDispatchKey, type AutomationEvent, AutomationEventLogger, type AutomationHandler, type AutomationHistoryActionType, type AutomationHistoryListFilter, type AutomationHistoryRecord, type AutomationHistoryRecordInput, type AutomationHistoryStatus, type AutomationHistoryStore, type AutomationInputEvent, type AutomationInputEventSource, type AutomationMatcher, type AutomationResult, type AutomationRuntimeGuard, type AutomationScheduleRegistration, type AutomationSchedulerHost, type AutomationSchedulerHostOptions, type AutomationSchedulerLifecycleReceipt, type AutomationSchedulerTickOptions, AutomationSystem, type SessionMetadataSnapshot as AutomationSystemMetadataSnapshot, type AutomationSystemOptions, type AutomationTimelineBridge, type AutomationsConfig, type AutomationsConfigDoctorReport, type AutomationsConfigProvider, AutomationsConfigSchema, type AutomationsValidationResult, type BaseEventPayload, type ConditionContext, type CreateAutomationTimelineBridgeOptions, type CreateRuntimeAutomationBridgeOptions, type EventBus, type EventHandler, EventLogHandler, type EventLogHandlerOptions, type EventPayloadMap, type ExecuteAutomationPromptOptions, type ExecuteAutomationPromptResult, type ExecuteWebhookOptions, type FlagChangePayload, type GenericEventPayload, HISTORY_FIELD_MAX_LENGTH, type LabelConfigChangePayload, type LabelEventPayload, type LoadAutomationsConfigResult, type LoggedAutomationEvent, type LoggedAutomationEventInput, type LogicalCondition, type PendingPrompt, type PermissionModeChangePayload, type PromptAction, type PromptActionResult, PromptHandler, type PromptHandlerOptions, type PromptReferences, type RetryConfig, type RetryQueueEntry, RetryScheduler, type RetrySchedulerOptions, type RuntimeAutomationBridge, type SaveAutomationsConfigResult, type SchedulerTickPayload, type SdkAutomationCallback, type SdkAutomationCallbackMatcher, type SdkAutomationInput, type SessionMetadataSnapshot, type SessionStatusChangePayload, type StateCondition, StateConditionSchema, type TimeCondition, TimeConditionSchema, VALID_EVENTS, type WebhookAction, type WebhookActionResult, type WebhookAuth, type WebhookBodyFormat, WebhookHandler, type WebhookHandlerOptions, type WebhookHttpMethod, WorkspaceEventBus, appendAutomationHistoryEntry, automationHistoryInputForPromptResult, buildEnvFromSdkInput, compactAutomationHistory, compactAutomationHistorySync, createAutomationRuntimeGuard, createAutomationSchedulerHost, createAutomationTimelineBridge, createAutomationsConfigDoctorReport, createInMemoryAutomationHistoryStore, createPromptHistoryEntry, createRuntimeAutomationBridge, createWebhookHistoryEntry, evaluateAutoLabels, evaluateConditions, executeAutomationPrompt, executeWebhookRequest, executeWithRetry, extractLabelId, generateShortId, loadAutomationsConfig, matchesCron, normalizeNumberValue, parsePromptReferences, projectTimelineEnvelopeToAutomationInput, resolveAutomationsConfigPath, sanitizeForShell, saveAutomationsConfig, validateAutoLabelPattern, validateAutomations, validateAutomationsConfig, validateAutomationsContent, zodErrorToIssues };