@roll-agent/core 0.15.0 → 0.17.0

package/dist/config/migration.d.ts

@@ -7,6 +7,10 @@ declare const CONFIG_MIGRATION_ISSUE_CODES: {
     readonly unknownRouterKeys: "unknown-router-keys";
     readonly legacyCamelCaseAgentEnvKey: "legacy-camelcase-agent-env-key";
     readonly legacyAgentEnvKeyConflict: "legacy-agent-env-key-conflict";
+    readonly deprecatedRuntimeBashSection: "deprecated-runtime-bash-section";
+    readonly invalidRuntimeBashSection: "invalid-runtime-bash-section";
+    readonly invalidRuntimeShellSection: "invalid-runtime-shell-section";
+    readonly runtimeShellConflict: "runtime-shell-conflict";
 };
 type ConfigMigrationIssueCode = (typeof CONFIG_MIGRATION_ISSUE_CODES)[keyof typeof CONFIG_MIGRATION_ISSUE_CODES];
 export interface ConfigMigrationIssue {
@@ -29,7 +33,7 @@ export type ApplyKnownConfigMigrationsResult = {
     readonly changed: false;
     readonly issues: readonly ConfigMigrationIssue[];
 };
-export type ConfigMigrationScope = "llm" | "ask" | "agents";
+export type ConfigMigrationScope = "llm" | "ask" | "agents" | "runtime";
 export declare function detectKnownConfigMigrations(document: Record<string, unknown>, options?: {
     readonly scope?: ConfigMigrationScope;
 }): ConfigMigrationReport;

package/dist/config/migration.js

@@ -1 +1 @@
-import{camelToKebab as e}from"./key-codec.js";const t={deprecatedRouterSection:"deprecated-router-section",invalidAskSection:"invalid-ask-section",invalidRouterSection:"invalid-router-section",routerAskConflict:"router-ask-conflict",duplicateEquivalentKeys:"duplicate-equivalent-keys",unknownRouterKeys:"unknown-router-keys",legacyCamelCaseAgentEnvKey:"legacy-camelcase-agent-env-key",legacyAgentEnvKeyConflict:"legacy-agent-env-key-conflict"},s={llmModel:{routerKeys:["llm-model","llmModel"],askKeys:["llm-model","llmModel"],targetAskKey:"llm-model"},confirmThreshold:{routerKeys:["confirm-threshold","confirmThreshold"],askKeys:["confirm-threshold","confirmThreshold"],targetAskKey:"confirm-threshold"}},n=[...s.llmModel.routerKeys,...s.confirmThreshold.routerKeys,"mode"],o=new Set([t.invalidAskSection,t.invalidRouterSection,t.routerAskConflict,t.unknownRouterKeys,t.legacyAgentEnvKeyConflict]);function r(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}function u(e,t){return Object.prototype.hasOwnProperty.call(e,t)}function i(e,t){return{code:e,message:t}}function c(e,t){return t.filter(t=>u(e,t))}function a(e,s,n){const o=c(s,n);if(0===o.length)return{ok:!0,key:void 0,value:void 0};const[r]=o,u=r?s[r]:void 0;return o.some(e=>s[e]!==u)?{ok:!1,issue:i(t.duplicateEquivalentKeys,`\`${e}\` 同时包含等价键 ${o.join(", ")} 且值不一致，请手动处理。`)}:{ok:!0,key:r,value:u}}function l(e){if(!u(e,"router"))return{matches:!1,canAutoMigrate:!1,issues:[]};const c=[i(t.deprecatedRouterSection,"`router` 配置段已废弃，请改用 `ask`。"),i(t.deprecatedRouterSection,"将 `router.llm-model` 迁移为 `ask.llm-model`。"),i(t.deprecatedRouterSection,"将 `router.confirm-threshold` 迁移为 `ask.confirm-threshold`。"),i(t.deprecatedRouterSection,"删除 `router.mode`；命令本身已决定策略（`run` / `ask` / `chat`）。")],l=e.router;if(!r(l))return c.push(i(t.invalidRouterSection,"`router` 配置段不是对象，无法自动迁移，请手动修复。")),{matches:!0,canAutoMigrate:!1,issues:c};const d=Object.keys(l).filter(e=>!n.includes(e));d.length>0&&c.push(i(t.unknownRouterKeys,`\`router\` 包含无法自动迁移的未知键：${d.join(", ")}。`));const g=e.ask;if(void 0===g||r(g)||c.push(i(t.invalidAskSection,"`ask` 配置段不是对象，无法自动迁移，请手动修复。")),r(g))for(const e of Object.keys(s)){const n=s[e],o=a("router",l,n.routerKeys),r=a("ask",g,n.askKeys);o.ok?r.ok?o.key&&r.key&&r.value!==o.value&&c.push(i(t.routerAskConflict,`\`router.${n.targetAskKey}\` 与 \`ask.${n.targetAskKey}\` 同时存在且值冲突，请手动处理。`)):c.push(r.issue):c.push(o.issue)}return{matches:!0,canAutoMigrate:!c.some(e=>o.has(e.code)),issues:c}}function d(e){const t=l(e);if(!t.matches)return{ok:!0,changed:!1,document:structuredClone(e),issues:[],summary:[]};if(!t.canAutoMigrate)return{ok:!1,changed:!1,issues:t.issues};const n=structuredClone(e),o=n.router;if(!r(o))return{ok:!1,changed:!1,issues:t.issues};const i=n.ask,c=r(i)?i:{};let d=!1;const g=[];for(const e of Object.keys(s)){const t=s[e],n=a("router",o,t.routerKeys);if(!n.ok)return{ok:!1,changed:!1,issues:[n.issue]};if(!n.key)continue;const r=a("ask",c,t.askKeys);if(!r.ok)return{ok:!1,changed:!1,issues:[r.issue]};r.key?g.push(`移除已废弃的 \`router.${t.targetAskKey}\``):(c[t.targetAskKey]=n.value,d=!0,g.push(`将 \`router.${t.targetAskKey}\` 迁移到 \`ask.${t.targetAskKey}\``));for(const e of t.routerKeys)u(o,e)&&delete o[e]}return u(o,"mode")&&(delete o.mode,g.push("删除已废弃的 `router.mode`")),d&&(n.ask=c),0===Object.keys(o).length&&(delete n.router,g.push("删除空的 `router` 配置段")),{ok:!0,changed:g.length>0,document:n,issues:t.issues,summary:g}}const g=/^[a-z0-9]+(-[a-z0-9]+)*$/;function f(e){return!g.test(e)}function k(t){const s=e(t).toLowerCase();return g.test(s)?s:void 0}function y(e){const s=e.agents;if(!r(s))return{matches:!1,canAutoMigrate:!1,issues:[]};const n=s.env;if(!r(n))return{matches:!1,canAutoMigrate:!1,issues:[]};const o=Object.keys(n).filter(f);if(0===o.length)return{matches:!1,canAutoMigrate:!1,issues:[]};const c=[];let a=!1;for(const e of o){const s=k(e);void 0!==s?u(n,s)?(a=!0,c.push(i(t.legacyAgentEnvKeyConflict,`\`agents.env\` 下同时存在 \`${e}\` 与 \`${s}\`，无法自动合并，请手动处理。`))):c.push(i(t.legacyCamelCaseAgentEnvKey,`\`agents.env.${e}\` 应使用 kebab-case（\`${s}\`）。`)):(a=!0,c.push(i(t.legacyAgentEnvKeyConflict,`\`agents.env.${e}\` 命名不符合 kebab-case 规范，无法自动迁移，请手动重命名。`)))}return{matches:!0,canAutoMigrate:!a,issues:c}}function h(e){const t=y(e);if(!t.matches)return{ok:!0,changed:!1,document:structuredClone(e),issues:[],summary:[]};if(!t.canAutoMigrate)return{ok:!1,changed:!1,issues:t.issues};const s=structuredClone(e),n=s.agents;if(!r(n))return{ok:!1,changed:!1,issues:t.issues};const o=n.env;if(!r(o))return{ok:!1,changed:!1,issues:t.issues};const u=[];for(const e of Object.keys(o).filter(f)){const t=k(e);void 0!==t&&(o[t]=o[e],delete o[e],u.push(`将 \`agents.env.${e}\` 重命名为 \`agents.env.${t}\``))}return{ok:!0,changed:u.length>0,document:s,issues:t.issues,summary:u}}const m=[{id:"router-to-ask",scopes:new Set(["ask"]),inspect:l,apply:d},{id:"legacy-agent-env-keys",scopes:new Set(["agents"]),inspect:y,apply:h}];export function detectKnownConfigMigrations(e,t={}){const{scope:s}=t,n=(void 0!==s?m.filter(e=>e.scopes.has(s)):m).map(t=>t.inspect(e)).filter(e=>e.matches);return 0===n.length?{needsMigration:!1,canAutoMigrate:!1,issues:[]}:{needsMigration:!0,canAutoMigrate:n.every(e=>e.canAutoMigrate),issues:n.flatMap(e=>e.issues)}}export function applyKnownConfigMigrations(e){let t=structuredClone(e);const s=[],n=[];let o=!1;for(const e of m){const r=e.apply(t);if(!r.ok)return{ok:!1,changed:!1,issues:r.issues};t=r.document,r.changed&&(o=!0,s.push(...r.summary)),n.push(...r.issues)}return{ok:!0,changed:o,document:t,summary:s,issues:n}}export function formatConfigMigrationError(e,t){const s=[`Config validation failed (${e}):`];for(const e of t.issues)s.push(`  - ${e.message}`);return t.canAutoMigrate?s.push("  - 可运行 `roll config migrate` 自动迁移当前配置。"):t.needsMigration&&s.push("  - 检测到配置迁移冲突，请手动处理后再重试。"),s.join("\n")}
+import{camelToKebab as e,CONFIG_KEY_CODEC as t,kebabToCamel as s}from"./key-codec.js";const n={deprecatedRouterSection:"deprecated-router-section",invalidAskSection:"invalid-ask-section",invalidRouterSection:"invalid-router-section",routerAskConflict:"router-ask-conflict",duplicateEquivalentKeys:"duplicate-equivalent-keys",unknownRouterKeys:"unknown-router-keys",legacyCamelCaseAgentEnvKey:"legacy-camelcase-agent-env-key",legacyAgentEnvKeyConflict:"legacy-agent-env-key-conflict",deprecatedRuntimeBashSection:"deprecated-runtime-bash-section",invalidRuntimeBashSection:"invalid-runtime-bash-section",invalidRuntimeShellSection:"invalid-runtime-shell-section",runtimeShellConflict:"runtime-shell-conflict"},o={llmModel:{routerKeys:["llm-model","llmModel"],askKeys:["llm-model","llmModel"],targetAskKey:"llm-model"},confirmThreshold:{routerKeys:["confirm-threshold","confirmThreshold"],askKeys:["confirm-threshold","confirmThreshold"],targetAskKey:"confirm-threshold"}},r=[...o.llmModel.routerKeys,...o.confirmThreshold.routerKeys,"mode"],i=new Set([n.invalidAskSection,n.invalidRouterSection,n.routerAskConflict,n.unknownRouterKeys,n.legacyAgentEnvKeyConflict,n.invalidRuntimeBashSection,n.invalidRuntimeShellSection,n.runtimeShellConflict]);function u(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}function c(e,t){return Object.prototype.hasOwnProperty.call(e,t)}function a(e,t){return{code:e,message:t}}function l(e,t){if(Object.is(e,t))return!0;if(!u(e)||!u(t))return!1;const s=Object.keys(e).sort(),n=Object.keys(t).sort();return s.length===n.length&&s.every((s,o)=>s===n[o]&&l(e[s],t[s]))}function d(){if("object"!==t.kind)throw new Error("runtime shell key codec is unavailable");const e=t.fields.runtime;if("object"!==e?.kind)throw new Error("runtime shell key codec is unavailable");const s=e.fields.shell;if("object"!==s?.kind)throw new Error("runtime shell key codec is unavailable");return s}function h(e,t,n){if(!u(e)||"leaf"===t.kind)return{ok:!0,value:e};const o={};for(const[r,i]of Object.entries(e)){const e="object"===t.kind?s(r):r,u="object"===t.kind?t.fields[e]:t.value,a=void 0===u?{ok:!0,value:i}:h(i,u,[...n,e]);if(!a.ok)return a;if(c(o,e)){if(!l(o[e],a.value))return{ok:!1,conflictPath:[...n,e].join(".")}}else o[e]=a.value}return{ok:!0,value:o}}function f(e,t){const s=h(e,d(),[t]);return s.ok?u(s.value)?{ok:!0,value:s.value}:{ok:!0,value:e}:s}function m(e,t){if(!u(e)||"leaf"===t.kind)return e;const n={},o=new Set;for(const[r,i]of Object.entries(e)){const e="object"===t.kind?s(r):r;if(o.has(e))continue;o.add(e);const u="object"===t.kind?t.fields[e]:t.value;n[r]=void 0===u?i:m(i,u)}return n}function k(e,t){return t.filter(t=>c(e,t))}function g(e,t,s){const o=k(t,s);if(0===o.length)return{ok:!0,key:void 0,value:void 0};const[r]=o,i=r?t[r]:void 0;return o.some(e=>t[e]!==i)?{ok:!1,issue:a(n.duplicateEquivalentKeys,`\`${e}\` 同时包含等价键 ${o.join(", ")} 且值不一致，请手动处理。`)}:{ok:!0,key:r,value:i}}function y(e){if(!c(e,"router"))return{matches:!1,canAutoMigrate:!1,issues:[]};const t=[a(n.deprecatedRouterSection,"`router` 配置段已废弃，请改用 `ask`。"),a(n.deprecatedRouterSection,"将 `router.llm-model` 迁移为 `ask.llm-model`。"),a(n.deprecatedRouterSection,"将 `router.confirm-threshold` 迁移为 `ask.confirm-threshold`。"),a(n.deprecatedRouterSection,"删除 `router.mode`；命令本身已决定策略（`run` / `ask` / `chat`）。")],s=e.router;if(!u(s))return t.push(a(n.invalidRouterSection,"`router` 配置段不是对象，无法自动迁移，请手动修复。")),{matches:!0,canAutoMigrate:!1,issues:t};const l=Object.keys(s).filter(e=>!r.includes(e));l.length>0&&t.push(a(n.unknownRouterKeys,`\`router\` 包含无法自动迁移的未知键：${l.join(", ")}。`));const d=e.ask;if(void 0===d||u(d)||t.push(a(n.invalidAskSection,"`ask` 配置段不是对象，无法自动迁移，请手动修复。")),u(d))for(const e of Object.keys(o)){const r=o[e],i=g("router",s,r.routerKeys),u=g("ask",d,r.askKeys);i.ok?u.ok?i.key&&u.key&&u.value!==i.value&&t.push(a(n.routerAskConflict,`\`router.${r.targetAskKey}\` 与 \`ask.${r.targetAskKey}\` 同时存在且值冲突，请手动处理。`)):t.push(u.issue):t.push(i.issue)}return{matches:!0,canAutoMigrate:!t.some(e=>i.has(e.code)),issues:t}}function v(e){const t=y(e);if(!t.matches)return{ok:!0,changed:!1,document:structuredClone(e),issues:[],summary:[]};if(!t.canAutoMigrate)return{ok:!1,changed:!1,issues:t.issues};const s=structuredClone(e),n=s.router;if(!u(n))return{ok:!1,changed:!1,issues:t.issues};const r=s.ask,i=u(r)?r:{};let a=!1;const l=[];for(const e of Object.keys(o)){const t=o[e],s=g("router",n,t.routerKeys);if(!s.ok)return{ok:!1,changed:!1,issues:[s.issue]};if(!s.key)continue;const r=g("ask",i,t.askKeys);if(!r.ok)return{ok:!1,changed:!1,issues:[r.issue]};r.key?l.push(`移除已废弃的 \`router.${t.targetAskKey}\``):(i[t.targetAskKey]=s.value,a=!0,l.push(`将 \`router.${t.targetAskKey}\` 迁移到 \`ask.${t.targetAskKey}\``));for(const e of t.routerKeys)c(n,e)&&delete n[e]}return c(n,"mode")&&(delete n.mode,l.push("删除已废弃的 `router.mode`")),a&&(s.ask=i),0===Object.keys(n).length&&(delete s.router,l.push("删除空的 `router` 配置段")),{ok:!0,changed:l.length>0,document:s,issues:t.issues,summary:l}}const p=/^[a-z0-9]+(-[a-z0-9]+)*$/;function b(e){return!p.test(e)}function A(t){const s=e(t).toLowerCase();return p.test(s)?s:void 0}function K(e){const t=e.agents;if(!u(t))return{matches:!1,canAutoMigrate:!1,issues:[]};const s=t.env;if(!u(s))return{matches:!1,canAutoMigrate:!1,issues:[]};const o=Object.keys(s).filter(b);if(0===o.length)return{matches:!1,canAutoMigrate:!1,issues:[]};const r=[];let i=!1;for(const e of o){const t=A(e);void 0!==t?c(s,t)?(i=!0,r.push(a(n.legacyAgentEnvKeyConflict,`\`agents.env\` 下同时存在 \`${e}\` 与 \`${t}\`，无法自动合并，请手动处理。`))):r.push(a(n.legacyCamelCaseAgentEnvKey,`\`agents.env.${e}\` 应使用 kebab-case（\`${t}\`）。`)):(i=!0,r.push(a(n.legacyAgentEnvKeyConflict,`\`agents.env.${e}\` 命名不符合 kebab-case 规范，无法自动迁移，请手动重命名。`)))}return{matches:!0,canAutoMigrate:!i,issues:r}}function S(e){const t=K(e);if(!t.matches)return{ok:!0,changed:!1,document:structuredClone(e),issues:[],summary:[]};if(!t.canAutoMigrate)return{ok:!1,changed:!1,issues:t.issues};const s=structuredClone(e),n=s.agents;if(!u(n))return{ok:!1,changed:!1,issues:t.issues};const o=n.env;if(!u(o))return{ok:!1,changed:!1,issues:t.issues};const r=[];for(const e of Object.keys(o).filter(b)){const t=A(e);void 0!==t&&(o[t]=o[e],delete o[e],r.push(`将 \`agents.env.${e}\` 重命名为 \`agents.env.${t}\``))}return{ok:!0,changed:r.length>0,document:s,issues:t.issues,summary:r}}function M(e){const t=e.runtime;if(!u(t))return{matches:!1,canAutoMigrate:!1,issues:[]};if(!c(t,"bash"))return{matches:!1,canAutoMigrate:!1,issues:[]};const s=[a(n.deprecatedRuntimeBashSection,"`runtime.bash` 配置段已废弃，请改用 `runtime.shell`。")],o=t.bash;u(o)||s.push(a(n.invalidRuntimeBashSection,"`runtime.bash` 配置段不是对象，无法自动迁移，请手动修复。"));const r=t.shell;void 0===r||u(r)||s.push(a(n.invalidRuntimeShellSection,"`runtime.shell` 配置段不是对象，无法自动迁移，请手动修复。"));const d=u(o)?f(o,"runtime.bash"):void 0,h=u(r)?f(r,"runtime.shell"):void 0;for(const e of[d,h])void 0===e||e.ok||s.push(a(n.runtimeShellConflict,`\`${e.conflictPath}\` 同时包含等价键且值冲突，请手动处理。`));!0!==d?.ok||!0!==h?.ok||l(d.value,h.value)||s.push(a(n.runtimeShellConflict,"`runtime.bash` 与 `runtime.shell` 同时存在且值冲突，请手动处理。"));return{matches:!0,canAutoMigrate:!s.some(e=>i.has(e.code)),issues:s}}function C(e){const t=M(e);if(!t.matches)return{ok:!0,changed:!1,document:structuredClone(e),issues:[],summary:[]};if(!t.canAutoMigrate)return{ok:!1,changed:!1,issues:t.issues};const s=structuredClone(e),n=s.runtime;if(!u(n))return{ok:!1,changed:!1,issues:t.issues};const o=n.bash;if(!u(o))return{ok:!1,changed:!1,issues:t.issues};const r=[];return c(n,"shell")?r.push("删除已废弃的 `runtime.bash`"):(n.shell=m(o,d()),r.push("将 `runtime.bash` 迁移为 `runtime.shell`")),delete n.bash,{ok:!0,changed:!0,document:s,issues:t.issues,summary:r}}const j=[{id:"router-to-ask",scopes:new Set(["ask"]),inspect:y,apply:v},{id:"legacy-agent-env-keys",scopes:new Set(["agents"]),inspect:K,apply:S},{id:"runtime-bash-to-shell",scopes:new Set(["runtime"]),inspect:M,apply:C}];export function detectKnownConfigMigrations(e,t={}){const{scope:s}=t,n=(void 0!==s?j.filter(e=>e.scopes.has(s)):j).map(t=>t.inspect(e)).filter(e=>e.matches);return 0===n.length?{needsMigration:!1,canAutoMigrate:!1,issues:[]}:{needsMigration:!0,canAutoMigrate:n.every(e=>e.canAutoMigrate),issues:n.flatMap(e=>e.issues)}}export function applyKnownConfigMigrations(e){let t=structuredClone(e);const s=[],n=[];let o=!1;for(const e of j){const r=e.apply(t);if(!r.ok)return{ok:!1,changed:!1,issues:r.issues};t=r.document,r.changed&&(o=!0,s.push(...r.summary)),n.push(...r.issues)}return{ok:!0,changed:o,document:t,summary:s,issues:n}}export function formatConfigMigrationError(e,t){const s=[`Config validation failed (${e}):`];for(const e of t.issues)s.push(`  - ${e.message}`);return t.canAutoMigrate?s.push("  - 可运行 `roll config migrate` 自动迁移当前配置。"):t.needsMigration&&s.push("  - 检测到配置迁移冲突，请手动处理后再重试。"),s.join("\n")}

package/dist/config/runtime-env.d.ts

@@ -107,17 +107,17 @@ export declare const BrowserInstanceStatusDiagnosticSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     mode: "managed-cdp" | "remote-cdp" | "existing-session";
     id: string;
+    profile: {
+        exists: boolean;
+        writable: boolean;
+        userDataDir?: string | undefined;
+    };
     cdp: {
         endpoint: string;
         versionReachable: boolean;
         listReachable: boolean;
         port?: number | undefined;
     };
-    profile: {
-        exists: boolean;
-        writable: boolean;
-        userDataDir?: string | undefined;
-    };
     tracking: {
         source: "instance" | "missing" | "default-env";
         agentIdFingerprint?: string | undefined;
@@ -126,17 +126,17 @@ export declare const BrowserInstanceStatusDiagnosticSchema: z.ZodObject<{
 }, {
     mode: "managed-cdp" | "remote-cdp" | "existing-session";
     id: string;
+    profile: {
+        exists: boolean;
+        writable: boolean;
+        userDataDir?: string | undefined;
+    };
     cdp: {
         endpoint: string;
         versionReachable: boolean;
         listReachable: boolean;
         port?: number | undefined;
     };
-    profile: {
-        exists: boolean;
-        writable: boolean;
-        userDataDir?: string | undefined;
-    };
     tracking: {
         source: "instance" | "missing" | "default-env";
         agentIdFingerprint?: string | undefined;
@@ -251,17 +251,17 @@ export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         mode: "managed-cdp" | "remote-cdp" | "existing-session";
         id: string;
+        profile: {
+            exists: boolean;
+            writable: boolean;
+            userDataDir?: string | undefined;
+        };
         cdp: {
             endpoint: string;
             versionReachable: boolean;
             listReachable: boolean;
             port?: number | undefined;
         };
-        profile: {
-            exists: boolean;
-            writable: boolean;
-            userDataDir?: string | undefined;
-        };
         tracking: {
             source: "instance" | "missing" | "default-env";
             agentIdFingerprint?: string | undefined;
@@ -270,17 +270,17 @@ export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
     }, {
         mode: "managed-cdp" | "remote-cdp" | "existing-session";
         id: string;
+        profile: {
+            exists: boolean;
+            writable: boolean;
+            userDataDir?: string | undefined;
+        };
         cdp: {
             endpoint: string;
             versionReachable: boolean;
             listReachable: boolean;
             port?: number | undefined;
         };
-        profile: {
-            exists: boolean;
-            writable: boolean;
-            userDataDir?: string | undefined;
-        };
         tracking: {
             source: "instance" | "missing" | "default-env";
             agentIdFingerprint?: string | undefined;
@@ -295,17 +295,17 @@ export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
     instances?: {
         mode: "managed-cdp" | "remote-cdp" | "existing-session";
         id: string;
+        profile: {
+            exists: boolean;
+            writable: boolean;
+            userDataDir?: string | undefined;
+        };
         cdp: {
             endpoint: string;
             versionReachable: boolean;
             listReachable: boolean;
             port?: number | undefined;
         };
-        profile: {
-            exists: boolean;
-            writable: boolean;
-            userDataDir?: string | undefined;
-        };
         tracking: {
             source: "instance" | "missing" | "default-env";
             agentIdFingerprint?: string | undefined;
@@ -339,17 +339,17 @@ export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
     instances?: {
         mode: "managed-cdp" | "remote-cdp" | "existing-session";
         id: string;
+        profile: {
+            exists: boolean;
+            writable: boolean;
+            userDataDir?: string | undefined;
+        };
         cdp: {
             endpoint: string;
             versionReachable: boolean;
             listReachable: boolean;
             port?: number | undefined;
         };
-        profile: {
-            exists: boolean;
-            writable: boolean;
-            userDataDir?: string | undefined;
-        };
         tracking: {
             source: "instance" | "missing" | "default-env";
             agentIdFingerprint?: string | undefined;

package/dist/config/schema.d.ts

@@ -93,6 +93,72 @@ export declare const runtimeCompactionConfigSchema: z.ZodObject<{
     keepRecentTokens?: number | undefined;
 }>;
 export declare const runtimeThinkingLevels: readonly ["off", "low", "medium", "high"];
+export declare const runtimeShellSessionConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    maxSessions: z.ZodDefault<z.ZodNumber>;
+    defaultYieldMs: z.ZodDefault<z.ZodNumber>;
+    maxOutputTokens: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    maxOutputTokens: number;
+    enabled: boolean;
+    maxSessions: number;
+    defaultYieldMs: number;
+}, {
+    maxOutputTokens?: number | undefined;
+    enabled?: boolean | undefined;
+    maxSessions?: number | undefined;
+    defaultYieldMs?: number | undefined;
+}>;
+export declare const runtimeShellConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    autoApproveSafe: z.ZodDefault<z.ZodBoolean>;
+    defaultTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    maxTimeoutMs: z.ZodDefault<z.ZodNumber>;
+    maxCaptureBytes: z.ZodDefault<z.ZodNumber>;
+    maxModelOutputChars: z.ZodDefault<z.ZodNumber>;
+    session: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        maxSessions: z.ZodDefault<z.ZodNumber>;
+        defaultYieldMs: z.ZodDefault<z.ZodNumber>;
+        maxOutputTokens: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        maxOutputTokens: number;
+        enabled: boolean;
+        maxSessions: number;
+        defaultYieldMs: number;
+    }, {
+        maxOutputTokens?: number | undefined;
+        enabled?: boolean | undefined;
+        maxSessions?: number | undefined;
+        defaultYieldMs?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    autoApproveSafe: boolean;
+    defaultTimeoutMs: number;
+    maxTimeoutMs: number;
+    maxCaptureBytes: number;
+    maxModelOutputChars: number;
+    session: {
+        maxOutputTokens: number;
+        enabled: boolean;
+        maxSessions: number;
+        defaultYieldMs: number;
+    };
+}, {
+    enabled?: boolean | undefined;
+    autoApproveSafe?: boolean | undefined;
+    defaultTimeoutMs?: number | undefined;
+    maxTimeoutMs?: number | undefined;
+    maxCaptureBytes?: number | undefined;
+    maxModelOutputChars?: number | undefined;
+    session?: {
+        maxOutputTokens?: number | undefined;
+        enabled?: boolean | undefined;
+        maxSessions?: number | undefined;
+        defaultYieldMs?: number | undefined;
+    } | undefined;
+}>;
 export declare const runtimeConfigSchema: z.ZodObject<{
     provider: z.ZodOptional<z.ZodString>;
     model: z.ZodOptional<z.ZodString>;
@@ -130,7 +196,71 @@ export declare const runtimeConfigSchema: z.ZodObject<{
         keepRecentTurns?: number | undefined;
         keepRecentTokens?: number | undefined;
     }>>;
+    shell: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        autoApproveSafe: z.ZodDefault<z.ZodBoolean>;
+        defaultTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        maxTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        maxCaptureBytes: z.ZodDefault<z.ZodNumber>;
+        maxModelOutputChars: z.ZodDefault<z.ZodNumber>;
+        session: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            maxSessions: z.ZodDefault<z.ZodNumber>;
+            defaultYieldMs: z.ZodDefault<z.ZodNumber>;
+            maxOutputTokens: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            maxOutputTokens: number;
+            enabled: boolean;
+            maxSessions: number;
+            defaultYieldMs: number;
+        }, {
+            maxOutputTokens?: number | undefined;
+            enabled?: boolean | undefined;
+            maxSessions?: number | undefined;
+            defaultYieldMs?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        autoApproveSafe: boolean;
+        defaultTimeoutMs: number;
+        maxTimeoutMs: number;
+        maxCaptureBytes: number;
+        maxModelOutputChars: number;
+        session: {
+            maxOutputTokens: number;
+            enabled: boolean;
+            maxSessions: number;
+            defaultYieldMs: number;
+        };
+    }, {
+        enabled?: boolean | undefined;
+        autoApproveSafe?: boolean | undefined;
+        defaultTimeoutMs?: number | undefined;
+        maxTimeoutMs?: number | undefined;
+        maxCaptureBytes?: number | undefined;
+        maxModelOutputChars?: number | undefined;
+        session?: {
+            maxOutputTokens?: number | undefined;
+            enabled?: boolean | undefined;
+            maxSessions?: number | undefined;
+            defaultYieldMs?: number | undefined;
+        } | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
+    shell: {
+        enabled: boolean;
+        autoApproveSafe: boolean;
+        defaultTimeoutMs: number;
+        maxTimeoutMs: number;
+        maxCaptureBytes: number;
+        maxModelOutputChars: number;
+        session: {
+            maxOutputTokens: number;
+            enabled: boolean;
+            maxSessions: number;
+            defaultYieldMs: number;
+        };
+    };
     maxSteps: number;
     turnTimeoutMs: number;
     threadsDir: string;
@@ -150,6 +280,20 @@ export declare const runtimeConfigSchema: z.ZodObject<{
     provider?: string | undefined;
     contextWindow?: number | undefined;
 }, {
+    shell?: {
+        enabled?: boolean | undefined;
+        autoApproveSafe?: boolean | undefined;
+        defaultTimeoutMs?: number | undefined;
+        maxTimeoutMs?: number | undefined;
+        maxCaptureBytes?: number | undefined;
+        maxModelOutputChars?: number | undefined;
+        session?: {
+            maxOutputTokens?: number | undefined;
+            enabled?: boolean | undefined;
+            maxSessions?: number | undefined;
+            defaultYieldMs?: number | undefined;
+        } | undefined;
+    } | undefined;
     model?: string | undefined;
     provider?: string | undefined;
     maxSteps?: number | undefined;
@@ -621,7 +765,71 @@ export declare const rollConfigSchema: z.ZodObject<{
             keepRecentTurns?: number | undefined;
             keepRecentTokens?: number | undefined;
         }>>;
+        shell: z.ZodDefault<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            autoApproveSafe: z.ZodDefault<z.ZodBoolean>;
+            defaultTimeoutMs: z.ZodDefault<z.ZodNumber>;
+            maxTimeoutMs: z.ZodDefault<z.ZodNumber>;
+            maxCaptureBytes: z.ZodDefault<z.ZodNumber>;
+            maxModelOutputChars: z.ZodDefault<z.ZodNumber>;
+            session: z.ZodDefault<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                maxSessions: z.ZodDefault<z.ZodNumber>;
+                defaultYieldMs: z.ZodDefault<z.ZodNumber>;
+                maxOutputTokens: z.ZodDefault<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                maxOutputTokens: number;
+                enabled: boolean;
+                maxSessions: number;
+                defaultYieldMs: number;
+            }, {
+                maxOutputTokens?: number | undefined;
+                enabled?: boolean | undefined;
+                maxSessions?: number | undefined;
+                defaultYieldMs?: number | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            autoApproveSafe: boolean;
+            defaultTimeoutMs: number;
+            maxTimeoutMs: number;
+            maxCaptureBytes: number;
+            maxModelOutputChars: number;
+            session: {
+                maxOutputTokens: number;
+                enabled: boolean;
+                maxSessions: number;
+                defaultYieldMs: number;
+            };
+        }, {
+            enabled?: boolean | undefined;
+            autoApproveSafe?: boolean | undefined;
+            defaultTimeoutMs?: number | undefined;
+            maxTimeoutMs?: number | undefined;
+            maxCaptureBytes?: number | undefined;
+            maxModelOutputChars?: number | undefined;
+            session?: {
+                maxOutputTokens?: number | undefined;
+                enabled?: boolean | undefined;
+                maxSessions?: number | undefined;
+                defaultYieldMs?: number | undefined;
+            } | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
+        shell: {
+            enabled: boolean;
+            autoApproveSafe: boolean;
+            defaultTimeoutMs: number;
+            maxTimeoutMs: number;
+            maxCaptureBytes: number;
+            maxModelOutputChars: number;
+            session: {
+                maxOutputTokens: number;
+                enabled: boolean;
+                maxSessions: number;
+                defaultYieldMs: number;
+            };
+        };
         maxSteps: number;
         turnTimeoutMs: number;
         threadsDir: string;
@@ -641,6 +849,20 @@ export declare const rollConfigSchema: z.ZodObject<{
         provider?: string | undefined;
         contextWindow?: number | undefined;
     }, {
+        shell?: {
+            enabled?: boolean | undefined;
+            autoApproveSafe?: boolean | undefined;
+            defaultTimeoutMs?: number | undefined;
+            maxTimeoutMs?: number | undefined;
+            maxCaptureBytes?: number | undefined;
+            maxModelOutputChars?: number | undefined;
+            session?: {
+                maxOutputTokens?: number | undefined;
+                enabled?: boolean | undefined;
+                maxSessions?: number | undefined;
+                defaultYieldMs?: number | undefined;
+            } | undefined;
+        } | undefined;
         model?: string | undefined;
         provider?: string | undefined;
         maxSteps?: number | undefined;
@@ -962,6 +1184,20 @@ export declare const rollConfigSchema: z.ZodObject<{
         }>;
     };
     runtime: {
+        shell: {
+            enabled: boolean;
+            autoApproveSafe: boolean;
+            defaultTimeoutMs: number;
+            maxTimeoutMs: number;
+            maxCaptureBytes: number;
+            maxModelOutputChars: number;
+            session: {
+                maxOutputTokens: number;
+                enabled: boolean;
+                maxSessions: number;
+                defaultYieldMs: number;
+            };
+        };
         maxSteps: number;
         turnTimeoutMs: number;
         threadsDir: string;
@@ -1037,6 +1273,20 @@ export declare const rollConfigSchema: z.ZodObject<{
         }> | undefined;
     } | undefined;
     runtime?: {
+        shell?: {
+            enabled?: boolean | undefined;
+            autoApproveSafe?: boolean | undefined;
+            defaultTimeoutMs?: number | undefined;
+            maxTimeoutMs?: number | undefined;
+            maxCaptureBytes?: number | undefined;
+            maxModelOutputChars?: number | undefined;
+            session?: {
+                maxOutputTokens?: number | undefined;
+                enabled?: boolean | undefined;
+                maxSessions?: number | undefined;
+                defaultYieldMs?: number | undefined;
+            } | undefined;
+        } | undefined;
         model?: string | undefined;
         provider?: string | undefined;
         maxSteps?: number | undefined;

package/dist/config/schema.js

@@ -1 +1 @@
-import{z as e}from"zod";const t=["zhipin","yupao"],o=["managed-cdp","remote-cdp","existing-session"],n=["chrome","chromium","msedge"],i=["guarded","auto","deny"],r=["auto","confirm","deny"],a=["summarize","truncate"],s=e.string().trim().regex(/^#[\da-fA-F]{6}$/,"profileColor must be a hex RGB color such as #2563EB").transform(e=>e.toUpperCase());export const browserWindowBoundsSchema=e.object({x:e.number().int().optional(),y:e.number().int().optional(),width:e.number().int().positive().optional(),height:e.number().int().positive().optional()});export const providerConfigSchema=e.object({apiKey:e.string(),baseUrl:e.string().optional()});export const llmConfigSchema=e.object({defaultProvider:e.string(),defaultModel:e.string(),providers:e.record(e.string(),providerConfigSchema)});export const askConfigSchema=e.object({llmModel:e.string().optional(),confirmThreshold:e.number().optional()});export const runtimeApprovalConfigSchema=e.object({default:e.enum(i).default("guarded"),overrides:e.record(e.string(),e.enum(r)).default({})});export const runtimeCompactionConfigSchema=e.object({enabled:e.boolean().default(!0),strategy:e.enum(a).default("summarize"),threshold:e.number().min(.1).max(.95).default(.75),keepRecentTurns:e.number().int().min(1).default(4),keepRecentTokens:e.number().int().min(1).default(32e3)});export const runtimeThinkingLevels=["off","low","medium","high"];export const runtimeConfigSchema=e.object({provider:e.string().optional(),model:e.string().optional(),maxSteps:e.number().int().min(1).default(80),turnTimeoutMs:e.number().int().min(1e4).default(3e5),threadsDir:e.string().default("~/.roll-agent/threads"),contextWindow:e.number().int().min(1).optional(),thinkingLevel:e.enum(runtimeThinkingLevels).default("medium"),approval:runtimeApprovalConfigSchema.default({}),compaction:runtimeCompactionConfigSchema.default({})});export const skillsConfigSchema=e.object({dirs:e.array(e.string().trim().min(1)).default([])});export const agentsConfigSchema=e.object({dataDir:e.string(),env:e.record(e.string(),e.record(e.string(),e.string())).optional()});export const installConfigSchema=e.object({registry:e.string().trim().url().optional(),fetchRetries:e.number().int().min(0).max(10).default(3),preferOffline:e.boolean().default(!1),networkTimeoutMs:e.number().int().min(1e4).default(12e4)});export const browserInstanceConfigSchema=e.object({platform:e.enum(t).optional(),mode:e.enum(o).default("managed-cdp"),headless:e.boolean().optional(),cdpUrl:e.string().optional(),cdpHost:e.string().default("127.0.0.1"),cdpPort:e.number().int().min(1).max(65535).optional(),channel:e.enum(n).default("chrome"),executablePath:e.string().optional(),userDataDir:e.string().trim().min(1),sessionsDir:e.string().trim().min(1).optional(),args:e.array(e.string()).optional(),profileName:e.string().trim().min(1).optional(),profileColor:s.optional(),windowBounds:browserWindowBoundsSchema.optional(),trackingAgentId:e.string().trim().min(1).optional()}).superRefine((t,o)=>{"managed-cdp"===t.mode&&void 0===t.cdpPort&&o.addIssue({code:e.ZodIssueCode.custom,path:["cdpPort"],message:"managed-cdp browser instance requires cdpPort"}),"remote-cdp"!==t.mode&&"existing-session"!==t.mode||void 0!==t.cdpUrl||o.addIssue({code:e.ZodIssueCode.custom,path:["cdpUrl"],message:`${t.mode} browser instance requires cdpUrl`})});export const browserConfigSchema=e.object({defaultInstance:e.string().trim().min(1).optional(),instances:e.record(e.string(),browserInstanceConfigSchema).default({})}).superRefine((t,o)=>{const n=Object.entries(t.instances);void 0!==t.defaultInstance&&void 0===t.instances[t.defaultInstance]&&o.addIssue({code:e.ZodIssueCode.custom,path:["defaultInstance"],message:`defaultInstance "${t.defaultInstance}" is not declared in browser.instances`});const i=new Map,r=new Map;for(const[t,a]of n){if(void 0!==a.cdpPort){const n=i.get(a.cdpPort);void 0!==n?o.addIssue({code:e.ZodIssueCode.custom,path:["instances",t,"cdpPort"],message:`cdpPort ${String(a.cdpPort)} is already used by browser instance "${n}"`}):i.set(a.cdpPort,t)}const n=r.get(a.userDataDir);void 0!==n?o.addIssue({code:e.ZodIssueCode.custom,path:["instances",t,"userDataDir"],message:`userDataDir is already used by browser instance "${n}"`}):r.set(a.userDataDir,t)}});export const rollConfigSchema=e.object({llm:llmConfigSchema,ask:askConfigSchema,runtime:runtimeConfigSchema.default({}),skills:skillsConfigSchema.default({}),agents:agentsConfigSchema,install:installConfigSchema.default({}),browser:browserConfigSchema.default({})});
+import{z as e}from"zod";const t=["zhipin","yupao"],n=["managed-cdp","remote-cdp","existing-session"],o=["chrome","chromium","msedge"],i=["guarded","auto","deny"],a=["auto","confirm","deny"],r=["summarize","truncate"],s=e.string().trim().regex(/^#[\da-fA-F]{6}$/,"profileColor must be a hex RGB color such as #2563EB").transform(e=>e.toUpperCase());export const browserWindowBoundsSchema=e.object({x:e.number().int().optional(),y:e.number().int().optional(),width:e.number().int().positive().optional(),height:e.number().int().positive().optional()});export const providerConfigSchema=e.object({apiKey:e.string(),baseUrl:e.string().optional()});export const llmConfigSchema=e.object({defaultProvider:e.string(),defaultModel:e.string(),providers:e.record(e.string(),providerConfigSchema)});export const askConfigSchema=e.object({llmModel:e.string().optional(),confirmThreshold:e.number().optional()});export const runtimeApprovalConfigSchema=e.object({default:e.enum(i).default("guarded"),overrides:e.record(e.string(),e.enum(a)).default({})});export const runtimeCompactionConfigSchema=e.object({enabled:e.boolean().default(!0),strategy:e.enum(r).default("summarize"),threshold:e.number().min(.1).max(.95).default(.75),keepRecentTurns:e.number().int().min(1).default(4),keepRecentTokens:e.number().int().min(1).default(32e3)});export const runtimeThinkingLevels=["off","low","medium","high"];export const runtimeShellSessionConfigSchema=e.object({enabled:e.boolean().default(!1),maxSessions:e.number().int().min(1).max(64).default(8),defaultYieldMs:e.number().int().min(250).max(3e4).default(1e4),maxOutputTokens:e.number().int().min(256).default(1e4)});export const runtimeShellConfigSchema=e.object({enabled:e.boolean().default(!1),autoApproveSafe:e.boolean().default(!0),defaultTimeoutMs:e.number().int().min(1e3).max(6e5).default(1e4),maxTimeoutMs:e.number().int().min(1e3).max(6e5).default(6e5),maxCaptureBytes:e.number().int().min(16384).default(1048576),maxModelOutputChars:e.number().int().min(1e3).default(16e3),session:runtimeShellSessionConfigSchema.default({})});export const runtimeConfigSchema=e.object({provider:e.string().optional(),model:e.string().optional(),maxSteps:e.number().int().min(1).default(80),turnTimeoutMs:e.number().int().min(1e4).default(3e5),threadsDir:e.string().default("~/.roll-agent/threads"),contextWindow:e.number().int().min(1).optional(),thinkingLevel:e.enum(runtimeThinkingLevels).default("medium"),approval:runtimeApprovalConfigSchema.default({}),compaction:runtimeCompactionConfigSchema.default({}),shell:runtimeShellConfigSchema.default({})});export const skillsConfigSchema=e.object({dirs:e.array(e.string().trim().min(1)).default([])});export const agentsConfigSchema=e.object({dataDir:e.string(),env:e.record(e.string(),e.record(e.string(),e.string())).optional()});export const installConfigSchema=e.object({registry:e.string().trim().url().optional(),fetchRetries:e.number().int().min(0).max(10).default(3),preferOffline:e.boolean().default(!1),networkTimeoutMs:e.number().int().min(1e4).default(12e4)});export const browserInstanceConfigSchema=e.object({platform:e.enum(t).optional(),mode:e.enum(n).default("managed-cdp"),headless:e.boolean().optional(),cdpUrl:e.string().optional(),cdpHost:e.string().default("127.0.0.1"),cdpPort:e.number().int().min(1).max(65535).optional(),channel:e.enum(o).default("chrome"),executablePath:e.string().optional(),userDataDir:e.string().trim().min(1),sessionsDir:e.string().trim().min(1).optional(),args:e.array(e.string()).optional(),profileName:e.string().trim().min(1).optional(),profileColor:s.optional(),windowBounds:browserWindowBoundsSchema.optional(),trackingAgentId:e.string().trim().min(1).optional()}).superRefine((t,n)=>{"managed-cdp"===t.mode&&void 0===t.cdpPort&&n.addIssue({code:e.ZodIssueCode.custom,path:["cdpPort"],message:"managed-cdp browser instance requires cdpPort"}),"remote-cdp"!==t.mode&&"existing-session"!==t.mode||void 0!==t.cdpUrl||n.addIssue({code:e.ZodIssueCode.custom,path:["cdpUrl"],message:`${t.mode} browser instance requires cdpUrl`})});export const browserConfigSchema=e.object({defaultInstance:e.string().trim().min(1).optional(),instances:e.record(e.string(),browserInstanceConfigSchema).default({})}).superRefine((t,n)=>{const o=Object.entries(t.instances);void 0!==t.defaultInstance&&void 0===t.instances[t.defaultInstance]&&n.addIssue({code:e.ZodIssueCode.custom,path:["defaultInstance"],message:`defaultInstance "${t.defaultInstance}" is not declared in browser.instances`});const i=new Map,a=new Map;for(const[t,r]of o){if(void 0!==r.cdpPort){const o=i.get(r.cdpPort);void 0!==o?n.addIssue({code:e.ZodIssueCode.custom,path:["instances",t,"cdpPort"],message:`cdpPort ${String(r.cdpPort)} is already used by browser instance "${o}"`}):i.set(r.cdpPort,t)}const o=a.get(r.userDataDir);void 0!==o?n.addIssue({code:e.ZodIssueCode.custom,path:["instances",t,"userDataDir"],message:`userDataDir is already used by browser instance "${o}"`}):a.set(r.userDataDir,t)}});export const rollConfigSchema=e.object({llm:llmConfigSchema,ask:askConfigSchema,runtime:runtimeConfigSchema.default({}),skills:skillsConfigSchema.default({}),agents:agentsConfigSchema,install:installConfigSchema.default({}),browser:browserConfigSchema.default({})});

package/dist/llm/providers.d.ts

@@ -15,10 +15,22 @@ export interface ResolvedLLMCall {
     readonly model: LanguageModelV4;
     readonly providerOptions?: SharedV4ProviderOptions;
 }
+/**
+ * 把 resolveLLMCall(..., "sampling", ...) 的结果转换成
+ * McpClientManager.connect() 需要的 samplingModel/samplingProviderOptions 字段。
+ * 统一入口，避免每个调用方（ask/run/chat）各自拼一份、漏传 providerOptions。
+ */
+export declare function toSamplingConnectOptions(call: ResolvedLLMCall | undefined): {
+    readonly samplingModel?: LanguageModelV4;
+    readonly samplingProviderOptions?: SharedV4ProviderOptions;
+};
 /**
  * 按 provider + 调用目的解析 generateText 的完整调用上下文。
  *
  * structured-output 场景下，对 qwen provider 自动注入 enableThinking: false，
  * 因为阿里云 thinking mode 不支持 structured output。
+ *
+ * chat 与 sampling 场景下都是纯文本 generateText 调用，复用同一套
+ * thinkingProviderOptions 映射注入 reasoning/thinking effort。
  */
 export declare function resolveLLMCall(providerName: string, modelName: string, apiKey: string, purpose: LLMCallPurpose, baseURL?: string, thinkingLevel?: ThinkingLevel): ResolvedLLMCall;

package/dist/llm/providers.js

@@ -1 +1 @@
-import{createAlibaba as e}from"@ai-sdk/alibaba";import{createAnthropic as i}from"@ai-sdk/anthropic";import{createOpenAI as n}from"@ai-sdk/openai";import{createDeepSeek as o}from"@ai-sdk/deepseek";import{runtimeThinkingLevels as t}from"../config/schema.js";const a={low:2048,medium:8192,high:16384},r=["gpt-5.1","gpt-5.2","gpt-5.3","gpt-5.4"];function p(e){return r.some(i=>e.startsWith(i))}function s(e){const i=/^claude-[a-z]+-(\d+)(?:-(\d+))?(?:\b|-)/.exec(e),n=i?.[1];if(!n)return!1;const o=Number(n),t=i?.[2],a=void 0!==t&&t.length<=2?Number(t):0;return o>4||4===o&&a>=6}export function thinkingProviderOptions(e,i,n){return"openai"===e?"off"===n?p(i)?{openai:{reasoningEffort:"none"}}:void 0:{openai:{reasoningEffort:n}}:"anthropic"===e?"off"===n?{anthropic:{thinking:{type:"disabled"}}}:s(i)?{anthropic:{thinking:{type:"adaptive"},effort:n}}:{anthropic:{thinking:{type:"enabled",budgetTokens:a[n]}}}:"qwen"===e?"off"===n?{alibaba:{enableThinking:!1}}:{alibaba:{enableThinking:!0,thinkingBudget:a[n]}}:"deepseek"===e?{deepseek:{thinking:{type:"off"===n?"disabled":"enabled"}}}:void 0}const d="https://dashscope.aliyuncs.com/compatible-mode/v1",c={anthropic:(e,{apiKey:n,baseURL:o})=>i({apiKey:n,...o?{baseURL:o}:{}})(e),openai:(e,{apiKey:i,baseURL:o})=>n({apiKey:i,...o?{baseURL:o}:{}})(e),deepseek:(e,{apiKey:i,baseURL:n})=>o({apiKey:i,...n?{baseURL:n}:{}})(e),qwen:(i,{apiKey:n,baseURL:o})=>e({apiKey:n,baseURL:o??d})(i)};export function createProviderModel(e,i,n,o){const t=c[e];if(!t){const i=Object.keys(c).join(", ");throw new Error(`Unknown LLM provider "${e}". Supported: ${i}`)}return t(i,{apiKey:n,baseURL:o})}export function resolveLLMCall(e,i,n,o,t,a="medium"){const r=createProviderModel(e,i,n,t);if("structured-output"===o&&"qwen"===e)return{model:r,providerOptions:{alibaba:{enableThinking:!1}}};if("chat"===o){const n=thinkingProviderOptions(e,i,a);return n?{model:r,providerOptions:n}:{model:r}}return{model:r}}
+import{createAlibaba as e}from"@ai-sdk/alibaba";import{createAnthropic as i}from"@ai-sdk/anthropic";import{createOpenAI as n}from"@ai-sdk/openai";import{createDeepSeek as o}from"@ai-sdk/deepseek";import{runtimeThinkingLevels as t}from"../config/schema.js";const r={low:2048,medium:8192,high:16384},a=["gpt-5.1","gpt-5.2","gpt-5.3","gpt-5.4"];function p(e){return a.some(i=>e.startsWith(i))}function s(e){const i=/^claude-[a-z]+-(\d+)(?:-(\d+))?(?:\b|-)/.exec(e),n=i?.[1];if(!n)return!1;const o=Number(n),t=i?.[2],r=void 0!==t&&t.length<=2?Number(t):0;return o>4||4===o&&r>=6}export function thinkingProviderOptions(e,i,n){return"openai"===e?"off"===n?p(i)?{openai:{reasoningEffort:"none"}}:void 0:{openai:{reasoningEffort:n}}:"anthropic"===e?"off"===n?{anthropic:{thinking:{type:"disabled"}}}:s(i)?{anthropic:{thinking:{type:"adaptive"},effort:n}}:{anthropic:{thinking:{type:"enabled",budgetTokens:r[n]}}}:"qwen"===e?"off"===n?{alibaba:{enableThinking:!1}}:{alibaba:{enableThinking:!0,thinkingBudget:r[n]}}:"deepseek"===e?{deepseek:{thinking:{type:"off"===n?"disabled":"enabled"}}}:void 0}const d="https://dashscope.aliyuncs.com/compatible-mode/v1",c={anthropic:(e,{apiKey:n,baseURL:o})=>i({apiKey:n,...o?{baseURL:o}:{}})(e),openai:(e,{apiKey:i,baseURL:o})=>n({apiKey:i,...o?{baseURL:o}:{}})(e),deepseek:(e,{apiKey:i,baseURL:n})=>o({apiKey:i,...n?{baseURL:n}:{}})(e),qwen:(i,{apiKey:n,baseURL:o})=>e({apiKey:n,baseURL:o??d})(i)};export function createProviderModel(e,i,n,o){const t=c[e];if(!t){const i=Object.keys(c).join(", ");throw new Error(`Unknown LLM provider "${e}". Supported: ${i}`)}return t(i,{apiKey:n,baseURL:o})}export function toSamplingConnectOptions(e){return e?{samplingModel:e.model,...e.providerOptions?{samplingProviderOptions:e.providerOptions}:{}}:{}}export function resolveLLMCall(e,i,n,o,t,r="medium"){const a=createProviderModel(e,i,n,t);if("structured-output"===o&&"qwen"===e)return{model:a,providerOptions:{alibaba:{enableThinking:!1}}};if("chat"===o||"sampling"===o){const n=thinkingProviderOptions(e,i,r);return n?{model:a,providerOptions:n}:{model:a}}return{model:a}}

package/dist/mcp/client-manager.d.ts

@@ -1,11 +1,13 @@
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import type { LanguageModelV4 } from "@ai-sdk/provider";
+import type { LanguageModelV4, SharedV4ProviderOptions } from "@ai-sdk/provider";
 import type { AgentTransport } from "../types/agent.ts";
 export interface ConnectOptions {
     /** 连接超时（毫秒），默认 30s */
     readonly timeoutMs?: number;
     /** 为子 Agent 提供的 LLM model（启用 Sampling 支持） */
     readonly samplingModel?: LanguageModelV4;
+    /** Sampling 调用的 provider 级参数（如 reasoning/thinking effort） */
+    readonly samplingProviderOptions?: SharedV4ProviderOptions;
     /** 注入到 stdio 子进程的环境变量（与 process.env 合并） */
     readonly env?: Readonly<Record<string, string>>;
 }
@@ -28,6 +30,8 @@ export declare class McpClientManager {
      * @param cwd 仅 stdio 模式使用，作为子进程工作目录
      */
     connect(agentName: string, transport: AgentTransport, cwd: string, options?: ConnectOptions): Promise<Client>;
+    /** 更新全部已连接 Agent 后续 Sampling 请求使用的 provider 参数。 */
+    setSamplingProviderOptions(providerOptions: SharedV4ProviderOptions | undefined): void;
     /** 断开指定 Agent 的连接 */
     disconnect(agentName: string): Promise<void>;
     /** 断开所有连接 */

package/dist/mcp/client-manager.js

@@ -1 +1 @@
-import{Client as n}from"@modelcontextprotocol/sdk/client/index.js";import{StdioClientTransport as t}from"@modelcontextprotocol/sdk/client/stdio.js";import{StreamableHTTPClientTransport as e}from"@modelcontextprotocol/sdk/client/streamableHttp.js";import{registerSamplingHandler as o}from"./sampling-handler.js";const s=3e4,i="--disable-warning=ExperimentalWarning";export function buildStdioChildEnv(n){const t=n?{...process.env,...n}:{};return{...t,NODE_OPTIONS:r(t.NODE_OPTIONS,i),ROLL_AGENT_LOG_LEVEL:t.ROLL_AGENT_LOG_LEVEL??"warn",PYTHONUTF8:t.PYTHONUTF8??"1",PYTHONIOENCODING:t.PYTHONIOENCODING??"utf-8"}}function r(n,t){const e=n?.trim();if(!e)return t;const o=e.split(/\s+/);return o.includes("--no-warnings")||o.includes(t)?e:`${e} ${t}`}export function shouldSuppressStdioChildStderrLine(n){const t=n.trim();return t.includes("ExperimentalWarning:")||t.startsWith("(Use `node --trace-warnings")||/\[INFO\s*\]\s*\[[^\]]+\]\s*MCP Server running on stdio$/.test(t)}function c(n,e,o){const s=new t({command:n.command,args:[...n.args??[]],cwd:e,env:buildStdioChildEnv(o),stderr:"pipe"});return l(s),s}function l(n){const t=n.stderr;if(!t)return;let e="";const o=n=>{shouldSuppressStdioChildStderrLine(n)||process.stderr.write(`${n}\n`)};t.on("data",n=>{e+=n.toString();const t=e.split(/\r?\n/);e=t.pop()??"";for(const n of t)o(n)}),t.on("end",()=>{e.length>0&&(o(e),e="")})}export class McpClientManager{connections=new Map;async connect(t,i,r,l={}){const a=this.connections.get(t);if(a)return a.client;const d=l.timeoutMs??s,p=l.samplingModel?{sampling:{}}:{},m=new n({name:`roll-client-${t}`,version:"0.0.1"},{capabilities:p});l.samplingModel&&o(m,l.samplingModel);const u="streamable-http"===i.type?new e(new URL(i.endpoint)):c(i,r,l.env),h=m.connect(u);let O;const g=new Promise((n,e)=>{O=setTimeout(()=>e(new Error(`Connection to "${t}" timed out after ${d}ms`)),d)});try{await Promise.race([h,g])}catch(n){throw await m.close().catch(()=>{}),n}finally{clearTimeout(O)}return this.connections.set(t,{client:m,transportType:i.type}),m}async disconnect(n){const t=this.connections.get(n);t&&(await t.client.close(),this.connections.delete(n))}async disconnectAll(){const n=[...this.connections.keys()];await Promise.all(n.map(n=>this.disconnect(n)))}isConnected(n){return this.connections.has(n)}}
+import{Client as n}from"@modelcontextprotocol/sdk/client/index.js";import{StdioClientTransport as t}from"@modelcontextprotocol/sdk/client/stdio.js";import{StreamableHTTPClientTransport as e}from"@modelcontextprotocol/sdk/client/streamableHttp.js";import{registerSamplingHandler as o}from"./sampling-handler.js";const s=3e4,i="--disable-warning=ExperimentalWarning";export function buildStdioChildEnv(n){const t={...process.env,...n??{}};return{...t,NODE_OPTIONS:r(t.NODE_OPTIONS,i),ROLL_AGENT_LOG_LEVEL:t.ROLL_AGENT_LOG_LEVEL??"warn",PYTHONUTF8:t.PYTHONUTF8??"1",PYTHONIOENCODING:t.PYTHONIOENCODING??"utf-8"}}function r(n,t){const e=n?.trim();if(!e)return t;const o=e.split(/\s+/);return o.includes("--no-warnings")||o.includes(t)?e:`${e} ${t}`}export function shouldSuppressStdioChildStderrLine(n){const t=n.trim();return t.includes("ExperimentalWarning:")||t.startsWith("(Use `node --trace-warnings")||/\[INFO\s*\]\s*\[[^\]]+\]\s*MCP Server running on stdio$/.test(t)}function c(n,e,o){const s=new t({command:n.command,args:[...n.args??[]],cwd:e,env:buildStdioChildEnv(o),stderr:"pipe"});return l(s),s}function l(n){const t=n.stderr;if(!t)return;let e="";const o=n=>{shouldSuppressStdioChildStderrLine(n)||process.stderr.write(`${n}\n`)};t.on("data",n=>{e+=n.toString();const t=e.split(/\r?\n/);e=t.pop()??"";for(const n of t)o(n)}),t.on("end",()=>{e.length>0&&(o(e),e="")})}export class McpClientManager{connections=new Map;async connect(t,i,r,l={}){const a=this.connections.get(t);if(a)return a.client;const d=l.timeoutMs??s,p=l.samplingModel?{sampling:{}}:{},m=new n({name:`roll-client-${t}`,version:"0.0.1"},{capabilities:p}),u=l.samplingModel?o(m,l.samplingModel,l.samplingProviderOptions):void 0,g="streamable-http"===i.type?new e(new URL(i.endpoint)):c(i,r,l.env),h=m.connect(g);let O;const f=new Promise((n,e)=>{O=setTimeout(()=>e(new Error(`Connection to "${t}" timed out after ${d}ms`)),d)});try{await Promise.race([h,f])}catch(n){throw await m.close().catch(()=>{}),n}finally{clearTimeout(O)}return this.connections.set(t,{client:m,transportType:i.type,...u?{samplingController:u}:{}}),m}setSamplingProviderOptions(n){for(const t of this.connections.values())t.samplingController?.setProviderOptions(n)}async disconnect(n){const t=this.connections.get(n);t&&(await t.client.close(),this.connections.delete(n))}async disconnectAll(){const n=[...this.connections.keys()];await Promise.all(n.map(n=>this.disconnect(n)))}isConnected(n){return this.connections.has(n)}}

package/dist/mcp/sampling-handler.d.ts

@@ -1,5 +1,17 @@
 import type { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import type { LanguageModelV4 } from "@ai-sdk/provider";
+import type { ModelMessage } from "ai";
+import type { LanguageModelV4, SharedV4ProviderOptions } from "@ai-sdk/provider";
+export interface SamplingHandlerController {
+    /** 更新后续 Sampling 请求使用的 provider 参数；不影响已经发出的请求。 */
+    setProviderOptions(providerOptions: SharedV4ProviderOptions | undefined): void;
+}
+/** 组装传给 AI SDK generateText() 的调用参数（供单测复用，不依赖真实网络请求） */
+export declare function buildSamplingGenerateTextParams(model: LanguageModelV4, messages: ModelMessage[], maxTokens: number, providerOptions?: SharedV4ProviderOptions): {
+    providerOptions?: SharedV4ProviderOptions;
+    maxOutputTokens?: number;
+    model: LanguageModelV4;
+    messages: ModelMessage[];
+};
 /**
  * 在 MCP Client 上注册 Sampling Handler。
  *
@@ -8,4 +20,4 @@ import type { LanguageModelV4 } from "@ai-sdk/provider";
  *
  * @see https://spec.modelcontextprotocol.io/specification/client/sampling/
  */
-export declare function registerSamplingHandler(client: Client, model: LanguageModelV4): void;
+export declare function registerSamplingHandler(client: Client, model: LanguageModelV4, providerOptions?: SharedV4ProviderOptions): SamplingHandlerController;

package/dist/mcp/sampling-handler.js

@@ -1 +1 @@
-import{CreateMessageRequestSchema as t}from"@modelcontextprotocol/sdk/types.js";import{generateText as e}from"ai";export function registerSamplingHandler(o,s){o.setRequestHandler(t,async t=>{const o=n(t.params.messages),r=t.params.maxTokens;let a;try{a=await e({model:s,messages:o,...r>0?{maxOutputTokens:r}:{}})}catch(t){throw new Error("Sampling handler: LLM generation failed",{cause:t})}return{role:"assistant",content:{type:"text",text:a.text},model:a.response.modelId,..."length"===a.finishReason?{stopReason:"maxTokens"}:{stopReason:"endTurn"}}})}function n(t){return t.map(t=>{const e=o(t.content);return"assistant"===t.role?{role:"assistant",content:[{type:"text",text:e}]}:{role:"user",content:[{type:"text",text:e}]}})}function o(t){if("string"==typeof t)return t;if("object"==typeof t&&null!==t&&"type"in t){const e=t;if("text"===e.type&&"string"==typeof e.text)return e.text}return JSON.stringify(t)}
+import{CreateMessageRequestSchema as t}from"@modelcontextprotocol/sdk/types.js";import{generateText as e}from"ai";export function buildSamplingGenerateTextParams(t,e,n,r){return{model:t,messages:e,...n>0?{maxOutputTokens:n}:{},...r?{providerOptions:r}:{}}}export function registerSamplingHandler(r,o,s){let a=s;return r.setRequestHandler(t,async t=>{const r=n(t.params.messages),s=t.params.maxTokens;let i;try{i=await e(buildSamplingGenerateTextParams(o,r,s,a))}catch(t){throw new Error("Sampling handler: LLM generation failed",{cause:t})}return{role:"assistant",content:{type:"text",text:i.text},model:i.response.modelId,..."length"===i.finishReason?{stopReason:"maxTokens"}:{stopReason:"endTurn"}}}),{setProviderOptions(t){a=t}}}function n(t){return t.map(t=>{const e=r(t.content);return"assistant"===t.role?{role:"assistant",content:[{type:"text",text:e}]}:{role:"user",content:[{type:"text",text:e}]}})}function r(t){if("string"==typeof t)return t;if("object"==typeof t&&null!==t&&"type"in t){const e=t;if("text"===e.type&&"string"==typeof e.text)return e.text}return JSON.stringify(t)}