@zhin.js/adapter 1.1.9 → 1.1.11

package/README.md

@@ -8,10 +8,10 @@ generation lifecycle。候选 Endpoint 可完成连接 readiness，但入站由
 销毁整组候选 Endpoint 并拒绝本次 generation，不存在 inert stub 或后台 late-open。
 
 ```ts
-import { defineAdapter } from '@zhin.js/adapter';
+import { defineAdapter } from 'zhin.js/adapter';
 
 export default defineAdapter({
-  capabilities: ['inbound', 'outbound'],
+  capabilities: ['inbound'],
   create: (context) => ({ name: context.name }),
 });
 ```
@@ -32,7 +32,9 @@ instead of probing optional endpoint methods. The zero-dependency types live in
 
 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
 
@@ -66,7 +68,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,6 +1,8 @@
 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 EndpointManagementCapability } from './endpoint-management.js';
+import { type EndpointContentResolveContext } from './endpoint-content.js';
+import type { ConversationReference, ConversationResolution } from '@zhin.js/im-contract';
 export interface AdapterDescriptor {
     readonly id: CapabilityId;
     readonly owner: PluginId;
@@ -46,6 +48,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

@@ -2,6 +2,7 @@ import { DisposeStack, GenerationCompensationError, createGenerationAdmissionGat
 import { createCapabilityContext } from '@zhin.js/feature-kit';
 import { listEndpointManagementCapabilities, } from './endpoint-management.js';
 import { assertDeclaredEndpointOperations } from './endpoint-control.js';
+import { endpointContentOf } from './endpoint-content.js';
 export class AdapterIndex {
     $projection = 'zhin.adapter-index/1';
     #records = new Map();
@@ -194,7 +195,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) {
@@ -289,6 +307,9 @@ async function createEndpoint(slot, snapshot, admission, signal, expansion) {
         name: slot.localName,
     }));
     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, String(expansion?.id ?? slot.id));
     return endpoint;
 }

package/lib/definition.d.ts

@@ -3,6 +3,7 @@ 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. */
@@ -11,16 +12,20 @@ export type AdapterOperation = Exclude<EndpointOperation, 'send'>;
 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 +34,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 +66,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[];
     /**
@@ -75,14 +83,14 @@ export interface AdapterDefinition<TConfig = unknown, TResult = unknown> {
     readonly operations?: readonly AdapterOperation[];
     /** 可选：端点消息段能力声明（出站协商降级挂载点）。 */
     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 parseAdapterDefinition(value: unknown): AdapterDefinition;

package/lib/definition.js

@@ -66,6 +66,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 +78,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) {

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

@@ -21,7 +21,7 @@ export interface EndpointWithControl {
 }
 /** 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;
 /** 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

@@ -5,7 +5,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;

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.9",
+  "version": "1.1.11",
   "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.10",
-    "@zhin.js/im-contract": "1.0.3",
-    "@zhin.js/plugin-runtime": "1.1.6",
-    "@zhin.js/logger": "1.0.76"
+    "@zhin.js/im-contract": "1.0.4",
+    "@zhin.js/feature-kit": "1.0.12",
+    "@zhin.js/logger": "1.0.76",
+    "@zhin.js/plugin-runtime": "1.1.7"
   },
   "devDependencies": {
     "@types/node": "^26.1.2",
     "typescript": "^6.0.3",
-    "@zhin.js/command": "1.0.13"
+    "@zhin.js/command": "1.0.15"
   },
   "zhin": {
     "protocol": 1,

package/src/adapter-index.ts

@@ -22,6 +22,8 @@ import {
   type EndpointManagementCapability,
 } from './endpoint-management.js';
 import { assertDeclaredEndpointOperations } from './endpoint-control.js';
+import { endpointContentOf, type EndpointContentResolveContext } from './endpoint-content.js';
+import type { ConversationReference, ConversationResolution } from '@zhin.js/im-contract';
 
 export interface AdapterDescriptor {
   readonly id: CapabilityId;
@@ -251,7 +253,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 +262,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);
   }
 }
 
@@ -384,6 +406,11 @@ async function createEndpoint(
     }),
   );
   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,

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;
 
@@ -20,6 +21,8 @@ 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 +30,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 +45,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 +80,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 +95,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[];
   /**
@@ -100,21 +108,21 @@ export interface AdapterDefinition<TConfig = unknown, TResult = unknown> {
   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');
   }
@@ -200,6 +208,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 +222,7 @@ function normalizeSegmentPolicy(
       ? { outboundMedia: Object.freeze([...new Set(policy.outboundMedia)]) }
       : {}),
     ...(policy.interactive ? { interactive: policy.interactive } : {}),
+    ...(policy.markdown ? { markdown: policy.markdown } : {}),
   });
 }
 

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

@@ -30,7 +30,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',

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';