dsh-github-flow 0.1.0 → 0.1.3

package/lib/tools/repo.js

@@ -1,6 +1,14 @@
-import { defineSafeTool } from './define.js';
+function normalizeOutput(data) {
+    if (data && typeof data === 'object' && !Array.isArray(data)) {
+        return data;
+    }
+    if (Array.isArray(data)) {
+        return { items: data, count: data.length };
+    }
+    return { result: data !== undefined && data !== null ? data : '' };
+}
 export function createRepoTool(executor) {
-    return defineSafeTool({
+    return {
         name: 'github_repo',
         description: '查看 GitHub 仓库元数据与跨仓库检索代码、Issue。默认查询当前工作区关联的仓库。',
         parameters: {
@@ -29,7 +37,15 @@ export function createRepoTool(executor) {
         output: {
             schema: { type: 'object' },
             render(args, value) {
-                return [{ type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) }];
+                if (!value)
+                    return [{ type: 'text', text: '无返回内容' }];
+                if (typeof value.result === 'string') {
+                    return [{ type: 'text', text: value.result }];
+                }
+                if (Array.isArray(value.items)) {
+                    return [{ type: 'text', text: JSON.stringify(value.items, null, 2) }];
+                }
+                return [{ type: 'text', text: JSON.stringify(value, null, 2) }];
             },
         },
         async execute(args, execContext) {
@@ -37,11 +53,18 @@ export function createRepoTool(executor) {
             const limitStr = String(args.limit || 10);
             switch (args.action) {
                 case 'view': {
-                    const repoArgs = args.repo ? [args.repo] : [];
+                    let repoTarget = args.repo;
+                    if (!repoTarget) {
+                        const meta = await executor.getRepoMetadata(cwd);
+                        if (meta?.nameWithOwner) {
+                            repoTarget = meta.nameWithOwner;
+                        }
+                    }
+                    const repoArgs = repoTarget ? [repoTarget] : [];
                     const res = await executor.run(['repo', 'view', ...repoArgs, '--json', 'nameWithOwner,description,defaultBranchRef,isPrivate,stargazerCount,forkCount,url'], { cwd });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.data || res.rawOutput;
+                    return normalizeOutput(res.data || res.rawOutput);
                 }
                 case 'search_code': {
                     if (!args.query)
@@ -50,7 +73,7 @@ export function createRepoTool(executor) {
                     const res = await executor.run(['search', 'code', args.query, ...repoArgs, '--json', 'path,repository,textMatches', '-L', limitStr], { cwd });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.data || res.rawOutput;
+                    return normalizeOutput(res.data || res.rawOutput);
                 }
                 case 'search_repos': {
                     if (!args.query)
@@ -58,11 +81,11 @@ export function createRepoTool(executor) {
                     const res = await executor.run(['search', 'repos', args.query, '--json', 'fullName,description,stargazersCount,updatedAt', '-L', limitStr], { cwd });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.data || res.rawOutput;
+                    return normalizeOutput(res.data || res.rawOutput);
                 }
                 default:
                     throw new Error(`未知的 Repo 操作: ${args.action}`);
             }
         },
-    });
+    };
 }

package/lib/tools/run.d.ts

@@ -1,2 +1,38 @@
 import type { GhExecutor } from '../executor.js';
-export declare function createRunTool(executor: GhExecutor): any;
+export declare function createRunTool(executor: GhExecutor): {
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            run_id: {
+                type: string;
+                description: string;
+            };
+            repo: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    output: {
+        schema: {
+            type: string;
+        };
+        render(args: any, value: any): {
+            type: string;
+            text: any;
+        }[];
+    };
+    execute(args: any, execContext: any): Promise<Record<string, any>>;
+};

package/lib/tools/run.js

@@ -1,6 +1,14 @@
-import { defineSafeTool } from './define.js';
+function normalizeOutput(data) {
+    if (data && typeof data === 'object' && !Array.isArray(data)) {
+        return data;
+    }
+    if (Array.isArray(data)) {
+        return { items: data, count: data.length };
+    }
+    return { result: data !== undefined && data !== null ? data : '' };
+}
 export function createRunTool(executor) {
-    return defineSafeTool({
+    return {
         name: 'github_run',
         description: '排查和诊断 GitHub Actions 工作流构建状态。特别优化了获取失败步骤日志能力（log_failed），专供 Agent 快速定位 CI 报错。',
         parameters: {
@@ -29,18 +37,33 @@ export function createRunTool(executor) {
         output: {
             schema: { type: 'object' },
             render(args, value) {
-                return [{ type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) }];
+                if (!value)
+                    return [{ type: 'text', text: '无返回数据' }];
+                if (typeof value.result === 'string') {
+                    return [{ type: 'text', text: value.result }];
+                }
+                if (Array.isArray(value.items)) {
+                    return [{ type: 'text', text: JSON.stringify(value.items, null, 2) }];
+                }
+                return [{ type: 'text', text: JSON.stringify(value, null, 2) }];
             },
         },
         async execute(args, execContext) {
             const cwd = execContext?.cwd || process.cwd();
-            const repoArgs = args.repo ? ['-R', args.repo] : [];
+            let repoTarget = args.repo;
+            if (!repoTarget) {
+                const meta = await executor.getRepoMetadata(cwd);
+                if (meta?.nameWithOwner) {
+                    repoTarget = meta.nameWithOwner;
+                }
+            }
+            const repoArgs = repoTarget ? ['-R', repoTarget] : [];
             switch (args.action) {
                 case 'list': {
                     const res = await executor.run(['run', 'list', ...repoArgs, '--json', 'databaseId,name,status,conclusion,event,headBranch,createdAt', '-L', String(args.limit || 10)], { cwd });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.data || res.rawOutput;
+                    return normalizeOutput(res.data || res.rawOutput);
                 }
                 case 'view': {
                     if (!args.run_id)
@@ -48,7 +71,7 @@ export function createRunTool(executor) {
                     const res = await executor.run(['run', 'view', String(args.run_id), ...repoArgs, '--json', 'databaseId,name,status,conclusion,jobs,url'], { cwd });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.data || res.rawOutput;
+                    return normalizeOutput(res.data || res.rawOutput);
                 }
                 case 'log_failed': {
                     if (!args.run_id)
@@ -61,7 +84,7 @@ export function createRunTool(executor) {
                     });
                     if (!res.ok)
                         throw new Error(res.error);
-                    return res.rawOutput || '未找到失败步骤的日志';
+                    return { result: res.rawOutput || '未找到失败步骤的日志' };
                 }
                 case 'rerun': {
                     if (!args.run_id)
@@ -83,5 +106,5 @@ export function createRunTool(executor) {
                     throw new Error(`未知的 Run 操作: ${args.action}`);
             }
         },
-    });
+    };
 }

package/lib/types.d.ts

@@ -152,16 +152,3 @@ export interface GlobalOverviewData {
     lastUpdated: string;
     error?: string;
 }
-declare module '@deepseek-ai/cordis' {
-    interface Events {
-        'github/pr:create'(repo: string, pr: {
-            title: string;
-            url: string;
-        }): void;
-        'github/pr:merge'(repo: string, prNumber: number): void;
-        'github/issue:create'(repo: string, issue: {
-            title: string;
-            url: string;
-        }): void;
-    }
-}

package/package.json

@@ -1,12 +1,21 @@
 {
   "name": "dsh-github-flow",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "icon": "icon.svg",
   "description": "GitHub Flow: Native GitHub CLI (gh) integration for DeepSeek Harness — Agent Tools, Slash Commands, and Web UI Workspace",
   "type": "module",
-  "main": "./lib/index.js",
+  "main": "./lib/main.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ItQianChen/dsh-github-flow.git"
+  },
+  "homepage": "https://github.com/ItQianChen/dsh-github-flow#readme",
+  "bugs": {
+    "url": "https://github.com/ItQianChen/dsh-github-flow/issues"
+  },
   "exports": {
-    ".": "./lib/index.js",
+    ".": "./lib/main.js",
+    "./entry": "./lib/main.js",
     "./client": "./lib/client.js",
     "./package.json": "./package.json"
   },
@@ -14,7 +23,10 @@
     "lib",
     "icon.svg",
     "cordis.patch.yml",
-    "README.md"
+    "README.md",
+    "README.en.md",
+    "LICENSE",
+    "docs"
   ],
   "scripts": {
     "build": "tsc && node scripts/build.mjs",
@@ -42,13 +54,6 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "*",
-    "@deepseek-ai/schemastery": "^3.18.4"
-  },
-  "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.4"
-  },
   "devDependencies": {
     "@types/node": "^26.6.3",
     "typescript": "^7.0.2"

package/lib/service.d.ts

@@ -1,28 +0,0 @@
-import type { GhExecutor } from './executor.js';
-import type { GhExecutionOptions, GhResult, AuthStatus, RepoMetadata } from './types.js';
-declare module '@deepseek-ai/cordis' {
-    interface Context {
-        github: GitHubService;
-    }
-}
-/**
- * DSH GitHub 原生微内核服务
- * 允许生态内其他插件通过 ctx.github 或 inject: ['github'] 消费 GitHub CLI 能力
- */
-export declare class GitHubService {
-    private ctx;
-    executor: GhExecutor;
-    constructor(ctx: any, executor: GhExecutor);
-    /**
-     * 执行原生 gh 命令
-     */
-    run<T = unknown>(args: string[], options?: GhExecutionOptions): Promise<GhResult<T>>;
-    /**
-     * 检查宿主机 GitHub CLI 认证状态
-     */
-    checkAuth(cwd?: string): Promise<AuthStatus>;
-    /**
-     * 获取指定工作区路径下的 Git 关联元数据
-     */
-    getRepoMetadata(cwd?: string): Promise<RepoMetadata | null>;
-}

package/lib/service.js

@@ -1,34 +0,0 @@
-/**
- * DSH GitHub 原生微内核服务
- * 允许生态内其他插件通过 ctx.github 或 inject: ['github'] 消费 GitHub CLI 能力
- */
-export class GitHubService {
-    ctx;
-    executor;
-    constructor(ctx, executor) {
-        this.ctx = ctx;
-        this.executor = executor;
-        // 挂载到 ctx 上
-        if (ctx) {
-            ctx.github = this;
-        }
-    }
-    /**
-     * 执行原生 gh 命令
-     */
-    async run(args, options = {}) {
-        return this.executor.run(args, options);
-    }
-    /**
-     * 检查宿主机 GitHub CLI 认证状态
-     */
-    async checkAuth(cwd) {
-        return this.executor.checkAuth(cwd);
-    }
-    /**
-     * 获取指定工作区路径下的 Git 关联元数据
-     */
-    async getRepoMetadata(cwd) {
-        return this.executor.getRepoMetadata(cwd);
-    }
-}

package/lib/tools/define.d.ts

@@ -1,6 +0,0 @@
-/**
- * DSH Tool 定义规范包装器
- * 优先使用 @deepseek-ai/dsh-tools 的 defineTool DSL
- * 在独立环境无此包时提供标准的运行时安全包装
- */
-export declare function defineSafeTool(spec: any): any;

package/lib/tools/define.js

@@ -1,15 +0,0 @@
-/**
- * DSH Tool 定义规范包装器
- * 优先使用 @deepseek-ai/dsh-tools 的 defineTool DSL
- * 在独立环境无此包时提供标准的运行时安全包装
- */
-export function defineSafeTool(spec) {
-    try {
-        const dshTools = globalThis.__DSH_TOOLS__;
-        if (dshTools && typeof dshTools.defineTool === 'function') {
-            return dshTools.defineTool(spec);
-        }
-    }
-    catch (e) { }
-    return spec;
-}