@hazeljs/agent 0.2.0-beta.60 → 0.2.0-beta.61

package/dist/supervisor/supervisor.js

@@ -0,0 +1,227 @@
+"use strict";
+/**
+ * SupervisorAgent — Orchestrate a team of worker agents via an LLM router
+ *
+ * The supervisor uses an LLM to:
+ *  1. Decompose an incoming task into subtasks
+ *  2. Route each subtask to the most appropriate worker agent
+ *  3. Accumulate results and decide when the task is complete
+ *
+ * This implements the "Supervisor ↔ Workers" multi-agent pattern:
+ *
+ * ```
+ *   User Task
+ *       │
+ *   Supervisor  ←───────────────────────┐
+ *       │                               │
+ *   ┌───▼────────────────┐         Worker result
+ *   │  Route to worker?  │              │
+ *   └───────────┬────────┘              │
+ *               │                       │
+ *        ┌──────▼──────┐                │
+ *        │  WorkerAgent │───────────────┘
+ *        └─────────────┘
+ * ```
+ *
+ * @example
+ * ```ts
+ * const supervisor = runtime.createSupervisor({
+ *   name: 'project-manager',
+ *   workers: ['ResearchAgent', 'CoderAgent', 'WriterAgent'],
+ *   maxRounds: 6,
+ * });
+ *
+ * const result = await supervisor.run('Build a REST API for a todo app');
+ * console.log(result.response);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SupervisorAgent = void 0;
+/**
+ * A supervisor that routes tasks to worker agents using an LLM.
+ * Obtain one via `AgentRuntime.createSupervisor(config)`.
+ */
+class SupervisorAgent {
+    constructor(config, llmProvider, runtime) {
+        this.config = config;
+        this.llmProvider = llmProvider;
+        this.runtime = runtime;
+        this.name = config.name;
+        this.workers = config.workers;
+        this.maxRounds = config.maxRounds ?? 10;
+        this.temperature = config.temperature ?? 0;
+        this.model = config.model;
+        // Collect worker descriptions for the system prompt
+        const workerInfos = this.workers.map((w) => ({
+            name: w,
+            description: runtime.getAgentMetadata(w)?.description ?? `Worker agent: ${w}`,
+        }));
+        this.systemPrompt = config.systemPrompt
+            ? `${config.systemPrompt}\n\n${this.buildWorkerList(workerInfos)}`
+            : this.buildDefaultSystemPrompt(workerInfos);
+    }
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    /**
+     * Run the supervisor on a given task.
+     * The supervisor will iteratively route subtasks to workers until either:
+     *  - The LLM decides the task is complete and emits a final response, or
+     *  - `maxRounds` is reached (returns the accumulated context as the response).
+     */
+    async run(task, options = {}) {
+        const startTime = Date.now();
+        const rounds = [];
+        // Conversation context the supervisor maintains across rounds
+        const conversationContext = [`Task: ${task}`];
+        try {
+            for (let round = 1; round <= this.maxRounds; round++) {
+                const roundStart = Date.now();
+                // Ask the LLM supervisor to decide what to do next
+                const decision = await this.makeRoutingDecision(task, conversationContext);
+                if (decision.action === 'finish') {
+                    const response = decision.response ?? conversationContext.join('\n\n');
+                    rounds.push({
+                        round,
+                        decision,
+                        duration: Date.now() - roundStart,
+                    });
+                    return {
+                        response,
+                        rounds,
+                        totalDuration: Date.now() - startTime,
+                        completedAt: new Date(),
+                        success: true,
+                    };
+                }
+                // Delegate to a worker agent
+                if (decision.action === 'delegate' && decision.worker && decision.subtask) {
+                    if (!this.workers.includes(decision.worker)) {
+                        throw new Error(`Supervisor "${this.name}" tried to route to unknown worker "${decision.worker}". ` +
+                            `Available workers: ${this.workers.join(', ')}`);
+                    }
+                    const workerResult = await this.runtime.execute(decision.worker, decision.subtask, {
+                        sessionId: options.sessionId,
+                        userId: options.userId,
+                    });
+                    // Add the worker result to the conversation context
+                    conversationContext.push(`Round ${round} — Worker: ${decision.worker}\n` +
+                        `Subtask: ${decision.subtask}\n` +
+                        `Result: ${workerResult.response ?? '(no response)'}`);
+                    rounds.push({
+                        round,
+                        decision,
+                        workerResult,
+                        duration: Date.now() - roundStart,
+                    });
+                    continue;
+                }
+                // Unexpected decision shape — treat as finish
+                rounds.push({ round, decision, duration: Date.now() - roundStart });
+                break;
+            }
+            // maxRounds reached without a 'finish' decision
+            const finalResponse = conversationContext.length > 1
+                ? `Supervisor reached maximum rounds (${this.maxRounds}).\n\n` +
+                    conversationContext.slice(1).join('\n\n')
+                : `Supervisor reached maximum rounds without producing a response.`;
+            return {
+                response: finalResponse,
+                rounds,
+                totalDuration: Date.now() - startTime,
+                completedAt: new Date(),
+                success: true,
+            };
+        }
+        catch (error) {
+            return {
+                response: '',
+                rounds,
+                totalDuration: Date.now() - startTime,
+                completedAt: new Date(),
+                success: false,
+                error: error,
+            };
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private: LLM routing
+    // ---------------------------------------------------------------------------
+    async makeRoutingDecision(originalTask, context) {
+        const contextSummary = context.length > 1 ? '\n\nWork completed so far:\n' + context.slice(1).join('\n\n') : '';
+        const userMessage = `Original task: ${originalTask}${contextSummary}\n\n` +
+            `Decide the next action. Respond with ONLY a JSON object (no markdown):
+{
+  "action": "delegate" | "finish",
+  "worker": "<worker name>",    // required when action === "delegate"
+  "subtask": "<instructions>",  // required when action === "delegate"
+  "response": "<final answer>", // required when action === "finish"
+  "thought": "<your reasoning>" // optional
+}`;
+        try {
+            const llmResponse = await this.llmProvider.chat({
+                messages: [
+                    { role: 'system', content: this.systemPrompt },
+                    { role: 'user', content: userMessage },
+                ],
+                temperature: this.temperature,
+                ...(this.model ? { model: this.model } : {}),
+            });
+            return this.parseDecision(llmResponse.content);
+        }
+        catch {
+            // On LLM error, default to finishing with accumulated context
+            return {
+                action: 'finish',
+                response: context.slice(1).join('\n\n') || 'Unable to complete task due to LLM error.',
+                thought: 'LLM call failed, returning accumulated context.',
+            };
+        }
+    }
+    parseDecision(raw) {
+        // Strip markdown code fences if present
+        const cleaned = raw
+            .replace(/^```(?:json)?\s*/i, '')
+            .replace(/\s*```$/i, '')
+            .trim();
+        try {
+            const parsed = JSON.parse(cleaned);
+            if (parsed.action !== 'delegate' && parsed.action !== 'finish') {
+                return { action: 'finish', response: cleaned };
+            }
+            return parsed;
+        }
+        catch {
+            // If the LLM returned plain text, treat it as a final answer
+            return { action: 'finish', response: raw };
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // Private: prompt builders
+    // ---------------------------------------------------------------------------
+    buildDefaultSystemPrompt(workers) {
+        return (`You are "${this.name}", a supervisor agent responsible for orchestrating a team of ` +
+            `specialized worker agents to complete complex tasks.\n\n` +
+            `Your responsibilities:\n` +
+            `1. Break down the user's task into subtasks\n` +
+            `2. Delegate each subtask to the most appropriate worker\n` +
+            `3. Review worker results and decide what to do next\n` +
+            `4. When all subtasks are done, synthesize a final response\n\n` +
+            this.buildWorkerList(workers));
+    }
+    buildWorkerList(workers) {
+        const lines = workers.map((w) => `  • ${w.name}: ${w.description}`);
+        return `Available workers:\n${lines.join('\n')}`;
+    }
+    // ---------------------------------------------------------------------------
+    // Introspection
+    // ---------------------------------------------------------------------------
+    get supervisorName() {
+        return this.name;
+    }
+    get workerNames() {
+        return [...this.workers];
+    }
+}
+exports.SupervisorAgent = SupervisorAgent;
+//# sourceMappingURL=supervisor.js.map

package/dist/supervisor/supervisor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.js","sourceRoot":"","sources":["../../src/supervisor/supervisor.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;;;AAsBH;;;GAGG;AACH,MAAa,eAAe;IAQ1B,YACmB,MAAwB,EACxB,WAAwB,EACxB,OAAoB;QAFpB,WAAM,GAAN,MAAM,CAAkB;QACxB,gBAAW,GAAX,WAAW,CAAa;QACxB,YAAO,GAAP,OAAO,CAAa;QAErC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAE1B,oDAAoD;QACpD,MAAM,WAAW,GAA2B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACnE,IAAI,EAAE,CAAC;YACP,WAAW,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,WAAW,IAAI,iBAAiB,CAAC,EAAE;SAC9E,CAAC,CAAC,CAAC;QAEJ,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY;YACrC,CAAC,CAAC,GAAG,MAAM,CAAC,YAAY,OAAO,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,EAAE;YAClE,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,8EAA8E;IAC9E,aAAa;IACb,8EAA8E;IAE9E;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CACP,IAAY,EACZ,UAAmD,EAAE;QAErD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAsB,EAAE,CAAC;QAErC,8DAA8D;QAC9D,MAAM,mBAAmB,GAAa,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAExD,IAAI,CAAC;YACH,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC;gBACrD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAE9B,mDAAmD;gBACnD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;gBAE3E,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;oBACjC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,IAAI,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBAEvE,MAAM,CAAC,IAAI,CAAC;wBACV,KAAK;wBACL,QAAQ;wBACR,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU;qBAClC,CAAC,CAAC;oBAEH,OAAO;wBACL,QAAQ;wBACR,MAAM;wBACN,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;wBACrC,WAAW,EAAE,IAAI,IAAI,EAAE;wBACvB,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;gBAED,6BAA6B;gBAC7B,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU,IAAI,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;oBAC1E,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;wBAC5C,MAAM,IAAI,KAAK,CACb,eAAe,IAAI,CAAC,IAAI,uCAAuC,QAAQ,CAAC,MAAM,KAAK;4BACjF,sBAAsB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClD,CAAC;oBACJ,CAAC;oBAED,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE;wBACjF,SAAS,EAAE,OAAO,CAAC,SAAS;wBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;qBACvB,CAAC,CAAC;oBAEH,oDAAoD;oBACpD,mBAAmB,CAAC,IAAI,CACtB,SAAS,KAAK,cAAc,QAAQ,CAAC,MAAM,IAAI;wBAC7C,YAAY,QAAQ,CAAC,OAAO,IAAI;wBAChC,WAAW,YAAY,CAAC,QAAQ,IAAI,eAAe,EAAE,CACxD,CAAC;oBAEF,MAAM,CAAC,IAAI,CAAC;wBACV,KAAK;wBACL,QAAQ;wBACR,YAAY;wBACZ,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU;qBAClC,CAAC,CAAC;oBAEH,SAAS;gBACX,CAAC;gBAED,8CAA8C;gBAC9C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC;gBACpE,MAAM;YACR,CAAC;YAED,gDAAgD;YAChD,MAAM,aAAa,GACjB,mBAAmB,CAAC,MAAM,GAAG,CAAC;gBAC5B,CAAC,CAAC,sCAAsC,IAAI,CAAC,SAAS,QAAQ;oBAC5D,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;gBAC3C,CAAC,CAAC,iEAAiE,CAAC;YAExE,OAAO;gBACL,QAAQ,EAAE,aAAa;gBACvB,MAAM;gBACN,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBACrC,WAAW,EAAE,IAAI,IAAI,EAAE;gBACvB,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,QAAQ,EAAE,EAAE;gBACZ,MAAM;gBACN,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBACrC,WAAW,EAAE,IAAI,IAAI,EAAE;gBACvB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAc;aACtB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,uBAAuB;IACvB,8EAA8E;IAEtE,KAAK,CAAC,mBAAmB,CAC/B,YAAoB,EACpB,OAAiB;QAEjB,MAAM,cAAc,GAClB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,8BAA8B,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAE3F,MAAM,WAAW,GACf,kBAAkB,YAAY,GAAG,cAAc,MAAM;YACrD;;;;;;;EAOJ,CAAC;QAEC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;gBAC9C,QAAQ,EAAE;oBACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE;oBAC9C,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE;iBACvC;gBACD,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7C,CAAC,CAAC;YAEH,OAAO,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,8DAA8D;YAC9D,OAAO;gBACL,MAAM,EAAE,QAAQ;gBAChB,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,2CAA2C;gBACtF,OAAO,EAAE,iDAAiD;aAC3D,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,GAAW;QAC/B,wCAAwC;QACxC,MAAM,OAAO,GAAG,GAAG;aAChB,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;aAChC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;aACvB,IAAI,EAAE,CAAC;QAEV,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAuB,CAAC;YAEzD,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC/D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;YACjD,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,6DAA6D;YAC7D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,2BAA2B;IAC3B,8EAA8E;IAEtE,wBAAwB,CAAC,OAA+B;QAC9D,OAAO,CACL,YAAY,IAAI,CAAC,IAAI,gEAAgE;YACrF,0DAA0D;YAC1D,0BAA0B;YAC1B,+CAA+C;YAC/C,2DAA2D;YAC3D,uDAAuD;YACvD,gEAAgE;YAChE,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAC9B,CAAC;IACJ,CAAC;IAEO,eAAe,CAAC,OAA+B;QACrD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACpE,OAAO,uBAAuB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACnD,CAAC;IAED,8EAA8E;IAC9E,gBAAgB;IAChB,8EAA8E;IAE9E,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,WAAW;QACb,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;CACF;AA1OD,0CA0OC"}

package/dist/types/event.types.d.ts

@@ -21,7 +21,20 @@ export declare enum AgentEventType {
     USER_INPUT_REQUESTED = "agent.input.requested",
     USER_INPUT_RECEIVED = "agent.input.received",
     MEMORY_UPDATED = "agent.memory.updated",
-    RAG_QUERY_EXECUTED = "agent.rag.executed"
+    RAG_QUERY_EXECUTED = "agent.rag.executed",
+    GRAPH_STARTED = "graph.started",
+    GRAPH_COMPLETED = "graph.completed",
+    GRAPH_FAILED = "graph.failed",
+    GRAPH_NODE_STARTED = "graph.node.started",
+    GRAPH_NODE_COMPLETED = "graph.node.completed",
+    GRAPH_NODE_FAILED = "graph.node.failed",
+    GRAPH_PARALLEL_STARTED = "graph.parallel.started",
+    GRAPH_PARALLEL_COMPLETED = "graph.parallel.completed",
+    SUPERVISOR_ROUND_STARTED = "supervisor.round.started",
+    SUPERVISOR_DELEGATED = "supervisor.delegated",
+    SUPERVISOR_FINISHED = "supervisor.finished",
+    DELEGATE_STARTED = "agent.delegate.started",
+    DELEGATE_COMPLETED = "agent.delegate.completed"
 }
 /**
  * Base event interface
@@ -120,4 +133,66 @@ export interface RAGQueryEventData {
     topK: number;
     duration: number;
 }
+export interface GraphStartedEventData {
+    graphId: string;
+    executionId: string;
+    input: string;
+}
+export interface GraphCompletedEventData {
+    graphId: string;
+    executionId: string;
+    response?: string;
+    stepCount: number;
+    duration: number;
+}
+export interface GraphFailedEventData {
+    graphId: string;
+    executionId: string;
+    error: Error;
+    stepCount: number;
+    duration: number;
+}
+export interface GraphNodeEventData {
+    graphId: string;
+    executionId: string;
+    nodeId: string;
+    nodeType: string;
+    input?: string;
+    output?: string;
+    duration?: number;
+    error?: string;
+}
+export interface GraphParallelEventData {
+    graphId: string;
+    executionId: string;
+    nodeId: string;
+    branches: string[];
+    duration?: number;
+}
+export interface SupervisorRoundEventData {
+    supervisorName: string;
+    round: number;
+    worker?: string;
+    subtask?: string;
+}
+export interface SupervisorDelegatedEventData {
+    supervisorName: string;
+    round: number;
+    worker: string;
+    subtask: string;
+    result?: string;
+}
+export interface SupervisorFinishedEventData {
+    supervisorName: string;
+    rounds: number;
+    response: string;
+    duration: number;
+}
+export interface DelegateEventData {
+    fromAgent: string;
+    toAgent: string;
+    input: string;
+    response?: string;
+    duration?: number;
+}
 //# sourceMappingURL=event.types.d.ts.map

package/dist/types/event.types.d.ts.map

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

package/dist/types/event.types.js

@@ -26,5 +26,21 @@ var AgentEventType;
     AgentEventType["USER_INPUT_RECEIVED"] = "agent.input.received";
     AgentEventType["MEMORY_UPDATED"] = "agent.memory.updated";
     AgentEventType["RAG_QUERY_EXECUTED"] = "agent.rag.executed";
+    // Graph orchestration events
+    AgentEventType["GRAPH_STARTED"] = "graph.started";
+    AgentEventType["GRAPH_COMPLETED"] = "graph.completed";
+    AgentEventType["GRAPH_FAILED"] = "graph.failed";
+    AgentEventType["GRAPH_NODE_STARTED"] = "graph.node.started";
+    AgentEventType["GRAPH_NODE_COMPLETED"] = "graph.node.completed";
+    AgentEventType["GRAPH_NODE_FAILED"] = "graph.node.failed";
+    AgentEventType["GRAPH_PARALLEL_STARTED"] = "graph.parallel.started";
+    AgentEventType["GRAPH_PARALLEL_COMPLETED"] = "graph.parallel.completed";
+    // Supervisor events
+    AgentEventType["SUPERVISOR_ROUND_STARTED"] = "supervisor.round.started";
+    AgentEventType["SUPERVISOR_DELEGATED"] = "supervisor.delegated";
+    AgentEventType["SUPERVISOR_FINISHED"] = "supervisor.finished";
+    // Agent delegation events (agent-as-tool)
+    AgentEventType["DELEGATE_STARTED"] = "agent.delegate.started";
+    AgentEventType["DELEGATE_COMPLETED"] = "agent.delegate.completed";
 })(AgentEventType || (exports.AgentEventType = AgentEventType = {}));
 //# sourceMappingURL=event.types.js.map

package/dist/types/event.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"event.types.js","sourceRoot":"","sources":["../../src/types/event.types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;GAEG;AACH,IAAY,cAkBX;AAlBD,WAAY,cAAc;IACxB,+DAA6C,CAAA;IAC7C,mEAAiD,CAAA;IACjD,6DAA2C,CAAA;IAC3C,qDAAmC,CAAA;IACnC,yDAAuC,CAAA;IACvC,mDAAiC,CAAA;IACjC,uDAAqC,CAAA;IACrC,mEAAiD,CAAA;IACjD,uEAAqD,CAAA;IACrD,iEAA+C,CAAA;IAC/C,qEAAmD,CAAA;IACnD,iEAA+C,CAAA;IAC/C,+DAA6C,CAAA;IAC7C,gEAA8C,CAAA;IAC9C,8DAA4C,CAAA;IAC5C,yDAAuC,CAAA;IACvC,2DAAyC,CAAA;AAC3C,CAAC,EAlBW,cAAc,8BAAd,cAAc,QAkBzB"}
+{"version":3,"file":"event.types.js","sourceRoot":"","sources":["../../src/types/event.types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH;;GAEG;AACH,IAAY,cAqCX;AArCD,WAAY,cAAc;IACxB,+DAA6C,CAAA;IAC7C,mEAAiD,CAAA;IACjD,6DAA2C,CAAA;IAC3C,qDAAmC,CAAA;IACnC,yDAAuC,CAAA;IACvC,mDAAiC,CAAA;IACjC,uDAAqC,CAAA;IACrC,mEAAiD,CAAA;IACjD,uEAAqD,CAAA;IACrD,iEAA+C,CAAA;IAC/C,qEAAmD,CAAA;IACnD,iEAA+C,CAAA;IAC/C,+DAA6C,CAAA;IAC7C,gEAA8C,CAAA;IAC9C,8DAA4C,CAAA;IAC5C,yDAAuC,CAAA;IACvC,2DAAyC,CAAA;IAEzC,6BAA6B;IAC7B,iDAA+B,CAAA;IAC/B,qDAAmC,CAAA;IACnC,+CAA6B,CAAA;IAC7B,2DAAyC,CAAA;IACzC,+DAA6C,CAAA;IAC7C,yDAAuC,CAAA;IACvC,mEAAiD,CAAA;IACjD,uEAAqD,CAAA;IAErD,oBAAoB;IACpB,uEAAqD,CAAA;IACrD,+DAA6C,CAAA;IAC7C,6DAA2C,CAAA;IAE3C,0CAA0C;IAC1C,6DAA2C,CAAA;IAC3C,iEAA+C,CAAA;AACjD,CAAC,EArCW,cAAc,8BAAd,cAAc,QAqCzB"}

package/logs/combined.log

@@ -1 +1 @@
-2026-03-05 13:36:30 [INFO] Application started | {"service":"hazeljs","version":"0.1.0","environment":"test"}
+2026-03-05 18:39:34 [INFO] Application started | {"service":"hazeljs","version":"0.1.0","environment":"test"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hazeljs/agent",
-  "version": "0.2.0-beta.60",
+  "version": "0.2.0-beta.61",
   "description": "AI-native Agent Runtime for HazelJS - stateful, long-running agents with tools, memory, and human-in-the-loop",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -30,9 +30,9 @@
     "directory": "packages/agent"
   },
   "dependencies": {
-    "@hazeljs/core": "^0.2.0-beta.60",
-    "@hazeljs/rag": "^0.2.0-beta.60",
-    "@hazeljs/resilience": "^0.2.0-beta.60",
+    "@hazeljs/core": "^0.2.0-beta.61",
+    "@hazeljs/rag": "^0.2.0-beta.61",
+    "@hazeljs/resilience": "^0.2.0-beta.61",
     "reflect-metadata": "^0.2.1"
   },
   "devDependencies": {
@@ -66,5 +66,5 @@
     "url": "https://github.com/hazeljs/hazel-js/issues"
   },
   "homepage": "https://hazeljs.com",
-  "gitHead": "8cd6f3cf5b77aba504ec10691324937130feb2c3"
+  "gitHead": "2205447dd2f88f83a7748b0ffdee0417be0f3970"
 }