nebula-notebook 0.1.0

package/node-server/dist/kernel/types.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Kernel Service Types
+ *
+ * Types for Jupyter kernel management in Node.js
+ */
+/**
+ * Jupyter kernelspec definition (from kernel.json files)
+ */
+export interface KernelSpec {
+    name: string;
+    displayName: string;
+    language: string;
+    path: string;
+    argv?: string[];
+    env?: Record<string, string>;
+}
+/**
+ * Jupyter connection configuration
+ * Contains port information for ZeroMQ channels
+ */
+export interface ConnectionConfig {
+    ip: string;
+    transport: string;
+    signatureScheme: string;
+    key: string;
+    shellPort: number;
+    stdinPort: number;
+    controlPort: number;
+    iopubPort: number;
+    hbPort: number;
+}
+/**
+ * Active kernel session
+ */
+export interface KernelSession {
+    id: string;
+    kernelName: string;
+    filePath: string | null;
+    status: KernelStatus;
+    executionCount: number;
+    pid: number | null;
+    connectionFile: string | null;
+    connectionConfig: ConnectionConfig | null;
+    createdAt: number;
+    lastActivity: number;
+}
+/**
+ * Kernel status
+ */
+export type KernelStatus = 'starting' | 'idle' | 'busy' | 'dead';
+/**
+ * Persisted session for SQLite storage
+ */
+export interface PersistedSession {
+    sessionId: string;
+    kernelName: string;
+    filePath: string | null;
+    kernelPid: number | null;
+    serverId?: string | null;
+    serverInstanceId?: string | null;
+    kernelStartTime?: string | null;
+    status: 'active' | 'orphaned' | 'terminated';
+    createdAt: number;
+    lastHeartbeat: number;
+    connectionFile: string | null;
+    connectionConfig: string | null;
+}
+/**
+ * Kernel output types (matching Jupyter message types)
+ */
+export type JsonValue = string | number | boolean | null | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type OutputType = 'stdout' | 'stderr' | 'image' | 'html' | 'error' | 'display_data';
+export type MimeBundle = Record<string, JsonValue>;
+/**
+ * Kernel output message
+ */
+export interface KernelOutput {
+    type: OutputType;
+    content: string;
+    mimeBundle?: MimeBundle;
+    metadata?: Record<string, JsonValue>;
+    preferredMimeType?: string;
+}
+export interface SequencedKernelOutput {
+    seq: number;
+    output: KernelOutput;
+    cellId?: string | null;
+}
+/**
+ * Execution queue metadata for a kernel session.
+ */
+export interface ExecutionQueueInfo {
+    /** Zero-based position of this request in the session queue. */
+    queuePosition: number;
+    /** Total number of requests queued for the session at enqueue time (includes this request). */
+    queueLength: number;
+}
+/**
+ * Execution result
+ */
+export interface ExecutionResult {
+    status: 'ok' | 'error';
+    executionCount: number | null;
+    error?: string;
+    queuePosition?: number;
+    queueLength?: number;
+}
+/**
+ * Options for starting a kernel
+ */
+export interface StartKernelOptions {
+    kernelName?: string;
+    cwd?: string;
+    filePath?: string;
+}
+/**
+ * Session info returned by API
+ */
+export interface SessionInfo {
+    id: string;
+    kernelName: string;
+    filePath: string | null;
+    status: KernelStatus;
+    executionCount: number;
+    memoryMb: number | null;
+    pid: number | null;
+    createdAt: number;
+}
+/**
+ * Kernel service configuration
+ */
+export interface KernelServiceConfig {
+    startupTimeoutSeconds?: number;
+    shutdownTimeoutSeconds?: number;
+    messageTimeoutSeconds?: number;
+    pollingIntervalSeconds?: number;
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: Required<KernelServiceConfig>;

package/node-server/dist/kernel/types.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Kernel Service Types
+ *
+ * Types for Jupyter kernel management in Node.js
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = void 0;
+/**
+ * Default configuration values
+ */
+exports.DEFAULT_CONFIG = {
+    startupTimeoutSeconds: 60,
+    shutdownTimeoutSeconds: 10,
+    messageTimeoutSeconds: 5,
+    pollingIntervalSeconds: 0.1,
+};

package/node-server/dist/llm/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * LLM Service Module
+ */
+export * from './types';
+export * from './llm-service';

package/node-server/dist/llm/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * LLM Service Module
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./llm-service"), exports);

package/node-server/dist/llm/llm-service.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Multi-Provider LLM Service
+ *
+ * Supports Google Gemini, OpenAI, and Anthropic.
+ * Node.js port of the Python LLMService.
+ */
+import { LLMConfig, LLMProvider, GenerateOptions, ChatOptions, GenerateStructuredOptions } from './types';
+export declare class LLMService {
+    private googleClient;
+    private openaiClient;
+    private anthropicClient;
+    /**
+     * Get or create Google GenAI client
+     */
+    private getGoogleClient;
+    /**
+     * Get or create OpenAI client
+     */
+    private getOpenaiClient;
+    /**
+     * Get or create Anthropic client
+     */
+    private getAnthropicClient;
+    /**
+     * Get available providers based on configured API keys
+     */
+    getAvailableProviders(): Partial<Record<LLMProvider, string[]>>;
+    /**
+     * Normalize config with defaults
+     */
+    normalizeConfig(config: LLMConfig): Required<Omit<LLMConfig, 'apiKey'>> & {
+        apiKey?: string;
+    };
+    /**
+     * Repair common JSON formatting issues
+     */
+    repairJson(s: string): string;
+    /**
+     * Parse JSON with automatic repair on failure
+     */
+    private parseJsonWithRepair;
+    /**
+     * Extract JSON from a response that may contain markdown code blocks
+     */
+    extractJsonFromResponse(response: string): unknown;
+    /**
+     * Generate response from Google Gemini
+     */
+    private generateGoogle;
+    /**
+     * Generate response from OpenAI
+     */
+    private generateOpenai;
+    /**
+     * Generate response from Anthropic Claude
+     */
+    private generateAnthropic;
+    /**
+     * Generate a response from the LLM
+     */
+    generate(options: GenerateOptions): Promise<string>;
+    /**
+     * Generate structured JSON response
+     */
+    generateStructured(options: GenerateStructuredOptions): Promise<unknown>;
+    private generateStructuredGoogle;
+    private generateStructuredOpenai;
+    private generateStructuredAnthropic;
+    /**
+     * Chat with conversation history
+     */
+    chat(options: ChatOptions): Promise<string>;
+    private chatGoogle;
+    private chatOpenai;
+    private chatAnthropic;
+}
+export declare const llmService: LLMService;