@stina/extension-api 0.7.0 → 0.8.0

package/README.md

@@ -0,0 +1,107 @@
+# @stina/extension-api
+
+Type definitions and runtime helpers for building extensions for Stina (https://github.com/einord/stina).
+Use this package to define your extension manifest, register tools/providers, and access the extension context.
+
+## What this package is for
+
+- Authoring Stina extensions (tools, providers, settings, commands, prompts).
+- Typing `manifest.json` and runtime code with Stina's Extension API.
+- Running extension code inside Stina's sandboxed worker via the runtime helper.
+
+## Install
+
+```bash
+pnpm add @stina/extension-api
+```
+
+(Use npm or yarn if you prefer.)
+
+## Minimal extension example
+
+### 1) `manifest.json`
+
+```json
+{
+  "id": "example.hello",
+  "name": "Hello Extension",
+  "version": "0.1.0",
+  "description": "Adds a hello tool",
+  "author": { "name": "Your Name" },
+  "main": "dist/index.js",
+  "permissions": ["tools.register"],
+  "contributes": {
+    "tools": [
+      {
+        "id": "example.hello",
+        "name": "Hello",
+        "description": "Returns a friendly greeting",
+        "parameters": {
+          "type": "object",
+          "properties": {
+            "name": { "type": "string" }
+          }
+        }
+      }
+    ]
+  }
+}
+```
+
+### 2) Extension entry point (`src/index.ts`)
+
+```ts
+import type { ExtensionModule } from '@stina/extension-api'
+import { initializeExtension } from '@stina/extension-api/runtime'
+
+const extension: ExtensionModule = {
+  activate(context) {
+    context.log.info('Hello extension activated', { id: context.extension.id })
+
+    context.tools?.register({
+      id: 'example.hello',
+      name: 'Hello',
+      description: 'Returns a friendly greeting',
+      execute: async (params) => {
+        const name = typeof params?.name === 'string' ? params.name : 'there'
+        return { message: `Hello, ${name}!` }
+      },
+    })
+  },
+}
+
+initializeExtension(extension)
+```
+
+### 3) Build output
+
+Bundle your extension so that `manifest.json` points at the built file (`main`).
+For example, compile to `dist/index.js` and publish the zip/release with:
+
+```
+manifest.json
+src/
+dist/
+```
+
+## Common patterns
+
+- Use `contributes` in `manifest.json` for UI definitions.
+- Use `context.tools?.register(...)` or `context.providers?.register(...)` at runtime.
+- Always include the permission that matches what you register (`tools.register`, `provider.register`, etc.).
+- Keep runtime code platform-agnostic; it runs in a worker.
+
+## Publish to Stina Extension Library
+
+Extensions that should appear in the Stina Extension Library must be registered via a Pull Request to:
+https://github.com/einord/stina-extensions-registry
+
+## Real-world example
+
+For a real, but still approachable example of a Stina extension in use, see:
+https://github.com/einord/stina-ext-people
+
+## Links
+
+- Manifest types: `ExtensionManifest` in this package.
+- Runtime helper: `@stina/extension-api/runtime`.

package/dist/{chunk-SS4D3JYX.js → chunk-IKJ37ZGB.js}

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

package/dist/chunk-IKJ37ZGB.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\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  }\n}\n\nexport interface ActionExecuteRequestMessage {\n  type: 'action-execute-request'\n  id: string\n  payload: {\n    actionId: string\n    params: Record<string, unknown>\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// 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\nexport interface ReadyMessage {\n  type: 'ready'\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  | '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\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":";;;;;;;;AA2OO,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/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// Types\nexport type {\n  // Manifest\n  ExtensionManifest,\n  Platform,\n  ExtensionContributions,\n  SettingDefinition,\n  ToolSettingsViewDefinition,\n  ToolSettingsView,\n  ToolSettingsListView,\n  ToolSettingsListMapping,\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  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  // 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  ResponseMessage,\n  ReadyMessage,\n  RequestMessage,\n  RequestMethod,\n  ProviderRegisteredMessage,\n  ToolRegisteredMessage,\n  StreamEventMessage,\n  LogMessage,\n  PendingRequest,\n} from './messages.js'\n\nexport { generateMessageId } from './messages.js'\n","/**\n * Message protocol between Extension Host and Extension Workers\n */\n\nimport type { ChatMessage, ChatOptions, GetModelsOptions, StreamEvent, ToolResult, ModelInfo } from './types.js'\n\n// ============================================================================\n// Host → Worker Messages\n// ============================================================================\n\nexport type HostToWorkerMessage =\n  | ActivateMessage\n  | DeactivateMessage\n  | SettingsChangedMessage\n  | ProviderChatRequestMessage\n  | ProviderModelsRequestMessage\n  | ToolExecuteRequestMessage\n  | ResponseMessage\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 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  }\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// Worker → Host Messages\n// ============================================================================\n\nexport type WorkerToHostMessage =\n  | ReadyMessage\n  | RequestMessage\n  | ProviderRegisteredMessage\n  | ToolRegisteredMessage\n  | StreamEventMessage\n  | LogMessage\n  | ProviderModelsResponseMessage\n  | ToolExecuteResponseMessage\n\nexport interface ReadyMessage {\n  type: 'ready'\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  | 'settings.getAll'\n  | 'settings.get'\n  | 'settings.set'\n  | 'database.execute'\n  | 'storage.get'\n  | 'storage.set'\n  | 'storage.delete'\n  | 'storage.keys'\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 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 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;;;AC0LO,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/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// 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  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  // 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  SelectProps,\n  VerticalStackProps,\n  HorizontalStackProps,\n  GridProps,\n  DividerProps,\n  IconProps,\n  IconButtonType,\n  IconButtonProps,\n  PanelAction,\n  PanelProps,\n  ToggleProps,\n} from './types.components.js'\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\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  }\n}\n\nexport interface ActionExecuteRequestMessage {\n  type: 'action-execute-request'\n  id: string\n  payload: {\n    actionId: string\n    params: Record<string, unknown>\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// 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\nexport interface ReadyMessage {\n  type: 'ready'\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  | '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\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;;;AC2OO,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,11 +1,11 @@
-import { C as ChatMessage, a as ChatOptions, G as GetModelsOptions, S as StreamEvent, M as ModelInfo, T as ToolResult } from './types-Brv9O9NY.cjs';
-export { F as AIProvider, t as CapabilityPermission, l as CommandDefinition, A as DatabaseAPI, D as Disposable, v as ExtensionContext, b as ExtensionContributions, E as ExtensionManifest, J as ExtensionModule, L as LogAPI, w as NetworkAPI, N as NetworkPermission, r as Permission, P as Platform, i as PromptContribution, j as PromptSection, n as ProviderConfigProperty, o as ProviderConfigPropertyType, m as ProviderConfigSchema, p as ProviderConfigSelectOption, q as ProviderConfigValidation, h as ProviderDefinition, y as ProvidersAPI, c as SettingDefinition, x as SettingsAPI, B as StorageAPI, s as StoragePermission, u as SystemPermission, I as Tool, H as ToolCall, k as ToolDefinition, g as ToolSettingsListMapping, f as ToolSettingsListView, e as ToolSettingsView, d as ToolSettingsViewDefinition, z as ToolsAPI, U as UserDataPermission } from './types-Brv9O9NY.cjs';
+import { 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-Cr8eCJ0G.cjs';
+export { a3 as AIProvider, a6 as Action, Q as ActionsAPI, ai as ButtonProps, D as CapabilityPermission, _ as ChatAPI, $ as ChatInstructionMessage, t as CommandDefinition, a0 as DatabaseAPI, I as Disposable, ao as DividerProps, R as EventsAPI, ab as ExtensionActionCall, ac as ExtensionActionRef, aa as ExtensionComponentChildren, a8 as ExtensionComponentData, a9 as ExtensionComponentIterator, H as ExtensionContext, c as ExtensionContributions, ad as ExtensionDataSource, E as ExtensionManifest, a7 as ExtensionModule, ae as ExtensionPanelDefinition, an as GridProps, af as HeaderProps, am as HorizontalStackProps, ar as IconButtonProps, aq as IconButtonType, ap as IconProps, ag as LabelProps, a2 as LogAPI, J as NetworkAPI, N as NetworkPermission, as as PanelAction, n as PanelActionDataSource, m as PanelComponentView, k as PanelDefinition, at as PanelProps, o as PanelUnknownView, l as PanelView, ah as ParagraphProps, z as Permission, P as Platform, q as PromptContribution, r as PromptSection, v as ProviderConfigProperty, w as ProviderConfigPropertyType, u as ProviderConfigSchema, x as ProviderConfigSelectOption, y as ProviderConfigValidation, p as ProviderDefinition, L as ProvidersAPI, V as SchedulerAPI, W as SchedulerJobRequest, X as SchedulerSchedule, ak as SelectProps, f as SettingCreateMapping, d as SettingDefinition, e as SettingOptionsMapping, K as SettingsAPI, a1 as StorageAPI, B as StoragePermission, F as SystemPermission, aj as TextInputProps, au as ToggleProps, a5 as Tool, a4 as ToolCall, s as ToolDefinition, j as ToolSettingsListMapping, i as ToolSettingsListView, h as ToolSettingsView, g as ToolSettingsViewDefinition, O as ToolsAPI, Y as UserAPI, U as UserDataPermission, Z as UserProfile, al as VerticalStackProps } from './types-Cr8eCJ0G.cjs';
 
 /**
  * Message protocol between Extension Host and Extension Workers
  */
 
-type HostToWorkerMessage = ActivateMessage | DeactivateMessage | SettingsChangedMessage | ProviderChatRequestMessage | ProviderModelsRequestMessage | ToolExecuteRequestMessage | ResponseMessage;
+type HostToWorkerMessage = ActivateMessage | DeactivateMessage | SettingsChangedMessage | SchedulerFireMessage | ProviderChatRequestMessage | ProviderModelsRequestMessage | ToolExecuteRequestMessage | ActionExecuteRequestMessage | ResponseMessage;
 interface ActivateMessage {
     type: 'activate';
     id: string;
@@ -29,6 +29,11 @@ interface SettingsChangedMessage {
         value: unknown;
     };
 }
+interface SchedulerFireMessage {
+    type: 'scheduler-fire';
+    id: string;
+    payload: SchedulerFirePayload;
+}
 interface ProviderChatRequestMessage {
     type: 'provider-chat-request';
     id: string;
@@ -54,6 +59,14 @@ interface ToolExecuteRequestMessage {
         params: Record<string, unknown>;
     };
 }
+interface ActionExecuteRequestMessage {
+    type: 'action-execute-request';
+    id: string;
+    payload: {
+        actionId: string;
+        params: Record<string, unknown>;
+    };
+}
 interface ResponseMessage {
     type: 'response';
     id: string;
@@ -64,7 +77,7 @@ interface ResponseMessage {
         error?: string;
     };
 }
-type WorkerToHostMessage = ReadyMessage | RequestMessage | ProviderRegisteredMessage | ToolRegisteredMessage | StreamEventMessage | LogMessage | ProviderModelsResponseMessage | ToolExecuteResponseMessage;
+type WorkerToHostMessage = ReadyMessage | RequestMessage | ProviderRegisteredMessage | ToolRegisteredMessage | ActionRegisteredMessage | StreamEventMessage | LogMessage | ProviderModelsResponseMessage | ToolExecuteResponseMessage | ActionExecuteResponseMessage;
 interface ReadyMessage {
     type: 'ready';
 }
@@ -74,7 +87,7 @@ interface RequestMessage {
     method: RequestMethod;
     payload: unknown;
 }
-type RequestMethod = 'network.fetch' | 'settings.getAll' | 'settings.get' | 'settings.set' | 'database.execute' | 'storage.get' | 'storage.set' | 'storage.delete' | 'storage.keys';
+type RequestMethod = 'network.fetch' | 'settings.getAll' | 'settings.get' | 'settings.set' | 'user.getProfile' | 'events.emit' | 'scheduler.schedule' | 'scheduler.cancel' | 'chat.appendInstruction' | 'database.execute' | 'storage.get' | 'storage.set' | 'storage.delete' | 'storage.keys';
 interface ProviderRegisteredMessage {
     type: 'provider-registered';
     payload: {
@@ -91,6 +104,12 @@ interface ToolRegisteredMessage {
         parameters?: Record<string, unknown>;
     };
 }
+interface ActionRegisteredMessage {
+    type: 'action-registered';
+    payload: {
+        id: string;
+    };
+}
 interface StreamEventMessage {
     type: 'stream-event';
     payload: {
@@ -114,6 +133,14 @@ interface ToolExecuteResponseMessage {
         error?: string;
     };
 }
+interface ActionExecuteResponseMessage {
+    type: 'action-execute-response';
+    payload: {
+        requestId: string;
+        result: ActionResult;
+        error?: string;
+    };
+}
 interface LogMessage {
     type: 'log';
     payload: {
@@ -132,4 +159,4 @@ interface PendingRequest<T = unknown> {
  */
 declare function generateMessageId(): string;
 
-export { type ActivateMessage, ChatMessage, ChatOptions, type DeactivateMessage, GetModelsOptions, type HostToWorkerMessage, type LogMessage, ModelInfo, type PendingRequest, type ProviderChatRequestMessage, type ProviderModelsRequestMessage, type ProviderRegisteredMessage, type ReadyMessage, type RequestMessage, type RequestMethod, type ResponseMessage, type SettingsChangedMessage, StreamEvent, type StreamEventMessage, type ToolExecuteRequestMessage, type ToolExecuteResponseMessage, type ToolRegisteredMessage, ToolResult, type WorkerToHostMessage, generateMessageId };
+export { type ActionExecuteRequestMessage, type ActionExecuteResponseMessage, type ActionRegisteredMessage, ActionResult, type ActivateMessage, ChatMessage, ChatOptions, type DeactivateMessage, GetModelsOptions, type HostToWorkerMessage, type LogMessage, ModelInfo, type PendingRequest, type ProviderChatRequestMessage, type ProviderModelsRequestMessage, type ProviderRegisteredMessage, type ReadyMessage, type RequestMessage, type RequestMethod, type ResponseMessage, SchedulerFirePayload, type SettingsChangedMessage, StreamEvent, type StreamEventMessage, type ToolExecuteRequestMessage, type ToolExecuteResponseMessage, type ToolRegisteredMessage, ToolResult, type WorkerToHostMessage, generateMessageId };

package/dist/index.d.ts

@@ -1,11 +1,11 @@
-import { C as ChatMessage, a as ChatOptions, G as GetModelsOptions, S as StreamEvent, M as ModelInfo, T as ToolResult } from './types-Brv9O9NY.js';
-export { F as AIProvider, t as CapabilityPermission, l as CommandDefinition, A as DatabaseAPI, D as Disposable, v as ExtensionContext, b as ExtensionContributions, E as ExtensionManifest, J as ExtensionModule, L as LogAPI, w as NetworkAPI, N as NetworkPermission, r as Permission, P as Platform, i as PromptContribution, j as PromptSection, n as ProviderConfigProperty, o as ProviderConfigPropertyType, m as ProviderConfigSchema, p as ProviderConfigSelectOption, q as ProviderConfigValidation, h as ProviderDefinition, y as ProvidersAPI, c as SettingDefinition, x as SettingsAPI, B as StorageAPI, s as StoragePermission, u as SystemPermission, I as Tool, H as ToolCall, k as ToolDefinition, g as ToolSettingsListMapping, f as ToolSettingsListView, e as ToolSettingsView, d as ToolSettingsViewDefinition, z as ToolsAPI, U as UserDataPermission } from './types-Brv9O9NY.js';
+import { 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-Cr8eCJ0G.js';
+export { a3 as AIProvider, a6 as Action, Q as ActionsAPI, ai as ButtonProps, D as CapabilityPermission, _ as ChatAPI, $ as ChatInstructionMessage, t as CommandDefinition, a0 as DatabaseAPI, I as Disposable, ao as DividerProps, R as EventsAPI, ab as ExtensionActionCall, ac as ExtensionActionRef, aa as ExtensionComponentChildren, a8 as ExtensionComponentData, a9 as ExtensionComponentIterator, H as ExtensionContext, c as ExtensionContributions, ad as ExtensionDataSource, E as ExtensionManifest, a7 as ExtensionModule, ae as ExtensionPanelDefinition, an as GridProps, af as HeaderProps, am as HorizontalStackProps, ar as IconButtonProps, aq as IconButtonType, ap as IconProps, ag as LabelProps, a2 as LogAPI, J as NetworkAPI, N as NetworkPermission, as as PanelAction, n as PanelActionDataSource, m as PanelComponentView, k as PanelDefinition, at as PanelProps, o as PanelUnknownView, l as PanelView, ah as ParagraphProps, z as Permission, P as Platform, q as PromptContribution, r as PromptSection, v as ProviderConfigProperty, w as ProviderConfigPropertyType, u as ProviderConfigSchema, x as ProviderConfigSelectOption, y as ProviderConfigValidation, p as ProviderDefinition, L as ProvidersAPI, V as SchedulerAPI, W as SchedulerJobRequest, X as SchedulerSchedule, ak as SelectProps, f as SettingCreateMapping, d as SettingDefinition, e as SettingOptionsMapping, K as SettingsAPI, a1 as StorageAPI, B as StoragePermission, F as SystemPermission, aj as TextInputProps, au as ToggleProps, a5 as Tool, a4 as ToolCall, s as ToolDefinition, j as ToolSettingsListMapping, i as ToolSettingsListView, h as ToolSettingsView, g as ToolSettingsViewDefinition, O as ToolsAPI, Y as UserAPI, U as UserDataPermission, Z as UserProfile, al as VerticalStackProps } from './types-Cr8eCJ0G.js';
 
 /**
  * Message protocol between Extension Host and Extension Workers
  */
 
-type HostToWorkerMessage = ActivateMessage | DeactivateMessage | SettingsChangedMessage | ProviderChatRequestMessage | ProviderModelsRequestMessage | ToolExecuteRequestMessage | ResponseMessage;
+type HostToWorkerMessage = ActivateMessage | DeactivateMessage | SettingsChangedMessage | SchedulerFireMessage | ProviderChatRequestMessage | ProviderModelsRequestMessage | ToolExecuteRequestMessage | ActionExecuteRequestMessage | ResponseMessage;
 interface ActivateMessage {
     type: 'activate';
     id: string;
@@ -29,6 +29,11 @@ interface SettingsChangedMessage {
         value: unknown;
     };
 }
+interface SchedulerFireMessage {
+    type: 'scheduler-fire';
+    id: string;
+    payload: SchedulerFirePayload;
+}
 interface ProviderChatRequestMessage {
     type: 'provider-chat-request';
     id: string;
@@ -54,6 +59,14 @@ interface ToolExecuteRequestMessage {
         params: Record<string, unknown>;
     };
 }
+interface ActionExecuteRequestMessage {
+    type: 'action-execute-request';
+    id: string;
+    payload: {
+        actionId: string;
+        params: Record<string, unknown>;
+    };
+}
 interface ResponseMessage {
     type: 'response';
     id: string;
@@ -64,7 +77,7 @@ interface ResponseMessage {
         error?: string;
     };
 }
-type WorkerToHostMessage = ReadyMessage | RequestMessage | ProviderRegisteredMessage | ToolRegisteredMessage | StreamEventMessage | LogMessage | ProviderModelsResponseMessage | ToolExecuteResponseMessage;
+type WorkerToHostMessage = ReadyMessage | RequestMessage | ProviderRegisteredMessage | ToolRegisteredMessage | ActionRegisteredMessage | StreamEventMessage | LogMessage | ProviderModelsResponseMessage | ToolExecuteResponseMessage | ActionExecuteResponseMessage;
 interface ReadyMessage {
     type: 'ready';
 }
@@ -74,7 +87,7 @@ interface RequestMessage {
     method: RequestMethod;
     payload: unknown;
 }
-type RequestMethod = 'network.fetch' | 'settings.getAll' | 'settings.get' | 'settings.set' | 'database.execute' | 'storage.get' | 'storage.set' | 'storage.delete' | 'storage.keys';
+type RequestMethod = 'network.fetch' | 'settings.getAll' | 'settings.get' | 'settings.set' | 'user.getProfile' | 'events.emit' | 'scheduler.schedule' | 'scheduler.cancel' | 'chat.appendInstruction' | 'database.execute' | 'storage.get' | 'storage.set' | 'storage.delete' | 'storage.keys';
 interface ProviderRegisteredMessage {
     type: 'provider-registered';
     payload: {
@@ -91,6 +104,12 @@ interface ToolRegisteredMessage {
         parameters?: Record<string, unknown>;
     };
 }
+interface ActionRegisteredMessage {
+    type: 'action-registered';
+    payload: {
+        id: string;
+    };
+}
 interface StreamEventMessage {
     type: 'stream-event';
     payload: {
@@ -114,6 +133,14 @@ interface ToolExecuteResponseMessage {
         error?: string;
     };
 }
+interface ActionExecuteResponseMessage {
+    type: 'action-execute-response';
+    payload: {
+        requestId: string;
+        result: ActionResult;
+        error?: string;
+    };
+}
 interface LogMessage {
     type: 'log';
     payload: {
@@ -132,4 +159,4 @@ interface PendingRequest<T = unknown> {
  */
 declare function generateMessageId(): string;
 
-export { type ActivateMessage, ChatMessage, ChatOptions, type DeactivateMessage, GetModelsOptions, type HostToWorkerMessage, type LogMessage, ModelInfo, type PendingRequest, type ProviderChatRequestMessage, type ProviderModelsRequestMessage, type ProviderRegisteredMessage, type ReadyMessage, type RequestMessage, type RequestMethod, type ResponseMessage, type SettingsChangedMessage, StreamEvent, type StreamEventMessage, type ToolExecuteRequestMessage, type ToolExecuteResponseMessage, type ToolRegisteredMessage, ToolResult, type WorkerToHostMessage, generateMessageId };
+export { type ActionExecuteRequestMessage, type ActionExecuteResponseMessage, type ActionRegisteredMessage, ActionResult, type ActivateMessage, ChatMessage, ChatOptions, type DeactivateMessage, GetModelsOptions, type HostToWorkerMessage, type LogMessage, ModelInfo, type PendingRequest, type ProviderChatRequestMessage, type ProviderModelsRequestMessage, type ProviderRegisteredMessage, type ReadyMessage, type RequestMessage, type RequestMethod, type ResponseMessage, SchedulerFirePayload, type SettingsChangedMessage, StreamEvent, type StreamEventMessage, type ToolExecuteRequestMessage, type ToolExecuteResponseMessage, type ToolRegisteredMessage, ToolResult, type WorkerToHostMessage, generateMessageId };

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   generateMessageId
-} from "./chunk-SS4D3JYX.js";
+} from "./chunk-IKJ37ZGB.js";
 export {
   generateMessageId
 };

package/dist/runtime.cjs

@@ -54,7 +54,9 @@ var extensionContext = null;
 var pendingRequests = /* @__PURE__ */ new Map();
 var registeredProviders = /* @__PURE__ */ new Map();
 var registeredTools = /* @__PURE__ */ new Map();
+var registeredActions = /* @__PURE__ */ new Map();
 var settingsCallbacks = [];
+var schedulerCallbacks = [];
 var REQUEST_TIMEOUT = 3e4;
 function postMessage(message) {
   messagePort.postMessage(message);
@@ -86,6 +88,9 @@ async function handleHostMessage(message) {
     case "settings-changed":
       handleSettingsChanged(message.payload.key, message.payload.value);
       break;
+    case "scheduler-fire":
+      handleSchedulerFire(message.payload);
+      break;
     case "provider-chat-request":
       await handleProviderChatRequest(message.id, message.payload);
       break;
@@ -95,6 +100,9 @@ async function handleHostMessage(message) {
     case "tool-execute-request":
       await handleToolExecuteRequest(message.id, message.payload);
       break;
+    case "action-execute-request":
+      await handleActionExecuteRequest(message.id, message.payload);
+      break;
     case "response":
       handleResponse(message.payload);
       break;
@@ -144,7 +152,9 @@ async function handleDeactivate() {
     extensionContext = null;
     registeredProviders.clear();
     registeredTools.clear();
+    registeredActions.clear();
     settingsCallbacks.length = 0;
+    schedulerCallbacks.length = 0;
   }
 }
 function handleSettingsChanged(key, value) {
@@ -156,6 +166,15 @@ function handleSettingsChanged(key, value) {
     }
   }
 }
+function handleSchedulerFire(payload) {
+  for (const callback of schedulerCallbacks) {
+    try {
+      callback(payload);
+    } catch (error) {
+      console.error("Error in scheduler callback:", error);
+    }
+  }
+}
 async function handleProviderChatRequest(requestId, payload) {
   const provider = registeredProviders.get(payload.providerId);
   if (!provider) {
@@ -272,6 +291,40 @@ async function handleToolExecuteRequest(requestId, payload) {
     });
   }
 }
+async function handleActionExecuteRequest(requestId, payload) {
+  const action = registeredActions.get(payload.actionId);
+  if (!action) {
+    postMessage({
+      type: "action-execute-response",
+      payload: {
+        requestId,
+        result: { success: false, error: `Action ${payload.actionId} not found` },
+        error: `Action ${payload.actionId} not found`
+      }
+    });
+    return;
+  }
+  try {
+    const result = await action.execute(payload.params);
+    postMessage({
+      type: "action-execute-response",
+      payload: {
+        requestId,
+        result
+      }
+    });
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    postMessage({
+      type: "action-execute-response",
+      payload: {
+        requestId,
+        result: { success: false, error: errorMessage },
+        error: errorMessage
+      }
+    });
+  }
+}
 function buildContext(extensionId, extensionVersion, storagePath, permissions) {
   const hasPermission = (perm) => {
     return permissions.some((p) => {
@@ -369,6 +422,69 @@ function buildContext(extensionId, extensionVersion, storagePath, permissions) {
     };
     context.tools = toolsApi;
   }
+  if (hasPermission("actions.register")) {
+    const actionsApi = {
+      register(action) {
+        registeredActions.set(action.id, action);
+        postMessage({
+          type: "action-registered",
+          payload: {
+            id: action.id
+          }
+        });
+        return {
+          dispose: () => {
+            registeredActions.delete(action.id);
+          }
+        };
+      }
+    };
+    context.actions = actionsApi;
+  }
+  if (hasPermission("events.emit")) {
+    const eventsApi = {
+      async emit(name, payload) {
+        await sendRequest("events.emit", { name, payload });
+      }
+    };
+    context.events = eventsApi;
+  }
+  if (hasPermission("scheduler.register")) {
+    const schedulerApi = {
+      async schedule(job) {
+        await sendRequest("scheduler.schedule", { job });
+      },
+      async cancel(jobId) {
+        await sendRequest("scheduler.cancel", { jobId });
+      },
+      onFire(callback) {
+        schedulerCallbacks.push(callback);
+        return {
+          dispose: () => {
+            const index = schedulerCallbacks.indexOf(callback);
+            if (index >= 0) schedulerCallbacks.splice(index, 1);
+          }
+        };
+      }
+    };
+    context.scheduler = schedulerApi;
+  }
+  if (hasPermission("user.profile.read")) {
+    const userApi = {
+      async getProfile() {
+        return sendRequest("user.getProfile", {});
+      }
+    };
+    context.user = userApi;
+  }
+  if (hasPermission("chat.message.write")) {
+    const chatApi = {
+      async appendInstruction(message) {
+        await sendRequest("chat.appendInstruction", message);
+      }
+    };
+    context.chat = chatApi;
+  }
   if (hasPermission("database.own")) {
     const databaseApi = {
       async execute(sql, params) {