@stina/extension-api 0.20.0 → 0.22.0

package/dist/{chunk-WIDGIYRV.js → chunk-U3PEHSBG.js}

@@ -14,4 +14,4 @@ export {
   __require,
   generateMessageId
 };
-//# sourceMappingURL=chunk-WIDGIYRV.js.map
+//# sourceMappingURL=chunk-U3PEHSBG.js.map

package/dist/chunk-U3PEHSBG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/messages.ts"],"sourcesContent":["/**\n * Message protocol between Extension Host and Extension Workers\n */\n\nimport type {\n  ChatMessage,\n  ChatOptions,\n  GetModelsOptions,\n  StreamEvent,\n  ToolResult,\n  ActionResult,\n  ModelInfo,\n  SchedulerFirePayload,\n} from './types.js'\n\n// ============================================================================\n// Host → Worker Messages\n// ============================================================================\n\nexport type HostToWorkerMessage =\n  | ActivateMessage\n  | DeactivateMessage\n  | SettingsChangedMessage\n  | SchedulerFireMessage\n  | ProviderChatRequestMessage\n  | ProviderModelsRequestMessage\n  | ToolExecuteRequestMessage\n  | ActionExecuteRequestMessage\n  | ResponseMessage\n  | StreamingFetchChunkMessage\n  | BackgroundTaskStartMessage\n  | BackgroundTaskStopMessage\n\nexport interface ActivateMessage {\n  type: 'activate'\n  id: string\n  payload: {\n    extensionId: string\n    extensionVersion: string\n    storagePath: string\n    permissions: string[]\n    settings: Record<string, unknown>\n  }\n}\n\nexport interface DeactivateMessage {\n  type: 'deactivate'\n  id: string\n}\n\nexport interface SettingsChangedMessage {\n  type: 'settings-changed'\n  id: string\n  payload: {\n    key: string\n    value: unknown\n  }\n}\n\nexport interface SchedulerFireMessage {\n  type: 'scheduler-fire'\n  id: string\n  payload: SchedulerFirePayload\n}\n\nexport interface ProviderChatRequestMessage {\n  type: 'provider-chat-request'\n  id: string\n  payload: {\n    providerId: string\n    messages: ChatMessage[]\n    options: ChatOptions\n  }\n}\n\nexport interface ProviderModelsRequestMessage {\n  type: 'provider-models-request'\n  id: string\n  payload: {\n    providerId: string\n    options?: GetModelsOptions\n  }\n}\n\nexport interface ToolExecuteRequestMessage {\n  type: 'tool-execute-request'\n  id: string\n  payload: {\n    toolId: string\n    params: Record<string, unknown>\n    /** User ID if the tool is executed in a user context */\n    userId?: string\n  }\n}\n\nexport interface ActionExecuteRequestMessage {\n  type: 'action-execute-request'\n  id: string\n  payload: {\n    actionId: string\n    params: Record<string, unknown>\n    /** User ID if the action is executed in a user context */\n    userId?: string\n  }\n}\n\nexport interface ResponseMessage {\n  type: 'response'\n  id: string\n  payload: {\n    requestId: string\n    success: boolean\n    data?: unknown\n    error?: string\n  }\n}\n\n/**\n * Message sent from host to worker with streaming fetch data chunks.\n * Used for streaming network responses (e.g., NDJSON streams from Ollama).\n */\nexport interface StreamingFetchChunkMessage {\n  type: 'streaming-fetch-chunk'\n  id: string\n  payload: {\n    requestId: string\n    chunk: string\n    done: boolean\n    error?: string\n  }\n}\n\n/**\n * Message sent from host to worker to start a registered background task.\n */\nexport interface BackgroundTaskStartMessage {\n  type: 'background-task-start'\n  id: string\n  payload: {\n    taskId: string\n  }\n}\n\n/**\n * Message sent from host to worker to stop a running background task.\n */\nexport interface BackgroundTaskStopMessage {\n  type: 'background-task-stop'\n  id: string\n  payload: {\n    taskId: string\n  }\n}\n\n// ============================================================================\n// Worker → Host Messages\n// ============================================================================\n\nexport type WorkerToHostMessage =\n  | ReadyMessage\n  | RequestMessage\n  | ProviderRegisteredMessage\n  | ToolRegisteredMessage\n  | ActionRegisteredMessage\n  | StreamEventMessage\n  | LogMessage\n  | ProviderModelsResponseMessage\n  | ToolExecuteResponseMessage\n  | ActionExecuteResponseMessage\n  | StreamingFetchAckMessage\n  | BackgroundTaskRegisteredMessage\n  | BackgroundTaskStatusMessage\n  | BackgroundTaskHealthMessage\n\nexport interface ReadyMessage {\n  type: 'ready'\n}\n\n/**\n * Message sent from worker to host to acknowledge receipt of a streaming fetch chunk.\n * This enables backpressure control to prevent unbounded memory growth.\n */\nexport interface StreamingFetchAckMessage {\n  type: 'streaming-fetch-ack'\n  payload: {\n    requestId: string\n  }\n}\n\nexport interface RequestMessage {\n  type: 'request'\n  id: string\n  method: RequestMethod\n  payload: unknown\n}\n\nexport type RequestMethod =\n  | 'network.fetch'\n  | 'network.fetch-stream'\n  | 'settings.getAll'\n  | 'settings.get'\n  | 'settings.set'\n  | 'user.getProfile'\n  | 'events.emit'\n  | 'scheduler.schedule'\n  | 'scheduler.cancel'\n  | 'chat.appendInstruction'\n  | 'database.execute'\n  | 'storage.get'\n  | 'storage.set'\n  | 'storage.delete'\n  | 'storage.keys'\n  | 'storage.getForUser'\n  | 'storage.setForUser'\n  | 'storage.deleteForUser'\n  | 'storage.keysForUser'\n\nexport interface ProviderRegisteredMessage {\n  type: 'provider-registered'\n  payload: {\n    id: string\n    name: string\n  }\n}\n\nexport interface ToolRegisteredMessage {\n  type: 'tool-registered'\n  payload: {\n    id: string\n    name: string\n    description: string\n    parameters?: Record<string, unknown>\n  }\n}\n\nexport interface ActionRegisteredMessage {\n  type: 'action-registered'\n  payload: {\n    id: string\n  }\n}\n\nexport interface StreamEventMessage {\n  type: 'stream-event'\n  payload: {\n    requestId: string\n    event: StreamEvent\n  }\n}\n\nexport interface ProviderModelsResponseMessage {\n  type: 'provider-models-response'\n  payload: {\n    requestId: string\n    models: ModelInfo[]\n    error?: string\n  }\n}\n\nexport interface ToolExecuteResponseMessage {\n  type: 'tool-execute-response'\n  payload: {\n    requestId: string\n    result: ToolResult\n    error?: string\n  }\n}\n\nexport interface ActionExecuteResponseMessage {\n  type: 'action-execute-response'\n  payload: {\n    requestId: string\n    result: ActionResult\n    error?: string\n  }\n}\n\nexport interface LogMessage {\n  type: 'log'\n  payload: {\n    level: 'debug' | 'info' | 'warn' | 'error'\n    message: string\n    data?: Record<string, unknown>\n  }\n}\n\n/**\n * Message sent from worker to host when a background task is registered.\n */\nexport interface BackgroundTaskRegisteredMessage {\n  type: 'background-task-registered'\n  payload: {\n    taskId: string\n    name: string\n    userId: string\n    restartPolicy: {\n      type: 'always' | 'on-failure' | 'never'\n      maxRestarts?: number\n      initialDelayMs?: number\n      maxDelayMs?: number\n      backoffMultiplier?: number\n    }\n    payload?: Record<string, unknown>\n  }\n}\n\n/**\n * Message sent from worker to host with background task status updates.\n */\nexport interface BackgroundTaskStatusMessage {\n  type: 'background-task-status'\n  payload: {\n    taskId: string\n    status: 'running' | 'stopped' | 'failed'\n    error?: string\n  }\n}\n\n/**\n * Message sent from worker to host with background task health reports.\n */\nexport interface BackgroundTaskHealthMessage {\n  type: 'background-task-health'\n  payload: {\n    taskId: string\n    status: string\n    timestamp: string\n  }\n}\n\n// ============================================================================\n// Utility Types\n// ============================================================================\n\nexport interface PendingRequest<T = unknown> {\n  resolve: (value: T) => void\n  reject: (error: Error) => void\n  timeout: ReturnType<typeof setTimeout>\n}\n\n/**\n * Generate a unique message ID\n */\nexport function generateMessageId(): string {\n  return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`\n}\n"],"mappings":";;;;;;;;AAuVO,SAAS,oBAA4B;AAC1C,SAAO,GAAG,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,EAAE,CAAC;AACjE;","names":[]}

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/types.localization.ts","../src/messages.ts"],"sourcesContent":["/**\n * @stina/extension-api\n *\n * Types and utilities for building Stina extensions.\n *\n * Extensions should import from this package for type definitions.\n * The runtime (worker-side code) should import from '@stina/extension-api/runtime'.\n */\n\n// Localization\nexport type { LocalizedString } from './types.js'\nexport { resolveLocalizedString } from './types.js'\n\n// Types\nexport type {\n  // Manifest\n  ExtensionManifest,\n  Platform,\n  ExtensionContributions,\n  SettingDefinition,\n  SettingOptionsMapping,\n  SettingCreateMapping,\n  ToolSettingsViewDefinition,\n  ToolSettingsView,\n  ToolSettingsListView,\n  ToolSettingsListMapping,\n  ToolSettingsComponentView,\n  ToolSettingsActionDataSource,\n  PanelDefinition,\n  PanelView,\n  PanelComponentView,\n  PanelActionDataSource,\n  PanelUnknownView,\n  ProviderDefinition,\n  PromptContribution,\n  PromptSection,\n  ToolDefinition,\n  CommandDefinition,\n\n  // Provider Configuration Schema\n  ProviderConfigSchema,\n  ProviderConfigProperty,\n  ProviderConfigPropertyType,\n  ProviderConfigSelectOption,\n  ProviderConfigValidation,\n\n  // Permissions\n  Permission,\n  NetworkPermission,\n  StoragePermission,\n  UserDataPermission,\n  CapabilityPermission,\n  SystemPermission,\n\n  // Context\n  ExtensionContext,\n  Disposable,\n  NetworkAPI,\n  SettingsAPI,\n  ProvidersAPI,\n  ToolsAPI,\n  ActionsAPI,\n  EventsAPI,\n  SchedulerAPI,\n  SchedulerJobRequest,\n  SchedulerSchedule,\n  SchedulerFirePayload,\n  UserAPI,\n  UserProfile,\n  ChatAPI,\n  ChatInstructionMessage,\n  DatabaseAPI,\n  StorageAPI,\n  LogAPI,\n\n  // AI Provider\n  AIProvider,\n  ModelInfo,\n  ChatMessage,\n  ChatOptions,\n  GetModelsOptions,\n  StreamEvent,\n  ToolCall,\n\n  // Tools\n  Tool,\n  ToolResult,\n\n  // Actions\n  Action,\n  ActionResult,\n\n  // Entry point\n  ExtensionModule,\n} from './types.js'\n\n// Messages (for host implementation)\nexport type {\n  HostToWorkerMessage,\n  WorkerToHostMessage,\n  ActivateMessage,\n  DeactivateMessage,\n  SettingsChangedMessage,\n  ProviderChatRequestMessage,\n  ProviderModelsRequestMessage,\n  ToolExecuteRequestMessage,\n  ToolExecuteResponseMessage,\n  ActionExecuteRequestMessage,\n  ActionExecuteResponseMessage,\n  ResponseMessage,\n  ReadyMessage,\n  RequestMessage,\n  RequestMethod,\n  ProviderRegisteredMessage,\n  ToolRegisteredMessage,\n  ActionRegisteredMessage,\n  StreamEventMessage,\n  LogMessage,\n  PendingRequest,\n} from './messages.js'\n\nexport { generateMessageId } from './messages.js'\n\n// Component types (for extension UI components)\nexport type {\n  // Styling\n  AllowedCSSProperty,\n  ExtensionComponentStyle,\n  // Base types\n  ExtensionComponentData,\n  // Iteration & Children\n  ExtensionComponentIterator,\n  ExtensionComponentChildren,\n  // Actions\n  ExtensionActionCall,\n  ExtensionActionRef,\n  // Data Sources & Panel Definition\n  ExtensionDataSource,\n  ExtensionPanelDefinition,\n  // Component Props\n  HeaderProps,\n  LabelProps,\n  ParagraphProps,\n  ButtonProps,\n  TextInputProps,\n  DateTimeInputProps,\n  SelectProps,\n  VerticalStackProps,\n  HorizontalStackProps,\n  GridProps,\n  DividerProps,\n  IconProps,\n  IconButtonType,\n  IconButtonProps,\n  PanelAction,\n  PanelProps,\n  ToggleProps,\n  CollapsibleProps,\n  PillVariant,\n  PillProps,\n  CheckboxProps,\n  MarkdownProps,\n  ModalProps,\n} from './types.components.js'\n","/**\n * Localization Types\n *\n * Types and utilities for localized strings in extensions.\n */\n\n/**\n * A string that can be either a simple string or a map of language codes to localized strings.\n * When a simple string is provided, it's used as the default/fallback value.\n * When a map is provided, the appropriate language is selected at runtime.\n *\n * @example\n * // Simple string (backwards compatible)\n * name: \"Get Weather\"\n *\n * @example\n * // Localized strings\n * name: { en: \"Get Weather\", sv: \"Hämta väder\", de: \"Wetter abrufen\" }\n */\nexport type LocalizedString = string | Record<string, string>\n\n/**\n * Resolves a LocalizedString to an actual string value.\n * @param value The LocalizedString to resolve\n * @param lang The preferred language code (e.g., \"sv\", \"en\")\n * @param fallbackLang The fallback language code (defaults to \"en\")\n * @returns The resolved string value\n */\nexport function resolveLocalizedString(\n  value: LocalizedString,\n  lang: string,\n  fallbackLang = 'en'\n): string {\n  if (typeof value === 'string') {\n    return value\n  }\n  // Try preferred language first, then fallback language, then first available, then empty string\n  return value[lang] ?? value[fallbackLang] ?? Object.values(value)[0] ?? ''\n}\n","/**\n * Message protocol between Extension Host and Extension Workers\n */\n\nimport type {\n  ChatMessage,\n  ChatOptions,\n  GetModelsOptions,\n  StreamEvent,\n  ToolResult,\n  ActionResult,\n  ModelInfo,\n  SchedulerFirePayload,\n} from './types.js'\n\n// ============================================================================\n// Host → Worker Messages\n// ============================================================================\n\nexport type HostToWorkerMessage =\n  | ActivateMessage\n  | DeactivateMessage\n  | SettingsChangedMessage\n  | SchedulerFireMessage\n  | ProviderChatRequestMessage\n  | ProviderModelsRequestMessage\n  | ToolExecuteRequestMessage\n  | ActionExecuteRequestMessage\n  | ResponseMessage\n  | StreamingFetchChunkMessage\n\nexport interface ActivateMessage {\n  type: 'activate'\n  id: string\n  payload: {\n    extensionId: string\n    extensionVersion: string\n    storagePath: string\n    permissions: string[]\n    settings: Record<string, unknown>\n  }\n}\n\nexport interface DeactivateMessage {\n  type: 'deactivate'\n  id: string\n}\n\nexport interface SettingsChangedMessage {\n  type: 'settings-changed'\n  id: string\n  payload: {\n    key: string\n    value: unknown\n  }\n}\n\nexport interface SchedulerFireMessage {\n  type: 'scheduler-fire'\n  id: string\n  payload: SchedulerFirePayload\n}\n\nexport interface ProviderChatRequestMessage {\n  type: 'provider-chat-request'\n  id: string\n  payload: {\n    providerId: string\n    messages: ChatMessage[]\n    options: ChatOptions\n  }\n}\n\nexport interface ProviderModelsRequestMessage {\n  type: 'provider-models-request'\n  id: string\n  payload: {\n    providerId: string\n    options?: GetModelsOptions\n  }\n}\n\nexport interface ToolExecuteRequestMessage {\n  type: 'tool-execute-request'\n  id: string\n  payload: {\n    toolId: string\n    params: Record<string, unknown>\n    /** User ID if the tool is executed in a user context */\n    userId?: string\n  }\n}\n\nexport interface ActionExecuteRequestMessage {\n  type: 'action-execute-request'\n  id: string\n  payload: {\n    actionId: string\n    params: Record<string, unknown>\n    /** User ID if the action is executed in a user context */\n    userId?: string\n  }\n}\n\nexport interface ResponseMessage {\n  type: 'response'\n  id: string\n  payload: {\n    requestId: string\n    success: boolean\n    data?: unknown\n    error?: string\n  }\n}\n\n/**\n * Message sent from host to worker with streaming fetch data chunks.\n * Used for streaming network responses (e.g., NDJSON streams from Ollama).\n */\nexport interface StreamingFetchChunkMessage {\n  type: 'streaming-fetch-chunk'\n  id: string\n  payload: {\n    requestId: string\n    chunk: string\n    done: boolean\n    error?: string\n  }\n}\n\n// ============================================================================\n// Worker → Host Messages\n// ============================================================================\n\nexport type WorkerToHostMessage =\n  | ReadyMessage\n  | RequestMessage\n  | ProviderRegisteredMessage\n  | ToolRegisteredMessage\n  | ActionRegisteredMessage\n  | StreamEventMessage\n  | LogMessage\n  | ProviderModelsResponseMessage\n  | ToolExecuteResponseMessage\n  | ActionExecuteResponseMessage\n  | StreamingFetchAckMessage\n\nexport interface ReadyMessage {\n  type: 'ready'\n}\n\n/**\n * Message sent from worker to host to acknowledge receipt of a streaming fetch chunk.\n * This enables backpressure control to prevent unbounded memory growth.\n */\nexport interface StreamingFetchAckMessage {\n  type: 'streaming-fetch-ack'\n  payload: {\n    requestId: string\n  }\n}\n\nexport interface RequestMessage {\n  type: 'request'\n  id: string\n  method: RequestMethod\n  payload: unknown\n}\n\nexport type RequestMethod =\n  | 'network.fetch'\n  | 'network.fetch-stream'\n  | 'settings.getAll'\n  | 'settings.get'\n  | 'settings.set'\n  | 'user.getProfile'\n  | 'events.emit'\n  | 'scheduler.schedule'\n  | 'scheduler.cancel'\n  | 'chat.appendInstruction'\n  | 'database.execute'\n  | 'storage.get'\n  | 'storage.set'\n  | 'storage.delete'\n  | 'storage.keys'\n  | 'storage.getForUser'\n  | 'storage.setForUser'\n  | 'storage.deleteForUser'\n  | 'storage.keysForUser'\n\nexport interface ProviderRegisteredMessage {\n  type: 'provider-registered'\n  payload: {\n    id: string\n    name: string\n  }\n}\n\nexport interface ToolRegisteredMessage {\n  type: 'tool-registered'\n  payload: {\n    id: string\n    name: string\n    description: string\n    parameters?: Record<string, unknown>\n  }\n}\n\nexport interface ActionRegisteredMessage {\n  type: 'action-registered'\n  payload: {\n    id: string\n  }\n}\n\nexport interface StreamEventMessage {\n  type: 'stream-event'\n  payload: {\n    requestId: string\n    event: StreamEvent\n  }\n}\n\nexport interface ProviderModelsResponseMessage {\n  type: 'provider-models-response'\n  payload: {\n    requestId: string\n    models: ModelInfo[]\n    error?: string\n  }\n}\n\nexport interface ToolExecuteResponseMessage {\n  type: 'tool-execute-response'\n  payload: {\n    requestId: string\n    result: ToolResult\n    error?: string\n  }\n}\n\nexport interface ActionExecuteResponseMessage {\n  type: 'action-execute-response'\n  payload: {\n    requestId: string\n    result: ActionResult\n    error?: string\n  }\n}\n\nexport interface LogMessage {\n  type: 'log'\n  payload: {\n    level: 'debug' | 'info' | 'warn' | 'error'\n    message: string\n    data?: Record<string, unknown>\n  }\n}\n\n// ============================================================================\n// Utility Types\n// ============================================================================\n\nexport interface PendingRequest<T = unknown> {\n  resolve: (value: T) => void\n  reject: (error: Error) => void\n  timeout: ReturnType<typeof setTimeout>\n}\n\n/**\n * Generate a unique message ID\n */\nexport function generateMessageId(): string {\n  return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC4BO,SAAS,uBACd,OACA,MACA,eAAe,MACP;AACR,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,SAAO,MAAM,IAAI,KAAK,MAAM,YAAY,KAAK,OAAO,OAAO,KAAK,EAAE,CAAC,KAAK;AAC1E;;;AC0OO,SAAS,oBAA4B;AAC1C,SAAO,GAAG,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,EAAE,CAAC;AACjE;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/types.localization.ts","../src/messages.ts"],"sourcesContent":["/**\n * @stina/extension-api\n *\n * Types and utilities for building Stina extensions.\n *\n * Extensions should import from this package for type definitions.\n * The runtime (worker-side code) should import from '@stina/extension-api/runtime'.\n */\n\n// Localization\nexport type { LocalizedString } from './types.js'\nexport { resolveLocalizedString } from './types.js'\n\n// Types\nexport type {\n  // Manifest\n  ExtensionManifest,\n  Platform,\n  ExtensionContributions,\n  SettingDefinition,\n  SettingOptionsMapping,\n  SettingCreateMapping,\n  ToolSettingsViewDefinition,\n  ToolSettingsView,\n  ToolSettingsListView,\n  ToolSettingsListMapping,\n  ToolSettingsComponentView,\n  ToolSettingsActionDataSource,\n  PanelDefinition,\n  PanelView,\n  PanelComponentView,\n  PanelActionDataSource,\n  PanelUnknownView,\n  ProviderDefinition,\n  PromptContribution,\n  PromptSection,\n  ToolDefinition,\n  CommandDefinition,\n\n  // Provider Configuration Schema\n  ProviderConfigSchema,\n  ProviderConfigProperty,\n  ProviderConfigPropertyType,\n  ProviderConfigSelectOption,\n  ProviderConfigValidation,\n\n  // Permissions\n  Permission,\n  NetworkPermission,\n  StoragePermission,\n  UserDataPermission,\n  CapabilityPermission,\n  SystemPermission,\n\n  // Context\n  ExtensionContext,\n  Disposable,\n  NetworkAPI,\n  SettingsAPI,\n  ProvidersAPI,\n  ToolsAPI,\n  ActionsAPI,\n  EventsAPI,\n  SchedulerAPI,\n  SchedulerJobRequest,\n  SchedulerSchedule,\n  SchedulerFirePayload,\n  UserAPI,\n  UserProfile,\n  ChatAPI,\n  ChatInstructionMessage,\n  DatabaseAPI,\n  StorageAPI,\n  LogAPI,\n\n  // Background workers\n  BackgroundWorkersAPI,\n  BackgroundTaskConfig,\n  BackgroundTaskCallback,\n  BackgroundTaskContext,\n  BackgroundTaskHealth,\n  BackgroundRestartPolicy,\n\n  // AI Provider\n  AIProvider,\n  ModelInfo,\n  ChatMessage,\n  ChatOptions,\n  GetModelsOptions,\n  StreamEvent,\n  ToolCall,\n\n  // Tools\n  Tool,\n  ToolResult,\n\n  // Actions\n  Action,\n  ActionResult,\n\n  // Entry point\n  ExtensionModule,\n} from './types.js'\n\n// Messages (for host implementation)\nexport type {\n  HostToWorkerMessage,\n  WorkerToHostMessage,\n  ActivateMessage,\n  DeactivateMessage,\n  SettingsChangedMessage,\n  ProviderChatRequestMessage,\n  ProviderModelsRequestMessage,\n  ToolExecuteRequestMessage,\n  ToolExecuteResponseMessage,\n  ActionExecuteRequestMessage,\n  ActionExecuteResponseMessage,\n  ResponseMessage,\n  ReadyMessage,\n  RequestMessage,\n  RequestMethod,\n  ProviderRegisteredMessage,\n  ToolRegisteredMessage,\n  ActionRegisteredMessage,\n  StreamEventMessage,\n  LogMessage,\n  PendingRequest,\n  // Background task messages\n  BackgroundTaskStartMessage,\n  BackgroundTaskStopMessage,\n  BackgroundTaskRegisteredMessage,\n  BackgroundTaskStatusMessage,\n  BackgroundTaskHealthMessage,\n} from './messages.js'\n\nexport { generateMessageId } from './messages.js'\n\n// Component types (for extension UI components)\nexport type {\n  // Styling\n  AllowedCSSProperty,\n  ExtensionComponentStyle,\n  // Base types\n  ExtensionComponentData,\n  // Iteration & Children\n  ExtensionComponentIterator,\n  ExtensionComponentChildren,\n  // Actions\n  ExtensionActionCall,\n  ExtensionActionRef,\n  // Data Sources & Panel Definition\n  ExtensionDataSource,\n  ExtensionPanelDefinition,\n  // Component Props\n  HeaderProps,\n  LabelProps,\n  ParagraphProps,\n  ButtonProps,\n  TextInputProps,\n  DateTimeInputProps,\n  SelectProps,\n  VerticalStackProps,\n  HorizontalStackProps,\n  GridProps,\n  DividerProps,\n  IconProps,\n  IconButtonType,\n  IconButtonProps,\n  PanelAction,\n  PanelProps,\n  ToggleProps,\n  CollapsibleProps,\n  PillVariant,\n  PillProps,\n  CheckboxProps,\n  MarkdownProps,\n  ModalProps,\n  ConditionalGroupProps,\n} from './types.components.js'\n","/**\n * Localization Types\n *\n * Types and utilities for localized strings in extensions.\n */\n\n/**\n * A string that can be either a simple string or a map of language codes to localized strings.\n * When a simple string is provided, it's used as the default/fallback value.\n * When a map is provided, the appropriate language is selected at runtime.\n *\n * @example\n * // Simple string (backwards compatible)\n * name: \"Get Weather\"\n *\n * @example\n * // Localized strings\n * name: { en: \"Get Weather\", sv: \"Hämta väder\", de: \"Wetter abrufen\" }\n */\nexport type LocalizedString = string | Record<string, string>\n\n/**\n * Resolves a LocalizedString to an actual string value.\n * @param value The LocalizedString to resolve\n * @param lang The preferred language code (e.g., \"sv\", \"en\")\n * @param fallbackLang The fallback language code (defaults to \"en\")\n * @returns The resolved string value\n */\nexport function resolveLocalizedString(\n  value: LocalizedString,\n  lang: string,\n  fallbackLang = 'en'\n): string {\n  if (typeof value === 'string') {\n    return value\n  }\n  // Try preferred language first, then fallback language, then first available, then empty string\n  return value[lang] ?? value[fallbackLang] ?? Object.values(value)[0] ?? ''\n}\n","/**\n * Message protocol between Extension Host and Extension Workers\n */\n\nimport type {\n  ChatMessage,\n  ChatOptions,\n  GetModelsOptions,\n  StreamEvent,\n  ToolResult,\n  ActionResult,\n  ModelInfo,\n  SchedulerFirePayload,\n} from './types.js'\n\n// ============================================================================\n// Host → Worker Messages\n// ============================================================================\n\nexport type HostToWorkerMessage =\n  | ActivateMessage\n  | DeactivateMessage\n  | SettingsChangedMessage\n  | SchedulerFireMessage\n  | ProviderChatRequestMessage\n  | ProviderModelsRequestMessage\n  | ToolExecuteRequestMessage\n  | ActionExecuteRequestMessage\n  | ResponseMessage\n  | StreamingFetchChunkMessage\n  | BackgroundTaskStartMessage\n  | BackgroundTaskStopMessage\n\nexport interface ActivateMessage {\n  type: 'activate'\n  id: string\n  payload: {\n    extensionId: string\n    extensionVersion: string\n    storagePath: string\n    permissions: string[]\n    settings: Record<string, unknown>\n  }\n}\n\nexport interface DeactivateMessage {\n  type: 'deactivate'\n  id: string\n}\n\nexport interface SettingsChangedMessage {\n  type: 'settings-changed'\n  id: string\n  payload: {\n    key: string\n    value: unknown\n  }\n}\n\nexport interface SchedulerFireMessage {\n  type: 'scheduler-fire'\n  id: string\n  payload: SchedulerFirePayload\n}\n\nexport interface ProviderChatRequestMessage {\n  type: 'provider-chat-request'\n  id: string\n  payload: {\n    providerId: string\n    messages: ChatMessage[]\n    options: ChatOptions\n  }\n}\n\nexport interface ProviderModelsRequestMessage {\n  type: 'provider-models-request'\n  id: string\n  payload: {\n    providerId: string\n    options?: GetModelsOptions\n  }\n}\n\nexport interface ToolExecuteRequestMessage {\n  type: 'tool-execute-request'\n  id: string\n  payload: {\n    toolId: string\n    params: Record<string, unknown>\n    /** User ID if the tool is executed in a user context */\n    userId?: string\n  }\n}\n\nexport interface ActionExecuteRequestMessage {\n  type: 'action-execute-request'\n  id: string\n  payload: {\n    actionId: string\n    params: Record<string, unknown>\n    /** User ID if the action is executed in a user context */\n    userId?: string\n  }\n}\n\nexport interface ResponseMessage {\n  type: 'response'\n  id: string\n  payload: {\n    requestId: string\n    success: boolean\n    data?: unknown\n    error?: string\n  }\n}\n\n/**\n * Message sent from host to worker with streaming fetch data chunks.\n * Used for streaming network responses (e.g., NDJSON streams from Ollama).\n */\nexport interface StreamingFetchChunkMessage {\n  type: 'streaming-fetch-chunk'\n  id: string\n  payload: {\n    requestId: string\n    chunk: string\n    done: boolean\n    error?: string\n  }\n}\n\n/**\n * Message sent from host to worker to start a registered background task.\n */\nexport interface BackgroundTaskStartMessage {\n  type: 'background-task-start'\n  id: string\n  payload: {\n    taskId: string\n  }\n}\n\n/**\n * Message sent from host to worker to stop a running background task.\n */\nexport interface BackgroundTaskStopMessage {\n  type: 'background-task-stop'\n  id: string\n  payload: {\n    taskId: string\n  }\n}\n\n// ============================================================================\n// Worker → Host Messages\n// ============================================================================\n\nexport type WorkerToHostMessage =\n  | ReadyMessage\n  | RequestMessage\n  | ProviderRegisteredMessage\n  | ToolRegisteredMessage\n  | ActionRegisteredMessage\n  | StreamEventMessage\n  | LogMessage\n  | ProviderModelsResponseMessage\n  | ToolExecuteResponseMessage\n  | ActionExecuteResponseMessage\n  | StreamingFetchAckMessage\n  | BackgroundTaskRegisteredMessage\n  | BackgroundTaskStatusMessage\n  | BackgroundTaskHealthMessage\n\nexport interface ReadyMessage {\n  type: 'ready'\n}\n\n/**\n * Message sent from worker to host to acknowledge receipt of a streaming fetch chunk.\n * This enables backpressure control to prevent unbounded memory growth.\n */\nexport interface StreamingFetchAckMessage {\n  type: 'streaming-fetch-ack'\n  payload: {\n    requestId: string\n  }\n}\n\nexport interface RequestMessage {\n  type: 'request'\n  id: string\n  method: RequestMethod\n  payload: unknown\n}\n\nexport type RequestMethod =\n  | 'network.fetch'\n  | 'network.fetch-stream'\n  | 'settings.getAll'\n  | 'settings.get'\n  | 'settings.set'\n  | 'user.getProfile'\n  | 'events.emit'\n  | 'scheduler.schedule'\n  | 'scheduler.cancel'\n  | 'chat.appendInstruction'\n  | 'database.execute'\n  | 'storage.get'\n  | 'storage.set'\n  | 'storage.delete'\n  | 'storage.keys'\n  | 'storage.getForUser'\n  | 'storage.setForUser'\n  | 'storage.deleteForUser'\n  | 'storage.keysForUser'\n\nexport interface ProviderRegisteredMessage {\n  type: 'provider-registered'\n  payload: {\n    id: string\n    name: string\n  }\n}\n\nexport interface ToolRegisteredMessage {\n  type: 'tool-registered'\n  payload: {\n    id: string\n    name: string\n    description: string\n    parameters?: Record<string, unknown>\n  }\n}\n\nexport interface ActionRegisteredMessage {\n  type: 'action-registered'\n  payload: {\n    id: string\n  }\n}\n\nexport interface StreamEventMessage {\n  type: 'stream-event'\n  payload: {\n    requestId: string\n    event: StreamEvent\n  }\n}\n\nexport interface ProviderModelsResponseMessage {\n  type: 'provider-models-response'\n  payload: {\n    requestId: string\n    models: ModelInfo[]\n    error?: string\n  }\n}\n\nexport interface ToolExecuteResponseMessage {\n  type: 'tool-execute-response'\n  payload: {\n    requestId: string\n    result: ToolResult\n    error?: string\n  }\n}\n\nexport interface ActionExecuteResponseMessage {\n  type: 'action-execute-response'\n  payload: {\n    requestId: string\n    result: ActionResult\n    error?: string\n  }\n}\n\nexport interface LogMessage {\n  type: 'log'\n  payload: {\n    level: 'debug' | 'info' | 'warn' | 'error'\n    message: string\n    data?: Record<string, unknown>\n  }\n}\n\n/**\n * Message sent from worker to host when a background task is registered.\n */\nexport interface BackgroundTaskRegisteredMessage {\n  type: 'background-task-registered'\n  payload: {\n    taskId: string\n    name: string\n    userId: string\n    restartPolicy: {\n      type: 'always' | 'on-failure' | 'never'\n      maxRestarts?: number\n      initialDelayMs?: number\n      maxDelayMs?: number\n      backoffMultiplier?: number\n    }\n    payload?: Record<string, unknown>\n  }\n}\n\n/**\n * Message sent from worker to host with background task status updates.\n */\nexport interface BackgroundTaskStatusMessage {\n  type: 'background-task-status'\n  payload: {\n    taskId: string\n    status: 'running' | 'stopped' | 'failed'\n    error?: string\n  }\n}\n\n/**\n * Message sent from worker to host with background task health reports.\n */\nexport interface BackgroundTaskHealthMessage {\n  type: 'background-task-health'\n  payload: {\n    taskId: string\n    status: string\n    timestamp: string\n  }\n}\n\n// ============================================================================\n// Utility Types\n// ============================================================================\n\nexport interface PendingRequest<T = unknown> {\n  resolve: (value: T) => void\n  reject: (error: Error) => void\n  timeout: ReturnType<typeof setTimeout>\n}\n\n/**\n * Generate a unique message ID\n */\nexport function generateMessageId(): string {\n  return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC4BO,SAAS,uBACd,OACA,MACA,eAAe,MACP;AACR,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AAEA,SAAO,MAAM,IAAI,KAAK,MAAM,YAAY,KAAK,OAAO,OAAO,KAAK,EAAE,CAAC,KAAK;AAC1E;;;ACiTO,SAAS,oBAA4B;AAC1C,SAAO,GAAG,KAAK,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,SAAS,EAAE,EAAE,MAAM,GAAG,EAAE,CAAC;AACjE;","names":[]}

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { E as ExtensionContributions, S as SchedulerFirePayload, C as ChatMessage, a as ChatOptions, G as GetModelsOptions, b as StreamEvent, M as ModelInfo, T as ToolResult, A as ActionResult } from './types.tools-DgCozsOW.cjs';
-export { $ as AIProvider, a2 as Action, J as ActionsAPI, a4 as AllowedCSSProperty, ag as ButtonProps, W as ChatAPI, X as ChatInstructionMessage, ax as CheckboxProps, au as CollapsibleProps, u as CommandDefinition, Y as DatabaseAPI, ai as DateTimeInputProps, D as Disposable, an as DividerProps, K as EventsAPI, a9 as ExtensionActionCall, aa as ExtensionActionRef, a8 as ExtensionComponentChildren, a6 as ExtensionComponentData, a7 as ExtensionComponentIterator, a5 as ExtensionComponentStyle, B as ExtensionContext, ab as ExtensionDataSource, a3 as ExtensionModule, ac as ExtensionPanelDefinition, am as GridProps, ad as HeaderProps, al as HorizontalStackProps, aq as IconButtonProps, ap as IconButtonType, ao as IconProps, ae as LabelProps, L as LocalizedString, _ as LogAPI, ay as MarkdownProps, az as ModalProps, N as NetworkAPI, ar as PanelAction, n as PanelActionDataSource, m as PanelComponentView, P as PanelDefinition, as as PanelProps, o as PanelUnknownView, l as PanelView, af as ParagraphProps, aw as PillProps, av as PillVariant, q as PromptContribution, s as PromptSection, w as ProviderConfigProperty, x as ProviderConfigPropertyType, v as ProviderConfigSchema, y as ProviderConfigSelectOption, z as ProviderConfigValidation, p as ProviderDefinition, H as ProvidersAPI, O as SchedulerAPI, Q as SchedulerJobRequest, R as SchedulerSchedule, aj as SelectProps, e as SettingCreateMapping, c as SettingDefinition, d as SettingOptionsMapping, F as SettingsAPI, Z as StorageAPI, ah as TextInputProps, at as ToggleProps, a1 as Tool, a0 as ToolCall, t as ToolDefinition, k as ToolSettingsActionDataSource, j as ToolSettingsComponentView, i as ToolSettingsListMapping, h as ToolSettingsListView, g as ToolSettingsView, f as ToolSettingsViewDefinition, I as ToolsAPI, U as UserAPI, V as UserProfile, ak as VerticalStackProps, r as resolveLocalizedString } from './types.tools-DgCozsOW.cjs';
+import { E as ExtensionContributions, S as SchedulerFirePayload, C as ChatMessage, a as ChatOptions, G as GetModelsOptions, b as StreamEvent, M as ModelInfo, T as ToolResult, A as ActionResult } from './types.tools-BXGZf8zc.cjs';
+export { a5 as AIProvider, a8 as Action, J as ActionsAPI, aa as AllowedCSSProperty, a4 as BackgroundRestartPolicy, a1 as BackgroundTaskCallback, a0 as BackgroundTaskConfig, a2 as BackgroundTaskContext, a3 as BackgroundTaskHealth, $ as BackgroundWorkersAPI, am as ButtonProps, W as ChatAPI, X as ChatInstructionMessage, aD as CheckboxProps, aA as CollapsibleProps, u as CommandDefinition, aG as ConditionalGroupProps, Y as DatabaseAPI, ao as DateTimeInputProps, D as Disposable, at as DividerProps, K as EventsAPI, af as ExtensionActionCall, ag as ExtensionActionRef, ae as ExtensionComponentChildren, ac as ExtensionComponentData, ad as ExtensionComponentIterator, ab as ExtensionComponentStyle, B as ExtensionContext, ah as ExtensionDataSource, a9 as ExtensionModule, ai as ExtensionPanelDefinition, as as GridProps, aj as HeaderProps, ar as HorizontalStackProps, aw as IconButtonProps, av as IconButtonType, au as IconProps, ak as LabelProps, L as LocalizedString, _ as LogAPI, aE as MarkdownProps, aF as ModalProps, N as NetworkAPI, ax as PanelAction, n as PanelActionDataSource, m as PanelComponentView, P as PanelDefinition, ay as PanelProps, o as PanelUnknownView, l as PanelView, al as ParagraphProps, aC as PillProps, aB as PillVariant, q as PromptContribution, s as PromptSection, w as ProviderConfigProperty, x as ProviderConfigPropertyType, v as ProviderConfigSchema, y as ProviderConfigSelectOption, z as ProviderConfigValidation, p as ProviderDefinition, H as ProvidersAPI, O as SchedulerAPI, Q as SchedulerJobRequest, R as SchedulerSchedule, ap as SelectProps, e as SettingCreateMapping, c as SettingDefinition, d as SettingOptionsMapping, F as SettingsAPI, Z as StorageAPI, an as TextInputProps, az as ToggleProps, a7 as Tool, a6 as ToolCall, t as ToolDefinition, k as ToolSettingsActionDataSource, j as ToolSettingsComponentView, i as ToolSettingsListMapping, h as ToolSettingsListView, g as ToolSettingsView, f as ToolSettingsViewDefinition, I as ToolsAPI, U as UserAPI, V as UserProfile, aq as VerticalStackProps, r as resolveLocalizedString } from './types.tools-BXGZf8zc.cjs';
 
 /**
  * Permission Types
@@ -14,7 +14,7 @@ type StoragePermission = 'database.own' | 'storage.local';
 /** User data permissions */
 type UserDataPermission = 'user.profile.read' | 'user.location.read' | 'chat.history.read' | 'chat.current.read';
 /** Capability permissions */
-type CapabilityPermission = 'provider.register' | 'tools.register' | 'actions.register' | 'settings.register' | 'commands.register' | 'panels.register' | 'events.emit' | 'scheduler.register' | 'chat.message.write';
+type CapabilityPermission = 'provider.register' | 'tools.register' | 'actions.register' | 'settings.register' | 'commands.register' | 'panels.register' | 'events.emit' | 'scheduler.register' | 'chat.message.write' | 'background.workers';
 /** System permissions */
 type SystemPermission = 'files.read' | 'files.write' | 'clipboard.read' | 'clipboard.write';
 
@@ -64,7 +64,7 @@ type Platform = 'web' | 'electron' | 'tui';
  * Message protocol between Extension Host and Extension Workers
  */
 
-type HostToWorkerMessage = ActivateMessage | DeactivateMessage | SettingsChangedMessage | SchedulerFireMessage | ProviderChatRequestMessage | ProviderModelsRequestMessage | ToolExecuteRequestMessage | ActionExecuteRequestMessage | ResponseMessage | StreamingFetchChunkMessage;
+type HostToWorkerMessage = ActivateMessage | DeactivateMessage | SettingsChangedMessage | SchedulerFireMessage | ProviderChatRequestMessage | ProviderModelsRequestMessage | ToolExecuteRequestMessage | ActionExecuteRequestMessage | ResponseMessage | StreamingFetchChunkMessage | BackgroundTaskStartMessage | BackgroundTaskStopMessage;
 interface ActivateMessage {
     type: 'activate';
     id: string;
@@ -154,7 +154,27 @@ interface StreamingFetchChunkMessage {
         error?: string;
     };
 }
-type WorkerToHostMessage = ReadyMessage | RequestMessage | ProviderRegisteredMessage | ToolRegisteredMessage | ActionRegisteredMessage | StreamEventMessage | LogMessage | ProviderModelsResponseMessage | ToolExecuteResponseMessage | ActionExecuteResponseMessage | StreamingFetchAckMessage;
+/**
+ * Message sent from host to worker to start a registered background task.
+ */
+interface BackgroundTaskStartMessage {
+    type: 'background-task-start';
+    id: string;
+    payload: {
+        taskId: string;
+    };
+}
+/**
+ * Message sent from host to worker to stop a running background task.
+ */
+interface BackgroundTaskStopMessage {
+    type: 'background-task-stop';
+    id: string;
+    payload: {
+        taskId: string;
+    };
+}
+type WorkerToHostMessage = ReadyMessage | RequestMessage | ProviderRegisteredMessage | ToolRegisteredMessage | ActionRegisteredMessage | StreamEventMessage | LogMessage | ProviderModelsResponseMessage | ToolExecuteResponseMessage | ActionExecuteResponseMessage | StreamingFetchAckMessage | BackgroundTaskRegisteredMessage | BackgroundTaskStatusMessage | BackgroundTaskHealthMessage;
 interface ReadyMessage {
     type: 'ready';
 }
@@ -236,6 +256,47 @@ interface LogMessage {
         data?: Record<string, unknown>;
     };
 }
+/**
+ * Message sent from worker to host when a background task is registered.
+ */
+interface BackgroundTaskRegisteredMessage {
+    type: 'background-task-registered';
+    payload: {
+        taskId: string;
+        name: string;
+        userId: string;
+        restartPolicy: {
+            type: 'always' | 'on-failure' | 'never';
+            maxRestarts?: number;
+            initialDelayMs?: number;
+            maxDelayMs?: number;
+            backoffMultiplier?: number;
+        };
+        payload?: Record<string, unknown>;
+    };
+}
+/**
+ * Message sent from worker to host with background task status updates.
+ */
+interface BackgroundTaskStatusMessage {
+    type: 'background-task-status';
+    payload: {
+        taskId: string;
+        status: 'running' | 'stopped' | 'failed';
+        error?: string;
+    };
+}
+/**
+ * Message sent from worker to host with background task health reports.
+ */
+interface BackgroundTaskHealthMessage {
+    type: 'background-task-health';
+    payload: {
+        taskId: string;
+        status: string;
+        timestamp: string;
+    };
+}
 interface PendingRequest<T = unknown> {
     resolve: (value: T) => void;
     reject: (error: Error) => void;
@@ -246,4 +307,4 @@ interface PendingRequest<T = unknown> {
  */
 declare function generateMessageId(): string;
 
-export { type ActionExecuteRequestMessage, type ActionExecuteResponseMessage, type ActionRegisteredMessage, ActionResult, type ActivateMessage, type CapabilityPermission, ChatMessage, ChatOptions, type DeactivateMessage, ExtensionContributions, type ExtensionManifest, GetModelsOptions, type HostToWorkerMessage, type LogMessage, ModelInfo, type NetworkPermission, type PendingRequest, type Permission, type Platform, type ProviderChatRequestMessage, type ProviderModelsRequestMessage, type ProviderRegisteredMessage, type ReadyMessage, type RequestMessage, type RequestMethod, type ResponseMessage, SchedulerFirePayload, type SettingsChangedMessage, type StoragePermission, StreamEvent, type StreamEventMessage, type SystemPermission, type ToolExecuteRequestMessage, type ToolExecuteResponseMessage, type ToolRegisteredMessage, ToolResult, type UserDataPermission, type WorkerToHostMessage, generateMessageId };
+export { type ActionExecuteRequestMessage, type ActionExecuteResponseMessage, type ActionRegisteredMessage, ActionResult, type ActivateMessage, type BackgroundTaskHealthMessage, type BackgroundTaskRegisteredMessage, type BackgroundTaskStartMessage, type BackgroundTaskStatusMessage, type BackgroundTaskStopMessage, type CapabilityPermission, ChatMessage, ChatOptions, type DeactivateMessage, ExtensionContributions, type ExtensionManifest, GetModelsOptions, type HostToWorkerMessage, type LogMessage, ModelInfo, type NetworkPermission, type PendingRequest, type Permission, type Platform, type ProviderChatRequestMessage, type ProviderModelsRequestMessage, type ProviderRegisteredMessage, type ReadyMessage, type RequestMessage, type RequestMethod, type ResponseMessage, SchedulerFirePayload, type SettingsChangedMessage, type StoragePermission, StreamEvent, type StreamEventMessage, type SystemPermission, type ToolExecuteRequestMessage, type ToolExecuteResponseMessage, type ToolRegisteredMessage, ToolResult, type UserDataPermission, type WorkerToHostMessage, generateMessageId };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { E as ExtensionContributions, S as SchedulerFirePayload, C as ChatMessage, a as ChatOptions, G as GetModelsOptions, b as StreamEvent, M as ModelInfo, T as ToolResult, A as ActionResult } from './types.tools-DgCozsOW.js';
-export { $ as AIProvider, a2 as Action, J as ActionsAPI, a4 as AllowedCSSProperty, ag as ButtonProps, W as ChatAPI, X as ChatInstructionMessage, ax as CheckboxProps, au as CollapsibleProps, u as CommandDefinition, Y as DatabaseAPI, ai as DateTimeInputProps, D as Disposable, an as DividerProps, K as EventsAPI, a9 as ExtensionActionCall, aa as ExtensionActionRef, a8 as ExtensionComponentChildren, a6 as ExtensionComponentData, a7 as ExtensionComponentIterator, a5 as ExtensionComponentStyle, B as ExtensionContext, ab as ExtensionDataSource, a3 as ExtensionModule, ac as ExtensionPanelDefinition, am as GridProps, ad as HeaderProps, al as HorizontalStackProps, aq as IconButtonProps, ap as IconButtonType, ao as IconProps, ae as LabelProps, L as LocalizedString, _ as LogAPI, ay as MarkdownProps, az as ModalProps, N as NetworkAPI, ar as PanelAction, n as PanelActionDataSource, m as PanelComponentView, P as PanelDefinition, as as PanelProps, o as PanelUnknownView, l as PanelView, af as ParagraphProps, aw as PillProps, av as PillVariant, q as PromptContribution, s as PromptSection, w as ProviderConfigProperty, x as ProviderConfigPropertyType, v as ProviderConfigSchema, y as ProviderConfigSelectOption, z as ProviderConfigValidation, p as ProviderDefinition, H as ProvidersAPI, O as SchedulerAPI, Q as SchedulerJobRequest, R as SchedulerSchedule, aj as SelectProps, e as SettingCreateMapping, c as SettingDefinition, d as SettingOptionsMapping, F as SettingsAPI, Z as StorageAPI, ah as TextInputProps, at as ToggleProps, a1 as Tool, a0 as ToolCall, t as ToolDefinition, k as ToolSettingsActionDataSource, j as ToolSettingsComponentView, i as ToolSettingsListMapping, h as ToolSettingsListView, g as ToolSettingsView, f as ToolSettingsViewDefinition, I as ToolsAPI, U as UserAPI, V as UserProfile, ak as VerticalStackProps, r as resolveLocalizedString } from './types.tools-DgCozsOW.js';
+import { E as ExtensionContributions, S as SchedulerFirePayload, C as ChatMessage, a as ChatOptions, G as GetModelsOptions, b as StreamEvent, M as ModelInfo, T as ToolResult, A as ActionResult } from './types.tools-BXGZf8zc.js';
+export { a5 as AIProvider, a8 as Action, J as ActionsAPI, aa as AllowedCSSProperty, a4 as BackgroundRestartPolicy, a1 as BackgroundTaskCallback, a0 as BackgroundTaskConfig, a2 as BackgroundTaskContext, a3 as BackgroundTaskHealth, $ as BackgroundWorkersAPI, am as ButtonProps, W as ChatAPI, X as ChatInstructionMessage, aD as CheckboxProps, aA as CollapsibleProps, u as CommandDefinition, aG as ConditionalGroupProps, Y as DatabaseAPI, ao as DateTimeInputProps, D as Disposable, at as DividerProps, K as EventsAPI, af as ExtensionActionCall, ag as ExtensionActionRef, ae as ExtensionComponentChildren, ac as ExtensionComponentData, ad as ExtensionComponentIterator, ab as ExtensionComponentStyle, B as ExtensionContext, ah as ExtensionDataSource, a9 as ExtensionModule, ai as ExtensionPanelDefinition, as as GridProps, aj as HeaderProps, ar as HorizontalStackProps, aw as IconButtonProps, av as IconButtonType, au as IconProps, ak as LabelProps, L as LocalizedString, _ as LogAPI, aE as MarkdownProps, aF as ModalProps, N as NetworkAPI, ax as PanelAction, n as PanelActionDataSource, m as PanelComponentView, P as PanelDefinition, ay as PanelProps, o as PanelUnknownView, l as PanelView, al as ParagraphProps, aC as PillProps, aB as PillVariant, q as PromptContribution, s as PromptSection, w as ProviderConfigProperty, x as ProviderConfigPropertyType, v as ProviderConfigSchema, y as ProviderConfigSelectOption, z as ProviderConfigValidation, p as ProviderDefinition, H as ProvidersAPI, O as SchedulerAPI, Q as SchedulerJobRequest, R as SchedulerSchedule, ap as SelectProps, e as SettingCreateMapping, c as SettingDefinition, d as SettingOptionsMapping, F as SettingsAPI, Z as StorageAPI, an as TextInputProps, az as ToggleProps, a7 as Tool, a6 as ToolCall, t as ToolDefinition, k as ToolSettingsActionDataSource, j as ToolSettingsComponentView, i as ToolSettingsListMapping, h as ToolSettingsListView, g as ToolSettingsView, f as ToolSettingsViewDefinition, I as ToolsAPI, U as UserAPI, V as UserProfile, aq as VerticalStackProps, r as resolveLocalizedString } from './types.tools-BXGZf8zc.js';
 
 /**
  * Permission Types
@@ -14,7 +14,7 @@ type StoragePermission = 'database.own' | 'storage.local';
 /** User data permissions */
 type UserDataPermission = 'user.profile.read' | 'user.location.read' | 'chat.history.read' | 'chat.current.read';
 /** Capability permissions */
-type CapabilityPermission = 'provider.register' | 'tools.register' | 'actions.register' | 'settings.register' | 'commands.register' | 'panels.register' | 'events.emit' | 'scheduler.register' | 'chat.message.write';
+type CapabilityPermission = 'provider.register' | 'tools.register' | 'actions.register' | 'settings.register' | 'commands.register' | 'panels.register' | 'events.emit' | 'scheduler.register' | 'chat.message.write' | 'background.workers';
 /** System permissions */
 type SystemPermission = 'files.read' | 'files.write' | 'clipboard.read' | 'clipboard.write';
 
@@ -64,7 +64,7 @@ type Platform = 'web' | 'electron' | 'tui';
  * Message protocol between Extension Host and Extension Workers
  */
 
-type HostToWorkerMessage = ActivateMessage | DeactivateMessage | SettingsChangedMessage | SchedulerFireMessage | ProviderChatRequestMessage | ProviderModelsRequestMessage | ToolExecuteRequestMessage | ActionExecuteRequestMessage | ResponseMessage | StreamingFetchChunkMessage;
+type HostToWorkerMessage = ActivateMessage | DeactivateMessage | SettingsChangedMessage | SchedulerFireMessage | ProviderChatRequestMessage | ProviderModelsRequestMessage | ToolExecuteRequestMessage | ActionExecuteRequestMessage | ResponseMessage | StreamingFetchChunkMessage | BackgroundTaskStartMessage | BackgroundTaskStopMessage;
 interface ActivateMessage {
     type: 'activate';
     id: string;
@@ -154,7 +154,27 @@ interface StreamingFetchChunkMessage {
         error?: string;
     };
 }
-type WorkerToHostMessage = ReadyMessage | RequestMessage | ProviderRegisteredMessage | ToolRegisteredMessage | ActionRegisteredMessage | StreamEventMessage | LogMessage | ProviderModelsResponseMessage | ToolExecuteResponseMessage | ActionExecuteResponseMessage | StreamingFetchAckMessage;
+/**
+ * Message sent from host to worker to start a registered background task.
+ */
+interface BackgroundTaskStartMessage {
+    type: 'background-task-start';
+    id: string;
+    payload: {
+        taskId: string;
+    };
+}
+/**
+ * Message sent from host to worker to stop a running background task.
+ */
+interface BackgroundTaskStopMessage {
+    type: 'background-task-stop';
+    id: string;
+    payload: {
+        taskId: string;
+    };
+}
+type WorkerToHostMessage = ReadyMessage | RequestMessage | ProviderRegisteredMessage | ToolRegisteredMessage | ActionRegisteredMessage | StreamEventMessage | LogMessage | ProviderModelsResponseMessage | ToolExecuteResponseMessage | ActionExecuteResponseMessage | StreamingFetchAckMessage | BackgroundTaskRegisteredMessage | BackgroundTaskStatusMessage | BackgroundTaskHealthMessage;
 interface ReadyMessage {
     type: 'ready';
 }
@@ -236,6 +256,47 @@ interface LogMessage {
         data?: Record<string, unknown>;
     };
 }
+/**
+ * Message sent from worker to host when a background task is registered.
+ */
+interface BackgroundTaskRegisteredMessage {
+    type: 'background-task-registered';
+    payload: {
+        taskId: string;
+        name: string;
+        userId: string;
+        restartPolicy: {
+            type: 'always' | 'on-failure' | 'never';
+            maxRestarts?: number;
+            initialDelayMs?: number;
+            maxDelayMs?: number;
+            backoffMultiplier?: number;
+        };
+        payload?: Record<string, unknown>;
+    };
+}
+/**
+ * Message sent from worker to host with background task status updates.
+ */
+interface BackgroundTaskStatusMessage {
+    type: 'background-task-status';
+    payload: {
+        taskId: string;
+        status: 'running' | 'stopped' | 'failed';
+        error?: string;
+    };
+}
+/**
+ * Message sent from worker to host with background task health reports.
+ */
+interface BackgroundTaskHealthMessage {
+    type: 'background-task-health';
+    payload: {
+        taskId: string;
+        status: string;
+        timestamp: string;
+    };
+}
 interface PendingRequest<T = unknown> {
     resolve: (value: T) => void;
     reject: (error: Error) => void;
@@ -246,4 +307,4 @@ interface PendingRequest<T = unknown> {
  */
 declare function generateMessageId(): string;
 
-export { type ActionExecuteRequestMessage, type ActionExecuteResponseMessage, type ActionRegisteredMessage, ActionResult, type ActivateMessage, type CapabilityPermission, ChatMessage, ChatOptions, type DeactivateMessage, ExtensionContributions, type ExtensionManifest, GetModelsOptions, type HostToWorkerMessage, type LogMessage, ModelInfo, type NetworkPermission, type PendingRequest, type Permission, type Platform, type ProviderChatRequestMessage, type ProviderModelsRequestMessage, type ProviderRegisteredMessage, type ReadyMessage, type RequestMessage, type RequestMethod, type ResponseMessage, SchedulerFirePayload, type SettingsChangedMessage, type StoragePermission, StreamEvent, type StreamEventMessage, type SystemPermission, type ToolExecuteRequestMessage, type ToolExecuteResponseMessage, type ToolRegisteredMessage, ToolResult, type UserDataPermission, type WorkerToHostMessage, generateMessageId };
+export { type ActionExecuteRequestMessage, type ActionExecuteResponseMessage, type ActionRegisteredMessage, ActionResult, type ActivateMessage, type BackgroundTaskHealthMessage, type BackgroundTaskRegisteredMessage, type BackgroundTaskStartMessage, type BackgroundTaskStatusMessage, type BackgroundTaskStopMessage, type CapabilityPermission, ChatMessage, ChatOptions, type DeactivateMessage, ExtensionContributions, type ExtensionManifest, GetModelsOptions, type HostToWorkerMessage, type LogMessage, ModelInfo, type NetworkPermission, type PendingRequest, type Permission, type Platform, type ProviderChatRequestMessage, type ProviderModelsRequestMessage, type ProviderRegisteredMessage, type ReadyMessage, type RequestMessage, type RequestMethod, type ResponseMessage, SchedulerFirePayload, type SettingsChangedMessage, type StoragePermission, StreamEvent, type StreamEventMessage, type SystemPermission, type ToolExecuteRequestMessage, type ToolExecuteResponseMessage, type ToolRegisteredMessage, ToolResult, type UserDataPermission, type WorkerToHostMessage, generateMessageId };

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   generateMessageId
-} from "./chunk-WIDGIYRV.js";
+} from "./chunk-U3PEHSBG.js";
 
 // src/types.localization.ts
 function resolveLocalizedString(value, lang, fallbackLang = "en") {

package/dist/runtime.cjs

@@ -24,6 +24,164 @@ __export(runtime_exports, {
 });
 module.exports = __toCommonJS(runtime_exports);
 
+// src/background.ts
+var WorkerBackgroundTaskManager = class {
+  tasks = /* @__PURE__ */ new Map();
+  options;
+  constructor(options) {
+    this.options = options;
+  }
+  /**
+   * Register and start a background task.
+   * @returns A disposable that stops the task when disposed
+   */
+  async start(config, callback) {
+    const { id: taskId } = config;
+    if (this.tasks.has(taskId)) {
+      throw new Error(`Background task with id '${taskId}' is already registered`);
+    }
+    const task = {
+      config,
+      callback,
+      abortController: null,
+      status: "pending"
+    };
+    this.tasks.set(taskId, task);
+    this.options.sendTaskRegistered(
+      taskId,
+      config.name,
+      config.userId,
+      config.restartPolicy,
+      config.payload
+    );
+    return {
+      dispose: () => {
+        this.stop(taskId);
+      }
+    };
+  }
+  /**
+   * Stop a running task.
+   */
+  stop(taskId) {
+    const task = this.tasks.get(taskId);
+    if (!task) {
+      return;
+    }
+    if (task.abortController) {
+      task.abortController.abort();
+      task.abortController = null;
+    }
+    task.status = "stopped";
+    this.options.sendTaskStatus(taskId, "stopped");
+  }
+  /**
+   * Handle start message from host.
+   * This is called when the host tells us to actually run the task.
+   */
+  async handleStart(taskId) {
+    const task = this.tasks.get(taskId);
+    if (!task) {
+      return;
+    }
+    if (task.abortController) {
+      task.abortController.abort();
+      task.abortController = null;
+    }
+    task.abortController = new AbortController();
+    task.status = "running";
+    task.error = void 0;
+    const context = this.buildTaskContext(task);
+    this.options.sendTaskStatus(taskId, "running");
+    try {
+      await task.callback(context);
+      if (task.abortController?.signal.aborted) {
+        task.status = "stopped";
+        this.options.sendTaskStatus(taskId, "stopped");
+      } else {
+        task.status = "stopped";
+        this.options.sendTaskStatus(taskId, "stopped");
+      }
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      task.status = "failed";
+      task.error = errorMessage;
+      this.options.sendTaskStatus(taskId, "failed", errorMessage);
+    } finally {
+      task.abortController = null;
+    }
+  }
+  /**
+   * Handle stop message from host.
+   */
+  handleStop(taskId) {
+    this.stop(taskId);
+  }
+  /**
+   * Build the execution context for a task.
+   */
+  buildTaskContext(task) {
+    const { config, abortController } = task;
+    const signal = abortController.signal;
+    const log = this.options.createLogAPI(config.id);
+    const context = {
+      userId: config.userId,
+      extension: {
+        id: this.options.extensionId,
+        version: this.options.extensionVersion,
+        storagePath: this.options.storagePath
+      },
+      signal,
+      reportHealth: (status) => {
+        const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+        task.lastHealthStatus = status;
+        task.lastHealthTime = timestamp;
+        this.options.sendHealthReport(config.id, status, timestamp);
+      },
+      log
+    };
+    return context;
+  }
+  /**
+   * Get the status of all tasks.
+   */
+  getStatus() {
+    const result = [];
+    for (const task of this.tasks.values()) {
+      result.push({
+        taskId: task.config.id,
+        name: task.config.name,
+        userId: task.config.userId,
+        status: task.status,
+        restartCount: 0,
+        // Worker doesn't track restarts, host does
+        lastHealthStatus: task.lastHealthStatus,
+        lastHealthTime: task.lastHealthTime,
+        error: task.error
+      });
+    }
+    return result;
+  }
+  /**
+   * Check if a task exists.
+   */
+  hasTask(taskId) {
+    return this.tasks.has(taskId);
+  }
+  /**
+   * Clean up all tasks.
+   * Called during extension deactivation.
+   */
+  dispose() {
+    for (const task of this.tasks.values()) {
+      if (task.abortController) {
+        task.abortController.abort();
+      }
+    }
+    this.tasks.clear();
+  }
+};
+
 // src/messages.ts
 function generateMessageId() {
   return `${Date.now()}-${Math.random().toString(36).slice(2, 11)}`;
@@ -51,6 +209,7 @@ var messagePort = getMessagePort();
 var extensionModule = null;
 var extensionDisposable = null;
 var extensionContext = null;
+var backgroundTaskManager = null;
 var pendingRequests = /* @__PURE__ */ new Map();
 var registeredProviders = /* @__PURE__ */ new Map();
 var registeredTools = /* @__PURE__ */ new Map();
@@ -110,6 +269,12 @@ async function handleHostMessage(message) {
     case "streaming-fetch-chunk":
       handleStreamingFetchChunk(message.payload);
       break;
+    case "background-task-start":
+      await handleBackgroundTaskStart(message.payload.taskId);
+      break;
+    case "background-task-stop":
+      handleBackgroundTaskStop(message.payload.taskId);
+      break;
   }
 }
 function handleStreamingFetchChunk(payload) {
@@ -170,12 +335,16 @@ async function handleDeactivate() {
     if (extensionDisposable) {
       extensionDisposable.dispose();
     }
+    if (backgroundTaskManager) {
+      backgroundTaskManager.dispose();
+    }
   } catch (error) {
     console.error("Error during deactivation:", error);
   } finally {
     extensionModule = null;
     extensionDisposable = null;
     extensionContext = null;
+    backgroundTaskManager = null;
     registeredProviders.clear();
     registeredTools.clear();
     registeredActions.clear();
@@ -210,6 +379,20 @@ async function handleSchedulerFire(payload) {
     }
   });
 }
+async function handleBackgroundTaskStart(taskId) {
+  if (!backgroundTaskManager) {
+    console.error("Background task manager not initialized");
+    return;
+  }
+  await backgroundTaskManager.handleStart(taskId);
+}
+function handleBackgroundTaskStop(taskId) {
+  if (!backgroundTaskManager) {
+    console.error("Background task manager not initialized");
+    return;
+  }
+  backgroundTaskManager.handleStop(taskId);
+}
 async function handleProviderChatRequest(requestId, payload) {
   const provider = registeredProviders.get(payload.providerId);
   if (!provider) {
@@ -613,6 +796,65 @@ function buildContext(extensionId, extensionVersion, storagePath, permissions) {
     };
     context.storage = storageApi;
   }
+  if (hasPermission("background.workers")) {
+    if (!backgroundTaskManager) {
+      backgroundTaskManager = new WorkerBackgroundTaskManager({
+        extensionId,
+        extensionVersion,
+        storagePath,
+        sendTaskRegistered: (taskId, name, userId, restartPolicy, payload) => {
+          postMessage({
+            type: "background-task-registered",
+            payload: {
+              taskId,
+              name,
+              userId,
+              restartPolicy,
+              payload
+            }
+          });
+        },
+        sendTaskStatus: (taskId, status, error) => {
+          postMessage({
+            type: "background-task-status",
+            payload: {
+              taskId,
+              status,
+              error
+            }
+          });
+        },
+        sendHealthReport: (taskId, status, timestamp) => {
+          postMessage({
+            type: "background-task-health",
+            payload: {
+              taskId,
+              status,
+              timestamp
+            }
+          });
+        },
+        createLogAPI: (taskId) => ({
+          debug: (message, data) => postMessage({ type: "log", payload: { level: "debug", message: `[${taskId}] ${message}`, data } }),
+          info: (message, data) => postMessage({ type: "log", payload: { level: "info", message: `[${taskId}] ${message}`, data } }),
+          warn: (message, data) => postMessage({ type: "log", payload: { level: "warn", message: `[${taskId}] ${message}`, data } }),
+          error: (message, data) => postMessage({ type: "log", payload: { level: "error", message: `[${taskId}] ${message}`, data } })
+        })
+      });
+    }
+    const backgroundWorkersApi = {
+      async start(config, callback) {
+        return backgroundTaskManager.start(config, callback);
+      },
+      async stop(taskId) {
+        backgroundTaskManager.stop(taskId);
+      },
+      async getStatus() {
+        return backgroundTaskManager.getStatus();
+      }
+    };
+    context.backgroundWorkers = backgroundWorkersApi;
+  }
   return context;
 }
 function initializeExtension(module2) {