@memberjunction/ng-agent-client 5.22.0 → 5.24.0

package/README.md

@@ -0,0 +1,113 @@
+# @memberjunction/ng-agent-client
+
+Thin Angular wrapper around [`@memberjunction/ai-agent-client`](../../../AI/AgentsClient/README.md). Provides Angular dependency injection and automatic lifecycle cleanup -- nothing more.
+
+## What This Package Does
+
+- **`AgentClientService`** -- An `@Injectable({ providedIn: 'root' })` singleton that owns an `AgentClientSession` internally.
+- **Pass-through API** -- Every public method and observable on `AgentClientSession` is exposed directly. No transformation, no added logic.
+- **Lifecycle management** -- Calls `session.Dispose()` in `ngOnDestroy` to prevent memory leaks.
+
+## What This Package Does NOT Do
+
+- No business logic
+- No tool handlers -- the consuming application registers tools
+- No GraphQL code -- that lives in the core SDK
+- No WebSocket code -- removed; transport is handled by `GraphQLDataProvider`
+
+## Usage
+
+```typescript
+import { Component, inject, OnInit, OnDestroy } from '@angular/core';
+import { AgentClientService } from '@memberjunction/ng-agent-client';
+import { Subject, takeUntil } from 'rxjs';
+
+@Component({ ... })
+export class MyChatComponent implements OnInit, OnDestroy {
+    private agentClient = inject(AgentClientService);
+    private destroy$ = new Subject<void>();
+
+    ngOnInit(): void {
+        // Register tools
+        this.agentClient.RegisterTool({
+            Name: 'NavigateToRecord',
+            Description: 'Open an entity record',
+            ParameterSchema: { type: 'object', properties: { EntityName: { type: 'string' } } },
+            Handler: async (params) => {
+                // app-specific logic
+                return { Success: true, Data: 'done' };
+            },
+        });
+
+        // Listen for events
+        this.agentClient.ToolRequested$
+            .pipe(takeUntil(this.destroy$))
+            .subscribe(event => console.log('Tool requested:', event.Request.ToolName));
+
+        // Start session
+        this.agentClient.StartSession('session-id');
+    }
+
+    async SendMessage(text: string): Promise<void> {
+        const result = await this.agentClient.RunAgent({
+            AgentId: 'agent-uuid',
+            Messages: [{ role: 'user', content: text }],
+        });
+        console.log('Agent result:', result.Success);
+    }
+
+    ngOnDestroy(): void {
+        this.destroy$.next();
+        this.destroy$.complete();
+        // AgentClientService.ngOnDestroy() calls session.Dispose() automatically
+    }
+}
+```
+
+## API
+
+All methods and observables mirror `AgentClientSession` from the core SDK:
+
+| Member | Type | Description |
+|---|---|---|
+| `ToolRequested$` | `Observable` | Emitted before tool execution |
+| `ToolExecuted$` | `Observable` | Emitted after tool execution |
+| `AgentProgress$` | `Observable` | Agent progress updates |
+| `SessionActive$` | `Observable` | Session state changes |
+| `Error$` | `Observable` | Errors during communication or execution |
+| `SessionId` | `string \| null` | Current session ID |
+| `IsActive` | `boolean` | Whether a session is active |
+| `RegisterTool(tool)` | method | Register a client-side tool handler |
+| `UnregisterTool(name)` | method | Remove a tool |
+| `GetRegisteredTools()` | method | List all registered tools |
+| `StartSession(id)` | method | Start listening for tool requests |
+| `StopSession()` | method | Stop and clean up |
+| `RunAgent(params)` | method | Execute an agent |
+| `RunAgentFromConversationDetail(params)` | method | Execute from conversation detail |
+
+## Using the Core SDK Directly
+
+This Angular wrapper is a convenience, not a requirement. The core SDK (`@memberjunction/ai-agent-client`) already provides RxJS observables and requires no Angular-specific APIs. If you run into issues with Angular's `providedIn: 'root'` singleton pattern — such as duplicate instances from multiple module imports or npm hoisting conflicts — you can use `AgentClientSession` directly:
+
+```typescript
+import { AgentClientSession } from '@memberjunction/ai-agent-client';
+
+// Create and manage the session yourself
+const session = new AgentClientSession();
+session.RegisterTool({ Name: 'MyTool', ... });
+session.StartSession('session-id');
+
+// Same observables, same API — no Angular DI involved
+session.ToolRequested$.subscribe(event => { ... });
+await session.RunAgent({ AgentId: 'sage-id', Messages: [...] });
+
+// Clean up when done
+session.Dispose();
+```
+
+This is particularly useful in non-standard Angular setups (micro-frontends, lazy-loaded feature modules with their own injectors, or hybrid apps).
+
+## Further Reading
+
+- **Core SDK**: [`@memberjunction/ai-agent-client` README](../../../AI/AgentsClient/README.md) -- full architecture, types, and examples
+- **Client Tools Protocol**: [CLIENT_TOOLS_GUIDE.md](../../../AI/Agents/docs/CLIENT_TOOLS_GUIDE.md) -- how tools are defined, dispatched, and resolved

package/dist/__tests__/agent-client-service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-client-service.test.d.ts.map

package/dist/__tests__/agent-client-service.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-client-service.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/agent-client-service.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/agent-client-service.test.js

@@ -0,0 +1,148 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+/**
+ * Tests for AgentClientService — verifies pass-through delegation to AgentClientSession.
+ */
+vi.mock('@angular/core', () => ({
+    Injectable: () => (target) => target,
+    OnDestroy: class {
+    },
+}));
+// Track the mock session created by the constructor
+let createdSession;
+vi.mock('@memberjunction/ai-agent-client', () => {
+    // Factory runs at module load — must define mock inside
+    function MockAgentClientSession() {
+        const session = {
+            ToolRequested$: { subscribe: () => { } },
+            ToolExecuted$: { subscribe: () => { } },
+            AgentProgress$: { subscribe: () => { } },
+            SessionActive$: { subscribe: () => { } },
+            Error$: { subscribe: () => { } },
+            SessionId: null,
+            IsActive: false,
+            RegisterTool: vi.fn(),
+            UnregisterTool: vi.fn(),
+            GetRegisteredTools: vi.fn().mockReturnValue([]),
+            RegisterToolDecorator: vi.fn(),
+            SetDecoratorContext: vi.fn(),
+            DecorateAndSendTools: vi.fn().mockResolvedValue(undefined),
+            StartSession: vi.fn(),
+            StopSession: vi.fn(),
+            RunAgent: vi.fn().mockResolvedValue({ Success: true }),
+            RunAgentFromConversationDetail: vi.fn().mockResolvedValue({ Success: true }),
+            Dispose: vi.fn(),
+        };
+        createdSession = session;
+        return session;
+    }
+    return {
+        AgentClientSession: MockAgentClientSession,
+    };
+});
+import { AgentClientService } from '../lib/agent-client.service';
+describe('AgentClientService', () => {
+    let service;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        service = new AgentClientService();
+    });
+    describe('Observable pass-throughs', () => {
+        it('should expose ToolRequested$ from the session', () => {
+            expect(service.ToolRequested$).toBe(createdSession.ToolRequested$);
+        });
+        it('should expose ToolExecuted$ from the session', () => {
+            expect(service.ToolExecuted$).toBe(createdSession.ToolExecuted$);
+        });
+        it('should expose AgentProgress$ from the session', () => {
+            expect(service.AgentProgress$).toBe(createdSession.AgentProgress$);
+        });
+        it('should expose SessionActive$ from the session', () => {
+            expect(service.SessionActive$).toBe(createdSession.SessionActive$);
+        });
+        it('should expose Error$ from the session', () => {
+            expect(service.Error$).toBe(createdSession.Error$);
+        });
+    });
+    describe('Session state', () => {
+        it('should return SessionId from the session', () => {
+            createdSession.SessionId = 'test-session-123';
+            expect(service.SessionId).toBe('test-session-123');
+        });
+        it('should return null SessionId when no session is active', () => {
+            createdSession.SessionId = null;
+            expect(service.SessionId).toBeNull();
+        });
+        it('should return IsActive from the session', () => {
+            createdSession.IsActive = true;
+            expect(service.IsActive).toBe(true);
+        });
+        it('should return false when session is not active', () => {
+            createdSession.IsActive = false;
+            expect(service.IsActive).toBe(false);
+        });
+    });
+    describe('Tool registration', () => {
+        it('should delegate RegisterTool to the session', () => {
+            const tool = { Name: 'TestTool', Handler: vi.fn() };
+            service.RegisterTool(tool);
+            expect(createdSession.RegisterTool).toHaveBeenCalledWith(tool);
+        });
+        it('should delegate UnregisterTool to the session', () => {
+            service.UnregisterTool('TestTool');
+            expect(createdSession.UnregisterTool).toHaveBeenCalledWith('TestTool');
+        });
+        it('should delegate GetRegisteredTools to the session', () => {
+            const tools = [{ Name: 'Tool1' }, { Name: 'Tool2' }];
+            createdSession.GetRegisteredTools.mockReturnValue(tools);
+            expect(service.GetRegisteredTools()).toBe(tools);
+        });
+    });
+    describe('Tool decoration', () => {
+        it('should delegate RegisterToolDecorator to the session', () => {
+            const decorator = vi.fn();
+            service.RegisterToolDecorator('MyTool', decorator);
+            expect(createdSession.RegisterToolDecorator).toHaveBeenCalledWith('MyTool', decorator);
+        });
+        it('should delegate SetDecoratorContext to the session', () => {
+            const context = { activeConversationId: 'conv-123' };
+            service.SetDecoratorContext(context);
+            expect(createdSession.SetDecoratorContext).toHaveBeenCalledWith(context);
+        });
+        it('should delegate DecorateAndSendTools to the session', async () => {
+            const baseTools = [{ Name: 'BaseTool' }];
+            await service.DecorateAndSendTools(baseTools);
+            expect(createdSession.DecorateAndSendTools).toHaveBeenCalledWith(baseTools);
+        });
+    });
+    describe('Session lifecycle', () => {
+        it('should delegate StartSession to the session', () => {
+            service.StartSession('session-abc');
+            expect(createdSession.StartSession).toHaveBeenCalledWith('session-abc');
+        });
+        it('should delegate StopSession to the session', () => {
+            service.StopSession();
+            expect(createdSession.StopSession).toHaveBeenCalled();
+        });
+    });
+    describe('Agent execution', () => {
+        it('should delegate RunAgent to the session', async () => {
+            const params = { AgentId: 'agent-1', Message: 'Hello' };
+            const result = await service.RunAgent(params);
+            expect(createdSession.RunAgent).toHaveBeenCalledWith(params);
+            expect(result).toEqual({ Success: true });
+        });
+        it('should delegate RunAgentFromConversationDetail to the session', async () => {
+            const params = { ConversationDetailId: 'detail-1' };
+            const result = await service.RunAgentFromConversationDetail(params);
+            expect(createdSession.RunAgentFromConversationDetail).toHaveBeenCalledWith(params);
+            expect(result).toEqual({ Success: true });
+        });
+    });
+    describe('Angular lifecycle', () => {
+        it('should call Dispose on the session when destroyed', () => {
+            service.ngOnDestroy();
+            expect(createdSession.Dispose).toHaveBeenCalled();
+        });
+    });
+});
+//# sourceMappingURL=agent-client-service.test.js.map

package/dist/__tests__/agent-client-service.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-client-service.test.js","sourceRoot":"","sources":["../../src/__tests__/agent-client-service.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, it, expect, vi, beforeEach } from 'vitest';\n\n/**\n * Tests for AgentClientService — verifies pass-through delegation to AgentClientSession.\n */\n\nvi.mock('@angular/core', () => ({\n    Injectable: () => (target: Function) => target,\n    OnDestroy: class {},\n}));\n\n// Track the mock session created by the constructor\nlet createdSession: Record<string, unknown>;\n\nvi.mock('@memberjunction/ai-agent-client', () => {\n    // Factory runs at module load — must define mock inside\n    function MockAgentClientSession() {\n        const session: Record<string, unknown> = {\n            ToolRequested$: { subscribe: () => {} },\n            ToolExecuted$: { subscribe: () => {} },\n            AgentProgress$: { subscribe: () => {} },\n            SessionActive$: { subscribe: () => {} },\n            Error$: { subscribe: () => {} },\n            SessionId: null,\n            IsActive: false,\n            RegisterTool: vi.fn(),\n            UnregisterTool: vi.fn(),\n            GetRegisteredTools: vi.fn().mockReturnValue([]),\n            RegisterToolDecorator: vi.fn(),\n            SetDecoratorContext: vi.fn(),\n            DecorateAndSendTools: vi.fn().mockResolvedValue(undefined),\n            StartSession: vi.fn(),\n            StopSession: vi.fn(),\n            RunAgent: vi.fn().mockResolvedValue({ Success: true }),\n            RunAgentFromConversationDetail: vi.fn().mockResolvedValue({ Success: true }),\n            Dispose: vi.fn(),\n        };\n        createdSession = session;\n        return session;\n    }\n    return {\n        AgentClientSession: MockAgentClientSession,\n    };\n});\n\nimport { AgentClientService } from '../lib/agent-client.service';\n\ndescribe('AgentClientService', () => {\n    let service: AgentClientService;\n\n    beforeEach(() => {\n        vi.clearAllMocks();\n        service = new AgentClientService();\n    });\n\n    describe('Observable pass-throughs', () => {\n        it('should expose ToolRequested$ from the session', () => {\n            expect(service.ToolRequested$).toBe(createdSession.ToolRequested$);\n        });\n\n        it('should expose ToolExecuted$ from the session', () => {\n            expect(service.ToolExecuted$).toBe(createdSession.ToolExecuted$);\n        });\n\n        it('should expose AgentProgress$ from the session', () => {\n            expect(service.AgentProgress$).toBe(createdSession.AgentProgress$);\n        });\n\n        it('should expose SessionActive$ from the session', () => {\n            expect(service.SessionActive$).toBe(createdSession.SessionActive$);\n        });\n\n        it('should expose Error$ from the session', () => {\n            expect(service.Error$).toBe(createdSession.Error$);\n        });\n    });\n\n    describe('Session state', () => {\n        it('should return SessionId from the session', () => {\n            createdSession.SessionId = 'test-session-123';\n            expect(service.SessionId).toBe('test-session-123');\n        });\n\n        it('should return null SessionId when no session is active', () => {\n            createdSession.SessionId = null;\n            expect(service.SessionId).toBeNull();\n        });\n\n        it('should return IsActive from the session', () => {\n            createdSession.IsActive = true;\n            expect(service.IsActive).toBe(true);\n        });\n\n        it('should return false when session is not active', () => {\n            createdSession.IsActive = false;\n            expect(service.IsActive).toBe(false);\n        });\n    });\n\n    describe('Tool registration', () => {\n        it('should delegate RegisterTool to the session', () => {\n            const tool = { Name: 'TestTool', Handler: vi.fn() };\n            service.RegisterTool(tool as never);\n            expect(createdSession.RegisterTool).toHaveBeenCalledWith(tool);\n        });\n\n        it('should delegate UnregisterTool to the session', () => {\n            service.UnregisterTool('TestTool');\n            expect(createdSession.UnregisterTool).toHaveBeenCalledWith('TestTool');\n        });\n\n        it('should delegate GetRegisteredTools to the session', () => {\n            const tools = [{ Name: 'Tool1' }, { Name: 'Tool2' }];\n            (createdSession.GetRegisteredTools as ReturnType<typeof vi.fn>).mockReturnValue(tools);\n            expect(service.GetRegisteredTools()).toBe(tools);\n        });\n    });\n\n    describe('Tool decoration', () => {\n        it('should delegate RegisterToolDecorator to the session', () => {\n            const decorator = vi.fn();\n            service.RegisterToolDecorator('MyTool', decorator as never);\n            expect(createdSession.RegisterToolDecorator).toHaveBeenCalledWith('MyTool', decorator);\n        });\n\n        it('should delegate SetDecoratorContext to the session', () => {\n            const context = { activeConversationId: 'conv-123' };\n            service.SetDecoratorContext(context as never);\n            expect(createdSession.SetDecoratorContext).toHaveBeenCalledWith(context);\n        });\n\n        it('should delegate DecorateAndSendTools to the session', async () => {\n            const baseTools = [{ Name: 'BaseTool' }];\n            await service.DecorateAndSendTools(baseTools as never);\n            expect(createdSession.DecorateAndSendTools).toHaveBeenCalledWith(baseTools);\n        });\n    });\n\n    describe('Session lifecycle', () => {\n        it('should delegate StartSession to the session', () => {\n            service.StartSession('session-abc');\n            expect(createdSession.StartSession).toHaveBeenCalledWith('session-abc');\n        });\n\n        it('should delegate StopSession to the session', () => {\n            service.StopSession();\n            expect(createdSession.StopSession).toHaveBeenCalled();\n        });\n    });\n\n    describe('Agent execution', () => {\n        it('should delegate RunAgent to the session', async () => {\n            const params = { AgentId: 'agent-1', Message: 'Hello' };\n            const result = await service.RunAgent(params as never);\n            expect(createdSession.RunAgent).toHaveBeenCalledWith(params);\n            expect(result).toEqual({ Success: true });\n        });\n\n        it('should delegate RunAgentFromConversationDetail to the session', async () => {\n            const params = { ConversationDetailId: 'detail-1' };\n            const result = await service.RunAgentFromConversationDetail(params as never);\n            expect(createdSession.RunAgentFromConversationDetail).toHaveBeenCalledWith(params);\n            expect(result).toEqual({ Success: true });\n        });\n    });\n\n    describe('Angular lifecycle', () => {\n        it('should call Dispose on the session when destroyed', () => {\n            service.ngOnDestroy();\n            expect(createdSession.Dispose).toHaveBeenCalled();\n        });\n    });\n});\n"]}

package/dist/__tests__/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/__tests__/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/index.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/index.test.js

@@ -0,0 +1,7 @@
+import { describe, it, expect } from 'vitest';
+describe('@memberjunction/ng-agent-client', () => {
+    it('should have a passing test', () => {
+        expect(true).toBe(true);
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/__tests__/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/__tests__/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { describe, it, expect } from 'vitest';\n\ndescribe('@memberjunction/ng-agent-client', () => {\n  it('should have a passing test', () => {\n    expect(true).toBe(true);\n  });\n});\n"]}

package/dist/lib/agent-client.service.d.ts

@@ -1,73 +1,72 @@
 /**
  * @fileoverview Angular adapter for the MJ Agent Client SDK.
  *
- * Provides an injectable service that wraps AgentClientSession with
- * RxJS observables for reactive Angular consumption.
+ * Thin Angular wrapper around AgentClientSession from @memberjunction/ai-agent-client.
+ * Provides Angular dependency injection and lifecycle management.
+ *
+ * This service does NOT contain business logic, GraphQL code, or tool handlers.
+ * All heavy lifting is in the core SDK. The consuming application registers tools
+ * and handles events as appropriate for its context.
  *
  * @module @memberjunction/ng-agent-client
  */
 import { OnDestroy } from '@angular/core';
-import { BehaviorSubject, Subject } from 'rxjs';
-import { ClientToolDefinition, AgentMessage, AgentProgress, AgentError, ClientToolRequest, TransportOptions } from '@memberjunction/ai-agent-client';
+import { ClientToolDefinition, ClientToolMetadata, ClientToolDecorator, ClientToolDecoratorContext, ClientToolRequestEvent, ClientToolResultEvent, SessionError, AgentProgress, RunAgentParams, RunAgentFromConversationDetailParams, RunAgentResult } from '@memberjunction/ai-agent-client';
+import { Observable } from 'rxjs';
 import * as i0 from "@angular/core";
 /**
- * Angular injectable service that wraps the framework-agnostic Agent Client SDK.
+ * Angular injectable wrapper around the framework-agnostic AgentClientSession.
+ *
+ * Provides:
+ * - Angular DI (providedIn: root singleton)
+ * - Automatic cleanup via ngOnDestroy
+ * - Pass-through access to all SDK observables and methods
  *
- * Provides RxJS observable bridges for agent messages, progress, and connection state.
- * Pre-registers built-in navigation and component tools.
+ * Usage:
+ * ```typescript
+ * const agentClient = inject(AgentClientService);
+ * agentClient.RegisterTool({ Name: 'NavigateToRecord', ... });
+ * agentClient.StartSession('session-123');
+ * agentClient.ToolRequested$.subscribe(e => console.log('Tool:', e));
+ * ```
  */
 export declare class AgentClientService implements OnDestroy {
     private session;
-    private toolRegistry;
-    private router;
-    /** Stream of all agent messages received during the session */
-    AgentMessages$: BehaviorSubject<AgentMessage[]>;
-    /** Whether the client is currently connected to an agent */
-    IsConnected$: BehaviorSubject<boolean>;
-    /** Stream of agent progress updates */
-    Progress$: Subject<AgentProgress>;
-    /** Stream of agent errors */
-    Errors$: Subject<AgentError>;
-    /** Stream of client tool requests (for UI visualization) */
-    ToolRequests$: Subject<ClientToolRequest>;
-    constructor();
-    /**
-     * Connect to an agent using WebSocket transport.
-     *
-     * @param url - The WebSocket URL of the agent server
-     * @param agentId - The ID of the agent to connect to
-     * @param conversationId - Optional existing conversation to resume
-     * @param options - Optional transport options (auth, reconnection)
-     */
-    ConnectToAgent(url: string, agentId: string, conversationId?: string, options?: TransportOptions): Promise<void>;
-    /**
-     * Send a user message to the connected agent.
-     */
-    SendMessage(content: string): Promise<void>;
-    /**
-     * Disconnect from the current agent session.
-     */
-    Disconnect(): Promise<void>;
-    /**
-     * Register a custom client-side tool.
-     */
+    /** Emitted when a tool request is received from the server (before execution) */
+    get ToolRequested$(): Observable<ClientToolRequestEvent>;
+    /** Emitted after a tool has been executed (with result) */
+    get ToolExecuted$(): Observable<ClientToolResultEvent>;
+    /** Emitted when agent execution progress updates arrive */
+    get AgentProgress$(): Observable<AgentProgress>;
+    /** Emitted when session state changes */
+    get SessionActive$(): Observable<boolean>;
+    /** Emitted on errors during tool execution or communication */
+    get Error$(): Observable<SessionError>;
+    /** The current session ID, or null if no session is active */
+    get SessionId(): string | null;
+    /** Whether a session is currently active */
+    get IsActive(): boolean;
+    /** Register a client-side tool handler */
     RegisterTool(tool: ClientToolDefinition): void;
-    /**
-     * Get the current conversation ID.
-     */
-    get ConversationId(): string | null;
-    /**
-     * Clean up on service destruction.
-     */
+    /** Unregister a client-side tool */
+    UnregisterTool(toolName: string): void;
+    /** Get all registered tool definitions */
+    GetRegisteredTools(): ClientToolDefinition[];
+    /** Register a decorator for runtime enrichment of a metadata-driven tool */
+    RegisterToolDecorator(toolName: string, decorator: ClientToolDecorator): void;
+    /** Set the runtime context for decorators */
+    SetDecoratorContext(context: ClientToolDecoratorContext): void;
+    /** Decorate base tools and send enriched definitions to the server */
+    DecorateAndSendTools(baseTools: ClientToolMetadata[]): Promise<void>;
+    /** Start listening for client tool requests for a session */
+    StartSession(sessionId: string): void;
+    /** Stop listening and clean up the session */
+    StopSession(): void;
+    /** Run an agent with a message */
+    RunAgent(params: RunAgentParams): Promise<RunAgentResult>;
+    /** Run an agent from an existing conversation detail */
+    RunAgentFromConversationDetail(params: RunAgentFromConversationDetailParams): Promise<RunAgentResult>;
     ngOnDestroy(): void;
-    /**
-     * Set up event handlers on the session that feed into RxJS observables.
-     */
-    private setupSessionHandlers;
-    /**
-     * Register built-in navigation and component tools.
-     */
-    private registerBuiltInTools;
     static ɵfac: i0.ɵɵFactoryDeclaration<AgentClientService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AgentClientService>;
 }

package/dist/lib/agent-client.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-client.service.d.ts","sourceRoot":"","sources":["../../src/lib/agent-client.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAc,SAAS,EAAU,MAAM,eAAe,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAChD,OAAO,EAIH,oBAAoB,EACpB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EACnB,MAAM,iCAAiC,CAAC;;AAEzC;;;;;GAKG;AACH,qBACa,kBAAmB,YAAW,SAAS;IAChD,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,MAAM,CAAkB;IAEhC,+DAA+D;IACxD,cAAc,kCAA2C;IAEhE,4DAA4D;IACrD,YAAY,2BAAuC;IAE1D,uCAAuC;IAChC,SAAS,yBAAgC;IAEhD,6BAA6B;IACtB,OAAO,sBAA6B;IAE3C,4DAA4D;IACrD,aAAa,6BAAoC;;IAMxD;;;;;;;OAOG;IACU,cAAc,CACvB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,gBAAgB,GAC3B,OAAO,CAAC,IAAI,CAAC;IAchB;;OAEG;IACU,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxD;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IASxC;;OAEG;IACI,YAAY,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAIrD;;OAEG;IACH,IAAW,cAAc,IAAI,MAAM,GAAG,IAAI,CAEzC;IAED;;OAEG;IACI,WAAW,IAAI,IAAI;IAU1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAwB5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;yCAlInB,kBAAkB;6CAAlB,kBAAkB;CAwL9B"}
+{"version":3,"file":"agent-client.service.d.ts","sourceRoot":"","sources":["../../src/lib/agent-client.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAc,SAAS,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAEH,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,oCAAoC,EACpC,cAAc,EACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;;AAElC;;;;;;;;;;;;;;;GAeG;AACH,qBACa,kBAAmB,YAAW,SAAS;IAChD,OAAO,CAAC,OAAO,CAA4B;IAI3C,iFAAiF;IACjF,IAAW,cAAc,IAAI,UAAU,CAAC,sBAAsB,CAAC,CAE9D;IAED,2DAA2D;IAC3D,IAAW,aAAa,IAAI,UAAU,CAAC,qBAAqB,CAAC,CAE5D;IAED,2DAA2D;IAC3D,IAAW,cAAc,IAAI,UAAU,CAAC,aAAa,CAAC,CAErD;IAED,yCAAyC;IACzC,IAAW,cAAc,IAAI,UAAU,CAAC,OAAO,CAAC,CAE/C;IAED,+DAA+D;IAC/D,IAAW,MAAM,IAAI,UAAU,CAAC,YAAY,CAAC,CAE5C;IAID,8DAA8D;IAC9D,IAAW,SAAS,IAAI,MAAM,GAAG,IAAI,CAEpC;IAED,4CAA4C;IAC5C,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAID,0CAA0C;IACnC,YAAY,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAIrD,oCAAoC;IAC7B,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI7C,0CAA0C;IACnC,kBAAkB,IAAI,oBAAoB,EAAE;IAMnD,4EAA4E;IACrE,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,GAAG,IAAI;IAIpF,6CAA6C;IACtC,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,IAAI;IAIrE,sEAAsE;IACzD,oBAAoB,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMjF,6DAA6D;IACtD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI5C,8CAA8C;IACvC,WAAW,IAAI,IAAI;IAM1B,kCAAkC;IACrB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAItE,wDAAwD;IAC3C,8BAA8B,CAAC,MAAM,EAAE,oCAAoC,GAAG,OAAO,CAAC,cAAc,CAAC;IAM3G,WAAW,IAAI,IAAI;yCAtGjB,kBAAkB;6CAAlB,kBAAkB;CAyG9B"}

package/dist/lib/agent-client.service.js

@@ -1,178 +1,113 @@
 /**
  * @fileoverview Angular adapter for the MJ Agent Client SDK.
  *
- * Provides an injectable service that wraps AgentClientSession with
- * RxJS observables for reactive Angular consumption.
+ * Thin Angular wrapper around AgentClientSession from @memberjunction/ai-agent-client.
+ * Provides Angular dependency injection and lifecycle management.
+ *
+ * This service does NOT contain business logic, GraphQL code, or tool handlers.
+ * All heavy lifting is in the core SDK. The consuming application registers tools
+ * and handles events as appropriate for its context.
  *
  * @module @memberjunction/ng-agent-client
  */
-import { Injectable, inject } from '@angular/core';
-import { Router } from '@angular/router';
-import { BehaviorSubject, Subject } from 'rxjs';
-import { AgentClientSession, ClientToolRegistry, WebSocketTransport, } from '@memberjunction/ai-agent-client';
+import { Injectable } from '@angular/core';
+import { AgentClientSession, } from '@memberjunction/ai-agent-client';
 import * as i0 from "@angular/core";
 /**
- * Angular injectable service that wraps the framework-agnostic Agent Client SDK.
+ * Angular injectable wrapper around the framework-agnostic AgentClientSession.
+ *
+ * Provides:
+ * - Angular DI (providedIn: root singleton)
+ * - Automatic cleanup via ngOnDestroy
+ * - Pass-through access to all SDK observables and methods
  *
- * Provides RxJS observable bridges for agent messages, progress, and connection state.
- * Pre-registers built-in navigation and component tools.
+ * Usage:
+ * ```typescript
+ * const agentClient = inject(AgentClientService);
+ * agentClient.RegisterTool({ Name: 'NavigateToRecord', ... });
+ * agentClient.StartSession('session-123');
+ * agentClient.ToolRequested$.subscribe(e => console.log('Tool:', e));
+ * ```
  */
 export class AgentClientService {
-    session = null;
-    toolRegistry = new ClientToolRegistry();
-    router = inject(Router);
-    /** Stream of all agent messages received during the session */
-    AgentMessages$ = new BehaviorSubject([]);
-    /** Whether the client is currently connected to an agent */
-    IsConnected$ = new BehaviorSubject(false);
-    /** Stream of agent progress updates */
-    Progress$ = new Subject();
-    /** Stream of agent errors */
-    Errors$ = new Subject();
-    /** Stream of client tool requests (for UI visualization) */
-    ToolRequests$ = new Subject();
-    constructor() {
-        this.registerBuiltInTools();
-    }
-    /**
-     * Connect to an agent using WebSocket transport.
-     *
-     * @param url - The WebSocket URL of the agent server
-     * @param agentId - The ID of the agent to connect to
-     * @param conversationId - Optional existing conversation to resume
-     * @param options - Optional transport options (auth, reconnection)
-     */
-    async ConnectToAgent(url, agentId, conversationId, options) {
-        // Clean up any existing session
-        await this.Disconnect();
-        const transport = new WebSocketTransport();
-        await transport.Connect(url, options);
-        this.session = new AgentClientSession(transport, this.toolRegistry);
-        this.setupSessionHandlers();
-        await this.session.Connect(agentId, conversationId);
-        this.IsConnected$.next(true);
-    }
-    /**
-     * Send a user message to the connected agent.
-     */
-    async SendMessage(content) {
-        if (!this.session) {
-            throw new Error('Not connected to an agent. Call ConnectToAgent() first.');
-        }
-        await this.session.SendMessage(content);
-    }
-    /**
-     * Disconnect from the current agent session.
-     */
-    async Disconnect() {
-        if (this.session) {
-            await this.session.Disconnect();
-            this.session = null;
-            this.IsConnected$.next(false);
-            this.AgentMessages$.next([]);
-        }
-    }
-    /**
-     * Register a custom client-side tool.
-     */
+    session = new AgentClientSession();
+    // --- Observable Pass-Through ---
+    /** Emitted when a tool request is received from the server (before execution) */
+    get ToolRequested$() {
+        return this.session.ToolRequested$;
+    }
+    /** Emitted after a tool has been executed (with result) */
+    get ToolExecuted$() {
+        return this.session.ToolExecuted$;
+    }
+    /** Emitted when agent execution progress updates arrive */
+    get AgentProgress$() {
+        return this.session.AgentProgress$;
+    }
+    /** Emitted when session state changes */
+    get SessionActive$() {
+        return this.session.SessionActive$;
+    }
+    /** Emitted on errors during tool execution or communication */
+    get Error$() {
+        return this.session.Error$;
+    }
+    // --- Session State ---
+    /** The current session ID, or null if no session is active */
+    get SessionId() {
+        return this.session.SessionId;
+    }
+    /** Whether a session is currently active */
+    get IsActive() {
+        return this.session.IsActive;
+    }
+    // --- Tool Registration ---
+    /** Register a client-side tool handler */
     RegisterTool(tool) {
-        this.toolRegistry.Register(tool);
+        this.session.RegisterTool(tool);
+    }
+    /** Unregister a client-side tool */
+    UnregisterTool(toolName) {
+        this.session.UnregisterTool(toolName);
+    }
+    /** Get all registered tool definitions */
+    GetRegisteredTools() {
+        return this.session.GetRegisteredTools();
+    }
+    // --- Tool Decoration ---
+    /** Register a decorator for runtime enrichment of a metadata-driven tool */
+    RegisterToolDecorator(toolName, decorator) {
+        this.session.RegisterToolDecorator(toolName, decorator);
+    }
+    /** Set the runtime context for decorators */
+    SetDecoratorContext(context) {
+        this.session.SetDecoratorContext(context);
+    }
+    /** Decorate base tools and send enriched definitions to the server */
+    async DecorateAndSendTools(baseTools) {
+        return this.session.DecorateAndSendTools(baseTools);
+    }
+    // --- Session Lifecycle ---
+    /** Start listening for client tool requests for a session */
+    StartSession(sessionId) {
+        this.session.StartSession(sessionId);
+    }
+    /** Stop listening and clean up the session */
+    StopSession() {
+        this.session.StopSession();
+    }
+    // --- Agent Execution ---
+    /** Run an agent with a message */
+    async RunAgent(params) {
+        return this.session.RunAgent(params);
     }
-    /**
-     * Get the current conversation ID.
-     */
-    get ConversationId() {
-        return this.session?.ConversationId ?? null;
+    /** Run an agent from an existing conversation detail */
+    async RunAgentFromConversationDetail(params) {
+        return this.session.RunAgentFromConversationDetail(params);
     }
-    /**
-     * Clean up on service destruction.
-     */
+    // --- Angular Lifecycle ---
     ngOnDestroy() {
-        // Fire-and-forget disconnect on destroy
-        this.Disconnect().catch(() => { });
-        this.AgentMessages$.complete();
-        this.IsConnected$.complete();
-        this.Progress$.complete();
-        this.Errors$.complete();
-        this.ToolRequests$.complete();
-    }
-    /**
-     * Set up event handlers on the session that feed into RxJS observables.
-     */
-    setupSessionHandlers() {
-        if (!this.session)
-            return;
-        this.session.OnAgentMessage((msg) => {
-            const current = this.AgentMessages$.value;
-            this.AgentMessages$.next([...current, msg]);
-        });
-        this.session.OnProgress((progress) => {
-            this.Progress$.next(progress);
-        });
-        this.session.OnError((error) => {
-            this.Errors$.next(error);
-            if (error.Code === 'DISCONNECTED') {
-                this.IsConnected$.next(false);
-            }
-        });
-        this.session.OnToolRequest((req) => {
-            this.ToolRequests$.next(req);
-        });
-    }
-    /**
-     * Register built-in navigation and component tools.
-     */
-    registerBuiltInTools() {
-        this.toolRegistry.Register({
-            Name: 'navigate_to_record',
-            Description: 'Navigate the browser to a specific entity record in MJ Explorer',
-            ParameterSchema: {
-                type: 'object',
-                properties: {
-                    EntityName: { type: 'string' },
-                    RecordID: { type: 'string' },
-                },
-                required: ['EntityName', 'RecordID'],
-            },
-            Handler: async (params) => {
-                const entityName = String(params['EntityName']);
-                const recordId = String(params['RecordID']);
-                await this.router.navigate(['/resource', 'entity', entityName, recordId]);
-                return { Success: true, Data: { Navigated: true } };
-            },
-        });
-        this.toolRegistry.Register({
-            Name: 'navigate_to_app',
-            Description: 'Switch to a different MJ Explorer application',
-            ParameterSchema: {
-                type: 'object',
-                properties: {
-                    AppName: { type: 'string' },
-                },
-                required: ['AppName'],
-            },
-            Handler: async (params) => {
-                const appName = String(params['AppName']);
-                await this.router.navigate(['/app', appName]);
-                return { Success: true, Data: { Navigated: true } };
-            },
-        });
-        this.toolRegistry.Register({
-            Name: 'navigate_to_tab',
-            Description: 'Switch to a specific tab within the current application',
-            ParameterSchema: {
-                type: 'object',
-                properties: {
-                    TabName: { type: 'string' },
-                },
-                required: ['TabName'],
-            },
-            Handler: async (params) => {
-                // Tab navigation is handled via the app's internal routing
-                const tabName = String(params['TabName']);
-                return { Success: true, Data: { TabName: tabName, Note: 'Tab switch requested' } };
-            },
-        });
+        this.session.Dispose();
     }
     static ɵfac = function AgentClientService_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || AgentClientService)(); };
     static ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: AgentClientService, factory: AgentClientService.ɵfac, providedIn: 'root' });
@@ -180,5 +115,5 @@ export class AgentClientService {
 (() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(AgentClientService, [{
         type: Injectable,
         args: [{ providedIn: 'root' }]
-    }], () => [], null); })();
+    }], null, null); })();
 //# sourceMappingURL=agent-client.service.js.map

package/dist/lib/agent-client.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-client.service.js","sourceRoot":"","sources":["../../src/lib/agent-client.service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Angular adapter for the MJ Agent Client SDK.\n *\n * Provides an injectable service that wraps AgentClientSession with\n * RxJS observables for reactive Angular consumption.\n *\n * @module @memberjunction/ng-agent-client\n */\n\nimport { Injectable, OnDestroy, inject } from '@angular/core';\nimport { Router } from '@angular/router';\nimport { BehaviorSubject, Subject } from 'rxjs';\nimport {\n    AgentClientSession,\n    ClientToolRegistry,\n    WebSocketTransport,\n    ClientToolDefinition,\n    AgentMessage,\n    AgentProgress,\n    AgentError,\n    ClientToolRequest,\n    TransportOptions,\n} from '@memberjunction/ai-agent-client';\n\n/**\n * Angular injectable service that wraps the framework-agnostic Agent Client SDK.\n *\n * Provides RxJS observable bridges for agent messages, progress, and connection state.\n * Pre-registers built-in navigation and component tools.\n */\n@Injectable({ providedIn: 'root' })\nexport class AgentClientService implements OnDestroy {\n    private session: AgentClientSession | null = null;\n    private toolRegistry = new ClientToolRegistry();\n    private router = inject(Router);\n\n    /** Stream of all agent messages received during the session */\n    public AgentMessages$ = new BehaviorSubject<AgentMessage[]>([]);\n\n    /** Whether the client is currently connected to an agent */\n    public IsConnected$ = new BehaviorSubject<boolean>(false);\n\n    /** Stream of agent progress updates */\n    public Progress$ = new Subject<AgentProgress>();\n\n    /** Stream of agent errors */\n    public Errors$ = new Subject<AgentError>();\n\n    /** Stream of client tool requests (for UI visualization) */\n    public ToolRequests$ = new Subject<ClientToolRequest>();\n\n    constructor() {\n        this.registerBuiltInTools();\n    }\n\n    /**\n     * Connect to an agent using WebSocket transport.\n     *\n     * @param url - The WebSocket URL of the agent server\n     * @param agentId - The ID of the agent to connect to\n     * @param conversationId - Optional existing conversation to resume\n     * @param options - Optional transport options (auth, reconnection)\n     */\n    public async ConnectToAgent(\n        url: string,\n        agentId: string,\n        conversationId?: string,\n        options?: TransportOptions\n    ): Promise<void> {\n        // Clean up any existing session\n        await this.Disconnect();\n\n        const transport = new WebSocketTransport();\n        await transport.Connect(url, options);\n\n        this.session = new AgentClientSession(transport, this.toolRegistry);\n        this.setupSessionHandlers();\n\n        await this.session.Connect(agentId, conversationId);\n        this.IsConnected$.next(true);\n    }\n\n    /**\n     * Send a user message to the connected agent.\n     */\n    public async SendMessage(content: string): Promise<void> {\n        if (!this.session) {\n            throw new Error('Not connected to an agent. Call ConnectToAgent() first.');\n        }\n        await this.session.SendMessage(content);\n    }\n\n    /**\n     * Disconnect from the current agent session.\n     */\n    public async Disconnect(): Promise<void> {\n        if (this.session) {\n            await this.session.Disconnect();\n            this.session = null;\n            this.IsConnected$.next(false);\n            this.AgentMessages$.next([]);\n        }\n    }\n\n    /**\n     * Register a custom client-side tool.\n     */\n    public RegisterTool(tool: ClientToolDefinition): void {\n        this.toolRegistry.Register(tool);\n    }\n\n    /**\n     * Get the current conversation ID.\n     */\n    public get ConversationId(): string | null {\n        return this.session?.ConversationId ?? null;\n    }\n\n    /**\n     * Clean up on service destruction.\n     */\n    public ngOnDestroy(): void {\n        // Fire-and-forget disconnect on destroy\n        this.Disconnect().catch(() => { /* intentional: best-effort cleanup */ });\n        this.AgentMessages$.complete();\n        this.IsConnected$.complete();\n        this.Progress$.complete();\n        this.Errors$.complete();\n        this.ToolRequests$.complete();\n    }\n\n    /**\n     * Set up event handlers on the session that feed into RxJS observables.\n     */\n    private setupSessionHandlers(): void {\n        if (!this.session) return;\n\n        this.session.OnAgentMessage((msg) => {\n            const current = this.AgentMessages$.value;\n            this.AgentMessages$.next([...current, msg]);\n        });\n\n        this.session.OnProgress((progress) => {\n            this.Progress$.next(progress);\n        });\n\n        this.session.OnError((error) => {\n            this.Errors$.next(error);\n            if (error.Code === 'DISCONNECTED') {\n                this.IsConnected$.next(false);\n            }\n        });\n\n        this.session.OnToolRequest((req) => {\n            this.ToolRequests$.next(req);\n        });\n    }\n\n    /**\n     * Register built-in navigation and component tools.\n     */\n    private registerBuiltInTools(): void {\n        this.toolRegistry.Register({\n            Name: 'navigate_to_record',\n            Description: 'Navigate the browser to a specific entity record in MJ Explorer',\n            ParameterSchema: {\n                type: 'object',\n                properties: {\n                    EntityName: { type: 'string' },\n                    RecordID: { type: 'string' },\n                },\n                required: ['EntityName', 'RecordID'],\n            },\n            Handler: async (params) => {\n                const entityName = String(params['EntityName']);\n                const recordId = String(params['RecordID']);\n                await this.router.navigate(['/resource', 'entity', entityName, recordId]);\n                return { Success: true, Data: { Navigated: true } };\n            },\n        });\n\n        this.toolRegistry.Register({\n            Name: 'navigate_to_app',\n            Description: 'Switch to a different MJ Explorer application',\n            ParameterSchema: {\n                type: 'object',\n                properties: {\n                    AppName: { type: 'string' },\n                },\n                required: ['AppName'],\n            },\n            Handler: async (params) => {\n                const appName = String(params['AppName']);\n                await this.router.navigate(['/app', appName]);\n                return { Success: true, Data: { Navigated: true } };\n            },\n        });\n\n        this.toolRegistry.Register({\n            Name: 'navigate_to_tab',\n            Description: 'Switch to a specific tab within the current application',\n            ParameterSchema: {\n                type: 'object',\n                properties: {\n                    TabName: { type: 'string' },\n                },\n                required: ['TabName'],\n            },\n            Handler: async (params) => {\n                // Tab navigation is handled via the app's internal routing\n                const tabName = String(params['TabName']);\n                return { Success: true, Data: { TabName: tabName, Note: 'Tab switch requested' } };\n            },\n        });\n    }\n}\n"]}
+{"version":3,"file":"agent-client.service.js","sourceRoot":"","sources":["../../src/lib/agent-client.service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Angular adapter for the MJ Agent Client SDK.\n *\n * Thin Angular wrapper around AgentClientSession from @memberjunction/ai-agent-client.\n * Provides Angular dependency injection and lifecycle management.\n *\n * This service does NOT contain business logic, GraphQL code, or tool handlers.\n * All heavy lifting is in the core SDK. The consuming application registers tools\n * and handles events as appropriate for its context.\n *\n * @module @memberjunction/ng-agent-client\n */\n\nimport { Injectable, OnDestroy } from '@angular/core';\nimport {\n    AgentClientSession,\n    ClientToolDefinition,\n    ClientToolMetadata,\n    ClientToolDecorator,\n    ClientToolDecoratorContext,\n    ClientToolRequestEvent,\n    ClientToolResultEvent,\n    SessionError,\n    AgentProgress,\n    RunAgentParams,\n    RunAgentFromConversationDetailParams,\n    RunAgentResult,\n} from '@memberjunction/ai-agent-client';\nimport { Observable } from 'rxjs';\n\n/**\n * Angular injectable wrapper around the framework-agnostic AgentClientSession.\n *\n * Provides:\n * - Angular DI (providedIn: root singleton)\n * - Automatic cleanup via ngOnDestroy\n * - Pass-through access to all SDK observables and methods\n *\n * Usage:\n * ```typescript\n * const agentClient = inject(AgentClientService);\n * agentClient.RegisterTool({ Name: 'NavigateToRecord', ... });\n * agentClient.StartSession('session-123');\n * agentClient.ToolRequested$.subscribe(e => console.log('Tool:', e));\n * ```\n */\n@Injectable({ providedIn: 'root' })\nexport class AgentClientService implements OnDestroy {\n    private session = new AgentClientSession();\n\n    // --- Observable Pass-Through ---\n\n    /** Emitted when a tool request is received from the server (before execution) */\n    public get ToolRequested$(): Observable<ClientToolRequestEvent> {\n        return this.session.ToolRequested$;\n    }\n\n    /** Emitted after a tool has been executed (with result) */\n    public get ToolExecuted$(): Observable<ClientToolResultEvent> {\n        return this.session.ToolExecuted$;\n    }\n\n    /** Emitted when agent execution progress updates arrive */\n    public get AgentProgress$(): Observable<AgentProgress> {\n        return this.session.AgentProgress$;\n    }\n\n    /** Emitted when session state changes */\n    public get SessionActive$(): Observable<boolean> {\n        return this.session.SessionActive$;\n    }\n\n    /** Emitted on errors during tool execution or communication */\n    public get Error$(): Observable<SessionError> {\n        return this.session.Error$;\n    }\n\n    // --- Session State ---\n\n    /** The current session ID, or null if no session is active */\n    public get SessionId(): string | null {\n        return this.session.SessionId;\n    }\n\n    /** Whether a session is currently active */\n    public get IsActive(): boolean {\n        return this.session.IsActive;\n    }\n\n    // --- Tool Registration ---\n\n    /** Register a client-side tool handler */\n    public RegisterTool(tool: ClientToolDefinition): void {\n        this.session.RegisterTool(tool);\n    }\n\n    /** Unregister a client-side tool */\n    public UnregisterTool(toolName: string): void {\n        this.session.UnregisterTool(toolName);\n    }\n\n    /** Get all registered tool definitions */\n    public GetRegisteredTools(): ClientToolDefinition[] {\n        return this.session.GetRegisteredTools();\n    }\n\n    // --- Tool Decoration ---\n\n    /** Register a decorator for runtime enrichment of a metadata-driven tool */\n    public RegisterToolDecorator(toolName: string, decorator: ClientToolDecorator): void {\n        this.session.RegisterToolDecorator(toolName, decorator);\n    }\n\n    /** Set the runtime context for decorators */\n    public SetDecoratorContext(context: ClientToolDecoratorContext): void {\n        this.session.SetDecoratorContext(context);\n    }\n\n    /** Decorate base tools and send enriched definitions to the server */\n    public async DecorateAndSendTools(baseTools: ClientToolMetadata[]): Promise<void> {\n        return this.session.DecorateAndSendTools(baseTools);\n    }\n\n    // --- Session Lifecycle ---\n\n    /** Start listening for client tool requests for a session */\n    public StartSession(sessionId: string): void {\n        this.session.StartSession(sessionId);\n    }\n\n    /** Stop listening and clean up the session */\n    public StopSession(): void {\n        this.session.StopSession();\n    }\n\n    // --- Agent Execution ---\n\n    /** Run an agent with a message */\n    public async RunAgent(params: RunAgentParams): Promise<RunAgentResult> {\n        return this.session.RunAgent(params);\n    }\n\n    /** Run an agent from an existing conversation detail */\n    public async RunAgentFromConversationDetail(params: RunAgentFromConversationDetailParams): Promise<RunAgentResult> {\n        return this.session.RunAgentFromConversationDetail(params);\n    }\n\n    // --- Angular Lifecycle ---\n\n    public ngOnDestroy(): void {\n        this.session.Dispose();\n    }\n}\n"]}

package/dist/public-api.d.ts

@@ -1,5 +1,3 @@
 export * from './lib/agent-client.service';
 export * from './lib/agent-client.module';
-export * from './lib/tools/navigation-tool';
-export * from './lib/tools/component-tool';
 //# sourceMappingURL=public-api.d.ts.map

package/dist/public-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAIA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC"}
+{"version":3,"file":"public-api.d.ts","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAIA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC"}

package/dist/public-api.js

@@ -3,6 +3,4 @@
  */
 export * from './lib/agent-client.service';
 export * from './lib/agent-client.module';
-export * from './lib/tools/navigation-tool';
-export * from './lib/tools/component-tool';
 //# sourceMappingURL=public-api.js.map

package/dist/public-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC","sourcesContent":["/*\n * Public API Surface for @memberjunction/ng-agent-client\n */\n\nexport * from './lib/agent-client.service';\nexport * from './lib/agent-client.module';\nexport * from './lib/tools/navigation-tool';\nexport * from './lib/tools/component-tool';\n"]}
+{"version":3,"file":"public-api.js","sourceRoot":"","sources":["../src/public-api.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC","sourcesContent":["/*\n * Public API Surface for @memberjunction/ng-agent-client\n */\n\nexport * from './lib/agent-client.service';\nexport * from './lib/agent-client.module';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memberjunction/ng-agent-client",
-  "version": "5.22.0",
+  "version": "5.24.0",
   "description": "MemberJunction: Angular adapter for the Agent Client SDK - injectable service, navigation tools, RxJS bridges",
   "main": "./dist/public-api.js",
   "typings": "./dist/public-api.d.ts",
@@ -8,7 +8,7 @@
     "/dist"
   ],
   "scripts": {
-    "test": "echo \"No tests configured yet\"",
+    "test": "vitest run",
     "build": "ngc",
     "test:watch": "vitest"
   },
@@ -26,8 +26,8 @@
     "@angular/router": "21.1.3"
   },
   "dependencies": {
-    "@memberjunction/ai-agent-client": "5.22.0",
-    "@memberjunction/global": "5.22.0",
+    "@memberjunction/ai-agent-client": "5.24.0",
+    "@memberjunction/global": "5.24.0",
     "rxjs": "^7.8.2",
     "tslib": "^2.8.1"
   },

package/dist/lib/tools/component-tool.d.ts

@@ -1,25 +0,0 @@
-/**
- * @fileoverview Component interaction tool definitions for the Angular Agent Client.
- *
- * Pre-built tool definitions for manipulating Knowledge Hub UI components
- * from agent commands (opening panels, applying filters, etc.).
- *
- * @module @memberjunction/ng-agent-client
- */
-import { ClientToolDefinition } from '@memberjunction/ai-agent-client';
-/**
- * Create an "open_search_panel" tool definition.
- * Opens or focuses the search panel in the Knowledge Hub.
- */
-export declare function CreateOpenSearchPanelTool(): ClientToolDefinition;
-/**
- * Create an "apply_search_filter" tool definition.
- * Applies filters to the current Knowledge Hub search results.
- */
-export declare function CreateApplySearchFilterTool(): ClientToolDefinition;
-/**
- * Create a "show_entity_details" tool definition.
- * Opens a details panel for a specific entity record.
- */
-export declare function CreateShowEntityDetailsTool(): ClientToolDefinition;
-//# sourceMappingURL=component-tool.d.ts.map

package/dist/lib/tools/component-tool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"component-tool.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/component-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAoB,MAAM,iCAAiC,CAAC;AAEzF;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,oBAAoB,CAoBhE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,oBAAoB,CAoClE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,oBAAoB,CAuBlE"}

package/dist/lib/tools/component-tool.js

@@ -1,103 +0,0 @@
-/**
- * @fileoverview Component interaction tool definitions for the Angular Agent Client.
- *
- * Pre-built tool definitions for manipulating Knowledge Hub UI components
- * from agent commands (opening panels, applying filters, etc.).
- *
- * @module @memberjunction/ng-agent-client
- */
-/**
- * Create an "open_search_panel" tool definition.
- * Opens or focuses the search panel in the Knowledge Hub.
- */
-export function CreateOpenSearchPanelTool() {
-    return {
-        Name: 'open_search_panel',
-        Description: 'Open or focus the search panel in the Knowledge Hub',
-        ParameterSchema: {
-            type: 'object',
-            properties: {
-                Query: { type: 'string', description: 'Optional search query to pre-fill' },
-            },
-        },
-        Handler: async (params) => {
-            const query = params['Query'] != null ? String(params['Query']) : undefined;
-            // In a real implementation, this would emit an event picked up by the
-            // Knowledge Hub shell component. For now, return success with the intent.
-            return {
-                Success: true,
-                Data: { Action: 'open_search_panel', Query: query },
-            };
-        },
-    };
-}
-/**
- * Create an "apply_search_filter" tool definition.
- * Applies filters to the current Knowledge Hub search results.
- */
-export function CreateApplySearchFilterTool() {
-    return {
-        Name: 'apply_search_filter',
-        Description: 'Apply filters to the current Knowledge Hub search results',
-        ParameterSchema: {
-            type: 'object',
-            properties: {
-                EntityNames: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'Filter to specific entity names',
-                },
-                SourceTypes: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'Filter to specific source types',
-                },
-                Tags: {
-                    type: 'array',
-                    items: { type: 'string' },
-                    description: 'Filter to specific tags',
-                },
-            },
-        },
-        Handler: async (params) => {
-            return {
-                Success: true,
-                Data: {
-                    Action: 'apply_search_filter',
-                    EntityNames: params['EntityNames'],
-                    SourceTypes: params['SourceTypes'],
-                    Tags: params['Tags'],
-                },
-            };
-        },
-    };
-}
-/**
- * Create a "show_entity_details" tool definition.
- * Opens a details panel for a specific entity record.
- */
-export function CreateShowEntityDetailsTool() {
-    return {
-        Name: 'show_entity_details',
-        Description: 'Open a details panel for a specific entity record',
-        ParameterSchema: {
-            type: 'object',
-            properties: {
-                EntityName: { type: 'string', description: 'The MJ entity name' },
-                RecordID: { type: 'string', description: 'The record ID to show details for' },
-            },
-            required: ['EntityName', 'RecordID'],
-        },
-        Handler: async (params) => {
-            return {
-                Success: true,
-                Data: {
-                    Action: 'show_entity_details',
-                    EntityName: String(params['EntityName']),
-                    RecordID: String(params['RecordID']),
-                },
-            };
-        },
-    };
-}
-//# sourceMappingURL=component-tool.js.map

package/dist/lib/tools/component-tool.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"component-tool.js","sourceRoot":"","sources":["../../../src/lib/tools/component-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACrC,OAAO;QACH,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,qDAAqD;QAClE,eAAe,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACR,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;aAC9E;SACJ;QACD,OAAO,EAAE,KAAK,EAAE,MAA+B,EAA6B,EAAE;YAC1E,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5E,sEAAsE;YACtE,0EAA0E;YAC1E,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,KAAK,EAAE,KAAK,EAAE;aACtD,CAAC;QACN,CAAC;KACJ,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B;IACvC,OAAO;QACH,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,2DAA2D;QACxE,eAAe,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACR,WAAW,EAAE;oBACT,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,iCAAiC;iBACjD;gBACD,WAAW,EAAE;oBACT,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,iCAAiC;iBACjD;gBACD,IAAI,EAAE;oBACF,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,yBAAyB;iBACzC;aACJ;SACJ;QACD,OAAO,EAAE,KAAK,EAAE,MAA+B,EAA6B,EAAE;YAC1E,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE;oBACF,MAAM,EAAE,qBAAqB;oBAC7B,WAAW,EAAE,MAAM,CAAC,aAAa,CAAC;oBAClC,WAAW,EAAE,MAAM,CAAC,aAAa,CAAC;oBAClC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;iBACvB;aACJ,CAAC;QACN,CAAC;KACJ,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B;IACvC,OAAO;QACH,IAAI,EAAE,qBAAqB;QAC3B,WAAW,EAAE,mDAAmD;QAChE,eAAe,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACR,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;gBACjE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;aACjF;YACD,QAAQ,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC;SACvC;QACD,OAAO,EAAE,KAAK,EAAE,MAA+B,EAA6B,EAAE;YAC1E,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE;oBACF,MAAM,EAAE,qBAAqB;oBAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;oBACxC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;iBACvC;aACJ,CAAC;QACN,CAAC;KACJ,CAAC;AACN,CAAC","sourcesContent":["/**\n * @fileoverview Component interaction tool definitions for the Angular Agent Client.\n *\n * Pre-built tool definitions for manipulating Knowledge Hub UI components\n * from agent commands (opening panels, applying filters, etc.).\n *\n * @module @memberjunction/ng-agent-client\n */\n\nimport { ClientToolDefinition, ClientToolResult } from '@memberjunction/ai-agent-client';\n\n/**\n * Create an \"open_search_panel\" tool definition.\n * Opens or focuses the search panel in the Knowledge Hub.\n */\nexport function CreateOpenSearchPanelTool(): ClientToolDefinition {\n    return {\n        Name: 'open_search_panel',\n        Description: 'Open or focus the search panel in the Knowledge Hub',\n        ParameterSchema: {\n            type: 'object',\n            properties: {\n                Query: { type: 'string', description: 'Optional search query to pre-fill' },\n            },\n        },\n        Handler: async (params: Record<string, unknown>): Promise<ClientToolResult> => {\n            const query = params['Query'] != null ? String(params['Query']) : undefined;\n            // In a real implementation, this would emit an event picked up by the\n            // Knowledge Hub shell component. For now, return success with the intent.\n            return {\n                Success: true,\n                Data: { Action: 'open_search_panel', Query: query },\n            };\n        },\n    };\n}\n\n/**\n * Create an \"apply_search_filter\" tool definition.\n * Applies filters to the current Knowledge Hub search results.\n */\nexport function CreateApplySearchFilterTool(): ClientToolDefinition {\n    return {\n        Name: 'apply_search_filter',\n        Description: 'Apply filters to the current Knowledge Hub search results',\n        ParameterSchema: {\n            type: 'object',\n            properties: {\n                EntityNames: {\n                    type: 'array',\n                    items: { type: 'string' },\n                    description: 'Filter to specific entity names',\n                },\n                SourceTypes: {\n                    type: 'array',\n                    items: { type: 'string' },\n                    description: 'Filter to specific source types',\n                },\n                Tags: {\n                    type: 'array',\n                    items: { type: 'string' },\n                    description: 'Filter to specific tags',\n                },\n            },\n        },\n        Handler: async (params: Record<string, unknown>): Promise<ClientToolResult> => {\n            return {\n                Success: true,\n                Data: {\n                    Action: 'apply_search_filter',\n                    EntityNames: params['EntityNames'],\n                    SourceTypes: params['SourceTypes'],\n                    Tags: params['Tags'],\n                },\n            };\n        },\n    };\n}\n\n/**\n * Create a \"show_entity_details\" tool definition.\n * Opens a details panel for a specific entity record.\n */\nexport function CreateShowEntityDetailsTool(): ClientToolDefinition {\n    return {\n        Name: 'show_entity_details',\n        Description: 'Open a details panel for a specific entity record',\n        ParameterSchema: {\n            type: 'object',\n            properties: {\n                EntityName: { type: 'string', description: 'The MJ entity name' },\n                RecordID: { type: 'string', description: 'The record ID to show details for' },\n            },\n            required: ['EntityName', 'RecordID'],\n        },\n        Handler: async (params: Record<string, unknown>): Promise<ClientToolResult> => {\n            return {\n                Success: true,\n                Data: {\n                    Action: 'show_entity_details',\n                    EntityName: String(params['EntityName']),\n                    RecordID: String(params['RecordID']),\n                },\n            };\n        },\n    };\n}\n"]}

package/dist/lib/tools/navigation-tool.d.ts

@@ -1,19 +0,0 @@
-/**
- * @fileoverview Navigation tool definitions for the Angular Agent Client.
- *
- * Pre-built tool definitions for navigating MJ Explorer from agent commands.
- * These are registered automatically by the AgentClientService.
- *
- * @module @memberjunction/ng-agent-client
- */
-import { Router } from '@angular/router';
-import { ClientToolDefinition } from '@memberjunction/ai-agent-client';
-/**
- * Create a "navigate_to_record" tool definition bound to a specific Angular Router.
- */
-export declare function CreateNavigateToRecordTool(router: Router): ClientToolDefinition;
-/**
- * Create a "navigate_to_app" tool definition bound to a specific Angular Router.
- */
-export declare function CreateNavigateToAppTool(router: Router): ClientToolDefinition;
-//# sourceMappingURL=navigation-tool.d.ts.map

package/dist/lib/tools/navigation-tool.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"navigation-tool.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/navigation-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAoB,MAAM,iCAAiC,CAAC;AAEzF;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAyB/E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAuB5E"}

package/dist/lib/tools/navigation-tool.js

@@ -1,65 +0,0 @@
-/**
- * @fileoverview Navigation tool definitions for the Angular Agent Client.
- *
- * Pre-built tool definitions for navigating MJ Explorer from agent commands.
- * These are registered automatically by the AgentClientService.
- *
- * @module @memberjunction/ng-agent-client
- */
-/**
- * Create a "navigate_to_record" tool definition bound to a specific Angular Router.
- */
-export function CreateNavigateToRecordTool(router) {
-    return {
-        Name: 'navigate_to_record',
-        Description: 'Navigate the browser to a specific entity record in MJ Explorer',
-        ParameterSchema: {
-            type: 'object',
-            properties: {
-                EntityName: { type: 'string', description: 'The MJ entity name' },
-                RecordID: { type: 'string', description: 'The record ID to navigate to' },
-            },
-            required: ['EntityName', 'RecordID'],
-        },
-        Handler: async (params) => {
-            const entityName = String(params['EntityName']);
-            const recordId = String(params['RecordID']);
-            try {
-                await router.navigate(['/resource', 'entity', entityName, recordId]);
-                return { Success: true, Data: { Navigated: true, EntityName: entityName, RecordID: recordId } };
-            }
-            catch (error) {
-                const message = error instanceof Error ? error.message : String(error);
-                return { Success: false, ErrorMessage: `Navigation failed: ${message}` };
-            }
-        },
-    };
-}
-/**
- * Create a "navigate_to_app" tool definition bound to a specific Angular Router.
- */
-export function CreateNavigateToAppTool(router) {
-    return {
-        Name: 'navigate_to_app',
-        Description: 'Switch to a different MJ Explorer application by name',
-        ParameterSchema: {
-            type: 'object',
-            properties: {
-                AppName: { type: 'string', description: 'The application name to switch to' },
-            },
-            required: ['AppName'],
-        },
-        Handler: async (params) => {
-            const appName = String(params['AppName']);
-            try {
-                await router.navigate(['/app', appName]);
-                return { Success: true, Data: { Navigated: true, AppName: appName } };
-            }
-            catch (error) {
-                const message = error instanceof Error ? error.message : String(error);
-                return { Success: false, ErrorMessage: `Navigation failed: ${message}` };
-            }
-        },
-    };
-}
-//# sourceMappingURL=navigation-tool.js.map

package/dist/lib/tools/navigation-tool.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"navigation-tool.js","sourceRoot":"","sources":["../../../src/lib/tools/navigation-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAc;IACrD,OAAO;QACH,IAAI,EAAE,oBAAoB;QAC1B,WAAW,EAAE,iEAAiE;QAC9E,eAAe,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACR,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;gBACjE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;aAC5E;YACD,QAAQ,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC;SACvC;QACD,OAAO,EAAE,KAAK,EAAE,MAA+B,EAA6B,EAAE;YAC1E,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;YAChD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;YAE5C,IAAI,CAAC;gBACD,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;gBACrE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC;YACpG,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,sBAAsB,OAAO,EAAE,EAAE,CAAC;YAC7E,CAAC;QACL,CAAC;KACJ,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAc;IAClD,OAAO;QACH,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,uDAAuD;QACpE,eAAe,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACR,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;aAChF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACxB;QACD,OAAO,EAAE,KAAK,EAAE,MAA+B,EAA6B,EAAE;YAC1E,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;YAE1C,IAAI,CAAC;gBACD,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;gBACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;YAC1E,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,sBAAsB,OAAO,EAAE,EAAE,CAAC;YAC7E,CAAC;QACL,CAAC;KACJ,CAAC;AACN,CAAC","sourcesContent":["/**\n * @fileoverview Navigation tool definitions for the Angular Agent Client.\n *\n * Pre-built tool definitions for navigating MJ Explorer from agent commands.\n * These are registered automatically by the AgentClientService.\n *\n * @module @memberjunction/ng-agent-client\n */\n\nimport { Router } from '@angular/router';\nimport { ClientToolDefinition, ClientToolResult } from '@memberjunction/ai-agent-client';\n\n/**\n * Create a \"navigate_to_record\" tool definition bound to a specific Angular Router.\n */\nexport function CreateNavigateToRecordTool(router: Router): ClientToolDefinition {\n    return {\n        Name: 'navigate_to_record',\n        Description: 'Navigate the browser to a specific entity record in MJ Explorer',\n        ParameterSchema: {\n            type: 'object',\n            properties: {\n                EntityName: { type: 'string', description: 'The MJ entity name' },\n                RecordID: { type: 'string', description: 'The record ID to navigate to' },\n            },\n            required: ['EntityName', 'RecordID'],\n        },\n        Handler: async (params: Record<string, unknown>): Promise<ClientToolResult> => {\n            const entityName = String(params['EntityName']);\n            const recordId = String(params['RecordID']);\n\n            try {\n                await router.navigate(['/resource', 'entity', entityName, recordId]);\n                return { Success: true, Data: { Navigated: true, EntityName: entityName, RecordID: recordId } };\n            } catch (error) {\n                const message = error instanceof Error ? error.message : String(error);\n                return { Success: false, ErrorMessage: `Navigation failed: ${message}` };\n            }\n        },\n    };\n}\n\n/**\n * Create a \"navigate_to_app\" tool definition bound to a specific Angular Router.\n */\nexport function CreateNavigateToAppTool(router: Router): ClientToolDefinition {\n    return {\n        Name: 'navigate_to_app',\n        Description: 'Switch to a different MJ Explorer application by name',\n        ParameterSchema: {\n            type: 'object',\n            properties: {\n                AppName: { type: 'string', description: 'The application name to switch to' },\n            },\n            required: ['AppName'],\n        },\n        Handler: async (params: Record<string, unknown>): Promise<ClientToolResult> => {\n            const appName = String(params['AppName']);\n\n            try {\n                await router.navigate(['/app', appName]);\n                return { Success: true, Data: { Navigated: true, AppName: appName } };\n            } catch (error) {\n                const message = error instanceof Error ? error.message : String(error);\n                return { Success: false, ErrorMessage: `Navigation failed: ${message}` };\n            }\n        },\n    };\n}\n"]}