dsh-github-flow 0.1.7 → 0.2.0

package/lib/tools/release.d.ts

@@ -0,0 +1,89 @@
+import type { GhExecutor } from '../executor.js';
+export declare function createReleaseTool(executor: GhExecutor): {
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            repo: {
+                type: string;
+                description: string;
+            };
+            tag: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+            notes: {
+                type: string;
+                description: string;
+            };
+            generate_notes: {
+                type: string;
+                description: string;
+            };
+            draft: {
+                type: string;
+                description: string;
+            };
+            prerelease: {
+                type: string;
+                description: string;
+            };
+            target: {
+                type: string;
+                description: string;
+            };
+            assets: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            clobber: {
+                type: string;
+                description: string;
+            };
+            pattern: {
+                type: string;
+                description: string;
+            };
+            dir: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            confirm: {
+                type: string;
+                description: string;
+            };
+            cleanup_tag: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    output: {
+        schema: {
+            type: string;
+        };
+        render(args: any, value: any): {
+            type: string;
+            text: string;
+        }[];
+    };
+    execute(args: any, execContext: any): Promise<Record<string, any>>;
+};

package/lib/tools/release.js

@@ -0,0 +1,219 @@
+import { renderReleaseMarkdown } from '../renderers/markdown.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 createReleaseTool(executor) {
+    return {
+        name: 'github_release',
+        description: '管理 GitHub Releases 版本发布与构建资产：查看发版历史、根据提交自动生成发版说明、创建 Release、上传/下载发布资产（如 npm .tgz 产物）。高危操作（delete、clobber 覆盖上传）需 confirm: true。',
+        parameters: {
+            type: 'object',
+            properties: {
+                action: {
+                    type: 'string',
+                    enum: ['list', 'view', 'create', 'upload', 'download', 'delete'],
+                    description: 'Release 操作类型。',
+                },
+                repo: {
+                    type: 'string',
+                    description: '目标仓库 [owner/repo]，留空则自动识别当前本地 Git 仓库。',
+                },
+                tag: {
+                    type: 'string',
+                    description: '版本 Tag 名称（view/upload/download/delete 动作使用，如 "v0.1.9"；view 留空查看最新 Release）。',
+                },
+                title: {
+                    type: 'string',
+                    description: 'Release 标题（create 动作使用，留空且开启 generate_notes 时由 GitHub 自动生成）。',
+                },
+                notes: {
+                    type: 'string',
+                    description: 'Release 说明正文（create 动作使用）。留空且 generate_notes 为 true 时将自动由 GitHub 根据提交记录生成。',
+                },
+                generate_notes: {
+                    type: 'boolean',
+                    description: '是否自动生成 Release 说明（映射为 --generate-notes）。默认 true。',
+                },
+                draft: {
+                    type: 'boolean',
+                    description: '是否创建为草稿 Release（create 动作使用）。',
+                },
+                prerelease: {
+                    type: 'boolean',
+                    description: '是否标记为预发布版本 Pre-release（create 动作使用）。',
+                },
+                target: {
+                    type: 'string',
+                    description: '自动创建 Tag 时的目标分支或完整 commit SHA（create 动作使用，默认主分支）。',
+                },
+                assets: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: '本地资产文件路径列表（create/upload 动作使用，如 ["./dsh-github-flow-0.1.9.tgz"]）。',
+                },
+                clobber: {
+                    type: 'boolean',
+                    description: '上传时覆盖同名旧资产（upload 动作使用）。破坏性操作：旧资产会先被删除，上传失败时无法恢复，需 confirm: true。',
+                },
+                pattern: {
+                    type: 'string',
+                    description: '仅下载匹配 glob 的资产（download 动作使用，如 "*.tgz"）。',
+                },
+                dir: {
+                    type: 'string',
+                    description: '资产下载目录（download 动作使用，默认当前目录 "."）。',
+                },
+                limit: {
+                    type: 'number',
+                    description: '返回 Release 数量上限（list 动作使用，默认 10，最大 50）。',
+                },
+                confirm: {
+                    type: 'boolean',
+                    description: '高危破坏性操作确认标志（delete 动作或 upload+clobber 时必需）。若为 false 则仅输出影响评估报告。',
+                },
+                cleanup_tag: {
+                    type: 'boolean',
+                    description: '删除 Release 时是否连同删除其 Git Tag（delete 动作可选，映射 --cleanup-tag）。默认 false：仅删 Release 保留 Tag。',
+                },
+            },
+            required: ['action'],
+        },
+        output: {
+            schema: { type: 'object' },
+            render(args, value) {
+                return [{ type: 'text', text: renderReleaseMarkdown(args, value) }];
+            },
+        },
+        async execute(args, execContext) {
+            const cwd = execContext?.cwd || process.cwd();
+            const sessionId = execContext?.sessionId || execContext?.session?.id || process.env.DSH_SESSION_ID;
+            let repoTarget = args.repo;
+            if (!repoTarget) {
+                const meta = await executor.getRepoMetadata(cwd, sessionId);
+                if (meta?.nameWithOwner) {
+                    repoTarget = meta.nameWithOwner;
+                }
+            }
+            if (!repoTarget) {
+                throw new Error('未能自动识别当前工作区关联的 GitHub 仓库。请通过 `repo` 参数显式指定目标仓库 [owner/repo]。');
+            }
+            const repoArgs = ['-R', repoTarget];
+            const runOpts = { cwd, sessionId };
+            switch (args.action) {
+                case 'list': {
+                    // 显式 limit 优先；缺省回退 executor.defaultListLimit（上限 50 防止全量 Release 撑爆输出）
+                    const limit = typeof args.limit === 'number' && args.limit > 0 ? Math.min(args.limit, 50) : Math.min(executor.defaultListLimit ?? 10, 50);
+                    const res = await executor.run(['release', 'list', ...repoArgs, '-L', String(limit), '--json', 'tagName,name,isDraft,isPrerelease,publishedAt,createdAt'], runOpts);
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return normalizeOutput(res.data || res.rawOutput);
+                }
+                case 'view': {
+                    // gh release view 不带 tag 参数时展示最新 Release，与工具语义一致
+                    const target = args.tag ? [args.tag] : [];
+                    const res = await executor.run(['release', 'view', ...target, ...repoArgs, '--json', 'tagName,name,body,publishedAt,isDraft,isPrerelease,assets,url'], runOpts);
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return normalizeOutput(res.data || res.rawOutput);
+                }
+                case 'create': {
+                    if (!args.tag)
+                        throw new Error('create 操作必须提供 tag（如 "v0.1.9"）');
+                    const createCmd = ['release', 'create', args.tag, ...repoArgs];
+                    // 资产文件直接跟在 tag 后（gh release create <tag> <files...>）
+                    if (Array.isArray(args.assets)) {
+                        for (const a of args.assets) {
+                            if (typeof a === 'string' && a.trim())
+                                createCmd.push(a);
+                        }
+                    }
+                    if (args.title)
+                        createCmd.push('--title', args.title);
+                    // notes 与 generate_notes 可共存：gh 会在自动生成的说明前 prepend 手写正文
+                    if (args.notes)
+                        createCmd.push('--notes', args.notes);
+                    if (args.generate_notes !== false)
+                        createCmd.push('--generate-notes');
+                    if (args.draft === true)
+                        createCmd.push('--draft');
+                    if (args.prerelease === true)
+                        createCmd.push('--prerelease');
+                    if (args.target)
+                        createCmd.push('--target', args.target);
+                    const res = await executor.run(createCmd, runOpts);
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return { message: `Release ${args.tag} 创建成功`, url: res.rawOutput };
+                }
+                case 'upload': {
+                    if (!args.tag)
+                        throw new Error('upload 操作必须提供 tag');
+                    if (!Array.isArray(args.assets) || args.assets.length === 0) {
+                        throw new Error('upload 操作必须提供 assets（文件路径列表）');
+                    }
+                    if (args.clobber === true && args.confirm !== true) {
+                        return {
+                            status: 'AWAITING_CONFIRMATION',
+                            warning: `⚠️ 高危操作拦截：你即将覆盖上传 Release ${args.tag} 的同名旧资产（clobber 模式）。`,
+                            impact: 'clobber 会先删除既有同名资产再上传；若上传中途失败，旧资产已丢失且无法恢复。',
+                            requiredAction: '如确认覆盖，请向用户核实并附加 `confirm: true` 重新调用。',
+                        };
+                    }
+                    const uploadCmd = ['release', 'upload', args.tag, ...repoArgs];
+                    for (const a of args.assets) {
+                        if (typeof a === 'string' && a.trim())
+                            uploadCmd.push(a);
+                    }
+                    if (args.clobber === true)
+                        uploadCmd.push('--clobber');
+                    const res = await executor.run(uploadCmd, runOpts);
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return { message: `已上传 ${args.assets.length} 个资产至 Release ${args.tag}`, output: res.rawOutput };
+                }
+                case 'download': {
+                    const target = args.tag ? [args.tag] : [];
+                    if (!args.tag && !args.pattern) {
+                        throw new Error('download 不带 tag 时（下载最新 Release）必须提供 pattern 过滤资产');
+                    }
+                    const dlCmd = ['release', 'download', ...target, ...repoArgs];
+                    if (args.pattern)
+                        dlCmd.push('--pattern', args.pattern);
+                    if (args.dir)
+                        dlCmd.push('--dir', args.dir);
+                    const res = await executor.run(dlCmd, runOpts);
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return { message: `Release 资产下载完成（目录: ${args.dir || '.'}）`, output: res.rawOutput };
+                }
+                case 'delete': {
+                    if (!args.tag)
+                        throw new Error('delete 操作必须提供 tag');
+                    if (args.confirm !== true) {
+                        return {
+                            status: 'AWAITING_CONFIRMATION',
+                            warning: `⚠️ 高危操作拦截：你即将删除 Release ${args.tag}${args.cleanup_tag ? ' 及其 Git Tag' : ''}。`,
+                            impact: '删除 Release 不可逆；若同时清理 Tag，引用该 Tag 的历史版本入口将全部失效。',
+                            requiredAction: '如确认删除，请向用户核实并附加 `confirm: true` 重新调用。',
+                        };
+                    }
+                    const delCmd = ['release', 'delete', args.tag, ...repoArgs, '--yes'];
+                    if (args.cleanup_tag === true)
+                        delCmd.push('--cleanup-tag');
+                    const res = await executor.run(delCmd, runOpts);
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return { message: `Release ${args.tag} 已删除`, output: res.rawOutput };
+                }
+                default:
+                    throw new Error(`未知的 Release 操作: ${args.action}`);
+            }
+        },
+    };
+}

package/lib/tools/repo.d.ts

@@ -22,6 +22,18 @@ export declare function createRepoTool(executor: GhExecutor): {
                 type: string;
                 description: string;
             };
+            branch: {
+                type: string;
+                description: string;
+            };
+            source: {
+                type: string;
+                description: string;
+            };
+            force: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
     };
@@ -31,7 +43,7 @@ export declare function createRepoTool(executor: GhExecutor): {
         };
         render(args: any, value: any): {
             type: string;
-            text: any;
+            text: string;
         }[];
     };
     execute(args: any, execContext: any): Promise<Record<string, any>>;

package/lib/tools/repo.js

@@ -1,3 +1,4 @@
+import { renderRepoMarkdown } from '../renderers/markdown.js';
 function normalizeOutput(data) {
     if (data && typeof data === 'object' && !Array.isArray(data)) {
         return data;
@@ -10,14 +11,14 @@ function normalizeOutput(data) {
 export function createRepoTool(executor) {
     return {
         name: 'github_repo',
-        description: '查看 GitHub 仓库元数据与跨仓库检索代码、Issue。默认查询当前工作区关联的仓库。',
+        description: '查看 GitHub 仓库元数据、同步 Fork 仓库主干 (sync) 与跨仓库检索代码。默认查询当前工作区关联的仓库。',
         parameters: {
             type: 'object',
             properties: {
                 action: {
                     type: 'string',
-                    enum: ['view', 'search_code', 'search_repos'],
-                    description: '仓库操作类型。',
+                    enum: ['view', 'search_code', 'search_repos', 'sync'],
+                    description: '仓库操作类型。新增 sync (一键拉平 Fork 仓库与上游主干)。',
                 },
                 repo: {
                     type: 'string',
@@ -31,27 +32,32 @@ export function createRepoTool(executor) {
                     type: 'number',
                     description: '返回条数，默认 10。',
                 },
+                branch: {
+                    type: 'string',
+                    description: '要同步的分支名（sync 动作使用，默认主分支如 main）。',
+                },
+                source: {
+                    type: 'string',
+                    description: '上游源仓库 [owner/repo]（sync 动作使用，留空自动匹配 upstream 远程配置）。',
+                },
+                force: {
+                    type: 'boolean',
+                    description: '是否强制硬重置同步（sync 动作使用，映射为 --force，解决分叉冲突）。默认 false。',
+                },
             },
             required: ['action'],
         },
         output: {
             schema: { type: 'object' },
             render(args, value) {
-                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) }];
+                return [{ type: 'text', text: renderRepoMarkdown(args, value) }];
             },
         },
         async execute(args, execContext) {
             const cwd = execContext?.cwd || process.cwd();
             const sessionId = execContext?.sessionId || execContext?.session?.id || process.env.DSH_SESSION_ID;
-            const limitStr = String(args.limit || 10);
+            // 显式 limit 优先；缺省回退 executor.defaultListLimit（用户可在插件配置中调整）
+            const limitStr = String(typeof args.limit === 'number' && args.limit > 0 ? args.limit : Math.min(executor.defaultListLimit ?? 10, 50));
             const runOpts = { cwd, sessionId };
             switch (args.action) {
                 case 'view': {
@@ -64,7 +70,7 @@ export function createRepoTool(executor) {
                         }
                     }
                     const repoArgs = repoTarget ? [repoTarget] : [];
-                    const res = await executor.run(['repo', 'view', ...repoArgs, '--json', 'nameWithOwner,description,defaultBranchRef,isPrivate,stargazerCount,forkCount,url'], runOpts);
+                    const res = await executor.run(['repo', 'view', ...repoArgs, '--json', 'nameWithOwner,description,defaultBranchRef,isPrivate,stargazerCount,forkCount,url,repositoryTopics,licenseInfo'], runOpts);
                     if (!res.ok) {
                         // 若执行 gh 失败（如离线或环境限制），但本地已成功识别仓库元数据，进行优雅兜底返回
                         if (meta && meta.nameWithOwner) {
@@ -91,6 +97,32 @@ export function createRepoTool(executor) {
                         throw new Error(res.error);
                     return normalizeOutput(res.data || res.rawOutput);
                 }
+                case 'sync': {
+                    let repoTarget = args.repo;
+                    if (!repoTarget) {
+                        const meta = await executor.getRepoMetadata(cwd, sessionId);
+                        if (meta?.nameWithOwner) {
+                            repoTarget = meta.nameWithOwner;
+                        }
+                    }
+                    const syncCmd = ['repo', 'sync'];
+                    if (repoTarget) {
+                        syncCmd.push(repoTarget);
+                    }
+                    if (args.branch) {
+                        syncCmd.push('--branch', args.branch);
+                    }
+                    if (args.source) {
+                        syncCmd.push('--source', args.source);
+                    }
+                    if (args.force === true) {
+                        syncCmd.push('--force');
+                    }
+                    const res = await executor.run(syncCmd, runOpts);
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return { message: 'Fork 仓库同步成功，已与上游主干对齐', output: res.rawOutput || 'Synced' };
+                }
                 default:
                     throw new Error(`未知的 Repo 操作: ${args.action}`);
             }

package/lib/tools/run.d.ts

@@ -22,6 +22,27 @@ export declare function createRunTool(executor: GhExecutor): {
                 type: string;
                 description: string;
             };
+            branch: {
+                type: string;
+                description: string;
+            };
+            status: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            workflow: {
+                type: string;
+                description: string;
+            };
+            ref: {
+                type: string;
+                description: string;
+            };
+            inputs: {
+                type: string;
+                description: string;
+            };
         };
         required: string[];
     };
@@ -31,7 +52,7 @@ export declare function createRunTool(executor: GhExecutor): {
         };
         render(args: any, value: any): {
             type: string;
-            text: any;
+            text: string;
         }[];
     };
     execute(args: any, execContext: any): Promise<Record<string, any>>;

package/lib/tools/run.js

@@ -1,3 +1,4 @@
+import { renderRunMarkdown } from '../renderers/markdown.js';
 function normalizeOutput(data) {
     if (data && typeof data === 'object' && !Array.isArray(data)) {
         return data;
@@ -10,14 +11,14 @@ function normalizeOutput(data) {
 export function createRunTool(executor) {
     return {
         name: 'github_run',
-        description: '排查和诊断 GitHub Actions 工作流构建状态。特别优化了获取失败步骤日志能力（log_failed），专供 Agent 快速定位 CI 报错。',
+        description: '排查和诊断 GitHub Actions 工作流构建状态。特别优化了获取失败步骤日志能力（log_failed），专供 Agent 快速定位 CI 报错，并支持手动触发工作流 (trigger)。',
         parameters: {
             type: 'object',
             properties: {
                 action: {
                     type: 'string',
-                    enum: ['list', 'view', 'log_failed', 'rerun', 'cancel'],
-                    description: 'Actions 操作类型。',
+                    enum: ['list', 'view', 'log_failed', 'rerun', 'cancel', 'trigger'],
+                    description: 'Actions 操作类型。新增 trigger (主动触发 workflow_dispatch)。',
                 },
                 run_id: {
                     type: 'string',
@@ -31,21 +32,34 @@ export function createRunTool(executor) {
                     type: 'number',
                     description: '列出 runs 的数量，默认 10。',
                 },
+                branch: {
+                    type: 'string',
+                    description: '按分支筛选运行记录（list 动作使用，例如 "main" 或当前分支）。',
+                },
+                status: {
+                    type: 'string',
+                    enum: ['queued', 'completed', 'in_progress', 'failure', 'success'],
+                    description: '按状态筛选运行记录（list 动作使用，排查报错推荐 failure）。',
+                },
+                workflow: {
+                    type: 'string',
+                    description: '工作流名称或文件名（trigger 动作使用，例如 "pr-check.yml" 或 "CI"）。',
+                },
+                ref: {
+                    type: 'string',
+                    description: '触发工作流的目标分支或 tag（trigger 动作使用，默认当前工作区分支）。',
+                },
+                inputs: {
+                    type: 'object',
+                    description: '传递给工作流的自定义参数键值对（trigger 动作使用）。',
+                },
             },
             required: ['action'],
         },
         output: {
             schema: { type: 'object' },
             render(args, value) {
-                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) }];
+                return [{ type: 'text', text: renderRunMarkdown(args, value) }];
             },
         },
         async execute(args, execContext) {
@@ -65,7 +79,19 @@ export function createRunTool(executor) {
             const runOpts = { cwd, sessionId };
             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)], runOpts);
+                    const listCmd = [
+                        'run', 'list', ...repoArgs,
+                        '--json', 'databaseId,name,status,conclusion,event,headBranch,createdAt,url',
+                        // 显式 limit 优先；缺省回退 executor.defaultListLimit（用户可在插件配置中调整）
+                        '-L', String(typeof args.limit === 'number' && args.limit > 0 ? args.limit : Math.min(executor.defaultListLimit ?? 10, 50))
+                    ];
+                    if (args.branch) {
+                        listCmd.push('--branch', args.branch);
+                    }
+                    if (args.status) {
+                        listCmd.push('--status', args.status);
+                    }
+                    const res = await executor.run(listCmd, runOpts);
                     if (!res.ok)
                         throw new Error(res.error);
                     return normalizeOutput(res.data || res.rawOutput);
@@ -87,10 +113,44 @@ export function createRunTool(executor) {
                         timeoutMs: 60_000,
                         rawText: true,
                     });
-                    if (!res.ok)
+                    if (!res.ok) {
+                        // 两类已知的非零退出需要优雅吸收：
+                        // 1) 工作流本身成功/无失败步骤 —— gh 的确定性提示；
+                        // 2) gh CLI 在 Windows 受限目录写日志缓存 zip 报 Access is denied ——
+                        //    这是宿主环境问题而非构建失败，透传原文会让 Agent 误判为构建故障，
+                        //    给出自查指引（gh cache 目录权限）更可行动。
+                        const err = String(res.error || '');
+                        if (err.includes('no failed jobs') || err.includes('not failed')) {
+                            return { result: `工作流 Run #${args.run_id} 中未检测到任何失败的任务步骤 (状态正常)。` };
+                        }
+                        if (err.includes('Access is denied') || err.includes('拒绝访问')) {
+                            return {
+                                result: `无法提取 Run #${args.run_id} 的失败日志：gh CLI 向本机缓存目录写入日志压缩包时被系统拒绝 (${err.trim().slice(0, 200)})。建议检查 gh 缓存目录（如 %LocalAppData%\\GitHub CLI）的写权限后重试，或改用 github_api 拉取日志端点。`,
+                            };
+                        }
                         throw new Error(res.error);
+                    }
                     return { result: res.rawOutput || '未找到失败步骤的日志' };
                 }
+                case 'trigger': {
+                    if (!args.workflow)
+                        throw new Error('trigger 操作必须提供 workflow（工作流名称或文件名，例如 "pr-check.yml"）');
+                    const trigCmd = ['workflow', 'run', args.workflow, ...repoArgs];
+                    if (args.ref) {
+                        trigCmd.push('--ref', args.ref);
+                    }
+                    if (args.inputs && typeof args.inputs === 'object') {
+                        for (const [k, v] of Object.entries(args.inputs)) {
+                            if (v !== undefined && v !== null) {
+                                trigCmd.push('-f', `${k}=${String(v)}`);
+                            }
+                        }
+                    }
+                    const res = await executor.run(trigCmd, runOpts);
+                    if (!res.ok)
+                        throw new Error(res.error);
+                    return { message: `已成功触发工作流「${args.workflow}」运行`, output: res.rawOutput || 'Workflow dispatched' };
+                }
                 case 'rerun': {
                     if (!args.run_id)
                         throw new Error('rerun 操作必须提供 run_id');

package/lib/tools/secret.d.ts

@@ -0,0 +1,60 @@
+import type { GhExecutor } from '../executor.js';
+export declare function createSecretTool(executor: GhExecutor): {
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            repo: {
+                type: string;
+                description: string;
+            };
+            name: {
+                type: string;
+                description: string;
+            };
+            value: {
+                type: string;
+                description: string;
+            };
+            org: {
+                type: string;
+                description: string;
+            };
+            env: {
+                type: string;
+                description: string;
+            };
+            app: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            visibility: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            confirm: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    output: {
+        schema: {
+            type: string;
+        };
+        render(args: any, value: any): {
+            type: string;
+            text: string;
+        }[];
+    };
+    execute(args: any, execContext: any): Promise<Record<string, any>>;
+};