@copilotkitnext/angular 0.0.1

package/src/core/chat-configuration/chat-configuration.service.ts

@@ -0,0 +1,162 @@
+import { Injectable, Inject, Optional, signal } from '@angular/core';
+import { 
+  CopilotChatConfiguration, 
+  CopilotChatLabels,
+  COPILOT_CHAT_DEFAULT_LABELS,
+  COPILOT_CHAT_INITIAL_CONFIG
+} from './chat-configuration.types';
+
+/**
+ * Service for managing CopilotKit chat configuration.
+ * Can be provided at different component levels for scoped configuration.
+ * 
+ * @example
+ * ```typescript
+ * // Global configuration
+ * providers: [provideCopilotChatConfiguration({ labels: { ... } })]
+ * 
+ * // Component-scoped configuration
+ * @Component({
+ *   providers: [provideCopilotChatConfiguration()],
+ *   ...
+ * })
+ * ```
+ */
+@Injectable()
+export class CopilotChatConfigurationService {
+  // State signals
+  private readonly _labels: ReturnType<typeof signal<CopilotChatLabels>>;
+  private readonly _inputValue: ReturnType<typeof signal<string | undefined>>;
+  private readonly _onSubmitInput: ReturnType<typeof signal<((value: string) => void) | undefined>>;
+  private readonly _onChangeInput: ReturnType<typeof signal<((value: string) => void) | undefined>>;
+  
+  // Public readonly signals
+  readonly labels: ReturnType<typeof signal<CopilotChatLabels>>['asReadonly'] extends () => infer R ? R : never;
+  readonly inputValue: ReturnType<typeof signal<string | undefined>>['asReadonly'] extends () => infer R ? R : never;
+  
+  constructor(
+    @Optional() @Inject(COPILOT_CHAT_INITIAL_CONFIG) private readonly initialConfig: CopilotChatConfiguration | null
+  ) {
+    // Initialize state signals
+    this._labels = signal<CopilotChatLabels>(
+      this.mergeLabels(this.initialConfig?.labels)
+    );
+    this._inputValue = signal<string | undefined>(
+      this.initialConfig?.inputValue
+    );
+    this._onSubmitInput = signal<((value: string) => void) | undefined>(
+      this.initialConfig?.onSubmitInput
+    );
+    this._onChangeInput = signal<((value: string) => void) | undefined>(
+      this.initialConfig?.onChangeInput
+    );
+    
+    // Initialize public readonly signals
+    this.labels = this._labels.asReadonly();
+    this.inputValue = this._inputValue.asReadonly();
+  }
+  
+  /**
+   * Update chat labels (partial update, merged with defaults)
+   */
+  setLabels(labels: Partial<CopilotChatLabels>): void {
+    this._labels.set(this.mergeLabels(labels));
+  }
+  
+  /**
+   * Update the current input value
+   */
+  setInputValue(value: string | undefined): void {
+    this._inputValue.set(value);
+    // Also trigger change handler if set
+    if (value !== undefined) {
+      this.changeInput(value);
+    }
+  }
+  
+  /**
+   * Set the submit input handler
+   */
+  setSubmitHandler(handler: ((value: string) => void) | undefined): void {
+    this._onSubmitInput.set(handler);
+  }
+  
+  /**
+   * Set the change input handler
+   */
+  setChangeHandler(handler: ((value: string) => void) | undefined): void {
+    this._onChangeInput.set(handler);
+  }
+  
+  /**
+   * Submit the current input value
+   */
+  submitInput(value: string): void {
+    const handler = this._onSubmitInput();
+    if (handler) {
+      handler(value);
+    }
+  }
+  
+  /**
+   * Handle input value change
+   */
+  changeInput(value: string): void {
+    const handler = this._onChangeInput();
+    if (handler) {
+      handler(value);
+    }
+  }
+  
+  /**
+   * Update the entire configuration at once
+   */
+  updateConfiguration(config: CopilotChatConfiguration): void {
+    if (config.labels) {
+      this.setLabels(config.labels);
+    }
+    if (config.inputValue !== undefined) {
+      this._inputValue.set(config.inputValue);
+    }
+    if (config.onSubmitInput) {
+      this.setSubmitHandler(config.onSubmitInput);
+    }
+    if (config.onChangeInput) {
+      this.setChangeHandler(config.onChangeInput);
+    }
+  }
+  
+  /**
+   * Reset configuration to defaults
+   */
+  reset(): void {
+    this._labels.set(COPILOT_CHAT_DEFAULT_LABELS);
+    this._inputValue.set(undefined);
+    this._onSubmitInput.set(undefined);
+    this._onChangeInput.set(undefined);
+  }
+  
+  /**
+   * Get the current submit handler
+   */
+  getSubmitHandler(): ((value: string) => void) | undefined {
+    return this._onSubmitInput();
+  }
+  
+  /**
+   * Get the current change handler
+   */
+  getChangeHandler(): ((value: string) => void) | undefined {
+    return this._onChangeInput();
+  }
+  
+  /**
+   * Merge partial labels with defaults
+   */
+  private mergeLabels(partial?: Partial<CopilotChatLabels>): CopilotChatLabels {
+    return {
+      ...COPILOT_CHAT_DEFAULT_LABELS,
+      ...partial
+    };
+  }
+}

package/src/core/chat-configuration/chat-configuration.types.ts

@@ -0,0 +1,57 @@
+import { InjectionToken } from "@angular/core";
+
+// Type for chat labels
+export interface CopilotChatLabels {
+  chatInputPlaceholder: string;
+  chatInputToolbarStartTranscribeButtonLabel: string;
+  chatInputToolbarCancelTranscribeButtonLabel: string;
+  chatInputToolbarFinishTranscribeButtonLabel: string;
+  chatInputToolbarAddButtonLabel: string;
+  chatInputToolbarToolsButtonLabel: string;
+  assistantMessageToolbarCopyCodeLabel: string;
+  assistantMessageToolbarCopyCodeCopiedLabel: string;
+  assistantMessageToolbarCopyMessageLabel: string;
+  assistantMessageToolbarThumbsUpLabel: string;
+  assistantMessageToolbarThumbsDownLabel: string;
+  assistantMessageToolbarReadAloudLabel: string;
+  assistantMessageToolbarRegenerateLabel: string;
+  userMessageToolbarCopyMessageLabel: string;
+  userMessageToolbarEditMessageLabel: string;
+  chatDisclaimerText: string;
+}
+
+// Default labels constant
+export const COPILOT_CHAT_DEFAULT_LABELS: CopilotChatLabels = {
+  chatInputPlaceholder: "Type a message...",
+  chatInputToolbarStartTranscribeButtonLabel: "Transcribe",
+  chatInputToolbarCancelTranscribeButtonLabel: "Cancel",
+  chatInputToolbarFinishTranscribeButtonLabel: "Finish",
+  chatInputToolbarAddButtonLabel: "Add photos or files",
+  chatInputToolbarToolsButtonLabel: "Tools",
+  assistantMessageToolbarCopyCodeLabel: "Copy",
+  assistantMessageToolbarCopyCodeCopiedLabel: "Copied",
+  assistantMessageToolbarCopyMessageLabel: "Copy",
+  assistantMessageToolbarThumbsUpLabel: "Good response",
+  assistantMessageToolbarThumbsDownLabel: "Bad response",
+  assistantMessageToolbarReadAloudLabel: "Read aloud",
+  assistantMessageToolbarRegenerateLabel: "Regenerate",
+  userMessageToolbarCopyMessageLabel: "Copy",
+  userMessageToolbarEditMessageLabel: "Edit",
+  chatDisclaimerText:
+    "AI can make mistakes. Please verify important information.",
+};
+
+// Configuration interface
+export interface CopilotChatConfiguration {
+  labels?: Partial<CopilotChatLabels>;
+  inputValue?: string;
+  onSubmitInput?: (value: string) => void;
+  onChangeInput?: (value: string) => void;
+}
+
+// Injection token for initial configuration
+export const COPILOT_CHAT_INITIAL_CONFIG =
+  new InjectionToken<CopilotChatConfiguration>("COPILOT_CHAT_INITIAL_CONFIG", {
+    providedIn: "root",
+    factory: () => ({}),
+  });

package/src/core/copilotkit.providers.ts

@@ -0,0 +1,59 @@
+import { Provider } from "@angular/core";
+import {
+  COPILOTKIT_RUNTIME_URL,
+  COPILOTKIT_HEADERS,
+  COPILOTKIT_PROPERTIES,
+  COPILOTKIT_AGENTS,
+  COPILOTKIT_RENDER_TOOL_CALLS,
+  COPILOTKIT_FRONTEND_TOOLS,
+  COPILOTKIT_HUMAN_IN_THE_LOOP,
+  ToolCallRender,
+  AngularFrontendTool,
+  AngularHumanInTheLoop,
+} from "./copilotkit.types";
+import { AbstractAgent } from "@ag-ui/client";
+
+export interface ProvideCopilotKitOptions {
+  runtimeUrl?: string;
+  headers?: Record<string, string>;
+  properties?: Record<string, unknown>;
+  agents?: Record<string, AbstractAgent>;
+  renderToolCalls?: ToolCallRender<unknown>[];
+  frontendTools?: AngularFrontendTool<any>[];
+  humanInTheLoop?: AngularHumanInTheLoop<any>[];
+}
+
+export function provideCopilotKit(
+  options: ProvideCopilotKitOptions = {}
+): Provider[] {
+  return [
+    {
+      provide: COPILOTKIT_RUNTIME_URL,
+      useValue: options.runtimeUrl,
+    },
+    {
+      provide: COPILOTKIT_HEADERS,
+      useValue: options.headers ?? {},
+    },
+    {
+      provide: COPILOTKIT_PROPERTIES,
+      useValue: options.properties ?? {},
+    },
+    {
+      provide: COPILOTKIT_AGENTS,
+      useValue: options.agents ?? {},
+    },
+    {
+      provide: COPILOTKIT_RENDER_TOOL_CALLS,
+      useValue: options.renderToolCalls ?? [],
+    },
+    {
+      provide: COPILOTKIT_FRONTEND_TOOLS,
+      useValue: options.frontendTools ?? [],
+    },
+    {
+      provide: COPILOTKIT_HUMAN_IN_THE_LOOP,
+      useValue: options.humanInTheLoop ?? [],
+    },
+  ];
+}