@veedubin/neuralgentics 0.9.1

package/dist/neuralgentics/go-backend-client.d.ts

@@ -0,0 +1,71 @@
+/**
+ * GoBackendClient — JSON-RPC 2.0 client over stdio for the Neuralgentics Go backend.
+ *
+ * Spawns the `neuralgentics-backend` binary as a child process and communicates
+ * via newline-delimited JSON-RPC over stdin/stdout. Stderr is inherited so the
+ * backend's logs appear in the parent process' console.
+ *
+ * This replaces the previous HTTP transport to the Python memini-core server,
+ * achieving sub-millisecond latency on the same machine with zero port management.
+ */
+/**
+ * JSON-RPC 2.0 client that talks to the Go backend over stdio.
+ *
+ * Usage:
+ * ```ts
+ * const backend = new GoBackendClient("neuralgentics-backend");
+ * await backend.waitForReady();
+ * const result = await backend.call("memory.add", { content: "hello" });
+ * await backend.shutdown();
+ * ```
+ */
+export declare class GoBackendClient {
+    private process;
+    private nextId;
+    private pending;
+    private ready;
+    private readyPromise;
+    private readyResolve;
+    private readyReject;
+    /**
+     * Spawn the Go backend binary and begin reading its stdout.
+     *
+     * @param binaryPath - Absolute or relative path to the `neuralgentics-backend` binary.
+     *                     Falls back to $PATH lookup if just the binary name is given.
+     */
+    constructor(binaryPath: string);
+    /**
+     * Wait for the backend to be ready (after first stdout line, which is
+     * the {"method":"ready"} notification the backend emits post-init).
+     *
+     * @param timeoutMs - Maximum time to wait before giving up (default 10 000).
+     *                    If the backend is slow to start (or crashes silently),
+     *                    this prevents the OpenCode plugin from hanging forever.
+     *                    On timeout, the promise rejects so callers can decide
+     *                    whether to abort or continue with a broken backend.
+     */
+    waitForReady(timeoutMs?: number): Promise<void>;
+    /**
+     * Send a JSON-RPC request and await the response.
+     *
+     * @param method - JSON-RPC method name (e.g. "memory.add", "thought.startChain").
+     * @param params - Request parameters object.
+     * @param timeoutMs - Request timeout in milliseconds (default 30 000).
+     * @returns The `result` field of the JSON-RPC response.
+     */
+    call(method: string, params?: Record<string, unknown>, timeoutMs?: number): Promise<unknown>;
+    /** Shutdown the backend process gracefully. */
+    shutdown(): Promise<void>;
+    /**
+     * Handle a single line from the Go backend's stdout.
+     *
+     * The first valid JSON line marks the backend as ready.
+     * Subsequent lines are routed to their pending calls by `id`.
+     */
+    private handleLine;
+    /** Handle stdout close — reject all pending calls. */
+    private handleClose;
+    /** Reject every pending call with the same error. */
+    private rejectAll;
+}
+//# sourceMappingURL=go-backend-client.d.ts.map

package/dist/neuralgentics/go-backend-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"go-backend-client.d.ts","sourceRoot":"","sources":["../../src/neuralgentics/go-backend-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiCH;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,WAAW,CAAwB;IAE3C;;;;;OAKG;gBACS,UAAU,EAAE,MAAM;IAsC9B;;;;;;;;;OASG;IACG,YAAY,CAAC,SAAS,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBrD;;;;;;;OAOG;IACG,IAAI,CACR,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,SAAS,GACjB,OAAO,CAAC,OAAO,CAAC;IAgCnB,+CAA+C;IACzC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAqClB,sDAAsD;IACtD,OAAO,CAAC,WAAW;IAInB,qDAAqD;IACrD,OAAO,CAAC,SAAS;CAOlB"}

package/dist/neuralgentics/go-backend-client.js

@@ -0,0 +1,198 @@
+/**
+ * GoBackendClient — JSON-RPC 2.0 client over stdio for the Neuralgentics Go backend.
+ *
+ * Spawns the `neuralgentics-backend` binary as a child process and communicates
+ * via newline-delimited JSON-RPC over stdin/stdout. Stderr is inherited so the
+ * backend's logs appear in the parent process' console.
+ *
+ * This replaces the previous HTTP transport to the Python memini-core server,
+ * achieving sub-millisecond latency on the same machine with zero port management.
+ */
+import { spawn } from "node:child_process";
+import { createInterface } from "node:readline";
+/**
+ * Default database URL the Go backend connects to.
+ *
+ * IMPORTANT: lib/pq (the Go postgres driver) defaults `sslmode` to `require`
+ * when no `sslmode` is specified in the connection string. That works against
+ * databases with `ssl = on` but fails against databases with `ssl = off`
+ * (e.g. the user's prod timescale-pg18 on 5434). The dev test DB on 6000
+ * has SSL enabled, so `?sslmode=require` matches the server's capability
+ * and lets the migrator + queries succeed without any CA verification.
+ *
+ * Override at spawn time by setting `NEURALGENTICS_DB_URL` in the parent
+ * process's environment before OpenCode launches the plugin.
+ */
+const DEFAULT_DB_URL = "postgresql://postgres:testpassword@localhost:6000/neuralgentics_test?sslmode=require";
+/** Resolve the DB URL — explicit env override wins, otherwise the dev DB. */
+function resolveDbUrl() {
+    return process.env.NEURALGENTICS_DB_URL ?? DEFAULT_DB_URL;
+}
+/**
+ * JSON-RPC 2.0 client that talks to the Go backend over stdio.
+ *
+ * Usage:
+ * ```ts
+ * const backend = new GoBackendClient("neuralgentics-backend");
+ * await backend.waitForReady();
+ * const result = await backend.call("memory.add", { content: "hello" });
+ * await backend.shutdown();
+ * ```
+ */
+export class GoBackendClient {
+    process;
+    nextId = 1;
+    pending = new Map();
+    ready = false;
+    readyPromise;
+    readyResolve;
+    readyReject;
+    /**
+     * Spawn the Go backend binary and begin reading its stdout.
+     *
+     * @param binaryPath - Absolute or relative path to the `neuralgentics-backend` binary.
+     *                     Falls back to $PATH lookup if just the binary name is given.
+     */
+    constructor(binaryPath) {
+        // Set NEURALGENTICS_DB_URL so the backend doesn't fall back to its
+        // 5434 default (which has no SSL and breaks lib/pq's implicit
+        // sslmode=require). Override the env var before launch to point at
+        // any database; default is the dev/test DB on 6000 with SSL.
+        const childEnv = {
+            ...process.env,
+            NEURALGENTICS_DB_URL: resolveDbUrl(),
+        };
+        this.process = spawn(binaryPath, [], {
+            stdio: ["pipe", "pipe", "inherit"],
+            env: childEnv,
+        });
+        this.readyPromise = new Promise((resolve, reject) => {
+            this.readyResolve = resolve;
+            this.readyReject = reject;
+        });
+        // Read stdout line-by-line and route responses to pending calls.
+        const rl = createInterface({ input: this.process.stdout });
+        rl.on("line", (line) => this.handleLine(line));
+        rl.on("close", () => this.handleClose());
+        // Detect binary failure to start.
+        this.process.on("error", (err) => {
+            this.readyReject(err);
+            this.rejectAll(err);
+        });
+        this.process.on("exit", (code) => {
+            const error = new Error(`Go backend exited with code ${code ?? "unknown"}`);
+            this.rejectAll(error);
+        });
+    }
+    /**
+     * Wait for the backend to be ready (after first stdout line, which is
+     * the {"method":"ready"} notification the backend emits post-init).
+     *
+     * @param timeoutMs - Maximum time to wait before giving up (default 10 000).
+     *                    If the backend is slow to start (or crashes silently),
+     *                    this prevents the OpenCode plugin from hanging forever.
+     *                    On timeout, the promise rejects so callers can decide
+     *                    whether to abort or continue with a broken backend.
+     */
+    async waitForReady(timeoutMs = 10_000) {
+        if (this.ready)
+            return;
+        await Promise.race([
+            this.readyPromise,
+            new Promise((_, reject) => setTimeout(() => reject(new Error(`Go backend did not emit 'ready' within ${timeoutMs}ms — it may have crashed or the binary path is wrong`)), timeoutMs)),
+        ]);
+    }
+    /**
+     * Send a JSON-RPC request and await the response.
+     *
+     * @param method - JSON-RPC method name (e.g. "memory.add", "thought.startChain").
+     * @param params - Request parameters object.
+     * @param timeoutMs - Request timeout in milliseconds (default 30 000).
+     * @returns The `result` field of the JSON-RPC response.
+     */
+    async call(method, params, timeoutMs = 30_000) {
+        await this.waitForReady();
+        const id = this.nextId++;
+        const request = {
+            jsonrpc: "2.0",
+            id,
+            method,
+            params: params ?? {},
+        };
+        const body = JSON.stringify(request) + "\n";
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`JSON-RPC timeout: ${method} after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.pending.set(id, { resolve, reject, timer });
+            this.process.stdin.write(body, (err) => {
+                if (err) {
+                    clearTimeout(timer);
+                    this.pending.delete(id);
+                    reject(new Error(`Failed to write JSON-RPC request: ${err.message}`));
+                }
+            });
+        });
+    }
+    /** Shutdown the backend process gracefully. */
+    async shutdown() {
+        try {
+            await this.call("shutdown", {});
+        }
+        catch {
+            // Ignore errors during shutdown — the process may already be exiting.
+        }
+        this.process.kill();
+    }
+    /**
+     * Handle a single line from the Go backend's stdout.
+     *
+     * The first valid JSON line marks the backend as ready.
+     * Subsequent lines are routed to their pending calls by `id`.
+     */
+    handleLine(line) {
+        // On first line, mark ready (the backend has finished initialisation).
+        if (!this.ready) {
+            this.ready = true;
+            this.readyResolve();
+        }
+        let response;
+        try {
+            response = JSON.parse(line);
+        }
+        catch {
+            // Skip malformed / non-JSON lines (e.g. debug output).
+            return;
+        }
+        // Ignore notifications (no id).
+        if (response.id == null)
+            return;
+        const id = response.id;
+        const pending = this.pending.get(id);
+        if (!pending)
+            return;
+        this.pending.delete(id);
+        clearTimeout(pending.timer);
+        if (response.error != null) {
+            const err = response.error;
+            pending.reject(new Error(`JSON-RPC error ${err.code ?? "unknown"}: ${err.message ?? "unknown error"}`));
+        }
+        else {
+            pending.resolve(response.result);
+        }
+    }
+    /** Handle stdout close — reject all pending calls. */
+    handleClose() {
+        this.rejectAll(new Error("Go backend stdout closed"));
+    }
+    /** Reject every pending call with the same error. */
+    rejectAll(reason) {
+        for (const [id, pending] of this.pending.entries()) {
+            clearTimeout(pending.timer);
+            pending.reject(reason);
+            this.pending.delete(id);
+        }
+    }
+}
+//# sourceMappingURL=go-backend-client.js.map

package/dist/neuralgentics/go-backend-client.js.map

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

package/dist/neuralgentics/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Neuralgentics overlay — public API surface.
+ *
+ * Re-exports every module so consumers can import from a single entry point:
+ *
+ * ```ts
+ * import { NeuralgenticsOrchestrator, GoBackendClient, ROUTING_MATRIX } from "./neuralgentics";
+ * ```
+ */
+export { NeuralgenticsOrchestrator } from "./orchestrator.js";
+export { MemoryClient } from "./memory-client.js";
+export { GoBackendClient } from "./go-backend-client.js";
+export { ROUTING_MATRIX, validateAgentRouting, getPrimaryAgent } from "./routing.js";
+export { StatelessProtocol } from "./stateless.js";
+export { NeuralgenticsUpdater } from "./updater.js";
+export type { AgentDefinition, RoutingRule, ContextPackage, MemoryRecord, ServerCatalogEntry, ToolMatch, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/neuralgentics/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,YAAY,EACV,eAAe,EACf,WAAW,EACX,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/neuralgentics/index.js

@@ -0,0 +1,16 @@
+/**
+ * Neuralgentics overlay — public API surface.
+ *
+ * Re-exports every module so consumers can import from a single entry point:
+ *
+ * ```ts
+ * import { NeuralgenticsOrchestrator, GoBackendClient, ROUTING_MATRIX } from "./neuralgentics";
+ * ```
+ */
+export { NeuralgenticsOrchestrator } from "./orchestrator.js";
+export { MemoryClient } from "./memory-client.js";
+export { GoBackendClient } from "./go-backend-client.js";
+export { ROUTING_MATRIX, validateAgentRouting, getPrimaryAgent } from "./routing.js";
+export { StatelessProtocol } from "./stateless.js";
+export { NeuralgenticsUpdater } from "./updater.js";
+//# sourceMappingURL=index.js.map

package/dist/neuralgentics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/neuralgentics/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}

package/dist/neuralgentics/memory-client.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Neuralgentics Memory Client — thin wrapper over GoBackendClient.
+ *
+ * Routes all memory and thought-chain operations through the Go backend
+ * via JSON-RPC over stdio (child process).  This replaces the previous
+ * HTTP transport to the Python memini-core server, achieving sub-millisecond
+ * latency on the same machine with zero port management.
+ *
+ * The underlying `GoBackendClient` spawns the `neuralgentics-backend` binary
+ * and communicates via newline-delimited JSON-RPC 2.0.
+ */
+import type { MemoryRecord } from "./types.js";
+import { GoBackendClient } from "./go-backend-client.js";
+/**
+ * High-level client for Neuralgentics memory operations.
+ *
+ * Delegates to a `GoBackendClient` instance that talks to the Go backend
+ * over stdio.  Consumers can supply their own `GoBackendClient` instance
+ * (useful for testing with a mock) or let this class create one
+ * automatically.
+ */
+export declare class MemoryClient {
+    private backend;
+    /**
+     * Create a new MemoryClient.
+     *
+     * @param backendOrPath - One of:
+     *   - A `GoBackendClient` instance (typically a mock in tests).
+     *   - A string path to the `neuralgentics-backend` binary.
+     *   - `undefined` to auto-resolve from `NEURALGENTICS_BACKEND_PATH` env
+     *     or fall back to `"neuralgentics-backend"` (looked up on $PATH).
+     */
+    constructor(backendOrPath?: GoBackendClient | string);
+    /**
+     * Store a new memory entry via the Go backend.
+     *
+     * @param content - The memory text to store.
+     * @param metadata - Optional key-value metadata attached to the memory.
+     * @returns The ID of the newly created memory record.
+     */
+    addMemory(content: string, metadata?: Record<string, unknown>): Promise<string>;
+    /**
+     * Query memories via semantic search through the Go backend.
+     *
+     * @param query - Natural-language search string.
+     * @param limit - Maximum number of results to return (default 10).
+     * @returns An array of matching memory records.
+     */
+    queryMemories(query: string, limit?: number): Promise<MemoryRecord[]>;
+    /**
+     * Add a thought to an existing (or new) thought chain.
+     *
+     * @param thought - The thought text.
+     * @param thoughtNumber - 1-based index of this thought within the chain.
+     * @param totalThoughts - Expected total number of thoughts.
+     * @param nextThoughtNeeded - Whether more thoughts follow after this one.
+     * @param chainId - Existing chain UUID to continue, or undefined to auto-create.
+     * @returns The chain ID (useful when auto-creating).
+     */
+    addThought(thought: string, thoughtNumber: number, totalThoughts: number, nextThoughtNeeded: boolean, chainId?: string): Promise<string>;
+    /**
+     * Start a new thought chain and return its UUID.
+     *
+     * @returns The UUID of the newly created thought chain.
+     */
+    startThoughtChain(): Promise<string>;
+}
+//# sourceMappingURL=memory-client.d.ts.map

package/dist/neuralgentics/memory-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-client.d.ts","sourceRoot":"","sources":["../../src/neuralgentics/memory-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAUzD;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAkB;IAEjC;;;;;;;;OAQG;gBACS,aAAa,CAAC,EAAE,eAAe,GAAG,MAAM;IAapD;;;;;;OAMG;IACG,SAAS,CACb,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,MAAM,CAAC;IAQlB;;;;;;OAMG;IACG,aAAa,CACjB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC;IAU1B;;;;;;;;;OASG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,OAAO,EAC1B,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC;IAkBlB;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;CAM3C"}

package/dist/neuralgentics/memory-client.js

@@ -0,0 +1,111 @@
+/**
+ * Neuralgentics Memory Client — thin wrapper over GoBackendClient.
+ *
+ * Routes all memory and thought-chain operations through the Go backend
+ * via JSON-RPC over stdio (child process).  This replaces the previous
+ * HTTP transport to the Python memini-core server, achieving sub-millisecond
+ * latency on the same machine with zero port management.
+ *
+ * The underlying `GoBackendClient` spawns the `neuralgentics-backend` binary
+ * and communicates via newline-delimited JSON-RPC 2.0.
+ */
+import { GoBackendClient } from "./go-backend-client.js";
+/** Resolve the Go backend binary path from env var or fallback. */
+function resolveBinaryPath() {
+    if (process.env.NEURALGENTICS_BACKEND_PATH) {
+        return process.env.NEURALGENTICS_BACKEND_PATH;
+    }
+    return "neuralgentics-backend";
+}
+/**
+ * High-level client for Neuralgentics memory operations.
+ *
+ * Delegates to a `GoBackendClient` instance that talks to the Go backend
+ * over stdio.  Consumers can supply their own `GoBackendClient` instance
+ * (useful for testing with a mock) or let this class create one
+ * automatically.
+ */
+export class MemoryClient {
+    backend;
+    /**
+     * Create a new MemoryClient.
+     *
+     * @param backendOrPath - One of:
+     *   - A `GoBackendClient` instance (typically a mock in tests).
+     *   - A string path to the `neuralgentics-backend` binary.
+     *   - `undefined` to auto-resolve from `NEURALGENTICS_BACKEND_PATH` env
+     *     or fall back to `"neuralgentics-backend"` (looked up on $PATH).
+     */
+    constructor(backendOrPath) {
+        if (backendOrPath instanceof GoBackendClient) {
+            this.backend = backendOrPath;
+        }
+        else {
+            const path = backendOrPath ?? resolveBinaryPath();
+            this.backend = new GoBackendClient(path);
+        }
+    }
+    // ---------------------------------------------------------------
+    // Memory operations
+    // ---------------------------------------------------------------
+    /**
+     * Store a new memory entry via the Go backend.
+     *
+     * @param content - The memory text to store.
+     * @param metadata - Optional key-value metadata attached to the memory.
+     * @returns The ID of the newly created memory record.
+     */
+    async addMemory(content, metadata) {
+        const result = (await this.backend.call("memory.add", {
+            content,
+            metadata,
+        }));
+        return result.id;
+    }
+    /**
+     * Query memories via semantic search through the Go backend.
+     *
+     * @param query - Natural-language search string.
+     * @param limit - Maximum number of results to return (default 10).
+     * @returns An array of matching memory records.
+     */
+    async queryMemories(query, limit = 10) {
+        return this.backend.call("memory.query", { query, limit });
+    }
+    // ---------------------------------------------------------------
+    // Thought-chain operations
+    // ---------------------------------------------------------------
+    /**
+     * Add a thought to an existing (or new) thought chain.
+     *
+     * @param thought - The thought text.
+     * @param thoughtNumber - 1-based index of this thought within the chain.
+     * @param totalThoughts - Expected total number of thoughts.
+     * @param nextThoughtNeeded - Whether more thoughts follow after this one.
+     * @param chainId - Existing chain UUID to continue, or undefined to auto-create.
+     * @returns The chain ID (useful when auto-creating).
+     */
+    async addThought(thought, thoughtNumber, totalThoughts, nextThoughtNeeded, chainId) {
+        const params = {
+            thought,
+            thoughtNumber,
+            totalThoughts,
+            nextThoughtNeeded,
+        };
+        if (chainId !== undefined) {
+            params.chainId = chainId;
+        }
+        const result = (await this.backend.call("thought.add", params));
+        return result.chainId;
+    }
+    /**
+     * Start a new thought chain and return its UUID.
+     *
+     * @returns The UUID of the newly created thought chain.
+     */
+    async startThoughtChain() {
+        const result = (await this.backend.call("thought.startChain", {}));
+        return result.chainId;
+    }
+}
+//# sourceMappingURL=memory-client.js.map

package/dist/neuralgentics/memory-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-client.js","sourceRoot":"","sources":["../../src/neuralgentics/memory-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,mEAAmE;AACnE,SAAS,iBAAiB;IACxB,IAAI,OAAO,CAAC,GAAG,CAAC,0BAA0B,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;IAChD,CAAC;IACD,OAAO,uBAAuB,CAAC;AACjC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,YAAY;IACf,OAAO,CAAkB;IAEjC;;;;;;;;OAQG;IACH,YAAY,aAAwC;QAClD,IAAI,aAAa,YAAY,eAAe,EAAE,CAAC;YAC7C,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,GAAG,aAAa,IAAI,iBAAiB,EAAE,CAAC;YAClD,IAAI,CAAC,OAAO,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,oBAAoB;IACpB,kEAAkE;IAElE;;;;;;OAMG;IACH,KAAK,CAAC,SAAS,CACb,OAAe,EACf,QAAkC;QAElC,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE;YACpD,OAAO;YACP,QAAQ;SACT,CAAC,CAAmB,CAAC;QACtB,OAAO,MAAM,CAAC,EAAE,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,aAAa,CACjB,KAAa,EACb,QAAgB,EAAE;QAElB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAExD,CAAC;IACJ,CAAC;IAED,kEAAkE;IAClE,2BAA2B;IAC3B,kEAAkE;IAElE;;;;;;;;;OASG;IACH,KAAK,CAAC,UAAU,CACd,OAAe,EACf,aAAqB,EACrB,aAAqB,EACrB,iBAA0B,EAC1B,OAAgB;QAEhB,MAAM,MAAM,GAA4B;YACtC,OAAO;YACP,aAAa;YACb,aAAa;YACb,iBAAiB;SAClB,CAAC;QACF,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QAC3B,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CACrC,aAAa,EACb,MAAM,CACP,CAAwB,CAAC;QAC1B,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB;QACrB,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAEhE,CAAC;QACF,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;CACF"}

package/dist/neuralgentics/orchestrator.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Neuralgentics Orchestrator — main hook into OpenCode's agent lifecycle.
+ *
+ * The orchestrator injects identity strings into system prompts, validates
+ * routing decisions against the mandatory matrix, and exposes the list of
+ * available Neuralgentics agents.
+ *
+ * The orchestrator now communicates with the Go backend via JSON-RPC over
+ * stdio (GoBackendClient), replacing the previous HTTP transport to the
+ * Python memini-core server.
+ */
+import type { AgentDefinition } from "./types.js";
+import { GoBackendClient } from "./go-backend-client.js";
+/**
+ * The main orchestrator class for Neuralgentics within OpenCode.
+ *
+ * Provides three core hooks:
+ * 1. **injectSystemPrompt** — appends Neuralgentics identity to agent prompts.
+ * 2. **validateRouting** — enforces the mandatory routing matrix.
+ * 3. **getAgentList** — returns the full roster of Neuralgentics agents.
+ */
+export declare class NeuralgenticsOrchestrator {
+    private routing;
+    private stateless;
+    private memoryClient;
+    /**
+     * Create a new NeuralgenticsOrchestrator.
+     *
+     * @param backend - One of:
+     *   - A `GoBackendClient` instance (useful for testing with a mock).
+     *   - A string path to the `neuralgentics-backend` binary.
+     *   - `undefined` to auto-resolve from env / $PATH.
+     */
+    constructor(backend?: GoBackendClient | string);
+    /**
+     * Inject the Neuralgentics identity string into an agent's system prompt.
+     *
+     * The identity string is appended to the existing system prompt array.
+     *
+     * @param system - The mutable system prompt array to modify in-place.
+     * @param _agent - The agent configuration (reserved for future use).
+     * @param _session - The active session object (reserved for future use).
+     */
+    injectSystemPrompt(system: string[], _agent: unknown, _session?: unknown): void;
+    /**
+     * Validate that a proposed agent assignment conforms to the routing matrix.
+     *
+     * @param params - Object containing the subagent type and optional parent/tasks.
+     * @returns An error string if routing is violated, or `undefined` if valid.
+     */
+    validateRouting(params: {
+        subagentType: string;
+        parentAgent?: string;
+        tasks?: unknown[];
+    }): string | void;
+    /**
+     * Return the full list of Neuralgentics agent definitions.
+     *
+     * @returns An array of AgentDefinition objects.
+     */
+    getAgentList(): AgentDefinition[];
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/neuralgentics/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/neuralgentics/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,YAAY,CAAC;AAG/D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AA0EzD;;;;;;;GAOG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,YAAY,CAAe;IAEnC;;;;;;;OAOG;gBACS,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM;IAM9C;;;;;;;;OAQG;IACH,kBAAkB,CAChB,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,EAAE,OAAO,EACf,QAAQ,CAAC,EAAE,OAAO,GACjB,IAAI;IAIP;;;;;OAKG;IACH,eAAe,CAAC,MAAM,EAAE;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;KACnB,GAAG,MAAM,GAAG,IAAI;IAuBjB;;;;OAIG;IACH,YAAY,IAAI,eAAe,EAAE;CAGlC"}