@olane/os 0.8.15 → 0.8.17

package/dist/src/address/address-factory.d.ts

@@ -0,0 +1,23 @@
+import { oNodeAddress } from '@olane/o-node';
+export interface AddressCreateOptions {
+    name: string;
+    description?: string;
+}
+/**
+ * Factory for creating and validating o:// addresses.
+ */
+export declare class AddressFactory {
+    /**
+     * Create a validated o:// address from a name.
+     */
+    static createAddress(name: string): oNodeAddress;
+    /**
+     * Generate a unique address with a random suffix.
+     */
+    static generateUniqueAddress(prefix: string): oNodeAddress;
+    /**
+     * Validate that a string is a well-formed o:// address.
+     */
+    static validate(value: string): boolean;
+}
+//# sourceMappingURL=address-factory.d.ts.map

package/dist/src/address/address-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-factory.d.ts","sourceRoot":"","sources":["../../../src/address/address-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAehD;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAM1D;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAQxC"}

package/dist/src/address/address-factory.js

@@ -0,0 +1,42 @@
+import { oAddress } from '@olane/o-core';
+import { oNodeAddress } from '@olane/o-node';
+/**
+ * Factory for creating and validating o:// addresses.
+ */
+export class AddressFactory {
+    /**
+     * Create a validated o:// address from a name.
+     */
+    static createAddress(name) {
+        // Normalize: strip surrounding quotes, then ensure o:// prefix
+        const cleaned = name.replace(/^['"]|['"]$/g, '').trim();
+        const value = cleaned.startsWith('o://') ? cleaned : `o://${cleaned}`;
+        // Use oAddress validation: must start with o:// and must not be nested
+        const addr = new oAddress(value);
+        if (!addr.validate()) {
+            throw new Error(`Invalid address '${value}': must use o:// protocol`);
+        }
+        addr.validateNotNested();
+        return new oNodeAddress(value);
+    }
+    /**
+     * Generate a unique address with a random suffix.
+     */
+    static generateUniqueAddress(prefix) {
+        const suffix = Math.random().toString(36).substring(2, 8);
+        const name = `${prefix}-${suffix}`;
+        return AddressFactory.createAddress(name);
+    }
+    /**
+     * Validate that a string is a well-formed o:// address.
+     */
+    static validate(value) {
+        try {
+            new oAddress(value.startsWith('o://') ? value : `o://${value}`);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}

package/dist/src/address-book/address-book.d.ts

@@ -0,0 +1,32 @@
+export type AddressBookEntryType = 'internal' | 'external';
+export interface AddressBookEntry {
+    address: string;
+    type: AddressBookEntryType;
+    alias?: string;
+    copassId?: string;
+    worldId?: string;
+    lastSeen?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AddressBookData {
+    version: string;
+    entries: AddressBookEntry[];
+}
+/**
+ * Persistent address book for tracking internal and external network addresses.
+ */
+export declare class AddressBook {
+    private storagePath;
+    private data;
+    constructor(instanceName: string, basePath?: string);
+    load(): Promise<void>;
+    private persist;
+    add(entry: AddressBookEntry): Promise<void>;
+    remove(address: string): Promise<boolean>;
+    get(address: string): AddressBookEntry | undefined;
+    list(type?: AddressBookEntryType): AddressBookEntry[];
+    findByAlias(alias: string): AddressBookEntry | undefined;
+    findByCopassId(copassId: string): AddressBookEntry | undefined;
+    findByWorld(worldId: string): AddressBookEntry[];
+}
+//# sourceMappingURL=address-book.d.ts.map

package/dist/src/address-book/address-book.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"address-book.d.ts","sourceRoot":"","sources":["../../../src/address-book/address-book.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,oBAAoB,GAAG,UAAU,GAAG,UAAU,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,oBAAoB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAID;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,IAAI,CAAmD;gBAEnD,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;IAK7C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAUb,OAAO;IAKf,GAAG,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3C,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU/C,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIlD,IAAI,CAAC,IAAI,CAAC,EAAE,oBAAoB,GAAG,gBAAgB,EAAE;IAOrD,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIxD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI9D,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,EAAE;CAGjD"}

package/dist/src/address-book/address-book.js

@@ -0,0 +1,65 @@
+import * as fs from 'fs-extra';
+import * as path from 'path';
+import { DEFAULT_INSTANCE_PATH } from '@olane/o-core';
+const EMPTY_BOOK = { version: '1.0', entries: [] };
+/**
+ * Persistent address book for tracking internal and external network addresses.
+ */
+export class AddressBook {
+    constructor(instanceName, basePath) {
+        this.data = { ...EMPTY_BOOK, entries: [] };
+        const base = basePath ?? path.join(DEFAULT_INSTANCE_PATH, '..', 'storage');
+        this.storagePath = path.join(base, instanceName, 'address-book.json');
+    }
+    async load() {
+        try {
+            if (await fs.pathExists(this.storagePath)) {
+                this.data = await fs.readJson(this.storagePath);
+            }
+        }
+        catch {
+            this.data = { ...EMPTY_BOOK, entries: [] };
+        }
+    }
+    async persist() {
+        await fs.ensureDir(path.dirname(this.storagePath));
+        await fs.writeJson(this.storagePath, this.data, { spaces: 2 });
+    }
+    async add(entry) {
+        const existing = this.data.entries.findIndex((e) => e.address === entry.address);
+        if (existing >= 0) {
+            this.data.entries[existing] = { ...this.data.entries[existing], ...entry };
+        }
+        else {
+            this.data.entries.push(entry);
+        }
+        await this.persist();
+    }
+    async remove(address) {
+        const before = this.data.entries.length;
+        this.data.entries = this.data.entries.filter((e) => e.address !== address);
+        if (this.data.entries.length < before) {
+            await this.persist();
+            return true;
+        }
+        return false;
+    }
+    get(address) {
+        return this.data.entries.find((e) => e.address === address);
+    }
+    list(type) {
+        if (type) {
+            return this.data.entries.filter((e) => e.type === type);
+        }
+        return [...this.data.entries];
+    }
+    findByAlias(alias) {
+        return this.data.entries.find((e) => e.alias === alias);
+    }
+    findByCopassId(copassId) {
+        return this.data.entries.find((e) => e.copassId === copassId);
+    }
+    findByWorld(worldId) {
+        return this.data.entries.filter((e) => e.worldId === worldId);
+    }
+}

package/dist/src/auth/os-auth-guard.d.ts

@@ -0,0 +1,20 @@
+import { oTokenManager } from '@olane/o-core';
+/**
+ * Auth guard for OS operations.
+ * Verifies a valid token exists before allowing network-facing operations.
+ */
+export declare class OSAuthGuard {
+    private tokenManager;
+    constructor(tokenManager?: oTokenManager);
+    /**
+     * Verify that a valid auth token exists.
+     * Throws if no token manager is configured or no valid token is found.
+     */
+    ensureAuth(): Promise<void>;
+    /**
+     * Check whether auth is available (non-throwing).
+     */
+    isAuthenticated(): Promise<boolean>;
+    setTokenManager(tokenManager: oTokenManager): void;
+}
+//# sourceMappingURL=os-auth-guard.d.ts.map

package/dist/src/auth/os-auth-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-auth-guard.d.ts","sourceRoot":"","sources":["../../../src/auth/os-auth-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAuB;gBAE/B,YAAY,CAAC,EAAE,aAAa;IAIxC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAUzC,eAAe,CAAC,YAAY,EAAE,aAAa,GAAG,IAAI;CAGnD"}

package/dist/src/auth/os-auth-guard.js

@@ -0,0 +1,39 @@
+/**
+ * Auth guard for OS operations.
+ * Verifies a valid token exists before allowing network-facing operations.
+ */
+export class OSAuthGuard {
+    constructor(tokenManager) {
+        this.tokenManager = tokenManager ?? null;
+    }
+    /**
+     * Verify that a valid auth token exists.
+     * Throws if no token manager is configured or no valid token is found.
+     */
+    async ensureAuth() {
+        if (!this.tokenManager) {
+            throw new Error('Authentication required: no token manager configured for this OS instance.');
+        }
+        const token = await this.tokenManager.getToken();
+        if (!token) {
+            throw new Error('Authentication required: no valid token found. Please log in first.');
+        }
+    }
+    /**
+     * Check whether auth is available (non-throwing).
+     */
+    async isAuthenticated() {
+        if (!this.tokenManager)
+            return false;
+        try {
+            const token = await this.tokenManager.getToken();
+            return !!token;
+        }
+        catch {
+            return false;
+        }
+    }
+    setTokenManager(tokenManager) {
+        this.tokenManager = tokenManager;
+    }
+}

package/dist/src/identity/copass-id.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Copass ID validation and resolution.
+ *
+ * Copass IDs are human-readable identifiers linked to o:// addresses.
+ * Validation rules: 3-30 chars, lowercase alphanumeric + hyphens/underscores,
+ * no consecutive special chars, must start/end with alphanumeric.
+ */
+export interface CopassIdValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export declare function validateCopassId(id: string): CopassIdValidationResult;
+/**
+ * Link a Copass ID to an address in the address book.
+ * This is a convenience wrapper — the actual storage is in the AddressBook.
+ */
+export interface CopassIdMapping {
+    copassId: string;
+    address: string;
+    linkedAt: string;
+}
+export declare function createCopassIdMapping(copassId: string, address: string): CopassIdMapping;
+//# sourceMappingURL=copass-id.d.ts.map

package/dist/src/identity/copass-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copass-id.d.ts","sourceRoot":"","sources":["../../../src/identity/copass-id.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,wBAAwB,CAmBrE;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,eAAe,CAYjB"}

package/dist/src/identity/copass-id.js

@@ -0,0 +1,37 @@
+/**
+ * Copass ID validation and resolution.
+ *
+ * Copass IDs are human-readable identifiers linked to o:// addresses.
+ * Validation rules: 3-30 chars, lowercase alphanumeric + hyphens/underscores,
+ * no consecutive special chars, must start/end with alphanumeric.
+ */
+const COPASS_ID_REGEX = /^[a-z0-9]([a-z0-9_-]*[a-z0-9])?$/;
+const MIN_LENGTH = 3;
+const MAX_LENGTH = 30;
+export function validateCopassId(id) {
+    const errors = [];
+    if (id.length < MIN_LENGTH) {
+        errors.push(`Must be at least ${MIN_LENGTH} characters`);
+    }
+    if (id.length > MAX_LENGTH) {
+        errors.push(`Must be at most ${MAX_LENGTH} characters`);
+    }
+    if (!COPASS_ID_REGEX.test(id)) {
+        errors.push('Must be lowercase alphanumeric with hyphens/underscores, starting and ending with alphanumeric');
+    }
+    if (/[-_]{2,}/.test(id)) {
+        errors.push('Cannot contain consecutive special characters');
+    }
+    return { valid: errors.length === 0, errors };
+}
+export function createCopassIdMapping(copassId, address) {
+    const validation = validateCopassId(copassId);
+    if (!validation.valid) {
+        throw new Error(`Invalid Copass ID '${copassId}': ${validation.errors.join(', ')}`);
+    }
+    return {
+        copassId,
+        address,
+        linkedAt: new Date().toISOString(),
+    };
+}

package/dist/src/index.d.ts

@@ -1,3 +1,15 @@
 export * from './o-olane-os/index.js';
 export * from './utils/config.js';
+export * from './address/address-factory.js';
+export * from './address-book/address-book.js';
+export * from './memory/memory-harness.js';
+export * from './lifecycle/os-lifecycle.js';
+export * from './worlds/world.types.js';
+export * from './worlds/world-instance.tool.js';
+export * from './worlds/world-manager.tool.js';
+export * from './nodes/relay-node.js';
+export * from './vector-store/copass-vector-store.tool.js';
+export * from './tools/filesystem.tool.js';
+export * from './identity/copass-id.js';
+export * from './mcp/os-mcp-server.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4CAA4C,CAAC;AAC3D,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC"}

package/dist/src/index.js

@@ -1,2 +1,14 @@
 export * from './o-olane-os/index.js';
 export * from './utils/config.js';
+export * from './address/address-factory.js';
+export * from './address-book/address-book.js';
+export * from './memory/memory-harness.js';
+export * from './lifecycle/os-lifecycle.js';
+export * from './worlds/world.types.js';
+export * from './worlds/world-instance.tool.js';
+export * from './worlds/world-manager.tool.js';
+export * from './nodes/relay-node.js';
+export * from './vector-store/copass-vector-store.tool.js';
+export * from './tools/filesystem.tool.js';
+export * from './identity/copass-id.js';
+export * from './mcp/os-mcp-server.js';

package/dist/src/lifecycle/os-lifecycle.d.ts

@@ -0,0 +1,36 @@
+import { OlaneOS } from '../o-olane-os/o-os.js';
+import { OlaneOSConfig } from '../o-olane-os/interfaces/o-os.config.js';
+import { OlaneOSInstanceConfig } from '../utils/config.js';
+export interface OSStartResult {
+    peerId: string;
+    transports: string[];
+    instanceName: string;
+    pid: number;
+}
+/**
+ * Start an OlaneOS instance and persist its PID/state.
+ * If an instance with this name is already running, stops it first.
+ */
+export declare function startOS(instanceName: string, osConfig: OlaneOSConfig): Promise<{
+    os: OlaneOS;
+    result: OSStartResult;
+}>;
+/**
+ * Stop a running OS instance by name. Sends SIGTERM to its PID.
+ */
+export declare function stopOS(instanceName: string): Promise<boolean>;
+/**
+ * Check liveness of an OS instance by name.
+ */
+export declare function statusOS(instanceName: string): Promise<{
+    config: OlaneOSInstanceConfig;
+    alive: boolean;
+} | null>;
+/**
+ * List all instances with live PID checks.
+ */
+export declare function listOS(): Promise<Array<{
+    config: OlaneOSInstanceConfig;
+    alive: boolean;
+}>>;
+//# sourceMappingURL=os-lifecycle.d.ts.map

package/dist/src/lifecycle/os-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/lifecycle/os-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAExE,OAAO,EAAiB,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAC3B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,CAAC,CAqCjD;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBnE;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAC5B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,qBAAqB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CAoBnE;AAED;;GAEG;AACH,wBAAsB,MAAM,IAAI,OAAO,CACrC,KAAK,CAAC;IAAE,MAAM,EAAE,qBAAqB,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CACzD,CAMA"}

package/dist/src/lifecycle/os-lifecycle.js

@@ -0,0 +1,99 @@
+import { OlaneOS } from '../o-olane-os/o-os.js';
+import { OlaneOSSystemStatus } from '../o-olane-os/enum/o-os.status-enum.js';
+import { ConfigManager } from '../utils/config.js';
+/**
+ * Start an OlaneOS instance and persist its PID/state.
+ * If an instance with this name is already running, stops it first.
+ */
+export async function startOS(instanceName, osConfig) {
+    // Check for an existing running instance and clean up
+    const existing = await ConfigManager.getOSConfig(instanceName);
+    if (existing?.pid && isProcessAlive(existing.pid) && existing.pid !== process.pid) {
+        process.kill(existing.pid, 'SIGTERM');
+        await ConfigManager.updateOSConfig({
+            ...existing,
+            status: OlaneOSSystemStatus.STOPPED,
+            pid: undefined,
+        });
+    }
+    const os = new OlaneOS(osConfig);
+    const { peerId, transports } = await os.start();
+    const instanceConfig = {
+        name: instanceName,
+        version: osConfig.network?.version || '0.0.1',
+        description: osConfig.network?.description || '',
+        port: osConfig.network?.port || 0,
+        status: OlaneOSSystemStatus.RUNNING,
+        createdAt: new Date().toISOString(),
+        pid: process.pid,
+        peerId,
+        transports: transports.map((t) => String(t)),
+        oNetworkConfig: osConfig,
+    };
+    await ConfigManager.saveOSConfig(instanceConfig);
+    const result = {
+        peerId,
+        transports: instanceConfig.transports || [],
+        instanceName,
+        pid: process.pid,
+    };
+    return { os, result };
+}
+/**
+ * Stop a running OS instance by name. Sends SIGTERM to its PID.
+ */
+export async function stopOS(instanceName) {
+    const config = await ConfigManager.getOSConfig(instanceName);
+    if (!config) {
+        return false;
+    }
+    if (config.pid && isProcessAlive(config.pid)) {
+        process.kill(config.pid, 'SIGTERM');
+    }
+    await ConfigManager.updateOSConfig({
+        ...config,
+        status: OlaneOSSystemStatus.STOPPED,
+        pid: undefined,
+    });
+    return true;
+}
+/**
+ * Check liveness of an OS instance by name.
+ */
+export async function statusOS(instanceName) {
+    const config = await ConfigManager.getOSConfig(instanceName);
+    if (!config) {
+        return null;
+    }
+    const alive = config.pid ? isProcessAlive(config.pid) : false;
+    // Clean up stale status
+    if (!alive && config.status === OlaneOSSystemStatus.RUNNING) {
+        await ConfigManager.updateOSConfig({
+            ...config,
+            status: OlaneOSSystemStatus.STOPPED,
+            pid: undefined,
+        });
+        config.status = OlaneOSSystemStatus.STOPPED;
+        config.pid = undefined;
+    }
+    return { config, alive };
+}
+/**
+ * List all instances with live PID checks.
+ */
+export async function listOS() {
+    const instances = await ConfigManager.listOSInstances();
+    return instances.map((config) => ({
+        config,
+        alive: config.pid ? isProcessAlive(config.pid) : false,
+    }));
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/src/mcp/os-mcp-server.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 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 type { OlaneOS } from '../o-olane-os/o-os.js';
+import type { AddressBook } from '../address-book/address-book.js';
+import type { MemoryHarness } from '../memory/memory-harness.js';
+import type { WorldManagerTool } from '../worlds/world-manager.tool.js';
+export interface OSMcpContext {
+    os?: OlaneOS;
+    addressBook?: AddressBook;
+    memory?: MemoryHarness;
+    worldManager?: WorldManagerTool;
+}
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, any>;
+    handler: (params: any, ctx: OSMcpContext) => Promise<{
+        content: Array<{
+            type: string;
+            text: string;
+        }>;
+    }>;
+}
+export declare const OS_MCP_TOOLS: McpToolDefinition[];
+//# sourceMappingURL=os-mcp-server.d.ts.map

package/dist/src/mcp/os-mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-mcp-server.d.ts","sourceRoot":"","sources":["../../../src/mcp/os-mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAKxE,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,OAAO,EAAE,CACP,MAAM,EAAE,GAAG,EACX,GAAG,EAAE,YAAY,KACd,OAAO,CAAC;QAAE,OAAO,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CAClE;AAMD,eAAO,MAAM,YAAY,EAAE,iBAAiB,EAsO3C,CAAC"}