@hazeljs/agent 0.2.0-alpha.1

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

@@ -0,0 +1,166 @@
+/**
+ * Core Agent Runtime Types
+ */
+/** Guardrails service interface (from @hazeljs/guardrails when available) */
+export interface IGuardrailsService {
+    checkInput(input: string | object, options?: unknown): {
+        allowed: boolean;
+        modified?: string | object;
+        violations?: string[];
+        blockedReason?: string;
+    };
+    checkOutput(output: string | object, options?: unknown): {
+        allowed: boolean;
+        modified?: string | object;
+        violations?: string[];
+        blockedReason?: string;
+    };
+}
+/**
+ * Agent execution state
+ */
+export declare enum AgentState {
+    IDLE = "idle",
+    THINKING = "thinking",
+    USING_TOOL = "using_tool",
+    WAITING_FOR_INPUT = "waiting_for_input",
+    WAITING_FOR_APPROVAL = "waiting_for_approval",
+    COMPLETED = "completed",
+    FAILED = "failed"
+}
+/**
+ * Agent execution step
+ */
+export interface AgentStep {
+    id: string;
+    agentId: string;
+    executionId: string;
+    stepNumber: number;
+    state: AgentState;
+    action?: AgentAction;
+    result?: AgentStepResult;
+    error?: Error;
+    timestamp: Date;
+    duration?: number;
+}
+/**
+ * Agent action types
+ */
+export declare enum AgentActionType {
+    THINK = "think",
+    USE_TOOL = "use_tool",
+    ASK_USER = "ask_user",
+    RESPOND = "respond",
+    WAIT = "wait",
+    COMPLETE = "complete"
+}
+/**
+ * Agent action
+ */
+export interface AgentAction {
+    type: AgentActionType;
+    toolName?: string;
+    toolInput?: Record<string, unknown>;
+    thought?: string;
+    question?: string;
+    response?: string;
+    waitReason?: string;
+}
+/**
+ * Agent step result
+ */
+export interface AgentStepResult {
+    success: boolean;
+    output?: unknown;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Agent execution context
+ */
+export interface AgentContext {
+    executionId: string;
+    agentId: string;
+    sessionId: string;
+    userId?: string;
+    input: string;
+    state: AgentState;
+    steps: AgentStep[];
+    memory: AgentMemoryContext;
+    ragContext?: string[];
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Agent memory context
+ */
+export interface AgentMemoryContext {
+    conversationHistory: Array<{
+        role: 'user' | 'assistant' | 'system' | 'tool';
+        content: string;
+        timestamp: Date;
+    }>;
+    workingMemory: Record<string, unknown>;
+    facts: string[];
+    entities: Array<{
+        name: string;
+        type: string;
+        attributes: Record<string, unknown>;
+    }>;
+}
+/**
+ * Agent configuration
+ */
+export interface AgentConfig {
+    name: string;
+    description?: string;
+    systemPrompt?: string;
+    model?: string;
+    maxSteps?: number;
+    maxThinkingTime?: number;
+    temperature?: number;
+    enableMemory?: boolean;
+    enableRAG?: boolean;
+    ragTopK?: number;
+    tools?: string[];
+    policies?: string[];
+    metadata?: Record<string, unknown>;
+}
+type NewableFunction = new (...args: unknown[]) => unknown;
+/**
+ * Agent metadata stored via decorator
+ */
+export interface AgentMetadata extends AgentConfig {
+    target: NewableFunction;
+    instance?: unknown;
+}
+/**
+ * Agent execution options
+ */
+export interface AgentExecutionOptions {
+    sessionId?: string;
+    userId?: string;
+    maxSteps?: number;
+    timeout?: number;
+    enableMemory?: boolean;
+    enableRAG?: boolean;
+    initialContext?: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Agent execution result
+ */
+export interface AgentExecutionResult {
+    executionId: string;
+    agentId: string;
+    state: AgentState;
+    response?: string;
+    steps: AgentStep[];
+    error?: Error;
+    metadata: Record<string, unknown>;
+    duration: number;
+    completedAt: Date;
+}
+export {};
+//# sourceMappingURL=agent.types.d.ts.map

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

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

package/dist/types/agent.types.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * Core Agent Runtime Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentActionType = exports.AgentState = void 0;
+/**
+ * Agent execution state
+ */
+var AgentState;
+(function (AgentState) {
+    AgentState["IDLE"] = "idle";
+    AgentState["THINKING"] = "thinking";
+    AgentState["USING_TOOL"] = "using_tool";
+    AgentState["WAITING_FOR_INPUT"] = "waiting_for_input";
+    AgentState["WAITING_FOR_APPROVAL"] = "waiting_for_approval";
+    AgentState["COMPLETED"] = "completed";
+    AgentState["FAILED"] = "failed";
+})(AgentState || (exports.AgentState = AgentState = {}));
+/**
+ * Agent action types
+ */
+var AgentActionType;
+(function (AgentActionType) {
+    AgentActionType["THINK"] = "think";
+    AgentActionType["USE_TOOL"] = "use_tool";
+    AgentActionType["ASK_USER"] = "ask_user";
+    AgentActionType["RESPOND"] = "respond";
+    AgentActionType["WAIT"] = "wait";
+    AgentActionType["COMPLETE"] = "complete";
+})(AgentActionType || (exports.AgentActionType = AgentActionType = {}));
+//# sourceMappingURL=agent.types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.types.js","sourceRoot":"","sources":["../../src/types/agent.types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAwBH;;GAEG;AACH,IAAY,UAQX;AARD,WAAY,UAAU;IACpB,2BAAa,CAAA;IACb,mCAAqB,CAAA;IACrB,uCAAyB,CAAA;IACzB,qDAAuC,CAAA;IACvC,2DAA6C,CAAA;IAC7C,qCAAuB,CAAA;IACvB,+BAAiB,CAAA;AACnB,CAAC,EARW,UAAU,0BAAV,UAAU,QAQrB;AAkBD;;GAEG;AACH,IAAY,eAOX;AAPD,WAAY,eAAe;IACzB,kCAAe,CAAA;IACf,wCAAqB,CAAA;IACrB,wCAAqB,CAAA;IACrB,sCAAmB,CAAA;IACnB,gCAAa,CAAA;IACb,wCAAqB,CAAA;AACvB,CAAC,EAPW,eAAe,+BAAf,eAAe,QAO1B"}

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

@@ -0,0 +1,198 @@
+/**
+ * Agent Runtime Event Types
+ */
+/**
+ * Event types emitted by the agent runtime
+ */
+export declare enum AgentEventType {
+    EXECUTION_STARTED = "agent.execution.started",
+    EXECUTION_COMPLETED = "agent.execution.completed",
+    EXECUTION_FAILED = "agent.execution.failed",
+    STEP_STARTED = "agent.step.started",
+    STEP_COMPLETED = "agent.step.completed",
+    STEP_FAILED = "agent.step.failed",
+    STATE_CHANGED = "agent.state.changed",
+    TOOL_EXECUTION_STARTED = "tool.execution.started",
+    TOOL_EXECUTION_COMPLETED = "tool.execution.completed",
+    TOOL_EXECUTION_FAILED = "tool.execution.failed",
+    TOOL_APPROVAL_REQUESTED = "tool.approval.requested",
+    TOOL_APPROVAL_GRANTED = "tool.approval.granted",
+    TOOL_APPROVAL_DENIED = "tool.approval.denied",
+    USER_INPUT_REQUESTED = "agent.input.requested",
+    USER_INPUT_RECEIVED = "agent.input.received",
+    MEMORY_UPDATED = "agent.memory.updated",
+    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
+ */
+export interface AgentEvent<T = unknown> {
+    type: AgentEventType;
+    agentId: string;
+    executionId: string;
+    timestamp: Date;
+    data: T;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Execution started event
+ */
+export interface ExecutionStartedEvent {
+    input: string;
+    sessionId: string;
+    userId?: string;
+    options: Record<string, unknown>;
+}
+/**
+ * Execution completed event
+ */
+export interface ExecutionCompletedEvent {
+    response: string;
+    steps: number;
+    duration: number;
+}
+/**
+ * Execution failed event
+ */
+export interface ExecutionFailedEvent {
+    error: Error;
+    step?: number;
+    duration: number;
+}
+/**
+ * Step event data
+ */
+export interface StepEventData {
+    stepNumber: number;
+    state: string;
+    action?: Record<string, unknown>;
+    result?: Record<string, unknown>;
+}
+/**
+ * State changed event
+ */
+export interface StateChangedEvent {
+    previousState: string;
+    newState: string;
+    reason?: string;
+}
+/**
+ * Tool execution event
+ */
+export interface ToolExecutionEventData {
+    toolName: string;
+    input: Record<string, unknown>;
+    output?: unknown;
+    error?: string;
+    duration?: number;
+}
+/**
+ * Tool approval event
+ */
+export interface ToolApprovalEventData {
+    requestId: string;
+    toolName: string;
+    input: Record<string, unknown>;
+    approvedBy?: string;
+    reason?: string;
+}
+/**
+ * User input event
+ */
+export interface UserInputEventData {
+    question: string;
+    response?: string;
+}
+/**
+ * Memory update event
+ */
+export interface MemoryUpdateEventData {
+    type: 'conversation' | 'fact' | 'entity' | 'working';
+    content: string;
+    sessionId: string;
+}
+/**
+ * RAG query event
+ */
+export interface RAGQueryEventData {
+    query: string;
+    results: string[];
+    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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Agent Runtime Event Types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentEventType = void 0;
+/**
+ * Event types emitted by the agent runtime
+ */
+var AgentEventType;
+(function (AgentEventType) {
+    AgentEventType["EXECUTION_STARTED"] = "agent.execution.started";
+    AgentEventType["EXECUTION_COMPLETED"] = "agent.execution.completed";
+    AgentEventType["EXECUTION_FAILED"] = "agent.execution.failed";
+    AgentEventType["STEP_STARTED"] = "agent.step.started";
+    AgentEventType["STEP_COMPLETED"] = "agent.step.completed";
+    AgentEventType["STEP_FAILED"] = "agent.step.failed";
+    AgentEventType["STATE_CHANGED"] = "agent.state.changed";
+    AgentEventType["TOOL_EXECUTION_STARTED"] = "tool.execution.started";
+    AgentEventType["TOOL_EXECUTION_COMPLETED"] = "tool.execution.completed";
+    AgentEventType["TOOL_EXECUTION_FAILED"] = "tool.execution.failed";
+    AgentEventType["TOOL_APPROVAL_REQUESTED"] = "tool.approval.requested";
+    AgentEventType["TOOL_APPROVAL_GRANTED"] = "tool.approval.granted";
+    AgentEventType["TOOL_APPROVAL_DENIED"] = "tool.approval.denied";
+    AgentEventType["USER_INPUT_REQUESTED"] = "agent.input.requested";
+    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

@@ -0,0 +1 @@
+{"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/dist/types/llm.types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * LLM Provider Types
+ * Defines the interface for LLM providers used by the agent runtime
+ */
+export interface LLMMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string;
+    name?: string;
+}
+export interface LLMToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface LLMToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: 'object';
+            properties: Record<string, unknown>;
+            required?: string[];
+        };
+    };
+}
+export interface LLMChatRequest {
+    messages: LLMMessage[];
+    tools?: LLMToolDefinition[];
+    temperature?: number;
+    maxTokens?: number;
+    topP?: number;
+    model?: string;
+}
+export interface LLMChatResponse {
+    content: string;
+    tool_calls?: LLMToolCall[];
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    finishReason?: string;
+}
+/**
+ * LLM Provider Interface
+ * All LLM providers must implement this interface
+ */
+export interface LLMProvider {
+    /**
+     * Send a chat completion request
+     */
+    chat(request: LLMChatRequest): Promise<LLMChatResponse>;
+    /**
+     * Optional: Check if the provider is available
+     */
+    isAvailable?(): Promise<boolean>;
+    /**
+     * Optional: Get supported models
+     */
+    getSupportedModels?(): string[];
+}
+//# sourceMappingURL=llm.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"llm.types.d.ts","sourceRoot":"","sources":["../../src/types/llm.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ,CAAC;YACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;SACrB,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAExD;;OAEG;IACH,WAAW,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjC;;OAEG;IACH,kBAAkB,CAAC,IAAI,MAAM,EAAE,CAAC;CACjC"}

package/dist/types/llm.types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * LLM Provider Types
+ * Defines the interface for LLM providers used by the agent runtime
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=llm.types.js.map

package/dist/types/llm.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.types.js","sourceRoot":"","sources":["../../src/types/llm.types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/types/rag.types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * RAG Service Types
+ * Defines the interface for RAG services used by the agent runtime
+ */
+export interface RAGDocument {
+    id: string;
+    content: string;
+    metadata?: Record<string, unknown>;
+    score?: number;
+}
+export interface RAGSearchRequest {
+    query: string;
+    topK?: number;
+    filter?: Record<string, unknown>;
+    minScore?: number;
+}
+export interface RAGSearchResponse {
+    documents: RAGDocument[];
+    totalResults: number;
+    searchTime?: number;
+}
+/**
+ * RAG Service Interface
+ * All RAG services must implement this interface
+ */
+export interface RAGService {
+    /**
+     * Search for relevant documents
+     */
+    search(request: RAGSearchRequest): Promise<RAGSearchResponse>;
+    /**
+     * Optional: Add documents to the index
+     */
+    addDocuments?(documents: RAGDocument[]): Promise<void>;
+    /**
+     * Optional: Check if the service is available
+     */
+    isAvailable?(): Promise<boolean>;
+}
+//# sourceMappingURL=rag.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rag.types.d.ts","sourceRoot":"","sources":["../../src/types/rag.types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9D;;OAEG;IACH,YAAY,CAAC,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvD;;OAEG;IACH,WAAW,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAClC"}

package/dist/types/rag.types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * RAG Service Types
+ * Defines the interface for RAG services used by the agent runtime
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=rag.types.js.map

package/dist/types/rag.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag.types.js","sourceRoot":"","sources":["../../src/types/rag.types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}