tuplet 2.7.0

package/dist/executor.js

@@ -0,0 +1,399 @@
+/**
+ * Executor - Tool Execution Loop
+ *
+ * Core execution loop that runs tools and handles agent responses.
+ */
+const ASK_USER_TOOL_NAME = '__ask_user__';
+/**
+ * Extract text from content blocks
+ */
+function extractText(content) {
+    return content
+        .filter((block) => block.type === 'text')
+        .map(block => block.text)
+        .join('\n');
+}
+/**
+ * Extract thinking blocks
+ */
+function extractThinking(content) {
+    return content
+        .filter((block) => block.type === 'thinking')
+        .map(block => block.thinking);
+}
+/**
+ * Convert tools to schemas for LLM
+ */
+function toolsToSchemas(tools) {
+    return tools.map(tool => ({
+        name: tool.name,
+        description: tool.description,
+        input_schema: tool.parameters
+    }));
+}
+/**
+ * Truncate and stringify data for logging
+ */
+function truncateForLog(data, maxLength = 500) {
+    const str = JSON.stringify(data);
+    if (str.length <= maxLength)
+        return str;
+    return str.slice(0, maxLength) + `... (${str.length} chars total)`;
+}
+/**
+ * Execute a single tool
+ */
+async function executeTool(tool, params, context, logger) {
+    const startTime = Date.now();
+    // Progress: tool starting (with context for specific tools)
+    let progressMessage = `Running ${tool.name}...`;
+    if (tool.name === 'TaskCreate') {
+        const subject = params.subject;
+        progressMessage = subject ? `Creating task: "${subject}"...` : 'Creating task...';
+    }
+    else if (tool.name === 'TaskUpdate') {
+        const status = params.status;
+        if (status === 'completed') {
+            progressMessage = 'Marking task complete...';
+        }
+        else if (status === 'in_progress') {
+            progressMessage = 'Starting task...';
+        }
+        else if (status === 'deleted') {
+            progressMessage = 'Deleting task...';
+        }
+        else {
+            progressMessage = 'Updating task...';
+        }
+    }
+    else if (tool.name === 'TaskList') {
+        progressMessage = 'Checking tasks...';
+    }
+    else if (tool.name === 'TaskGet') {
+        progressMessage = 'Getting task details...';
+    }
+    else if (tool.name === '__sub_agent__') {
+        const agent = params.agent;
+        progressMessage = `Delegating to ${agent}...`;
+    }
+    else if (tool.name === '__shell__') {
+        const command = params.command;
+        if (command) {
+            // Show the full command, truncated if too long
+            const truncated = command.length > 80 ? command.slice(0, 80) + '...' : command;
+            progressMessage = `$ ${truncated}`;
+        }
+    }
+    logger?.onProgress?.({
+        type: 'tool_start',
+        message: progressMessage,
+        details: { toolName: tool.name }
+    });
+    // Log tool execution details
+    logger?.debug(`[Tool: ${tool.name}] Executing with params: ${truncateForLog(params)}`);
+    logger?.debug(`[Tool: ${tool.name}] Context: conversationId=${context.conversationId}, userId=${context.userId}, remainingTokens=${context.remainingTokens}`);
+    logger?.onToolCall?.(tool.name, params);
+    try {
+        const result = await tool.execute(params, context);
+        const durationMs = Date.now() - startTime;
+        // Log result details
+        logger?.debug(`[Tool: ${tool.name}] Completed in ${durationMs}ms, success=${result.success}`);
+        if (result.success) {
+            if (result.data !== undefined) {
+                logger?.debug(`[Tool: ${tool.name}] Result data: ${truncateForLog(result.data)}`);
+            }
+        }
+        else {
+            logger?.warn(`[Tool: ${tool.name}] Error: ${result.error}`);
+            if (result.data !== undefined) {
+                logger?.warn(`[Tool: ${tool.name}] Details: ${truncateForLog(result.data, 1000)}`);
+            }
+        }
+        // Progress: tool completed (with result context)
+        let completionMessage = `${tool.name} completed`;
+        if (!result.success) {
+            completionMessage = `${tool.name} failed: ${result.error}`;
+        }
+        else if (tool.name === '__shell__') {
+            const command = params.command;
+            if (command) {
+                const truncated = command.length > 80 ? command.slice(0, 80) + '...' : command;
+                completionMessage = `$ ${truncated}`;
+            }
+        }
+        else {
+            const isTaskTool = ['TaskCreate', 'TaskUpdate', 'TaskGet', 'TaskList'].includes(tool.name);
+            if (isTaskTool && result.data) {
+                const data = result.data;
+                if (data.message) {
+                    completionMessage = data.message;
+                }
+            }
+        }
+        logger?.onProgress?.({
+            type: 'tool_end',
+            message: completionMessage,
+            details: { toolName: tool.name, duration: durationMs, success: result.success }
+        });
+        logger?.onToolResult?.(tool.name, result, durationMs);
+        return { result, durationMs };
+    }
+    catch (error) {
+        const durationMs = Date.now() - startTime;
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorStack = error instanceof Error ? error.stack : undefined;
+        logger?.error(`[Tool: ${tool.name}] Exception after ${durationMs}ms: ${errorMessage}`);
+        if (errorStack) {
+            logger?.error(`[Tool: ${tool.name}] Stack trace: ${errorStack}`);
+        }
+        const result = {
+            success: false,
+            error: errorMessage
+        };
+        // Progress: tool failed
+        logger?.onProgress?.({
+            type: 'tool_end',
+            message: `${tool.name} failed`,
+            details: { toolName: tool.name, duration: durationMs, success: false }
+        });
+        logger?.onToolResult?.(tool.name, result, durationMs);
+        return { result, durationMs };
+    }
+}
+/**
+ * Check if execution should be interrupted
+ */
+async function checkInterruption(signal, shouldContinue) {
+    // Check AbortSignal
+    if (signal?.aborted) {
+        return 'aborted';
+    }
+    // Check shouldContinue callback
+    if (shouldContinue) {
+        const continueExecution = await shouldContinue();
+        if (!continueExecution) {
+            return 'stopped';
+        }
+    }
+    return null;
+}
+/**
+ * Build interrupted result
+ */
+function buildInterruptedResult(reason, iteration, messages, toolCallLogs, thinkingBlocks, taskManager) {
+    const tasks = taskManager.getAll();
+    return {
+        response: '',
+        history: messages,
+        toolCalls: toolCallLogs,
+        thinking: thinkingBlocks.length > 0 ? thinkingBlocks : undefined,
+        tasks: tasks.length > 0 ? tasks : undefined,
+        status: 'interrupted',
+        interrupted: {
+            reason,
+            iterationsCompleted: iteration
+        }
+    };
+}
+/**
+ * Main execution loop
+ */
+export async function executeLoop(config, initialMessages, toolContext) {
+    const { systemPrompt, tools, llm, logger, maxIterations, contextManager, taskManager, llmOptions, signal, shouldContinue, traceBuilder } = config;
+    const messages = [...initialMessages];
+    const toolCallLogs = [];
+    const thinkingBlocks = [];
+    const toolSchemas = toolsToSchemas(tools);
+    const modelId = llm.getModelId?.() || 'unknown';
+    for (let iteration = 0; iteration < maxIterations; iteration++) {
+        // Check for interruption at start of each iteration
+        const interruptReason = await checkInterruption(signal, shouldContinue);
+        if (interruptReason) {
+            logger?.onProgress?.({
+                type: 'status',
+                message: `Interrupted: ${interruptReason}`
+            });
+            return buildInterruptedResult(interruptReason, iteration, messages, toolCallLogs, thinkingBlocks, taskManager);
+        }
+        logger?.onIteration?.(iteration, messages.length);
+        // Progress: thinking
+        logger?.onProgress?.({
+            type: 'thinking',
+            message: iteration === 0 ? 'Thinking...' : 'Processing...'
+        });
+        // Manage context (truncate/summarize if needed)
+        const managedMessages = await contextManager.manageContext(messages);
+        // Call LLM with timing
+        const llmStartTime = Date.now();
+        let response;
+        try {
+            response = await llm.chat(systemPrompt, managedMessages, toolSchemas, llmOptions);
+        }
+        catch (error) {
+            const llmDurationMs = Date.now() - llmStartTime;
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger?.error(`[LLM] Failed after ${llmDurationMs}ms: ${errorMessage}`);
+            const tasks = taskManager.getAll();
+            return {
+                response: '',
+                history: messages,
+                toolCalls: toolCallLogs,
+                thinking: thinkingBlocks.length > 0 ? thinkingBlocks : undefined,
+                tasks: tasks.length > 0 ? tasks : undefined,
+                status: 'error',
+                error: errorMessage
+            };
+        }
+        const llmDurationMs = Date.now() - llmStartTime;
+        // Record usage in trace
+        if (response.usage) {
+            traceBuilder?.recordLLMCall(modelId, response.usage.inputTokens, response.usage.outputTokens, llmDurationMs, {
+                cacheCreationTokens: response.cacheUsage?.cacheCreationInputTokens,
+                cacheReadTokens: response.cacheUsage?.cacheReadInputTokens,
+                systemPrompt,
+                messages: managedMessages,
+                response: response.content
+            });
+        }
+        // Collect thinking blocks
+        thinkingBlocks.push(...extractThinking(response.content));
+        // Add assistant message to history
+        messages.push({ role: 'assistant', content: response.content });
+        // Check if done (no tool use)
+        if (response.stopReason !== 'tool_use') {
+            const tasks = taskManager.getAll();
+            const incompleteTasks = tasks.filter(t => t.status !== 'completed');
+            // If there are incomplete tasks, force the agent to continue working
+            if (incompleteTasks.length > 0) {
+                logger?.onProgress?.({
+                    type: 'status',
+                    message: `${incompleteTasks.length} tasks remaining, continuing...`
+                });
+                // Add a reminder to continue working on tasks
+                const reminderContent = `You have ${incompleteTasks.length} incomplete task(s) in your task list:\n${incompleteTasks.map(t => `- ${t.status === 'in_progress' ? '[IN PROGRESS] ' : ''}${t.subject}`).join('\n')}\n\nYou MUST continue working on these tasks. Use the TaskUpdate tool with status "completed" after finishing each task. Do not respond to the user until all tasks are completed.`;
+                messages.push({
+                    role: 'user',
+                    content: reminderContent
+                });
+                // Continue the loop instead of returning
+                continue;
+            }
+            const result = {
+                response: extractText(response.content),
+                history: messages,
+                toolCalls: toolCallLogs,
+                thinking: thinkingBlocks.length > 0 ? thinkingBlocks : undefined,
+                tasks: tasks.length > 0 ? tasks : undefined,
+                status: 'complete'
+            };
+            logger?.onComplete?.(result);
+            return result;
+        }
+        // Execute tool calls
+        const toolUseBlocks = response.content.filter((block) => block.type === 'tool_use');
+        const toolResults = [];
+        for (const toolUse of toolUseBlocks) {
+            // Check for interruption between tool calls
+            const toolInterruptReason = await checkInterruption(signal, shouldContinue);
+            if (toolInterruptReason) {
+                logger?.onProgress?.({
+                    type: 'status',
+                    message: `Interrupted between tools: ${toolInterruptReason}`
+                });
+                return buildInterruptedResult(toolInterruptReason, iteration, messages, toolCallLogs, thinkingBlocks, taskManager);
+            }
+            // Handle ask_user tool specially
+            if (toolUse.name === ASK_USER_TOOL_NAME) {
+                const input = toolUse.input;
+                // Build pendingQuestion from questions array
+                const questions = input.questions && Array.isArray(input.questions) && input.questions.length > 0
+                    ? input.questions
+                    : [{ question: 'The assistant needs more information. Please provide additional details.' }];
+                const pendingQuestion = { questions };
+                const tasks = taskManager.getAll();
+                return {
+                    response: '',
+                    history: messages,
+                    toolCalls: toolCallLogs,
+                    thinking: thinkingBlocks.length > 0 ? thinkingBlocks : undefined,
+                    tasks: tasks.length > 0 ? tasks : undefined,
+                    pendingQuestion,
+                    status: 'needs_input'
+                };
+            }
+            // Find and execute the tool
+            const tool = tools.find(t => t.name === toolUse.name);
+            if (!tool) {
+                toolResults.push({
+                    type: 'tool_result',
+                    tool_use_id: toolUse.id,
+                    content: JSON.stringify({ success: false, error: `Unknown tool: ${toolUse.name}` }),
+                    is_error: true
+                });
+                continue;
+            }
+            const { result, durationMs } = await executeTool(tool, toolUse.input, toolContext, logger);
+            toolCallLogs.push({
+                name: toolUse.name,
+                input: toolUse.input,
+                output: result,
+                durationMs
+            });
+            // Record in trace
+            traceBuilder?.recordToolCall(toolUse.name, toolUse.input, result, durationMs);
+            // If a sub-agent needs user input, propagate needs_input immediately
+            // We add the __sub_agent__ tool result to history, then synthesize an __ask_user__
+            // tool call so the existing resume logic in agent.ts works correctly
+            if (toolUse.name === '__sub_agent__' && !result.success && result.error === 'Sub-agent needs user input' && result.data) {
+                const subAgentData = result.data;
+                if (subAgentData.questions && Array.isArray(subAgentData.questions) && subAgentData.questions.length > 0) {
+                    // Add the __sub_agent__ tool result to close the pending tool_use
+                    toolResults.push({
+                        type: 'tool_result',
+                        tool_use_id: toolUse.id,
+                        content: JSON.stringify(result),
+                        is_error: true
+                    });
+                    messages.push({ role: 'user', content: toolResults });
+                    // Synthesize an __ask_user__ tool call so resume logic works
+                    const syntheticAskUserId = `synthetic_ask_user_${Date.now()}`;
+                    messages.push({
+                        role: 'assistant',
+                        content: [{
+                                type: 'tool_use',
+                                id: syntheticAskUserId,
+                                name: ASK_USER_TOOL_NAME,
+                                input: { questions: subAgentData.questions }
+                            }]
+                    });
+                    const pendingQuestion = { questions: subAgentData.questions };
+                    const tasks = taskManager.getAll();
+                    return {
+                        response: '',
+                        history: messages,
+                        toolCalls: toolCallLogs,
+                        thinking: thinkingBlocks.length > 0 ? thinkingBlocks : undefined,
+                        tasks: tasks.length > 0 ? tasks : undefined,
+                        pendingQuestion,
+                        status: 'needs_input'
+                    };
+                }
+            }
+            toolResults.push({
+                type: 'tool_result',
+                tool_use_id: toolUse.id,
+                content: JSON.stringify(result),
+                is_error: !result.success
+            });
+        }
+        // Add tool results as user message
+        messages.push({ role: 'user', content: toolResults });
+    }
+    // Max iterations reached - return as interrupted instead of throwing
+    logger?.onProgress?.({
+        type: 'status',
+        message: `Max iterations (${maxIterations}) reached`
+    });
+    return buildInterruptedResult('max_iterations', maxIterations, messages, toolCallLogs, thinkingBlocks, taskManager);
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Tuplet Agent Framework
+ *
+ * Minimal TypeScript agent framework inspired by Claude Code architecture.
+ */
+export { Tuplet, Tuplet as Hive, PLAN_PATH } from './agent.js';
+export type { Message, MessageRole, ContentBlock, TextBlock, ThinkingBlock, ToolUseBlock, ToolResultBlock, Tool, ToolSchema, ToolResult, ToolContext, ToolCallLog, JSONSchema, TupletConfig, TupletConfig as HiveConfig, SubAgentConfig, RunOptions, AgentResult, AgentStatus, PendingQuestion, QuestionOption, EnhancedQuestion, TaskItem, TaskStatus, TaskComment, TaskProgress, TaskUpdateNotification, TodoItem, TodoStatus, TodoProgress, TodoUpdate, LLMProvider, LLMResponse, LLMOptions, StopReason, LogProvider, RepositoryProvider, EnvironmentProvider, ProgressUpdate, CacheUsage, ContextStrategy, SystemPromptConfig, EnvironmentInfo } from './types.js';
+export { ClaudeProvider, type ClaudeProviderConfig } from './providers/llm/claude.js';
+export { OpenAIProvider, type OpenAIProviderConfig } from './providers/llm/openai.js';
+export { OpenRouterProvider, type OpenRouterProviderConfig } from './providers/llm/openrouter.js';
+export { ConsoleLogger, type ConsoleLoggerConfig, type LogLevel } from './providers/logger/console.js';
+export { MemoryRepository } from './providers/repository/memory.js';
+export { MemoryEnvironmentProvider } from './providers/env/memory.js';
+export { estimateTokens, estimateMessageTokens, estimateTotalTokens, truncateOldMessages, sanitizeHistory, ContextManager } from './context-manager.js';
+export { summarizeMessages, microCompact, parseSummary } from './summarizer.js';
+export { buildSystemPrompt, buildEnvironmentSection, buildRemindersSection, getCurrentEnvironment, DEFAULT_SYSTEM_PROMPT, SubAgentBuilder, roleSection, subAgentsTable, questionHandlingSection, directToolsSection, workspaceStorageSection, rulesSection, taskExamplesSection, subAgentRoleSection, taskSection, workflowSection, guidelinesSection, outputSection, type SubAgentDef, type ToolDef, type WorkspacePathDef, type TaskExample, type WorkflowStep, type OutputFormat, type SubAgentPromptConfig } from './prompt.js';
+export { TaskManager, formatTaskList, createTaskTools, createTaskCreateTool, createTaskUpdateTool, createTaskGetTool, createTaskListTool, type TaskToolOptions, TodoManager, formatTodoList, createTodoTool, type TodoToolOptions } from './tools/tasks.js';
+export { TraceBuilder, ConsoleTraceProvider, generateTraceId, generateSpanId, calculateCost, DEFAULT_MODEL_PRICING, OPENROUTER_MODEL_PRICING, type TraceProvider, type TraceId, type SpanId, type Trace, type AgentSpan, type TraceEvent, type LLMCallEvent, type ToolCallEvent, type TraceContext, type ModelPricing, type ConsoleTraceConfig } from './trace.js';
+export { Workspace, type WorkspaceEntry, type WorkspaceListItem, type WorkspaceConfig, type WorkspaceConfigExt, type PathConfig, type ValidatorFn, type ZodLike, type ValidationError, type WriteResult } from './workspace.js';
+export { type WorkspaceProvider, type WorkspaceChange, type WorkspaceChangeListener, MemoryWorkspaceProvider, FileWorkspaceProvider } from './providers/workspace/index.js';
+export { Shell, type ShellConfig, type ShellResult, type CommandHandler, type CommandHelp, type CommandFlag, type CommandExample } from './shell/index.js';
+export { exploreAgent, planAgent, getBuiltInAgents } from './built-in-agents/index.js';
+export { RunRecorder, RunReplayer, RunTester, type RunRecorderConfig, type RunRecord, type RunRecordConfig, type RunRecordResult, type SerializedTool, type SerializedSubAgentConfig, type RunTesterConfig, type TestResult, type TestSummary } from './providers/dataset/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,40 @@
+/**
+ * Tuplet Agent Framework
+ *
+ * Minimal TypeScript agent framework inspired by Claude Code architecture.
+ */
+// Main agent class
+export { Tuplet, Tuplet as Hive, PLAN_PATH } from './agent.js';
+// Providers
+export { ClaudeProvider } from './providers/llm/claude.js';
+export { OpenAIProvider } from './providers/llm/openai.js';
+export { OpenRouterProvider } from './providers/llm/openrouter.js';
+export { ConsoleLogger } from './providers/logger/console.js';
+export { MemoryRepository } from './providers/repository/memory.js';
+// Environment Providers
+export { MemoryEnvironmentProvider } from './providers/env/memory.js';
+// Utilities
+export { estimateTokens, estimateMessageTokens, estimateTotalTokens, truncateOldMessages, sanitizeHistory, ContextManager } from './context-manager.js';
+export { summarizeMessages, microCompact, parseSummary } from './summarizer.js';
+export { buildSystemPrompt, buildEnvironmentSection, buildRemindersSection, getCurrentEnvironment, DEFAULT_SYSTEM_PROMPT, 
+// Prompt builders
+SubAgentBuilder, 
+// Template functions (for advanced customization)
+roleSection, subAgentsTable, questionHandlingSection, directToolsSection, workspaceStorageSection, rulesSection, taskExamplesSection, subAgentRoleSection, taskSection, workflowSection, guidelinesSection, outputSection } from './prompt.js';
+// Task Management utilities (new 4-tool approach)
+export { TaskManager, formatTaskList, createTaskTools, createTaskCreateTool, createTaskUpdateTool, createTaskGetTool, createTaskListTool, 
+// Backward compatibility (deprecated)
+TodoManager, formatTodoList, createTodoTool } from './tools/tasks.js';
+// Tracing
+export { TraceBuilder, ConsoleTraceProvider, generateTraceId, generateSpanId, calculateCost, DEFAULT_MODEL_PRICING, OPENROUTER_MODEL_PRICING } from './trace.js';
+// Workspace
+export { Workspace } from './workspace.js';
+// Workspace Providers
+export { MemoryWorkspaceProvider, FileWorkspaceProvider } from './providers/workspace/index.js';
+// Shell
+export { Shell } from './shell/index.js';
+// Built-in Agents
+export { exploreAgent, planAgent, getBuiltInAgents } from './built-in-agents/index.js';
+// Dataset (Run Recording, Replay & Testing)
+export { RunRecorder, RunReplayer, RunTester } from './providers/dataset/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mBAAmB;AACnB,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAgE9D,YAAY;AACZ,OAAO,EACL,cAAc,EAEf,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACL,cAAc,EAEf,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACL,kBAAkB,EAEnB,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EACL,aAAa,EAGd,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EACL,gBAAgB,EACjB,MAAM,kCAAkC,CAAA;AAEzC,wBAAwB;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAA;AAErE,YAAY;AACZ,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACf,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACb,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB;AACrB,kBAAkB;AAClB,eAAe;AACf,kDAAkD;AAClD,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,aAAa,EASd,MAAM,aAAa,CAAA;AAEpB,kDAAkD;AAClD,OAAO,EACL,WAAW,EACX,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB;AAElB,sCAAsC;AACtC,WAAW,EACX,cAAc,EACd,cAAc,EAEf,MAAM,kBAAkB,CAAA;AAEzB,UAAU;AACV,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,aAAa,EACb,qBAAqB,EACrB,wBAAwB,EAYzB,MAAM,YAAY,CAAA;AAEnB,YAAY;AACZ,OAAO,EACL,SAAS,EAUV,MAAM,gBAAgB,CAAA;AAEvB,sBAAsB;AACtB,OAAO,EAIL,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,gCAAgC,CAAA;AAEvC,QAAQ;AACR,OAAO,EACL,KAAK,EAON,MAAM,kBAAkB,CAAA;AAEzB,kBAAkB;AAClB,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAEtF,4CAA4C;AAC5C,OAAO,EACL,WAAW,EACX,WAAW,EACX,SAAS,EAUV,MAAM,8BAA8B,CAAA"}

package/dist/prompt/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Prompt Builder Module
+ *
+ * Fluent API builders for creating main agent and sub-agent system prompts.
+ */
+export type { SubAgentDef, ToolDef, WorkspacePathDef, TaskExample, WorkflowStep, OutputFormat, MainAgentPromptConfig, SubAgentPromptConfig } from './types.js';
+export { SubAgentBuilder } from './sub-agent-builder.js';
+export { roleSection, subAgentsTable, questionHandlingSection, directToolsSection, workspaceStorageSection, rulesSection, taskExamplesSection, subAgentRoleSection, taskSection, workflowSection, guidelinesSection, outputSection } from './templates.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/prompt/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,WAAW,EACX,OAAO,EACP,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAGxD,OAAO,EACL,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,aAAa,EACd,MAAM,gBAAgB,CAAA"}

package/dist/prompt/index.js

@@ -0,0 +1,10 @@
+/**
+ * Prompt Builder Module
+ *
+ * Fluent API builders for creating main agent and sub-agent system prompts.
+ */
+// Builders
+export { SubAgentBuilder } from './sub-agent-builder.js';
+// Templates (for advanced customization)
+export { roleSection, subAgentsTable, questionHandlingSection, directToolsSection, workspaceStorageSection, rulesSection, taskExamplesSection, subAgentRoleSection, taskSection, workflowSection, guidelinesSection, outputSection } from './templates.js';
+//# sourceMappingURL=index.js.map

package/dist/prompt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompt/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,WAAW;AACX,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,yCAAyC;AACzC,OAAO,EACL,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,aAAa,EACd,MAAM,gBAAgB,CAAA"}

package/dist/prompt/main-agent-builder.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Main Agent Prompt Builder
+ *
+ * Fluent API for building main agent system prompts.
+ */
+import type { WorkspacePathDef, TaskExample, MainAgentPromptConfig } from './types.js';
+import type { Tool, SubAgentConfig } from '../types.js';
+export declare class MainAgentBuilder {
+    private config;
+    private _skipBuiltInAgents;
+    /**
+     * Skip auto-injecting built-in agents (used when Tuplet already merges them)
+     */
+    skipBuiltInAgents(): this;
+    /**
+     * Set the agent's role identity
+     */
+    role(role: string): this;
+    /**
+     * Set the agent's description
+     */
+    description(description: string): this;
+    /**
+     * Set sub-agents from actual SubAgentConfig objects
+     * Extracts name, description, and input parameters automatically
+     */
+    agents(configs: SubAgentConfig[]): this;
+    /**
+     * Configure question handling behavior
+     */
+    questionHandling(options: {
+        description?: string;
+        exampleFlow?: string[];
+    }): this;
+    /**
+     * Set tools from actual Tool objects
+     * Extracts name and description automatically
+     */
+    tools(toolObjects: Tool[]): this;
+    /**
+     * Add a workspace path definition
+     */
+    addWorkspacePath(path: string, description: string): this;
+    /**
+     * Add multiple workspace paths at once
+     */
+    addWorkspacePaths(paths: WorkspacePathDef[]): this;
+    /**
+     * Add a behavioral rule
+     */
+    addRule(rule: string): this;
+    /**
+     * Add multiple rules at once
+     */
+    addRules(rules: string[]): this;
+    /**
+     * Add a task example showing the flow
+     */
+    addExample(example: TaskExample): this;
+    /**
+     * Add multiple examples at once
+     */
+    addExamples(examples: TaskExample[]): this;
+    /**
+     * Add a custom section with title and content
+     */
+    addSection(title: string, content: string): this;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): MainAgentPromptConfig;
+    /**
+     * Build the final system prompt string
+     */
+    build(): string;
+    /**
+     * Reset the builder to initial state
+     */
+    reset(): this;
+}
+//# sourceMappingURL=main-agent-builder.d.ts.map

package/dist/prompt/main-agent-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-agent-builder.d.ts","sourceRoot":"","sources":["../../src/prompt/main-agent-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,qBAAqB,EACtB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAavD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAOb;IAED,OAAO,CAAC,kBAAkB,CAAQ;IAElC;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAKzB;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKtC;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI;IAyBvC;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE;QACxB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;KACvB,GAAG,IAAI;IAKR;;;OAGG;IACH,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,GAAG,IAAI;IAYhC;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAKzD;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAKlD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK3B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAK/B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKtC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAK1C;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAKhD;;OAEG;IACH,SAAS,IAAI,qBAAqB;IAIlC;;OAEG;IACH,KAAK,IAAI,MAAM;IA8If;;OAEG;IACH,KAAK,IAAI,IAAI;CAWd"}