@agentick/nestjs 0.0.1

package/dist/tentickle.service.d.ts

@@ -0,0 +1,83 @@
+/**
+ * TentickleService - High-level service for Tentickle operations.
+ *
+ * Wraps App with NestJS-friendly patterns for multiplexed SSE sessions.
+ *
+ * @module @tentickle/nestjs/service
+ */
+import type { Response } from "express";
+import type { App } from "@tentickle/core";
+import type { SendInput } from "@tentickle/shared";
+import { type TentickleModuleOptions } from "./types";
+/**
+ * High-level service for Tentickle operations.
+ *
+ * @example Injecting into your controller
+ * ```typescript
+ * @Controller('chat')
+ * export class ChatController {
+ *   constructor(private readonly tentickle: TentickleService) {}
+ *
+ *   @Post('send')
+ *   async send(@Body() body: { message: string }, @Res() res: Response) {
+ *     const { sessionId } = body;
+ *     return this.tentickle.sendAndStream(sessionId, { message: body.message }, res);
+ *   }
+ * }
+ * ```
+ */
+export declare class TentickleService {
+    private readonly app;
+    private readonly options;
+    private readonly connections;
+    private readonly sessionSubscribers;
+    private readonly sessionListeners;
+    private readonly sessionChannelListeners;
+    constructor(app: App, options: TentickleModuleOptions);
+    /**
+     * Create an SSE connection.
+     * Returns a connection ID that the client will use for subscriptions.
+     */
+    createConnection(res: Response): string;
+    /**
+     * Subscribe a connection to one or more sessions.
+     */
+    subscribe(connectionId: string, sessionIds: string[]): Promise<void>;
+    /**
+     * Unsubscribe a connection from one or more sessions.
+     */
+    unsubscribe(connectionId: string, sessionIds: string[]): Promise<void>;
+    private ensureSessionListener;
+    private unsubscribeConnection;
+    /**
+     * Send a message and stream events via SSE.
+     * Mirrors Express POST /send endpoint.
+     */
+    sendAndStream(sessionId: string | undefined, input: SendInput, res: Response): Promise<void>;
+    /**
+     * Abort a session's current execution.
+     */
+    abort(sessionId: string, reason?: string): Promise<void>;
+    /**
+     * Close a session server-side.
+     */
+    close(sessionId: string): Promise<void>;
+    /**
+     * Submit tool confirmation result.
+     */
+    submitToolResult(sessionId: string, toolUseId: string, result: {
+        approved: boolean;
+        reason?: string;
+        modifiedArguments?: Record<string, unknown>;
+    }): Promise<void>;
+    /**
+     * Publish to a session-scoped channel.
+     */
+    publishToChannel(sessionId: string, channelName: string, eventType: string, payload: unknown): Promise<void>;
+    private ensureChannelListener;
+    /**
+     * Get the underlying App for direct access.
+     */
+    getApp(): App;
+}
+//# sourceMappingURL=tentickle.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tentickle.service.d.ts","sourceRoot":"","sources":["../src/tentickle.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,KAAK,EAAe,SAAS,EAAgB,MAAM,mBAAmB,CAAC;AAE9E,OAAO,EAAoC,KAAK,sBAAsB,EAAE,MAAM,SAAS,CAAC;AASxF;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,gBAAgB;IAOF,OAAO,CAAC,QAAQ,CAAC,GAAG;IAChB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPrD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAC7D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAkC;IACrE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmD;IACpF,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAA8C;gBAG5C,GAAG,EAAE,GAAG,EACJ,OAAO,EAAE,sBAAsB;IAO7E;;;OAGG;IACH,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM;IAiCvC;;OAEG;IACG,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB1E;;OAEG;IACG,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5E,OAAO,CAAC,qBAAqB;IAgC7B,OAAO,CAAC,qBAAqB;IAyB7B;;;OAGG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE,SAAS,EAChB,GAAG,EAAE,QAAQ,GACZ,OAAO,CAAC,IAAI,CAAC;IAwBhB;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9D;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7C;;OAEG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAC1F,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC;IAYhB,OAAO,CAAC,qBAAqB;IAmC7B;;OAEG;IACH,MAAM,IAAI,GAAG;CAGd"}

package/dist/tentickle.service.js

@@ -0,0 +1,273 @@
+/**
+ * TentickleService - High-level service for Tentickle operations.
+ *
+ * Wraps App with NestJS-friendly patterns for multiplexed SSE sessions.
+ *
+ * @module @tentickle/nestjs/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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Injectable, Inject } from "@nestjs/common";
+import { createSSEWriter, setSSEHeaders } from "@tentickle/server";
+import { TENTICKLE_APP, TENTICKLE_OPTIONS } from "./types";
+/**
+ * High-level service for Tentickle operations.
+ *
+ * @example Injecting into your controller
+ * ```typescript
+ * @Controller('chat')
+ * export class ChatController {
+ *   constructor(private readonly tentickle: TentickleService) {}
+ *
+ *   @Post('send')
+ *   async send(@Body() body: { message: string }, @Res() res: Response) {
+ *     const { sessionId } = body;
+ *     return this.tentickle.sendAndStream(sessionId, { message: body.message }, res);
+ *   }
+ * }
+ * ```
+ */
+let TentickleService = class TentickleService {
+    app;
+    options;
+    connections = new Map();
+    sessionSubscribers = new Map();
+    sessionListeners = new Map();
+    sessionChannelListeners = new Map();
+    constructor(app, options) {
+        this.app = app;
+        this.options = options;
+    }
+    // ══════════════════════════════════════════════════════════════════════════
+    // SSE Connection Management
+    // ══════════════════════════════════════════════════════════════════════════
+    /**
+     * Create an SSE connection.
+     * Returns a connection ID that the client will use for subscriptions.
+     */
+    createConnection(res) {
+        setSSEHeaders(res);
+        const writer = createSSEWriter(res, {
+            keepaliveInterval: this.options.sseKeepaliveInterval ?? 15000,
+        });
+        const connectionId = `conn-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+        const connection = {
+            id: connectionId,
+            writer,
+            subscriptions: new Set(),
+            closed: false,
+        };
+        this.connections.set(connectionId, connection);
+        writer.writeEvent({
+            type: "connection",
+            connectionId,
+            subscriptions: [],
+        });
+        res.on("close", () => {
+            connection.closed = true;
+            for (const sessionId of connection.subscriptions) {
+                this.unsubscribeConnection(connectionId, sessionId);
+            }
+            this.connections.delete(connectionId);
+        });
+        return connectionId;
+    }
+    /**
+     * Subscribe a connection to one or more sessions.
+     */
+    async subscribe(connectionId, sessionIds) {
+        const connection = this.connections.get(connectionId);
+        if (!connection || connection.closed) {
+            throw new Error("Connection not found or closed");
+        }
+        for (const sessionId of sessionIds) {
+            this.ensureSessionListener(sessionId);
+            connection.subscriptions.add(sessionId);
+            const subscribers = this.sessionSubscribers.get(sessionId) ?? new Set();
+            subscribers.add(connectionId);
+            this.sessionSubscribers.set(sessionId, subscribers);
+        }
+    }
+    /**
+     * Unsubscribe a connection from one or more sessions.
+     */
+    async unsubscribe(connectionId, sessionIds) {
+        for (const sessionId of sessionIds) {
+            this.unsubscribeConnection(connectionId, sessionId);
+        }
+    }
+    ensureSessionListener(sessionId) {
+        if (this.sessionListeners.has(sessionId))
+            return;
+        const session = this.app.session(sessionId);
+        const listener = (event) => {
+            const subscribers = this.sessionSubscribers.get(sessionId);
+            if (!subscribers)
+                return;
+            for (const connectionId of subscribers) {
+                const connection = this.connections.get(connectionId);
+                if (!connection || connection.closed)
+                    continue;
+                connection.writer.writeEvent({ ...event, sessionId });
+            }
+        };
+        session.on("event", listener);
+        session.once("close", () => {
+            this.sessionListeners.delete(sessionId);
+            this.sessionSubscribers.delete(sessionId);
+            const channelListeners = this.sessionChannelListeners.get(sessionId);
+            if (channelListeners) {
+                for (const unsubscribe of channelListeners.values()) {
+                    unsubscribe();
+                }
+                this.sessionChannelListeners.delete(sessionId);
+            }
+        });
+        this.sessionListeners.set(sessionId, listener);
+    }
+    unsubscribeConnection(connectionId, sessionId) {
+        const connection = this.connections.get(connectionId);
+        if (connection) {
+            connection.subscriptions.delete(sessionId);
+        }
+        const subscribers = this.sessionSubscribers.get(sessionId);
+        if (!subscribers)
+            return;
+        subscribers.delete(connectionId);
+        if (subscribers.size === 0) {
+            this.sessionSubscribers.delete(sessionId);
+            const listener = this.sessionListeners.get(sessionId);
+            if (listener && this.app.has(sessionId)) {
+                const session = this.app.session(sessionId);
+                session.off("event", listener);
+            }
+            this.sessionListeners.delete(sessionId);
+        }
+    }
+    // ══════════════════════════════════════════════════════════════════════════
+    // Session Operations
+    // ══════════════════════════════════════════════════════════════════════════
+    /**
+     * Send a message and stream events via SSE.
+     * Mirrors Express POST /send endpoint.
+     */
+    async sendAndStream(sessionId, input, res) {
+        setSSEHeaders(res);
+        const writer = createSSEWriter(res);
+        try {
+            const handle = await this.app.send(input, { sessionId });
+            for await (const event of handle) {
+                writer.writeEvent({ ...event, sessionId: handle.sessionId });
+            }
+            const result = await handle.result;
+            writer.writeEvent({ type: "result", sessionId: handle.sessionId, result });
+        }
+        catch (error) {
+            writer.writeEvent({
+                type: "error",
+                sessionId: sessionId ?? "unknown",
+                error: { message: error instanceof Error ? error.message : String(error) },
+            });
+        }
+        finally {
+            writer.close();
+        }
+    }
+    /**
+     * Abort a session's current execution.
+     */
+    async abort(sessionId, reason) {
+        if (!this.app.has(sessionId)) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        const session = this.app.session(sessionId);
+        session.interrupt(undefined, reason);
+    }
+    /**
+     * Close a session server-side.
+     */
+    async close(sessionId) {
+        if (!this.app.has(sessionId)) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        await this.app.close(sessionId);
+    }
+    /**
+     * Submit tool confirmation result.
+     */
+    async submitToolResult(sessionId, toolUseId, result) {
+        if (!this.app.has(sessionId)) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        const session = this.app.session(sessionId);
+        session.submitToolResult(toolUseId, result);
+    }
+    /**
+     * Publish to a session-scoped channel.
+     */
+    async publishToChannel(sessionId, channelName, eventType, payload) {
+        if (!this.app.has(sessionId)) {
+            throw new Error(`Session ${sessionId} not found`);
+        }
+        this.ensureChannelListener(sessionId, channelName);
+        const session = this.app.session(sessionId);
+        const channel = session.channel(channelName);
+        channel.publish({ type: eventType, channel: channelName, payload });
+    }
+    ensureChannelListener(sessionId, channelName) {
+        let channelListeners = this.sessionChannelListeners.get(sessionId);
+        if (!channelListeners) {
+            channelListeners = new Map();
+            this.sessionChannelListeners.set(sessionId, channelListeners);
+        }
+        if (channelListeners.has(channelName))
+            return;
+        const session = this.app.session(sessionId);
+        const channel = session.channel(channelName);
+        const unsubscribe = channel.subscribe((event) => {
+            const subscribers = this.sessionSubscribers.get(sessionId);
+            if (!subscribers)
+                return;
+            const sseEvent = {
+                type: "channel",
+                sessionId,
+                channel: channelName,
+                event,
+            };
+            for (const connectionId of subscribers) {
+                const connection = this.connections.get(connectionId);
+                if (!connection || connection.closed)
+                    continue;
+                connection.writer.writeEvent(sseEvent);
+            }
+        });
+        channelListeners.set(channelName, unsubscribe);
+    }
+    // ══════════════════════════════════════════════════════════════════════════
+    // Low-level Access
+    // ══════════════════════════════════════════════════════════════════════════
+    /**
+     * Get the underlying App for direct access.
+     */
+    getApp() {
+        return this.app;
+    }
+};
+TentickleService = __decorate([
+    Injectable(),
+    __param(0, Inject(TENTICKLE_APP)),
+    __param(1, Inject(TENTICKLE_OPTIONS)),
+    __metadata("design:paramtypes", [Object, 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,82 @@
+/**
+ * NestJS module types for Tentickle.
+ *
+ * @module @tentickle/nestjs/types
+ */
+import type { ModuleMetadata, Type, InjectionToken } from "@nestjs/common";
+import type { App } from "@tentickle/core";
+/**
+ * Configuration for TentickleModule.
+ */
+export interface TentickleModuleOptions {
+    /**
+     * The Tentickle App instance.
+     */
+    app: App;
+    /**
+     * Endpoint path overrides.
+     */
+    paths?: {
+        events?: string;
+        send?: string;
+        subscribe?: string;
+        abort?: string;
+        close?: string;
+        toolResponse?: string;
+        channel?: string;
+    };
+    /**
+     * SSE keepalive interval in ms.
+     * @default 15000
+     */
+    sseKeepaliveInterval?: number;
+    /**
+     * Whether to register the default controller.
+     * Set to false if you want to define your own routes.
+     * @default true
+     */
+    registerController?: boolean;
+}
+/**
+ * Async configuration factory.
+ */
+export interface TentickleModuleOptionsFactory {
+    createTentickleOptions(): Promise<TentickleModuleOptions> | TentickleModuleOptions;
+}
+/**
+ * Async module configuration.
+ */
+export interface TentickleModuleAsyncOptions extends Pick<ModuleMetadata, "imports"> {
+    /**
+     * Factory function for options.
+     */
+    useFactory?: (...args: unknown[]) => Promise<TentickleModuleOptions> | TentickleModuleOptions;
+    /**
+     * Dependencies to inject into factory.
+     */
+    inject?: InjectionToken[];
+    /**
+     * Class that implements TentickleModuleOptionsFactory.
+     */
+    useClass?: Type<TentickleModuleOptionsFactory>;
+    /**
+     * Existing provider to use.
+     */
+    useExisting?: Type<TentickleModuleOptionsFactory>;
+    /**
+     * Whether to register the default controller.
+     * Set to false if you want to define your own routes.
+     * @default true
+     */
+    registerController?: boolean;
+}
+/**
+ * Injection token for TentickleModuleOptions.
+ */
+export declare const TENTICKLE_OPTIONS = "TENTICKLE_OPTIONS";
+/**
+ * Injection token for App.
+ */
+export declare const TENTICKLE_APP = "TENTICKLE_APP";
+export type { SendInput } from "@tentickle/shared";
+//# 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,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAM3C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,GAAG,EAAE,GAAG,CAAC;IAET;;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,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,sBAAsB,IAAI,OAAO,CAAC,sBAAsB,CAAC,GAAG,sBAAsB,CAAC;CACpF;AAED;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC;IAClF;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,sBAAsB,CAAC,GAAG,sBAAsB,CAAC;IAE9F;;OAEG;IACH,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAE/C;;OAEG;IACH,WAAW,CAAC,EAAE,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAElD;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAMD;;GAEG;AACH,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAM7C,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/types.js

@@ -0,0 +1,17 @@
+/**
+ * NestJS module types for Tentickle.
+ *
+ * @module @tentickle/nestjs/types
+ */
+// ============================================================================
+// Injection Tokens
+// ============================================================================
+/**
+ * Injection token for TentickleModuleOptions.
+ */
+export const TENTICKLE_OPTIONS = "TENTICKLE_OPTIONS";
+/**
+ * Injection token for App.
+ */
+export const TENTICKLE_APP = "TENTICKLE_APP";
+//# 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;AAoFH,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@agentick/nestjs",
+  "version": "0.0.1",
+  "description": "NestJS module for Agentick servers",
+  "keywords": [
+    "agent",
+    "agentick",
+    "ai",
+    "llm",
+    "nestjs"
+  ],
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@nestjs/common": "^10.4.15",
+    "@agentick/gateway": "0.0.1"
+  },
+  "devDependencies": {
+    "@nestjs/core": "^10.4.15",
+    "@nestjs/platform-express": "^10.4.15",
+    "@nestjs/testing": "^10.4.15",
+    "@types/express": "^4.17.25",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1",
+    "typescript": "^5.8.3",
+    "vitest": "^3.2.4"
+  },
+  "peerDependencies": {
+    "@nestjs/common": ">=9.0.0",
+    "@nestjs/core": ">=9.0.0",
+    "reflect-metadata": ">=0.1.0",
+    "rxjs": ">=7.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}