@olane/os 0.8.17 → 0.8.18

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

@@ -7,6 +7,7 @@ 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';
+import { FilesystemTool } from '../tools/filesystem.tool.js';
 type OlaneOSNode = oLaneTool | oLeaderNode;
 export declare class OlaneOS extends oObject {
     private leaders;
@@ -18,6 +19,7 @@ export declare class OlaneOS extends oObject {
     worldManager: WorldManagerTool | null;
     addressBook: AddressBook | null;
     memory: MemoryHarness | null;
+    filesystemTool: FilesystemTool | null;
     constructor(config: OlaneOSConfig);
     entryNode(): oLaneTool | oLeaderNode;
     addLeader(leader: oLeaderNode): void;

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;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"}
+{"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;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,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;IACpC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAQ;gBAExC,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;IAsD5B;;;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"}

package/dist/src/o-olane-os/o-os.js

@@ -16,6 +16,7 @@ import { WorldManagerTool } from '../worlds/world-manager.tool.js';
 import { AddressBook } from '../address-book/address-book.js';
 import { MemoryHarness } from '../memory/memory-harness.js';
 import { CopassVectorStoreTool } from '../vector-store/copass-vector-store.tool.js';
+import { FilesystemTool } from '../tools/filesystem.tool.js';
 export class OlaneOS extends oObject {
     constructor(config) {
         super();
@@ -26,6 +27,7 @@ export class OlaneOS extends oObject {
         this.worldManager = null;
         this.addressBook = null;
         this.memory = null;
+        this.filesystemTool = null;
         this.config = config;
     }
     entryNode() {
@@ -285,6 +287,16 @@ export class OlaneOS extends oObject {
             this.rootLeader.addChildNode(vectorStore);
             await vectorStore.start();
             this.logger.debug('Copass vector store started');
+            // Filesystem tool — single instance for the entire OS
+            this.filesystemTool = new FilesystemTool({
+                address: new oAddress('o://fs'),
+                leader: this.rootLeader.address,
+                parent: this.rootLeader.address,
+                _allowNestedAddress: true,
+            });
+            this.rootLeader.addChildNode(this.filesystemTool);
+            await this.filesystemTool.start();
+            this.logger.debug('Filesystem tool started');
             // World manager
             this.worldManager = new WorldManagerTool({
                 leader: this.rootLeader.address,

package/dist/src/tools/filesystem.tool.d.ts

@@ -3,8 +3,8 @@ import { oLaneTool } from '@olane/o-lane';
 import { oRequest } from '@olane/o-core';
 import type { ToolResult } from '@olane/o-tool';
 /**
- * FilesystemTool — an oLaneTool that provides scoped filesystem access
- * for a world. Each world gets its own FilesystemTool as a child node.
+ * FilesystemTool — an oLaneTool that provides scoped filesystem access.
+ * A single instance exists per OS at o://fs, shared across all worlds.
  *
  * The tool maintains a list of allowed directory paths (addresses).
  * All file operations are restricted to these directories.

package/dist/src/tools/filesystem.tool.js

@@ -2,8 +2,8 @@ import { oLaneTool } from '@olane/o-lane';
 import { readFile, readdir, stat, access } from 'fs/promises';
 import * as path from 'path';
 /**
- * FilesystemTool — an oLaneTool that provides scoped filesystem access
- * for a world. Each world gets its own FilesystemTool as a child node.
+ * FilesystemTool — an oLaneTool that provides scoped filesystem access.
+ * A single instance exists per OS at o://fs, shared across all worlds.
  *
  * The tool maintains a list of allowed directory paths (addresses).
  * All file operations are restricted to these directories.

package/dist/src/worlds/world-instance.tool.d.ts

@@ -2,20 +2,19 @@ import { oNodeConfig } from '@olane/o-node';
 import { oLaneTool } from '@olane/o-lane';
 import { oRequest } from '@olane/o-core';
 import type { ToolResult } from '@olane/o-tool';
-import { FilesystemTool } from '../tools/filesystem.tool.js';
 import type { WorldConfig, WorldAddressEntry, WorldSupportedType } from './world.types.js';
 /**
  * A world instance node — hub for addresses of a given world.
  * Registered as a child of the WorldManagerTool at o://world-manager/{world-name}.
  *
- * Each world instance owns a FilesystemTool child that provides scoped
- * filesystem access to the directories (addresses) registered with it.
+ * Uses the shared OS-level FilesystemTool for scoped filesystem access
+ * to the directories (addresses) registered with it.
  */
 export declare class WorldInstanceTool extends oLaneTool {
     private worldConfig;
     private addresses;
     private persistPath;
-    filesystemTool: FilesystemTool | null;
+    private fsAddress;
     constructor(nodeConfig: oNodeConfig, worldConfig: WorldConfig, persistPath?: string);
     get world(): WorldConfig;
     start(): Promise<void>;
@@ -23,6 +22,7 @@ export declare class WorldInstanceTool extends oLaneTool {
     _tool_remove_address(request: oRequest): Promise<ToolResult>;
     _tool_list_addresses(request: oRequest): Promise<ToolResult>;
     _tool_get_world_info(_request: oRequest): Promise<ToolResult>;
+    _tool_ping_address(request: oRequest): Promise<ToolResult>;
     getAddresses(type?: WorldSupportedType): WorldAddressEntry[];
     private loadAddresses;
     persistAddresses(): Promise<void>;

package/dist/src/worlds/world-instance.tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"world-instance.tool.d.ts","sourceRoot":"","sources":["../../../src/worlds/world-instance.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAY,QAAQ,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAEnB,MAAM,kBAAkB,CAAC;AAQ1B;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,WAAW,CAAqB;IACjC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAQ;gBAGlD,UAAU,EAAE,WAAW,EACvB,WAAW,EAAE,WAAW,EACxB,WAAW,CAAC,EAAE,MAAM;IA2CtB,IAAI,KAAK,IAAI,WAAW,CAEvB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBtB,sBAAsB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAkC9D,oBAAoB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAkB5D,oBAAoB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAQ5D,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAWnE,YAAY,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,EAAE;YAO9C,aAAa;IAcrB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;CASxC"}
+{"version":3,"file":"world-instance.tool.d.ts","sourceRoot":"","sources":["../../../src/worlds/world-instance.tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAY,QAAQ,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAEnB,MAAM,kBAAkB,CAAC;AAQ1B;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,SAAS,CAA0B;gBAGzC,UAAU,EAAE,WAAW,EACvB,WAAW,EAAE,WAAW,EACxB,WAAW,CAAC,EAAE,MAAM;IAmDtB,IAAI,KAAK,IAAI,WAAW,CAEvB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtB,sBAAsB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAuC9D,oBAAoB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAkB5D,oBAAoB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAQ5D,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAU7D,kBAAkB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;IAgChE,YAAY,CAAC,IAAI,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,EAAE;YAO9C,aAAa;IAcrB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;CASxC"}

package/dist/src/worlds/world-instance.tool.js

@@ -1,6 +1,5 @@
 import { oLaneTool } from '@olane/o-lane';
 import { oAddress } from '@olane/o-core';
-import { FilesystemTool } from '../tools/filesystem.tool.js';
 import { readFile, writeFile, mkdir, access } from 'fs/promises';
 import * as path from 'path';
 async function pathExists(p) {
@@ -16,8 +15,8 @@ async function pathExists(p) {
  * A world instance node — hub for addresses of a given world.
  * Registered as a child of the WorldManagerTool at o://world-manager/{world-name}.
  *
- * Each world instance owns a FilesystemTool child that provides scoped
- * filesystem access to the directories (addresses) registered with it.
+ * Uses the shared OS-level FilesystemTool for scoped filesystem access
+ * to the directories (addresses) registered with it.
  */
 export class WorldInstanceTool extends oLaneTool {
     constructor(nodeConfig, worldConfig, persistPath) {
@@ -56,10 +55,18 @@ export class WorldInstanceTool extends oLaneTool {
                     parameters: [],
                     dependencies: [],
                 },
+                ping_address: {
+                    name: 'ping_address',
+                    description: 'Ping a registered address to verify the underlying resource still exists',
+                    parameters: [
+                        { name: 'address', type: 'string', required: true, description: 'The registered address to ping' },
+                    ],
+                    dependencies: [],
+                },
             },
         });
         this.addresses = [];
-        this.filesystemTool = null;
+        this.fsAddress = new oAddress('o://fs');
         this.worldConfig = worldConfig;
         this.persistPath = persistPath;
     }
@@ -69,19 +76,13 @@ export class WorldInstanceTool extends oLaneTool {
     async start() {
         await super.start();
         await this.loadAddresses();
-        // Create the FilesystemTool child node scoped to this world's filepath addresses
+        // Sync existing filepath addresses to the shared OS-level FilesystemTool
         const filepathAddresses = this.addresses
             .filter((a) => a.type === 'filepath')
             .map((a) => a.address);
-        const slug = this.worldConfig.name.toLowerCase().replace(/[^a-z0-9-]/g, '-');
-        this.filesystemTool = new FilesystemTool({
-            address: new oAddress(`o://world-manager/${slug}/fs`),
-            leader: this.leader,
-            parent: this.address,
-            _allowNestedAddress: true,
-        }, filepathAddresses);
-        this.addChildNode(this.filesystemTool);
-        await this.filesystemTool.start();
+        for (const addr of filepathAddresses) {
+            await this.use(this.fsAddress, { method: 'add_path', params: { path: addr } });
+        }
     }
     // ── Tool methods ───────────────────────────────────────────
     async _tool_register_address(request) {
@@ -99,6 +100,16 @@ export class WorldInstanceTool extends oLaneTool {
                 error: `Address '${address}' is already registered in world '${this.worldConfig.name}'`,
             };
         }
+        // Validate and register with o://fs BEFORE storing
+        if (type === 'filepath') {
+            const fsResult = await this.use(this.fsAddress, { method: 'add_path', params: { path: address } });
+            if (!fsResult.result?.success) {
+                return {
+                    success: false,
+                    error: fsResult.result?.error || `Address '${address}' does not exist or is not a valid directory`,
+                };
+            }
+        }
         const entry = {
             address,
             type,
@@ -106,10 +117,6 @@ export class WorldInstanceTool extends oLaneTool {
             metadata,
         };
         this.addresses.push(entry);
-        // Sync filepath to the FilesystemTool
-        if (type === 'filepath' && this.filesystemTool) {
-            await this.filesystemTool._tool_add_path({ params: { path: address } });
-        }
         await this.persistAddresses();
         return { success: true };
     }
@@ -121,8 +128,8 @@ export class WorldInstanceTool extends oLaneTool {
         const removed = this.addresses.length < before;
         if (removed) {
             // Unsync from FilesystemTool
-            if (entry?.type === 'filepath' && this.filesystemTool) {
-                await this.filesystemTool._tool_remove_path({ params: { path: address } });
+            if (entry?.type === 'filepath') {
+                await this.use(this.fsAddress, { method: 'remove_path', params: { path: address } });
             }
             await this.persistAddresses();
         }
@@ -136,13 +143,41 @@ export class WorldInstanceTool extends oLaneTool {
         return { success: true, addresses: filtered };
     }
     async _tool_get_world_info(_request) {
+        const fsResponse = await this.use(this.fsAddress, { method: 'list_paths' });
         return {
             success: true,
             config: this.worldConfig,
             addressCount: this.addresses.length,
-            filesystemPaths: this.filesystemTool?.getAllowedPaths() || [],
+            filesystemPaths: fsResponse.result?.paths || [],
         };
     }
+    async _tool_ping_address(request) {
+        const { address } = request.params;
+        const entry = this.addresses.find((a) => a.address === address);
+        if (!entry) {
+            return { success: false, error: `Address '${address}' is not registered in this world` };
+        }
+        if (entry.type === 'filepath') {
+            const fsResult = await this.use(this.fsAddress, { method: 'stat_path', params: { path: entry.address } });
+            if (!fsResult.result?.success) {
+                return {
+                    success: false,
+                    address: entry.address,
+                    type: entry.type,
+                    error: fsResult.result?.error || 'Resource not reachable',
+                };
+            }
+            return {
+                success: true,
+                address: entry.address,
+                type: entry.type,
+                isDirectory: fsResult.result.isDirectory,
+                size: fsResult.result.size,
+                modified: fsResult.result.modified,
+            };
+        }
+        return { success: false, error: `Ping not supported for type '${entry.type}'` };
+    }
     // ── Convenience accessors ─────────────────────────────────
     getAddresses(type) {
         if (type)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olane/os",
-  "version": "0.8.17",
+  "version": "0.8.18",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -45,6 +45,7 @@
     "@typescript-eslint/eslint-plugin": "^8.56.1",
     "@typescript-eslint/parser": "^8.56.1",
     "aegir": "^47.0.26",
+    "chai": "^6.2.2",
     "eslint": "^10.0.2",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.5",
@@ -59,23 +60,24 @@
   },
   "dependencies": {
     "@libp2p/circuit-relay-v2": "^4.1.3",
-    "@olane/o-client-limited": "0.8.17",
-    "@olane/o-config": "0.8.17",
-    "@olane/o-core": "0.8.17",
-    "@olane/o-intelligence": "0.8.17",
-    "@olane/o-lane": "0.8.17",
-    "@olane/o-leader": "0.8.17",
-    "@olane/o-login": "0.8.17",
-    "@olane/o-protocol": "0.8.17",
-    "@olane/o-storage": "0.8.17",
-    "@olane/o-tool": "0.8.17",
-    "@olane/o-tool-registry": "0.8.17",
-    "@olane/o-tools-common": "0.8.17",
+    "@olane/o-client-limited": "0.8.18",
+    "@olane/o-config": "0.8.18",
+    "@olane/o-core": "0.8.18",
+    "@olane/o-intelligence": "0.8.18",
+    "@olane/o-lane": "0.8.18",
+    "@olane/o-leader": "0.8.18",
+    "@olane/o-login": "0.8.18",
+    "@olane/o-node": "0.8.18",
+    "@olane/o-protocol": "0.8.18",
+    "@olane/o-storage": "0.8.18",
+    "@olane/o-tool": "0.8.18",
+    "@olane/o-tool-registry": "0.8.18",
+    "@olane/o-tools-common": "0.8.18",
     "chalk": "^5.6.2",
     "debug": "^4.4.3",
     "dotenv": "^17.3.1",
     "fs-extra": "^11.3.3",
     "touch": "^3.1.1"
   },
-  "gitHead": "848be12a374d32f799026feecf15ada6bcf753ff"
+  "gitHead": "53fd92e7eeb02ce0a4713fe7ec1aeaba2b240abb"
 }