@stina/extension-api 0.28.1 → 0.29.0-alpha.d59ea54

package/dist/{types.tools-ymsggUiN.d.ts → types.tools-CmclZz5I.d.ts}

@@ -26,6 +26,8 @@ type LocalizedString = string | Record<string, string>;
  */
 declare function resolveLocalizedString(value: LocalizedString, lang: string, fallbackLang?: string): string;
 
+/** Semantic type alias for icon names (e.g. Hugeicons). Accepts any string. */
+type HugeIconName = string;
 /**
  * Allowed CSS property names for extension component styling.
  * Only safe properties that cannot be used for UI spoofing,
@@ -162,7 +164,7 @@ interface HeaderProps extends ExtensionComponentData {
     level: number;
     title: string;
     description?: string | string[];
-    icon?: string;
+    icon?: HugeIconName;
 }
 /** The extension API properties for the Label component. */
 interface LabelProps extends ExtensionComponentData {
@@ -239,7 +241,7 @@ interface DividerProps extends ExtensionComponentData {
 /** The extension API properties for the Icon component. */
 interface IconProps extends ExtensionComponentData {
     component: 'Icon';
-    name: string;
+    name: HugeIconName;
     title?: string;
 }
 /** Button type for IconButton. */
@@ -247,7 +249,7 @@ type IconButtonType = 'normal' | 'primary' | 'danger' | 'accent';
 /** The extension API properties for the IconButton component. */
 interface IconButtonProps extends ExtensionComponentData {
     component: 'IconButton';
-    icon: string;
+    icon: HugeIconName;
     tooltip: string;
     active?: boolean;
     disabled?: boolean;
@@ -256,7 +258,7 @@ interface IconButtonProps extends ExtensionComponentData {
 }
 /** Action button definition for Panel component. */
 interface PanelAction {
-    icon: string;
+    icon: HugeIconName;
     tooltip: string;
     action: ExtensionActionRef;
     type?: IconButtonType;
@@ -266,7 +268,7 @@ interface PanelProps extends ExtensionComponentData {
     component: 'Panel';
     title: string;
     description?: string | string[];
-    icon?: string;
+    icon?: HugeIconName;
     actions?: PanelAction[];
     content?: ExtensionComponentData;
 }
@@ -287,7 +289,7 @@ interface CollapsibleProps extends ExtensionComponentData {
     /** Optional description rendered under the title. */
     description?: string | string[];
     /** Optional icon shown to the left of the title. */
-    icon?: string;
+    icon?: HugeIconName;
     /** Whether the section is expanded by default. */
     defaultExpanded?: boolean;
     /** Child component to render when expanded. */
@@ -301,7 +303,7 @@ interface PillProps extends ExtensionComponentData {
     /** Text to display in the pill. */
     text: string;
     /** Optional icon shown to the left of the text. */
-    icon?: string;
+    icon?: HugeIconName;
     /** Color variant. Defaults to 'default'. */
     variant?: PillVariant;
 }
@@ -325,6 +327,14 @@ interface MarkdownProps extends ExtensionComponentData {
     /** Markdown content to render. */
     content: string;
 }
+/** The extension API properties for the TextPreview component. */
+interface TextPreviewProps extends ExtensionComponentData {
+    component: 'TextPreview';
+    /** Markdown content to render. */
+    content: string;
+    /** Maximum number of visible lines before truncating. Defaults to 5. */
+    maxLines?: number;
+}
 /** The extension API properties for the Modal component. */
 interface ModalProps extends ExtensionComponentData {
     component: 'Modal';
@@ -361,6 +371,28 @@ interface ConditionalGroupProps extends ExtensionComponentData {
     /** Children to render when condition is true. */
     children: ExtensionComponentChildren;
 }
+/** Visual variant for the Frame component. */
+type FrameVariant = 'border' | 'solid';
+/** The extension API properties for the Frame component. */
+interface FrameProps extends ExtensionComponentData {
+    component: 'Frame';
+    /** Optional title displayed in the header. Can be a plain string or extension components. */
+    title?: string | ExtensionComponentChildren;
+    /** Whether the content can be toggled (collapsed/expanded) by clicking the title. Requires title to be set. */
+    collapsible?: boolean;
+    /** Whether the frame content is expanded by default. Only used when collapsible is true. Defaults to true. */
+    defaultExpanded?: boolean;
+    /** Visual variant: 'border' shows a bordered container, 'solid' shows a solid background. Defaults to 'border'. */
+    variant?: FrameVariant;
+    /** Child components to render inside the frame. */
+    children: ExtensionComponentChildren;
+}
+/** The extension API properties for the List component. */
+interface ListProps extends ExtensionComponentData {
+    component: 'List';
+    /** Child components to render as list items. Supports iteration. */
+    children: ExtensionComponentChildren;
+}
 
 /**
  * Contribution Types
@@ -811,6 +843,11 @@ interface ChatOptions {
     signal?: AbortSignal;
     /** Provider-specific settings from model configuration */
     settings?: Record<string, unknown>;
+    /** Request context (user info, session metadata — not provider config) */
+    context?: {
+        userId?: string;
+        [key: string]: unknown;
+    };
     /** Available tools for this request */
     tools?: ToolDefinition[];
 }
@@ -1304,6 +1341,23 @@ interface ToolsAPI {
      * Register a tool that Stina can use
      */
     register(tool: Tool): Disposable;
+    /**
+     * List all registered tools from all extensions.
+     * Requires the `tools.list` permission.
+     *
+     * @returns All tool definitions currently registered across all extensions.
+     */
+    list(): Promise<ToolDefinition[]>;
+    /**
+     * Execute a tool registered by any extension.
+     * Requires the `tools.execute` permission.
+     *
+     * @param toolId - The unique identifier of the tool to execute.
+     * @param params - Parameters to pass to the tool.
+     * @param userId - Optional user ID for user-scoped tool execution.
+     * @returns The result produced by the tool.
+     */
+    execute(toolId: string, params: Record<string, unknown>, userId?: string): Promise<ToolResult>;
 }
 /**
  * Actions API for registering UI actions
@@ -1678,4 +1732,4 @@ interface ActionResult {
     error?: string;
 }
 
-export { type BackgroundTaskConfig as $, type ActionResult as A, type ProviderConfigValidation as B, type ChatMessage as C, type ExtensionContext as D, type ExtensionContributions as E, type Disposable as F, type GetModelsOptions as G, type SettingsAPI as H, type ProvidersAPI as I, type ToolsAPI as J, type ActionsAPI as K, type LocalizedString as L, type ModelInfo as M, type NetworkAPI as N, type EventsAPI as O, type PanelDefinition as P, type SchedulerAPI as Q, type SchedulerJobRequest as R, type SchedulerFirePayload as S, type ToolResult as T, type SchedulerSchedule as U, type UserAPI as V, type UserProfile as W, type ChatAPI as X, type ChatInstructionMessage as Y, type LogAPI as Z, type BackgroundWorkersAPI as _, type ChatOptions as a, type BackgroundTaskCallback as a0, type BackgroundTaskContext as a1, type BackgroundTaskHealth as a2, type BackgroundRestartPolicy as a3, type Query as a4, type QueryOptions as a5, type StorageAPI as a6, type SecretsAPI as a7, type StorageCollectionConfig as a8, type StorageContributions as a9, type IconProps as aA, type IconButtonType as aB, type IconButtonProps as aC, type PanelAction as aD, type PanelProps as aE, type ToggleProps as aF, type CollapsibleProps as aG, type PillVariant as aH, type PillProps as aI, type CheckboxProps as aJ, type MarkdownProps as aK, type ModalProps as aL, type ConditionalGroupProps as aM, type ExecutionContext as aN, type AIProvider as aa, type ToolCall as ab, type Tool as ac, type Action as ad, type ExtensionModule as ae, type AllowedCSSProperty as af, type ExtensionComponentStyle as ag, type ExtensionComponentData as ah, type ExtensionComponentIterator as ai, type ExtensionComponentChildren as aj, type ExtensionActionCall as ak, type ExtensionActionRef as al, type ExtensionDataSource as am, type ExtensionPanelDefinition as an, type HeaderProps as ao, type LabelProps as ap, type ParagraphProps as aq, type ButtonProps as ar, type TextInputProps as as, type DateTimeInputProps as at, type SelectProps as au, type IconPickerProps as av, type VerticalStackProps as aw, type HorizontalStackProps as ax, type GridProps as ay, type DividerProps as az, type StreamEvent as b, type SettingDefinition as c, type SettingOptionsMapping as d, type SettingCreateMapping as e, type ToolSettingsViewDefinition as f, type ToolSettingsView as g, type ToolSettingsListView as h, type ToolSettingsListMapping as i, type ToolSettingsComponentView as j, type ToolSettingsActionDataSource as k, type PanelView as l, type PanelComponentView as m, type PanelActionDataSource as n, type PanelUnknownView as o, type ProviderDefinition as p, type PromptContribution as q, resolveLocalizedString as r, type PromptSection as s, type ToolDefinition as t, type ToolConfirmationConfig as u, type CommandDefinition as v, type ProviderConfigSchema as w, type ProviderConfigProperty as x, type ProviderConfigPropertyType as y, type ProviderConfigSelectOption as z };
+export { type BackgroundTaskConfig as $, type ActionResult as A, type ProviderConfigValidation as B, type ChatMessage as C, type ExtensionContext as D, type ExtensionContributions as E, type Disposable as F, type GetModelsOptions as G, type SettingsAPI as H, type ProvidersAPI as I, type ToolsAPI as J, type ActionsAPI as K, type LocalizedString as L, type ModelInfo as M, type NetworkAPI as N, type EventsAPI as O, type PanelDefinition as P, type SchedulerAPI as Q, type SchedulerJobRequest as R, type SchedulerFirePayload as S, type ToolResult as T, type SchedulerSchedule as U, type UserAPI as V, type UserProfile as W, type ChatAPI as X, type ChatInstructionMessage as Y, type LogAPI as Z, type BackgroundWorkersAPI as _, type ChatOptions as a, type BackgroundTaskCallback as a0, type BackgroundTaskContext as a1, type BackgroundTaskHealth as a2, type BackgroundRestartPolicy as a3, type Query as a4, type QueryOptions as a5, type StorageAPI as a6, type SecretsAPI as a7, type StorageCollectionConfig as a8, type StorageContributions as a9, type DividerProps as aA, type IconProps as aB, type IconButtonType as aC, type IconButtonProps as aD, type PanelAction as aE, type PanelProps as aF, type ToggleProps as aG, type CollapsibleProps as aH, type FrameVariant as aI, type FrameProps as aJ, type ListProps as aK, type PillVariant as aL, type PillProps as aM, type CheckboxProps as aN, type MarkdownProps as aO, type TextPreviewProps as aP, type ModalProps as aQ, type ConditionalGroupProps as aR, type ExecutionContext as aS, type AIProvider as aa, type ToolCall as ab, type Tool as ac, type Action as ad, type ExtensionModule as ae, type HugeIconName as af, type AllowedCSSProperty as ag, type ExtensionComponentStyle as ah, type ExtensionComponentData as ai, type ExtensionComponentIterator as aj, type ExtensionComponentChildren as ak, type ExtensionActionCall as al, type ExtensionActionRef as am, type ExtensionDataSource as an, type ExtensionPanelDefinition as ao, type HeaderProps as ap, type LabelProps as aq, type ParagraphProps as ar, type ButtonProps as as, type TextInputProps as at, type DateTimeInputProps as au, type SelectProps as av, type IconPickerProps as aw, type VerticalStackProps as ax, type HorizontalStackProps as ay, type GridProps as az, type StreamEvent as b, type SettingDefinition as c, type SettingOptionsMapping as d, type SettingCreateMapping as e, type ToolSettingsViewDefinition as f, type ToolSettingsView as g, type ToolSettingsListView as h, type ToolSettingsListMapping as i, type ToolSettingsComponentView as j, type ToolSettingsActionDataSource as k, type PanelView as l, type PanelComponentView as m, type PanelActionDataSource as n, type PanelUnknownView as o, type ProviderDefinition as p, type PromptContribution as q, resolveLocalizedString as r, type PromptSection as s, type ToolDefinition as t, type ToolConfirmationConfig as u, type CommandDefinition as v, type ProviderConfigSchema as w, type ProviderConfigProperty as x, type ProviderConfigPropertyType as y, type ProviderConfigSelectOption as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stina/extension-api",
-  "version": "0.28.1",
+  "version": "0.29.0-alpha.d59ea54",
   "private": false,
   "repository": {
     "type": "git",

package/schema/extension-manifest.schema.json

@@ -108,6 +108,8 @@
                   "chat.message.write",
                   "provider.register",
                   "tools.register",
+                  "tools.list",
+                  "tools.execute",
                   "actions.register",
                   "settings.register",
                   "commands.register",

package/src/index.ts

@@ -144,6 +144,8 @@ export { generateMessageId } from './messages.js'
 
 // Component types (for extension UI components)
 export type {
+  // Icon Names
+  HugeIconName,
   // Styling
   AllowedCSSProperty,
   ExtensionComponentStyle,
@@ -178,10 +180,14 @@ export type {
   PanelProps,
   ToggleProps,
   CollapsibleProps,
+  FrameVariant,
+  FrameProps,
+  ListProps,
   PillVariant,
   PillProps,
   CheckboxProps,
   MarkdownProps,
+  TextPreviewProps,
   ModalProps,
   ConditionalGroupProps,
 } from './types.components.js'

package/src/messages.ts

@@ -242,6 +242,9 @@ export type RequestMethod =
   | 'secrets.getForUser'
   | 'secrets.deleteForUser'
   | 'secrets.listForUser'
+  // Tools cross-extension methods
+  | 'tools.list'
+  | 'tools.execute'
 
 export interface ProviderRegisteredMessage {
   type: 'provider-registered'

package/src/runtime.ts

@@ -28,6 +28,8 @@ import type {
   LogAPI,
   AIProvider,
   Tool,
+  ToolDefinition,
+  ToolResult,
   Action,
   ChatMessage,
   ChatOptions,
@@ -720,10 +722,14 @@ function buildContext(
     ;(context as { providers: ProvidersAPI }).providers = providersApi
   }
 
-  // Add tools API if permitted
-  if (hasPermission('tools.register')) {
+  // Add tools API if ANY tools permission is present
+  const hasAnyToolsPermission = hasPermission('tools.register') || hasPermission('tools.list') || hasPermission('tools.execute')
+  if (hasAnyToolsPermission) {
     const toolsApi: ToolsAPI = {
       register(tool: Tool): Disposable {
+        if (!hasPermission('tools.register')) {
+          throw new Error('tools.register permission required')
+        }
         registeredTools.set(tool.id, tool)
         postMessage({
           type: 'tool-registered',
@@ -740,6 +746,18 @@ function buildContext(
           },
         }
       },
+      async list(): Promise<ToolDefinition[]> {
+        if (!hasPermission('tools.list')) {
+          throw new Error('tools.list permission required')
+        }
+        return sendRequest<ToolDefinition[]>('tools.list', {})
+      },
+      async execute(toolId: string, params: Record<string, unknown>, userId?: string): Promise<ToolResult> {
+        if (!hasPermission('tools.execute')) {
+          throw new Error('tools.execute permission required')
+        }
+        return sendRequest<ToolResult>('tools.execute', { toolId, params, userId })
+      },
     }
     ;(context as { tools: ToolsAPI }).tools = toolsApi
   }

package/src/schemas/components.schema.ts

@@ -414,6 +414,16 @@ export const MarkdownPropsSchema = z
   .passthrough()
   .describe('Markdown component')
 
+export const TextPreviewPropsSchema = z
+  .object({
+    component: z.literal('TextPreview'),
+    content: z.string().describe('Markdown content'),
+    maxLines: z.number().optional().describe('Max visible lines before truncating (default 5)'),
+    style: ExtensionComponentStyleSchema.optional(),
+  })
+  .passthrough()
+  .describe('TextPreview component')
+
 export const ModalPropsSchema = z
   .object({
     component: z.literal('Modal'),
@@ -438,6 +448,33 @@ export const ConditionalGroupPropsSchema = z
   .passthrough()
   .describe('ConditionalGroup component')
 
+export const FrameVariantSchema = z
+  .enum(['border', 'solid'])
+  .describe('Frame visual variant')
+
+export const FramePropsSchema = z
+  .object({
+    component: z.literal('Frame'),
+    title: z.union([z.string(), ExtensionComponentChildrenSchema]).optional().describe('Optional title (string or components)'),
+    icon: z.string().optional().describe('Icon name'),
+    collapsible: z.boolean().optional().describe('Whether content can be toggled'),
+    defaultExpanded: z.boolean().optional().describe('Whether expanded by default'),
+    variant: FrameVariantSchema.optional().describe('Visual variant'),
+    children: ExtensionComponentChildrenSchema.describe('Child components'),
+    style: ExtensionComponentStyleSchema.optional(),
+  })
+  .passthrough()
+  .describe('Frame container component')
+
+export const ListPropsSchema = z
+  .object({
+    component: z.literal('List'),
+    children: ExtensionComponentChildrenSchema.describe('Child components rendered as list items'),
+    style: ExtensionComponentStyleSchema.optional(),
+  })
+  .passthrough()
+  .describe('List component')
+
 // =============================================================================
 // Type Exports
 // =============================================================================
@@ -473,5 +510,9 @@ export type CollapsibleProps = z.infer<typeof CollapsiblePropsSchema>
 export type PillProps = z.infer<typeof PillPropsSchema>
 export type CheckboxProps = z.infer<typeof CheckboxPropsSchema>
 export type MarkdownProps = z.infer<typeof MarkdownPropsSchema>
+export type TextPreviewProps = z.infer<typeof TextPreviewPropsSchema>
 export type ModalProps = z.infer<typeof ModalPropsSchema>
 export type ConditionalGroupProps = z.infer<typeof ConditionalGroupPropsSchema>
+export type FrameVariant = z.infer<typeof FrameVariantSchema>
+export type FrameProps = z.infer<typeof FramePropsSchema>
+export type ListProps = z.infer<typeof ListPropsSchema>

package/src/schemas/index.ts

@@ -123,6 +123,10 @@ export {
   PanelPropsSchema,
   TogglePropsSchema,
   CollapsiblePropsSchema,
+  FrameVariantSchema,
+  FramePropsSchema,
+  TextPreviewPropsSchema,
+  ListPropsSchema,
   PillPropsSchema,
   CheckboxPropsSchema,
   MarkdownPropsSchema,
@@ -156,6 +160,10 @@ export {
   type PanelProps,
   type ToggleProps,
   type CollapsibleProps,
+  type FrameVariant,
+  type FrameProps,
+  type TextPreviewProps,
+  type ListProps,
   type PillProps,
   type CheckboxProps,
   type MarkdownProps,

package/src/schemas/permissions.schema.ts

@@ -22,6 +22,8 @@ export const VALID_PERMISSIONS = [
   'chat.message.write',
   'provider.register',
   'tools.register',
+  'tools.list',
+  'tools.execute',
   'actions.register',
   'settings.register',
   'commands.register',
@@ -81,6 +83,8 @@ const CapabilityPermissionSchema = z
   .enum([
     'provider.register',
     'tools.register',
+    'tools.list',
+    'tools.execute',
     'actions.register',
     'settings.register',
     'commands.register',

package/src/types.components.ts

@@ -1,3 +1,10 @@
+// =============================================================================
+// Icon Names
+// =============================================================================
+
+/** Semantic type alias for icon names (e.g. Hugeicons). Accepts any string. */
+export type HugeIconName = string
+
 // =============================================================================
 // Styling
 // =============================================================================
@@ -235,7 +242,7 @@ export interface HeaderProps extends ExtensionComponentData {
   level: number
   title: string
   description?: string | string[]
-  icon?: string
+  icon?: HugeIconName
 }
 
 /** The extension API properties for the Label component. */
@@ -321,7 +328,7 @@ export interface DividerProps extends ExtensionComponentData {
 /** The extension API properties for the Icon component. */
 export interface IconProps extends ExtensionComponentData {
   component: 'Icon'
-  name: string
+  name: HugeIconName
   title?: string
 }
 
@@ -331,7 +338,7 @@ export type IconButtonType = 'normal' | 'primary' | 'danger' | 'accent'
 /** The extension API properties for the IconButton component. */
 export interface IconButtonProps extends ExtensionComponentData {
   component: 'IconButton'
-  icon: string
+  icon: HugeIconName
   tooltip: string
   active?: boolean
   disabled?: boolean
@@ -341,7 +348,7 @@ export interface IconButtonProps extends ExtensionComponentData {
 
 /** Action button definition for Panel component. */
 export interface PanelAction {
-  icon: string
+  icon: HugeIconName
   tooltip: string
   action: ExtensionActionRef
   type?: IconButtonType
@@ -352,7 +359,7 @@ export interface PanelProps extends ExtensionComponentData {
   component: 'Panel'
   title: string
   description?: string | string[]
-  icon?: string
+  icon?: HugeIconName
   actions?: PanelAction[]
   content?: ExtensionComponentData
 }
@@ -375,7 +382,7 @@ export interface CollapsibleProps extends ExtensionComponentData {
   /** Optional description rendered under the title. */
   description?: string | string[]
   /** Optional icon shown to the left of the title. */
-  icon?: string
+  icon?: HugeIconName
   /** Whether the section is expanded by default. */
   defaultExpanded?: boolean
   /** Child component to render when expanded. */
@@ -391,7 +398,7 @@ export interface PillProps extends ExtensionComponentData {
   /** Text to display in the pill. */
   text: string
   /** Optional icon shown to the left of the text. */
-  icon?: string
+  icon?: HugeIconName
   /** Color variant. Defaults to 'default'. */
   variant?: PillVariant
 }
@@ -418,6 +425,15 @@ export interface MarkdownProps extends ExtensionComponentData {
   content: string
 }
 
+/** The extension API properties for the TextPreview component. */
+export interface TextPreviewProps extends ExtensionComponentData {
+  component: 'TextPreview'
+  /** Markdown content to render. */
+  content: string
+  /** Maximum number of visible lines before truncating. Defaults to 5. */
+  maxLines?: number
+}
+
 /** The extension API properties for the Modal component. */
 export interface ModalProps extends ExtensionComponentData {
   component: 'Modal'
@@ -455,3 +471,28 @@ export interface ConditionalGroupProps extends ExtensionComponentData {
   /** Children to render when condition is true. */
   children: ExtensionComponentChildren
 }
+
+/** Visual variant for the Frame component. */
+export type FrameVariant = 'border' | 'solid'
+
+/** The extension API properties for the Frame component. */
+export interface FrameProps extends ExtensionComponentData {
+  component: 'Frame'
+  /** Optional title displayed in the header. Can be a plain string or extension components. */
+  title?: string | ExtensionComponentChildren
+  /** Whether the content can be toggled (collapsed/expanded) by clicking the title. Requires title to be set. */
+  collapsible?: boolean
+  /** Whether the frame content is expanded by default. Only used when collapsible is true. Defaults to true. */
+  defaultExpanded?: boolean
+  /** Visual variant: 'border' shows a bordered container, 'solid' shows a solid background. Defaults to 'border'. */
+  variant?: FrameVariant
+  /** Child components to render inside the frame. */
+  children: ExtensionComponentChildren
+}
+
+/** The extension API properties for the List component. */
+export interface ListProps extends ExtensionComponentData {
+  component: 'List'
+  /** Child components to render as list items. Supports iteration. */
+  children: ExtensionComponentChildren
+}

package/src/types.context.ts

@@ -5,7 +5,8 @@
  */
 
 import type { AIProvider } from './types.provider.js'
-import type { Tool, Action } from './types.tools.js'
+import type { Tool, ToolResult, Action } from './types.tools.js'
+import type { ToolDefinition } from './types.contributions.js'
 import type { StorageAPI, SecretsAPI } from './types.storage.js'
 
 /**
@@ -212,6 +213,24 @@ export interface ToolsAPI {
    * Register a tool that Stina can use
    */
   register(tool: Tool): Disposable
+  /**
+   * List all registered tools from all extensions.
+   * Requires the `tools.list` permission.
+   *
+   * @returns All tool definitions currently registered across all extensions.
+   */
+  list(): Promise<ToolDefinition[]>
+
+  /**
+   * Execute a tool registered by any extension.
+   * Requires the `tools.execute` permission.
+   *
+   * @param toolId - The unique identifier of the tool to execute.
+   * @param params - Parameters to pass to the tool.
+   * @param userId - Optional user ID for user-scoped tool execution.
+   * @returns The result produced by the tool.
+   */
+  execute(toolId: string, params: Record<string, unknown>, userId?: string): Promise<ToolResult>
 }
 
 /**

package/src/types.permissions.ts

@@ -32,6 +32,8 @@ export type UserDataPermission =
 export type CapabilityPermission =
   | 'provider.register'
   | 'tools.register'
+  | 'tools.list'
+  | 'tools.execute'
   | 'actions.register'
   | 'settings.register'
   | 'commands.register'

package/src/types.provider.ts

@@ -87,6 +87,8 @@ export interface ChatOptions {
   signal?: AbortSignal
   /** Provider-specific settings from model configuration */
   settings?: Record<string, unknown>
+  /** Request context (user info, session metadata — not provider config) */
+  context?: { userId?: string; [key: string]: unknown }
   /** Available tools for this request */
   tools?: ToolDefinition[]
 }