@roll-agent/core 0.10.1 → 0.11.0

package/bin/roll.js

@@ -1,2 +1,40 @@
 #!/usr/bin/env node
-import "../dist/cli/index.js";
+import { spawnSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+async function sqliteAvailable() {
+  try {
+    await import("node:sqlite");
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function sourceTreeAvailable() {
+  return existsSync(resolve(dirname(fileURLToPath(import.meta.url)), "../src/cli/index.ts"));
+}
+
+function hasExecFlag(flag) {
+  return process.execArgv.includes(flag);
+}
+
+const needsSqliteFlag = !(await sqliteAvailable());
+const needsTypeStripFlag = sourceTreeAvailable() && !hasExecFlag("--experimental-strip-types");
+
+if (!process.env.ROLL_SQLITE_RESPAWNED && (needsSqliteFlag || needsTypeStripFlag)) {
+  const nodeFlags = [
+    ...(needsSqliteFlag ? ["--experimental-sqlite"] : []),
+    ...(needsTypeStripFlag ? ["--experimental-strip-types"] : []),
+  ];
+  const result = spawnSync(
+    process.execPath,
+    [...nodeFlags, process.argv[1], ...process.argv.slice(2)],
+    { stdio: "inherit", env: { ...process.env, ROLL_SQLITE_RESPAWNED: "1" } },
+  );
+  process.exit(result.status ?? 0);
+}
+
+await import("../dist/cli/index.js");

package/dist/cli/commands/chat.d.ts

@@ -1,3 +1,6 @@
+import type { AgentSession } from "@roll-agent/runtime";
+import type { ChatCommandResult } from "../../types/chat.ts";
+export declare function runJsonTurn(session: AgentSession, message: string): Promise<ChatCommandResult>;
 declare const _default: import("citty").CommandDef<{
     message: {
         type: "positional";
@@ -8,10 +11,25 @@ declare const _default: import("citty").CommandDef<{
         type: "string";
         description: string;
     };
+    last: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
+    list: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
     json: {
         type: "boolean";
         description: string;
         default: false;
     };
+    server: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
 }>;
 export default _default;

package/dist/cli/commands/chat.js

@@ -1 +1 @@
-import{defineCommand as s}from"citty";import{log as e}from"../utils/output.js";const t="roll chat 仍处于 experimental 阶段，当前只提供命令骨架，不会执行会话编排、不会恢复 session，也不会隐式降级到 roll ask。";function o(){return{status:"unavailable",message:t}}function n(s){console.log(JSON.stringify(s,null,2))}export default s({meta:{description:"Experimental: 会话式入口骨架（当前不可用）"},args:{message:{type:"positional",description:"起始消息",required:!1},session:{type:"string",description:"继续已有会话的 session ID"},json:{type:"boolean",description:"JSON 格式输出",default:!1}},async run({args:s}){const t=o();s.json?n(t):e.warn(t.message),process.exitCode=1}});
+import{defineCommand as e}from"citty";import{loadConfig as s}from"../../config/loader.js";import{createProviderModel as t}from"../../llm/providers.js";import{createInterface as o}from"node:readline/promises";import r from"chalk";import i from"cli-table3";import{log as n}from"../utils/output.js";import{ChatRenderer as a,clackConfirm as l}from"../utils/chat-renderer.js";function c(e,s){return new e.ConfigurableToolPolicy({defaultMode:s.runtime.approval.default,overrides:s.runtime.approval.overrides})}function d(e){const s=e.trim().replace(/\s+/g," ");return s.length>40?`${s.slice(0,39)}…`:s}function u(e){console.log(JSON.stringify(e,null,2))}function m(e){n.warn(`Agent "${e.agentName}" 启动失败：${e.message}`)}async function p(){return import("@roll-agent/runtime")}async function f(e){const s=e.runtime.provider??e.llm.defaultProvider,o=e.runtime.model??e.llm.defaultModel,r=e.llm.providers[s];if(!r)return n.error(`LLM provider "${s}" 未配置。请检查 roll.config.yaml`),void(process.exitCode=1);const i=await p(),{ConversationEngine:a,ThreadStore:l,RuntimeServer:d,createStdioConnection:u}=i,f=t(s,o,r.apiKey,r.baseUrl),g=new l(e.runtime.threadsDir),y=new a({config:e,model:f,store:g,policy:c(i,e),maxSteps:e.runtime.maxSteps,onAgentBootstrapIssue:m}),h=u(process.stdin,process.stdout),w=new d(y,h);h.onClose(()=>{w.abortAll(),y.dispose().catch(()=>{}).finally(()=>{g.close(),process.exit(0)})}),n.info("roll runtime-server 已启动（stdio JSON-RPC，等待客户端连接）")}async function g(e,s){const{ThreadStore:t}=await p(),o=new t(e.runtime.threadsDir);try{const e=o.listThreads();if(s){const s=e.map(e=>({...e,messageCount:o.countMessages(e.id)}));return void console.log(JSON.stringify(s,null,2))}if(0===e.length)return void console.log('暂无会话。用 `roll chat "<message>"` 开始一个。');const t=new i({head:["Session ID","标题","消息","更新时间"],style:{head:["cyan"]}});for(const s of e)t.push([s.id,s.title??"-",String(o.countMessages(s.id)),s.updatedAt]);console.log(t.toString())}finally{o.close()}}export async function runJsonTurn(e,s){const t=[],o=[],r=[];let i,n,a="";for await(const l of e.send(s))switch(l.type){case"text-delta":a+=l.delta;break;case"tool-call":t.push({summary:`${l.agentName}.${l.toolName}`,agentName:l.agentName,toolName:l.toolName});break;case"confirmation-required":r.push({summary:`${l.agentName}.${l.toolName}`,agentName:l.agentName,toolName:l.toolName}),e.reject(l.approvalId,"json 模式不支持交互确认");break;case"step-finish":o.push({finishReason:l.finishReason,...l.usage?{usage:l.usage}:{}});break;case"message-finish":n=l.totalUsage;break;case"error":i=l.message}return void 0!==i?{status:"failed",stage:"execute",message:i,sessionId:e.id}:r.length>0?{status:"needs_confirmation",sessionId:e.id,message:"存在需要确认的工具调用，请在交互模式下执行或显式批准",pendingActions:r}:{status:"completed",sessionId:e.id,output:a,steps:t,...o.length>0?{stepUsages:o}:{},...n?{totalUsage:n}:{}}}async function y(e,s,t){const i=o({input:process.stdin,output:process.stdout});i.on("SIGINT",()=>i.close());const l=new a(async e=>{const s=(await i.question(`${e} (y/N) `)).trim().toLowerCase();return"y"===s||"yes"===s});n.info("进入多轮对话（输入 exit / quit 或 Ctrl-C 退出）");let c=!t,u=!1;try{for(;;){let t;try{t=(await i.question(r.green("› "))).trim()}catch{break}if(0!==t.length){if("exit"===t||"quit"===t)break;c||(s.updateTitle(e.id,d(t)),c=!0),u=!0;for await(const s of e.send(t))await l.handle(s,e)}}}finally{i.close(),t&&!u&&0===s.countMessages(e.id)&&s.deleteThread(e.id)}}export default e({meta:{description:"会话式 AI 助手（多轮对话 + 自动工具调用）"},args:{message:{type:"positional",description:"起始消息",required:!1},session:{type:"string",description:"继续已有会话的 session ID"},last:{type:"boolean",description:"继续最近一个会话",default:!1},list:{type:"boolean",description:"列出已有会话",default:!1},json:{type:"boolean",description:"JSON 格式输出",default:!1},server:{type:"boolean",description:"以 JSON-RPC daemon 模式运行（stdio，供 GUI/前端接入）",default:!1}},async run({args:e}){const{config:o}=s();if(e.server)return void await f(o);if(e.list)return void await g(o,e.json);const r=o.runtime.provider??o.llm.defaultProvider,i=o.runtime.model??o.llm.defaultModel,h=o.llm.providers[r];if(!h)return n.error(`LLM provider "${r}" 未配置。请检查 roll.config.yaml`),void(process.exitCode=1);if(e.json&&!e.message)return n.error('--json 模式需要消息：roll chat "<message>" --json'),void(process.exitCode=1);const w=await p(),{ConversationEngine:v,ThreadStore:S}=w,N=t(r,i,h.apiKey,h.baseUrl),x=new S(o.runtime.threadsDir),C=new v({config:o,model:N,store:x,policy:c(w,o),maxSteps:o.runtime.maxSteps,onAgentBootstrapIssue:m});try{let s;if(e.session)s=await C.resumeSession(e.session);else if(e.last){const e=x.listThreads()[0];if(!e)return n.error('暂无可继续的会话，先用 `roll chat "<message>"` 开始一个'),void(process.exitCode=1);s=await C.resumeSession(e.id)}else s=await C.createSession(e.message?{title:d(e.message)}:{});if(e.json&&e.message){const t=await runJsonTurn(s,e.message);return u(t),void("completed"!==t.status&&(process.exitCode=1))}if(n.info(`会话 ${s.id}`),e.message){const t=new a(l);for await(const o of s.send(e.message))await t.handle(o,s)}else await y(s,x,!e.session&&!e.last)}catch(e){n.error(e instanceof Error?e.message:String(e)),process.exitCode=1}finally{await C.dispose(),x.close()}}});

package/dist/cli/commands/config-guidance.d.ts

@@ -88,6 +88,18 @@ export declare const CONFIG_GUIDANCE_ENTRIES: readonly [{
     readonly purpose: "`roll ask` 路由置信度低于该阈值时，倾向要求用户确认。";
     readonly defaultBehavior: "未配置时使用内置路由默认行为。";
     readonly example: "ask:\n  confirm-threshold: 0.5";
+}, {
+    readonly path: "runtime.approval.default";
+    readonly title: "Chat 工具确认默认策略";
+    readonly purpose: "`roll chat` 调用工具时的默认确认策略。`guarded` 使用内置读写启发式，`auto` 默认放行非破坏性工具，`deny` 默认拒绝。";
+    readonly defaultBehavior: "默认值为 `guarded`。此配置不影响 `roll ask`。" | "默认值为 `auto`。此配置不影响 `roll ask`。" | "默认值为 `deny`。此配置不影响 `roll ask`。";
+    readonly example: "runtime:\n  approval:\n    default: guarded" | "runtime:\n  approval:\n    default: auto" | "runtime:\n  approval:\n    default: deny";
+}, {
+    readonly path: "runtime.approval.overrides";
+    readonly title: "Chat 工具确认精确覆盖";
+    readonly purpose: "`roll chat` 按完整 `agentName.toolName` 覆盖单个工具的确认策略。可选值为 `auto`、`confirm`、`deny`。";
+    readonly defaultBehavior: "未配置时回退到 `runtime.approval.default`。";
+    readonly example: "runtime:\n  approval:\n    overrides:\n      browser-use-agent.zhipin_send_prepared_reply: confirm\n      browser-use-agent.browser_status: auto";
 }, {
     readonly path: "browser.default-instance";
     readonly title: "默认浏览器实例";

package/dist/cli/commands/config-guidance.js

@@ -1 +1 @@
-import{DEFAULT_CONFIG as e}from"../../config/defaults.js";import{normalizeUserPath as t}from"../../config/key-codec.js";export const INSTALL_SCENARIOS=["default-network","china-dev","private-registry","advanced"];export const CONFIG_GUIDANCE_ENTRIES=[{path:"llm.default-provider",title:"默认 LLM Provider",purpose:"`roll ask` / `roll chat` 默认使用的模型提供商。",defaultBehavior:`默认值为 \`${e.llm.defaultProvider}\`。`,example:`llm:\n  default-provider: ${e.llm.defaultProvider}`,setupCommand:"roll config setup llm"},{path:"llm.default-model",title:"默认 LLM Model",purpose:"`roll ask` / `roll chat` 默认使用的模型名称。",defaultBehavior:`默认值为 \`${e.llm.defaultModel}\`。`,example:`llm:\n  default-model: ${e.llm.defaultModel}`,setupCommand:"roll config setup llm"},{path:"llm.providers.<provider>.api-key",title:"Provider API Key",purpose:"指定 LLM provider 的 API key。可以写真实 key，也可以写 `${ENV_VAR}` 占位符。",example:"llm:\n  providers:\n    anthropic:\n      api-key: ${ANTHROPIC_API_KEY}",setupCommand:"roll config setup llm"},{path:"llm.providers.<provider>.base-url",title:"Provider Base URL",purpose:"指定 LLM provider 的自定义 API base URL，通常只在代理、兼容网关或私有部署时需要。",defaultBehavior:"不配置时使用 provider SDK 默认地址。",example:"llm:\n  providers:\n    openai:\n      base-url: https://api.openai.com/v1",setupCommand:"roll config setup llm"},{path:"install.registry",title:"npm Registry",purpose:"`roll agent install` / `roll update` 查询和安装 npm 包时使用的 registry。",defaultBehavior:"不配置时走 npm 自身默认源；Roll 不做隐式镜像 fallback。",example:"install:\n  registry: https://registry.npmmirror.com",setupCommand:"roll config setup install"},{path:"install.fetch-retries",title:"npm Fetch Retries",purpose:"透传给 npm 的 `--fetch-retries`，同时影响 Roll 层整体网络重试次数。",defaultBehavior:`默认值为 \`${e.install.fetchRetries}\`。`,example:`install:\n  fetch-retries: ${e.install.fetchRetries}`,setupCommand:"roll config setup install"},{path:"install.prefer-offline",title:"Prefer Offline",purpose:"安装时是否附加 `--prefer-offline`。",defaultBehavior:`默认值为 \`${e.install.preferOffline}\`，避免更新时复用过期 npm 元数据。`,example:`install:\n  prefer-offline: ${e.install.preferOffline}`,setupCommand:"roll config setup install"},{path:"install.network-timeout-ms",title:"Install Network Timeout",purpose:"单次 npm install 命令的超时时间，单位毫秒。",defaultBehavior:`默认值为 \`${e.install.networkTimeoutMs}\`，即 120 秒。`,example:`install:\n  network-timeout-ms: ${e.install.networkTimeoutMs}`,setupCommand:"roll config setup install"},{path:"agents.data-dir",title:"Agent 数据目录",purpose:"Roll 持久化已注册 Agent、PID、日志和 runtime sidecar 的目录。",defaultBehavior:`默认值为 \`${e.agents.dataDir}\`。`,example:`agents:\n  data-dir: ${e.agents.dataDir}`},{path:"agents.env.<agent-name>",title:"Agent 环境变量",purpose:"按 Agent 名称声明注入到子 Agent 进程的环境变量。",defaultBehavior:"未配置时只会继承当前 shell 环境变量；core-managed Agent 需要重启才会看到新值。",example:"agents:\n  env:\n    browser-use-agent:\n      REPLY_AUTHORITY_URL: https://example.com",setupCommand:"roll config setup agent <agent-name>"},{path:"ask.confirm-threshold",title:"Ask 确认阈值",purpose:"`roll ask` 路由置信度低于该阈值时，倾向要求用户确认。",defaultBehavior:"未配置时使用内置路由默认行为。",example:"ask:\n  confirm-threshold: 0.5"},{path:"browser.default-instance",title:"默认浏览器实例",purpose:"多浏览器实例配置下，未显式指定 browserInstance 时使用的默认实例。",defaultBehavior:"不配置且只有一个实例时可自动推断；多个实例时工具可能返回 needs_input。",example:"browser:\n  default-instance: boss-a"},{path:"browser.instances",title:"浏览器实例声明",purpose:"声明 browser-use-agent 可使用的浏览器 profile、CDP 端口、会话目录和业务归因信息。",defaultBehavior:"不配置时 browser-use-agent 使用 legacy 单实例环境变量路径。",example:"browser:\n  instances:\n    boss-a:\n      platform: zhipin\n      mode: managed-cdp\n      cdp-port: 9222\n      user-data-dir: ~/.roll-agent/browser/boss-a"}];export function listConfigGuidanceEntries(){return CONFIG_GUIDANCE_ENTRIES}export function findConfigGuidance(e){const r=t(e.split(".")).join(".");return CONFIG_GUIDANCE_ENTRIES.find(e=>l(e.path,r))}function l(e,l){const r=t(e.split(".")).join(".");if(r===l)return!0;const a=r.split("."),n=l.split(".");return a.length===n.length&&a.every((e,t)=>e.startsWith("<")||e===n[t])}export function flattenAgentEnvDeclarations(e){return[...(e?.required??[]).map(e=>({...e,required:!0})),...(e?.optional??[]).map(e=>({...e,required:!1}))]}export function isSecretEnvName(e){return/(?:TOKEN|KEY|SECRET|PASSWORD)/iu.test(e)}
+import{DEFAULT_CONFIG as e}from"../../config/defaults.js";import{normalizeUserPath as t}from"../../config/key-codec.js";export const INSTALL_SCENARIOS=["default-network","china-dev","private-registry","advanced"];export const CONFIG_GUIDANCE_ENTRIES=[{path:"llm.default-provider",title:"默认 LLM Provider",purpose:"`roll ask` / `roll chat` 默认使用的模型提供商。",defaultBehavior:`默认值为 \`${e.llm.defaultProvider}\`。`,example:`llm:\n  default-provider: ${e.llm.defaultProvider}`,setupCommand:"roll config setup llm"},{path:"llm.default-model",title:"默认 LLM Model",purpose:"`roll ask` / `roll chat` 默认使用的模型名称。",defaultBehavior:`默认值为 \`${e.llm.defaultModel}\`。`,example:`llm:\n  default-model: ${e.llm.defaultModel}`,setupCommand:"roll config setup llm"},{path:"llm.providers.<provider>.api-key",title:"Provider API Key",purpose:"指定 LLM provider 的 API key。可以写真实 key，也可以写 `${ENV_VAR}` 占位符。",example:"llm:\n  providers:\n    anthropic:\n      api-key: ${ANTHROPIC_API_KEY}",setupCommand:"roll config setup llm"},{path:"llm.providers.<provider>.base-url",title:"Provider Base URL",purpose:"指定 LLM provider 的自定义 API base URL，通常只在代理、兼容网关或私有部署时需要。",defaultBehavior:"不配置时使用 provider SDK 默认地址。",example:"llm:\n  providers:\n    openai:\n      base-url: https://api.openai.com/v1",setupCommand:"roll config setup llm"},{path:"install.registry",title:"npm Registry",purpose:"`roll agent install` / `roll update` 查询和安装 npm 包时使用的 registry。",defaultBehavior:"不配置时走 npm 自身默认源；Roll 不做隐式镜像 fallback。",example:"install:\n  registry: https://registry.npmmirror.com",setupCommand:"roll config setup install"},{path:"install.fetch-retries",title:"npm Fetch Retries",purpose:"透传给 npm 的 `--fetch-retries`，同时影响 Roll 层整体网络重试次数。",defaultBehavior:`默认值为 \`${e.install.fetchRetries}\`。`,example:`install:\n  fetch-retries: ${e.install.fetchRetries}`,setupCommand:"roll config setup install"},{path:"install.prefer-offline",title:"Prefer Offline",purpose:"安装时是否附加 `--prefer-offline`。",defaultBehavior:`默认值为 \`${e.install.preferOffline}\`，避免更新时复用过期 npm 元数据。`,example:`install:\n  prefer-offline: ${e.install.preferOffline}`,setupCommand:"roll config setup install"},{path:"install.network-timeout-ms",title:"Install Network Timeout",purpose:"单次 npm install 命令的超时时间，单位毫秒。",defaultBehavior:`默认值为 \`${e.install.networkTimeoutMs}\`，即 120 秒。`,example:`install:\n  network-timeout-ms: ${e.install.networkTimeoutMs}`,setupCommand:"roll config setup install"},{path:"agents.data-dir",title:"Agent 数据目录",purpose:"Roll 持久化已注册 Agent、PID、日志和 runtime sidecar 的目录。",defaultBehavior:`默认值为 \`${e.agents.dataDir}\`。`,example:`agents:\n  data-dir: ${e.agents.dataDir}`},{path:"agents.env.<agent-name>",title:"Agent 环境变量",purpose:"按 Agent 名称声明注入到子 Agent 进程的环境变量。",defaultBehavior:"未配置时只会继承当前 shell 环境变量；core-managed Agent 需要重启才会看到新值。",example:"agents:\n  env:\n    browser-use-agent:\n      REPLY_AUTHORITY_URL: https://example.com",setupCommand:"roll config setup agent <agent-name>"},{path:"ask.confirm-threshold",title:"Ask 确认阈值",purpose:"`roll ask` 路由置信度低于该阈值时，倾向要求用户确认。",defaultBehavior:"未配置时使用内置路由默认行为。",example:"ask:\n  confirm-threshold: 0.5"},{path:"runtime.approval.default",title:"Chat 工具确认默认策略",purpose:"`roll chat` 调用工具时的默认确认策略。`guarded` 使用内置读写启发式，`auto` 默认放行非破坏性工具，`deny` 默认拒绝。",defaultBehavior:`默认值为 \`${e.runtime.approval.default}\`。此配置不影响 \`roll ask\`。`,example:`runtime:\n  approval:\n    default: ${e.runtime.approval.default}`},{path:"runtime.approval.overrides",title:"Chat 工具确认精确覆盖",purpose:"`roll chat` 按完整 `agentName.toolName` 覆盖单个工具的确认策略。可选值为 `auto`、`confirm`、`deny`。",defaultBehavior:"未配置时回退到 `runtime.approval.default`。",example:"runtime:\n  approval:\n    overrides:\n      browser-use-agent.zhipin_send_prepared_reply: confirm\n      browser-use-agent.browser_status: auto"},{path:"browser.default-instance",title:"默认浏览器实例",purpose:"多浏览器实例配置下，未显式指定 browserInstance 时使用的默认实例。",defaultBehavior:"不配置且只有一个实例时可自动推断；多个实例时工具可能返回 needs_input。",example:"browser:\n  default-instance: boss-a"},{path:"browser.instances",title:"浏览器实例声明",purpose:"声明 browser-use-agent 可使用的浏览器 profile、CDP 端口、会话目录和业务归因信息。",defaultBehavior:"不配置时 browser-use-agent 使用 legacy 单实例环境变量路径。",example:"browser:\n  instances:\n    boss-a:\n      platform: zhipin\n      mode: managed-cdp\n      cdp-port: 9222\n      user-data-dir: ~/.roll-agent/browser/boss-a"}];export function listConfigGuidanceEntries(){return CONFIG_GUIDANCE_ENTRIES}export function findConfigGuidance(e){const r=t(e.split(".")).join(".");return CONFIG_GUIDANCE_ENTRIES.find(e=>l(e.path,r))}function l(e,l){const r=t(e.split(".")).join(".");if(r===l)return!0;const a=r.split("."),n=l.split(".");return a.length===n.length&&a.every((e,t)=>e.startsWith("<")||e===n[t])}export function flattenAgentEnvDeclarations(e){return[...(e?.required??[]).map(e=>({...e,required:!0})),...(e?.optional??[]).map(e=>({...e,required:!1}))]}export function isSecretEnvName(e){return/(?:TOKEN|KEY|SECRET|PASSWORD)/iu.test(e)}

package/dist/cli/utils/chat-renderer.d.ts

@@ -0,0 +1,15 @@
+import type { SessionEvent } from "@roll-agent/runtime";
+export interface ChatApprover {
+    approve(approvalId: string): void;
+    reject(approvalId: string, reason?: string): void;
+}
+export type ChatConfirm = (message: string) => Promise<boolean>;
+export declare const clackConfirm: ChatConfirm;
+export declare class ChatRenderer {
+    private readonly confirm;
+    private readonly spinners;
+    private streaming;
+    constructor(confirm: ChatConfirm);
+    handle(event: SessionEvent, approver: ChatApprover): Promise<void>;
+    private flushLine;
+}

package/dist/cli/utils/chat-renderer.js

@@ -0,0 +1 @@
+import t from"chalk";import{confirm as s,isCancel as e}from"@clack/prompts";import{createSpinner as o,log as n,redactToolArgsForLog as r}from"./output.js";export const clackConfirm=async t=>{const o=await s({message:t});return!e(o)&&!0===o};function a(t){const s=JSON.stringify(r(t));return s.length>80?`${s.slice(0,79)}…`:s}function i(t){const s=[];return void 0!==t.inputTokens&&s.push(`in ${String(t.inputTokens)}`),void 0!==t.outputTokens&&s.push(`out ${String(t.outputTokens)}`),void 0!==t.totalTokens&&s.push(`total ${String(t.totalTokens)}`),s.join(" · ")}export class ChatRenderer{confirm;spinners=new Map;streaming=!1;constructor(t){this.confirm=t}async handle(s,e){switch(s.type){case"text-delta":process.stdout.write(s.delta),this.streaming=!0;break;case"tool-call":{this.flushLine();const e=o(`${t.cyan(`${s.agentName}.${s.toolName}`)} ${t.gray(a(s.input))}`);e.start(),this.spinners.set(s.toolCallId,e);break}case"tool-result":{const t=this.spinners.get(s.toolCallId);t&&(s.isError?t.fail():t.succeed(),this.spinners.delete(s.toolCallId));break}case"confirmation-required":{this.flushLine();const t=s.reason?`（${s.reason}）`:"";await this.confirm(`执行 ${s.agentName}.${s.toolName}${t}?`)?e.approve(s.approvalId):e.reject(s.approvalId,"用户取消");break}case"error":this.flushLine(),n.error(s.message);break;case"message-finish":this.flushLine(),s.totalUsage&&n.debug(`tokens: ${i(s.totalUsage)}`)}}flushLine(){this.streaming&&(process.stdout.write("\n"),this.streaming=!1)}}

package/dist/config/defaults.js

@@ -1 +1 @@
-export const LLM_PROVIDER_OPTIONS=["anthropic","openai","qwen","deepseek"];export const DEFAULT_LLM_PROVIDER="anthropic";export const DEFAULT_LLM_MODELS={anthropic:"claude-sonnet-4-6",openai:"gpt-5.5",qwen:"qwen3.6-plus",deepseek:"deepseek-v4-flash"};export const DEFAULT_CONFIG={llm:{defaultProvider:"anthropic",defaultModel:DEFAULT_LLM_MODELS.anthropic,providers:{}},ask:{},agents:{dataDir:"~/.roll-agent/agents"},install:{fetchRetries:3,preferOffline:!1,networkTimeoutMs:12e4},browser:{instances:{}}};export const CONFIG_FILE_NAMES=["roll.config.yaml","roll.config.yml"];
+export const LLM_PROVIDER_OPTIONS=["anthropic","openai","qwen","deepseek"];export const DEFAULT_LLM_PROVIDER="anthropic";export const DEFAULT_LLM_MODELS={anthropic:"claude-sonnet-4-6",openai:"gpt-5.5",qwen:"qwen3.6-plus",deepseek:"deepseek-v4-flash"};export const DEFAULT_CONFIG={llm:{defaultProvider:"anthropic",defaultModel:DEFAULT_LLM_MODELS.anthropic,providers:{}},ask:{},runtime:{maxSteps:16,threadsDir:"~/.roll-agent/threads",approval:{default:"guarded",overrides:{}}},agents:{dataDir:"~/.roll-agent/agents"},install:{fetchRetries:3,preferOffline:!1,networkTimeoutMs:12e4},browser:{instances:{}}};export const CONFIG_FILE_NAMES=["roll.config.yaml","roll.config.yml"];

package/dist/config/key-codec.js

@@ -1 +1 @@
-const e={kind:"leaf"},r={kind:"object",fields:{apiKey:e,baseUrl:e}},o={kind:"object",fields:{platform:e,mode:e,headless:e,cdpUrl:e,cdpHost:e,cdpPort:e,channel:e,executablePath:e,userDataDir:e,sessionsDir:e,args:e,profileName:e,profileColor:e,windowBounds:{kind:"object",fields:{x:e,y:e,width:e,height:e}},trackingAgentId:e}};export const CONFIG_KEY_CODEC={kind:"object",fields:{llm:{kind:"object",fields:{defaultProvider:e,defaultModel:e,providers:{kind:"record",value:r}}},ask:{kind:"object",fields:{llmModel:e,confirmThreshold:e}},agents:{kind:"object",fields:{dataDir:e,env:{kind:"record",value:{kind:"record",value:e}}}},install:{kind:"object",fields:{registry:e,fetchRetries:e,preferOffline:e,networkTimeoutMs:e}},browser:{kind:"object",fields:{defaultInstance:e,instances:{kind:"record",value:o}}}}};export function kebabToCamel(e){return e.replace(/-([a-z])/g,(e,r)=>r.toUpperCase())}export function camelToKebab(e){return e.replace(/[A-Z]/g,e=>`-${e.toLowerCase()}`)}function t(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}export function decodeFromYaml(r,o=CONFIG_KEY_CODEC){if(Array.isArray(r))return r.map(e=>decodeFromYaml(e,o));if(!t(r))return r;if("object"===o.kind){const t={};for(const[n,i]of Object.entries(r)){const r=kebabToCamel(n),d=o.fields[r]??e;t[r]=decodeFromYaml(i,d)}return t}if("record"===o.kind){const e={};for(const[t,n]of Object.entries(r))e[t]=decodeFromYaml(n,o.value);return e}return r}function n(r,o){const t=[];let n=CONFIG_KEY_CODEC;for(const i of r)if("object"===n.kind){const r=kebabToCamel(i),d=n.fields[r];d?(t.push("camel"===o?r:camelToKebab(r)),n=d):(t.push(i),n=e)}else"record"===n.kind?(t.push(i),n=n.value):t.push(i);return t}export function encodePathToYaml(e){return n(e,"kebab")}export function normalizeUserPath(e){return n(e,"camel")}
+const e={kind:"leaf"},r={kind:"object",fields:{apiKey:e,baseUrl:e}},o={kind:"object",fields:{platform:e,mode:e,headless:e,cdpUrl:e,cdpHost:e,cdpPort:e,channel:e,executablePath:e,userDataDir:e,sessionsDir:e,args:e,profileName:e,profileColor:e,windowBounds:{kind:"object",fields:{x:e,y:e,width:e,height:e}},trackingAgentId:e}};export const CONFIG_KEY_CODEC={kind:"object",fields:{llm:{kind:"object",fields:{defaultProvider:e,defaultModel:e,providers:{kind:"record",value:r}}},ask:{kind:"object",fields:{llmModel:e,confirmThreshold:e}},runtime:{kind:"object",fields:{provider:e,model:e,maxSteps:e,threadsDir:e,approval:{kind:"object",fields:{default:e,overrides:{kind:"record",value:e}}}}},agents:{kind:"object",fields:{dataDir:e,env:{kind:"record",value:{kind:"record",value:e}}}},install:{kind:"object",fields:{registry:e,fetchRetries:e,preferOffline:e,networkTimeoutMs:e}},browser:{kind:"object",fields:{defaultInstance:e,instances:{kind:"record",value:o}}}}};export function kebabToCamel(e){return e.replace(/-([a-z])/g,(e,r)=>r.toUpperCase())}export function camelToKebab(e){return e.replace(/[A-Z]/g,e=>`-${e.toLowerCase()}`)}function t(e){return"object"==typeof e&&null!==e&&!Array.isArray(e)}export function decodeFromYaml(r,o=CONFIG_KEY_CODEC){if(Array.isArray(r))return r.map(e=>decodeFromYaml(e,o));if(!t(r))return r;if("object"===o.kind){const t={};for(const[n,i]of Object.entries(r)){const r=kebabToCamel(n),d=o.fields[r]??e;t[r]=decodeFromYaml(i,d)}return t}if("record"===o.kind){const e={};for(const[t,n]of Object.entries(r))e[t]=decodeFromYaml(n,o.value);return e}return r}function n(r,o){const t=[];let n=CONFIG_KEY_CODEC;for(const i of r)if("object"===n.kind){const r=kebabToCamel(i),d=n.fields[r];d?(t.push("camel"===o?r:camelToKebab(r)),n=d):(t.push(i),n=e)}else"record"===n.kind?(t.push(i),n=n.value):t.push(i);return t}export function encodePathToYaml(e){return n(e,"kebab")}export function normalizeUserPath(e){return n(e,"camel")}

package/dist/config/loader.js

@@ -1 +1 @@
-import{readFileSync as n,existsSync as r}from"node:fs";import{resolve as t}from"node:path";import{parse as o}from"yaml";import{agentsConfigSchema as e,installConfigSchema as i,rollConfigSchema as s}from"./schema.js";import{DEFAULT_CONFIG as a,CONFIG_FILE_NAMES as f}from"./defaults.js";import{decodeFromYaml as c}from"./key-codec.js";import{detectKnownConfigMigrations as u,formatConfigMigrationError as l}from"./migration.js";function g(n){if("string"==typeof n)return n.replace(/\$\{([^}]+)\}/g,(n,r)=>process.env[r]??n);if(Array.isArray(n))return n.map(g);if(d(n)){const r={};for(const[t,o]of Object.entries(n))r[t]=g(o);return r}return n}function d(n){return"object"==typeof n&&null!==n&&!Array.isArray(n)}function p(n){return d(n)&&"number"==typeof n.line&&"number"==typeof n.col}function h(n){return n instanceof Error&&"linePos"in n&&Array.isArray(n.linePos)&&n.linePos.length>0&&n.linePos.every(p)}function m(n,r){const t=`Invalid YAML syntax in config file: ${n}`;if(!(r instanceof Error))return`${t}\n${String(r)}`;if(h(r)){const[n]=r.linePos;if(n)return`${t} at line ${n.line}, column ${n.col}\n${r.message}`}return`${t}\n${r.message}`}function w(n){let o=t(n);const e=t("/");for(;o!==e;){for(const n of f){const e=t(o,n);if(r(e))return e}const n=t(o,"..");if(n===o)break;o=n}}function v(n){if(n.startsWith("~/")){const r=process.env.HOME??process.env.USERPROFILE??"";return t(r,n.slice(2))}return n}function $(n){return{...n,agents:{...n.agents,dataDir:v(n.agents.dataDir)},browser:{...n.browser,instances:Object.fromEntries(Object.entries(n.browser.instances).map(([n,r])=>[n,{...r,userDataDir:v(r.userDataDir),...void 0!==r.sessionsDir?{sessionsDir:v(r.sessionsDir)}:{}}]))}}}const C={notFound:"not-found",valid:"valid",needsMigration:"needs-migration",invalid:"invalid"};export function parseConfigDocument(n,r){let t;try{t=o(n)}catch(n){throw new Error(m(r,n),{cause:n instanceof Error?n:void 0})}if(!d(t))throw new Error(`Invalid config file: ${r} (expected YAML object)`);return t}function P(n,r,t={}){const o=parseConfigDocument(n,r),e=u(o,t);if(e.needsMigration)throw new Error(l(r,e));return o}export function validateConfigText(n,r){const t=P(n,r),o=g(c(t));if(!d(o))throw new Error(`Invalid config file: ${r} (expected YAML object)`);const e=j(a,o),i=s.safeParse(e);if(!i.success){const n=i.error.issues.map(n=>`  - ${n.path.join(".")}: ${n.message}`).join("\n");throw new Error(`Config validation failed (${r}):\n${n}`)}return $(i.data)}function E(n,r){const t=P(n,r,{scope:"agents"}),o=g(c(t));if(!d(o))throw new Error(`Invalid config file: ${r} (expected YAML object)`);const i=d(o.agents)?o.agents:{},s=j(a.agents,i),f=e.safeParse(s);if(!f.success){const n=f.error.issues.map(n=>`  - agents.${n.path.join(".")}: ${n.message}`).join("\n");throw new Error(`Config validation failed (${r}):\n${n}`)}return{...f.data,dataDir:v(f.data.dataDir)}}function y(n,r){const t=parseConfigDocument(n,r),o=g(c(t));if(!d(o))throw new Error(`Invalid config file: ${r} (expected YAML object)`);const e=d(o.install)?o.install:{},s=j(a.install,e),f=i.safeParse(s);if(!f.success){const n=f.error.issues.map(n=>`  - install.${n.path.join(".")}: ${n.message}`).join("\n");throw new Error(`Config validation failed (${r}):\n${n}`)}return f.data}export function loadInstallConfig(t={}){const o=resolveConfigPath(t);if(!o)return{installConfig:a.install,configPath:void 0};if(!r(o))throw new Error(`Config file not found: ${o}`);return{installConfig:y(n(o,"utf-8"),o),configPath:o}}export function loadConfig(t={}){const o=resolveConfigPath(t);if(!o)return{config:$(a),configPath:void 0};if(!r(o))throw new Error(`Config file not found: ${o}`);return{config:validateConfigText(n(o,"utf-8"),o),configPath:o}}export function loadAgentsConfig(t={}){const o=resolveConfigPath(t);if(!o)return{agentsConfig:{...a.agents,dataDir:v(a.agents.dataDir)},configPath:void 0};if(!r(o))throw new Error(`Config file not found: ${o}`);return{agentsConfig:E(n(o,"utf-8"),o),configPath:o}}export function resolveConfigPath(n={}){const{configPath:r,cwd:t=process.cwd()}=n;return r??w(t)}export function inspectConfigFile(t={}){const o=resolveConfigPath(t);if(!o)return{status:C.notFound,configPath:void 0};if(!r(o))return{status:C.invalid,configPath:o,raw:"",error:new Error(`Config file not found: ${o}`)};const e=n(o,"utf-8");let i;try{i=parseConfigDocument(e,o)}catch(n){return{status:C.invalid,configPath:o,raw:e,error:n instanceof Error?n:new Error(String(n))}}const s=u(i);if(s.needsMigration)return{status:C.needsMigration,configPath:o,raw:e,report:s};try{return{status:C.valid,configPath:o,config:validateConfigText(e,o)}}catch(n){return{status:C.invalid,configPath:o,raw:e,error:n instanceof Error?n:new Error(String(n))}}}function j(n,r){const t={...n};for(const[o,e]of Object.entries(r)){const r=n[o];"object"!=typeof e||null===e||Array.isArray(e)||"object"!=typeof r||null===r||Array.isArray(r)?t[o]=e:t[o]=j(r,e)}return t}
+import{readFileSync as n,existsSync as r}from"node:fs";import{resolve as t}from"node:path";import{parse as o}from"yaml";import{agentsConfigSchema as e,installConfigSchema as i,rollConfigSchema as s}from"./schema.js";import{DEFAULT_CONFIG as a,CONFIG_FILE_NAMES as f}from"./defaults.js";import{decodeFromYaml as c}from"./key-codec.js";import{detectKnownConfigMigrations as u,formatConfigMigrationError as l}from"./migration.js";function g(n){if("string"==typeof n)return n.replace(/\$\{([^}]+)\}/g,(n,r)=>process.env[r]??n);if(Array.isArray(n))return n.map(g);if(d(n)){const r={};for(const[t,o]of Object.entries(n))r[t]=g(o);return r}return n}function d(n){return"object"==typeof n&&null!==n&&!Array.isArray(n)}function p(n){return d(n)&&"number"==typeof n.line&&"number"==typeof n.col}function h(n){return n instanceof Error&&"linePos"in n&&Array.isArray(n.linePos)&&n.linePos.length>0&&n.linePos.every(p)}function m(n,r){const t=`Invalid YAML syntax in config file: ${n}`;if(!(r instanceof Error))return`${t}\n${String(r)}`;if(h(r)){const[n]=r.linePos;if(n)return`${t} at line ${n.line}, column ${n.col}\n${r.message}`}return`${t}\n${r.message}`}function w(n){let o=t(n);const e=t("/");for(;o!==e;){for(const n of f){const e=t(o,n);if(r(e))return e}const n=t(o,"..");if(n===o)break;o=n}}function v(n){if(n.startsWith("~/")){const r=process.env.HOME??process.env.USERPROFILE??"";return t(r,n.slice(2))}return n}function $(n){return{...n,agents:{...n.agents,dataDir:v(n.agents.dataDir)},runtime:{...n.runtime,threadsDir:v(n.runtime.threadsDir)},browser:{...n.browser,instances:Object.fromEntries(Object.entries(n.browser.instances).map(([n,r])=>[n,{...r,userDataDir:v(r.userDataDir),...void 0!==r.sessionsDir?{sessionsDir:v(r.sessionsDir)}:{}}]))}}}const C={notFound:"not-found",valid:"valid",needsMigration:"needs-migration",invalid:"invalid"};export function parseConfigDocument(n,r){let t;try{t=o(n)}catch(n){throw new Error(m(r,n),{cause:n instanceof Error?n:void 0})}if(!d(t))throw new Error(`Invalid config file: ${r} (expected YAML object)`);return t}function P(n,r,t={}){const o=parseConfigDocument(n,r),e=u(o,t);if(e.needsMigration)throw new Error(l(r,e));return o}export function validateConfigText(n,r){const t=P(n,r),o=g(c(t));if(!d(o))throw new Error(`Invalid config file: ${r} (expected YAML object)`);const e=j(a,o),i=s.safeParse(e);if(!i.success){const n=i.error.issues.map(n=>`  - ${n.path.join(".")}: ${n.message}`).join("\n");throw new Error(`Config validation failed (${r}):\n${n}`)}return $(i.data)}function E(n,r){const t=P(n,r,{scope:"agents"}),o=g(c(t));if(!d(o))throw new Error(`Invalid config file: ${r} (expected YAML object)`);const i=d(o.agents)?o.agents:{},s=j(a.agents,i),f=e.safeParse(s);if(!f.success){const n=f.error.issues.map(n=>`  - agents.${n.path.join(".")}: ${n.message}`).join("\n");throw new Error(`Config validation failed (${r}):\n${n}`)}return{...f.data,dataDir:v(f.data.dataDir)}}function y(n,r){const t=parseConfigDocument(n,r),o=g(c(t));if(!d(o))throw new Error(`Invalid config file: ${r} (expected YAML object)`);const e=d(o.install)?o.install:{},s=j(a.install,e),f=i.safeParse(s);if(!f.success){const n=f.error.issues.map(n=>`  - install.${n.path.join(".")}: ${n.message}`).join("\n");throw new Error(`Config validation failed (${r}):\n${n}`)}return f.data}export function loadInstallConfig(t={}){const o=resolveConfigPath(t);if(!o)return{installConfig:a.install,configPath:void 0};if(!r(o))throw new Error(`Config file not found: ${o}`);return{installConfig:y(n(o,"utf-8"),o),configPath:o}}export function loadConfig(t={}){const o=resolveConfigPath(t);if(!o)return{config:$(a),configPath:void 0};if(!r(o))throw new Error(`Config file not found: ${o}`);return{config:validateConfigText(n(o,"utf-8"),o),configPath:o}}export function loadAgentsConfig(t={}){const o=resolveConfigPath(t);if(!o)return{agentsConfig:{...a.agents,dataDir:v(a.agents.dataDir)},configPath:void 0};if(!r(o))throw new Error(`Config file not found: ${o}`);return{agentsConfig:E(n(o,"utf-8"),o),configPath:o}}export function resolveConfigPath(n={}){const{configPath:r,cwd:t=process.cwd()}=n;return r??w(t)}export function inspectConfigFile(t={}){const o=resolveConfigPath(t);if(!o)return{status:C.notFound,configPath:void 0};if(!r(o))return{status:C.invalid,configPath:o,raw:"",error:new Error(`Config file not found: ${o}`)};const e=n(o,"utf-8");let i;try{i=parseConfigDocument(e,o)}catch(n){return{status:C.invalid,configPath:o,raw:e,error:n instanceof Error?n:new Error(String(n))}}const s=u(i);if(s.needsMigration)return{status:C.needsMigration,configPath:o,raw:e,report:s};try{return{status:C.valid,configPath:o,config:validateConfigText(e,o)}}catch(n){return{status:C.invalid,configPath:o,raw:e,error:n instanceof Error?n:new Error(String(n))}}}function j(n,r){const t={...n};for(const[o,e]of Object.entries(r)){const r=n[o];"object"!=typeof e||null===e||Array.isArray(e)||"object"!=typeof r||null===r||Array.isArray(r)?t[o]=e:t[o]=j(r,e)}return t}

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

@@ -22,13 +22,13 @@ export declare const BrowserSecurityDiagnosticSchema: z.ZodObject<{
     domainAllowlist: string[];
     maxPageContentBytes: number;
     maxSnapshotNodes: number;
-    actionPolicy: "log" | "deny" | "confirm";
+    actionPolicy: "deny" | "confirm" | "log";
     foregroundPolicy: "never" | "when-minimized" | "always";
 }, {
     domainAllowlist: string[];
     maxPageContentBytes: number;
     maxSnapshotNodes: number;
-    actionPolicy: "log" | "deny" | "confirm";
+    actionPolicy: "deny" | "confirm" | "log";
     foregroundPolicy?: "never" | "when-minimized" | "always" | undefined;
 }>;
 export declare const BrowserUseToolPolicyDiagnosticSchema: z.ZodObject<{
@@ -36,18 +36,18 @@ export declare const BrowserUseToolPolicyDiagnosticSchema: z.ZodObject<{
     tools: z.ZodRecord<z.ZodString, z.ZodObject<{
         policy: z.ZodEnum<["log", "deny", "confirm"]>;
     }, "strip", z.ZodTypeAny, {
-        policy: "log" | "deny" | "confirm";
+        policy: "deny" | "confirm" | "log";
     }, {
-        policy: "log" | "deny" | "confirm";
+        policy: "deny" | "confirm" | "log";
     }>>;
 }, "strip", z.ZodTypeAny, {
     tools: Record<string, {
-        policy: "log" | "deny" | "confirm";
+        policy: "deny" | "confirm" | "log";
     }>;
     approvalTtlMs: number;
 }, {
     tools: Record<string, {
-        policy: "log" | "deny" | "confirm";
+        policy: "deny" | "confirm" | "log";
     }>;
     approvalTtlMs: number;
 }>;
@@ -164,13 +164,13 @@ export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
         domainAllowlist: string[];
         maxPageContentBytes: number;
         maxSnapshotNodes: number;
-        actionPolicy: "log" | "deny" | "confirm";
+        actionPolicy: "deny" | "confirm" | "log";
         foregroundPolicy: "never" | "when-minimized" | "always";
     }, {
         domainAllowlist: string[];
         maxPageContentBytes: number;
         maxSnapshotNodes: number;
-        actionPolicy: "log" | "deny" | "confirm";
+        actionPolicy: "deny" | "confirm" | "log";
         foregroundPolicy?: "never" | "when-minimized" | "always" | undefined;
     }>>;
     toolPolicy: z.ZodOptional<z.ZodObject<{
@@ -178,18 +178,18 @@ export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
         tools: z.ZodRecord<z.ZodString, z.ZodObject<{
             policy: z.ZodEnum<["log", "deny", "confirm"]>;
         }, "strip", z.ZodTypeAny, {
-            policy: "log" | "deny" | "confirm";
+            policy: "deny" | "confirm" | "log";
         }, {
-            policy: "log" | "deny" | "confirm";
+            policy: "deny" | "confirm" | "log";
         }>>;
     }, "strip", z.ZodTypeAny, {
         tools: Record<string, {
-            policy: "log" | "deny" | "confirm";
+            policy: "deny" | "confirm" | "log";
         }>;
         approvalTtlMs: number;
     }, {
         tools: Record<string, {
-            policy: "log" | "deny" | "confirm";
+            policy: "deny" | "confirm" | "log";
         }>;
         approvalTtlMs: number;
     }>>;
@@ -316,12 +316,12 @@ export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
         domainAllowlist: string[];
         maxPageContentBytes: number;
         maxSnapshotNodes: number;
-        actionPolicy: "log" | "deny" | "confirm";
+        actionPolicy: "deny" | "confirm" | "log";
         foregroundPolicy: "never" | "when-minimized" | "always";
     } | undefined;
     toolPolicy?: {
         tools: Record<string, {
-            policy: "log" | "deny" | "confirm";
+            policy: "deny" | "confirm" | "log";
         }>;
         approvalTtlMs: number;
     } | undefined;
@@ -360,12 +360,12 @@ export declare const AgentRuntimeEnvDiagnosticPayloadSchema: z.ZodObject<{
         domainAllowlist: string[];
         maxPageContentBytes: number;
         maxSnapshotNodes: number;
-        actionPolicy: "log" | "deny" | "confirm";
+        actionPolicy: "deny" | "confirm" | "log";
         foregroundPolicy?: "never" | "when-minimized" | "always" | undefined;
     } | undefined;
     toolPolicy?: {
         tools: Record<string, {
-            policy: "log" | "deny" | "confirm";
+            policy: "deny" | "confirm" | "log";
         }>;
         approvalTtlMs: number;
     } | undefined;

package/dist/config/schema.d.ts

@@ -63,6 +63,50 @@ export declare const askConfigSchema: z.ZodObject<{
     llmModel?: string | undefined;
     confirmThreshold?: number | undefined;
 }>;
+export declare const runtimeApprovalConfigSchema: z.ZodObject<{
+    default: z.ZodDefault<z.ZodEnum<["guarded", "auto", "deny"]>>;
+    overrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<["auto", "confirm", "deny"]>>>;
+}, "strip", z.ZodTypeAny, {
+    default: "guarded" | "auto" | "deny";
+    overrides: Record<string, "auto" | "deny" | "confirm">;
+}, {
+    default?: "guarded" | "auto" | "deny" | undefined;
+    overrides?: Record<string, "auto" | "deny" | "confirm"> | undefined;
+}>;
+export declare const runtimeConfigSchema: z.ZodObject<{
+    provider: z.ZodOptional<z.ZodString>;
+    model: z.ZodOptional<z.ZodString>;
+    maxSteps: z.ZodDefault<z.ZodNumber>;
+    threadsDir: z.ZodDefault<z.ZodString>;
+    approval: z.ZodDefault<z.ZodObject<{
+        default: z.ZodDefault<z.ZodEnum<["guarded", "auto", "deny"]>>;
+        overrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<["auto", "confirm", "deny"]>>>;
+    }, "strip", z.ZodTypeAny, {
+        default: "guarded" | "auto" | "deny";
+        overrides: Record<string, "auto" | "deny" | "confirm">;
+    }, {
+        default?: "guarded" | "auto" | "deny" | undefined;
+        overrides?: Record<string, "auto" | "deny" | "confirm"> | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    maxSteps: number;
+    threadsDir: string;
+    approval: {
+        default: "guarded" | "auto" | "deny";
+        overrides: Record<string, "auto" | "deny" | "confirm">;
+    };
+    provider?: string | undefined;
+    model?: string | undefined;
+}, {
+    provider?: string | undefined;
+    model?: string | undefined;
+    maxSteps?: number | undefined;
+    threadsDir?: string | undefined;
+    approval?: {
+        default?: "guarded" | "auto" | "deny" | undefined;
+        overrides?: Record<string, "auto" | "deny" | "confirm"> | undefined;
+    } | undefined;
+}>;
 export declare const agentsConfigSchema: z.ZodObject<{
     dataDir: z.ZodString;
     /** per-agent 环境变量：键为 agent name，值为 key-value 对 */
@@ -470,6 +514,40 @@ export declare const rollConfigSchema: z.ZodObject<{
         llmModel?: string | undefined;
         confirmThreshold?: number | undefined;
     }>;
+    runtime: z.ZodDefault<z.ZodObject<{
+        provider: z.ZodOptional<z.ZodString>;
+        model: z.ZodOptional<z.ZodString>;
+        maxSteps: z.ZodDefault<z.ZodNumber>;
+        threadsDir: z.ZodDefault<z.ZodString>;
+        approval: z.ZodDefault<z.ZodObject<{
+            default: z.ZodDefault<z.ZodEnum<["guarded", "auto", "deny"]>>;
+            overrides: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<["auto", "confirm", "deny"]>>>;
+        }, "strip", z.ZodTypeAny, {
+            default: "guarded" | "auto" | "deny";
+            overrides: Record<string, "auto" | "deny" | "confirm">;
+        }, {
+            default?: "guarded" | "auto" | "deny" | undefined;
+            overrides?: Record<string, "auto" | "deny" | "confirm"> | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        maxSteps: number;
+        threadsDir: string;
+        approval: {
+            default: "guarded" | "auto" | "deny";
+            overrides: Record<string, "auto" | "deny" | "confirm">;
+        };
+        provider?: string | undefined;
+        model?: string | undefined;
+    }, {
+        provider?: string | undefined;
+        model?: string | undefined;
+        maxSteps?: number | undefined;
+        threadsDir?: string | undefined;
+        approval?: {
+            default?: "guarded" | "auto" | "deny" | undefined;
+            overrides?: Record<string, "auto" | "deny" | "confirm"> | undefined;
+        } | undefined;
+    }>>;
     agents: z.ZodObject<{
         dataDir: z.ZodString;
         /** per-agent 环境变量：键为 agent name，值为 key-value 对 */
@@ -760,6 +838,16 @@ export declare const rollConfigSchema: z.ZodObject<{
             baseUrl?: string | undefined;
         }>;
     };
+    runtime: {
+        maxSteps: number;
+        threadsDir: string;
+        approval: {
+            default: "guarded" | "auto" | "deny";
+            overrides: Record<string, "auto" | "deny" | "confirm">;
+        };
+        provider?: string | undefined;
+        model?: string | undefined;
+    };
     agents: {
         dataDir: string;
         env?: Record<string, Record<string, string>> | undefined;
@@ -812,7 +900,19 @@ export declare const rollConfigSchema: z.ZodObject<{
             trackingAgentId?: string | undefined;
         }> | undefined;
     } | undefined;
+    runtime?: {
+        provider?: string | undefined;
+        model?: string | undefined;
+        maxSteps?: number | undefined;
+        threadsDir?: string | undefined;
+        approval?: {
+            default?: "guarded" | "auto" | "deny" | undefined;
+            overrides?: Record<string, "auto" | "deny" | "confirm"> | undefined;
+        } | undefined;
+    } | undefined;
 }>;
 export type RollConfig = z.infer<typeof rollConfigSchema>;
+export type RuntimeConfig = z.infer<typeof runtimeConfigSchema>;
+export type RuntimeApprovalConfig = z.infer<typeof runtimeApprovalConfigSchema>;
 export type BrowserConfig = z.infer<typeof browserConfigSchema>;
 export type InstallConfig = z.infer<typeof installConfigSchema>;

package/dist/config/schema.js

@@ -1 +1 @@
-import{z as e}from"zod";const o=["zhipin","yupao"],t=["managed-cdp","remote-cdp","existing-session"],n=["chrome","chromium","msedge"],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 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(o).optional(),mode:e.enum(t).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((o,t)=>{"managed-cdp"===o.mode&&void 0===o.cdpPort&&t.addIssue({code:e.ZodIssueCode.custom,path:["cdpPort"],message:"managed-cdp browser instance requires cdpPort"}),"remote-cdp"!==o.mode&&"existing-session"!==o.mode||void 0!==o.cdpUrl||t.addIssue({code:e.ZodIssueCode.custom,path:["cdpUrl"],message:`${o.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((o,t)=>{const n=Object.entries(o.instances);void 0!==o.defaultInstance&&void 0===o.instances[o.defaultInstance]&&t.addIssue({code:e.ZodIssueCode.custom,path:["defaultInstance"],message:`defaultInstance "${o.defaultInstance}" is not declared in browser.instances`});const s=new Map,r=new Map;for(const[o,i]of n){if(void 0!==i.cdpPort){const n=s.get(i.cdpPort);void 0!==n?t.addIssue({code:e.ZodIssueCode.custom,path:["instances",o,"cdpPort"],message:`cdpPort ${String(i.cdpPort)} is already used by browser instance "${n}"`}):s.set(i.cdpPort,o)}const n=r.get(i.userDataDir);void 0!==n?t.addIssue({code:e.ZodIssueCode.custom,path:["instances",o,"userDataDir"],message:`userDataDir is already used by browser instance "${n}"`}):r.set(i.userDataDir,o)}});export const rollConfigSchema=e.object({llm:llmConfigSchema,ask:askConfigSchema,agents:agentsConfigSchema,install:installConfigSchema.default({}),browser:browserConfigSchema.default({})});
+import{z as e}from"zod";const o=["zhipin","yupao"],t=["managed-cdp","remote-cdp","existing-session"],n=["chrome","chromium","msedge"],r=["guarded","auto","deny"],s=["auto","confirm","deny"],i=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(r).default("guarded"),overrides:e.record(e.string(),e.enum(s)).default({})});export const runtimeConfigSchema=e.object({provider:e.string().optional(),model:e.string().optional(),maxSteps:e.number().int().min(1).default(16),threadsDir:e.string().default("~/.roll-agent/threads"),approval:runtimeApprovalConfigSchema.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(o).optional(),mode:e.enum(t).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:i.optional(),windowBounds:browserWindowBoundsSchema.optional(),trackingAgentId:e.string().trim().min(1).optional()}).superRefine((o,t)=>{"managed-cdp"===o.mode&&void 0===o.cdpPort&&t.addIssue({code:e.ZodIssueCode.custom,path:["cdpPort"],message:"managed-cdp browser instance requires cdpPort"}),"remote-cdp"!==o.mode&&"existing-session"!==o.mode||void 0!==o.cdpUrl||t.addIssue({code:e.ZodIssueCode.custom,path:["cdpUrl"],message:`${o.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((o,t)=>{const n=Object.entries(o.instances);void 0!==o.defaultInstance&&void 0===o.instances[o.defaultInstance]&&t.addIssue({code:e.ZodIssueCode.custom,path:["defaultInstance"],message:`defaultInstance "${o.defaultInstance}" is not declared in browser.instances`});const r=new Map,s=new Map;for(const[o,i]of n){if(void 0!==i.cdpPort){const n=r.get(i.cdpPort);void 0!==n?t.addIssue({code:e.ZodIssueCode.custom,path:["instances",o,"cdpPort"],message:`cdpPort ${String(i.cdpPort)} is already used by browser instance "${n}"`}):r.set(i.cdpPort,o)}const n=s.get(i.userDataDir);void 0!==n?t.addIssue({code:e.ZodIssueCode.custom,path:["instances",o,"userDataDir"],message:`userDataDir is already used by browser instance "${n}"`}):s.set(i.userDataDir,o)}});export const rollConfigSchema=e.object({llm:llmConfigSchema,ask:askConfigSchema,runtime:runtimeConfigSchema.default({}),agents:agentsConfigSchema,install:installConfigSchema.default({}),browser:browserConfigSchema.default({})});

package/dist/types/chat.d.ts

@@ -7,6 +7,15 @@ export interface ChatStepSummary {
     readonly agentName?: string;
     readonly toolName?: string;
 }
+export interface ChatTokenUsage {
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+    readonly totalTokens?: number;
+}
+export interface ChatStepUsage {
+    readonly finishReason: string;
+    readonly usage?: ChatTokenUsage;
+}
 export interface ChatInputRequirement {
     readonly name: string;
     readonly description: string;
@@ -25,6 +34,8 @@ export interface ChatCompletedResult {
     readonly sessionId: string;
     readonly output: string;
     readonly steps: ReadonlyArray<ChatStepSummary>;
+    readonly stepUsages?: ReadonlyArray<ChatStepUsage>;
+    readonly totalUsage?: ChatTokenUsage;
 }
 export interface ChatNeedsInputResult {
     readonly status: "needs_input";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roll-agent/core",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -14,6 +14,34 @@
     ".": {
       "types": "./dist/cli/index.d.ts",
       "default": "./dist/cli/index.js"
+    },
+    "./mcp/*": {
+      "types": "./dist/mcp/*.d.ts",
+      "default": "./dist/mcp/*.js"
+    },
+    "./llm/*": {
+      "types": "./dist/llm/*.d.ts",
+      "default": "./dist/llm/*.js"
+    },
+    "./registry/*": {
+      "types": "./dist/registry/*.d.ts",
+      "default": "./dist/registry/*.js"
+    },
+    "./tool-runtime/*": {
+      "types": "./dist/tool-runtime/*.d.ts",
+      "default": "./dist/tool-runtime/*.js"
+    },
+    "./config/*": {
+      "types": "./dist/config/*.d.ts",
+      "default": "./dist/config/*.js"
+    },
+    "./types/*": {
+      "types": "./dist/types/*.d.ts",
+      "default": "./dist/types/*.js"
+    },
+    "./cli/utils/*": {
+      "types": "./dist/cli/utils/*.d.ts",
+      "default": "./dist/cli/utils/*.js"
     }
   },
   "bin": {
@@ -44,17 +72,18 @@
     "gray-matter": "^4.0.3",
     "ora": "^8.1.0",
     "yaml": "^2.7.0",
-    "zod": "^3.25.76"
+    "zod": "^3.25.76",
+    "@roll-agent/runtime": "0.1.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"
   },
   "scripts": {
-    "dev": "node --experimental-strip-types src/cli/index.ts",
+    "dev": "node --experimental-strip-types --experimental-sqlite src/cli/index.ts",
     "build": "rm -rf dist && tsc -p tsconfig.build.json && node ../../scripts/obfuscate.mjs",
     "typecheck": "tsc --noEmit",
-    "test": "node --experimental-strip-types --test \"src/**/*.test.ts\"",
-    "test:e2e": "node --experimental-strip-types --test \"src/**/*.e2e.ts\"",
+    "test": "node --experimental-strip-types --experimental-sqlite --test \"src/**/*.test.ts\"",
+    "test:e2e": "node --experimental-strip-types --experimental-sqlite --test \"src/**/*.e2e.ts\"",
     "clean": "rm -rf dist"
   }
 }