@rolexjs/core 1.5.0-dev-20260312103654 → 1.5.0-dev-20260313095759

package/dist/index.d.ts

@@ -433,8 +433,12 @@ declare class Role {
 
 interface RoleX {
     activate(individual: string): Promise<Role>;
-    inspect(id: string): Promise<string>;
-    survey(type?: string): Promise<string>;
+    inspect(id: string, options?: {
+        raw?: boolean;
+    }): Promise<string | State>;
+    survey(type?: string, options?: {
+        raw?: boolean;
+    }): Promise<string | readonly State[]>;
     direct<T = unknown>(locator: string, args?: Record<string, unknown>, options?: {
         raw?: boolean;
     }): Promise<T>;
@@ -464,8 +468,12 @@ declare class RoleXService implements RoleX {
     private findOrAutoBorn;
     private saveSnapshot;
     private restoreSnapshot;
-    inspect(id: string): Promise<string>;
-    survey(type?: string): Promise<string>;
+    inspect(id: string, options?: {
+        raw?: boolean;
+    }): Promise<string | State>;
+    survey(type?: string, options?: {
+        raw?: boolean;
+    }): Promise<string | readonly State[]>;
     direct<T = unknown>(locator: string, args?: Record<string, unknown>, options?: {
         raw?: boolean;
     }): Promise<T>;
@@ -882,11 +890,13 @@ interface RoleXBuilder {
     /** Inspect any node's full state — world-level observation. */
     inspect(params: {
         id: string;
-    }): Promise<string>;
+        raw?: boolean;
+    }): Promise<string | State>;
     /** Survey the world — list individuals, organizations, positions. */
     survey(params?: {
         type?: string;
-    }): Promise<string>;
+        raw?: boolean;
+    }): Promise<string | readonly State[]>;
     /** Tool schemas + world instructions — the unified contract for any channel adapter. */
     readonly protocol: Protocol;
     /** Universal JSON-RPC 2.0 dispatch. */

package/dist/index.js

@@ -3117,21 +3117,23 @@ var RoleXService = class _RoleXService {
   // ================================================================
   //  inspect — project any node's subtree
   // ================================================================
-  async inspect(id) {
+  async inspect(id, options) {
     const node = await this.find(id);
     if (!node) throw new Error(`"${id}" not found.`);
     const state = await this.project(node);
+    if (options?.raw) return state;
     const result = { state, process: "inspect" };
     return this.renderer.render("inspect", result);
   }
   // ================================================================
   //  survey — world-level overview
   // ================================================================
-  async survey(type) {
+  async survey(type, options) {
     const target = type === "past" ? this.past : this.society;
     const state = await this.project(target);
     const children = state.children ?? [];
     const filtered = type === "past" ? children : children.filter((c) => type ? c.name === type : c.name !== "past");
+    if (options?.raw) return filtered;
     const result = { state: { ...state, children: filtered }, process: "list" };
     return this.renderer.render("survey.list", result);
   }
@@ -3584,10 +3586,14 @@ function createBuilder(config) {
               return service.activate(params.individual);
             },
             inspect: async (params) => {
-              return service.inspect(params.id);
+              return service.inspect(params.id, {
+                raw: params.raw
+              });
             },
             survey: async (params) => {
-              return service.survey(params.type);
+              return service.survey(params.type, {
+                raw: params.raw
+              });
             }
           }
         });
@@ -3642,8 +3648,8 @@ function createBuilder(config) {
     get resource() {
       return _resource;
     },
-    async inspect({ id }) {
-      return call("inspect", { id });
+    async inspect({ id, raw }) {
+      return call("inspect", { id, raw });
     },
     async survey(params) {
       return call("survey", params);