@tuttiai/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tutti AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,62 @@
+# @tuttiai/core
+
+The runtime engine for [Tutti](https://tutti-ai.com) — an open-source multi-agent orchestration framework for TypeScript.
+
+## Install
+
+```bash
+npm install @tuttiai/core
+```
+
+## Quick start
+
+```ts
+import { TuttiRuntime, AnthropicProvider, defineScore } from "@tuttiai/core";
+
+const score = defineScore({
+  name: "my-project",
+  provider: new AnthropicProvider(), // uses ANTHROPIC_API_KEY env var
+  agents: {
+    assistant: {
+      name: "assistant",
+      model: "claude-sonnet-4-20250514",
+      system_prompt: "You are a helpful assistant.",
+      voices: [],
+    },
+  },
+});
+
+const tutti = new TuttiRuntime(score);
+const result = await tutti.run("assistant", "Hello!");
+console.log(result.output);
+```
+
+## What's included
+
+- **TuttiRuntime** — top-level orchestrator
+- **AgentRunner** — agentic while-loop (LLM call → tool execution → repeat)
+- **AnthropicProvider** — `LLMProvider` implementation via `@anthropic-ai/sdk`
+- **EventBus** — typed pub/sub for full lifecycle observability
+- **InMemorySessionStore** — conversation persistence
+- **ScoreLoader** — dynamic import of `tutti.score.ts` files
+- **defineScore()** — typed identity function for score authoring
+
+## Observability
+
+Every action emits typed events:
+
+```ts
+tutti.events.on("tool:start", (e) => {
+  console.log(`Calling tool: ${e.tool_name}`);
+});
+```
+
+## Links
+
+- [Tutti](https://tutti-ai.com)
+- [GitHub](https://github.com/tuttiai/tutti/tree/main/packages/core)
+- [Docs](https://tutti-ai.com/docs)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+import { TuttiEventType, TuttiEvent, ScoreConfig, AgentResult, Session, LLMProvider, SessionStore, AgentConfig, ChatMessage, ChatRequest, ChatResponse } from '@tuttiai/types';
+export { AgentConfig, AgentResult, ChatMessage, ChatRequest, ChatResponse, ContentBlock, LLMProvider, ScoreConfig, Session, SessionStore, StopReason, TextBlock, TokenUsage, Tool, ToolContext, ToolDefinition, ToolResult, ToolResultBlock, ToolUseBlock, TuttiEvent, TuttiEventHandler, TuttiEventType, Voice, VoiceContext } from '@tuttiai/types';
+
+declare class EventBus {
+    private listeners;
+    on<T extends TuttiEventType>(type: T, handler: (event: Extract<TuttiEvent, {
+        type: T;
+    }>) => void): () => void;
+    off<T extends TuttiEventType>(type: T, handler: (event: Extract<TuttiEvent, {
+        type: T;
+    }>) => void): void;
+    emit(event: TuttiEvent): void;
+    /** Subscribe to all events. */
+    onAny(handler: (event: TuttiEvent) => void): () => void;
+}
+
+declare class TuttiRuntime {
+    readonly events: EventBus;
+    private sessions;
+    private runner;
+    private score;
+    constructor(score: ScoreConfig);
+    /**
+     * Run an agent by name with the given user input.
+     * Optionally pass a session_id to continue a conversation.
+     */
+    run(agent_name: string, input: string, session_id?: string): Promise<AgentResult>;
+    /** Retrieve an existing session. */
+    getSession(id: string): Session | undefined;
+}
+
+declare class AgentRunner {
+    private provider;
+    private events;
+    private sessions;
+    constructor(provider: LLMProvider, events: EventBus, sessions: SessionStore);
+    run(agent: AgentConfig, input: string, session_id?: string): Promise<AgentResult>;
+    private executeTool;
+}
+
+declare class InMemorySessionStore implements SessionStore {
+    private sessions;
+    create(agent_name: string): Session;
+    get(id: string): Session | undefined;
+    update(id: string, messages: ChatMessage[]): void;
+}
+
+declare class ScoreLoader {
+    /**
+     * Dynamically import a tutti.score.ts file and return its config.
+     * Expects the file to `export default defineScore({ ... })`.
+     */
+    static load(path: string): Promise<ScoreConfig>;
+}
+
+/**
+ * Typed identity function for defining a Tutti score.
+ * Provides autocomplete and type checking — no runtime magic.
+ */
+declare function defineScore(config: ScoreConfig): ScoreConfig;
+
+interface AnthropicProviderOptions {
+    api_key?: string;
+}
+declare class AnthropicProvider implements LLMProvider {
+    private client;
+    constructor(options?: AnthropicProviderOptions);
+    chat(request: ChatRequest): Promise<ChatResponse>;
+}
+
+export { AgentRunner, AnthropicProvider, type AnthropicProviderOptions, EventBus, InMemorySessionStore, ScoreLoader, TuttiRuntime, defineScore };

package/dist/index.js

@@ -0,0 +1,355 @@
+// src/agent-runner.ts
+import { zodToJsonSchema } from "zod-to-json-schema";
+var DEFAULT_MAX_TURNS = 10;
+var AgentRunner = class {
+  constructor(provider, events, sessions) {
+    this.provider = provider;
+    this.events = events;
+    this.sessions = sessions;
+  }
+  provider;
+  events;
+  sessions;
+  async run(agent, input, session_id) {
+    const session = session_id ? this.sessions.get(session_id) : this.sessions.create(agent.name);
+    if (!session) {
+      throw new Error(`Session not found: ${session_id}`);
+    }
+    this.events.emit({
+      type: "agent:start",
+      agent_name: agent.name,
+      session_id: session.id
+    });
+    const allTools = agent.voices.flatMap((v) => v.tools);
+    const toolDefs = allTools.map(toolToDefinition);
+    const messages = [
+      ...session.messages,
+      { role: "user", content: input }
+    ];
+    const maxTurns = agent.max_turns ?? DEFAULT_MAX_TURNS;
+    const totalUsage = { input_tokens: 0, output_tokens: 0 };
+    let turns = 0;
+    while (turns < maxTurns) {
+      turns++;
+      this.events.emit({
+        type: "turn:start",
+        agent_name: agent.name,
+        session_id: session.id,
+        turn: turns
+      });
+      const request = {
+        model: agent.model,
+        system: agent.system_prompt,
+        messages,
+        tools: toolDefs.length > 0 ? toolDefs : void 0
+      };
+      this.events.emit({
+        type: "llm:request",
+        agent_name: agent.name,
+        request
+      });
+      const response = await this.provider.chat(request);
+      this.events.emit({
+        type: "llm:response",
+        agent_name: agent.name,
+        response
+      });
+      totalUsage.input_tokens += response.usage.input_tokens;
+      totalUsage.output_tokens += response.usage.output_tokens;
+      messages.push({ role: "assistant", content: response.content });
+      this.events.emit({
+        type: "turn:end",
+        agent_name: agent.name,
+        session_id: session.id,
+        turn: turns
+      });
+      if (response.stop_reason !== "tool_use") {
+        break;
+      }
+      const toolUseBlocks = response.content.filter(
+        (b) => b.type === "tool_use"
+      );
+      const toolResults = await Promise.all(
+        toolUseBlocks.map(
+          (block) => this.executeTool(allTools, block, {
+            session_id: session.id,
+            agent_name: agent.name
+          })
+        )
+      );
+      messages.push({ role: "user", content: toolResults });
+    }
+    this.sessions.update(session.id, messages);
+    const lastAssistant = messages.filter((m) => m.role === "assistant").at(-1);
+    const output = extractText(lastAssistant?.content);
+    this.events.emit({
+      type: "agent:end",
+      agent_name: agent.name,
+      session_id: session.id
+    });
+    return {
+      session_id: session.id,
+      output,
+      messages,
+      turns,
+      usage: totalUsage
+    };
+  }
+  async executeTool(tools, block, context) {
+    const tool = tools.find((t) => t.name === block.name);
+    if (!tool) {
+      return {
+        type: "tool_result",
+        tool_use_id: block.id,
+        content: `Tool not found: ${block.name}`,
+        is_error: true
+      };
+    }
+    this.events.emit({
+      type: "tool:start",
+      agent_name: context.agent_name,
+      tool_name: block.name,
+      input: block.input
+    });
+    try {
+      const parsed = tool.parameters.parse(block.input);
+      const result = await tool.execute(parsed, context);
+      this.events.emit({
+        type: "tool:end",
+        agent_name: context.agent_name,
+        tool_name: block.name,
+        result
+      });
+      return {
+        type: "tool_result",
+        tool_use_id: block.id,
+        content: result.content,
+        is_error: result.is_error
+      };
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      this.events.emit({
+        type: "tool:error",
+        agent_name: context.agent_name,
+        tool_name: block.name,
+        error: error instanceof Error ? error : new Error(message)
+      });
+      return {
+        type: "tool_result",
+        tool_use_id: block.id,
+        content: `Tool execution error: ${message}`,
+        is_error: true
+      };
+    }
+  }
+};
+function toolToDefinition(tool) {
+  const jsonSchema = zodToJsonSchema(tool.parameters, { target: "openApi3" });
+  return {
+    name: tool.name,
+    description: tool.description,
+    input_schema: jsonSchema
+  };
+}
+function extractText(content) {
+  if (!content) return "";
+  if (typeof content === "string") return content;
+  return content.filter((b) => b.type === "text").map((b) => b.text).join("\n");
+}
+
+// src/event-bus.ts
+var EventBus = class {
+  listeners = /* @__PURE__ */ new Map();
+  on(type, handler) {
+    if (!this.listeners.has(type)) {
+      this.listeners.set(type, /* @__PURE__ */ new Set());
+    }
+    const handlers = this.listeners.get(type);
+    const h = handler;
+    handlers.add(h);
+    return () => {
+      handlers.delete(h);
+    };
+  }
+  off(type, handler) {
+    this.listeners.get(type)?.delete(handler);
+  }
+  emit(event) {
+    const handlers = this.listeners.get(event.type);
+    if (handlers) {
+      for (const handler of handlers) {
+        handler(event);
+      }
+    }
+    const wildcardHandlers = this.listeners.get("*");
+    if (wildcardHandlers) {
+      for (const handler of wildcardHandlers) {
+        handler(event);
+      }
+    }
+  }
+  /** Subscribe to all events. */
+  onAny(handler) {
+    if (!this.listeners.has("*")) {
+      this.listeners.set("*", /* @__PURE__ */ new Set());
+    }
+    const handlers = this.listeners.get("*");
+    const h = handler;
+    handlers.add(h);
+    return () => {
+      handlers.delete(h);
+    };
+  }
+};
+
+// src/session-store.ts
+import { randomUUID } from "crypto";
+var InMemorySessionStore = class {
+  sessions = /* @__PURE__ */ new Map();
+  create(agent_name) {
+    const session = {
+      id: randomUUID(),
+      agent_name,
+      messages: [],
+      created_at: /* @__PURE__ */ new Date(),
+      updated_at: /* @__PURE__ */ new Date()
+    };
+    this.sessions.set(session.id, session);
+    return session;
+  }
+  get(id) {
+    return this.sessions.get(id);
+  }
+  update(id, messages) {
+    const session = this.sessions.get(id);
+    if (!session) {
+      throw new Error(`Session not found: ${id}`);
+    }
+    session.messages = messages;
+    session.updated_at = /* @__PURE__ */ new Date();
+  }
+};
+
+// src/runtime.ts
+var TuttiRuntime = class {
+  events;
+  sessions;
+  runner;
+  score;
+  constructor(score) {
+    this.score = score;
+    this.events = new EventBus();
+    this.sessions = new InMemorySessionStore();
+    this.runner = new AgentRunner(score.provider, this.events, this.sessions);
+  }
+  /**
+   * Run an agent by name with the given user input.
+   * Optionally pass a session_id to continue a conversation.
+   */
+  async run(agent_name, input, session_id) {
+    const agent = this.score.agents[agent_name];
+    if (!agent) {
+      const available = Object.keys(this.score.agents).join(", ");
+      throw new Error(
+        `Agent "${agent_name}" not found. Available agents: ${available}`
+      );
+    }
+    const resolvedAgent = agent.model ? agent : { ...agent, model: this.score.default_model ?? "claude-sonnet-4-20250514" };
+    return this.runner.run(resolvedAgent, input, session_id);
+  }
+  /** Retrieve an existing session. */
+  getSession(id) {
+    return this.sessions.get(id);
+  }
+};
+
+// src/score-loader.ts
+import { pathToFileURL } from "url";
+import { resolve } from "path";
+var ScoreLoader = class {
+  /**
+   * Dynamically import a tutti.score.ts file and return its config.
+   * Expects the file to `export default defineScore({ ... })`.
+   */
+  static async load(path) {
+    const absolute = resolve(path);
+    const url = pathToFileURL(absolute).href;
+    const mod = await import(url);
+    if (!mod.default) {
+      throw new Error(
+        `Score file must have a default export: ${path}`
+      );
+    }
+    return mod.default;
+  }
+};
+
+// src/define-score.ts
+function defineScore(config) {
+  return config;
+}
+
+// src/providers/anthropic.ts
+import Anthropic from "@anthropic-ai/sdk";
+var AnthropicProvider = class {
+  client;
+  constructor(options = {}) {
+    this.client = new Anthropic({
+      apiKey: options.api_key
+    });
+  }
+  async chat(request) {
+    if (!request.model) {
+      throw new Error("AnthropicProvider requires a model on ChatRequest");
+    }
+    const response = await this.client.messages.create({
+      model: request.model,
+      max_tokens: request.max_tokens ?? 4096,
+      system: request.system ?? "",
+      messages: request.messages.map((msg) => ({
+        role: msg.role,
+        content: msg.content
+      })),
+      tools: request.tools?.map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        input_schema: tool.input_schema
+      })),
+      ...request.temperature != null && { temperature: request.temperature },
+      ...request.stop_sequences && { stop_sequences: request.stop_sequences }
+    });
+    const content = response.content.map((block) => {
+      if (block.type === "text") {
+        return { type: "text", text: block.text };
+      }
+      if (block.type === "tool_use") {
+        return {
+          type: "tool_use",
+          id: block.id,
+          name: block.name,
+          input: block.input
+        };
+      }
+      throw new Error(`Unexpected content block type: ${block.type}`);
+    });
+    return {
+      id: response.id,
+      content,
+      stop_reason: response.stop_reason,
+      usage: {
+        input_tokens: response.usage.input_tokens,
+        output_tokens: response.usage.output_tokens
+      }
+    };
+  }
+};
+export {
+  AgentRunner,
+  AnthropicProvider,
+  EventBus,
+  InMemorySessionStore,
+  ScoreLoader,
+  TuttiRuntime,
+  defineScore
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent-runner.ts","../src/event-bus.ts","../src/session-store.ts","../src/runtime.ts","../src/score-loader.ts","../src/define-score.ts","../src/providers/anthropic.ts"],"sourcesContent":["import { zodToJsonSchema } from \"zod-to-json-schema\";\nimport type {\n  AgentConfig,\n  AgentResult,\n  ChatMessage,\n  ContentBlock,\n  LLMProvider,\n  SessionStore,\n  Tool,\n  ToolContext,\n  ToolDefinition,\n  ToolResultBlock,\n  ToolUseBlock,\n  TokenUsage,\n} from \"@tuttiai/types\";\nimport type { EventBus } from \"./event-bus.js\";\n\nconst DEFAULT_MAX_TURNS = 10;\n\nexport class AgentRunner {\n  constructor(\n    private provider: LLMProvider,\n    private events: EventBus,\n    private sessions: SessionStore,\n  ) {}\n\n  async run(\n    agent: AgentConfig,\n    input: string,\n    session_id?: string,\n  ): Promise<AgentResult> {\n    // Resolve or create session\n    const session = session_id\n      ? this.sessions.get(session_id)\n      : this.sessions.create(agent.name);\n\n    if (!session) {\n      throw new Error(`Session not found: ${session_id}`);\n    }\n\n    this.events.emit({\n      type: \"agent:start\",\n      agent_name: agent.name,\n      session_id: session.id,\n    });\n\n    // Collect all tools from all voices\n    const allTools = agent.voices.flatMap((v) => v.tools);\n    const toolDefs = allTools.map(toolToDefinition);\n\n    // Add user message\n    const messages: ChatMessage[] = [\n      ...session.messages,\n      { role: \"user\", content: input },\n    ];\n\n    const maxTurns = agent.max_turns ?? DEFAULT_MAX_TURNS;\n    const totalUsage: TokenUsage = { input_tokens: 0, output_tokens: 0 };\n    let turns = 0;\n\n    // Agentic loop\n    while (turns < maxTurns) {\n      turns++;\n\n      this.events.emit({\n        type: \"turn:start\",\n        agent_name: agent.name,\n        session_id: session.id,\n        turn: turns,\n      });\n\n      const request = {\n        model: agent.model,\n        system: agent.system_prompt,\n        messages,\n        tools: toolDefs.length > 0 ? toolDefs : undefined,\n      };\n\n      this.events.emit({\n        type: \"llm:request\",\n        agent_name: agent.name,\n        request,\n      });\n\n      const response = await this.provider.chat(request);\n\n      this.events.emit({\n        type: \"llm:response\",\n        agent_name: agent.name,\n        response,\n      });\n\n      totalUsage.input_tokens += response.usage.input_tokens;\n      totalUsage.output_tokens += response.usage.output_tokens;\n\n      // Add assistant message\n      messages.push({ role: \"assistant\", content: response.content });\n\n      this.events.emit({\n        type: \"turn:end\",\n        agent_name: agent.name,\n        session_id: session.id,\n        turn: turns,\n      });\n\n      // If the model is done talking, exit the loop\n      if (response.stop_reason !== \"tool_use\") {\n        break;\n      }\n\n      // Execute tool calls\n      const toolUseBlocks = response.content.filter(\n        (b): b is ToolUseBlock => b.type === \"tool_use\",\n      );\n\n      const toolResults: ToolResultBlock[] = await Promise.all(\n        toolUseBlocks.map((block) =>\n          this.executeTool(allTools, block, {\n            session_id: session.id,\n            agent_name: agent.name,\n          }),\n        ),\n      );\n\n      // Add tool results as a user message (Anthropic API format)\n      messages.push({ role: \"user\", content: toolResults });\n    }\n\n    // Persist updated messages\n    this.sessions.update(session.id, messages);\n\n    // Extract final text output\n    const lastAssistant = messages\n      .filter((m) => m.role === \"assistant\")\n      .at(-1);\n\n    const output = extractText(lastAssistant?.content);\n\n    this.events.emit({\n      type: \"agent:end\",\n      agent_name: agent.name,\n      session_id: session.id,\n    });\n\n    return {\n      session_id: session.id,\n      output,\n      messages,\n      turns,\n      usage: totalUsage,\n    };\n  }\n\n  private async executeTool(\n    tools: Tool[],\n    block: ToolUseBlock,\n    context: ToolContext,\n  ): Promise<ToolResultBlock> {\n    const tool = tools.find((t) => t.name === block.name);\n    if (!tool) {\n      return {\n        type: \"tool_result\",\n        tool_use_id: block.id,\n        content: `Tool not found: ${block.name}`,\n        is_error: true,\n      };\n    }\n\n    this.events.emit({\n      type: \"tool:start\",\n      agent_name: context.agent_name,\n      tool_name: block.name,\n      input: block.input,\n    });\n\n    try {\n      // Validate input with Zod\n      const parsed = tool.parameters.parse(block.input);\n      const result = await tool.execute(parsed, context);\n\n      this.events.emit({\n        type: \"tool:end\",\n        agent_name: context.agent_name,\n        tool_name: block.name,\n        result,\n      });\n\n      return {\n        type: \"tool_result\",\n        tool_use_id: block.id,\n        content: result.content,\n        is_error: result.is_error,\n      };\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n\n      this.events.emit({\n        type: \"tool:error\",\n        agent_name: context.agent_name,\n        tool_name: block.name,\n        error: error instanceof Error ? error : new Error(message),\n      });\n\n      return {\n        type: \"tool_result\",\n        tool_use_id: block.id,\n        content: `Tool execution error: ${message}`,\n        is_error: true,\n      };\n    }\n  }\n}\n\nfunction toolToDefinition(tool: Tool): ToolDefinition {\n  const jsonSchema = zodToJsonSchema(tool.parameters, { target: \"openApi3\" });\n  return {\n    name: tool.name,\n    description: tool.description,\n    input_schema: jsonSchema as Record<string, unknown>,\n  };\n}\n\nfunction extractText(content: string | ContentBlock[] | undefined): string {\n  if (!content) return \"\";\n  if (typeof content === \"string\") return content;\n  return content\n    .filter((b) => b.type === \"text\")\n    .map((b) => (b as { text: string }).text)\n    .join(\"\\n\");\n}\n","import type { TuttiEvent, TuttiEventType } from \"@tuttiai/types\";\n\ntype Handler = (event: never) => void;\n\nexport class EventBus {\n  private listeners = new Map<string, Set<Handler>>();\n\n  on<T extends TuttiEventType>(\n    type: T,\n    handler: (event: Extract<TuttiEvent, { type: T }>) => void,\n  ): () => void {\n    if (!this.listeners.has(type)) {\n      this.listeners.set(type, new Set());\n    }\n    const handlers = this.listeners.get(type)!;\n    const h = handler as Handler;\n    handlers.add(h);\n\n    return () => {\n      handlers.delete(h);\n    };\n  }\n\n  off<T extends TuttiEventType>(\n    type: T,\n    handler: (event: Extract<TuttiEvent, { type: T }>) => void,\n  ): void {\n    this.listeners.get(type)?.delete(handler as Handler);\n  }\n\n  emit(event: TuttiEvent): void {\n    const handlers = this.listeners.get(event.type);\n    if (handlers) {\n      for (const handler of handlers) {\n        (handler as (event: TuttiEvent) => void)(event);\n      }\n    }\n\n    // Also notify wildcard listeners\n    const wildcardHandlers = this.listeners.get(\"*\");\n    if (wildcardHandlers) {\n      for (const handler of wildcardHandlers) {\n        (handler as (event: TuttiEvent) => void)(event);\n      }\n    }\n  }\n\n  /** Subscribe to all events. */\n  onAny(handler: (event: TuttiEvent) => void): () => void {\n    if (!this.listeners.has(\"*\")) {\n      this.listeners.set(\"*\", new Set());\n    }\n    const handlers = this.listeners.get(\"*\")!;\n    const h = handler as Handler;\n    handlers.add(h);\n\n    return () => {\n      handlers.delete(h);\n    };\n  }\n}\n","import type { Session, SessionStore, ChatMessage } from \"@tuttiai/types\";\nimport { randomUUID } from \"node:crypto\";\n\nexport class InMemorySessionStore implements SessionStore {\n  private sessions = new Map<string, Session>();\n\n  create(agent_name: string): Session {\n    const session: Session = {\n      id: randomUUID(),\n      agent_name,\n      messages: [],\n      created_at: new Date(),\n      updated_at: new Date(),\n    };\n    this.sessions.set(session.id, session);\n    return session;\n  }\n\n  get(id: string): Session | undefined {\n    return this.sessions.get(id);\n  }\n\n  update(id: string, messages: ChatMessage[]): void {\n    const session = this.sessions.get(id);\n    if (!session) {\n      throw new Error(`Session not found: ${id}`);\n    }\n    session.messages = messages;\n    session.updated_at = new Date();\n  }\n}\n","import type { AgentResult, ScoreConfig, Session } from \"@tuttiai/types\";\nimport { AgentRunner } from \"./agent-runner.js\";\nimport { EventBus } from \"./event-bus.js\";\nimport { InMemorySessionStore } from \"./session-store.js\";\n\nexport class TuttiRuntime {\n  readonly events: EventBus;\n  private sessions: InMemorySessionStore;\n  private runner: AgentRunner;\n  private score: ScoreConfig;\n\n  constructor(score: ScoreConfig) {\n    this.score = score;\n    this.events = new EventBus();\n    this.sessions = new InMemorySessionStore();\n    this.runner = new AgentRunner(score.provider, this.events, this.sessions);\n  }\n\n  /**\n   * Run an agent by name with the given user input.\n   * Optionally pass a session_id to continue a conversation.\n   */\n  async run(\n    agent_name: string,\n    input: string,\n    session_id?: string,\n  ): Promise<AgentResult> {\n    const agent = this.score.agents[agent_name];\n    if (!agent) {\n      const available = Object.keys(this.score.agents).join(\", \");\n      throw new Error(\n        `Agent \"${agent_name}\" not found. Available agents: ${available}`,\n      );\n    }\n\n    // Apply default model if agent doesn't specify one\n    const resolvedAgent = agent.model\n      ? agent\n      : { ...agent, model: this.score.default_model ?? \"claude-sonnet-4-20250514\" };\n\n    return this.runner.run(resolvedAgent, input, session_id);\n  }\n\n  /** Retrieve an existing session. */\n  getSession(id: string): Session | undefined {\n    return this.sessions.get(id);\n  }\n}\n","import { pathToFileURL } from \"node:url\";\nimport { resolve } from \"node:path\";\nimport type { ScoreConfig } from \"@tuttiai/types\";\n\nexport class ScoreLoader {\n  /**\n   * Dynamically import a tutti.score.ts file and return its config.\n   * Expects the file to `export default defineScore({ ... })`.\n   */\n  static async load(path: string): Promise<ScoreConfig> {\n    const absolute = resolve(path);\n    const url = pathToFileURL(absolute).href;\n\n    const mod = (await import(url)) as { default?: ScoreConfig };\n\n    if (!mod.default) {\n      throw new Error(\n        `Score file must have a default export: ${path}`,\n      );\n    }\n\n    return mod.default;\n  }\n}\n","import type { ScoreConfig } from \"@tuttiai/types\";\n\n/**\n * Typed identity function for defining a Tutti score.\n * Provides autocomplete and type checking — no runtime magic.\n */\nexport function defineScore(config: ScoreConfig): ScoreConfig {\n  return config;\n}\n","import Anthropic from \"@anthropic-ai/sdk\";\nimport type {\n  LLMProvider,\n  ChatRequest,\n  ChatResponse,\n  ContentBlock,\n} from \"@tuttiai/types\";\n\nexport interface AnthropicProviderOptions {\n  api_key?: string;\n}\n\nexport class AnthropicProvider implements LLMProvider {\n  private client: Anthropic;\n\n  constructor(options: AnthropicProviderOptions = {}) {\n    this.client = new Anthropic({\n      apiKey: options.api_key,\n    });\n  }\n\n  async chat(request: ChatRequest): Promise<ChatResponse> {\n    if (!request.model) {\n      throw new Error(\"AnthropicProvider requires a model on ChatRequest\");\n    }\n\n    const response = await this.client.messages.create({\n      model: request.model,\n      max_tokens: request.max_tokens ?? 4096,\n      system: request.system ?? \"\",\n      messages: request.messages.map((msg) => ({\n        role: msg.role,\n        content: msg.content as Anthropic.MessageCreateParams[\"messages\"][number][\"content\"],\n      })),\n      tools: request.tools?.map((tool) => ({\n        name: tool.name,\n        description: tool.description,\n        input_schema: tool.input_schema as Anthropic.Tool[\"input_schema\"],\n      })),\n      ...(request.temperature != null && { temperature: request.temperature }),\n      ...(request.stop_sequences && { stop_sequences: request.stop_sequences }),\n    });\n\n    const content: ContentBlock[] = response.content.map((block) => {\n      if (block.type === \"text\") {\n        return { type: \"text\" as const, text: block.text };\n      }\n      if (block.type === \"tool_use\") {\n        return {\n          type: \"tool_use\" as const,\n          id: block.id,\n          name: block.name,\n          input: block.input,\n        };\n      }\n      throw new Error(`Unexpected content block type: ${(block as { type: string }).type}`);\n    });\n\n    return {\n      id: response.id,\n      content,\n      stop_reason: response.stop_reason as ChatResponse[\"stop_reason\"],\n      usage: {\n        input_tokens: response.usage.input_tokens,\n        output_tokens: response.usage.output_tokens,\n      },\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@tuttiai/core",
+  "version": "0.1.0",
+  "description": "Tutti runtime — multi-agent orchestration for TypeScript",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "@tuttiai/types": "^0.1.0",
+    "zod": "^3.24.0",
+    "zod-to-json-schema": "^3.24.0"
+  },
+  "keywords": ["tutti", "ai", "agents", "orchestration", "runtime", "llm", "anthropic"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tuttiai/tutti",
+    "directory": "packages/core"
+  },
+  "homepage": "https://tutti-ai.com"
+}