zora-agent 0.9.0

package/dist/orchestrator/orchestrator.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Orchestrator — Central controller that boots, owns, and connects every component.
+ *
+ * Remediation Roadmap R1-R9:
+ *   - Single owner that instantiates Router, FailoverController, RetryQueue,
+ *     AuthMonitor, SessionManager, SteeringManager, MemoryManager,
+ *     HeartbeatSystem, RoutineManager.
+ *   - Exposes boot() and shutdown().
+ *   - submitTask() wires routing, failover, retry, steering, session persistence,
+ *     and memory context injection into a unified execution path.
+ */
+import type { ZoraConfig, ZoraPolicy, LLMProvider, CostTier, AgentEvent } from '../types.js';
+import { Router } from './router.js';
+import { RetryQueue } from './retry-queue.js';
+import { AuthMonitor } from './auth-monitor.js';
+import { SessionManager } from './session-manager.js';
+import { SteeringManager } from '../steering/steering-manager.js';
+import { MemoryManager } from '../memory/memory-manager.js';
+import { PolicyEngine } from '../security/policy-engine.js';
+export interface OrchestratorOptions {
+    config: ZoraConfig;
+    policy: ZoraPolicy;
+    providers: LLMProvider[];
+    baseDir?: string;
+}
+export interface SubmitTaskOptions {
+    prompt: string;
+    model?: string;
+    maxCostTier?: CostTier;
+    maxTurns?: number;
+    jobId?: string;
+    onEvent?: (event: AgentEvent) => void;
+}
+export declare class Orchestrator {
+    private readonly _config;
+    private readonly _policy;
+    private readonly _baseDir;
+    private readonly _providers;
+    private _router;
+    private _failoverController;
+    private _retryQueue;
+    private _authMonitor;
+    private _sessionManager;
+    private _steeringManager;
+    private _memoryManager;
+    private _policyEngine;
+    private _notifications;
+    private _intentCapsuleManager;
+    private _heartbeatSystem;
+    private _routineManager;
+    private _authCheckTimeout;
+    private _retryPollTimeout;
+    private _booted;
+    constructor(options: OrchestratorOptions);
+    /**
+     * Boots all subsystems and starts background loops.
+     */
+    boot(): Promise<void>;
+    /**
+     * Gracefully shuts down all subsystems.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Submits a task through the full orchestration pipeline:
+     * 1. Load memory context (R6)
+     * 2. Classify and route to provider (R2)
+     * 3. Execute with event persistence (R8) and steering (R7)
+     * 4. Handle failures with failover (R3) and retry (R5)
+     */
+    submitTask(options: SubmitTaskOptions): Promise<string>;
+    /** Symbol used to mark errors that have already been through the failover path */
+    private static readonly _FAILOVER_SENTINEL;
+    /** Maximum depth of failover recursion to prevent unbounded re-execution */
+    private static readonly MAX_FAILOVER_DEPTH;
+    /**
+     * Executes a task with a specific provider, handling failover and event persistence.
+     */
+    private _executeWithProvider;
+    /**
+     * Creates custom tools available to the agent during execution.
+     */
+    private _createCustomTools;
+    /**
+     * Parse interval strings like "30m", "1h" to minutes.
+     */
+    private _parseIntervalMinutes;
+    private _assertBooted;
+    get isBooted(): boolean;
+    get router(): Router;
+    get sessionManager(): SessionManager;
+    get steeringManager(): SteeringManager;
+    get memoryManager(): MemoryManager;
+    get authMonitor(): AuthMonitor;
+    get retryQueue(): RetryQueue;
+    get policyEngine(): PolicyEngine;
+    get config(): ZoraConfig;
+    get providers(): LLMProvider[];
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator/orchestrator.d.ts.map

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

package/dist/orchestrator/orchestrator.js

@@ -0,0 +1,456 @@
+/**
+ * Orchestrator — Central controller that boots, owns, and connects every component.
+ *
+ * Remediation Roadmap R1-R9:
+ *   - Single owner that instantiates Router, FailoverController, RetryQueue,
+ *     AuthMonitor, SessionManager, SteeringManager, MemoryManager,
+ *     HeartbeatSystem, RoutineManager.
+ *   - Exposes boot() and shutdown().
+ *   - submitTask() wires routing, failover, retry, steering, session persistence,
+ *     and memory context injection into a unified execution path.
+ */
+import crypto from 'node:crypto';
+import path from 'node:path';
+import os from 'node:os';
+import fs from 'node:fs';
+import { Router } from './router.js';
+import { FailoverController } from './failover-controller.js';
+import { RetryQueue } from './retry-queue.js';
+import { AuthMonitor } from './auth-monitor.js';
+import { SessionManager } from './session-manager.js';
+import { ExecutionLoop } from './execution-loop.js';
+import { SteeringManager } from '../steering/steering-manager.js';
+import { MemoryManager } from '../memory/memory-manager.js';
+import { HeartbeatSystem } from '../routines/heartbeat.js';
+import { RoutineManager } from '../routines/routine-manager.js';
+import { NotificationTools } from '../tools/notifications.js';
+import { PolicyEngine } from '../security/policy-engine.js';
+import { IntentCapsuleManager } from '../security/intent-capsule.js';
+export class Orchestrator {
+    _config;
+    _policy;
+    _baseDir;
+    _providers;
+    // Core components
+    _router;
+    _failoverController;
+    _retryQueue;
+    _authMonitor;
+    _sessionManager;
+    _steeringManager;
+    _memoryManager;
+    _policyEngine;
+    _notifications;
+    // Security
+    _intentCapsuleManager;
+    // Background systems
+    _heartbeatSystem = null;
+    _routineManager = null;
+    // Background intervals
+    _authCheckTimeout = null;
+    _retryPollTimeout = null;
+    _booted = false;
+    constructor(options) {
+        this._config = options.config;
+        this._policy = options.policy;
+        this._providers = options.providers;
+        this._baseDir = options.baseDir ?? path.join(os.homedir(), '.zora');
+    }
+    /**
+     * Boots all subsystems and starts background loops.
+     */
+    async boot() {
+        if (this._booted)
+            return;
+        // Initialize core services
+        this._notifications = new NotificationTools();
+        this._policyEngine = new PolicyEngine(this._policy);
+        this._policyEngine.startSession(`session_${Date.now()}`);
+        // ASI01: Create IntentCapsuleManager with per-session signing key
+        this._intentCapsuleManager = new IntentCapsuleManager(crypto.randomBytes(32).toString('hex'));
+        this._policyEngine.setIntentCapsuleManager(this._intentCapsuleManager);
+        this._sessionManager = new SessionManager(this._baseDir);
+        this._steeringManager = new SteeringManager(this._baseDir);
+        await this._steeringManager.init();
+        this._memoryManager = new MemoryManager(this._config.memory, this._baseDir);
+        await this._memoryManager.init();
+        // R2: Wire Router
+        this._router = new Router({
+            providers: this._providers,
+            mode: this._config.routing.mode,
+            providerOnlyName: this._config.routing.provider_only_name,
+        });
+        // R3: Wire FailoverController
+        this._failoverController = new FailoverController(this._providers, this._router, this._config.failover);
+        // R5: Initialize RetryQueue
+        this._retryQueue = new RetryQueue(this._baseDir);
+        await this._retryQueue.init();
+        // R4: Schedule AuthMonitor
+        this._authMonitor = new AuthMonitor({
+            providers: this._providers,
+            notifications: this._notifications,
+            preExpiryWarningHours: 2,
+        });
+        // R4: Schedule periodic auth checks (every 5 minutes) using self-rescheduling
+        // setTimeout to avoid overlapping async executions
+        const scheduleAuthCheck = () => {
+            this._authCheckTimeout = setTimeout(async () => {
+                try {
+                    await this._authMonitor.checkAll();
+                }
+                catch (err) {
+                    console.error('[Orchestrator] AuthMonitor check failed:', err);
+                }
+                scheduleAuthCheck();
+            }, 5 * 60 * 1000);
+        };
+        scheduleAuthCheck();
+        // R5: Poll RetryQueue (every 30 seconds) — remove task only after successful re-submission
+        const scheduleRetryPoll = () => {
+            this._retryPollTimeout = setTimeout(async () => {
+                try {
+                    const readyTasks = this._retryQueue.getReadyTasks();
+                    for (const task of readyTasks) {
+                        try {
+                            await this.submitTask({ prompt: task.task, jobId: task.jobId });
+                            await this._retryQueue.remove(task.jobId);
+                        }
+                        catch (err) {
+                            console.error(`[Orchestrator] Retry failed for ${task.jobId}:`, err);
+                            // Leave task in queue for next poll cycle
+                        }
+                    }
+                }
+                catch (err) {
+                    console.error('[Orchestrator] RetryQueue poll failed:', err);
+                }
+                scheduleRetryPoll();
+            }, 30 * 1000);
+        };
+        scheduleRetryPoll();
+        // R9: Start HeartbeatSystem and RoutineManager
+        const defaultLoop = new ExecutionLoop({
+            systemPrompt: 'You are Zora, a helpful autonomous agent.',
+            permissionMode: 'default',
+            cwd: process.cwd(),
+            canUseTool: this._policyEngine.createCanUseTool(),
+            customTools: this._createCustomTools(),
+        });
+        this._heartbeatSystem = new HeartbeatSystem({
+            loop: defaultLoop,
+            baseDir: this._baseDir,
+            intervalMinutes: this._parseIntervalMinutes(this._config.agent.heartbeat_interval),
+        });
+        await this._heartbeatSystem.start();
+        this._routineManager = new RoutineManager(async (opts) => this.submitTask({
+            prompt: opts.prompt,
+            model: opts.model,
+            maxCostTier: opts.maxCostTier,
+        }), this._baseDir);
+        await this._routineManager.init();
+        this._booted = true;
+    }
+    /**
+     * Gracefully shuts down all subsystems.
+     */
+    async shutdown() {
+        if (!this._booted)
+            return;
+        // Stop background timers
+        if (this._authCheckTimeout) {
+            clearTimeout(this._authCheckTimeout);
+            this._authCheckTimeout = null;
+        }
+        if (this._retryPollTimeout) {
+            clearTimeout(this._retryPollTimeout);
+            this._retryPollTimeout = null;
+        }
+        // Stop heartbeat and routines
+        if (this._heartbeatSystem) {
+            this._heartbeatSystem.stop();
+            this._heartbeatSystem = null;
+        }
+        if (this._routineManager) {
+            this._routineManager.stopAll();
+            this._routineManager = null;
+        }
+        this._booted = false;
+    }
+    /**
+     * Submits a task through the full orchestration pipeline:
+     * 1. Load memory context (R6)
+     * 2. Classify and route to provider (R2)
+     * 3. Execute with event persistence (R8) and steering (R7)
+     * 4. Handle failures with failover (R3) and retry (R5)
+     */
+    async submitTask(options) {
+        const jobId = options.jobId ?? `job_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+        // R6: Inject MemoryManager context systematically
+        const memoryContext = await this._memoryManager.loadContext();
+        // Load SOUL.md for agent identity (fixes bug: file was created but never read)
+        const soulPath = this._config.agent.identity.soul_file.replace(/^~/, os.homedir());
+        let soulContent = '';
+        try {
+            if (fs.existsSync(soulPath)) {
+                soulContent = fs.readFileSync(soulPath, 'utf-8').trim();
+            }
+        }
+        catch {
+            // SOUL.md missing or unreadable — use default identity
+        }
+        // Build system prompt with policy awareness
+        const systemPrompt = [
+            soulContent || 'You are Zora, a helpful autonomous agent.',
+            '[SECURITY] You operate under a permission policy. Before planning any task,',
+            'use the check_permissions tool to verify you have access to the paths and',
+            'commands you need. If access is denied, tell the user what you need and why.',
+            'Do NOT attempt actions without checking first.',
+            ...memoryContext,
+        ].join('\n\n');
+        // ASI01: Create signed intent capsule for goal drift detection
+        if (this._intentCapsuleManager) {
+            this._intentCapsuleManager.createCapsule(options.prompt);
+        }
+        // Classify task for routing
+        const classification = this._router.classifyTask(options.prompt);
+        // Build task context
+        const taskContext = {
+            jobId,
+            task: options.prompt,
+            requiredCapabilities: [],
+            complexity: classification.complexity,
+            resourceType: classification.resourceType,
+            systemPrompt,
+            memoryContext,
+            history: [],
+            modelPreference: options.model,
+            maxCostTier: options.maxCostTier,
+            maxTurns: options.maxTurns,
+        };
+        // R2: Route to provider
+        let selectedProvider;
+        try {
+            selectedProvider = await this._router.selectProvider(taskContext);
+        }
+        catch (err) {
+            throw new Error(`No provider available: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // Execute with the selected provider
+        return this._executeWithProvider(selectedProvider, taskContext, options.onEvent);
+    }
+    /** Symbol used to mark errors that have already been through the failover path */
+    static _FAILOVER_SENTINEL = Symbol.for('zora.failoverSentinel');
+    /** Maximum depth of failover recursion to prevent unbounded re-execution */
+    static MAX_FAILOVER_DEPTH = 3;
+    /**
+     * Executes a task with a specific provider, handling failover and event persistence.
+     */
+    async _executeWithProvider(provider, taskContext, onEvent, failoverDepth = 0) {
+        let result = '';
+        try {
+            // Execute via the provider's async generator
+            for await (const event of provider.execute(taskContext)) {
+                // R8: Persist events to SessionManager
+                await this._sessionManager.appendEvent(taskContext.jobId, event);
+                // R7: Poll SteeringManager during execution
+                if (event.type === 'text' || event.type === 'tool_result') {
+                    const pendingMessages = await this._steeringManager.getPendingMessages(taskContext.jobId);
+                    for (const msg of pendingMessages) {
+                        // Inject steering as an event
+                        const steerEvent = {
+                            type: 'steering',
+                            timestamp: new Date(),
+                            content: { text: msg.message, source: msg.source, author: msg.author },
+                        };
+                        await this._sessionManager.appendEvent(taskContext.jobId, steerEvent);
+                        taskContext.history.push(steerEvent);
+                        if (onEvent)
+                            onEvent(steerEvent);
+                        // Archive the processed message
+                        await this._steeringManager.archiveMessage(taskContext.jobId, msg.id);
+                    }
+                }
+                // Notify caller
+                if (onEvent)
+                    onEvent(event);
+                // Track history for failover handoff
+                taskContext.history.push(event);
+                // Capture result text
+                if (event.type === 'done') {
+                    result = event.content.text ?? '';
+                }
+                // Handle errors — trigger failover (R3)
+                if (event.type === 'error') {
+                    const errorContent = event.content;
+                    const error = new Error(errorContent.message ?? 'Unknown provider error');
+                    // Guard: skip failover if depth exceeded
+                    if (failoverDepth >= Orchestrator.MAX_FAILOVER_DEPTH) {
+                        throw error;
+                    }
+                    // R3: Connect FailoverController to error path
+                    const failoverResult = await this._failoverController.handleFailure(taskContext, provider, error);
+                    if (failoverResult) {
+                        // Re-execute with the failover provider (increment depth)
+                        return this._executeWithProvider(failoverResult.nextProvider, taskContext, onEvent, failoverDepth + 1);
+                    }
+                    // R5: Enqueue for retry if no failover available
+                    try {
+                        await this._retryQueue.enqueue(taskContext, error.message, this._config.failover.max_retries);
+                    }
+                    catch {
+                        // Max retries exceeded or enqueue failed
+                    }
+                    // Mark so the outer catch doesn't re-trigger failover
+                    error[Orchestrator._FAILOVER_SENTINEL] = true;
+                    throw error;
+                }
+            }
+        }
+        catch (err) {
+            // Skip failover for errors already marked by the failover path
+            const isFailoverError = err instanceof Error && err[Orchestrator._FAILOVER_SENTINEL];
+            if (!isFailoverError && err instanceof Error && failoverDepth < Orchestrator.MAX_FAILOVER_DEPTH) {
+                // R3: Try failover on execution exceptions
+                const failoverResult = await this._failoverController.handleFailure(taskContext, provider, err);
+                if (failoverResult) {
+                    // Mark the error so downstream doesn't re-trigger failover
+                    err[Orchestrator._FAILOVER_SENTINEL] = true;
+                    return this._executeWithProvider(failoverResult.nextProvider, taskContext, onEvent, failoverDepth + 1);
+                }
+                // R5: Enqueue for retry
+                try {
+                    await this._retryQueue.enqueue(taskContext, err.message, this._config.failover.max_retries);
+                }
+                catch {
+                    // Max retries exceeded
+                }
+            }
+            throw err;
+        }
+        // Record completion in daily notes
+        await this._memoryManager.appendDailyNote(`Completed task: ${taskContext.task}`);
+        return result;
+    }
+    /**
+     * Creates custom tools available to the agent during execution.
+     */
+    _createCustomTools() {
+        return [
+            {
+                name: 'check_permissions',
+                description: 'Check if you have access to specific paths or commands before executing. Use this during planning to verify your boundaries.',
+                input_schema: {
+                    type: 'object',
+                    properties: {
+                        paths: { type: 'array', items: { type: 'string' }, description: 'Filesystem paths to check access for' },
+                        commands: { type: 'array', items: { type: 'string' }, description: 'Shell commands to check access for' },
+                    },
+                },
+                handler: async (input) => {
+                    const paths = input['paths'] ?? [];
+                    const commands = input['commands'] ?? [];
+                    return this._policyEngine.checkAccess(paths, commands);
+                },
+            },
+            {
+                name: 'request_permissions',
+                description: 'Request additional permissions from the user. Use this when check_permissions shows a path or command is denied and you need it for the current task. The user will be asked to approve.',
+                input_schema: {
+                    type: 'object',
+                    properties: {
+                        paths: { type: 'array', items: { type: 'string' }, description: 'Filesystem paths to request access for' },
+                        commands: { type: 'array', items: { type: 'string' }, description: 'Shell commands to request access for' },
+                        reason: { type: 'string', description: 'Why you need this access (shown to user)' },
+                    },
+                    required: ['reason'],
+                },
+                handler: async (input) => {
+                    const paths = input['paths'] ?? [];
+                    const commands = input['commands'] ?? [];
+                    const reason = input['reason'] ?? 'No reason provided';
+                    // Validate against permanent deny-list before asking the user
+                    const deniedPaths = this._policy.filesystem.denied_paths;
+                    for (const p of paths) {
+                        const abs = path.resolve(p.replace(/^~/, os.homedir()));
+                        for (const denied of deniedPaths) {
+                            const absDenied = path.resolve(denied.replace(/^~/, os.homedir()));
+                            if (abs === absDenied || abs.startsWith(absDenied + path.sep)) {
+                                return {
+                                    granted: false,
+                                    message: `Cannot grant access to ${p} — it is in the permanent deny-list. This cannot be overridden at runtime.`,
+                                };
+                            }
+                        }
+                    }
+                    // The actual approval flow happens outside (CLI prompt, dashboard, etc.)
+                    // For now, return the request details so the caller can present them to the user.
+                    // In the CLI, this will be intercepted by the onEvent callback.
+                    return {
+                        granted: false,
+                        pending: true,
+                        message: `Permission request submitted. Paths: ${paths.join(', ') || 'none'}. Commands: ${commands.join(', ') || 'none'}. Reason: ${reason}`,
+                        request: { paths, commands, reason },
+                    };
+                },
+            },
+        ];
+    }
+    /**
+     * Parse interval strings like "30m", "1h" to minutes.
+     */
+    _parseIntervalMinutes(interval) {
+        const match = interval.match(/^(\d+)(m|h|s)$/);
+        if (!match)
+            return 30; // default 30 minutes
+        const value = parseInt(match[1], 10);
+        switch (match[2]) {
+            case 'h': return value * 60;
+            case 'm': return value;
+            case 's': return Math.max(1, Math.floor(value / 60));
+            default: return 30;
+        }
+    }
+    // ─── Public accessors ──────────────────────────────────────────────
+    _assertBooted() {
+        if (!this._booted)
+            throw new Error('Orchestrator.boot() must be called before accessing subsystems');
+    }
+    get isBooted() {
+        return this._booted;
+    }
+    get router() {
+        this._assertBooted();
+        return this._router;
+    }
+    get sessionManager() {
+        this._assertBooted();
+        return this._sessionManager;
+    }
+    get steeringManager() {
+        this._assertBooted();
+        return this._steeringManager;
+    }
+    get memoryManager() {
+        this._assertBooted();
+        return this._memoryManager;
+    }
+    get authMonitor() {
+        this._assertBooted();
+        return this._authMonitor;
+    }
+    get retryQueue() {
+        this._assertBooted();
+        return this._retryQueue;
+    }
+    get policyEngine() {
+        this._assertBooted();
+        return this._policyEngine;
+    }
+    get config() {
+        return this._config;
+    }
+    get providers() {
+        return this._providers;
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator/orchestrator.js.map

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

package/dist/orchestrator/retry-queue.d.ts

@@ -0,0 +1,39 @@
+/**
+ * RetryQueue — Persistence and scheduling for failed tasks.
+ *
+ * Spec §4.2 "Scheduler":
+ *   - Tasks failed due to quota/transient errors are scheduled for retry.
+ *   - Uses exponential backoff for cooldown tracking.
+ *   - Persists state to prevent loss across restarts.
+ */
+import type { TaskContext } from '../types.js';
+export interface RetryEntry {
+    task: TaskContext;
+    retryCount: number;
+    lastError: string;
+    nextRunAt: Date;
+}
+export declare class RetryQueue {
+    private readonly _stateFile;
+    private _queue;
+    constructor(baseDir?: string);
+    /**
+     * Initializes the queue by loading persisted state.
+     */
+    init(): Promise<void>;
+    /**
+     * Adds a task to the retry queue with exponential backoff.
+     */
+    enqueue(task: TaskContext, error: string, maxRetries?: number): Promise<void>;
+    /**
+     * Returns tasks that are ready to be retried.
+     */
+    getReadyTasks(): TaskContext[];
+    /**
+     * Removes a task from the queue once successfully completed.
+     */
+    remove(jobId: string): Promise<void>;
+    private _save;
+    get size(): number;
+}
+//# sourceMappingURL=retry-queue.d.ts.map

package/dist/orchestrator/retry-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-queue.d.ts","sourceRoot":"","sources":["../../src/orchestrator/retry-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,MAAM,CAAoB;gBAEtB,OAAO,GAAE,MAAyC;IAI9D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,GAAE,MAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCtF;;OAEG;IACH,aAAa,IAAI,WAAW,EAAE;IAM9B;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAK5B,KAAK;IAInB,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}