@alexnetrebskii/hive-agent 0.24.0 → 0.25.0

package/dist/prompt/sub-agent-builder.js

@@ -0,0 +1,342 @@
+/**
+ * Sub-Agent Prompt Builder
+ *
+ * Fluent API for building sub-agent system prompts.
+ */
+import { subAgentRoleSection, taskSection, workflowSection, guidelinesSection, outputSection, outputSchemaSection, availableToolsSection, instructionsSection, checklistSection, subAgentExamplesSection, constraintsSection, inputParametersSection } from './templates.js';
+export class SubAgentBuilder {
+    config = {
+        workflow: [],
+        guidelines: [],
+        instructions: [],
+        constraints: [],
+        examples: [],
+        contextPaths: [],
+        useContext: false,
+        customSections: [],
+        availableTools: []
+    };
+    /**
+     * Set the sub-agent's role (e.g., "a Nutrition Counter assistant")
+     */
+    role(role) {
+        this.config.role = role;
+        return this;
+    }
+    /**
+     * Set the task description
+     */
+    task(task) {
+        this.config.task = task;
+        return this;
+    }
+    /**
+     * Add step-by-step instructions
+     */
+    instructions(instructions) {
+        this.config.instructions = instructions;
+        return this;
+    }
+    /**
+     * Add a single instruction
+     */
+    addInstruction(instruction) {
+        this.config.instructions.push(instruction);
+        return this;
+    }
+    /**
+     * Enable todo tracking - AI will plan and track its own work
+     * @param options.exampleSteps - Example todos to guide the AI (optional)
+     */
+    useTodoTracking(options) {
+        this.config.checklist = {
+            items: (options?.exampleSteps || []).map(step => ({ task: step })),
+            trackProgress: true
+        };
+        return this;
+    }
+    /**
+     * Add guidance items (without todo tracking)
+     * @deprecated Use useTodoTracking() for progress tracking, or addGuidelines() for static guidance
+     */
+    checklist(items, options) {
+        this.config.checklist = {
+            items: items.map(item => typeof item === 'string' ? { task: item } : item),
+            sequential: options?.sequential,
+            trackProgress: options?.trackProgress
+        };
+        return this;
+    }
+    /**
+     * Add an input/output example
+     */
+    addExample(input, output, explanation) {
+        this.config.examples.push({ input, output, explanation });
+        return this;
+    }
+    /**
+     * Add multiple examples at once
+     */
+    examples(examples) {
+        this.config.examples.push(...examples);
+        return this;
+    }
+    /**
+     * Add a constraint (thing to avoid)
+     */
+    addConstraint(constraint) {
+        this.config.constraints.push(constraint);
+        return this;
+    }
+    /**
+     * Add multiple constraints at once
+     */
+    constraints(constraints) {
+        this.config.constraints.push(...constraints);
+        return this;
+    }
+    /**
+     * Add a workflow step
+     */
+    addStep(step) {
+        this.config.workflow.push(step);
+        return this;
+    }
+    /**
+     * Add a step that may ask a question
+     */
+    addQuestionStep(description, askQuestion) {
+        this.config.workflow.push({
+            description,
+            askQuestion
+        });
+        return this;
+    }
+    /**
+     * Add a step with tool calls
+     */
+    addToolStep(description, toolCalls) {
+        this.config.workflow.push({
+            description,
+            toolCalls
+        });
+        return this;
+    }
+    /**
+     * Add a guideline
+     */
+    addGuideline(guideline) {
+        this.config.guidelines.push(guideline);
+        return this;
+    }
+    /**
+     * Add multiple guidelines at once
+     */
+    addGuidelines(guidelines) {
+        this.config.guidelines.push(...guidelines);
+        return this;
+    }
+    /**
+     * Enable context discovery - agent will check context before starting work
+     */
+    useContext() {
+        this.config.useContext = true;
+        return this;
+    }
+    /**
+     * Add a context path the agent should check
+     */
+    addContextPath(path, description) {
+        this.config.contextPaths.push({ path, description });
+        this.config.useContext = true;
+        return this;
+    }
+    /**
+     * Add multiple context paths at once
+     */
+    addContextPaths(paths) {
+        this.config.contextPaths.push(...paths);
+        this.config.useContext = true;
+        return this;
+    }
+    /**
+     * Set the output format
+     */
+    output(format) {
+        this.config.output = format;
+        return this;
+    }
+    /**
+     * Shorthand for common output format
+     * @deprecated Use outputSchema() instead for type-safe output definition
+     */
+    outputWithSummary(summaryTemplate, dataFields, errorCase) {
+        this.config.output = {
+            summaryTemplate,
+            dataFields,
+            errorCase
+        };
+        return this;
+    }
+    /**
+     * Set output schema - generates output instructions from the schema
+     * This is the preferred way to define output format (type-safe)
+     */
+    outputSchema(schema) {
+        // Convert JSONSchema to OutputSchema format
+        this.config.outputSchema = schema;
+        return this;
+    }
+    /**
+     * Set available tools from actual Tool objects
+     * Extracts name and description automatically for documentation
+     */
+    tools(toolObjects) {
+        for (const tool of toolObjects) {
+            // Extract first line of description for brevity
+            const desc = tool.description.split('\n')[0].trim();
+            this.config.availableTools.push({
+                name: tool.name,
+                description: desc
+            });
+        }
+        return this;
+    }
+    /**
+     * Add a workflow step that uses specific tools
+     * Type-safe alternative to addToolStep with string arrays
+     */
+    addToolsStep(description, toolRefs) {
+        const toolCalls = toolRefs.map(ref => {
+            const purpose = ref.purpose ? ` - ${ref.purpose}` : '';
+            return `${ref.tool.name}${purpose}`;
+        });
+        this.config.workflow.push({
+            description,
+            toolCalls
+        });
+        return this;
+    }
+    /**
+     * Add a custom section
+     */
+    addSection(title, content) {
+        this.config.customSections.push({ title, content });
+        return this;
+    }
+    /**
+     * Get the current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Build the final system prompt string
+     */
+    build() {
+        const sections = [];
+        // Role section (required, with default)
+        const role = this.config.role || 'a specialized assistant';
+        sections.push(subAgentRoleSection(role));
+        // Task section
+        if (this.config.task) {
+            sections.push('');
+            sections.push(taskSection(this.config.task));
+        }
+        // Instructions section
+        if (this.config.instructions && this.config.instructions.length > 0) {
+            sections.push('');
+            sections.push(instructionsSection(this.config.instructions));
+        }
+        // Checklist section
+        if (this.config.checklist && this.config.checklist.items.length > 0) {
+            sections.push('');
+            sections.push(checklistSection(this.config.checklist));
+        }
+        // Available tools section (before context discovery)
+        if (this.config.availableTools && this.config.availableTools.length > 0) {
+            sections.push('');
+            sections.push(availableToolsSection(this.config.availableTools));
+        }
+        // Context discovery section (before workflow)
+        if (this.config.useContext) {
+            sections.push('');
+            sections.push('## Context Discovery (Do This First!)');
+            sections.push('');
+            sections.push('⚠️ ALWAYS check context BEFORE asking questions or starting work:');
+            sections.push('');
+            sections.push('1. Use **context_ls** to see what data exists');
+            sections.push('2. Use **context_read** to read relevant paths');
+            sections.push('3. Use information from context instead of asking the user');
+            if (this.config.contextPaths && this.config.contextPaths.length > 0) {
+                sections.push('');
+                sections.push('Check these paths:');
+                for (const path of this.config.contextPaths) {
+                    sections.push(`- ${path.path} - ${path.description}`);
+                }
+            }
+        }
+        // Check if we have question steps with conditions - add input parameters section
+        const hasQuestionSteps = this.config.workflow?.some(step => step.askQuestion?.condition);
+        if (hasQuestionSteps) {
+            sections.push('');
+            sections.push(inputParametersSection());
+        }
+        // Workflow steps
+        if (this.config.workflow && this.config.workflow.length > 0) {
+            sections.push('');
+            sections.push(workflowSection(this.config.workflow));
+        }
+        // Guidelines
+        if (this.config.guidelines && this.config.guidelines.length > 0) {
+            sections.push('');
+            sections.push(guidelinesSection(this.config.guidelines));
+        }
+        // Constraints section
+        if (this.config.constraints && this.config.constraints.length > 0) {
+            sections.push('');
+            sections.push(constraintsSection(this.config.constraints));
+        }
+        // Examples section
+        if (this.config.examples && this.config.examples.length > 0) {
+            sections.push('');
+            sections.push(subAgentExamplesSection(this.config.examples));
+        }
+        // Custom sections
+        for (const section of this.config.customSections || []) {
+            sections.push('');
+            sections.push(`## ${section.title}`);
+            sections.push('');
+            sections.push(section.content);
+        }
+        // Output format (always at the end)
+        // Prefer outputSchema over deprecated output format
+        if (this.config.outputSchema) {
+            sections.push('');
+            sections.push(outputSchemaSection(this.config.outputSchema));
+        }
+        else if (this.config.output) {
+            sections.push('');
+            sections.push(outputSection(this.config.output));
+        }
+        return sections.join('\n');
+    }
+    /**
+     * Reset the builder to initial state
+     */
+    reset() {
+        this.config = {
+            workflow: [],
+            guidelines: [],
+            instructions: [],
+            constraints: [],
+            examples: [],
+            contextPaths: [],
+            useContext: false,
+            customSections: [],
+            availableTools: []
+        };
+        return this;
+    }
+}
+//# sourceMappingURL=sub-agent-builder.js.map

package/dist/prompt/sub-agent-builder.js.map

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

package/dist/prompt/templates.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Prompt Templates
+ *
+ * Template functions for generating prompt sections.
+ */
+import type { SubAgentDef, ToolDef, ContextPathDef, TaskExample, WorkflowStep, OutputFormat, OutputSchema, ChecklistConfig, SubAgentExample } from './types.js';
+/**
+ * Generate role section
+ */
+export declare function roleSection(role: string, description?: string): string;
+/**
+ * Generate sub-agents table
+ */
+export declare function subAgentsTable(agents: SubAgentDef[]): string;
+/**
+ * Generate sub-agent parameters documentation
+ */
+export declare function subAgentParametersSection(agents: SubAgentDef[]): string;
+/**
+ * Generate question handling section
+ */
+export declare function questionHandlingSection(description?: string, exampleFlow?: string[]): string;
+/**
+ * Generate direct tools section
+ */
+export declare function directToolsSection(tools: ToolDef[]): string;
+/**
+ * Generate context storage section
+ */
+export declare function contextStorageSection(paths: ContextPathDef[]): string;
+/**
+ * Generate rules section
+ */
+export declare function rulesSection(rules: string[]): string;
+/**
+ * Generate task examples section
+ */
+export declare function taskExamplesSection(examples: TaskExample[]): string;
+/**
+ * Generate sub-agent role section
+ */
+export declare function subAgentRoleSection(role: string): string;
+/**
+ * Generate input parameters section - explains how to check provided parameters
+ */
+export declare function inputParametersSection(): string;
+/**
+ * Generate task section
+ */
+export declare function taskSection(task: string): string;
+/**
+ * Generate workflow steps section
+ */
+export declare function workflowSection(steps: WorkflowStep[]): string;
+/**
+ * Generate guidelines section
+ */
+export declare function guidelinesSection(guidelines: string[]): string;
+/**
+ * Generate output section
+ */
+export declare function outputSection(output: OutputFormat): string;
+/**
+ * Generate output section from JSON schema
+ */
+export declare function outputSchemaSection(schema: OutputSchema): string;
+/**
+ * Generate available tools section for sub-agents
+ */
+export declare function availableToolsSection(tools: ToolDef[]): string;
+/**
+ * Generate instructions section
+ */
+export declare function instructionsSection(instructions: string[]): string;
+/**
+ * Generate checklist section
+ */
+export declare function checklistSection(config: ChecklistConfig): string;
+/**
+ * Generate examples section for sub-agents
+ */
+export declare function subAgentExamplesSection(examples: SubAgentExample[]): string;
+/**
+ * Generate constraints section
+ */
+export declare function constraintsSection(constraints: string[]): string;
+//# sourceMappingURL=templates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/prompt/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,OAAO,EACP,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,eAAe,EAChB,MAAM,YAAY,CAAA;AAMnB;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAe5D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAwBvE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,CAAC,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,MAAM,CAiCR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAQ3D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAQrE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAQpD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAWnE;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAU/C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,CAiC7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAQ9D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAkB1D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CA8BhE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAQ9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAQlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CA4BhE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,MAAM,CAmB3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAQhE"}