@olane/os 0.8.15 → 0.8.17

package/dist/src/mcp/os-mcp-server.js

@@ -0,0 +1,244 @@
+/**
+ * OS-level MCP tool definitions.
+ *
+ * These are meant to be registered on an MCP server by the CLI layer.
+ * Each handler receives an OlaneOS instance and returns structured results.
+ */
+import { listOS } from '../lifecycle/os-lifecycle.js';
+import { AddressFactory } from '../address/address-factory.js';
+import { oAddress } from '@olane/o-core';
+function textResult(text) {
+    return { content: [{ type: 'text', text }] };
+}
+export const OS_MCP_TOOLS = [
+    // ── Lifecycle ──────────────────────────────────────────────
+    {
+        name: 'os_status',
+        description: 'List all OS instances and their status',
+        inputSchema: { type: 'object', properties: {} },
+        handler: async () => {
+            const instances = await listOS();
+            return textResult(JSON.stringify(instances, null, 2));
+        },
+    },
+    // ── Address ────────────────────────────────────────────────
+    {
+        name: 'address_create',
+        description: 'Create a new o:// address',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Address name' },
+            },
+            required: ['name'],
+        },
+        handler: async (params) => {
+            const address = AddressFactory.createAddress(params.name);
+            return textResult(JSON.stringify({ address: address.value, created: true }));
+        },
+    },
+    {
+        name: 'address_list',
+        description: 'List all addresses in the address book',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                type: {
+                    type: 'string',
+                    enum: ['internal', 'external'],
+                    description: 'Filter by type',
+                },
+            },
+        },
+        handler: async (params, ctx) => {
+            if (!ctx.addressBook)
+                return textResult('Address book not initialized');
+            const entries = ctx.addressBook.list(params.type);
+            return textResult(JSON.stringify(entries, null, 2));
+        },
+    },
+    // ── Contacts ───────────────────────────────────────────────
+    {
+        name: 'contacts_add',
+        description: 'Add an address to the address book',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                address: { type: 'string', description: 'o:// address' },
+                alias: { type: 'string', description: 'Human-friendly alias' },
+                type: {
+                    type: 'string',
+                    enum: ['internal', 'external'],
+                    default: 'external',
+                },
+            },
+            required: ['address'],
+        },
+        handler: async (params, ctx) => {
+            if (!ctx.addressBook)
+                return textResult('Address book not initialized');
+            await ctx.addressBook.add({
+                address: params.address,
+                type: params.type || 'external',
+                alias: params.alias,
+            });
+            return textResult(JSON.stringify({ added: true, address: params.address }));
+        },
+    },
+    {
+        name: 'contacts_list',
+        description: 'List all contacts in the address book',
+        inputSchema: { type: 'object', properties: {} },
+        handler: async (_params, ctx) => {
+            if (!ctx.addressBook)
+                return textResult('Address book not initialized');
+            return textResult(JSON.stringify(ctx.addressBook.list(), null, 2));
+        },
+    },
+    {
+        name: 'contacts_remove',
+        description: 'Remove an address from the address book',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                address: { type: 'string', description: 'o:// address to remove' },
+            },
+            required: ['address'],
+        },
+        handler: async (params, ctx) => {
+            if (!ctx.addressBook)
+                return textResult('Address book not initialized');
+            const removed = await ctx.addressBook.remove(params.address);
+            return textResult(JSON.stringify({ removed }));
+        },
+    },
+    // ── Worlds ─────────────────────────────────────────────────
+    {
+        name: 'world_create',
+        description: 'Create a new world (branded network)',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'World name' },
+                description: { type: 'string' },
+                icon: { type: 'string' },
+                supportedTypes: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Supported types (default: filepath)',
+                },
+            },
+            required: ['name'],
+        },
+        handler: async (params, ctx) => {
+            if (!ctx.worldManager)
+                return textResult('World manager not initialized');
+            const result = await ctx.worldManager.createWorld(params);
+            return textResult(JSON.stringify(result, null, 2));
+        },
+    },
+    {
+        name: 'world_list',
+        description: 'List all worlds',
+        inputSchema: { type: 'object', properties: {} },
+        handler: async (_params, ctx) => {
+            if (!ctx.worldManager)
+                return textResult('World manager not initialized');
+            return textResult(JSON.stringify(ctx.worldManager.listWorlds(), null, 2));
+        },
+    },
+    {
+        name: 'world_join',
+        description: 'Join a world by adding your Copass ID',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'World ID' },
+                copassId: { type: 'string', description: 'Your Copass ID' },
+            },
+            required: ['id', 'copassId'],
+        },
+        handler: async (params, ctx) => {
+            if (!ctx.worldManager)
+                return textResult('World manager not initialized');
+            const result = await ctx.worldManager.joinWorld(params.id, params.copassId);
+            return textResult(JSON.stringify(result));
+        },
+    },
+    // ── Memory ─────────────────────────────────────────────────
+    {
+        name: 'memory_remember',
+        description: 'Ingest a memory into the Copass backend for later retrieval',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                key: { type: 'string', description: 'Memory key / entity hint' },
+                value: { type: 'string', description: 'Text value to remember' },
+            },
+            required: ['key', 'value'],
+        },
+        handler: async (params, ctx) => {
+            if (!ctx.memory)
+                return textResult('Memory harness not initialized');
+            const result = await ctx.memory.remember(params.key, params.value);
+            return textResult(JSON.stringify(result));
+        },
+    },
+    {
+        name: 'memory_recall',
+        description: 'Query the Copass backend to recall memories',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Question or topic to recall' },
+            },
+            required: ['query'],
+        },
+        handler: async (params, ctx) => {
+            if (!ctx.memory)
+                return textResult('Memory harness not initialized');
+            const result = await ctx.memory.recall(params.query);
+            return textResult(JSON.stringify(result));
+        },
+    },
+    {
+        name: 'memory_search',
+        description: 'Fast context search across OS memories via Copass',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Search query' },
+            },
+            required: ['query'],
+        },
+        handler: async (params, ctx) => {
+            if (!ctx.memory)
+                return textResult('Memory harness not initialized');
+            const result = await ctx.memory.search(params.query);
+            return textResult(JSON.stringify(result));
+        },
+    },
+    // ── Generic use ────────────────────────────────────────────
+    {
+        name: 'os_use',
+        description: 'Invoke a method on any o:// address in the OS',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                address: { type: 'string', description: 'o:// address' },
+                method: { type: 'string', description: 'Method name' },
+                params: { type: 'object', description: 'Method parameters' },
+            },
+            required: ['address', 'method'],
+        },
+        handler: async (params, ctx) => {
+            if (!ctx.os)
+                return textResult('OS not running');
+            const result = await ctx.os.use(new oAddress(params.address), {
+                method: params.method,
+                params: params.params || {},
+            });
+            return textResult(JSON.stringify(result, null, 2));
+        },
+    },
+];

package/dist/src/memory/memory-harness.d.ts

@@ -0,0 +1,38 @@
+/**
+ * MemoryHarness — stores and retrieves OS memory via the Copass backend.
+ *
+ * - `remember(key, value)` → `olane ingest text` with key as entity hint
+ * - `recall(query)` → `olane copass question` scoped to memory context
+ * - Session memory remains in-process (ephemeral Map)
+ */
+export declare class MemoryHarness {
+    private session;
+    /**
+     * Ingest a memory into the Copass backend via `olane ingest text`.
+     */
+    remember(key: string, value: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Recall memory via `olane copass question`.
+     */
+    recall(query: string): Promise<{
+        success: boolean;
+        answer?: string;
+        error?: string;
+    }>;
+    /**
+     * Search memory via `olane copass context` (fast path search).
+     */
+    search(query: string): Promise<{
+        success: boolean;
+        context?: string;
+        error?: string;
+    }>;
+    sessionSet(key: string, value: unknown): void;
+    sessionGet(key: string): unknown | undefined;
+    sessionDelete(key: string): boolean;
+    sessionClear(): void;
+}
+//# sourceMappingURL=memory-harness.d.ts.map

package/dist/src/memory/memory-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-harness.d.ts","sourceRoot":"","sources":["../../../src/memory/memory-harness.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAmC;IAElD;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAYzF;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAa3F;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAe5F,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAI7C,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI5C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAInC,YAAY,IAAI,IAAI;CAGrB"}

package/dist/src/memory/memory-harness.js

@@ -0,0 +1,100 @@
+import { spawn } from 'node:child_process';
+/**
+ * MemoryHarness — stores and retrieves OS memory via the Copass backend.
+ *
+ * - `remember(key, value)` → `olane ingest text` with key as entity hint
+ * - `recall(query)` → `olane copass question` scoped to memory context
+ * - Session memory remains in-process (ephemeral Map)
+ */
+export class MemoryHarness {
+    constructor() {
+        this.session = new Map();
+    }
+    /**
+     * Ingest a memory into the Copass backend via `olane ingest text`.
+     */
+    async remember(key, value) {
+        try {
+            await execCli(['ingest', 'text', '--source-type', 'os-memory', '--entity-hints', key, '--additional-context', `OS memory key: ${key}`], `[Memory: ${key}] ${value}`);
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: String(err) };
+        }
+    }
+    /**
+     * Recall memory via `olane copass question`.
+     */
+    async recall(query) {
+        try {
+            const result = await execCli([
+                'copass', 'question', query,
+                '--detail-level', 'concise',
+                '--json',
+            ]);
+            return { success: true, answer: result };
+        }
+        catch (err) {
+            return { success: false, error: String(err) };
+        }
+    }
+    /**
+     * Search memory via `olane copass context` (fast path search).
+     */
+    async search(query) {
+        try {
+            const result = await execCli([
+                'copass', 'context', query,
+                '--detail-level', 'concise',
+                '--json',
+            ]);
+            return { success: true, context: result };
+        }
+        catch (err) {
+            return { success: false, error: String(err) };
+        }
+    }
+    // ── Session memory (ephemeral, in-process) ────────────────────
+    sessionSet(key, value) {
+        this.session.set(key, value);
+    }
+    sessionGet(key) {
+        return this.session.get(key);
+    }
+    sessionDelete(key) {
+        return this.session.delete(key);
+    }
+    sessionClear() {
+        this.session.clear();
+    }
+}
+function execCli(args, stdin) {
+    return new Promise((resolve, reject) => {
+        const child = spawn('olane', args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            env: {
+                ...process.env,
+                FORCE_COLOR: '0',
+                NODE_OPTIONS: (process.env.NODE_OPTIONS || '')
+                    .replace(/--inspect[^ ]*/g, '')
+                    .trim(),
+            },
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout.on('data', (d) => { stdout += d; });
+        child.stderr.on('data', (d) => { stderr += d; });
+        child.on('close', (code) => {
+            if (code !== 0) {
+                reject(new Error(stderr.trim() || `CLI exited with code ${code}`));
+            }
+            else {
+                resolve(stdout.trim());
+            }
+        });
+        if (stdin !== undefined) {
+            child.stdin.write(stdin);
+        }
+        child.stdin.end();
+    });
+}

package/dist/src/nodes/relay-node.d.ts

@@ -0,0 +1,31 @@
+import { oNodeConfig } from '@olane/o-node';
+import { oLaneTool } from '@olane/o-lane';
+import { oAddress } from '@olane/o-core';
+import type { ToolResult } from '@olane/o-tool';
+import { Libp2pConfig } from '@olane/o-config';
+export interface RelayNodeConfig extends oNodeConfig {
+    /** Override relay reservation limits. */
+    relay?: {
+        maxReservations?: number;
+        reservationClearInterval?: number;
+        defaultDurationLimit?: number;
+        defaultDataLimit?: bigint;
+    };
+}
+/**
+ * Local relay node — mirrors the private network relay tool
+ * (`o-private-network/nodes/relay/src/relay.tool.ts`) but runs
+ * on the local oLaneTool base instead of oPrivateNodeTool.
+ *
+ * Configures libp2p with circuit-relay-v2 server so other nodes
+ * can relay connections through this node.
+ */
+export declare class RelayNode extends oLaneTool {
+    private relayConfig;
+    constructor(config: RelayNodeConfig);
+    handleProtocol(address: oAddress): Promise<void>;
+    configure(): Promise<Libp2pConfig>;
+    initialize(): Promise<void>;
+    _tool_identify(): Promise<ToolResult>;
+}
+//# sourceMappingURL=relay-node.d.ts.map

package/dist/src/nodes/relay-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-node.d.ts","sourceRoot":"","sources":["../../../src/nodes/relay-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAY,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,EAGL,YAAY,EACb,MAAM,iBAAiB,CAAC;AAEzB,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,yCAAyC;IACzC,KAAK,CAAC,EAAE;QACN,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,wBAAwB,CAAC,EAAE,MAAM,CAAC;QAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED;;;;;;;GAOG;AACH,qBAAa,SAAU,SAAQ,SAAS;IACtC,OAAO,CAAC,WAAW,CAA2B;gBAElC,MAAM,EAAE,eAAe;IAiB7B,cAAc,CAAC,OAAO,EAAE,QAAQ;IAUhC,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;IAwClC,UAAU;IASV,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC;CAQ5C"}

package/dist/src/nodes/relay-node.js

@@ -0,0 +1,85 @@
+import { oLaneTool } from '@olane/o-lane';
+import { oAddress } from '@olane/o-core';
+import { circuitRelayServer } from '@libp2p/circuit-relay-v2';
+import { ping, identify, } from '@olane/o-config';
+/**
+ * Local relay node — mirrors the private network relay tool
+ * (`o-private-network/nodes/relay/src/relay.tool.ts`) but runs
+ * on the local oLaneTool base instead of oPrivateNodeTool.
+ *
+ * Configures libp2p with circuit-relay-v2 server so other nodes
+ * can relay connections through this node.
+ */
+export class RelayNode extends oLaneTool {
+    constructor(config) {
+        super({
+            ...config,
+            address: config.address || new oAddress('o://relay'),
+            description: 'Local relay node for the Olane OS',
+            methods: {
+                identify: {
+                    name: 'identify',
+                    description: 'Get relay identity and transport info',
+                    parameters: [],
+                    dependencies: [],
+                },
+            },
+        });
+        this.relayConfig = config.relay;
+    }
+    async handleProtocol(address) {
+        this.logger.debug('Handling protocol with limited connection: ' + address.protocol);
+        await this.p2pNode.handle(address.protocol, this.handleStream.bind(this), {
+            maxInboundStreams: Infinity,
+            maxOutboundStreams: Infinity,
+        });
+    }
+    async configure() {
+        const config = await super.configure();
+        config.services = {
+            identify: identify({
+                maxOutboundStreams: Infinity,
+                maxInboundStreams: Infinity,
+                runOnLimitedConnection: true,
+            }),
+            ping: ping({
+                maxOutboundStreams: Infinity,
+                maxInboundStreams: Infinity,
+                runOnLimitedConnection: true,
+            }),
+            relay: circuitRelayServer({
+                reservations: {
+                    maxReservations: this.relayConfig?.maxReservations ?? Infinity,
+                    reservationClearInterval: this.relayConfig?.reservationClearInterval ?? 60000 * 5,
+                    defaultDurationLimit: this.relayConfig?.defaultDurationLimit ?? 60000 * 15,
+                    defaultDataLimit: this.relayConfig?.defaultDataLimit ??
+                        BigInt(1024 * 1024 * 100000),
+                },
+            }),
+        };
+        // Filter out in-memory listeners
+        config.listeners = config.listeners?.filter((l) => l.indexOf('/memory/') === -1);
+        config.connectionManager = {
+            ...(config?.connectionManager || {}),
+            maxConnections: 500,
+            maxParallelDials: 100,
+            maxDialQueueLength: 100,
+            maxPeerAddrsToDial: 25,
+        };
+        return config;
+    }
+    async initialize() {
+        await super.initialize();
+        this.logger.debug(`Relay node initialized ${this.address.toString()}`);
+        this.logger.debug('Multiaddrs:', this.p2pNode.getMultiaddrs());
+        this.logger.debug('Protocols:', this.p2pNode.getProtocols());
+    }
+    async _tool_identify() {
+        return {
+            success: true,
+            address: this.address.toString(),
+            staticAddress: this.staticAddress?.toString(),
+            transports: this.transports.map((t) => t.toMultiaddr().toString()),
+        };
+    }
+}

package/dist/src/o-olane-os/interfaces/o-os.config.d.ts

@@ -5,6 +5,12 @@ export interface ApprovalPreferences {
     blacklist?: string[];
     timeout?: number;
 }
+export interface OSRelayNodeConfig {
+    /** Mark this node as a relay that forwards between local and remote leaders. */
+    relay: boolean;
+    /** The remote leader address this relay connects to. */
+    remoteLeaderAddress?: string;
+}
 export interface OlaneOSConfig {
     configFilePath?: string;
     network?: {
@@ -16,11 +22,19 @@ export interface OlaneOSConfig {
         networkId?: string;
         port?: number;
     };
-    nodes?: oNodeConfig[];
+    nodes?: (oNodeConfig & Partial<OSRelayNodeConfig>)[];
     lanes?: string[];
     noIndexNetwork?: boolean;
     inProgress?: string[];
     approvalMode?: ApprovalMode;
     approvalPreferences?: ApprovalPreferences;
+    /** Copass ID linked to this OS instance. */
+    copassId?: string;
+    /** World configurations managed by this OS. */
+    worlds?: WorldReference[];
+}
+export interface WorldReference {
+    id: string;
+    name: string;
 }
 //# sourceMappingURL=o-os.config.d.ts.map

package/dist/src/o-olane-os/interfaces/o-os.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-os.config.d.ts","sourceRoot":"","sources":["../../../../src/o-olane-os/interfaces/o-os.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C"}
+{"version":3,"file":"o-os.config.d.ts","sourceRoot":"","sources":["../../../../src/o-olane-os/interfaces/o-os.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,KAAK,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,CAAC,EAAE,CAAC,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC;IACrD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd"}

package/dist/src/o-olane-os/o-os.d.ts

@@ -4,6 +4,9 @@ import { oLeaderNode } from '@olane/o-leader';
 import { oAddress, oObject, oTransport } from '@olane/o-core';
 import { NodeType } from '@olane/o-core';
 import { oLaneTool } from '@olane/o-lane';
+import { WorldManagerTool } from '../worlds/world-manager.tool.js';
+import { AddressBook } from '../address-book/address-book.js';
+import { MemoryHarness } from '../memory/memory-harness.js';
 type OlaneOSNode = oLaneTool | oLeaderNode;
 export declare class OlaneOS extends oObject {
     private leaders;
@@ -12,6 +15,9 @@ export declare class OlaneOS extends oObject {
     status: OlaneOSSystemStatus;
     private config;
     private roundRobinIndex;
+    worldManager: WorldManagerTool | null;
+    addressBook: AddressBook | null;
+    memory: MemoryHarness | null;
     constructor(config: OlaneOSConfig);
     entryNode(): oLaneTool | oLeaderNode;
     addLeader(leader: oLeaderNode): void;
@@ -25,6 +31,22 @@ export declare class OlaneOS extends oObject {
     getOSInstanceName(): Promise<string | undefined>;
     startNodes(type: NodeType): Promise<void>;
     runSavedPlans(): Promise<void>;
+    /**
+     * Initialize world manager, address book, and memory harness
+     * after the leader and nodes are started.
+     */
+    private initOSServices;
+    /**
+     * Only index if `indexCompletedAt` is not set in the instance config.
+     * Records the timestamp after successful indexing.
+     */
+    private indexOnceInBackground;
+    /**
+     * Index all nodes in the network in parallel.
+     * Each node indexes itself + its children concurrently,
+     * rather than the default sequential tree walk.
+     */
+    private indexNetworkParallel;
     use(oAddress: oAddress, params: any): Promise<import("@olane/o-core").oResponse>;
     start(): Promise<{
         peerId: string;

package/dist/src/o-olane-os/o-os.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-os.d.ts","sourceRoot":"","sources":["../../../src/o-olane-os/o-os.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAK1C,KAAK,WAAW,GAAG,SAAS,GAAG,WAAW,CAAC;AAC3C,qBAAa,OAAQ,SAAQ,OAAO;IAClC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,KAAK,CAAqB;IAC3B,UAAU,EAAE,WAAW,GAAG,IAAI,CAAQ;IACtC,MAAM,EAAG,mBAAmB,CAAC;IACpC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,eAAe,CAAa;gBAExB,MAAM,EAAE,aAAa;IAKjC,SAAS,IAAI,SAAS,GAAG,WAAW;IAMpC,SAAS,CAAC,MAAM,EAAE,WAAW;IAOvB,OAAO,CAAC,IAAI,EAAE,WAAW;YAiBjB,UAAU;IAyCxB;;;OAGG;YACW,qBAAqB;IA2E7B,iBAAiB;IASjB,UAAU,CAAC,IAAI,EAAE,QAAQ;IAsDzB,aAAa;IAwEb,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG;IASnC,KAAK,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAuC9D,IAAI;IAwBJ,OAAO;CAKd"}
+{"version":3,"file":"o-os.d.ts","sourceRoot":"","sources":["../../../src/o-olane-os/o-os.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAK5D,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAI1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,KAAK,WAAW,GAAG,SAAS,GAAG,WAAW,CAAC;AAC3C,qBAAa,OAAQ,SAAQ,OAAO;IAClC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,KAAK,CAAqB;IAC3B,UAAU,EAAE,WAAW,GAAG,IAAI,CAAQ;IACtC,MAAM,EAAG,mBAAmB,CAAC;IACpC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,eAAe,CAAa;IAC7B,YAAY,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAC7C,WAAW,EAAE,WAAW,GAAG,IAAI,CAAQ;IACvC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAQ;gBAE/B,MAAM,EAAE,aAAa;IAKjC,SAAS,IAAI,SAAS,GAAG,WAAW;IAMpC,SAAS,CAAC,MAAM,EAAE,WAAW;IAOvB,OAAO,CAAC,IAAI,EAAE,WAAW;YAiBjB,UAAU;IA4CxB;;;OAGG;YACW,qBAAqB;IA2E7B,iBAAiB;IASjB,UAAU,CAAC,IAAI,EAAE,QAAQ;IAsDzB,aAAa;IAwEnB;;;OAGG;YACW,cAAc;IAyC5B;;;OAGG;YACW,qBAAqB;IAwBnC;;;;OAIG;YACW,oBAAoB;IA4B5B,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG;IASnC,KAAK,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IA0C9D,IAAI;IAwBJ,OAAO;CAKd"}