@gaia-ai/core 0.11.1 → 0.11.2

package/dist/src/conductor-registry/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * One registered conductor in the local machine registry
+ * (`${GAIA_HOME ?? ~}/.gaia/conductors.json`). The registry is inherently
+ * machine + user scoped: it lists the conductors this user can drive locally.
+ */
+export interface ConductorRegistryEntry {
+    id: string;
+    path: string;
+    project: string;
+    label: string;
+    host: 'herdr' | 'process' | 'systemd';
+    handle: string;
+}
+/** `${GAIA_HOME ?? ~}/.gaia/conductors.json`. */
+export declare function conductorRegistryPath(): string;
+/** All registered conductors, in insertion order. */
+export declare function listRegisteredConductors(): Promise<ConductorRegistryEntry[]>;
+/** One registered conductor by id, or `null` when absent. */
+export declare function getRegisteredConductor(id: string): Promise<ConductorRegistryEntry | null>;
+/** Insert or overwrite a conductor by id (idempotent). */
+export declare function registerConductor(entry: ConductorRegistryEntry): Promise<void>;
+/** Remove a conductor by id; a no-op when it is not present. */
+export declare function removeConductor(id: string): Promise<void>;

package/dist/src/conductor-registry/index.js

@@ -0,0 +1,59 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+/** `${GAIA_HOME ?? ~}/.gaia/conductors.json`. */
+export function conductorRegistryPath() {
+    const home = process.env.GAIA_HOME ?? homedir();
+    return join(home, '.gaia', 'conductors.json');
+}
+async function read() {
+    let raw;
+    try {
+        raw = await readFile(conductorRegistryPath(), 'utf8');
+    }
+    catch {
+        return {};
+    }
+    if (raw.trim() === '') {
+        return {};
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed === 'object' &&
+            parsed !== null &&
+            !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return {};
+    }
+    catch {
+        return {};
+    }
+}
+async function write(data) {
+    const path = conductorRegistryPath();
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
+}
+/** All registered conductors, in insertion order. */
+export async function listRegisteredConductors() {
+    return Object.values(await read());
+}
+/** One registered conductor by id, or `null` when absent. */
+export async function getRegisteredConductor(id) {
+    return (await read())[id] ?? null;
+}
+/** Insert or overwrite a conductor by id (idempotent). */
+export async function registerConductor(entry) {
+    const data = await read();
+    data[entry.id] = entry;
+    await write(data);
+}
+/** Remove a conductor by id; a no-op when it is not present. */
+export async function removeConductor(id) {
+    const data = await read();
+    if (data[id]) {
+        delete data[id];
+        await write(data);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gaia-ai/core",
-  "version": "0.11.1",
+  "version": "0.11.2",
   "description": "GAIA surface-agnostic kernel: host contract, split-config helpers, addon preset/discovery machinery, shared primitives.",
   "type": "module",
   "license": "MIT",