mu-harness 0.18.0 → 0.19.0

package/esm/agents/index.d.ts

@@ -2,4 +2,3 @@ export type { Agent, GrantValue, ToolDecision, ToolGrants } from './types.js';
 export { type AgentRegistry, createAgentRegistry, grantArg, toolDecision, toolNames } from './registry.js';
 export { parseAgent } from './parser.js';
 export { loadAgents } from './loader.js';
-export { createAgentWriterTool } from './writer.js';

package/esm/agents/index.js

@@ -1,4 +1,3 @@
 export { createAgentRegistry, grantArg, toolDecision, toolNames } from './registry.js';
 export { parseAgent } from './parser.js';
 export { loadAgents } from './loader.js';
-export { createAgentWriterTool } from './writer.js';

package/esm/common/index.d.ts

@@ -1,3 +1,2 @@
 export { createEmitter, type Emitter, strList } from './utils.js';
 export { type Frontmatter, parseFrontmatter, str } from './frontmatter.js';
-export type { Scope } from './scope.js';

package/esm/harness/create.js

@@ -1,7 +1,7 @@
 import os from 'node:os';
 import { join } from 'node:path';
 import process from 'node:process';
-import { createAgentRegistry, createAgentWriterTool, grantArg, loadAgents, toolDecision, toolNames } from '../agents/index.js';
+import { createAgentRegistry, grantArg, loadAgents, toolDecision, toolNames } from '../agents/index.js';
 import { createAgentsCommand, createCommandRegistry, createHelpCommand, createSessionsCommand, createSkillCommand, createSkillsCommand, } from '../commands/index.js';
 import { createHarnessConfig } from '../config/index.js';
 import { mergeHooks } from '../hooks/index.js';
@@ -9,7 +9,7 @@ import { allowList } from '../permissions/index.js';
 import { createPluginStore } from '../plugin/index.js';
 import { createScheduler, createScheduleTaskTool, createTasksCommand, createTaskStore } from '../scheduler/index.js';
 import { createAgentSession, createSessionCatalog, createSessionManager, createSessionStore, persistTo, runTitler, } from '../session/index.js';
-import { createRunSkillTool, createSkillRegistry, createSkillTool, createSkillWriterTool, loadSkills, runSkill, } from '../skills/index.js';
+import { createRunSkillTool, createSkillRegistry, createSkillTool, loadSkills, runSkill } from '../skills/index.js';
 import { createSubAgentRegistry, createSubAgentTool, runSubAgent } from '../subAgents/index.js';
 import { environmentBlock } from './environment.js';
 import { createModelRegistry } from './models.js';
@@ -20,7 +20,7 @@ const TITLE_AGENT = {
     tools: [],
 };
 export const createHarness = async (options) => {
-    const { hostName, xdg, providers, model, agents: hostAgents = [], defaultAgents = [], skills: hostSkills = [], skillScope, agentScope, agentDirs, title, titleModel, scheduler: enableScheduler = false, approvals, ...sessionDefaults } = options;
+    const { hostName, xdg, providers, model, agents: hostAgents = [], defaultAgents = [], skills: hostSkills = [], agentDirs, title, titleModel, scheduler: enableScheduler = false, approvals, ...sessionDefaults } = options;
     const cwd = options.cwd ?? process.cwd();
     const config = createHarnessConfig({ hostName, xdg });
     const models = createModelRegistry({ providers, default: model });
@@ -61,16 +61,6 @@ export const createHarness = async (options) => {
         ...await loadSkills(skillsDir),
     ];
     const skills = createSkillRegistry(await mergedSkills());
-    const skillWriterTool = createSkillWriterTool({
-        dirs: { local: cwdSkillsDir, config: skillsDir },
-        registry: skills,
-        forceScope: skillScope,
-    });
-    const agentWriterTool = createAgentWriterTool({
-        dirs: { local: localAgentsDir, config: agentsDir },
-        registry: agents,
-        forceScope: agentScope,
-    });
     const scopeSkills = (agent) => {
         if (!agent)
             return skills;
@@ -84,8 +74,6 @@ export const createHarness = async (options) => {
         ...(sessionDefaults.tools ?? []),
         ...extra,
         createSkillTool(scopeSkills(agent)),
-        skillWriterTool,
-        agentWriterTool,
         ...schedulerTools,
     ];
     const approvalHook = (getAgent) => approvals

package/esm/harness/types.d.ts

@@ -1,7 +1,6 @@
 import type { Provider } from 'mu-core';
 import type { Agent, AgentRegistry, ToolDecision } from '../agents/index.js';
 import type { CommandRegistry } from '../commands/index.js';
-import type { Scope } from '../common/index.js';
 import type { HarnessConfig, HarnessConfigOptions } from '../config/index.js';
 import type { ApprovalManager } from '../permissions/index.js';
 import type { PluginStore } from '../plugin/index.js';
@@ -21,18 +20,7 @@ export type HarnessOptions = HarnessConfigOptions & Omit<AgentSessionConfig, 'pr
     defaultAgents?: Agent[];
     skills?: Skill[];
     /**
-     * Forces the save location of `create_skill`. When set, the model's `scope`
-     * argument is overridden (and dropped from the tool schema). Unset → the
-     * model chooses, defaulting to 'local'.
-     */
-    skillScope?: Scope;
-    /**
-     * Forces the save location of `create_agent`. Same semantics as
-     * {@link skillScope}: set to pin the scope, leave unset to let the model choose.
-     */
-    agentScope?: Scope;
-    /**
-     * Overrides where `create_agent` writes (and which dirs are loaded at boot).
+     * Overrides which agent directories are loaded at boot (and watched/reloaded).
      * Defaults to `{ local: <cwd>/agents, config: <configDir>/agents }`.
      */
     agentDirs?: {

package/esm/skills/index.d.ts

@@ -4,5 +4,4 @@ export { parseSkill } from './parser.js';
 export { loadSkills } from './loader.js';
 export { skillMatchesPlatform } from './platform.js';
 export { createSkillTool } from './tool.js';
-export { createSkillWriterTool } from './writer.js';
 export { createRunSkillTool, runSkill, type RunSkillDeps } from './run.js';

package/esm/skills/index.js

@@ -3,5 +3,4 @@ export { parseSkill } from './parser.js';
 export { loadSkills } from './loader.js';
 export { skillMatchesPlatform } from './platform.js';
 export { createSkillTool } from './tool.js';
-export { createSkillWriterTool } from './writer.js';
 export { createRunSkillTool, runSkill } from './run.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mu-harness",
-  "version": "0.18.0",
+  "version": "0.19.0",
   "description": "Agent harness: createHarness wires mu-core into a host — XDG paths, model registry, plugins, disk-loaded agents & skills, sub-agents, sessions (JSONL + SQLite catalog), slash commands, permission/approval hooks, an optional scheduler, and a composable TUI chat app",
   "license": "MIT",
   "main": "./script/index.js",
@@ -23,8 +23,8 @@
     "@swc/wasm-typescript": "^1.15.0",
     "cli-highlight": "^2.1.11",
     "croner": "^9.0.0",
-    "mu-core": "^0.18.0",
-    "mu-tui": "^0.18.0"
+    "mu-core": "^0.19.0",
+    "mu-tui": "^0.19.0"
   },
   "_generatedBy": "dnt@dev",
   "types": "./esm/index.d.ts"

package/script/agents/index.d.ts

@@ -2,4 +2,3 @@ export type { Agent, GrantValue, ToolDecision, ToolGrants } from './types.js';
 export { type AgentRegistry, createAgentRegistry, grantArg, toolDecision, toolNames } from './registry.js';
 export { parseAgent } from './parser.js';
 export { loadAgents } from './loader.js';
-export { createAgentWriterTool } from './writer.js';

package/script/agents/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAgentWriterTool = exports.loadAgents = exports.parseAgent = exports.toolNames = exports.toolDecision = exports.grantArg = exports.createAgentRegistry = void 0;
+exports.loadAgents = exports.parseAgent = exports.toolNames = exports.toolDecision = exports.grantArg = exports.createAgentRegistry = void 0;
 var registry_js_1 = require("./registry.js");
 Object.defineProperty(exports, "createAgentRegistry", { enumerable: true, get: function () { return registry_js_1.createAgentRegistry; } });
 Object.defineProperty(exports, "grantArg", { enumerable: true, get: function () { return registry_js_1.grantArg; } });
@@ -10,5 +10,3 @@ var parser_js_1 = require("./parser.js");
 Object.defineProperty(exports, "parseAgent", { enumerable: true, get: function () { return parser_js_1.parseAgent; } });
 var loader_js_1 = require("./loader.js");
 Object.defineProperty(exports, "loadAgents", { enumerable: true, get: function () { return loader_js_1.loadAgents; } });
-var writer_js_1 = require("./writer.js");
-Object.defineProperty(exports, "createAgentWriterTool", { enumerable: true, get: function () { return writer_js_1.createAgentWriterTool; } });

package/script/common/index.d.ts

@@ -1,3 +1,2 @@
 export { createEmitter, type Emitter, strList } from './utils.js';
 export { type Frontmatter, parseFrontmatter, str } from './frontmatter.js';
-export type { Scope } from './scope.js';

package/script/harness/create.js

@@ -26,7 +26,7 @@ const TITLE_AGENT = {
     tools: [],
 };
 const createHarness = async (options) => {
-    const { hostName, xdg, providers, model, agents: hostAgents = [], defaultAgents = [], skills: hostSkills = [], skillScope, agentScope, agentDirs, title, titleModel, scheduler: enableScheduler = false, approvals, ...sessionDefaults } = options;
+    const { hostName, xdg, providers, model, agents: hostAgents = [], defaultAgents = [], skills: hostSkills = [], agentDirs, title, titleModel, scheduler: enableScheduler = false, approvals, ...sessionDefaults } = options;
     const cwd = options.cwd ?? node_process_1.default.cwd();
     const config = (0, index_js_3.createHarnessConfig)({ hostName, xdg });
     const models = (0, models_js_1.createModelRegistry)({ providers, default: model });
@@ -67,16 +67,6 @@ const createHarness = async (options) => {
         ...await (0, index_js_9.loadSkills)(skillsDir),
     ];
     const skills = (0, index_js_9.createSkillRegistry)(await mergedSkills());
-    const skillWriterTool = (0, index_js_9.createSkillWriterTool)({
-        dirs: { local: cwdSkillsDir, config: skillsDir },
-        registry: skills,
-        forceScope: skillScope,
-    });
-    const agentWriterTool = (0, index_js_1.createAgentWriterTool)({
-        dirs: { local: localAgentsDir, config: agentsDir },
-        registry: agents,
-        forceScope: agentScope,
-    });
     const scopeSkills = (agent) => {
         if (!agent)
             return skills;
@@ -90,8 +80,6 @@ const createHarness = async (options) => {
         ...(sessionDefaults.tools ?? []),
         ...extra,
         (0, index_js_9.createSkillTool)(scopeSkills(agent)),
-        skillWriterTool,
-        agentWriterTool,
         ...schedulerTools,
     ];
     const approvalHook = (getAgent) => approvals

package/script/harness/types.d.ts

@@ -1,7 +1,6 @@
 import type { Provider } from 'mu-core';
 import type { Agent, AgentRegistry, ToolDecision } from '../agents/index.js';
 import type { CommandRegistry } from '../commands/index.js';
-import type { Scope } from '../common/index.js';
 import type { HarnessConfig, HarnessConfigOptions } from '../config/index.js';
 import type { ApprovalManager } from '../permissions/index.js';
 import type { PluginStore } from '../plugin/index.js';
@@ -21,18 +20,7 @@ export type HarnessOptions = HarnessConfigOptions & Omit<AgentSessionConfig, 'pr
     defaultAgents?: Agent[];
     skills?: Skill[];
     /**
-     * Forces the save location of `create_skill`. When set, the model's `scope`
-     * argument is overridden (and dropped from the tool schema). Unset → the
-     * model chooses, defaulting to 'local'.
-     */
-    skillScope?: Scope;
-    /**
-     * Forces the save location of `create_agent`. Same semantics as
-     * {@link skillScope}: set to pin the scope, leave unset to let the model choose.
-     */
-    agentScope?: Scope;
-    /**
-     * Overrides where `create_agent` writes (and which dirs are loaded at boot).
+     * Overrides which agent directories are loaded at boot (and watched/reloaded).
      * Defaults to `{ local: <cwd>/agents, config: <configDir>/agents }`.
      */
     agentDirs?: {

package/script/skills/index.d.ts

@@ -4,5 +4,4 @@ export { parseSkill } from './parser.js';
 export { loadSkills } from './loader.js';
 export { skillMatchesPlatform } from './platform.js';
 export { createSkillTool } from './tool.js';
-export { createSkillWriterTool } from './writer.js';
 export { createRunSkillTool, runSkill, type RunSkillDeps } from './run.js';

package/script/skills/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runSkill = exports.createRunSkillTool = exports.createSkillWriterTool = exports.createSkillTool = exports.skillMatchesPlatform = exports.loadSkills = exports.parseSkill = exports.createSkillRegistry = void 0;
+exports.runSkill = exports.createRunSkillTool = exports.createSkillTool = exports.skillMatchesPlatform = exports.loadSkills = exports.parseSkill = exports.createSkillRegistry = void 0;
 var registry_js_1 = require("./registry.js");
 Object.defineProperty(exports, "createSkillRegistry", { enumerable: true, get: function () { return registry_js_1.createSkillRegistry; } });
 var parser_js_1 = require("./parser.js");
@@ -11,8 +11,6 @@ var platform_js_1 = require("./platform.js");
 Object.defineProperty(exports, "skillMatchesPlatform", { enumerable: true, get: function () { return platform_js_1.skillMatchesPlatform; } });
 var tool_js_1 = require("./tool.js");
 Object.defineProperty(exports, "createSkillTool", { enumerable: true, get: function () { return tool_js_1.createSkillTool; } });
-var writer_js_1 = require("./writer.js");
-Object.defineProperty(exports, "createSkillWriterTool", { enumerable: true, get: function () { return writer_js_1.createSkillWriterTool; } });
 var run_js_1 = require("./run.js");
 Object.defineProperty(exports, "createRunSkillTool", { enumerable: true, get: function () { return run_js_1.createRunSkillTool; } });
 Object.defineProperty(exports, "runSkill", { enumerable: true, get: function () { return run_js_1.runSkill; } });

package/esm/agents/writer.d.ts

@@ -1,14 +0,0 @@
-import type { Tool } from 'mu-core';
-import type { Scope } from '../common/index.js';
-import type { AgentRegistry } from './registry.js';
-/**
- * `create_agent` — authors a reusable agent definition (`.md` with frontmatter)
- * and registers it live via {@link AgentRegistry.add}, so it can be delegated to
- * through `subagent` without a restart. Mirrors {@link createSkillWriterTool}:
- * the `scope` selects the save location, or a configured `forceScope` pins it.
- */
-export declare const createAgentWriterTool: (deps: {
-    dirs: Record<Scope, string>;
-    registry: AgentRegistry;
-    forceScope?: Scope;
-}) => Tool;

package/esm/agents/writer.js

@@ -1,81 +0,0 @@
-import { existsSync } from 'node:fs';
-import { mkdir, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { stringify as stringifyYaml } from '../deps/jsr.io/@std/yaml/1.1.0/mod.js';
-import { parseAgent } from './parser.js';
-const slug = (name) => name.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
-/**
- * `create_agent` — authors a reusable agent definition (`.md` with frontmatter)
- * and registers it live via {@link AgentRegistry.add}, so it can be delegated to
- * through `subagent` without a restart. Mirrors {@link createSkillWriterTool}:
- * the `scope` selects the save location, or a configured `forceScope` pins it.
- */
-export const createAgentWriterTool = (deps) => {
-    const { forceScope } = deps;
-    const scopeProp = forceScope ? {} : {
-        scope: {
-            type: 'string',
-            enum: ['local', 'config'],
-            description: 'Where to save it: "local" = this project (repo-first), "config" = global config dir. Defaults to "local".',
-        },
-    };
-    return {
-        name: 'create_agent',
-        description: forceScope
-            ? `Define a reusable agent (name, description, system prompt, optional per-tool grants) that can be delegated to via \`subagent\`. Always saved to the "${forceScope}" agents directory.`
-            : 'Define a reusable agent (name, description, system prompt, optional per-tool grants) that can be delegated to via `subagent`. `scope: "local"` saves it to this project, `scope: "config"` makes it available across all projects.',
-        parameters: {
-            type: 'object',
-            properties: {
-                name: { type: 'string', description: 'Short agent name (kebab-case); also the filename.' },
-                description: { type: 'string', description: 'One line describing what this agent is for.' },
-                prompt: { type: 'string', description: 'The system prompt that defines the agent.' },
-                tools: {
-                    type: 'object',
-                    description: 'Optional per-tool grants: map a tool name to "allow" | "ask" | "deny" (or a nested {glob: decision} map). Omitted tools are denied — be explicit about what it may use.',
-                    additionalProperties: true,
-                },
-                model: { type: 'string', description: 'Optional model ref override.' },
-                color: { type: 'string', description: 'Optional hex color for the UI.' },
-                ...scopeProp,
-            },
-            required: ['name', 'description', 'prompt'],
-            additionalProperties: false,
-        },
-        run: async (input) => {
-            const { name, description, prompt, tools, model, color, scope } = (input ?? {});
-            if (!name || !description || !prompt) {
-                return [{ type: 'text', text: 'Error: create_agent requires `name`, `description`, and `prompt`.' }];
-            }
-            // A configured forceScope wins over whatever the model passed.
-            const resolved = forceScope ?? scope ?? 'local';
-            const base = deps.dirs[resolved];
-            if (!base)
-                return [{ type: 'text', text: `Error: unknown scope "${scope}".` }];
-            const id = slug(name);
-            if (!id)
-                return [{ type: 'text', text: `Error: invalid agent name "${name}".` }];
-            if (deps.registry.get(id)) {
-                return [{ type: 'text', text: `Error: an agent named "${id}" already exists.` }];
-            }
-            const file = join(base, `${id}.md`);
-            if (existsSync(file))
-                return [{ type: 'text', text: `Error: ${file} already exists.` }];
-            const frontmatter = { name: id, description };
-            if (model)
-                frontmatter.model = model;
-            if (color)
-                frontmatter.color = color;
-            if (tools && typeof tools === 'object')
-                frontmatter.tools = tools;
-            const source = `---\n${stringifyYaml(frontmatter).trimEnd()}\n---\n\n${prompt.trim()}\n`;
-            await mkdir(base, { recursive: true });
-            await writeFile(file, source, 'utf-8');
-            deps.registry.add(parseAgent(source, id));
-            return [{
-                    type: 'text',
-                    text: `Created agent "${id}" at ${file}. It can now be delegated to via the \`subagent\` tool.`,
-                }];
-        },
-    };
-};

package/esm/common/scope.d.ts

@@ -1,8 +0,0 @@
-/**
- * Where a host saves agent-authored definitions (skills, sub-agents, …):
- * - `local`  → the current project (repo-first, e.g. `<cwd>/skills`).
- * - `config` → the global config dir, shared across every project.
- *
- * Generic across definition kinds so every writer tool speaks the same vocabulary.
- */
-export type Scope = 'local' | 'config';

package/esm/common/scope.js

@@ -1 +0,0 @@
-export {};

package/esm/skills/writer.d.ts

@@ -1,8 +0,0 @@
-import type { Tool } from 'mu-core';
-import type { Scope } from '../common/index.js';
-import type { SkillRegistry } from './registry.js';
-export declare const createSkillWriterTool: (deps: {
-    dirs: Record<Scope, string>;
-    registry: SkillRegistry;
-    forceScope?: Scope;
-}) => Tool;

package/esm/skills/writer.js

@@ -1,55 +0,0 @@
-import { mkdir, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { parseSkill } from './parser.js';
-const slug = (name) => name.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
-export const createSkillWriterTool = (deps) => {
-    const { forceScope } = deps;
-    const scopeProp = forceScope ? {} : {
-        scope: {
-            type: 'string',
-            enum: ['local', 'config'],
-            description: 'Where to save it: "local" = this project (<cwd>/skills), "config" = global config dir. Defaults to "local".',
-        },
-    };
-    return {
-        name: 'create_skill',
-        description: forceScope
-            ? `Create a reusable skill (name, description, instructions) the agent can load on demand later — capture a reusable workflow worth keeping. Always saved to the global "${forceScope}" skills directory; load it later via \`skill\`.`
-            : 'Create a reusable skill (name, description, instructions) the agent can load on demand later — capture a reusable workflow worth keeping. `scope: "local"` saves it to this project, `scope: "config"` makes it available across all projects; load it later via `skill`.',
-        parameters: {
-            type: 'object',
-            properties: {
-                name: { type: 'string', description: 'Short skill name (kebab-case).' },
-                description: { type: 'string', description: 'One line describing when this skill should be used.' },
-                instructions: {
-                    type: 'string',
-                    description: 'The skill body: the instructions to follow when it is invoked.',
-                },
-                ...scopeProp,
-            },
-            required: ['name', 'description', 'instructions'],
-            additionalProperties: false,
-        },
-        run: async (input) => {
-            const { name, description, instructions, scope } = (input ?? {});
-            if (!name || !description || !instructions) {
-                return [{ type: 'text', text: 'Error: create_skill requires `name`, `description`, and `instructions`.' }];
-            }
-            // A configured forceScope wins over whatever the model passed.
-            const resolved = forceScope ?? scope ?? 'local';
-            const base = deps.dirs[resolved];
-            if (!base)
-                return [{ type: 'text', text: `Error: unknown scope "${scope}".` }];
-            const id = slug(name);
-            if (!id)
-                return [{ type: 'text', text: `Error: invalid skill name "${name}".` }];
-            const skillDir = join(base, id);
-            const file = join(skillDir, 'SKILL.md');
-            const source = `---\nname: ${id}\ndescription: ${JSON.stringify(description)}\n---\n\n${instructions.trim()}\n`;
-            await mkdir(skillDir, { recursive: true });
-            await writeFile(file, source, 'utf-8');
-            deps.registry.add(parseSkill(source, id, skillDir));
-            return [{ type: 'text', text: `Created skill "${id}" at ${file}. It is now available via the \`skill\` tool.` }];
-        },
-    };
-};

package/script/agents/writer.d.ts

@@ -1,14 +0,0 @@
-import type { Tool } from 'mu-core';
-import type { Scope } from '../common/index.js';
-import type { AgentRegistry } from './registry.js';
-/**
- * `create_agent` — authors a reusable agent definition (`.md` with frontmatter)
- * and registers it live via {@link AgentRegistry.add}, so it can be delegated to
- * through `subagent` without a restart. Mirrors {@link createSkillWriterTool}:
- * the `scope` selects the save location, or a configured `forceScope` pins it.
- */
-export declare const createAgentWriterTool: (deps: {
-    dirs: Record<Scope, string>;
-    registry: AgentRegistry;
-    forceScope?: Scope;
-}) => Tool;

package/script/agents/writer.js

@@ -1,85 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAgentWriterTool = void 0;
-const node_fs_1 = require("node:fs");
-const promises_1 = require("node:fs/promises");
-const node_path_1 = require("node:path");
-const mod_js_1 = require("../deps/jsr.io/@std/yaml/1.1.0/mod.js");
-const parser_js_1 = require("./parser.js");
-const slug = (name) => name.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
-/**
- * `create_agent` — authors a reusable agent definition (`.md` with frontmatter)
- * and registers it live via {@link AgentRegistry.add}, so it can be delegated to
- * through `subagent` without a restart. Mirrors {@link createSkillWriterTool}:
- * the `scope` selects the save location, or a configured `forceScope` pins it.
- */
-const createAgentWriterTool = (deps) => {
-    const { forceScope } = deps;
-    const scopeProp = forceScope ? {} : {
-        scope: {
-            type: 'string',
-            enum: ['local', 'config'],
-            description: 'Where to save it: "local" = this project (repo-first), "config" = global config dir. Defaults to "local".',
-        },
-    };
-    return {
-        name: 'create_agent',
-        description: forceScope
-            ? `Define a reusable agent (name, description, system prompt, optional per-tool grants) that can be delegated to via \`subagent\`. Always saved to the "${forceScope}" agents directory.`
-            : 'Define a reusable agent (name, description, system prompt, optional per-tool grants) that can be delegated to via `subagent`. `scope: "local"` saves it to this project, `scope: "config"` makes it available across all projects.',
-        parameters: {
-            type: 'object',
-            properties: {
-                name: { type: 'string', description: 'Short agent name (kebab-case); also the filename.' },
-                description: { type: 'string', description: 'One line describing what this agent is for.' },
-                prompt: { type: 'string', description: 'The system prompt that defines the agent.' },
-                tools: {
-                    type: 'object',
-                    description: 'Optional per-tool grants: map a tool name to "allow" | "ask" | "deny" (or a nested {glob: decision} map). Omitted tools are denied — be explicit about what it may use.',
-                    additionalProperties: true,
-                },
-                model: { type: 'string', description: 'Optional model ref override.' },
-                color: { type: 'string', description: 'Optional hex color for the UI.' },
-                ...scopeProp,
-            },
-            required: ['name', 'description', 'prompt'],
-            additionalProperties: false,
-        },
-        run: async (input) => {
-            const { name, description, prompt, tools, model, color, scope } = (input ?? {});
-            if (!name || !description || !prompt) {
-                return [{ type: 'text', text: 'Error: create_agent requires `name`, `description`, and `prompt`.' }];
-            }
-            // A configured forceScope wins over whatever the model passed.
-            const resolved = forceScope ?? scope ?? 'local';
-            const base = deps.dirs[resolved];
-            if (!base)
-                return [{ type: 'text', text: `Error: unknown scope "${scope}".` }];
-            const id = slug(name);
-            if (!id)
-                return [{ type: 'text', text: `Error: invalid agent name "${name}".` }];
-            if (deps.registry.get(id)) {
-                return [{ type: 'text', text: `Error: an agent named "${id}" already exists.` }];
-            }
-            const file = (0, node_path_1.join)(base, `${id}.md`);
-            if ((0, node_fs_1.existsSync)(file))
-                return [{ type: 'text', text: `Error: ${file} already exists.` }];
-            const frontmatter = { name: id, description };
-            if (model)
-                frontmatter.model = model;
-            if (color)
-                frontmatter.color = color;
-            if (tools && typeof tools === 'object')
-                frontmatter.tools = tools;
-            const source = `---\n${(0, mod_js_1.stringify)(frontmatter).trimEnd()}\n---\n\n${prompt.trim()}\n`;
-            await (0, promises_1.mkdir)(base, { recursive: true });
-            await (0, promises_1.writeFile)(file, source, 'utf-8');
-            deps.registry.add((0, parser_js_1.parseAgent)(source, id));
-            return [{
-                    type: 'text',
-                    text: `Created agent "${id}" at ${file}. It can now be delegated to via the \`subagent\` tool.`,
-                }];
-        },
-    };
-};
-exports.createAgentWriterTool = createAgentWriterTool;

package/script/common/scope.d.ts

@@ -1,8 +0,0 @@
-/**
- * Where a host saves agent-authored definitions (skills, sub-agents, …):
- * - `local`  → the current project (repo-first, e.g. `<cwd>/skills`).
- * - `config` → the global config dir, shared across every project.
- *
- * Generic across definition kinds so every writer tool speaks the same vocabulary.
- */
-export type Scope = 'local' | 'config';

package/script/common/scope.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/script/skills/writer.d.ts

@@ -1,8 +0,0 @@
-import type { Tool } from 'mu-core';
-import type { Scope } from '../common/index.js';
-import type { SkillRegistry } from './registry.js';
-export declare const createSkillWriterTool: (deps: {
-    dirs: Record<Scope, string>;
-    registry: SkillRegistry;
-    forceScope?: Scope;
-}) => Tool;

package/script/skills/writer.js

@@ -1,59 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSkillWriterTool = void 0;
-const promises_1 = require("node:fs/promises");
-const node_path_1 = require("node:path");
-const parser_js_1 = require("./parser.js");
-const slug = (name) => name.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
-const createSkillWriterTool = (deps) => {
-    const { forceScope } = deps;
-    const scopeProp = forceScope ? {} : {
-        scope: {
-            type: 'string',
-            enum: ['local', 'config'],
-            description: 'Where to save it: "local" = this project (<cwd>/skills), "config" = global config dir. Defaults to "local".',
-        },
-    };
-    return {
-        name: 'create_skill',
-        description: forceScope
-            ? `Create a reusable skill (name, description, instructions) the agent can load on demand later — capture a reusable workflow worth keeping. Always saved to the global "${forceScope}" skills directory; load it later via \`skill\`.`
-            : 'Create a reusable skill (name, description, instructions) the agent can load on demand later — capture a reusable workflow worth keeping. `scope: "local"` saves it to this project, `scope: "config"` makes it available across all projects; load it later via `skill`.',
-        parameters: {
-            type: 'object',
-            properties: {
-                name: { type: 'string', description: 'Short skill name (kebab-case).' },
-                description: { type: 'string', description: 'One line describing when this skill should be used.' },
-                instructions: {
-                    type: 'string',
-                    description: 'The skill body: the instructions to follow when it is invoked.',
-                },
-                ...scopeProp,
-            },
-            required: ['name', 'description', 'instructions'],
-            additionalProperties: false,
-        },
-        run: async (input) => {
-            const { name, description, instructions, scope } = (input ?? {});
-            if (!name || !description || !instructions) {
-                return [{ type: 'text', text: 'Error: create_skill requires `name`, `description`, and `instructions`.' }];
-            }
-            // A configured forceScope wins over whatever the model passed.
-            const resolved = forceScope ?? scope ?? 'local';
-            const base = deps.dirs[resolved];
-            if (!base)
-                return [{ type: 'text', text: `Error: unknown scope "${scope}".` }];
-            const id = slug(name);
-            if (!id)
-                return [{ type: 'text', text: `Error: invalid skill name "${name}".` }];
-            const skillDir = (0, node_path_1.join)(base, id);
-            const file = (0, node_path_1.join)(skillDir, 'SKILL.md');
-            const source = `---\nname: ${id}\ndescription: ${JSON.stringify(description)}\n---\n\n${instructions.trim()}\n`;
-            await (0, promises_1.mkdir)(skillDir, { recursive: true });
-            await (0, promises_1.writeFile)(file, source, 'utf-8');
-            deps.registry.add((0, parser_js_1.parseSkill)(source, id, skillDir));
-            return [{ type: 'text', text: `Created skill "${id}" at ${file}. It is now available via the \`skill\` tool.` }];
-        },
-    };
-};
-exports.createSkillWriterTool = createSkillWriterTool;