@stina/extension-api 1.3.1 → 1.7.0

package/dist/{chunk-ZB7GJUPS.js → chunk-S3YP4QPF.js}

@@ -6,4 +6,4 @@ function generateMessageId() {
 export {
   generateMessageId
 };
-//# sourceMappingURL=chunk-ZB7GJUPS.js.map
+//# sourceMappingURL=chunk-S3YP4QPF.js.map

package/dist/{chunk-ZB7GJUPS.js.map → chunk-S3YP4QPF.js.map}

@@ -1 +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  VoiceSessionOptions,\n  VoiceSessionDescriptor,\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  | ProviderVoiceSessionRequestMessage\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 ProviderVoiceSessionRequestMessage {\n  type: 'provider-voice-session-request'\n  id: string\n  payload: {\n    providerId: string\n    /**\n     * `signal` is dropped on the way across: an AbortSignal cannot be\n     * structured-cloned into a worker. Cancellation is handled by the host\n     * rejecting the pending request instead.\n     */\n    options: Omit<VoiceSessionOptions, 'signal'>\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  | ProviderVoiceSessionResponseMessage\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  | 'user.listIds'\n  | 'events.emit'\n  | 'scheduler.schedule'\n  | 'scheduler.cancel'\n  | 'scheduler.reportFireResult'\n  | 'chat.appendInstruction'\n  | 'database.execute'\n  // Simple key-value storage methods\n  | 'storage.set'\n  | 'storage.keys'\n  | 'storage.setForUser'\n  | 'storage.keysForUser'\n  // Collection-based storage methods\n  | 'storage.put'\n  | 'storage.get'\n  | 'storage.delete'\n  | 'storage.find'\n  | 'storage.findOne'\n  | 'storage.count'\n  | 'storage.putMany'\n  | 'storage.deleteMany'\n  | 'storage.dropCollection'\n  | 'storage.listCollections'\n  | 'storage.putForUser'\n  | 'storage.getForUser'\n  | 'storage.deleteForUser'\n  | 'storage.findForUser'\n  | 'storage.findOneForUser'\n  | 'storage.countForUser'\n  | 'storage.putManyForUser'\n  | 'storage.deleteManyForUser'\n  | 'storage.dropCollectionForUser'\n  | 'storage.listCollectionsForUser'\n  // Secrets methods\n  | 'secrets.set'\n  | 'secrets.get'\n  | 'secrets.delete'\n  | 'secrets.list'\n  | 'secrets.setForUser'\n  | 'secrets.getForUser'\n  | 'secrets.deleteForUser'\n  | 'secrets.listForUser'\n  // Tools cross-extension methods\n  | 'tools.list'\n  | 'tools.execute'\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 ProviderVoiceSessionResponseMessage {\n  type: 'provider-voice-session-response'\n  payload: {\n    requestId: string\n    /** Absent when `error` is set. */\n    descriptor?: VoiceSessionDescriptor\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' | 'completed' | '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":";AAmZO,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/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  VoiceSessionOptions,\n  VoiceSessionDescriptor,\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  | ProviderVoiceSessionRequestMessage\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 ProviderVoiceSessionRequestMessage {\n  type: 'provider-voice-session-request'\n  id: string\n  payload: {\n    providerId: string\n    /**\n     * `signal` is dropped on the way across: an AbortSignal cannot be\n     * structured-cloned into a worker. Cancellation is handled by the host\n     * rejecting the pending request instead.\n     */\n    options: Omit<VoiceSessionOptions, 'signal'>\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  | ProviderVoiceSessionResponseMessage\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  | 'user.listIds'\n  | 'events.emit'\n  | 'scheduler.schedule'\n  | 'scheduler.cancel'\n  | 'scheduler.reportFireResult'\n  | 'chat.appendInstruction'\n  | 'database.execute'\n  // Simple key-value storage methods\n  | 'storage.set'\n  | 'storage.keys'\n  | 'storage.setForUser'\n  | 'storage.keysForUser'\n  // Collection-based storage methods\n  | 'storage.put'\n  | 'storage.get'\n  | 'storage.delete'\n  | 'storage.find'\n  | 'storage.findOne'\n  | 'storage.count'\n  | 'storage.putMany'\n  | 'storage.deleteMany'\n  | 'storage.dropCollection'\n  | 'storage.listCollections'\n  | 'storage.putForUser'\n  | 'storage.getForUser'\n  | 'storage.deleteForUser'\n  | 'storage.findForUser'\n  | 'storage.findOneForUser'\n  | 'storage.countForUser'\n  | 'storage.putManyForUser'\n  | 'storage.deleteManyForUser'\n  | 'storage.dropCollectionForUser'\n  | 'storage.listCollectionsForUser'\n  // Secrets methods\n  | 'secrets.set'\n  | 'secrets.get'\n  | 'secrets.delete'\n  | 'secrets.list'\n  | 'secrets.setForUser'\n  | 'secrets.getForUser'\n  | 'secrets.deleteForUser'\n  | 'secrets.listForUser'\n  // Tools cross-extension methods\n  | 'tools.list'\n  | 'tools.execute'\n  // Attachments\n  | 'attachments.read'\n  // Connected accounts\n  | 'accounts.list'\n  | 'accounts.getAccessToken'\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 ProviderVoiceSessionResponseMessage {\n  type: 'provider-voice-session-response'\n  payload: {\n    requestId: string\n    /** Absent when `error` is set. */\n    descriptor?: VoiceSessionDescriptor\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' | 'completed' | '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":";AAwZO,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  ToolSettingsViewDefinition,\n  ToolSettingsView,\n  ToolSettingsListView,\n  ToolSettingsListMapping,\n  ToolSettingsComponentView,\n  ToolSettingsActionDataSource,\n  PanelDefinition,\n  StatusCardDefinition,\n  PanelView,\n  PanelComponentView,\n  PanelActionDataSource,\n  PanelUnknownView,\n  ProviderDefinition,\n  ProviderConfigView,\n  PromptContribution,\n  PromptSection,\n  ToolDefinition,\n  ToolConfirmationConfig,\n  CommandDefinition,\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  ConversationPresentation,\n  LogAPI,\n\n  // Background workers\n  BackgroundWorkersAPI,\n  BackgroundTaskConfig,\n  BackgroundTaskCallback,\n  BackgroundTaskContext,\n  BackgroundTaskHealth,\n  BackgroundRestartPolicy,\n\n  // Storage and Secrets\n  Query,\n  QueryOptions,\n  StorageAPI,\n  SecretsAPI,\n  StorageCollectionConfig,\n  StorageContributions,\n\n  // AI Provider\n  AIProvider,\n  ModelInfo,\n  ModelCapabilities,\n  ChatMessage,\n  ChatImage,\n  ChatOptions,\n  GetModelsOptions,\n  StreamEvent,\n  ToolCall,\n\n  // Duplex voice\n  VoiceSessionOptions,\n  VoiceSessionDescriptor,\n  VoiceTransportRequest,\n\n  // Tools\n  Tool,\n  ToolResult,\n  ToolAttachment,\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  // Icon Names\n  HugeIconName,\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  ClockProps,\n  ParagraphProps,\n  ButtonProps,\n  TextInputProps,\n  PasswordInputProps,\n  NumberInputProps,\n  TextAreaProps,\n  DateTimeInputProps,\n  SelectProps,\n  IconPickerProps,\n  VerticalStackProps,\n  HorizontalStackProps,\n  GridProps,\n  DividerProps,\n  IconProps,\n  IconButtonType,\n  IconButtonProps,\n  PanelAction,\n  PanelProps,\n  ToggleProps,\n  CollapsibleProps,\n  FrameVariant,\n  FrameProps,\n  ListProps,\n  PillVariant,\n  PillProps,\n  CheckboxProps,\n  MarkdownProps,\n  TextPreviewProps,\n  ModalProps,\n  ConditionalGroupProps,\n  // Purpose-built display components\n  WeatherCondition,\n  WeatherWind,\n  WeatherNowProps,\n  WeatherForecastStep,\n  WeatherForecastProps,\n  ChartKind,\n  ChartSeries,\n  ChartProps,\n  StatTrend,\n  StatTileProps,\n  ProgressShape,\n  ProgressColor,\n  ProgressBarProps,\n  KeyValueRow,\n  KeyValueListProps,\n  TimelineVariant,\n  TimelineEntry,\n  TimelineProps,\n  NoteVariant,\n  NoteProps,\n  CalendarEventStatus,\n  CalendarEventProps,\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  VoiceSessionOptions,\n  VoiceSessionDescriptor,\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  | ProviderVoiceSessionRequestMessage\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 ProviderVoiceSessionRequestMessage {\n  type: 'provider-voice-session-request'\n  id: string\n  payload: {\n    providerId: string\n    /**\n     * `signal` is dropped on the way across: an AbortSignal cannot be\n     * structured-cloned into a worker. Cancellation is handled by the host\n     * rejecting the pending request instead.\n     */\n    options: Omit<VoiceSessionOptions, 'signal'>\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  | ProviderVoiceSessionResponseMessage\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  | 'user.listIds'\n  | 'events.emit'\n  | 'scheduler.schedule'\n  | 'scheduler.cancel'\n  | 'scheduler.reportFireResult'\n  | 'chat.appendInstruction'\n  | 'database.execute'\n  // Simple key-value storage methods\n  | 'storage.set'\n  | 'storage.keys'\n  | 'storage.setForUser'\n  | 'storage.keysForUser'\n  // Collection-based storage methods\n  | 'storage.put'\n  | 'storage.get'\n  | 'storage.delete'\n  | 'storage.find'\n  | 'storage.findOne'\n  | 'storage.count'\n  | 'storage.putMany'\n  | 'storage.deleteMany'\n  | 'storage.dropCollection'\n  | 'storage.listCollections'\n  | 'storage.putForUser'\n  | 'storage.getForUser'\n  | 'storage.deleteForUser'\n  | 'storage.findForUser'\n  | 'storage.findOneForUser'\n  | 'storage.countForUser'\n  | 'storage.putManyForUser'\n  | 'storage.deleteManyForUser'\n  | 'storage.dropCollectionForUser'\n  | 'storage.listCollectionsForUser'\n  // Secrets methods\n  | 'secrets.set'\n  | 'secrets.get'\n  | 'secrets.delete'\n  | 'secrets.list'\n  | 'secrets.setForUser'\n  | 'secrets.getForUser'\n  | 'secrets.deleteForUser'\n  | 'secrets.listForUser'\n  // Tools cross-extension methods\n  | 'tools.list'\n  | 'tools.execute'\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 ProviderVoiceSessionResponseMessage {\n  type: 'provider-voice-session-response'\n  payload: {\n    requestId: string\n    /** Absent when `error` is set. */\n    descriptor?: VoiceSessionDescriptor\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' | 'completed' | '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;;;AC6WO,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  ToolSettingsViewDefinition,\n  ToolSettingsView,\n  ToolSettingsListView,\n  ToolSettingsListMapping,\n  ToolSettingsComponentView,\n  ToolSettingsActionDataSource,\n  PanelDefinition,\n  StatusCardDefinition,\n  PanelView,\n  PanelComponentView,\n  PanelActionDataSource,\n  PanelUnknownView,\n  ProviderDefinition,\n  ProviderConfigView,\n  PromptContribution,\n  PromptSection,\n  ToolDefinition,\n  ToolConfirmationConfig,\n  CommandDefinition,\n  AccountProvider,\n  AccountContribution,\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  ConversationPresentation,\n  AttachmentsAPI,\n  AttachmentContent,\n  ConnectedAccountsAPI,\n  ConnectedAccount,\n  AccountAccessToken,\n  LogAPI,\n\n  // Background workers\n  BackgroundWorkersAPI,\n  BackgroundTaskConfig,\n  BackgroundTaskCallback,\n  BackgroundTaskContext,\n  BackgroundTaskHealth,\n  BackgroundRestartPolicy,\n\n  // Storage and Secrets\n  Query,\n  QueryOptions,\n  StorageAPI,\n  SecretsAPI,\n  StorageCollectionConfig,\n  StorageContributions,\n\n  // AI Provider\n  AIProvider,\n  ModelInfo,\n  ModelCapabilities,\n  ChatMessage,\n  ChatImage,\n  ChatFile,\n  ChatOptions,\n  GetModelsOptions,\n  StreamEvent,\n  ToolCall,\n\n  // Duplex voice\n  VoiceSessionOptions,\n  VoiceSessionDescriptor,\n  VoiceTransportRequest,\n\n  // Tools\n  Tool,\n  ToolResult,\n  ToolAttachment,\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  // Icon Names\n  HugeIconName,\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  ClockProps,\n  ParagraphProps,\n  ButtonProps,\n  TextInputProps,\n  PasswordInputProps,\n  NumberInputProps,\n  TextAreaProps,\n  DateTimeInputProps,\n  SelectProps,\n  IconPickerProps,\n  VerticalStackProps,\n  HorizontalStackProps,\n  GridProps,\n  DividerProps,\n  IconProps,\n  IconButtonType,\n  IconButtonProps,\n  PanelAction,\n  PanelProps,\n  ToggleProps,\n  CollapsibleProps,\n  FrameVariant,\n  FrameProps,\n  ListProps,\n  PillVariant,\n  PillProps,\n  CheckboxProps,\n  MarkdownProps,\n  TextPreviewProps,\n  ModalProps,\n  ConditionalGroupProps,\n  // Purpose-built display components\n  WeatherCondition,\n  WeatherWind,\n  WeatherNowProps,\n  WeatherForecastStep,\n  WeatherForecastProps,\n  ChartKind,\n  ChartSeries,\n  ChartProps,\n  StatTrend,\n  StatTileProps,\n  ProgressShape,\n  ProgressColor,\n  ProgressBarProps,\n  KeyValueRow,\n  KeyValueListProps,\n  TimelineVariant,\n  TimelineEntry,\n  TimelineProps,\n  NoteVariant,\n  NoteProps,\n  CalendarEventStatus,\n  CalendarEventProps,\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  VoiceSessionOptions,\n  VoiceSessionDescriptor,\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  | ProviderVoiceSessionRequestMessage\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 ProviderVoiceSessionRequestMessage {\n  type: 'provider-voice-session-request'\n  id: string\n  payload: {\n    providerId: string\n    /**\n     * `signal` is dropped on the way across: an AbortSignal cannot be\n     * structured-cloned into a worker. Cancellation is handled by the host\n     * rejecting the pending request instead.\n     */\n    options: Omit<VoiceSessionOptions, 'signal'>\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  | ProviderVoiceSessionResponseMessage\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  | 'user.listIds'\n  | 'events.emit'\n  | 'scheduler.schedule'\n  | 'scheduler.cancel'\n  | 'scheduler.reportFireResult'\n  | 'chat.appendInstruction'\n  | 'database.execute'\n  // Simple key-value storage methods\n  | 'storage.set'\n  | 'storage.keys'\n  | 'storage.setForUser'\n  | 'storage.keysForUser'\n  // Collection-based storage methods\n  | 'storage.put'\n  | 'storage.get'\n  | 'storage.delete'\n  | 'storage.find'\n  | 'storage.findOne'\n  | 'storage.count'\n  | 'storage.putMany'\n  | 'storage.deleteMany'\n  | 'storage.dropCollection'\n  | 'storage.listCollections'\n  | 'storage.putForUser'\n  | 'storage.getForUser'\n  | 'storage.deleteForUser'\n  | 'storage.findForUser'\n  | 'storage.findOneForUser'\n  | 'storage.countForUser'\n  | 'storage.putManyForUser'\n  | 'storage.deleteManyForUser'\n  | 'storage.dropCollectionForUser'\n  | 'storage.listCollectionsForUser'\n  // Secrets methods\n  | 'secrets.set'\n  | 'secrets.get'\n  | 'secrets.delete'\n  | 'secrets.list'\n  | 'secrets.setForUser'\n  | 'secrets.getForUser'\n  | 'secrets.deleteForUser'\n  | 'secrets.listForUser'\n  // Tools cross-extension methods\n  | 'tools.list'\n  | 'tools.execute'\n  // Attachments\n  | 'attachments.read'\n  // Connected accounts\n  | 'accounts.list'\n  | 'accounts.getAccessToken'\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 ProviderVoiceSessionResponseMessage {\n  type: 'provider-voice-session-response'\n  payload: {\n    requestId: string\n    /** Absent when `error` is set. */\n    descriptor?: VoiceSessionDescriptor\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' | 'completed' | '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;;;ACkXO,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 { H as HugeIconName, E as ExtensionContributions, S as SchedulerFirePayload, C as ChatMessage, a as ChatOptions, G as GetModelsOptions, V as VoiceSessionOptions, b as StreamEvent, M as ModelInfo, c as VoiceSessionDescriptor, T as ToolResult, A as ActionResult } from './types.tools-C0GqXQlu.cjs';
-export { a8 as AIProvider, af as Action, B as ActionsAPI, ah as AllowedCSSProperty, a1 as BackgroundRestartPolicy, _ as BackgroundTaskCallback, Z as BackgroundTaskConfig, $ as BackgroundTaskContext, a0 as BackgroundTaskHealth, Y as BackgroundWorkersAPI, au as ButtonProps, bg as CalendarEventProps, bf as CalendarEventStatus, b0 as ChartKind, b2 as ChartProps, b1 as ChartSeries, Q as ChatAPI, aa as ChatImage, R as ChatInstructionMessage, aS as CheckboxProps, as as ClockProps, aM as CollapsibleProps, v as CommandDefinition, aW as ConditionalGroupProps, W as ConversationPresentation, az as DateTimeInputProps, D as Disposable, aF as DividerProps, F as EventsAPI, am as ExtensionActionCall, an as ExtensionActionRef, al as ExtensionComponentChildren, aj as ExtensionComponentData, ak as ExtensionComponentIterator, ai as ExtensionComponentStyle, w as ExtensionContext, ao as ExtensionDataSource, ag as ExtensionModule, ap as ExtensionPanelDefinition, aO as FrameProps, aN as FrameVariant, aE as GridProps, aq as HeaderProps, aD as HorizontalStackProps, aI as IconButtonProps, aH as IconButtonType, aB as IconPickerProps, aG as IconProps, b9 as KeyValueListProps, b8 as KeyValueRow, ar as LabelProps, aP as ListProps, L as LocalizedString, X as LogAPI, aT as MarkdownProps, aV as ModalProps, a9 as ModelCapabilities, N as NetworkAPI, be as NoteProps, bd as NoteVariant, ax as NumberInputProps, aJ as PanelAction, m as PanelActionDataSource, l as PanelComponentView, P as PanelDefinition, aK as PanelProps, n as PanelUnknownView, k as PanelView, at as ParagraphProps, aw as PasswordInputProps, aR as PillProps, aQ as PillVariant, b7 as ProgressBarProps, b6 as ProgressColor, b5 as ProgressShape, q as PromptContribution, s as PromptSection, p as ProviderConfigView, o as ProviderDefinition, y as ProvidersAPI, a2 as Query, a3 as QueryOptions, I as SchedulerAPI, J as SchedulerJobRequest, K as SchedulerSchedule, a5 as SecretsAPI, aA as SelectProps, x as SettingsAPI, b4 as StatTileProps, b3 as StatTrend, j as StatusCardDefinition, a4 as StorageAPI, a6 as StorageCollectionConfig, a7 as StorageContributions, ay as TextAreaProps, av as TextInputProps, aU as TextPreviewProps, bb as TimelineEntry, bc as TimelineProps, ba as TimelineVariant, aL as ToggleProps, ad as Tool, ae as ToolAttachment, ab as ToolCall, u as ToolConfirmationConfig, t as ToolDefinition, i as ToolSettingsActionDataSource, h as ToolSettingsComponentView, g as ToolSettingsListMapping, f as ToolSettingsListView, e as ToolSettingsView, d as ToolSettingsViewDefinition, z as ToolsAPI, U as UserAPI, O as UserProfile, aC as VerticalStackProps, ac as VoiceTransportRequest, aX as WeatherCondition, a$ as WeatherForecastProps, a_ as WeatherForecastStep, aZ as WeatherNowProps, aY as WeatherWind, r as resolveLocalizedString } from './types.tools-C0GqXQlu.cjs';
+import { H as HugeIconName, E as ExtensionContributions, S as SchedulerFirePayload, C as ChatMessage, a as ChatOptions, G as GetModelsOptions, V as VoiceSessionOptions, b as StreamEvent, M as ModelInfo, c as VoiceSessionDescriptor, T as ToolResult, A as ActionResult } from './types.tools-DcFBsfRV.cjs';
+export { af as AIProvider, a1 as AccountAccessToken, x as AccountContribution, w as AccountProvider, an as Action, I as ActionsAPI, ap as AllowedCSSProperty, _ as AttachmentContent, Z as AttachmentsAPI, a8 as BackgroundRestartPolicy, a5 as BackgroundTaskCallback, a4 as BackgroundTaskConfig, a6 as BackgroundTaskContext, a7 as BackgroundTaskHealth, a3 as BackgroundWorkersAPI, aC as ButtonProps, bo as CalendarEventProps, bn as CalendarEventStatus, b8 as ChartKind, ba as ChartProps, b9 as ChartSeries, W as ChatAPI, ai as ChatFile, ah as ChatImage, X as ChatInstructionMessage, a_ as CheckboxProps, aA as ClockProps, aU as CollapsibleProps, v as CommandDefinition, b2 as ConditionalGroupProps, a0 as ConnectedAccount, $ as ConnectedAccountsAPI, Y as ConversationPresentation, aH as DateTimeInputProps, D as Disposable, aN as DividerProps, J as EventsAPI, au as ExtensionActionCall, av as ExtensionActionRef, at as ExtensionComponentChildren, ar as ExtensionComponentData, as as ExtensionComponentIterator, aq as ExtensionComponentStyle, y as ExtensionContext, aw as ExtensionDataSource, ao as ExtensionModule, ax as ExtensionPanelDefinition, aW as FrameProps, aV as FrameVariant, aM as GridProps, ay as HeaderProps, aL as HorizontalStackProps, aQ as IconButtonProps, aP as IconButtonType, aJ as IconPickerProps, aO as IconProps, bh as KeyValueListProps, bg as KeyValueRow, az as LabelProps, aX as ListProps, L as LocalizedString, a2 as LogAPI, a$ as MarkdownProps, b1 as ModalProps, ag as ModelCapabilities, N as NetworkAPI, bm as NoteProps, bl as NoteVariant, aF as NumberInputProps, aR as PanelAction, m as PanelActionDataSource, l as PanelComponentView, P as PanelDefinition, aS as PanelProps, n as PanelUnknownView, k as PanelView, aB as ParagraphProps, aE as PasswordInputProps, aZ as PillProps, aY as PillVariant, bf as ProgressBarProps, be as ProgressColor, bd as ProgressShape, q as PromptContribution, s as PromptSection, p as ProviderConfigView, o as ProviderDefinition, B as ProvidersAPI, a9 as Query, aa as QueryOptions, K as SchedulerAPI, O as SchedulerJobRequest, Q as SchedulerSchedule, ac as SecretsAPI, aI as SelectProps, z as SettingsAPI, bc as StatTileProps, bb as StatTrend, j as StatusCardDefinition, ab as StorageAPI, ad as StorageCollectionConfig, ae as StorageContributions, aG as TextAreaProps, aD as TextInputProps, b0 as TextPreviewProps, bj as TimelineEntry, bk as TimelineProps, bi as TimelineVariant, aT as ToggleProps, al as Tool, am as ToolAttachment, aj as ToolCall, u as ToolConfirmationConfig, t as ToolDefinition, i as ToolSettingsActionDataSource, h as ToolSettingsComponentView, g as ToolSettingsListMapping, f as ToolSettingsListView, e as ToolSettingsView, d as ToolSettingsViewDefinition, F as ToolsAPI, U as UserAPI, R as UserProfile, aK as VerticalStackProps, ak as VoiceTransportRequest, b3 as WeatherCondition, b7 as WeatherForecastProps, b6 as WeatherForecastStep, b5 as WeatherNowProps, b4 as WeatherWind, r as resolveLocalizedString } from './types.tools-DcFBsfRV.cjs';
 
 /**
  * Permission Types
@@ -12,7 +12,22 @@ type NetworkPermission = 'network:*' | `network:localhost` | `network:localhost:
 /** Storage permissions */
 type StoragePermission = 'storage.collections' | 'secrets.manage';
 /** User data permissions */
-type UserDataPermission = 'user.profile.read' | 'user.list' | 'user.location.read' | 'chat.history.read' | 'chat.current.read';
+type UserDataPermission = 'user.profile.read' | 'user.list' | 'user.location.read' | 'chat.history.read' | 'chat.current.read'
+/**
+ * Read the bytes of a file attached to one of this user's conversations, given
+ * its id. For handing a file on — mailing the PDF she was shown, printing it —
+ * not for reading what it says, which `core_read_attachment` does without an
+ * extension.
+ */
+ | 'attachments.read'
+/**
+ * Get access tokens for the external accounts the user has connected to Stina
+ * itself - a Microsoft account, say - for the scopes the extension declares under
+ * `contributes.accounts`. The user signs in once, in Stina's settings, and every
+ * extension that declares the provider can use that sign-in. Refresh tokens stay
+ * with the host.
+ */
+ | 'accounts.use';
 /** Capability permissions */
 type CapabilityPermission = 'provider.register' | 'tools.register' | 'tools.list' | 'tools.execute' | 'actions.register' | 'settings.register' | 'commands.register' | 'panels.register' | 'statusCards.register' | 'events.emit' | 'scheduler.register' | 'chat.message.write' | 'background.workers';
 /** System permissions */
@@ -213,7 +228,7 @@ interface RequestMessage {
     method: RequestMethod;
     payload: unknown;
 }
-type RequestMethod = 'network.fetch' | 'network.fetch-stream' | 'settings.getAll' | 'settings.get' | 'settings.set' | 'user.getProfile' | 'user.listIds' | 'events.emit' | 'scheduler.schedule' | 'scheduler.cancel' | 'scheduler.reportFireResult' | 'chat.appendInstruction' | 'database.execute' | 'storage.set' | 'storage.keys' | 'storage.setForUser' | 'storage.keysForUser' | 'storage.put' | 'storage.get' | 'storage.delete' | 'storage.find' | 'storage.findOne' | 'storage.count' | 'storage.putMany' | 'storage.deleteMany' | 'storage.dropCollection' | 'storage.listCollections' | 'storage.putForUser' | 'storage.getForUser' | 'storage.deleteForUser' | 'storage.findForUser' | 'storage.findOneForUser' | 'storage.countForUser' | 'storage.putManyForUser' | 'storage.deleteManyForUser' | 'storage.dropCollectionForUser' | 'storage.listCollectionsForUser' | 'secrets.set' | 'secrets.get' | 'secrets.delete' | 'secrets.list' | 'secrets.setForUser' | 'secrets.getForUser' | 'secrets.deleteForUser' | 'secrets.listForUser' | 'tools.list' | 'tools.execute';
+type RequestMethod = 'network.fetch' | 'network.fetch-stream' | 'settings.getAll' | 'settings.get' | 'settings.set' | 'user.getProfile' | 'user.listIds' | 'events.emit' | 'scheduler.schedule' | 'scheduler.cancel' | 'scheduler.reportFireResult' | 'chat.appendInstruction' | 'database.execute' | 'storage.set' | 'storage.keys' | 'storage.setForUser' | 'storage.keysForUser' | 'storage.put' | 'storage.get' | 'storage.delete' | 'storage.find' | 'storage.findOne' | 'storage.count' | 'storage.putMany' | 'storage.deleteMany' | 'storage.dropCollection' | 'storage.listCollections' | 'storage.putForUser' | 'storage.getForUser' | 'storage.deleteForUser' | 'storage.findForUser' | 'storage.findOneForUser' | 'storage.countForUser' | 'storage.putManyForUser' | 'storage.deleteManyForUser' | 'storage.dropCollectionForUser' | 'storage.listCollectionsForUser' | 'secrets.set' | 'secrets.get' | 'secrets.delete' | 'secrets.list' | 'secrets.setForUser' | 'secrets.getForUser' | 'secrets.deleteForUser' | 'secrets.listForUser' | 'tools.list' | 'tools.execute' | 'attachments.read' | 'accounts.list' | 'accounts.getAccessToken';
 interface ProviderRegisteredMessage {
     type: 'provider-registered';
     payload: {

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { H as HugeIconName, E as ExtensionContributions, S as SchedulerFirePayload, C as ChatMessage, a as ChatOptions, G as GetModelsOptions, V as VoiceSessionOptions, b as StreamEvent, M as ModelInfo, c as VoiceSessionDescriptor, T as ToolResult, A as ActionResult } from './types.tools-C0GqXQlu.js';
-export { a8 as AIProvider, af as Action, B as ActionsAPI, ah as AllowedCSSProperty, a1 as BackgroundRestartPolicy, _ as BackgroundTaskCallback, Z as BackgroundTaskConfig, $ as BackgroundTaskContext, a0 as BackgroundTaskHealth, Y as BackgroundWorkersAPI, au as ButtonProps, bg as CalendarEventProps, bf as CalendarEventStatus, b0 as ChartKind, b2 as ChartProps, b1 as ChartSeries, Q as ChatAPI, aa as ChatImage, R as ChatInstructionMessage, aS as CheckboxProps, as as ClockProps, aM as CollapsibleProps, v as CommandDefinition, aW as ConditionalGroupProps, W as ConversationPresentation, az as DateTimeInputProps, D as Disposable, aF as DividerProps, F as EventsAPI, am as ExtensionActionCall, an as ExtensionActionRef, al as ExtensionComponentChildren, aj as ExtensionComponentData, ak as ExtensionComponentIterator, ai as ExtensionComponentStyle, w as ExtensionContext, ao as ExtensionDataSource, ag as ExtensionModule, ap as ExtensionPanelDefinition, aO as FrameProps, aN as FrameVariant, aE as GridProps, aq as HeaderProps, aD as HorizontalStackProps, aI as IconButtonProps, aH as IconButtonType, aB as IconPickerProps, aG as IconProps, b9 as KeyValueListProps, b8 as KeyValueRow, ar as LabelProps, aP as ListProps, L as LocalizedString, X as LogAPI, aT as MarkdownProps, aV as ModalProps, a9 as ModelCapabilities, N as NetworkAPI, be as NoteProps, bd as NoteVariant, ax as NumberInputProps, aJ as PanelAction, m as PanelActionDataSource, l as PanelComponentView, P as PanelDefinition, aK as PanelProps, n as PanelUnknownView, k as PanelView, at as ParagraphProps, aw as PasswordInputProps, aR as PillProps, aQ as PillVariant, b7 as ProgressBarProps, b6 as ProgressColor, b5 as ProgressShape, q as PromptContribution, s as PromptSection, p as ProviderConfigView, o as ProviderDefinition, y as ProvidersAPI, a2 as Query, a3 as QueryOptions, I as SchedulerAPI, J as SchedulerJobRequest, K as SchedulerSchedule, a5 as SecretsAPI, aA as SelectProps, x as SettingsAPI, b4 as StatTileProps, b3 as StatTrend, j as StatusCardDefinition, a4 as StorageAPI, a6 as StorageCollectionConfig, a7 as StorageContributions, ay as TextAreaProps, av as TextInputProps, aU as TextPreviewProps, bb as TimelineEntry, bc as TimelineProps, ba as TimelineVariant, aL as ToggleProps, ad as Tool, ae as ToolAttachment, ab as ToolCall, u as ToolConfirmationConfig, t as ToolDefinition, i as ToolSettingsActionDataSource, h as ToolSettingsComponentView, g as ToolSettingsListMapping, f as ToolSettingsListView, e as ToolSettingsView, d as ToolSettingsViewDefinition, z as ToolsAPI, U as UserAPI, O as UserProfile, aC as VerticalStackProps, ac as VoiceTransportRequest, aX as WeatherCondition, a$ as WeatherForecastProps, a_ as WeatherForecastStep, aZ as WeatherNowProps, aY as WeatherWind, r as resolveLocalizedString } from './types.tools-C0GqXQlu.js';
+import { H as HugeIconName, E as ExtensionContributions, S as SchedulerFirePayload, C as ChatMessage, a as ChatOptions, G as GetModelsOptions, V as VoiceSessionOptions, b as StreamEvent, M as ModelInfo, c as VoiceSessionDescriptor, T as ToolResult, A as ActionResult } from './types.tools-DcFBsfRV.js';
+export { af as AIProvider, a1 as AccountAccessToken, x as AccountContribution, w as AccountProvider, an as Action, I as ActionsAPI, ap as AllowedCSSProperty, _ as AttachmentContent, Z as AttachmentsAPI, a8 as BackgroundRestartPolicy, a5 as BackgroundTaskCallback, a4 as BackgroundTaskConfig, a6 as BackgroundTaskContext, a7 as BackgroundTaskHealth, a3 as BackgroundWorkersAPI, aC as ButtonProps, bo as CalendarEventProps, bn as CalendarEventStatus, b8 as ChartKind, ba as ChartProps, b9 as ChartSeries, W as ChatAPI, ai as ChatFile, ah as ChatImage, X as ChatInstructionMessage, a_ as CheckboxProps, aA as ClockProps, aU as CollapsibleProps, v as CommandDefinition, b2 as ConditionalGroupProps, a0 as ConnectedAccount, $ as ConnectedAccountsAPI, Y as ConversationPresentation, aH as DateTimeInputProps, D as Disposable, aN as DividerProps, J as EventsAPI, au as ExtensionActionCall, av as ExtensionActionRef, at as ExtensionComponentChildren, ar as ExtensionComponentData, as as ExtensionComponentIterator, aq as ExtensionComponentStyle, y as ExtensionContext, aw as ExtensionDataSource, ao as ExtensionModule, ax as ExtensionPanelDefinition, aW as FrameProps, aV as FrameVariant, aM as GridProps, ay as HeaderProps, aL as HorizontalStackProps, aQ as IconButtonProps, aP as IconButtonType, aJ as IconPickerProps, aO as IconProps, bh as KeyValueListProps, bg as KeyValueRow, az as LabelProps, aX as ListProps, L as LocalizedString, a2 as LogAPI, a$ as MarkdownProps, b1 as ModalProps, ag as ModelCapabilities, N as NetworkAPI, bm as NoteProps, bl as NoteVariant, aF as NumberInputProps, aR as PanelAction, m as PanelActionDataSource, l as PanelComponentView, P as PanelDefinition, aS as PanelProps, n as PanelUnknownView, k as PanelView, aB as ParagraphProps, aE as PasswordInputProps, aZ as PillProps, aY as PillVariant, bf as ProgressBarProps, be as ProgressColor, bd as ProgressShape, q as PromptContribution, s as PromptSection, p as ProviderConfigView, o as ProviderDefinition, B as ProvidersAPI, a9 as Query, aa as QueryOptions, K as SchedulerAPI, O as SchedulerJobRequest, Q as SchedulerSchedule, ac as SecretsAPI, aI as SelectProps, z as SettingsAPI, bc as StatTileProps, bb as StatTrend, j as StatusCardDefinition, ab as StorageAPI, ad as StorageCollectionConfig, ae as StorageContributions, aG as TextAreaProps, aD as TextInputProps, b0 as TextPreviewProps, bj as TimelineEntry, bk as TimelineProps, bi as TimelineVariant, aT as ToggleProps, al as Tool, am as ToolAttachment, aj as ToolCall, u as ToolConfirmationConfig, t as ToolDefinition, i as ToolSettingsActionDataSource, h as ToolSettingsComponentView, g as ToolSettingsListMapping, f as ToolSettingsListView, e as ToolSettingsView, d as ToolSettingsViewDefinition, F as ToolsAPI, U as UserAPI, R as UserProfile, aK as VerticalStackProps, ak as VoiceTransportRequest, b3 as WeatherCondition, b7 as WeatherForecastProps, b6 as WeatherForecastStep, b5 as WeatherNowProps, b4 as WeatherWind, r as resolveLocalizedString } from './types.tools-DcFBsfRV.js';
 
 /**
  * Permission Types
@@ -12,7 +12,22 @@ type NetworkPermission = 'network:*' | `network:localhost` | `network:localhost:
 /** Storage permissions */
 type StoragePermission = 'storage.collections' | 'secrets.manage';
 /** User data permissions */
-type UserDataPermission = 'user.profile.read' | 'user.list' | 'user.location.read' | 'chat.history.read' | 'chat.current.read';
+type UserDataPermission = 'user.profile.read' | 'user.list' | 'user.location.read' | 'chat.history.read' | 'chat.current.read'
+/**
+ * Read the bytes of a file attached to one of this user's conversations, given
+ * its id. For handing a file on — mailing the PDF she was shown, printing it —
+ * not for reading what it says, which `core_read_attachment` does without an
+ * extension.
+ */
+ | 'attachments.read'
+/**
+ * Get access tokens for the external accounts the user has connected to Stina
+ * itself - a Microsoft account, say - for the scopes the extension declares under
+ * `contributes.accounts`. The user signs in once, in Stina's settings, and every
+ * extension that declares the provider can use that sign-in. Refresh tokens stay
+ * with the host.
+ */
+ | 'accounts.use';
 /** Capability permissions */
 type CapabilityPermission = 'provider.register' | 'tools.register' | 'tools.list' | 'tools.execute' | 'actions.register' | 'settings.register' | 'commands.register' | 'panels.register' | 'statusCards.register' | 'events.emit' | 'scheduler.register' | 'chat.message.write' | 'background.workers';
 /** System permissions */
@@ -213,7 +228,7 @@ interface RequestMessage {
     method: RequestMethod;
     payload: unknown;
 }
-type RequestMethod = 'network.fetch' | 'network.fetch-stream' | 'settings.getAll' | 'settings.get' | 'settings.set' | 'user.getProfile' | 'user.listIds' | 'events.emit' | 'scheduler.schedule' | 'scheduler.cancel' | 'scheduler.reportFireResult' | 'chat.appendInstruction' | 'database.execute' | 'storage.set' | 'storage.keys' | 'storage.setForUser' | 'storage.keysForUser' | 'storage.put' | 'storage.get' | 'storage.delete' | 'storage.find' | 'storage.findOne' | 'storage.count' | 'storage.putMany' | 'storage.deleteMany' | 'storage.dropCollection' | 'storage.listCollections' | 'storage.putForUser' | 'storage.getForUser' | 'storage.deleteForUser' | 'storage.findForUser' | 'storage.findOneForUser' | 'storage.countForUser' | 'storage.putManyForUser' | 'storage.deleteManyForUser' | 'storage.dropCollectionForUser' | 'storage.listCollectionsForUser' | 'secrets.set' | 'secrets.get' | 'secrets.delete' | 'secrets.list' | 'secrets.setForUser' | 'secrets.getForUser' | 'secrets.deleteForUser' | 'secrets.listForUser' | 'tools.list' | 'tools.execute';
+type RequestMethod = 'network.fetch' | 'network.fetch-stream' | 'settings.getAll' | 'settings.get' | 'settings.set' | 'user.getProfile' | 'user.listIds' | 'events.emit' | 'scheduler.schedule' | 'scheduler.cancel' | 'scheduler.reportFireResult' | 'chat.appendInstruction' | 'database.execute' | 'storage.set' | 'storage.keys' | 'storage.setForUser' | 'storage.keysForUser' | 'storage.put' | 'storage.get' | 'storage.delete' | 'storage.find' | 'storage.findOne' | 'storage.count' | 'storage.putMany' | 'storage.deleteMany' | 'storage.dropCollection' | 'storage.listCollections' | 'storage.putForUser' | 'storage.getForUser' | 'storage.deleteForUser' | 'storage.findForUser' | 'storage.findOneForUser' | 'storage.countForUser' | 'storage.putManyForUser' | 'storage.deleteManyForUser' | 'storage.dropCollectionForUser' | 'storage.listCollectionsForUser' | 'secrets.set' | 'secrets.get' | 'secrets.delete' | 'secrets.list' | 'secrets.setForUser' | 'secrets.getForUser' | 'secrets.deleteForUser' | 'secrets.listForUser' | 'tools.list' | 'tools.execute' | 'attachments.read' | 'accounts.list' | 'accounts.getAccessToken';
 interface ProviderRegisteredMessage {
     type: 'provider-registered';
     payload: {

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   generateMessageId
-} from "./chunk-ZB7GJUPS.js";
+} from "./chunk-S3YP4QPF.js";
 import "./chunk-DGUM43GV.js";
 
 // src/types.localization.ts

package/dist/runtime.cjs

@@ -139,6 +139,7 @@ var WorkerBackgroundTaskManager = class {
       userStorage,
       secrets,
       userSecrets,
+      ...config.userId && this.options.createUserAccountsAPI ? { accounts: this.options.createUserAccountsAPI(config.userId) } : {},
       signal,
       reportHealth: (status) => {
         const timestamp = (/* @__PURE__ */ new Date()).toISOString();
@@ -272,8 +273,22 @@ function buildUserSecretsAPI(sendRequest2, userId) {
   };
 }
 
+// src/runtime/accountsApi.ts
+function buildUserAccountsAPI(sendRequest2, userId) {
+  return {
+    async list(provider) {
+      return sendRequest2("accounts.list", { provider, userId });
+    },
+    async getAccessToken(accountId) {
+      return sendRequest2("accounts.getAccessToken", { accountId, userId });
+    }
+  };
+}
+
 // src/runtime/executionContext.ts
-function createExecutionContext(sendRequest2, extensionContext2, userId) {
+function createExecutionContext(sendRequest2, extensionContext2, userId, granted = []) {
+  const canReadAttachments = granted.includes("attachments.read");
+  const canUseAccounts = granted.includes("accounts.use");
   return {
     userId,
     extension: {
@@ -284,7 +299,21 @@ function createExecutionContext(sendRequest2, extensionContext2, userId) {
     storage: buildExtensionStorageAPI(sendRequest2),
     userStorage: userId ? buildUserStorageAPI(sendRequest2, userId) : buildExtensionStorageAPI(sendRequest2),
     secrets: buildExtensionSecretsAPI(sendRequest2),
-    userSecrets: userId ? buildUserSecretsAPI(sendRequest2, userId) : buildExtensionSecretsAPI(sendRequest2)
+    userSecrets: userId ? buildUserSecretsAPI(sendRequest2, userId) : buildExtensionSecretsAPI(sendRequest2),
+    // Only with a user to scope it to. An attachment belongs to somebody, and a
+    // request that cannot say whose work it is doing has no business reading one.
+    ...canReadAttachments && userId ? {
+      attachments: {
+        async read(attachmentId) {
+          return sendRequest2("attachments.read", {
+            attachmentId,
+            userId
+          });
+        }
+      }
+    } : {},
+    // Scoped to a user for the same reason: a connected account is somebody's.
+    ...canUseAccounts && userId ? { accounts: buildUserAccountsAPI(sendRequest2, userId) } : {}
   };
 }
 
@@ -310,6 +339,7 @@ var messagePort = getMessagePort();
 var extensionModule = null;
 var extensionDisposable = null;
 var extensionContext = null;
+var grantedPermissions = [];
 var backgroundTaskManager = null;
 var pendingRequests = /* @__PURE__ */ new Map();
 var registeredProviders = /* @__PURE__ */ new Map();
@@ -416,6 +446,7 @@ function handleResponse(payload) {
 }
 async function handleActivate(payload) {
   const { extensionId, extensionVersion, storagePath, permissions } = payload;
+  grantedPermissions = permissions;
   extensionContext = buildContext(extensionId, extensionVersion, storagePath, permissions);
   try {
     if (extensionModule?.activate) {
@@ -466,7 +497,12 @@ function handleSettingsChanged(key, value) {
   }
 }
 async function handleSchedulerFire(payload) {
-  const execContext = createExecutionContext(sendRequest, extensionContext, payload.userId);
+  const execContext = createExecutionContext(
+    sendRequest,
+    extensionContext,
+    payload.userId,
+    grantedPermissions
+  );
   const results = await Promise.allSettled(
     schedulerCallbacks.map((callback) => Promise.resolve(callback(payload, execContext)))
   );
@@ -613,7 +649,12 @@ async function handleToolExecuteRequest(requestId, payload) {
     return;
   }
   try {
-    const execContext = createExecutionContext(sendRequest, extensionContext, payload.userId);
+    const execContext = createExecutionContext(
+      sendRequest,
+      extensionContext,
+      payload.userId,
+      grantedPermissions
+    );
     const result = await tool.execute(payload.params, execContext);
     postMessage({
       type: "tool-execute-response",
@@ -648,7 +689,12 @@ async function handleActionExecuteRequest(requestId, payload) {
     return;
   }
   try {
-    const execContext = createExecutionContext(sendRequest, extensionContext, payload.userId);
+    const execContext = createExecutionContext(
+      sendRequest,
+      extensionContext,
+      payload.userId,
+      grantedPermissions
+    );
     const result = await action.execute(payload.params, execContext);
     postMessage({
       type: "action-execute-response",
@@ -949,7 +995,8 @@ function buildContext(extensionId, extensionVersion, storagePath, permissions) {
         createStorageAPI: () => buildExtensionStorageAPI(sendRequest),
         createUserStorageAPI: (userId) => buildUserStorageAPI(sendRequest, userId),
         createSecretsAPI: () => buildExtensionSecretsAPI(sendRequest),
-        createUserSecretsAPI: (userId) => buildUserSecretsAPI(sendRequest, userId)
+        createUserSecretsAPI: (userId) => buildUserSecretsAPI(sendRequest, userId),
+        ...hasPermission("accounts.use") ? { createUserAccountsAPI: (userId) => buildUserAccountsAPI(sendRequest, userId) } : {}
       });
     }
     const backgroundWorkersApi = {