mu-core 0.33.0 → 0.34.0

package/{esm/types.d.ts → dist/index.d.ts}

@@ -1,4 +1,4 @@
-export type ContentPart = {
+type ContentPart = {
     type: 'text';
     text: string;
 } | {
@@ -19,15 +19,15 @@ export type ContentPart = {
     id: string;
     content: ContentPart[];
 };
-export type Role = 'system' | 'user' | 'assistant' | 'tool';
-export type Message = {
+type Role = 'system' | 'user' | 'assistant' | 'tool';
+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 {
+declare const text: (value: string) => ContentPart;
+declare const image: (mime: string, data: Uint8Array) => ContentPart;
+declare const audio: (mime: string, data: Uint8Array) => ContentPart;
+interface Tool {
     name: string;
     description: string;
     parameters: Record<string, unknown>;
@@ -36,13 +36,13 @@ export interface Tool {
         signal?: AbortSignal;
     }): Promise<ContentPart[]>;
 }
-export interface Usage {
+interface Usage {
     input?: number;
     output?: number;
     total?: number;
     contextWindow?: number;
 }
-export type StreamEvent = ContentPart | {
+type StreamEvent = ContentPart | {
     type: 'usage';
     usage: Usage;
 } | {
@@ -50,11 +50,11 @@ export type StreamEvent = ContentPart | {
     text: string;
 };
 /** Non-text input modalities a model accepts. */
-export interface ModelModalities {
+interface ModelModalities {
     vision: boolean;
     audio: boolean;
 }
-export interface Provider {
+interface Provider {
     stream(req: {
         model: string;
         messages: Message[];
@@ -76,3 +76,47 @@ export interface Provider {
     /** The model's context window in tokens, when the provider can report it. */
     contextWindow?(model: string): Promise<number | undefined>;
 }
+
+type LoopEvent = ContentPart | {
+    type: 'usage';
+    usage: Usage;
+} | {
+    type: 'reasoning';
+    text: string;
+} | {
+    type: 'message';
+    message: Message;
+} | {
+    type: 'error';
+    error: Error;
+} | {
+    type: 'done';
+    messages: Message[];
+};
+interface RunOptions {
+    provider: Provider;
+    model: string;
+    messages: Message[];
+    tools?: Tool[];
+    signal?: AbortSignal;
+}
+declare function run(opts: RunOptions): AsyncIterable<LoopEvent>;
+interface AgentConfig {
+    provider: Provider;
+    model: string;
+    tools?: Tool[];
+    system?: string;
+    signal?: AbortSignal;
+}
+type Input = string | ContentPart[] | Message[];
+interface AgentResult {
+    message: Message;
+    messages: Message[];
+}
+interface Agent {
+    stream(input: Input): AsyncIterable<LoopEvent>;
+    run(input: Input): Promise<AgentResult>;
+}
+declare const createAgent: (config: AgentConfig) => Agent;
+
+export { type Agent, type AgentConfig, type AgentResult, type ContentPart, type Input, type LoopEvent, type Message, type ModelModalities, type Provider, type Role, type RunOptions, type StreamEvent, type Tool, type Usage, audio, createAgent, image, run, text };

package/dist/index.js

@@ -0,0 +1,104 @@
+// src/types.ts
+var text = (value) => ({ type: "text", text: value });
+var image = (mime, data) => ({ type: "image", mime, data });
+var audio = (mime, data) => ({ type: "audio", mime, data });
+
+// src/agent.ts
+var 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);
+  }
+};
+var 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) }];
+  }
+};
+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) {
+    if (signal?.aborted) break;
+    const content = [];
+    const calls = [];
+    try {
+      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);
+      }
+    } catch (error) {
+      yield { type: "error", error: error instanceof Error ? error : new Error(String(error)) };
+      break;
+    }
+    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: "tool", content: results };
+    messages.push(toolMessage);
+    yield { type: "message", message: toolMessage };
+  }
+  yield { type: "done", messages };
+}
+var isMessages = (input) => input.length > 0 && "role" in input[0];
+var toMessages = (input) => {
+  if (typeof input === "string") return [{ role: "user", content: [{ type: "text", text: input }] }];
+  if (isMessages(input)) return input;
+  return [{ role: "user", content: input }];
+};
+var 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 };
+};
+export {
+  audio,
+  createAgent,
+  image,
+  run,
+  text
+};

package/package.json

@@ -1,25 +1,20 @@
 {
   "name": "mu-core",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Standalone multimodal agentic loop: content, messages, tools, provider interface, createAgent",
-  "license": "MIT",
-  "main": "./script/index.js",
-  "module": "./esm/index.js",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": {
-        "types": "./esm/index.d.ts",
-        "default": "./esm/index.js"
-      },
-      "require": {
-        "types": "./script/index.d.ts",
-        "default": "./script/index.js"
-      }
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
     }
   },
-  "scripts": {},
-  "type": "module",
-  "dependencies": {},
-  "_generatedBy": "dnt@dev",
-  "types": "./esm/index.d.ts"
-}
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean"
+  }
+}

package/esm/agent.d.ts

@@ -1,42 +0,0 @@
-import type { ContentPart, Message, Provider, Tool, Usage } from './types.js';
-export type LoopEvent = ContentPart | {
-    type: 'usage';
-    usage: Usage;
-} | {
-    type: 'reasoning';
-    text: string;
-} | {
-    type: 'message';
-    message: Message;
-} | {
-    type: 'error';
-    error: Error;
-} | {
-    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/agent.js

@@ -1,104 +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) {
-        if (signal?.aborted)
-            break;
-        const content = [];
-        const calls = [];
-        try {
-            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);
-            }
-        }
-        catch (error) {
-            yield { type: 'error', error: error instanceof Error ? error : new Error(String(error)) };
-            break;
-        }
-        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: 'tool', 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/index.d.ts

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

package/esm/index.js

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

package/esm/package.json

@@ -1,3 +0,0 @@
-{
-  "type": "module"
-}

package/esm/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/script/agent.d.ts

@@ -1,42 +0,0 @@
-import type { ContentPart, Message, Provider, Tool, Usage } from './types.js';
-export type LoopEvent = ContentPart | {
-    type: 'usage';
-    usage: Usage;
-} | {
-    type: 'reasoning';
-    text: string;
-} | {
-    type: 'message';
-    message: Message;
-} | {
-    type: 'error';
-    error: Error;
-} | {
-    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/script/agent.js

@@ -1,109 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAgent = void 0;
-exports.run = run;
-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) }];
-    }
-};
-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) {
-        if (signal?.aborted)
-            break;
-        const content = [];
-        const calls = [];
-        try {
-            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);
-            }
-        }
-        catch (error) {
-            yield { type: 'error', error: error instanceof Error ? error : new Error(String(error)) };
-            break;
-        }
-        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: 'tool', 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 }];
-};
-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 };
-};
-exports.createAgent = createAgent;

package/script/index.d.ts

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

package/script/index.js

@@ -1,10 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.run = exports.createAgent = exports.text = exports.image = exports.audio = void 0;
-var types_js_1 = require("./types.js");
-Object.defineProperty(exports, "audio", { enumerable: true, get: function () { return types_js_1.audio; } });
-Object.defineProperty(exports, "image", { enumerable: true, get: function () { return types_js_1.image; } });
-Object.defineProperty(exports, "text", { enumerable: true, get: function () { return types_js_1.text; } });
-var agent_js_1 = require("./agent.js");
-Object.defineProperty(exports, "createAgent", { enumerable: true, get: function () { return agent_js_1.createAgent; } });
-Object.defineProperty(exports, "run", { enumerable: true, get: function () { return agent_js_1.run; } });

package/script/package.json

@@ -1,3 +0,0 @@
-{
-  "type": "commonjs"
-}

package/script/types.d.ts

@@ -1,78 +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' | 'tool';
-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;
-};
-/** Non-text input modalities a model accepts. */
-export interface ModelModalities {
-    vision: boolean;
-    audio: boolean;
-}
-export interface Provider {
-    stream(req: {
-        model: string;
-        messages: Message[];
-        tools: Tool[];
-        signal?: AbortSignal;
-        /** Per-turn extra chat-template kwargs (e.g. `{ enable_thinking: false }`). A
-         * provider wrapper can set this for a single turn; merged over any provider-level
-         * default. Providers that don't support it ignore it. */
-        chatTemplateKwargs?: Record<string, unknown>;
-    }): AsyncIterable<StreamEvent>;
-    /**
-     * Probe a model's input modalities. MAY load the model (e.g. a llama.cpp `/props`
-     * fetch) — call it on model selection, not on every turn. Optional: providers that
-     * can't introspect modalities simply omit it.
-     */
-    capabilities?(model: string): Promise<ModelModalities | undefined>;
-    /** Exact token count of `text` via the model's own tokenizer, when the provider supports it. */
-    countTokens?(text: string, model: string): Promise<number | undefined>;
-    /** The model's context window in tokens, when the provider can report it. */
-    contextWindow?(model: string): Promise<number | undefined>;
-}

package/script/types.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.audio = exports.image = exports.text = void 0;
-const text = (value) => ({ type: 'text', text: value });
-exports.text = text;
-const image = (mime, data) => ({ type: 'image', mime, data });
-exports.image = image;
-const audio = (mime, data) => ({ type: 'audio', mime, data });
-exports.audio = audio;