dsh-github-flow 0.6.0 → 0.7.0

package/lib/tools/run.js

@@ -1,5 +1,9 @@
+import { wrapWithGate } from '../destructive.js';
 import { compareGhVersions } from '../executor.js';
 import { renderRunMarkdown } from '../renderers/markdown.js';
+import { extractFailureAnchors, renderFailureAnchors, tailLines } from '../executor/failure-anchors.js';
+import { interpretRunLogError } from '../executor/run-log.js';
+import { assertPositionArg } from '../executor/args-guard.js';
 import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
@@ -13,7 +17,7 @@ function normalizeOutput(data) {
     return { result: data !== undefined && data !== null ? data : '' };
 }
 export function createRunTool(executor) {
-    return {
+    return wrapWithGate({
         name: 'github_run',
         description: '排查和诊断 GitHub Actions 工作流构建状态。特别优化了获取失败步骤日志能力（log_failed），专供 Agent 快速定位 CI 报错，并支持手动触发工作流 (trigger)。',
         parameters: {
@@ -75,8 +79,11 @@ export function createRunTool(executor) {
             },
         },
         async execute(args, execContext) {
-            const cwd = execContext?.cwd || process.cwd();
-            const sessionId = execContext?.sessionId || execContext?.session?.id || process.env.DSH_SESSION_ID;
+            // 位置参数守卫：run_id / workflow 都会作为 `gh run view <id>`、
+            // `gh workflow view <name>` 的位置参数进入 argv（同上一条 C-01 的同类面）
+            assertPositionArg(args.run_id, 'Run ID');
+            assertPositionArg(args.workflow, '工作流名称');
+            const { cwd, sessionId } = executor.resolveExecScope(execContext);
             let repoTarget = args.repo;
             if (!repoTarget) {
                 const meta = await executor.getRepoMetadata(cwd, sessionId);
@@ -124,25 +131,60 @@ export function createRunTool(executor) {
                         ...runOpts,
                         timeoutMs: 60_000,
                         rawText: true,
+                        /*
+                         * 必须在这里放开输出预算。
+                         *
+                         * 为什么：executor 默认 maxOutputChars=24,000，截断发生在**萃取之前**——
+                         * 矩阵构建的日志动辄几万行，不放开就永远只能萃取前 24KB，后面的失败
+                         * 块根本进不了上下文。上限与 PR diff 通道同口径（2MB 字符 / 8MB 字节），
+                         * 且只在这一条链路放开，不抬高全局默认值。
+                         */
+                        maxOutputChars: 2_000_000,
+                        maxOutputBytes: 8 * 1024 * 1024,
                     });
                     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 拉取日志端点。`,
-                            };
-                        }
+                        // 两类已知的非零退出（无失败步骤 / Windows 缓存目录被拒）由共用映射吸收：
+                        // 文案必须与 Run 详情弹窗同一份，否则 Agent 与界面会对同一次失败给出两种说法。
+                        const friendly = interpretRunLogError(String(res.error || ''), args.run_id);
+                        if (friendly)
+                            return { result: friendly };
                         throw new Error(res.error);
                     }
-                    return { result: res.rawOutput || '未找到失败步骤的日志' };
+                    const rawLog = res.rawOutput || '';
+                    if (!rawLog.trim())
+                        return { result: '未找到失败步骤的日志' };
+                    /*
+                     * 两级预算：先按框架锚点选，再按字符数裁。
+                     *
+                     * 为什么不能直接整段返回：矩阵构建下 N 个 job 的失败日志是几万行，
+                     * 整段进上下文既浪费又必然被下游再截一次（那次截断是静默的）。
+                     * 无锚点时回退尾部 200 行——失败结论在末尾，头部基本只有环境准备信息。
+                     */
+                    const anchored = extractFailureAnchors(rawLog);
+                    let rendered;
+                    if (anchored.blocks.length > 0) {
+                        rendered = renderFailureAnchors(anchored);
+                    }
+                    else {
+                        rendered = `> 未匹配到已知框架的失败锚点，以下为日志尾部 200 行。\n\n\`\`\`\n${tailLines(rawLog, 200)}\n\`\`\``;
+                    }
+                    /*
+                     * 底层输出被硬截断时必须在最前面说明。
+                     *
+                     * 为什么：gh 的原始日志已按 2MB 字符 / 8MB 字节裁过（res.truncated），
+                     * 此时「没找到更多失败块」不等于「没有更多失败」——不说明的话，
+                     * Agent 会把「日志里就这些」当成结论，而真实失败可能在被裁掉的那一段里。
+                     */
+                    if (res.truncated) {
+                        rendered = `> ⚠️ 原始日志体量超出输出上限（2MB 字符 / 8MB 字节）已被截断，以下仅基于已获取的部分。\n\n${rendered}`;
+                    }
+                    // 二级预算：锚点文本仍可能超预算，裁剪必须显式说明
+                    const budget = executor.maxOutputChars;
+                    if (rendered.length > budget) {
+                        const kept = rendered.slice(0, budget);
+                        rendered = `${kept}\n\n> ⚠️ 输出已按字符上限（${budget}）截断，上述失败块可能不完整。`;
+                    }
+                    return { result: rendered };
                 }
                 case 'workflow_list': {
                     // 字段集为 gh 2.96 实测合法全集（仅 4 个，无 updatedAt——勘误 E1）。
@@ -195,12 +237,22 @@ export function createRunTool(executor) {
                         throw new Error('download 操作必须提供 run_id');
                     if (args.name && typeof args.name !== 'string')
                         throw new Error('name 必须是字符串（artifact 名称过滤）');
-                    // GHSA-39wj-f2f4-978v（gh<2.102 符号链接路径穿越）防线：落盘目录由插件
-                    // 固定派生（owner/repo/run_id 三级），不暴露 dir 参数给用户——攻击面
-                    // 收敛到一个 mkdirSync 调用点；用户无法注入 ../ 或符号链接目标。
-                    const artifactsRoot = path.join(os.homedir(), '.dsh', 'data', 'dsh-github-flow', 'artifacts', ...repoTarget.split('/'), String(args.run_id));
+                    // run_id 必须是纯数字：它既是 gh run download 的位置参数，也是落盘目录的一段。
+                    // 不校验时 "../../../../windows" 会被 path.join 归一化成沙箱外的目录（实测可越界写盘）。
+                    const runIdStr = String(args.run_id).trim();
+                    if (!/^\d+$/.test(runIdStr)) {
+                        throw new Error(`run_id 必须是纯数字的运行 ID（实际收到 "${runIdStr}"）。`);
+                    }
+                    // GHSA-39wj-f2f4-978v（gh<2.102 符号链接路径穿越）防线：落盘目录由插件固定派生
+                    // （owner/repo/run_id 三级），不暴露 dir 参数给用户。数字校验已挡住 ".."，
+                    // 这里再做一次包含性复核，把路径拼接的语义边界显式钉住，防止将来改派生逻辑时回归。
+                    const artifactsBase = path.resolve(os.homedir(), '.dsh', 'data', 'dsh-github-flow', 'artifacts');
+                    const artifactsRoot = path.resolve(artifactsBase, ...repoTarget.split('/'), runIdStr);
+                    if (!artifactsRoot.startsWith(artifactsBase + path.sep)) {
+                        throw new Error('artifact 落盘目录越界，已拒绝。');
+                    }
                     fs.mkdirSync(artifactsRoot, { recursive: true });
-                    const dlCmd = ['run', 'download', String(args.run_id), ...repoArgs, '-D', artifactsRoot];
+                    const dlCmd = ['run', 'download', runIdStr, ...repoArgs, '-D', artifactsRoot];
                     if (args.name) {
                         dlCmd.push('-n', args.name);
                     }
@@ -272,5 +324,5 @@ export function createRunTool(executor) {
                     throw new Error(`未知的 Run 操作: ${args.action}`);
             }
         },
-    };
+    });
 }

package/lib/tools/secret.js

@@ -1,3 +1,4 @@
+import { wrapWithGate, GATE_BLOCKED } from '../destructive.js';
 function normalizeOutput(data) {
     if (data && typeof data === 'object' && !Array.isArray(data)) {
         return data;
@@ -16,7 +17,7 @@ function normalizeOutput(data) {
 function renderSecretOutput(args, value) {
     if (!value)
         return '无返回内容';
-    if (value.status === 'AWAITING_CONFIRMATION') {
+    if (value.status === GATE_BLOCKED) {
         return [
             `> ### ${value.warning}`,
             `> - **影响评估**: ${value.impact}`,
@@ -55,7 +56,7 @@ function renderSecretOutput(args, value) {
 function renderVariableOutput(args, value) {
     if (!value)
         return '无返回内容';
-    if (value.status === 'AWAITING_CONFIRMATION') {
+    if (value.status === GATE_BLOCKED) {
         return [
             `> ### ${value.warning}`,
             `> - **影响评估**: ${value.impact}`,
@@ -87,7 +88,7 @@ function renderVariableOutput(args, value) {
     return JSON.stringify(value, null, 2);
 }
 export function createSecretTool(executor) {
-    return {
+    return wrapWithGate({
         name: 'github_secret',
         description: '管理 GitHub Actions 仓库密钥 (Secrets) 与变量 (Variables)：查看名称清单、设置/更新/删除值。Secret 密文经标准输入安全传递，绝不出现在命令行参数或输出中；Variable 为 CI 明文，可经 get 查看值。Secret 删除需 confirm: true。',
         parameters: {
@@ -149,8 +150,7 @@ export function createSecretTool(executor) {
             },
         },
         async execute(args, execContext) {
-            const cwd = execContext?.cwd || process.cwd();
-            const sessionId = execContext?.sessionId || execContext?.session?.id || process.env.DSH_SESSION_ID;
+            const { cwd, sessionId } = executor.resolveExecScope(execContext);
             const isVariable = args.kind === 'variable';
             // org 作用域挂在组织上，与具体仓库无关：既不需要仓库识别，
             // 也不能把 -R 与 --org 同时传给 gh（两者语义冲突，gh 会报错）。
@@ -177,8 +177,12 @@ export function createSecretTool(executor) {
             const scopeFlags = [];
             if (args.org) {
                 scopeFlags.push('--org', args.org);
-                if (!isVariable && args.visibility)
+                // `--visibility` 只有 `gh secret set` 支持（实测 gh 2.96：list / delete 的 FLAGS
+                // 区块里没有它）。早期实现对所有动作都下发，导致带 org 的 list/delete 必然
+                // unknown flag——这正是 phase34 契约测试上线第一天抓到的那条。
+                if (!isVariable && args.visibility && args.action === 'set') {
                     scopeFlags.push('--visibility', args.visibility);
+                }
             }
             else if (args.env) {
                 scopeFlags.push('--env', args.env);
@@ -237,16 +241,6 @@ export function createSecretTool(executor) {
                     if (!args.name)
                         throw new Error('delete 操作必须提供 name');
                     const kindLabel = isVariable ? 'Variable' : 'Secret';
-                    if (args.confirm !== true) {
-                        return {
-                            status: 'AWAITING_CONFIRMATION',
-                            warning: `⚠️ 高危操作拦截：你即将删除 ${kindLabel}「${args.name}」${args.org ? `（组织 ${args.org}）` : ''}。`,
-                            impact: isVariable
-                                ? '删除后所有引用该变量的工作流将取不到值，运行中的构建立即失败。'
-                                : '删除后所有引用该密钥的 CI/CD 工作流将立即无法取到值，运行中的构建会失败。',
-                            requiredAction: '如确认删除，请向用户核实并附加 `confirm: true` 重新调用。',
-                        };
-                    }
                     const res = await executor.run([domain, 'delete', args.name, ...targetArgs, ...scopeFlags], runOpts);
                     if (!res.ok)
                         throw new Error(res.error);
@@ -256,5 +250,5 @@ export function createSecretTool(executor) {
                     throw new Error(`未知的 Secret/Variable 操作: ${args.action}（kind: ${args.kind || 'secret'}）`);
             }
         },
-    };
+    });
 }

package/lib/tools/skill.js

@@ -1,4 +1,5 @@
 import path from 'node:path';
+import { wrapWithGate } from '../destructive.js';
 import fs from 'node:fs';
 import { renderSkillMarkdown, parseSkillPublishOutput } from '../renderers/markdown.js';
 function normalizeOutput(data) {
@@ -11,7 +12,7 @@ function normalizeOutput(data) {
     return { result: data !== undefined && data !== null ? data : '' };
 }
 export function createSkillTool(executor) {
-    return {
+    return wrapWithGate({
         name: 'github_skill',
         description: '通过 GitHub CLI 官方生态发现与管理 Agent Skills：跨仓库检索开源 Skills、预览 SKILL.md 内容、安装到本地 Agent 宿主（Claude Code / Cursor / Copilot 等）、查看已安装列表、合规自检与安全发布（publish）以及检查与同步更新（update）。install 会写入磁盘需 confirm；publish 默认 --dry-run 自检，正式发布需 tag 与 confirm；update 默认 --dry-run 检查。基于 gh CLI preview 特性（需 gh >= 2.9x）。',
         parameters: {
@@ -90,8 +91,7 @@ export function createSkillTool(executor) {
             },
         },
         async execute(args, execContext) {
-            const cwd = execContext?.cwd || process.cwd();
-            const sessionId = execContext?.sessionId || execContext?.session?.id || process.env.DSH_SESSION_ID;
+            const { cwd, sessionId } = executor.resolveExecScope(execContext);
             // skill 工具天然面向跨仓库生态（search/preview 均以显式 repository 为目标），
             // 不做当前工作区仓库自动识别——识别失败反而会误导调用方。
             const runOpts = { cwd, sessionId };
@@ -130,14 +130,6 @@ export function createSkillTool(executor) {
                 case 'install': {
                     if (!args.repository)
                         throw new Error('install 操作必须提供 repository [owner/repo]');
-                    if (args.confirm !== true) {
-                        return {
-                            status: 'AWAITING_CONFIRMATION',
-                            warning: `⚠️ 安装确认拦截：你即将从仓库「${args.repository}」安装 Skill${args.skill_name ? `「${args.skill_name}」` : ''}到本地${args.scope === 'user' ? '用户主目录（全局）' : '当前项目'}。`,
-                            impact: '安装会在本地磁盘写入 SKILL.md 及附属文件，并可能影响目标 Agent 宿主的默认行为。',
-                            requiredAction: '如确认安装，请向用户核实并附加 `confirm: true` 重新调用。',
-                        };
-                    }
                     const installCmd = ['skill', 'install', args.repository];
                     if (args.skill_name)
                         installCmd.push(args.skill_name);
@@ -165,9 +157,20 @@ export function createSkillTool(executor) {
                     const isFix = args.fix === true;
                     const isDryRun = args.dry_run !== false && !isFix;
                     const targetDir = typeof args.directory === 'string' && args.directory.trim() ? args.directory.trim() : undefined;
-                    // 1. 目录存在性前置安全校验
+                    // 1. 目录存在性 + 工作区包含性前置安全校验
                     if (targetDir) {
+                        const workspaceRoot = path.resolve(cwd);
                         const resolvedPath = path.resolve(cwd, targetDir);
+                        // 只校验存在性是不够的：`directory: "../.."` 可以指向仓库外任意目录，
+                        // 配合 dry_run:false + confirm:true 就能把仓库外的内容发布成 Release。
+                        // Windows 文件系统大小写不敏感（D:/Proj/Repo 与 d:/proj/repo 是同一目录），
+                        // 直接 startsWith 会把合法路径误判为越界，所以先归一再比。
+                        const norm = (p) => (process.platform === 'win32' ? p.toLowerCase() : p);
+                        const rootNorm = norm(workspaceRoot);
+                        const pathNorm = norm(resolvedPath);
+                        if (pathNorm !== rootNorm && !pathNorm.startsWith(rootNorm + path.sep)) {
+                            throw new Error(`技能目录必须位于当前工作区内（工作区: ${workspaceRoot}，解析结果: ${resolvedPath}）。`);
+                        }
                         if (!fs.existsSync(resolvedPath)) {
                             throw new Error(`指定的技能目录不存在: ${targetDir}`);
                         }
@@ -179,15 +182,8 @@ export function createSkillTool(executor) {
                             throw new Error('正式发布 Skill（dry_run: false）必须提供版本 tag（如 "v1.0.0"），以防止 CLI 尝试进入交互式向导导致进程挂起');
                         }
                         const cleanTag = args.tag.trim();
-                        // 防线 2: 破坏性发布二级确认拦截（创建 Release 与打 Tag 属于公开制品发布）
-                        if (args.confirm !== true) {
-                            return {
-                                status: 'AWAITING_CONFIRMATION',
-                                warning: `⚠️ 发布确认拦截：你即将正式发布 Agent Skill 并创建 GitHub Release（Tag: ${cleanTag}）。`,
-                                impact: `该操作将在仓库中打上「agent-skills」Topic、创建 Git Tag「${cleanTag}」并发布正式 GitHub Release，向所有用户公开提供该版本。`,
-                                requiredAction: `如确认发布，请核实版本号并在参数中附加 \`confirm: true\` 重新调用。`,
-                            };
-                        }
+                        // 防线 2（破坏性发布的二级确认）已收口到 src/destructive.ts 的 github_skill.publish 条目——
+                        // 闸门在工厂入口执行，这里只剩 tag 前置校验与 argv 组装。
                         const publishCmd = ['skill', 'publish'];
                         if (targetDir)
                             publishCmd.push(targetDir);
@@ -252,5 +248,5 @@ export function createSkillTool(executor) {
                     throw new Error(`未知的 Skill 操作: ${args.action}`);
             }
         },
-    };
+    });
 }

package/lib/tools/status.js

@@ -1,7 +1,8 @@
+import { wrapWithGate } from '../destructive.js';
 import { renderStatusMarkdown, parseStatusOutput } from '../renderers/markdown.js';
 import { defaultTelemetryCollector } from '../telemetry.js';
 export function createStatusTool(executor, telemetryCollector) {
-    return {
+    return wrapWithGate({
         name: 'github_status',
         description: '聚合展示当前登录用户的跨仓库全局待办与动态大盘（view），或审计当前工具链运行时健康度、API 降级率与自愈建议（health）。无需指定单仓，账号与系统维度一站式概览。',
         parameters: {
@@ -34,8 +35,7 @@ export function createStatusTool(executor, telemetryCollector) {
                 const collector = telemetryCollector || defaultTelemetryCollector;
                 return collector.getSummary();
             }
-            const cwd = execContext?.cwd || process.cwd();
-            const sessionId = execContext?.sessionId || execContext?.session?.id || process.env.DSH_SESSION_ID;
+            const { cwd, sessionId } = executor.resolveExecScope(execContext);
             const statusCmd = ['status'];
             if (args?.org) {
                 statusCmd.push('-o', String(args.org));
@@ -54,5 +54,5 @@ export function createStatusTool(executor, telemetryCollector) {
                 rawText: res.rawOutput || '',
             };
         },
-    };
+    });
 }

package/lib/tools/task.d.ts

@@ -0,0 +1,219 @@
+/**
+ * `github_task`：任务级原语（s8）。
+ *
+ * 为什么需要它：现有 18 个工具是**动词表**（list / view / diff / checks / review…），
+ * 而用户真正说的是**任务**（"帮我审一下这个 PR" / "CI 为什么挂" / "该发什么版本"）。
+ * 一个任务要 Agent 自己串 5–10 个动词，每一步都可能选错参数。
+ *
+ * 三条纪律（写在最前面，因为它们是这个工具能存在的前提）：
+ * 1. **不自己拼 gh 命令**：全部经 executor 与既有工具函数，`phase34` 的 argv 契约网
+ *    因此能覆盖到这里的每一次调用；
+ * 2. **默认零写回**：三个原语里只有 `review_pr` 会写远端，且必须 `write: true` +
+ *    `confirm: true` 双门（闸门见 `destructive.ts` 的 `github_task` 段）；
+ * 3. **任何裁剪都显式**：装不下就写进 `truncated`，并区分「裁了多少」与「连总数都不知道」。
+ */
+import type { GhExecutor } from '../executor.js';
+export declare function createTaskTool(executor: GhExecutor): {
+    name: string;
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            pr_number: {
+                type: string;
+                description: string;
+            };
+            run_id: {
+                type: string;
+                description: string;
+            };
+            repo: {
+                type: string;
+                description: string;
+            };
+            focus: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            budget_chars: {
+                type: string;
+                description: string;
+            };
+            write: {
+                type: string;
+                description: string;
+            };
+            body: {
+                type: string;
+                description: string;
+            };
+            comments: {
+                type: string;
+                items: {
+                    type: string;
+                    properties: {
+                        path: {
+                            type: string;
+                        };
+                        line: {
+                            type: string;
+                        };
+                        side: {
+                            type: string;
+                            enum: string[];
+                        };
+                        start_line: {
+                            type: string;
+                        };
+                        body: {
+                            type: string;
+                        };
+                    };
+                    required: string[];
+                };
+                description: string;
+            };
+            review_decision: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            framework: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            from_tag: {
+                type: string;
+                description: string;
+            };
+            bump: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            draft: {
+                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<import("../task-primitives.js").TaskEnvelope<{
+        pr: number;
+        title: string;
+        sha: string | undefined;
+        baseSha: string | undefined;
+        changedFiles: number;
+        filesTruncated: boolean;
+        files: import("../task-primitives.js").BudgetFile[];
+        checks: {
+            pass: number;
+            fail: number;
+            pending: number;
+            skipped: number;
+            failing: string[];
+        };
+        rules: {
+            sources: {
+                path: string;
+                content: string;
+            }[];
+            truncated: boolean;
+        } | null;
+        existingLineComments: number;
+    }> | import("../task-primitives.js").TaskEnvelope<{
+        runId: number;
+        name: any;
+        status: any;
+        conclusion: any;
+        url: any;
+        failedJobs: any;
+        excerpts: {
+            file: string;
+            line: number;
+            message: string;
+        }[];
+        suspectedFiles: string[];
+        framework: any;
+        totalBlocks: number;
+        logError?: string | undefined;
+    }> | import("../task-primitives.js").TaskEnvelope<{
+        fromTag: string | null;
+        commitCount: number;
+        suggestedVersion: string;
+        bump: "major" | "minor" | "patch";
+        bumpReason: string;
+        groups: import("../task-primitives.js").CommitGroups;
+        health: {
+            clean: boolean;
+            synced: boolean;
+            ciGreen: boolean | null;
+            branch: string;
+        };
+        notes: string;
+        commits: {
+            sha: string;
+            subject: string;
+        }[];
+    }> | {
+        summary: string;
+        facts: {
+            pr: number;
+            title: string;
+            sha: string | undefined;
+            baseSha: string | undefined;
+            changedFiles: number;
+            filesTruncated: boolean;
+            files: import("../task-primitives.js").BudgetFile[];
+            checks: {
+                pass: number;
+                fail: number;
+                pending: number;
+                skipped: number;
+                failing: string[];
+            };
+            rules: {
+                sources: {
+                    path: string;
+                    content: string;
+                }[];
+                truncated: boolean;
+            } | null;
+            existingLineComments: number;
+            written: {
+                htmlUrl: any;
+                state: any;
+                degraded: boolean;
+            };
+        };
+        truncated?: {
+            fields: string[];
+            reason: string;
+            totalUnknown: boolean;
+        };
+        nextActions: string[];
+        cost: {
+            chars: number;
+            ghCalls: number;
+            elapsedMs: number;
+        };
+        degraded: boolean;
+        degradedReason: string | undefined;
+    }>;
+};