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

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

@@ -1,11 +1,35 @@
 /**
- * Generated from manifest.schema.json, messaging.schema.json, and behavior-fixture.schema.json.
+ * Generated from plugin-metadata.schema.json, manifest.schema.json, catalog.schema.json, signal.schema.json, messaging.schema.json, physical-limb.schema.json, docx-materialization.schema.json, and behavior-fixture.schema.json.
  * Do not edit by hand. Run `pnpm generate` after changing a schema.
  */
+export type LocalizedDescriptionObject = {
+    readonly default: string;
+    readonly translations: Readonly<Record<string, string>>;
+};
+export type LocalizedDescription = string | LocalizedDescriptionObject;
+export type PackageAssetPath = string;
+export type PackageIcon = {
+    readonly type: 'svg';
+    readonly src: PackageAssetPath & `${string}.svg`;
+} | {
+    readonly type: 'png';
+    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';
@@ -41,21 +65,440 @@ export type ResourceReference = {
     readonly type: string;
     readonly id: string;
 };
+export type ContributionReference = {
+    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;
+export type ConfigurationOption = {
+    readonly value: string;
+    readonly label: string;
+    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';
+    readonly key: string;
+} | {
+    readonly source: 'secret';
+    readonly key: string;
+};
+export type ContributionRuntime = {
+    readonly transport: 'stdio' | 'ipc';
+    readonly entrypoint: PackageRelativePath;
+    readonly args?: readonly string[];
+};
+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;
+    readonly displayName: string;
+    readonly icon?: string;
+    readonly color?: string;
+};
+export type ScheduleContribution = {
+    readonly type: 'schedule';
+    readonly id: string;
+    readonly schedule: {
+        readonly kind: 'interval';
+        readonly everyMs: number;
+    } | {
+        readonly kind: 'cron';
+        readonly expression: string;
+    };
+    readonly action: CallbackAction;
+    readonly policy: {
+        readonly overlap: 'skip';
+        readonly timeoutMs: number;
+    };
+};
+export type DirectToolContribution = {
+    readonly type: 'tool';
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    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 = {
+    readonly type: 'skill';
+    readonly id: string;
+    readonly path: PackageRelativePath;
+};
+export type LimbContribution = {
+    readonly type: 'limb';
+    readonly id: string;
+    readonly manifestPath: PackageRelativePath;
+};
+export type WebhookContribution = {
+    readonly type: 'webhook';
+    readonly id: string;
+    readonly path: string;
+    readonly methods: readonly ('GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE')[];
+    readonly action: CallbackAction;
+    readonly verificationSecretRef?: string;
+};
+export type MessageSubscriptionContribution = {
+    readonly type: 'message-subscription';
+    readonly id: string;
+    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';
+    readonly id: string;
+    readonly runtime: ContributionRuntime;
+    readonly healthMethod: string;
+    readonly environment?: Readonly<Record<string, EnvironmentBinding>>;
+};
+export type ConnectorContribution = {
+    readonly type: 'connector';
+    readonly id: string;
+    readonly identityRef: string;
+    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[];
+};
+export type UiAnchor = {
+    readonly position: 'before' | 'after';
+    readonly target: string;
+};
+export type UiCommandContribution = {
+    readonly type: 'ui';
+    readonly id: string;
+    readonly kind: 'command';
+    readonly label: string;
+    readonly action: CallbackAction;
+    readonly when?: UiWhenClause;
+};
+export type UiSlotItemContribution = {
+    readonly type: 'ui';
+    readonly id: string;
+    readonly kind: 'slot-item';
+    readonly label: string;
+    readonly command: string;
+    readonly group: string;
+    readonly anchor?: UiAnchor;
+    readonly order?: number;
+    readonly when?: UiWhenClause;
+};
+export type UiMessageElementContribution = {
+    readonly type: 'ui';
+    readonly id: string;
+    readonly kind: 'message-element';
+    readonly label: string;
+    readonly elementKind: string;
+    readonly renderer: string;
+    readonly when?: UiWhenClause;
+};
+export type UiContribution = UiCommandContribution | UiSlotItemContribution | UiMessageElementContribution;
+export type SemanticMaterializerDeclaration = {
+    readonly executionClass: 'dedicated-browser-worker';
+    readonly entrypoint: PackageRelativePath & `${string}.js`;
+    readonly integrity: string;
+    readonly protocolVersion: '1.0.0';
+};
+export type DesktopWindowContribution = {
+    readonly type: 'desktop-window';
+    readonly id: string;
+    readonly role: 'companion';
+    readonly surface: {
+        readonly entrypoint: PackageRelativePath & `${string}.html`;
+        readonly integrity: string;
+    };
+    readonly bridgeVersion: '1.0.0' | '1.1.0' | '1.2.0' | '1.3.0' | '1.4.0' | '1.5.0' | '1.6.0';
+    readonly presentation: {
+        readonly width: number;
+        readonly height: number;
+        readonly transparent: true;
+        readonly frame: false;
+        readonly alwaysOnTop: boolean;
+        readonly skipTaskbar: boolean;
+    };
+};
+export type ContentEditorProviderContribution = {
+    readonly type: 'content-editor-provider';
+    readonly id: string;
+    readonly mediaTypes: readonly ['application/vnd.openxmlformats-officedocument.wordprocessingml.document'];
+    readonly surface: {
+        readonly entrypoint: PackageRelativePath;
+        readonly integrity: string;
+        readonly sandbox: 'dedicated-origin-iframe';
+        readonly navigationPolicy: 'navigation-api-deny';
+    };
+    readonly bridgeVersion: '1.0.0';
+    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 | MediaSourceContribution | ServiceContribution | ConnectorContribution | CloudConversationHostContribution | UiContribution | ContentEditorProviderContribution | DesktopWindowContribution;
 export type PluginFeature = {
     readonly id: string;
     readonly name: string;
     readonly resources: readonly ResourceReference[];
+    readonly contributions?: readonly ContributionReference[];
     readonly capabilities: readonly Capability[];
 };
 export type RuntimeTransport = 'stdio' | 'ipc' | 'builtin';
 export type ExternalRuntimeTransport = 'stdio' | 'ipc';
 export type ExternalRuntimeDeclaration = {
     readonly transport: ExternalRuntimeTransport;
-    readonly entrypoint: string;
+    readonly entrypoint: PackageRelativePath;
 };
 export type BuiltinRuntimeDeclaration = {
     readonly transport: 'builtin';
     readonly entrypoint?: string;
+    readonly dataDirectory?: string;
 };
 export type RuntimeDeclaration = ExternalRuntimeDeclaration | BuiltinRuntimeDeclaration;
 export type PluginManifest = {
@@ -63,10 +506,71 @@ export type PluginManifest = {
     readonly version: SemVer;
     readonly contractVersion: SemVer;
     readonly name: string;
-    readonly description?: string;
+    readonly description?: LocalizedDescription;
+    readonly icon?: PluginIcon;
+    readonly configuration?: readonly ConfigurationField[];
+    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;
+export type CatalogPublisher = {
+    readonly id: string;
+    readonly name: string;
+};
+export type ArtifactProvenance = {
+    readonly repository: string;
+    readonly sourceDirectory: string;
+};
+export type NpmArtifact = {
+    readonly kind: 'npm';
+    readonly packageName: string;
+    readonly version: CatalogSemVer;
+    readonly tarballUrl: string;
+    readonly integrity: string;
+    readonly shasum: string;
+    readonly provenance: ArtifactProvenance;
+};
+export type CatalogPluginVersion = {
+    readonly version: CatalogSemVer;
+    readonly contractVersion: CatalogSemVer;
+    readonly manifestPath: 'plugin.yaml';
+    readonly artifact: NpmArtifact;
+};
+export type CatalogPluginEntry = {
+    readonly pluginId: string;
+    readonly name: string;
+    readonly description: LocalizedDescription;
+    readonly icon: PluginIcon;
+    readonly publisher: CatalogPublisher;
+    readonly keywords?: readonly string[];
+    readonly versions: readonly CatalogPluginVersion[];
+};
+export type PluginCatalog = {
+    readonly schemaVersion: '1';
+    readonly plugins: readonly CatalogPluginEntry[];
+};
+export type SignalType = string;
+export type SignalSchemaRef = string;
+export type SignalEpistemicStatus = 'observation' | 'inference';
+export type SignalPrivacyClass = 'behavioral' | 'content-adjacent' | 'content' | 'av-raw' | 'input-raw';
+export type AdmissibleSignalPrivacyClass = 'behavioral' | 'content-adjacent' | 'content';
+export type SignalSourceClass = 'os-metadata' | 'accessibility-api' | 'remote-service' | 'av-capture' | 'input-hardware';
+export type AdmissibleSignalSourceClass = 'os-metadata' | 'accessibility-api' | 'remote-service';
+export type SignalDeclaration = {
+    readonly type: SignalType;
+    readonly schemaRef: SignalSchemaRef;
+    readonly epistemicStatus: SignalEpistemicStatus;
+    readonly privacyClass: AdmissibleSignalPrivacyClass;
+    readonly sourceClass: AdmissibleSignalSourceClass;
+};
+export type SignalContribution = {
+    readonly provides: readonly SignalDeclaration[];
 };
 export type ActorKind = 'user' | 'cat' | 'plugin' | 'device' | 'system';
 export type ActorRef = {
@@ -102,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';
@@ -122,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';
@@ -129,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[];
@@ -163,22 +709,25 @@ 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: string;
+    readonly occurredAt: OccurredAt;
     readonly payload: MessagePayload;
 };
 export type MessagePublishEvent = {
@@ -191,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;
@@ -200,18 +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;
@@ -229,12 +780,12 @@ export type SubscriptionNormalResponse = {
     readonly stale: false;
 };
 export type SubscriptionEmptyResponse = {
-    readonly events: readonly MessageOutputEvent[];
+    readonly events: readonly [];
     readonly ackToken: null;
     readonly stale: false;
 };
 export type SubscriptionStaleResponse = {
-    readonly events: readonly MessageOutputEvent[];
+    readonly events: readonly [];
     readonly ackToken: null;
     readonly stale: true;
 };
@@ -243,6 +794,1045 @@ 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;
+};
+export type M0CSubscribeResult = {
+    readonly subscriptionId: string;
+};
+export type M0CReadInput = {
+    readonly subscriptionId: string;
+    readonly limit: number;
+};
+export type M0CReadNormalResult = {
+    readonly events: readonly MessageOutputEvent[];
+    readonly ackToken: string;
+    readonly stale: false;
+};
+export type M0CReadEmptyResult = {
+    readonly events: readonly [];
+    readonly ackToken: null;
+    readonly stale: false;
+};
+export type M0CReadStaleResult = {
+    readonly events: readonly [];
+    readonly ackToken: null;
+    readonly stale: true;
+};
+export type M0CReadResult = M0CReadNormalResult | M0CReadEmptyResult | M0CReadStaleResult;
+export type M0CAckInput = {
+    readonly subscriptionId: string;
+    readonly ackToken: string;
+};
+export type M0CAckResult = null;
+export type M0CSnapshotInput = {
+    readonly subscriptionId: string;
+    readonly maxItems: number;
+    readonly pageToken?: string;
+};
+export type M0CSnapshotIntermediateResult = {
+    readonly items: readonly MessageEnvelope[];
+    readonly nextPageToken: string;
+    readonly snapshotAckToken: null;
+};
+export type M0CSnapshotFinalResult = {
+    readonly items: readonly MessageEnvelope[];
+    readonly nextPageToken: null;
+    readonly snapshotAckToken: string;
+};
+export type M0CSnapshotResult = M0CSnapshotIntermediateResult | M0CSnapshotFinalResult;
+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 = {
+    readonly yawDeg: number;
+    readonly pitchDeg: number;
+    readonly timeoutMs: number;
+};
+export type PhysicalLimbContribution = {
+    readonly contributionId: PhysicalLimbIdentifier;
+    readonly nodeType: PhysicalLimbIdentifier;
+    readonly displayName: string;
+    readonly grants: readonly PhysicalLimbGrant[];
+    readonly safePose: PhysicalLimbSafePose;
+};
+export type PhysicalLimbExpressionSource = {
+    readonly kind: 'cat_state' | 'play' | 'degraded';
+    readonly ref: PhysicalLimbIdentifier;
+};
+export type PhysicalLimbTouchPayload = {
+    readonly gesture: 'tap' | 'stroke';
+    readonly durationMs: number;
+    readonly confidence: number;
+};
+export type PhysicalLimbTranscriptPayload = {
+    readonly interactionId: PhysicalLimbIdentifier;
+    readonly text: string;
+    readonly language?: string;
+    readonly captureDurationMs: number;
+};
+export type PhysicalLimbTouchObservation = {
+    readonly v: 1;
+    readonly observationId: PhysicalLimbIdentifier;
+    readonly nodeId: PhysicalLimbIdentifier;
+    readonly occurredAt: string;
+    readonly sessionId: PhysicalLimbIdentifier;
+    readonly kind: 'touch';
+    readonly payload: PhysicalLimbTouchPayload;
+};
+export type PhysicalLimbTranscriptObservation = {
+    readonly v: 1;
+    readonly observationId: PhysicalLimbIdentifier;
+    readonly nodeId: PhysicalLimbIdentifier;
+    readonly occurredAt: string;
+    readonly sessionId: PhysicalLimbIdentifier;
+    readonly kind: 'transcript';
+    readonly payload: PhysicalLimbTranscriptPayload;
+};
+export type PhysicalLimbObservation = PhysicalLimbTouchObservation | PhysicalLimbTranscriptObservation;
+export type PhysicalLimbMotionPayload = {
+    readonly yawDeg: number;
+    readonly pitchDeg: number;
+    readonly speedDps: number;
+    readonly accelerationDps2: number;
+};
+export type PhysicalLimbDisplayPayload = {
+    readonly expression: string;
+    readonly expressionSource: PhysicalLimbExpressionSource;
+};
+export type PhysicalLimbRgb = readonly [number, number, number];
+export type PhysicalLimbLightPayload = {
+    readonly colors: readonly PhysicalLimbRgb[];
+};
+export type PhysicalLimbSpeakerPayload = {
+    readonly text: string;
+    readonly voiceProfileRef: PhysicalLimbIdentifier;
+    readonly volumePercent: number;
+};
+export type PhysicalLimbMotionAction = {
+    readonly v: 1;
+    readonly actionId: PhysicalLimbIdentifier;
+    readonly nodeId: PhysicalLimbIdentifier;
+    readonly deadlineUnixMs: number;
+    readonly timeoutMs: number;
+    readonly cancelToken: PhysicalLimbIdentifier;
+    readonly kind: 'motion';
+    readonly payload: PhysicalLimbMotionPayload;
+};
+export type PhysicalLimbDisplayAction = {
+    readonly v: 1;
+    readonly actionId: PhysicalLimbIdentifier;
+    readonly nodeId: PhysicalLimbIdentifier;
+    readonly deadlineUnixMs: number;
+    readonly timeoutMs: number;
+    readonly cancelToken: PhysicalLimbIdentifier;
+    readonly kind: 'display';
+    readonly payload: PhysicalLimbDisplayPayload;
+};
+export type PhysicalLimbLightAction = {
+    readonly v: 1;
+    readonly actionId: PhysicalLimbIdentifier;
+    readonly nodeId: PhysicalLimbIdentifier;
+    readonly deadlineUnixMs: number;
+    readonly timeoutMs: number;
+    readonly cancelToken: PhysicalLimbIdentifier;
+    readonly kind: 'light';
+    readonly payload: PhysicalLimbLightPayload;
+};
+export type PhysicalLimbSpeakerAction = {
+    readonly v: 1;
+    readonly actionId: PhysicalLimbIdentifier;
+    readonly nodeId: PhysicalLimbIdentifier;
+    readonly deadlineUnixMs: number;
+    readonly timeoutMs: number;
+    readonly cancelToken: PhysicalLimbIdentifier;
+    readonly kind: 'speaker';
+    readonly payload: PhysicalLimbSpeakerPayload;
+};
+export type PhysicalLimbAction = PhysicalLimbMotionAction | PhysicalLimbDisplayAction | PhysicalLimbLightAction | PhysicalLimbSpeakerAction;
+export type PhysicalLimbCancel = {
+    readonly v: 1;
+    readonly nodeId: PhysicalLimbIdentifier;
+    readonly actionId: PhysicalLimbIdentifier;
+    readonly cancelToken: PhysicalLimbIdentifier;
+    readonly reason: 'user' | 'timeout' | 'lease_lost' | 'host_lost' | 'superseded';
+};
+export type PhysicalLimbActionResult = {
+    readonly v: 1;
+    readonly actionId: PhysicalLimbIdentifier;
+    readonly nodeId: PhysicalLimbIdentifier;
+    readonly outcome: 'succeeded' | 'refused' | 'failed' | 'canceled';
+    readonly reason?: string;
+    readonly observedAt: string;
+};
+export type PhysicalLimbReadinessReason = 'gateway_disconnected' | 'device_disconnected' | 'firmware_incompatible' | 'sensor_unavailable' | 'speech_dependency_missing' | 'skin_unavailable' | 'grant_revoked' | 'host_unavailable';
+export type PhysicalLimbReadyReadiness = {
+    readonly v: 1;
+    readonly nodeId: PhysicalLimbIdentifier;
+    readonly status: 'ready';
+    readonly observedAt: string;
+};
+export type PhysicalLimbUnavailableReadiness = {
+    readonly v: 1;
+    readonly nodeId: PhysicalLimbIdentifier;
+    readonly status: 'degraded' | 'offline';
+    readonly reason: PhysicalLimbReadinessReason;
+    readonly observedAt: string;
+};
+export type PhysicalLimbReadiness = PhysicalLimbReadyReadiness | PhysicalLimbUnavailableReadiness;
+export type DocxMaterializationText = string;
+export type DocxMaterializationAuthor = string;
+export type DocxMaterializationBytes = string;
+export type DocxMaterializationAnchor = {
+    readonly paragraphId: string;
+    readonly textQuote: string;
+};
+export type DocxMaterializationAttribution = {
+    readonly author: DocxMaterializationAuthor;
+    readonly operationId: string;
+    readonly timestamp: string;
+};
+export type DocxMaterializationOperation = {
+    readonly kind: 'inspect';
+    readonly cursor: number;
+    readonly limit: number;
+} | {
+    readonly kind: 'tracked-change';
+    readonly target: DocxMaterializationAnchor;
+    readonly replacement: DocxMaterializationText;
+    readonly attribution: DocxMaterializationAttribution;
+} | {
+    readonly kind: 'comment';
+    readonly target: DocxMaterializationAnchor;
+    readonly body: DocxMaterializationText;
+    readonly attribution: DocxMaterializationAttribution;
+};
+export type DocxMaterializationRequest = {
+    readonly protocolVersion: '1.0.0';
+    readonly requestId: string;
+    readonly mediaType: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document';
+    readonly bytesBase64: DocxMaterializationBytes;
+    readonly operation: DocxMaterializationOperation;
+};
+export type DocxMaterializationResult = {
+    readonly kind: 'inspection';
+    readonly paragraphs: readonly ({
+        readonly target: DocxMaterializationAnchor;
+        readonly editable: boolean;
+    })[];
+    readonly nextCursor: number | null;
+} | {
+    readonly kind: 'document';
+    readonly bytesBase64: DocxMaterializationBytes;
+} | {
+    readonly kind: 'rejected';
+    readonly code: 'INVALID_DOCX' | 'TARGET_MISMATCH' | 'UNSUPPORTED_TARGET' | 'LIMIT_EXCEEDED' | 'INVALID_REQUEST';
+};
+export type DocxMaterializationResponse = {
+    readonly protocolVersion: '1.0.0';
+    readonly requestId: string;
+    readonly result: DocxMaterializationResult;
+};
+export type CompanionSelectionId = string;
+export type CompanionCallId = string;
+export type CompanionClientMessageId = string;
+export type CompanionAppAssistRef = string;
+export type CompanionAppAssistAction = 'dismiss' | 'timeout' | 'accept';
+export type CompanionCorrelatableId = string;
+export type CompanionOpaqueReadReference = string;
+export type CompanionConversationScopeRef = string;
+export type CompanionPresentationReference = {
+    readonly kind: 'message';
+    readonly messageId: CompanionCorrelatableId;
+} | {
+    readonly kind: 'native-item';
+    readonly nativeItemId: CompanionCorrelatableId;
+};
+export type CompanionScreenFrame = {
+    readonly image: string;
+    readonly width: number;
+    readonly height: number;
+    readonly frameId: string;
+    readonly sourceLabel: string;
+    readonly observedAt: number;
+};
+export type CompanionCommand = {
+    readonly kind: 'state';
+} | {
+    readonly kind: 'work.read';
+} | {
+    readonly kind: 'work.open';
+    readonly entryRef: string;
+} | {
+    readonly kind: 'prepare';
+} | {
+    readonly kind: 'audio.connect';
+    readonly mode?: 'receive_only';
+} | {
+    readonly kind: 'audio.close';
+} | {
+    readonly kind: 'audio.microphone';
+    readonly muted: boolean;
+} | {
+    readonly kind: 'audio.speaker';
+    readonly muted: boolean;
+} | {
+    readonly kind: 'stop';
+} | {
+    readonly kind: 'text';
+    readonly text: string;
+    readonly clientMessageId: string;
+} | {
+    readonly kind: 'documents';
+    readonly allowed: boolean;
+} | {
+    readonly kind: 'screen.pick';
+} | {
+    readonly kind: 'screen.open';
+    readonly selectionId: CompanionSelectionId;
+    readonly label: string;
+} | {
+    readonly kind: 'screen.frame';
+    readonly selectionId: CompanionSelectionId;
+    readonly frame: CompanionScreenFrame;
+} | {
+    readonly kind: 'screen.close';
+} | {
+    readonly kind: 'conversation.open';
+} | {
+    readonly kind: 'presentation.observe';
+    readonly event: 'first_text_visible';
+    readonly observedAt: number;
+    readonly callId: CompanionCallId;
+    readonly reference: CompanionPresentationReference;
+} | {
+    readonly kind: 'decisions.read';
+    readonly offset: number;
+    readonly limit: number;
+} | {
+    readonly kind: 'decision.open';
+    readonly variantRef: string;
+    readonly target: CompanionDecisionNavigationTarget;
+} | {
+    readonly kind: 'f221.inspect';
+    readonly proposalId: string;
+} | {
+    readonly kind: 'view.resize';
+    readonly expanded: boolean;
+} | {
+    readonly kind: 'view.layout';
+    readonly panel: 'none' | 'bubble' | 'actions' | 'menu' | 'chat' | 'decisions' | 'transcript' | 'settings' | 'app-assist';
+    readonly width: number;
+    readonly height: number;
+    readonly call?: {
+        readonly presentation: 'lite' | 'controls';
+        readonly bubble?: {
+            readonly width: number;
+            readonly height: number;
+        };
+    };
+} | {
+    readonly kind: 'view.drag';
+    readonly phase: 'start' | 'end';
+} | {
+    readonly kind: 'view.hide';
+} | {
+    readonly kind: 'view.reset';
+} | {
+    readonly kind: 'settings.read';
+} | {
+    readonly kind: 'settings.update';
+    readonly field: 'dutyCatProfileId';
+    readonly value: string;
+} | {
+    readonly kind: 'settings.update';
+    readonly field: 'skin';
+    readonly value: 'yarn-ball' | 'ragdoll-v1' | 'yanyan-codex' | 'xianxian-codex';
+} | {
+    readonly kind: 'settings.update';
+    readonly field: 'ballSize';
+    readonly value: number;
+} | {
+    readonly kind: 'settings.update';
+    readonly field: 'behaviorEnabled';
+    readonly value: boolean;
+} | {
+    readonly kind: 'settings.update';
+    readonly field: 'proactivePolicy';
+    readonly value: 'ambient' | 'quiet-badge';
+} | {
+    readonly kind: 'settings.update';
+    readonly field: 'personaTone';
+    readonly value: string;
+} | {
+    readonly kind: 'settings.update';
+    readonly field: 'householdReadsAllowed';
+    readonly value: boolean;
+} | {
+    readonly kind: 'settings.update';
+    readonly field: 'appAssistEnabled';
+    readonly value: boolean;
+} | {
+    readonly kind: 'app-assist.settle';
+    readonly scopeRef: CompanionAppAssistRef;
+    readonly offerRef: CompanionAppAssistRef;
+    readonly action: CompanionAppAssistAction;
+} | {
+    readonly kind: 'companion.disable';
+} | {
+    readonly kind: 'conversation.read';
+} | {
+    readonly kind: 'conversation.read';
+    readonly v: 2;
+    readonly before?: CompanionOpaqueReadReference;
+    readonly limit?: number;
+} | {
+    readonly kind: 'conversation.body.read';
+    readonly v: 2;
+    readonly continuation: CompanionOpaqueReadReference;
+} | {
+    readonly kind: 'conversation.draft.read';
+    readonly v: 1;
+} | {
+    readonly kind: 'conversation.draft.save';
+    readonly v: 1;
+    readonly scopeRef: CompanionConversationScopeRef;
+    readonly expectedRevision: number;
+    readonly text: string;
+} | {
+    readonly kind: 'conversation.delivery.read';
+    readonly v: 1;
+    readonly scopeRef: CompanionConversationScopeRef;
+    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;
+    readonly displayName: string;
+};
+export type CompanionWorkCoverage = {
+    readonly source: 'tasks' | 'messages' | 'artifacts';
+    readonly status: 'available' | 'partial' | 'unavailable';
+};
+export type CompanionWorkActive = {
+    readonly entryRef: string;
+    readonly title: string;
+    readonly actor: CompanionActor | null;
+    readonly activity: 'working' | 'waiting';
+    readonly taskId: string | null;
+    readonly homeThreadId: string | null;
+    readonly sourceRef: string;
+    readonly updatedAt: number;
+};
+export type CompanionWorkDelivery = {
+    readonly entryRef: string;
+    readonly title: string;
+    readonly taskId: string | null;
+    readonly homeThreadId: string | null;
+    readonly sourceRef: string;
+    readonly deliveredAt: number;
+    readonly artifact: null | {
+        readonly artifactId: string;
+        readonly version: string | null;
+        readonly versionState: 'current' | 'superseded' | 'unknown';
+    };
+};
+export type CompanionWorkOverview = {
+    readonly kind: 'work';
+    readonly v: 1;
+    readonly status: 'available' | 'partial' | 'unavailable';
+    readonly observedAt: number;
+    readonly scope: {
+        readonly kind: 'current-project';
+        readonly label: string;
+    };
+    readonly coverage: readonly [CompanionWorkCoverage, CompanionWorkCoverage, CompanionWorkCoverage];
+    readonly active: readonly CompanionWorkActive[];
+    readonly recentDeliveries: readonly CompanionWorkDelivery[];
+};
+export type CompanionIdentitySnapshotV1 = {
+    readonly v: 1;
+    readonly name: '猫猫球';
+    readonly partner: {
+        readonly catId: string;
+        readonly displayName: string;
+        readonly skin: string;
+    };
+    readonly live: {
+        readonly catId: string;
+        readonly displayName: string;
+        readonly transport: 'gpt_live_v3';
+        readonly verifiedModel: string | null;
+    };
+    readonly deep: {
+        readonly catId: string;
+        readonly displayName: string;
+        readonly verifiedModel: string | null;
+    };
+};
+export type CompanionLiveTransport = {
+    readonly kind: 'gpt_live_v3';
+    readonly verifiedModel: null;
+};
+export type CompanionAudioState = {
+    readonly supportedModes: readonly ('duplex' | 'receive_only')[];
+    readonly activeMode: 'duplex' | 'receive_only' | null;
+};
+export type CompanionNativeWorkEntry = {
+    readonly taskId: string;
+    readonly nativeTurnId: string;
+    readonly kind: 'reasoning' | 'tool' | 'workspace_fetch' | 'workspace_dispatch' | 'screen_read';
+    readonly startedAt: number;
+    readonly expiresAt: number;
+};
+export type CompanionNativeWorkEvent = {
+    readonly eventId: string;
+    readonly taskId: string;
+    readonly kind: 'reasoning' | 'tool' | 'workspace_fetch' | 'workspace_dispatch' | 'screen_read' | 'result';
+    readonly phase: 'started' | 'completed' | 'failed' | 'cancelled' | 'expired' | 'result_handed_to_voice';
+    readonly occurredAt: number;
+    readonly expiresAt: number;
+    readonly resultId?: string;
+    readonly nativeCarrierCatId?: string;
+};
+export type CompanionNativeWork = {
+    readonly scopeId: string | null;
+    readonly revision: number;
+    readonly active: readonly CompanionNativeWorkEntry[];
+    readonly recent: readonly CompanionNativeWorkEvent[];
+};
+export type CompanionMeetingState = {
+    readonly kind: 'running';
+    readonly sharing: boolean;
+    readonly paused: boolean;
+    readonly sourceLabel: string | null;
+} | {
+    readonly kind: 'idle' | 'stopped' | 'unconfirmed' | 'needs_source';
+    readonly sharing: false;
+    readonly paused: false;
+    readonly sourceLabel: null;
+};
+export type CompanionAppAssistState = {
+    readonly scopeRef: CompanionAppAssistRef;
+    readonly revision: number;
+    readonly status: 'ready';
+    readonly offer: null | {
+        readonly offerRef: CompanionAppAssistRef;
+        readonly appName: string;
+    };
+} | {
+    readonly scopeRef: CompanionAppAssistRef;
+    readonly revision: number;
+    readonly status: 'off' | 'suspended' | 'unsupported' | 'source_unavailable' | 'permission_required' | 'timezone_required' | 'identity_unavailable';
+    readonly offer: null;
+};
+export type CompanionAppAssistSettlement = {
+    readonly kind: 'app-assist-settlement';
+    readonly scopeRef: CompanionAppAssistRef;
+    readonly revision: number;
+    readonly offerRef: CompanionAppAssistRef;
+    readonly action: CompanionAppAssistAction;
+    readonly outcome: 'settled' | 'stale_offer';
+};
+export type CompanionState = {
+    readonly kind: 'state';
+    readonly phase: 'idle' | 'preparing' | 'ready' | 'connecting' | 'talking' | 'closed' | 'failed';
+    readonly displayName: string;
+    readonly skin: string;
+    readonly duty: CompanionActor;
+    readonly carrier: CompanionActor;
+    readonly documentsAllowed: boolean;
+    readonly behaviorEnabled: boolean;
+    readonly toolsReady: boolean;
+    readonly nativeActivity: 'none' | 'reasoning' | 'tool_running';
+    readonly liveTransport: CompanionLiveTransport;
+    readonly audio?: CompanionAudioState;
+    readonly meeting: CompanionMeetingState;
+    readonly appAssist: CompanionAppAssistState;
+    readonly nativeWork: CompanionNativeWork;
+};
+export type CompanionDecisionNavigationTarget = 'origin' | 'approval_card' | 'action';
+export type CompanionDecisionNavigation = {
+    readonly targets: readonly CompanionDecisionNavigationTarget[];
+};
+export type CompanionDecisionSourceRead = {
+    readonly status: 'available' | 'unavailable' | 'unauthenticated' | 'forbidden' | 'invalid';
+    readonly coverage: 'complete' | 'partial' | 'unknown';
+};
+export type CompanionDecisionSources = {
+    readonly approvals: CompanionDecisionSourceRead;
+    readonly needsMe: CompanionDecisionSourceRead;
+};
+export type CompanionDecisionApproval = {
+    readonly resolution: 'open' | 'accepted' | 'rejected' | 'closed_without_decision';
+    readonly materializationState: 'not_started' | 'outcome_unknown' | 'in_progress' | 'succeeded' | 'failed';
+    readonly linkedNeedsMe: boolean;
+};
+export type CompanionDecisionItem = {
+    readonly variantRef: string;
+    readonly kind: 'approval';
+    readonly summary: string;
+    readonly navigation: CompanionDecisionNavigation;
+    readonly approval: CompanionDecisionApproval;
+} | {
+    readonly variantRef: string;
+    readonly kind: 'judgment' | 'repair';
+    readonly summary: string;
+    readonly navigation: CompanionDecisionNavigation;
+};
+export type CompanionLegacyDecisions = {
+    readonly kind: 'decisions';
+    readonly status: 'available' | 'unavailable';
+    readonly approvalCount: number | null;
+    readonly needsMeCount: number | null;
+    readonly otherNeedsMeCount: number | null;
+    readonly approvals: readonly ({
+        readonly proposalId: string;
+        readonly sourceFeatureId: string;
+        readonly summary: string;
+        readonly resolution: 'open' | 'accepted' | 'rejected' | 'closed_without_decision';
+        readonly materializationState: 'not_started' | 'outcome_unknown' | 'in_progress' | 'succeeded' | 'failed';
+        readonly linkedNeedsMe: boolean;
+    })[];
+    readonly otherNeedsMe: readonly ({
+        readonly subjectRef: string;
+        readonly summary: string;
+    })[];
+    readonly page: {
+        readonly offset: number;
+        readonly limit: number;
+        readonly hasMoreApprovals: boolean;
+        readonly hasMoreNeedsMe: boolean;
+    };
+};
+export type CompanionUnifiedDecisions = {
+    readonly kind: 'decisions';
+    readonly version: 1;
+    readonly status: 'available' | 'partial' | 'unavailable';
+    readonly observedAt: number;
+    readonly sources: CompanionDecisionSources;
+    readonly items: readonly CompanionDecisionItem[];
+    readonly totalCount?: number;
+    readonly page: {
+        readonly offset: number;
+        readonly limit: number;
+        readonly scope: 'known_rows';
+        readonly hasMore: boolean;
+    };
+};
+export type CompanionDecisions = CompanionLegacyDecisions | CompanionUnifiedDecisions;
+export type CompanionDecisionTrial = {
+    readonly kind: 'decision-trial';
+    readonly status: 'dismissed' | 'trial_confirmed' | 'stale' | 'unavailable';
+};
+export type CompanionSettingField = 'dutyCatProfileId' | 'skin' | 'ballSize' | 'behaviorEnabled' | 'proactivePolicy' | 'personaTone' | 'householdReadsAllowed' | 'appAssistEnabled';
+export type CompanionSettingsValues = {
+    readonly dutyCatProfileId: string;
+    readonly skin: 'yarn-ball' | 'ragdoll-v1' | 'yanyan-codex' | 'xianxian-codex';
+    readonly ballSize: number;
+    readonly behaviorEnabled: boolean;
+    readonly proactivePolicy: 'ambient' | 'quiet-badge';
+    readonly personaTone: string;
+    readonly householdReadsAllowed: boolean;
+    readonly appAssistEnabled: boolean;
+};
+export type CompanionSettingsRosterEntry = {
+    readonly catProfileId: string;
+    readonly displayName: string;
+    readonly available: boolean;
+};
+export type CompanionSettings = {
+    readonly kind: 'settings';
+    readonly status: 'available';
+    readonly values: CompanionSettingsValues;
+    readonly companions: readonly CompanionSettingsRosterEntry[];
+    readonly selectedCompanionStatus: 'available' | 'unavailable';
+} | {
+    readonly kind: 'settings';
+    readonly status: 'unavailable';
+    readonly reason: 'host_upgrade_required' | 'temporarily_unavailable';
+};
+export type CompanionSettingsUpdateReceipt = {
+    readonly kind: 'settings-update';
+    readonly field: CompanionSettingField;
+    readonly outcome: 'saved';
+    readonly callStatus: 'unchanged' | 'stopped';
+    readonly applies: 'now' | 'next_call';
+} | {
+    readonly kind: 'settings-update';
+    readonly field: CompanionSettingField;
+    readonly outcome: 'rejected';
+    readonly callStatus: 'unchanged' | 'stopped' | 'stop_failed';
+    readonly reason: 'invalid_value' | 'selection_unavailable' | 'permission_denied' | 'call_stop_failed' | 'save_failed' | 'unsupported';
+} | {
+    readonly kind: 'settings-update';
+    readonly field: CompanionSettingField;
+    readonly outcome: 'unconfirmed';
+    readonly callStatus: 'unchanged' | 'stopped';
+    readonly reconcile: 'settings.read';
+};
+export type CompanionLifecycleReceipt = {
+    readonly kind: 'companion-lifecycle';
+    readonly action: 'disable';
+    readonly outcome: 'disabled';
+};
+export type CompanionTranscriptScope = {
+    readonly callId: CompanionCallId;
+    readonly realtimeSessionId: string;
+};
+export type CompanionTranscriptVoiceSource = {
+    readonly kind: 'voice';
+    readonly nativeThreadId: string;
+    readonly realtimeSessionId: string;
+    readonly nativeItemId: CompanionCorrelatableId;
+    readonly nativeTurnId?: string;
+};
+export type CompanionTranscriptTypedSource = {
+    readonly kind: 'typed';
+    readonly clientMessageId: CompanionClientMessageId;
+    readonly callId: CompanionCallId;
+};
+export type CompanionTranscriptRow = {
+    readonly messageId: CompanionCorrelatableId;
+    readonly role: 'user' | 'assistant';
+    readonly text: string;
+    readonly source: CompanionTranscriptVoiceSource;
+} | {
+    readonly messageId: CompanionCorrelatableId;
+    readonly role: 'user';
+    readonly text: string;
+    readonly source: CompanionTranscriptTypedSource;
+};
+export type CompanionDeliveryReceipt = {
+    readonly kind: 'delivery';
+    readonly delivery: 'accepted';
+    readonly clientMessageId: CompanionClientMessageId;
+    readonly messageId: CompanionCorrelatableId;
+    readonly callId: CompanionCallId | null;
+} | {
+    readonly kind: 'delivery';
+    readonly delivery: 'unconfirmed';
+    readonly clientMessageId: CompanionClientMessageId;
+    readonly messageId: null;
+    readonly callId: CompanionCallId | null;
+};
+export type CompanionDeliveryAcceptedV2 = {
+    readonly kind: 'delivery';
+    readonly v: 2;
+    readonly delivery: 'accepted';
+    readonly clientMessageId: CompanionClientMessageId;
+    readonly messageId: CompanionCorrelatableId;
+    readonly callId: CompanionCallId | null;
+};
+export type CompanionDeliveryUnconfirmedV2 = {
+    readonly kind: 'delivery';
+    readonly v: 2;
+    readonly delivery: 'unconfirmed';
+    readonly clientMessageId: CompanionClientMessageId;
+    readonly messageId: null;
+    readonly callId: CompanionCallId | null;
+};
+export type CompanionDeliveryRejectedV2 = {
+    readonly kind: 'delivery';
+    readonly v: 2;
+    readonly delivery: 'rejected';
+    readonly clientMessageId: CompanionClientMessageId;
+    readonly reason: 'draft_changed' | 'unsupported_draft' | 'pending_limit';
+    readonly draftRevision: number;
+};
+export type CompanionDeliveryReceiptV2 = CompanionDeliveryAcceptedV2 | CompanionDeliveryUnconfirmedV2 | CompanionDeliveryRejectedV2;
+export type CompanionConversationDraftSubmissionV1 = {
+    readonly clientMessageId: CompanionClientMessageId;
+    readonly text: string;
+    readonly submissionRevision: number;
+    readonly receipt: CompanionDeliveryAcceptedV2 | CompanionDeliveryUnconfirmedV2;
+};
+export type CompanionConversationDraftV1 = {
+    readonly kind: 'conversation-draft';
+    readonly v: 1;
+    readonly status: 'available';
+    readonly scopeRef: CompanionConversationScopeRef;
+    readonly revision: number;
+    readonly text: string;
+    readonly writable: boolean;
+    readonly submissions: readonly CompanionConversationDraftSubmissionV1[];
+} | {
+    readonly kind: 'conversation-draft';
+    readonly v: 1;
+    readonly status: 'conflict' | 'readonly';
+    readonly revision: number;
+};
+export type CompanionConversationResponsePhase = 'processing' | 'completed' | 'failed' | 'canceled' | 'interrupted' | null;
+export type CompanionConversationBodyProjection = {
+    readonly revision: CompanionCorrelatableId;
+    readonly complete: true;
+    readonly continuation: null;
+} | {
+    readonly revision: CompanionCorrelatableId;
+    readonly complete: false;
+    readonly continuation: CompanionOpaqueReadReference;
+};
+export type CompanionConversationRowV2 = {
+    readonly id: CompanionCorrelatableId;
+    readonly role: 'user' | 'assistant';
+    readonly name: string;
+    readonly text: string;
+    readonly companionIdentity?: CompanionIdentitySnapshotV1;
+    readonly inputMessageIds: readonly CompanionCorrelatableId[];
+    readonly responsePhase: CompanionConversationResponsePhase;
+    readonly body: CompanionConversationBodyProjection;
+    readonly deliveryReceipt?: CompanionDeliveryAcceptedV2;
+};
+export type CompanionConversationPageV2 = {
+    readonly kind: 'conversation';
+    readonly v: 2;
+    readonly status: 'available';
+    readonly threadTitle: string;
+    readonly messages: readonly CompanionConversationRowV2[];
+    readonly hasMoreOlder: boolean;
+    readonly olderCursor: CompanionOpaqueReadReference | null;
+} | {
+    readonly kind: 'conversation';
+    readonly v: 2;
+    readonly status: 'stale';
+};
+export type CompanionConversationBodyV2 = {
+    readonly kind: 'conversation-body';
+    readonly v: 2;
+    readonly status: 'available';
+    readonly messageId: CompanionCorrelatableId;
+    readonly text: string;
+    readonly body: CompanionConversationBodyProjection;
+} | {
+    readonly kind: 'conversation-body';
+    readonly v: 2;
+    readonly status: 'stale' | 'withdrawn';
+};
+export type CompanionErrorCode = 'invalid_request' | 'permission_required' | 'unavailable' | 'session_required' | 'busy' | 'selection_changed' | 'carrier_unavailable' | 'cancelled' | 'unconfirmed';
+export type CompanionReply = {
+    readonly kind: 'ok';
+} | CompanionState | CompanionWorkOverview | CompanionDecisions | CompanionDecisionTrial | CompanionDeliveryReceipt | CompanionDeliveryReceiptV2 | CompanionConversationDraftV1 | CompanionSettings | CompanionSettingsUpdateReceipt | CompanionLifecycleReceipt | CompanionAppAssistSettlement | {
+    readonly kind: 'selection';
+    readonly selectionId: CompanionSelectionId;
+} | CompanionConversationPageV2 | CompanionConversationBodyV2 | {
+    readonly kind: 'navigation';
+    readonly delivery: 'requested' | 'applied' | 'queued' | 'blocked' | 'unconfirmed';
+} | {
+    readonly kind: 'error';
+    readonly code: CompanionErrorCode;
+} | {
+    readonly kind: 'layout';
+    readonly pet: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly panel: {
+        readonly x: number;
+        readonly y: number;
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly bubble?: {
+        readonly x: number;
+        readonly y: number;
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly width: number;
+    readonly height: number;
+} | {
+    readonly kind: 'conversation';
+    readonly threadTitle: string;
+    readonly messages: readonly ({
+        readonly id: string;
+        readonly role: 'user' | 'assistant';
+        readonly text: string;
+        readonly name: string;
+        readonly companionIdentity?: CompanionIdentitySnapshotV1;
+    })[];
+    readonly hasMore: boolean;
+} | {
+    readonly kind: 'transcript';
+    readonly scope: CompanionTranscriptScope;
+    readonly rows: readonly CompanionTranscriptRow[];
+    readonly hasMore: boolean;
+};
+export type CompanionEvent = {
+    readonly kind: 'media-stopped';
+    readonly reason: 'locked' | 'suspended' | 'hidden' | 'closed' | 'revoked';
+} | {
+    readonly kind: 'audio';
+    readonly type: 'connected' | 'recovering' | 'recovered' | 'error';
+    readonly callId: CompanionCallId;
+} | {
+    readonly kind: 'audio';
+    readonly type: 'transcript';
+    readonly role: 'user' | 'assistant';
+    readonly text: string;
+    readonly callId: CompanionCallId;
+    readonly turnId?: string;
+    readonly itemId?: CompanionCorrelatableId;
+} | {
+    readonly kind: 'audio';
+    readonly type: 'turn-done';
+    readonly role?: 'user' | 'assistant';
+    readonly transcript?: string;
+    readonly callId: CompanionCallId;
+    readonly turnId?: string;
+} | {
+    readonly kind: 'view-dismiss';
+};
+export declare const DOCX_MATERIALIZATION_TEXT_PATTERN = "^[\\u0009\\u000A\\u0020-\\uD7FF\\uE000-\\uFFFD\\u{10000}-\\u{10FFFF}]*(?![\\s\\S])";
+export declare const DOCX_MATERIALIZATION_AUTHOR_PATTERN = "^[\\u0020-\\uD7FF\\uE000-\\uFFFD\\u{10000}-\\u{10FFFF}]*(?![\\s\\S])";
 export type FixtureMetadata = {
     readonly executor: 'loopback';
     readonly domain: 'messaging';
@@ -302,6 +1892,31 @@ export type FixtureOperation = {
     readonly operation: 'deleteReplayEvents';
     readonly input: DeleteReplayEventsInput;
 };
+export type PluginToHostMethod = 'messaging.send' | 'messaging.appendElements' | 'messaging.subscribe' | 'messaging.read' | 'messaging.ack' | 'messaging.snapshot';
+export type BehaviorExpectationOracle = {
+    readonly kind: 'behavior-expectation';
+};
+export type JsonRpcAdmissionOracle = {
+    readonly kind: 'json-rpc-error';
+    readonly code: -32602;
+    readonly sideEffects: 'behavior-expectation';
+};
+export type BehaviorExecution = {
+    readonly plane: 'plugin-to-host-wire';
+    readonly method: PluginToHostMethod;
+    readonly verdictOracle: BehaviorExpectationOracle;
+} | {
+    readonly plane: 'wire-admission';
+    readonly method: PluginToHostMethod;
+    readonly verdictOracle: JsonRpcAdmissionOracle;
+} | {
+    readonly plane: 'host-to-plugin-delivery';
+    readonly method: 'host.messaging.deliver';
+    readonly verdictOracle: BehaviorExpectationOracle;
+} | {
+    readonly plane: 'host-control';
+    readonly verdictOracle: BehaviorExpectationOracle;
+};
 export type SendOperationInput = {
     readonly address: Readonly<Record<string, unknown>>;
     readonly idempotencyKey: string;
@@ -344,7 +1959,7 @@ export type PermissionMatrixEntry = {
     readonly firstPartyPreset: boolean;
 };
 export type PermissionMatrixInput = {
-    readonly entries: readonly 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;
@@ -352,19 +1967,159 @@ export type DeleteReplayEventsInput = {
 };
 export type SideEffectAssertion = {
     readonly target: 'messages' | 'output_events' | 'idempotency_ledger' | 'subscription' | 'snapshot' | 'reply_preview' | 'provenance' | 'grant_state' | 'permission_matrix' | 'replay_events';
-    readonly assertion: 'unchanged' | 'none' | 'state_equals' | 'round_trip' | 'matches';
-    readonly value?: unknown;
+    readonly assertion: 'unchanged';
+    readonly value?: never;
+} | {
+    readonly target: 'messages' | 'output_events' | 'idempotency_ledger' | 'subscription' | 'snapshot' | 'reply_preview' | 'provenance' | 'grant_state' | 'permission_matrix' | 'replay_events';
+    readonly assertion: 'none';
+    readonly value?: never;
+} | {
+    readonly target: 'messages' | 'output_events' | 'idempotency_ledger' | 'subscription' | 'snapshot' | 'reply_preview' | 'provenance' | 'grant_state' | 'permission_matrix' | 'replay_events';
+    readonly assertion: 'state_equals';
+    readonly value: unknown;
+} | {
+    readonly target: 'messages' | 'output_events' | 'idempotency_ledger' | 'subscription' | 'snapshot' | 'reply_preview' | 'provenance' | 'grant_state' | 'permission_matrix' | 'replay_events';
+    readonly assertion: 'round_trip';
+    readonly value: unknown;
+} | {
+    readonly target: 'messages' | 'output_events' | 'idempotency_ledger' | 'subscription' | 'snapshot' | 'reply_preview' | 'provenance' | 'grant_state' | 'permission_matrix' | 'replay_events';
+    readonly assertion: 'matches';
+    readonly value: unknown;
 };
 export type ExpectedVerdict = {
-    readonly status: 'success' | 'error';
-    readonly errorCode?: MessagingErrorCode;
+    readonly status: 'success';
+    readonly errorCode?: never;
+    readonly sideEffects: readonly SideEffectAssertion[];
+} | {
+    readonly status: 'error';
+    readonly errorCode: MessagingErrorCode;
     readonly sideEffects: readonly SideEffectAssertion[];
 };
 export type BehaviorCase = {
     readonly id: string;
     readonly invariant: string;
+    readonly execution: Extract<BehaviorExecution, {
+        readonly plane: 'plugin-to-host-wire';
+    }> & {
+        readonly method: 'messaging.send';
+    } | Extract<BehaviorExecution, {
+        readonly plane: 'wire-admission';
+    }> & {
+        readonly method: 'messaging.send';
+    };
+    readonly given: FixtureSetup;
+    readonly when: Extract<FixtureOperation, {
+        readonly operation: 'send';
+    }>;
+    readonly expect: ExpectedVerdict;
+} | {
+    readonly id: string;
+    readonly invariant: string;
+    readonly execution: Extract<BehaviorExecution, {
+        readonly plane: 'plugin-to-host-wire';
+    }> & {
+        readonly method: 'messaging.appendElements';
+    } | Extract<BehaviorExecution, {
+        readonly plane: 'wire-admission';
+    }> & {
+        readonly method: 'messaging.appendElements';
+    };
+    readonly given: FixtureSetup;
+    readonly when: Extract<FixtureOperation, {
+        readonly operation: 'appendElements';
+    }>;
+    readonly expect: ExpectedVerdict;
+} | {
+    readonly id: string;
+    readonly invariant: string;
+    readonly execution: Extract<BehaviorExecution, {
+        readonly plane: 'plugin-to-host-wire';
+    }> & {
+        readonly method: 'messaging.subscribe';
+    } | Extract<BehaviorExecution, {
+        readonly plane: 'wire-admission';
+    }> & {
+        readonly method: 'messaging.subscribe';
+    };
+    readonly given: FixtureSetup;
+    readonly when: Extract<FixtureOperation, {
+        readonly operation: 'subscribe';
+    }>;
+    readonly expect: ExpectedVerdict;
+} | {
+    readonly id: string;
+    readonly invariant: string;
+    readonly execution: Extract<BehaviorExecution, {
+        readonly plane: 'plugin-to-host-wire';
+    }> & {
+        readonly method: 'messaging.read';
+    } | Extract<BehaviorExecution, {
+        readonly plane: 'wire-admission';
+    }> & {
+        readonly method: 'messaging.read';
+    };
+    readonly given: FixtureSetup;
+    readonly when: Extract<FixtureOperation, {
+        readonly operation: 'read';
+    }>;
+    readonly expect: ExpectedVerdict;
+} | {
+    readonly id: string;
+    readonly invariant: string;
+    readonly execution: Extract<BehaviorExecution, {
+        readonly plane: 'plugin-to-host-wire';
+    }> & {
+        readonly method: 'messaging.ack';
+    } | Extract<BehaviorExecution, {
+        readonly plane: 'wire-admission';
+    }> & {
+        readonly method: 'messaging.ack';
+    };
+    readonly given: FixtureSetup;
+    readonly when: Extract<FixtureOperation, {
+        readonly operation: 'ack';
+    }>;
+    readonly expect: ExpectedVerdict;
+} | {
+    readonly id: string;
+    readonly invariant: string;
+    readonly execution: Extract<BehaviorExecution, {
+        readonly plane: 'plugin-to-host-wire';
+    }> & {
+        readonly method: 'messaging.snapshot';
+    } | Extract<BehaviorExecution, {
+        readonly plane: 'wire-admission';
+    }> & {
+        readonly method: 'messaging.snapshot';
+    };
+    readonly given: FixtureSetup;
+    readonly when: Extract<FixtureOperation, {
+        readonly operation: 'snapshot';
+    }>;
+    readonly expect: ExpectedVerdict;
+} | {
+    readonly id: string;
+    readonly invariant: string;
+    readonly execution: Extract<BehaviorExecution, {
+        readonly plane: 'host-to-plugin-delivery';
+    }> & {
+        readonly method: 'host.messaging.deliver';
+    };
+    readonly given: FixtureSetup;
+    readonly when: Extract<FixtureOperation, {
+        readonly operation: 'deliverOnMessage';
+    }>;
+    readonly expect: ExpectedVerdict;
+} | {
+    readonly id: string;
+    readonly invariant: string;
+    readonly execution: Extract<BehaviorExecution, {
+        readonly plane: 'host-control';
+    }>;
     readonly given: FixtureSetup;
-    readonly when: FixtureOperation;
+    readonly when: Extract<FixtureOperation, {
+        readonly operation: 'applyGrantPreset' | 'revokeGrant' | 'checkPermissionMatrix' | 'deleteReplayEvents';
+    }>;
     readonly expect: ExpectedVerdict;
 };
 export type BehaviorFixture = {
@@ -373,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: {
@@ -400,6 +2155,12 @@ export declare const MESSAGING_BOUNDS: {
     readonly maxElementIdLength: 128;
     readonly maxElementsPerMessage: 128;
     readonly maxAppendOpsPerMessage: 64;
+    readonly maxMessageIdLength: 512;
+    readonly maxThreadIdLength: 512;
+    readonly maxActorIdLength: 512;
+    readonly maxMessageHandleTokenLength: 512;
+    readonly maxEventIdLength: 720;
+    readonly maxOccurredAtLength: 27;
 };
 /**
  * @signed(G-0 2026-07-15)