@memberjunction/ng-agent-client 0.0.1 → 5.22.0

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,74 @@
+/**
+ * @fileoverview Angular adapter for the MJ Agent Client SDK.
+ *
+ * Provides an injectable service that wraps AgentClientSession with
+ * RxJS observables for reactive Angular consumption.
+ *
+ * @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 * as i0 from "@angular/core";
+/**
+ * Angular injectable service that wraps the framework-agnostic Agent Client SDK.
+ *
+ * Provides RxJS observable bridges for agent messages, progress, and connection state.
+ * Pre-registers built-in navigation and component tools.
+ */
+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.
+     */
+    RegisterTool(tool: ClientToolDefinition): void;
+    /**
+     * Get the current conversation ID.
+     */
+    get ConversationId(): string | null;
+    /**
+     * Clean up on service destruction.
+     */
+    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>;
+}
+//# 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;;;;;;;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"}

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

@@ -0,0 +1,184 @@
+/**
+ * @fileoverview Angular adapter for the MJ Agent Client SDK.
+ *
+ * Provides an injectable service that wraps AgentClientSession with
+ * RxJS observables for reactive Angular consumption.
+ *
+ * @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 * as i0 from "@angular/core";
+/**
+ * Angular injectable service that wraps the framework-agnostic Agent Client SDK.
+ *
+ * Provides RxJS observable bridges for agent messages, progress, and connection state.
+ * Pre-registers built-in navigation and component tools.
+ */
+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.
+     */
+    RegisterTool(tool) {
+        this.toolRegistry.Register(tool);
+    }
+    /**
+     * Get the current conversation ID.
+     */
+    get ConversationId() {
+        return this.session?.ConversationId ?? null;
+    }
+    /**
+     * Clean up on service destruction.
+     */
+    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' } };
+            },
+        });
+    }
+    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); })();
+//# 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 * 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"]}

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

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

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

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

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

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

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

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

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

package/dist/public-api.d.ts

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

@@ -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;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC"}

package/dist/public-api.js

@@ -0,0 +1,8 @@
+/*
+ * Public API Surface for @memberjunction/ng-agent-client
+ */
+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

@@ -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;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"]}

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.22.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": "echo \"No tests configured yet\"",
+    "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.22.0",
+    "@memberjunction/global": "5.22.0",
+    "rxjs": "^7.8.2",
+    "tslib": "^2.8.1"
+  },
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/MemberJunction/MJ"
+  }
 }

package/README.md

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