jiva-core 0.2.2 → 0.3.1

package/cloud-run.yaml

@@ -0,0 +1,135 @@
+# Cloud Run service configuration for Jiva
+# Deploy with: gcloud run services replace cloud-run.yaml
+
+apiVersion: serving.knative.dev/v1
+kind: Service
+metadata:
+  name: jiva
+  labels:
+    app: jiva
+    environment: production
+spec:
+  template:
+    metadata:
+      annotations:
+        # Launch stage for beta features
+        run.googleapis.com/launch-stage: "BETA"
+        
+        # Scale to zero when idle
+        autoscaling.knative.dev/minScale: "0"
+        autoscaling.knative.dev/maxScale: "10"
+        
+        # CPU allocation - always allocated since we need WebSocket support
+        run.googleapis.com/cpu-throttling: "false"
+        
+        # Startup probe for slow initialization
+        run.googleapis.com/startup-cpu-boost: "true"
+        
+        # Container execution environment
+        run.googleapis.com/execution-environment: gen2
+        
+        # Session affinity for WebSocket connections
+        run.googleapis.com/session-affinity: "true"
+    spec:
+      # Timeout for long-running WebSocket sessions
+      timeoutSeconds: 3600  # 60 minutes
+      
+      # Container concurrency (WebSocket connections per instance)
+      containerConcurrency: 80
+      
+      serviceAccountName: jiva-cloud-run@PROJECT_ID.iam.gserviceaccount.com
+      
+      containers:
+      - name: jiva
+        image: gcr.io/PROJECT_ID/jiva:latest
+        
+        ports:
+        - name: http1
+          containerPort: 8080
+        
+        env:
+        # Node environment
+        - name: NODE_ENV
+          value: "production"
+        
+        # Server configuration
+        - name: LOG_LEVEL
+          value: "info"
+        
+        # Storage configuration
+        - name: JIVA_STORAGE_PROVIDER
+          value: "gcp"
+        - name: JIVA_GCP_BUCKET
+          value: "jiva-state-BUCKET_NAME"
+        - name: JIVA_GCP_PROJECT
+          value: "PROJECT_ID"
+        
+        # Session configuration
+        - name: MAX_CONCURRENT_SESSIONS
+          value: "100"
+        - name: SESSION_IDLE_TIMEOUT_MS
+          value: "1800000"  # 30 minutes
+        
+        # Authentication
+        - name: AUTH_STRATEGY
+          value: "firebase"  # or "custom"
+        - name: AUTH_DISABLED
+          value: "true"  # Set to false for production
+        
+        # Model configuration (from Secret Manager)
+        - name: JIVA_MODEL_PROVIDER
+          value: "krutrim"
+        - name: JIVA_MODEL_API_KEY
+          valueFrom:
+            secretKeyRef:
+              name: jiva-model-api-key
+              key: latest
+        - name: JIVA_MODEL_BASE_URL
+          value: "https://cloud.olakrutrim.com/v1/chat/completions"
+        - name: JIVA_MODEL_NAME
+          value: "gpt-oss-120b"
+        
+        # MCP Server Configuration
+        - name: ENABLE_MCP_SERVERS
+          value: "true"
+        - name: MCP_FILESYSTEM_ENABLED
+          value: "true"
+        - name: MCP_FILESYSTEM_ALLOWED_PATHS
+          value: "/tmp,/workspace"
+        
+        # CORS allowed origins
+        - name: ALLOWED_ORIGINS
+          value: "https://yourdomain.com,https://app.yourdomain.com"
+        
+        resources:
+          limits:
+            # CPU: 2 vCPU for handling concurrent sessions
+            cpu: "2000m"
+            # Memory: 4GB for model inference and session state
+            memory: "4Gi"
+          requests:
+            cpu: "1000m"
+            memory: "2Gi"
+        
+        # Health probes
+        startupProbe:
+          httpGet:
+            path: /startup
+            port: 8080
+          initialDelaySeconds: 0
+          periodSeconds: 10
+          timeoutSeconds: 5
+          failureThreshold: 3
+        
+        livenessProbe:
+          httpGet:
+            path: /health
+            port: 8080
+          initialDelaySeconds: 0
+          periodSeconds: 10
+          timeoutSeconds: 5
+          failureThreshold: 3
+
+  traffic:
+  - percent: 100
+    latestRevision: true

package/cloud-run.yaml.template

@@ -0,0 +1,143 @@
+# Cloud Run service configuration for Jiva
+# Deploy with: gcloud run services replace cloud-run.yaml
+
+apiVersion: serving.knative.dev/v1
+kind: Service
+metadata:
+  name: jiva
+  labels:
+    app: jiva
+    environment: production
+spec:
+  template:
+    metadata:
+      annotations:
+        # Scale to zero when idle
+        autoscaling.knative.dev/minScale: "0"
+        autoscaling.knative.dev/maxScale: "10"
+        
+        # CPU allocation - always allocated since we need WebSocket support
+        run.googleapis.com/cpu-throttling: "false"
+        
+        # Startup probe for slow initialization
+        run.googleapis.com/startup-cpu-boost: "true"
+        
+        # Container execution environment
+        run.googleapis.com/execution-environment: gen2
+        
+        # Session affinity for WebSocket connections
+        run.googleapis.com/session-affinity: "true"
+    spec:
+      # Timeout for long-running WebSocket sessions
+      timeoutSeconds: 3600  # 60 minutes
+      
+      # Container concurrency (WebSocket connections per instance)
+      containerConcurrency: 80
+      
+      serviceAccountName: jiva-cloud-run@PROJECT_ID.iam.gserviceaccount.com
+      
+      containers:
+      - name: jiva
+        image: gcr.io/PROJECT_ID/jiva:latest
+        
+        ports:
+        - name: http1
+          containerPort: 8080
+        
+        env:
+        # Node environment
+        - name: NODE_ENV
+          value: "production"
+        
+        # Server configuration
+        - name: PORT
+          value: "8080"
+        - name: LOG_LEVEL
+          value: "info"
+        
+        # Storage configuration
+        - name: JIVA_STORAGE_PROVIDER
+          value: "gcp"
+        - name: JIVA_GCP_BUCKET
+          value: "jiva-state-BUCKET_NAME"
+        - name: JIVA_GCP_PROJECT
+          value: "PROJECT_ID"
+        
+        # Session configuration
+        - name: MAX_CONCURRENT_SESSIONS
+          value: "100"
+        - name: SESSION_IDLE_TIMEOUT_MS
+          value: "1800000"  # 30 minutes
+        
+        # Authentication
+        - name: AUTH_STRATEGY
+          value: "firebase"  # or "custom"
+        - name: AUTH_DISABLED
+          value: "false"
+        
+        # Model configuration (from Secret Manager)
+        - name: JIVA_MODEL_PROVIDER
+          value: "krutrim"
+        - name: JIVA_MODEL_API_KEY
+          valueFrom:
+            secretKeyRef:
+              name: jiva-model-api-key
+              key: latest
+        - name: JIVA_MODEL_BASE_URL
+          value: "https://cloud.olakrutrim.com/v1/chat/completions"
+        - name: JIVA_MODEL_NAME
+          value: "gpt-oss-120b"
+        
+        # MCP Server Configuration
+        - name: ENABLE_MCP_SERVERS
+          value: "true"
+        - name: MCP_FILESYSTEM_ENABLED
+          value: "true"
+        - name: MCP_FILESYSTEM_ALLOWED_PATHS
+          value: "/tmp,/workspace"
+        
+        # CORS allowed origins
+        - name: ALLOWED_ORIGINS
+          value: "https://yourdomain.com,https://app.yourdomain.com"
+        
+        resources:
+          limits:
+            # CPU: 2 vCPU for handling concurrent sessions
+            cpu: "2000m"
+            # Memory: 4GB for model inference and session state
+            memory: "4Gi"
+          requests:
+            cpu: "1000m"
+            memory: "2Gi"
+        
+        # Health probes
+        startupProbe:
+          httpGet:
+            path: /startup
+            port: 8080
+          initialDelaySeconds: 0
+          periodSeconds: 10
+          timeoutSeconds: 5
+          failureThreshold: 3
+        
+        livenessProbe:
+          httpGet:
+            path: /health
+            port: 8080
+          initialDelaySeconds: 0
+          periodSeconds: 10
+          timeoutSeconds: 5
+          failureThreshold: 3
+        
+        readinessProbe:
+          httpGet:
+            path: /ready
+            port: 8080
+          initialDelaySeconds: 0
+          periodSeconds: 5
+          timeoutSeconds: 3
+          failureThreshold: 2
+
+  traffic:
+  - percent: 100
+    latestRevision: true

package/deploy.sh

@@ -0,0 +1,107 @@
+#!/bin/bash
+# Deploy Jiva to Cloud Run
+# Usage: ./deploy.sh [PROJECT_ID] [REGION]
+
+set -e
+
+PROJECT_ID="${1:-your-project-id}"
+REGION="${2:-us-central1}"
+SERVICE_NAME="jiva"
+IMAGE_NAME="gcr.io/$PROJECT_ID/jiva"
+BUCKET_NAME="jiva-state-$PROJECT_ID"
+
+echo "🚀 Deploying Jiva to Cloud Run"
+echo "Project: $PROJECT_ID"
+echo "Region: $REGION"
+echo "Service: $SERVICE_NAME"
+echo ""
+
+# Check if gcloud is installed
+if ! command -v gcloud &> /dev/null; then
+    echo "❌ gcloud CLI not found. Please install it first."
+    exit 1
+fi
+
+# Set project
+echo "📦 Setting GCP project..."
+gcloud config set project $PROJECT_ID
+
+# Enable required APIs
+echo "🔧 Enabling required APIs..."
+gcloud services enable \
+    cloudbuild.googleapis.com \
+    run.googleapis.com \
+    storage.googleapis.com \
+    secretmanager.googleapis.com \
+    --quiet
+
+# Create GCS bucket if it doesn't exist
+echo "🪣 Creating GCS bucket (if not exists)..."
+gsutil mb -p $PROJECT_ID -c STANDARD -l $REGION gs://$BUCKET_NAME 2>/dev/null || echo "Bucket already exists"
+
+# Create service account if it doesn't exist
+echo "👤 Creating service account (if not exists)..."
+gcloud iam service-accounts create jiva-cloud-run \
+    --display-name="Jiva Cloud Run Service Account" \
+    --quiet 2>/dev/null || echo "Service account already exists"
+
+# Grant permissions
+echo "🔐 Granting permissions..."
+gcloud projects add-iam-policy-binding $PROJECT_ID \
+    --member="serviceAccount:jiva-cloud-run@$PROJECT_ID.iam.gserviceaccount.com" \
+    --role="roles/storage.objectAdmin" \
+    --quiet
+
+gcloud projects add-iam-policy-binding $PROJECT_ID \
+    --member="serviceAccount:jiva-cloud-run@$PROJECT_ID.iam.gserviceaccount.com" \
+    --role="roles/secretmanager.secretAccessor" \
+    --quiet
+
+# Create secret for model API key if it doesn't exist
+echo "🔑 Checking model API key secret..."
+if ! gcloud secrets describe jiva-model-api-key --quiet 2>/dev/null; then
+    echo "Please enter your model API key:"
+    read -s API_KEY
+    echo -n "$API_KEY" | gcloud secrets create jiva-model-api-key \
+        --data-file=- \
+        --replication-policy="automatic" \
+        --quiet
+    echo "✅ Secret created"
+else
+    echo "✅ Secret already exists"
+fi
+
+# Build container image
+echo "🏗️  Building container image..."
+gcloud builds submit --tag $IMAGE_NAME:latest --quiet
+
+# Update cloud-run.yaml with project-specific values
+echo "📝 Updating configuration..."
+sed -i.bak "s/PROJECT_ID/$PROJECT_ID/g" cloud-run.yaml
+sed -i.bak "s/BUCKET_NAME/$PROJECT_ID/g" cloud-run.yaml
+
+# Deploy to Cloud Run
+echo "🚢 Deploying to Cloud Run..."
+gcloud run services replace cloud-run.yaml \
+    --region=$REGION \
+    --quiet
+
+# Restore original cloud-run.yaml
+mv cloud-run.yaml.bak cloud-run.yaml
+
+# Get service URL
+SERVICE_URL=$(gcloud run services describe $SERVICE_NAME --region=$REGION --format='value(status.url)')
+
+echo ""
+echo "✅ Deployment complete!"
+echo "🌐 Service URL: $SERVICE_URL"
+echo ""
+echo "Test the service:"
+echo "  Health: curl $SERVICE_URL/health"
+echo "  WebSocket: ws://${SERVICE_URL#https://}/ws?token=YOUR_TOKEN"
+echo ""
+echo "To make the service public (optional):"
+echo "  gcloud run services add-iam-policy-binding $SERVICE_NAME \\"
+echo "    --region=$REGION \\"
+echo "   --member=\"allUsers\" \\"
+echo "    --role=\"roles/run.invoker\""

package/dist/core/agent-spawner.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Agent Spawner - Manages hierarchical sub-agent spawning with personas
+ *
+ * Enables a parent agent to spawn child agents with specific personas,
+ * creating a multi-agent collaboration system for complex tasks.
+ *
+ * Example: An "engineering-manager" persona can spawn:
+ * - "code-reviewer" agent to review code
+ * - "developer" agent to implement features
+ * - "tester" agent to write tests
+ */
+import { DualAgent } from './dual-agent.js';
+import { ModelOrchestrator } from '../models/orchestrator.js';
+import { MCPServerManager } from '../mcp/server-manager.js';
+import { WorkspaceManager } from './workspace.js';
+import { ConversationManager } from './conversation-manager.js';
+import { PersonaManager } from '../personas/persona-manager.js';
+export interface SpawnedAgent {
+    id: string;
+    persona: string;
+    agent: DualAgent;
+    parentId?: string;
+    createdAt: Date;
+    messageCount: number;
+    status: 'active' | 'completed' | 'failed';
+    result?: string;
+}
+export interface SpawnAgentRequest {
+    persona: string;
+    task: string;
+    context?: string;
+    maxIterations?: number;
+}
+export interface SpawnAgentResponse {
+    agentId: string;
+    persona: string;
+    result: string;
+    iterations: number;
+    toolsUsed: string[];
+}
+export declare class AgentSpawner {
+    private agents;
+    private orchestrator;
+    private mcpManager;
+    private workspace;
+    private conversationManager;
+    private basePersonaManager;
+    private parentAgentId?;
+    private maxDepth;
+    private currentDepth;
+    constructor(orchestrator: ModelOrchestrator, mcpManager: MCPServerManager, workspace: WorkspaceManager, conversationManager: ConversationManager | null, basePersonaManager: PersonaManager, options?: {
+        parentAgentId?: string;
+        maxDepth?: number;
+        currentDepth?: number;
+    });
+    /**
+     * Check if agent spawning is allowed at current depth
+     */
+    canSpawnMore(): boolean;
+    /**
+     * Get current depth level
+     */
+    getCurrentDepth(): number;
+    /**
+     * Get maximum depth
+     */
+    getMaxDepth(): number;
+    /**
+     * Spawn a sub-agent with a specific persona
+     */
+    spawnAgent(request: SpawnAgentRequest): Promise<SpawnAgentResponse>;
+    /**
+     * Get information about a spawned agent
+     */
+    getAgent(agentId: string): SpawnedAgent | undefined;
+    /**
+     * List all spawned agents
+     */
+    listAgents(): SpawnedAgent[];
+    /**
+     * Get available personas that can be spawned
+     */
+    getAvailablePersonas(): string[];
+    /**
+     * Cleanup all spawned agents
+     */
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=agent-spawner.d.ts.map

package/dist/core/agent-spawner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-spawner.d.ts","sourceRoot":"","sources":["../../src/core/agent-spawner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAmB,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAGhE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,mBAAmB,CAA6B;IACxD,OAAO,CAAC,kBAAkB,CAAiB;IAC3C,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;gBAG3B,YAAY,EAAE,iBAAiB,EAC/B,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,gBAAgB,EAC3B,mBAAmB,EAAE,mBAAmB,GAAG,IAAI,EAC/C,kBAAkB,EAAE,cAAc,EAClC,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB;IAYH;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA8IzE;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAInD;;OAEG;IACH,UAAU,IAAI,YAAY,EAAE;IAI5B;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAIhC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAU/B"}

package/dist/core/agent-spawner.js

@@ -0,0 +1,195 @@
+/**
+ * Agent Spawner - Manages hierarchical sub-agent spawning with personas
+ *
+ * Enables a parent agent to spawn child agents with specific personas,
+ * creating a multi-agent collaboration system for complex tasks.
+ *
+ * Example: An "engineering-manager" persona can spawn:
+ * - "code-reviewer" agent to review code
+ * - "developer" agent to implement features
+ * - "tester" agent to write tests
+ */
+import { DualAgent } from './dual-agent.js';
+import { PersonaManager } from '../personas/persona-manager.js';
+import { logger } from '../utils/logger.js';
+export class AgentSpawner {
+    agents = new Map();
+    orchestrator;
+    mcpManager;
+    workspace;
+    conversationManager;
+    basePersonaManager;
+    parentAgentId;
+    maxDepth;
+    currentDepth;
+    constructor(orchestrator, mcpManager, workspace, conversationManager, basePersonaManager, options) {
+        this.orchestrator = orchestrator;
+        this.mcpManager = mcpManager;
+        this.workspace = workspace;
+        this.conversationManager = conversationManager;
+        this.basePersonaManager = basePersonaManager;
+        this.parentAgentId = options?.parentAgentId;
+        this.maxDepth = options?.maxDepth || 1; // Default: only top-level can spawn
+        this.currentDepth = options?.currentDepth || 0;
+    }
+    /**
+     * Check if agent spawning is allowed at current depth
+     */
+    canSpawnMore() {
+        return this.currentDepth < this.maxDepth;
+    }
+    /**
+     * Get current depth level
+     */
+    getCurrentDepth() {
+        return this.currentDepth;
+    }
+    /**
+     * Get maximum depth
+     */
+    getMaxDepth() {
+        return this.maxDepth;
+    }
+    /**
+     * Spawn a sub-agent with a specific persona
+     */
+    async spawnAgent(request) {
+        // Check depth limit
+        if (this.currentDepth >= this.maxDepth) {
+            throw new Error(`Maximum agent depth (${this.maxDepth}) reached. Cannot spawn more sub-agents.`);
+        }
+        // Ensure PersonaManager is initialized
+        if (this.basePersonaManager.getPersonas().length === 0) {
+            logger.info('[AgentSpawner] PersonaManager not initialized, initializing now...');
+            await this.basePersonaManager.initialize();
+        }
+        // Validate persona exists
+        const availablePersonas = this.basePersonaManager.getPersonas();
+        if (availablePersonas.length === 0) {
+            throw new Error(`No personas available. Please install personas in ~/.jiva/personas/ or activate one with 'jiva persona activate <name>'`);
+        }
+        const personaExists = availablePersonas.some((p) => p.manifest.name === request.persona);
+        if (!personaExists) {
+            throw new Error(`Persona '${request.persona}' not found. Available personas: ${availablePersonas.map((p) => p.manifest.name).join(', ')}`);
+        }
+        const agentId = `agent-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+        logger.info(`[AgentSpawner] Spawning sub-agent with persona: ${request.persona}`);
+        logger.info(`[AgentSpawner] Task: ${request.task}`);
+        logger.info(`[AgentSpawner] Depth: ${this.currentDepth + 1}/${this.maxDepth}`);
+        try {
+            // Create a new PersonaManager for the sub-agent
+            const subPersonaManager = new PersonaManager();
+            await subPersonaManager.initialize();
+            // Activate the requested persona
+            await subPersonaManager.activatePersona(request.persona);
+            logger.success(`[AgentSpawner] Activated persona: ${request.persona}`);
+            // Merge persona MCP servers
+            const personaMCPServers = subPersonaManager.getPersonaMCPServers();
+            if (Object.keys(personaMCPServers).length > 0) {
+                logger.info(`[AgentSpawner] Loading ${Object.keys(personaMCPServers).length} MCP servers from persona`);
+                for (const [name, config] of Object.entries(personaMCPServers)) {
+                    try {
+                        await this.mcpManager.addServer(name, config);
+                    }
+                    catch (error) {
+                        // Server might already exist from parent, that's ok
+                        logger.debug(`[AgentSpawner] MCP server '${name}' already exists or failed to add`);
+                    }
+                }
+            }
+            // Create sub-agent with persona and nested spawner
+            const subSpawner = new AgentSpawner(this.orchestrator, this.mcpManager, this.workspace, this.conversationManager, this.basePersonaManager, {
+                parentAgentId: agentId,
+                maxDepth: this.maxDepth,
+                currentDepth: this.currentDepth + 1,
+            });
+            const subAgentConfig = {
+                orchestrator: this.orchestrator,
+                mcpManager: this.mcpManager,
+                workspace: this.workspace,
+                conversationManager: this.conversationManager || undefined,
+                personaManager: subPersonaManager,
+                maxSubtasks: 20,
+                maxIterations: request.maxIterations || 10,
+                maxAgentDepth: this.maxDepth, // Inherit parent's max depth limit
+                autoSave: false, // Sub-agents don't auto-save
+            };
+            const subAgent = new DualAgent(subAgentConfig);
+            // Override with the nested spawner (which has currentDepth + 1)
+            subAgent.setAgentSpawner(subSpawner);
+            // Track the spawned agent
+            const spawnedAgent = {
+                id: agentId,
+                persona: request.persona,
+                agent: subAgent,
+                parentId: this.parentAgentId,
+                createdAt: new Date(),
+                messageCount: 0,
+                status: 'active',
+            };
+            this.agents.set(agentId, spawnedAgent);
+            // Prepare task message with context
+            let taskMessage = request.task;
+            if (request.context) {
+                taskMessage = `CONTEXT:\n${request.context}\n\nTASK:\n${request.task}`;
+            }
+            // Execute the task
+            logger.info(`[AgentSpawner] Executing task with sub-agent...`);
+            const response = await subAgent.chat(taskMessage);
+            // Update agent status
+            spawnedAgent.messageCount = 1;
+            spawnedAgent.status = 'completed';
+            spawnedAgent.result = response.content;
+            logger.success(`[AgentSpawner] Sub-agent completed task (${response.iterations} iterations)`);
+            return {
+                agentId,
+                persona: request.persona,
+                result: response.content,
+                iterations: response.iterations,
+                toolsUsed: response.toolsUsed,
+            };
+        }
+        catch (error) {
+            logger.error(`[AgentSpawner] Sub-agent failed:`, error);
+            const agent = this.agents.get(agentId);
+            if (agent) {
+                agent.status = 'failed';
+                agent.result = error instanceof Error ? error.message : String(error);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Get information about a spawned agent
+     */
+    getAgent(agentId) {
+        return this.agents.get(agentId);
+    }
+    /**
+     * List all spawned agents
+     */
+    listAgents() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * Get available personas that can be spawned
+     */
+    getAvailablePersonas() {
+        return this.basePersonaManager.getPersonas().map((p) => p.manifest.name);
+    }
+    /**
+     * Cleanup all spawned agents
+     */
+    async cleanup() {
+        for (const [agentId, spawnedAgent] of this.agents.entries()) {
+            try {
+                await spawnedAgent.agent.cleanup();
+            }
+            catch (error) {
+                logger.warn(`[AgentSpawner] Failed to cleanup agent ${agentId}:`, error);
+            }
+        }
+        this.agents.clear();
+    }
+}
+//# sourceMappingURL=agent-spawner.js.map

package/dist/core/agent-spawner.js.map

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