@tuttiai/types 0.1.0 → 0.3.0

package/dist/index.d.ts

@@ -53,13 +53,27 @@ interface LLMProvider {
 
 /** Voice — a pluggable module that gives agents tools and capabilities. */
 
+type Permission = "network" | "filesystem" | "shell" | "browser";
 interface ToolResult {
     content: string;
     is_error?: boolean;
 }
+interface ToolMemoryHelpers {
+    /** Store a fact the agent should remember across sessions. */
+    remember(content: string, metadata?: Record<string, unknown>): Promise<void>;
+    /** Search for relevant memories. */
+    recall(query: string, limit?: number): Promise<{
+        id: string;
+        content: string;
+    }[]>;
+    /** Delete a specific memory by ID. */
+    forget(id: string): Promise<void>;
+}
 interface ToolContext {
     session_id: string;
     agent_name: string;
+    /** Semantic memory helpers — only available when agent.semantic_memory.enabled is true. */
+    memory?: ToolMemoryHelpers;
 }
 interface Tool<T = unknown> {
     name: string;
@@ -75,19 +89,44 @@ interface Voice {
     name: string;
     description?: string;
     tools: Tool[];
+    required_permissions: Permission[];
     setup?(context: VoiceContext): Promise<void>;
     teardown?(): Promise<void>;
 }
 
 /** Agent configuration and result types. */
 
+interface BudgetConfig {
+    max_tokens?: number;
+    max_cost_usd?: number;
+    /** Percentage at which to emit a warning (default 80). */
+    warn_at_percent?: number;
+}
+interface AgentMemoryConfig {
+    /** Enable semantic memory for this agent. */
+    enabled: boolean;
+    /** Max memory entries to inject per LLM call (default 5). */
+    max_memories?: number;
+    /** Inject memories into the system prompt (default true). */
+    inject_system?: boolean;
+}
 interface AgentConfig {
     name: string;
     description?: string;
     model?: string;
     system_prompt: string;
     voices: Voice[];
+    permissions?: Permission[];
     max_turns?: number;
+    max_tool_calls?: number;
+    tool_timeout_ms?: number;
+    budget?: BudgetConfig;
+    /** Semantic (long-term) memory configuration. */
+    semantic_memory?: AgentMemoryConfig;
+    /** Agent IDs this agent can delegate to via the orchestrator. */
+    delegates?: string[];
+    /** Role in the orchestration — orchestrator receives input first. */
+    role?: "orchestrator" | "specialist";
 }
 interface AgentResult {
     session_id: string;
@@ -99,12 +138,21 @@ interface AgentResult {
 
 /** Score — the top-level configuration file (tutti.score.ts). */
 
+interface MemoryConfig {
+    provider: "in-memory" | "postgres" | "redis";
+    /** Connection URL (e.g. DATABASE_URL for postgres). */
+    url?: string;
+}
 interface ScoreConfig {
     name?: string;
     description?: string;
     agents: Record<string, AgentConfig>;
     provider: LLMProvider;
     default_model?: string;
+    /** Which agent is the entry point (default: "orchestrator"). */
+    entry?: string;
+    /** Session storage configuration (default: in-memory). */
+    memory?: MemoryConfig;
 }
 
 /** Session types for conversation state management. */
@@ -165,10 +213,35 @@ type TuttiEvent = {
     agent_name: string;
     session_id: string;
     turn: number;
+} | {
+    type: "delegate:start";
+    from: string;
+    to: string;
+    task: string;
+} | {
+    type: "delegate:end";
+    from: string;
+    to: string;
+    output: string;
+} | {
+    type: "security:injection_detected";
+    agent_name: string;
+    tool_name: string;
+    patterns: string[];
+} | {
+    type: "budget:warning";
+    agent_name: string;
+    tokens: number;
+    cost_usd: number;
+} | {
+    type: "budget:exceeded";
+    agent_name: string;
+    tokens: number;
+    cost_usd: 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 };
+export type { AgentConfig, AgentMemoryConfig, AgentResult, BudgetConfig, ChatMessage, ChatRequest, ChatResponse, ContentBlock, LLMProvider, MemoryConfig, Permission, ScoreConfig, Session, SessionStore, StopReason, TextBlock, TokenUsage, Tool, ToolContext, ToolDefinition, ToolMemoryHelpers, ToolResult, ToolResultBlock, ToolUseBlock, TuttiEvent, TuttiEventHandler, TuttiEventType, Voice, VoiceContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tuttiai/types",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Type definitions for the Tutti multi-agent orchestration framework",
   "type": "module",
   "exports": {
@@ -18,7 +18,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "zod": "^3.24.0"
+    "zod": "3.25.76"
   },
   "keywords": ["tutti", "ai", "agents", "orchestration", "types", "typescript"],
   "license": "MIT",