mu-harness 0.16.15 → 0.16.16

package/package.json

@@ -1,14 +1,20 @@
 {
   "name": "mu-harness",
-  "version": "0.16.15",
+  "version": "0.16.16",
   "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",
   "module": "./esm/index.js",
   "exports": {
     ".": {
-      "import": "./esm/index.js",
-      "require": "./script/index.js"
+      "import": {
+        "types": "./esm/index.d.ts",
+        "default": "./esm/index.js"
+      },
+      "require": {
+        "types": "./script/index.d.ts",
+        "default": "./script/index.js"
+      }
     }
   },
   "scripts": {},
@@ -17,9 +23,9 @@
     "@swc/wasm-typescript": "^1.15.0",
     "cli-highlight": "^2.1.11",
     "croner": "^9.0.0",
-    "mu-core": "^0.16.15",
-    "mu-harness": "^0.16.15",
-    "mu-tui": "^0.16.15"
+    "mu-core": "^0.16.16",
+    "mu-tui": "^0.16.16"
   },
-  "_generatedBy": "dnt@dev"
-}
+  "_generatedBy": "dnt@dev",
+  "types": "./esm/index.d.ts"
+}

package/esm/core/src/agent.d.ts

@@ -1,39 +0,0 @@
-import type { ContentPart, Message, Provider, Tool, Usage } from './types';
-export type LoopEvent = ContentPart | {
-    type: 'usage';
-    usage: Usage;
-} | {
-    type: 'reasoning';
-    text: string;
-} | {
-    type: 'message';
-    message: Message;
-} | {
-    type: 'done';
-    messages: Message[];
-};
-export interface RunOptions {
-    provider: Provider;
-    model: string;
-    messages: Message[];
-    tools?: Tool[];
-    signal?: AbortSignal;
-}
-export declare function run(opts: RunOptions): AsyncIterable<LoopEvent>;
-export interface AgentConfig {
-    provider: Provider;
-    model: string;
-    tools?: Tool[];
-    system?: string;
-    signal?: AbortSignal;
-}
-export type Input = string | ContentPart[] | Message[];
-export interface AgentResult {
-    message: Message;
-    messages: Message[];
-}
-export interface Agent {
-    stream(input: Input): AsyncIterable<LoopEvent>;
-    run(input: Input): Promise<AgentResult>;
-}
-export declare const createAgent: (config: AgentConfig) => Agent;

package/esm/core/src/agent.js

@@ -1,96 +0,0 @@
-const append = (parts, part) => {
-    const last = parts[parts.length - 1];
-    if (part.type === 'text' && last?.type === 'text') {
-        last.text += part.text;
-    }
-    else if (part.type === 'audio' && last?.type === 'audio' && last.mime === part.mime) {
-        const merged = new Uint8Array(last.data.length + part.data.length);
-        merged.set(last.data);
-        merged.set(part.data, last.data.length);
-        last.data = merged;
-    }
-    else if (part.type === 'text') {
-        parts.push({ type: 'text', text: part.text });
-    }
-    else if (part.type === 'audio') {
-        parts.push({ type: 'audio', mime: part.mime, data: part.data });
-    }
-    else {
-        parts.push(part);
-    }
-};
-const execute = async (tools, call, signal) => {
-    const tool = tools.get(call.name);
-    if (!tool)
-        return [{ type: 'text', text: `Unknown tool: ${call.name}` }];
-    try {
-        return await tool.run(call.input, { signal });
-    }
-    catch (err) {
-        return [{ type: 'text', text: err instanceof Error ? err.message : String(err) }];
-    }
-};
-export async function* run(opts) {
-    const { provider, model, signal } = opts;
-    const tools = opts.tools ?? [];
-    const registry = new Map(tools.map((t) => [t.name, t]));
-    const messages = [...opts.messages];
-    while (true) {
-        const content = [];
-        const calls = [];
-        for await (const event of provider.stream({ model, messages, tools, signal })) {
-            if (event.type === 'usage' || event.type === 'reasoning') {
-                yield event;
-                continue;
-            }
-            yield event;
-            append(content, event);
-            if (event.type === 'tool_call')
-                calls.push(event);
-        }
-        const message = { role: 'assistant', content };
-        messages.push(message);
-        yield { type: 'message', message };
-        if (calls.length === 0)
-            break;
-        const results = await Promise.all(calls.map(async (call) => ({
-            type: 'tool_result',
-            id: call.id,
-            content: await execute(registry, call, signal),
-        })));
-        const toolMessage = { role: 'user', content: results };
-        messages.push(toolMessage);
-        yield { type: 'message', message: toolMessage };
-    }
-    yield { type: 'done', messages };
-}
-const isMessages = (input) => input.length > 0 && 'role' in input[0];
-const toMessages = (input) => {
-    if (typeof input === 'string')
-        return [{ role: 'user', content: [{ type: 'text', text: input }] }];
-    if (isMessages(input))
-        return input;
-    return [{ role: 'user', content: input }];
-};
-export const createAgent = (config) => {
-    const tools = config.tools ?? [];
-    const build = (input) => {
-        const messages = toMessages(input);
-        if (!config.system)
-            return messages;
-        return [{ role: 'system', content: [{ type: 'text', text: config.system }] }, ...messages];
-    };
-    const stream = (input) => run({ provider: config.provider, model: config.model, tools, messages: build(input), signal: config.signal });
-    const runToEnd = async (input) => {
-        let message = { role: 'assistant', content: [] };
-        let messages = [];
-        for await (const event of stream(input)) {
-            if (event.type === 'message' && event.message.role === 'assistant')
-                message = event.message;
-            else if (event.type === 'done')
-                messages = event.messages;
-        }
-        return { message, messages };
-    };
-    return { stream, run: runToEnd };
-};

package/esm/core/src/index.d.ts

@@ -1,4 +0,0 @@
-export type { ContentPart, Message, Provider, Role, StreamEvent, Tool, Usage } from './types';
-export { audio, image, text } from './types';
-export type { Agent, AgentConfig, AgentResult, Input, LoopEvent, RunOptions } from './agent';
-export { createAgent, run } from './agent';

package/esm/core/src/index.js

@@ -1,2 +0,0 @@
-export { audio, image, text } from './types';
-export { createAgent, run } from './agent';

package/esm/core/src/types.d.ts

@@ -1,59 +0,0 @@
-export type ContentPart = {
-    type: 'text';
-    text: string;
-} | {
-    type: 'image';
-    mime: string;
-    data: Uint8Array;
-} | {
-    type: 'audio';
-    mime: string;
-    data: Uint8Array;
-} | {
-    type: 'tool_call';
-    id: string;
-    name: string;
-    input: unknown;
-} | {
-    type: 'tool_result';
-    id: string;
-    content: ContentPart[];
-};
-export type Role = 'system' | 'user' | 'assistant';
-export type Message = {
-    role: Role;
-    content: ContentPart[];
-};
-export declare const text: (value: string) => ContentPart;
-export declare const image: (mime: string, data: Uint8Array) => ContentPart;
-export declare const audio: (mime: string, data: Uint8Array) => ContentPart;
-export interface Tool {
-    name: string;
-    description: string;
-    parameters: Record<string, unknown>;
-    prompt?: string;
-    run(input: unknown, ctx: {
-        signal?: AbortSignal;
-    }): Promise<ContentPart[]>;
-}
-export interface Usage {
-    input?: number;
-    output?: number;
-    total?: number;
-    contextWindow?: number;
-}
-export type StreamEvent = ContentPart | {
-    type: 'usage';
-    usage: Usage;
-} | {
-    type: 'reasoning';
-    text: string;
-};
-export interface Provider {
-    stream(req: {
-        model: string;
-        messages: Message[];
-        tools: Tool[];
-        signal?: AbortSignal;
-    }): AsyncIterable<StreamEvent>;
-}

package/esm/core/src/types.js

@@ -1,3 +0,0 @@
-export const text = (value) => ({ type: 'text', text: value });
-export const image = (mime, data) => ({ type: 'image', mime, data });
-export const audio = (mime, data) => ({ type: 'audio', mime, data });

package/esm/harness/src/agents/index.d.ts

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

package/esm/harness/src/agents/index.js

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

package/esm/harness/src/agents/loader.d.ts

@@ -1,2 +0,0 @@
-import type { Agent } from './types';
-export declare const loadAgents: (dir: string) => Promise<Agent[]>;

package/esm/harness/src/agents/loader.js

@@ -1,24 +0,0 @@
-import { readdir, readFile } from 'node:fs/promises';
-import { basename, join } from 'node:path';
-import { parseAgent } from './parser';
-export const loadAgents = async (dir) => {
-    let entries;
-    try {
-        entries = await readdir(dir);
-    }
-    catch {
-        return [];
-    }
-    const files = entries.filter((name) => name.endsWith('.md')).sort();
-    const agents = [];
-    for (const file of files) {
-        try {
-            const source = await readFile(join(dir, file), 'utf-8');
-            agents.push(parseAgent(source, basename(file, '.md')));
-        }
-        catch {
-            continue;
-        }
-    }
-    return agents;
-};

package/esm/harness/src/agents/parser.d.ts

@@ -1,2 +0,0 @@
-import type { Agent } from './types';
-export declare const parseAgent: (source: string, fallbackName: string) => Agent;

package/esm/harness/src/agents/parser.js

@@ -1,46 +0,0 @@
-import { parseFrontmatter, str } from '../common';
-const DECISIONS = new Set(['allow', 'ask', 'deny']);
-const isDecision = (value) => typeof value === 'string' && DECISIONS.has(value);
-const parseStringList = (raw) => (Array.isArray(raw) ? raw : raw.split(','))
-    .filter((entry) => typeof entry === 'string')
-    .map((entry) => entry.trim())
-    .filter(Boolean);
-const parseDecisionMap = (raw) => {
-    const out = {};
-    for (const [key, value] of Object.entries(raw))
-        if (isDecision(value))
-            out[key] = value;
-    return Object.keys(out).length > 0 ? out : undefined;
-};
-const parseTools = (raw) => {
-    if (Array.isArray(raw) || typeof raw === 'string') {
-        const list = parseStringList(raw);
-        return list.length > 0 ? list : undefined;
-    }
-    if (raw && typeof raw === 'object') {
-        const out = {};
-        for (const [tool, value] of Object.entries(raw)) {
-            if (isDecision(value))
-                out[tool] = value;
-            else if (value && typeof value === 'object' && !Array.isArray(value)) {
-                const nested = parseDecisionMap(value);
-                if (nested)
-                    out[tool] = nested;
-            }
-        }
-        return Object.keys(out).length > 0 ? out : undefined;
-    }
-    return undefined;
-};
-export const parseAgent = (source, fallbackName) => {
-    const { fields, body } = parseFrontmatter(source);
-    return {
-        name: str(fields.name) ?? fallbackName,
-        description: str(fields.description) ?? '',
-        prompt: body,
-        tools: parseTools(fields.tools),
-        model: str(fields.model),
-        color: str(fields.color),
-        extends: str(fields.extends),
-    };
-};

package/esm/harness/src/agents/registry.d.ts

@@ -1,9 +0,0 @@
-import type { Agent, ToolDecision } from './types';
-export interface AgentRegistry {
-    list(): Agent[];
-    get(name: string): Agent | undefined;
-}
-export declare const grantArg: (tool: string, input: unknown) => string | undefined;
-export declare const toolDecision: (agent: Agent, tool: string, arg?: string) => ToolDecision;
-export declare const toolNames: (agent: Agent) => string[] | undefined;
-export declare const createAgentRegistry: (agents?: Agent[]) => AgentRegistry;

package/esm/harness/src/agents/registry.js

@@ -1,88 +0,0 @@
-import { matchesGlob } from 'node:path';
-const asMap = (grants) => {
-    if (!grants)
-        return undefined;
-    if (Array.isArray(grants))
-        return Object.fromEntries(grants.map((name) => [name, 'allow']));
-    return grants;
-};
-const matchKey = (keys, name) => {
-    if (keys.includes(name))
-        return name;
-    let glob;
-    for (const key of keys) {
-        if (key === '*' || key === name)
-            continue;
-        if (matchesGlob(name, key) && (glob === undefined || key.length > glob.length))
-            glob = key;
-    }
-    if (glob !== undefined)
-        return glob;
-    return keys.includes('*') ? '*' : undefined;
-};
-const resolveGrant = (grants, tool, arg) => {
-    const map = asMap(grants);
-    if (!map)
-        return 'allow';
-    const key = matchKey(Object.keys(map), tool);
-    if (key === undefined)
-        return 'deny';
-    const value = map[key];
-    if (typeof value === 'string')
-        return value;
-    if (arg === undefined)
-        return 'allow';
-    const inner = matchKey(Object.keys(value), arg);
-    return inner === undefined ? 'deny' : value[inner];
-};
-const grantNames = (grants) => {
-    const map = asMap(grants);
-    if (!map)
-        return undefined;
-    const wildcard = map['*'];
-    if (wildcard !== undefined && wildcard !== 'deny')
-        return ['*'];
-    return Object.entries(map).filter(([, value]) => value !== 'deny').map(([name]) => name);
-};
-const GRANT_ARG = { skill: 'name', bash: 'command' };
-export const grantArg = (tool, input) => {
-    const field = GRANT_ARG[tool];
-    if (!field || typeof input !== 'object' || input === null)
-        return undefined;
-    const value = input[field];
-    return typeof value === 'string' ? value : undefined;
-};
-export const toolDecision = (agent, tool, arg) => resolveGrant(agent.tools, tool, arg);
-export const toolNames = (agent) => grantNames(agent.tools);
-const merge = (base, child) => ({
-    name: child.name,
-    description: child.description || base.description,
-    prompt: child.prompt || base.prompt,
-    tools: child.tools ?? base.tools,
-    model: child.model ?? base.model,
-    color: child.color ?? base.color,
-});
-export const createAgentRegistry = (agents = []) => {
-    const raw = new Map();
-    for (const agent of agents)
-        if (!raw.has(agent.name))
-            raw.set(agent.name, agent);
-    const resolve = (name, seen) => {
-        const agent = raw.get(name);
-        if (!agent.extends)
-            return agent;
-        if (seen.has(name))
-            throw new Error(`AgentRegistry: "extends" cycle at "${name}"`);
-        const base = raw.get(agent.extends);
-        if (!base)
-            throw new Error(`AgentRegistry: "${name}" extends unknown agent "${agent.extends}"`);
-        return merge(resolve(agent.extends, new Set(seen).add(name)), agent);
-    };
-    const byName = new Map();
-    for (const name of raw.keys())
-        byName.set(name, resolve(name, new Set()));
-    return {
-        list: () => [...byName.values()],
-        get: (name) => byName.get(name),
-    };
-};

package/esm/harness/src/agents/types.js

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

package/esm/harness/src/channels/channel.d.ts

@@ -1,7 +0,0 @@
-import type { AgentSession } from '../session';
-import type { Channel } from './types';
-export declare const createChannel: (config: {
-    id: string;
-    title: string;
-    createSession: () => AgentSession;
-}) => Channel;

package/esm/harness/src/channels/channel.js

@@ -1,25 +0,0 @@
-import { createEmitter } from '../common';
-export const createChannel = (config) => {
-    let session;
-    const emitter = createEmitter();
-    const ensure = () => {
-        if (!session) {
-            session = config.createSession();
-            session.subscribe(emitter.emit);
-        }
-        return session;
-    };
-    return {
-        id: config.id,
-        title: config.title,
-        get started() {
-            return session !== undefined;
-        },
-        get messages() {
-            return session?.messages ?? [];
-        },
-        send: (input) => ensure().send(input),
-        abort: () => session?.abort(),
-        subscribe: emitter.subscribe,
-    };
-};

package/esm/harness/src/channels/index.d.ts

@@ -1,3 +0,0 @@
-export type { Channel, ChannelEvent, ChannelManager, ChannelManagerEvent } from './types';
-export { createChannel } from './channel';
-export { createChannelManager } from './manager';

package/esm/harness/src/channels/index.js

@@ -1,2 +0,0 @@
-export { createChannel } from './channel';
-export { createChannelManager } from './manager';

package/esm/harness/src/channels/manager.d.ts

@@ -1,6 +0,0 @@
-import type { AgentSession } from '../session';
-import type { ChannelManager } from './types';
-export declare const createChannelManager: (config: {
-    createSession: () => AgentSession;
-    idGen?: () => string;
-}) => ChannelManager;

package/esm/harness/src/channels/manager.js

@@ -1,28 +0,0 @@
-import { createEmitter } from '../common';
-import { createChannel } from './channel';
-export const createChannelManager = (config) => {
-    const channels = new Map();
-    const unsubs = new Map();
-    const emitter = createEmitter();
-    const idGen = config.idGen ?? (() => crypto.randomUUID());
-    return {
-        open(opts) {
-            const id = opts?.id ?? idGen();
-            const title = opts?.title ?? id;
-            const channel = createChannel({ id, title, createSession: config.createSession });
-            channels.set(id, channel);
-            unsubs.set(id, channel.subscribe((event) => emitter.emit({ channelId: id, ...event })));
-            emitter.emit({ channelId: id, type: 'channel_open', title });
-            return channel;
-        },
-        get: (id) => channels.get(id),
-        list: () => [...channels.values()],
-        close(id) {
-            unsubs.get(id)?.();
-            unsubs.delete(id);
-            if (channels.delete(id))
-                emitter.emit({ channelId: id, type: 'channel_close' });
-        },
-        subscribe: emitter.subscribe,
-    };
-};

package/esm/harness/src/channels/types.d.ts

@@ -1,30 +0,0 @@
-import type { ContentPart, Message } from 'mu-core';
-import type { AgentSessionEvent } from '../session';
-export type ChannelEvent = AgentSessionEvent | {
-    type: 'channel_open';
-    title: string;
-} | {
-    type: 'channel_close';
-};
-export type ChannelManagerEvent = {
-    channelId: string;
-} & ChannelEvent;
-export interface Channel {
-    readonly id: string;
-    readonly title: string;
-    readonly started: boolean;
-    readonly messages: readonly Message[];
-    send(input: string | ContentPart[]): Promise<void>;
-    abort(): void;
-    subscribe(listener: (event: AgentSessionEvent) => void): () => void;
-}
-export interface ChannelManager {
-    open(opts?: {
-        id?: string;
-        title?: string;
-    }): Channel;
-    get(id: string): Channel | undefined;
-    list(): Channel[];
-    close(id: string): void;
-    subscribe(listener: (event: ChannelManagerEvent) => void): () => void;
-}

package/esm/harness/src/channels/types.js

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

package/esm/harness/src/commands/defaults.d.ts

@@ -1,11 +0,0 @@
-import type { AgentRegistry } from '../agents';
-import type { SessionManager } from '../session';
-import type { SkillRegistry } from '../skills';
-import type { Command } from './types';
-export declare const createAgentsCommand: (agents: AgentRegistry) => Command;
-export declare const createSkillsCommand: (skills: SkillRegistry) => Command;
-export declare const createSessionsCommand: (sessions: SessionManager, options?: {
-    cwd?: string;
-}) => Command;
-export declare const createQuitCommand: (onQuit: () => void | Promise<void>) => Command;
-export declare const createHelpCommand: (list: () => Command[]) => Command;

package/esm/harness/src/commands/defaults.js

@@ -1,53 +0,0 @@
-export const createAgentsCommand = (agents) => ({
-    name: 'agents',
-    description: 'List available agents',
-    run: () => {
-        const list = agents.list();
-        if (list.length === 0)
-            return { ok: true, output: 'No agents configured.' };
-        const lines = list.map((a) => `- ${a.name}${a.description ? ` — ${a.description}` : ''}`);
-        return { ok: true, output: lines.join('\n') };
-    },
-});
-export const createSkillsCommand = (skills) => ({
-    name: 'skills',
-    description: 'List available skills',
-    run: () => {
-        const list = skills.list();
-        if (list.length === 0)
-            return { ok: true, output: 'No skills configured.' };
-        const lines = list.map((s) => `- ${s.name}${s.description ? ` — ${s.description}` : ''}`);
-        return { ok: true, output: lines.join('\n') };
-    },
-});
-export const createSessionsCommand = (sessions, options) => ({
-    name: 'sessions',
-    description: 'List saved sessions',
-    run: async () => {
-        const list = await sessions.list(options?.cwd ? { cwd: options.cwd } : undefined);
-        if (list.length === 0)
-            return { ok: true, output: 'No sessions yet.' };
-        const lines = list.map((s) => `- ${s.title || s.id}`);
-        return { ok: true, output: lines.join('\n') };
-    },
-});
-export const createQuitCommand = (onQuit) => ({
-    name: 'quit',
-    description: 'Exit the session',
-    aliases: ['q'],
-    run: async () => {
-        await onQuit();
-        return { ok: true };
-    },
-});
-export const createHelpCommand = (list) => ({
-    name: 'help',
-    description: 'Show available commands',
-    run: () => {
-        const commands = list();
-        if (commands.length === 0)
-            return { ok: true, output: 'No commands registered.' };
-        const lines = commands.map((c) => `/${c.name} — ${c.description}`);
-        return { ok: true, output: lines.join('\n') };
-    },
-});

package/esm/harness/src/commands/index.d.ts

@@ -1,3 +0,0 @@
-export { createAgentsCommand, createHelpCommand, createQuitCommand, createSessionsCommand, createSkillsCommand, } from './defaults';
-export { createCommandRegistry } from './registry';
-export type { Command, CommandContext, CommandRegistry, CommandResult } from './types';

package/esm/harness/src/commands/index.js

@@ -1,2 +0,0 @@
-export { createAgentsCommand, createHelpCommand, createQuitCommand, createSessionsCommand, createSkillsCommand, } from './defaults';
-export { createCommandRegistry } from './registry';

package/esm/harness/src/commands/registry.d.ts

@@ -1,2 +0,0 @@
-import type { Command, CommandRegistry } from './types';
-export declare const createCommandRegistry: (commands?: Command[]) => CommandRegistry;