@cjhyy/code-shell 0.1.7 → 0.3.0

package/dist/settings/schema.d.ts

@@ -48,38 +48,47 @@ export declare const SettingsSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         provider: string;
         name: string;
+        temperature: number;
         maxTokens: number;
         baseUrl: string;
-        temperature: number;
         apiKey?: string | undefined;
     }, {
         provider?: string | undefined;
         name?: string | undefined;
+        temperature?: number | undefined;
         maxTokens?: number | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
-        temperature?: number | undefined;
     }>>;
     providers: z.ZodDefault<z.ZodArray<z.ZodObject<{
         key: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
-        kind: z.ZodEnum<["openai", "anthropic", "deepseek", "xai", "mistral", "groq", "google", "openrouter", "ollama", "custom"]>;
+        kind: z.ZodEnum<["openai", "anthropic", "deepseek", "zai", "xai", "mistral", "groq", "google", "openrouter", "ollama", "custom"]>;
         baseUrl: z.ZodString;
         apiKey: z.ZodOptional<z.ZodString>;
         protocol: z.ZodOptional<z.ZodEnum<["openai-compat", "anthropic-style"]>>;
         modelsPath: z.ZodOptional<z.ZodString>;
+        /**
+         * DeepSeek V4 thinking-mode default for this provider. "enabled"
+         * matches endpoint default; "disabled" makes V4 calls run in
+         * non-thinking mode (faster, cheaper). Ignored by every provider
+         * other than DeepSeek V4. Per-call overrides still win.
+         */
+        thinking: z.ZodOptional<z.ZodEnum<["enabled", "disabled"]>>;
     }, "strip", z.ZodTypeAny, {
-        kind: "anthropic" | "openai" | "openrouter" | "deepseek" | "ollama" | "mistral" | "custom" | "xai" | "groq" | "google";
+        kind: "anthropic" | "openai" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
         key: string;
         baseUrl: string;
+        thinking?: "enabled" | "disabled" | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
         protocol?: "openai-compat" | "anthropic-style" | undefined;
         modelsPath?: string | undefined;
     }, {
-        kind: "anthropic" | "openai" | "openrouter" | "deepseek" | "ollama" | "mistral" | "custom" | "xai" | "groq" | "google";
+        kind: "anthropic" | "openai" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
         key: string;
         baseUrl: string;
+        thinking?: "enabled" | "disabled" | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
         protocol?: "openai-compat" | "anthropic-style" | undefined;
@@ -102,10 +111,18 @@ export declare const SettingsSchema: z.ZodObject<{
         provider: z.ZodOptional<z.ZodString>;
         baseUrl: z.ZodOptional<z.ZodString>;
         apiKey: z.ZodOptional<z.ZodString>;
+        /**
+         * Per-model thinking override. Wins over the provider-level
+         * setting (settings.providers[].thinking). Use this when
+         * different models under the same provider need different
+         * defaults — e.g. DeepSeek V4 Pro off (faster) but V4 Flash on.
+         */
+        thinking: z.ZodOptional<z.ZodEnum<["enabled", "disabled"]>>;
     }, "strip", z.ZodTypeAny, {
         model: string;
         key: string;
         provider?: string | undefined;
+        thinking?: "enabled" | "disabled" | undefined;
         baseUrl?: string | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
@@ -117,6 +134,7 @@ export declare const SettingsSchema: z.ZodObject<{
         model: string;
         key: string;
         provider?: string | undefined;
+        thinking?: "enabled" | "disabled" | undefined;
         baseUrl?: string | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
@@ -129,6 +147,7 @@ export declare const SettingsSchema: z.ZodObject<{
         provider: string | undefined;
         model: string;
         key: string;
+        thinking?: "enabled" | "disabled" | undefined;
         baseUrl?: string | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
@@ -139,6 +158,7 @@ export declare const SettingsSchema: z.ZodObject<{
         model: string;
         key: string;
         provider?: string | undefined;
+        thinking?: "enabled" | "disabled" | undefined;
         baseUrl?: string | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
@@ -166,21 +186,21 @@ export declare const SettingsSchema: z.ZodObject<{
             argsPattern?: Record<string, string> | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
+        defaultMode: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan";
         rules: {
             tool: string;
             decision: "allow" | "deny" | "ask";
             reason?: string | undefined;
             argsPattern?: Record<string, string> | undefined;
         }[];
-        defaultMode: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan";
     }, {
+        defaultMode?: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan" | undefined;
         rules?: {
             tool: string;
             decision: "allow" | "deny" | "ask";
             reason?: string | undefined;
             argsPattern?: Record<string, string> | undefined;
         }[] | undefined;
-        defaultMode?: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan" | undefined;
     }>>;
     context: z.ZodDefault<z.ZodObject<{
         maxTokens: z.ZodDefault<z.ZodNumber>;
@@ -325,6 +345,35 @@ export declare const SettingsSchema: z.ZodObject<{
         deniedReads?: string[] | undefined;
         network?: "allow" | "deny" | undefined;
     }>>;
+    /**
+     * Shell-hook configuration. Each entry binds a HookEventName to a
+     * shell command; the command receives ctx JSON on stdin and returns
+     * a HookResult JSON on stdout (or exit 2 = deny with stderr as
+     * reason). See src/hooks/shell-runner.ts for the wire protocol.
+     *
+     * The event field is loose-typed here (z.string()) because adding
+     * new lifecycle events shouldn't force a schema bump; the runner
+     * silently ignores entries whose event isn't registered.
+     */
+    hooks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        event: z.ZodString;
+        command: z.ZodString;
+        matcher: z.ZodOptional<z.ZodString>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
+        cwd: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        event: string;
+        cwd?: string | undefined;
+        matcher?: string | undefined;
+        timeout_ms?: number | undefined;
+    }, {
+        command: string;
+        event: string;
+        cwd?: string | undefined;
+        matcher?: string | undefined;
+        timeout_ms?: number | undefined;
+    }>, "many">>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     agent: z.ZodDefault<z.ZodObject<{
         preset: z.ZodDefault<z.ZodString>;
@@ -371,38 +420,47 @@ export declare const SettingsSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         provider: string;
         name: string;
+        temperature: number;
         maxTokens: number;
         baseUrl: string;
-        temperature: number;
         apiKey?: string | undefined;
     }, {
         provider?: string | undefined;
         name?: string | undefined;
+        temperature?: number | undefined;
         maxTokens?: number | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
-        temperature?: number | undefined;
     }>>;
     providers: z.ZodDefault<z.ZodArray<z.ZodObject<{
         key: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
-        kind: z.ZodEnum<["openai", "anthropic", "deepseek", "xai", "mistral", "groq", "google", "openrouter", "ollama", "custom"]>;
+        kind: z.ZodEnum<["openai", "anthropic", "deepseek", "zai", "xai", "mistral", "groq", "google", "openrouter", "ollama", "custom"]>;
         baseUrl: z.ZodString;
         apiKey: z.ZodOptional<z.ZodString>;
         protocol: z.ZodOptional<z.ZodEnum<["openai-compat", "anthropic-style"]>>;
         modelsPath: z.ZodOptional<z.ZodString>;
+        /**
+         * DeepSeek V4 thinking-mode default for this provider. "enabled"
+         * matches endpoint default; "disabled" makes V4 calls run in
+         * non-thinking mode (faster, cheaper). Ignored by every provider
+         * other than DeepSeek V4. Per-call overrides still win.
+         */
+        thinking: z.ZodOptional<z.ZodEnum<["enabled", "disabled"]>>;
     }, "strip", z.ZodTypeAny, {
-        kind: "anthropic" | "openai" | "openrouter" | "deepseek" | "ollama" | "mistral" | "custom" | "xai" | "groq" | "google";
+        kind: "anthropic" | "openai" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
         key: string;
         baseUrl: string;
+        thinking?: "enabled" | "disabled" | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
         protocol?: "openai-compat" | "anthropic-style" | undefined;
         modelsPath?: string | undefined;
     }, {
-        kind: "anthropic" | "openai" | "openrouter" | "deepseek" | "ollama" | "mistral" | "custom" | "xai" | "groq" | "google";
+        kind: "anthropic" | "openai" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
         key: string;
         baseUrl: string;
+        thinking?: "enabled" | "disabled" | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
         protocol?: "openai-compat" | "anthropic-style" | undefined;
@@ -425,10 +483,18 @@ export declare const SettingsSchema: z.ZodObject<{
         provider: z.ZodOptional<z.ZodString>;
         baseUrl: z.ZodOptional<z.ZodString>;
         apiKey: z.ZodOptional<z.ZodString>;
+        /**
+         * Per-model thinking override. Wins over the provider-level
+         * setting (settings.providers[].thinking). Use this when
+         * different models under the same provider need different
+         * defaults — e.g. DeepSeek V4 Pro off (faster) but V4 Flash on.
+         */
+        thinking: z.ZodOptional<z.ZodEnum<["enabled", "disabled"]>>;
     }, "strip", z.ZodTypeAny, {
         model: string;
         key: string;
         provider?: string | undefined;
+        thinking?: "enabled" | "disabled" | undefined;
         baseUrl?: string | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
@@ -440,6 +506,7 @@ export declare const SettingsSchema: z.ZodObject<{
         model: string;
         key: string;
         provider?: string | undefined;
+        thinking?: "enabled" | "disabled" | undefined;
         baseUrl?: string | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
@@ -452,6 +519,7 @@ export declare const SettingsSchema: z.ZodObject<{
         provider: string | undefined;
         model: string;
         key: string;
+        thinking?: "enabled" | "disabled" | undefined;
         baseUrl?: string | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
@@ -462,6 +530,7 @@ export declare const SettingsSchema: z.ZodObject<{
         model: string;
         key: string;
         provider?: string | undefined;
+        thinking?: "enabled" | "disabled" | undefined;
         baseUrl?: string | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
@@ -489,21 +558,21 @@ export declare const SettingsSchema: z.ZodObject<{
             argsPattern?: Record<string, string> | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
+        defaultMode: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan";
         rules: {
             tool: string;
             decision: "allow" | "deny" | "ask";
             reason?: string | undefined;
             argsPattern?: Record<string, string> | undefined;
         }[];
-        defaultMode: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan";
     }, {
+        defaultMode?: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan" | undefined;
         rules?: {
             tool: string;
             decision: "allow" | "deny" | "ask";
             reason?: string | undefined;
             argsPattern?: Record<string, string> | undefined;
         }[] | undefined;
-        defaultMode?: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan" | undefined;
     }>>;
     context: z.ZodDefault<z.ZodObject<{
         maxTokens: z.ZodDefault<z.ZodNumber>;
@@ -648,6 +717,35 @@ export declare const SettingsSchema: z.ZodObject<{
         deniedReads?: string[] | undefined;
         network?: "allow" | "deny" | undefined;
     }>>;
+    /**
+     * Shell-hook configuration. Each entry binds a HookEventName to a
+     * shell command; the command receives ctx JSON on stdin and returns
+     * a HookResult JSON on stdout (or exit 2 = deny with stderr as
+     * reason). See src/hooks/shell-runner.ts for the wire protocol.
+     *
+     * The event field is loose-typed here (z.string()) because adding
+     * new lifecycle events shouldn't force a schema bump; the runner
+     * silently ignores entries whose event isn't registered.
+     */
+    hooks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        event: z.ZodString;
+        command: z.ZodString;
+        matcher: z.ZodOptional<z.ZodString>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
+        cwd: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        event: string;
+        cwd?: string | undefined;
+        matcher?: string | undefined;
+        timeout_ms?: number | undefined;
+    }, {
+        command: string;
+        event: string;
+        cwd?: string | undefined;
+        matcher?: string | undefined;
+        timeout_ms?: number | undefined;
+    }>, "many">>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     agent: z.ZodDefault<z.ZodObject<{
         preset: z.ZodDefault<z.ZodString>;
@@ -694,38 +792,47 @@ export declare const SettingsSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         provider: string;
         name: string;
+        temperature: number;
         maxTokens: number;
         baseUrl: string;
-        temperature: number;
         apiKey?: string | undefined;
     }, {
         provider?: string | undefined;
         name?: string | undefined;
+        temperature?: number | undefined;
         maxTokens?: number | undefined;
         baseUrl?: string | undefined;
         apiKey?: string | undefined;
-        temperature?: number | undefined;
     }>>;
     providers: z.ZodDefault<z.ZodArray<z.ZodObject<{
         key: z.ZodString;
         label: z.ZodOptional<z.ZodString>;
-        kind: z.ZodEnum<["openai", "anthropic", "deepseek", "xai", "mistral", "groq", "google", "openrouter", "ollama", "custom"]>;
+        kind: z.ZodEnum<["openai", "anthropic", "deepseek", "zai", "xai", "mistral", "groq", "google", "openrouter", "ollama", "custom"]>;
         baseUrl: z.ZodString;
         apiKey: z.ZodOptional<z.ZodString>;
         protocol: z.ZodOptional<z.ZodEnum<["openai-compat", "anthropic-style"]>>;
         modelsPath: z.ZodOptional<z.ZodString>;
+        /**
+         * DeepSeek V4 thinking-mode default for this provider. "enabled"
+         * matches endpoint default; "disabled" makes V4 calls run in
+         * non-thinking mode (faster, cheaper). Ignored by every provider
+         * other than DeepSeek V4. Per-call overrides still win.
+         */
+        thinking: z.ZodOptional<z.ZodEnum<["enabled", "disabled"]>>;
     }, "strip", z.ZodTypeAny, {
-        kind: "anthropic" | "openai" | "openrouter" | "deepseek" | "ollama" | "mistral" | "custom" | "xai" | "groq" | "google";
+        kind: "anthropic" | "openai" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
         key: string;
         baseUrl: string;
+        thinking?: "enabled" | "disabled" | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
         protocol?: "openai-compat" | "anthropic-style" | undefined;
         modelsPath?: string | undefined;
     }, {
-        kind: "anthropic" | "openai" | "openrouter" | "deepseek" | "ollama" | "mistral" | "custom" | "xai" | "groq" | "google";
+        kind: "anthropic" | "openai" | "deepseek" | "zai" | "xai" | "mistral" | "groq" | "google" | "openrouter" | "ollama" | "custom";
         key: string;
         baseUrl: string;
+        thinking?: "enabled" | "disabled" | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
         protocol?: "openai-compat" | "anthropic-style" | undefined;
@@ -748,10 +855,18 @@ export declare const SettingsSchema: z.ZodObject<{
         provider: z.ZodOptional<z.ZodString>;
         baseUrl: z.ZodOptional<z.ZodString>;
         apiKey: z.ZodOptional<z.ZodString>;
+        /**
+         * Per-model thinking override. Wins over the provider-level
+         * setting (settings.providers[].thinking). Use this when
+         * different models under the same provider need different
+         * defaults — e.g. DeepSeek V4 Pro off (faster) but V4 Flash on.
+         */
+        thinking: z.ZodOptional<z.ZodEnum<["enabled", "disabled"]>>;
     }, "strip", z.ZodTypeAny, {
         model: string;
         key: string;
         provider?: string | undefined;
+        thinking?: "enabled" | "disabled" | undefined;
         baseUrl?: string | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
@@ -763,6 +878,7 @@ export declare const SettingsSchema: z.ZodObject<{
         model: string;
         key: string;
         provider?: string | undefined;
+        thinking?: "enabled" | "disabled" | undefined;
         baseUrl?: string | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
@@ -775,6 +891,7 @@ export declare const SettingsSchema: z.ZodObject<{
         provider: string | undefined;
         model: string;
         key: string;
+        thinking?: "enabled" | "disabled" | undefined;
         baseUrl?: string | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
@@ -785,6 +902,7 @@ export declare const SettingsSchema: z.ZodObject<{
         model: string;
         key: string;
         provider?: string | undefined;
+        thinking?: "enabled" | "disabled" | undefined;
         baseUrl?: string | undefined;
         label?: string | undefined;
         apiKey?: string | undefined;
@@ -812,21 +930,21 @@ export declare const SettingsSchema: z.ZodObject<{
             argsPattern?: Record<string, string> | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
+        defaultMode: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan";
         rules: {
             tool: string;
             decision: "allow" | "deny" | "ask";
             reason?: string | undefined;
             argsPattern?: Record<string, string> | undefined;
         }[];
-        defaultMode: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan";
     }, {
+        defaultMode?: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan" | undefined;
         rules?: {
             tool: string;
             decision: "allow" | "deny" | "ask";
             reason?: string | undefined;
             argsPattern?: Record<string, string> | undefined;
         }[] | undefined;
-        defaultMode?: "default" | "acceptEdits" | "dontAsk" | "bypassPermissions" | "auto" | "plan" | undefined;
     }>>;
     context: z.ZodDefault<z.ZodObject<{
         maxTokens: z.ZodDefault<z.ZodNumber>;
@@ -971,6 +1089,35 @@ export declare const SettingsSchema: z.ZodObject<{
         deniedReads?: string[] | undefined;
         network?: "allow" | "deny" | undefined;
     }>>;
+    /**
+     * Shell-hook configuration. Each entry binds a HookEventName to a
+     * shell command; the command receives ctx JSON on stdin and returns
+     * a HookResult JSON on stdout (or exit 2 = deny with stderr as
+     * reason). See src/hooks/shell-runner.ts for the wire protocol.
+     *
+     * The event field is loose-typed here (z.string()) because adding
+     * new lifecycle events shouldn't force a schema bump; the runner
+     * silently ignores entries whose event isn't registered.
+     */
+    hooks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        event: z.ZodString;
+        command: z.ZodString;
+        matcher: z.ZodOptional<z.ZodString>;
+        timeout_ms: z.ZodOptional<z.ZodNumber>;
+        cwd: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        event: string;
+        cwd?: string | undefined;
+        matcher?: string | undefined;
+        timeout_ms?: number | undefined;
+    }, {
+        command: string;
+        event: string;
+        cwd?: string | undefined;
+        matcher?: string | undefined;
+        timeout_ms?: number | undefined;
+    }>, "many">>;
 }, z.ZodTypeAny, "passthrough">>;
 export type ValidatedSettings = z.infer<typeof SettingsSchema>;
 export declare function validateSettings(raw: unknown): ValidatedSettings;

package/dist/skills/frontmatter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Frontmatter parser for SKILL.md files. Byte-compatible with Claude Code's
+ * `utils/frontmatterParser.ts` so community skill repositories can be reused
+ * without modification.
+ */
+export declare const FRONTMATTER_REGEX: RegExp;
+export interface ParsedFrontmatter {
+    frontmatter: Record<string, unknown>;
+    body: string;
+}
+export declare function parseFrontmatter(raw: string): ParsedFrontmatter;
+export declare function quoteProblematicValues(frontmatterText: string): string;
+export declare function coerceDescription(value: unknown): string;

package/dist/skills/index.d.ts

@@ -1,7 +1,7 @@
 /**
- * Skills system — scan, match, and inject skills into prompts.
+ * Skills barrel. Phase A keeps the scanner only. Listing rendering lives in
+ * src/tool-system/builtin/skill-prompt.ts so the prompt-formatting layer can
+ * grow token-budget logic later without churn here.
  */
-export { scanSkills } from "./scanner.js";
+export { scanSkills, invalidateSkillCache } from "./scanner.js";
 export type { SkillDefinition } from "./scanner.js";
-export { matchSkillsByInput, matchSkillsByTool, buildSkillListing } from "./matcher.js";
-export type { MatchResult } from "./matcher.js";

package/dist/skills/scanner.d.ts

@@ -1,30 +1,20 @@
 /**
- * Skills scanner — discovers SKILL.md files and parses their metadata.
- *
- * Skills are markdown files with YAML frontmatter:
- * ---
- * name: skill-name
- * description: what it does
- * triggers:
- *   keywords: [word1, word2]
- *   tools: [ToolName]
- * when_to_use: description of when to invoke
- * ---
- * <skill content>
+ * Skill scanner — discovers <base>/<name>/SKILL.md files from project + user
+ * directories AND from installed plugins. Mirrors Claude Code's
+ * `loadSkillsFromSkillsDir` (skills/loadSkillsDir.ts:407) plus plugin
+ * integration (utils/plugins/pluginLoader.ts).
  */
 export interface SkillDefinition {
+    /** Directory name; authoritative regardless of frontmatter.name. */
     name: string;
+    /** From frontmatter.description, coerced. Empty string if absent or invalid. */
     description: string;
-    triggers: {
-        keywords?: string[];
-        tools?: string[];
-        intents?: string[];
-    };
-    whenToUse: string;
+    /** SKILL.md body with frontmatter stripped. */
     content: string;
+    /** Absolute path to the SKILL.md file. */
     filePath: string;
+    /** Where the skill was loaded from. */
+    source: "project" | "user" | "plugin";
 }
-/**
- * Scan for SKILL.md files in standard locations.
- */
 export declare function scanSkills(cwd: string): SkillDefinition[];
+export declare function invalidateSkillCache(): void;

package/dist/tool-summary-HJX6RHG4.js

@@ -0,0 +1,2 @@
+import {d as d$1}from'./chunk-DI26OUIU.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 d$1.warn("tool_summary.failed",{error:e.message}),null}}a(d,"generateToolUseSummary");export{d as generateToolUseSummary};

package/dist/tool-system/builtin/agent-notifications.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Background-agent completion notification queue.
+ *
+ * Mirrors Claude Code's `commandQueue` with `mode: 'task-notification'`. A
+ * background sub-agent that finishes (completed | failed) enqueues an item
+ * here; the UI layer subscribes and, when the main agent is idle, drains
+ * the queue and submits the formatted XML as a new user turn so the LLM
+ * sees the result. Cancellation does NOT enqueue (user explicitly stopped
+ * the agent; no follow-up needed).
+ *
+ * The result text lives only in this queue + the eventual user message —
+ * not in `asyncAgentRegistry`. Registry stays metadata-only.
+ *
+ * Process-local singleton; same lifetime contract as `asyncAgentRegistry`.
+ */
+export type NotificationItem = {
+    agentId: string;
+    name?: string;
+    description: string;
+    status: "completed" | "failed";
+    /** Final assistant text (completed only). */
+    finalText?: string;
+    /** Error message (failed only). */
+    error?: string;
+    enqueuedAt: number;
+};
+type Listener = () => void;
+declare class NotificationQueue {
+    private items;
+    private listeners;
+    enqueue(item: NotificationItem): void;
+    subscribe: (cb: Listener) => (() => void);
+    getSnapshot: () => NotificationItem[];
+    /** Atomic: returns all items and clears in one shot. */
+    drainAll(): NotificationItem[];
+    reset(): void;
+    private notify;
+}
+export declare const notificationQueue: NotificationQueue;
+/**
+ * Render a batch of completion notifications as the XML user-message
+ * body that the main agent's LLM will see. Format is stable — main
+ * agent prompts can rely on the `<background-agents-completed>` root
+ * tag as a signal that this turn is a system-injected notification,
+ * not a real user message.
+ */
+export declare function buildNotificationMessage(items: NotificationItem[]): string;
+/**
+ * One-line-per-agent human summary for the chat feed. The full result
+ * body goes to the LLM via buildNotificationMessage; the user sees only
+ * this terse marker plus an optional inline error preview, and can
+ * switch to the sub-agent's dock view if they want details.
+ */
+export declare function buildNotificationSummary(items: NotificationItem[]): string;
+export {};

package/dist/tool-system/builtin/agent-registry.d.ts

@@ -12,23 +12,54 @@
  * RunManager, not here.
  */
 export type AsyncAgentStatus = "running" | "completed" | "failed" | "cancelled";
+/**
+ * Minimal structural shape for an entry in an agent's transcript. We avoid
+ * importing the UI's `ChatEntry` here to prevent a tool-system → ui import
+ * direction. Consumers (the UI dock) widen this type via `as ChatEntry[]`
+ * at their boundary.
+ */
+export interface AgentTranscriptEntry {
+    id: string;
+    type: string;
+    [key: string]: unknown;
+}
 export interface AsyncAgentEntry {
     agentId: string;
+    /** Short kind label shown in the dock (e.g. "Explore", "Plan"). */
+    name?: string;
     description: string;
     status: AsyncAgentStatus;
     startedAt: number;
     finishedAt?: number;
-    result?: string;
-    error?: string;
+    /** finishedAt + 30_000. Dock filters rows past this. */
+    finishedFadeAt?: number;
     abort: () => void;
+    /** Stream events recorded by run_in_background agents for UI view-switching. */
+    transcript?: AgentTranscriptEntry[];
 }
 declare class AsyncAgentRegistry {
     private agents;
+    private listeners;
+    private snapshot;
+    subscribe: (cb: () => void) => (() => void);
+    getSnapshot: () => AsyncAgentEntry[];
+    hasRunning: () => boolean;
+    private notify;
     register(entry: AsyncAgentEntry): void;
+    appendToTranscript(agentId: string, entry: AgentTranscriptEntry): void;
+    /**
+     * Re-emit the registry change signal after callers mutate an agent's
+     * transcript array in place (patching or filtering entries). Required
+     * because `notify` rebuilds the snapshot and tells React subscribers to
+     * re-read.
+     */
+    touchTranscript(agentId: string): void;
     get(agentId: string): AsyncAgentEntry | undefined;
     list(): AsyncAgentEntry[];
-    markCompleted(agentId: string, result: string): void;
-    markFailed(agentId: string, error: string): void;
+    private markFinished;
+    markCompleted(agentId: string): void;
+    markFailed(agentId: string): void;
+    markCancelled(agentId: string): void;
     cancel(agentId: string): boolean;
     reset(): void;
 }