@agentick/angular 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Agentick Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+# @agentick/angular
+
+Angular integration for Agentick. Provides a signal-first service wrapper around `@agentick/client`.
+
+## Installation
+
+```bash
+pnpm add @agentick/angular
+```
+
+## Quick Start
+
+```ts
+import { Component, inject } from "@angular/core";
+import { AgentickService, provideAgentick } from "@agentick/angular";
+
+@Component({
+  selector: "app-chat",
+  providers: [provideAgentick({ baseUrl: "/api/agent" })],
+  template: `
+    <div>{{ agentick.text() }}</div>
+    <button (click)="send('Hello')">Send</button>
+  `,
+})
+export class ChatComponent {
+  agentick = inject(AgentickService);
+
+  constructor() {
+    this.agentick.subscribe("conv-123");
+  }
+
+  async send(message: string) {
+    const handle = this.agentick.send(message);
+    await handle.result;
+  }
+}
+```
+
+## Service API
+
+```ts
+service.session(sessionId)      // cold accessor
+service.subscribe(sessionId)    // hot accessor
+service.unsubscribe()           // drop current subscription
+
+service.send(input)             // returns ClientExecutionHandle
+service.abort(reason?)
+service.close()
+
+service.channel(name)           // session-scoped channel
+```
+
+Signals:
+
+```ts
+service.connectionState()
+service.sessionId()
+service.streamingText()
+service.text()
+service.isStreaming()
+```

package/dist/agentick.service.d.ts

@@ -0,0 +1,210 @@
+/**
+ * AgentickService - Modern Angular service for Agentick.
+ *
+ * Uses Angular signals for reactive state management with RxJS interop.
+ *
+ * @module @agentick/angular/service
+ */
+import { InjectionToken, type OnDestroy } from "@angular/core";
+import { Observable } from "rxjs";
+import { type AgentickClient, type ConnectionState, type StreamEvent, type StreamingTextState, type SessionStreamEvent, type SessionAccessor, type ClientExecutionHandle } from "@agentick/client";
+import type { AgentickConfig } from "./types";
+/**
+ * Injection token for Agentick configuration.
+ */
+export declare const TENTICKLE_CONFIG: InjectionToken<AgentickConfig>;
+/**
+ * Provides AgentickService with configuration at component level.
+ *
+ * Use this to create isolated service instances for different components,
+ * each with their own connection and state.
+ *
+ * @example Multiple agents in one app
+ * ```typescript
+ * // Each component gets its own AgentickService instance
+ *
+ * @Component({
+ *   selector: 'app-support-chat',
+ *   providers: [provideAgentick({ baseUrl: '/api/support-agent' })],
+ *   template: `<div>{{ agentick.text() }}</div>`,
+ * })
+ * export class SupportChatComponent {
+ *   agentick = inject(AgentickService);
+ * }
+ *
+ * @Component({
+ *   selector: 'app-sales-chat',
+ *   providers: [provideAgentick({ baseUrl: '/api/sales-agent' })],
+ *   template: `<div>{{ agentick.text() }}</div>`,
+ * })
+ * export class SalesChatComponent {
+ *   agentick = inject(AgentickService);
+ * }
+ * ```
+ *
+ * @param config - Configuration for this service instance
+ * @returns Provider array to spread into component's providers
+ */
+export declare function provideAgentick(config: AgentickConfig): (typeof AgentickService | {
+    provide: InjectionToken<AgentickConfig>;
+    useValue: AgentickConfig;
+})[];
+/**
+ * Modern Angular service for Agentick.
+ *
+ * Uses signals for state, with RxJS observables available for compatibility.
+ *
+ * @example Standalone setup
+ * ```typescript
+ * import { AgentickService, TENTICKLE_CONFIG } from '@agentick/angular';
+ *
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     { provide: TENTICKLE_CONFIG, useValue: { baseUrl: 'https://api.example.com' } },
+ *   ],
+ * });
+ * ```
+ *
+ * @example Component with signals
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     @if (agentick.isConnected()) {
+ *       <div class="response">
+ *         {{ agentick.text() }}
+ *         @if (agentick.isStreaming()) {
+ *           <span class="cursor">|</span>
+ *         }
+ *       </div>
+ *       <input #input />
+ *       <button (click)="send(input.value)">Send</button>
+ *     } @else {
+ *       <p>Connecting...</p>
+ *     }
+ *   `,
+ * })
+ * export class ChatComponent {
+ *   agentick = inject(AgentickService);
+ *
+ *   constructor() {
+ *     this.agentick.subscribe("conv-123");
+ *   }
+ *
+ *   async send(message: string) {
+ *     const handle = this.agentick.send(message);
+ *     await handle.result;
+ *   }
+ * }
+ * ```
+ *
+ * @example With RxJS (for compatibility)
+ * ```typescript
+ * @Component({
+ *   template: `{{ text$ | async }}`,
+ * })
+ * export class LegacyComponent {
+ *   agentick = inject(AgentickService);
+ *   text$ = this.agentick.text$;
+ * }
+ * ```
+ */
+export declare class AgentickService implements OnDestroy {
+    private readonly client;
+    private readonly destroy$;
+    private currentSession?;
+    /** Current connection state */
+    readonly connectionState: import("@angular/core").WritableSignal<ConnectionState>;
+    /** Current session ID */
+    readonly sessionId: import("@angular/core").WritableSignal<string | undefined>;
+    /** Connection error, if any */
+    readonly error: import("@angular/core").WritableSignal<Error | undefined>;
+    /** Streaming text state from the client */
+    readonly streamingText: import("@angular/core").WritableSignal<StreamingTextState>;
+    /** Whether currently connected */
+    readonly isConnected: import("@angular/core").Signal<boolean>;
+    /** Whether currently connecting */
+    readonly isConnecting: import("@angular/core").Signal<boolean>;
+    /** Current streaming text */
+    readonly text: import("@angular/core").Signal<string>;
+    /** Whether currently streaming */
+    readonly isStreaming: import("@angular/core").Signal<boolean>;
+    /** Observable of connection state (for RxJS users) */
+    readonly connectionState$: Observable<ConnectionState>;
+    /** Observable of whether connected (for RxJS users) */
+    readonly isConnected$: Observable<boolean>;
+    /** Observable of streaming text state (for RxJS users) */
+    readonly streamingText$: Observable<StreamingTextState>;
+    /** Observable of just the text (for RxJS users) */
+    readonly text$: Observable<string>;
+    /** Observable of whether streaming (for RxJS users) */
+    readonly isStreaming$: Observable<boolean>;
+    /** Subject for raw stream events */
+    private readonly eventsSubject;
+    /** Observable of all stream events */
+    readonly events$: Observable<StreamEvent | SessionStreamEvent>;
+    /** Subject for execution results */
+    private readonly resultSubject;
+    /** Observable of execution results */
+    readonly result$: Observable<{
+        response: string;
+        outputs: Record<string, unknown>;
+        usage: {
+            inputTokens: number;
+            outputTokens: number;
+            totalTokens: number;
+        };
+        stopReason?: string;
+    }>;
+    /**
+     * Creates a new AgentickService.
+     *
+     * @param configOrInjected - Config passed directly (for testing) or undefined to use DI
+     */
+    constructor(configOrInjected?: AgentickConfig);
+    private setupSubscriptions;
+    /**
+     * Get a cold session accessor.
+     */
+    session(sessionId: string): SessionAccessor;
+    /**
+     * Subscribe to a session and make it the active session.
+     */
+    subscribe(sessionId: string): SessionAccessor;
+    /**
+     * Unsubscribe from the active session.
+     */
+    unsubscribe(): void;
+    /**
+     * Send a message to the session.
+     */
+    send(input: Parameters<AgentickClient["send"]>[0]): ClientExecutionHandle;
+    /**
+     * Abort the current execution.
+     */
+    abort(reason?: string): Promise<void>;
+    /**
+     * Close the active session on the server.
+     */
+    close(): Promise<void>;
+    /**
+     * Clear the accumulated streaming text.
+     */
+    clearStreamingText(): void;
+    /**
+     * Get a channel accessor for custom pub/sub.
+     */
+    channel(name: string): import("@agentick/client").ChannelAccessor;
+    /**
+     * Create an Observable from a channel.
+     */
+    channel$(name: string): Observable<{
+        type: string;
+        payload: unknown;
+    }>;
+    /**
+     * Filter events by type.
+     */
+    eventsOfType(...types: StreamEvent["type"][]): Observable<StreamEvent>;
+    ngOnDestroy(): void;
+}
+//# sourceMappingURL=agentick.service.d.ts.map

package/dist/agentick.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentick.service.d.ts","sourceRoot":"","sources":["../src/agentick.service.ts"],"names":[],"mappings":"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"}

package/dist/agentick.service.js

@@ -0,0 +1,354 @@
+/**
+ * AgentickService - Modern Angular service for Agentick.
+ *
+ * Uses Angular signals for reactive state management with RxJS interop.
+ *
+ * @module @agentick/angular/service
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Injectable, InjectionToken, computed, signal, inject, } from "@angular/core";
+import { toObservable } from "@angular/core/rxjs-interop";
+import { Observable, Subject, filter, takeUntil } from "rxjs";
+import { createClient, } from "@agentick/client";
+/**
+ * Injection token for Agentick configuration.
+ */
+export const TENTICKLE_CONFIG = new InjectionToken("TENTICKLE_CONFIG");
+/**
+ * Provides AgentickService with configuration at component level.
+ *
+ * Use this to create isolated service instances for different components,
+ * each with their own connection and state.
+ *
+ * @example Multiple agents in one app
+ * ```typescript
+ * // Each component gets its own AgentickService instance
+ *
+ * @Component({
+ *   selector: 'app-support-chat',
+ *   providers: [provideAgentick({ baseUrl: '/api/support-agent' })],
+ *   template: `<div>{{ agentick.text() }}</div>`,
+ * })
+ * export class SupportChatComponent {
+ *   agentick = inject(AgentickService);
+ * }
+ *
+ * @Component({
+ *   selector: 'app-sales-chat',
+ *   providers: [provideAgentick({ baseUrl: '/api/sales-agent' })],
+ *   template: `<div>{{ agentick.text() }}</div>`,
+ * })
+ * export class SalesChatComponent {
+ *   agentick = inject(AgentickService);
+ * }
+ * ```
+ *
+ * @param config - Configuration for this service instance
+ * @returns Provider array to spread into component's providers
+ */
+export function provideAgentick(config) {
+    return [{ provide: TENTICKLE_CONFIG, useValue: config }, AgentickService];
+}
+/**
+ * Modern Angular service for Agentick.
+ *
+ * Uses signals for state, with RxJS observables available for compatibility.
+ *
+ * @example Standalone setup
+ * ```typescript
+ * import { AgentickService, TENTICKLE_CONFIG } from '@agentick/angular';
+ *
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     { provide: TENTICKLE_CONFIG, useValue: { baseUrl: 'https://api.example.com' } },
+ *   ],
+ * });
+ * ```
+ *
+ * @example Component with signals
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     @if (agentick.isConnected()) {
+ *       <div class="response">
+ *         {{ agentick.text() }}
+ *         @if (agentick.isStreaming()) {
+ *           <span class="cursor">|</span>
+ *         }
+ *       </div>
+ *       <input #input />
+ *       <button (click)="send(input.value)">Send</button>
+ *     } @else {
+ *       <p>Connecting...</p>
+ *     }
+ *   `,
+ * })
+ * export class ChatComponent {
+ *   agentick = inject(AgentickService);
+ *
+ *   constructor() {
+ *     this.agentick.subscribe("conv-123");
+ *   }
+ *
+ *   async send(message: string) {
+ *     const handle = this.agentick.send(message);
+ *     await handle.result;
+ *   }
+ * }
+ * ```
+ *
+ * @example With RxJS (for compatibility)
+ * ```typescript
+ * @Component({
+ *   template: `{{ text$ | async }}`,
+ * })
+ * export class LegacyComponent {
+ *   agentick = inject(AgentickService);
+ *   text$ = this.agentick.text$;
+ * }
+ * ```
+ */
+let AgentickService = class AgentickService {
+    // ══════════════════════════════════════════════════════════════════════════
+    // Constructor
+    // ══════════════════════════════════════════════════════════════════════════
+    /**
+     * Creates a new AgentickService.
+     *
+     * @param configOrInjected - Config passed directly (for testing) or undefined to use DI
+     */
+    constructor(configOrInjected) {
+        this.destroy$ = new Subject();
+        // ══════════════════════════════════════════════════════════════════════════
+        // Signals - Primary State
+        // ══════════════════════════════════════════════════════════════════════════
+        /** Current connection state */
+        this.connectionState = signal("disconnected");
+        /** Current session ID */
+        this.sessionId = signal(undefined);
+        /** Connection error, if any */
+        this.error = signal(undefined);
+        /** Streaming text state from the client */
+        this.streamingText = signal({ text: "", isStreaming: false });
+        // ══════════════════════════════════════════════════════════════════════════
+        // Computed Signals - Derived State
+        // ══════════════════════════════════════════════════════════════════════════
+        /** Whether currently connected */
+        this.isConnected = computed(() => this.connectionState() === "connected");
+        /** Whether currently connecting */
+        this.isConnecting = computed(() => this.connectionState() === "connecting");
+        /** Current streaming text */
+        this.text = computed(() => this.streamingText().text);
+        /** Whether currently streaming */
+        this.isStreaming = computed(() => this.streamingText().isStreaming);
+        /** Subject for raw stream events */
+        this.eventsSubject = new Subject();
+        /** Observable of all stream events */
+        this.events$ = this.eventsSubject.asObservable();
+        /** Subject for execution results */
+        this.resultSubject = new Subject();
+        /** Observable of execution results */
+        this.result$ = this.resultSubject.asObservable();
+        // Support both direct config (for testing) and DI injection
+        let config = configOrInjected;
+        if (!config) {
+            try {
+                config = inject(TENTICKLE_CONFIG, { optional: true }) ?? undefined;
+            }
+            catch {
+                // Not in injection context - config must be passed directly
+            }
+        }
+        if (!config) {
+            throw new Error("AgentickService requires TENTICKLE_CONFIG to be provided");
+        }
+        this.client = createClient(config);
+        // Initialize observables from signals
+        // Note: toObservable requires injection context, so we create them conditionally
+        try {
+            this.connectionState$ = toObservable(this.connectionState);
+            this.isConnected$ = toObservable(this.isConnected);
+            this.streamingText$ = toObservable(this.streamingText);
+            this.text$ = toObservable(this.text);
+            this.isStreaming$ = toObservable(this.isStreaming);
+        }
+        catch {
+            // Not in injection context - create manual observables for testing
+            this.connectionState$ = new Observable((subscriber) => {
+                subscriber.next(this.connectionState());
+                const interval = setInterval(() => {
+                    subscriber.next(this.connectionState());
+                }, 10);
+                return () => clearInterval(interval);
+            });
+            this.isConnected$ = new Observable((subscriber) => {
+                subscriber.next(this.isConnected());
+                const interval = setInterval(() => {
+                    subscriber.next(this.isConnected());
+                }, 10);
+                return () => clearInterval(interval);
+            });
+            this.streamingText$ = new Observable((subscriber) => {
+                subscriber.next(this.streamingText());
+                const interval = setInterval(() => {
+                    subscriber.next(this.streamingText());
+                }, 10);
+                return () => clearInterval(interval);
+            });
+            this.text$ = new Observable((subscriber) => {
+                subscriber.next(this.text());
+                const interval = setInterval(() => {
+                    subscriber.next(this.text());
+                }, 10);
+                return () => clearInterval(interval);
+            });
+            this.isStreaming$ = new Observable((subscriber) => {
+                subscriber.next(this.isStreaming());
+                const interval = setInterval(() => {
+                    subscriber.next(this.isStreaming());
+                }, 10);
+                return () => clearInterval(interval);
+            });
+        }
+        this.setupSubscriptions();
+    }
+    setupSubscriptions() {
+        // Connection state → signal
+        this.client.onConnectionChange((state) => {
+            this.connectionState.set(state);
+        });
+        // Streaming text → signal
+        this.client.onStreamingText((state) => {
+            this.streamingText.set(state);
+        });
+        // Events → subject (for filtering)
+        this.client.onEvent((event) => {
+            this.eventsSubject.next(event);
+        });
+        // Results → subject
+        this.client.onEvent((event) => {
+            if (event.type === "result") {
+                this.resultSubject.next(event.result);
+            }
+        });
+    }
+    // ══════════════════════════════════════════════════════════════════════════
+    // Session Access
+    // ══════════════════════════════════════════════════════════════════════════
+    /**
+     * Get a cold session accessor.
+     */
+    session(sessionId) {
+        return this.client.session(sessionId);
+    }
+    /**
+     * Subscribe to a session and make it the active session.
+     */
+    subscribe(sessionId) {
+        const accessor = this.client.subscribe(sessionId);
+        this.currentSession = accessor;
+        this.sessionId.set(sessionId);
+        return accessor;
+    }
+    /**
+     * Unsubscribe from the active session.
+     */
+    unsubscribe() {
+        this.currentSession?.unsubscribe();
+        this.currentSession = undefined;
+        this.sessionId.set(undefined);
+    }
+    // ══════════════════════════════════════════════════════════════════════════
+    // Messaging
+    // ══════════════════════════════════════════════════════════════════════════
+    /**
+     * Send a message to the session.
+     */
+    send(input) {
+        if (this.currentSession) {
+            return this.currentSession.send(input);
+        }
+        return this.client.send(input);
+    }
+    /**
+     * Abort the current execution.
+     */
+    async abort(reason) {
+        if (this.currentSession) {
+            await this.currentSession.abort(reason);
+            return;
+        }
+        const id = this.sessionId();
+        if (id) {
+            await this.client.abort(id, reason);
+        }
+    }
+    /**
+     * Close the active session on the server.
+     */
+    async close() {
+        if (this.currentSession) {
+            await this.currentSession.close();
+            this.currentSession = undefined;
+            this.sessionId.set(undefined);
+        }
+    }
+    /**
+     * Clear the accumulated streaming text.
+     */
+    clearStreamingText() {
+        this.client.clearStreamingText();
+    }
+    // ══════════════════════════════════════════════════════════════════════════
+    // Channels
+    // ══════════════════════════════════════════════════════════════════════════
+    /**
+     * Get a channel accessor for custom pub/sub.
+     */
+    channel(name) {
+        if (!this.currentSession) {
+            throw new Error("No active session. Call subscribe(sessionId) first.");
+        }
+        return this.currentSession.channel(name);
+    }
+    /**
+     * Create an Observable from a channel.
+     */
+    channel$(name) {
+        return new Observable((subscriber) => {
+            const channel = this.channel(name);
+            const unsubscribe = channel.subscribe((payload, event) => {
+                subscriber.next({ type: event.type, payload });
+            });
+            return () => unsubscribe();
+        }).pipe(takeUntil(this.destroy$));
+    }
+    /**
+     * Filter events by type.
+     */
+    eventsOfType(...types) {
+        return this.events$.pipe(filter((event) => types.includes(event.type)));
+    }
+    // ══════════════════════════════════════════════════════════════════════════
+    // Cleanup
+    // ══════════════════════════════════════════════════════════════════════════
+    ngOnDestroy() {
+        this.destroy$.next();
+        this.destroy$.complete();
+        this.client.destroy();
+    }
+};
+AgentickService = __decorate([
+    Injectable({ providedIn: "root" }),
+    __metadata("design:paramtypes", [Object])
+], AgentickService);
+export { AgentickService };
+//# sourceMappingURL=agentick.service.js.map

package/dist/agentick.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentick.service.js","sourceRoot":"","sources":["../src/agentick.service.ts"],"names":[],"mappings":"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"}