@stina/extension-api 0.30.2 → 0.31.1-alpha.67639c6

package/schema/extension-manifest.schema.json

@@ -102,6 +102,7 @@
                   "storage.collections",
                   "secrets.manage",
                   "user.profile.read",
+                  "user.list",
                   "user.location.read",
                   "chat.history.read",
                   "chat.current.read",
@@ -856,6 +857,21 @@
                     "type": "object",
                     "additionalProperties": {},
                     "description": "Parameter schema (JSON Schema)"
+                  },
+                  "requiresConfirmation": {
+                    "type": "boolean",
+                    "description": "Whether this tool requires user confirmation before execution (default: true)"
+                  },
+                  "confirmationPrompt": {
+                    "anyOf": [
+                      {
+                        "$ref": "#/definitions/ExtensionManifest/properties/contributes/properties/tools/items/properties/name/anyOf/0"
+                      },
+                      {
+                        "$ref": "#/definitions/ExtensionManifest/properties/contributes/properties/tools/items/properties/name/anyOf/1"
+                      }
+                    ],
+                    "description": "Custom confirmation prompt"
                   }
                 },
                 "required": [

package/src/messages.ts

@@ -201,6 +201,7 @@ export type RequestMethod =
   | 'settings.get'
   | 'settings.set'
   | 'user.getProfile'
+  | 'user.listIds'
   | 'events.emit'
   | 'scheduler.schedule'
   | 'scheduler.cancel'

package/src/runtime.ts

@@ -823,6 +823,9 @@ function buildContext(
       async getProfile(): Promise<UserProfile> {
         return sendRequest<UserProfile>('user.getProfile', {})
       },
+      async listIds(): Promise<string[]> {
+        return sendRequest<string[]>('user.listIds', {})
+      },
     }
     ;(context as { user: UserAPI }).user = userApi
   }

package/src/schemas/contributions.schema.ts

@@ -353,6 +353,8 @@ export const ToolDefinitionSchema = z
     name: LocalizedStringSchema.describe('Display name'),
     description: LocalizedStringSchema.describe('Description for Stina'),
     parameters: z.record(z.unknown()).optional().describe('Parameter schema (JSON Schema)'),
+    requiresConfirmation: z.boolean().optional().describe('Whether this tool requires user confirmation before execution (default: true)'),
+    confirmationPrompt: LocalizedStringSchema.optional().describe('Custom confirmation prompt'),
   })
   .describe('Tool definition')
 

package/src/schemas/permissions.schema.ts

@@ -16,6 +16,7 @@ export const VALID_PERMISSIONS = [
   'storage.collections',
   'secrets.manage',
   'user.profile.read',
+  'user.list',
   'user.location.read',
   'chat.history.read',
   'chat.current.read',
@@ -73,7 +74,7 @@ const StoragePermissionSchema = z.enum(['storage.collections', 'secrets.manage']
  * User data permission schema
  */
 const UserDataPermissionSchema = z
-  .enum(['user.profile.read', 'user.location.read', 'chat.history.read', 'chat.current.read'])
+  .enum(['user.profile.read', 'user.list', 'user.location.read', 'chat.history.read', 'chat.current.read'])
   .describe('User data access permission')
 
 /**

package/src/types.context.ts

@@ -319,6 +319,7 @@ export interface UserProfile {
  */
 export interface UserAPI {
   getProfile(): Promise<UserProfile>
+  listIds(): Promise<string[]>
 }
 
 /**

package/src/types.contributions.ts

@@ -374,13 +374,20 @@ export interface ToolDefinition {
   /** Parameter schema (JSON Schema) */
   parameters?: Record<string, unknown>
   /**
-   * Confirmation configuration. If set, user must confirm before tool runs.
-   * If not set, tool runs without confirmation.
+   * Whether this tool requires user confirmation before execution.
+   * Defaults to true if not specified — tools require confirmation unless explicitly opted out.
    */
-  confirmation?: ToolConfirmationConfig
+  requiresConfirmation?: boolean
+  /**
+   * Optional custom confirmation prompt to show the user.
+   * Only used when confirmation is required.
+   * @example { en: "Allow sending email?", sv: "Tillåt att skicka e-post?" }
+   */
+  confirmationPrompt?: LocalizedString
 }
 
 /**
+ * @deprecated Use `requiresConfirmation` and `confirmationPrompt` directly on ToolDefinition instead.
  * Configuration for tool confirmation.
  */
 export interface ToolConfirmationConfig {

package/src/types.permissions.ts

@@ -24,6 +24,7 @@ export type StoragePermission = 'storage.collections' | 'secrets.manage'
 /** User data permissions */
 export type UserDataPermission =
   | 'user.profile.read'
+  | 'user.list'
   | 'user.location.read'
   | 'chat.history.read'
   | 'chat.current.read'