@alexnetrebskii/hive-agent 0.23.0 → 0.25.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mBAAmB;AACnB,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAsDjC,YAAY;AACZ,OAAO,EACL,cAAc,EAEf,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACL,cAAc,EAEf,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACL,aAAa,EAGd,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EACL,gBAAgB,EACjB,MAAM,kCAAkC,CAAA;AAEzC,YAAY;AACZ,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACf,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,aAAa,CAAA;AAEpB,iBAAiB;AACjB,OAAO,EACL,WAAW,EACX,cAAc,EACf,MAAM,WAAW,CAAA;AAElB,UAAU;AACV,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,aAAa,EACb,qBAAqB,EAYtB,MAAM,YAAY,CAAA;AAEnB,UAAU;AACV,OAAO,EACL,OAAO,EACP,kBAAkB,EASnB,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mBAAmB;AACnB,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAsDjC,YAAY;AACZ,OAAO,EACL,cAAc,EAEf,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACL,cAAc,EAEf,MAAM,2BAA2B,CAAA;AAElC,OAAO,EACL,aAAa,EAGd,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EACL,gBAAgB,EACjB,MAAM,kCAAkC,CAAA;AAEzC,YAAY;AACZ,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACf,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB;AACrB,kBAAkB;AAClB,gBAAgB,EAChB,eAAe;AACf,kDAAkD;AAClD,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,aAAa,EAUd,MAAM,aAAa,CAAA;AAEpB,iBAAiB;AACjB,OAAO,EACL,WAAW,EACX,cAAc,EACf,MAAM,iBAAiB,CAAA;AAExB,UAAU;AACV,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,aAAa,EACb,qBAAqB,EAYtB,MAAM,YAAY,CAAA;AAEnB,UAAU;AACV,OAAO,EACL,OAAO,EACP,kBAAkB,EASnB,MAAM,cAAc,CAAA;AAErB,4CAA4C;AAC5C,OAAO,EACL,WAAW,EACX,WAAW,EACX,SAAS,EAUV,MAAM,8BAA8B,CAAA"}

package/dist/prompt/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Prompt Builder Module
+ *
+ * Fluent API builders for creating main agent and sub-agent system prompts.
+ */
+export type { SubAgentDef, ToolDef, ContextPathDef, TaskExample, WorkflowStep, OutputFormat, MainAgentPromptConfig, SubAgentPromptConfig } from './types.js';
+export { MainAgentBuilder } from './main-agent-builder.js';
+export { SubAgentBuilder } from './sub-agent-builder.js';
+export { roleSection, subAgentsTable, questionHandlingSection, directToolsSection, contextStorageSection, 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,cAAc,EACd,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAGxD,OAAO,EACL,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,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,11 @@
+/**
+ * Prompt Builder Module
+ *
+ * Fluent API builders for creating main agent and sub-agent system prompts.
+ */
+// Builders
+export { MainAgentBuilder } from './main-agent-builder.js';
+export { SubAgentBuilder } from './sub-agent-builder.js';
+// Templates (for advanced customization)
+export { roleSection, subAgentsTable, questionHandlingSection, directToolsSection, contextStorageSection, 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,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,yCAAyC;AACzC,OAAO,EACL,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,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,92 @@
+/**
+ * Main Agent Prompt Builder
+ *
+ * Fluent API for building main agent system prompts.
+ */
+import type { SubAgentDef, ToolDef, ContextPathDef, TaskExample, MainAgentPromptConfig } from './types.js';
+import type { Tool, SubAgentConfig } from '../types.js';
+export declare class MainAgentBuilder {
+    private config;
+    /**
+     * Set the agent's role identity
+     */
+    role(role: string): this;
+    /**
+     * Set the agent's description
+     */
+    description(description: string): this;
+    /**
+     * Add a sub-agent definition manually
+     */
+    addSubAgent(name: string, purpose: string, whenToUse: string): this;
+    /**
+     * Add multiple sub-agents at once (manual definitions)
+     */
+    addSubAgents(agents: SubAgentDef[]): 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;
+    /**
+     * Add a direct tool manually
+     */
+    addTool(name: string, description: string): this;
+    /**
+     * Add multiple tools at once (manual definitions)
+     */
+    addTools(tools: ToolDef[]): this;
+    /**
+     * Set tools from actual Tool objects
+     * Extracts name and description automatically
+     */
+    tools(toolObjects: Tool[]): this;
+    /**
+     * Add a context path definition
+     */
+    addContextPath(path: string, description: string): this;
+    /**
+     * Add multiple context paths at once
+     */
+    addContextPaths(paths: ContextPathDef[]): 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,WAAW,EACX,OAAO,EACP,cAAc,EACd,WAAW,EACX,qBAAqB,EACtB,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAYvD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAOb;IAED;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB;;OAEG;IACH,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKnE;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI;IAKzC;;;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;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAKhD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI;IAKhC;;;OAGG;IACH,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,GAAG,IAAI;IAYhC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAKvD;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI;IAK9C;;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;IA+Ef;;OAEG;IACH,KAAK,IAAI,IAAI;CAWd"}

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

@@ -0,0 +1,244 @@
+/**
+ * Main Agent Prompt Builder
+ *
+ * Fluent API for building main agent system prompts.
+ */
+import { roleSection, subAgentsTable, subAgentParametersSection, questionHandlingSection, directToolsSection, contextStorageSection, rulesSection, taskExamplesSection } from './templates.js';
+export class MainAgentBuilder {
+    config = {
+        subAgents: [],
+        directTools: [],
+        contextPaths: [],
+        rules: [],
+        examples: [],
+        customSections: []
+    };
+    /**
+     * Set the agent's role identity
+     */
+    role(role) {
+        this.config.role = role;
+        return this;
+    }
+    /**
+     * Set the agent's description
+     */
+    description(description) {
+        this.config.description = description;
+        return this;
+    }
+    /**
+     * Add a sub-agent definition manually
+     */
+    addSubAgent(name, purpose, whenToUse) {
+        this.config.subAgents.push({ name, purpose, whenToUse });
+        return this;
+    }
+    /**
+     * Add multiple sub-agents at once (manual definitions)
+     */
+    addSubAgents(agents) {
+        this.config.subAgents.push(...agents);
+        return this;
+    }
+    /**
+     * Set sub-agents from actual SubAgentConfig objects
+     * Extracts name, description, and input parameters automatically
+     */
+    agents(configs) {
+        for (const config of configs) {
+            // Extract input parameters from inputSchema
+            const inputParams = [];
+            if (config.inputSchema?.properties) {
+                const required = config.inputSchema.required || [];
+                for (const [name, prop] of Object.entries(config.inputSchema.properties)) {
+                    inputParams.push({
+                        name,
+                        description: prop.description || '',
+                        required: required.includes(name)
+                    });
+                }
+            }
+            this.config.subAgents.push({
+                name: config.name,
+                purpose: config.description,
+                whenToUse: config.description,
+                inputParams: inputParams.length > 0 ? inputParams : undefined
+            });
+        }
+        return this;
+    }
+    /**
+     * Configure question handling behavior
+     */
+    questionHandling(options) {
+        this.config.questionHandling = options;
+        return this;
+    }
+    /**
+     * Add a direct tool manually
+     */
+    addTool(name, description) {
+        this.config.directTools.push({ name, description });
+        return this;
+    }
+    /**
+     * Add multiple tools at once (manual definitions)
+     */
+    addTools(tools) {
+        this.config.directTools.push(...tools);
+        return this;
+    }
+    /**
+     * Set tools from actual Tool objects
+     * Extracts name and description automatically
+     */
+    tools(toolObjects) {
+        for (const tool of toolObjects) {
+            // Extract first line of description for brevity
+            const desc = tool.description.split('\n')[0].trim();
+            this.config.directTools.push({
+                name: tool.name,
+                description: desc
+            });
+        }
+        return this;
+    }
+    /**
+     * Add a context path definition
+     */
+    addContextPath(path, description) {
+        this.config.contextPaths.push({ path, description });
+        return this;
+    }
+    /**
+     * Add multiple context paths at once
+     */
+    addContextPaths(paths) {
+        this.config.contextPaths.push(...paths);
+        return this;
+    }
+    /**
+     * Add a behavioral rule
+     */
+    addRule(rule) {
+        this.config.rules.push(rule);
+        return this;
+    }
+    /**
+     * Add multiple rules at once
+     */
+    addRules(rules) {
+        this.config.rules.push(...rules);
+        return this;
+    }
+    /**
+     * Add a task example showing the flow
+     */
+    addExample(example) {
+        this.config.examples.push(example);
+        return this;
+    }
+    /**
+     * Add multiple examples at once
+     */
+    addExamples(examples) {
+        this.config.examples.push(...examples);
+        return this;
+    }
+    /**
+     * Add a custom section with title and content
+     */
+    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 || 'an AI assistant';
+        sections.push(roleSection(role, this.config.description));
+        // Your Role header if we have sub-agents (orchestrator pattern)
+        if (this.config.subAgents && this.config.subAgents.length > 0) {
+            sections.push('');
+            sections.push('## Your Role');
+            sections.push('');
+            sections.push('1. **Delegate** - Call __task__ tool to spawn sub-agents');
+            sections.push('2. **Relay questions** - When sub-agent needs input, call __ask_user__ tool');
+            sections.push('3. **Present results** - After sub-agent completes, you MUST output a text message to the user');
+            sections.push('');
+            sections.push('⚠️ CRITICAL:');
+            sections.push('- Make actual tool calls, never write tool names as text');
+            sections.push('- After receiving tool results, ALWAYS respond with a text message to the user');
+            sections.push('- Never return an empty response');
+        }
+        // Sub-agents table
+        if (this.config.subAgents && this.config.subAgents.length > 0) {
+            sections.push('');
+            sections.push(subAgentsTable(this.config.subAgents));
+            // Add sub-agent parameters documentation
+            const paramsSection = subAgentParametersSection(this.config.subAgents);
+            if (paramsSection) {
+                sections.push('');
+                sections.push(paramsSection);
+            }
+        }
+        // Question handling
+        if (this.config.questionHandling || (this.config.subAgents && this.config.subAgents.length > 0)) {
+            sections.push('');
+            sections.push(questionHandlingSection(this.config.questionHandling?.description, this.config.questionHandling?.exampleFlow));
+        }
+        // Direct tools
+        if (this.config.directTools && this.config.directTools.length > 0) {
+            sections.push('');
+            sections.push(directToolsSection(this.config.directTools));
+        }
+        // Context storage
+        if (this.config.contextPaths && this.config.contextPaths.length > 0) {
+            sections.push('');
+            sections.push(contextStorageSection(this.config.contextPaths));
+        }
+        // Task examples
+        if (this.config.examples && this.config.examples.length > 0) {
+            sections.push('');
+            sections.push(taskExamplesSection(this.config.examples));
+        }
+        // Custom sections
+        for (const section of this.config.customSections || []) {
+            sections.push('');
+            sections.push(`## ${section.title}`);
+            sections.push('');
+            sections.push(section.content);
+        }
+        // Rules (always at the end)
+        if (this.config.rules && this.config.rules.length > 0) {
+            sections.push('');
+            sections.push(rulesSection(this.config.rules));
+        }
+        return sections.join('\n');
+    }
+    /**
+     * Reset the builder to initial state
+     */
+    reset() {
+        this.config = {
+            subAgents: [],
+            directTools: [],
+            contextPaths: [],
+            rules: [],
+            examples: [],
+            customSections: []
+        };
+        return this;
+    }
+}
+//# sourceMappingURL=main-agent-builder.js.map

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

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

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

@@ -0,0 +1,137 @@
+/**
+ * Sub-Agent Prompt Builder
+ *
+ * Fluent API for building sub-agent system prompts.
+ */
+import type { WorkflowStep, OutputFormat, SubAgentPromptConfig, ContextPathDef, ToolStepRef, ChecklistItem, SubAgentExample } from './types.js';
+import type { Tool, JSONSchema } from '../types.js';
+export declare class SubAgentBuilder {
+    private config;
+    /**
+     * Set the sub-agent's role (e.g., "a Nutrition Counter assistant")
+     */
+    role(role: string): this;
+    /**
+     * Set the task description
+     */
+    task(task: string): this;
+    /**
+     * Add step-by-step instructions
+     */
+    instructions(instructions: string[]): this;
+    /**
+     * Add a single instruction
+     */
+    addInstruction(instruction: string): this;
+    /**
+     * Enable todo tracking - AI will plan and track its own work
+     * @param options.exampleSteps - Example todos to guide the AI (optional)
+     */
+    useTodoTracking(options?: {
+        exampleSteps?: string[];
+    }): this;
+    /**
+     * Add guidance items (without todo tracking)
+     * @deprecated Use useTodoTracking() for progress tracking, or addGuidelines() for static guidance
+     */
+    checklist(items: (string | ChecklistItem)[], options?: {
+        sequential?: boolean;
+        trackProgress?: boolean;
+    }): this;
+    /**
+     * Add an input/output example
+     */
+    addExample(input: string, output: string, explanation?: string): this;
+    /**
+     * Add multiple examples at once
+     */
+    examples(examples: SubAgentExample[]): this;
+    /**
+     * Add a constraint (thing to avoid)
+     */
+    addConstraint(constraint: string): this;
+    /**
+     * Add multiple constraints at once
+     */
+    constraints(constraints: string[]): this;
+    /**
+     * Add a workflow step
+     */
+    addStep(step: WorkflowStep): this;
+    /**
+     * Add a step that may ask a question
+     */
+    addQuestionStep(description: string, askQuestion: {
+        condition?: string;
+        question: string;
+        options?: string[];
+    }): this;
+    /**
+     * Add a step with tool calls
+     */
+    addToolStep(description: string, toolCalls: string[]): this;
+    /**
+     * Add a guideline
+     */
+    addGuideline(guideline: string): this;
+    /**
+     * Add multiple guidelines at once
+     */
+    addGuidelines(guidelines: string[]): this;
+    /**
+     * Enable context discovery - agent will check context before starting work
+     */
+    useContext(): this;
+    /**
+     * Add a context path the agent should check
+     */
+    addContextPath(path: string, description: string): this;
+    /**
+     * Add multiple context paths at once
+     */
+    addContextPaths(paths: ContextPathDef[]): this;
+    /**
+     * Set the output format
+     */
+    output(format: OutputFormat): this;
+    /**
+     * Shorthand for common output format
+     * @deprecated Use outputSchema() instead for type-safe output definition
+     */
+    outputWithSummary(summaryTemplate: string, dataFields: Record<string, string>, errorCase?: {
+        condition: string;
+        data: Record<string, unknown>;
+    }): this;
+    /**
+     * Set output schema - generates output instructions from the schema
+     * This is the preferred way to define output format (type-safe)
+     */
+    outputSchema(schema: JSONSchema): this;
+    /**
+     * Set available tools from actual Tool objects
+     * Extracts name and description automatically for documentation
+     */
+    tools(toolObjects: Tool[]): this;
+    /**
+     * Add a workflow step that uses specific tools
+     * Type-safe alternative to addToolStep with string arrays
+     */
+    addToolsStep(description: string, toolRefs: ToolStepRef[]): this;
+    /**
+     * Add a custom section
+     */
+    addSection(title: string, content: string): this;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): SubAgentPromptConfig;
+    /**
+     * Build the final system prompt string
+     */
+    build(): string;
+    /**
+     * Reset the builder to initial state
+     */
+    reset(): this;
+}
+//# sourceMappingURL=sub-agent-builder.d.ts.map

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

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