studiograph 1.3.48-next.8 → 1.3.48-next.9

package/dist/server/agents/agent-runtime.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Agent Runtime — central scheduler for autonomous agents
+ *
+ * Manages the lifecycle of all autonomous agents: scheduling ticks
+ * via setInterval, persisting state, broadcasting findings via WsHub,
+ * executing approved actions, and handling graceful shutdown.
+ *
+ * Follows the same setInterval pattern as SessionManager.
+ */
+import type { WorkspaceManager } from '../../core/workspace-manager.js';
+import type { WsHub } from '../ws-hub.js';
+import type { MemoryService } from '../../services/memory-service.js';
+import type { AutonomousAgent } from './base-agent.js';
+import type { AgentStatus } from './types.js';
+export declare class AgentRuntime {
+    private agents;
+    private timers;
+    private config;
+    private ctx;
+    private configPath;
+    private stateBaseDir;
+    constructor(workspaceManager: WorkspaceManager, wsHub?: WsHub, memoryService?: MemoryService);
+    /**
+     * Register an agent with the runtime.
+     */
+    register(agent: AutonomousAgent): void;
+    /**
+     * Start all enabled agents on their configured intervals.
+     */
+    start(): void;
+    /**
+     * Run a single tick for an agent.
+     */
+    private runTick;
+    /**
+     * Get status of all agents.
+     */
+    getAllStatus(): AgentStatus[];
+    /**
+     * Get a specific agent's full state.
+     */
+    getAgentDetail(agentId: string): {
+        status: AgentStatus;
+        pendingActions: any[];
+        completedActions: any[];
+    } | null;
+    /**
+     * Manually trigger a tick for an agent.
+     */
+    triggerAgent(agentId: string): Promise<boolean>;
+    /**
+     * Approve a pending action.
+     */
+    approveAction(agentId: string, actionId: string): boolean;
+    /**
+     * Reject a pending action.
+     */
+    rejectAction(agentId: string, actionId: string): boolean;
+    /**
+     * Update agent config (enable/disable, interval).
+     */
+    updateAgentConfig(agentId: string, updates: {
+        enabled?: boolean;
+        intervalMs?: number;
+    }): boolean;
+    /**
+     * Stop all agents and save state. Called on server shutdown.
+     */
+    stop(): void;
+    private loadConfig;
+    private saveConfig;
+}

package/dist/server/agents/agent-runtime.js

@@ -0,0 +1,275 @@
+/**
+ * Agent Runtime — central scheduler for autonomous agents
+ *
+ * Manages the lifecycle of all autonomous agents: scheduling ticks
+ * via setInterval, persisting state, broadcasting findings via WsHub,
+ * executing approved actions, and handling graceful shutdown.
+ *
+ * Follows the same setInterval pattern as SessionManager.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+const DEFAULT_CONFIG = {
+    agents: {},
+    autonomy: {
+        'generate-digest': 'auto',
+        'flag-stale-deal': 'auto',
+        'create-followup-task': 'approve',
+        'fix-missing-field': 'suggest',
+    },
+};
+export class AgentRuntime {
+    agents = new Map();
+    timers = new Map();
+    config;
+    ctx;
+    configPath;
+    stateBaseDir;
+    constructor(workspaceManager, wsHub, memoryService) {
+        this.stateBaseDir = join(homedir(), '.studiograph', 'agents');
+        this.configPath = join(this.stateBaseDir, 'runtime.json');
+        if (!existsSync(this.stateBaseDir)) {
+            mkdirSync(this.stateBaseDir, { recursive: true });
+        }
+        // Load or create runtime config
+        this.config = this.loadConfig();
+        this.ctx = {
+            workspaceManager,
+            wsHub,
+            memoryService,
+            stateDir: this.stateBaseDir,
+        };
+    }
+    /**
+     * Register an agent with the runtime.
+     */
+    register(agent) {
+        agent.initState(this.stateBaseDir);
+        this.agents.set(agent.id, agent);
+        // Ensure config has an entry for this agent
+        if (!this.config.agents[agent.id]) {
+            this.config.agents[agent.id] = {
+                enabled: true,
+                intervalMs: agent.defaultIntervalMs,
+            };
+            this.saveConfig();
+        }
+    }
+    /**
+     * Start all enabled agents on their configured intervals.
+     */
+    start() {
+        for (const [id, agent] of this.agents) {
+            const agentConfig = this.config.agents[id];
+            if (!agentConfig?.enabled)
+                continue;
+            // Run first tick after a short delay (let server finish startup)
+            const initialDelay = setTimeout(() => {
+                this.runTick(agent);
+            }, 5000 + Math.random() * 5000); // Stagger initial ticks
+            // Schedule recurring ticks
+            const timer = setInterval(() => {
+                this.runTick(agent);
+            }, agentConfig.intervalMs);
+            this.timers.set(id, timer);
+            // Store initial delay so we can clear it on shutdown
+            const delayKey = `${id}-init`;
+            this.timers.set(delayKey, initialDelay);
+            console.log(`[agent-runtime] Scheduled ${agent.name} (${id}) every ${Math.round(agentConfig.intervalMs / 1000)}s`);
+        }
+    }
+    /**
+     * Run a single tick for an agent.
+     */
+    async runTick(agent) {
+        if (agent.running)
+            return; // Skip if previous tick still running
+        agent.running = true;
+        const startTime = Date.now();
+        try {
+            const result = await agent.tick(this.ctx);
+            // Update state
+            agent.state.lastRunAt = new Date().toISOString();
+            agent.state.lastSuccessAt = agent.state.lastRunAt;
+            agent.state.lastFindings = result.findings;
+            // Process actions
+            for (const action of result.actions) {
+                const autonomy = this.config.autonomy[action.type] ?? action.autonomy;
+                action.autonomy = autonomy;
+                if (autonomy === 'auto') {
+                    // Auto-execute (implementation left to specific action handlers)
+                    action.status = 'executed';
+                    agent.state.completedActions.push(action);
+                }
+                else {
+                    // Queue for approval or suggestion
+                    agent.state.pendingActions.push(action);
+                }
+            }
+            agent.saveState();
+            // Broadcast findings via WebSocket
+            if (result.findings.length > 0 && this.ctx.wsHub) {
+                for (const finding of result.findings) {
+                    this.ctx.wsHub.broadcast({
+                        type: 'agent_finding',
+                        agentId: agent.id,
+                        agentName: agent.name,
+                        finding,
+                        timestamp: new Date().toISOString(),
+                    });
+                }
+            }
+            // Broadcast pending actions via WebSocket
+            for (const action of result.actions) {
+                if (action.autonomy !== 'auto' && this.ctx.wsHub) {
+                    this.ctx.wsHub.broadcast({
+                        type: 'agent_action',
+                        agentId: agent.id,
+                        agentName: agent.name,
+                        action,
+                        timestamp: new Date().toISOString(),
+                    });
+                }
+            }
+            const elapsed = Date.now() - startTime;
+            if (result.findings.length > 0) {
+                console.log(`[agent-runtime] ${agent.name}: ${result.findings.length} findings, ${result.actions.length} actions (${elapsed}ms)`);
+            }
+        }
+        catch (err) {
+            agent.state.lastRunAt = new Date().toISOString();
+            agent.saveState();
+            console.warn(`[agent-runtime] ${agent.name} tick failed:`, err.message);
+        }
+        finally {
+            agent.running = false;
+        }
+    }
+    // ── Public API ──────────────────────────────────────────────────
+    /**
+     * Get status of all agents.
+     */
+    getAllStatus() {
+        return Array.from(this.agents.values()).map(agent => {
+            const agentConfig = this.config.agents[agent.id];
+            return agent.getStatus(agentConfig?.enabled ?? false, agentConfig?.intervalMs ?? agent.defaultIntervalMs);
+        });
+    }
+    /**
+     * Get a specific agent's full state.
+     */
+    getAgentDetail(agentId) {
+        const agent = this.agents.get(agentId);
+        if (!agent)
+            return null;
+        const agentConfig = this.config.agents[agentId];
+        return {
+            status: agent.getStatus(agentConfig?.enabled ?? false, agentConfig?.intervalMs ?? agent.defaultIntervalMs),
+            pendingActions: agent.state.pendingActions,
+            completedActions: agent.state.completedActions.slice(-20),
+        };
+    }
+    /**
+     * Manually trigger a tick for an agent.
+     */
+    async triggerAgent(agentId) {
+        const agent = this.agents.get(agentId);
+        if (!agent || agent.running)
+            return false;
+        await this.runTick(agent);
+        return true;
+    }
+    /**
+     * Approve a pending action.
+     */
+    approveAction(agentId, actionId) {
+        const agent = this.agents.get(agentId);
+        if (!agent)
+            return false;
+        const idx = agent.state.pendingActions.findIndex(a => a.id === actionId);
+        if (idx === -1)
+            return false;
+        const action = agent.state.pendingActions.splice(idx, 1)[0];
+        action.status = 'approved';
+        // TODO: execute the action based on its payload
+        action.status = 'executed';
+        agent.state.completedActions.push(action);
+        agent.saveState();
+        return true;
+    }
+    /**
+     * Reject a pending action.
+     */
+    rejectAction(agentId, actionId) {
+        const agent = this.agents.get(agentId);
+        if (!agent)
+            return false;
+        const idx = agent.state.pendingActions.findIndex(a => a.id === actionId);
+        if (idx === -1)
+            return false;
+        const action = agent.state.pendingActions.splice(idx, 1)[0];
+        action.status = 'rejected';
+        agent.state.completedActions.push(action);
+        agent.saveState();
+        return true;
+    }
+    /**
+     * Update agent config (enable/disable, interval).
+     */
+    updateAgentConfig(agentId, updates) {
+        if (!this.config.agents[agentId])
+            return false;
+        if (updates.enabled !== undefined)
+            this.config.agents[agentId].enabled = updates.enabled;
+        if (updates.intervalMs !== undefined)
+            this.config.agents[agentId].intervalMs = updates.intervalMs;
+        this.saveConfig();
+        // Restart timer if interval changed
+        const existingTimer = this.timers.get(agentId);
+        if (existingTimer) {
+            clearInterval(existingTimer);
+            this.timers.delete(agentId);
+        }
+        if (this.config.agents[agentId].enabled) {
+            const agent = this.agents.get(agentId);
+            if (agent) {
+                const timer = setInterval(() => this.runTick(agent), this.config.agents[agentId].intervalMs);
+                this.timers.set(agentId, timer);
+            }
+        }
+        return true;
+    }
+    // ── Lifecycle ──────────────────────────────────────────────────
+    /**
+     * Stop all agents and save state. Called on server shutdown.
+     */
+    stop() {
+        for (const [id, timer] of this.timers) {
+            clearInterval(timer);
+            clearTimeout(timer);
+        }
+        this.timers.clear();
+        // Save all agent states
+        for (const agent of this.agents.values()) {
+            agent.saveState();
+        }
+        console.log('[agent-runtime] All agents stopped');
+    }
+    // ── Config persistence ─────────────────────────────────────────
+    loadConfig() {
+        if (existsSync(this.configPath)) {
+            try {
+                return JSON.parse(readFileSync(this.configPath, 'utf-8'));
+            }
+            catch {
+                return { ...DEFAULT_CONFIG };
+            }
+        }
+        return { ...DEFAULT_CONFIG };
+    }
+    saveConfig() {
+        writeFileSync(this.configPath, JSON.stringify(this.config, null, 2));
+    }
+}
+//# sourceMappingURL=agent-runtime.js.map

package/dist/server/agents/agent-runtime.js.map

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

package/dist/server/agents/base-agent.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Base Autonomous Agent
+ *
+ * Abstract class that all autonomous agents extend. Provides:
+ * - State loading/saving from filesystem
+ * - Finding and action creation helpers
+ * - tick() contract for subclasses
+ */
+import type { AgentContext, AgentState, AgentAction, AgentFinding, AgentTickResult } from './types.js';
+export declare abstract class AutonomousAgent {
+    abstract readonly id: string;
+    abstract readonly name: string;
+    abstract readonly description: string;
+    abstract readonly defaultIntervalMs: number;
+    state: AgentState;
+    running: boolean;
+    private stateDir;
+    private stateFile;
+    /**
+     * The main agent loop body. Subclasses implement this.
+     * Read from graph, analyze, return findings and proposed actions.
+     */
+    abstract tick(ctx: AgentContext): Promise<AgentTickResult>;
+    initState(baseDir: string): void;
+    saveState(): void;
+    private emptyState;
+    createFinding(headline: string, detail: string, urgency?: AgentFinding['urgency'], entities?: AgentFinding['entities']): AgentFinding;
+    createAction(type: string, description: string, payload: Record<string, any>, autonomy?: AgentAction['autonomy']): AgentAction;
+    getStatus(enabled: boolean, intervalMs: number): import('./types.js').AgentStatus;
+}

package/dist/server/agents/base-agent.js

@@ -0,0 +1,88 @@
+/**
+ * Base Autonomous Agent
+ *
+ * Abstract class that all autonomous agents extend. Provides:
+ * - State loading/saving from filesystem
+ * - Finding and action creation helpers
+ * - tick() contract for subclasses
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { randomUUID } from 'crypto';
+const MAX_COMPLETED_ACTIONS = 50;
+export class AutonomousAgent {
+    state;
+    running = false;
+    stateDir = '';
+    stateFile = '';
+    // ── State management ────────────────────────────────────────────
+    initState(baseDir) {
+        this.stateDir = join(baseDir, this.id);
+        this.stateFile = join(this.stateDir, 'state.json');
+        if (!existsSync(this.stateDir)) {
+            mkdirSync(this.stateDir, { recursive: true });
+        }
+        if (existsSync(this.stateFile)) {
+            try {
+                this.state = JSON.parse(readFileSync(this.stateFile, 'utf-8'));
+            }
+            catch {
+                this.state = this.emptyState();
+            }
+        }
+        else {
+            this.state = this.emptyState();
+        }
+    }
+    saveState() {
+        if (!this.stateFile)
+            return;
+        // Trim completed actions to ring buffer size
+        if (this.state.completedActions.length > MAX_COMPLETED_ACTIONS) {
+            this.state.completedActions = this.state.completedActions.slice(-MAX_COMPLETED_ACTIONS);
+        }
+        writeFileSync(this.stateFile, JSON.stringify(this.state, null, 2));
+    }
+    emptyState() {
+        return {
+            lastRunAt: null,
+            lastSuccessAt: null,
+            checkpoint: {},
+            pendingActions: [],
+            completedActions: [],
+            lastFindings: [],
+        };
+    }
+    // ── Helpers for subclasses ──────────────────────────────────────
+    createFinding(headline, detail, urgency = 'medium', entities) {
+        return { headline, detail, urgency, entities };
+    }
+    createAction(type, description, payload, autonomy = 'suggest') {
+        return {
+            id: randomUUID(),
+            agentId: this.id,
+            createdAt: new Date().toISOString(),
+            type,
+            description,
+            autonomy,
+            status: 'pending',
+            payload,
+        };
+    }
+    // ── Status for API ─────────────────────────────────────────────
+    getStatus(enabled, intervalMs) {
+        return {
+            id: this.id,
+            name: this.name,
+            description: this.description,
+            enabled,
+            running: this.running,
+            intervalMs,
+            lastRunAt: this.state.lastRunAt,
+            lastSuccessAt: this.state.lastSuccessAt,
+            pendingActionsCount: this.state.pendingActions.length,
+            lastFindings: this.state.lastFindings,
+        };
+    }
+}
+//# sourceMappingURL=base-agent.js.map

package/dist/server/agents/base-agent.js.map

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

package/dist/server/agents/executive-digest.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Executive Digest Agent — daily synthesis across all agents
+ *
+ * Runs daily (or on-demand), reads recent findings from all agents
+ * and recent entity changes, synthesizes a narrative summary.
+ * Writes to MemoryService for persistent record.
+ */
+import { AutonomousAgent } from './base-agent.js';
+import type { AgentContext, AgentTickResult } from './types.js';
+export declare class ExecutiveDigest extends AutonomousAgent {
+    readonly id = "executive-digest";
+    readonly name = "Executive Digest";
+    readonly description = "Daily synthesis of agent findings and workspace activity";
+    readonly defaultIntervalMs: number;
+    tick(ctx: AgentContext): Promise<AgentTickResult>;
+}

package/dist/server/agents/executive-digest.js

@@ -0,0 +1,115 @@
+/**
+ * Executive Digest Agent — daily synthesis across all agents
+ *
+ * Runs daily (or on-demand), reads recent findings from all agents
+ * and recent entity changes, synthesizes a narrative summary.
+ * Writes to MemoryService for persistent record.
+ */
+import { AutonomousAgent } from './base-agent.js';
+import { readdirSync, readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+const TWENTY_FOUR_HOURS = 24 * 60 * 60 * 1000;
+export class ExecutiveDigest extends AutonomousAgent {
+    id = 'executive-digest';
+    name = 'Executive Digest';
+    description = 'Daily synthesis of agent findings and workspace activity';
+    defaultIntervalMs = TWENTY_FOUR_HOURS;
+    async tick(ctx) {
+        const findings = [];
+        // Collect recent findings from all other agents
+        const allFindings = [];
+        const agentDirs = existsSync(ctx.stateDir) ? readdirSync(ctx.stateDir, { withFileTypes: true }) : [];
+        for (const dir of agentDirs) {
+            if (!dir.isDirectory() || dir.name === this.id)
+                continue;
+            const stateFile = join(ctx.stateDir, dir.name, 'state.json');
+            if (!existsSync(stateFile))
+                continue;
+            try {
+                const state = JSON.parse(readFileSync(stateFile, 'utf-8'));
+                if (state.lastFindings) {
+                    for (const f of state.lastFindings) {
+                        allFindings.push({ agent: dir.name, finding: f });
+                    }
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+        // Count entity changes in the last 24h
+        let recentChanges = 0;
+        let activeRepos = 0;
+        const typeChanges = {};
+        for (const repo of ctx.workspaceManager.getAllRepoConfigs()) {
+            try {
+                const graph = ctx.workspaceManager.getGraph(repo.name);
+                const entities = graph.search({});
+                let repoChanged = false;
+                for (const entity of entities) {
+                    const data = entity.data;
+                    const updatedAt = data.updated_at;
+                    if (updatedAt && (Date.now() - new Date(updatedAt).getTime()) < TWENTY_FOUR_HOURS) {
+                        recentChanges++;
+                        repoChanged = true;
+                        const type = data.entity_type ?? 'unknown';
+                        typeChanges[type] = (typeChanges[type] ?? 0) + 1;
+                    }
+                }
+                if (repoChanged)
+                    activeRepos++;
+            }
+            catch {
+                continue;
+            }
+        }
+        // Count findings by urgency
+        const highCount = allFindings.filter(f => f.finding.urgency === 'high').length;
+        const medCount = allFindings.filter(f => f.finding.urgency === 'medium').length;
+        // Build digest
+        const parts = [];
+        if (highCount > 0) {
+            parts.push(`**Attention needed**: ${highCount} high-urgency finding${highCount > 1 ? 's' : ''}`);
+        }
+        if (medCount > 0) {
+            parts.push(`**Review**: ${medCount} medium-urgency finding${medCount > 1 ? 's' : ''}`);
+        }
+        // Summarize by agent
+        const byAgent = new Map();
+        for (const { agent, finding } of allFindings) {
+            if (!byAgent.has(agent))
+                byAgent.set(agent, []);
+            byAgent.get(agent).push(finding);
+        }
+        for (const [agent, agentFindings] of byAgent) {
+            parts.push(`**${agent}**: ${agentFindings.map(f => f.headline).join('; ')}`);
+        }
+        // Activity summary
+        if (recentChanges > 0) {
+            const topTypes = Object.entries(typeChanges)
+                .sort(([, a], [, b]) => b - a)
+                .slice(0, 3)
+                .map(([type, count]) => `${type} (${count})`)
+                .join(', ');
+            parts.push(`**Activity**: ${recentChanges} entities updated across ${activeRepos} collections. Most active: ${topTypes}`);
+        }
+        else {
+            parts.push(`**Activity**: No entity changes in the last 24 hours`);
+        }
+        if (parts.length > 0) {
+            const today = new Date().toISOString().slice(0, 10);
+            const digestText = parts.join('\n');
+            findings.push(this.createFinding(`Daily Digest — ${today}`, digestText, highCount > 0 ? 'high' : medCount > 0 ? 'medium' : 'low'));
+            // Write to memory service if available
+            if (ctx.memoryService) {
+                try {
+                    ctx.memoryService.writeMemory({ timestamp: new Date(), type: 'note', content: `## Daily Digest — ${today}\n\n${digestText}` });
+                }
+                catch { /* non-fatal */ }
+            }
+        }
+        this.state.checkpoint.lastDigestDate = new Date().toISOString().slice(0, 10);
+        return { findings, actions: [] };
+    }
+}
+//# sourceMappingURL=executive-digest.js.map

package/dist/server/agents/executive-digest.js.map

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

package/dist/server/agents/graph-steward.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Graph Steward — autonomous graph health monitor
+ *
+ * Periodically runs graph health analysis and reports only NEW or
+ * WORSENING issues compared to the last checkpoint. Delta-based
+ * reporting avoids alert fatigue — you only hear about changes.
+ */
+import { AutonomousAgent } from './base-agent.js';
+import type { AgentContext, AgentTickResult } from './types.js';
+export declare class GraphSteward extends AutonomousAgent {
+    readonly id = "graph-steward";
+    readonly name = "Graph Steward";
+    readonly description = "Monitors graph health and reports new issues (broken links, stale entities, orphans)";
+    readonly defaultIntervalMs: number;
+    tick(ctx: AgentContext): Promise<AgentTickResult>;
+}