@xpert-ai/plugin-sdk 3.19.0 → 3.21.0

package/model-provider.cjs.js

@@ -6,6 +6,46 @@ var common = require('@nestjs/common');
 var tools = require('@langchain/core/tools');
 var v3 = require('zod/v3');
 
+function createRuntimeCapability(id, options = {}) {
+    return Object.freeze({
+        id,
+        description: options.description
+    });
+}
+const XPERT_RUNTIME_CAPABILITIES_TOKEN = 'XPERT_RUNTIME_CAPABILITIES';
+/** Metadata key under which RuntimeCapabilityProviderExplorer discovers capability providers. */ const RUNTIME_CAPABILITY_PROVIDER = 'XPERT_RUNTIME_CAPABILITY_PROVIDER';
+/** Tags a Nest provider as the platform implementation of a runtime capability. */ const RuntimeCapabilityProvider = (capability)=>common.SetMetadata(RUNTIME_CAPABILITY_PROVIDER, capability);
+class DefaultRuntimeCapabilityRegistry {
+    register(key, implementation) {
+        this.capabilities.set(runtimeCapabilityId(key), implementation);
+        return this;
+    }
+    has(key) {
+        var _this_parent;
+        return this.capabilities.has(runtimeCapabilityId(key)) || ((_this_parent = this.parent) == null ? void 0 : _this_parent.get(key)) !== undefined;
+    }
+    get(key) {
+        var _this_parent;
+        const id = runtimeCapabilityId(key);
+        return this.capabilities.has(id) ? this.capabilities.get(id) : (_this_parent = this.parent) == null ? void 0 : _this_parent.get(key);
+    }
+    require(key) {
+        const implementation = this.get(key);
+        if (!implementation) {
+            throw new Error(`Runtime capability '${runtimeCapabilityId(key)}' is not available`);
+        }
+        return implementation;
+    }
+    constructor(entries = [], parent){
+        this.capabilities = new Map();
+        this.parent = parent;
+        entries.forEach(([key, implementation])=>this.register(key, implementation));
+    }
+}
+function runtimeCapabilityId(key) {
+    return typeof key === 'string' ? key : key.id;
+}
+
 /**
  * Base ability for all toolsets
  */ class BaseToolset extends tools.BaseToolkit {
@@ -147,68 +187,6 @@ class BuiltinToolset extends BaseToolset {
 } 
 BuiltinToolset.provider = '';
 
-function createRuntimeCapability(id, options = {}) {
-    return Object.freeze({
-        id,
-        description: options.description
-    });
-}
-const XPERT_RUNTIME_CAPABILITIES_TOKEN = 'XPERT_RUNTIME_CAPABILITIES';
-/** Metadata key under which RuntimeCapabilityProviderExplorer discovers capability providers. */ const RUNTIME_CAPABILITY_PROVIDER = 'XPERT_RUNTIME_CAPABILITY_PROVIDER';
-/** Tags a Nest provider as the platform implementation of a runtime capability. */ const RuntimeCapabilityProvider = (capability)=>common.SetMetadata(RUNTIME_CAPABILITY_PROVIDER, capability);
-class DefaultRuntimeCapabilityRegistry {
-    register(key, implementation) {
-        this.capabilities.set(runtimeCapabilityId(key), implementation);
-        return this;
-    }
-    has(key) {
-        var _this_parent;
-        return this.capabilities.has(runtimeCapabilityId(key)) || ((_this_parent = this.parent) == null ? void 0 : _this_parent.get(key)) !== undefined;
-    }
-    get(key) {
-        var _this_parent;
-        const id = runtimeCapabilityId(key);
-        return this.capabilities.has(id) ? this.capabilities.get(id) : (_this_parent = this.parent) == null ? void 0 : _this_parent.get(key);
-    }
-    require(key) {
-        const implementation = this.get(key);
-        if (!implementation) {
-            throw new Error(`Runtime capability '${runtimeCapabilityId(key)}' is not available`);
-        }
-        return implementation;
-    }
-    constructor(entries = [], parent){
-        this.capabilities = new Map();
-        this.parent = parent;
-        entries.forEach(([key, implementation])=>this.register(key, implementation));
-    }
-}
-function runtimeCapabilityId(key) {
-    return typeof key === 'string' ? key : key.id;
-}
-
-const KnowledgebaseRuntimeCapability = createRuntimeCapability('platform.knowledgebase', {
-    description: 'List, search, and write chunks in platform knowledgebases.'
-});
-const KnowledgebaseProvisioningRuntimeCapability = createRuntimeCapability('platform.knowledgebase.provisioning', {
-    description: 'Idempotently provision managed platform knowledgebases and connect them to an Agent.'
-});
-
-const KnowledgeGraphRuntimeCapability = createRuntimeCapability('platform.knowledge-graph', {
-    description: 'Publish, inspect, and retract source-owned structured knowledge graphs without model extraction.'
-});
-
-const KnowledgebaseDocumentsRuntimeCapability = createRuntimeCapability('platform.knowledgebase.documents', {
-    description: 'Upload, import, create, process, reprocess, inspect, and delete persistent knowledgebase documents.'
-});
-
-const KnowledgeDocumentVisualAssetsRuntimeCapability = createRuntimeCapability('platform.knowledgebase.visual-assets', {
-    description: 'Issue execution-scoped logical KnowledgeDocument image paths and inject validated images without exposing host storage paths.'
-});
-const KnowledgeDocumentVisualAssetsRuntimeFactoryCapability = createRuntimeCapability('platform.knowledge-document.visual-assets.factory', {
-    description: 'Create a visual-assets API with an execution-local image allow-list and authorized workspace writer.'
-});
-
 const ActorTokenRuntimeCapability = createRuntimeCapability('platform.actor-token', {
     description: 'Mint a short-lived host-issued actor bearer token for outbound API calls.'
 });
@@ -272,6 +250,10 @@ const ProjectAccessRuntimeCapability = createRuntimeCapability('platform.project
     description: 'Resolve human Project membership for platform and plugin operations.'
 });
 
+const ToolImagesRuntimeCapability = createRuntimeCapability('platform.tool-images', {
+    description: 'Save scoped immutable tool images and materialize verified pixels for one model request.'
+});
+
 /**
  * Shared host-runtime plumbing for built-in tools backed by a configured model provider.
  * Provider request/response semantics remain owned by each plugin.
@@ -393,12 +375,6 @@ exports.BaseTool = BaseTool;
 exports.BaseToolset = BaseToolset;
 exports.BuiltinToolset = BuiltinToolset;
 exports.DefaultRuntimeCapabilityRegistry = DefaultRuntimeCapabilityRegistry;
-exports.KnowledgeDocumentVisualAssetsRuntimeCapability = KnowledgeDocumentVisualAssetsRuntimeCapability;
-exports.KnowledgeDocumentVisualAssetsRuntimeFactoryCapability = KnowledgeDocumentVisualAssetsRuntimeFactoryCapability;
-exports.KnowledgeGraphRuntimeCapability = KnowledgeGraphRuntimeCapability;
-exports.KnowledgebaseDocumentsRuntimeCapability = KnowledgebaseDocumentsRuntimeCapability;
-exports.KnowledgebaseProvisioningRuntimeCapability = KnowledgebaseProvisioningRuntimeCapability;
-exports.KnowledgebaseRuntimeCapability = KnowledgebaseRuntimeCapability;
 exports.ModelProviderBuiltinToolset = ModelProviderBuiltinToolset;
 exports.ProjectAccessRuntimeCapability = ProjectAccessRuntimeCapability;
 exports.ProjectProvisioningRuntimeCapability = ProjectProvisioningRuntimeCapability;
@@ -408,6 +384,7 @@ exports.SANDBOX_JOB_ERROR_CODES = SANDBOX_JOB_ERROR_CODES;
 exports.SANDBOX_JOB_PROGRESS_PREFIX = SANDBOX_JOB_PROGRESS_PREFIX;
 exports.SandboxJobRuntimeError = SandboxJobRuntimeError;
 exports.SandboxJobsRuntimeCapability = SandboxJobsRuntimeCapability;
+exports.ToolImagesRuntimeCapability = ToolImagesRuntimeCapability;
 exports.WORKSPACE_FILES_SOURCE = WORKSPACE_FILES_SOURCE;
 exports.WorkspaceFilesRuntimeCapability = WorkspaceFilesRuntimeCapability;
 exports.XPERT_RUNTIME_CAPABILITIES_TOKEN = XPERT_RUNTIME_CAPABILITIES_TOKEN;

package/model-provider.esm.js

@@ -1,9 +1,49 @@
 import { _ as _extends } from './_extends.esm.js';
 import { AiModelTypeEnum } from '@xpert-ai/contracts';
-import { Logger, SetMetadata } from '@nestjs/common';
+import { SetMetadata, Logger } from '@nestjs/common';
 import { BaseToolkit, StructuredTool } from '@langchain/core/tools';
 import { z } from 'zod/v3';
 
+function createRuntimeCapability(id, options = {}) {
+    return Object.freeze({
+        id,
+        description: options.description
+    });
+}
+const XPERT_RUNTIME_CAPABILITIES_TOKEN = 'XPERT_RUNTIME_CAPABILITIES';
+/** Metadata key under which RuntimeCapabilityProviderExplorer discovers capability providers. */ const RUNTIME_CAPABILITY_PROVIDER = 'XPERT_RUNTIME_CAPABILITY_PROVIDER';
+/** Tags a Nest provider as the platform implementation of a runtime capability. */ const RuntimeCapabilityProvider = (capability)=>SetMetadata(RUNTIME_CAPABILITY_PROVIDER, capability);
+class DefaultRuntimeCapabilityRegistry {
+    register(key, implementation) {
+        this.capabilities.set(runtimeCapabilityId(key), implementation);
+        return this;
+    }
+    has(key) {
+        var _this_parent;
+        return this.capabilities.has(runtimeCapabilityId(key)) || ((_this_parent = this.parent) == null ? void 0 : _this_parent.get(key)) !== undefined;
+    }
+    get(key) {
+        var _this_parent;
+        const id = runtimeCapabilityId(key);
+        return this.capabilities.has(id) ? this.capabilities.get(id) : (_this_parent = this.parent) == null ? void 0 : _this_parent.get(key);
+    }
+    require(key) {
+        const implementation = this.get(key);
+        if (!implementation) {
+            throw new Error(`Runtime capability '${runtimeCapabilityId(key)}' is not available`);
+        }
+        return implementation;
+    }
+    constructor(entries = [], parent){
+        this.capabilities = new Map();
+        this.parent = parent;
+        entries.forEach(([key, implementation])=>this.register(key, implementation));
+    }
+}
+function runtimeCapabilityId(key) {
+    return typeof key === 'string' ? key : key.id;
+}
+
 /**
  * Base ability for all toolsets
  */ class BaseToolset extends BaseToolkit {
@@ -145,68 +185,6 @@ class BuiltinToolset extends BaseToolset {
 } 
 BuiltinToolset.provider = '';
 
-function createRuntimeCapability(id, options = {}) {
-    return Object.freeze({
-        id,
-        description: options.description
-    });
-}
-const XPERT_RUNTIME_CAPABILITIES_TOKEN = 'XPERT_RUNTIME_CAPABILITIES';
-/** Metadata key under which RuntimeCapabilityProviderExplorer discovers capability providers. */ const RUNTIME_CAPABILITY_PROVIDER = 'XPERT_RUNTIME_CAPABILITY_PROVIDER';
-/** Tags a Nest provider as the platform implementation of a runtime capability. */ const RuntimeCapabilityProvider = (capability)=>SetMetadata(RUNTIME_CAPABILITY_PROVIDER, capability);
-class DefaultRuntimeCapabilityRegistry {
-    register(key, implementation) {
-        this.capabilities.set(runtimeCapabilityId(key), implementation);
-        return this;
-    }
-    has(key) {
-        var _this_parent;
-        return this.capabilities.has(runtimeCapabilityId(key)) || ((_this_parent = this.parent) == null ? void 0 : _this_parent.get(key)) !== undefined;
-    }
-    get(key) {
-        var _this_parent;
-        const id = runtimeCapabilityId(key);
-        return this.capabilities.has(id) ? this.capabilities.get(id) : (_this_parent = this.parent) == null ? void 0 : _this_parent.get(key);
-    }
-    require(key) {
-        const implementation = this.get(key);
-        if (!implementation) {
-            throw new Error(`Runtime capability '${runtimeCapabilityId(key)}' is not available`);
-        }
-        return implementation;
-    }
-    constructor(entries = [], parent){
-        this.capabilities = new Map();
-        this.parent = parent;
-        entries.forEach(([key, implementation])=>this.register(key, implementation));
-    }
-}
-function runtimeCapabilityId(key) {
-    return typeof key === 'string' ? key : key.id;
-}
-
-const KnowledgebaseRuntimeCapability = createRuntimeCapability('platform.knowledgebase', {
-    description: 'List, search, and write chunks in platform knowledgebases.'
-});
-const KnowledgebaseProvisioningRuntimeCapability = createRuntimeCapability('platform.knowledgebase.provisioning', {
-    description: 'Idempotently provision managed platform knowledgebases and connect them to an Agent.'
-});
-
-const KnowledgeGraphRuntimeCapability = createRuntimeCapability('platform.knowledge-graph', {
-    description: 'Publish, inspect, and retract source-owned structured knowledge graphs without model extraction.'
-});
-
-const KnowledgebaseDocumentsRuntimeCapability = createRuntimeCapability('platform.knowledgebase.documents', {
-    description: 'Upload, import, create, process, reprocess, inspect, and delete persistent knowledgebase documents.'
-});
-
-const KnowledgeDocumentVisualAssetsRuntimeCapability = createRuntimeCapability('platform.knowledgebase.visual-assets', {
-    description: 'Issue execution-scoped logical KnowledgeDocument image paths and inject validated images without exposing host storage paths.'
-});
-const KnowledgeDocumentVisualAssetsRuntimeFactoryCapability = createRuntimeCapability('platform.knowledge-document.visual-assets.factory', {
-    description: 'Create a visual-assets API with an execution-local image allow-list and authorized workspace writer.'
-});
-
 const ActorTokenRuntimeCapability = createRuntimeCapability('platform.actor-token', {
     description: 'Mint a short-lived host-issued actor bearer token for outbound API calls.'
 });
@@ -270,6 +248,10 @@ const ProjectAccessRuntimeCapability = createRuntimeCapability('platform.project
     description: 'Resolve human Project membership for platform and plugin operations.'
 });
 
+const ToolImagesRuntimeCapability = createRuntimeCapability('platform.tool-images', {
+    description: 'Save scoped immutable tool images and materialize verified pixels for one model request.'
+});
+
 /**
  * Shared host-runtime plumbing for built-in tools backed by a configured model provider.
  * Provider request/response semantics remain owned by each plugin.
@@ -384,4 +366,4 @@ function normalizeWorkspaceScope(scope) {
     } : {});
 }
 
-export { ActorTokenRuntimeCapability as A, BuiltinToolset as B, DefaultRuntimeCapabilityRegistry as D, KnowledgeDocumentVisualAssetsRuntimeCapability as K, ModelProviderBuiltinToolset as M, ProjectAccessRuntimeCapability as P, RUNTIME_CAPABILITY_PROVIDER as R, SANDBOX_JOB_ERROR_CODES as S, WorkspaceFilesRuntimeCapability as W, XPERT_RUNTIME_CAPABILITIES_TOKEN as X, ActorTokenRuntimeFactoryCapability as a, ArtifactsRuntimeCapability as b, createRuntimeCapability as c, BaseTool as d, BaseToolset as e, KnowledgeDocumentVisualAssetsRuntimeFactoryCapability as f, KnowledgeGraphRuntimeCapability as g, KnowledgebaseDocumentsRuntimeCapability as h, KnowledgebaseProvisioningRuntimeCapability as i, KnowledgebaseRuntimeCapability as j, ProjectProvisioningRuntimeCapability as k, RuntimeCapabilityProvider as l, SANDBOX_JOB_PROGRESS_PREFIX as m, SandboxJobRuntimeError as n, SandboxJobsRuntimeCapability as o, WORKSPACE_FILES_SOURCE as p, isSandboxJobRuntimeError as q };
+export { ActorTokenRuntimeCapability as A, BuiltinToolset as B, DefaultRuntimeCapabilityRegistry as D, ModelProviderBuiltinToolset as M, ProjectAccessRuntimeCapability as P, RUNTIME_CAPABILITY_PROVIDER as R, SANDBOX_JOB_ERROR_CODES as S, ToolImagesRuntimeCapability as T, WorkspaceFilesRuntimeCapability as W, XPERT_RUNTIME_CAPABILITIES_TOKEN as X, ActorTokenRuntimeFactoryCapability as a, ArtifactsRuntimeCapability as b, createRuntimeCapability as c, BaseTool as d, BaseToolset as e, ProjectProvisioningRuntimeCapability as f, RuntimeCapabilityProvider as g, SANDBOX_JOB_PROGRESS_PREFIX as h, SandboxJobRuntimeError as i, SandboxJobsRuntimeCapability as j, WORKSPACE_FILES_SOURCE as k, isSandboxJobRuntimeError as l };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xpert-ai/plugin-sdk",
-  "version": "3.19.0",
+  "version": "3.21.0",
   "license": "AGPL-3.0",
   "repository": {
     "type": "git",
@@ -19,6 +19,12 @@
       "import": "./index.cjs.mjs",
       "default": "./index.cjs.js"
     },
+    "./agent-results": {
+      "module": "./agent-results.esm.js",
+      "types": "./agent-results.d.ts",
+      "import": "./agent-results.cjs.mjs",
+      "default": "./agent-results.cjs.js"
+    },
     "./data-workbench": {
       "module": "./data-workbench.esm.js",
       "types": "./data-workbench.d.ts",
@@ -56,7 +62,7 @@
   },
   "dependencies": {
     "@langchain/openai": "0.6.9",
-    "@xpert-ai/contracts": "3.19.0",
+    "@xpert-ai/contracts": "3.21.0",
     "express": "^4.22.1",
     "js-tiktoken": "^1.0.21"
   },

package/results.cjs.js

@@ -0,0 +1,50 @@
+'use strict';
+
+var _extends = require('./_extends.cjs.js');
+var v3 = require('zod/v3');
+var contracts = require('@xpert-ai/contracts');
+
+/** Opt in to the host's authorized, on-demand result View from middleware metadata. */ const AGENT_TASK_RESULTS_FEATURE = 'agent_task_results';
+const common = {
+    id: v3.z.string().regex(/^[a-zA-Z0-9_-]{1,80}$/),
+    title: v3.z.string().min(1).max(200),
+    summary: v3.z.string().max(16000)
+};
+/** Machine-readable result kind; file declarations are not committed artifacts or download grants. */ const agentResultItemSchema = v3.z.discriminatedUnion('type', [
+    v3.z.object(_extends._extends({}, common, {
+        type: v3.z.literal('analysis')
+    })).strict(),
+    v3.z.object(_extends._extends({}, common, {
+        type: v3.z.literal('changes'),
+        files: v3.z.array(v3.z.object({
+            path: contracts.agentResultPathSchema,
+            change: v3.z.enum([
+                'created',
+                'modified',
+                'deleted'
+            ])
+        }).strict()).max(128)
+    })).strict(),
+    v3.z.object(_extends._extends({}, common, {
+        type: v3.z.literal('tests'),
+        status: v3.z.enum([
+            'passed',
+            'failed',
+            'skipped'
+        ]),
+        command: v3.z.string().max(2000).optional()
+    })).strict(),
+    v3.z.object(_extends._extends({}, common, {
+        type: v3.z.literal('file'),
+        path: contracts.agentResultPathSchema
+    })).strict()
+]);
+/** Explicit final response envelope shared by adapters; ordinary prose is never classified heuristically. */ const agentTaskResultSchema = v3.z.object({
+    version: v3.z.literal(1),
+    summary: v3.z.string().max(64000),
+    items: v3.z.array(agentResultItemSchema).max(32)
+}).strict().refine((value)=>new Set(value.items.map((item)=>item.id)).size === value.items.length, 'Result item IDs must be unique');
+
+exports.AGENT_TASK_RESULTS_FEATURE = AGENT_TASK_RESULTS_FEATURE;
+exports.agentResultItemSchema = agentResultItemSchema;
+exports.agentTaskResultSchema = agentTaskResultSchema;

package/results.esm.js

@@ -0,0 +1,46 @@
+import { _ as _extends } from './_extends.esm.js';
+import { z } from 'zod/v3';
+import { agentResultPathSchema } from '@xpert-ai/contracts';
+
+/** Opt in to the host's authorized, on-demand result View from middleware metadata. */ const AGENT_TASK_RESULTS_FEATURE = 'agent_task_results';
+const common = {
+    id: z.string().regex(/^[a-zA-Z0-9_-]{1,80}$/),
+    title: z.string().min(1).max(200),
+    summary: z.string().max(16000)
+};
+/** Machine-readable result kind; file declarations are not committed artifacts or download grants. */ const agentResultItemSchema = z.discriminatedUnion('type', [
+    z.object(_extends({}, common, {
+        type: z.literal('analysis')
+    })).strict(),
+    z.object(_extends({}, common, {
+        type: z.literal('changes'),
+        files: z.array(z.object({
+            path: agentResultPathSchema,
+            change: z.enum([
+                'created',
+                'modified',
+                'deleted'
+            ])
+        }).strict()).max(128)
+    })).strict(),
+    z.object(_extends({}, common, {
+        type: z.literal('tests'),
+        status: z.enum([
+            'passed',
+            'failed',
+            'skipped'
+        ]),
+        command: z.string().max(2000).optional()
+    })).strict(),
+    z.object(_extends({}, common, {
+        type: z.literal('file'),
+        path: agentResultPathSchema
+    })).strict()
+]);
+/** Explicit final response envelope shared by adapters; ordinary prose is never classified heuristically. */ const agentTaskResultSchema = z.object({
+    version: z.literal(1),
+    summary: z.string().max(64000),
+    items: z.array(agentResultItemSchema).max(32)
+}).strict().refine((value)=>new Set(value.items.map((item)=>item.id)).size === value.items.length, 'Result item IDs must be unique');
+
+export { AGENT_TASK_RESULTS_FEATURE as A, agentResultItemSchema as a, agentTaskResultSchema as b };

package/src/agent-results.d.ts

@@ -0,0 +1,2 @@
+/** Browser-safe result contracts. Keep this entry independent of the server SDK barrel. */
+export * from './lib/agent/runtime/results';

package/src/index.d.ts

@@ -2,6 +2,8 @@ export * from './lib/plugin';
 export * from './lib/plugin.interface';
 export * from './lib/plugin-metadata';
 export * from './lib/artifact-namespace';
+export * from './lib/resource-card';
+export * from './lib/resource-card-provider';
 export * from './lib/types';
 export * from './lib/logger';
 export * from './lib/integration/index';
@@ -30,3 +32,4 @@ export * from './lib/mcp/index';
 export * from './lib/tool-provider/index';
 export * from './lib/project-type/index';
 export * from './lib/project-task/index';
+export * from './lib/agent-plugin/import-default-agent-plugins.command';

package/src/lib/agent/handoff/agent-chat.contract.d.ts

@@ -1,8 +1,10 @@
-import { TChatOptions, TChatRequest, TChatRuntimePrincipal, TChatSourceAuditOptions } from '@xpert-ai/contracts';
+import { TChatMessageEnvelope, TChatOptions, TChatRequest, TChatRuntimePrincipal, TChatSourceAuditOptions } from '@xpert-ai/contracts';
 export declare const AGENT_CHAT_DISPATCH_MESSAGE_TYPE: import("./message-type").StructuredHandoffMessageType;
 export declare const AGENT_CHAT_DISPATCH_ERROR_STEER_TARGET_NOT_RUNNING = "steer_target_not_running";
 export interface AgentChatHandoffMessageCallbackTarget {
     transport?: 'handoff-message';
+    /** Defaults to all events; lifecycle emits only terminal callbacks, leaving tokens in the run stream. */
+    events?: 'all' | 'lifecycle';
     messageType: string;
     headers?: Record<string, string>;
     context?: Record<string, unknown>;
@@ -16,11 +18,18 @@ export type AgentChatRuntimePrincipal = TChatRuntimePrincipal;
 export interface AgentChatDispatchPayload extends Record<string, unknown> {
     request: TChatRequest;
     options: TChatOptions & TChatSourceAuditOptions & {
+        /** Host-created group recipient receipt; the runtime must reauthorize it before execution. */
+        groupDeliveryId?: string;
+        /** Host-resolved runtime branch, independent of the conversation root. */
+        threadId?: string;
+        isDerivedThread?: boolean;
         xpertId?: string;
         isDraft?: boolean;
         from?: string;
         fromEndUserId?: string;
         runtimePrincipal?: AgentChatRuntimePrincipal;
+        /** Host-resolved provenance and presentation; never grants routing or execution privileges. */
+        messageEnvelope?: TChatMessageEnvelope;
         execution?: {
             id: string;
         };