@roll-agent/core 0.19.0 → 0.21.0

package/dist/config/schema.js

@@ -1 +1 @@
-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({})});
+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"];export const runtimeThinkingLevels=["off","low","medium","high"];export const CHAT_SCREEN_MODES=["auto","fullscreen","inline"];const 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 chatScreenModeSchema=e.enum(CHAT_SCREEN_MODES);export const chatConfigSchema=e.object({screenMode:chatScreenModeSchema.default("auto")});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"),timeoutMs:e.number().int().min(1e4).max(6e5).default(12e4),thinkingLevel:e.enum(runtimeThinkingLevels).optional(),maxOutputTokens:e.number().int().min(2048).max(32768).default(8192),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 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,chat:chatConfigSchema.default({}),runtime:runtimeConfigSchema.default({}),skills:skillsConfigSchema.default({}),agents:agentsConfigSchema,install:installConfigSchema.default({}),browser:browserConfigSchema.default({})});

package/dist/llm/providers.d.ts

@@ -1,11 +1,12 @@
-import type { LanguageModelV4, SharedV4ProviderOptions } from "@ai-sdk/provider";
+import type { LanguageModelV4, LanguageModelV4CallOptions, SharedV4ProviderOptions } from "@ai-sdk/provider";
 import { runtimeThinkingLevels } from "../config/schema.ts";
 export type ThinkingLevel = (typeof runtimeThinkingLevels)[number];
+export type UnifiedReasoning = NonNullable<LanguageModelV4CallOptions["reasoning"]>;
 export declare function thinkingProviderOptions(providerName: string, modelName: string, level: ThinkingLevel): SharedV4ProviderOptions | undefined;
 /**
  * 根据 provider 名称创建 AI SDK LanguageModel 实例。
  *
- * 支持: anthropic, openai, deepseek, qwen
+ * 支持: anthropic, openai, deepseek, qwen, xai
  */
 export declare function createProviderModel(providerName: string, modelName: string, apiKey: string, baseURL?: string): LanguageModelV4;
 /** generateText 调用目的 */
@@ -13,6 +14,7 @@ export type LLMCallPurpose = "structured-output" | "text" | "sampling" | "chat";
 /** resolveLLMCall 的返回值 */
 export interface ResolvedLLMCall {
     readonly model: LanguageModelV4;
+    readonly reasoning?: UnifiedReasoning;
     readonly providerOptions?: SharedV4ProviderOptions;
 }
 /**
@@ -27,8 +29,8 @@ export declare function toSamplingConnectOptions(call: ResolvedLLMCall | undefin
 /**
  * 按 provider + 调用目的解析 generateText 的完整调用上下文。
  *
- * structured-output 场景下，对 qwen provider 自动注入 enableThinking: false，
- * 因为阿里云 thinking mode 不支持 structured output。
+ * structured-output 场景优先使用 AI SDK 顶层 reasoning 统一语义；qwen 是例外，
+ * 因为阿里云 thinking mode 不支持 structured output，必须通过 providerOptions 强制关闭。
  *
  * chat 与 sampling 场景下都是纯文本 generateText 调用，复用同一套
  * thinkingProviderOptions 映射注入 reasoning/thinking effort。

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 o}from"@ai-sdk/openai";import{createDeepSeek as n}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),o=i?.[1];if(!o)return!1;const n=Number(o),t=i?.[2],r=void 0!==t&&t.length<=2?Number(t):0;return n>4||4===n&&r>=6}export function thinkingProviderOptions(e,i,o){return"openai"===e?"off"===o?p(i)?{openai:{reasoningEffort:"none"}}:void 0:{openai:{reasoningEffort:o}}:"anthropic"===e?"off"===o?{anthropic:{thinking:{type:"disabled"}}}:s(i)?{anthropic:{thinking:{type:"adaptive"},effort:o}}:{anthropic:{thinking:{type:"enabled",budgetTokens:r[o]}}}:"qwen"===e?"off"===o?{alibaba:{enableThinking:!1}}:{alibaba:{enableThinking:!0,thinkingBudget:r[o]}}:"deepseek"===e?{deepseek:{thinking:{type:"off"===o?"disabled":"enabled"}}}:void 0}const d="https://dashscope.aliyuncs.com/compatible-mode/v1",c={anthropic:(e,{apiKey:o,baseURL:n})=>i({apiKey:o,...n?{baseURL:n}:{}})(e),openai:(e,{apiKey:i,baseURL:n})=>o({apiKey:i,...n?{baseURL:n}:{}})(e),deepseek:(e,{apiKey:i,baseURL:o})=>n({apiKey:i,...o?{baseURL:o}:{}})(e),qwen:(i,{apiKey:o,baseURL:n})=>e({apiKey:o,baseURL:n??d})(i)};export function createProviderModel(e,i,o,n){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:o,baseURL:n})}export function toSamplingConnectOptions(e){return e?{samplingModel:e.model,...e.providerOptions?{samplingProviderOptions:e.providerOptions}:{}}:{}}export function resolveLLMCall(e,i,o,n,t,r="medium"){const a=createProviderModel(e,i,o,t);if("structured-output"===n&&"qwen"===e)return{model:a,providerOptions:{alibaba:{enableThinking:!1}}};if("chat"===n||"sampling"===n){const o=thinkingProviderOptions(e,i,r);return"openai"===e&&t?{model:a,providerOptions:{...o??{},openai:{...o?.openai??{},store:!1}}}:o?{model:a,providerOptions:o}:{model:a}}return{model:a}}
+import{createAlibaba as e}from"@ai-sdk/alibaba";import{createAnthropic as n}from"@ai-sdk/anthropic";import{createOpenAI as o}from"@ai-sdk/openai";import{createDeepSeek as i}from"@ai-sdk/deepseek";import{createXai as t}from"@ai-sdk/xai";import{runtimeThinkingLevels as r}from"../config/schema.js";const a={low:2048,medium:8192,high:16384},s=["gpt-5.1","gpt-5.2","gpt-5.3","gpt-5.4","gpt-5.5"],p=["o1","o3","o4-mini"],u="grok-4.20",f="-multi-agent";function d(e){return s.some(n=>e.startsWith(n))}function c(e){return p.some(n=>e.startsWith(n))||e.startsWith("gpt-5")&&!e.startsWith("gpt-5-chat")}function l(e){const n=/^claude-[a-z]+-(\d+)(?:-(\d+))?(?:\b|-)/.exec(e),o=n?.[1];if(!o)return!1;const i=Number(o),t=n?.[2],r=void 0!==t&&t.length<=2?Number(t):0;return i>4||4===i&&r>=6}function m(e){return"grok-3"===e||"grok-4-1"===e||e.includes("-non-reasoning")}function g(e){return!h(e)}function h(e){return e.startsWith(u)&&!e.includes(f)}function b(e){return"grok-4.5"===e||e.includes(f)||h(e)&&!m(e)}export function thinkingProviderOptions(e,n,o){if("openai"===e)return"off"===o?d(n)?{openai:{reasoningEffort:"none"}}:void 0:{openai:{reasoningEffort:o}};if("anthropic"===e)return"off"===o?{anthropic:{thinking:{type:"disabled"}}}:l(n)?{anthropic:{thinking:{type:"adaptive"},effort:o}}:{anthropic:{thinking:{type:"enabled",budgetTokens:a[o]}}};if("qwen"===e)return"off"===o?{alibaba:{enableThinking:!1}}:{alibaba:{enableThinking:!0,thinkingBudget:a[o]}};if("xai"===e){if(m(n))return;return g(n)?"off"===o?{xai:{reasoningEffort:"none"}}:{xai:{reasoningEffort:o,reasoningSummary:"auto"}}:"off"===o?void 0:{xai:{reasoningSummary:"auto"}}}return"deepseek"===e?{deepseek:{thinking:{type:"off"===o?"disabled":"enabled"}}}:void 0}const k="https://dashscope.aliyuncs.com/compatible-mode/v1",v={anthropic:(e,{apiKey:o,baseURL:i})=>n({apiKey:o,...i?{baseURL:i}:{}})(e),openai:(e,{apiKey:n,baseURL:i})=>o({apiKey:n,...i?{baseURL:i}:{}})(e),deepseek:(e,{apiKey:n,baseURL:o})=>i({apiKey:n,...o?{baseURL:o}:{}})(e),qwen:(n,{apiKey:o,baseURL:i})=>e({apiKey:o,baseURL:i??k})(n),xai:(e,{apiKey:n,baseURL:o})=>t({apiKey:n,...o?{baseURL:o}:{}})(e)};export function createProviderModel(e,n,o,i){const t=v[e];if(!t){const n=Object.keys(v).join(", ");throw new Error(`Unknown LLM provider "${e}". Supported: ${n}`)}return t(n,{apiKey:o,baseURL:i})}function y(e){return"off"===e?"none":e}function w(e,n,o){if("openai"===e){if(!c(n))return;if("off"!==o)return y(o);if(d(n))return"none";throw new Error(`OpenAI model "${n}" cannot disable reasoning for structured output; set runtime.compaction.thinking-level to low or higher`)}if("xai"===e){if(m(n))return;if(h(n)){if("off"===o)throw new Error(`xAI model "${n}" cannot disable reasoning for structured output; set runtime.compaction.thinking-level to low or higher`);return}if("off"===o&&b(n))throw new Error(`xAI model "${n}" cannot disable reasoning for structured output; set runtime.compaction.thinking-level to low or higher`)}return y(o)}export function toSamplingConnectOptions(e){return e?{samplingModel:e.model,...e.providerOptions?{samplingProviderOptions:e.providerOptions}:{}}:{}}export function resolveLLMCall(e,n,o,i,t,r="medium"){const a=createProviderModel(e,n,o,t);if("structured-output"===i){if("qwen"===e)return{model:a,providerOptions:{alibaba:{enableThinking:!1}}};const o=w(e,n,r);return o?{model:a,reasoning:o}:{model:a}}if("chat"===i||"sampling"===i){const o=thinkingProviderOptions(e,n,r);return"openai"===e&&t?{model:a,providerOptions:{...o??{},openai:{...o?.openai??{},store:!1}}}:o?{model:a,providerOptions:o}:{model:a}}return{model:a}}

package/dist/registry/install.js

@@ -1 +1 @@
-import{existsSync as e,mkdirSync as t,rmSync as s,statSync as r}from"node:fs";import{resolve as a}from"node:path";import{buildNpmRetryPolicy as n,formatPackageManagerError as i,npmInstallNetworkArgs as o,runPackageManagerWithRetry as l}from"../cli/utils/package-manager.js";import{inspectAgentEnvRequirements as g}from"../config/helpers.js";import{discoverAgent as m}from"./discovery.js";import{startAgent as p,stopAgentGracefully as c,waitForAgentReady as u}from"./process-manager.js";import{runAgentSetup as d}from"./runtime-setup.js";import{parsePackageName as f,readInstalledPackageManifest as k,resolveInstalledPackageRoot as y,sanitizeInstallId as h}from"./source.js";import{AgentStore as w}from"./store.js";export const INSTALL_AGENT_STEPS=["resolve","download","discover","setup","register","start"];function v(e){return o({...e.registry?{registry:e.registry}:{},fetchRetries:e.fetchRetries,preferOffline:e.preferOffline})}function S(e){return e.startsWith("git@")||e.startsWith("git+")||e.startsWith("github:")||e.startsWith("gitlab:")||e.startsWith("bitbucket:")||e.endsWith(".git")}function $(t){const s=a(t);return e(s)&&r(s).isDirectory()}function C(e){return e instanceof Error?e.message:String(e)}function A(e){return e.source?.type??"unknown"}function D(e,t,s){return{ok:!1,step:"register",message:`Agent "${e}" 已通过 ${t} 来源注册。为避免覆盖本地/Git Agent，默认不会替换为 npm 安装。请先运行 \`roll agent remove ${e}\`，或确认风险后使用 \`roll agent install ${s} --force\`。`,retryCommand:`roll agent install ${s} --force`}}function j(e,t){return void 0!==e&&"installed-package"!==e.source?.type&&!t}export async function installAgent(r,o){const R=o.report??(()=>{}),B=o.collaborators??{},b=B.runInstall??l,M=B.discover??m,N=B.runSetup??d,T=B.start??p,W=B.waitReady??u,x=B.stopGracefully??c,E=B.resolvePackageRoot??y,L=B.readManifest??k,{packageSpec:G}=r,I=r.autoStart??!0,O=r.replaceExisting??!1;if(S(G))return{ok:!1,step:"resolve",message:`Git URL 请使用 \`roll agent add ${G}\` 注册，不要使用 \`roll agent install\``};if($(G))return{ok:!1,step:"resolve",message:`本地源码目录请使用 \`roll agent add ${G}\` 注册，不要使用 \`roll agent install\``};const P=f(G),_=a(o.agentsConfig.dataDir,"installed",h(P)),q=o.store??new w(o.agentsConfig.dataDir),K=r.expectedSkillName,U=K?q.findByName(K):void 0;if(U&&j(U,O))return D(U.skill.name,A(U),G);const V=e(_);V||t(_,{recursive:!0}),o.installConfig.registry&&R({type:"info",message:`使用 npm registry: ${o.installConfig.registry}（roll.config.yaml install.registry）`}),R({type:"step",step:"download",message:`安装 ${G}...`});const z={command:"npm",args:["install","--prefix",_,G,...v(o.installConfig)]};try{await b(z,{timeout:o.installConfig.networkTimeoutMs},{...n(o.installConfig.fetchRetries),onRetry:({attempt:e,delayMs:t})=>{R({type:"retry",attempt:e,delayMs:t})}})}catch(e){return{ok:!1,step:"download",message:`安装失败: ${i(z,e)}`}}const F=E(_,P);if(!e(F))return{ok:!1,step:"discover",message:`安装完成但未找到包目录: ${F}`};const H=L(F);let J;R({type:"step",step:"discover",message:"解析已安装 Agent 的 SKILL.md..."});try{J=M(F)}catch(e){return{ok:!1,step:"discover",message:C(e)}}const Q={skill:J.skill,transport:J.transport,runtime:J.runtime,installPath:F,registeredAt:(new Date).toISOString(),status:"idle",source:{type:"installed-package",packageName:H?.name??P,packageSpec:G,installDir:_,...H?.version?{installedVersion:H.version}:{}},...J.skillBody.length>0?{skillBody:J.skillBody}:{}},X=q.findByName(J.skill.name);if(X&&j(X,O))return V||s(_,{recursive:!0,force:!0}),D(J.skill.name,A(X),G);"core-managed"===Q.runtime.ownership&&Q.runtime.setup?.playwright&&!r.skipBrowserSetup&&R({type:"info",message:`即将安装浏览器运行时 (${Q.runtime.setup.playwright.browsers.join(", ")})，这可能需要一些时间...`});const Y=await N(Q,{skipBrowserSetup:r.skipBrowserSetup??!1});Y.ok&&!Y.skipped?R({type:"success",message:Y.message}):Y.ok&&R({type:"info",message:Y.message});const Z="core-managed"===X?.runtime.ownership&&"online"===X.status;try{if("installed-package"===X?.source?.type||X&&O){if("installed-package"!==X.source?.type){const e=X.source?.type??"unknown";R({type:"info",message:`Agent "${J.skill.name}" 已通过 ${e} 来源注册，将替换为 npm 安装`})}q.replace(X.skill.name,Q)}else q.add(Q)}catch(e){return{ok:!1,step:"register",message:C(e)}}if(!Y.ok)return Z&&await x(o.agentsConfig.dataDir,Q.skill.name).catch(()=>{}),q.updateStatus(J.skill.name,"error"),{ok:!1,step:"setup",message:Y.message,...Y.retryCommand?{retryCommand:Y.retryCommand}:{}};const ee=g(Q.skill.name,J.skill.env,o.agentsConfig.env),te=ee?.missingRequired??[];let se=!1;const re="core-managed"===Q.runtime.ownership&&I,ae=re&&0===te.length;if(Z&&!ae&&(await x(o.agentsConfig.dataDir,Q.skill.name).catch(()=>{}),q.updateStatus(Q.skill.name,"idle")),re)if(te.length>0)R({type:"warn",message:`Agent "${Q.skill.name}" 缺少必填环境变量（${te.map(e=>e.name).join(", ")}），暂不启动。配置后运行 \`roll agent start ${Q.skill.name}\` 启动`});else{let e=!1;try{Z&&await x(o.agentsConfig.dataDir,Q.skill.name),q.updateStatus(Q.skill.name,"starting"),T(Q,o.agentsConfig.dataDir,o.getStartEnv(Q.skill.name)),e=!0,await W(Q,{startupTimeoutMs:15e3,probeTimeoutMs:2e3}),q.updateStatus(Q.skill.name,"online"),se=!0}catch(t){return e&&await x(o.agentsConfig.dataDir,Q.skill.name).catch(()=>{}),q.updateStatus(Q.skill.name,"error"),{ok:!1,step:"start",message:`Agent "${J.skill.name}" 已安装，但自动启动失败：${C(t)}`}}}return{ok:!0,agent:Q,envReport:ee,started:se}}
+import{randomUUID as e}from"node:crypto";import{existsSync as t,lstatSync as r,mkdirSync as s,readFileSync as n,rmSync as a,statSync as i,writeFileSync as o}from"node:fs";import{basename as l,dirname as c,resolve as m}from"node:path";import{buildNpmRetryPolicy as g,formatPackageManagerError as p,npmInstallNetworkArgs as k,runPackageManagerWithRetry as u}from"../cli/utils/package-manager.js";import{inspectAgentEnvRequirements as f}from"../config/helpers.js";import{discoverAgent as d}from"./discovery.js";import{startAgent as y,stopAgentGracefully as h,waitForAgentReady as w}from"./process-manager.js";import{runAgentSetup as $}from"./runtime-setup.js";import{parsePackageName as v,readInstalledPackageManifest as S,resolveInstalledPackageRoot as D,sanitizeInstallId as A}from"./source.js";import{AgentStore as C}from"./store.js";export const INSTALL_AGENT_STEPS=["resolve","download","discover","setup","register","start"];const P=".install.lock";function T(e){return k({...e.registry?{registry:e.registry}:{},fetchRetries:e.fetchRetries,preferOffline:e.preferOffline})}function j(e){return e.startsWith("git@")||e.startsWith("git+")||e.startsWith("github:")||e.startsWith("gitlab:")||e.startsWith("bitbucket:")||e.endsWith(".git")}function B(e){const r=m(e);return t(r)&&i(r).isDirectory()}function b(e){return e instanceof Error?e.message:String(e)}function E(e,t){return"object"==typeof e&&null!==e&&"code"in e&&e.code===t}function N(e,t){try{e({type:"warn",message:t})}catch{}}function R(e){return m(c(e),`.${l(e)}${P}`)}function I(e,t){o(e,`${JSON.stringify(t)}\n`,{encoding:"utf8",flag:"wx",mode:384})}function O(e){try{const t=JSON.parse(n(e,"utf8"));return"object"==typeof t&&null!==t&&"token"in t&&"string"==typeof t.token?t.token:void 0}catch{return}}function x(e,r){const s=O(e.lockPath);if(void 0!==s)if(s===e.markerToken)try{a(e.lockPath)}catch(t){N(r,`清理安装锁失败: ${e.lockPath}（${b(t)}）`)}else N(r,`安装锁已被其他任务替换，未执行清理: ${e.lockPath}`);else t(e.lockPath)&&N(r,`安装锁内容无法验证，未自动删除: ${e.lockPath}`)}function L(t,n){const a=e(),i=R(t),o=c(t);try{s(o,{recursive:!0}),I(i,{token:a,pid:process.pid,startedAt:(new Date).toISOString()})}catch(e){return{ok:!1,failure:{ok:!1,step:"resolve",message:E(e,"EEXIST")?`Agent 安装任务正在使用锁文件: ${i}。请先检查锁文件中的 pid，确认对应安装进程已结束后再手动删除该锁文件并重试；Roll 不会自动抢占疑似 stale lock。`:`无法创建 Agent 安装锁: ${b(e)}`}}}let l;try{l=r(t)}catch(e){if(!E(e,"ENOENT"))return x({installDir:t,lockPath:i,markerToken:a},n),{ok:!1,failure:{ok:!1,step:"resolve",message:`无法检查 Agent 安装目录: ${b(e)}`}}}if(void 0!==l)return l.isSymbolicLink()?(x({installDir:t,lockPath:i,markerToken:a},n),{ok:!1,failure:{ok:!1,step:"resolve",message:`Agent 安装目录不能是符号链接: ${t}`}}):l.isDirectory()?{ok:!0,workspace:{installDir:t,lockPath:i,markerToken:a,createdByInvocation:!1}}:(x({installDir:t,lockPath:i,markerToken:a},n),{ok:!1,failure:{ok:!1,step:"resolve",message:`Agent 安装路径已存在但不是目录: ${t}`}});try{s(t)}catch(e){return x({installDir:t,lockPath:i,markerToken:a},n),{ok:!1,failure:{ok:!1,step:"resolve",message:`无法创建 Agent 安装目录: ${b(e)}`}}}return{ok:!0,workspace:{installDir:t,lockPath:i,markerToken:a,createdByInvocation:!0}}}function M(e,t){if(e.createdByInvocation)if(O(e.lockPath)===e.markerToken)try{a(e.installDir,{recursive:!0,force:!0})}catch(r){N(t,`清理未完成的安装目录失败: ${e.installDir}（${b(r)}）`)}else N(t,`安装目录锁不再属于当前任务，未删除目录: ${e.installDir}`)}function W(e){return e.source?.type??"unknown"}function G(e,t,r){return{ok:!1,step:"register",message:`Agent "${e}" 已通过 ${t} 来源注册。为避免覆盖本地/Git Agent，默认不会替换为 npm 安装。请先运行 \`roll agent remove ${e}\`，或确认风险后使用 \`roll agent install ${r} --force\`。`,retryCommand:`roll agent install ${r} --force`}}function J(e,t){return void 0!==e&&"installed-package"!==e.source?.type&&!t}export async function installAgent(e,r){const s=r.report??(()=>{}),n=r.collaborators??{},a=n.runInstall??u,i=n.discover??d,o=n.runSetup??$,l=n.start??y,c=n.waitReady??w,k=n.stopGracefully??h,P=n.resolvePackageRoot??D,E=n.readManifest??S,{packageSpec:N}=e,R=e.autoStart??!0,I=e.replaceExisting??!1;if(j(N))return{ok:!1,step:"resolve",message:`Git URL 请使用 \`roll agent add ${N}\` 注册，不要使用 \`roll agent install\``};if(B(N))return{ok:!1,step:"resolve",message:`本地源码目录请使用 \`roll agent add ${N}\` 注册，不要使用 \`roll agent install\``};const O=v(N),_=m(r.agentsConfig.dataDir,"installed",A(O)),q=r.store??new C(r.agentsConfig.dataDir),K=e.expectedSkillName,U=K?q.findByName(K):void 0;if(U&&J(U,I))return G(U.skill.name,W(U),N);const V=L(_,s);if(!V.ok)return V.failure;const X=V.workspace;try{r.installConfig.registry&&s({type:"info",message:`使用 npm registry: ${r.installConfig.registry}（roll.config.yaml install.registry）`}),s({type:"step",step:"download",message:`安装 ${N}...`});const n={command:"npm",args:["install","--prefix",_,N,...T(r.installConfig)]};try{await a(n,{timeout:r.installConfig.networkTimeoutMs},{...g(r.installConfig.fetchRetries),onRetry:({attempt:e,delayMs:t})=>{s({type:"retry",attempt:e,delayMs:t})}})}catch(e){return M(X,s),{ok:!1,step:"download",message:`安装失败: ${p(n,e)}`}}let m,u,d;try{m=P(_,O)}catch(e){throw M(X,s),e}if(!t(m))return M(X,s),{ok:!1,step:"discover",message:`安装完成但未找到包目录: ${m}`};try{u=E(m)}catch(e){throw M(X,s),e}s({type:"step",step:"discover",message:"解析已安装 Agent 的 SKILL.md..."});try{d=i(m)}catch(e){return M(X,s),{ok:!1,step:"discover",message:b(e)}}const y={skill:d.skill,transport:d.transport,runtime:d.runtime,installPath:m,registeredAt:(new Date).toISOString(),status:"idle",source:{type:"installed-package",packageName:u?.name??O,packageSpec:N,installDir:_,...u?.version?{installedVersion:u.version}:{}},...d.skillBody.length>0?{skillBody:d.skillBody}:{}},h=q.findByName(d.skill.name);if(h&&J(h,I))return M(X,s),G(d.skill.name,W(h),N);let w;"core-managed"===y.runtime.ownership&&y.runtime.setup?.playwright&&!e.skipBrowserSetup&&s({type:"info",message:`即将安装浏览器运行时 (${y.runtime.setup.playwright.browsers.join(", ")})，这可能需要一些时间...`});try{w=await o(y,{skipBrowserSetup:e.skipBrowserSetup??!1})}catch(e){throw M(X,s),e}w.ok&&!w.skipped?s({type:"success",message:w.message}):w.ok&&s({type:"info",message:w.message});const $="core-managed"===h?.runtime.ownership&&"online"===h.status;try{if("installed-package"===h?.source?.type||h&&I){if("installed-package"!==h.source?.type){const e=h.source?.type??"unknown";s({type:"info",message:`Agent "${d.skill.name}" 已通过 ${e} 来源注册，将替换为 npm 安装`})}if(!q.replace(h.skill.name,y))throw new Error(`Agent "${h.skill.name}" 在安装期间已被移除，请重试`)}else q.add(y)}catch(e){return M(X,s),{ok:!1,step:"register",message:b(e)}}if(!w.ok)return $&&await k(r.agentsConfig.dataDir,y.skill.name).catch(()=>{}),q.updateStatus(d.skill.name,"error"),{ok:!1,step:"setup",message:w.message,...w.retryCommand?{retryCommand:w.retryCommand}:{}};const v=f(y.skill.name,d.skill.env,r.agentsConfig.env),S=v?.missingRequired??[];let D=!1;const A="core-managed"===y.runtime.ownership&&R,C=A&&0===S.length;if($&&!C&&(await k(r.agentsConfig.dataDir,y.skill.name).catch(()=>{}),q.updateStatus(y.skill.name,"idle")),A)if(S.length>0)s({type:"warn",message:`Agent "${y.skill.name}" 缺少必填环境变量（${S.map(e=>e.name).join(", ")}），暂不启动。配置后运行 \`roll agent start ${y.skill.name}\` 启动`});else{let e=!1;try{$&&await k(r.agentsConfig.dataDir,y.skill.name),q.updateStatus(y.skill.name,"starting"),l(y,r.agentsConfig.dataDir,r.getStartEnv(y.skill.name)),e=!0,await c(y,{startupTimeoutMs:15e3,probeTimeoutMs:2e3}),q.updateStatus(y.skill.name,"online"),D=!0}catch(t){return e&&await k(r.agentsConfig.dataDir,y.skill.name).catch(()=>{}),q.updateStatus(y.skill.name,"error"),{ok:!1,step:"start",message:`Agent "${d.skill.name}" 已安装，但自动启动失败：${b(t)}`}}}return{ok:!0,agent:y,envReport:v,started:D}}finally{x(X,s)}}

package/dist/skills/invocation.d.ts

@@ -0,0 +1,27 @@
+export interface SkillInvocationSummary {
+    readonly name: string;
+    readonly description: string;
+    readonly source: string;
+}
+export interface SkillInvocation {
+    readonly skills: readonly SkillInvocationSummary[];
+    readonly prompt: string;
+}
+export declare const SKILL_INVOCATION_PARSE_KINDS: {
+    readonly none: "none";
+    readonly valid: "valid";
+    readonly unknown: "unknown";
+};
+export type SkillInvocationParseResult = {
+    readonly kind: typeof SKILL_INVOCATION_PARSE_KINDS.none;
+} | {
+    readonly kind: typeof SKILL_INVOCATION_PARSE_KINDS.valid;
+    readonly invocation: SkillInvocation;
+} | {
+    readonly kind: typeof SKILL_INVOCATION_PARSE_KINDS.unknown;
+    readonly token: string;
+};
+export declare function findSkillBySlashName(token: string, skills: readonly SkillInvocationSummary[]): SkillInvocationSummary | undefined;
+/** Parses one or more known leading /skill tokens without rewriting the user's request. */
+export declare function parseSkillInvocationResult(input: string, skills: readonly SkillInvocationSummary[]): SkillInvocationParseResult;
+export declare function parseSkillInvocation(input: string, skills: readonly SkillInvocationSummary[]): SkillInvocation | undefined;

package/dist/skills/invocation.js

@@ -0,0 +1 @@
+export const SKILL_INVOCATION_PARSE_KINDS={none:"none",valid:"valid",unknown:"unknown"};export function findSkillBySlashName(n,o){const t=n.toLowerCase();return o.find(n=>`/${n.name}`.toLowerCase()===t)}export function parseSkillInvocationResult(n,o){let t=n.trimStart();const e=[],i=new Set;for(;;){const n=/^(\/\S+)(\s*)/.exec(t);if(!n)break;const a=findSkillBySlashName(n[1]??"",o);if(!a)return{kind:SKILL_INVOCATION_PARSE_KINDS.unknown,token:n[1]??""};const S=a.name.toLowerCase();i.has(S)||(e.push(a),i.add(S)),t=t.slice(n[0].length)}return 0===e.length?{kind:SKILL_INVOCATION_PARSE_KINDS.none}:{kind:SKILL_INVOCATION_PARSE_KINDS.valid,invocation:{skills:e,prompt:t.trim()}}}export function parseSkillInvocation(n,o){const t=parseSkillInvocationResult(n,o);return t.kind===SKILL_INVOCATION_PARSE_KINDS.valid?t.invocation:void 0}

package/dist/types/chat.d.ts

@@ -23,6 +23,9 @@ export interface ChatCompactionSummary {
     readonly kept: number;
     readonly truncatedTools?: number;
     readonly beforeInputTokens?: number;
+    readonly checkpointId?: string;
+    readonly checkpointGeneration?: number;
+    readonly checkpointSummaryStatus?: "valid" | "fallback" | "skipped";
 }
 export interface ChatInputRequirement {
     readonly name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roll-agent/core",
-  "version": "0.19.0",
+  "version": "0.21.0",
   "type": "module",
   "repository": {
     "type": "git",
@@ -68,6 +68,7 @@
     "@ai-sdk/deepseek": "^3.0.2",
     "@ai-sdk/openai": "^4.0.4",
     "@ai-sdk/provider": "^4.0.1",
+    "@ai-sdk/xai": "4.0.12",
     "@clack/prompts": "1.4.0",
     "@modelcontextprotocol/sdk": "^1.12.0",
     "ai": "^7.0.9",
@@ -84,7 +85,7 @@
     "string-width": "8.2.1",
     "yaml": "^2.7.0",
     "zod": "^3.25.76",
-    "@roll-agent/runtime": "0.7.1"
+    "@roll-agent/runtime": "0.8.0"
   },
   "devDependencies": {
     "@tailwindcss/vite": "4.3.2",