posipaki 0.16.2 → 0.16.3

package/dist/plugins/tree-introspection.d.ts

@@ -0,0 +1,18 @@
+import { s as ActorPlugin } from "../hooks-Czj67zNB.js";
+
+//#region src/plugins/tree-introspection.d.ts
+/** A node in the process tree. */
+interface TreeNode {
+  /** Actor name (tree-prefixed, e.g. "openai:connector"). */
+  pname: string;
+  /** Parent actor name, or null for the root. */
+  parentName: string | null;
+  /** Child subtrees (recursive). */
+  children: TreeNode[];
+  /** Actor status. */
+  status: 'running' | 'no introspection';
+}
+declare function inspect(): ActorPlugin;
+//#endregion
+export { TreeNode, inspect };
+//# sourceMappingURL=tree-introspection.d.ts.map

package/dist/plugins/tree-introspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-introspection.d.ts","names":[],"sources":["../../src/plugins/tree-introspection.ts"],"mappings":";;;;UAiCiB,QAAA;EAAA;EAEf,KAAA;;EAEA,UAAA;EAFA;EAIA,QAAA,EAAU,QAAQ;EAAlB;EAEA,MAAA;AAAA;AAAA,iBAKc,OAAA,IAAW,WAAW"}

package/dist/plugins/tree-introspection.js

@@ -0,0 +1,42 @@
+//#region src/plugins/tree-introspection.ts
+function inspect() {
+	return {
+		name: "inspect",
+		install(self) {
+			self.reflection.register("getTree", async function(prefix) {
+				const children = [];
+				for (const child of Object.values(this.$child)) {
+					const childRefl = child.$reflection;
+					if (typeof childRefl["inspect.getTree"] === "function") {
+						const sub = await childRefl["inspect.getTree"](prefix);
+						if (!prefix || sub.pname.startsWith(prefix)) children.push(sub);
+					} else {
+						const name = child.pname;
+						if (!prefix || name.startsWith(prefix)) children.push({
+							pname: name,
+							parentName: this.name,
+							children: [],
+							status: "no introspection"
+						});
+					}
+				}
+				return {
+					pname: this.name,
+					parentName: this.ctx.parentName,
+					children,
+					status: "running"
+				};
+			});
+			self.reflection.register("getState", function() {
+				return this.state;
+			});
+			self.reflection.register("stop", function() {
+				this.agreeToStop();
+			});
+		}
+	};
+}
+//#endregion
+export { inspect };
+
+//# sourceMappingURL=tree-introspection.js.map

package/dist/plugins/tree-introspection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-introspection.js","names":[],"sources":["../../src/plugins/tree-introspection.ts"],"sourcesContent":["// ── inspect Plugin ───────────────────────────────────────────────────────\n//\n// Registers reflection methods for actor tree introspection.\n// Built on the Actor Reflection RPC mechanism.\n//\n// Usage:\n//\n//   import { inspect } from 'posipaki/plugins/tree-introspection';\n//   const MyActor = defineActor({\n//     plugins: [inspect()],\n//     ...\n//   });\n//\n// Access via proc.$reflection:\n//\n//   const tree = await rootProc.$reflection['inspect.getTree']();\n//   // TreeNode { pname, parentName, children: TreeNode[], status }\n//\n//   const state = await proc.$reflection['inspect.getState']();\n//\n//   await proc.$reflection['inspect.stop']();\n//\n// Filtering:\n//\n//   const subtree = await proc.$reflection['inspect.getTree']('openai:');\n//   // Only includes nodes whose pname starts with 'openai:'\n//\n\nimport type { ActorPlugin } from '../hooks.js';\n\n// ── types ────────────────────────────────────────────────────────────────\n\n/** A node in the process tree. */\nexport interface TreeNode {\n  /** Actor name (tree-prefixed, e.g. \"openai:connector\"). */\n  pname: string;\n  /** Parent actor name, or null for the root. */\n  parentName: string | null;\n  /** Child subtrees (recursive). */\n  children: TreeNode[];\n  /** Actor status. */\n  status: 'running' | 'no introspection';\n}\n\n// ── plugin ───────────────────────────────────────────────────────────────\n\nexport function inspect(): ActorPlugin {\n  return {\n    name: 'inspect',\n    install(self) {\n      self.reflection.register('getTree', async function (prefix?: string) {\n        const children: TreeNode[] = [];\n        for (const child of Object.values(this.$child)) {\n          const childRefl = (child.$reflection as Record<string, Function>);\n          if (typeof childRefl['inspect.getTree'] === 'function') {\n            const sub = await childRefl['inspect.getTree'](prefix) as TreeNode;\n            if (!prefix || sub.pname.startsWith(prefix)) {\n              children.push(sub);\n            }\n          } else {\n            const name = child.pname;\n            if (!prefix || name.startsWith(prefix)) {\n              children.push({\n                pname: name,\n                parentName: this.name,\n                children: [],\n                status: 'no introspection',\n              });\n            }\n          }\n        }\n        return {\n          pname: this.name,\n          parentName: this.ctx.parentName,\n          children,\n          status: 'running' as const,\n        } satisfies TreeNode;\n      });\n\n      self.reflection.register('getState', function () {\n        return this.state;\n      });\n\n      self.reflection.register('stop', function () {\n        this.agreeToStop();\n      });\n    },\n  };\n}\n"],"mappings":";AA8CA,SAAgB,UAAuB;CACrC,OAAO;EACL,MAAM;EACN,QAAQ,MAAM;GACZ,KAAK,WAAW,SAAS,WAAW,eAAgB,QAAiB;IACnE,MAAM,WAAuB,CAAC;IAC9B,KAAK,MAAM,SAAS,OAAO,OAAO,KAAK,MAAM,GAAG;KAC9C,MAAM,YAAa,MAAM;KACzB,IAAI,OAAO,UAAU,uBAAuB,YAAY;MACtD,MAAM,MAAM,MAAM,UAAU,mBAAmB,MAAM;MACrD,IAAI,CAAC,UAAU,IAAI,MAAM,WAAW,MAAM,GACxC,SAAS,KAAK,GAAG;KAErB,OAAO;MACL,MAAM,OAAO,MAAM;MACnB,IAAI,CAAC,UAAU,KAAK,WAAW,MAAM,GACnC,SAAS,KAAK;OACZ,OAAO;OACP,YAAY,KAAK;OACjB,UAAU,CAAC;OACX,QAAQ;MACV,CAAC;KAEL;IACF;IACA,OAAO;KACL,OAAO,KAAK;KACZ,YAAY,KAAK,IAAI;KACrB;KACA,QAAQ;IACV;GACF,CAAC;GAED,KAAK,WAAW,SAAS,YAAY,WAAY;IAC/C,OAAO,KAAK;GACd,CAAC;GAED,KAAK,WAAW,SAAS,QAAQ,WAAY;IAC3C,KAAK,YAAY;GACnB,CAAC;EACH;CACF;AACF"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "posipaki",
-  "version": "0.16.2",
+  "version": "0.16.3",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
@@ -41,6 +41,10 @@
       "types": "./dist/plugins/rbac.d.ts",
       "default": "./dist/plugins/rbac.js"
     },
+    "./plugins/tree-introspection": {
+      "types": "./dist/plugins/tree-introspection.d.ts",
+      "default": "./dist/plugins/tree-introspection.js"
+    },
     "./hooks": {
       "types": "./dist/hooks.d.ts",
       "default": "./dist/hooks.js"