0xkobold 0.0.6 → 0.2.0

package/dist/src/agent/types/definitions.js

@@ -0,0 +1,317 @@
+/**
+ * Agent Type Definitions - v0.2.0
+ *
+ * Defines the five agent types for the sub-agent system:
+ * - Coordinator: Plans and delegates
+ * - Specialist: Deep domain expertise
+ * - Researcher: Information gathering
+ * - Worker: Implementation
+ * - Reviewer: Code review and validation
+ */
+export const AGENT_TYPES = {
+    coordinator: {
+        id: "coordinator",
+        name: "Coordinator",
+        emoji: "🎯",
+        description: "Plans and delegates complex tasks to other agents",
+        purpose: `You are a Coordinator agent. Your job is to break down complex tasks 
+into manageable pieces and delegate them to appropriate specialist agents.
+
+You should:
+1. Analyze the task and identify what needs to be done
+2. Break it down into subtasks with clear dependencies
+3. Delegate each subtask to the right agent type
+4. Monitor progress and integrate results
+5. Handle failures by replanning
+
+You rarely write code yourself - you coordinate others who do.`,
+        systemPrompt: `You are a Coordinator agent (🎯).
+
+Your role is to plan and delegate. When given a task:
+1. Analyze requirements thoroughly
+2. Identify subtasks and dependencies
+3. Delegate to appropriate agents:
+   - Researcher for information gathering
+   - Specialist for domain-specific work
+   - Worker for implementation
+   - Reviewer for validation
+4. Track progress and integrate results
+5. Report back with final outcome
+
+Guidelines:
+- Think before acting: create a plan first
+- Delegate work, don't do it yourself
+- Monitor and coordinate multiple agents
+- Handle failures gracefully
+- Keep the user informed of progress`,
+        capabilities: [
+            "task-decomposition",
+            "agent-delegation",
+            "progress-tracking",
+            "result-integration",
+            "failure-recovery"
+        ],
+        tools: [
+            "agent_orchestrate",
+            "task_breakdown",
+            "perennial_search",
+            "read",
+            "bash"
+        ],
+        maxIterations: 20,
+        thinkLevel: "deep",
+        modelPreference: "smart"
+    },
+    specialist: {
+        id: "specialist",
+        name: "Specialist",
+        emoji: "🧠",
+        description: "Deep domain expertise on specific technologies",
+        purpose: `You are a Specialist agent with deep expertise in specific domains.
+You know one or more technologies extremely well and provide expert-level work.
+
+Domains you might specialize in:
+- Database optimization (SQL, PostgreSQL, MongoDB)
+- Frontend frameworks (React, Vue, Svelte)
+- API design (REST, GraphQL, gRPC)
+- DevOps (Docker, Kubernetes, CI/CD)
+- Security (auth, crypto, best practices)
+- Performance optimization
+
+You should:
+- Apply deep domain knowledge
+- Follow best practices in your specialty
+- Provide expert recommendations
+- Solve complex domain-specific problems`,
+        systemPrompt: `You are a Specialist agent (🧠) with deep domain expertise.
+
+You are an expert in a specific domain. When assigned a task:
+1. Apply your deep knowledge immediately
+2. Follow domain best practices
+3. Consider edge cases and gotchas
+4. Provide expert-level recommendations
+5. Deliver production-quality work
+
+Your expertise makes you the go-to agent for difficult problems
+in your domain. You're thorough, precise, and deliver excellent results.
+
+You work independently but ask for clarification if requirements
+are ambiguous or incomplete.`,
+        capabilities: [
+            "deep-domain-knowledge",
+            "best-practices",
+            "complex-problem-solving",
+            "optimization",
+            "expert-recommendations"
+        ],
+        tools: [
+            "read",
+            "edit",
+            "write",
+            "bash",
+            "web_search",
+            "perennial_search"
+        ],
+        maxIterations: 15,
+        thinkLevel: "deep",
+        modelPreference: "smart"
+    },
+    researcher: {
+        id: "researcher",
+        name: "Researcher",
+        emoji: "🔍",
+        description: "Gathers information and synthesizes findings",
+        purpose: `You are a Researcher agent. Your job is to gather information,
+analyze data, and provide comprehensive findings.
+
+You should:
+- Search for relevant information thoroughly
+- Read documentation and source materials
+- Synthesize findings into clear summaries
+- Provide citations and sources
+- Identify gaps in available information
+
+You are curious, thorough, and excellent at finding answers.`,
+        systemPrompt: `You are a Researcher agent (🔍).
+
+Your mission: Find information and synthesize findings.
+
+When given a research task:
+1. Identify what information is needed
+2. Search web, documentation, codebase
+3. Read and analyze source materials
+4. Synthesize findings into clear summaries
+5. Provide sources and citations
+6. Note any information gaps
+
+Guidelines:
+- Be thorough - check multiple sources
+- Synthesize, don't just copy
+- Provide specific details with citations
+- Structure findings clearly
+- Note confidence levels when uncertain
+- Flag when information is incomplete`,
+        capabilities: [
+            "information-gathering",
+            "web-research",
+            "documentation-analysis",
+            "synthesis",
+            "citation-tracking"
+        ],
+        tools: [
+            "web_search",
+            "web_fetch",
+            "web_research",
+            "read",
+            "perennial_search",
+            "bash"
+        ],
+        maxIterations: 12,
+        thinkLevel: "normal",
+        modelPreference: "fast"
+    },
+    worker: {
+        id: "worker",
+        name: "Worker",
+        emoji: "⚒️",
+        description: "Implements code and executes tasks efficiently",
+        purpose: `You are a Worker agent. Your job is to implement code,
+write tests, and execute tasks efficiently.
+
+You should:
+- Write clean, working code
+- Follow existing patterns in the codebase
+- Test your changes
+- Handle errors gracefully
+- Deliver complete, working solutions
+
+You are efficient, practical, and focused on delivering results.`,
+        systemPrompt: `You are a Worker agent (⚒️).
+
+Your mission: Implement, execute, deliver.
+
+When assigned a task:
+1. Understand the requirements clearly
+2. Check existing patterns in the codebase
+3. Implement the solution efficiently
+4. Test your changes
+5. Handle errors gracefully
+6. Deliver working code
+
+Guidelines:
+- Follow existing code patterns
+- Write clean, readable code
+- Test before claiming done
+- Handle edge cases
+- Comment complex logic
+- Don't over-engineer
+- Deliver complete solutions, not partial work`,
+        capabilities: [
+            "implementation",
+            "code-generation",
+            "testing",
+            "debugging",
+            "pattern-matching"
+        ],
+        tools: [
+            "read",
+            "edit",
+            "write",
+            "bash",
+            "perennial_save",
+            "memory_save"
+        ],
+        maxIterations: 15,
+        thinkLevel: "normal",
+        modelPreference: "fast"
+    },
+    reviewer: {
+        id: "reviewer",
+        name: "Reviewer",
+        emoji: "👁️",
+        description: "Reviews code, validates solutions, checks quality",
+        purpose: `You are a Reviewer agent. Your job is to validate work,
+review code, and ensure quality standards are met.
+
+You should:
+- Review code for correctness and style
+- Check for bugs and edge cases
+- Validate against requirements
+- Provide constructive feedback
+- Suggest improvements
+
+You are thorough, critical, and fair. You catch issues others miss.`,
+        systemPrompt: `You are a Reviewer agent (👁️).
+
+Your mission: Validate, review, ensure quality.
+
+When reviewing work:
+1. Check against requirements
+2. Review code for correctness
+3. Identify bugs and edge cases
+4. Check for security issues
+5. Validate test coverage
+6. Assess code quality
+7. Provide constructive feedback
+
+Guidelines:
+- Be thorough, not superficial
+- Explain why something is wrong
+- Suggest specific improvements
+- Check edge cases
+- Validate test coverage
+- Consider security implications
+- Be constructive, not harsh
+- Focus on important issues`,
+        capabilities: [
+            "code-review",
+            "validation",
+            "quality-assurance",
+            "security-review",
+            "test-coverage-analysis"
+        ],
+        tools: [
+            "read",
+            "bash",
+            "perennial_search",
+            "web_search"
+        ],
+        maxIterations: 10,
+        thinkLevel: "deep",
+        modelPreference: "smart"
+    }
+};
+/**
+ * Get agent type by ID
+ */
+export function getAgentType(id) {
+    return AGENT_TYPES[id.toLowerCase()];
+}
+/**
+ * Get all agent types
+ */
+export function getAllAgentTypes() {
+    return Object.values(AGENT_TYPES);
+}
+/**
+ * Get agent types that can handle a task
+ */
+export function getAgentTypesForTask(taskType) {
+    const taskLower = taskType.toLowerCase();
+    if (taskLower.includes("research") || taskLower.includes("find") || taskLower.includes("search")) {
+        return [AGENT_TYPES.researcher];
+    }
+    if (taskLower.includes("review") || taskLower.includes("check") || taskLower.includes("validate")) {
+        return [AGENT_TYPES.reviewer];
+    }
+    if (taskLower.includes("implement") || taskLower.includes("code") || taskLower.includes("write")) {
+        return [AGENT_TYPES.worker, AGENT_TYPES.specialist];
+    }
+    if (taskLower.includes("plan") || taskLower.includes("coordinate") || taskLower.includes("organize")) {
+        return [AGENT_TYPES.coordinator];
+    }
+    // Default: Worker can handle most tasks
+    return [AGENT_TYPES.worker];
+}
+export default AGENT_TYPES;
+//# sourceMappingURL=definitions.js.map

package/dist/src/agent/types/definitions.js.map

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

package/dist/src/agent/types/index.js

@@ -0,0 +1,2 @@
+export { AGENT_TYPES, getAgentType, getAllAgentTypes, getAgentTypesForTask } from "./definitions.js";
+//# sourceMappingURL=index.js.map

package/dist/src/agent/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/agent/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/src/agent/user-profile.js

@@ -0,0 +1,300 @@
+/**
+ * User Profile System - v0.2.0
+ *
+ * Manages USER.md - learned and explicit user preferences.
+ * Part of the Persona System (Phase 1.2).
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { existsSync } from "node:fs";
+const DEFAULT_USER_PROFILE = {
+    preferences: {
+        coding: {
+            style: "balanced",
+            comments: "descriptive",
+            testing: "basic",
+            frameworks: [],
+        },
+        communication: {
+            formality: "casual",
+            detailLevel: "medium",
+            emojiUsage: true,
+        },
+        tools: {
+            preferredEditor: "vscode",
+            preferredShell: "bash",
+            preferredModel: "auto",
+        },
+    },
+    learned: {
+        patterns: [],
+        dislikes: [],
+        favorites: [],
+        workflows: [],
+    },
+    createdAt: new Date().toISOString(),
+    updatedAt: new Date().toISOString(),
+};
+const USER_MD_TEMPLATE = `# USER Profile
+
+## Identity
+**Name:** {{name}}
+**Email:** {{email}}
+**Timezone:** {{timezone}}
+
+## Coding Preferences
+
+### Style
+- Approach: {{coding.style}}
+- Comments: {{coding.comments}}
+- Testing: {{coding.testing}}
+- Frameworks: {{coding.frameworks}}
+
+### Communication
+- Formality: {{communication.formality}}
+- Detail Level: {{communication.detailLevel}}
+- Emojis: {{communication.emojiUsage}}
+
+### Tools
+- Editor: {{tools.preferredEditor}}
+- Shell: {{tools.preferredShell}}
+- Preferred Model: {{tools.preferredModel}}
+
+## Learned Preferences
+
+### Patterns I Use
+{{#each learned.patterns}}
+- {{this}}
+{{/each}}
+
+### Things I Dislike
+{{#each learned.dislikes}}
+- {{this}}
+{{/each}}
+
+### Things I Like
+{{#each learned.favorites}}
+- {{this}}
+{{/each}}
+
+### Preferred Workflows
+{{#each learned.workflows}}
+#### {{name}}
+{{description}}
+
+Steps:
+{{#each steps}}
+1. {{this}}
+{{/each}}
+
+Use when: {{contexts}}
+{{/each}}
+
+---
+*Last updated: {{updatedAt}}*
+`;
+/**
+ * Load user profile from USER.md
+ */
+export async function loadUserProfile(workspaceDir) {
+    const userPath = path.join(workspaceDir, "USER.md");
+    if (!existsSync(userPath)) {
+        return { ...DEFAULT_USER_PROFILE };
+    }
+    try {
+        const content = await fs.readFile(userPath, "utf-8");
+        return parseUserProfile(content);
+    }
+    catch (error) {
+        console.warn("[UserProfile] Failed to load USER.md, using defaults");
+        return { ...DEFAULT_USER_PROFILE };
+    }
+}
+/**
+ * Save user profile to USER.md
+ */
+export async function saveUserProfile(workspaceDir, profile) {
+    const userPath = path.join(workspaceDir, "USER.md");
+    profile.updatedAt = new Date().toISOString();
+    const content = serializeUserProfile(profile);
+    await fs.writeFile(userPath, content, "utf-8");
+}
+/**
+ * Parse USER.md content into UserProfile
+ */
+function parseUserProfile(content) {
+    const profile = { ...DEFAULT_USER_PROFILE };
+    // Simple parsing - extract values from markdown
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        // Parse identity
+        if (line.startsWith("**Name:**")) {
+            profile.name = line.replace("**Name:**", "").trim() || undefined;
+        }
+        if (line.startsWith("**Email:**")) {
+            profile.email = line.replace("**Email:**", "").trim() || undefined;
+        }
+        if (line.startsWith("**Timezone:**")) {
+            profile.timezone = line.replace("**Timezone:**", "").trim() || undefined;
+        }
+        // Parse coding style
+        if (line.includes("Approach:") && profile.preferences) {
+            const value = line.split(":")[1]?.trim();
+            if (value)
+                profile.preferences.coding.style = value;
+        }
+        // Parse communication
+        if (line.includes("Formality:") && profile.preferences) {
+            const value = line.split(":")[1]?.trim();
+            if (value)
+                profile.preferences.communication.formality = value;
+        }
+        // Parse learned sections (simple list parsing)
+        if (line === "### Things I Dislike") {
+            let j = i + 1;
+            while (j < lines.length && lines[j].startsWith("- ")) {
+                const item = lines[j].replace("- ", "").trim();
+                if (item)
+                    profile.learned.dislikes.push(item);
+                j++;
+            }
+        }
+        if (line === "### Things I Like") {
+            let j = i + 1;
+            while (j < lines.length && lines[j].startsWith("- ")) {
+                const item = lines[j].replace("- ", "").trim();
+                if (item)
+                    profile.learned.favorites.push(item);
+                j++;
+            }
+        }
+    }
+    return profile;
+}
+/**
+ * Serialize UserProfile to USER.md content
+ */
+function serializeUserProfile(profile) {
+    // Build markdown manually for now
+    const sections = [];
+    sections.push("# USER Profile\n");
+    // Identity
+    sections.push("## Identity");
+    sections.push(`**Name:** ${profile.name || ""}`);
+    sections.push(`**Email:** ${profile.email || ""}`);
+    sections.push(`**Timezone:** ${profile.timezone || ""}\n`);
+    // Coding preferences
+    sections.push("## Coding Preferences\n");
+    sections.push("### Style");
+    sections.push(`- Approach: ${profile.preferences.coding.style}`);
+    sections.push(`- Comments: ${profile.preferences.coding.comments}`);
+    sections.push(`- Testing: ${profile.preferences.coding.testing}`);
+    sections.push(`- Frameworks: ${profile.preferences.coding.frameworks.join(", ") || "None specified"}\n`);
+    // Communication
+    sections.push("### Communication");
+    sections.push(`- Formality: ${profile.preferences.communication.formality}`);
+    sections.push(`- Detail Level: ${profile.preferences.communication.detailLevel}`);
+    sections.push(`- Emojis: ${profile.preferences.communication.emojiUsage ? "Yes" : "No"}\n`);
+    // Tools
+    sections.push("### Tools");
+    sections.push(`- Editor: ${profile.preferences.tools.preferredEditor}`);
+    sections.push(`- Shell: ${profile.preferences.tools.preferredShell}`);
+    sections.push(`- Preferred Model: ${profile.preferences.tools.preferredModel}\n`);
+    // Learned
+    sections.push("## Learned Preferences\n");
+    sections.push("### Patterns I Use");
+    if (profile.learned.patterns.length === 0) {
+        sections.push("_No patterns learned yet_\n");
+    }
+    else {
+        for (const pattern of profile.learned.patterns) {
+            sections.push(`- ${pattern}`);
+        }
+        sections.push("");
+    }
+    sections.push("### Things I Dislike");
+    if (profile.learned.dislikes.length === 0) {
+        sections.push("_None recorded_\n");
+    }
+    else {
+        for (const dislike of profile.learned.dislikes) {
+            sections.push(`- ${dislike}`);
+        }
+        sections.push("");
+    }
+    sections.push("### Things I Like");
+    if (profile.learned.favorites.length === 0) {
+        sections.push("_None recorded_\n");
+    }
+    else {
+        for (const favorite of profile.learned.favorites) {
+            sections.push(`- ${favorite}`);
+        }
+        sections.push("");
+    }
+    sections.push("---");
+    sections.push(`*Last updated: ${profile.updatedAt}*`);
+    return sections.join("\n");
+}
+/**
+ * Learn from user interaction
+ */
+export async function learnPreference(workspaceDir, type, value) {
+    const profile = await loadUserProfile(workspaceDir);
+    switch (type) {
+        case "like":
+            if (!profile.learned.favorites.includes(value)) {
+                profile.learned.favorites.push(value);
+            }
+            break;
+        case "dislike":
+            if (!profile.learned.dislikes.includes(value)) {
+                profile.learned.dislikes.push(value);
+            }
+            break;
+        case "pattern":
+            if (!profile.learned.patterns.includes(value)) {
+                profile.learned.patterns.push(value);
+            }
+            break;
+    }
+    await saveUserProfile(workspaceDir, profile);
+}
+/**
+ * Create default USER.md if missing
+ */
+export async function ensureUserProfile(workspaceDir) {
+    const userPath = path.join(workspaceDir, "USER.md");
+    if (existsSync(userPath)) {
+        console.log("[UserProfile] USER.md exists");
+        return;
+    }
+    const profile = { ...DEFAULT_USER_PROFILE };
+    await saveUserProfile(workspaceDir, profile);
+    console.log("[UserProfile] Created default USER.md");
+}
+/**
+ * Get user preferences as system prompt section
+ */
+export async function getUserPreferencesForPrompt(workspaceDir) {
+    const profile = await loadUserProfile(workspaceDir);
+    const parts = [];
+    parts.push("<!-- User Profile -->");
+    if (profile.name) {
+        parts.push(`Name: ${profile.name}`);
+    }
+    parts.push("Preferences:");
+    parts.push(`- Coding style: ${profile.preferences.coding.style}`);
+    parts.push(`- Comments: ${profile.preferences.coding.comments}`);
+    parts.push(`- Testing: ${profile.preferences.coding.testing}`);
+    parts.push(`- Communication: ${profile.preferences.communication.formality}, ${profile.preferences.communication.detailLevel} detail`);
+    if (profile.learned.favorites.length > 0) {
+        parts.push(`- Preferences: ${profile.learned.favorites.slice(0, 3).join(", ")}`);
+    }
+    if (profile.learned.dislikes.length > 0) {
+        parts.push(`- Avoid: ${profile.learned.dislikes.slice(0, 3).join(", ")}`);
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=user-profile.js.map

package/dist/src/agent/user-profile.js.map

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