verbolab 0.1.0-alpha.1

package/dist/src/intelligence/task-decomposer.js

@@ -0,0 +1,97 @@
+import Anthropic from '@anthropic-ai/sdk';
+import { scanProject } from './project-scanner.js';
+import { isIntelligenceEnabled } from './kill-switch.js';
+// ---- Constants ----
+const MIN_WORDS = 50;
+const MODEL = 'claude-haiku-4-5-20251001';
+const MAX_TOKENS = 1024;
+const SYSTEM_PROMPT = `You are a software task decomposer. Given a task description and project structure, break the task into concrete subtasks.
+
+Return a JSON array with this exact structure (no markdown, no code fences, just the raw JSON array):
+[
+  {
+    "title": "string",
+    "description": "string",
+    "estimatedFiles": ["string"],
+    "dependsOnIndexes": [number],
+    "personaHint": "string"
+  }
+]
+
+Rules:
+- dependsOnIndexes: 0-based indexes of subtasks this one depends on (empty array if none)
+- estimatedFiles: file paths likely to be created or modified
+- personaHint: short label for the ideal engineer (e.g. "frontend", "backend", "devops", "fullstack")
+- Return only the JSON array, nothing else`;
+// ---- Factory ----
+export function createTaskDecomposer(taskStore, apiKey) {
+    const key = apiKey ?? process.env.ANTHROPIC_API_KEY;
+    const client = key ? new Anthropic({ apiKey: key }) : null;
+    async function decompose(input) {
+        if (!isIntelligenceEnabled())
+            return null;
+        const wordCount = input.trim().split(/\s+/).filter(Boolean).length;
+        if (wordCount < MIN_WORDS)
+            return null;
+        if (!client)
+            return null;
+        const projectDirs = scanProject();
+        try {
+            const response = await client.messages.create({
+                model: MODEL,
+                max_tokens: MAX_TOKENS,
+                system: SYSTEM_PROMPT,
+                messages: [
+                    {
+                        role: 'user',
+                        content: `Project top-level directories: ${projectDirs || '(unknown)'}
+
+Task to decompose:
+${input}`,
+                    },
+                ],
+            });
+            const text = response.content[0].type === 'text' ? response.content[0].text.trim() : '';
+            const parsed = JSON.parse(text);
+            if (!Array.isArray(parsed))
+                return null;
+            return parsed.map((item) => ({
+                title: String(item.title ?? ''),
+                description: String(item.description ?? ''),
+                estimatedFiles: Array.isArray(item.estimatedFiles)
+                    ? item.estimatedFiles.map(String)
+                    : [],
+                dependsOnIndexes: Array.isArray(item.dependsOnIndexes)
+                    ? item.dependsOnIndexes.map(Number).filter(Number.isFinite)
+                    : [],
+                personaHint: String(item.personaHint ?? ''),
+            }));
+        }
+        catch {
+            return null;
+        }
+    }
+    async function confirm(result, parentTaskId) {
+        const createdTasks = [];
+        for (const subtask of result) {
+            const dependencies = subtask.dependsOnIndexes
+                .filter((idx) => idx >= 0 && idx < createdTasks.length)
+                .map((idx) => createdTasks[idx].id);
+            if (parentTaskId) {
+                dependencies.push(parentTaskId);
+            }
+            const input = {
+                title: subtask.title,
+                description: subtask.description,
+                filePaths: subtask.estimatedFiles,
+                dependencies,
+                labels: subtask.personaHint ? [subtask.personaHint] : [],
+            };
+            const task = taskStore.create(input);
+            createdTasks.push(task);
+        }
+        return createdTasks;
+    }
+    return { decompose, confirm };
+}
+//# sourceMappingURL=task-decomposer.js.map

package/dist/src/intelligence/task-decomposer.js.map

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

package/dist/src/intelligence/types.d.ts

@@ -0,0 +1,14 @@
+export interface IntelligenceConfig {
+    model: string;
+    maxTokens: number;
+    temperature?: number;
+    systemPrompt?: string;
+}
+export interface ClaudeCallMetrics {
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    durationMs: number;
+    timestamp: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/intelligence/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/intelligence/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/src/intelligence/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/intelligence/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/intelligence/types.ts"],"names":[],"mappings":""}

package/dist/src/mcp/server.d.ts

@@ -0,0 +1,63 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { TaskStore, Task } from '../core/task-store.js';
+import type { AgentSessionStore } from '../core/agent-session-store.js';
+import type { ConflictDetector } from '../core/conflict-detector.js';
+import type { HumanActionStore } from '../core/human-action-store.js';
+import type { OrchestratorStore } from '../core/orchestrator-store.js';
+import type { RbacChecker } from '../core/rbac.js';
+import type { AuditLogStore } from '../core/audit-log-store.js';
+import type { CostStore } from '../core/cost-store.js';
+import type { ConflictMediator } from '../intelligence/conflict-mediator.js';
+import type { SkillRegistry } from '../skills/registry.js';
+import type { TaskClassifier } from '../skills/classifier.js';
+/**
+ * Validates that file paths are relative and do not escape the project root.
+ * Rejects absolute paths and paths containing ".." traversal segments.
+ */
+export declare function validateFilePaths(filePaths: string[]): void;
+export interface ConflictDetectedEvent {
+    laterTaskId: string;
+    laterSessionId: string;
+    earlierTaskId: string;
+    file: string;
+}
+export interface McpServerDeps {
+    tasks: TaskStore;
+    sessions: AgentSessionStore;
+    detector: ConflictDetector;
+    humanActions: HumanActionStore;
+    humanId: string;
+    /** RBAC checks are enforced on every tool call. */
+    rbac: RbacChecker;
+    /** If set, complete_task will trigger review + push via the GitHub orchestrator. */
+    projectDir?: string;
+    orchestratorStore?: OrchestratorStore;
+    /** Called when report_files detects a file conflict. The later agent should be killed. */
+    onConflictDetected?: (event: ConflictDetectedEvent) => void;
+    /** Optional: attempt auto-merge before firing onConflictDetected. */
+    mediator?: ConflictMediator;
+    /** Called when report_files auto-merged a conflict instead of killing the agent. */
+    onAutoMerged?: (file: string) => void;
+    /** If set, token usage and cost are recorded per pipeline run. */
+    costStore?: CostStore;
+    /** Groups all cost ledger entries for this server instance. Required when costStore is set. */
+    pipelineRunId?: string;
+    /** Hard cap in USD for this pipeline run. update_progress returns { paused: true } when exceeded. */
+    budgetPerTaskUsd?: number;
+    /** If set, all tool invocations are recorded to the audit log before execution. */
+    auditLog?: AuditLogStore;
+    /**
+     * Called when an agent invokes spawn_subtask. Receives the newly-created subtask so the
+     * orchestrator can immediately launch an agent for it (rather than waiting for factory mode).
+     */
+    onSpawnSubtask?: (subtask: Task) => Promise<void>;
+    skillRegistry?: SkillRegistry;
+    skillClassifier?: TaskClassifier;
+}
+export declare function createVerboMcpServer(deps: McpServerDeps): {
+    getToolNames: () => string[];
+    callTool: (name: string, args: unknown) => Promise<unknown>;
+    createMcpServer: () => McpServer;
+    startStdio: () => Promise<void>;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/src/mcp/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/mcp/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAGvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAI7E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAI9D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAW3D;AAID,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,IAAI,EAAE,WAAW,CAAC;IAClB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,0FAA0F;IAC1F,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC5D,qEAAqE;IACrE,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,oFAAoF;IACpF,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,kEAAkE;IAClE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,+FAA+F;IAC/F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qGAAqG;IACrG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mFAAmF;IACnF,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,eAAe,CAAC,EAAE,cAAc,CAAC;CAClC;AAID,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa;wBAsb7B,MAAM,EAAE;qBAIH,MAAM,QAAQ,OAAO,KAAG,OAAO,CAAC,OAAO,CAAC;2BAI1C,SAAS;sBA+RR,OAAO,CAAC,IAAI,CAAC;EAY3C"}