@hazeljs/agent 0.2.0-alpha.1

package/dist/graph/agent-graph.types.d.ts

@@ -0,0 +1,210 @@
+/**
+ * AgentGraph Types
+ * Type definitions for the multi-agent orchestration graph system
+ */
+import { AgentExecutionResult } from '../types/agent.types';
+/** Sentinel value marking the end of a graph execution */
+export declare const END: "__end__";
+export type GraphEndSymbol = typeof END;
+/** Message that flows through the graph between nodes */
+export interface GraphMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    /** The node that produced this message */
+    nodeId?: string;
+    timestamp?: Date;
+}
+/**
+ * The shared state object that flows through every node in the graph.
+ * Nodes read from it, transform it, and return a partial update.
+ */
+export interface GraphState {
+    /** The original user input that kicked off the graph */
+    input: string;
+    /** The most recent output produced by any node */
+    output?: string;
+    /** Full message history for the graph run */
+    messages: GraphMessage[];
+    /** Arbitrary key-value store for inter-node data sharing */
+    data: Record<string, unknown>;
+    /** Full AgentExecutionResult keyed by node ID */
+    nodeResults: Record<string, AgentExecutionResult>;
+    /** ID of the node currently being executed */
+    currentNode?: string;
+    /** Set if the graph encountered an unrecoverable error */
+    error?: Error;
+    /** Graph-level metadata (execution ID, options, etc.) */
+    metadata?: Record<string, unknown>;
+}
+/** A node that runs a registered agent by name */
+export interface AgentNodeConfig {
+    type: 'agent';
+    /** The name of the agent as registered with AgentRuntime */
+    agentName: string;
+    /**
+     * Optional: transform graph state → agent input string.
+     * Defaults to `state.input` when not provided.
+     */
+    inputMapper?: (state: GraphState) => string;
+    /**
+     * Optional: transform agent result + previous state → new state.
+     * Defaults to setting `state.output = result.response`.
+     */
+    outputMapper?: (result: AgentExecutionResult, state: GraphState) => Partial<GraphState>;
+}
+/** A node that runs an arbitrary async function */
+export interface FunctionNodeConfig {
+    type: 'function';
+    /** Must return a (possibly partial) GraphState update */
+    fn: (state: GraphState) => Promise<Partial<GraphState>> | Partial<GraphState>;
+}
+/**
+ * A node that fans-out to multiple child nodes in parallel,
+ * waits for all of them, then merges their results.
+ */
+export interface ParallelNodeConfig {
+    type: 'parallel';
+    /** IDs of nodes to execute concurrently */
+    branches: string[];
+    /**
+     * Optional: merge all branch outputs into the final state.
+     * Defaults to concatenating each branch's `output` with a separator.
+     */
+    mergeStrategy?: (results: ParallelBranchResult[], base: GraphState) => Partial<GraphState>;
+}
+export type GraphNodeConfig = AgentNodeConfig | FunctionNodeConfig | ParallelNodeConfig;
+/** Internal node representation */
+export interface GraphNode {
+    id: string;
+    config: GraphNodeConfig;
+}
+/**
+ * Router function: inspects the current state and returns the ID of the next
+ * node (or `END` to stop the graph).
+ */
+export type RouterFunction = (state: GraphState) => string | GraphEndSymbol;
+export interface GraphEdge {
+    from: string;
+    /** Fixed target node ID (or END). Mutually exclusive with `condition`. */
+    to?: string | GraphEndSymbol;
+    /** Conditional routing function. Mutually exclusive with `to`. */
+    condition?: RouterFunction;
+}
+export interface GraphExecutionOptions {
+    sessionId?: string;
+    userId?: string;
+    /** Maximum number of node executions before aborting (default: 50) */
+    maxSteps?: number;
+    /** Timeout in ms for the entire graph run (default: 600_000) */
+    timeout?: number;
+    /** Seed data merged into `state.data` before the run starts */
+    initialData?: Record<string, unknown>;
+}
+/** Per-node step record within a graph execution */
+export interface GraphStep {
+    id: string;
+    nodeId: string;
+    nodeType: GraphNodeConfig['type'];
+    /** Input string seen by this node */
+    input: string;
+    /** Output produced by this node */
+    output?: string;
+    duration: number;
+    timestamp: Date;
+    /** For parallel nodes: IDs of branches executed */
+    parallelBranches?: string[];
+    error?: string;
+}
+export interface GraphExecutionResult {
+    graphId: string;
+    executionId: string;
+    /** Final state after all nodes have run */
+    state: GraphState;
+    /** Convenience alias for `state.output` */
+    response?: string;
+    steps: GraphStep[];
+    /** Full agent results keyed by node ID */
+    nodeExecutions: Record<string, AgentExecutionResult>;
+    duration: number;
+    completedAt: Date;
+    success: boolean;
+    error?: Error;
+}
+/** Emitted for each node during a streaming graph execution */
+export interface GraphStreamChunk {
+    executionId: string;
+    nodeId: string;
+    nodeType: GraphNodeConfig['type'];
+    /** Incremental content delta (may be empty for non-streaming nodes) */
+    chunk: string;
+    /** Full output of this node once it completes */
+    nodeOutput?: string;
+    done: boolean;
+}
+export interface ParallelBranchResult {
+    nodeId: string;
+    state: GraphState;
+    agentResult?: AgentExecutionResult;
+    error?: Error;
+}
+export interface SupervisorConfig {
+    /** Display name for this supervisor instance */
+    name: string;
+    /** Names of worker agents available for delegation */
+    workers: string[];
+    /**
+     * Optional override for the supervisor system prompt.
+     * The workers list is always appended automatically.
+     */
+    systemPrompt?: string;
+    /** Maximum routing rounds before the supervisor gives up (default: 10) */
+    maxRounds?: number;
+    /** Model to use for supervisor routing decisions */
+    model?: string;
+    temperature?: number;
+}
+export interface SupervisorWorkerInfo {
+    name: string;
+    description?: string;
+}
+/** Routing decision returned by the LLM */
+export interface SupervisorDecision {
+    /** 'delegate' to route to a worker, 'finish' to return a final answer */
+    action: 'delegate' | 'finish';
+    /** When action === 'delegate': target worker agent name */
+    worker?: string;
+    /** When action === 'delegate': the subtask for the worker */
+    subtask?: string;
+    /** When action === 'finish': the final response to the user */
+    response?: string;
+    /** Supervisor's internal reasoning */
+    thought?: string;
+}
+export interface SupervisorResult {
+    response: string;
+    rounds: SupervisorRound[];
+    totalDuration: number;
+    completedAt: Date;
+    success: boolean;
+    error?: Error;
+}
+export interface SupervisorRound {
+    round: number;
+    decision: SupervisorDecision;
+    workerResult?: AgentExecutionResult;
+    duration: number;
+}
+export interface DelegateConfig {
+    /** The agent name (as registered with AgentRuntime) to delegate to */
+    agent: string;
+    /** Human-readable description used as the tool description for the LLM */
+    description: string;
+    /**
+     * Which key in the tool call's arguments object contains the text
+     * passed as `input` to the target agent.  Defaults to 'input'.
+     */
+    inputField?: string;
+}
+export declare const DELEGATE_METADATA_KEY: unique symbol;
+export declare const DELEGATES_LIST_KEY: unique symbol;
+//# sourceMappingURL=agent-graph.types.d.ts.map

package/dist/graph/agent-graph.types.d.ts.map

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

package/dist/graph/agent-graph.types.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * AgentGraph Types
+ * Type definitions for the multi-agent orchestration graph system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DELEGATES_LIST_KEY = exports.DELEGATE_METADATA_KEY = exports.END = void 0;
+/** Sentinel value marking the end of a graph execution */
+exports.END = '__end__';
+exports.DELEGATE_METADATA_KEY = Symbol('hazel:delegate');
+exports.DELEGATES_LIST_KEY = Symbol('hazel:delegates');
+//# sourceMappingURL=agent-graph.types.js.map

package/dist/graph/agent-graph.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-graph.types.js","sourceRoot":"","sources":["../../src/graph/agent-graph.types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,0DAA0D;AAC7C,QAAA,GAAG,GAAG,SAAkB,CAAC;AA0PzB,QAAA,qBAAqB,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC;AACjD,QAAA,kBAAkB,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @hazeljs/agent
+ * AI-native Agent Runtime for HazelJS
+ */
+export * from './types/agent.types';
+export * from './types/tool.types';
+export * from './types/event.types';
+export * from './types/llm.types';
+export * from './types/rag.types';
+export * from './decorators/agent.decorator';
+export * from './decorators/tool.decorator';
+export * from './decorators/delegate.decorator';
+export * from './registry/agent.registry';
+export * from './registry/tool.registry';
+export * from './state/agent.state';
+export * from './state/agent-state.interface';
+export * from './state/redis-state.manager';
+export * from './state/database-state.manager';
+export * from './context/agent.context';
+export * from './executor/agent.executor';
+export * from './executor/tool.executor';
+export * from './events/event.emitter';
+export * from './runtime/agent.runtime';
+export * from './utils/rate-limiter';
+export * from './utils/logger';
+export * from './utils/metrics';
+export * from './utils/retry';
+export * from './utils/circuit-breaker';
+export * from './utils/health-check';
+export * from './graph/agent-graph.types';
+export * from './graph/agent-graph';
+export * from './supervisor/supervisor';
+export * from './agent.module';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAElC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAEhD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AAEzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AAExC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AAEzC,cAAc,wBAAwB,CAAC;AAEvC,cAAc,yBAAyB,CAAC;AAExC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AAExC,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,51 @@
+"use strict";
+/**
+ * @hazeljs/agent
+ * AI-native Agent Runtime for HazelJS
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types/agent.types"), exports);
+__exportStar(require("./types/tool.types"), exports);
+__exportStar(require("./types/event.types"), exports);
+__exportStar(require("./types/llm.types"), exports);
+__exportStar(require("./types/rag.types"), exports);
+__exportStar(require("./decorators/agent.decorator"), exports);
+__exportStar(require("./decorators/tool.decorator"), exports);
+__exportStar(require("./decorators/delegate.decorator"), exports);
+__exportStar(require("./registry/agent.registry"), exports);
+__exportStar(require("./registry/tool.registry"), exports);
+__exportStar(require("./state/agent.state"), exports);
+__exportStar(require("./state/agent-state.interface"), exports);
+__exportStar(require("./state/redis-state.manager"), exports);
+__exportStar(require("./state/database-state.manager"), exports);
+__exportStar(require("./context/agent.context"), exports);
+__exportStar(require("./executor/agent.executor"), exports);
+__exportStar(require("./executor/tool.executor"), exports);
+__exportStar(require("./events/event.emitter"), exports);
+__exportStar(require("./runtime/agent.runtime"), exports);
+__exportStar(require("./utils/rate-limiter"), exports);
+__exportStar(require("./utils/logger"), exports);
+__exportStar(require("./utils/metrics"), exports);
+__exportStar(require("./utils/retry"), exports);
+__exportStar(require("./utils/circuit-breaker"), exports);
+__exportStar(require("./utils/health-check"), exports);
+// Multi-agent orchestration
+__exportStar(require("./graph/agent-graph.types"), exports);
+__exportStar(require("./graph/agent-graph"), exports);
+__exportStar(require("./supervisor/supervisor"), exports);
+__exportStar(require("./agent.module"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,sDAAoC;AACpC,qDAAmC;AACnC,sDAAoC;AACpC,oDAAkC;AAClC,oDAAkC;AAElC,+DAA6C;AAC7C,8DAA4C;AAC5C,kEAAgD;AAEhD,4DAA0C;AAC1C,2DAAyC;AAEzC,sDAAoC;AACpC,gEAA8C;AAC9C,8DAA4C;AAC5C,iEAA+C;AAC/C,0DAAwC;AAExC,4DAA0C;AAC1C,2DAAyC;AAEzC,yDAAuC;AAEvC,0DAAwC;AAExC,uDAAqC;AACrC,iDAA+B;AAC/B,kDAAgC;AAChC,gDAA8B;AAC9B,0DAAwC;AACxC,uDAAqC;AAErC,4BAA4B;AAC5B,4DAA0C;AAC1C,sDAAoC;AACpC,0DAAwC;AAExC,iDAA+B"}

package/dist/prompts/agent-system.prompt.d.ts

@@ -0,0 +1,10 @@
+import { PromptTemplate } from '@hazeljs/prompts';
+export declare const AGENT_SYSTEM_KEY = "agent:system";
+export interface AgentSystemVariables {
+    systemPrompt: string;
+    description: string;
+    ragContext: string;
+}
+declare const template: PromptTemplate<AgentSystemVariables>;
+export { template as agentSystemPrompt };
+//# sourceMappingURL=agent-system.prompt.d.ts.map

package/dist/prompts/agent-system.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-system.prompt.d.ts","sourceRoot":"","sources":["../../src/prompts/agent-system.prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAkB,MAAM,kBAAkB,CAAC;AAElE,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,QAAA,MAAM,QAAQ,sCAYb,CAAC;AAIF,OAAO,EAAE,QAAQ,IAAI,iBAAiB,EAAE,CAAC"}

package/dist/prompts/agent-system.prompt.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.agentSystemPrompt = exports.AGENT_SYSTEM_KEY = void 0;
+const prompts_1 = require("@hazeljs/prompts");
+exports.AGENT_SYSTEM_KEY = 'agent:system';
+const template = new prompts_1.PromptTemplate(`{systemPrompt}
+
+Agent description: {description}
+
+Relevant context:
+{ragContext}`, {
+    name: 'Agent System Prompt',
+    description: 'Assembles the main system prompt for an agent from its config and RAG context',
+    version: '1.0.0',
+});
+exports.agentSystemPrompt = template;
+prompts_1.PromptRegistry.register(exports.AGENT_SYSTEM_KEY, template);
+//# sourceMappingURL=agent-system.prompt.js.map

package/dist/prompts/agent-system.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-system.prompt.js","sourceRoot":"","sources":["../../src/prompts/agent-system.prompt.ts"],"names":[],"mappings":";;;AAAA,8CAAkE;AAErD,QAAA,gBAAgB,GAAG,cAAc,CAAC;AAQ/C,MAAM,QAAQ,GAAG,IAAI,wBAAc,CACjC;;;;;aAKW,EACX;IACE,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,+EAA+E;IAC5F,OAAO,EAAE,OAAO;CACjB,CACF,CAAC;AAImB,qCAAiB;AAFtC,wBAAc,CAAC,QAAQ,CAAC,wBAAgB,EAAE,QAAQ,CAAC,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,4 @@
+export * from './agent-system.prompt';
+export * from './supervisor-system.prompt';
+export * from './supervisor-routing.prompt';
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC"}

package/dist/prompts/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./agent-system.prompt"), exports);
+__exportStar(require("./supervisor-system.prompt"), exports);
+__exportStar(require("./supervisor-routing.prompt"), exports);
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,6DAA2C;AAC3C,8DAA4C"}

package/dist/prompts/supervisor-routing.prompt.d.ts

@@ -0,0 +1,9 @@
+import { PromptTemplate } from '@hazeljs/prompts';
+export declare const SUPERVISOR_ROUTING_KEY = "agent:supervisor:routing";
+export interface SupervisorRoutingVariables {
+    originalTask: string;
+    contextSummary: string;
+}
+declare const template: PromptTemplate<SupervisorRoutingVariables>;
+export { template as supervisorRoutingPrompt };
+//# sourceMappingURL=supervisor-routing.prompt.d.ts.map

package/dist/prompts/supervisor-routing.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-routing.prompt.d.ts","sourceRoot":"","sources":["../../src/prompts/supervisor-routing.prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAkB,MAAM,kBAAkB,CAAC;AAElE,eAAO,MAAM,sBAAsB,6BAA6B,CAAC;AAEjE,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,QAAA,MAAM,QAAQ,4CAgBb,CAAC;AAIF,OAAO,EAAE,QAAQ,IAAI,uBAAuB,EAAE,CAAC"}

package/dist/prompts/supervisor-routing.prompt.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.supervisorRoutingPrompt = exports.SUPERVISOR_ROUTING_KEY = void 0;
+const prompts_1 = require("@hazeljs/prompts");
+exports.SUPERVISOR_ROUTING_KEY = 'agent:supervisor:routing';
+const template = new prompts_1.PromptTemplate(`Original task: {originalTask}{contextSummary}
+
+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
+}`, {
+    name: 'Supervisor Routing Decision',
+    description: 'Prompts the supervisor LLM to decide whether to delegate or finish',
+    version: '1.0.0',
+});
+exports.supervisorRoutingPrompt = template;
+prompts_1.PromptRegistry.register(exports.SUPERVISOR_ROUTING_KEY, template);
+//# sourceMappingURL=supervisor-routing.prompt.js.map

package/dist/prompts/supervisor-routing.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-routing.prompt.js","sourceRoot":"","sources":["../../src/prompts/supervisor-routing.prompt.ts"],"names":[],"mappings":";;;AAAA,8CAAkE;AAErD,QAAA,sBAAsB,GAAG,0BAA0B,CAAC;AAOjE,MAAM,QAAQ,GAAG,IAAI,wBAAc,CACjC;;;;;;;;;EASA,EACA;IACE,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE,oEAAoE;IACjF,OAAO,EAAE,OAAO;CACjB,CACF,CAAC;AAImB,2CAAuB;AAF5C,wBAAc,CAAC,QAAQ,CAAC,8BAAsB,EAAE,QAAQ,CAAC,CAAC"}

package/dist/prompts/supervisor-system.prompt.d.ts

@@ -0,0 +1,9 @@
+import { PromptTemplate } from '@hazeljs/prompts';
+export declare const SUPERVISOR_SYSTEM_KEY = "agent:supervisor:system";
+export interface SupervisorSystemVariables {
+    name: string;
+    workerList: string;
+}
+declare const template: PromptTemplate<SupervisorSystemVariables>;
+export { template as supervisorSystemPrompt };
+//# sourceMappingURL=supervisor-system.prompt.d.ts.map

package/dist/prompts/supervisor-system.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-system.prompt.d.ts","sourceRoot":"","sources":["../../src/prompts/supervisor-system.prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAkB,MAAM,kBAAkB,CAAC;AAElE,eAAO,MAAM,qBAAqB,4BAA4B,CAAC;AAE/D,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,QAAA,MAAM,QAAQ,2CAeb,CAAC;AAIF,OAAO,EAAE,QAAQ,IAAI,sBAAsB,EAAE,CAAC"}

package/dist/prompts/supervisor-system.prompt.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.supervisorSystemPrompt = exports.SUPERVISOR_SYSTEM_KEY = void 0;
+const prompts_1 = require("@hazeljs/prompts");
+exports.SUPERVISOR_SYSTEM_KEY = 'agent:supervisor:system';
+const template = new prompts_1.PromptTemplate(`You are "{name}", a supervisor agent responsible for orchestrating a team of specialized worker agents to complete complex tasks.
+
+Your responsibilities:
+1. Break down the user's task into subtasks
+2. Delegate each subtask to the most appropriate worker
+3. Review worker results and decide what to do next
+4. When all subtasks are done, synthesize a final response
+
+{workerList}`, {
+    name: 'Supervisor System Prompt',
+    description: 'Default system prompt for a supervisor agent with worker list',
+    version: '1.0.0',
+});
+exports.supervisorSystemPrompt = template;
+prompts_1.PromptRegistry.register(exports.SUPERVISOR_SYSTEM_KEY, template);
+//# sourceMappingURL=supervisor-system.prompt.js.map

package/dist/prompts/supervisor-system.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-system.prompt.js","sourceRoot":"","sources":["../../src/prompts/supervisor-system.prompt.ts"],"names":[],"mappings":";;;AAAA,8CAAkE;AAErD,QAAA,qBAAqB,GAAG,yBAAyB,CAAC;AAO/D,MAAM,QAAQ,GAAG,IAAI,wBAAc,CACjC;;;;;;;;aAQW,EACX;IACE,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE,+DAA+D;IAC5E,OAAO,EAAE,OAAO;CACjB,CACF,CAAC;AAImB,0CAAsB;AAF3C,wBAAc,CAAC,QAAQ,CAAC,6BAAqB,EAAE,QAAQ,CAAC,CAAC"}

package/dist/registry/agent.registry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Agent Registry
+ * Central registry for all agents in the system
+ */
+import { AgentMetadata } from '../types/agent.types';
+/**
+ * Agent Registry - manages agent registration and lookup
+ */
+export declare class AgentRegistry {
+    private agents;
+    private instances;
+    /**
+     * Register an agent class
+     */
+    register(agentClass: new (...args: unknown[]) => unknown): void;
+    /**
+     * Register an agent instance
+     */
+    registerInstance(agentName: string, instance: unknown): void;
+    /**
+     * Get agent metadata by name
+     */
+    getAgent(name: string): AgentMetadata | undefined;
+    /**
+     * Get agent instance by name
+     */
+    getInstance(name: string): unknown | undefined;
+    /**
+     * Get all registered agents
+     */
+    getAllAgents(): AgentMetadata[];
+    /**
+     * Check if an agent is registered
+     */
+    hasAgent(name: string): boolean;
+    /**
+     * Unregister an agent
+     */
+    unregister(name: string): void;
+    /**
+     * Clear all agents
+     */
+    clear(): void;
+    /**
+     * Get agent count
+     */
+    get count(): number;
+}
+//# sourceMappingURL=agent.registry.d.ts.map

package/dist/registry/agent.registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.registry.d.ts","sourceRoot":"","sources":["../../src/registry/agent.registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,SAAS,CAAmC;IAEpD;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,GAAG,IAAI;IAiB/D;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI;IAW5D;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIjD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI9C;;OAEG;IACH,YAAY,IAAI,aAAa,EAAE;IAI/B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK9B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;CACF"}

package/dist/registry/agent.registry.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * Agent Registry
+ * Central registry for all agents in the system
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentRegistry = void 0;
+const agent_decorator_1 = require("../decorators/agent.decorator");
+/**
+ * Agent Registry - manages agent registration and lookup
+ */
+class AgentRegistry {
+    constructor() {
+        this.agents = new Map();
+        this.instances = new Map();
+    }
+    /**
+     * Register an agent class
+     */
+    register(agentClass) {
+        if (!(0, agent_decorator_1.isAgent)(agentClass)) {
+            throw new Error(`Class ${agentClass.name} is not decorated with @Agent`);
+        }
+        const metadata = (0, agent_decorator_1.getAgentMetadata)(agentClass);
+        if (!metadata) {
+            throw new Error(`Failed to get metadata for agent ${agentClass.name}`);
+        }
+        if (this.agents.has(metadata.name)) {
+            throw new Error(`Agent ${metadata.name} is already registered`);
+        }
+        this.agents.set(metadata.name, metadata);
+    }
+    /**
+     * Register an agent instance
+     */
+    registerInstance(agentName, instance) {
+        if (!this.agents.has(agentName)) {
+            throw new Error(`Agent ${agentName} is not registered`);
+        }
+        this.instances.set(agentName, instance);
+        const metadata = this.agents.get(agentName);
+        metadata.instance = instance;
+    }
+    /**
+     * Get agent metadata by name
+     */
+    getAgent(name) {
+        return this.agents.get(name);
+    }
+    /**
+     * Get agent instance by name
+     */
+    getInstance(name) {
+        return this.instances.get(name);
+    }
+    /**
+     * Get all registered agents
+     */
+    getAllAgents() {
+        return Array.from(this.agents.values());
+    }
+    /**
+     * Check if an agent is registered
+     */
+    hasAgent(name) {
+        return this.agents.has(name);
+    }
+    /**
+     * Unregister an agent
+     */
+    unregister(name) {
+        this.agents.delete(name);
+        this.instances.delete(name);
+    }
+    /**
+     * Clear all agents
+     */
+    clear() {
+        this.agents.clear();
+        this.instances.clear();
+    }
+    /**
+     * Get agent count
+     */
+    get count() {
+        return this.agents.size;
+    }
+}
+exports.AgentRegistry = AgentRegistry;
+//# sourceMappingURL=agent.registry.js.map

package/dist/registry/agent.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.registry.js","sourceRoot":"","sources":["../../src/registry/agent.registry.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAGH,mEAA0E;AAE1E;;GAEG;AACH,MAAa,aAAa;IAA1B;QACU,WAAM,GAA+B,IAAI,GAAG,EAAE,CAAC;QAC/C,cAAS,GAAyB,IAAI,GAAG,EAAE,CAAC;IAsFtD,CAAC;IApFC;;OAEG;IACH,QAAQ,CAAC,UAA+C;QACtD,IAAI,CAAC,IAAA,yBAAO,EAAC,UAAU,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,SAAS,UAAU,CAAC,IAAI,+BAA+B,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,QAAQ,GAAG,IAAA,kCAAgB,EAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,oCAAoC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,SAAS,QAAQ,CAAC,IAAI,wBAAwB,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,SAAiB,EAAE,QAAiB;QACnD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,SAAS,SAAS,oBAAoB,CAAC,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAExC,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;QAC7C,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;CACF;AAxFD,sCAwFC"}