@zhin.js/adapter-github 6.0.0 → 6.0.2

package/lib/github-agent-deps.d.ts

@@ -1,47 +0,0 @@
-/**
- * Agent tool deps for github.
- * Endpoints register themselves on start; tools look up by config name / endpoint id.
- */
-import type { GhClient } from './gh-client.js';
-import type { ResolvedGithubConfig } from './protocol.js';
-import type { WorkspaceManager } from './workspace-manager.js';
-export interface GithubAgentEndpoint {
-    readonly name: string;
-    readonly gh: GhClient;
-    readonly config: ResolvedGithubConfig;
-    getAPI(): GhClient;
-    getUserOrDefaultAPI(platform?: string, platformUid?: string): Promise<GhClient | null>;
-    getClientId(): string | null;
-    getHost(): string | undefined;
-    getAppSlug(): string | null;
-    getInstallations(): Array<{
-        id: number;
-        account: {
-            login: string;
-            type: string;
-        };
-        target_type: string;
-    }>;
-    getWorkspaceManager(): WorkspaceManager;
-    /** DatabaseHost wired at endpoint creation (optional). */
-    getDatabase?(): unknown;
-}
-export interface GithubAgentDeps {
-    getEndpoint: (endpointKey?: string) => GithubAgentEndpoint;
-    /** Alias kept for existing agent handlers that call getAdapter(). */
-    getAdapter: () => GithubAgentEndpoint;
-    getWorkspaceManager: () => WorkspaceManager;
-    getDatabase?: () => {
-        models?: Map<string, unknown>;
-    } | null | undefined;
-    logger?: {
-        debug: (...args: unknown[]) => void;
-        warn: (...args: unknown[]) => void;
-        error: (...args: unknown[]) => void;
-    };
-}
-export declare function registerGithubAgentEndpoint(endpointKey: string, endpoint: GithubAgentEndpoint): () => void;
-/** Optional override used by tests / transitional callers. Pass `null` to clear. */
-export declare function setGithubAgentDeps(deps: GithubAgentDeps | null): void;
-export declare function getGithubAgentDeps(): GithubAgentDeps;
-export declare function getAdapter(): GithubAgentEndpoint;

package/lib/github-agent-deps.js

@@ -1,43 +0,0 @@
-/**
- * Agent tool deps for github.
- * Endpoints register themselves on start; tools look up by config name / endpoint id.
- */
-const endpoints = new Map();
-let override = null;
-export function registerGithubAgentEndpoint(endpointKey, endpoint) {
-    endpoints.set(endpointKey, endpoint);
-    return () => {
-        if (endpoints.get(endpointKey) === endpoint) {
-            endpoints.delete(endpointKey);
-        }
-    };
-}
-/** Optional override used by tests / transitional callers. Pass `null` to clear. */
-export function setGithubAgentDeps(deps) {
-    override = deps;
-}
-function lookup(endpointKey) {
-    if (endpointKey) {
-        const registered = endpoints.get(endpointKey);
-        if (!registered)
-            throw new Error(`Endpoint ${endpointKey} 不存在`);
-        return registered;
-    }
-    const first = endpoints.values().next().value;
-    if (!first)
-        throw new Error('github agent deps not initialized');
-    return first;
-}
-export function getGithubAgentDeps() {
-    if (override)
-        return override;
-    return {
-        getEndpoint: lookup,
-        getAdapter: () => lookup(),
-        getWorkspaceManager: () => lookup().getWorkspaceManager(),
-        getDatabase: () => lookup().getDatabase?.(),
-    };
-}
-export function getAdapter() {
-    return getGithubAgentDeps().getAdapter();
-}

package/src/agent-prompt.ts

@@ -1,101 +0,0 @@
-import type {
-  AgentPromptBuildContext,
-  AgentPromptContributor,
-  AgentPromptSection,
-  DeferredToolCatalogItem,
-} from 'zhin.js';
-import { filterTools, type AgentTool } from 'zhin.js/ai';
-
-function selectGithubDeferredTools(
-  query: string,
-  goal: string,
-  deferredCatalog: DeferredToolCatalogItem[],
-  maxTools: number,
-): DeferredToolCatalogItem[] {
-  const pool = deferredCatalog.filter(
-    t => !t.name.startsWith('mcp_filesystem') && !t.name.startsWith('mcp_icqq_'),
-  );
-  const pinned: DeferredToolCatalogItem[] = [];
-  const bash = pool.find(t => t.name === 'bash');
-  if (bash) pinned.push(bash);
-
-  const preferNames = [
-    ...pool.filter(t => t.name.startsWith('github_')).map(t => t.name),
-    ...pool.filter(t => t.name.startsWith('mcp_github_')).map(t => t.name),
-  ];
-  for (const name of preferNames) {
-    if (pinned.length >= maxTools) break;
-    const t = pool.find(x => x.name === name);
-    if (t && !pinned.some(p => p.name === name)) pinned.push(t);
-  }
-
-  const extra = filterTools(`${query} ${goal}`, pool as AgentTool[], { maxTools, minScore: 0.08 })
-    .map((t) => ({ name: t.name, description: t.description }));
-
-  const merged: DeferredToolCatalogItem[] = [...pinned];
-  for (const t of extra) {
-    if (merged.length >= maxTools) break;
-    if (!merged.some(p => p.name === t.name)) merged.push(t);
-  }
-  return merged.slice(0, maxTools);
-}
-
-function isGithubDelegatedTask(query: string, goal: string): boolean {
-  const text = `${query} ${goal}`;
-  return /github|gh_|mcp_github|\bissue\b|pull\s*request|\bpr\b/i.test(text);
-}
-
-const ORCHESTRATOR_GITHUB = [
-  'On GitHub: use run_deferred_task with tool_query "github_".',
-  'Discuss issues/PRs in chat context; do not call github_* tools on this orchestrator.',
-  'Bot write operations use github_* tools (Installation Token), not mcp_github_*.',
-].join('\n');
-
-const WORKER_GITHUB = [
-  'Use github_prepare_workspace before multi-file edits in a repo.',
-  'Small single-file change: github_patch_file (Contents API).',
-  'Multi-file / tests: workspace + bash, then github_push_branch (requires approval) and github_create_pr for Issues.',
-  'Issue thread: new branch + new PR. PR thread: push to existing PR head branch.',
-  'Do NOT use mcp_github_* for writes — PAT acts as human, not Bot.',
-  'Summarize outcomes (PR link, branch) for the orchestrator.',
-].map(line => `- ${line}`).join('\n');
-
-export function createGithubAgentPromptContributor(): AgentPromptContributor {
-  return {
-    platform: 'github',
-
-    async buildSections(ctx: AgentPromptBuildContext): Promise<AgentPromptSection[] | null> {
-      if (ctx.slot === 'orchestrator') {
-        return [{
-          id: 'platform.github.orchestrator',
-          title: '## GitHub',
-          body: ORCHESTRATOR_GITHUB,
-          priority: 50,
-        }];
-      }
-      if (ctx.slot === 'deferred_worker') {
-        const query = ctx.deferred?.toolQuery ?? ctx.deferred?.goal ?? '';
-        const goal = ctx.deferred?.goal ?? '';
-        if (!isGithubDelegatedTask(query, goal)) return null;
-        return [{
-          id: 'platform.github.deferred_worker',
-          title: '## GitHub（本任务）',
-          body: WORKER_GITHUB,
-          priority: 50,
-        }];
-      }
-      return null;
-    },
-
-    matchesDeferredTask(ctx: AgentPromptBuildContext): boolean {
-      const query = ctx.deferred?.toolQuery ?? ctx.deferred?.goal ?? ctx.userMessagePreview ?? '';
-      const goal = ctx.deferred?.goal ?? ctx.userMessagePreview ?? '';
-      return isGithubDelegatedTask(query, goal);
-    },
-
-    selectDeferredTools(query, goal, catalog, maxTools) {
-      if (!isGithubDelegatedTask(query, goal)) return null;
-      return selectGithubDeferredTools(query, goal, catalog, maxTools);
-    },
-  };
-}

package/src/github-agent-deps.ts

@@ -1,82 +0,0 @@
-/**
- * Agent tool deps for github.
- * Endpoints register themselves on start; tools look up by config name / endpoint id.
- */
-
-import type { GhClient } from './gh-client.js';
-import type { ResolvedGithubConfig } from './protocol.js';
-import type { WorkspaceManager } from './workspace-manager.js';
-
-export interface GithubAgentEndpoint {
-  readonly name: string;
-  readonly gh: GhClient;
-  readonly config: ResolvedGithubConfig;
-  getAPI(): GhClient;
-  getUserOrDefaultAPI(platform?: string, platformUid?: string): Promise<GhClient | null>;
-  getClientId(): string | null;
-  getHost(): string | undefined;
-  getAppSlug(): string | null;
-  getInstallations(): Array<{ id: number; account: { login: string; type: string }; target_type: string }>;
-  getWorkspaceManager(): WorkspaceManager;
-  /** DatabaseHost wired at endpoint creation (optional). */
-  getDatabase?(): unknown;
-}
-
-export interface GithubAgentDeps {
-  getEndpoint: (endpointKey?: string) => GithubAgentEndpoint;
-  /** Alias kept for existing agent handlers that call getAdapter(). */
-  getAdapter: () => GithubAgentEndpoint;
-  getWorkspaceManager: () => WorkspaceManager;
-  getDatabase?: () => { models?: Map<string, unknown> } | null | undefined;
-  logger?: {
-    debug: (...args: unknown[]) => void;
-    warn: (...args: unknown[]) => void;
-    error: (...args: unknown[]) => void;
-  };
-}
-
-const endpoints = new Map<string, GithubAgentEndpoint>();
-let override: GithubAgentDeps | null = null;
-
-export function registerGithubAgentEndpoint(
-  endpointKey: string,
-  endpoint: GithubAgentEndpoint,
-): () => void {
-  endpoints.set(endpointKey, endpoint);
-  return () => {
-    if (endpoints.get(endpointKey) === endpoint) {
-      endpoints.delete(endpointKey);
-    }
-  };
-}
-
-/** Optional override used by tests / transitional callers. Pass `null` to clear. */
-export function setGithubAgentDeps(deps: GithubAgentDeps | null): void {
-  override = deps;
-}
-
-function lookup(endpointKey?: string): GithubAgentEndpoint {
-  if (endpointKey) {
-    const registered = endpoints.get(endpointKey);
-    if (!registered) throw new Error(`Endpoint ${endpointKey} 不存在`);
-    return registered;
-  }
-  const first = endpoints.values().next().value;
-  if (!first) throw new Error('github agent deps not initialized');
-  return first;
-}
-
-export function getGithubAgentDeps(): GithubAgentDeps {
-  if (override) return override;
-  return {
-    getEndpoint: lookup,
-    getAdapter: () => lookup(),
-    getWorkspaceManager: () => lookup().getWorkspaceManager(),
-    getDatabase: () => lookup().getDatabase?.() as
-      { models?: Map<string, unknown> } | null | undefined,
-  };
-}
-
-export function getAdapter(): GithubAgentEndpoint {
-  return getGithubAgentDeps().getAdapter();
-}