@copilotkitnext/angular 0.0.1 → 0.0.4

package/src/types/frontend-tool.ts

@@ -1,44 +0,0 @@
-import { Type, TemplateRef } from "@angular/core";
-import type { z } from "zod";
-
-/**
- * Angular-specific frontend tool definition.
- * Provides a handler function that executes on the frontend when the tool is called.
- */
-export interface AngularFrontendTool<T extends Record<string, any> = Record<string, any>> {
-  /**
-   * The name of the tool - must be unique
-   */
-  name: string;
-  
-  /**
-   * Description of what the tool does
-   */
-  description?: string;
-  
-  /**
-   * Zod schema defining the parameters for the tool
-   */
-  parameters?: z.ZodSchema<T>;
-  
-  /**
-   * Handler function that executes when the tool is called
-   */
-  handler?: (args: T) => Promise<any>;
-  
-  /**
-   * Optional Angular component or template to render when the tool is called
-   */
-  render?: Type<any> | TemplateRef<any>;
-  
-  /**
-   * Whether the agent should follow up after this tool completes.
-   * Defaults to true if not specified.
-   */
-  followUp?: boolean;
-  
-  /**
-   * Optional agent ID to constrain this tool to a specific agent
-   */
-  agentId?: string;
-}

package/src/types/human-in-the-loop.ts

@@ -1,52 +0,0 @@
-import { Type, TemplateRef } from "@angular/core";
-import type { z } from "zod";
-import { AngularFrontendTool } from "./frontend-tool";
-import { ToolCallStatus } from "@copilotkitnext/core";
-
-/**
- * Props passed to human-in-the-loop render components - discriminated union matching React
- */
-export type HumanInTheLoopProps<T = unknown> =
-  | {
-      name: string;
-      description: string;
-      args: Partial<T>;
-      status: ToolCallStatus.InProgress;
-      result: undefined;
-      respond: undefined;
-    }
-  | {
-      name: string;
-      description: string;
-      args: T;
-      status: ToolCallStatus.Executing;
-      result: undefined;
-      respond: (result: unknown) => Promise<void>;
-    }
-  | {
-      name: string;
-      description: string;
-      args: T;
-      status: ToolCallStatus.Complete;
-      result: string;
-      respond: undefined;
-    };
-
-/**
- * Angular human-in-the-loop tool definition.
- * Similar to frontend tools but designed for interactive user input scenarios.
- */
-export interface AngularHumanInTheLoop<
-  T extends Record<string, any> = Record<string, any>,
-> extends Omit<AngularFrontendTool<T>, "handler" | "render"> {
-  /**
-   * Angular component or template to render for user interaction.
-   * Required for human-in-the-loop tools.
-   */
-  render: Type<HumanInTheLoopProps<T>> | TemplateRef<HumanInTheLoopProps<T>>;
-
-  /**
-   * Parameters schema is required for human-in-the-loop tools
-   */
-  parameters: z.ZodType<T>;
-}

package/src/utils/__tests__/agent.utils.spec.ts

@@ -1,234 +0,0 @@
-import { TestBed } from "@angular/core/testing";
-import { Component, OnInit, DestroyRef, inject } from "@angular/core";
-import { describe, it, expect, beforeEach, vi, afterEach } from "vitest";
-import {
-  watchAgent,
-  getAgent,
-  subscribeToAgent,
-  registerAgentWatcher,
-} from "../agent.utils";
-import { CopilotKitService } from "../../core/copilotkit.service";
-import { provideCopilotKit } from "../../core/copilotkit.providers";
-import { AbstractAgent } from "@ag-ui/client";
-import { DEFAULT_AGENT_ID } from "@copilotkitnext/shared";
-import { effect } from "@angular/core";
-
-// Mock CopilotKitCore
-const mockAgent = {
-  subscribe: vi.fn((callbacks) => ({
-    unsubscribe: vi.fn(),
-  })),
-  id: "test-agent",
-  state: {},
-  messages: [],
-};
-
-const mockCopilotKitCore = {
-  addTool: vi.fn(),
-  removeTool: vi.fn(),
-  setRuntimeUrl: vi.fn(),
-  setHeaders: vi.fn(),
-  setProperties: vi.fn(),
-  setAgents: vi.fn(),
-  getAgent: vi.fn((id: string) =>
-    id === "test-agent" ? mockAgent : undefined
-  ),
-  subscribe: vi.fn(() => vi.fn()), // Returns unsubscribe function directly
-};
-
-vi.mock("@copilotkitnext/core", () => ({
-  CopilotKitCore: vi.fn().mockImplementation(() => mockCopilotKitCore),
-}));
-
-describe("Agent Utilities", () => {
-  let service: CopilotKitService;
-
-  beforeEach(() => {
-    TestBed.configureTestingModule({
-      providers: [provideCopilotKit({})],
-    });
-
-    service = TestBed.inject(CopilotKitService);
-    vi.clearAllMocks();
-  });
-
-  afterEach(() => {
-    vi.clearAllMocks();
-  });
-
-  describe("getAgent", () => {
-    it("should get agent by ID", () => {
-      const agent = getAgent(service, "test-agent");
-      expect(agent).toBe(mockAgent);
-      expect(mockCopilotKitCore.getAgent).toHaveBeenCalledWith("test-agent");
-    });
-
-    it("should use default agent ID when not provided", () => {
-      getAgent(service);
-      expect(mockCopilotKitCore.getAgent).toHaveBeenCalledWith(
-        DEFAULT_AGENT_ID
-      );
-    });
-
-    it("should return undefined for non-existent agent", () => {
-      const agent = getAgent(service, "non-existent");
-      expect(agent).toBeUndefined();
-    });
-  });
-
-  describe("subscribeToAgent", () => {
-    it("should subscribe to agent events", () => {
-      const callbacks = {
-        onRunInitialized: vi.fn(),
-        onRunFinalized: vi.fn(),
-        onRunFailed: vi.fn(),
-      };
-
-      const unsubscribe = subscribeToAgent(service, "test-agent", callbacks);
-
-      expect(mockAgent.subscribe).toHaveBeenCalledWith(
-        expect.objectContaining({
-          onRunInitialized: callbacks.onRunInitialized,
-          onRunFinalized: callbacks.onRunFinalized,
-          onRunFailed: callbacks.onRunFailed,
-        })
-      );
-
-      expect(typeof unsubscribe).toBe("function");
-    });
-
-    it("should return no-op function for non-existent agent", () => {
-      const unsubscribe = subscribeToAgent(service, "non-existent");
-      expect(typeof unsubscribe).toBe("function");
-      unsubscribe(); // Should not throw
-    });
-
-    it("should handle partial callbacks", () => {
-      const callbacks = {
-        onRunInitialized: vi.fn(),
-      };
-
-      subscribeToAgent(service, "test-agent", callbacks);
-
-      expect(mockAgent.subscribe).toHaveBeenCalledWith(
-        expect.objectContaining({
-          onRunInitialized: callbacks.onRunInitialized,
-          onRunFinalized: undefined,
-          onRunFailed: undefined,
-        })
-      );
-    });
-  });
-
-  describe("watchAgent", () => {
-    it("should return reactive signals within component context", () => {
-      @Component({
-        template: "",
-        standalone: true,
-        providers: [provideCopilotKit({})],
-      })
-      class TestComponent {
-        agentState: any;
-        agentValue: AbstractAgent | undefined;
-        messagesValue: any[] = [];
-        isRunningValue = false;
-
-        constructor() {
-          this.agentState = watchAgent({ agentId: "test-agent" });
-          // Use effect in constructor (injection context)
-          effect(() => {
-            this.agentValue = this.agentState.agent();
-            this.messagesValue = this.agentState.messages();
-            this.isRunningValue = this.agentState.isRunning();
-          });
-        }
-      }
-
-      const fixture = TestBed.createComponent(TestComponent);
-      fixture.detectChanges();
-
-      expect(fixture.componentInstance.agentState).toBeDefined();
-      expect(fixture.componentInstance.agentState.agent).toBeDefined();
-      expect(fixture.componentInstance.agentState.messages).toBeDefined();
-      expect(fixture.componentInstance.agentState.isRunning).toBeDefined();
-      expect(fixture.componentInstance.agentState.agent$).toBeDefined();
-      expect(fixture.componentInstance.agentState.messages$).toBeDefined();
-      expect(fixture.componentInstance.agentState.isRunning$).toBeDefined();
-    });
-
-    it("should cleanup on component destroy", () => {
-      @Component({
-        template: "",
-        standalone: true,
-        providers: [provideCopilotKit({})],
-      })
-      class TestComponent {
-        agentState: any;
-
-        constructor() {
-          this.agentState = watchAgent({ agentId: "test-agent" });
-        }
-      }
-
-      const fixture = TestBed.createComponent(TestComponent);
-      fixture.detectChanges();
-
-      const unsubscribeSpy = vi.fn();
-      fixture.componentInstance.agentState.unsubscribe = unsubscribeSpy;
-
-      fixture.destroy();
-
-      // The actual unsubscribe is handled by DestroyRef,
-      // but we can verify the function exists
-      expect(fixture.componentInstance.agentState.unsubscribe).toBeDefined();
-    });
-
-    it("should use default agent ID when not provided", () => {
-      @Component({
-        template: "",
-        standalone: true,
-        providers: [provideCopilotKit({})],
-      })
-      class TestComponent {
-        agentState = watchAgent(); // No agent ID
-      }
-
-      const fixture = TestBed.createComponent(TestComponent);
-      fixture.detectChanges();
-
-      expect(mockCopilotKitCore.getAgent).toHaveBeenCalledWith(
-        DEFAULT_AGENT_ID
-      );
-    });
-  });
-
-  describe("registerAgentWatcher", () => {
-    it("should be an alias for watchAgent", () => {
-      @Component({
-        template: "",
-        standalone: true,
-        providers: [provideCopilotKit({})],
-      })
-      class TestComponent {
-        agentState = registerAgentWatcher({ agentId: "test-agent" });
-      }
-
-      const fixture = TestBed.createComponent(TestComponent);
-      fixture.detectChanges();
-
-      expect(fixture.componentInstance.agentState).toBeDefined();
-      expect(fixture.componentInstance.agentState.agent).toBeDefined();
-      expect(fixture.componentInstance.agentState.messages).toBeDefined();
-      expect(fixture.componentInstance.agentState.isRunning).toBeDefined();
-      expect(mockCopilotKitCore.getAgent).toHaveBeenCalledWith("test-agent");
-    });
-  });
-
-  describe("CopilotKitService.getAgent", () => {
-    it("should delegate to core getAgent", () => {
-      const agent = service.getAgent("test-agent");
-      expect(agent).toBe(mockAgent);
-      expect(mockCopilotKitCore.getAgent).toHaveBeenCalledWith("test-agent");
-    });
-  });
-});

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

@@ -1,306 +0,0 @@
-import { TestBed } from '@angular/core/testing';
-import { Component } from '@angular/core';
-import { describe, it, expect, beforeEach, vi } from 'vitest';
-import { 
-  watchChatConfig,
-  registerChatConfig,
-  getChatLabels,
-  setChatLabels,
-  getChatInputValue,
-  setChatInputValue,
-  createChatConfigController
-} from '../chat-config.utils';
-import { CopilotChatConfigurationService } from '../../core/chat-configuration/chat-configuration.service';
-import { provideCopilotChatConfiguration } from '../../core/chat-configuration/chat-configuration.providers';
-import { COPILOT_CHAT_DEFAULT_LABELS } from '../../core/chat-configuration/chat-configuration.types';
-import { effect } from '@angular/core';
-
-describe('Chat Configuration Utilities', () => {
-  describe('watchChatConfig', () => {
-    it('should return reactive configuration within component context', () => {
-      @Component({
-        template: '',
-        standalone: true,
-        providers: provideCopilotChatConfiguration({
-          labels: { chatInputPlaceholder: 'Test placeholder' },
-          inputValue: 'test value'
-        })
-      })
-      class TestComponent {
-        config = watchChatConfig();
-      }
-
-      const fixture = TestBed.createComponent(TestComponent);
-      fixture.detectChanges();
-
-      const component = fixture.componentInstance;
-      
-      expect(component.config.labels().chatInputPlaceholder).toBe('Test placeholder');
-      expect(component.config.inputValue()).toBe('test value');
-      expect(typeof component.config.submitInput).toBe('function');
-      expect(typeof component.config.changeInput).toBe('function');
-    });
-
-    it('should provide reactive signals that update', () => {
-      TestBed.configureTestingModule({
-        providers: provideCopilotChatConfiguration()
-      });
-      
-      @Component({
-        template: '',
-        standalone: true
-      })
-      class TestComponent {
-        config = watchChatConfig();
-      }
-
-      const fixture = TestBed.createComponent(TestComponent);
-      fixture.detectChanges();
-
-      const service = TestBed.inject(CopilotChatConfigurationService);
-      
-      // Initial value
-      expect(fixture.componentInstance.config.labels().chatInputPlaceholder).toBe('Type a message...');
-      
-      // Update labels through service
-      service.setLabels({ chatInputPlaceholder: 'Updated' });
-      
-      // Signals update synchronously
-      expect(fixture.componentInstance.config.labels().chatInputPlaceholder).toBe('Updated');
-    });
-
-    it('should call service methods when handlers are invoked', () => {
-      const submitHandler = vi.fn();
-      const changeHandler = vi.fn();
-
-      @Component({
-        template: '',
-        standalone: true,
-        providers: provideCopilotChatConfiguration({
-          onSubmitInput: submitHandler,
-          onChangeInput: changeHandler
-        })
-      })
-      class TestComponent {
-        config = watchChatConfig();
-      }
-
-      const fixture = TestBed.createComponent(TestComponent);
-      fixture.detectChanges();
-
-      const component = fixture.componentInstance;
-      
-      component.config.submitInput('test submit');
-      expect(submitHandler).toHaveBeenCalledWith('test submit');
-      
-      component.config.changeInput('test change');
-      expect(changeHandler).toHaveBeenCalledWith('test change');
-    });
-  });
-
-  describe('registerChatConfig', () => {
-    it('should update configuration when called within injection context', () => {
-      TestBed.configureTestingModule({
-        providers: provideCopilotChatConfiguration()
-      });
-      
-      @Component({
-        template: '',
-        standalone: true
-      })
-      class TestComponent {
-        constructor() {
-          registerChatConfig({
-            labels: { chatInputPlaceholder: 'Registered placeholder' },
-            inputValue: 'registered value'
-          });
-        }
-      }
-
-      const fixture = TestBed.createComponent(TestComponent);
-      fixture.detectChanges();
-
-      const service = TestBed.inject(CopilotChatConfigurationService);
-      
-      expect(service.labels().chatInputPlaceholder).toBe('Registered placeholder');
-      expect(service.inputValue()).toBe('registered value');
-    });
-
-    it('should set handlers through registerChatConfig', () => {
-      const submitHandler = vi.fn();
-      const changeHandler = vi.fn();
-
-      TestBed.configureTestingModule({
-        providers: provideCopilotChatConfiguration()
-      });
-      
-      @Component({
-        template: '',
-        standalone: true
-      })
-      class TestComponent {
-        constructor() {
-          registerChatConfig({
-            onSubmitInput: submitHandler,
-            onChangeInput: changeHandler
-          });
-        }
-      }
-
-      const fixture = TestBed.createComponent(TestComponent);
-      fixture.detectChanges();
-
-      const service = TestBed.inject(CopilotChatConfigurationService);
-      
-      service.submitInput('test');
-      expect(submitHandler).toHaveBeenCalledWith('test');
-      
-      service.changeInput('change');
-      expect(changeHandler).toHaveBeenCalledWith('change');
-    });
-  });
-
-  describe('getChatLabels and setChatLabels', () => {
-    let service: CopilotChatConfigurationService;
-
-    beforeEach(() => {
-      TestBed.configureTestingModule({
-        providers: provideCopilotChatConfiguration()
-      });
-      
-      service = TestBed.inject(CopilotChatConfigurationService);
-    });
-
-    it('should get current labels signal', () => {
-      const labels = getChatLabels(service);
-      expect(labels()).toEqual(COPILOT_CHAT_DEFAULT_LABELS);
-    });
-
-    it('should update labels', () => {
-      setChatLabels(service, {
-        chatInputPlaceholder: 'New placeholder',
-        chatDisclaimerText: 'New disclaimer'
-      });
-      
-      const labels = getChatLabels(service);
-      expect(labels().chatInputPlaceholder).toBe('New placeholder');
-      expect(labels().chatDisclaimerText).toBe('New disclaimer');
-    });
-
-    it('should merge labels with defaults', () => {
-      setChatLabels(service, {
-        chatInputPlaceholder: 'Custom'
-      });
-      
-      const labels = getChatLabels(service);
-      expect(labels().chatInputPlaceholder).toBe('Custom');
-      expect(labels().chatInputToolbarAddButtonLabel).toBe(
-        COPILOT_CHAT_DEFAULT_LABELS.chatInputToolbarAddButtonLabel
-      );
-    });
-  });
-
-  describe('getChatInputValue and setChatInputValue', () => {
-    let service: CopilotChatConfigurationService;
-
-    beforeEach(() => {
-      TestBed.configureTestingModule({
-        providers: provideCopilotChatConfiguration()
-      });
-      
-      service = TestBed.inject(CopilotChatConfigurationService);
-    });
-
-    it('should get current input value signal', () => {
-      const inputValue = getChatInputValue(service);
-      expect(inputValue()).toBeUndefined();
-    });
-
-    it('should update input value', () => {
-      setChatInputValue(service, 'test value');
-      
-      const inputValue = getChatInputValue(service);
-      expect(inputValue()).toBe('test value');
-    });
-
-    it('should handle undefined value', () => {
-      setChatInputValue(service, 'value');
-      setChatInputValue(service, undefined);
-      
-      const inputValue = getChatInputValue(service);
-      expect(inputValue()).toBeUndefined();
-    });
-
-    it('should trigger change handler when setting value', () => {
-      const changeHandler = vi.fn();
-      service.setChangeHandler(changeHandler);
-      
-      setChatInputValue(service, 'new value');
-      
-      expect(changeHandler).toHaveBeenCalledWith('new value');
-    });
-  });
-
-  describe('createChatConfigController', () => {
-    let service: CopilotChatConfigurationService;
-
-    beforeEach(() => {
-      TestBed.configureTestingModule({
-        providers: provideCopilotChatConfiguration()
-      });
-      
-      service = TestBed.inject(CopilotChatConfigurationService);
-    });
-
-    it('should create controller with initial configuration', () => {
-      const controller = createChatConfigController(service, {
-        labels: { chatInputPlaceholder: 'Controller placeholder' },
-        inputValue: 'controller value'
-      });
-      
-      expect(controller.getLabels().chatInputPlaceholder).toBe('Controller placeholder');
-      expect(controller.getInputValue()).toBe('controller value');
-    });
-
-    it('should update configuration through controller', () => {
-      const controller = createChatConfigController(service);
-      
-      controller.update({
-        labels: { chatInputPlaceholder: 'Updated via controller' },
-        inputValue: 'new value'
-      });
-      
-      expect(service.labels().chatInputPlaceholder).toBe('Updated via controller');
-      expect(service.inputValue()).toBe('new value');
-    });
-
-    it('should reset configuration through controller', () => {
-      const controller = createChatConfigController(service, {
-        labels: { chatInputPlaceholder: 'Custom' },
-        inputValue: 'test'
-      });
-      
-      controller.reset();
-      
-      expect(service.labels()).toEqual(COPILOT_CHAT_DEFAULT_LABELS);
-      expect(service.inputValue()).toBeUndefined();
-    });
-
-    it('should provide getter methods', () => {
-      const controller = createChatConfigController(service);
-      
-      service.setLabels({ chatInputPlaceholder: 'Test' });
-      service.setInputValue('test value');
-      
-      expect(controller.getLabels().chatInputPlaceholder).toBe('Test');
-      expect(controller.getInputValue()).toBe('test value');
-    });
-
-    it('should work without initial configuration', () => {
-      const controller = createChatConfigController(service);
-      
-      expect(controller.getLabels()).toEqual(COPILOT_CHAT_DEFAULT_LABELS);
-      expect(controller.getInputValue()).toBeUndefined();
-    });
-  });
-});