@cjhyy/code-shell 0.2.0 → 0.3.0

package/dist/chunk-Q3RSX66I.js

@@ -1 +0,0 @@
-import {M,da,ca,W,fa}from'./chunk-MGP35GKD.js';import {h,a}from'./chunk-3QP5BQ3L.js';import {join}from'path';import {homedir}from'os';h();h();function R(y,s){let{preset:e,adapter:t,contract:o}=y,w=e.name,x=["Read","Write","Edit","Glob","Grep","Bash","AskUserQuestion","Agent","ToolSearch","TaskCreate","TaskList","TaskUpdate","TaskGet"],i=new Set([...x,...t?.enableTools??[]]);for(let n of t?.disableTools??[])i.delete(n);let S=[{tool:"Read",decision:"allow"},{tool:"Glob",decision:"allow"},{tool:"Grep",decision:"allow"},{tool:"AskUserQuestion",decision:"allow"},{tool:"ToolSearch",decision:"allow"},{tool:"TaskCreate",decision:"allow"},{tool:"TaskList",decision:"allow"},{tool:"TaskUpdate",decision:"allow"},{tool:"TaskGet",decision:"allow"},...t?.permissionRules??[]],l={name:w,label:e.label,description:e.description,promptSections:e.sections??["base","orchestration"],injectGitStatus:e.injectGitStatus??false,builtinTools:[...i],defaultPermissionRules:S};M(l);let r;o?.evaluator?Array.isArray(o.evaluator)?r=new da(o.evaluator):r=o.evaluator:r=new ca;let c=t?.tools??[],d=c.map(n=>({definition:n.definition,execute:n.execute})),u=s.runsDir??join(homedir(),".code-shell","runs"),k=new W(u);return {manager:new fa({store:k,executor:{llm:s.llm,maxTurns:o?.maxTurns??30,maxContextTokens:o?.maxContextTokens??2e5,permissionMode:s.permissionMode??"acceptEdits",sessionStorageDir:s.sessionStorageDir,mcpServers:t?.mcpServers,enabledBuiltinTools:[...i],disabledBuiltinTools:t?.disableTools,customSystemPrompt:e.customPrompt,appendSystemPrompt:e.appendPrompt,hooks:t?.hooks,customTools:d.length>0?d:void 0},concurrency:o?.concurrency??1,runsDir:u,evaluator:r,defaultTags:o?.defaultTags,defaultMetadata:o?.defaultMetadata}),preset:l,customTools:c}}a(R,"defineProduct");export{R as a};

package/dist/chunk-VKKU4LOM.js

@@ -1,3 +0,0 @@
-import {a as a$2}from'./chunk-O5HFCH2U.js';import {a as a$1}from'./chunk-2EUIMKJA.js';import {b as b$1,c,d}from'./chunk-FU7AHZNN.js';import {b}from'./chunk-ZSAONDT6.js';import {h,a}from'./chunk-3QP5BQ3L.js';import O from'openai';h();h();h();var I=[{kind:"openai",match:/^(?:o[1-9]\d*|gpt-[5-9])(?:[-.]|$)/i,capability:{tokenLimitField:"max_completion_tokens",rejectedParams:new Set(["temperature","top_p","presence_penalty","frequency_penalty","logit_bias","logprobs","top_logprobs"]),reasoning:{kind:"openai-effort"},echoReasoning:"optional"},why:"OpenAI o-series + gpt-5+ reject classic sampling params; use max_completion_tokens + reasoning_effort."},{kind:"deepseek",match:/^deepseek-v4(?:[-.]|$)/i,capability:{reasoning:{kind:"deepseek-thinking"},echoReasoning:"when-tools"},why:"DeepSeek V4 thinking mode \u2014 top-level thinking:{type}; echo reasoning_content when tools are present."},{kind:"deepseek",match:/^deepseek-reasoner(?:[-.]|$)/i,capability:{reasoning:{kind:"none"},echoReasoning:"never"},why:"deepseek-reasoner refuses prior reasoning_content in input; always-on reasoning, no toggle."},{kind:"zai",match:/^glm-[4-9](?:[-.]|$)/i,capability:{reasoning:{kind:"deepseek-thinking"},echoReasoning:"optional"},why:"Z.AI GLM-4.5+ thinking shape is identical to DeepSeek V4; default is enabled."},{kind:"anthropic",match:/^claude-(?:opus|sonnet|haiku)-4-[6-9](?:[-.]|$)/i,capability:{reasoning:{kind:"anthropic-adaptive"},echoReasoning:"when-tools",parallelToolCalls:"anthropic-disable-flag",streamUsage:"auto"},why:"Claude 4.6+ thinking is adaptive \u2014 no opt-in field. Echo thinking blocks on tool turns."},{kind:"anthropic",match:/^claude-(?:opus|sonnet|haiku)-4(?:[-.]|$)/i,capability:{reasoning:{kind:"anthropic-budget",minBudgetTokens:1024},echoReasoning:"when-tools",parallelToolCalls:"anthropic-disable-flag",streamUsage:"auto"},why:"Claude 4.x \u22644.5 supports explicit thinking:{type:enabled, budget_tokens\u22651024}."},{kind:"anthropic",match:/^claude-/i,capability:{parallelToolCalls:"anthropic-disable-flag",streamUsage:"auto"},why:"Pre-Claude-4 \u2014 no extended thinking; keep Anthropic tool_choice/stream shape."},{kind:"google",match:/^gemini-(?:[2-9]\.\d|[2-9])/i,capability:{reasoning:{kind:"openai-effort"},echoReasoning:"optional"},why:"Gemini 2.5+ via OpenAI-compat \u2014 reasoning_effort is auto-mapped to thinking_level."},{kind:"openrouter",match:/./,capability:{reasoning:{kind:"openrouter-reasoning"},echoReasoning:"optional"},why:"OpenRouter exposes a unified reasoning:{effort,max_tokens,exclude,enabled} field for every backend."},{kind:"xai",match:/^grok-4\.3(?:[-.]|$)/i,capability:{reasoning:{kind:"openai-effort",disabledEffort:"low"}},why:"xAI grok-4.3 supports reasoning_effort none|low|medium|high \u2014 no `minimal`."},{kind:"mistral",match:/^magistral/i,capability:{reasoning:{kind:"openai-effort",disabledEffort:"none"}},why:"Mistral magistral models accept only reasoning_effort `high` or `none`."},{kind:"groq",match:/^(?:gpt-oss-(?:20b|120b)|qwen3-)/i,capability:{reasoning:{kind:"openai-effort"},tokenLimitField:"max_completion_tokens"},why:"Groq reasoning-capable models use max_completion_tokens + reasoning_effort."}];h();var y={tokenLimitField:"max_tokens",rejectedParams:new Set,reasoning:{kind:"none"},echoReasoning:"optional",parallelToolCalls:"openai-flag",streamUsage:"include-usage-flag"};function S(_,e){for(let t of I)if(t.kind===_&&t.match.test(e))return {...y,...t.capability,rejectedParams:t.capability.rejectedParams?new Set(t.capability.rejectedParams):new Set(y.rejectedParams)};return {...y,rejectedParams:new Set(y.rejectedParams)}}a(S,"capabilitiesFor");var E=class extends a$1{static{a(this,"OpenAIClient");}_client=null;_forceMaxCompletionTokens=false;constructor(e){super(e);}initClient(){}get client(){return this._client||(this._client=new O({apiKey:this.config.apiKey??process.env.OPENAI_API_KEY,...this.config.baseUrl?{baseURL:this.config.baseUrl}:{},timeout:this.timeout})),this._client}_capability=null;get capability(){if(!this._capability){let e=this.config.providerKind??"openai";this._capability=S(e,this.model);}return this._capability}async createMessage(e){return this.withRetry(async()=>{let t=e.thinking??this.config.thinking,c=this.buildMessages(e.systemPrompt,e.messages,t),i=e.tools?.length?this.convertTools(e.tools):void 0,a=b.span("llm.request",{cat:"llm",provider:this.provider,model:this.model,stream:!!(e.stream&&e.onChunk),messageCount:c.length,toolCount:i?.length??0});try{let n=e.stream&&e.onChunk?await this.streamMessage(e,c,i,t):await this.nonStreamMessage(e,c,i,t);return a.end({stopReason:n.stopReason,promptTokens:n.usage?.promptTokens,completionTokens:n.usage?.completionTokens,cacheReadTokens:n.usage?.cacheReadTokens,cacheCreationTokens:n.usage?.cacheCreationTokens}),n}catch(n){throw a.fail(n),n}})}buildRequestBody(e,t,c,i,a){let n=this.capability,d=e.maxTokens??this.maxTokens,s=this._forceMaxCompletionTokens||n.tokenLimitField==="max_completion_tokens"?{max_completion_tokens:d}:{max_tokens:d},p={};n.rejectedParams.has("temperature")||(p.temperature=e.temperature!==void 0?e.temperature:this.temperature);let r={};if(i)switch(n.reasoning.kind){case "deepseek-thinking":r.thinking={type:i};break;case "openai-effort":r.reasoning_effort=i==="disabled"?n.reasoning.disabledEffort??"minimal":"medium";break;case "openrouter-reasoning":r.reasoning=i==="disabled"?{effort:"minimal",exclude:true}:{effort:"medium"};break;}return {model:this.model,messages:t,...s,...p,...r,...c?{tools:c}:{},...a?{stream:true,stream_options:{include_usage:true}}:{}}}async nonStreamMessage(e,t,c,i){try{let a=await this.client.chat.completions.create(this.buildRequestBody(e,t,c,i,!1),{signal:e.signal}),n=a.choices[0];if(!n)throw new b$1("No response from OpenAI","openai");let d={promptTokens:a.usage?.prompt_tokens??0,completionTokens:a.usage?.completion_tokens??0,totalTokens:a.usage?.total_tokens??0};return this.recordUsage(d,e),this.processChoice(n,d)}catch(a){throw this.handleApiError(a),a}}async streamMessage(e,t,c,i){try{let a=await this.client.chat.completions.create(this.buildRequestBody(e,t,c,i,!0),{signal:e.signal}),n="",d="",h=new Map,s,p=Date.now(),r=!1;for await(let o of a){o.usage&&(s=o.usage);let m=o.choices[0]?.delta;if(!m)continue;let w=m.reasoning_content;if(typeof w=="string"&&w.length>0&&(d+=w),m.content&&(r||(r=!0,b.debug("llm.first_byte",{cat:"llm",provider:this.provider,model:this.model,ttft_ms:Date.now()-p})),n+=m.content,e.onChunk?.({type:"text",text:m.content,tokens:a$2(m.content)})),m.tool_calls)for(let g of m.tool_calls){let x=g.index;h.has(x)||(h.set(x,{id:g.id??"",name:g.function?.name??"",args:""}),e.onChunk?.({type:"tool_use_start",toolCall:{id:g.id,toolName:g.function?.name}}));let f=h.get(x);if(g.id&&(f.id=g.id),g.function?.name&&(f.name=g.function.name),g.function?.arguments&&(f.args+=g.function.arguments,f.id))try{let U=JSON.parse(f.args||"{}");e.onChunk?.({type:"tool_use_delta",toolCall:{id:f.id,toolName:f.name,args:U}});}catch{}}o.choices[0]?.finish_reason&&e.onChunk?.({type:"stop",stopReason:o.choices[0].finish_reason});}let l=[];for(let[,o]of h){let m={};try{m=JSON.parse(o.args||"{}");}catch{}l.push({id:o.id,toolName:o.name,args:m});}let k={promptTokens:s?.prompt_tokens??0,completionTokens:s?.completion_tokens??0,totalTokens:s?.total_tokens??0};return this.recordUsage(k,e),{text:n,toolCalls:l,usage:k,stopReason:"stop",...d?{reasoningContent:d}:{}}}catch(a){throw this.handleApiError(a),a}}processChoice(e,t){let c=e.message.content??"",i=[];if(e.message.tool_calls)for(let n of e.message.tool_calls){let d={};try{d=JSON.parse(n.function.arguments||"{}");}catch{}i.push({id:n.id,toolName:n.function.name,args:d});}let a=j(e.message);return {text:c,toolCalls:i,usage:t,stopReason:e.finish_reason??void 0,...a?{reasoningContent:a}:{}}}buildMessages(e,t,c){let i=[{role:"system",content:e}],a=this.capability,n=t.some(s=>Array.isArray(s.content)&&s.content.some(p=>p.type==="tool_use"||p.type==="tool_result")),d=c!=="disabled"&&a.echoReasoning==="when-tools"&&n,h=a.echoReasoning==="never";for(let s of t)if(s.role!=="system")if(s.role==="assistant"){let p={role:"assistant"},r;if(typeof s.content=="string")p.content=s.content;else {let l=[],k=[];for(let o of s.content)o.type==="text"&&o.text?l.push(o.text):o.type==="tool_use"&&o.id&&o.name?k.push({id:o.id,type:"function",function:{name:o.name,arguments:JSON.stringify(o.input??{})}}):o.type==="reasoning"&&o.reasoningContent&&(r=o.reasoningContent),!r&&o.reasoningContent&&(r=o.reasoningContent);l.length&&(p.content=l.join(`
-`)),k.length&&(p.tool_calls=k);}h?r=void 0:!r&&d&&(r=""),r!==void 0&&(p.reasoning_content=r),i.push(p);}else if(s.role==="tool")i.push({role:"tool",tool_call_id:s.tool_call_id??"",content:typeof s.content=="string"?s.content:""});else if(typeof s.content=="string")i.push({role:"user",content:s.content});else {let p=[],r=[];for(let l of s.content)l.type==="tool_result"&&l.tool_use_id?r.push({tool_use_id:l.tool_use_id,content:typeof l.content=="string"?l.content:""}):l.type==="text"&&l.text&&p.push(l.text);for(let l of r)i.push({role:"tool",tool_call_id:l.tool_use_id,content:l.content});p.length>0&&i.push({role:"user",content:p.join(`
-`)});}return i}convertTools(e){return e.map(t=>({type:"function",function:{name:t.name,description:t.description,parameters:t.inputSchema}}))}handleApiError(e){if(e instanceof O.APIError){if(e.status===429)throw new c("openai");let t=(e.message??"").toLowerCase();throw e.status===400&&t.includes("max_tokens")&&t.includes("max_completion_tokens")&&(this._forceMaxCompletionTokens=true),t.includes("context_length_exceeded")||t.includes("maximum context length")||t.includes("too many tokens")||t.includes("prompt is too long")?new d("openai"):e.status===401&&t.includes("provider returned error")?new b$1(`OpenAI-compatible endpoint returned 401 "Provider returned error". Two likely causes: (1) the API key is invalid/revoked, or (2) the upstream provider rejects tool calls for this model (common on OpenRouter's gpt-4o-mini route). Verify the key, then try a tool-capable model such as openai/gpt-4.1-mini or anthropic/claude-3.5-haiku.`,"openai",{status:e.status}):new b$1(`OpenAI API error: ${e.message}`,"openai",{status:e.status})}throw e}};function j(_){let e=_.reasoning_content??_.reasoning;return typeof e=="string"&&e.length>0?e:void 0}a(j,"extractReasoningContent");export{E as a};

package/dist/chunk-ZSAONDT6.js

@@ -1,2 +0,0 @@
-import {h as h$1,a as a$1}from'./chunk-3QP5BQ3L.js';import {existsSync,mkdirSync,appendFileSync,readdirSync,unlinkSync}from'fs';import {join}from'path';import {homedir}from'os';h$1();var l={debug:0,info:1,warn:2,error:3},g=join(homedir(),".code-shell","logs"),h=7,x=100,_=new Set(["ui","ink","render","stream"]);function D(n,e){let r=(n??e??"").toLowerCase();return _.has(r)?"ui-ink":"engine"}a$1(D,"routeBucket");function C(){return process.env.CODE_SHELL_DEV==="1"||process.argv.includes("--debug")||process.argv.includes("-d")||process.argv.some(e=>e.startsWith("--debug="))?true:process.env.NODE_ENV==="test"||process.env.BUN_TEST==="1"||process.argv.some(e=>e.includes("/tests/")||e.endsWith(".test.ts"))?false:!!(process.argv[1]??"").includes("/src/")}a$1(C,"isLocalDev");function O(){let n=process.env.CODE_SHELL_LOG_LEVEL?.toLowerCase().trim();return n&&Object.hasOwn(l,n)?n:C()?"debug":"info"}a$1(O,"resolveDefaultLevel");function F(){let n=process.argv.find(t=>t.startsWith("--debug=")),e;if(n)e=n.slice(8);else {let t=process.env.CODE_SHELL_DEBUG;t&&t!=="1"&&t!=="true"&&(e=t);}if(!e)return null;let r=new Set(e.split(",").map(t=>t.trim().toLowerCase()).filter(Boolean));return r.size>0?r:null}a$1(F,"resolveCategoryFilter");var v=`${Date.now()}-${Math.random().toString(36).slice(2,8)}`;function M(n){v=n;}a$1(M,"setCurrentSid");function $(){return v}a$1($,"getCurrentSid");var a=[];var d=class n{constructor(e={}){this.context=e;this.enabled=process.env.CODE_SHELL_LOG!=="0",this.minLevel=O(),this.categoryFilter=F(),this.stderrEcho=process.env.CODE_SHELL_DEBUG==="1"||process.argv.includes("--debug-to-stderr")||process.argv.includes("-d2e");}static{a$1(this,"Logger");}enabled;minLevel;categoryFilter;stderrEcho;dirReady=false;child(e){return new n({...this.context,...e})}setSid(e){M(e);}getSid(){return $()}debug(e,r){this.write("debug",e,r);}info(e,r){this.write("info",e,r);}warn(e,r){this.write("warn",e,r);}error(e,r){let t,o;typeof e=="string"?(t=e,r instanceof Error?(o={error:r.message,stack:r.stack}):o=r):e instanceof Error?(t=e.message,o={stack:e.stack}):t=String(e),this.recordError(t,o),this.write("error",t,o);}recordError(e,r){a.length>=x&&a.shift(),a.push({msg:e,t:new Date().toISOString(),data:r});}write(e,r,t){if(!this.enabled||l[e]<l[this.minLevel])return;let o=t?.cat??this.context.cat;if(e==="debug"&&this.categoryFilter&&(!o||!this.categoryFilter.has(o.toLowerCase())))return;let i=new Date().toISOString(),c={t:i,l:e,msg:r,...this.context};o&&!c.cat&&(c.cat=o),c.sid===void 0&&(c.sid=v),t&&(c.d=t);let u=JSON.stringify(c)+`
-`;if(this.stderrEcho){process.stderr.write(u);return}try{this.dirReady||(existsSync(g)||mkdirSync(g,{recursive:!0}),this.dirReady=!0);let w=i.slice(0,10),S=D(o,this.context.cat),y=join(g,`${S}-${w}.log`);appendFileSync(y,u,"utf-8");}catch{}}getMinLevel(){return this.minLevel}isCategoryActive(e){return !this.categoryFilter||this.categoryFilter.has(e.toLowerCase())}span(e,r){let t=Date.now();return this.write("debug",`${e}.begin`,r),{end:a$1(o=>{let i=Date.now()-t;this.write("info",`${e}.end`,{...r,...o,duration_ms:i});},"end"),fail:a$1((o,i)=>{let c=Date.now()-t,u=o instanceof Error?o.message:String(o);this.write("error",`${e}.fail`,{...r,...i,duration_ms:c,error:u});},"fail")}}},V=new d;function W(){try{if(!existsSync(g))return;let n=readdirSync(g).filter(e=>e.endsWith(".log")).sort();if(n.length<=h)return;for(let e of n.slice(0,n.length-h))try{unlinkSync(join(g,e));}catch{}}catch{}}a$1(W,"rotateLogs");export{$ as a,V as b,W as c};

package/dist/client-base-F5FCRSB3.js

@@ -1 +0,0 @@
-export{a as LLMClientBase}from'./chunk-2EUIMKJA.js';import'./chunk-FU7AHZNN.js';import'./chunk-ZSAONDT6.js';import'./chunk-3QP5BQ3L.js';

package/dist/devtools-SGDUOOM4.js

@@ -1 +0,0 @@
-import {h}from'./chunk-3QP5BQ3L.js';h();

package/dist/manager-J6FXEUEK.js

@@ -1 +0,0 @@
-export{c as SettingsManager}from'./chunk-DTPABBSV.js';import'./chunk-3QP5BQ3L.js';

package/dist/mcp-manager-27EVBKRT.js

@@ -1 +0,0 @@
-export{a as MCPManager}from'./chunk-L7B2ORID.js';import'./chunk-ZSAONDT6.js';import'./chunk-3QP5BQ3L.js';

package/dist/openai-3QEADSYL.js

@@ -1 +0,0 @@
-export{a as OpenAIClient}from'./chunk-VKKU4LOM.js';import'./chunk-O5HFCH2U.js';import'./chunk-2EUIMKJA.js';import'./chunk-FU7AHZNN.js';import'./chunk-ZSAONDT6.js';import'./chunk-3QP5BQ3L.js';

package/dist/openrouter-sync-WG4AG5NC.js

@@ -1 +0,0 @@
-export{a as syncOpenRouterCatalog}from'./chunk-XXCZE2U2.js';export{b as getOpenRouterSnapshot}from'./chunk-A4M2Y42L.js';import'./chunk-3QP5BQ3L.js';

package/dist/plugins/loader.d.ts

@@ -1,72 +0,0 @@
-/**
- * Plugin system — discover, load, and manage plugins.
- *
- * Plugin directories:
- *   ~/.code-shell/plugins/
- *   .code-shell/plugins/ (project-level)
- *
- * Each plugin is a directory with a manifest.json:
- *   {
- *     "name": "my-plugin",
- *     "version": "1.0.0",
- *     "description": "...",
- *     "main": "index.js",
- *     "skills": [...],
- *     "hooks": {...},
- *     "mcpServers": {...},
- *     "tools": [...]
- *   }
- */
-export interface PluginManifest {
-    name: string;
-    version: string;
-    description: string;
-    main?: string;
-    enabled?: boolean;
-    skills?: Array<{
-        name: string;
-        description: string;
-        triggers?: {
-            keywords?: string[];
-            tools?: string[];
-            intents?: string[];
-        };
-    }>;
-    hooks?: Record<string, string>;
-    mcpServers?: Record<string, {
-        command: string;
-        args?: string[];
-    }>;
-    tools?: Array<{
-        name: string;
-        description: string;
-        inputSchema: Record<string, unknown>;
-        handler: string;
-    }>;
-}
-export interface LoadedPlugin {
-    manifest: PluginManifest;
-    path: string;
-    enabled: boolean;
-    error?: string;
-}
-export declare class PluginLoader {
-    private plugins;
-    /**
-     * Scan plugin directories and load manifests.
-     */
-    scan(cwd: string): LoadedPlugin[];
-    /**
-     * Load a single plugin from a directory.
-     */
-    private loadPlugin;
-    private registerPlugin;
-    /** Get a plugin by name. */
-    get(name: string): LoadedPlugin | undefined;
-    /** List all discovered plugins. */
-    list(): LoadedPlugin[];
-    /** Enable/disable a plugin. */
-    setEnabled(name: string, enabled: boolean): boolean;
-    /** Get all enabled plugins. */
-    getEnabled(): LoadedPlugin[];
-}

package/dist/skills/matcher.d.ts

@@ -1,21 +0,0 @@
-/**
- * Skill matcher — determines which skills are relevant for a given input/context.
- */
-import type { SkillDefinition } from "./scanner.js";
-export interface MatchResult {
-    skill: SkillDefinition;
-    score: number;
-    matchedBy: string;
-}
-/**
- * Match skills against user input text.
- */
-export declare function matchSkillsByInput(skills: SkillDefinition[], input: string): MatchResult[];
-/**
- * Match skills by tool name being used.
- */
-export declare function matchSkillsByTool(skills: SkillDefinition[], toolName: string): MatchResult[];
-/**
- * Build a skill listing for the system prompt.
- */
-export declare function buildSkillListing(skills: SkillDefinition[]): string;

package/dist/tool-summary-V2B3MD5N.js

@@ -1,2 +0,0 @@
-import {b}from'./chunk-ZSAONDT6.js';import {h,a}from'./chunk-3QP5BQ3L.js';h();var p='Generate a very brief (under 40 chars) summary of what these tools did. Use past tense, commit-subject style. Examples: "Read 3 config files", "Fixed import in auth.ts", "Searched for API endpoints". Respond with ONLY the summary text, nothing else.';async function d(r,a,l){if(r.length===0)return null;try{let e=[];for(let t=0;t<r.length;t++){let s=r[t],o=a[t],u=JSON.stringify(s.args).slice(0,200),c=(o?.result??o?.error??"").slice(0,300);e.push(`Tool: ${s.toolName}(${u}) \u2192 ${c}`);}return (await l(p,e.join(`
-`)))?.trim()||null}catch(e){return b.warn("tool_summary.failed",{error:e.message}),null}}a(d,"generateToolUseSummary");export{d as generateToolUseSummary};

package/skills-builtin/codeshell-help.md

@@ -1,135 +0,0 @@
----
-name: codeshell-help
-description: Use when the user asks how to use code-shell itself — slash commands, login/model setup, settings.json keys, hooks, MCP servers, debugging flags, or "how do I X in code-shell". Skip for general programming questions.
-when_to_use: User asks about code-shell features, configuration, slash commands, or runtime behavior. Not for code questions in the user's own project.
----
-
-# Using code-shell
-
-You are running inside **code-shell**, a terminal coding agent. This skill answers user questions about code-shell itself. Quote sections directly where helpful. If a topic isn't covered, say so — don't invent commands.
-
-## Getting started
-
-- `code-shell` — start an interactive REPL in the current directory.
-- `code-shell run "<prompt>"` — one-shot non-interactive run, prints final answer and exits.
-- `code-shell runs <sid>` — resume a saved session by id.
-- First launch shows an onboarding flow that walks through provider + model setup.
-
-## Slash commands (run inside the REPL)
-
-Type `/` and the menu appears. The full list:
-
-### Core
-- `/help` — show the slash menu.
-- `/exit` — quit the REPL.
-- `/clear` — clear the conversation (keeps session id).
-- `/compact` — manually trigger context compaction.
-- `/status` — current model, effort, token usage, working dir.
-- `/version` — code-shell version.
-- `/cost` — token cost summary for the session.
-- `/sid` — print the current session id.
-- `/session` — open the session picker.
-- `/resume` — resume the most recent session.
-- `/diff` — show working-tree diff.
-- `/tasks` — current task list (TaskCreate/TaskUpdate state).
-- `/tools` — list available tools.
-- `/memory` — open the per-project memory file.
-- `/export markdown` — export the current conversation to a markdown file.
-
-### Models / providers
-- `/login` — add a new provider + model via the unified ProviderModelFlow.
-- `/logout` — remove a provider's stored credentials.
-- `/model` — quick-switch the active model.
-- `/models` — open the ModelManager (add, refresh, delete providers and models).
-
-### Configuration
-- `/config` — open `settings.json` for the active scope.
-- `/permissions` — manage tool permission rules.
-- `/hooks` — list hooks configured in settings.
-- `/mcp` — list and manage MCP servers.
-- `/skills` — list discovered skills.
-- `/effort` — set reasoning effort (low / medium / high) for reasoning models.
-
-### Git / review
-- `/commit` — agent drafts a commit from staged changes.
-- `/branch` — branch operations.
-- `/review` — review pending changes.
-- `/pr-comments` — fetch GitHub PR comments.
-- `/autofix-pr` — apply review suggestions.
-- `/security-review` — run a security-focused review of pending changes.
-
-### Misc
-- `/init` — scaffold or refresh `CODESHELL.md` / project rules based on repo state.
-- `/copy` — copy last response to clipboard.
-- `/undo` — undo the most recent file edit done by the agent.
-- `/update` — check for and install code-shell updates (auto-installs on exit when npm prefix is writable).
-- `/log` — open the session log file.
-- `/files` — list files the agent has touched this session.
-- `/release-notes` — show CHANGELOG for the running version.
-- `/feedback` — open the feedback URL.
-- `/voice` — voice input (if enabled).
-
-## Provider + model setup
-
-code-shell uses a **two-layer config**: `providers[]` holds credentials and base URLs; `models[]` references a provider by key.
-
-- New users: `/login` runs the full wizard — pick provider kind (anthropic / openai / openrouter / deepseek / custom), enter API key, optional base URL, then pick a model from the fetched list.
-- Existing users with the legacy flat `models[]` shape: auto-migrated on startup with a `.bak` snapshot written next to `settings.json`.
-- Refresh a provider's model list: `/models` → select provider → Refresh. Cached for 7 days under `~/.code-shell/cache/`.
-
-## settings.json — key fields
-
-Located at `~/.code-shell/settings.json` (user scope) or `.code-shell/settings.json` (project scope, takes precedence).
-
-- `providers[]` — `[{ key, kind, baseUrl, apiKey }]`. Source of credentials.
-- `models[]` — `[{ id, providerKey, displayName, contextLength, ... }]`.
-- `model` — the default active model id.
-- `autoUpdates` — `false` disables the background updater.
-- `permissions` — allow/deny rules for the Bash tool and others.
-- `hooks` — shell commands to run on events (SessionStart, PreToolUse, etc.).
-- `mcpServers` — `{ name: { command, args, env } }` map of MCP servers.
-
-## Hooks
-
-Hooks are shell commands the harness runs on events. Configured in `settings.json` under `hooks`. Common events: `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `Stop`. Use them for automated behaviors ("each time X happens, run Y") — memory or preferences can't do this because the model doesn't fire actions on schedule, the harness does.
-
-## MCP servers
-
-`code-shell` speaks the Model Context Protocol. Add servers in `settings.json` under `mcpServers`. Each entry is a stdio command code-shell spawns; its tools/resources become available to the agent automatically. List with `/mcp`.
-
-## Debugging
-
-- `CODE_SHELL_DEV=1 code-shell` — dev mode: enables the per-session verbose recorder (JSONL traces under `log/<date>/session-<sid>.jsonl`, 7-day retention), disables auto-update, shows extra UI.
-- `--debug` flag has the same effect as `CODE_SHELL_DEV=1`.
-- Logs: `~/.code-shell/log/` for general logs; per-session JSONL traces appear there when dev mode is on.
-- Investigation guard: re-reading the same file 3× is hard-blocked. 4+ consecutive read-only tool calls inject a "change strategy" reminder. This is intentional — break the loop, don't fight it.
-- Update install log: `~/.code-shell/update.log`.
-
-## Memory
-
-code-shell has a per-project memory system at `.code-shell/memory/` (relative to project root) and a global one at `~/.code-shell/memory/`. The `MEMORY.md` index is auto-loaded into context every session. Individual memory files are loaded on demand. Edit with `/memory` or directly.
-
-## Skills
-
-Skills are markdown files with frontmatter that get discovered automatically. Locations scanned:
-- `<cwd>/.code-shell/skills/` — project-level
-- `<cwd>/.claude/skills/` — project-level (Claude Code compat)
-- `~/.code-shell/skills/` — user-level
-- `~/.claude/skills/` — user-level (Claude Code compat)
-- Built-in skills shipped with the package (e.g. this one).
-
-List discovered skills with `/skills`. Invoke a skill with the `Skill` tool by name. Frontmatter `description` tells the model when to use it.
-
-## Common questions
-
-**"How do I switch models?"** — `/model <id>` or pick from `/models`.
-
-**"How do I add a new provider?"** — `/login`, then follow the wizard. Or edit `settings.json` `providers[]` directly.
-
-**"Why is auto-update not working?"** — `/update` shows the disabled reason. Common: dev build, `DISABLE_AUTOUPDATER=1`, `settings.autoUpdates: false`, or the npm global prefix isn't writable (use the shown `sudo` command).
-
-**"Where's my session saved?"** — `~/.code-shell/sessions/<sid>/`. State, messages, and tool results all there.
-
-**"How do I see what tools an agent has?"** — `/tools`.
-
-**"How do I limit what Bash commands the agent can run?"** — `/permissions` or edit `settings.permissions` directly.