@agentick/angular 0.0.1

package/dist/tentickle.service.js

@@ -0,0 +1,354 @@
+/**
+ * TentickleService - Modern Angular service for Tentickle.
+ *
+ * Uses Angular signals for reactive state management with RxJS interop.
+ *
+ * @module @tentickle/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 "@tentickle/client";
+/**
+ * Injection token for Tentickle configuration.
+ */
+export const TENTICKLE_CONFIG = new InjectionToken("TENTICKLE_CONFIG");
+/**
+ * Provides TentickleService 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 TentickleService instance
+ *
+ * @Component({
+ *   selector: 'app-support-chat',
+ *   providers: [provideTentickle({ baseUrl: '/api/support-agent' })],
+ *   template: `<div>{{ tentickle.text() }}</div>`,
+ * })
+ * export class SupportChatComponent {
+ *   tentickle = inject(TentickleService);
+ * }
+ *
+ * @Component({
+ *   selector: 'app-sales-chat',
+ *   providers: [provideTentickle({ baseUrl: '/api/sales-agent' })],
+ *   template: `<div>{{ tentickle.text() }}</div>`,
+ * })
+ * export class SalesChatComponent {
+ *   tentickle = inject(TentickleService);
+ * }
+ * ```
+ *
+ * @param config - Configuration for this service instance
+ * @returns Provider array to spread into component's providers
+ */
+export function provideTentickle(config) {
+    return [{ provide: TENTICKLE_CONFIG, useValue: config }, TentickleService];
+}
+/**
+ * Modern Angular service for Tentickle.
+ *
+ * Uses signals for state, with RxJS observables available for compatibility.
+ *
+ * @example Standalone setup
+ * ```typescript
+ * import { TentickleService, TENTICKLE_CONFIG } from '@tentickle/angular';
+ *
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     { provide: TENTICKLE_CONFIG, useValue: { baseUrl: 'https://api.example.com' } },
+ *   ],
+ * });
+ * ```
+ *
+ * @example Component with signals
+ * ```typescript
+ * @Component({
+ *   template: `
+ *     @if (tentickle.isConnected()) {
+ *       <div class="response">
+ *         {{ tentickle.text() }}
+ *         @if (tentickle.isStreaming()) {
+ *           <span class="cursor">|</span>
+ *         }
+ *       </div>
+ *       <input #input />
+ *       <button (click)="send(input.value)">Send</button>
+ *     } @else {
+ *       <p>Connecting...</p>
+ *     }
+ *   `,
+ * })
+ * export class ChatComponent {
+ *   tentickle = inject(TentickleService);
+ *
+ *   constructor() {
+ *     this.tentickle.subscribe("conv-123");
+ *   }
+ *
+ *   async send(message: string) {
+ *     const handle = this.tentickle.send(message);
+ *     await handle.result;
+ *   }
+ * }
+ * ```
+ *
+ * @example With RxJS (for compatibility)
+ * ```typescript
+ * @Component({
+ *   template: `{{ text$ | async }}`,
+ * })
+ * export class LegacyComponent {
+ *   tentickle = inject(TentickleService);
+ *   text$ = this.tentickle.text$;
+ * }
+ * ```
+ */
+let TentickleService = class TentickleService {
+    // ══════════════════════════════════════════════════════════════════════════
+    // Constructor
+    // ══════════════════════════════════════════════════════════════════════════
+    /**
+     * Creates a new TentickleService.
+     *
+     * @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("TentickleService 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();
+    }
+};
+TentickleService = __decorate([
+    Injectable({ providedIn: "root" }),
+    __metadata("design:paramtypes", [Object])
+], TentickleService);
+export { TentickleService };
+//# sourceMappingURL=tentickle.service.js.map

package/dist/tentickle.service.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Angular integration types for Agentick.
+ *
+ * @module @agentick/angular/types
+ */
+import type { ClientTransport } from "@agentick/client";
+/**
+ * Transport configuration for AgentickService.
+ * Can be a built-in transport type or a custom ClientTransport instance.
+ */
+export type TransportConfig = "sse" | "websocket" | "auto" | ClientTransport;
+/**
+ * Configuration for AgentickService.
+ */
+export interface AgentickConfig {
+    /**
+     * Base URL of the Agentick server.
+     */
+    baseUrl: string;
+    /**
+     * Transport to use for communication.
+     * - "sse": HTTP/SSE transport (default for http:// and https:// URLs)
+     * - "websocket": WebSocket transport (default for ws:// and wss:// URLs)
+     * - "auto": Auto-detect based on URL scheme (default)
+     * - ClientTransport instance: Use a custom transport (e.g., SharedTransport for multi-tab)
+     *
+     * @example
+     * ```typescript
+     * import { createSharedTransport } from '@agentick/client-multiplexer';
+     *
+     * providers: [
+     *   {
+     *     provide: TENTICKLE_CONFIG,
+     *     useValue: {
+     *       baseUrl: 'https://api.example.com',
+     *       transport: createSharedTransport({ baseUrl: 'https://api.example.com' }),
+     *     },
+     *   },
+     * ]
+     * ```
+     */
+    transport?: TransportConfig;
+    /**
+     * Authentication token (adds Authorization: Bearer header).
+     */
+    token?: string;
+    /**
+     * User ID for session metadata.
+     */
+    userId?: string;
+    /**
+     * Custom headers for requests.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Custom path configuration.
+     */
+    paths?: {
+        events?: string;
+        send?: string;
+        subscribe?: string;
+        abort?: string;
+        close?: string;
+        toolResponse?: string;
+        channel?: string;
+    };
+    /**
+     * Request timeout in milliseconds.
+     * @default 30000
+     */
+    timeout?: number;
+}
+export type { AgentickClient, ConnectionState, StreamEvent, SessionStreamEvent, ClientExecutionHandle, StreamingTextState, ClientTransport, } from "@agentick/client";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMxD;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,GAAG,eAAe,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAE5B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,KAAK,CAAC,EAAE;QACN,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,YAAY,EACV,cAAc,EACd,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Angular integration types for Agentick.
+ *
+ * @module @agentick/angular/types
+ */
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@agentick/angular",
+  "version": "0.0.1",
+  "description": "Angular services and utilities for Agentick applications",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@agentick/client": "0.0.1",
+    "@agentick/shared": "0.0.1"
+  },
+  "devDependencies": {
+    "@angular/core": "^19.0.0",
+    "@types/node": "^22.10.5",
+    "rxjs": "^7.8.0",
+    "typescript": "^5.7.3",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "@angular/core": "^17.0.0 || ^18.0.0 || ^19.0.0",
+    "rxjs": "^7.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/src/agentick.service.spec.ts

@@ -0,0 +1,133 @@
+/**
+ * Tests for AgentickService (signals-based)
+ */
+
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { firstValueFrom } from "rxjs";
+import type { StreamingTextState, SessionStreamEvent } from "@agentick/client";
+
+let mockStreamingTextState: StreamingTextState = { text: "", isStreaming: false };
+let mockStreamingTextHandlers = new Set<(state: StreamingTextState) => void>();
+
+const emitMockStreamingText = (state: StreamingTextState) => {
+  mockStreamingTextState = state;
+  for (const handler of mockStreamingTextHandlers) {
+    handler(state);
+  }
+};
+
+const createMockHandle = (sessionId: string) => ({
+  sessionId,
+  executionId: "exec-1",
+  status: "completed" as const,
+  result: Promise.resolve({
+    response: "ok",
+    outputs: {},
+    usage: { inputTokens: 0, outputTokens: 0, totalTokens: 0 },
+  }),
+  abort: vi.fn(),
+  queueMessage: vi.fn(),
+  submitToolResult: vi.fn(),
+  async *[Symbol.asyncIterator]() {},
+});
+
+const mockClient = {
+  session: vi.fn((id: string) => ({
+    sessionId: id,
+    isSubscribed: false,
+    subscribe: vi.fn(),
+    unsubscribe: vi.fn(),
+    send: vi.fn(() => createMockHandle(id)),
+    abort: vi.fn(),
+    close: vi.fn(),
+    onEvent: vi.fn(() => () => {}),
+    onResult: vi.fn(() => () => {}),
+    onToolConfirmation: vi.fn(() => () => {}),
+    channel: vi.fn((name: string) => ({
+      name,
+      subscribe: vi.fn(() => () => {}),
+      publish: vi.fn(async () => {}),
+      request: vi.fn(async () => ({})),
+    })),
+  })),
+  subscribe: vi.fn((id: string) => ({
+    sessionId: id,
+    isSubscribed: true,
+    subscribe: vi.fn(),
+    unsubscribe: vi.fn(),
+    send: vi.fn(() => createMockHandle(id)),
+    abort: vi.fn(),
+    close: vi.fn(),
+    onEvent: vi.fn(() => () => {}),
+    onResult: vi.fn(() => () => {}),
+    onToolConfirmation: vi.fn(() => () => {}),
+    channel: vi.fn(),
+  })),
+  send: vi.fn(() => createMockHandle("ephemeral")),
+  abort: vi.fn(),
+  closeSession: vi.fn(),
+  destroy: vi.fn(),
+  onConnectionChange: vi.fn(() => () => {}),
+  onEvent: vi.fn(() => () => {}),
+  on: vi.fn(() => () => {}),
+  onStreamingText: vi.fn((handler: (state: StreamingTextState) => void) => {
+    mockStreamingTextHandlers.add(handler);
+    handler(mockStreamingTextState);
+    return () => mockStreamingTextHandlers.delete(handler);
+  }),
+  clearStreamingText: vi.fn(() => {
+    emitMockStreamingText({ text: "", isStreaming: false });
+  }),
+  get streamingText() {
+    return mockStreamingTextState;
+  },
+  get state() {
+    return "disconnected" as const;
+  },
+};
+
+vi.mock("@agentick/client", () => ({
+  createClient: vi.fn(() => mockClient),
+}));
+
+import { AgentickService } from "./agentick.service";
+
+describe("AgentickService", () => {
+  let service: AgentickService;
+
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mockStreamingTextState = { text: "", isStreaming: false };
+    mockStreamingTextHandlers.clear();
+    service = new AgentickService({ baseUrl: "https://api.example.com" });
+  });
+
+  afterEach(() => {
+    service.ngOnDestroy();
+  });
+
+  it("initializes signals", () => {
+    expect(service.connectionState()).toBe("disconnected");
+    expect(service.sessionId()).toBeUndefined();
+    expect(service.streamingText()).toEqual({ text: "", isStreaming: false });
+  });
+
+  it("subscribes to a session", () => {
+    const accessor = service.subscribe("conv-123");
+    expect(accessor.sessionId).toBe("conv-123");
+    expect(service.sessionId()).toBe("conv-123");
+  });
+
+  it("sends via active session", async () => {
+    service.subscribe("conv-123");
+    const handle = service.send("Hello");
+    const result = await handle.result;
+    expect(result.response).toBe("ok");
+  });
+
+  it("streams text updates", async () => {
+    emitMockStreamingText({ text: "hello", isStreaming: true });
+    const text = await firstValueFrom(service.text$);
+    expect(text).toBe("hello");
+  });
+});