@northflare/runner 0.0.1

package/dist/collections/runner-messages.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * ElectricSQL collection for RunnerMessages with real-time sync
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunnerMessagesCollection = exports.runnerMessageSchema = void 0;
+exports.createRunnerMessagesCollection = createRunnerMessagesCollection;
+const client_1 = require("@electric-sql/client");
+const zod_1 = require("zod");
+const logger_1 = require("../utils/logger");
+const logger = (0, logger_1.createLogger)("ElectricSQL");
+// Schema for RunnerMessage from ElectricSQL (raw database columns)
+const electricMessageSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    direction: zod_1.z.enum(["to_runner", "to_orchestrator"]),
+    runner: zod_1.z.string(), // Database column name
+    task: zod_1.z.string().nullable(), // Database column name for taskId
+    workspace: zod_1.z.string().nullable(), // Database column name
+    conversation: zod_1.z.string().nullable(), // Database column name for conversationId (relation id)
+    payload: zod_1.z.any(), // JSONRPC 2.0 message
+    expiresAt: zod_1.z.string(),
+    createdAt: zod_1.z.string(),
+});
+// Schema for normalized RunnerMessage used internally
+exports.runnerMessageSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    direction: zod_1.z.enum(["to_runner", "to_orchestrator"]),
+    runnerId: zod_1.z.string(),
+    taskId: zod_1.z.string().nullable(),
+    workspaceId: zod_1.z.string().nullable(),
+    conversationId: zod_1.z.string().nullable(),
+    payload: zod_1.z.any(), // JSONRPC 2.0 message
+    expiresAt: zod_1.z.string(),
+    createdAt: zod_1.z.string(),
+});
+class RunnerMessagesCollection {
+    shape;
+    stream;
+    subscribers = new Set();
+    shapeUnsubscribe;
+    isInitialized = false;
+    state = new Map();
+    constructor(config, lastProcessedAt) {
+        // Build the where clause based on lastProcessedAt
+        let whereClause = `"direction" = 'to_runner' AND "runner" = '${config.runnerId}'`;
+        if (lastProcessedAt) {
+            // Only get messages created after lastProcessedAt
+            whereClause += ` AND "createdAt" > '${lastProcessedAt.toISOString()}'`;
+        }
+        // Debug logging for ElectricSQL connection setup
+        if (process.env["DEBUG"] === "true") {
+            logger.debug("Creating ElectricSQL shape stream", {
+                electricUrl: config.electricUrl,
+                runnerId: config.runnerId,
+                lastProcessedAt: lastProcessedAt?.toISOString() || "null",
+                whereClause: whereClause,
+                table: '"RunnerMessage"',
+                authToken: process.env["CLAUDETTE_RUNNER_TOKEN"] ? "present" : "missing"
+            });
+        }
+        // Create the ShapeStream
+        this.stream = new client_1.ShapeStream({
+            url: `${config.electricUrl}/v1/shape`,
+            params: {
+                table: '"RunnerMessage"',
+                where: whereClause,
+            },
+            headers: {
+                Authorization: `Bearer ${process.env["CLAUDETTE_RUNNER_TOKEN"]}`,
+            },
+        });
+        // Create the Shape to handle data
+        this.shape = new client_1.Shape(this.stream);
+        // Subscribe to shape changes
+        this.shapeUnsubscribe = this.shape.subscribe(({ rows }) => {
+            // Update internal state with normalized messages
+            this.state.clear();
+            rows.forEach((row) => {
+                // Normalize the database column names to our internal schema
+                // ElectricSQL always returns raw database columns: task, runner, workspace
+                const normalizedMessage = {
+                    id: row.id,
+                    direction: row.direction,
+                    runnerId: row.runner, // Database column 'runner' -> 'runnerId'
+                    taskId: row.task, // Database column 'task' -> 'taskId'
+                    workspaceId: row.workspace, // Database column 'workspace' -> 'workspaceId'
+                    conversationId: row.conversation ?? null,
+                    payload: row.payload,
+                    expiresAt: row.expiresAt,
+                    createdAt: row.createdAt,
+                };
+                this.state.set(normalizedMessage.id, normalizedMessage);
+            });
+            // Mark as initialized after first sync
+            if (!this.isInitialized) {
+                this.isInitialized = true;
+            }
+            if (process.env["DEBUG"] === "true") {
+                logger.debug("ElectricSQL shape updated", {
+                    messageCount: rows.length,
+                    runnerId: config.runnerId
+                });
+            }
+            // Notify all subscribers
+            this.subscribers.forEach(callback => callback());
+        });
+        // Log when collection is created
+        if (process.env["DEBUG"] === "true") {
+            logger.debug("ElectricSQL collection created", {
+                hasState: true,
+                shapeUrl: `${config.electricUrl}/v1/shape`
+            });
+        }
+    }
+    // Subscribe to collection changes
+    subscribe(callback) {
+        this.subscribers.add(callback);
+        // Return unsubscribe function
+        return () => {
+            this.subscribers.delete(callback);
+        };
+    }
+    // Preload data - wait for initial sync
+    async preload() {
+        if (process.env["DEBUG"] === "true") {
+            logger.debug("Preloading ElectricSQL data");
+        }
+        // Wait for initial data to load
+        await this.shape.rows;
+        if (process.env["DEBUG"] === "true") {
+            logger.debug("ElectricSQL preload complete", {
+                messageCount: this.state.size
+            });
+        }
+    }
+    // Check if collection is ready
+    isReady() {
+        // Consider ready after initial sync
+        return this.isInitialized;
+    }
+    // Stop the collection
+    stop() {
+        // Unsubscribe from shape updates
+        if (this.shapeUnsubscribe) {
+            this.shapeUnsubscribe();
+        }
+        // Stop all stream subscriptions
+        this.stream.unsubscribeAll();
+        // Clear internal state
+        this.subscribers.clear();
+        this.state.clear();
+        if (process.env["DEBUG"] === "true") {
+            logger.debug("ElectricSQL collection stopped");
+        }
+    }
+}
+exports.RunnerMessagesCollection = RunnerMessagesCollection;
+function createRunnerMessagesCollection(config, lastProcessedAt) {
+    return new RunnerMessagesCollection(config, lastProcessedAt);
+}
+//# sourceMappingURL=runner-messages.js.map

package/dist/collections/runner-messages.js.map

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

package/dist/components/claude-manager.d.ts

@@ -0,0 +1,39 @@
+/**
+ * ClaudeManager - Manages Claude conversations using claude-code-sdk-ts
+ *
+ * This component handles stateful conversation lifecycle management, maintaining
+ * persistent conversation instances indexed by taskId. It integrates with the
+ * Claude SDK to manage sessions, handle MCP server configurations, and coordinate
+ * with the orchestrator for authentication and notifications.
+ */
+import { IRunnerApp } from "../types/runner-interface";
+import { EnhancedRepositoryManager } from "./enhanced-repository-manager";
+import { ConversationContext, ConversationConfig, Message } from "../types";
+export declare class ClaudeManager {
+    private runner;
+    private repositoryManager;
+    constructor(runner: IRunnerApp, repositoryManager: EnhancedRepositoryManager);
+    private setupInternalMcpServer;
+    startConversation(conversationObjectType: "Task" | "TaskPlan", conversationObjectId: string, config: ConversationConfig, initialMessages: Message[], conversationData?: {
+        id: string;
+        objectType: string;
+        objectId: string;
+        model: string;
+        globalInstructions: string;
+        workspaceInstructions: string;
+        permissionsMode: string;
+        agentSessionId: string;
+    }): Promise<ConversationContext>;
+    stopConversation(agentSessionId: string, context: ConversationContext): Promise<void>;
+    resumeConversation(conversationObjectType: "Task" | "TaskPlan", conversationObjectId: string, agentSessionId: string, config: ConversationConfig, conversationData?: any, resumeMessage?: string): Promise<string>;
+    sendUserMessage(conversationId: string, content: any, config?: ConversationConfig, conversationObjectType?: "Task" | "TaskPlan", conversationObjectId?: string, conversation?: any): Promise<void>;
+    private fetchGithubTokens;
+    private _handleConversationError;
+    private classifyError;
+    /**
+     * Normalize arbitrary content shapes into a plain string for the CLI
+     */
+    private normalizeToText;
+    private handleStreamedMessage;
+}
+//# sourceMappingURL=claude-manager.d.ts.map

package/dist/components/claude-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-manager.d.ts","sourceRoot":"","sources":["../../src/components/claude-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAM5E,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,iBAAiB,CAA4B;gBAGnD,MAAM,EAAE,UAAU,EAClB,iBAAiB,EAAE,yBAAyB;IAiB9C,OAAO,CAAC,sBAAsB;IAKxB,iBAAiB,CACrB,sBAAsB,EAAE,MAAM,GAAG,UAAU,EAC3C,oBAAoB,EAAE,MAAM,EAC5B,MAAM,EAAE,kBAAkB,EAC1B,eAAe,EAAE,OAAO,EAAE,EAC1B,gBAAgB,CAAC,EAAE;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,kBAAkB,EAAE,MAAM,CAAC;QAC3B,qBAAqB,EAAE,MAAM,CAAC;QAC9B,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;KACxB,GACA,OAAO,CAAC,mBAAmB,CAAC;IA6XzB,gBAAgB,CACpB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC;IAuBV,kBAAkB,CACtB,sBAAsB,EAAE,MAAM,GAAG,UAAU,EAC3C,oBAAoB,EAAE,MAAM,EAC5B,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,kBAAkB,EAC1B,gBAAgB,CAAC,EAAE,GAAG,EACtB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC;IAmCZ,eAAe,CACnB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,GAAG,EACZ,MAAM,CAAC,EAAE,kBAAkB,EAC3B,sBAAsB,CAAC,EAAE,MAAM,GAAG,UAAU,EAC5C,oBAAoB,CAAC,EAAE,MAAM,EAC7B,YAAY,CAAC,EAAE,GAAG,GACjB,OAAO,CAAC,IAAI,CAAC;YA8JF,iBAAiB;YA2BjB,wBAAwB;IA2BtC,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,OAAO,CAAC,eAAe;YA2CT,qBAAqB;CAmQpC"}