@clowder-ai/plugin-contract 0.1.0-beta.29 → 0.1.0-beta.37

package/dist/generated/contract.generated.d.ts

@@ -16,10 +16,20 @@ export type PackageIcon = {
     readonly src: PackageAssetPath & `${string}.png`;
 };
 export type PluginIcon = 'github' | PackageIcon;
+export type PluginMember = {
+    readonly catId: string;
+    readonly displayName: string;
+    readonly defaultModel: string;
+    readonly nickname?: string;
+    readonly variantLabel?: string;
+    readonly roleDescription?: string;
+    readonly avatar?: string;
+    readonly available: boolean;
+};
 export type SemVer = string;
 export type DataClass = 'cache' | 'ephemeral' | 'user-authored' | 'derived-user-visible' | 'relationship' | 'interaction-history';
 export type DataStrategy = 'lifecycle' | 'retained' | 'ask-on-uninstall';
-export type Capability = 'plugin.config.read' | 'plugin.state.get' | 'plugin.state.set' | 'messaging.send' | 'schedule.register' | 'events.publish' | 'messaging.appendElements' | 'onMessage' | 'message.event.subscribe' | 'secret.read' | 'thread.listMetadata' | 'thread.readContent' | 'memory.query' | 'memory.append' | 'memory.retrieve' | 'windows.create' | 'whisper.extend';
+export type Capability = 'plugin.config.read' | 'plugin.state.get' | 'plugin.state.set' | 'messaging.send' | 'schedule.register' | 'messaging.appendElements' | 'streams.read' | 'onMessage' | 'message.event.subscribe' | 'secret.read' | 'thread.listMetadata' | 'thread.readContent' | 'thread.write' | 'task.read' | 'task.write' | 'task.admitEntrusted' | 'memory.query' | 'memory.append' | 'memory.retrieve' | 'windows.create' | 'whisper.extend' | 'cloud.conversation.host';
 export type DataDeclaration = {
     readonly name: string;
     readonly dataClass: 'cache';
@@ -56,7 +66,7 @@ export type ResourceReference = {
     readonly id: string;
 };
 export type ContributionReference = {
-    readonly type: 'identity' | 'schedule' | 'tool' | 'mcp' | 'skill' | 'limb' | 'webhook' | 'message-subscription' | 'service' | 'connector' | 'ui' | 'content-editor-provider' | 'desktop-window';
+    readonly type: 'identity' | 'schedule' | 'tool' | 'mcp' | 'skill' | 'limb' | 'webhook' | 'message-subscription' | 'media-source' | 'service' | 'connector' | 'cloud-conversation-host' | 'ui' | 'content-editor-provider' | 'desktop-window';
     readonly id: string;
 };
 export type PackageRelativePath = string;
@@ -66,54 +76,94 @@ export type ConfigurationOption = {
     readonly hint?: string;
     readonly docsUrl?: string;
 };
+export type RequiredWhen = {
+    readonly key: string;
+    readonly value: string | number | boolean | readonly (string | number | boolean)[];
+};
 export type ConfigurationField = {
     readonly key: string;
     readonly label: string;
     readonly description?: string;
     readonly kind: 'string';
     readonly required: boolean;
+    readonly hidden?: boolean;
+    readonly requiredWhen?: RequiredWhen;
     readonly default?: string;
     readonly options?: never;
+    readonly target?: never;
+    readonly actions?: never;
 } | {
     readonly key: string;
     readonly label: string;
     readonly description?: string;
     readonly kind: 'secret';
     readonly required: boolean;
+    readonly hidden?: boolean;
+    readonly requiredWhen?: RequiredWhen;
     readonly default?: never;
     readonly options?: never;
+    readonly target?: never;
+    readonly actions?: never;
 } | {
     readonly key: string;
     readonly label: string;
     readonly description?: string;
     readonly kind: 'select';
     readonly required: boolean;
+    readonly hidden?: boolean;
+    readonly requiredWhen?: RequiredWhen;
     readonly default?: string;
     readonly options: readonly ConfigurationOption[];
+    readonly target?: never;
+    readonly actions?: never;
 } | {
     readonly key: string;
     readonly label: string;
     readonly description?: string;
     readonly kind: 'boolean';
     readonly required: boolean;
+    readonly hidden?: boolean;
+    readonly requiredWhen?: RequiredWhen;
     readonly default?: boolean;
     readonly options?: never;
+    readonly target?: never;
+    readonly actions?: never;
 } | {
     readonly key: string;
     readonly label: string;
     readonly description?: string;
     readonly kind: 'number';
     readonly required: boolean;
+    readonly hidden?: boolean;
+    readonly requiredWhen?: RequiredWhen;
     readonly default?: number;
     readonly options?: never;
+    readonly target?: never;
+    readonly actions?: never;
 } | {
     readonly key: string;
     readonly label: string;
     readonly description?: string;
     readonly kind: 'url';
     readonly required: boolean;
+    readonly hidden?: boolean;
+    readonly requiredWhen?: RequiredWhen;
     readonly default?: string;
     readonly options?: never;
+    readonly target?: never;
+    readonly actions?: never;
+} | {
+    readonly key: string;
+    readonly label: string;
+    readonly description?: string;
+    readonly kind: 'operation';
+    readonly required: boolean;
+    readonly hidden?: never;
+    readonly requiredWhen?: never;
+    readonly default?: never;
+    readonly options?: never;
+    readonly target?: readonly string[];
+    readonly actions: readonly ActionDef[];
 };
 export type EnvironmentBinding = {
     readonly source: 'config';
@@ -131,6 +181,56 @@ export type CallbackAction = {
     readonly method: string;
     readonly params?: Readonly<Record<string, unknown>>;
 };
+export type ActionDef = {
+    readonly id: string;
+    readonly label: string;
+    readonly render: 'button' | 'polling' | 'status' | 'row';
+    readonly confirm?: string;
+    readonly action: CallbackAction;
+    readonly resultRender?: string;
+    readonly next?: string;
+    readonly rollback?: string;
+    readonly timeout?: number;
+};
+export type OperationRows = {
+    readonly rows: readonly OperationRow[];
+    readonly empty?: string;
+};
+export type OperationRow = {
+    readonly key: string;
+    readonly label: string;
+    readonly detail?: string;
+    readonly actions?: readonly OperationRowAction[];
+};
+export type OperationRowAction = {
+    readonly action: string;
+    readonly label?: string;
+    readonly input: Readonly<Record<string, string | number | boolean>>;
+    readonly confirm?: string;
+};
+export type OperationActionResult = {
+    readonly render: string;
+    readonly data: unknown;
+    readonly label?: string;
+    readonly targetValues?: Readonly<Record<string, string>>;
+    readonly advance?: boolean;
+    readonly activate?: boolean;
+};
+export type PluginTestDeclaration = {
+    readonly action: CallbackAction;
+};
+export type PluginTestResult = {
+    readonly ok: boolean;
+    readonly message?: string;
+    readonly details?: Readonly<Record<string, unknown>>;
+};
+export type SetupStep = {
+    readonly text: string;
+    readonly mode?: string;
+};
+export type ConnectorPermissions = {
+    readonly label: string;
+};
 export type IdentityContribution = {
     readonly type: 'identity';
     readonly id: string;
@@ -162,10 +262,14 @@ export type DirectToolContribution = {
     readonly inputSchema: Readonly<Record<string, unknown>>;
     readonly action: CallbackAction;
 };
+export type McpActionMethod = {
+    readonly method: string;
+};
 export type McpContribution = {
     readonly type: 'mcp';
     readonly id: string;
     readonly runtime: ContributionRuntime;
+    readonly actions?: readonly McpActionMethod[];
     readonly environment?: Readonly<Record<string, EnvironmentBinding>>;
 };
 export type SkillContribution = {
@@ -182,7 +286,7 @@ export type WebhookContribution = {
     readonly type: 'webhook';
     readonly id: string;
     readonly path: string;
-    readonly methods: readonly ('GET' | 'POST' | 'PUT' | 'DELETE')[];
+    readonly methods: readonly ('GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE')[];
     readonly action: CallbackAction;
     readonly verificationSecretRef?: string;
 };
@@ -192,6 +296,12 @@ export type MessageSubscriptionContribution = {
     readonly binding: string;
     readonly filter?: Readonly<Record<string, unknown>>;
     readonly action: CallbackAction;
+    readonly presentation?: 'v1' | 'v2';
+};
+export type MediaSourceContribution = {
+    readonly type: 'media-source';
+    readonly id: string;
+    readonly binding: string;
 };
 export type ServiceContribution = {
     readonly type: 'service';
@@ -207,6 +317,95 @@ export type ConnectorContribution = {
     readonly inboundMethod: string;
     readonly outboundMethod: string;
 };
+export type CloudConversationHostMethod = {
+    readonly method: string;
+};
+export type CloudConversationHostContribution = {
+    readonly type: 'cloud-conversation-host';
+    readonly id: string;
+    readonly provider: 'chatgpt';
+    readonly appendMessage: CloudConversationHostMethod;
+    readonly assistantReturns: {
+        readonly list: CloudConversationHostMethod;
+        readonly ack: CloudConversationHostMethod;
+    };
+};
+export type CloudBridgeDomFingerprintNodeV1 = {
+    readonly path: string;
+    readonly kind: 'text' | 'element' | 'other';
+    readonly empty?: boolean;
+    readonly tag?: string;
+    readonly nodeType?: number;
+    readonly childCount?: number;
+    readonly contentEditable?: boolean;
+    readonly proseMirror?: boolean;
+    readonly placeholder?: boolean;
+    readonly virtualKeyboard?: boolean;
+    readonly trailingBreak?: boolean;
+};
+export type CloudBridgeDomFingerprintV1 = {
+    readonly v: 1;
+    readonly phase: string;
+    readonly adapterRevision: string;
+    readonly artifactRevision: string;
+    readonly firstUnsupportedPath?: string;
+    readonly nodes: readonly CloudBridgeDomFingerprintNodeV1[];
+    readonly truncated: boolean;
+};
+export type CloudBridgeFailureDiagnosticV1 = {
+    readonly v: 1;
+    readonly errorCode: string;
+    readonly nextAction: 'inspect_bound_tab';
+    readonly fingerprint: CloudBridgeDomFingerprintV1;
+};
+export type CloudConversationAppendMessageInput = {
+    readonly conversationId: string;
+    readonly text: string;
+    readonly idempotencyKey: MessageId;
+};
+export type CloudConversationAppendMessageAppendedResult = {
+    readonly status: 'appended';
+    readonly providerMessageId: string;
+    readonly idempotentReplay?: boolean;
+};
+export type CloudConversationAppendMessageFailedResult = {
+    readonly status: 'failed';
+    readonly errorCode: string;
+    readonly diagnostic?: CloudBridgeFailureDiagnosticV1;
+    readonly idempotentReplay?: boolean;
+};
+export type CloudConversationAppendMessageResult = CloudConversationAppendMessageAppendedResult | CloudConversationAppendMessageFailedResult;
+export type CloudConversationReturnCursor = {
+    readonly conversationId: string;
+    readonly sourceMessageId: MessageId;
+    readonly assistantMessageId: string;
+};
+export type CloudConversationAssistantReturn = {
+    readonly conversationId: string;
+    readonly sourceMessageId: MessageId;
+    readonly assistantMessageId: string;
+    readonly content: string;
+};
+export type CloudConversationListInput = {
+    readonly after?: CloudConversationReturnCursor;
+};
+export type CloudConversationListResult = {
+    readonly returns: readonly CloudConversationAssistantReturn[];
+};
+export type CloudConversationAckInput = {
+    readonly conversationId: string;
+    readonly sourceMessageId: MessageId;
+    readonly assistantMessageId: string;
+};
+export type CloudConversationAcknowledgedResult = {
+    readonly status: 'acknowledged';
+};
+export type CloudConversationAckFailedResult = {
+    readonly status: 'failed';
+    readonly errorCode: string;
+    readonly diagnostic?: CloudBridgeFailureDiagnosticV1;
+};
+export type CloudConversationAckResult = CloudConversationAcknowledgedResult | CloudConversationAckFailedResult;
 export type UiWhenClause = {
     readonly featureEnabled?: boolean;
     readonly requiresCapabilities?: readonly Capability[];
@@ -282,7 +481,7 @@ export type ContentEditorProviderContribution = {
     readonly semanticMaterializer?: SemanticMaterializerDeclaration;
     readonly operations: readonly ['load' | 'settle' | 'comment' | 'tracked-change', 'load' | 'settle' | 'comment' | 'tracked-change', 'load' | 'settle' | 'comment' | 'tracked-change', 'load' | 'settle' | 'comment' | 'tracked-change'];
 };
-export type StaticContribution = IdentityContribution | ScheduleContribution | DirectToolContribution | McpContribution | SkillContribution | LimbContribution | WebhookContribution | MessageSubscriptionContribution | ServiceContribution | ConnectorContribution | UiContribution | ContentEditorProviderContribution | DesktopWindowContribution;
+export type StaticContribution = IdentityContribution | ScheduleContribution | DirectToolContribution | McpContribution | SkillContribution | LimbContribution | WebhookContribution | MessageSubscriptionContribution | MediaSourceContribution | ServiceContribution | ConnectorContribution | CloudConversationHostContribution | UiContribution | ContentEditorProviderContribution | DesktopWindowContribution;
 export type PluginFeature = {
     readonly id: string;
     readonly name: string;
@@ -299,6 +498,7 @@ export type ExternalRuntimeDeclaration = {
 export type BuiltinRuntimeDeclaration = {
     readonly transport: 'builtin';
     readonly entrypoint?: string;
+    readonly dataDirectory?: string;
 };
 export type RuntimeDeclaration = ExternalRuntimeDeclaration | BuiltinRuntimeDeclaration;
 export type PluginManifest = {
@@ -312,7 +512,10 @@ export type PluginManifest = {
     readonly contributions?: readonly StaticContribution[];
     readonly features: readonly PluginFeature[];
     readonly data?: readonly DataDeclaration[];
-    readonly runtime: RuntimeDeclaration;
+    readonly runtime?: RuntimeDeclaration;
+    readonly test?: PluginTestDeclaration;
+    readonly permissions?: ConnectorPermissions;
+    readonly steps?: readonly SetupStep[];
     readonly signals?: SignalContribution;
 };
 export type CatalogSemVer = string;
@@ -369,25 +572,6 @@ export type SignalDeclaration = {
 export type SignalContribution = {
     readonly provides: readonly SignalDeclaration[];
 };
-export type SignalEventId = string;
-export type SignalIdempotencyKey = string;
-export type OpaqueSourceHandle = string;
-export type SignalSourceRef = {
-    readonly handle: OpaqueSourceHandle;
-};
-export type EventsPublishInput = {
-    readonly signalType: SignalType;
-    readonly eventId: SignalEventId;
-    readonly idempotencyKey: SignalIdempotencyKey;
-    readonly occurredAt: string;
-    readonly payload: Readonly<Record<string, unknown>>;
-    readonly source: SignalSourceRef;
-};
-export type EventsPublishDisposition = 'accepted' | 'duplicate';
-export type EventsPublishResult = {
-    readonly publicationId: SignalEventId;
-    readonly disposition: EventsPublishDisposition;
-};
 export type ActorKind = 'user' | 'cat' | 'plugin' | 'device' | 'system';
 export type ActorRef = {
     readonly kind: ActorKind;
@@ -422,12 +606,34 @@ export type DraftProvenance = {
     readonly origin?: DraftOrigin;
     readonly epistemicStatus: EpistemicStatus;
 };
-export type ElementKind = 'text' | 'media_ref' | 'rich_block';
+export type MediaType = 'image' | 'file' | 'audio' | 'video';
+export type ElementKind = 'text' | 'media_ref' | 'rich_block' | 'media_unavailable' | 'media_warning';
 export type TextElementPayload = {
     readonly text: string;
 };
-export type MediaRefElementPayload = Readonly<Record<string, unknown>>;
-export type RichBlockElementPayload = Readonly<Record<string, unknown>>;
+export type MediaRefElementPayload = {
+    readonly type: MediaType;
+    readonly reference: string;
+    readonly sourceId?: string;
+    readonly fileName?: string;
+    readonly [key: string]: unknown;
+};
+export type RichBlockElementPayload = {
+    readonly id: string;
+    readonly kind: string;
+    readonly v: 1;
+    readonly [key: string]: unknown;
+};
+export type MediaUnavailableElementPayload = {
+    readonly type: MediaType;
+    readonly fileName?: string;
+    readonly reason: 'source_expired' | 'timeout' | 'unavailable';
+};
+export type MediaWarningElementPayload = {
+    readonly mediaElementId: string;
+    readonly stage: 'transcription' | 'preview';
+    readonly reason: 'timeout' | 'processing_failed';
+};
 export type TextMessageElement = {
     readonly elementId: string;
     readonly kind: 'text';
@@ -442,6 +648,12 @@ export type MediaRefMessageElement = {
     readonly derivedFromElementId?: string;
     readonly epistemicStatus?: EpistemicStatus;
 };
+export type PmrMediaRefElementMatch = {
+    readonly kind: 'media_ref';
+    readonly payload: {
+        readonly reference: string;
+    };
+};
 export type RichBlockMessageElement = {
     readonly elementId: string;
     readonly kind: 'rich_block';
@@ -449,7 +661,21 @@ export type RichBlockMessageElement = {
     readonly derivedFromElementId?: string;
     readonly epistemicStatus?: EpistemicStatus;
 };
-export type MessageElement = TextMessageElement | MediaRefMessageElement | RichBlockMessageElement;
+export type MediaUnavailableMessageElement = {
+    readonly elementId: string;
+    readonly kind: 'media_unavailable';
+    readonly payload: MediaUnavailableElementPayload;
+    readonly derivedFromElementId?: string;
+    readonly epistemicStatus?: EpistemicStatus;
+};
+export type MediaWarningMessageElement = {
+    readonly elementId: string;
+    readonly kind: 'media_warning';
+    readonly payload: MediaWarningElementPayload;
+    readonly derivedFromElementId?: string;
+    readonly epistemicStatus?: EpistemicStatus;
+};
+export type MessageElement = TextMessageElement | MediaRefMessageElement | RichBlockMessageElement | MediaUnavailableMessageElement | MediaWarningMessageElement;
 export type MessagePayload = {
     readonly provenance: MessageProvenance;
     readonly elements: readonly MessageElement[];
@@ -483,20 +709,22 @@ export type SystemAudience = {
 };
 export type DraftAudience = PublicAudience | WhisperAudience;
 export type CanonicalAudience = PublicAudience | WhisperAudience | SystemAudience;
+export type MessageId = string;
 export type MessageDraft = {
     readonly address: MessageAddress;
     readonly draftAudience?: DraftAudience;
     readonly idempotencyKey: string;
     readonly sourceEventId?: string;
-    readonly replyTo?: string;
+    readonly replyTo?: MessageId;
     readonly payload: DraftPayload;
 };
 export type OccurredAt = string | string;
+export type ThreadId = string;
 export type MessageEnvelope = {
-    readonly messageId: string;
+    readonly messageId: MessageId;
     readonly revision: number;
-    readonly threadId: string;
-    readonly replyTo?: string;
+    readonly threadId: ThreadId;
+    readonly replyTo?: MessageId;
     readonly actor: ActorRef;
     readonly audience: CanonicalAudience;
     readonly occurredAt: OccurredAt;
@@ -512,8 +740,8 @@ export type MessageElementsAppendEvent = {
     readonly eventId: string;
     readonly sequence: number;
     readonly type: 'message.elements.append';
-    readonly messageId: string;
-    readonly threadId: string;
+    readonly messageId: MessageId;
+    readonly threadId: ThreadId;
     readonly operationId: string;
     readonly baseRevision?: number;
     readonly revision: number;
@@ -521,19 +749,20 @@ export type MessageElementsAppendEvent = {
 };
 export type MessageOutputEvent = MessagePublishEvent | MessageElementsAppendEvent;
 export type SendReceipt = {
-    readonly messageId: string;
-    readonly threadId: string;
+    readonly messageId: MessageId;
+    readonly threadId: ThreadId;
     readonly revision: number;
     readonly messageHandle: MessageHandle;
     readonly publishSequence?: number;
+    readonly pendingPublication?: true;
 };
 export type AppendReceipt = {
-    readonly messageId: string;
+    readonly messageId: MessageId;
     readonly revision: number;
     readonly appendSequence?: number;
     readonly appliedElementIds: readonly string[];
 };
-export type MessagingErrorCode = 'VALIDATION' | 'PERMISSION' | 'NOT_FOUND' | 'CONFLICT' | 'RETRYABLE_INFLIGHT' | 'STALE_CURSOR';
+export type MessagingErrorCode = 'VALIDATION' | 'PERMISSION' | 'NOT_FOUND' | 'CONFLICT' | 'RETRYABLE_INFLIGHT' | 'STALE_CURSOR' | 'MEDIA_ACCESS_DENIED' | 'MESSAGE_NOT_PUBLISHED';
 export type MessageHandle = {
     readonly kind: 'message';
     readonly token: string;
@@ -565,6 +794,87 @@ export type SnapshotResponse = {
     readonly envelopes: readonly MessageEnvelope[];
     readonly resumeSequence: number;
 };
+export type FrontendDisplayUrl = string;
+export type DeliveryPresentationActor = {
+    readonly displayName: string;
+    readonly emoji: string;
+};
+export type DeliveryPresentationThread = {
+    readonly shortId: string;
+    readonly title?: string;
+    readonly featId?: string;
+};
+export type DeliveryPresentationContext = {
+    readonly actor: DeliveryPresentationActor;
+    readonly thread: DeliveryPresentationThread;
+    readonly deepLinkUrl?: FrontendDisplayUrl;
+};
+export type MediaReadInput = {
+    readonly reference: string;
+    readonly offset: number;
+    readonly limit: number;
+};
+export type MediaReadResult = {
+    readonly offset: number;
+    readonly dataBase64: string;
+    readonly nextOffset?: number;
+    readonly done: boolean;
+};
+export type PluginMessageDelivery = {
+    readonly kind: 'message';
+    readonly deliveryId: string;
+    readonly threadId: ThreadId;
+    readonly executionId?: string;
+    readonly envelope: MessageEnvelope;
+    readonly presentation?: DeliveryPresentationContext;
+};
+export type PluginExecutionStartedDelivery = {
+    readonly deliveryId: string;
+    readonly threadId: ThreadId;
+    readonly state: 'started';
+    readonly presentation: DeliveryPresentationContext;
+    readonly placeholderLine?: string;
+    readonly replyTo?: MessageId;
+    readonly executionId: string;
+    readonly kind: 'execution_status';
+};
+export type PluginExecutionCatchingUpDelivery = {
+    readonly deliveryId: string;
+    readonly threadId: ThreadId;
+    readonly state: 'catching_up';
+    readonly executionId: string;
+    readonly kind: 'execution_status';
+};
+export type PluginExecutionBlockedDelivery = {
+    readonly deliveryId: string;
+    readonly threadId: ThreadId;
+    readonly state: 'blocked';
+    readonly reason: string;
+    readonly recoveryUrl?: FrontendDisplayUrl;
+    readonly executionId: string;
+    readonly kind: 'execution_status';
+};
+export type PluginExecutionResumedDelivery = {
+    readonly deliveryId: string;
+    readonly threadId: ThreadId;
+    readonly state: 'resumed';
+    readonly executionId: string;
+    readonly kind: 'execution_status';
+};
+export type PluginExecutionSettledDelivery = {
+    readonly deliveryId: string;
+    readonly threadId: ThreadId;
+    readonly state: 'settled';
+    readonly chainDone: boolean;
+    readonly outcome: 'completed' | 'failed' | 'cancelled';
+    readonly executionId: string;
+    readonly kind: 'execution_status';
+};
+export type PluginExecutionStatusDelivery = PluginExecutionStartedDelivery | PluginExecutionCatchingUpDelivery | PluginExecutionBlockedDelivery | PluginExecutionResumedDelivery | PluginExecutionSettledDelivery;
+export type PluginDeliveryInput = PluginMessageDelivery | PluginExecutionStatusDelivery;
+export type PluginDeliveryReceipt = {
+    readonly deliveryId: string;
+};
 export type M0CSubscribeInput = {
     readonly handle: string;
 };
@@ -612,14 +922,67 @@ export type M0CSnapshotFinalResult = {
     readonly snapshotAckToken: string;
 };
 export type M0CSnapshotResult = M0CSnapshotIntermediateResult | M0CSnapshotFinalResult;
-export type M0CDeliverInput = {
-    readonly deliveryId: string;
-    readonly threadHandle: ThreadHandleAddress;
-    readonly envelope: MessageEnvelope;
-};
-export type M0CDeliverResult = {
-    readonly deliveryId: string;
-};
+export declare const ACTOR_KIND_VALUES: readonly ["user", "cat", "plugin", "device", "system"];
+export declare const ACTOR_REF_KEYS: readonly ["kind", "id"];
+export declare const EPISTEMIC_STATUS_VALUES: readonly ["observation", "user_intent", "inference"];
+export declare const EXTERNAL_SOURCE_ADDRESS_KEYS: readonly ["connectorId", "chatId", "messageId"];
+export declare const PLUGIN_ORIGIN_KEYS: readonly ["kind", "instanceId"];
+export declare const EXTERNAL_ORIGIN_KEYS: readonly ["kind", "connectorId", "sourceAddress"];
+export declare const HOST_ORIGIN_KEYS: readonly ["kind"];
+export declare const MESSAGE_PROVENANCE_KEYS: readonly ["origin", "epistemicStatus"];
+export declare const DRAFT_PROVENANCE_KEYS: readonly ["origin", "epistemicStatus"];
+export declare const MEDIA_TYPE_VALUES: readonly ["image", "file", "audio", "video"];
+export declare const ELEMENT_KIND_VALUES: readonly ["text", "media_ref", "rich_block", "media_unavailable", "media_warning"];
+export declare const TEXT_ELEMENT_PAYLOAD_KEYS: readonly ["text"];
+export declare const MEDIA_UNAVAILABLE_ELEMENT_PAYLOAD_KEYS: readonly ["type", "fileName", "reason"];
+export declare const MEDIA_WARNING_ELEMENT_PAYLOAD_KEYS: readonly ["mediaElementId", "stage", "reason"];
+export declare const TEXT_MESSAGE_ELEMENT_KEYS: readonly ["elementId", "kind", "payload", "derivedFromElementId", "epistemicStatus"];
+export declare const MEDIA_REF_MESSAGE_ELEMENT_KEYS: readonly ["elementId", "kind", "payload", "derivedFromElementId", "epistemicStatus"];
+export declare const RICH_BLOCK_MESSAGE_ELEMENT_KEYS: readonly ["elementId", "kind", "payload", "derivedFromElementId", "epistemicStatus"];
+export declare const MEDIA_UNAVAILABLE_MESSAGE_ELEMENT_KEYS: readonly ["elementId", "kind", "payload", "derivedFromElementId", "epistemicStatus"];
+export declare const MEDIA_WARNING_MESSAGE_ELEMENT_KEYS: readonly ["elementId", "kind", "payload", "derivedFromElementId", "epistemicStatus"];
+export declare const MESSAGE_PAYLOAD_KEYS: readonly ["provenance", "elements", "correlationId", "causationId"];
+export declare const DRAFT_PAYLOAD_KEYS: readonly ["provenance", "elements", "correlationId", "causationId"];
+export declare const THREAD_HANDLE_ADDRESS_KEYS: readonly ["kind", "handle"];
+export declare const CONNECTOR_BINDING_ADDRESS_KEYS: readonly ["kind", "handle"];
+export declare const PUBLIC_AUDIENCE_KEYS: readonly ["kind"];
+export declare const WHISPER_AUDIENCE_KEYS: readonly ["kind", "targets"];
+export declare const SYSTEM_AUDIENCE_KEYS: readonly ["kind"];
+export declare const MESSAGE_DRAFT_KEYS: readonly ["address", "draftAudience", "idempotencyKey", "sourceEventId", "replyTo", "payload"];
+export declare const MESSAGE_ENVELOPE_KEYS: readonly ["messageId", "revision", "threadId", "replyTo", "actor", "audience", "occurredAt", "payload"];
+export declare const MESSAGE_PUBLISH_EVENT_KEYS: readonly ["eventId", "sequence", "type", "envelope"];
+export declare const MESSAGE_ELEMENTS_APPEND_EVENT_KEYS: readonly ["eventId", "sequence", "type", "messageId", "threadId", "operationId", "baseRevision", "revision", "elements"];
+export declare const SEND_RECEIPT_KEYS: readonly ["messageId", "threadId", "revision", "messageHandle", "publishSequence", "pendingPublication"];
+export declare const APPEND_RECEIPT_KEYS: readonly ["messageId", "revision", "appendSequence", "appliedElementIds"];
+export declare const MESSAGING_ERROR_CODE_VALUES: readonly ["VALIDATION", "PERMISSION", "NOT_FOUND", "CONFLICT", "RETRYABLE_INFLIGHT", "STALE_CURSOR", "MEDIA_ACCESS_DENIED", "MESSAGE_NOT_PUBLISHED"];
+export declare const MESSAGE_HANDLE_KEYS: readonly ["kind", "token"];
+export declare const APPEND_ELEMENTS_REQUEST_KEYS: readonly ["handle", "operationId", "baseRevision", "elements"];
+export declare const SUBSCRIPTION_NORMAL_RESPONSE_KEYS: readonly ["events", "ackToken", "stale"];
+export declare const SUBSCRIPTION_EMPTY_RESPONSE_KEYS: readonly ["events", "ackToken", "stale"];
+export declare const SUBSCRIPTION_STALE_RESPONSE_KEYS: readonly ["events", "ackToken", "stale"];
+export declare const SNAPSHOT_RESPONSE_KEYS: readonly ["envelopes", "resumeSequence"];
+export declare const DELIVERY_PRESENTATION_ACTOR_KEYS: readonly ["displayName", "emoji"];
+export declare const DELIVERY_PRESENTATION_THREAD_KEYS: readonly ["shortId", "title", "featId"];
+export declare const DELIVERY_PRESENTATION_CONTEXT_KEYS: readonly ["actor", "thread", "deepLinkUrl"];
+export declare const MEDIA_READ_INPUT_KEYS: readonly ["reference", "offset", "limit"];
+export declare const MEDIA_READ_RESULT_KEYS: readonly ["offset", "dataBase64", "nextOffset", "done"];
+export declare const PLUGIN_MESSAGE_DELIVERY_KEYS: readonly ["kind", "deliveryId", "threadId", "executionId", "envelope", "presentation"];
+export declare const PLUGIN_EXECUTION_STARTED_DELIVERY_KEYS: readonly ["deliveryId", "threadId", "state", "presentation", "placeholderLine", "replyTo", "executionId", "kind"];
+export declare const PLUGIN_EXECUTION_CATCHING_UP_DELIVERY_KEYS: readonly ["deliveryId", "threadId", "state", "executionId", "kind"];
+export declare const PLUGIN_EXECUTION_BLOCKED_DELIVERY_KEYS: readonly ["deliveryId", "threadId", "state", "reason", "recoveryUrl", "executionId", "kind"];
+export declare const PLUGIN_EXECUTION_RESUMED_DELIVERY_KEYS: readonly ["deliveryId", "threadId", "state", "executionId", "kind"];
+export declare const PLUGIN_EXECUTION_SETTLED_DELIVERY_KEYS: readonly ["deliveryId", "threadId", "state", "chainDone", "outcome", "executionId", "kind"];
+export declare const PLUGIN_DELIVERY_RECEIPT_KEYS: readonly ["deliveryId"];
+export declare const M0CSUBSCRIBE_INPUT_KEYS: readonly ["handle"];
+export declare const M0CSUBSCRIBE_RESULT_KEYS: readonly ["subscriptionId"];
+export declare const M0CREAD_INPUT_KEYS: readonly ["subscriptionId", "limit"];
+export declare const M0CREAD_NORMAL_RESULT_KEYS: readonly ["events", "ackToken", "stale"];
+export declare const M0CREAD_EMPTY_RESULT_KEYS: readonly ["events", "ackToken", "stale"];
+export declare const M0CREAD_STALE_RESULT_KEYS: readonly ["events", "ackToken", "stale"];
+export declare const M0CACK_INPUT_KEYS: readonly ["subscriptionId", "ackToken"];
+export declare const M0CSNAPSHOT_INPUT_KEYS: readonly ["subscriptionId", "maxItems", "pageToken"];
+export declare const M0CSNAPSHOT_INTERMEDIATE_RESULT_KEYS: readonly ["items", "nextPageToken", "snapshotAckToken"];
+export declare const M0CSNAPSHOT_FINAL_RESULT_KEYS: readonly ["items", "nextPageToken", "snapshotAckToken"];
 export type PhysicalLimbIdentifier = string;
 export type PhysicalLimbGrant = 'limb.action.motion' | 'limb.action.display' | 'limb.action.light' | 'limb.action.speaker' | 'limb.observe.touch' | 'limb.sensor.microphone' | 'limb.sensor.camera';
 export type PhysicalLimbSafePose = {
@@ -837,12 +1200,10 @@ export type CompanionScreenFrame = {
 export type CompanionCommand = {
     readonly kind: 'state';
 } | {
-    readonly kind: 'text';
-    readonly v: 2;
-    readonly scopeRef: CompanionConversationScopeRef;
-    readonly text: string;
-    readonly clientMessageId: CompanionClientMessageId;
-    readonly submissionRevision: number;
+    readonly kind: 'work.read';
+} | {
+    readonly kind: 'work.open';
+    readonly entryRef: string;
 } | {
     readonly kind: 'prepare';
 } | {
@@ -885,11 +1246,6 @@ export type CompanionCommand = {
     readonly observedAt: number;
     readonly callId: CompanionCallId;
     readonly reference: CompanionPresentationReference;
-} | {
-    readonly kind: 'work.read';
-} | {
-    readonly kind: 'work.open';
-    readonly entryRef: string;
 } | {
     readonly kind: 'decisions.read';
     readonly offset: number;
@@ -991,6 +1347,13 @@ export type CompanionCommand = {
     readonly clientMessageId: CompanionClientMessageId;
 } | {
     readonly kind: 'transcript.read';
+} | {
+    readonly kind: 'text';
+    readonly v: 2;
+    readonly scopeRef: CompanionConversationScopeRef;
+    readonly text: string;
+    readonly clientMessageId: CompanionClientMessageId;
+    readonly submissionRevision: number;
 };
 export type CompanionActor = {
     readonly catId: string;
@@ -1596,7 +1959,7 @@ export type PermissionMatrixEntry = {
     readonly firstPartyPreset: boolean;
 };
 export type PermissionMatrixInput = {
-    readonly entries: readonly [PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry];
+    readonly entries: readonly [PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry, PermissionMatrixEntry];
 };
 export type DeleteReplayEventsInput = {
     readonly subscriptionId: string;
@@ -1765,14 +2128,14 @@ export type BehaviorFixture = {
 };
 export declare const L0_CAPABILITIES: readonly ["plugin.config.read", "plugin.state.get", "plugin.state.set"];
 export type L0Capability = (typeof L0_CAPABILITIES)[number];
-export declare const L1_CAPABILITIES: readonly ["messaging.send", "schedule.register", "events.publish", "messaging.appendElements"];
+export declare const L1_CAPABILITIES: readonly ["messaging.send", "schedule.register", "messaging.appendElements", "streams.read"];
 export type L1Capability = (typeof L1_CAPABILITIES)[number];
-export declare const L2_CAPABILITIES: readonly ["onMessage", "message.event.subscribe", "secret.read", "thread.listMetadata", "thread.readContent", "memory.query", "memory.append", "memory.retrieve", "windows.create", "whisper.extend"];
+export declare const L2_CAPABILITIES: readonly ["onMessage", "message.event.subscribe", "secret.read", "thread.listMetadata", "thread.readContent", "thread.write", "task.read", "task.write", "task.admitEntrusted", "memory.query", "memory.append", "memory.retrieve", "windows.create", "whisper.extend", "cloud.conversation.host"];
 export type L2Capability = (typeof L2_CAPABILITIES)[number];
 export declare const CAPABILITY_TABLE: {
     readonly L0: readonly ["plugin.config.read", "plugin.state.get", "plugin.state.set"];
-    readonly L1: readonly ["messaging.send", "schedule.register", "events.publish", "messaging.appendElements"];
-    readonly L2: readonly ["onMessage", "message.event.subscribe", "secret.read", "thread.listMetadata", "thread.readContent", "memory.query", "memory.append", "memory.retrieve", "windows.create", "whisper.extend"];
+    readonly L1: readonly ["messaging.send", "schedule.register", "messaging.appendElements", "streams.read"];
+    readonly L2: readonly ["onMessage", "message.event.subscribe", "secret.read", "thread.listMetadata", "thread.readContent", "thread.write", "task.read", "task.write", "task.admitEntrusted", "memory.query", "memory.append", "memory.retrieve", "windows.create", "whisper.extend", "cloud.conversation.host"];
 };
 export type AuthorizationLayer = keyof typeof CAPABILITY_TABLE;
 export declare const DATA_CLASS_ALLOWED_STRATEGIES: {