@lobu/core 2.8.0

package/dist/worker/auth.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateWorkerToken = generateWorkerToken;
+exports.verifyWorkerToken = verifyWorkerToken;
+const logger_1 = require("../logger");
+const encryption_1 = require("../utils/encryption");
+const logger = (0, logger_1.createLogger)("worker-auth");
+/**
+ * Generate a worker authentication token by encrypting thread metadata
+ */
+function generateWorkerToken(userId, conversationId, deploymentName, options) {
+    // Validate required fields
+    if (!options.channelId) {
+        throw new Error("channelId is required for worker token generation");
+    }
+    const timestamp = Date.now();
+    const payload = {
+        userId,
+        conversationId,
+        channelId: options.channelId,
+        teamId: options.teamId, // Can be undefined - that's ok
+        agentId: options.agentId, // Space ID for multi-tenant credential lookup
+        connectionId: options.connectionId,
+        deploymentName,
+        timestamp,
+        platform: options.platform,
+        sessionKey: options.sessionKey,
+        traceId: options.traceId, // Trace ID for observability
+    };
+    // Encrypt the payload
+    const encrypted = (0, encryption_1.encrypt)(JSON.stringify(payload));
+    return encrypted;
+}
+/**
+ * Verify and decrypt a worker authentication token
+ */
+function verifyWorkerToken(token) {
+    try {
+        // Decrypt the token
+        const decrypted = (0, encryption_1.decrypt)(token);
+        const data = JSON.parse(decrypted);
+        if (!data.conversationId ||
+            !data.userId ||
+            !data.deploymentName ||
+            !data.timestamp) {
+            logger.error("Worker token rejected: missing required fields");
+            return null;
+        }
+        // Check token expiration (default 24h)
+        const parsedTtl = parseInt(process.env.WORKER_TOKEN_TTL_MS ?? "", 10);
+        const ttl = !Number.isNaN(parsedTtl) && parsedTtl > 0 ? parsedTtl : 86400000;
+        if (Date.now() - data.timestamp > ttl) {
+            logger.error("Worker token rejected: expired");
+            return null;
+        }
+        return data;
+    }
+    catch (error) {
+        logger.error("Error verifying token:", error);
+        return null;
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/worker/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/worker/auth.ts"],"names":[],"mappings":";;AA2BA,kDAqCC;AAKD,8CA8BC;AAnGD,sCAAyC;AACzC,oDAAuD;AAEvD,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,aAAa,CAAC,CAAC;AAqB3C;;GAEG;AACH,SAAgB,mBAAmB,CACjC,MAAc,EACd,cAAsB,EACtB,cAAsB,EACtB,OAQC;IAED,2BAA2B;IAC3B,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAoB;QAC/B,MAAM;QACN,cAAc;QACd,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,+BAA+B;QACvD,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,8CAA8C;QACxE,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,cAAc;QACd,SAAS;QACT,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,6BAA6B;KACxD,CAAC;IAEF,sBAAsB;IACtB,MAAM,SAAS,GAAG,IAAA,oBAAO,EAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACnD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,IAAI,CAAC;QACH,oBAAoB;QACpB,MAAM,SAAS,GAAG,IAAA,oBAAO,EAAC,KAAK,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAoB,CAAC;QAEtD,IACE,CAAC,IAAI,CAAC,cAAc;YACpB,CAAC,IAAI,CAAC,MAAM;YACZ,CAAC,IAAI,CAAC,cAAc;YACpB,CAAC,IAAI,CAAC,SAAS,EACf,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,uCAAuC;QACvC,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,GAAG,GACP,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;QACnE,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;YACtC,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/worker/transport.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Worker Transport Interface
+ * Defines how workers communicate with the gateway (platform-agnostic)
+ *
+ * This abstraction allows different transport implementations:
+ * - HTTP (current implementation)
+ * - WebSocket (for real-time bidirectional communication)
+ * - gRPC (for high-performance scenarios)
+ * - Message Queue (for asynchronous processing)
+ */
+/**
+ * Transport interface for worker-to-gateway communication
+ */
+export interface WorkerTransport {
+    /**
+     * Set the job ID for this worker session
+     * Used to correlate responses with the originating request
+     */
+    setJobId(jobId: string): void;
+    /**
+     * Set module-specific data to be included in responses
+     * Allows modules to attach metadata to worker responses
+     */
+    setModuleData(moduleData: Record<string, unknown>): void;
+    /**
+     * Send a streaming delta to the gateway
+     *
+     * @param delta - The content delta to send
+     * @param isFullReplacement - If true, replaces entire content; if false, appends
+     * @param isFinal - If true, indicates this is the final delta
+     */
+    sendStreamDelta(delta: string, isFullReplacement?: boolean, isFinal?: boolean): Promise<void>;
+    /**
+     * Signal that the worker has completed processing
+     * Optionally includes a final delta
+     *
+     * @param finalDelta - Optional final content delta
+     */
+    signalDone(finalDelta?: string): Promise<void>;
+    /**
+     * Signal successful completion without additional content
+     */
+    signalCompletion(): Promise<void>;
+    /**
+     * Signal that an error occurred during processing
+     *
+     * @param error - The error that occurred
+     */
+    signalError(error: Error, errorCode?: string): Promise<void>;
+    /**
+     * Send a status update to the gateway
+     * Used for long-running operations to show progress
+     *
+     * @param elapsedSeconds - Time elapsed since operation started
+     * @param state - Current state description (e.g., "processing", "waiting for API")
+     */
+    sendStatusUpdate(elapsedSeconds: number, state: string): Promise<void>;
+}
+/**
+ * Configuration for creating a worker transport
+ */
+export interface WorkerTransportConfig {
+    /** Gateway URL for sending responses */
+    gatewayUrl: string;
+    /** Authentication token for worker */
+    workerToken: string;
+    /** User ID who initiated the request */
+    userId: string;
+    /** Channel/conversation ID */
+    channelId: string;
+    /** Conversation ID for organizing messages */
+    conversationId: string;
+    /** Original message timestamp/ID */
+    originalMessageTs: string;
+    /** Bot's response message timestamp/ID (if exists) */
+    botResponseTs?: string;
+    /** Team/workspace ID (required for all platforms) */
+    teamId: string;
+    /** Platform identifier (slack, whatsapp, api, etc.) */
+    platform?: string;
+    /** Platform-specific metadata needed for response routing */
+    platformMetadata?: Record<string, unknown>;
+    /** IDs of messages already processed (for deduplication) */
+    processedMessageIds?: string[];
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/worker/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/worker/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEzD;;;;;;OAMG;IACH,eAAe,CACb,KAAK,EAAE,MAAM,EACb,iBAAiB,CAAC,EAAE,OAAO,EAC3B,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;OAKG;IACH,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;OAEG;IACH,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7D;;;;;;OAMG;IACH,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IAEnB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IAEf,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IAEvB,oCAAoC;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAE1B,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IAEf,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE3C,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC"}

package/dist/worker/transport.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * Worker Transport Interface
+ * Defines how workers communicate with the gateway (platform-agnostic)
+ *
+ * This abstraction allows different transport implementations:
+ * - HTTP (current implementation)
+ * - WebSocket (for real-time bidirectional communication)
+ * - gRPC (for high-performance scenarios)
+ * - Message Queue (for asynchronous processing)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=transport.js.map

package/dist/worker/transport.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@lobu/core",
+  "version": "2.8.0",
+  "license": "Apache-2.0",
+  "description": "Core types and utilities for Lobu agent platform",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./dist/index.js",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    },
+    "./testing": {
+      "bun": "./dist/__tests__/fixtures/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/sdk-trace-node": "^1.30.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.57.0",
+    "@opentelemetry/resources": "^1.30.0",
+    "@opentelemetry/semantic-conventions": "^1.28.0",
+    "@sentry/node": "^10.23.0",
+    "ioredis": "^5.4.1",
+    "winston": "^3.17.0"
+  },
+  "devDependencies": {
+    "@types/bun": "1.2.11",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.8.3"
+  }
+}