@memberjunction/ng-agent-client 0.0.1 → 5.23.0

package/README.md

@@ -1,45 +1,113 @@
 # @memberjunction/ng-agent-client
 
-## ⚠️ IMPORTANT NOTICE ⚠️
-
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@memberjunction/ng-agent-client`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**
+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.module.d.ts

@@ -0,0 +1,8 @@
+import * as i0 from "@angular/core";
+import * as i1 from "@angular/common";
+export declare class AgentClientModule {
+    static ɵfac: i0.ɵɵFactoryDeclaration<AgentClientModule, never>;
+    static ɵmod: i0.ɵɵNgModuleDeclaration<AgentClientModule, never, [typeof i1.CommonModule], never>;
+    static ɵinj: i0.ɵɵInjectorDeclaration<AgentClientModule>;
+}
+//# sourceMappingURL=agent-client.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-client.module.d.ts","sourceRoot":"","sources":["../../src/lib/agent-client.module.ts"],"names":[],"mappings":";;AASA,qBAKa,iBAAiB;yCAAjB,iBAAiB;0CAAjB,iBAAiB;0CAAjB,iBAAiB;CAAG"}

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

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Angular module for the Agent Client adapter.
+ *
+ * @module @memberjunction/ng-agent-client
+ */
+import { NgModule } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import * as i0 from "@angular/core";
+export class AgentClientModule {
+    static ɵfac = function AgentClientModule_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || AgentClientModule)(); };
+    static ɵmod = /*@__PURE__*/ i0.ɵɵdefineNgModule({ type: AgentClientModule });
+    static ɵinj = /*@__PURE__*/ i0.ɵɵdefineInjector({ imports: [CommonModule] });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(AgentClientModule, [{
+        type: NgModule,
+        args: [{
+                imports: [CommonModule],
+                declarations: [],
+                exports: [],
+            }]
+    }], null, null); })();
+(function () { (typeof ngJitMode === "undefined" || ngJitMode) && i0.ɵɵsetNgModuleScope(AgentClientModule, { imports: [CommonModule] }); })();
+//# sourceMappingURL=agent-client.module.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-client.module.js","sourceRoot":"","sources":["../../src/lib/agent-client.module.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;;AAO/C,MAAM,OAAO,iBAAiB;2GAAjB,iBAAiB;4DAAjB,iBAAiB;gEAJhB,YAAY;;iFAIb,iBAAiB;cAL7B,QAAQ;eAAC;gBACN,OAAO,EAAE,CAAC,YAAY,CAAC;gBACvB,YAAY,EAAE,EAAE;gBAChB,OAAO,EAAE,EAAE;aACd;;wFACY,iBAAiB,cAJhB,YAAY","sourcesContent":["/**\n * @fileoverview Angular module for the Agent Client adapter.\n *\n * @module @memberjunction/ng-agent-client\n */\n\nimport { NgModule } from '@angular/core';\nimport { CommonModule } from '@angular/common';\n\n@NgModule({\n    imports: [CommonModule],\n    declarations: [],\n    exports: [],\n})\nexport class AgentClientModule {}\n"]}

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

@@ -0,0 +1,73 @@
+/**
+ * @fileoverview Angular adapter for the MJ Agent Client SDK.
+ *
+ * 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 { 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 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
+ *
+ * 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;
+    /** 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;
+    /** 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;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AgentClientService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AgentClientService>;
+}
+//# sourceMappingURL=agent-client.service.d.ts.map

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

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

@@ -0,0 +1,119 @@
+/**
+ * @fileoverview Angular adapter for the MJ Agent Client SDK.
+ *
+ * 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 } from '@angular/core';
+import { AgentClientSession, } from '@memberjunction/ai-agent-client';
+import * as i0 from "@angular/core";
+/**
+ * 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
+ *
+ * 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 = 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.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);
+    }
+    /** Run an agent from an existing conversation detail */
+    async RunAgentFromConversationDetail(params) {
+        return this.session.RunAgentFromConversationDetail(params);
+    }
+    // --- Angular Lifecycle ---
+    ngOnDestroy() {
+        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' });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(AgentClientService, [{
+        type: Injectable,
+        args: [{ providedIn: 'root' }]
+    }], null, null); })();
+//# sourceMappingURL=agent-client.service.js.map

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

@@ -0,0 +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 * 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

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

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

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

@@ -0,0 +1,6 @@
+/*
+ * Public API Surface for @memberjunction/ng-agent-client
+ */
+export * from './lib/agent-client.service';
+export * from './lib/agent-client.module';
+//# sourceMappingURL=public-api.js.map

package/dist/public-api.js.map

@@ -0,0 +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","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,10 +1,39 @@
 {
   "name": "@memberjunction/ng-agent-client",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @memberjunction/ng-agent-client",
-  "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+  "version": "5.23.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",
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "build": "ngc",
+    "test:watch": "vitest"
+  },
+  "keywords": [],
+  "author": "MemberJunction.com",
+  "license": "ISC",
+  "devDependencies": {
+    "@angular/compiler": "21.1.3",
+    "@angular/compiler-cli": "21.1.3",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "@angular/common": "21.1.3",
+    "@angular/core": "21.1.3",
+    "@angular/router": "21.1.3"
+  },
+  "dependencies": {
+    "@memberjunction/ai-agent-client": "5.23.0",
+    "@memberjunction/global": "5.23.0",
+    "rxjs": "^7.8.2",
+    "tslib": "^2.8.1"
+  },
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/MJ"
+  }
 }