@copilotkitnext/angular 0.0.1 → 0.0.4

package/src/utils/agent-context.utils.ts

@@ -1,133 +0,0 @@
-import { DestroyRef, inject } from '@angular/core';
-import { CopilotKitService } from '../core/copilotkit.service';
-import { Context } from '@ag-ui/client';
-
-/**
- * Programmatically adds an agent context to CopilotKit and returns a cleanup function.
- * 
- * @param context - The context to add
- * @returns A cleanup function that removes the context
- * 
- * @example
- * ```typescript
- * export class MyComponent implements OnInit {
- *   private copilotkit = injectCopilotKit();
- *   
- *   ngOnInit() {
- *     const cleanup = addAgentContext(this.copilotkit, {
- *       description: 'User preferences',
- *       value: this.userSettings
- *     });
- *     
- *     // Store cleanup for later or register with DestroyRef
- *     this.cleanupFns.push(cleanup);
- *   }
- * }
- * ```
- */
-export function addAgentContext(
-  copilotkit: CopilotKitService,
-  context: Context
-): () => void {
-  const contextId = copilotkit.copilotkit.addContext(context);
-  
-  return () => {
-    copilotkit.copilotkit.removeContext(contextId);
-  };
-}
-
-/**
- * Registers an agent context with CopilotKit and automatically removes it when the component/service is destroyed.
- * Must be called within an injection context.
- * 
- * @param context - The context to add
- * @returns The context ID
- * 
- * @example
- * ```typescript
- * export class MyComponent implements OnInit {
- *   ngOnInit() {
- *     // Automatically cleaned up on component destroy
- *     registerAgentContext({
- *       description: 'Component state',
- *       value: this.state
- *     });
- *   }
- * }
- * ```
- */
-export function registerAgentContext(context: Context): string {
-  const copilotkit = inject(CopilotKitService);
-  const destroyRef = inject(DestroyRef);
-  
-  const contextId = copilotkit.copilotkit.addContext(context);
-  
-  // Register cleanup with Angular's DestroyRef
-  destroyRef.onDestroy(() => {
-    copilotkit.copilotkit.removeContext(contextId);
-  });
-  
-  return contextId;
-}
-
-/**
- * Creates a reactive context that updates whenever the value changes.
- * Uses Angular signals for reactivity.
- * 
- * @param description - Static or signal-based description
- * @param value - Signal that provides the context value
- * @returns Object with update and destroy methods
- * 
- * @example
- * ```typescript
- * export class MyComponent {
- *   private userSettings = signal({ theme: 'dark' });
- *   
- *   ngOnInit() {
- *     const context = createReactiveContext(
- *       'User settings',
- *       computed(() => this.userSettings())
- *     );
- *     
- *     // Updates automatically when userSettings signal changes
- *   }
- * }
- * ```
- */
-export function createReactiveContext(
-  description: string | (() => string),
-  value: () => any
-): { update: () => void; destroy: () => void } {
-  const copilotkit = inject(CopilotKitService);
-  let currentContextId: string | undefined;
-  
-  const update = () => {
-    // Remove old context if it exists
-    if (currentContextId) {
-      copilotkit.copilotkit.removeContext(currentContextId);
-    }
-    
-    // Add new context
-    const desc = typeof description === 'function' ? description() : description;
-    currentContextId = copilotkit.copilotkit.addContext({
-      description: desc,
-      value: value()
-    });
-  };
-  
-  const destroy = () => {
-    if (currentContextId) {
-      copilotkit.copilotkit.removeContext(currentContextId);
-      currentContextId = undefined;
-    }
-  };
-  
-  // Initial setup
-  update();
-  
-  // Register cleanup
-  const destroyRef = inject(DestroyRef);
-  destroyRef.onDestroy(destroy);
-  
-  return { update, destroy };
-}

package/src/utils/agent.utils.ts

@@ -1,239 +0,0 @@
-import { DestroyRef, inject, signal, computed } from "@angular/core";
-import { toObservable } from "@angular/core/rxjs-interop";
-import { CopilotKitService } from "../core/copilotkit.service";
-import {
-  AgentSubscriptionCallbacks,
-  AgentWatchResult,
-} from "../core/copilotkit.types";
-import { AbstractAgent } from "@ag-ui/client";
-import { DEFAULT_AGENT_ID } from "@copilotkitnext/shared";
-
-/**
- * Watches an agent and provides reactive signals for its state.
- * Must be called within an injection context.
- * Automatically cleans up when the component/service is destroyed.
- *
- * @param config - Optional configuration with agentId
- * @returns Object with agent, messages, and isRunning signals plus observables
- *
- * @example
- * ```typescript
- * export class MyComponent {
- *   // Automatically tracks agent state
- *   agentState = watchAgent({ agentId: 'my-agent' });
- *
- *   constructor() {
- *     effect(() => {
- *       const messages = this.agentState.messages();
- *       const isRunning = this.agentState.isRunning();
- *       console.log('Messages:', messages.length, 'Running:', isRunning);
- *     });
- *   }
- * }
- * ```
- */
-export function watchAgent(config?: { agentId?: string }): AgentWatchResult {
-  // Use inject() internally to get required services
-  const service = inject(CopilotKitService);
-  const destroyRef = inject(DestroyRef);
-  const effectiveAgentId = config?.agentId ?? DEFAULT_AGENT_ID;
-
-  // Create reactive signals with tick mechanism for reliable updates
-  const agentSignal = signal<AbstractAgent | undefined>(undefined);
-  const tick = signal<number>(0);
-  const isRunningSignal = signal<boolean>(false);
-
-  // Create computed messages signal that reacts to tick changes
-  const messages = computed(() => {
-    // Access tick to ensure recomputation
-    tick();
-    const a = agentSignal();
-    if (!a) return [];
-    // Return a shallow clone to ensure change detection
-    return a.messages.map((m) => ({ ...m }));
-  });
-
-  // Get initial agent
-  const updateAgent = () => {
-    const agent = service.copilotkit.getAgent(effectiveAgentId);
-    agentSignal.set(agent);
-    return agent;
-  };
-
-  // Initial update
-  let currentAgent = updateAgent();
-
-  // Subscribe to agent changes
-  let agentSubscription: { unsubscribe: () => void } | undefined;
-
-  const subscribeToAgent = () => {
-    // Unsubscribe from previous agent if any
-    agentSubscription?.unsubscribe();
-
-    if (currentAgent) {
-      agentSubscription = currentAgent.subscribe({
-        onMessagesChanged() {
-          // Increment tick to force recomputation of messages computed
-          tick.update((v) => v + 1);
-        },
-        onStateChanged() {
-          // Increment tick to force recomputation
-          tick.update((v) => v + 1);
-        },
-        onRunInitialized() {
-          isRunningSignal.set(true);
-        },
-        onRunFinalized() {
-          isRunningSignal.set(false);
-        },
-        onRunFailed() {
-          isRunningSignal.set(false);
-        },
-      });
-    }
-  };
-
-  // Initial subscription
-  subscribeToAgent();
-
-  // Subscribe to CopilotKit changes to detect agent updates
-  const coreUnsubscribe = service.copilotkit.subscribe({
-    onRuntimeLoaded() {
-      // Re-check agent when runtime loads
-      currentAgent = updateAgent();
-      subscribeToAgent();
-    },
-    onRuntimeLoadError() {
-      // Also re-check agent on runtime load error to ensure consistency
-      currentAgent = updateAgent();
-      subscribeToAgent();
-    },
-  });
-
-  // Register cleanup
-  const unsubscribe = () => {
-    agentSubscription?.unsubscribe();
-    coreUnsubscribe(); // subscribe returns a function directly
-  };
-
-  destroyRef.onDestroy(unsubscribe);
-
-  // Create observables from signals using toObservable
-  const agent$ = toObservable(agentSignal);
-  const isRunning$ = toObservable(isRunningSignal);
-  const messages$ = toObservable(messages);
-
-  return {
-    agent: agentSignal.asReadonly(),
-    messages: messages,
-    isRunning: isRunningSignal.asReadonly(),
-    agent$,
-    messages$,
-    isRunning$,
-    unsubscribe,
-  };
-}
-
-/**
- * Gets an agent by ID without subscribing to changes.
- *
- * @param service - The CopilotKitService instance
- * @param agentId - Optional agent ID (defaults to DEFAULT_AGENT_ID)
- * @returns The agent or undefined if not found
- *
- * @example
- * ```typescript
- * export class MyComponent {
- *   constructor(private copilotkit: CopilotKitService) {}
- *
- *   getCurrentAgent() {
- *     return getAgent(this.copilotkit, 'my-agent');
- *   }
- * }
- * ```
- */
-export function getAgent(
-  service: CopilotKitService,
-  agentId?: string
-): AbstractAgent | undefined {
-  const effectiveAgentId = agentId ?? DEFAULT_AGENT_ID;
-  return service.copilotkit.getAgent(effectiveAgentId);
-}
-
-// Re-export the type for convenience (the actual type is in copilotkit.types)
-export type { AgentWatchResult } from "../core/copilotkit.types";
-
-/**
- * Subscribes to an agent's events with custom callbacks.
- * Returns a cleanup function that should be called to unsubscribe.
- *
- * @param service - The CopilotKitService instance
- * @param agentId - Optional agent ID (defaults to DEFAULT_AGENT_ID)
- * @param callbacks - Event callbacks
- * @returns Cleanup function to unsubscribe
- *
- * @example
- * ```typescript
- * export class MyComponent implements OnInit, OnDestroy {
- *   private unsubscribe?: () => void;
- *
- *   constructor(private copilotkit: CopilotKitService) {}
- *
- *   ngOnInit() {
- *     this.unsubscribe = subscribeToAgent(this.copilotkit, 'my-agent', {
- *       onRunInitialized: () => console.log('Run started'),
- *       onRunFinalized: () => console.log('Run completed'),
- *       onRunFailed: (error) => console.error('Run failed', error),
- *     });
- *   }
- *
- *   ngOnDestroy() {
- *     this.unsubscribe?.();
- *   }
- * }
- * ```
- */
-export function subscribeToAgent(
-  service: CopilotKitService,
-  agentId?: string,
-  callbacks?: AgentSubscriptionCallbacks
-): () => void {
-  const effectiveAgentId = agentId ?? DEFAULT_AGENT_ID;
-  const agent = service.copilotkit.getAgent(effectiveAgentId);
-
-  if (!agent) {
-    // Return no-op cleanup if agent doesn't exist
-    return () => {};
-  }
-
-  const subscription = agent.subscribe({
-    onMessagesChanged: callbacks?.onMessagesChanged,
-    onStateChanged: callbacks?.onStateChanged,
-    onRunInitialized: callbacks?.onRunInitialized,
-    onRunFinalized: callbacks?.onRunFinalized,
-    onRunFailed: callbacks?.onRunFailed,
-  });
-
-  return () => subscription.unsubscribe();
-}
-
-/**
- * Registers an agent watcher that automatically cleans up on component destroy.
- * This is an alias for watchAgent with a more explicit name.
- * Must be called within an injection context.
- *
- * @param config - Optional configuration with agentId
- * @returns Object with agent, messages, and isRunning signals plus observables
- *
- * @example
- * ```typescript
- * export class MyComponent {
- *   agentState = registerAgentWatcher({ agentId: 'my-agent' });
- * }
- * ```
- */
-export function registerAgentWatcher(config?: {
-  agentId?: string;
-}): AgentWatchResult {
-  return watchAgent(config);
-}

package/src/utils/chat-config.utils.ts

@@ -1,221 +0,0 @@
-import { inject, Signal } from '@angular/core';
-import { CopilotChatConfigurationService } from '../core/chat-configuration/chat-configuration.service';
-import { 
-  CopilotChatConfiguration,
-  CopilotChatLabels
-} from '../core/chat-configuration/chat-configuration.types';
-
-/**
- * Watches chat configuration and provides reactive access to all configuration values.
- * Must be called within an injection context.
- * 
- * @returns Object with reactive signals and handler functions
- * 
- * @example
- * ```typescript
- * export class ChatInputComponent {
- *   config = watchChatConfig();
- *   
- *   constructor() {
- *     effect(() => {
- *       const placeholder = this.config.labels().chatInputPlaceholder;
- *       console.log('Placeholder:', placeholder);
- *     });
- *   }
- *   
- *   handleSubmit(value: string) {
- *     this.config.submitInput(value);
- *   }
- * }
- * ```
- */
-export function watchChatConfig(): {
-  labels: Signal<CopilotChatLabels>;
-  inputValue: Signal<string | undefined>;
-  submitInput: (value: string) => void;
-  changeInput: (value: string) => void;
-} {
-  const service = inject(CopilotChatConfigurationService);
-  
-  return {
-    labels: service.labels,
-    inputValue: service.inputValue,
-    submitInput: (value: string) => service.submitInput(value),
-    changeInput: (value: string) => service.changeInput(value)
-  };
-}
-
-/**
- * Registers chat configuration within an injection context.
- * Automatically updates the configuration when called.
- * 
- * @param config - The configuration to register
- * 
- * @example
- * ```typescript
- * export class ChatComponent {
- *   constructor() {
- *     registerChatConfig({
- *       labels: {
- *         chatInputPlaceholder: "How can I help?"
- *       },
- *       onSubmitInput: (value) => this.handleSubmit(value)
- *     });
- *   }
- * }
- * ```
- */
-export function registerChatConfig(config: CopilotChatConfiguration): void {
-  const service = inject(CopilotChatConfigurationService);
-  service.updateConfiguration(config);
-}
-
-/**
- * Gets the current chat labels signal.
- * 
- * @param service - The CopilotChatConfigurationService instance
- * @returns Signal containing the current labels
- * 
- * @example
- * ```typescript
- * export class ChatComponent {
- *   constructor(private chatConfig: CopilotChatConfigurationService) {
- *     const labels = getChatLabels(this.chatConfig);
- *     effect(() => {
- *       console.log('Current labels:', labels());
- *     });
- *   }
- * }
- * ```
- */
-export function getChatLabels(
-  service: CopilotChatConfigurationService
-): Signal<CopilotChatLabels> {
-  return service.labels;
-}
-
-/**
- * Updates chat labels.
- * 
- * @param service - The CopilotChatConfigurationService instance
- * @param labels - Partial labels to merge with defaults
- * 
- * @example
- * ```typescript
- * export class ChatComponent {
- *   updatePlaceholder(text: string) {
- *     setChatLabels(this.chatConfig, {
- *       chatInputPlaceholder: text
- *     });
- *   }
- * }
- * ```
- */
-export function setChatLabels(
-  service: CopilotChatConfigurationService,
-  labels: Partial<CopilotChatLabels>
-): void {
-  service.setLabels(labels);
-}
-
-/**
- * Gets the current input value signal.
- * 
- * @param service - The CopilotChatConfigurationService instance
- * @returns Signal containing the current input value
- * 
- * @example
- * ```typescript
- * export class ChatInputComponent {
- *   inputValue = getChatInputValue(this.chatConfig);
- *   
- *   constructor(private chatConfig: CopilotChatConfigurationService) {
- *     effect(() => {
- *       const value = this.inputValue();
- *       if (value) {
- *         this.updateTextarea(value);
- *       }
- *     });
- *   }
- * }
- * ```
- */
-export function getChatInputValue(
-  service: CopilotChatConfigurationService
-): Signal<string | undefined> {
-  return service.inputValue;
-}
-
-/**
- * Sets the current input value.
- * 
- * @param service - The CopilotChatConfigurationService instance
- * @param value - The new input value
- * 
- * @example
- * ```typescript
- * export class ChatInputComponent {
- *   onInputChange(event: Event) {
- *     const value = (event.target as HTMLInputElement).value;
- *     setChatInputValue(this.chatConfig, value);
- *   }
- * }
- * ```
- */
-export function setChatInputValue(
-  service: CopilotChatConfigurationService,
-  value: string | undefined
-): void {
-  service.setInputValue(value);
-}
-
-/**
- * Creates a chat configuration controller with dynamic update capabilities.
- * This is useful when you need to programmatically manage configuration.
- * 
- * @param service - The CopilotChatConfigurationService instance
- * @param initialConfig - Optional initial configuration
- * @returns Controller object with update and reset methods
- * 
- * @example
- * ```typescript
- * export class ChatManagerComponent {
- *   chatController = createChatConfigController(this.chatConfig, {
- *     labels: { chatInputPlaceholder: "Ask me..." }
- *   });
- *   
- *   constructor(private chatConfig: CopilotChatConfigurationService) {}
- *   
- *   updateForSupportMode() {
- *     this.chatController.update({
- *       labels: { chatInputPlaceholder: "Describe your issue..." }
- *     });
- *   }
- *   
- *   resetToDefaults() {
- *     this.chatController.reset();
- *   }
- * }
- * ```
- */
-export function createChatConfigController(
-  service: CopilotChatConfigurationService,
-  initialConfig?: CopilotChatConfiguration
-): {
-  update: (config: CopilotChatConfiguration) => void;
-  reset: () => void;
-  getLabels: () => CopilotChatLabels;
-  getInputValue: () => string | undefined;
-} {
-  // Apply initial configuration if provided
-  if (initialConfig) {
-    service.updateConfiguration(initialConfig);
-  }
-  
-  return {
-    update: (config: CopilotChatConfiguration) => service.updateConfiguration(config),
-    reset: () => service.reset(),
-    getLabels: () => service.labels(),
-    getInputValue: () => service.inputValue()
-  };
-}

package/src/utils/copilotkit.utils.ts

@@ -1,20 +0,0 @@
-import { inject } from "@angular/core";
-import { CopilotKitService } from "../core/copilotkit.service";
-
-/**
- * Utility function to inject the CopilotKit service in a component or directive.
- * 
- * @example
- * ```typescript
- * export class MyComponent {
- *   private copilotkit = injectCopilotKit();
- *   
- *   sendMessage() {
- *     this.copilotkit.copilotkit.sendMessage(...);
- *   }
- * }
- * ```
- */
-export function injectCopilotKit() {
-  return inject(CopilotKitService);
-}