@tuttiai/types 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,38 @@
+# @tuttiai/types
+
+Type definitions for the [Tutti](https://tutti-ai.com) multi-agent orchestration framework.
+
+## Install
+
+```bash
+npm install @tuttiai/types
+```
+
+## What's included
+
+All core interfaces for building on Tutti:
+
+- **LLM** — `LLMProvider`, `ChatRequest`, `ChatResponse`, `ContentBlock`, `ChatMessage`
+- **Voice** — `Voice`, `Tool<T>`, `ToolResult`, `ToolContext`
+- **Agent** — `AgentConfig`, `AgentResult`
+- **Score** — `ScoreConfig`
+- **Session** — `Session`, `SessionStore`
+- **Events** — `TuttiEvent`, `TuttiEventType`, `TuttiEventHandler`
+
+## Usage
+
+```ts
+import type { Voice, Tool, LLMProvider } from "@tuttiai/types";
+```
+
+Most users should install `@tuttiai/core` instead — it re-exports all types from this package along with the runtime implementation.
+
+## Links
+
+- [Tutti](https://tutti-ai.com)
+- [GitHub](https://github.com/tuttiai/tutti/tree/main/packages/types)
+- [Docs](https://tutti-ai.com/docs)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,174 @@
+import { ZodType } from 'zod';
+
+/** Model-agnostic LLM provider interface. */
+interface TextBlock {
+    type: "text";
+    text: string;
+}
+interface ToolUseBlock {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: unknown;
+}
+interface ToolResultBlock {
+    type: "tool_result";
+    tool_use_id: string;
+    content: string;
+    is_error?: boolean;
+}
+type ContentBlock = TextBlock | ToolUseBlock | ToolResultBlock;
+interface ChatMessage {
+    role: "user" | "assistant";
+    content: string | ContentBlock[];
+}
+type StopReason = "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
+interface ToolDefinition {
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+}
+interface ChatRequest {
+    model?: string;
+    messages: ChatMessage[];
+    system?: string;
+    tools?: ToolDefinition[];
+    max_tokens?: number;
+    temperature?: number;
+    stop_sequences?: string[];
+}
+interface ChatResponse {
+    id: string;
+    content: ContentBlock[];
+    stop_reason: StopReason;
+    usage: TokenUsage;
+}
+interface TokenUsage {
+    input_tokens: number;
+    output_tokens: number;
+}
+interface LLMProvider {
+    chat(request: ChatRequest): Promise<ChatResponse>;
+}
+
+/** Voice — a pluggable module that gives agents tools and capabilities. */
+
+interface ToolResult {
+    content: string;
+    is_error?: boolean;
+}
+interface ToolContext {
+    session_id: string;
+    agent_name: string;
+}
+interface Tool<T = unknown> {
+    name: string;
+    description: string;
+    parameters: ZodType<T, any, any>;
+    execute(input: T, context: ToolContext): Promise<ToolResult>;
+}
+interface VoiceContext {
+    session_id: string;
+    agent_name: string;
+}
+interface Voice {
+    name: string;
+    description?: string;
+    tools: Tool[];
+    setup?(context: VoiceContext): Promise<void>;
+    teardown?(): Promise<void>;
+}
+
+/** Agent configuration and result types. */
+
+interface AgentConfig {
+    name: string;
+    description?: string;
+    model?: string;
+    system_prompt: string;
+    voices: Voice[];
+    max_turns?: number;
+}
+interface AgentResult {
+    session_id: string;
+    output: string;
+    messages: ChatMessage[];
+    turns: number;
+    usage: TokenUsage;
+}
+
+/** Score — the top-level configuration file (tutti.score.ts). */
+
+interface ScoreConfig {
+    name?: string;
+    description?: string;
+    agents: Record<string, AgentConfig>;
+    provider: LLMProvider;
+    default_model?: string;
+}
+
+/** Session types for conversation state management. */
+
+interface Session {
+    id: string;
+    agent_name: string;
+    messages: ChatMessage[];
+    created_at: Date;
+    updated_at: Date;
+}
+interface SessionStore {
+    create(agent_name: string): Session;
+    get(id: string): Session | undefined;
+    update(id: string, messages: ChatMessage[]): void;
+}
+
+/** Event types for the observability EventBus. */
+
+type TuttiEvent = {
+    type: "agent:start";
+    agent_name: string;
+    session_id: string;
+} | {
+    type: "agent:end";
+    agent_name: string;
+    session_id: string;
+} | {
+    type: "llm:request";
+    agent_name: string;
+    request: ChatRequest;
+} | {
+    type: "llm:response";
+    agent_name: string;
+    response: ChatResponse;
+} | {
+    type: "tool:start";
+    agent_name: string;
+    tool_name: string;
+    input: unknown;
+} | {
+    type: "tool:end";
+    agent_name: string;
+    tool_name: string;
+    result: ToolResult;
+} | {
+    type: "tool:error";
+    agent_name: string;
+    tool_name: string;
+    error: Error;
+} | {
+    type: "turn:start";
+    agent_name: string;
+    session_id: string;
+    turn: number;
+} | {
+    type: "turn:end";
+    agent_name: string;
+    session_id: string;
+    turn: number;
+};
+type TuttiEventType = TuttiEvent["type"];
+type TuttiEventHandler<T extends TuttiEventType = TuttiEventType> = (event: Extract<TuttiEvent, {
+    type: T;
+}>) => void;
+
+export type { AgentConfig, AgentResult, ChatMessage, ChatRequest, ChatResponse, ContentBlock, LLMProvider, ScoreConfig, Session, SessionStore, StopReason, TextBlock, TokenUsage, Tool, ToolContext, ToolDefinition, ToolResult, ToolResultBlock, ToolUseBlock, TuttiEvent, TuttiEventHandler, TuttiEventType, Voice, VoiceContext };

package/dist/index.js

@@ -0,0 +1 @@
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@tuttiai/types",
+  "version": "0.1.0",
+  "description": "Type definitions for the Tutti multi-agent orchestration framework",
+  "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",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "zod": "^3.24.0"
+  },
+  "keywords": ["tutti", "ai", "agents", "orchestration", "types", "typescript"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tuttiai/tutti",
+    "directory": "packages/types"
+  },
+  "homepage": "https://tutti-ai.com"
+}