@zhin.js/adapter 1.1.10 → 1.2.0

package/README.md

@@ -11,7 +11,7 @@ generation lifecycle。候选 Endpoint 可完成连接 readiness，但入站由
 import { defineAdapter } from 'zhin.js/adapter';
 
 export default defineAdapter({
-  capabilities: ['inbound', 'outbound'],
+  capabilities: ['inbound'],
   create: (context) => ({ name: context.name }),
 });
 ```
@@ -26,13 +26,20 @@ AdapterIndex 和 generation lifecycle 管理。
 
 Adapter definitions declare `capabilities` for inbound/outbound admission and
 `operations` for optional actions such as `recall`, `edit`, `reaction`, and
-`typing`. Runtime callers should query the resulting `EndpointCapabilities`
-instead of probing optional endpoint methods. The zero-dependency types live in
+`typing`. `operations` accepts either a static list or a resolver receiving the
+concrete `AdapterContext`; use the resolver when connection modes expose different
+operations. `AdapterIndex` resolves, freezes, and exposes the exact set for every
+expanded Endpoint. Runtime callers should query the resulting `EndpointCapabilities`
+instead of probing optional endpoint methods. Declarations and the explicit
+`EndpointControl` port are validated in both directions, so hidden or unimplemented
+operations fail candidate generation before commit. The zero-dependency types live in
 [`@zhin.js/im-contract`](../im-contract/README.md).
 
 Framework-facing outbound code carries a structured `ConversationRef`.
 `EndpointSendRequest` is `{ conversation, payload }`; platform adapters derive
-their native target from `conversation` at the endpoint boundary.
+their native target from `conversation` at the endpoint boundary and return one
+non-empty platform message id. IM Runtime alone wraps that id as a structured
+`MessageRef` / `DeliveryReceipt`; arbitrary endpoint result shapes are rejected.
 
 ## Endpoint Control Port
 
@@ -43,7 +50,8 @@ boundary.
 
 New adapters should provide `control` directly and declare matching
 `operations`. Protocol-specific methods and compound string identifiers are not
-inspected or adapted by the runtime.
+inspected by the runtime. `createRecallEndpointControl()` bridges the common
+platform `recall(messageId)` shape without leaking that shape into Core.
 
 ## Endpoint 生命周期基座（createEndpointLifecycle）
 
@@ -66,7 +74,7 @@ stop 主动断开不重连、心跳 PONG 看门狗、定时器集中清理、陈
 
 展开由 `expandEndpointConfigs`（`src/adapter-index.ts`）完成：endpoint record id 为
 `<slotId>~<name>`，合并顺序 `{...通用, ...项}`（项优先），`endpoints` 键不下传给适配器。
-record name 即 entry.name——Console 展示、`resolve`/`instance` 查找、inbox 落库都按它命中
+record name 即 entry.name——Console 展示、endpoint identity 解析、inbox 落库都按它命中
 唯一 endpoint（适配器实例的 live name 如 icqq uin 优先于它展示）。entry.name 不得含
 `~`/`\0`（会破坏 id 结构），重名/缺名的 entry 会被丢弃并 warn。
 多账号示例见 `plugins/adapters/icqq` / `plugins/adapters/qq` 的 README 与 schema。

package/lib/adapter-index.d.ts

@@ -1,12 +1,16 @@
 import { generationAdmissionSource, type CapabilityId, type CapabilitySlot, type GenerationAdmissionGate, type PluginId, type RuntimeSnapshot } from '@zhin.js/plugin-runtime';
-import type { AdapterCapability, AdapterDefinition, AdapterSegmentPolicy, EndpointInstance, EndpointSendRequest } from './definition.js';
+import { type AdapterCapability, type AdapterDefinition, type AdapterOperation, type AdapterSegmentPolicy, type EndpointInstance, type EndpointSendRequest } from './definition.js';
 import { type EndpointManagementCapability } from './endpoint-management.js';
+import { type EndpointControl } from './endpoint-control.js';
+import { type EndpointContentResolveContext } from './endpoint-content.js';
+import type { ConversationReference, ConversationResolution, EndpointCapabilities } from '@zhin.js/im-contract';
 export interface AdapterDescriptor {
     readonly id: CapabilityId;
     readonly owner: PluginId;
     readonly name: string;
     readonly source: string;
     readonly capabilities: readonly AdapterCapability[];
+    readonly operations: readonly AdapterOperation[];
 }
 /** Console / Host-facing endpoint row (connected = admission open). */
 export interface AdapterEndpointSummary extends AdapterDescriptor {
@@ -35,6 +39,10 @@ export declare class AdapterIndex {
      */
     instance(adapter: string, endpointKey: string): EndpointInstance | undefined;
     owner(id: CapabilityId): PluginId;
+    /** Exact, serializable capabilities for one concrete Endpoint. */
+    capabilities(id: CapabilityId): EndpointCapabilities;
+    /** Returns the control port only when the concrete Endpoint declared the operation and is active. */
+    control(id: CapabilityId, operation: AdapterOperation): EndpointControl | undefined;
     /**
      * Endpoint 的消息段能力声明（出站协商降级依据）；
      * 未声明或未知 id 返回 undefined（调用方按历史行为处理）。
@@ -46,6 +54,7 @@ export declare class AdapterIndex {
     open(): void;
     close(): Promise<void>;
     stop(): Promise<void>;
-    send(id: CapabilityId, request: EndpointSendRequest): Promise<unknown>;
+    send(id: CapabilityId, request: EndpointSendRequest): Promise<string>;
+    resolveContent(id: CapabilityId, reference: ConversationReference, context: EndpointContentResolveContext): Promise<ConversationResolution>;
 }
 export declare function isAdapterIndex(value: unknown): value is AdapterIndex;

package/lib/adapter-index.js

@@ -1,7 +1,9 @@
 import { DisposeStack, GenerationCompensationError, createGenerationAdmissionGate, generationAdmissionSource, } from '@zhin.js/plugin-runtime';
 import { createCapabilityContext } from '@zhin.js/feature-kit';
+import { endpointCapabilitiesOf, resolveAdapterOperations, } from './definition.js';
 import { listEndpointManagementCapabilities, } from './endpoint-management.js';
-import { assertDeclaredEndpointOperations } from './endpoint-control.js';
+import { assertDeclaredEndpointOperations, endpointControlOf, } from './endpoint-control.js';
+import { endpointContentOf } from './endpoint-content.js';
 export class AdapterIndex {
     $projection = 'zhin.adapter-index/1';
     #records = new Map();
@@ -20,7 +22,7 @@ export class AdapterIndex {
             for (const slot of [...slots].sort((left, right) => left.id.localeCompare(right.id))) {
                 signal.throwIfAborted();
                 for (const expansion of expandEndpointConfigs(slot, snapshot)) {
-                    const endpoint = await createEndpoint(slot, snapshot, admission, signal, expansion);
+                    const created = await createEndpoint(slot, snapshot, admission, signal, expansion);
                     signal.throwIfAborted();
                     records.push({
                         id: expansion.id,
@@ -30,7 +32,8 @@ export class AdapterIndex {
                         name: expansion.endpointId,
                         source: slot.source,
                         capabilities: slot.definition.capabilities,
-                        endpoint,
+                        operations: created.operations,
+                        endpoint: created.endpoint,
                         ...(slot.definition.segments ? { segments: slot.definition.segments } : {}),
                         started: false,
                         open: false,
@@ -58,6 +61,7 @@ export class AdapterIndex {
             name: endpointLiveName(record.endpoint) ?? record.name,
             source: record.source,
             capabilities: record.capabilities,
+            operations: record.operations,
             connected: record.open && !record.stopped,
             status: record.open && !record.stopped ? 'online' : 'offline',
             phase: endpointPhase(record),
@@ -93,6 +97,22 @@ export class AdapterIndex {
             throw new Error(`Unknown Adapter Endpoint: ${id}`);
         return record.owner;
     }
+    /** Exact, serializable capabilities for one concrete Endpoint. */
+    capabilities(id) {
+        const record = this.#records.get(id);
+        if (!record)
+            throw new Error(`Unknown Adapter Endpoint: ${id}`);
+        return endpointCapabilitiesOf(record, record.operations);
+    }
+    /** Returns the control port only when the concrete Endpoint declared the operation and is active. */
+    control(id, operation) {
+        const record = this.#records.get(id);
+        if (!record || !record.started || record.stopped)
+            return undefined;
+        if (!record.operations.includes(operation))
+            return undefined;
+        return endpointControlOf(record.endpoint);
+    }
     /**
      * Endpoint 的消息段能力声明（出站协商降级依据）；
      * 未声明或未知 id 返回 undefined（调用方按历史行为处理）。
@@ -194,7 +214,24 @@ export class AdapterIndex {
         if (!record.started || record.stopped) {
             throw new Error(`Adapter Endpoint is not active: ${id}`);
         }
-        return record.endpoint.send(request);
+        const messageId = await record.endpoint.send(request);
+        if (typeof messageId !== 'string' || !messageId.trim()) {
+            throw new TypeError(`Adapter Endpoint send() must return a non-empty platform message id: ${id}`);
+        }
+        return messageId;
+    }
+    async resolveContent(id, reference, context) {
+        const record = this.#records.get(id);
+        if (!record)
+            return Object.freeze({ status: 'not_found', code: 'endpoint_not_found' });
+        if (!record.started || record.stopped) {
+            return Object.freeze({ status: 'failed', code: 'endpoint_not_active' });
+        }
+        const content = endpointContentOf(record.endpoint);
+        if (!content)
+            return Object.freeze({ status: 'unsupported', code: 'content_resolution_unsupported' });
+        context.signal.throwIfAborted();
+        return content.resolve(reference, context);
     }
 }
 export function isAdapterIndex(value) {
@@ -282,15 +319,20 @@ function expandEndpointConfigs(slot, snapshot) {
     })));
 }
 async function createEndpoint(slot, snapshot, admission, signal, expansion) {
-    const endpoint = await slot.definition.create(Object.freeze({
+    const context = Object.freeze({
         ...createCapabilityContext(snapshot, slot.owner, admission, signal),
         ...(expansion?.config ? { config: expansion.config } : {}),
         id: expansion?.id ?? slot.id,
         name: slot.localName,
-    }));
+    });
+    const operations = resolveAdapterOperations(slot.definition, context);
+    const endpoint = await slot.definition.create(context);
     assertEndpoint(endpoint, expansion?.id ?? slot.id);
-    assertDeclaredEndpointOperations(endpoint, slot.definition.operations, String(expansion?.id ?? slot.id));
-    return endpoint;
+    if (slot.definition.capabilities.includes('outbound') && typeof endpoint.send !== 'function') {
+        throw new TypeError(`Adapter Endpoint ${String(expansion?.id ?? slot.id)} declares outbound but send() is missing`);
+    }
+    assertDeclaredEndpointOperations(endpoint, operations, String(expansion?.id ?? slot.id));
+    return Object.freeze({ endpoint, operations });
 }
 async function stopRecords(records, primaryError) {
     const stack = new DisposeStack();

package/lib/definition.d.ts

@@ -3,24 +3,31 @@ import type { CapabilityContext } from '@zhin.js/feature-kit';
 import type { ConversationRef, EndpointCapabilities, EndpointOperation } from '@zhin.js/im-contract';
 import type { EndpointManagement } from './endpoint-management.js';
 import type { EndpointControl } from './endpoint-control.js';
+import type { EndpointContentPort } from './endpoint-content.js';
 declare const adapterBrand: "zhin.adapter/1";
 export type AdapterCapability = 'inbound' | 'outbound';
 /** Operations beyond sending, declared by an Adapter definition. */
 export type AdapterOperation = Exclude<EndpointOperation, 'send'>;
+/** Resolve operations for one concrete Endpoint configuration. */
+export type AdapterOperationDeclaration<TConfig = unknown> = readonly AdapterOperation[] | ((context: AdapterContext<TConfig>) => readonly AdapterOperation[]);
 /** 端点可消费的出站媒体来源形式。 */
 export type AdapterOutboundMedia = 'url' | 'path' | 'base64' | 'upload';
 /** 交互段（卡片/按钮等富交互）的端点消费方式。 */
 export type AdapterInteractiveMode = 'native' | 'text';
+/** Markdown semantic segment consumption mode. */
+export type AdapterMarkdownMode = 'native' | 'text';
 export interface EndpointSendRequest {
     /** 结构化会话寻址；端点在平台边界自行派生原生 target。 */
     readonly conversation: ConversationRef;
     readonly payload: unknown;
 }
-export interface EndpointInstance<TResult = unknown> {
+export interface EndpointInstance {
     /** Optional platform-neutral Console/Host management surface. */
     readonly management?: EndpointManagement;
     /** Optional platform-neutral control surface for existing messages. */
     readonly control?: EndpointControl;
+    /** Optional canonical resolver for message, merged-forward and media references. */
+    readonly content?: EndpointContentPort;
     /** Required readiness; must observe abort and settle before rollback returns. */
     start?(signal: AbortSignal): void | Promise<void>;
     /** Opens Endpoint-local flow behind the candidate generation admission gate. */
@@ -29,7 +36,8 @@ export interface EndpointInstance<TResult = unknown> {
     close?(): void | Promise<void>;
     /** Releases transport resources. Calls must be idempotent. */
     stop?(): void | Promise<void>;
-    send?(request: EndpointSendRequest): TResult | Promise<TResult>;
+    /** Platform message id. Core wraps it in the canonical MessageRef/DeliveryReceipt. */
+    send?(request: EndpointSendRequest): string | Promise<string>;
 }
 export interface AdapterContext<TConfig = unknown> extends CapabilityContext<TConfig> {
     readonly id: CapabilityId;
@@ -60,11 +68,13 @@ export interface AdapterSegmentPolicy {
     readonly outboundMedia?: readonly AdapterOutboundMedia[];
     /**
      * 交互段（卡片/按钮等富交互）消费方式：`native` 原生渲染 / `text` 降级纯文本。
-     * 目前仅为声明（供出站协商与门禁消费），`text` 的降级执行随 Wave 2 落地。
+     * Core 在最终出站阶段执行统一降级。
      */
     readonly interactive?: AdapterInteractiveMode;
+    /** `native` preserves Markdown for the endpoint codec; `text` strips formatting in Core. */
+    readonly markdown?: AdapterMarkdownMode;
 }
-export interface AdapterDefinition<TConfig = unknown, TResult = unknown> {
+export interface AdapterDefinition<TConfig = unknown> {
     readonly $feature: typeof adapterBrand;
     readonly capabilities: readonly AdapterCapability[];
     /**
@@ -72,18 +82,20 @@ export interface AdapterDefinition<TConfig = unknown, TResult = unknown> {
      * `capabilities: ['outbound']`; a method existing on an endpoint is not a
      * capability declaration.
      */
-    readonly operations?: readonly AdapterOperation[];
+    readonly operations?: AdapterOperationDeclaration<TConfig>;
     /** 可选：端点消息段能力声明（出站协商降级挂载点）。 */
     readonly segments?: AdapterSegmentPolicy;
-    create(context: AdapterContext<TConfig>): EndpointInstance<TResult> | Promise<EndpointInstance<TResult>>;
+    create(context: AdapterContext<TConfig>): EndpointInstance | Promise<EndpointInstance>;
 }
 declare module '@zhin.js/plugin-runtime' {
-    interface PluginSetupContext<TConfig> {
-        addAdapter<TResult = unknown>(localName: string, definition: AdapterDefinition<TConfig, TResult>): void;
+    interface PluginSetupContext<TConfig = unknown> {
+        addAdapter(localName: string, definition: AdapterDefinition<TConfig>): void;
     }
 }
-export declare function defineAdapter<TConfig = unknown, TResult = unknown>(definition: Omit<AdapterDefinition<TConfig, TResult>, '$feature'>): Readonly<AdapterDefinition<TConfig, TResult>>;
+export declare function defineAdapter<TConfig = unknown>(definition: Omit<AdapterDefinition<TConfig>, '$feature'>): Readonly<AdapterDefinition<TConfig>>;
 /** Converts the definition's compact authoring form into the public contract. */
-export declare function endpointCapabilitiesOf(definition: Pick<AdapterDefinition, 'capabilities' | 'operations'>): EndpointCapabilities;
+export declare function endpointCapabilitiesOf(definition: Pick<AdapterDefinition, 'capabilities' | 'operations'>, resolvedOperations?: readonly AdapterOperation[]): EndpointCapabilities;
+/** Resolve and validate the operation declaration for one concrete Endpoint. */
+export declare function resolveAdapterOperations<TConfig>(definition: Pick<AdapterDefinition<TConfig>, 'operations'>, context: AdapterContext<TConfig>): readonly AdapterOperation[];
 export declare function parseAdapterDefinition(value: unknown): AdapterDefinition;
 export {};

package/lib/definition.js

@@ -14,7 +14,9 @@ export function defineAdapter(definition) {
         throw new TypeError('Adapter capabilities must contain inbound and/or outbound');
     }
     const segments = normalizeSegmentPolicy(definition.segments);
-    const operations = normalizeOperations(definition.operations);
+    const operations = typeof definition.operations === 'function'
+        ? definition.operations
+        : normalizeOperations(definition.operations);
     return Object.freeze({
         ...definition,
         $feature: adapterBrand,
@@ -24,14 +26,27 @@ export function defineAdapter(definition) {
     });
 }
 /** Converts the definition's compact authoring form into the public contract. */
-export function endpointCapabilitiesOf(definition) {
-    const operations = definition.operations?.reduce((result, operation) => ({ ...result, [operation]: true }), {});
+export function endpointCapabilitiesOf(definition, resolvedOperations) {
+    if (typeof definition.operations === 'function' && resolvedOperations === undefined) {
+        throw new TypeError('Dynamic Adapter operations must be resolved for one Endpoint');
+    }
+    const declared = resolvedOperations
+        ?? (Array.isArray(definition.operations) ? definition.operations : undefined);
+    const operations = declared?.reduce((result, operation) => ({ ...result, [operation]: true }), {});
     return Object.freeze({
         inbound: definition.capabilities.includes('inbound'),
         outbound: definition.capabilities.includes('outbound'),
         ...(operations && Object.keys(operations).length > 0 ? { operations: Object.freeze(operations) } : {}),
     });
 }
+/** Resolve and validate the operation declaration for one concrete Endpoint. */
+export function resolveAdapterOperations(definition, context) {
+    const declaration = definition.operations;
+    const operations = typeof declaration === 'function'
+        ? declaration(context)
+        : declaration;
+    return normalizeOperations(operations) ?? Object.freeze([]);
+}
 function normalizeOperations(operations) {
     if (operations === undefined)
         return undefined;
@@ -66,6 +81,11 @@ function normalizeSegmentPolicy(policy) {
         && policy.interactive !== 'text') {
         throw new TypeError("Adapter segments.interactive must be 'native' or 'text'");
     }
+    if (policy.markdown !== undefined
+        && policy.markdown !== 'native'
+        && policy.markdown !== 'text') {
+        throw new TypeError("Adapter segments.markdown must be 'native' or 'text'");
+    }
     return Object.freeze({
         ...(policy.supported ? { supported: Object.freeze([...new Set(policy.supported)]) } : {}),
         ...(policy.html ? { html: policy.html } : {}),
@@ -73,6 +93,7 @@ function normalizeSegmentPolicy(policy) {
             ? { outboundMedia: Object.freeze([...new Set(policy.outboundMedia)]) }
             : {}),
         ...(policy.interactive ? { interactive: policy.interactive } : {}),
+        ...(policy.markdown ? { markdown: policy.markdown } : {}),
     });
 }
 export function parseAdapterDefinition(value) {
@@ -87,7 +108,9 @@ export function parseAdapterDefinition(value) {
         throw invalidAdapter();
     // defineAdapter 已校验过形状；外部手工构造的 definition 也在此兜底
     normalizeSegmentPolicy(definition.segments);
-    normalizeOperations(definition.operations);
+    if (typeof definition.operations !== 'function') {
+        normalizeOperations(definition.operations);
+    }
     return definition;
 }
 function invalidAdapter() {

package/lib/endpoint-content.d.ts

@@ -0,0 +1,12 @@
+import type { ConversationReference, ConversationResolution } from '@zhin.js/im-contract';
+export interface EndpointContentResolveContext {
+    readonly signal: AbortSignal;
+    readonly maxDepth: number;
+    readonly maxEntries: number;
+    readonly maxChars: number;
+}
+/** Platform semantic port for resolving content that was not observed locally. */
+export interface EndpointContentPort {
+    resolve(reference: ConversationReference, context: EndpointContentResolveContext): Promise<ConversationResolution>;
+}
+export declare function endpointContentOf(endpoint: unknown): EndpointContentPort | undefined;

package/lib/endpoint-content.js

@@ -0,0 +1,10 @@
+export function endpointContentOf(endpoint) {
+    if (!endpoint || typeof endpoint !== 'object')
+        return undefined;
+    const content = endpoint.content;
+    if (!content || typeof content !== 'object')
+        return undefined;
+    return typeof content.resolve === 'function'
+        ? content
+        : undefined;
+}

package/lib/endpoint-control.d.ts

@@ -19,9 +19,13 @@ export interface EndpointControl {
 export interface EndpointWithControl {
     readonly control?: EndpointControl;
 }
+/** Bridges the common platform `recall(messageId)` shape into canonical control. */
+export declare function createRecallEndpointControl(recallById: (messageId: string) => void | Promise<void>): Readonly<EndpointControl>;
 /** Reads the canonical control port without probing protocol-specific methods. */
 export declare function endpointControlOf(endpoint: unknown): EndpointControl | undefined;
-/** Checks only an Endpoint's explicit `control` port, never the legacy bridge. */
+/** Checks only an Endpoint's explicit `control` port; protocol methods are never probed. */
 export declare function hasExplicitEndpointOperation(endpoint: unknown, operation: 'recall' | 'edit' | 'reaction' | 'typing'): boolean;
+/** Lists the semantic operations implemented by an Endpoint's explicit control port. */
+export declare function listExplicitEndpointOperations(endpoint: unknown): readonly ('recall' | 'edit' | 'reaction' | 'typing')[];
 /** Rejects a declaration that cannot be fulfilled by the explicit control port. */
 export declare function assertDeclaredEndpointOperations(endpoint: unknown, operations: readonly ('recall' | 'edit' | 'reaction' | 'typing')[] | undefined, id: string): void;

package/lib/endpoint-control.js

@@ -1,3 +1,9 @@
+/** Bridges the common platform `recall(messageId)` shape into canonical control. */
+export function createRecallEndpointControl(recallById) {
+    return Object.freeze({
+        recall: (message) => Promise.resolve(recallById(message.id)),
+    });
+}
 /** Reads the canonical control port without probing protocol-specific methods. */
 export function endpointControlOf(endpoint) {
     if (!endpoint || typeof endpoint !== 'object')
@@ -5,7 +11,7 @@ export function endpointControlOf(endpoint) {
     const explicit = endpoint.control;
     return explicit && typeof explicit === 'object' ? explicit : undefined;
 }
-/** Checks only an Endpoint's explicit `control` port, never the legacy bridge. */
+/** Checks only an Endpoint's explicit `control` port; protocol methods are never probed. */
 export function hasExplicitEndpointOperation(endpoint, operation) {
     if (!endpoint || typeof endpoint !== 'object')
         return false;
@@ -19,6 +25,25 @@ export function hasExplicitEndpointOperation(endpoint, operation) {
         case 'typing': return typeof control.typing === 'function';
     }
 }
+/** Lists the semantic operations implemented by an Endpoint's explicit control port. */
+export function listExplicitEndpointOperations(endpoint) {
+    if (!endpoint || typeof endpoint !== 'object')
+        return Object.freeze([]);
+    const control = endpoint.control;
+    if (!control || typeof control !== 'object')
+        return Object.freeze([]);
+    const operations = [];
+    if (typeof control.recall === 'function')
+        operations.push('recall');
+    if (typeof control.edit === 'function')
+        operations.push('edit');
+    if (typeof control.addReaction === 'function'
+        || typeof control.removeReaction === 'function')
+        operations.push('reaction');
+    if (typeof control.typing === 'function')
+        operations.push('typing');
+    return Object.freeze(operations);
+}
 /** Rejects a declaration that cannot be fulfilled by the explicit control port. */
 export function assertDeclaredEndpointOperations(endpoint, operations, id) {
     for (const operation of operations ?? []) {
@@ -26,7 +51,19 @@ export function assertDeclaredEndpointOperations(endpoint, operations, id) {
             throw new TypeError(`Adapter Endpoint ${id} declares ${operation} but control.${controlMethodName(operation)} is missing`);
         }
     }
+    const declared = new Set(operations ?? []);
+    for (const operation of listExplicitEndpointOperations(endpoint)) {
+        if (!declared.has(operation)) {
+            throw new TypeError(`Adapter Endpoint ${id} exposes control.${explicitControlMethodName(endpoint, operation)} but does not declare ${operation}`);
+        }
+    }
 }
 function controlMethodName(operation) {
     return operation === 'reaction' ? 'addReaction' : operation;
 }
+function explicitControlMethodName(endpoint, operation) {
+    if (operation !== 'reaction')
+        return operation;
+    const control = endpoint.control;
+    return typeof control?.addReaction === 'function' ? 'addReaction' : 'removeReaction';
+}

package/lib/endpoint-management.d.ts

@@ -19,6 +19,18 @@ export interface EndpointChannel {
     readonly name?: string;
     readonly parent?: EndpointChannelParent;
 }
+/** Pending friend/group request for Console / Host listing (live, not inbox DB). */
+export interface EndpointPendingRequest {
+    readonly platform_request_id: string;
+    readonly type: string;
+    readonly scene_type?: string | null;
+    readonly scene_id: string;
+    readonly sub_type?: string | null;
+    readonly actor_id: string;
+    readonly actor_name?: string | null;
+    readonly comment?: string | null;
+    readonly created_at: number;
+}
 /**
  * Optional, platform-neutral management surface exposed by an Endpoint.
  *
@@ -31,6 +43,8 @@ export interface EndpointManagement {
     listGroups?(): Promise<readonly EndpointGroup[]>;
     listChannels?(): Promise<readonly EndpointChannel[]>;
     listGroupMembers?(groupId: string): Promise<readonly unknown[]>;
+    /** Live pending friend/group requests (preferred over unified_inbox_request). */
+    listRequests?(): Promise<readonly EndpointPendingRequest[]>;
     approveRequest?(requestId: string, remark?: string): Promise<void>;
     rejectRequest?(requestId: string, reason?: string): Promise<void>;
     kickGroupMember?(groupId: string, userId: string): Promise<void>;
@@ -46,7 +60,7 @@ export interface EndpointWithManagement {
  * Values intentionally mirror EndpointManagement method names so adapters only
  * need to implement the semantic port; no second capability declaration exists.
  */
-export declare const endpointManagementCapabilityIds: readonly ["listFriends", "listGroups", "listChannels", "listGroupMembers", "approveRequest", "rejectRequest", "kickGroupMember", "muteGroupMember", "setGroupAdmin", "deleteFriend"];
+export declare const endpointManagementCapabilityIds: readonly ["listFriends", "listGroups", "listChannels", "listGroupMembers", "listRequests", "approveRequest", "rejectRequest", "kickGroupMember", "muteGroupMember", "setGroupAdmin", "deleteFriend"];
 export type EndpointManagementCapability = (typeof endpointManagementCapabilityIds)[number];
 export declare function resolveEndpointManagement(endpoint: unknown): EndpointManagement | undefined;
 /** Derive advertised capabilities from the live semantic port implementation. */

package/lib/endpoint-management.js

@@ -8,6 +8,7 @@ export const endpointManagementCapabilityIds = [
     'listGroups',
     'listChannels',
     'listGroupMembers',
+    'listRequests',
     'approveRequest',
     'rejectRequest',
     'kickGroupMember',

package/lib/index.d.ts

@@ -7,5 +7,6 @@ export * from './endpoint-commands.js';
 export * from './endpoint-lifecycle.js';
 export * from './endpoint-management.js';
 export * from './endpoint-control.js';
+export * from './endpoint-content.js';
 export * from './provider.js';
 export { default } from './provider.js';

package/lib/index.js

@@ -7,5 +7,6 @@ export * from './endpoint-commands.js';
 export * from './endpoint-lifecycle.js';
 export * from './endpoint-management.js';
 export * from './endpoint-control.js';
+export * from './endpoint-content.js';
 export * from './provider.js';
 export { default } from './provider.js';

package/lib/provider.d.ts

@@ -1,5 +1,5 @@
 import { AdapterIndex } from './adapter-index.js';
 export declare const adapterFeatureId: import("@zhin.js/plugin-runtime").FeatureId;
-declare const adapterFeature: Readonly<import("@zhin.js/feature-kit").FeatureProvider<import("./definition.js").AdapterDefinition<unknown, unknown>, AdapterIndex>>;
+declare const adapterFeature: Readonly<import("@zhin.js/feature-kit").FeatureProvider<import("./definition.js").AdapterDefinition<unknown>, AdapterIndex>>;
 export { adapterFeature };
 export default adapterFeature;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/adapter",
-  "version": "1.1.10",
+  "version": "1.2.0",
   "description": "Convention-based Adapter and Endpoint Feature for Zhin Plugin Runtime",
   "type": "module",
   "main": "./lib/index.js",
@@ -18,15 +18,15 @@
   ],
   "dependencies": {
     "yaml": "^2.9.0",
-    "@zhin.js/feature-kit": "1.0.11",
-    "@zhin.js/im-contract": "1.0.3",
+    "@zhin.js/feature-kit": "1.0.12",
+    "@zhin.js/im-contract": "1.0.4",
     "@zhin.js/logger": "1.0.76",
-    "@zhin.js/plugin-runtime": "1.1.6"
+    "@zhin.js/plugin-runtime": "1.1.7"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
     "typescript": "^6.0.3",
-    "@zhin.js/command": "1.0.14"
+    "@zhin.js/command": "1.0.15"
   },
   "zhin": {
     "protocol": 1,

package/src/adapter-index.ts

@@ -10,18 +10,31 @@ import {
   type RuntimeSnapshot,
 } from '@zhin.js/plugin-runtime';
 import { createCapabilityContext } from '@zhin.js/feature-kit';
-import type {
-  AdapterCapability,
-  AdapterDefinition,
-  AdapterSegmentPolicy,
-  EndpointInstance,
-  EndpointSendRequest,
+import {
+  endpointCapabilitiesOf,
+  resolveAdapterOperations,
+  type AdapterCapability,
+  type AdapterDefinition,
+  type AdapterOperation,
+  type AdapterSegmentPolicy,
+  type EndpointInstance,
+  type EndpointSendRequest,
 } from './definition.js';
 import {
   listEndpointManagementCapabilities,
   type EndpointManagementCapability,
 } from './endpoint-management.js';
-import { assertDeclaredEndpointOperations } from './endpoint-control.js';
+import {
+  assertDeclaredEndpointOperations,
+  endpointControlOf,
+  type EndpointControl,
+} from './endpoint-control.js';
+import { endpointContentOf, type EndpointContentResolveContext } from './endpoint-content.js';
+import type {
+  ConversationReference,
+  ConversationResolution,
+  EndpointCapabilities,
+} from '@zhin.js/im-contract';
 
 export interface AdapterDescriptor {
   readonly id: CapabilityId;
@@ -29,6 +42,7 @@ export interface AdapterDescriptor {
   readonly name: string;
   readonly source: string;
   readonly capabilities: readonly AdapterCapability[];
+  readonly operations: readonly AdapterOperation[];
 }
 
 /** Console / Host-facing endpoint row (connected = admission open). */
@@ -78,7 +92,7 @@ export class AdapterIndex {
       for (const slot of [...slots].sort((left, right) => left.id.localeCompare(right.id))) {
         signal.throwIfAborted();
         for (const expansion of expandEndpointConfigs(slot, snapshot)) {
-          const endpoint = await createEndpoint(slot, snapshot, admission, signal, expansion);
+          const created = await createEndpoint(slot, snapshot, admission, signal, expansion);
           signal.throwIfAborted();
           records.push({
             id: expansion.id,
@@ -88,7 +102,8 @@ export class AdapterIndex {
             name: expansion.endpointId,
             source: slot.source,
             capabilities: slot.definition.capabilities,
-            endpoint,
+            operations: created.operations,
+            endpoint: created.endpoint,
             ...(slot.definition.segments ? { segments: slot.definition.segments } : {}),
             started: false,
             open: false,
@@ -120,6 +135,7 @@ export class AdapterIndex {
       name: endpointLiveName(record.endpoint) ?? record.name,
       source: record.source,
       capabilities: record.capabilities,
+      operations: record.operations,
       connected: record.open && !record.stopped,
       status: record.open && !record.stopped ? 'online' as const : 'offline' as const,
       phase: endpointPhase(record),
@@ -156,6 +172,21 @@ export class AdapterIndex {
     return record.owner;
   }
 
+  /** Exact, serializable capabilities for one concrete Endpoint. */
+  capabilities(id: CapabilityId): EndpointCapabilities {
+    const record = this.#records.get(id);
+    if (!record) throw new Error(`Unknown Adapter Endpoint: ${id}`);
+    return endpointCapabilitiesOf(record, record.operations);
+  }
+
+  /** Returns the control port only when the concrete Endpoint declared the operation and is active. */
+  control(id: CapabilityId, operation: AdapterOperation): EndpointControl | undefined {
+    const record = this.#records.get(id);
+    if (!record || !record.started || record.stopped) return undefined;
+    if (!record.operations.includes(operation)) return undefined;
+    return endpointControlOf(record.endpoint);
+  }
+
   /**
    * Endpoint 的消息段能力声明（出站协商降级依据）；
    * 未声明或未知 id 返回 undefined（调用方按历史行为处理）。
@@ -251,7 +282,7 @@ export class AdapterIndex {
     await stack.dispose();
   }
 
-  async send(id: CapabilityId, request: EndpointSendRequest): Promise<unknown> {
+  async send(id: CapabilityId, request: EndpointSendRequest): Promise<string> {
     const record = this.#records.get(id);
     if (!record) throw new Error(`Unknown Adapter Endpoint: ${id}`);
     if (!record.capabilities.includes('outbound') || !record.endpoint.send) {
@@ -260,7 +291,27 @@ export class AdapterIndex {
     if (!record.started || record.stopped) {
       throw new Error(`Adapter Endpoint is not active: ${id}`);
     }
-    return record.endpoint.send(request);
+    const messageId = await record.endpoint.send(request);
+    if (typeof messageId !== 'string' || !messageId.trim()) {
+      throw new TypeError(`Adapter Endpoint send() must return a non-empty platform message id: ${id}`);
+    }
+    return messageId;
+  }
+
+  async resolveContent(
+    id: CapabilityId,
+    reference: ConversationReference,
+    context: EndpointContentResolveContext,
+  ): Promise<ConversationResolution> {
+    const record = this.#records.get(id);
+    if (!record) return Object.freeze({ status: 'not_found', code: 'endpoint_not_found' });
+    if (!record.started || record.stopped) {
+      return Object.freeze({ status: 'failed', code: 'endpoint_not_active' });
+    }
+    const content = endpointContentOf(record.endpoint);
+    if (!content) return Object.freeze({ status: 'unsupported', code: 'content_resolution_unsupported' });
+    context.signal.throwIfAborted();
+    return content.resolve(reference, context);
   }
 }
 
@@ -374,22 +425,27 @@ async function createEndpoint(
   admission: GenerationAdmissionGate,
   signal: AbortSignal,
   expansion?: EndpointExpansion,
-): Promise<EndpointInstance> {
-  const endpoint = await slot.definition.create(
-    Object.freeze({
-      ...createCapabilityContext(snapshot, slot.owner, admission, signal),
-      ...(expansion?.config ? { config: expansion.config } : {}),
-      id: expansion?.id ?? slot.id,
-      name: slot.localName,
-    }),
-  );
+): Promise<Readonly<{ endpoint: EndpointInstance; operations: readonly AdapterOperation[] }>> {
+  const context = Object.freeze({
+    ...createCapabilityContext(snapshot, slot.owner, admission, signal),
+    ...(expansion?.config ? { config: expansion.config } : {}),
+    id: expansion?.id ?? slot.id,
+    name: slot.localName,
+  });
+  const operations = resolveAdapterOperations(slot.definition, context);
+  const endpoint = await slot.definition.create(context);
   assertEndpoint(endpoint, expansion?.id ?? slot.id);
+  if (slot.definition.capabilities.includes('outbound') && typeof endpoint.send !== 'function') {
+    throw new TypeError(
+      `Adapter Endpoint ${String(expansion?.id ?? slot.id)} declares outbound but send() is missing`,
+    );
+  }
   assertDeclaredEndpointOperations(
     endpoint,
-    slot.definition.operations,
+    operations,
     String(expansion?.id ?? slot.id),
   );
-  return endpoint;
+  return Object.freeze({ endpoint, operations });
 }
 
 async function stopRecords(

package/src/definition.ts

@@ -7,6 +7,7 @@ import type {
 } from '@zhin.js/im-contract';
 import type { EndpointManagement } from './endpoint-management.js';
 import type { EndpointControl } from './endpoint-control.js';
+import type { EndpointContentPort } from './endpoint-content.js';
 
 const adapterBrand = 'zhin.adapter/1' as const;
 
@@ -15,11 +16,18 @@ export type AdapterCapability = 'inbound' | 'outbound';
 /** Operations beyond sending, declared by an Adapter definition. */
 export type AdapterOperation = Exclude<EndpointOperation, 'send'>;
 
+/** Resolve operations for one concrete Endpoint configuration. */
+export type AdapterOperationDeclaration<TConfig = unknown> =
+  | readonly AdapterOperation[]
+  | ((context: AdapterContext<TConfig>) => readonly AdapterOperation[]);
+
 /** 端点可消费的出站媒体来源形式。 */
 export type AdapterOutboundMedia = 'url' | 'path' | 'base64' | 'upload';
 
 /** 交互段（卡片/按钮等富交互）的端点消费方式。 */
 export type AdapterInteractiveMode = 'native' | 'text';
+/** Markdown semantic segment consumption mode. */
+export type AdapterMarkdownMode = 'native' | 'text';
 
 export interface EndpointSendRequest {
   /** 结构化会话寻址；端点在平台边界自行派生原生 target。 */
@@ -27,11 +35,13 @@ export interface EndpointSendRequest {
   readonly payload: unknown;
 }
 
-export interface EndpointInstance<TResult = unknown> {
+export interface EndpointInstance {
   /** Optional platform-neutral Console/Host management surface. */
   readonly management?: EndpointManagement;
   /** Optional platform-neutral control surface for existing messages. */
   readonly control?: EndpointControl;
+  /** Optional canonical resolver for message, merged-forward and media references. */
+  readonly content?: EndpointContentPort;
   /** Required readiness; must observe abort and settle before rollback returns. */
   start?(signal: AbortSignal): void | Promise<void>;
   /** Opens Endpoint-local flow behind the candidate generation admission gate. */
@@ -40,7 +50,8 @@ export interface EndpointInstance<TResult = unknown> {
   close?(): void | Promise<void>;
   /** Releases transport resources. Calls must be idempotent. */
   stop?(): void | Promise<void>;
-  send?(request: EndpointSendRequest): TResult | Promise<TResult>;
+  /** Platform message id. Core wraps it in the canonical MessageRef/DeliveryReceipt. */
+  send?(request: EndpointSendRequest): string | Promise<string>;
 }
 
 export interface AdapterContext<TConfig = unknown> extends CapabilityContext<TConfig> {
@@ -74,9 +85,11 @@ export interface AdapterSegmentPolicy {
   readonly outboundMedia?: readonly AdapterOutboundMedia[];
   /**
    * 交互段（卡片/按钮等富交互）消费方式：`native` 原生渲染 / `text` 降级纯文本。
-   * 目前仅为声明（供出站协商与门禁消费），`text` 的降级执行随 Wave 2 落地。
+   * Core 在最终出站阶段执行统一降级。
    */
   readonly interactive?: AdapterInteractiveMode;
+  /** `native` preserves Markdown for the endpoint codec; `text` strips formatting in Core. */
+  readonly markdown?: AdapterMarkdownMode;
 }
 
 const HTML_OUTBOUND_MODES: readonly HtmlOutboundMode[] = ['direct', 'image', 'text'];
@@ -87,7 +100,7 @@ const OUTBOUND_MEDIA_FORMS: readonly AdapterOutboundMedia[] = [
 
 const ADAPTER_OPERATIONS: readonly AdapterOperation[] = ['recall', 'edit', 'reaction', 'typing'];
 
-export interface AdapterDefinition<TConfig = unknown, TResult = unknown> {
+export interface AdapterDefinition<TConfig = unknown> {
   readonly $feature: typeof adapterBrand;
   readonly capabilities: readonly AdapterCapability[];
   /**
@@ -95,26 +108,26 @@ export interface AdapterDefinition<TConfig = unknown, TResult = unknown> {
    * `capabilities: ['outbound']`; a method existing on an endpoint is not a
    * capability declaration.
    */
-  readonly operations?: readonly AdapterOperation[];
+  readonly operations?: AdapterOperationDeclaration<TConfig>;
   /** 可选：端点消息段能力声明（出站协商降级挂载点）。 */
   readonly segments?: AdapterSegmentPolicy;
   create(
     context: AdapterContext<TConfig>,
-  ): EndpointInstance<TResult> | Promise<EndpointInstance<TResult>>;
+  ): EndpointInstance | Promise<EndpointInstance>;
 }
 
 declare module '@zhin.js/plugin-runtime' {
-  interface PluginSetupContext<TConfig> {
-    addAdapter<TResult = unknown>(
+  interface PluginSetupContext<TConfig = unknown> {
+    addAdapter(
       localName: string,
-      definition: AdapterDefinition<TConfig, TResult>,
+      definition: AdapterDefinition<TConfig>,
     ): void;
   }
 }
 
-export function defineAdapter<TConfig = unknown, TResult = unknown>(
-  definition: Omit<AdapterDefinition<TConfig, TResult>, '$feature'>,
-): Readonly<AdapterDefinition<TConfig, TResult>> {
+export function defineAdapter<TConfig = unknown>(
+  definition: Omit<AdapterDefinition<TConfig>, '$feature'>,
+): Readonly<AdapterDefinition<TConfig>> {
   if (typeof definition.create !== 'function') {
     throw new TypeError('Adapter create must be a function');
   }
@@ -126,7 +139,9 @@ export function defineAdapter<TConfig = unknown, TResult = unknown>(
     throw new TypeError('Adapter capabilities must contain inbound and/or outbound');
   }
   const segments = normalizeSegmentPolicy(definition.segments);
-  const operations = normalizeOperations(definition.operations);
+  const operations = typeof definition.operations === 'function'
+    ? definition.operations
+    : normalizeOperations(definition.operations);
   return Object.freeze({
     ...definition,
     $feature: adapterBrand,
@@ -139,8 +154,14 @@ export function defineAdapter<TConfig = unknown, TResult = unknown>(
 /** Converts the definition's compact authoring form into the public contract. */
 export function endpointCapabilitiesOf(
   definition: Pick<AdapterDefinition, 'capabilities' | 'operations'>,
+  resolvedOperations?: readonly AdapterOperation[],
 ): EndpointCapabilities {
-  const operations = definition.operations?.reduce<Partial<Record<AdapterOperation, true>>>(
+  if (typeof definition.operations === 'function' && resolvedOperations === undefined) {
+    throw new TypeError('Dynamic Adapter operations must be resolved for one Endpoint');
+  }
+  const declared = resolvedOperations
+    ?? (Array.isArray(definition.operations) ? definition.operations : undefined);
+  const operations = declared?.reduce<Partial<Record<AdapterOperation, true>>>(
     (result, operation) => ({ ...result, [operation]: true }),
     {},
   );
@@ -151,6 +172,18 @@ export function endpointCapabilitiesOf(
   });
 }
 
+/** Resolve and validate the operation declaration for one concrete Endpoint. */
+export function resolveAdapterOperations<TConfig>(
+  definition: Pick<AdapterDefinition<TConfig>, 'operations'>,
+  context: AdapterContext<TConfig>,
+): readonly AdapterOperation[] {
+  const declaration = definition.operations;
+  const operations = typeof declaration === 'function'
+    ? declaration(context)
+    : declaration;
+  return normalizeOperations(operations) ?? Object.freeze([]);
+}
+
 function normalizeOperations(
   operations: readonly AdapterOperation[] | undefined,
 ): readonly AdapterOperation[] | undefined {
@@ -200,6 +233,13 @@ function normalizeSegmentPolicy(
   ) {
     throw new TypeError("Adapter segments.interactive must be 'native' or 'text'");
   }
+  if (
+    policy.markdown !== undefined
+    && policy.markdown !== 'native'
+    && policy.markdown !== 'text'
+  ) {
+    throw new TypeError("Adapter segments.markdown must be 'native' or 'text'");
+  }
   return Object.freeze({
     ...(policy.supported ? { supported: Object.freeze([...new Set(policy.supported)]) } : {}),
     ...(policy.html ? { html: policy.html } : {}),
@@ -207,6 +247,7 @@ function normalizeSegmentPolicy(
       ? { outboundMedia: Object.freeze([...new Set(policy.outboundMedia)]) }
       : {}),
     ...(policy.interactive ? { interactive: policy.interactive } : {}),
+    ...(policy.markdown ? { markdown: policy.markdown } : {}),
   });
 }
 
@@ -224,7 +265,9 @@ export function parseAdapterDefinition(value: unknown): AdapterDefinition {
   ) throw invalidAdapter();
   // defineAdapter 已校验过形状；外部手工构造的 definition 也在此兜底
   normalizeSegmentPolicy(definition.segments);
-  normalizeOperations(definition.operations);
+  if (typeof definition.operations !== 'function') {
+    normalizeOperations(definition.operations);
+  }
   return definition as AdapterDefinition;
 }
 

package/src/endpoint-content.ts

@@ -0,0 +1,28 @@
+import type {
+  ConversationReference,
+  ConversationResolution,
+} from '@zhin.js/im-contract';
+
+export interface EndpointContentResolveContext {
+  readonly signal: AbortSignal;
+  readonly maxDepth: number;
+  readonly maxEntries: number;
+  readonly maxChars: number;
+}
+
+/** Platform semantic port for resolving content that was not observed locally. */
+export interface EndpointContentPort {
+  resolve(
+    reference: ConversationReference,
+    context: EndpointContentResolveContext,
+  ): Promise<ConversationResolution>;
+}
+
+export function endpointContentOf(endpoint: unknown): EndpointContentPort | undefined {
+  if (!endpoint || typeof endpoint !== 'object') return undefined;
+  const content = (endpoint as { readonly content?: unknown }).content;
+  if (!content || typeof content !== 'object') return undefined;
+  return typeof (content as { readonly resolve?: unknown }).resolve === 'function'
+    ? content as EndpointContentPort
+    : undefined;
+}

package/src/endpoint-control.ts

@@ -23,6 +23,15 @@ export interface EndpointWithControl {
   readonly control?: EndpointControl;
 }
 
+/** Bridges the common platform `recall(messageId)` shape into canonical control. */
+export function createRecallEndpointControl(
+  recallById: (messageId: string) => void | Promise<void>,
+): Readonly<EndpointControl> {
+  return Object.freeze<EndpointControl>({
+    recall: (message) => Promise.resolve(recallById(message.id)),
+  });
+}
+
 /** Reads the canonical control port without probing protocol-specific methods. */
 export function endpointControlOf(endpoint: unknown): EndpointControl | undefined {
   if (!endpoint || typeof endpoint !== 'object') return undefined;
@@ -30,7 +39,7 @@ export function endpointControlOf(endpoint: unknown): EndpointControl | undefine
   return explicit && typeof explicit === 'object' ? explicit : undefined;
 }
 
-/** Checks only an Endpoint's explicit `control` port, never the legacy bridge. */
+/** Checks only an Endpoint's explicit `control` port; protocol methods are never probed. */
 export function hasExplicitEndpointOperation(
   endpoint: unknown,
   operation: 'recall' | 'edit' | 'reaction' | 'typing',
@@ -46,6 +55,24 @@ export function hasExplicitEndpointOperation(
   }
 }
 
+/** Lists the semantic operations implemented by an Endpoint's explicit control port. */
+export function listExplicitEndpointOperations(
+  endpoint: unknown,
+): readonly ('recall' | 'edit' | 'reaction' | 'typing')[] {
+  if (!endpoint || typeof endpoint !== 'object') return Object.freeze([]);
+  const control = (endpoint as EndpointWithControl).control;
+  if (!control || typeof control !== 'object') return Object.freeze([]);
+  const operations: Array<'recall' | 'edit' | 'reaction' | 'typing'> = [];
+  if (typeof control.recall === 'function') operations.push('recall');
+  if (typeof control.edit === 'function') operations.push('edit');
+  if (
+    typeof control.addReaction === 'function'
+    || typeof control.removeReaction === 'function'
+  ) operations.push('reaction');
+  if (typeof control.typing === 'function') operations.push('typing');
+  return Object.freeze(operations);
+}
+
 /** Rejects a declaration that cannot be fulfilled by the explicit control port. */
 export function assertDeclaredEndpointOperations(
   endpoint: unknown,
@@ -59,8 +86,25 @@ export function assertDeclaredEndpointOperations(
       );
     }
   }
+  const declared = new Set(operations ?? []);
+  for (const operation of listExplicitEndpointOperations(endpoint)) {
+    if (!declared.has(operation)) {
+      throw new TypeError(
+        `Adapter Endpoint ${id} exposes control.${explicitControlMethodName(endpoint, operation)} but does not declare ${operation}`,
+      );
+    }
+  }
 }
 
 function controlMethodName(operation: 'recall' | 'edit' | 'reaction' | 'typing'): string {
   return operation === 'reaction' ? 'addReaction' : operation;
 }
+
+function explicitControlMethodName(
+  endpoint: unknown,
+  operation: 'recall' | 'edit' | 'reaction' | 'typing',
+): string {
+  if (operation !== 'reaction') return operation;
+  const control = (endpoint as EndpointWithControl).control;
+  return typeof control?.addReaction === 'function' ? 'addReaction' : 'removeReaction';
+}

package/src/endpoint-management.ts

@@ -23,6 +23,19 @@ export interface EndpointChannel {
   readonly parent?: EndpointChannelParent;
 }
 
+/** Pending friend/group request for Console / Host listing (live, not inbox DB). */
+export interface EndpointPendingRequest {
+  readonly platform_request_id: string;
+  readonly type: string;
+  readonly scene_type?: string | null;
+  readonly scene_id: string;
+  readonly sub_type?: string | null;
+  readonly actor_id: string;
+  readonly actor_name?: string | null;
+  readonly comment?: string | null;
+  readonly created_at: number;
+}
+
 /**
  * Optional, platform-neutral management surface exposed by an Endpoint.
  *
@@ -35,6 +48,8 @@ export interface EndpointManagement {
   listGroups?(): Promise<readonly EndpointGroup[]>;
   listChannels?(): Promise<readonly EndpointChannel[]>;
   listGroupMembers?(groupId: string): Promise<readonly unknown[]>;
+  /** Live pending friend/group requests (preferred over unified_inbox_request). */
+  listRequests?(): Promise<readonly EndpointPendingRequest[]>;
   approveRequest?(requestId: string, remark?: string): Promise<void>;
   rejectRequest?(requestId: string, reason?: string): Promise<void>;
   kickGroupMember?(groupId: string, userId: string): Promise<void>;
@@ -57,6 +72,7 @@ export const endpointManagementCapabilityIds = [
   'listGroups',
   'listChannels',
   'listGroupMembers',
+  'listRequests',
   'approveRequest',
   'rejectRequest',
   'kickGroupMember',

package/src/index.ts

@@ -7,5 +7,6 @@ export * from './endpoint-commands.js';
 export * from './endpoint-lifecycle.js';
 export * from './endpoint-management.js';
 export * from './endpoint-control.js';
+export * from './endpoint-content.js';
 export * from './provider.js';
 export { default } from './provider.js';