@compilr-dev/cli 0.5.11 → 0.5.12

package/dist/agent.js

@@ -9,7 +9,7 @@ import { Agent, ContextManager, DEFAULT_CONTEXT_CONFIG, createTaskTool, createSu
 import { isAutoCompactEnabled, isDelegationEnabled, getSetting } from './settings/index.js';
 import { getApiKey } from './utils/credentials.js';
 import { createToolRegistry, createMinimalToolRegistry, getDirectTools, getMetaTools, initializeMetaTools, getToolIndexForSystemPrompt, getFilteredToolIndexForSystemPrompt, getToolStats, setMetaToolFilter, createToolFallback, getRegisteredMetaTools, } from './tools.js';
-import { TOOL_GROUPS } from './multi-agent/tool-config.js';
+import { TOOL_GROUPS } from '@compilr-dev/sdk';
 import { setCapabilityManager } from './multi-agent/capability-loader.js';
 import { getAgentRegistry } from './agents/registry.js';
 import { SystemPromptBuilder } from './system-prompt/index.js';

package/dist/commands-v2/handlers/session.js

@@ -148,7 +148,7 @@ export function saveCurrentTeam(team) {
     // Save shared context
     checkpointer.saveSharedContext(projectId, team.sharedContext);
     // Save artifacts
-    team.artifactStore.save();
+    checkpointer.saveArtifactStore(projectId, team.artifactStore);
 }
 /**
  * Load the team for the current project.
@@ -502,7 +502,7 @@ export async function handleProjectSwitch(oldProjectId, agent, teamOptions, agen
             try {
                 checkpointer.saveTeam(oldProjectId, teamOptions.team);
                 checkpointer.saveSharedContext(oldProjectId, teamOptions.team.sharedContext);
-                teamOptions.team.artifactStore.save();
+                checkpointer.saveArtifactStore(oldProjectId, teamOptions.team.artifactStore);
             }
             catch {
                 // Best effort - continue even if save fails

package/dist/commands-v2/types.d.ts

@@ -6,8 +6,7 @@
  */
 import type { Agent, ContextManager } from '@compilr-dev/sdk';
 import type { TerminalUI, AgentMessage } from '../ui/terminal-ui.js';
-import type { AgentTeam } from '../multi-agent/index.js';
-import type { BackgroundSessionInfo } from '../multi-agent/types.js';
+import type { AgentTeam, BackgroundSessionInfo } from '@compilr-dev/sdk';
 export type { BackgroundSessionInfo };
 /**
  * Context passed to V2 command handlers.

package/dist/multi-agent/capability-loader.js

@@ -5,7 +5,7 @@
  * (set by agent.ts during createAgent()). Provides a high-level function
  * for slash command handlers to load capability packs required by a skill.
  */
-import { SKILL_REQUIREMENTS } from './skill-requirements.js';
+import { SKILL_REQUIREMENTS } from '@compilr-dev/sdk';
 // =============================================================================
 // Module-level state
 // =============================================================================

package/dist/multi-agent/checkpointer.d.ts

@@ -13,10 +13,7 @@
  *     ├── index.json
  *     └── {id}.json
  */
-import type { SerializedTeamAgent, TeamMetadata } from './types.js';
-import { AgentTeam, type AgentTeamConfig } from './team.js';
-import { SharedContextManager } from './shared-context.js';
-import { ArtifactStore } from './artifacts.js';
+import { AgentTeam, ArtifactStore, SharedContextManager, type AgentTeamConfig, type SerializedTeamAgent, type TeamMetadata } from '@compilr-dev/sdk';
 /**
  * TeamCheckpointer handles persistence for multi-agent teams
  */
@@ -107,6 +104,10 @@ export declare class TeamCheckpointer {
      * The ArtifactStore handles its own persistence
      */
     getArtifactStore(projectId: number | null): ArtifactStore;
+    /**
+     * Save an artifact store to disk for a project
+     */
+    saveArtifactStore(projectId: number | null, store: ArtifactStore): void;
     /**
      * Check if artifacts exist for this project
      */

package/dist/multi-agent/checkpointer.js

@@ -15,9 +15,7 @@
  */
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import { AgentTeam } from './team.js';
-import { SharedContextManager } from './shared-context.js';
-import { ArtifactStore } from './artifacts.js';
+import { AgentTeam, ArtifactStore, SharedContextManager, } from '@compilr-dev/sdk';
 import { getActiveTerminalSessionId } from './session-registry.js';
 const ARTIFACTS_DIR = 'artifacts';
 /**
@@ -341,11 +339,33 @@ export class TeamCheckpointer {
      * The ArtifactStore handles its own persistence
      */
     getArtifactStore(projectId) {
+        const store = new ArtifactStore();
         const artifactsPath = this.getArtifactsPath(projectId);
-        const store = new ArtifactStore(artifactsPath);
-        store.load(); // Load existing artifacts
+        const dataFile = path.join(artifactsPath, 'artifacts.json');
+        if (fs.existsSync(dataFile)) {
+            try {
+                const raw = fs.readFileSync(dataFile, 'utf-8');
+                const data = JSON.parse(raw);
+                store.restore(data);
+            }
+            catch {
+                // Corrupted file — start fresh
+            }
+        }
         return store;
     }
+    /**
+     * Save an artifact store to disk for a project
+     */
+    saveArtifactStore(projectId, store) {
+        const artifactsPath = this.getArtifactsPath(projectId);
+        if (!fs.existsSync(artifactsPath)) {
+            fs.mkdirSync(artifactsPath, { recursive: true });
+        }
+        const dataFile = path.join(artifactsPath, 'artifacts.json');
+        const serialized = store.serialize();
+        fs.writeFileSync(dataFile, JSON.stringify(serialized, null, 2));
+    }
     /**
      * Check if artifacts exist for this project
      */

package/dist/multi-agent/custom-agents.d.ts

@@ -1,64 +1,11 @@
 /**
- * Custom Agent Definitions
+ * Custom Agent Definitions - CLI Filesystem Layer
  *
- * Enables users to create custom specialized agents beyond predefined templates.
- * Custom agents have user-defined names, specialties, and personalities.
+ * Pure logic (types, validation, generation) lives in @compilr-dev/sdk.
+ * This file provides CLI-specific filesystem operations for loading/saving.
  */
-import { type ToolConfig, type ToolProfile } from './tool-config.js';
-import type { ModelTier } from '../models/index.js';
-export interface CustomAgentDefinition {
-    id: string;
-    displayName: string;
-    specialty: string;
-    personality?: string;
-    mascot: string;
-    createdAt: string;
-    toolConfig?: ToolConfig;
-    enabledSkills?: string[];
-    modelTier?: ModelTier;
-}
-export type { ToolConfig, ToolProfile };
-/**
- * Mascots available for custom agents.
- * These are distinct from predefined role mascots.
- */
-export declare const CUSTOM_MASCOTS: string[];
-/**
- * Assign a mascot from the available pool.
- * Avoids mascots already in use by other custom agents.
- */
-export declare function assignMascot(existingAgents: CustomAgentDefinition[]): string;
-/**
- * Generate system prompt for a custom agent.
- * Uses a template-based approach (no LLM call).
- * Includes tool awareness if the agent has tool restrictions.
- */
-export declare function generateCustomAgentSystemPrompt(agent: CustomAgentDefinition): string;
-/**
- * Get the tool filter (list of allowed tools) for a custom agent.
- * Returns undefined for full access (no filtering).
- */
-export declare function getCustomAgentToolFilter(agent: CustomAgentDefinition): string[] | undefined;
-/**
- * Get the profile display name for a custom agent.
- */
-export declare function getCustomAgentProfileLabel(agent: CustomAgentDefinition): string;
-/**
- * Validate agent ID format.
- * Must be lowercase letters, numbers, and underscores.
- * Must start with a letter.
- */
-export declare function validateAgentId(id: string): {
-    valid: boolean;
-    error?: string;
-};
-/**
- * Check if agent ID is already in use.
- */
-export declare function isAgentIdTaken(id: string, existingCustomAgents: CustomAgentDefinition[], teamAgentIds: string[], predefinedRoleIds: string[]): {
-    taken: boolean;
-    reason?: string;
-};
+import { type CustomAgentDefinition } from '@compilr-dev/sdk';
+export { type CustomAgentDefinition, type TeamToolConfig as ToolConfig, type ToolProfile, CUSTOM_MASCOTS, assignMascot, generateCustomAgentSystemPrompt, getCustomAgentToolFilter, getCustomAgentProfileLabel, validateAgentId, isAgentIdTaken, createCustomAgentDefinition, } from '@compilr-dev/sdk';
 /**
  * Load custom agents from project directory.
  * Returns empty array if file doesn't exist.
@@ -77,7 +24,3 @@ export declare function addCustomAgent(projectPath: string, agent: CustomAgentDe
  * Remove a custom agent by ID and save.
  */
 export declare function removeCustomAgent(projectPath: string, agentId: string): boolean;
-/**
- * Create a new CustomAgentDefinition with auto-assigned mascot.
- */
-export declare function createCustomAgentDefinition(id: string, displayName: string, specialty: string, personality: string | undefined, existingAgents: CustomAgentDefinition[], toolConfig?: ToolConfig, enabledSkills?: string[], modelTier?: ModelTier): CustomAgentDefinition;

package/dist/multi-agent/custom-agents.js

@@ -1,125 +1,18 @@
 /**
- * Custom Agent Definitions
+ * Custom Agent Definitions - CLI Filesystem Layer
  *
- * Enables users to create custom specialized agents beyond predefined templates.
- * Custom agents have user-defined names, specialties, and personalities.
+ * Pure logic (types, validation, generation) lives in @compilr-dev/sdk.
+ * This file provides CLI-specific filesystem operations for loading/saving.
  */
 import * as fs from 'fs';
 import * as path from 'path';
-import { createDefaultToolConfig, getToolsForProfile, generateToolAwarenessPrompt, PROFILE_INFO, } from './tool-config.js';
-// Current storage version
-const STORAGE_VERSION = 2;
-// =============================================================================
-// Mascot Pool for Custom Agents
-// =============================================================================
-/**
- * Mascots available for custom agents.
- * These are distinct from predefined role mascots.
- */
-export const CUSTOM_MASCOTS = [
-    '[⊡_⊡]', '[⊞_⊞]', '[⊟_⊟]', '[⊠_⊠]',
-    '[⋈_⋈]', '[⋐_⋐]', '[⋑_⋑]', '[⋒_⋒]',
-    '[◌_◌]', '[◍_◍]', '[●_●]', '[◐_◐]',
-    '[◑_◑]', '[◒_◒]', '[◓_◓]', '[◔_◔]',
-];
-/**
- * Assign a mascot from the available pool.
- * Avoids mascots already in use by other custom agents.
- */
-export function assignMascot(existingAgents) {
-    const usedMascots = new Set(existingAgents.map(a => a.mascot));
-    const available = CUSTOM_MASCOTS.filter(m => !usedMascots.has(m));
-    if (available.length > 0) {
-        return available[0];
-    }
-    // Fall back to random selection if all are used
-    return CUSTOM_MASCOTS[Math.floor(Math.random() * CUSTOM_MASCOTS.length)];
-}
-// =============================================================================
-// System Prompt Generation
-// =============================================================================
-/**
- * Generate system prompt for a custom agent.
- * Uses a template-based approach (no LLM call).
- * Includes tool awareness if the agent has tool restrictions.
- */
-export function generateCustomAgentSystemPrompt(agent) {
-    const lines = [
-        `You are a ${agent.displayName} specialized in ${agent.specialty}.`,
-    ];
-    if (agent.personality) {
-        lines.push('');
-        lines.push(`Your approach: ${agent.personality}`);
-    }
-    lines.push('');
-    lines.push('Focus on your area of expertise. When questions fall outside your specialty, suggest which team member might be better suited to help.');
-    // Add tool awareness if agent has tool restrictions
-    const toolConfig = agent.toolConfig ?? createDefaultToolConfig();
-    if (toolConfig.profile !== 'full') {
-        lines.push('');
-        lines.push('---');
-        lines.push('');
-        lines.push(generateToolAwarenessPrompt(toolConfig));
-    }
-    return lines.join('\n');
-}
-/**
- * Get the tool filter (list of allowed tools) for a custom agent.
- * Returns undefined for full access (no filtering).
- */
-export function getCustomAgentToolFilter(agent) {
-    const toolConfig = agent.toolConfig ?? createDefaultToolConfig();
-    return getToolsForProfile(toolConfig.profile, toolConfig.customGroups);
-}
-/**
- * Get the profile display name for a custom agent.
- */
-export function getCustomAgentProfileLabel(agent) {
-    const toolConfig = agent.toolConfig ?? createDefaultToolConfig();
-    const info = PROFILE_INFO[toolConfig.profile];
-    return info.label;
-}
-// =============================================================================
-// Validation
-// =============================================================================
-/**
- * Validate agent ID format.
- * Must be lowercase letters, numbers, and underscores.
- * Must start with a letter.
- */
-export function validateAgentId(id) {
-    if (!id || id.trim() === '') {
-        return { valid: false, error: 'Agent ID is required' };
-    }
-    if (id.length > 20) {
-        return { valid: false, error: 'Agent ID must be 20 characters or less' };
-    }
-    if (!/^[a-z][a-z0-9_]*$/.test(id)) {
-        return { valid: false, error: 'Must be lowercase letters, numbers, underscore (start with letter)' };
-    }
-    return { valid: true };
-}
-/**
- * Check if agent ID is already in use.
- */
-export function isAgentIdTaken(id, existingCustomAgents, teamAgentIds, predefinedRoleIds) {
-    // Check predefined roles
-    if (predefinedRoleIds.includes(id)) {
-        return { taken: true, reason: `"${id}" is a predefined role` };
-    }
-    // Check team agents
-    if (teamAgentIds.includes(id)) {
-        return { taken: true, reason: `"${id}" is already in your team` };
-    }
-    // Check custom agents
-    if (existingCustomAgents.some(a => a.id === id)) {
-        return { taken: true, reason: `"${id}" already exists as a custom agent` };
-    }
-    return { taken: false };
-}
+import { createDefaultToolConfig, } from '@compilr-dev/sdk';
 // =============================================================================
-// Storage
+// Re-exports from SDK (for backward compatibility)
 // =============================================================================
+export { CUSTOM_MASCOTS, assignMascot, generateCustomAgentSystemPrompt, getCustomAgentToolFilter, getCustomAgentProfileLabel, validateAgentId, isAgentIdTaken, createCustomAgentDefinition, } from '@compilr-dev/sdk';
+// Current storage version
+const STORAGE_VERSION = 2;
 const CUSTOM_AGENTS_FILENAME = 'custom-agents.json';
 const COMPILR_DIR = '.compilr';
 /**
@@ -139,13 +32,12 @@ function ensureCompilrDir(projectPath) {
 }
 /**
  * Migrate a v1 agent to v2 format.
- * Adds default toolConfig (full access) and empty enabledSkills.
  */
 function migrateAgentV1toV2(agent) {
     return {
         ...agent,
         toolConfig: agent.toolConfig ?? createDefaultToolConfig(),
-        enabledSkills: agent.enabledSkills ?? [], // Empty = all skills
+        enabledSkills: agent.enabledSkills ?? [],
     };
 }
 /**
@@ -165,14 +57,12 @@ export function loadCustomAgents(projectPath) {
         // Migrate v1 agents to v2 format if needed
         if (data.version < STORAGE_VERSION) {
             const migratedAgents = agents.map(migrateAgentV1toV2);
-            // Save migrated agents
             saveCustomAgents(projectPath, migratedAgents);
             return migratedAgents;
         }
         return agents;
     }
     catch {
-        // If file is corrupted, return empty array
         return [];
     }
 }
@@ -201,7 +91,7 @@ export function addCustomAgent(projectPath, agent) {
  */
 export function removeCustomAgent(projectPath, agentId) {
     const agents = loadCustomAgents(projectPath);
-    const index = agents.findIndex(a => a.id === agentId);
+    const index = agents.findIndex((a) => a.id === agentId);
     if (index === -1) {
         return false;
     }
@@ -209,19 +99,3 @@ export function removeCustomAgent(projectPath, agentId) {
     saveCustomAgents(projectPath, agents);
     return true;
 }
-/**
- * Create a new CustomAgentDefinition with auto-assigned mascot.
- */
-export function createCustomAgentDefinition(id, displayName, specialty, personality, existingAgents, toolConfig, enabledSkills, modelTier) {
-    return {
-        id,
-        displayName,
-        specialty,
-        personality: personality || undefined,
-        mascot: assignMascot(existingAgents),
-        createdAt: new Date().toISOString(),
-        toolConfig: toolConfig ?? createDefaultToolConfig(),
-        enabledSkills: enabledSkills ?? [], // Empty = all skills
-        modelTier: modelTier ?? 'balanced', // Default tier
-    };
-}

package/dist/multi-agent/delegation-tracker.d.ts

@@ -1,152 +1,11 @@
 /**
- * Delegation Tracker (Phase 3d-beta - Coordinator Mode)
+ * Delegation Tracker - CLI Singleton Wrapper
  *
- * Tracks active delegations from the coordinator to background specialists.
- * Maintains a completion event queue so the coordinator can be notified
- * when specialists finish their work.
- *
- * Pattern follows PendingRequestsManager (singleton, event-based).
+ * The DelegationTracker class lives in @compilr-dev/sdk.
+ * This file provides CLI-specific singleton access.
  */
-import { EventEmitter } from 'events';
-export type DelegationStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
-export interface Delegation {
-    /** Unique delegation ID (del_<uuid>) */
-    id: string;
-    /** Agent that initiated the delegation (always 'default' for now) */
-    coordinatorId: string;
-    /** Target specialist agent ID (e.g., 'arch', 'dev', 'qa') */
-    targetAgentId: string;
-    /** Task description sent to the specialist */
-    task: string;
-    /** What the specialist is expected to produce */
-    expectedOutput?: string;
-    /** Associated todo index (if any) */
-    todoIndex?: number;
-    /** Current status */
-    status: DelegationStatus;
-    /** Result (set on completion or failure) */
-    result?: DelegationResult;
-    /** When the delegation was created */
-    createdAt: Date;
-    /** When the delegation completed */
-    completedAt?: Date;
-}
-export interface DelegationResult {
-    /** Whether the task completed successfully */
-    success: boolean;
-    /** Brief outcome summary */
-    summary: string;
-    /** Artifact IDs created by the specialist */
-    artifactIds: string[];
-    /** Error message (if failed) */
-    error?: string;
-}
-export interface CompletionEvent {
-    /** The delegation ID */
-    delegationId: string;
-    /** The specialist that completed the work */
-    agentId: string;
-    /** Completion status */
-    status: 'completed' | 'failed';
-    /** Result details */
-    result: DelegationResult;
-    /** When the event was generated */
-    timestamp: Date;
-}
-export interface CreateDelegationOptions {
-    /** Agent that initiated the delegation */
-    coordinatorId: string;
-    /** Target specialist agent ID */
-    targetAgentId: string;
-    /** Task description */
-    task: string;
-    /** Expected output description */
-    expectedOutput?: string;
-    /** Associated todo index */
-    todoIndex?: number;
-}
-export interface DelegationStats {
-    total: number;
-    pending: number;
-    running: number;
-    completed: number;
-    failed: number;
-    cancelled: number;
-}
-export interface DelegationTrackerEvents {
-    /** Emitted when a new delegation is created */
-    'delegation-created': (delegation: Delegation) => void;
-    /** Emitted when a delegation completes successfully */
-    'delegation-completed': (event: CompletionEvent) => void;
-    /** Emitted when a delegation fails */
-    'delegation-failed': (event: CompletionEvent) => void;
-    /** Emitted when delegation counts change */
-    'count-changed': (stats: DelegationStats) => void;
-}
-export declare class DelegationTracker extends EventEmitter {
-    private readonly delegations;
-    private readonly completionQueue;
-    /**
-     * Create a new delegation.
-     */
-    create(options: CreateDelegationOptions): Delegation;
-    /**
-     * Update a delegation's status.
-     */
-    updateStatus(id: string, status: DelegationStatus): void;
-    /**
-     * Mark a delegation as completed with a result.
-     */
-    complete(id: string, result: DelegationResult): void;
-    /**
-     * Mark a delegation as failed.
-     */
-    fail(id: string, error: string): void;
-    /**
-     * Mark a delegation as cancelled.
-     */
-    cancel(id: string): void;
-    /**
-     * Cancel all active delegations for a specific agent.
-     */
-    cancelAllForAgent(agentId: string): number;
-    /**
-     * Get a delegation by ID.
-     */
-    get(id: string): Delegation | undefined;
-    /**
-     * Get all delegations targeting a specific agent.
-     */
-    getByAgent(agentId: string): Delegation[];
-    /**
-     * Get all active (pending or running) delegations.
-     */
-    getActive(): Delegation[];
-    /**
-     * Get all delegations.
-     */
-    getAll(): Delegation[];
-    /**
-     * Check if there are pending completion events.
-     */
-    hasCompletionEvents(): boolean;
-    /**
-     * Drain all completion events (removes them from queue).
-     */
-    drainCompletionEvents(): CompletionEvent[];
-    /**
-     * Peek at completion events without removing them.
-     */
-    peekCompletionEvents(): CompletionEvent[];
-    /**
-     * Get delegation statistics.
-     */
-    getStats(): DelegationStats;
-    /**
-     * Clear all delegations and completion events.
-     */
-    clear(): void;
-}
+export { DelegationTracker, type Delegation, type DelegationStatus, type DelegationResult, type CompletionEvent, type CreateDelegationOptions, type DelegationStats, type DelegationTrackerEvents, } from '@compilr-dev/sdk';
+import { DelegationTracker } from '@compilr-dev/sdk';
 /**
  * Get the singleton DelegationTracker instance.
  */