@inf-minds/kernel 0.0.1

package/dist/kernel.js

@@ -0,0 +1,202 @@
+// ABOUTME: Kernel factory for creating kernel instances
+// ABOUTME: The kernel manages sessions, minds, and coordination modes
+import { validateGraph } from '@inf-minds/coordination-modes';
+import { JOB_TYPE } from '@inf-minds/jobs';
+import { createMindRegistry, createModeRegistry } from './registries/index.js';
+import { KernelSessionImpl } from './session.js';
+/**
+ * Create a new kernel instance.
+ *
+ * The kernel is the central orchestrator for multi-mind coordination.
+ * It manages:
+ * - Mind configurations (registered by name)
+ * - Coordination modes (execution graphs)
+ * - Sessions (executing instances of modes)
+ *
+ * @param options - Kernel configuration options
+ * @returns A new Kernel instance
+ *
+ * @example
+ * ```ts
+ * const kernel = createKernel({
+ *   jobManager,
+ *   eventAppender,
+ *   artifactManager,
+ * });
+ *
+ * // Register minds
+ * kernel.registerMind('researcher', {
+ *   model: 'claude-sonnet-4-20250514',
+ *   systemPrompt: 'You are a research assistant...',
+ * });
+ *
+ * // Register modes
+ * kernel.registerMode(createPipelineMode({
+ *   steps: [
+ *     { id: 'research', mind: { type: 'registered', mindType: 'researcher' } },
+ *     { id: 'analyze', mind: { type: 'registered', mindType: 'analyzer' } },
+ *   ],
+ * }));
+ *
+ * // Create and run a session
+ * const session = await kernel.createSession({
+ *   mode: 'pipeline',
+ *   input: { topic: 'quantum computing' },
+ *   accountId: 'acc-123',
+ * });
+ * ```
+ */
+export function createKernel(options) {
+    const { jobManager, eventAppender, artifactManager, defaultArtifactRouter } = options;
+    // Create registries
+    const mindRegistry = createMindRegistry();
+    const modeRegistry = createModeRegistry();
+    /**
+     * Resolve a mode from either a name or inline definition.
+     */
+    function resolveMode(modeRef) {
+        if (typeof modeRef === 'string') {
+            const mode = modeRegistry.get(modeRef);
+            if (!mode) {
+                throw new Error(`Mode '${modeRef}' not found in registry`);
+            }
+            return mode;
+        }
+        return modeRef;
+    }
+    /**
+     * Create initial graph state for a new session.
+     */
+    function createInitialGraphState(mode) {
+        const nodes = {};
+        for (const nodeId of Object.keys(mode.graph.nodes)) {
+            nodes[nodeId] = {
+                nodeId,
+                status: 'pending',
+            };
+        }
+        return {
+            nodes,
+            activeNodes: [],
+            completedNodes: [],
+            failedNodes: [],
+            skippedNodes: [],
+            startedAt: new Date().toISOString(),
+            status: 'running',
+        };
+    }
+    /**
+     * Wrap a job as a KernelSession.
+     */
+    async function wrapJobAsSession(job) {
+        // Parse the job input to get mode name
+        const jobInput = job.input;
+        const modeName = jobInput?.mode ?? 'unknown';
+        // Get the mode definition if available
+        const mode = modeRegistry.get(modeName);
+        return new KernelSessionImpl({
+            job,
+            mode,
+            modeName,
+            jobManager,
+            eventAppender,
+            artifactManager,
+            artifactRouter: defaultArtifactRouter,
+            mindRegistry,
+        });
+    }
+    return {
+        async createSession(sessionOptions) {
+            // Resolve the coordination mode
+            const mode = resolveMode(sessionOptions.mode);
+            // Validate the graph
+            const validation = validateGraph(mode.graph);
+            if (!validation.valid) {
+                throw new Error(`Invalid graph: ${validation.errors.join(', ')}`);
+            }
+            // Warn about issues (but don't fail)
+            if (validation.warnings.length > 0) {
+                console.warn(`Graph warnings: ${validation.warnings.join(', ')}`);
+            }
+            // Create initial graph state
+            const graphState = createInitialGraphState(mode);
+            // Generate artifact base path for this session
+            const sessionId = crypto.randomUUID();
+            const artifactBasePath = `/sessions/${sessionId}`;
+            // Create the parent job
+            const job = await jobManager.create({
+                type: JOB_TYPE.KERNEL_SESSION,
+                accountId: sessionOptions.accountId,
+                input: {
+                    mode: mode.name,
+                    userInput: sessionOptions.input,
+                    metadata: sessionOptions.metadata,
+                },
+                graphState,
+                artifactBasePath,
+            });
+            // Create and return the session wrapper
+            const artifactRouter = sessionOptions.artifactRouter ?? defaultArtifactRouter;
+            return new KernelSessionImpl({
+                job,
+                mode,
+                modeName: mode.name,
+                jobManager,
+                eventAppender,
+                artifactManager,
+                artifactRouter,
+                mindRegistry,
+            });
+        },
+        async getSession(sessionId) {
+            const job = await jobManager.get(sessionId);
+            if (!job) {
+                return null;
+            }
+            // Verify it's a kernel-session job
+            if (job.type !== JOB_TYPE.KERNEL_SESSION) {
+                return null;
+            }
+            return wrapJobAsSession(job);
+        },
+        async listSessions(filter) {
+            // Use job manager to list kernel-session jobs
+            const result = await jobManager.list({
+                accountId: filter?.accountId ?? '', // Required by job manager
+                type: JOB_TYPE.KERNEL_SESSION,
+                status: filter?.status,
+                limit: filter?.limit,
+                offset: filter?.offset,
+            });
+            // Filter by mode if specified
+            let jobs = result.jobs;
+            if (filter?.mode) {
+                jobs = jobs.filter((job) => {
+                    const input = job.input;
+                    return input?.mode === filter.mode;
+                });
+            }
+            // Wrap jobs as sessions
+            return Promise.all(jobs.map(wrapJobAsSession));
+        },
+        registerMind(name, config) {
+            mindRegistry.register(name, config);
+        },
+        getMind(name) {
+            return mindRegistry.get(name);
+        },
+        registerMode(mode) {
+            modeRegistry.register(mode);
+        },
+        getMode(name) {
+            return modeRegistry.get(name);
+        },
+        listMindTypes() {
+            return mindRegistry.list();
+        },
+        listModeNames() {
+            return modeRegistry.list();
+        },
+    };
+}
+//# sourceMappingURL=kernel.js.map

package/dist/kernel.js.map

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

package/dist/registries/index.d.ts

@@ -0,0 +1,3 @@
+export { createMindRegistry } from './mind-registry.js';
+export { createModeRegistry } from './mode-registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/registries/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registries/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/registries/index.js

@@ -0,0 +1,5 @@
+// ABOUTME: Registry exports
+// ABOUTME: Exports mind and mode registry factories
+export { createMindRegistry } from './mind-registry.js';
+export { createModeRegistry } from './mode-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/registries/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registries/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,oDAAoD;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/registries/mind-registry.d.ts

@@ -0,0 +1,11 @@
+import type { MindRegistry } from '../types.js';
+/**
+ * Create a new mind registry.
+ *
+ * The registry stores named mind configurations that can be referenced
+ * in coordination mode graph nodes.
+ *
+ * @returns A new MindRegistry instance
+ */
+export declare function createMindRegistry(): MindRegistry;
+//# sourceMappingURL=mind-registry.d.ts.map

package/dist/registries/mind-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mind-registry.d.ts","sourceRoot":"","sources":["../../src/registries/mind-registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAuBjD"}

package/dist/registries/mind-registry.js

@@ -0,0 +1,31 @@
+// ABOUTME: Mind registry for storing named mind configurations
+// ABOUTME: Allows registering and retrieving mind configs by name
+/**
+ * Create a new mind registry.
+ *
+ * The registry stores named mind configurations that can be referenced
+ * in coordination mode graph nodes.
+ *
+ * @returns A new MindRegistry instance
+ */
+export function createMindRegistry() {
+    const minds = new Map();
+    return {
+        register(name, config) {
+            if (minds.has(name)) {
+                throw new Error(`Mind '${name}' is already registered`);
+            }
+            minds.set(name, config);
+        },
+        get(name) {
+            return minds.get(name);
+        },
+        has(name) {
+            return minds.has(name);
+        },
+        list() {
+            return Array.from(minds.keys());
+        },
+    };
+}
+//# sourceMappingURL=mind-registry.js.map

package/dist/registries/mind-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mind-registry.js","sourceRoot":"","sources":["../../src/registries/mind-registry.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,kEAAkE;AAKlE;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAE5C,OAAO;QACL,QAAQ,CAAC,IAAY,EAAE,MAAkB;YACvC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,yBAAyB,CAAC,CAAC;YAC1D,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1B,CAAC;QAED,GAAG,CAAC,IAAY;YACd,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAED,GAAG,CAAC,IAAY;YACd,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAED,IAAI;YACF,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/registries/mode-registry.d.ts

@@ -0,0 +1,11 @@
+import type { ModeRegistry } from '../types.js';
+/**
+ * Create a new mode registry.
+ *
+ * The registry stores coordination modes that can be used when
+ * creating kernel sessions.
+ *
+ * @returns A new ModeRegistry instance
+ */
+export declare function createModeRegistry(): ModeRegistry;
+//# sourceMappingURL=mode-registry.d.ts.map

package/dist/registries/mode-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-registry.d.ts","sourceRoot":"","sources":["../../src/registries/mode-registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAuBjD"}

package/dist/registries/mode-registry.js

@@ -0,0 +1,31 @@
+// ABOUTME: Mode registry for storing named coordination modes
+// ABOUTME: Allows registering and retrieving modes by name
+/**
+ * Create a new mode registry.
+ *
+ * The registry stores coordination modes that can be used when
+ * creating kernel sessions.
+ *
+ * @returns A new ModeRegistry instance
+ */
+export function createModeRegistry() {
+    const modes = new Map();
+    return {
+        register(mode) {
+            if (modes.has(mode.name)) {
+                throw new Error(`Mode '${mode.name}' is already registered`);
+            }
+            modes.set(mode.name, mode);
+        },
+        get(name) {
+            return modes.get(name);
+        },
+        has(name) {
+            return modes.has(name);
+        },
+        list() {
+            return Array.from(modes.keys());
+        },
+    };
+}
+//# sourceMappingURL=mode-registry.js.map

package/dist/registries/mode-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-registry.js","sourceRoot":"","sources":["../../src/registries/mode-registry.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,2DAA2D;AAK3D;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,IAAI,GAAG,EAA4B,CAAC;IAElD,OAAO;QACL,QAAQ,CAAC,IAAsB;YAC7B,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,IAAI,yBAAyB,CAAC,CAAC;YAC/D,CAAC;YACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;QAED,GAAG,CAAC,IAAY;YACd,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAED,GAAG,CAAC,IAAY;YACd,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAED,IAAI;YACF,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,123 @@
+import type { CoordinationMode } from '@inf-minds/coordination-modes';
+import type { JobManager, EventAppender, ArtifactManager, ArtifactRef, Job, GraphState } from '@inf-minds/jobs';
+import type { ArtifactRouter, VisibilityHints } from '@inf-minds/jobs';
+import type { KernelSession, SessionStatus, SessionEvent, Unsubscribe, MindRegistry } from './types.js';
+/**
+ * Options for creating a KernelSessionImpl.
+ */
+export interface KernelSessionImplOptions {
+    /** The parent kernel-session job */
+    job: Job;
+    /** The coordination mode (may be undefined if restored from job) */
+    mode?: CoordinationMode;
+    /** Mode name for display */
+    modeName: string;
+    /** JobManager for job lifecycle */
+    jobManager: JobManager;
+    /** EventAppender for event streaming */
+    eventAppender: EventAppender;
+    /** ArtifactManager for artifact operations */
+    artifactManager: ArtifactManager;
+    /** ArtifactRouter for routing decisions */
+    artifactRouter?: ArtifactRouter;
+    /** MindRegistry for resolving registered minds */
+    mindRegistry: MindRegistry;
+}
+/**
+ * Implementation of KernelSession.
+ *
+ * Manages the lifecycle of a kernel session, including:
+ * - Graph execution state
+ * - Node scheduling
+ * - Artifact routing
+ * - Event emission
+ */
+export declare class KernelSessionImpl implements KernelSession {
+    private readonly _job;
+    private readonly _mode?;
+    private readonly _modeName;
+    private readonly _jobManager;
+    private readonly _eventAppender;
+    private readonly _artifactManager;
+    private readonly _artifactRouter?;
+    private readonly _mindRegistry;
+    private readonly _subscribers;
+    private _currentGraphState;
+    constructor(options: KernelSessionImplOptions);
+    get id(): string;
+    get mode(): string;
+    get status(): SessionStatus;
+    get graphState(): GraphState;
+    get artifactBasePath(): string;
+    get accountId(): string;
+    /**
+     * Get the coordination mode for this session.
+     * May be undefined if the session was restored from a job without the mode.
+     */
+    get coordinationMode(): CoordinationMode | undefined;
+    /**
+     * Get the artifact router for this session.
+     */
+    get artifactRouter(): ArtifactRouter | undefined;
+    /**
+     * Get the mind registry for resolving mind configs.
+     */
+    get mindRegistryRef(): MindRegistry;
+    pause(): Promise<void>;
+    resume(): Promise<void>;
+    cancel(): Promise<void>;
+    subscribe(handler: (event: SessionEvent) => void): Unsubscribe;
+    getArtifacts(path?: string): Promise<ArtifactRef[]>;
+    getNodeOutput(nodeId: string): unknown | null;
+    waitForCompletion(): Promise<unknown>;
+    /**
+     * Emit a session event to all subscribers.
+     */
+    private _emitEvent;
+    /**
+     * Start the session by executing the entry node.
+     */
+    start(): Promise<void>;
+    /**
+     * Handle completion of a node execution.
+     * Called by the coordinator when a mind-execution job completes.
+     */
+    handleNodeComplete(nodeId: string, output: unknown, artifacts?: Array<{
+        ref: ArtifactRef;
+        hints: VisibilityHints;
+    }>): Promise<void>;
+    /**
+     * Handle failure of a node execution.
+     * Called by the coordinator when a mind-execution job fails.
+     */
+    handleNodeFailure(nodeId: string, error: string): Promise<void>;
+    /**
+     * Start execution of a specific node.
+     */
+    private _startNode;
+    /**
+     * Complete the session with final output.
+     */
+    private _completeSession;
+    /**
+     * Fail the session with error.
+     */
+    private _failSession;
+    /**
+     * Get the user input from the job.
+     */
+    private _getUserInput;
+    /**
+     * Get the mind type for a node.
+     */
+    private _getNodeMindType;
+    /**
+     * Get the current iteration count for a node.
+     */
+    private _getNodeIteration;
+    /**
+     * Resolve mind config from a node's mind reference.
+     */
+    private _resolveMindConfig;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

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