@treenity/core 1.0.48 → 3.0.1

package/dist/tree-chain.js

@@ -0,0 +1,111 @@
+// treeChain — tree-aware Proxy chain
+// Navigate tree via dots, auto-follow refs, execute actions, typed components.
+// Layer L2: uses Tree (L1) + comp (L2). No server dependency.
+import { getComponent, isComponent, isRef, normalizeType, resolve } from '#core';
+const EMPTY_FN = () => { };
+const NO_OPS = [];
+async function exec(tree, path, spec, ops) {
+    const node = await tree.get(path);
+    if (!node)
+        throw new Error(`Node not found: ${path}`);
+    let cur = node;
+    let curType = node.$type;
+    // Apply $get — extract typed or named component
+    if (spec) {
+        if (spec.key) {
+            const ck = node[spec.key];
+            if (!isComponent(ck))
+                throw new Error(`Component "${spec.key}" not found on ${path}`);
+            cur = ck;
+            curType = cur.$type;
+        }
+        else if (spec.cls) {
+            const comp = getComponent(node, spec.cls);
+            if (!comp)
+                throw new Error(`Type "${normalizeType(spec.cls)}" not found on ${path}`);
+            cur = comp;
+            curType = comp.$type ?? curType;
+        }
+    }
+    // Walk ops: field reads and action calls
+    for (const op of ops) {
+        if (typeof op === 'string') {
+            // Field read
+            cur = cur[op];
+            if (cur == null)
+                throw new Error(`Field "${op}" is null at ${path}`);
+            // Auto-follow $ref
+            if (isRef(cur)) {
+                const target = await tree.get(cur.$ref);
+                if (!target)
+                    throw new Error(`Ref not found: ${cur.$ref}`);
+                cur = target;
+                curType = target.$type;
+            }
+        }
+        else {
+            // Action call: [name, args]
+            const [action, args] = op;
+            const handler = resolve(curType, `action:${action}`);
+            if (!handler)
+                throw new Error(`No action "${action}" for type "${curType}"`);
+            cur = await handler(null, args[0]);
+        }
+    }
+    return cur;
+}
+function make(tree, path, spec, ops) {
+    return new Proxy(EMPTY_FN, {
+        get: (_, p) => {
+            if (p === Symbol.toPrimitive || p === Symbol.toStringTag)
+                return `TreeChain(${path})`;
+            if (typeof p === 'symbol')
+                return undefined;
+            if (p === '$path')
+                return path;
+            if (p === 'then') {
+                return (res, rej) => exec(tree, path, spec, ops).then(res, rej);
+            }
+            if (p === '$get') {
+                return (cls, key) => make(tree, path, { cls, key }, NO_OPS);
+            }
+            if (p === '$field') {
+                return (key) => make(tree, path, { cls: null, key }, NO_OPS);
+            }
+            if (p === '$children') {
+                return (query) => tree.getChildren(path, query ? { query } : undefined).then(r => r.items);
+            }
+            if (p === '$set') {
+                return (cls, data) => tree.set({ $path: path, $type: normalizeType(cls), ...data });
+            }
+            // After [Class] or ops started — accumulate as field ops
+            if (spec || ops.length > 0) {
+                return make(tree, path, spec, [...ops, p]);
+            }
+            // Child navigation — string concat, no array allocation
+            return make(tree, path === '/' ? `/${p}` : `${path}/${p}`, null, NO_OPS);
+        },
+        apply: (_, __, args) => {
+            // Action call — spec set, last op is string → convert to action
+            if (spec && ops.length > 0) {
+                const last = ops[ops.length - 1];
+                if (typeof last === 'string') {
+                    return make(tree, path, spec, [...ops.slice(0, -1), [last, args]]);
+                }
+            }
+            // Class narrowing: proxy(Scanner) → set spec
+            const cls = args[0];
+            if (args.length === 1 && typeof cls === 'function' && cls.$type) {
+                return make(tree, path, { cls, key: undefined }, NO_OPS);
+            }
+            throw new Error('Call with Class first: t.path(Type).action()');
+        },
+    });
+}
+export function treeChain(tree, basePath) {
+    const path = basePath
+        ? (basePath.startsWith('/') ? basePath : '/' + basePath)
+        : '/';
+    return make(tree, path, null, NO_OPS);
+}
+//# sourceMappingURL=tree-chain.js.map

package/dist/tree-chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-chain.js","sourceRoot":"","sources":["../src/tree-chain.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,+EAA+E;AAC/E,8DAA8D;AAG9D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,EAAiB,aAAa,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AA2BhG,MAAM,QAAQ,GAAG,GAAG,EAAE,GAAE,CAAC,CAAA;AACzB,MAAM,MAAM,GAAS,EAAE,CAAA;AAEvB,KAAK,UAAU,IAAI,CAAC,IAAU,EAAE,IAAY,EAAE,IAAiB,EAAE,GAAS;IACxE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACjC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAA;IAErD,IAAI,GAAG,GAAQ,IAAI,CAAA;IACnB,IAAI,OAAO,GAAG,IAAI,CAAC,KAAK,CAAA;IAExB,gDAAgD;IAChD,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACzB,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAC,GAAG,kBAAkB,IAAI,EAAE,CAAC,CAAA;YACrF,GAAG,GAAG,EAAE,CAAA;YACR,OAAO,GAAG,GAAG,CAAC,KAAK,CAAA;QACrB,CAAC;aAAM,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;YACzC,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,SAAS,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAA;YACpF,GAAG,GAAG,IAAI,CAAA;YACV,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAA;QACjC,CAAC;IACH,CAAC;IAED,yCAAyC;IACzC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC3B,aAAa;YACb,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,CAAA;YACb,IAAI,GAAG,IAAI,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,gBAAgB,IAAI,EAAE,CAAC,CAAA;YAEpE,mBAAmB;YACnB,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACf,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBACvC,IAAI,CAAC,MAAM;oBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;gBAC1D,GAAG,GAAG,MAAM,CAAA;gBACZ,OAAO,GAAG,MAAM,CAAC,KAAK,CAAA;YACxB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,4BAA4B;YAC5B,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAA;YACzB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,UAAU,MAAM,EAAE,CAAC,CAAA;YACpD,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,cAAc,MAAM,eAAe,OAAO,GAAG,CAAC,CAAA;YAC5E,GAAG,GAAG,MAAO,OAAe,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QAC7C,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAS,IAAI,CAAC,IAAU,EAAE,IAAY,EAAE,IAAiB,EAAE,GAAS;IAClE,OAAO,IAAI,KAAK,CAAC,QAAe,EAAE;QAChC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAkB,EAAE,EAAE;YAC7B,IAAI,CAAC,KAAK,MAAM,CAAC,WAAW,IAAI,CAAC,KAAK,MAAM,CAAC,WAAW;gBAAE,OAAO,aAAa,IAAI,GAAG,CAAA;YACrF,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAA;YAE3C,IAAI,CAAC,KAAK,OAAO;gBAAE,OAAO,IAAI,CAAA;YAE9B,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAQ,EAAE,GAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;YAC3E,CAAC;YAED,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAiB,EAAE,GAAY,EAAE,EAAE,CACzC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,MAAM,CAAC,CAAA;YAC1C,CAAC;YAED,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAW,EAAE,EAAE,CACrB,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,CAAC,CAAA;YAChD,CAAC;YAED,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;gBACtB,OAAO,CAAC,KAA+B,EAAE,EAAE,CACzC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;YAC5E,CAAC;YAED,IAAI,CAAC,KAAK,MAAM,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAU,EAAE,IAA8B,EAAE,EAAE,CACpD,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAA;YACjE,CAAC;YAED,yDAAyD;YACzD,IAAI,IAAI,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAA;YAC5C,CAAC;YAED,wDAAwD;YACxD,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;QAC1E,CAAC;QAED,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;YACrB,gEAAgE;YAChE,IAAI,IAAI,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;gBAChC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC7B,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;gBACpE,CAAC;YACH,CAAC;YAED,6CAA6C;YAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;YACnB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,GAAG,KAAK,UAAU,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBAChE,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,CAAA;YAC1D,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;QACjE,CAAC;KACF,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAU,EAAE,QAAiB;IACrD,MAAM,IAAI,GAAG,QAAQ;QACnB,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,GAAG,QAAQ,CAAC;QACxD,CAAC,CAAC,GAAG,CAAA;IACP,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AACvC,CAAC"}

package/dist/tree.d.ts

@@ -0,0 +1,2 @@
+export * from './tree/index.ts';
+//# sourceMappingURL=tree.d.ts.map

package/dist/tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/tree.js

@@ -0,0 +1,2 @@
+export * from "./tree/index.js";
+//# sourceMappingURL=tree.js.map

package/dist/tree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree.js","sourceRoot":"","sources":["../src/tree.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/uri.d.ts

@@ -0,0 +1,11 @@
+export interface TreenityURI {
+    path: string;
+    key?: string;
+    field?: string;
+    action?: string;
+    data?: Record<string, unknown>;
+}
+export declare function parseURI(uri: string): TreenityURI;
+/** Extract value from node by parsed URI (key + field) */
+export declare function deriveURI<T>(node: Record<string, unknown> | undefined, uri: TreenityURI): T | undefined;
+//# sourceMappingURL=uri.d.ts.map

package/dist/uri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri.d.ts","sourceRoot":"","sources":["../src/uri.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CA4BjD;AAED,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,GAAG,EAAE,WAAW,GAAG,CAAC,GAAG,SAAS,CAOvG"}

package/dist/uri.js

@@ -0,0 +1,84 @@
+// Treenity URI — universal intra-node addressing (D17)
+// Standard URL order: /path[?query]#[key.]name[()]
+// Parsed via native URL — free encoding, edge case handling.
+// () = action call, no () = field read
+// Query: dot-notation for nesting (age.$gt=10 → { age: { $gt: 10 } })
+export function parseURI(uri) {
+    const url = new URL(uri, 'treenity://t');
+    const path = url.pathname;
+    if (!path.startsWith('/'))
+        throw new Error('Path must start with /');
+    const result = { path };
+    const fragment = url.hash.slice(1); // strip leading #
+    if (fragment) {
+        const isCall = fragment.endsWith('()');
+        const clean = isCall ? fragment.slice(0, -2) : fragment;
+        if (!clean)
+            throw new Error('Empty name in URI fragment');
+        const dot = clean.indexOf('.');
+        const key = dot > -1 ? clean.slice(0, dot) : undefined;
+        const name = dot > -1 ? clean.slice(dot + 1) : clean;
+        if (dot > -1 && !name)
+            throw new Error('Empty name in URI fragment');
+        if (key)
+            result.key = key;
+        if (isCall) {
+            result.action = name;
+        }
+        else if (key) {
+            result.field = name;
+        }
+        else {
+            result.key = name;
+        }
+    }
+    const data = url.search ? expandDots(url.searchParams) : undefined;
+    if (data)
+        result.data = data;
+    return result;
+}
+/** Extract value from node by parsed URI (key + field) */
+export function deriveURI(node, uri) {
+    if (!node)
+        return undefined;
+    if (!uri.key && !uri.field)
+        return node;
+    const comp = uri.key ? node[uri.key] : node;
+    if (comp === undefined)
+        return undefined;
+    if (!uri.field)
+        return comp;
+    return comp?.[uri.field];
+}
+/** Expand URLSearchParams with dot-notation into nested object */
+function expandDots(params) {
+    const result = {};
+    for (const [key, val] of params)
+        setNested(result, key, coerce(val));
+    return result;
+}
+function coerce(v) {
+    if (v === 'true')
+        return true;
+    if (v === 'false')
+        return false;
+    if (v === 'null')
+        return null;
+    const n = Number(v);
+    if (v !== '' && !isNaN(n))
+        return n;
+    return v;
+}
+function setNested(obj, path, val) {
+    const parts = path.split('.');
+    let cur = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const p = parts[i];
+        if (!(p in cur) || typeof cur[p] !== 'object' || cur[p] === null) {
+            cur[p] = {};
+        }
+        cur = cur[p];
+    }
+    cur[parts[parts.length - 1]] = val;
+}
+//# sourceMappingURL=uri.js.map

package/dist/uri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri.js","sourceRoot":"","sources":["../src/uri.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,51 +1,92 @@
 {
   "name": "@treenity/core",
-  "version": "1.0.48",
-  "description": "treenity core",
-  "author": "Treenity",
-  "license": "ISC",
+  "version": "3.0.1",
+  "description": "Composable typed tree engine — three primitives, everything else composes. Nodes, components, contexts.",
   "type": "module",
-  "types": "./dist/index.d.ts",
-  "module": "./dist/index.mjs",
+  "publishConfig": { "access": "public" },
+  "license": "AGPL-3.0",
+  "author": "Treenity <hello@treenity.ai> (https://treenity.ai)",
+  "homepage": "https://github.com/treenity-ai/treenity",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/treenity-ai/treenity.git"
+  },
+  "keywords": [
+    "treenity",
+    "tree",
+    "composable",
+    "typed",
+    "ecs",
+    "node",
+    "component",
+    "context",
+    "mcp",
+    "ai-native"
+  ],
+  "imports": {
+    "#*": {
+      "development": "./src/*.ts",
+      "default": "./dist/*.js"
+    }
+  },
   "exports": {
     ".": {
+      "development": "./src/index.ts",
       "types": "./dist/index.d.ts",
-      "default": "./dist/index.mjs"
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "development": "./src/*.ts",
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
     }
   },
+  "treenity": {
+    "clients": "./src/mods/clients.ts",
+    "servers": "./src/mods/servers.ts"
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepack": "npm run build",
+    "test": "tsx --conditions development --test src/**/*.test.ts",
+    "dev:server": "tsx --conditions development --watch src/server/main.ts ../root.json",
+    "schema": "tsx --conditions development src/schema/extract-schemas.ts ../mods ../packages"
+  },
   "dependencies": {
-    "@treenity/call-chain": "1.0.32",
-    "@treenity/js-shared": "1.0.35",
-    "json-schema": "^0.4.0",
-    "json-schema-to-ts": "^3.1.0",
-    "synchronous-promise": "2.0.17",
-    "tslib": "^2.8.1"
+    "@anthropic-ai/claude-agent-sdk": "^0.2.58",
+    "@grammyjs/runner": "^2.0.3",
+    "@huggingface/transformers": "^3.8.1",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@orama/orama": "^3.1.18",
+    "@trpc/server": "^11.9.0",
+    "dotenv": "^17.2.4",
+    "fast-json-patch": "^3.1.1",
+    "grammy": "^1.39.3",
+    "immer": "^11.1.4",
+    "mongoose": "^9.2.4",
+    "quickjs-emscripten": "^0.32.0",
+    "sift": "^17.1.3",
+    "uuid": "^13.0.0",
+    "wavefile": "^11.0.0",
+    "zod": "^4.3.6"
   },
   "peerDependencies": {
-    "react": "^18.3.1"
+    "mongodb": ">=6"
   },
-  "devDependencies": {
-    "@testing-library/dom": "^8.17.1",
-    "@testing-library/jest-dom": "^6.4.8",
-    "@treenity/build-utils": "1.1.32",
-    "@treenity/tsconfig": "1.0.14",
-    "@types/jest": "^29.5.12",
-    "@types/json-schema": "^7.0.15",
-    "@types/node": "^22.7.5",
-    "@types/prop-types": "^15.7.5",
-    "@types/react": "18.2.51",
-    "ajv": "^8.12.0",
-    "jest": "^29.7.0",
-    "react": "^18.3.1",
-    "rollup": "^4.26.0",
-    "typescript": "^5.4.5"
+  "peerDependenciesMeta": {
+    "mongodb": {
+      "optional": true
+    }
   },
-  "scripts": {
-    "build": "rollup -c",
-    "watch": "rollup -c -w",
-    "clean": "treenity-clean",
-    "typecheck": "tsc",
-    "test": "jest --no-cache  --detectOpenHandles --runInBand --forceExit",
-    "--doc": "typedoc --plugin typedoc-plugin-markdown"
+  "devDependencies": {
+    "mongodb": "^7.1.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
   }
-}
+}

package/src/chain.test.ts

@@ -0,0 +1,190 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { chain, refVal, runPathWithRefs, TypedRef } from './chain';
+
+// ── basic ──
+
+test('sync field', async () => {
+  assert.equal(await chain({ name: 'Alice' }).name, 'Alice')
+})
+
+test('sync method', async () => {
+  assert.equal(await chain({ greet: (n: string) => `hello ${n}` }).greet('Bob'), 'hello Bob')
+})
+
+test('async field', async () => {
+  assert.equal(await chain({ fetch: async () => 42 }).fetch(), 42)
+})
+
+test('deep sync chain', async () => {
+  const obj = { user: { profile: { name: 'Alice' } } }
+  assert.equal(await chain(obj).user.profile.name, 'Alice')
+})
+
+test('deep async chain', async () => {
+  const obj = {
+    user: async (id: string) => ({
+      id,
+      posts: async () => [{ title: 'Hello' }, { title: 'World' }],
+    }),
+  }
+  const posts = await chain(obj).user('123').posts()
+  assert.deepEqual(posts, [{ title: 'Hello' }, { title: 'World' }])
+})
+
+test('method chaining returns new chain', async () => {
+  const obj = {
+    add: (n: number) => ({
+      multiply: (m: number) => n * m,
+    }),
+  }
+  assert.equal(await chain(obj).add(3).multiply(4), 12)
+})
+
+test('this binding preserved', async () => {
+  const obj = { value: 42, get() { return this.value } }
+  assert.equal(await chain(obj).get(), 42)
+})
+
+test('null in chain throws', async () => {
+  await assert.rejects(
+    async () => { await chain({ user: null } as any).user.name },
+  )
+})
+
+test('same chain reusable', async () => {
+  let callCount = 0
+  const obj = { fetch: async () => { callCount++; return callCount } }
+  const c = chain(obj).fetch()
+  assert.equal(await c, 1)
+  assert.equal(await c, 2)  // no caching — executes again
+})
+
+test('async error propagates', async () => {
+  const obj = { fail: async () => { throw new Error('boom') } }
+  await assert.rejects(async () => { await chain(obj).fail() })
+})
+
+// ── demo tracker component types ──
+
+class LivePrices {
+  static $type = 'demo.live-prices'
+  feederUrl = 'ws://localhost:8090'
+  async subscribe({ slugs }: { slugs: string[] }) {
+    return slugs.map(s => ({ slug: s, bid: 0.6, ask: 0.65 }))
+  }
+}
+
+class Scanner {
+  static $type = 'demo.scanner'
+  intervalMs = 900_000
+  livePrices: TypedRef<LivePrices> = refVal(LivePrices, '/demo/live-prices')
+  depositTracker: TypedRef<DepositTracker> = refVal(DepositTracker, '/demo/deposits')
+}
+
+class DepositTracker {
+  static $type = 'demo.deposit-tracker'
+  async run() { return { added: 12, ts: Date.now() } }
+}
+
+class Profile {
+  static $type = 'demo.profile'
+  address = ''
+  async fetch({ address }: { address: string }) {
+    return { address, name: 'whale.eth', totalPnl: 50_000 }
+  }
+  async trades({ page = 1 } = {}) {
+    return { page, items: [{ hash: '0xabc', amount: 1000 }] }
+  }
+}
+
+// ── refVal ──
+
+test('refVal stores $type and $ref', () => {
+  const ref = refVal(LivePrices, '/demo/live-prices')
+  assert.equal(ref.$type, 'ref')
+  assert.equal(ref.$ref, '/demo/live-prices')
+})
+
+test('refVal default path is empty', () => {
+  const ref = refVal(LivePrices)
+  assert.equal(ref.$ref, '')
+})
+
+// ── server executor: auto-resolves refs ──
+
+function makeStore(entries: [string, any][]) {
+  const m = new Map(entries)
+  return (ref: { $ref: string }) => {
+    const node = m.get(ref.$ref)
+    if (!node) throw new Error(`Ref not found: ${ref.$ref}`)
+    return Promise.resolve(node)
+  }
+}
+
+test('runPathWithRefs: follows ref to node', async () => {
+  const live = new LivePrices()
+  const scanner = new Scanner()
+
+  const result = await runPathWithRefs(
+    scanner,
+    ['livePrices', 'subscribe', [{ slugs: ['btc-win'] }]],
+    makeStore([['/demo/live-prices', live]]),
+  )
+
+  assert.deepEqual(result, [{ slug: 'btc-win', bid: 0.6, ask: 0.65 }])
+})
+
+test('runPathWithRefs: multiple refs in one session', async () => {
+  const live = new LivePrices()
+  const deposits = new DepositTracker()
+  const scanner = new Scanner()
+  const resolve = makeStore([
+    ['/demo/live-prices', live],
+    ['/demo/deposits', deposits],
+  ])
+
+  const prices = await runPathWithRefs(scanner, ['livePrices', 'subscribe', [{ slugs: ['x'] }]], resolve)
+  const run = await runPathWithRefs(scanner, ['depositTracker', 'run', []], resolve)
+
+  assert.ok(Array.isArray(prices))
+  assert.equal(run.added, 12)
+})
+
+test('runPathWithRefs: nested refs (ref → node → ref → node)', async () => {
+  const profile = new Profile()
+  // live node has a nested ref to profile
+  const liveNode = { profile: { $type: 'ref', $ref: '/demo/profiles/0xabc' } }
+  const scanner = { live: { $type: 'ref', $ref: '/demo/live' } }
+
+  const result = await runPathWithRefs(
+    scanner,
+    ['live', 'profile', 'fetch', [{ address: '0xabc' }]],
+    makeStore([
+      ['/demo/live', liveNode],
+      ['/demo/profiles/0xabc', profile],
+    ]),
+  )
+
+  assert.deepEqual(result, { address: '0xabc', name: 'whale.eth', totalPnl: 50_000 })
+})
+
+test('runPathWithRefs: missing ref throws', async () => {
+  const scanner = new Scanner()
+  await assert.rejects(
+    () => runPathWithRefs(scanner, ['livePrices', 'subscribe', [{ slugs: [] }]], makeStore([])),
+  )
+})
+
+test('runPathWithRefs: profile trades pagination', async () => {
+  const profile = new Profile()
+  const node = { target: { $type: 'ref', $ref: '/profile' } }
+
+  const result = await runPathWithRefs(
+    node,
+    ['target', 'trades', [{ page: 2 }]],
+    makeStore([['/profile', profile]]),
+  )
+
+  assert.deepEqual(result, { page: 2, items: [{ hash: '0xabc', amount: 1000 }] })
+})

package/src/chain.ts

@@ -0,0 +1,84 @@
+// Minimal call-chain: records property/call path, resolves lazily on await.
+// Ref resolution is opt-in via runPathWithRefs — chain itself is pure.
+
+import { isRef, type Ref } from '#core';
+
+export type PathSection = string | unknown[]
+
+// ── Types (mirrors call-chain library, no dep needed) ──
+
+type Primitive = undefined | null | boolean | string | number | symbol | bigint | void
+
+type ValuePromise<T> = T extends Primitive
+  ? Promise<T>
+  : T extends Promise<any>
+  ? T
+  : Chain<T>
+
+export type Chain<T> = Promise<T> & {
+  [K in keyof T]: T[K] extends TypedRef<infer U>
+    ? Chain<U>
+    : T[K] extends (...args: infer A) => infer R
+      ? (...args: A) => ValuePromise<Awaited<NonNullable<R>>>
+      : ValuePromise<Awaited<NonNullable<T[K]>>>
+}
+
+// TypedRef: runtime $ref + phantom type T for call-chain to follow
+// _T is a phantom type — exists only for TypeScript inference, erased at runtime
+export interface TypedRef<_T> {
+  readonly $type: 'ref'
+  $ref: string
+}
+
+// Pass registered class (has .$type stamped by registerType) for TypeScript type inference.
+// Runtime only stores $ref — no class reference kept.
+export function refVal<T>(Comp: (new () => T) & { $type?: string }, defaultPath = ''): TypedRef<T> {
+  void Comp  // type-only at runtime; $type from registerType could be stored if needed
+  return { $type: 'ref', $ref: defaultPath }
+}
+
+// ── Core ──
+
+export async function runPath(target: any, path: PathSection[]): Promise<any> {
+  let cur = target, prev = target
+  for (const step of path) {
+    if (cur == null) throw new Error(`null at step: ${JSON.stringify(step)}`)
+    if (typeof step === 'string') { prev = cur; cur = cur[step] }
+    else { cur = cur.apply(prev, step as any[]) }
+    if (cur?.then) cur = await cur
+  }
+  return cur
+}
+
+// Server executor: same as runPath but auto-follows TypedRef fields
+export async function runPathWithRefs(
+  target: any,
+  path: PathSection[],
+  resolveRef: (ref: Ref) => Promise<any>,
+): Promise<any> {
+  let cur = target, prev = target
+  for (const step of path) {
+    if (cur == null) throw new Error(`null at step: ${JSON.stringify(step)}`)
+    if (typeof step === 'string') {
+      prev = cur
+      cur = cur[step]
+      if (isRef(cur)) cur = await resolveRef(cur)
+    } else {
+      cur = cur.apply(prev, step as any[])
+    }
+    if (cur?.then) cur = await cur
+  }
+  return cur
+}
+
+const make = (target: any, path: PathSection[]): any =>
+  new Proxy((() => {}) as any, {
+    get: (_, p: string | symbol) => {
+      if (p === 'then') return (res: any, rej: any) => runPath(target, path).then(res, rej)
+      if (typeof p === 'symbol') return undefined
+      return make(target, [...path, p as string])
+    },
+    apply: (_, __, args) => make(target, [...path, args]),
+  })
+
+export const chain = <T>(target: T): Chain<T> => make(target, []) as Chain<T>