@roll-agent/core 0.14.1 → 0.16.0

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

@@ -0,0 +1,21 @@
+export interface BannerInfo {
+    readonly version: string;
+    readonly model: string;
+    readonly agentCount: number;
+    readonly skillCount: number;
+}
+export interface BannerSpan {
+    readonly text: string;
+    readonly color?: string;
+    readonly dim?: boolean;
+}
+export interface BannerLine {
+    readonly spans: readonly BannerSpan[];
+}
+export interface BuildBannerOptions {
+    readonly hints?: string;
+    readonly unicode?: boolean;
+}
+export declare function bannerTextLine(text: string, style?: Omit<BannerSpan, "text">): BannerLine;
+export declare function buildBannerLines(info: BannerInfo, width: number, options?: BuildBannerOptions): readonly BannerLine[];
+export declare function renderBannerText(lines: readonly BannerLine[]): string;

package/dist/cli/chat/banner.js

@@ -0,0 +1 @@
+import n from"chalk";import t from"is-unicode-supported";const e="Roll Agent",_="#e879f9",o=["██████╗  ██████╗ ██╗     ██╗","██╔══██╗██╔═══██╗██║     ██║","██████╔╝██║   ██║██║     ██║","██╔══██╗██║   ██║██║     ██║","██║  ██║╚██████╔╝███████╗███████╗","╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚══════╝"],r=["    ____  ____  __    __","   / __ \\/ __ \\/ /   / /","  / /_/ / / / / /   / /"," / _, _/ /_/ / /___/ /___","/_/ |_|\\____/_____/_____/"],i=["#22d3ee","#4ac1f0","#71aff2","#999df5","#c08bf7","#e879f9"],s=["#22d3ee","#54bdf1","#85a6f4","#b790f6","#e879f9"],u=36,f=28;export function bannerTextLine(n,t={}){return{spans:[{text:n,...t}]}}function a(n,t){return n.map((n,e)=>({spans:[{text:n,color:t[e]??t[t.length-1]??_}]}))}function c(n,t){return t&&n>=u?a(o,i):n>=f?a(r,s):[]}function l(n){const t=[`v${n.version}`,n.model];return n.agentCount>0&&t.push(`${String(n.agentCount)} agents`),n.skillCount>0&&t.push(`${String(n.skillCount)} skills`),{spans:[{text:e,color:_},{text:` ${t.join(" · ")}`,dim:!0}]}}export function buildBannerLines(n,e,_={}){const o=c(e,_.unicode??t()),r=[...o,...o.length>0?[bannerTextLine(" ")]:[],l(n)];return void 0!==_.hints&&r.push(bannerTextLine(_.hints,{dim:!0})),r}function p(t){let e=n;return void 0!==t.color&&(e=e.hex(t.color)),!0===t.dim&&(e=e.dim),e(t.text)}export function renderBannerText(n){return n.map(n=>n.spans.map(p).join("")).join("\n")}

package/dist/cli/chat/ink/app.d.ts

@@ -2,12 +2,14 @@ import type { ReactElement } from "react";
 import type { AgentSession } from "@roll-agent/runtime";
 import type { ThinkingLevel } from "../../../llm/providers.ts";
 import type { HistoryItem } from "./state.ts";
+import { type SlashSkillSummary } from "./commands.ts";
 export interface ChatAppProps {
     readonly session: AgentSession;
     readonly model: string;
     readonly contextWindow: number | undefined;
     readonly initialHistory?: readonly HistoryItem[];
     readonly initialThinkingLevel?: ThinkingLevel;
+    readonly availableSkills?: readonly SlashSkillSummary[];
     readonly onThinkingChange?: (level: ThinkingLevel) => void;
     readonly onUserSubmit: (text: string) => void;
     readonly onExit: () => void;

package/dist/cli/chat/ink/app.js

@@ -1 +1 @@
-import{randomUUID as t}from"node:crypto";import{createElement as i,useMemo as n,useState as o}from"react";import{Box as e,Static as s,useInput as m}from"ink";import{useSession as r}from"./use-session.js";import{HistoryItemView as a}from"./history-item.js";import{LiveRegion as f}from"./live-region.js";import{StatusLine as l}from"./status-line.js";import{TextPrompt as h}from"./text-prompt.js";import{ConfirmSelect as p}from"./confirm-select.js";import{SlashPopup as d}from"./slash-popup.js";import{filterCommands as c,SLASH_COMMANDS as u}from"./commands.js";import{cycleThinking as g}from"./thinking.js";function k(){return u.map(t=>`${t.name} — ${t.description}`).join("\n")}export function ChatApp(v){const{session:x,model:C,contextWindow:j,onUserSubmit:y,onExit:L}=v,{state:M,submit:T,compact:A,resolveConfirm:b,setDraft:w,setThinking:S,setAutoMode:H,toggleAutoMode:$,commitHistory:D}=r(x,{model:C,contextWindow:j,...v.initialHistory?{initialHistory:v.initialHistory}:{},...v.initialThinkingLevel?{initialThinkingLevel:v.initialThinkingLevel}:{},...v.onThinkingChange?{onThinkingChange:v.onThinkingChange}:{}}),W=n(()=>[...M.history],[M.history]),[E,R]=o(0),U="idle"===M.phase&&M.draft.startsWith("/"),q=U?c(M.draft):[],z=Math.max(q.length-1,0),B=Math.min(E,z);m((t,i)=>{i.tab&&i.shift?$():i.meta&&"."===t?S(g(M.status.thinkingLevel,1)):i.meta&&","===t&&S(g(M.status.thinkingLevel,-1))});const F="confirm"===M.phase&&void 0!==M.pendingConfirm?i(p,{prompt:M.pendingConfirm.prompt,args:M.pendingConfirm.args,onDecide:b}):i(h,{value:M.draft,disabled:"idle"!==M.phase,slashActive:U,autoApprove:M.status.autoApprove,onChange:w,onSubmit:t=>{const i=t.trim();0!==i.length?(y(i),T(i)):w("")},onSlashMove:t=>{R(i=>Math.min(Math.max(Math.min(i,z)+t,0),z))},onSlashComplete:()=>{const t=q[B];t&&(w(`${t.name} `),R(0))},onSlashRun:()=>{const i=M.draft.trim().split(/\s+/,1)[0]??"";(i=>{w("");const n=i.trim().split(/\s+/),o=n[0]??"",e=(n[1]??"").toLowerCase(),s=M.status.thinkingLevel;"/compact"!==o?"/think"!==o?"/effort"!==o?"/auto"!==o?"/help"!==o?"/exit"!==o?D({kind:"notice",id:t(),text:`未知命令 ${o}`}):L():D({kind:"notice",id:t(),text:k()}):"on"===e?H(!0):"off"===e?H(!1):$():"low"===e||"medium"===e||"high"===e?S(e):D({kind:"notice",id:t(),text:"用法: /effort low | medium | high"}):S("off"===e?"off":"on"===e?"off"===s?"medium":s:"off"===s?"medium":"off"):A()})(u.some(t=>t.name===i)?M.draft:q[B]?.name??M.draft)}});return i(e,{flexDirection:"column"},i(s,{items:W,children:t=>{const n="user"===t.kind||"assistant"===t.kind,o="tool"===t.kind||"denied"===t.kind;return i(e,{key:t.id,marginTop:n?1:0,marginLeft:o?3:1},i(a,{item:t}))}}),i(e,{marginLeft:1},i(f,{live:M.live})),i(l,{status:M.status}),U?i(d,{matches:q,selected:B}):null,F)}
+import{randomUUID as i}from"node:crypto";import{createElement as t,useMemo as n,useState as o}from"react";import{Box as e,Static as s,useInput as r}from"ink";import{useSession as m}from"./use-session.js";import{HistoryItemView as a}from"./history-item.js";import{LiveRegion as l}from"./live-region.js";import{StatusLine as d}from"./status-line.js";import{TextPrompt as f}from"./text-prompt.js";import{ConfirmSelect as p}from"./confirm-select.js";import{SlashPopup as h}from"./slash-popup.js";import{buildSkillInvocationPrompt as u,buildSkillListLines as c,filterSlashEntries as g,parseSkillInvocation as v,SLASH_COMMANDS as k}from"./commands.js";import{bannerTextLine as j}from"../banner.js";import{cycleThinking as x}from"./thinking.js";function C(){return k.map(i=>`${i.name} — ${i.description}`).join("\n")}export function ChatApp(y){const{session:L,model:b,contextWindow:M,onUserSubmit:T,onExit:A}=y,$=y.availableSkills??[],{state:S,submit:w,compact:H,resolveConfirm:W,setDraft:D,setThinking:E,setAutoMode:P,toggleAutoMode:R,commitHistory:U}=m(L,{model:b,contextWindow:M,...y.initialHistory?{initialHistory:y.initialHistory}:{},...y.initialThinkingLevel?{initialThinkingLevel:y.initialThinkingLevel}:{},...y.onThinkingChange?{onThinkingChange:y.onThinkingChange}:{}}),q=n(()=>[...S.history],[S.history]),[z,B]=o(0),F="idle"===S.phase&&S.draft.startsWith("/"),G=F&&!0===S.draft.split(/\s+/).at(-1)?.startsWith("/"),I=G?g(S.draft,$):[],J=Math.max(I.length-1,0),K=Math.min(z,J);r((i,t)=>{t.tab&&t.shift?R():t.meta&&"."===i?E(x(S.status.thinkingLevel,1)):t.meta&&","===i&&E(x(S.status.thinkingLevel,-1))});const N=(i,t)=>{const n=i.trim();0!==n.length?(T(n),w(n,t)):D("")},O="confirm"===S.phase&&void 0!==S.pendingConfirm?t(p,{prompt:S.pendingConfirm.prompt,args:S.pendingConfirm.args,onDecide:W}):t(f,{value:S.draft,disabled:"idle"!==S.phase,slashActive:F,slashPopupActive:G,autoApprove:S.status.autoApprove,onChange:D,onSubmit:N,onSlashMove:i=>{B(t=>Math.min(Math.max(Math.min(t,J)+i,0),J))},onSlashComplete:()=>{const i=I[K];if(i){const t=S.draft.split(/\s+/);t[t.length-1]=i.name,D(`${t.join(" ")} `),B(0)}},onSlashRun:()=>{const t=S.draft.trim().split(/\s+/,1)[0]??"",n=k.some(i=>i.name===t),o=I[K];if(!n&&"skill"===o?.kind){const i=S.draft.split(/\s+/);return i[i.length-1]=o.name,D(`${i.join(" ")} `),void B(0)}(t=>{D("");const n=t.trim(),o=n.split(/\s+/),e=o[0]??"",s=(o[1]??"").toLowerCase(),r=S.status.thinkingLevel;if("/compact"===e)return void H();if("/think"===e)return void E("off"===s?"off":"on"===s?"off"===r?"medium":r:"off"===r?"medium":"off");if("/effort"===e)return void("low"===s||"medium"===s||"high"===s?E(s):U({kind:"notice",id:i(),text:"用法: /effort low | medium | high"}));if("/auto"===e)return void("on"===s?P(!0):"off"===s?P(!1):R());if("/skills"===e){const t=(process.stdout.columns||80)-2,[n,...o]=c($,t);return void U({kind:"banner",id:i(),lines:[j(n??""),...o.map(i=>j(i,{dim:!0}))]})}if("/help"===e)return void U({kind:"notice",id:i(),text:C()});if("/exit"===e)return void A();const m=v(n,$);if(m)return 0===m.prompt.length?void D(`${m.skills.map(i=>`/${i.name}`).join(" ")} `):void N(n,u(m));U({kind:"notice",id:i(),text:`未知命令 ${e}`})})(n?S.draft:o?.name??S.draft)}});return t(e,{flexDirection:"column"},t(s,{items:q,children:i=>{const n="user"===i.kind||"assistant"===i.kind,o="tool"===i.kind||"denied"===i.kind;return t(e,{key:i.id,marginTop:n?1:0,marginLeft:o?3:1},t(a,{item:i}))}}),t(e,{marginLeft:1},t(l,{live:S.live})),t(d,{status:S.status}),F?t(h,{matches:I,selected:K}):null,O)}

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

@@ -1,6 +1,34 @@
 export interface SlashCommand {
+    readonly kind: "command";
     readonly name: string;
     readonly description: string;
 }
+export interface SlashSkillSummary {
+    readonly name: string;
+    readonly description: string;
+    readonly source: string;
+}
+export interface SlashSkillEntry {
+    readonly kind: "skill";
+    readonly name: string;
+    readonly description: string;
+    readonly skillName: string;
+    readonly source: string;
+}
+export type SlashEntry = SlashCommand | SlashSkillEntry;
 export declare const SLASH_COMMANDS: readonly SlashCommand[];
+export declare function truncateDisplay(text: string, maxWidth: number): string;
+export declare function skillSlashName(skillName: string): string;
+export declare function buildSkillEntries(skills: readonly SlashSkillSummary[]): SlashSkillEntry[];
+export declare function currentSlashToken(input: string): string;
+export declare function filterSlashEntries(input: string, skills?: readonly SlashSkillSummary[]): SlashEntry[];
 export declare function filterCommands(input: string): SlashCommand[];
+export declare function findSkillBySlashName(token: string, skills: readonly SlashSkillSummary[]): SlashSkillSummary | undefined;
+export interface SkillInvocation {
+    readonly skills: readonly SlashSkillSummary[];
+    readonly prompt: string;
+}
+export declare function parseSkillInvocation(input: string, skills: readonly SlashSkillSummary[]): SkillInvocation | undefined;
+export declare function buildSkillInvocationPrompt(invocation: SkillInvocation): string;
+export declare function buildSkillListLines(skills: readonly SlashSkillSummary[], width?: number): string[];
+export declare function formatSkillList(skills: readonly SlashSkillSummary[], width?: number): string;

package/dist/cli/chat/ink/commands.js

@@ -1 +1 @@
-export const SLASH_COMMANDS=[{name:"/compact",description:"压缩上下文,释放 token"},{name:"/think",description:"开关 thinking/reasoning (on | off)"},{name:"/effort",description:"设置推理努力程度 (low | medium | high)"},{name:"/auto",description:"开关自动批准工具调用 (on | off)，Shift+Tab 快捷切换"},{name:"/help",description:"列出可用命令"},{name:"/exit",description:"退出对话"}];export function filterCommands(e){const t=(e.split(/\s+/,1)[0]??"").toLowerCase();return SLASH_COMMANDS.filter(e=>e.name.toLowerCase().startsWith(t))}
+import{SKILL_TOOL_ID as n}from"../../../skills/library.js";import{displayWidth as e}from"./markdown.js";export const SLASH_COMMANDS=[{kind:"command",name:"/compact",description:"压缩上下文,释放 token"},{kind:"command",name:"/think",description:"开关 thinking/reasoning (on | off)"},{kind:"command",name:"/effort",description:"设置推理努力程度 (low | medium | high)"},{kind:"command",name:"/auto",description:"开关自动批准工具调用 (on | off)，Shift+Tab 快捷切换"},{kind:"command",name:"/skills",description:"列出可加载的 SKILL"},{kind:"command",name:"/help",description:"列出可用命令"},{kind:"command",name:"/exit",description:"退出对话"}];function t(n){return n.replace(/\s+/g," ").trim()}export function truncateDisplay(n,t){if(e(n)<=t)return n;let i="",o=0;for(const r of n){const n=e(r);if(o+n>t-1)break;i+=r,o+=n}return`${i}…`}export function skillSlashName(n){return`/${n}`}export function buildSkillEntries(n){return[...n].filter(n=>!SLASH_COMMANDS.some(e=>e.name===skillSlashName(n.name))).sort((n,e)=>n.name.localeCompare(e.name)).map(n=>{const e=t(n.description);return{kind:"skill",name:skillSlashName(n.name),skillName:n.name,source:n.source,description:e.length>0?`${n.source} · ${e}`:n.source}})}export function currentSlashToken(n){const e=n.split(/\s+/),t=e.at(-1)??"";return t.startsWith("/")?t:e[0]??""}export function filterSlashEntries(n,e=[]){const t=currentSlashToken(n).toLowerCase();return[...SLASH_COMMANDS,...buildSkillEntries(e)].filter(n=>n.name.toLowerCase().startsWith(t))}export function filterCommands(n){const e=currentSlashToken(n).toLowerCase();return SLASH_COMMANDS.filter(n=>n.name.toLowerCase().startsWith(e))}export function findSkillBySlashName(n,e){const t=n.toLowerCase();return e.find(n=>skillSlashName(n.name).toLowerCase()===t)}export function parseSkillInvocation(n,e){let t=n.trimStart();const i=[],o=new Set;for(;;){const n=/^(\/\S+)(\s*)/.exec(t);if(!n)break;const r=findSkillBySlashName(n[1]??"",e);if(!r)break;o.has(r.name)||(i.push(r),o.add(r.name)),t=t.slice(n[0].length)}if(0!==i.length)return{skills:i,prompt:t.trim()}}export function buildSkillInvocationPrompt(e){const t=e.skills.map(n=>`- ${n.name}`).join("\n");return[`请先调用 \`${n}\` 工具加载以下 skill，并严格按它们的说明处理后续请求：`,t,"","用户请求：",e.prompt].join("\n")}const i=96;export function buildSkillListLines(n,e=96){if(0===n.length)return["当前没有可加载的 SKILL。"];const i=[...n].sort((n,e)=>n.name.localeCompare(e.name)),o=Math.min(Math.max(...i.map(n=>skillSlashName(n.name).length)),28);return[`可加载 SKILL（${String(i.length)} 个）· 用法: /<skill-name> 你的请求`,...i.map(n=>truncateDisplay(`  ${skillSlashName(n.name).padEnd(o)}  [${n.source}] ${t(n.description)}`,Math.max(e,40)))]}export function formatSkillList(n,e=96){return buildSkillListLines(n,e).join("\n")}

package/dist/cli/chat/ink/history-item.js

@@ -1 +1 @@
-import{createElement as t}from"react";import{Box as r,Text as o}from"ink";import{parseThinking as e}from"./thinking-text.js";import{Markdown as n}from"./markdown.js";import{ToolLabel as l}from"./tool-label.js";const i=["已取消执行","策略拒绝执行"];function c(t){const r=t.trimStart();return i.some(t=>r.startsWith(t))}export function HistoryItemView({item:i}){switch(i.kind){case"user":return t(r,null,t(o,{color:"cyan",bold:!0},"▌ "),t(o,{color:"cyan"},i.text));case"assistant":return c(i.text)?t(r,null,t(o,{dimColor:!0},"⊘ "),t(o,{dimColor:!0},i.text.trim())):t(r,{flexDirection:"column"},...e(i.text).map((r,e)=>r.thinking?t(o,{key:String(e),dimColor:!0},r.text):t(n,{key:String(e),text:r.text})));case"tool":{const r=i.args.length>0&&"{}"!==i.args?` ${i.args}`:"";return t(o,null,t(o,i.ok?{color:"green"}:{color:"red"},i.ok?"✓ ":"✗ "),t(l,{name:i.name}),r.length>0?t(o,{dimColor:!0},r):null)}case"denied":return t(o,{dimColor:!0},`⊘ ${i.name} ${i.label}`);case"compaction":return t(o,{dimColor:!0},i.notice);case"notice":return t(r,null,t(o,{color:"yellow"},"⚠ "),t(o,{color:"yellow"},i.text));case"error":return t(r,null,t(o,{color:"red"},"✗ "),t(o,{color:"red"},i.message));default:return t(o,null,"")}}
+import{createElement as r}from"react";import{Box as o,Text as t}from"ink";import{parseThinking as e}from"./thinking-text.js";import{Markdown as n}from"./markdown.js";import{ToolLabel as l}from"./tool-label.js";const i=["已取消执行","策略拒绝执行"];function c(r){const o=r.trimStart();return i.some(r=>o.startsWith(r))}export function HistoryItemView({item:i}){switch(i.kind){case"banner":return r(o,{flexDirection:"column"},...i.lines.map((o,e)=>r(t,{key:String(e)},...o.spans.map((o,e)=>r(t,{key:String(e),...void 0!==o.color?{color:o.color}:{},...!0===o.dim?{dimColor:!0}:{}},o.text)))));case"user":return r(o,null,r(t,{color:"cyan",bold:!0},"▌ "),r(t,{color:"cyan"},i.text));case"assistant":return c(i.text)?r(o,null,r(t,{dimColor:!0},"⊘ "),r(t,{dimColor:!0},i.text.trim())):r(o,{flexDirection:"column"},...e(i.text).map((o,e)=>o.thinking?r(t,{key:String(e),dimColor:!0},o.text):r(n,{key:String(e),text:o.text})));case"tool":{const o=i.args.length>0&&"{}"!==i.args?` ${i.args}`:"";return r(t,null,r(t,i.ok?{color:"green"}:{color:"red"},i.ok?"✓ ":"✗ "),r(l,{name:i.name}),o.length>0?r(t,{dimColor:!0},o):null)}case"denied":return r(t,{dimColor:!0},`⊘ ${i.name} ${i.label}`);case"compaction":return r(t,{dimColor:!0},i.notice);case"notice":return r(o,null,r(t,{color:"yellow"},"⚠ "),r(t,{color:"yellow"},i.text));case"error":return r(o,null,r(t,{color:"red"},"✗ "),r(t,{color:"red"},i.message));default:return r(t,null,"")}}

package/dist/cli/chat/ink/live-region.js

@@ -1 +1 @@
-import{createElement as n}from"react";import{Box as l,Text as t}from"ink";import{Spinner as e}from"./spinner.js";import{ThinkingText as i}from"./thinking-text.js";import{ToolLabel as o}from"./tool-label.js";export function LiveRegion({live:r}){return n(l,{flexDirection:"column"},r.streamingText.length>0?n(l,{marginTop:1},n(i,{text:r.thinkTagOpen?`<think>${r.streamingText}`:r.streamingText})):null,r.thinking?n(l,{marginTop:1},n(e,null),n(t,{dimColor:!0}," 思考中…")):null,...r.activeTools.map(i=>n(l,{key:i.toolCallId,marginLeft:2},n(e,null),n(t,null," "),n(o,{name:i.name}),i.args.length>0?n(t,{dimColor:!0},` ${i.args}`):null)),r.compacting?n(l,null,n(e,null),n(t,{dimColor:!0}," 压缩上下文中…")):null)}
+import{createElement as l}from"react";import{Box as n,Text as t}from"ink";import{Spinner as i}from"./spinner.js";import{ThinkingText as o}from"./thinking-text.js";import{ToolLabel as e}from"./tool-label.js";const r=3;function m(l){return void 0===l?[]:l.split("\n").map(l=>l.trimEnd()).filter(l=>l.length>0).slice(-3)}export function LiveRegion({live:r}){return l(n,{flexDirection:"column"},r.streamingText.length>0?l(n,{marginTop:1},l(o,{text:r.thinkTagOpen?`<think>${r.streamingText}`:r.streamingText})):null,r.thinking?l(n,{marginTop:1},l(i,null),l(t,{dimColor:!0}," 思考中…")):null,...r.activeTools.map(o=>l(n,{key:o.toolCallId,marginLeft:2,flexDirection:"column"},l(n,null,l(i,null),l(t,null," "),l(e,{name:o.name}),o.args.length>0?l(t,{dimColor:!0},` ${o.args}`):null),...m(o.outputTail).map((n,i)=>l(t,{key:`${o.toolCallId}-tail-${String(i)}`,dimColor:!0},`    ${n}`)))),r.compacting?l(n,null,l(i,null),l(t,{dimColor:!0}," 压缩上下文中…")):null)}

package/dist/cli/chat/ink/run-ink-repl.d.ts

@@ -1,5 +1,7 @@
 import type { AgentSession } from "@roll-agent/runtime";
 import type { ThinkingLevel } from "../../../llm/providers.ts";
+import { type BannerInfo } from "../banner.ts";
+export declare const INK_HINTS = "/exit \u9000\u51FA \u00B7 / \u547D\u4EE4 \u00B7 Shift+Enter/Ctrl+J \u6362\u884C \u00B7 Alt+./Alt+, \u8C03\u63A8\u7406 \u00B7 Shift+Tab \u81EA\u52A8\u6279\u51C6";
 export interface InkReplStore {
     updateTitle(threadId: string, title: string): void;
     countMessages(threadId: string): number;
@@ -7,6 +9,7 @@ export interface InkReplStore {
 }
 export interface RunInkReplOptions {
     readonly model: string;
+    readonly banner?: BannerInfo;
     readonly initialThinkingLevel?: ThinkingLevel;
     readonly onThinkingChange?: (level: ThinkingLevel) => void;
 }

package/dist/cli/chat/ink/run-ink-repl.js

@@ -1 +1 @@
-import{createElement as i}from"react";import{render as t}from"ink";import{ChatApp as e}from"./app.js";import{messagesToHistory as n}from"./history-from-messages.js";import{titleFromMessage as o}from"../title.js";import{log as a}from"../../utils/output.js";export async function runInkRepl(r,s,l,m){let g=!1,d=!l;a.info("多轮对话已就绪（/exit 退出 · / 命令 · Shift+Enter/Ctrl+J 换行 · Alt+./Alt+, 调推理 · Shift+Tab 自动批准）");const p=t(i(e,{session:r,model:m.model,contextWindow:r.getContextWindow(),onUserSubmit:i=>{g=!0,d||(s.updateTitle(r.id,o(i)),d=!0)},onExit:()=>{p.unmount()},initialHistory:n(r.getMessages()),...m.initialThinkingLevel?{initialThinkingLevel:m.initialThinkingLevel}:{},...m.onThinkingChange?{onThinkingChange:m.onThinkingChange}:{}}),{kittyKeyboard:{mode:"auto",flags:["disambiguateEscapeCodes","reportAlternateKeys"]}});await p.waitUntilExit(),r.abort(),l&&!g&&0===s.countMessages(r.id)&&s.deleteThread(r.id)}
+import{createElement as t}from"react";import{render as e}from"ink";import{ChatApp as i}from"./app.js";import{messagesToHistory as n}from"./history-from-messages.js";import{titleFromMessage as o}from"../title.js";import{buildBannerLines as s}from"../banner.js";import{log as r}from"../../utils/output.js";export const INK_HINTS="/exit 退出 · / 命令 · Shift+Enter/Ctrl+J 换行 · Alt+./Alt+, 调推理 · Shift+Tab 自动批准";export async function runInkRepl(a,l,m,d){let p=!1,c=!m;const g=t=>{p=!0,c||(l.updateTitle(a.id,o(t)),c=!0)};d.banner||r.info(`多轮对话已就绪（${INK_HINTS}）`);const h=d.banner?[{kind:"banner",id:"banner",lines:s(d.banner,process.stdout.columns||80,{hints:INK_HINTS})}]:[],u=!0===process.stdin.isTTY&&"function"==typeof process.stdin.setRawMode;let f;u&&process.stdin.setRawMode(!0);try{f=e(t(i,{session:a,model:d.model,contextWindow:a.getContextWindow(),availableSkills:a.getSkillSummaries(),onUserSubmit:g,onExit:()=>{f.unmount()},initialHistory:[...h,...n(a.getMessages())],...d.initialThinkingLevel?{initialThinkingLevel:d.initialThinkingLevel}:{},...d.onThinkingChange?{onThinkingChange:d.onThinkingChange}:{}}),{kittyKeyboard:{mode:"auto",flags:["disambiguateEscapeCodes","reportAlternateKeys"]}})}catch(t){throw u&&process.stdin.setRawMode(!1),t}await f.waitUntilExit(),a.abort(),m&&!p&&0===l.countMessages(a.id)&&l.deleteThread(a.id)}

package/dist/cli/chat/ink/slash-popup.d.ts

@@ -1,7 +1,7 @@
 import type { ReactElement } from "react";
-import type { SlashCommand } from "./commands.ts";
+import type { SlashEntry } from "./commands.ts";
 export interface SlashPopupProps {
-    readonly matches: readonly SlashCommand[];
+    readonly matches: readonly SlashEntry[];
     readonly selected: number;
 }
 export declare function SlashPopup({ matches, selected }: SlashPopupProps): ReactElement;

package/dist/cli/chat/ink/slash-popup.js

@@ -1 +1 @@
-import{createElement as r}from"react";import{Box as o,Text as e}from"ink";const n=8;export function SlashPopup({matches:n,selected:t}){if(0===n.length)return r(o,{borderStyle:"round",borderColor:"gray",paddingX:1},r(e,{dimColor:!0},"无匹配命令"));const d=n.slice(0,8);return r(o,{flexDirection:"column",borderStyle:"round",borderColor:"gray",paddingX:1},...d.map((n,d)=>{const l=d===t;return r(o,{key:n.name},r(e,l?{color:"cyan",bold:!0}:{dimColor:!0},`${l?"❯ ":"  "}${n.name}`),r(e,{dimColor:!0},`  ${n.description}`))}))}
+import{createElement as o}from"react";import{Box as r,Text as t,useStdout as n}from"ink";const e=8;export function SlashPopup({matches:e,selected:l}){const{stdout:a}=n(),i=a.columns||80;if(0===e.length)return o(r,{borderStyle:"round",borderColor:"gray",paddingX:1},o(t,{dimColor:!0},"无匹配命令"));const d=Math.min(Math.max(l-8+1,0),Math.max(e.length-8,0)),m=e.slice(d,d+8),c=Math.max(i-4,20);return o(r,{flexDirection:"column",borderStyle:"round",borderColor:"gray",paddingX:1},...m.map((n,e)=>{const a=d+e===l;return o(r,{key:n.name,width:c},o(t,{wrap:"truncate-end"},o(t,a?{color:"cyan",bold:!0}:{dimColor:!0},`${a?"❯ ":"  "}${n.name}`),"skill"===n.kind?o(t,{color:"magenta"}," ⚡"):null,o(t,{dimColor:!0},`  ${n.description}`)))}),e.length>8?o(t,{dimColor:!0},`  ${String(l+1)}/${String(e.length)} · ↑↓ 浏览`):null)}

package/dist/cli/chat/ink/state.d.ts

@@ -1,11 +1,17 @@
 import type { SessionEvent, SessionTokenUsage } from "@roll-agent/runtime";
 import type { ThinkingLevel } from "../../../llm/providers.ts";
+import type { BannerLine } from "../banner.ts";
 export interface ToolRowState {
     readonly toolCallId: string;
     readonly name: string;
     readonly args: string;
+    readonly outputTail?: string;
 }
 export type HistoryItem = {
+    readonly kind: "banner";
+    readonly id: string;
+    readonly lines: readonly BannerLine[];
+} | {
     readonly kind: "user";
     readonly id: string;
     readonly text: string;

package/dist/cli/chat/ink/state.js

@@ -1 +1 @@
-import{formatToolInput as t}from"../../utils/tool-format.js";import{GLYPHS as e}from"../../utils/glyphs.js";import{endsInsideThink as i}from"./thinking-text.js";const n={streamingText:"",thinking:!1,thinkTagOpen:!1,activeTools:[],compacting:!1,producedOutput:!1};function o(t,e){return e?`<think>${t}`:t}export function createInitialState(t,e,i){return{history:i?.history??[],draft:"",live:n,status:{model:t,contextWindow:e,turnUsage:void 0,sessionUsage:void 0,contextInputTokens:void 0,outputTokensPerSecond:void 0,thinkingLevel:i?.thinkingLevel??"medium",autoApprove:!1},phase:"idle",pendingConfirm:void 0}}export function buildConfirmPrompt(t){const e=t.reason?`（${t.reason}）`:"";return`执行 ${t.agentName}.${t.toolName}${e}?`}function r(t){const i="auto"===t.reason?"自动压缩":"手动压缩",n=t.truncatedTools?`，精简 ${String(t.truncatedTools)} 个工具结果`:"";return 0!==t.removed||t.truncatedTools?`${e.compact} ${i}(${t.strategy})：移除 ${String(t.removed)} 条 → 保留 ${String(t.kept)} 条${n}`:`${e.compact} ${i}：无需压缩`}const s=[["已取消执行","已取消"],["策略拒绝执行","策略拒绝"]];function a(t){return"string"==typeof t?t:"object"==typeof t&&null!==t&&"output"in t&&"string"==typeof t.output?t.output:void 0}export function denialLabel(t){const e=a(t);if(void 0!==e)return s.find(([t])=>e.startsWith(t))?.[1]}function u(t,e,i){const n=t.live.activeTools.find(t=>t.toolCallId===i.toolCallId),o=n?.name??`${i.agentName}.${i.toolName}`,r=n?.args??"",s=i.isError?denialLabel(i.output):void 0,a=void 0!==s?{kind:"denied",id:e,name:o,label:s}:{kind:"tool",id:e,name:o,args:r,ok:!i.isError};return{...t,history:[...t.history,a],live:{...t.live,activeTools:t.live.activeTools.filter(t=>t.toolCallId!==i.toolCallId)}}}function l(e,s,a){switch(a.type){case"message-start":return{...e,live:{...e.live,thinking:!0}};case"text-delta":return{...e,live:{...e.live,thinking:!1,producedOutput:!0,streamingText:e.live.streamingText+a.delta}};case"tool-call":{const n=e.live.streamingText.length>0?[{kind:"assistant",id:s,text:o(e.live.streamingText,e.live.thinkTagOpen)}]:[];return{...e,history:[...e.history,...n],live:{...e.live,thinking:!1,producedOutput:!0,streamingText:"",thinkTagOpen:i(e.live.streamingText,e.live.thinkTagOpen),activeTools:[...e.live.activeTools,{toolCallId:a.toolCallId,name:`${a.agentName}.${a.toolName}`,args:t(a.input)}]}}}case"tool-result":return u(e,s,a);case"confirmation-required":return{...e,phase:"confirm",pendingConfirm:{approvalId:a.approvalId,prompt:buildConfirmPrompt(a),args:t(a.input)}};case"compaction-start":return{...e,live:{...e.live,compacting:!0}};case"context-compacted":return{...e,live:{...e.live,compacting:!1},history:[...e.history,{kind:"compaction",id:s,notice:r(a)}]};case"message-finish":{const t=[];return e.live.streamingText.length>0?t.push({kind:"assistant",id:s,text:o(e.live.streamingText,e.live.thinkTagOpen)}):!e.live.producedOutput&&(a.totalUsage?.outputTokens??0)>0&&t.push({kind:"notice",id:s,text:"模型本轮只返回了 thinking/reasoning，没有生成可见回复"}),a.stoppedAtStepLimit&&t.push({kind:"notice",id:`${s}-step-limit`,text:"已达单轮最大工具步数，任务可能未完成 — 继续追问即可接着做，或调高 runtime.max-steps"}),{...e,history:[...e.history,...t],live:{...n},status:{...e.status,turnUsage:a.totalUsage,sessionUsage:a.sessionUsage,contextInputTokens:a.contextInputTokens,outputTokensPerSecond:a.outputTokensPerSecond}}}case"error":return{...e,history:[...e.history,{kind:"error",id:s,message:a.message}],live:{...n}};default:return e}}export function chatReducer(t,e){switch(e.type){case"submit-user":return{...t,history:[...t.history,{kind:"user",id:e.id,text:e.text}],draft:"",live:{...n},phase:"busy",pendingConfirm:void 0};case"set-draft":return{...t,draft:e.value};case"set-thinking":return{...t,status:{...t.status,thinkingLevel:e.level}};case"set-auto":return{...t,status:{...t.status,autoApprove:e.value}};case"commit-history":return{...t,history:[...t.history,e.item],draft:""};case"start-compaction":return{...t,live:{...n},phase:"busy",pendingConfirm:void 0};case"session-event":return l(t,e.id,e.event);case"confirm-resolved":return{...t,phase:"busy",pendingConfirm:void 0};case"turn-end":return{...t,phase:"idle",live:{...n}};default:return t}}
+import{formatToolInput as t,formatApprovalDetails as e}from"../../utils/tool-format.js";import{GLYPHS as i}from"../../utils/glyphs.js";import{endsInsideThink as o}from"./thinking-text.js";const n=2e3,r={streamingText:"",thinking:!1,thinkTagOpen:!1,activeTools:[],compacting:!1,producedOutput:!1};function s(t,e){return e?`<think>${t}`:t}export function createInitialState(t,e,i){return{history:i?.history??[],draft:"",live:r,status:{model:t,contextWindow:e,turnUsage:void 0,sessionUsage:void 0,contextInputTokens:void 0,outputTokensPerSecond:void 0,thinkingLevel:i?.thinkingLevel??"medium",autoApprove:!1},phase:"idle",pendingConfirm:void 0}}export function buildConfirmPrompt(t){const e=t.reason?`（${t.reason}）`:"";return`执行 ${t.agentName}.${t.toolName}${e}?`}function a(t){const e="auto"===t.reason?"自动压缩":"手动压缩",o=t.truncatedTools?`，精简 ${String(t.truncatedTools)} 个工具结果`:"";return 0!==t.removed||t.truncatedTools?`${i.compact} ${e}(${t.strategy})：移除 ${String(t.removed)} 条 → 保留 ${String(t.kept)} 条${o}`:`${i.compact} ${e}：无需压缩`}const l=[["已取消执行","已取消"],["策略拒绝执行","策略拒绝"]];function u(t){return"string"==typeof t?t:"object"==typeof t&&null!==t&&"output"in t&&"string"==typeof t.output?t.output:void 0}export function denialLabel(t){const e=u(t);if(void 0!==e)return l.find(([t])=>e.startsWith(t))?.[1]}function c(t,e,i){const o=t.live.activeTools.find(t=>t.toolCallId===i.toolCallId),n=o?.name??`${i.agentName}.${i.toolName}`,r=o?.args??"",s=i.isError?denialLabel(i.output):void 0,a=void 0!==s?{kind:"denied",id:e,name:n,label:s}:{kind:"tool",id:e,name:n,args:r,ok:!i.isError};return{...t,history:[...t.history,a],live:{...t.live,activeTools:t.live.activeTools.filter(t=>t.toolCallId!==i.toolCallId)}}}function d(i,l,u){switch(u.type){case"message-start":return{...i,live:{...i.live,thinking:!0}};case"text-delta":return{...i,live:{...i.live,thinking:!1,producedOutput:!0,streamingText:i.live.streamingText+u.delta}};case"tool-call":{const e=i.live.streamingText.length>0?[{kind:"assistant",id:l,text:s(i.live.streamingText,i.live.thinkTagOpen)}]:[];return{...i,history:[...i.history,...e],live:{...i.live,thinking:!1,producedOutput:!0,streamingText:"",thinkTagOpen:o(i.live.streamingText,i.live.thinkTagOpen),activeTools:[...i.live.activeTools,{toolCallId:u.toolCallId,name:`${u.agentName}.${u.toolName}`,args:t(u.input)}]}}}case"tool-output-delta":{const t=i.live.activeTools.map(t=>{if(t.toolCallId!==u.toolCallId)return t;const e=`${t.outputTail??""}${u.delta}`,i=e.length>n?e.slice(e.length-n):e;return{...t,outputTail:i}});return{...i,live:{...i.live,activeTools:t}}}case"tool-result":return c(i,l,u);case"confirmation-required":return{...i,phase:"confirm",pendingConfirm:{approvalId:u.approvalId,prompt:buildConfirmPrompt(u),args:e(u.input)}};case"compaction-start":return{...i,live:{...i.live,compacting:!0}};case"context-compacted":return{...i,live:{...i.live,compacting:!1},history:[...i.history,{kind:"compaction",id:l,notice:a(u)}]};case"message-finish":{const t=[];return i.live.streamingText.length>0?t.push({kind:"assistant",id:l,text:s(i.live.streamingText,i.live.thinkTagOpen)}):!i.live.producedOutput&&(u.totalUsage?.outputTokens??0)>0&&t.push({kind:"notice",id:l,text:"模型本轮只返回了 thinking/reasoning，没有生成可见回复"}),u.stoppedAtStepLimit&&t.push({kind:"notice",id:`${l}-step-limit`,text:"已达单轮最大工具步数，任务可能未完成 — 继续追问即可接着做，或调高 runtime.max-steps"}),{...i,history:[...i.history,...t],live:{...r},status:{...i.status,turnUsage:u.totalUsage,sessionUsage:u.sessionUsage,contextInputTokens:u.contextInputTokens,outputTokensPerSecond:u.outputTokensPerSecond}}}case"error":return{...i,history:[...i.history,{kind:"error",id:l,message:u.message}],live:{...r}};default:return i}}export function chatReducer(t,e){switch(e.type){case"submit-user":return{...t,history:[...t.history,{kind:"user",id:e.id,text:e.text}],draft:"",live:{...r},phase:"busy",pendingConfirm:void 0};case"set-draft":return{...t,draft:e.value};case"set-thinking":return{...t,status:{...t.status,thinkingLevel:e.level}};case"set-auto":return{...t,status:{...t.status,autoApprove:e.value}};case"commit-history":return{...t,history:[...t.history,e.item],draft:""};case"start-compaction":return{...t,live:{...r},phase:"busy",pendingConfirm:void 0};case"session-event":return d(t,e.id,e.event);case"confirm-resolved":return{...t,phase:"busy",pendingConfirm:void 0};case"turn-end":return{...t,phase:"idle",live:{...r}};default:return t}}

package/dist/cli/chat/ink/text-prompt.d.ts

@@ -3,6 +3,7 @@ export interface TextPromptProps {
     readonly value: string;
     readonly disabled: boolean;
     readonly slashActive: boolean;
+    readonly slashPopupActive: boolean;
     readonly autoApprove: boolean;
     readonly onChange: (value: string) => void;
     readonly onSubmit: (value: string) => void;

package/dist/cli/chat/ink/text-prompt.js

@@ -1 +1 @@
-import{createElement as r,useRef as t}from"react";import{Box as e,Text as n,useInput as o,useStdout as i}from"ink";import{GLYPHS as l}from"../../utils/glyphs.js";function u(r){return/^\[\?\d+u$/.test(r)||/^\x9b\?\d+u$/.test(r)}export function TextPrompt(c){const{value:s,disabled:a,slashActive:d,autoApprove:f,onChange:m,onSubmit:p}=c,{stdout:h}=i(),v=h.columns||80,b=t(s);b.current=s;const S=r=>{b.current=r,m(r)};o((r,t)=>{if(t.meta&&("."===r||","===r))return;if(u(r))return;if(t.backspace||t.delete)return void S(b.current.slice(0,-1));if("\n"===r||t.ctrl&&"j"===r||t.return&&(t.shift||t.meta))return void S(`${b.current}\n`);if(t.return||r.includes("\r")){if(d)return void c.onSlashRun();const t=r.split("\r",1)[0]??"";return void p(b.current+t)}if(d){if(t.upArrow)return void c.onSlashMove(-1);if(t.downArrow)return void c.onSlashMove(1);if(t.tab&&!t.shift)return void c.onSlashComplete();if(t.escape)return void S("")}t.ctrl||t.escape||t.tab||t.upArrow||t.downArrow||t.leftArrow||t.rightArrow||r.length>0&&S(b.current+r)},{isActive:!a});const g=s.split("\n"),w=r(e,{flexDirection:"column"},...g.map((t,o)=>{const i=o===g.length-1,l=0===o?r(n,{color:"green"},"› "):r(n,null,"  ");return r(e,{key:String(o)},l,r(n,a?{dimColor:!0}:{},t),i&&!a?r(n,null,"▏"):null)})),A=d?"↑↓ 选择 · Tab 补全 · Enter 执行 · Esc 取消":f?"Shift+Tab 关闭 · Enter 发送 · Shift+Enter/Ctrl+J 换行 · / 命令":"Enter 发送 · Shift+Enter/Ctrl+J 换行 · / 命令 · Shift+Tab 自动批准",C=r(e,{marginLeft:1},...f?[r(n,{color:"yellow"},`${l.auto} auto`),r(n,{dimColor:!0},` · ${A}`)]:[r(n,{dimColor:!0},A)]);return r(e,{flexDirection:"column",width:v},r(e,{borderStyle:"round",borderColor:a?"gray":"cyan",paddingX:2},w),C)}
+import{createElement as r,useRef as t}from"react";import{Box as e,Text as n,useInput as o,useStdout as i}from"ink";import{GLYPHS as l}from"../../utils/glyphs.js";function u(r){return/^\[\?\d+u$/.test(r)||/^\x9b\?\d+u$/.test(r)}export function TextPrompt(c){const{value:s,disabled:a,slashActive:d,slashPopupActive:f,autoApprove:m,onChange:p,onSubmit:h}=c,{stdout:v}=i(),b=v.columns||80,S=t(s);S.current=s;const g=r=>{S.current=r,p(r)};o((r,t)=>{if(t.meta&&("."===r||","===r))return;if(u(r))return;if(t.backspace||t.delete)return void g(S.current.slice(0,-1));if("\n"===r||t.ctrl&&"j"===r||t.return&&(t.shift||t.meta))return void g(`${S.current}\n`);if(t.return||r.includes("\r")){if(d)return void c.onSlashRun();const t=r.split("\r",1)[0]??"";return void h(S.current+t)}if(f){if(t.upArrow)return void c.onSlashMove(-1);if(t.downArrow)return void c.onSlashMove(1);if(t.tab&&!t.shift)return void c.onSlashComplete()}d&&t.escape?g(""):t.ctrl||t.escape||t.tab||t.upArrow||t.downArrow||t.leftArrow||t.rightArrow||r.length>0&&g(S.current+r)},{isActive:!a});const w=s.split("\n"),A=r(e,{flexDirection:"column"},...w.map((t,o)=>{const i=o===w.length-1,l=0===o?r(n,{color:"green"},"› "):r(n,null,"  ");return r(e,{key:String(o)},l,r(n,a?{dimColor:!0}:{},t),i&&!a?r(n,null,"▏"):null)})),C=d?"↑↓ 选择 · Tab 补全 · Enter 执行 · Esc 取消":m?"Shift+Tab 关闭 · Enter 发送 · Shift+Enter/Ctrl+J 换行 · / 命令":"Enter 发送 · Shift+Enter/Ctrl+J 换行 · / 命令 · Shift+Tab 自动批准",E=r(e,{marginLeft:1},...m?[r(n,{color:"yellow"},`${l.auto} auto`),r(n,{dimColor:!0},` · ${C}`)]:[r(n,{dimColor:!0},C)]);return r(e,{flexDirection:"column",width:b},r(e,{borderStyle:"round",borderColor:a?"gray":"cyan",paddingX:2},A),E)}

package/dist/cli/chat/ink/use-session.d.ts

@@ -10,7 +10,7 @@ export interface UseSessionOptions {
 }
 export interface UseSessionResult {
     readonly state: ChatUiState;
-    readonly submit: (text: string) => void;
+    readonly submit: (text: string, sendText?: string) => void;
     readonly compact: () => void;
     readonly resolveConfirm: (approved: boolean) => void;
     readonly setDraft: (value: string) => void;

package/dist/cli/chat/ink/use-session.js

@@ -1 +1 @@
-import{randomUUID as e}from"node:crypto";import{useCallback as t,useReducer as n,useRef as i}from"react";import{chatReducer as r,createInitialState as o}from"./state.js";import{log as s}from"../../utils/output.js";const a=32;function c(e){return e instanceof Error?e.message:String(e)}export function useSession(u,p){const[l,m]=n(r,o(p.model,p.contextWindow,{...p.initialHistory?{history:p.initialHistory}:{},...p.initialThinkingLevel?{thinkingLevel:p.initialThinkingLevel}:{}})),d=p.onThinkingChange,y=i(null),v=i(!1),f=i(!1),g=t(async t=>{let n,i="";const r=()=>{if(void 0!==n&&(clearTimeout(n),n=void 0),i.length>0){const t=i;i="",m({type:"session-event",id:e(),event:{type:"text-delta",delta:t}})}};try{for await(const o of t)if("debug"!==o.type)if("text-delta"!==o.type){if(r(),"confirmation-required"===o.type){if(v.current){u.approve(o.approvalId);continue}const t=new Promise(e=>{y.current=e});m({type:"session-event",id:e(),event:o});const n=await t;y.current=null,n?u.approve(o.approvalId):u.reject(o.approvalId,"用户取消"),m({type:"confirm-resolved"});continue}m({type:"session-event",id:e(),event:o})}else i+=o.delta,void 0===n&&(n=setTimeout(r,a));else s.debug(`chat.${o.stage} ${o.message}`)}catch(t){r(),m({type:"session-event",id:e(),event:{type:"error",stage:"execute",message:c(t)}})}finally{r(),m({type:"turn-end"}),f.current=!1}},[u]),h=t(t=>{f.current||(f.current=!0,m({type:"submit-user",id:e(),text:t}),g(u.send(t)).catch(()=>{}))},[g,u]),k=t(()=>{f.current||(f.current=!0,m({type:"start-compaction"}),g(u.compact("manual")).catch(()=>{}))},[g,u]),x=t(e=>{y.current?.(e)},[]),T=t(e=>{m({type:"set-draft",value:e})},[]),b=t(e=>{m({type:"set-thinking",level:e}),d?.(e)},[d]),w=t(e=>{v.current=e,m({type:"set-auto",value:e}),e&&y.current?.(!0)},[]),j=t(()=>{w(!v.current)},[w]),H=t(e=>{m({type:"commit-history",item:e})},[]);return{state:l,submit:h,compact:k,resolveConfirm:x,setDraft:T,setThinking:b,setAutoMode:w,toggleAutoMode:j,commitHistory:H}}
+import{randomUUID as e}from"node:crypto";import{useCallback as t,useReducer as n,useRef as i}from"react";import{chatReducer as r,createInitialState as o}from"./state.js";import{log as s}from"../../utils/output.js";const a=32;function c(e){return e instanceof Error?e.message:String(e)}export function useSession(u,p){const[l,m]=n(r,o(p.model,p.contextWindow,{...p.initialHistory?{history:p.initialHistory}:{},...p.initialThinkingLevel?{thinkingLevel:p.initialThinkingLevel}:{}})),d=p.onThinkingChange,y=i(null),v=i(!1),f=i(!1),g=t(async t=>{let n,i="";const r=()=>{if(void 0!==n&&(clearTimeout(n),n=void 0),i.length>0){const t=i;i="",m({type:"session-event",id:e(),event:{type:"text-delta",delta:t}})}};try{for await(const o of t)if("debug"!==o.type)if("text-delta"!==o.type){if(r(),"confirmation-required"===o.type){if(v.current){u.approve(o.approvalId);continue}const t=new Promise(e=>{y.current=e});m({type:"session-event",id:e(),event:o});const n=await t;y.current=null,n?u.approve(o.approvalId):u.reject(o.approvalId,"用户取消"),m({type:"confirm-resolved"});continue}m({type:"session-event",id:e(),event:o})}else i+=o.delta,void 0===n&&(n=setTimeout(r,a));else s.debug(`chat.${o.stage} ${o.message}`)}catch(t){r(),m({type:"session-event",id:e(),event:{type:"error",stage:"execute",message:c(t)}})}finally{r(),m({type:"turn-end"}),f.current=!1}},[u]),h=t((t,n)=>{f.current||(f.current=!0,m({type:"submit-user",id:e(),text:t}),g(u.send(n??t)).catch(()=>{}))},[g,u]),k=t(()=>{f.current||(f.current=!0,m({type:"start-compaction"}),g(u.compact("manual")).catch(()=>{}))},[g,u]),x=t(e=>{y.current?.(e)},[]),T=t(e=>{m({type:"set-draft",value:e})},[]),b=t(e=>{m({type:"set-thinking",level:e}),d?.(e)},[d]),w=t(e=>{v.current=e,m({type:"set-auto",value:e}),e&&y.current?.(!0)},[]),j=t(()=>{w(!v.current)},[w]),H=t(e=>{m({type:"commit-history",item:e})},[]);return{state:l,submit:h,compact:k,resolveConfirm:x,setDraft:T,setThinking:b,setAutoMode:w,toggleAutoMode:j,commitHistory:H}}

package/dist/cli/commands/agent-add.js

@@ -1 +1 @@
-import{defineCommand as e}from"citty";import{resolve as t}from"node:path";import{existsSync as r,mkdirSync as i}from"node:fs";import{execFile as o}from"node:child_process";import{promisify as n}from"node:util";import{inspectAgentEnvRequirements as s}from"../../config/helpers.js";import{loadAgentsConfig as a}from"../../config/loader.js";import{discoverAgent as p}from"../../registry/discovery.js";import{writeRemoteSkillManifest as c}from"../../registry/manifest.js";import{AgentStore as d}from"../../registry/store.js";import{log as l}from"../utils/output.js";import{createInstallCommand as m,detectInstallCommand as g,formatPackageManagerCommand as f,formatPackageManagerError as u,runPackageManager as h}from"../utils/package-manager.js";const y=n(o);function $(e){return e.startsWith("https://")||e.startsWith("http://")||e.startsWith("git@")||e.endsWith(".git")}function v(e){return(e.split("/").pop()??e).replace(/\.git$/,"")}export default e({meta:{description:"注册本地目录、Git 仓库或远程 MCP endpoint"},args:{path:{type:"positional",description:"本地 Agent 目录或 Git 仓库 URL；远程 endpoint 请用 --remote",required:!1},remote:{type:"string",description:"远程 MCP endpoint；需要同时提供 --name 和 --description"},name:{type:"string",description:"远程 Agent 名称（仅 --remote 时使用）"},description:{type:"string",description:"远程 Agent 描述（仅 --remote 时使用）"}},async run({args:e}){const{agentsConfig:o}=a();let n;if(e.remote){if(!e.name||!e.description)return l.error("远程注册需要同时提供 --name 和 --description"),void(process.exitCode=1);n=c({dataDir:o.dataDir,name:e.name,description:e.description,endpoint:e.remote})}else{if(!e.path)return l.error("请提供本地路径、Git URL，或使用 --remote <endpoint> 注册远程 Agent"),void(process.exitCode=1);if($(e.path)){const s=v(e.path),a=t(o.dataDir,"repos",s);if(r(a)){l.info(`仓库目录已存在，拉取最新代码: ${a}`);try{await y("git",["pull"],{cwd:a})}catch(e){return l.error(`git pull 失败: ${e instanceof Error?e.message:String(e)}`),void(process.exitCode=1)}}else{l.info(`克隆 ${e.path}...`);const n=t(o.dataDir,"repos");r(n)||i(n,{recursive:!0});try{await y("git",["clone",e.path,a]),l.success("克隆完成")}catch(e){return l.error(`git clone 失败: ${e instanceof Error?e.message:String(e)}`),void(process.exitCode=1)}}n=a}else if(n=t(e.path),!r(n))return l.error(`路径不存在: ${n}`),void(process.exitCode=1)}l.info("解析 SKILL.md...");const s=p(n);l.debug(`名称: ${s.skill.name}`),l.debug(`描述: ${s.skill.description}`),l.debug(`传输: ${s.transport.type}`);const L=t(n,"package.json"),A="1"===process.env.ROLL_SKIP_INSTALL;if(e.remote)l.info("远程 Agent 使用本地 manifest，无需安装依赖。");else if(r(L)&&!A){const e=g(n)??m("pnpm");l.info(`安装依赖 (${f(e)})...`);try{await h(e,{cwd:n}),l.success("依赖安装完成")}catch(t){return l.error(`依赖安装失败: ${u(e,t)}`),void(process.exitCode=1)}}else r(L)&&A&&l.warn("检测到 ROLL_SKIP_INSTALL=1，跳过依赖安装。");const j=e.remote?{type:"remote-manifest",endpoint:e.remote}:e.path&&$(e.path)?{type:"git",url:e.path}:{type:"local-path",path:n},w=new d(o.dataDir),C={skill:s.skill,transport:s.transport,runtime:s.runtime,installPath:n,registeredAt:(new Date).toISOString(),status:"idle",source:j,...s.skillBody.length>0?{skillBody:s.skillBody}:{}};try{w.add(C),l.success(`Agent "${s.skill.name}" 注册成功`),k(s.skill.name,s.skill.env,o.env)}catch(e){l.error(e instanceof Error?e.message:String(e)),process.exitCode=1}}});function k(e,t,r){const i=s(e,t,r);if(i)return i.missingRequired.length>0?(l.warn(`Agent "${e}" 仍缺少必填环境变量: ${i.missingRequired.map(e=>e.name).join(", ")}`),l.info(`运行 \`roll config setup agent ${e}\` 交互式配置。`),void l.info(`运行 \`roll config explain agents.env.${e}\` 查看配置说明。`)):void(i.processEnvOnlyRequired.length>0&&(l.warn(`Agent "${e}" 当前依赖 shell 环境变量: ${i.processEnvOnlyRequired.map(e=>e.name).join(", ")}`),l.info(`建议运行 \`roll config setup agent ${e}\` 持久写入 roll.config.yaml。`)))}
+import{defineCommand as e}from"citty";import{resolve as t}from"node:path";import{existsSync as r}from"node:fs";import{inspectAgentEnvRequirements as i}from"../../config/helpers.js";import{loadAgentsConfig as o}from"../../config/loader.js";import{discoverAgent as s}from"../../registry/discovery.js";import{writeRemoteSkillManifest as n}from"../../registry/manifest.js";import{AgentStore as a}from"../../registry/store.js";import{cloneOrPullRepo as p,isGitUrl as m,repoNameFromUrl as c}from"../utils/git-source.js";import{log as d}from"../utils/output.js";import{reportAgentEnvGuidance as l}from"./agent-env-guidance.js";import{createInstallCommand as g,detectInstallCommand as f,formatPackageManagerCommand as u,formatPackageManagerError as y,runPackageManager as h}from"../utils/package-manager.js";export default e({meta:{description:"注册本地目录、Git 仓库或远程 MCP endpoint"},args:{path:{type:"positional",description:"本地 Agent 目录或 Git 仓库 URL；远程 endpoint 请用 --remote",required:!1},remote:{type:"string",description:"远程 MCP endpoint；需要同时提供 --name 和 --description"},name:{type:"string",description:"远程 Agent 名称（仅 --remote 时使用）"},description:{type:"string",description:"远程 Agent 描述（仅 --remote 时使用）"}},async run({args:e}){const{agentsConfig:k}=o();let L;if(e.remote){if(!e.name||!e.description)return d.error("远程注册需要同时提供 --name 和 --description"),void(process.exitCode=1);L=n({dataDir:k.dataDir,name:e.name,description:e.description,endpoint:e.remote})}else{if(!e.path)return d.error("请提供本地路径、Git URL，或使用 --remote <endpoint> 注册远程 Agent"),void(process.exitCode=1);if(m(e.path)){const i=c(e.path),o=t(k.dataDir,"repos",i),s=r(o);s?d.info(`仓库目录已存在，拉取最新代码: ${o}`):d.info(`克隆 ${e.path}...`);try{const{action:t}=await p(e.path,o);"cloned"===t&&d.success("克隆完成")}catch(e){return d.error(`${s?"git pull":"git clone"} 失败: ${e instanceof Error?e.message:String(e)}`),void(process.exitCode=1)}L=o}else if(L=t(e.path),!r(L))return d.error(`路径不存在: ${L}`),void(process.exitCode=1)}d.info("解析 SKILL.md...");const $=s(L);d.debug(`名称: ${$.skill.name}`),d.debug(`描述: ${$.skill.description}`),d.debug(`传输: ${$.transport.type}`);const j=t(L,"package.json"),v="1"===process.env.ROLL_SKIP_INSTALL;if(e.remote)d.info("远程 Agent 使用本地 manifest，无需安装依赖。");else if(r(j)&&!v){const e=f(L)??g("pnpm");d.info(`安装依赖 (${u(e)})...`);try{await h(e,{cwd:L}),d.success("依赖安装完成")}catch(t){return d.error(`依赖安装失败: ${y(e,t)}`),void(process.exitCode=1)}}else r(j)&&v&&d.warn("检测到 ROLL_SKIP_INSTALL=1，跳过依赖安装。");const A=e.remote?{type:"remote-manifest",endpoint:e.remote}:e.path&&m(e.path)?{type:"git",url:e.path}:{type:"local-path",path:L},C=new a(k.dataDir),S={skill:$.skill,transport:$.transport,runtime:$.runtime,installPath:L,registeredAt:(new Date).toISOString(),status:"idle",source:A,...$.skillBody.length>0?{skillBody:$.skillBody}:{}};try{C.add(S),d.success(`Agent "${$.skill.name}" 注册成功`),l($.skill.name,i($.skill.name,$.skill.env,k.env))}catch(e){d.error(e instanceof Error?e.message:String(e)),process.exitCode=1}}});

package/dist/cli/commands/agent-env-guidance.d.ts

@@ -0,0 +1,2 @@
+import type { AgentEnvCheckReport } from "../../config/helpers.ts";
+export declare function reportAgentEnvGuidance(agentName: string, envReport: AgentEnvCheckReport | undefined): void;

package/dist/cli/commands/agent-env-guidance.js

@@ -0,0 +1 @@
+import{log as n}from"../utils/output.js";export function reportAgentEnvGuidance(e,i){if(i)return i.missingRequired.length>0?(n.warn(`Agent "${e}" 仍缺少必填环境变量: ${i.missingRequired.map(n=>n.name).join(", ")}`),n.info(`运行 \`roll config setup agent ${e}\` 交互式配置。`),void n.info(`运行 \`roll config explain agents.env.${e}\` 查看配置说明。`)):void(i.processEnvOnlyRequired.length>0&&(n.warn(`Agent "${e}" 当前依赖 shell 环境变量: ${i.processEnvOnlyRequired.map(n=>n.name).join(", ")}`),n.info(`建议运行 \`roll config setup agent ${e}\` 持久写入 roll.config.yaml。`)))}

package/dist/cli/commands/agent-install.d.ts

@@ -14,5 +14,10 @@ declare const _default: import("citty").CommandDef<{
         description: string;
         default: true;
     };
+    force: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
 }>;
 export default _default;

package/dist/cli/commands/agent-install.js

@@ -1 +1 @@
-import{defineCommand as e}from"citty";import{existsSync as t,mkdirSync as r,statSync as i}from"node:fs";import{resolve as s}from"node:path";import{getAgentEnv as n,inspectAgentEnvRequirements as o}from"../../config/helpers.js";import{loadAgentsConfig as a,loadConfig as l,loadInstallConfig as p}from"../../config/loader.js";import{discoverAgent as m}from"../../registry/discovery.js";import{startAgent as c,stopAgentGracefully as g,waitForAgentReady as d}from"../../registry/process-manager.js";import{runAgentSetup as u}from"../../registry/runtime-setup.js";import{AgentStore as f}from"../../registry/store.js";import{parsePackageName as y,readInstalledPackageManifest as k,resolveInstalledPackageRoot as h,sanitizeInstallId as w}from"../../registry/source.js";import{log as $}from"../utils/output.js";import{buildNpmRetryPolicy as v,formatPackageManagerError as j,npmInstallNetworkArgs as C,runPackageManagerWithRetry as S}from"../utils/package-manager.js";function b(e){return C({...e.registry?{registry:e.registry}:{},fetchRetries:e.fetchRetries,preferOffline:e.preferOffline})}function x(e){return e.startsWith("git@")||e.startsWith("git+")||e.startsWith("github:")||e.startsWith("gitlab:")||e.startsWith("bitbucket:")||e.endsWith(".git")}export default e({meta:{description:"安装已发布的 Agent npm 包并注册到本地"},args:{package:{type:"positional",description:"npm 包名、版本范围或 .tgz 路径（源码目录请用 roll agent add）",required:!0},"skip-browser-setup":{type:"boolean",description:"跳过 Playwright 浏览器运行时安装/校验",default:!1},start:{type:"boolean",description:"安装后不自动启动 core-managed Agent",default:!0}},async run({args:e}){const{agentsConfig:o}=a();let C;try{C=p().installConfig}catch(e){return $.error(`install 配置无效，已停止安装：${e instanceof Error?e.message:String(e)}`),void(process.exitCode=1)}const R=e.package;if(x(R))return $.error(`Git URL 请使用 \`roll agent add ${R}\` 注册，不要使用 \`roll agent install\``),void(process.exitCode=1);const D=s(R);if(t(D)&&i(D).isDirectory())return $.error(`本地源码目录请使用 \`roll agent add ${R}\` 注册，不要使用 \`roll agent install\``),void(process.exitCode=1);const W=y(R),q=s(o.dataDir,"installed",w(W));t(q)||r(q,{recursive:!0}),C.registry&&$.info(`使用 npm registry: ${C.registry}（roll.config.yaml install.registry）`),$.info(`安装 ${R}...`);const B={command:"npm",args:["install","--prefix",q,R,...b(C)]};try{await S(B,{timeout:C.networkTimeoutMs},{...v(C.fetchRetries),onRetry:({attempt:e,delayMs:t})=>{$.warn(`安装遇到网络问题，${Math.round(t/1e3)}s 后重试（第 ${e+1} 次）...`)}})}catch(e){return $.error(`安装失败: ${j(B,e)}`),void(process.exitCode=1)}const E=h(q,W);if(!t(E))return $.error(`安装完成但未找到包目录: ${E}`),void(process.exitCode=1);const M=k(E);$.info("解析已安装 Agent 的 SKILL.md...");const O=m(E),L=new f(o.dataDir),T={skill:O.skill,transport:O.transport,runtime:O.runtime,installPath:E,registeredAt:(new Date).toISOString(),status:"idle",source:{type:"installed-package",packageName:M?.name??W,packageSpec:R,installDir:q,...M?.version?{installedVersion:M.version}:{}},...O.skillBody.length>0?{skillBody:O.skillBody}:{}};"core-managed"===T.runtime.ownership&&T.runtime.setup?.playwright&&!e["skip-browser-setup"]&&$.info(`即将安装浏览器运行时 (${T.runtime.setup.playwright.browsers.join(", ")})，这可能需要一些时间...`);const I=await u(T,{skipBrowserSetup:e["skip-browser-setup"]});I.ok?I.skipped?$.info(I.message):$.success(I.message):($.warn(`Agent setup 失败：${I.message}`),I.retryCommand&&$.info(`重试命令: ${I.retryCommand}`));const N=L.findByName(O.skill.name);try{const t="core-managed"===N?.runtime.ownership&&"online"===N.status;if("installed-package"===N?.source?.type?L.replace(N.skill.name,T):L.add(T),!I.ok)return L.updateStatus(O.skill.name,"error"),void(process.exitCode=1);if("core-managed"===T.runtime.ownership&&e.start){t&&await g(o.dataDir,T.skill.name),L.updateStatus(T.skill.name,"starting");let e=!1;try{c(T,o.dataDir,n(l().config,T.skill.name)),e=!0,await d(T,{startupTimeoutMs:15e3,probeTimeoutMs:2e3}),L.updateStatus(T.skill.name,"online")}catch(t){return e&&await g(o.dataDir,T.skill.name).catch(()=>{}),L.updateStatus(T.skill.name,"error"),$.error(`Agent "${O.skill.name}" 已安装，但自动启动失败：${t instanceof Error?t.message:String(t)}`),void(process.exitCode=1)}}$.success(`Agent "${O.skill.name}" 安装并注册成功`),A(O.skill.name,O.skill.env,o.env)}catch(e){$.error(e instanceof Error?e.message:String(e)),process.exitCode=1}}});function A(e,t,r){const i=o(e,t,r);if(i)return i.missingRequired.length>0?($.warn(`Agent "${e}" 仍缺少必填环境变量: ${i.missingRequired.map(e=>e.name).join(", ")}`),$.info(`运行 \`roll config setup agent ${e}\` 交互式配置。`),void $.info(`运行 \`roll config explain agents.env.${e}\` 查看配置说明。`)):void(i.processEnvOnlyRequired.length>0&&($.warn(`Agent "${e}" 当前依赖 shell 环境变量: ${i.processEnvOnlyRequired.map(e=>e.name).join(", ")}`),$.info(`建议运行 \`roll config setup agent ${e}\` 持久写入 roll.config.yaml。`)))}
+import{defineCommand as e}from"citty";import{getAgentEnv as t}from"../../config/helpers.js";import{loadAgentsConfig as r,loadConfig as o,loadInstallConfig as s}from"../../config/loader.js";import{catalogPackageSpec as a,findCatalogEntry as n}from"../../registry/catalog.js";import{resolveAgentCatalog as i}from"../../registry/catalog-discovery.js";import{installAgent as p}from"../../registry/install.js";import{log as g}from"../utils/output.js";import{reportAgentEnvGuidance as c}from"./agent-env-guidance.js";function l(e){if("retry"===e.type)return void g.warn(`安装遇到网络问题，${Math.round(e.delayMs/1e3)}s 后重试（第 ${e.attempt+1} 次）...`);({step:g.info,info:g.info,warn:g.warn,success:g.success})[e.type](e.message)}function m(e){if("setup"===e.step)return g.warn(`Agent setup 失败：${e.message}`),void(e.retryCommand&&g.info(`重试命令: ${e.retryCommand}`));g.error(e.message)}export default e({meta:{description:"安装已发布的 Agent npm 包并注册到本地"},args:{package:{type:"positional",description:"官方 Agent 短名（roll agent list --available 查看）、npm 包名、版本范围或 .tgz 路径（源码目录请用 roll agent add）",required:!0},"skip-browser-setup":{type:"boolean",description:"跳过 Playwright 浏览器运行时安装/校验",default:!1},start:{type:"boolean",description:"安装后自动启动 core-managed Agent（可用 --no-start 跳过）",default:!0},force:{type:"boolean",description:"确认风险并替换同名的非 npm 来源 Agent",default:!1}},async run({args:e}){const{agentsConfig:f}=r();let d;try{d=s().installConfig}catch(e){return g.error(`install 配置无效，已停止安装：${e instanceof Error?e.message:String(e)}`),void(process.exitCode=1)}const u=await i(void 0,{...d.registry?{registry:d.registry}:{}}),y=n(u,e.package),k=y?a(y.entry,y.versionSpec):e.package;y&&k!==e.package&&g.info(`已识别官方 Agent 短名：${e.package} → ${k}`);const v=await p({packageSpec:k,skipBrowserSetup:e["skip-browser-setup"],autoStart:e.start,replaceExisting:e.force,...y?{expectedSkillName:y.entry.skillName}:{}},{agentsConfig:f,installConfig:d,getStartEnv:e=>t(o().config,e),report:l});if(!v.ok)return m(v),void(process.exitCode=1);g.success(`Agent "${v.agent.skill.name}" 安装并注册成功`),c(v.agent.skill.name,v.envReport)}});

package/dist/cli/commands/agent-list.d.ts

@@ -4,5 +4,10 @@ declare const _default: import("citty").CommandDef<{
         description: string;
         default: false;
     };
+    available: {
+        type: "boolean";
+        description: string;
+        default: false;
+    };
 }>;
 export default _default;

package/dist/cli/commands/agent-list.js

@@ -1 +1 @@
-import{defineCommand as t}from"citty";import o from"cli-table3";import{loadAgentsConfig as r}from"../../config/loader.js";import{formatAgentSourceType as n,getAgentLocation as e,inferAgentSourceType as s}from"../../registry/source.js";import{AgentStore as a}from"../../registry/store.js";import{formatLocationForDisplay as i,resolveTerminalColumns as l}from"../utils/terminal.js";const c=6,g=2;export default t({meta:{description:"列出所有已注册 Agent"},args:{json:{type:"boolean",description:"JSON 格式输出",default:!1}},run({args:t}){const{agentsConfig:c}=r(),g=new a(c.dataDir).list();if(t.json)return void console.log(JSON.stringify(g,null,2));if(0===g.length)return void console.log("暂无已注册的 Agent。可使用 `roll agent add <path>`、`roll agent install <package>` 或 `roll agent add --remote <endpoint>`。");const u=m(l()),p=new o({head:["Name","Status","Source","Transport","Location"],colWidths:[...u],truncate:"…",style:{head:["cyan"]}});for(const t of g)p.push([t.skill.name,t.status,n(s(t)),t.transport.type,i(e(t),f(u[4]))]);console.log(p.toString())}});function m(t){const o=t-6,r=o-43-24;if(r>=15)return[24,10,14,19,r];const n=Math.max(16,o-43-15);return[n,10,14,19,o-43-n]}function f(t){return Math.max(1,t-2)}
+import{defineCommand as t}from"citty";import e from"chalk";import n from"cli-table3";import{loadAgentsConfig as o,loadInstallConfig as r}from"../../config/loader.js";import{resolveAgentCatalog as s}from"../../registry/catalog-discovery.js";import{formatAgentSourceType as a,getAgentLocation as i,inferAgentSourceType as l}from"../../registry/source.js";import{AgentStore as c}from"../../registry/store.js";import{inspectCatalogAvailability as d}from"../utils/catalog-status.js";import{formatLocationForDisplay as g,resolveTerminalColumns as u}from"../utils/terminal.js";const m=6,p=2;export default t({meta:{description:"列出所有已注册 Agent"},args:{json:{type:"boolean",description:"JSON 格式输出",default:!1},available:{type:"boolean",description:"列出官方 catalog 中可安装的 Agent 及安装状态",default:!1}},async run({args:t}){const{agentsConfig:e}=o(),r=new c(e.dataDir).list();if(t.available)return void await y(r,t.json);if(t.json)return void console.log(JSON.stringify(r,null,2));if(0===r.length)return void console.log("暂无已注册的 Agent。可使用 `roll agent add <path>`、`roll agent install <package>` 或 `roll agent add --remote <endpoint>`。");const s=h(u()),d=new n({head:["Name","Status","Source","Transport","Location"],colWidths:[...s],truncate:"…",style:{head:["cyan"]}});for(const t of r)d.push([t.skill.name,t.status,a(l(t)),t.transport.type,g(i(t),v(s[4]))]);console.log(d.toString())}});const f={"not-installed":t=>e.yellow("未安装")+(t.latestVersion?e.dim(` · 最新 v${t.latestVersion}`):""),installed:t=>{const n="installed-package"===t.installedAgent?.source?.type?t.installedAgent.source.installedVersion:void 0,o=e.green("已安装"+(n?` v${n}`:""));return"update-available"===t.update?.status&&t.latestVersion?`${o} ${e.yellow(`⬆ 可更新到 v${t.latestVersion}`)}`:o},"installed-other-source":t=>{const n=t.installedAgent?a(l(t.installedAgent)):"unknown";return e.green("已注册")+e.dim(`（${n} 来源）`)+(t.latestVersion?e.dim(` · npm 最新 v${t.latestVersion}`):"")}};async function y(t,n){let o;try{o=r().installConfig.registry}catch{o=void 0}const a=await s(void 0,{...o?{registry:o}:{}}),i=await d(a,t,{...o?{registry:o}:{}});if(n)return void console.log(JSON.stringify(i,null,2));const l=[];for(const t of i)l.push(`${e.cyan.bold(t.entry.shortName)}  ${e.dim(t.entry.packageName)}  ${f[t.state](t)}`),l.push(`  ${t.entry.description}`),l.push(`  ${e.dim("必需环境变量:")} ${t.entry.requiredEnv.length>0?t.entry.requiredEnv.join(", "):e.dim("安装后由 SKILL.md 声明")}`),l.push("");l.push("使用 `roll agent install <name>` 安装官方 Agent。"),console.log(l.join("\n"))}function h(t){const e=t-6,n=e-43-24;if(n>=15)return[24,10,14,19,n];const o=Math.max(16,e-43-15);return[o,10,14,19,e-43-o]}function v(t){return Math.max(1,t-2)}

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

@@ -1,6 +1,8 @@
 import type { AgentSession } from "@roll-agent/runtime";
 import { type ChatConfirm } from "../utils/chat-renderer.ts";
 import type { ChatCommandResult } from "../../types/chat.ts";
+import type { RollConfig } from "../../config/schema.ts";
+import type { LlmConfigReadiness } from "../../config/helpers.ts";
 type RuntimeModule = typeof import("@roll-agent/runtime");
 type ThreadStoreInstance = InstanceType<RuntimeModule["ThreadStore"]>;
 interface ReplIo {
@@ -8,6 +10,7 @@ interface ReplIo {
     readonly output: NodeJS.WritableStream;
     readonly confirm?: ChatConfirm;
 }
+export declare function resolveChatLlmReadiness(config: RollConfig): LlmConfigReadiness;
 export declare function runJsonTurn(session: AgentSession, message: string): Promise<ChatCommandResult>;
 export declare function runRepl(session: AgentSession, store: ThreadStoreInstance, isNewSession: boolean, io?: ReplIo): Promise<void>;
 declare const _default: import("citty").CommandDef<{

package/dist/cli/commands/chat.js

@@ -1 +1 @@
-import{defineCommand as e}from"citty";import{loadConfig as t}from"../../config/loader.js";import{resolveLLMCall as o,thinkingProviderOptions as s}from"../../llm/providers.js";import{createInterface as n}from"node:readline/promises";import i from"chalk";import r from"cli-table3";import{isDebugLogEnabled as a,log as l}from"../utils/output.js";import{ChatRenderer as c,clackConfirm as d}from"../utils/chat-renderer.js";import{titleFromMessage as u}from"../chat/title.js";const p=import.meta.url.endsWith(".ts")?"ts":"js";function m(e,t){return new e.ConfigurableToolPolicy({defaultMode:t.runtime.approval.default,overrides:t.runtime.approval.overrides})}function g(e){console.log(JSON.stringify(e,null,2))}function f(e){l.warn(`Agent "${e.agentName}" 启动失败：${e.message}`)}async function h(e,t,o){l.debug(`chat.repl input waiting · ${o}`),e.resume();try{const s=await e.question(t);return l.debug(`chat.repl input received · ${o} · chars=${String(s.length)}`),s}catch(e){const t=e instanceof Error?e.message:String(e);return void l.debug(`chat.repl input closed · ${o} · ${t}`)}finally{e.pause()}}async function v(){return import("@roll-agent/runtime")}async function w(e){const t=e.runtime.provider??e.llm.defaultProvider,s=e.runtime.model??e.llm.defaultModel,n=e.llm.providers[t];if(!n)return l.error(`LLM provider "${t}" 未配置。请检查 roll.config.yaml`),void(process.exitCode=1);const i=await v(),{ConversationEngine:r,ThreadStore:c,RuntimeServer:d,createStdioConnection:u}=i,{model:p,providerOptions:g}=o(t,s,n.apiKey,"chat",n.baseUrl,e.runtime.thinkingLevel),h=new c(e.runtime.threadsDir),w=new r({config:e,model:p,store:h,policy:m(i,e),maxSteps:e.runtime.maxSteps,...g?{providerOptions:g}:{},debugEvents:a(),onAgentBootstrapIssue:f}),y=u(process.stdin,process.stdout),b=new d(w,y);y.onClose(()=>{b.abortAll(),w.dispose().catch(()=>{}).finally(()=>{h.close(),process.exit(0)})}),l.info("roll runtime-server 已启动（stdio JSON-RPC，等待客户端连接）")}async function y(e,t){const{ThreadStore:o}=await v(),s=new o(e.runtime.threadsDir);try{const e=s.listThreads();if(t){const t=e.map(e=>({...e,messageCount:s.countMessages(e.id)}));return void console.log(JSON.stringify(t,null,2))}if(0===e.length)return void console.log('暂无会话。用 `roll chat "<message>"` 开始一个。');const o=new r({head:["Session ID","标题","消息","更新时间"],style:{head:["cyan"]}});for(const t of e)o.push([t.id,t.title??"-",String(s.countMessages(t.id)),t.updatedAt]);console.log(o.toString())}finally{s.close()}}export async function runJsonTurn(e,t){const o=[],s=[],n=[],i=[];let r,a,l,c,d="";for await(const u of e.send(t))switch(u.type){case"text-delta":d+=u.delta;break;case"tool-call":o.push({summary:`${u.agentName}.${u.toolName}`,agentName:u.agentName,toolName:u.toolName});break;case"confirmation-required":i.push({summary:`${u.agentName}.${u.toolName}`,agentName:u.agentName,toolName:u.toolName}),e.reject(u.approvalId,"json 模式不支持交互确认");break;case"step-finish":s.push({finishReason:u.finishReason,...u.usage?{usage:u.usage}:{}});break;case"message-finish":a=u.totalUsage,l=u.sessionUsage,c=u.contextInputTokens;break;case"context-compacted":n.push({reason:u.reason,strategy:u.strategy,removed:u.removed,kept:u.kept,...void 0!==u.truncatedTools?{truncatedTools:u.truncatedTools}:{},...void 0!==u.beforeInputTokens?{beforeInputTokens:u.beforeInputTokens}:{}});break;case"error":r=u.message}const u=e.getContextWindow();return void 0!==r?{status:"failed",stage:"execute",message:r,sessionId:e.id}:i.length>0?{status:"needs_confirmation",sessionId:e.id,message:"存在需要确认的工具调用，请在交互模式下执行或显式批准",pendingActions:i}:{status:"completed",sessionId:e.id,output:d,steps:o,...s.length>0?{stepUsages:s}:{},...a?{totalUsage:a}:{},...l?{sessionUsage:l}:{},...void 0!==u?{contextWindow:u}:{},...void 0!==c?{contextInputTokens:c}:{},...n.length>0?{compactions:n}:{}}}export async function runRepl(e,t,o,s={input:process.stdin,output:process.stdout}){const r=n({input:s.input,output:s.output});r.on("SIGINT",()=>r.close());const a=s.confirm??(async e=>{l.debug("chat.repl input waiting · confirm"),r.pause();const t=await d(e);return l.debug(`chat.repl input received · confirm · approved=${String(t)}`),t}),p=new c(a,e.getContextWindow());l.info("进入多轮对话（输入 exit / quit 或 Ctrl-C 退出，/compact 手动压缩上下文）");let m=!o,g=!1;try{for(;;){const o=await h(r,i.green("› "),"prompt");if(void 0===o)break;const s=o.trim();if(0!==s.length){if("exit"===s||"quit"===s)break;if("/compact"!==s){m||(t.updateTitle(e.id,u(s)),m=!0),g=!0,l.debug(`chat.repl send start · chars=${String(s.length)}`);for await(const t of e.send(s))await p.handle(t,e);l.debug("chat.repl send completed")}else{l.debug("chat.repl manual compact requested");for await(const t of e.compact("manual"))await p.handle(t,e);l.debug("chat.repl manual compact completed")}}}}finally{r.close(),o&&!g&&0===t.countMessages(e.id)&&t.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:n}=t();if(e.server)return void await w(n);if(e.list)return void await y(n,e.json);const i=n.runtime.provider??n.llm.defaultProvider,r=n.runtime.model??n.llm.defaultModel,h=n.llm.providers[i];if(!h)return l.error(`LLM provider "${i}" 未配置。请检查 roll.config.yaml`),void(process.exitCode=1);if(e.json&&!e.message)return l.error('--json 模式需要消息：roll chat "<message>" --json'),void(process.exitCode=1);const b=await v(),{ConversationEngine:x,ThreadStore:S}=b,{model:T,providerOptions:k}=o(i,r,h.apiKey,"chat",h.baseUrl,n.runtime.thinkingLevel),C=new S(n.runtime.threadsDir),I=new x({config:n,model:T,store:C,policy:m(b,n),maxSteps:n.runtime.maxSteps,...k?{providerOptions:k}:{},debugEvents:a(),onAgentBootstrapIssue:f});try{let t;if(e.session)t=await I.resumeSession(e.session);else if(e.last){const e=C.listThreads()[0];if(!e)return l.error('暂无可继续的会话，先用 `roll chat "<message>"` 开始一个'),void(process.exitCode=1);t=await I.resumeSession(e.id)}else t=await I.createSession(e.message?{title:u(e.message)}:{});if(e.json&&e.message){const o=await runJsonTurn(t,e.message);return g(o),void("completed"!==o.status&&(process.exitCode=1))}if(l.info(`会话 ${t.id}`),n.runtime.compaction.enabled&&void 0===t.getContextWindow()&&l.warn(`未知模型 "${r}" 的 context window，阈值自动压缩不可用。可在 roll.config.yaml 设置 runtime.context-window`),e.message){const o=new c(d,t.getContextWindow());for await(const s of t.send(e.message))await o.handle(s,t)}else{const o=!e.session&&!e.last,a=Boolean(process.stdout.isTTY&&process.stdin.isTTY&&"function"==typeof process.stdin.setRawMode);let c=!1;if(a)try{const e=new URL(`../chat/ink/run-ink-repl.${p}`,import.meta.url).href,{runInkRepl:a}=await import(e);await a(t,C,o,{model:r,initialThinkingLevel:n.runtime.thinkingLevel,onThinkingChange:e=>t.setProviderOptions(s(i,r,e))}),c=!0}catch(e){l.warn(`Ink TUI 不可用，回退到基础多轮模式：${e instanceof Error?e.message:String(e)}`)}c||await runRepl(t,C,o)}}catch(e){l.error(e instanceof Error?e.message:String(e)),process.exitCode=1}finally{await I.dispose(),C.close()}}});
+var e=this&&this.__rewriteRelativeImportExtension||function(e,t){return"string"==typeof e&&/^\.\.?\//.test(e)?e.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i,function(e,o,s,n,i){return o?t?".jsx":".js":!s||n&&i?s+n+"."+i.toLowerCase()+"js":e}):e};import{defineCommand as t}from"citty";import{inspectLlmConfigReadiness as o}from"../../config/helpers.js";import{loadConfig as s}from"../../config/loader.js";import{resolveLLMCall as n,thinkingProviderOptions as i}from"../../llm/providers.js";import{createInterface as r}from"node:readline/promises";import a from"chalk";import l from"cli-table3";import{isDebugLogEnabled as c,log as d}from"../utils/output.js";import{ChatRenderer as u,clackConfirm as p}from"../utils/chat-renderer.js";import{titleFromMessage as m}from"../chat/title.js";import{buildBannerLines as g,renderBannerText as f}from"../chat/banner.js";import{getCurrentVersion as h}from"../utils/update-checker.js";import{buildSkillInvocationPrompt as v,formatSkillList as w,parseSkillInvocation as y}from"../chat/ink/commands.js";const b=import.meta.url.endsWith(".ts")?"ts":"js";function k(e,t){return new e.ConfigurableToolPolicy({defaultMode:t.runtime.approval.default,overrides:t.runtime.approval.overrides})}function C(e){console.log(JSON.stringify(e,null,2))}function x(e){d.warn(`Agent "${e.agentName}" 启动失败：${e.message}`)}function S(e){d.warn(`skill 目录加载警告：${e}`)}function T(e,t){const o=y(t,e.getSkillSummaries());return o&&o.prompt.length>0?v(o):t}async function I(e,t,o){d.debug(`chat.repl input waiting · ${o}`),e.resume();try{const s=await e.question(t);return d.debug(`chat.repl input received · ${o} · chars=${String(s.length)}`),s}catch(e){const t=e instanceof Error?e.message:String(e);return void d.debug(`chat.repl input closed · ${o} · ${t}`)}finally{e.pause()}}async function j(){return import("@roll-agent/runtime")}async function $(t,o){const s=new URL(`./setup.${b}`,import.meta.url).href;return(await import(e(s))).runChatOnboarding({},{provider:t,model:o})}export function resolveChatLlmReadiness(e){return o(e,{provider:e.runtime.provider??e.llm.defaultProvider,model:e.runtime.model??e.llm.defaultModel})}async function N(e){const t=resolveChatLlmReadiness(e);if(!t.configured||!t.providerConfig)return d.error(t.message),void(process.exitCode=1);const o=t.providerConfig,s=t.provider,i=t.model,r=await j(),{ConversationEngine:a,ThreadStore:l,RuntimeServer:u,createStdioConnection:p}=r,{model:m,providerOptions:g}=n(s,i,o.apiKey,"chat",o.baseUrl,e.runtime.thinkingLevel),f=new l(e.runtime.threadsDir),h=new a({config:e,model:m,store:f,policy:k(r,e),maxSteps:e.runtime.maxSteps,...g?{providerOptions:g}:{},debugEvents:c(),onAgentBootstrapIssue:x,onSkillLibraryIssue:S}),v=p(process.stdin,process.stdout),w=new u(h,v);v.onClose(()=>{w.abortAll(),h.dispose().catch(()=>{}).finally(()=>{f.close(),process.exit(0)})}),d.info("roll runtime-server 已启动（stdio JSON-RPC，等待客户端连接）")}async function R(e,t){const{ThreadStore:o}=await j(),s=new o(e.runtime.threadsDir);try{const e=s.listThreads();if(t){const t=e.map(e=>({...e,messageCount:s.countMessages(e.id)}));return void console.log(JSON.stringify(t,null,2))}if(0===e.length)return void console.log('暂无会话。用 `roll chat "<message>"` 开始一个。');const o=new l({head:["Session ID","标题","消息","更新时间"],style:{head:["cyan"]}});for(const t of e)o.push([t.id,t.title??"-",String(s.countMessages(t.id)),t.updatedAt]);console.log(o.toString())}finally{s.close()}}export async function runJsonTurn(e,t){const o=[],s=[],n=[],i=[];let r,a,l,c,d="";for await(const u of e.send(t))switch(u.type){case"text-delta":d+=u.delta;break;case"tool-call":o.push({summary:`${u.agentName}.${u.toolName}`,agentName:u.agentName,toolName:u.toolName});break;case"confirmation-required":i.push({summary:`${u.agentName}.${u.toolName}`,agentName:u.agentName,toolName:u.toolName}),e.reject(u.approvalId,"json 模式不支持交互确认");break;case"step-finish":s.push({finishReason:u.finishReason,...u.usage?{usage:u.usage}:{}});break;case"message-finish":a=u.totalUsage,l=u.sessionUsage,c=u.contextInputTokens;break;case"context-compacted":n.push({reason:u.reason,strategy:u.strategy,removed:u.removed,kept:u.kept,...void 0!==u.truncatedTools?{truncatedTools:u.truncatedTools}:{},...void 0!==u.beforeInputTokens?{beforeInputTokens:u.beforeInputTokens}:{}});break;case"error":r=u.message}const u=e.getContextWindow();return void 0!==r?{status:"failed",stage:"execute",message:r,sessionId:e.id}:i.length>0?{status:"needs_confirmation",sessionId:e.id,message:"存在需要确认的工具调用，请在交互模式下执行或显式批准",pendingActions:i}:{status:"completed",sessionId:e.id,output:d,steps:o,...s.length>0?{stepUsages:s}:{},...a?{totalUsage:a}:{},...l?{sessionUsage:l}:{},...void 0!==u?{contextWindow:u}:{},...void 0!==c?{contextInputTokens:c}:{},...n.length>0?{compactions:n}:{}}}export async function runRepl(e,t,o,s={input:process.stdin,output:process.stdout}){const n=r({input:s.input,output:s.output});n.on("SIGINT",()=>n.close());const i=s.confirm??(async e=>{d.debug("chat.repl input waiting · confirm"),n.pause();const t=await p(e);return d.debug(`chat.repl input received · confirm · approved=${String(t)}`),t}),l=new u(i,e.getContextWindow()),c=e.getSkillSummaries();d.info("进入多轮对话（输入 exit / quit 或 Ctrl-C 退出，/compact 手动压缩上下文）");let g=!o,f=!1;try{for(;;){const o=await I(n,a.green("› "),"prompt");if(void 0===o)break;const s=o.trim();if(0===s.length)continue;if("exit"===s||"quit"===s)break;if("/compact"===s){d.debug("chat.repl manual compact requested");for await(const t of e.compact("manual"))await l.handle(t,e);d.debug("chat.repl manual compact completed");continue}if("/skills"===s){d.info(w(c,(process.stdout.columns||96)-2));continue}const i=y(s,c);if(i&&0===i.prompt.length){d.info("用法: /<skill-name> [/<skill-name> ...] 你的请求");continue}const r=i?v(i):s;g||(t.updateTitle(e.id,m(s)),g=!0),f=!0,d.debug(`chat.repl send start · chars=${String(s.length)}`);for await(const t of e.send(r))await l.handle(t,e);d.debug("chat.repl send completed")}}finally{n.close(),o&&!f&&0===t.countMessages(e.id)&&t.deleteThread(e.id)}}export default t({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}){let{config:t}=s();if(e.server)return void await N(t);if(e.list)return void await R(t,e.json);let o=resolveChatLlmReadiness(t);if(!o.configured){!0===process.stdin.isTTY&&!0===process.stderr.isTTY&&!e.json&&await $(o.provider,o.model)&&(t=s().config,o=resolveChatLlmReadiness(t))}if(!o.configured||!o.providerConfig)return d.error(o.message),void(process.exitCode=1);const r=o.providerConfig,a=o.provider,l=o.model;if(e.json&&!e.message)return d.error('--json 模式需要消息：roll chat "<message>" --json'),void(process.exitCode=1);const v=await j(),{ConversationEngine:w,ThreadStore:y}=v,{model:I,providerOptions:L}=n(a,l,r.apiKey,"chat",r.baseUrl,t.runtime.thinkingLevel),O=new y(t.runtime.threadsDir),U=new w({config:t,model:I,store:O,policy:k(v,t),maxSteps:t.runtime.maxSteps,...L?{providerOptions:L}:{},debugEvents:c(),onAgentBootstrapIssue:x,onSkillLibraryIssue:S,sessionExecEnabled:void 0===e.message});let E;try{let o;if(e.session)o=await U.resumeSession(e.session);else if(e.last){const e=O.listThreads()[0];if(!e)return d.error('暂无可继续的会话，先用 `roll chat "<message>"` 开始一个'),void(process.exitCode=1);o=await U.resumeSession(e.id)}else o=await U.createSession(e.message?{title:m(e.message)}:{});if(E=o,e.json&&e.message){const t=await runJsonTurn(o,T(o,e.message));return C(t),void("completed"!==t.status&&(process.exitCode=1))}if(d.info(`会话 ${o.id}`),t.runtime.compaction.enabled&&void 0===o.getContextWindow()&&d.warn(`未知模型 "${l}" 的 context window，阈值自动压缩不可用。可在 roll.config.yaml 设置 runtime.context-window`),e.message){const t=new u(p,o.getContextWindow());for await(const s of o.send(T(o,e.message)))await t.handle(s,o)}else{const s=!e.session&&!e.last,n=Boolean(process.stdout.isTTY&&process.stdin.isTTY&&"function"==typeof process.stdin.setRawMode),r=await U.getContextSummary(),c={version:h(),model:l,agentCount:r.agentCount,skillCount:r.skillCount};let u=!1;if(n)try{const e=new URL(`../chat/ink/run-ink-repl.${b}`,import.meta.url).href,{runInkRepl:n}=await import(e);await n(o,O,s,{model:l,banner:c,initialThinkingLevel:t.runtime.thinkingLevel,onThinkingChange:e=>o.setProviderOptions(i(a,l,e))}),u=!0}catch(e){d.warn(`Ink TUI 不可用，回退到基础多轮模式：${e instanceof Error?e.message:String(e)}`)}u||(process.stderr.write(`${f(g(c,process.stdout.columns||80))}\n`),await runRepl(o,O,s))}}catch(e){d.error(e instanceof Error?e.message:String(e)),process.exitCode=1}finally{E?.abort(),await U.dispose(),O.close()}}});

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

@@ -100,6 +100,33 @@ export declare const CONFIG_GUIDANCE_ENTRIES: readonly [{
     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: "runtime.shell.enabled";
+    readonly title: "Chat 内建 shell 工具";
+    readonly purpose: "开启后 `roll chat` 注册内建 shell 工具：macOS/Linux 为 `roll__bash`，Windows 原生为 `roll__powershell`（需 PowerShell 7+）。命令继承 roll 进程环境变量；默认确认策略可由 `runtime.approval` 及精确 override 覆盖。";
+    readonly defaultBehavior: `\u9ED8\u8BA4\u503C\u4E3A \`${string}\`\uFF08\u5173\u95ED\uFF09\u3002Windows \u672A\u68C0\u6D4B\u5230 pwsh 7+ \u65F6\u4F1A\u8DF3\u8FC7\u6CE8\u518C\u3002`;
+    readonly example: "runtime:\n  shell:\n    enabled: true";
+    readonly setupCommand: "roll config setup shell";
+}, {
+    readonly path: "runtime.shell.auto-approve-safe";
+    readonly title: "只读命令免确认";
+    readonly purpose: "开启后用内建规则分类器识别 POSIX known-safe 只读命令（如 `ls`、`cat`、`git status`），在 `guarded`/`auto` 策略下免确认执行；dangerous（`rm -rf`、`sudo`）与无法识别的命令默认仍需确认。工具级显式 approval override 优先；Windows PowerShell 当前全部按 unknown 处理。";
+    readonly defaultBehavior: `\u9ED8\u8BA4\u503C\u4E3A \`${string}\`\u3002\u5173\u95ED\u540E POSIX \u56DE\u5F52\u9ED8\u8BA4\u9010\u6761\u786E\u8BA4\uFF1BWindows PowerShell \u9ED8\u8BA4\u9010\u6761\u786E\u8BA4\uFF0C\u663E\u5F0F approval override \u53EF\u8986\u76D6\u3002`;
+    readonly example: "runtime:\n  shell:\n    enabled: true\n    auto-approve-safe: false";
+    readonly setupCommand: "roll config setup shell";
+}, {
+    readonly path: "runtime.shell.session.enabled";
+    readonly title: "Chat 会话式长命令执行";
+    readonly purpose: "开启后在 POSIX shell 后端注册 `roll__exec_command` + `roll__exec_poll` 工具：命令在后台会话执行、跨轮存活，模型轮询进度并读取退出码，适合超过单轮超时的长脚本。Windows 原生 session exec 暂未支持。仅交互 REPL 与 `--server` 长驻模式注册（单条消息 / `--json` 单轮会话随进程结束，不提供该工具）；`--server` 下 `exec_command` 需 `runtime.approval.overrides` 里 `roll.exec_command: auto` 显式授权。";
+    readonly defaultBehavior: `\u9ED8\u8BA4\u503C\u4E3A \`${string}\`\uFF08\u5173\u95ED\uFF09\u3002\u9700\u540C\u65F6\u5F00\u542F runtime.shell.enabled\uFF1B\u80CC\u666F\u4F1A\u8BDD\u968F roll chat \u8FDB\u7A0B\u9000\u51FA\u800C\u7EC8\u6B62\u3002`;
+    readonly example: "runtime:\n  shell:\n    enabled: true\n    session:\n      enabled: true\n  approval:\n    overrides:\n      roll.exec_command: auto";
+    readonly setupCommand: "roll config setup shell";
+}, {
+    readonly path: "skills.dirs";
+    readonly title: "Chat 额外 skill 目录";
+    readonly purpose: "`roll chat` 除自动发现项目与用户级 `.agents/skills`（`npx skills add` 的标准安装位置）及已注册 Agent 的 SKILL.md 外，额外加载的 skill 目录。目录可以直接包含 SKILL.md，也可以是多个 skill 子目录的集合。";
+    readonly defaultBehavior: "默认为空。标准路径 `<项目>/.agents/skills` 与 `~/.agents/skills` 始终自动发现。";
+    readonly example: "skills:\n  dirs:\n    - ./openclaw-roll-core-skill-template";
 }, {
     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:"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)}
+import{DEFAULT_CONFIG as e}from"../../config/defaults.js";import{normalizeUserPath as l}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:"runtime.shell.enabled",title:"Chat 内建 shell 工具",purpose:"开启后 `roll chat` 注册内建 shell 工具：macOS/Linux 为 `roll__bash`，Windows 原生为 `roll__powershell`（需 PowerShell 7+）。命令继承 roll 进程环境变量；默认确认策略可由 `runtime.approval` 及精确 override 覆盖。",defaultBehavior:`默认值为 \`${String(e.runtime.shell.enabled)}\`（关闭）。Windows 未检测到 pwsh 7+ 时会跳过注册。`,example:"runtime:\n  shell:\n    enabled: true",setupCommand:"roll config setup shell"},{path:"runtime.shell.auto-approve-safe",title:"只读命令免确认",purpose:"开启后用内建规则分类器识别 POSIX known-safe 只读命令（如 `ls`、`cat`、`git status`），在 `guarded`/`auto` 策略下免确认执行；dangerous（`rm -rf`、`sudo`）与无法识别的命令默认仍需确认。工具级显式 approval override 优先；Windows PowerShell 当前全部按 unknown 处理。",defaultBehavior:`默认值为 \`${String(e.runtime.shell.autoApproveSafe)}\`。关闭后 POSIX 回归默认逐条确认；Windows PowerShell 默认逐条确认，显式 approval override 可覆盖。`,example:"runtime:\n  shell:\n    enabled: true\n    auto-approve-safe: false",setupCommand:"roll config setup shell"},{path:"runtime.shell.session.enabled",title:"Chat 会话式长命令执行",purpose:"开启后在 POSIX shell 后端注册 `roll__exec_command` + `roll__exec_poll` 工具：命令在后台会话执行、跨轮存活，模型轮询进度并读取退出码，适合超过单轮超时的长脚本。Windows 原生 session exec 暂未支持。仅交互 REPL 与 `--server` 长驻模式注册（单条消息 / `--json` 单轮会话随进程结束，不提供该工具）；`--server` 下 `exec_command` 需 `runtime.approval.overrides` 里 `roll.exec_command: auto` 显式授权。",defaultBehavior:`默认值为 \`${String(e.runtime.shell.session.enabled)}\`（关闭）。需同时开启 runtime.shell.enabled；背景会话随 roll chat 进程退出而终止。`,example:"runtime:\n  shell:\n    enabled: true\n    session:\n      enabled: true\n  approval:\n    overrides:\n      roll.exec_command: auto",setupCommand:"roll config setup shell"},{path:"skills.dirs",title:"Chat 额外 skill 目录",purpose:"`roll chat` 除自动发现项目与用户级 `.agents/skills`（`npx skills add` 的标准安装位置）及已注册 Agent 的 SKILL.md 外，额外加载的 skill 目录。目录可以直接包含 SKILL.md，也可以是多个 skill 子目录的集合。",defaultBehavior:"默认为空。标准路径 `<项目>/.agents/skills` 与 `~/.agents/skills` 始终自动发现。",example:"skills:\n  dirs:\n    - ./openclaw-roll-core-skill-template"},{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=l(e.split(".")).join(".");return CONFIG_GUIDANCE_ENTRIES.find(e=>t(e.path,r))}function t(e,t){const r=l(e.split(".")).join(".");if(r===t)return!0;const a=r.split("."),n=t.split(".");return a.length===n.length&&a.every((e,l)=>e.startsWith("<")||e===n[l])}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/commands/config-prompts.d.ts

@@ -33,5 +33,11 @@ export interface ConfigPromptAdapter {
         readonly message: string;
         readonly initialValue?: boolean;
     }): Promise<boolean>;
+    multiselect<Value extends string>(options: {
+        readonly message: string;
+        readonly options: readonly PromptOption<Value>[];
+        readonly initialValues?: readonly Value[];
+        readonly required?: boolean;
+    }): Promise<readonly Value[]>;
 }
 export declare const clackPromptAdapter: ConfigPromptAdapter;

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

@@ -1 +1 @@
-import{cancel as e,confirm as t,intro as a,isCancel as l,log as i,outro as u,password as o,select as r,text as n}from"@clack/prompts";const s=process.stderr;export class ConfigSetupCancelledError extends Error{constructor(){super("配置向导已取消")}}export const clackPromptAdapter={intro(e){a(e,{output:s})},outro(e){u(e,{output:s})},info(e){i.info(e,{output:s})},warn(e){i.warn(e,{output:s})},async select(e){const t=e.options.map(e=>e.hint?{value:e.value,label:e.label,hint:e.hint}:{value:e.value,label:e.label});return p(await r({message:e.message,options:t,output:s,...e.initialValue?{initialValue:e.initialValue}:{}}))},text:async e=>p(await n({message:e.message,output:s,...e.placeholder?{placeholder:e.placeholder}:{},...void 0!==e.defaultValue?{defaultValue:e.defaultValue}:{},...void 0!==e.initialValue?{initialValue:e.initialValue}:{},validate(t){const a=t??"";return e.required&&0===a.trim().length?"此项不能为空":e.validate?.(a)}})),password:async e=>p(await o({message:e.message,output:s,validate(t){const a=t??"";return e.required&&0===a.trim().length?"此项不能为空":e.validate?.(a)}})),confirm:async e=>p(await t({message:e.message,output:s,...void 0!==e.initialValue?{initialValue:e.initialValue}:{}}))};function p(t){if(l(t))throw e("已取消",{output:s}),new ConfigSetupCancelledError;return t}
+import{cancel as e,confirm as a,intro as t,isCancel as l,log as i,multiselect as u,outro as n,password as o,select as r,text as s}from"@clack/prompts";const p=process.stderr;export class ConfigSetupCancelledError extends Error{constructor(){super("配置向导已取消")}}export const clackPromptAdapter={intro(e){t(e,{output:p})},outro(e){n(e,{output:p})},info(e){i.info(e,{output:p})},warn(e){i.warn(e,{output:p})},async select(e){const a=e.options.map(e=>e.hint?{value:e.value,label:e.label,hint:e.hint}:{value:e.value,label:e.label});return c(await r({message:e.message,options:a,output:p,...e.initialValue?{initialValue:e.initialValue}:{}}))},async text(e){const a=e.placeholder??e.defaultValue;return c(await s({message:e.message,output:p,...a?{placeholder:a}:{},...void 0!==e.defaultValue?{defaultValue:e.defaultValue}:{},...void 0!==e.initialValue?{initialValue:e.initialValue}:{},validate(a){const t=a??"";if(0!==t.trim().length||void 0===e.defaultValue)return e.required&&0===t.trim().length?"此项不能为空":e.validate?.(t)}}))},password:async e=>c(await o({message:e.message,output:p,validate(a){const t=a??"";return e.required&&0===t.trim().length?"此项不能为空":e.validate?.(t)}})),confirm:async e=>c(await a({message:e.message,output:p,...void 0!==e.initialValue?{initialValue:e.initialValue}:{}})),async multiselect(e){const a=e.options.map(e=>e.hint?{value:e.value,label:e.label,hint:e.hint}:{value:e.value,label:e.label});return c(await u({message:e.message,options:a,output:p,required:e.required??!1,...e.initialValues?{initialValues:[...e.initialValues]}:{}})).map(e=>e)}};function c(a){if(l(a))throw e("已取消",{output:p}),new ConfigSetupCancelledError;return a}

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

@@ -1,3 +1,8 @@
 import { type ConfigPromptAdapter } from "./config-prompts.ts";
-export type ConfigSetupModule = "llm" | "install" | "agent";
+export type ConfigSetupModule = "llm" | "install" | "agent" | "shell";
 export declare function runConfigSetup(moduleArg: string | undefined, valueArg: string | undefined, prompts?: ConfigPromptAdapter): Promise<void>;
+export declare function setupLlm(prompts: ConfigPromptAdapter): Promise<string>;
+export declare function setupInstall(prompts: ConfigPromptAdapter): Promise<string>;
+export declare function setupShell(prompts: ConfigPromptAdapter, platform?: NodeJS.Platform): Promise<string>;
+export declare function setupBash(prompts: ConfigPromptAdapter): Promise<string>;
+export declare function setupAgentEnv(agentNameArg: string | undefined, prompts: ConfigPromptAdapter): Promise<string>;