@stackable-labs/sdk-extension-contracts 1.84.1 → 1.86.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { ISOTimestamp, MarketplaceMetadata } from '@stackable-labs/lib-contracts';
-export { AppRegistryEntry, ClerkOrgId, ClerkUserId, EXTENSION_CATEGORY, EXTENSION_VISIBILITY, ExtensionCategory, ExtensionVisibility, ISOTimestamp, MarketplaceMetadata, asClerkOrgId, asClerkUserId, asISOTimestamp } from '@stackable-labs/lib-contracts';
+import { ISOTimestamp, FieldDefinition, MarketplaceMetadata } from '@stackable-labs/lib-contracts';
+export { AppRegistryEntry, ClerkOrgId, ClerkUserId, EXTENSION_CATEGORY, EXTENSION_VISIBILITY, ExtensionCategory, ExtensionVisibility, FieldDefinition, FieldOption, ISOTimestamp, MarketplaceMetadata, asClerkOrgId, asClerkUserId, asISOTimestamp } from '@stackable-labs/lib-contracts';
 
 /**
  * Shared primitive types used across contracts.
@@ -465,10 +465,12 @@ interface ContextData {
     customerName?: string;
     identity?: IdentityState;
     messaging?: MessagingContext;
+    /** Non-secret extension settings for this specific extension on this specific instance. Never includes secret field values. */
+    settings?: Record<string, unknown>;
     [key: string]: unknown;
 }
 /** Keys managed exclusively by the host RPC layer — must not appear in surface-level context */
-declare const RESERVED_CONTEXT_KEYS: readonly ["identity", "messaging"];
+declare const RESERVED_CONTEXT_KEYS: readonly ["identity", "messaging", "settings"];
 type ReservedContextKey = typeof RESERVED_CONTEXT_KEYS[number];
 /** Union of all capability call types */
 type CapabilityCall = {
@@ -643,6 +645,8 @@ interface ExtensionManifest {
      * Use an empty array for extensions that do not use data.fetch.
      */
     allowedDomains: string[];
+    /** Optional schema of configurable fields for per-instance settings (plaintext + secrets). */
+    settingsSchema?: FieldDefinition[];
 }
 /**
  * Registry entry for an installed extension (returned by /api/extensions).

package/dist/index.js

@@ -342,7 +342,7 @@ var INVOKE_ACTION = {
   SET_CONVERSATION_TAGS: "setConversationTags",
   SET_CONVERSATION_FIELDS: "setConversationFields"
 };
-var RESERVED_CONTEXT_KEYS = ["identity", "messaging"];
+var RESERVED_CONTEXT_KEYS = ["identity", "messaging", "settings"];
 
 // src/identity.ts
 var IDENTITY_EVENT = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackable-labs/sdk-extension-contracts",
-  "version": "1.84.1",
+  "version": "1.86.0",
   "type": "module",
   "private": false,
   "main": "./dist/index.js",