0xkobold 0.0.6 → 0.2.0

package/dist/src/agent/system-prompt.js

@@ -0,0 +1,84 @@
+/**
+ * System Prompt Builder - v0.2.0
+ *
+ * Constructs custom system prompts with bootstrap injection.
+ * Inspired by OpenClaw's buildAgentSystemPrompt()
+ */
+import { formatBootstrapForPrompt } from "./bootstrap-loader.js";
+const BASE_SYSTEM_PROMPT = `You are 0xKobold, a helpful AI coding assistant and digital familiar.
+
+Your purpose is to assist the user with coding tasks, answer questions, and act as a companion in their development workflow.
+
+Key capabilities:
+- Read, write, and edit files in the workspace
+- Execute commands and scripts
+- Search the codebase
+- Spawn sub-agents for complex tasks
+- Access web resources
+- Remember context across sessions
+
+Important behaviors:
+- Be concise and focused on delivering working code
+- Ask clarifying questions when requirements are unclear
+- Handle errors gracefully and explain what went wrong
+- Follow existing code patterns in the project
+- Test your changes when possible
+
+When to use sub-agents:
+- Complex tasks requiring multiple steps
+- Parallel work streams
+- Research vs implementation split
+- Code review scenarios`;
+/**
+ * Build custom system prompt with bootstrap injection
+ */
+export function buildSystemPrompt(config) {
+    const parts = [];
+    // 1. Base identity
+    parts.push(config.basePrompt || BASE_SYSTEM_PROMPT);
+    // 2. Bootstrap context (SOUL.md, IDENTITY.md, etc.)
+    if (config.bootstrapFiles.length > 0) {
+        parts.push("");
+        parts.push(formatBootstrapForPrompt(config.bootstrapFiles));
+    }
+    // 3. Workspace context
+    if (config.workspace) {
+        parts.push("");
+        parts.push(`<!-- Workspace -->\nWorking directory: ${config.workspace}`);
+    }
+    // 4. Tools reference (optional summary)
+    if (config.tools && config.tools.length > 0) {
+        parts.push("");
+        parts.push("Available tools: " + config.tools.map(t => t.name).join(", "));
+    }
+    // 5. Mode-specific instructions
+    if (config.mode === "plan") {
+        parts.push("");
+        parts.push(`<!-- Mode: Plan -->\nYou are in PLAN MODE. Focus on investigation and planning. Do not write code unless explicitly asked.`);
+    }
+    else if (config.mode === "build") {
+        parts.push("");
+        parts.push(`<!-- Mode: Build -->\nYou are in BUILD MODE. Focus on implementation and execution. Write clean, tested code.`);
+    }
+    return parts.join("\n\n");
+}
+/**
+ * Create system prompt override for pi-coding-agent
+ * This format matches what pi-coding-agent expects
+ */
+export function createSystemPromptOverride(systemPrompt) {
+    return {
+        type: "override",
+        systemPrompt,
+    };
+}
+/**
+ * Apply system prompt override to session
+ * This is a placeholder - actual application depends on pi-coding-agent internals
+ */
+export function applySystemPromptOverride(session, override) {
+    // In real implementation, this would access pi-coding-agent internals
+    // For now, we document the intent
+    console.log("[SystemPrompt] Override prepared (" + override.systemPrompt.length + " chars)");
+}
+//# sourceMappingURL=system-prompt.js.map

package/dist/src/agent/system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../../../src/agent/system-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAiB,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAUhF,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;wBAuBH,CAAC;AAEzB;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAA0B;IAC1D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,mBAAmB;IACnB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,kBAAkB,CAAC,CAAC;IAEpD,oDAAoD;IACpD,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,uBAAuB;IACvB,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,0CAA0C,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,wCAAwC;IACxC,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,mBAAmB,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,gCAAgC;IAChC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,4HAA4H,CAAC,CAAC;IAC3I,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,+GAA+G,CAAC,CAAC;IAC9H,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,YAAoB;IAI7D,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAY,EACZ,QAAuD;IAEvD,sEAAsE;IACtE,kCAAkC;IAClC,OAAO,CAAC,GAAG,CAAC,oCAAoC,GAAG,QAAQ,CAAC,YAAY,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAC/F,CAAC"}

package/dist/src/agent/task-router.js

@@ -0,0 +1,194 @@
+/**
+ * Task Router - v0.2.0
+ *
+ * Routes tasks to appropriate agent types based on task content.
+ * Part of the Unified Agent Orchestration system.
+ */
+import { AGENT_TYPES } from "./types/index.js";
+/**
+ * Analyze task and route to appropriate agent
+ */
+export function routeTask(request) {
+    const task = request.task.toLowerCase();
+    const context = (request.context || "").toLowerCase();
+    // Keywords for each agent type
+    const keywords = {
+        coordinator: ["plan", "coordinate", "organize", "delegate", "manage", "break down", "multiple"],
+        researcher: ["research", "find", "search", "investigate", "lookup", "document", "learn about"],
+        reviewer: ["review", "check", "validate", "audit", "inspect", "quality", "verify"],
+        specialist: ["optimize", "refactor", "architecture", "design", "expert", "complex", "advanced"],
+        worker: ["implement", "code", "write", "create", "build", "fix", "test", "update"]
+    };
+    // Score each agent type
+    const scores = {
+        coordinator: 0,
+        researcher: 0,
+        reviewer: 0,
+        specialist: 0,
+        worker: 0
+    };
+    // Check keywords
+    for (const [agentType, words] of Object.entries(keywords)) {
+        for (const word of words) {
+            if (task.includes(word) || context.includes(word)) {
+                scores[agentType] += 1;
+            }
+        }
+    }
+    // Special patterns
+    if (/\b(design|architect|optimize|performance|security)\b/.test(task + context)) {
+        scores.specialist += 2;
+    }
+    if (/\b(bug|fix|implement|create|write)\b/.test(task + context)) {
+        scores.worker += 2;
+    }
+    if (/\b(review|check|validate|audit)\b/.test(task + context)) {
+        scores.reviewer += 2;
+    }
+    if (/\b(research|find|document|search)\b/.test(task + context)) {
+        scores.researcher += 2;
+    }
+    if (/\b(plan|coordinate|multiple|team|organize)\b/.test(task + context)) {
+        scores.coordinator += 2;
+    }
+    // Find best match
+    let bestAgent = "worker"; // default
+    let bestScore = -1;
+    for (const [agent, score] of Object.entries(scores)) {
+        if (score > bestScore) {
+            bestScore = score;
+            bestAgent = agent;
+        }
+    }
+    // Calculate confidence
+    const confidence = Math.min(0.95, 0.5 + bestScore * 0.15);
+    // Get alternatives
+    const alternatives = Object.entries(scores)
+        .filter(([agent, score]) => agent !== bestAgent && score > 0)
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 2)
+        .map(([agent]) => AGENT_TYPES[agent]);
+    // Estimate complexity
+    let complexity = "medium";
+    if (/\b(plan|architecture|design|multiple|coordinate)\b/i.test(task)) {
+        complexity = "complex";
+    }
+    else if (/\b(simple|quick|minor|small)\b/i.test(task)) {
+        complexity = "simple";
+    }
+    // Build reasoning
+    const reasoning = buildReasoning(bestAgent, request, scores);
+    return {
+        recommendedAgent: AGENT_TYPES[bestAgent],
+        confidence,
+        reasoning,
+        alternativeAgents: alternatives,
+        estimatedComplexity: complexity,
+        suggestions: generateSuggestions(request, bestAgent)
+    };
+}
+/**
+ * Build human-readable reasoning
+ */
+function buildReasoning(agentType, request, scores) {
+    const task = request.task;
+    switch (agentType) {
+        case "coordinator":
+            return `Task "${task}" appears to require planning and coordination. It mentions aspects that suggest multiple subtasks or need for delegation.`;
+        case "researcher":
+            return `Task "${task}" is primarily about information gathering. A Researcher is best suited to find and synthesize this information.`;
+        case "reviewer":
+            return `Task "${task}" involves validation and quality assurance. A Reviewer will ensure standards are met.`;
+        case "specialist":
+            return `Task "${task}" requires deep domain expertise. A Specialist ${AGENT_TYPES.specialist.emoji} has the knowledge needed.`;
+        case "worker":
+        default:
+            return `Task "${task}" is an implementation task best handled by a Worker agent. All scores: ${JSON.stringify(scores)}`;
+    }
+}
+/**
+ * Generate helpful suggestions
+ */
+function generateSuggestions(request, agentType) {
+    const suggestions = [];
+    if (agentType === "coordinator") {
+        suggestions.push("Consider breaking this into clearly defined subtasks");
+        suggestions.push("Identify dependencies between subtasks");
+    }
+    if (agentType === "worker") {
+        const complexity = /\b(complex|multiple|architecture)\b/i.test(request.task) ? "high" : "low";
+        if (complexity === "high") {
+            suggestions.push("This appears complex - consider using a Specialist for the design phase");
+            suggestions.push("A Reviewer could validate the implementation");
+        }
+    }
+    if (agentType === "specialist") {
+        suggestions.push("Consider having a Worker implement the solution after design");
+    }
+    if (!request.expectedOutput) {
+        suggestions.push("Consider specifying expected output format in the task");
+    }
+    return suggestions;
+}
+/**
+ * Get quick agent recommendation
+ */
+export function quickRoute(task) {
+    const result = routeTask({ task });
+    return result.recommendedAgent;
+}
+/**
+ * Check if task should use subagents
+ */
+export function shouldUseSubagents(task) {
+    const complexity = analyzeComplexity(task);
+    if (complexity === "simple") {
+        return {
+            useSubagents: false,
+            reason: "Task is simple enough to handle directly",
+            complexity
+        };
+    }
+    if (complexity === "complex") {
+        return {
+            useSubagents: true,
+            reason: "Complex task would benefit from coordinated subagents",
+            complexity
+        };
+    }
+    return {
+        useSubagents: false,
+        reason: "Medium complexity - use subagents if parallel work is possible",
+        complexity
+    };
+}
+/**
+ * Analyze task complexity
+ */
+function analyzeComplexity(task) {
+    const taskLower = task.toLowerCase();
+    // Complex indicators
+    const complexIndicators = [
+        /\b(multiple|several|various)\b/,
+        /\b(coordinate|orchestrate|plan)\b/,
+        /\b(architecture|design|refactor)\b/,
+        /\band\b.*\band\b.*\band\b/, // Multiple "and" clauses
+        /\b(system|framework|platform)\b/,
+        /\b(migrate|upgrade|rewrite)\b/,
+    ];
+    // Simple indicators
+    const simpleIndicators = [
+        /\b(simple|quick|minor|small|fix)\b/,
+        /^\s*\w+\s+(the|a|an)\s+\w+\s*$/, // Simple action pattern
+        /^\s*(add|fix|update|remove)\s+/i,
+        /\b(just|only|single)\b/,
+    ];
+    const complexScore = complexIndicators.filter(r => r.test(taskLower)).length;
+    const simpleScore = simpleIndicators.filter(r => r.test(taskLower)).length;
+    if (complexScore >= 2)
+        return "complex";
+    if (simpleScore >= 2 || task.length < 50)
+        return "simple";
+    return "medium";
+}
+//# sourceMappingURL=task-router.js.map

package/dist/src/agent/task-router.js.map

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

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

@@ -0,0 +1,2 @@
+export { spawnAgent, spawnAgents, getSpawnAgentToolConfig, executeSpawnAgent } from "./spawn-agent.js";
+//# sourceMappingURL=index.js.map

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

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

package/dist/src/agent/tools/spawn-agent.js

@@ -0,0 +1,200 @@
+/**
+ * Spawn Agent Tool - v0.2.0
+ *
+ * Spawns a subagent of a specific type with appropriate configuration.
+ * Part of the Unified Agent Orchestration system.
+ */
+import { getAgentType } from "../types/index.js";
+import { routeTask } from "../task-router.js";
+/**
+ * Generate unique agent ID
+ */
+function generateAgentId(type) {
+    const timestamp = Date.now().toString(36).slice(-4);
+    const random = Math.random().toString(36).slice(2, 6);
+    return `${type}-${timestamp}-${random}`;
+}
+/**
+ * Spawn a specialized agent
+ */
+export async function spawnAgent(params) {
+    let agentType;
+    let routingInfo;
+    // Auto-route if requested or no type specified
+    if (params.autoRoute || !params.agentType) {
+        const taskRequest = {
+            task: params.task,
+            context: params.context,
+            priority: params.priority,
+        };
+        routingInfo = routeTask(taskRequest);
+        agentType = routingInfo.recommendedAgent;
+    }
+    else {
+        const found = getAgentType(params.agentType);
+        if (!found) {
+            return {
+                success: false,
+                agentId: "",
+                agentType: getAgentType("worker"), // fallback
+                task: params.task,
+                systemPrompt: "",
+                maxIterations: 0,
+                error: `Unknown agent type: ${params.agentType}. Valid types: coordinator, specialist, researcher, worker, reviewer`,
+            };
+        }
+        agentType = found;
+    }
+    const agentId = generateAgentId(agentType.id);
+    // Build system prompt
+    const systemPrompt = buildAgentSystemPrompt(agentType, params);
+    // Override maxIterations if specified
+    const maxIterations = params.maxIterations || agentType.maxIterations;
+    return {
+        success: true,
+        agentId,
+        agentType,
+        task: params.task,
+        systemPrompt,
+        maxIterations,
+        routingInfo,
+    };
+}
+/**
+ * Build system prompt for the agent
+ */
+function buildAgentSystemPrompt(agentType, params) {
+    const parts = [];
+    // Agent identity
+    parts.push(`${agentType.systemPrompt}`);
+    // Task context
+    if (params.context) {
+        parts.push("");
+        parts.push(`<!-- Task Context -->`);
+        parts.push(`Additional context: ${params.context}`);
+    }
+    // Priority
+    if (params.priority) {
+        parts.push("");
+        parts.push(`<!-- Priority -->`);
+        parts.push(`Priority: ${params.priority.toUpperCase()}`);
+    }
+    // Capabilities reminder
+    parts.push("");
+    parts.push(`<!-- Your Capabilities -->`);
+    parts.push(agentType.capabilities.map(c => `- ${c}`).join("\n"));
+    // Available tools
+    parts.push("");
+    parts.push(`<!-- Available Tools -->`);
+    parts.push(agentType.tools.map(t => `- ${t}`).join("\n"));
+    return parts.join("\n\n");
+}
+/**
+ * Spawn multiple agents in parallel
+ */
+export async function spawnAgents(tasks) {
+    const promises = tasks.map((t) => spawnAgent({
+        task: t.task,
+        agentType: t.agentType,
+        context: t.context,
+        autoRoute: !t.agentType,
+    }));
+    return Promise.all(promises);
+}
+/**
+ * Get agent spawn configuration for tool registration
+ */
+export function getSpawnAgentToolConfig() {
+    return {
+        name: "spawn_agent",
+        description: `Spawn a specialized subagent to handle a task.
+
+This tool creates a subagent of a specific type:
+- coordinator (🎯): Plans and delegates complex tasks
+- specialist (🧠): Deep domain expertise
+- researcher (🔍): Gathers information and synthesizes findings  
+- worker (⚒️): Implements code and executes tasks
+- reviewer (👁️): Reviews code and validates quality
+
+Use autoRoute: true to let the system choose the best agent type.`,
+        parameters: {
+            type: "object",
+            properties: {
+                task: {
+                    type: "string",
+                    description: "The task to assign to the subagent. Be specific and clear.",
+                },
+                agentType: {
+                    type: "string",
+                    enum: ["coordinator", "specialist", "researcher", "worker", "reviewer"],
+                    description: "Type of agent to spawn. Use autoRoute: true to let system choose.",
+                },
+                autoRoute: {
+                    type: "boolean",
+                    description: "If true, automatically determine best agent type",
+                    default: true,
+                },
+                context: {
+                    type: "string",
+                    description: "Additional context for the agent",
+                },
+                priority: {
+                    type: "string",
+                    enum: ["low", "normal", "high"],
+                    default: "normal",
+                },
+            },
+            required: ["task"],
+        },
+    };
+}
+/**
+ * Spawn agent tool for ExtensionAPI
+ */
+export async function executeSpawnAgent(args) {
+    const result = await spawnAgent({
+        task: args.task,
+        agentType: args.agentType,
+        autoRoute: args.autoRoute ?? true,
+        context: args.context,
+        priority: args.priority ?? "normal",
+        maxIterations: args.maxIterations,
+        model: args.model,
+    });
+    if (!result.success) {
+        return {
+            success: false,
+            error: result.error,
+            content: [
+                {
+                    type: "text",
+                    text: `Failed to spawn agent: ${result.error}`,
+                },
+            ],
+            details: { error: result.error },
+        };
+    }
+    const routingText = result.routingInfo
+        ? `\n\nAuto-routing analysis:\n${result.routingInfo.reasoning}\n\nConfidence: ${Math.round(result.routingInfo.confidence * 100)}%\n\nAlternative agents: ${result.routingInfo.alternativeAgents
+            .map((a) => `${a.emoji} ${a.name}`)
+            .join(", ") || "none"}`
+        : "";
+    return {
+        success: true,
+        content: [
+            {
+                type: "text",
+                text: `Spawned ${result.agentType.emoji} ${result.agentType.name}\n\nID: ${result.agentId}\nTask: ${result.task}\nMax iterations: ${result.maxIterations}${routingText}`,
+            },
+        ],
+        details: {
+            agentId: result.agentId,
+            agentType: result.agentType.id,
+            task: result.task,
+            systemPrompt: result.systemPrompt,
+            maxIterations: result.maxIterations,
+            routingInfo: result.routingInfo,
+        },
+    };
+}
+//# sourceMappingURL=spawn-agent.js.map

package/dist/src/agent/tools/spawn-agent.js.map

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