@zhin.js/adapter-github 1.1.18 → 1.1.20

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # @zhin.js/adapter-github
 
+## 1.1.20
+
+### Patch Changes
+
+- Updated dependencies [5e878ba]
+  - @zhin.js/page@1.1.12
+
+## 1.1.19
+
+### Patch Changes
+
+- 2c3610a: Move account lifecycle ownership into the generic Adapter base and let native Endpoints retain their SDK Client inheritance. Infer platform-specific operation Sessions from a single adapter registry while preserving command parameter, option, configuration and factory inference.
+
+  Bind message replies, management ports, login challenges and Agent cancellation to the captured account incarnation. Persist runtime account intent with encrypted, revision-checked Host storage; keep account management independent of Root process restarts. Require explicit operator confirmation before importing existing accounts, and give replacement accounts a new identity without inheriting previous Sessions.
+
+  Expose account save, start, stop, update and replacement through the existing adapter Console, with exact account ownership, truthful pending/unknown outcomes and no startup configuration or environment-file rewrites.
+
+  Complete the target migration across every adapter, the public authoring API, generators, examples and Console. This intentionally removes the old create factory, inheritable Endpoint/ClientEndpoint classes, Client descriptors and file-rewrite account management; plugin authors must use createAdapter, native Client inheritance and the single AdapterRegistry. Satori and OneBot12 require explicit platform/userId selection, and WeCom requires a separate agentId.
+
+  Verify opaque credential changes before the same configuration snapshot is committed. Drain admitted native callbacks across close/rollback, cancel target work on stop, and keep raw transport parsing, platform ACK timing and SDK native methods under their existing owners. Account metadata conceals credentials carried in URLs.
+
+- a9f4e48: PATCH COMPATIBILITY CUTOVER: this batch intentionally changes plugin APIs. The maintainer explicitly chose patch releases with declared version boundaries. Upgrade the complete tested dependency set; patch numbering does not promise compatibility with the removed interfaces.
+
+  The first planned floors are zhin.js 1.1.19, Core 1.1.54, Adapter 1.1.26, FeatureKit 1.1.10, Plugin Runtime 1.1.18, Runtime/Isolate 1.1.16 and Agent 1.1.45. Keep old-interface plugins with the earlier locked stack until they are migrated. Adapter's independent Feature API changes from 1.0.0 to 2.0.0; official consumers declare ^2.0.0. Existing Feature API admission rejects explicitly incompatible ranges; omitted API metadata keeps its existing behavior and does not certify compatibility. Runtime engine and patch-only release gates remain unchanged.
+
+  Use the native-Client Adapter target contract, canonical FeatureKit AdapterRegistry augmentation and named Endpoint control/management requests. Route message controls from canonical message/conversation refs; retain exact source authority and propagate caller/account/explicit-Root-stop cancellation. Replace removed Agent activity feedback exports with source-bound feedback. HMR pause/resume belongs to concrete plugin instances; plugins choose accepted-work policy without changing Controller commit/rollback authority. Cooperative worker/process control cancellation does not kill an isolate or reopen retired business admission.
+
+  Provide authenticated historical-data preview, exact selected binding, transactional application, authoritative inspection and explicit resumption, including active games. Preserve before-images and journals; never replay an unconfirmed effect, infer an account from an alias, or reuse historical permission grants. Owner V2 approvals remain inactive legacy data, while new writes use V3. Rollback requires matching software, lockfile and verified data; installing old code alone cannot read a new V3 approval file. Conflicting after-images are never overwritten.
+
+  See docs/plans/adapter-operation-version-boundaries.md and the Chinese/English upgrade guide for the complete version inventory, custom-plugin changes, acceptance and recovery sequence. These code and metadata changes do not authorize merging, publication, deployment, login, production migration or removal of installed workspace patches.
+
+- Updated dependencies [2c3610a]
+- Updated dependencies [a9f4e48]
+- Updated dependencies [f8505b0]
+- Updated dependencies [2c3610a]
+  - @zhin.js/adapter@1.1.26
+  - @zhin.js/feature-kit@1.1.10
+  - @zhin.js/core@1.1.54
+  - @zhin.js/host-http@1.1.12
+  - @zhin.js/client@1.1.22
+  - @zhin.js/page@1.1.11
+  - @zhin.js/agent-feature@1.1.11
+  - @zhin.js/skill@1.1.11
+  - @zhin.js/tool@1.1.13
+
 ## 1.1.18
 
 ### Patch Changes

package/README.md

@@ -5,7 +5,7 @@ GitHub Plugin Runtime 适配器 — Issue/PR 评论区即聊天通道，GitHub A
 ## 功能特性
 
 - **聊天通道**：Issue/PR 评论区映射为群聊，支持收发消息
-- **Webhook 入站**：HMAC-SHA256 验签 → `Endpoint.emit(...)`
+- **Webhook 入站**：HMAC-SHA256 验签 → `endpointSpec.events`
 - **出站**：`send({ conversation, payload })` → Issue/PR comment（`conversation.id` 为 channel ID）
 - **GitHub App 认证**：JWT → Installation Token
 - **Agent 工具**：按账号、订阅和仓库操作拆分在 `agents/github/skills/github-*/tools/`，只激活当前任务所需的一组
@@ -94,18 +94,16 @@ github:
 | `src/protocol.ts` | 协议纯函数（channel / payload） |
 | `src/gh-client.ts` | GitHub API 客户端 |
 
-- 入站：`httpHostToken` POST → `Endpoint.emit(...)`
+- 入站：`httpHostToken` POST → `endpointSpec.events`
 - 出站：`send({ conversation, payload })`
 
 ## Console 页面
 
-启动后打开 Console 的「GitHub」页（地址 `/github`），可以：
+在所属插件的 Console 页面管理账号：查看配置与运行状态，添加、编辑、启动、停止、替换或删除账号。首次修改启动账号前，管理员需确认迁移清单；保留原身份与历史。此后保存到 Host 运行时存储，不改启动配置或 `.env`，无需重启进程。
 
-- 查看运行中的连接、点「测试连接」做连通性诊断；
-- 增删 `plugins.github.endpoints`（凭据写入 `.env`，配置里只保留 `${ENV}` 引用）；
-- 如果适配器要求登录，页面会显示 LoginAssist 的扫码 / 滑块 / 设备确认待办；
+新增仅保存，需手动启动；运行账号的普通配置更新只重连该账号。身份变化走明确替换，新账号不会继承旧 Session 或登录状态。账号凭据变化先按平台实际只读接口核验；平台无法核验时需明确替换。空白或遮蔽的密码不会覆盖既有密码。
 
-读取需要 `github:read`，写操作需要 `github:write`；管理员 full token 不受限。页面里的「添加 endpoint」等价于原来的 `github endpoint add`。
+读取需要 `github:read`，写入需要 `github:write`；首次迁移还需管理员身份。无持久化存储时管理操作不可用，提交结果未知时先刷新核实，不重复提交。
 
 ## 故障排查
 

package/adapters/github/index.js

@@ -1,23 +1,12 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { GithubAdapter } from "../../lib/adapter.js";
 /**
  * Convention entry: discover `adapters/github/index.ts` → defineAdapter.
  * Implementation lives under `src/` (endpoint / webhook / oauth / protocol).
  */
 import { defineAdapter } from 'zhin.js/adapter';
-import { httpHostToken } from '@zhin.js/host-http';
-import { databaseHostToken, } from 'zhin.js';
-import { GithubEndpoint } from "../../lib/endpoint.js";
-import { githubRuntimeStateToken } from "../../lib/github-runtime-state.js";
-import { resolveGithubConfig, } from "../../lib/protocol.js";
+import {} from "../../lib/protocol.js";
 export { GithubEndpoint } from "../../lib/endpoint.js";
-function optionalDatabase(context) {
-    try {
-        return context.use(databaseHostToken);
-    }
-    catch {
-        return undefined;
-    }
-}
 export default defineAdapter({
     capabilities: ['inbound', 'outbound'],
     // Issue/PR 评论以 markdown 图片链接消费远程 URL；无交互面，交互段降级纯文本。
@@ -25,27 +14,5 @@ export default defineAdapter({
         outboundMedia: ['url'],
         interactive: 'text',
     },
-    create(context) {
-        const config = resolveGithubConfig(context.config);
-        const database = optionalDatabase(context);
-        // 注册到插件运行时状态（github endpoint list 的"运行中"数据源）
-        context.use(githubRuntimeStateToken).endpoints.set(config.id, {
-            id: config.id,
-            mode: config.webhookSecret ? 'webhook' : 'api',
-        });
-        if (config.webhookSecret) {
-            return new GithubEndpoint({
-                id: context.id,
-                http: context.use(httpHostToken),
-                database,
-                config,
-            });
-        }
-        // API-only: Issue/PR send + agent tools without webhook.
-        return new GithubEndpoint({
-            id: context.id,
-            database,
-            config,
-        });
-    },
+    createAdapter: context => new GithubAdapter(context),
 });

package/adapters/github/index.ts

@@ -1,30 +1,16 @@
+import { GithubAdapter } from '../../src/adapter.js';
 /**
  * Convention entry: discover `adapters/github/index.ts` → defineAdapter.
  * Implementation lives under `src/` (endpoint / webhook / oauth / protocol).
  */
-import { defineAdapter, type AdapterContext } from 'zhin.js/adapter';
-import { httpHostToken } from '@zhin.js/host-http';
+import { defineAdapter } from 'zhin.js/adapter';
 import {
-  databaseHostToken,
-  type PluginDatabaseHost,
-} from 'zhin.js';
-import { GithubEndpoint } from '../../src/endpoint.js';
-import { githubRuntimeStateToken } from '../../src/github-runtime-state.js';
-import {
-  resolveGithubConfig,
   type GithubEndpointConfig,
 } from '../../src/protocol.js';
 
 export { GithubEndpoint } from '../../src/endpoint.js';
 export type { GithubEndpointOptions } from '../../src/endpoint.js';
 
-function optionalDatabase(context: AdapterContext): PluginDatabaseHost | undefined {
-  try {
-    return context.use(databaseHostToken);
-  } catch {
-    return undefined;
-  }
-}
 
 export default defineAdapter<GithubEndpointConfig>({
   capabilities: ['inbound', 'outbound'],
@@ -33,27 +19,5 @@ export default defineAdapter<GithubEndpointConfig>({
     outboundMedia: ['url'],
     interactive: 'text',
   },
-  create(context) {
-    const config = resolveGithubConfig(context.config);
-    const database = optionalDatabase(context);
-    // 注册到插件运行时状态（github endpoint list 的"运行中"数据源）
-    context.use(githubRuntimeStateToken).endpoints.set(config.id, {
-      id: config.id,
-      mode: config.webhookSecret ? 'webhook' : 'api',
-    });
-    if (config.webhookSecret) {
-      return new GithubEndpoint({
-        id: context.id,
-        http: context.use(httpHostToken),
-        database,
-        config,
-      });
-    }
-    // API-only: Issue/PR send + agent tools without webhook.
-    return new GithubEndpoint({
-      id: context.id,
-      database,
-      config,
-    });
-  },
+  createAdapter: context => new GithubAdapter(context),
 });

package/agents/github/skills/github-account/handlers.ts

@@ -4,9 +4,9 @@ import { formatCompact } from '@zhin.js/logger';
 import type { Message } from 'zhin.js';
 import { getCurrentCommMessage } from '@zhin.js/agent/security';
 import { GhClient } from '../../../../src/gh-client.js';
-import type { GithubClient } from '../../../../src/client.js';
+import type { GithubEndpoint } from '../../../../src/endpoint.js';
 
-function oauthModel(client: GithubClient) {
+function oauthModel(client: GithubEndpoint) {
   const db = client.database as {
     models?: Map<string, unknown>;
   } | null | undefined;
@@ -25,7 +25,7 @@ function depsLogger() {
   };
 }
 
-export async function executeGithubBind(_args: Record<string, never>, client: GithubClient, commMessage?: Message, preference?: Locale) {
+export async function executeGithubBind(_args: Record<string, never>, client: GithubEndpoint, commMessage?: Message, preference?: Locale) {
   const log = depsLogger();
   const msg = commMessage ?? getCurrentCommMessage();
   const locale = resolveLocale(preference ?? msg?.locale);
@@ -91,7 +91,7 @@ export async function executeGithubBind(_args: Record<string, never>, client: Gi
   }
 }
 
-export async function executeGithubUnbind(_args: Record<string, never>, client: GithubClient, commMessage?: Message, preference?: Locale) {
+export async function executeGithubUnbind(_args: Record<string, never>, client: GithubEndpoint, commMessage?: Message, preference?: Locale) {
   const msg = commMessage ?? getCurrentCommMessage();
   const locale = resolveLocale(preference ?? msg?.locale);
   if (!msg?.clientAdapter || !msg?.sender?.id) return t(locale, 'missingUser');
@@ -106,7 +106,7 @@ export async function executeGithubUnbind(_args: Record<string, never>, client:
   return t(locale, 'unbound', { login: existing.github_login });
 }
 
-export async function executeGithubWhoami(_args: Record<string, never>, client: GithubClient, commMessage?: Message, preference?: Locale) {
+export async function executeGithubWhoami(_args: Record<string, never>, client: GithubEndpoint, commMessage?: Message, preference?: Locale) {
   const msg = commMessage ?? getCurrentCommMessage();
   const locale = resolveLocale(preference ?? msg?.locale);
   if (!msg?.clientAdapter || !msg?.sender?.id) return t(locale, 'missingUser');
@@ -125,7 +125,7 @@ export async function executeGithubWhoami(_args: Record<string, never>, client:
   return t(locale, 'expired', { login: existing.github_login });
 }
 
-export async function executeGithubInstall(client: GithubClient, locale?: Locale) {
+export async function executeGithubInstall(client: GithubEndpoint, locale?: Locale) {
   const slug = client.appSlug;
   if (!slug) return t(locale, 'missingApp');
   const host = client.host || 'github.com';

package/agents/github/skills/github-repository/handlers.js

@@ -3,7 +3,7 @@ import { createMessages, resolveLocale } from 'zhin.js/i18n';
 import { getCurrentCommMessage } from '@zhin.js/agent/security';
 import { formatChannelContext, parseMessageChannel, resolveWorkspaceBranch, } from "../../../../lib/github-channel-context.js";
 function requireBotGh(client, locale) {
-    const gh = client.api;
+    const gh = client;
     if (!gh?.isAppAuth) {
         throw new Error(t(locale, 'appRequired'));
     }

package/agents/github/skills/github-repository/handlers.ts

@@ -9,10 +9,10 @@ import {
   parseMessageChannel,
   resolveWorkspaceBranch,
 } from '../../../../src/github-channel-context.js';
-import type { GithubClient } from '../../../../src/client.js';
+import type { GithubEndpoint } from '../../../../src/endpoint.js';
 
-function requireBotGh(client: GithubClient, locale?: Locale) {
-  const gh = client.api;
+function requireBotGh(client: GithubEndpoint, locale?: Locale) {
+  const gh = client;
   if (!gh?.isAppAuth) {
     throw new Error(t(locale, 'appRequired'));
   }
@@ -36,7 +36,7 @@ function resolveChannel(msg: Message, repo?: string, locale?: Locale) {
 
 export async function executeGithubPrepareWorkspace(
   args: { repo?: string },
-  client: GithubClient,
+  client: GithubEndpoint,
   commMessage?: Message,
   preference?: Locale,
 ) {
@@ -57,7 +57,7 @@ export async function executeGithubPrepareWorkspace(
 
 export async function executeGithubPatchFile(
   args: { repo?: string; path: string; content: string; message: string; branch?: string },
-  client: GithubClient,
+  client: GithubEndpoint,
   commMessage?: Message,
   preference?: Locale,
 ) {
@@ -87,7 +87,7 @@ export async function executeGithubPatchFile(
 
 export async function executeGithubPushBranch(
   args: { repo?: string; branch?: string; message: string },
-  client: GithubClient,
+  client: GithubEndpoint,
   commMessage?: Message,
   preference?: Locale,
 ) {
@@ -103,7 +103,7 @@ export async function executeGithubPushBranch(
 
 export async function executeGithubCreatePr(
   args: { repo?: string; title: string; body?: string; head?: string; base?: string },
-  client: GithubClient,
+  client: GithubEndpoint,
   commMessage?: Message,
   preference?: Locale,
 ) {

package/agents/github/skills/github-subscriptions/handlers.ts

@@ -1,10 +1,10 @@
 import { createMessages, resolveLocale, type Locale } from 'zhin.js/i18n';
 import type { Message } from 'zhin.js';
 import { getCurrentCommMessage } from '@zhin.js/agent/security';
-import type { GithubClient } from '../../../../src/client.js';
+import type { GithubEndpoint } from '../../../../src/endpoint.js';
 import type { EventType } from '../../../../src/types.js';
 
-function subscriptionsModel(client: GithubClient) {
+function subscriptionsModel(client: GithubEndpoint) {
   const db = client.database as {
     models?: Map<string, unknown>;
   } | null | undefined;
@@ -16,7 +16,7 @@ function subscriptionsModel(client: GithubClient) {
   } | undefined;
 }
 
-export async function executeGithubStar(args: { action: 'star' | 'unstar' | 'check'; repo: string }, client: GithubClient, commMessage?: Message, preference?: Locale) {
+export async function executeGithubStar(args: { action: 'star' | 'unstar' | 'check'; repo: string }, client: GithubEndpoint, commMessage?: Message, preference?: Locale) {
   const msg = commMessage ?? getCurrentCommMessage();
   const locale = resolveLocale(preference ?? msg?.locale);
   const gh = await client.getUserOrDefaultApi(msg?.clientAdapter, msg?.sender?.id);
@@ -38,7 +38,7 @@ export async function executeGithubStar(args: { action: 'star' | 'unstar' | 'che
   }
 }
 
-export async function executeGithubSubscribe(args: { repo: string; events?: string }, client: GithubClient, commMessage?: Message, preference?: Locale) {
+export async function executeGithubSubscribe(args: { repo: string; events?: string }, client: GithubEndpoint, commMessage?: Message, preference?: Locale) {
   const msg = commMessage ?? getCurrentCommMessage();
   const locale = resolveLocale(preference ?? msg?.locale);
   if (!msg?.clientAdapter || !msg?.sender?.id || !msg?.conversation.id || !msg?.endpointId) {
@@ -77,7 +77,7 @@ export async function executeGithubSubscribe(args: { repo: string; events?: stri
   return t(locale, 'subscribed', { repo: args.repo, events: events.join(', ') });
 }
 
-export async function executeGithubUnsubscribe(args: { repo: string }, client: GithubClient, commMessage?: Message, preference?: Locale) {
+export async function executeGithubUnsubscribe(args: { repo: string }, client: GithubEndpoint, commMessage?: Message, preference?: Locale) {
   const msg = commMessage ?? getCurrentCommMessage();
   const locale = resolveLocale(preference ?? msg?.locale);
   if (!msg?.clientAdapter || !msg?.conversation.id || !msg?.endpointId) {
@@ -99,7 +99,7 @@ export async function executeGithubUnsubscribe(args: { repo: string }, client: G
   return t(locale, 'unsubscribed', { repo: args.repo });
 }
 
-export async function executeGithubSubscriptions(_args: Record<string, never>, client: GithubClient, commMessage?: Message, preference?: Locale) {
+export async function executeGithubSubscriptions(_args: Record<string, never>, client: GithubEndpoint, commMessage?: Message, preference?: Locale) {
   const msg = commMessage ?? getCurrentCommMessage();
   const locale = resolveLocale(preference ?? msg?.locale);
   if (!msg?.clientAdapter || !msg?.conversation.id || !msg?.endpointId) {

package/commands/github/endpoint/definition.js

@@ -9,7 +9,6 @@
  */
 import { createEndpointCommands } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { githubRuntimeStateToken } from "../../../lib/github-runtime-state.js";
 export const githubEndpointCommands = createEndpointCommands({
     adapterKey: 'github',
     adapterDisplayName: 'GitHub',
@@ -18,6 +17,5 @@ export const githubEndpointCommands = createEndpointCommands({
         { key: 'private_key', required: true, description: 'PEM 文件路径（推荐，如 ./data/xxx.pem）或 PEM 内容', descriptionI18n: { en: "PEM file path (recommended, such as ./data/app.pem) or PEM content" } },
         { key: 'webhook_secret', env: true, description: 'webhook 签名密钥（不配则 API-only）', descriptionI18n: { en: "Webhook signing secret (API-only when omitted)" } },
     ],
-    running: (use) => use(githubRuntimeStateToken).endpoints.values(),
     describeEntry: (entry) => `app_id: ${String(entry.app_id)}`,
 }, defineCommand);

package/commands/github/endpoint/definition.ts

@@ -8,7 +8,6 @@
  */
 import { createEndpointCommands } from 'zhin.js/adapter';
 import { defineCommand } from 'zhin.js/command';
-import { githubRuntimeStateToken } from '../../../src/github-runtime-state.js';
 
 export const githubEndpointCommands = createEndpointCommands({
   adapterKey: 'github',
@@ -18,6 +17,5 @@ export const githubEndpointCommands = createEndpointCommands({
     { key: 'private_key', required: true, description: 'PEM 文件路径（推荐，如 ./data/xxx.pem）或 PEM 内容', descriptionI18n: { en: "PEM file path (recommended, such as ./data/app.pem) or PEM content" } },
     { key: 'webhook_secret', env: true, description: 'webhook 签名密钥（不配则 API-only）', descriptionI18n: { en: "Webhook signing secret (API-only when omitted)" } },
   ],
-  running: (use) => use(githubRuntimeStateToken).endpoints.values(),
   describeEntry: (entry) => `app_id: ${String(entry.app_id)}`,
 }, defineCommand);

package/lib/adapter.d.ts

@@ -0,0 +1,19 @@
+import { Adapter, type AdapterContext, type EndpointCreationContext } from 'zhin.js/adapter';
+import { GithubEndpoint } from './endpoint.js';
+import { type GithubEndpointConfig } from './protocol.js';
+import type { GithubClientEventMap } from './client.js';
+export declare class GithubAdapter extends Adapter<GithubEndpoint, GithubEndpointConfig, GithubClientEventMap> {
+    #private;
+    constructor(context: AdapterContext<GithubEndpointConfig>);
+    get configurationIdentityFields(): readonly string[];
+    get configurationUpdateFields(): readonly string[];
+    get configurationIdentityProbeFields(): readonly string[];
+    protected identifyConfiguration(input: GithubEndpointConfig, signal: AbortSignal, _changed: readonly string[]): Promise<string | undefined>;
+    protected validateConfiguration(config: GithubEndpointConfig): void;
+    protected createEndpoint(input: GithubEndpointConfig, execution: EndpointCreationContext): GithubEndpoint;
+}
+declare module '@zhin.js/feature-kit' {
+    interface AdapterRegistry {
+        readonly 'github': GithubAdapter;
+    }
+}

package/lib/adapter.js

@@ -0,0 +1,30 @@
+import { GhClient } from './gh-client.js';
+import { Adapter } from 'zhin.js/adapter';
+import { GithubEndpoint } from './endpoint.js';
+import { resolveGithubConfig } from './protocol.js';
+import { httpHostToken } from '@zhin.js/host-http';
+import { databaseHostToken } from 'zhin.js';
+export class GithubAdapter extends Adapter {
+    #context;
+    constructor(context) { super(); this.#context = context; }
+    get configurationIdentityFields() { return ['id', 'app_id', 'host']; }
+    get configurationUpdateFields() { return ['private_key', 'webhook_secret', 'webhook_path', 'auto_reply_repos', 'bot_login', 'workspace_root']; }
+    get configurationIdentityProbeFields() { return ['private_key']; }
+    async identifyConfiguration(input, signal, _changed) {
+        const config = resolveGithubConfig(input), client = new GhClient({ host: config.host, appAuth: { appId: config.appId, privateKey: config.privateKey }, signal });
+        const authenticated = await client.verifyAuth();
+        signal.throwIfAborted();
+        if (!authenticated.ok)
+            throw new Error('GitHub application identity verification failed');
+        const identity = await client.getBotIdentity();
+        signal.throwIfAborted();
+        if (!identity?.userId)
+            throw new Error('GitHub identity verification returned no bot userId');
+        return JSON.stringify(['github', config.host ?? 'github.com', identity.userId]);
+    }
+    validateConfiguration(config) { resolveGithubConfig(config); }
+    createEndpoint(input, execution) {
+        const config = resolveGithubConfig(input);
+        return new GithubEndpoint({ id: execution.canonicalId, config, ...(config.webhookSecret ? { http: this.#context.use(httpHostToken) } : {}), ...(this.#context.has?.(databaseHostToken) ? { database: this.#context.use(databaseHostToken) } : {}) });
+    }
+}

package/lib/client.d.ts

@@ -1,36 +1 @@
-import type { PluginDatabaseHost } from 'zhin.js';
-import { GhClient } from './gh-client.js';
-import type { ResolvedGithubConfig } from './protocol.js';
-import { WorkspaceManager } from './workspace-manager.js';
-/** GitHub SDK surface exposed to plugin handlers and Agent tools. */
-export declare class GithubClient {
-    #private;
-    readonly name: string;
-    readonly api: GhClient;
-    readonly config: ResolvedGithubConfig;
-    readonly database?: PluginDatabaseHost | undefined;
-    constructor(name: string, api: GhClient, config: ResolvedGithubConfig, database?: PluginDatabaseHost | undefined);
-    getUserOrDefaultApi(platform?: string, platformUid?: string): Promise<GhClient>;
-    get clientId(): string | null;
-    get host(): string | undefined;
-    get appSlug(): string | null;
-    get installations(): {
-        id: number;
-        account: {
-            login: string;
-            type: string;
-        };
-        target_type: string;
-    }[];
-    get workspaceManager(): WorkspaceManager;
-}
 export type GithubClientEventMap = Record<string, unknown>;
-declare module '@zhin.js/feature-kit' {
-    interface AdapterClientRegistry {
-        readonly github: {
-            readonly client: GithubClient;
-            readonly events: GithubClientEventMap;
-        };
-    }
-}
-export declare const githubClient: import("@zhin.js/adapter").EndpointClientToken<GithubClient, GithubClientEventMap>;

package/lib/client.js

@@ -1,44 +1 @@
-import { defineEndpointClient } from 'zhin.js/adapter';
-import { lookupGithubOauthAccessToken } from './oauth-users.js';
-import { WorkspaceManager } from './workspace-manager.js';
-/** GitHub SDK surface exposed to plugin handlers and Agent tools. */
-export class GithubClient {
-    name;
-    api;
-    config;
-    database;
-    #workspaceManager;
-    constructor(name, api, config, database) {
-        this.name = name;
-        this.api = api;
-        this.config = config;
-        this.database = database;
-    }
-    async getUserOrDefaultApi(platform, platformUid) {
-        if (platform && platformUid) {
-            const token = await lookupGithubOauthAccessToken(this.database, platform, platformUid);
-            if (token)
-                return this.api.withToken(token);
-        }
-        return this.api;
-    }
-    get clientId() {
-        return this.api.clientId || null;
-    }
-    get host() {
-        return this.config.host;
-    }
-    get appSlug() {
-        return this.api.appSlug || null;
-    }
-    get installations() {
-        return this.api.installations || [];
-    }
-    get workspaceManager() {
-        if (!this.#workspaceManager) {
-            this.#workspaceManager = new WorkspaceManager(this.api, this.config.workspaceRoot);
-        }
-        return this.#workspaceManager;
-    }
-}
-export const githubClient = defineEndpointClient('github');
+export {};

package/lib/console.d.ts

@@ -5,4 +5,4 @@
  */
 import { type AdapterConsoleResources } from 'zhin.js/adapter';
 import type { PluginConsoleRpc } from 'zhin.js';
-export declare function createGithubConsoleRpc(resources: AdapterConsoleResources, getConfig: () => unknown): PluginConsoleRpc;
+export declare function createGithubConsoleRpc(_resources: AdapterConsoleResources, getConfig: () => unknown): PluginConsoleRpc;

package/lib/console.js

@@ -4,13 +4,10 @@
  * 页面绑定 `pages/index`，读取 / 写入分别要求 `<adapter>:read` / `<adapter>:write`。
  */
 import { createAdapterConsoleRpc } from 'zhin.js/adapter';
-import { githubRuntimeStateToken } from './github-runtime-state.js';
 import { githubConsoleSpec } from './console-spec.js';
-export function createGithubConsoleRpc(resources, getConfig) {
-    const state = resources.use(githubRuntimeStateToken);
+export function createGithubConsoleRpc(_resources, getConfig) {
     return createAdapterConsoleRpc({
         ...githubConsoleSpec,
-        running: () => state.endpoints.values(),
         getConfig,
-    }, resources);
+    });
 }

package/lib/endpoint.d.ts

@@ -1,36 +1,33 @@
-import { Endpoint } from 'zhin.js/adapter';
+import { endpointSpec, type Endpoint } from 'zhin.js/adapter';
 /**
  * GithubEndpoint — lifecycle, outbound send, inbound admit.
  */
-import { type EndpointSendRequest } from 'zhin.js/adapter';
 import type { HttpHost } from '@zhin.js/host-http';
 import type { CapabilityId, PluginDatabaseHost } from 'zhin.js';
 import { GhClient } from './gh-client.js';
 import { type GithubInboundComment, type ResolvedGithubConfig } from './protocol.js';
-import { GithubClient } from './client.js';
+import { WorkspaceManager } from './workspace-manager.js';
 export interface GithubEndpointOptions {
     readonly id: CapabilityId;
     readonly http?: HttpHost;
     readonly database?: PluginDatabaseHost;
     readonly config: ResolvedGithubConfig;
-    readonly createClient?: (config: ResolvedGithubConfig) => GhClient;
 }
 /**
  * GitHub 是代码协作面（issue/PR），无好友/群/频道等 IM 社交概念，
  * 不适用 EndpointManagement 语义端口；本 endpoint 不暴露该端口。
  */
-export declare class GithubEndpoint extends Endpoint<GithubClient> {
+export declare class GithubEndpoint extends GhClient implements Endpoint {
     #private;
-    readonly client: GithubClient;
+    readonly [endpointSpec]: import("@zhin.js/adapter").EndpointSpecification;
+    get database(): PluginDatabaseHost | undefined;
+    get host(): string | undefined;
+    getUserOrDefaultApi(platform?: string, platformUid?: string): Promise<GhClient>;
+    get workspaceManager(): WorkspaceManager;
     constructor(options: GithubEndpointOptions);
     get config(): ResolvedGithubConfig;
-    start(): Promise<void>;
-    open(): void;
-    close(): void;
-    stop(): Promise<void>;
-    send({ conversation, payload }: EndpointSendRequest): Promise<string>;
     /** Test / internal: admit a parsed comment when open. */
-    admit(comment: GithubInboundComment): void;
+    admit(comment: GithubInboundComment, nativeEvent?: unknown): void;
     admitPlatform(name: string, event: unknown): void;
 }
 export declare function defaultCreateClient(config: ResolvedGithubConfig): GhClient;