@treenity/core 1.0.48 → 3.0.1

package/dist/mod/optimistic.js

@@ -0,0 +1,176 @@
+// Treenity Optimistic Updates — predict locally, reconcile with server
+// Component class methods are the shared kernel: same code runs on client (optimistic)
+// and server (authoritative). Server patches confirm or override.
+import { getComponent } from '#core';
+export class OptimisticBuffer {
+    pending = new Map();
+    idCounter = 0;
+    // Apply an action optimistically: clone node, run method, store prediction
+    apply(node, compType, action, method, data) {
+        const baseline = structuredClone(node);
+        const draft = structuredClone(node);
+        // Find the component (or node itself) matching compType
+        const target = getComponent(draft, compType);
+        if (!target)
+            throw new Error(`Component "${compType}" not found on node ${node.$path}`);
+        method(target, data);
+        const id = `opt_${++this.idCounter}_${Date.now()}`;
+        const mutation = {
+            id,
+            path: node.$path,
+            compType,
+            action,
+            predicted: draft,
+            baseline,
+            method,
+            data,
+            createdAt: Date.now(),
+        };
+        if (!this.pending.has(node.$path))
+            this.pending.set(node.$path, []);
+        this.pending.get(node.$path).push(mutation);
+        return { predicted: draft, mutationId: id };
+    }
+    // Server confirmed a new state. Reconcile with pending mutations.
+    // Returns the node to use and whether any rollback happened.
+    confirm(path, serverNode) {
+        const mutations = this.pending.get(path);
+        if (!mutations || mutations.length === 0) {
+            return { node: serverNode, rolledBack: false };
+        }
+        // Find the first pending mutation that this server update might confirm
+        const first = mutations[0];
+        // Compare server result with our prediction
+        if (nodesMatch(serverNode, first.predicted)) {
+            // Prediction was correct — drop this mutation
+            mutations.shift();
+            if (mutations.length === 0)
+                this.pending.delete(path);
+            // If more pending mutations, rebase them on the confirmed state
+            if (mutations.length > 0) {
+                return { node: this.rebase(path, serverNode), rolledBack: false };
+            }
+            return { node: serverNode, rolledBack: false };
+        }
+        // Prediction was wrong — server wins, drop ALL pending for this path
+        this.pending.delete(path);
+        return { node: serverNode, rolledBack: true };
+    }
+    // Rebase remaining mutations on top of a new base state
+    rebase(path, base) {
+        const mutations = this.pending.get(path);
+        if (!mutations || mutations.length === 0)
+            return base;
+        // Replay each pending mutation on top of the new base
+        let current = base;
+        const surviving = [];
+        for (const m of mutations) {
+            try {
+                const draft = structuredClone(current);
+                const target = getComponent(draft, m.compType);
+                if (!target)
+                    continue;
+                m.method(target, m.data);
+                m.baseline = current;
+                m.predicted = draft;
+                current = draft;
+                surviving.push(m);
+            }
+            catch {
+                // Mutation no longer valid on new base — drop it
+            }
+        }
+        if (surviving.length === 0)
+            this.pending.delete(path);
+        else
+            this.pending.set(path, surviving);
+        return current;
+    }
+    // Confirm a specific mutation by ID
+    confirmById(mutationId) {
+        for (const [path, mutations] of this.pending) {
+            const idx = mutations.findIndex(m => m.id === mutationId);
+            if (idx !== -1) {
+                mutations.splice(idx, 1);
+                if (mutations.length === 0)
+                    this.pending.delete(path);
+                return true;
+            }
+        }
+        return false;
+    }
+    // Rollback all pending mutations for a path
+    rollback(path) {
+        const mutations = this.pending.get(path);
+        if (!mutations || mutations.length === 0)
+            return undefined;
+        const baseline = mutations[0].baseline;
+        this.pending.delete(path);
+        return baseline;
+    }
+    // Rollback a specific mutation by ID, return baseline
+    rollbackById(mutationId) {
+        for (const [path, mutations] of this.pending) {
+            const idx = mutations.findIndex(m => m.id === mutationId);
+            if (idx !== -1) {
+                const baseline = mutations[idx].baseline;
+                mutations.splice(idx, 1);
+                if (mutations.length === 0)
+                    this.pending.delete(path);
+                return baseline;
+            }
+        }
+        return undefined;
+    }
+    // Get the optimistic view: base node with all pending mutations applied
+    getOptimistic(path) {
+        const mutations = this.pending.get(path);
+        if (!mutations || mutations.length === 0)
+            return undefined;
+        return mutations[mutations.length - 1].predicted;
+    }
+    hasPending(path) {
+        const m = this.pending.get(path);
+        return !!m && m.length > 0;
+    }
+    getPendingCount(path) {
+        if (path)
+            return this.pending.get(path)?.length ?? 0;
+        let total = 0;
+        for (const m of this.pending.values())
+            total += m.length;
+        return total;
+    }
+    // Expire mutations older than maxAge ms
+    expire(maxAge) {
+        const now = Date.now();
+        const expired = [];
+        for (const [path, mutations] of this.pending) {
+            const before = mutations.length;
+            const remaining = mutations.filter(m => now - m.createdAt < maxAge);
+            if (remaining.length < before) {
+                expired.push(...mutations.filter(m => now - m.createdAt >= maxAge).map(m => m.id));
+            }
+            if (remaining.length === 0)
+                this.pending.delete(path);
+            else
+                this.pending.set(path, remaining);
+        }
+        return expired;
+    }
+    clear() {
+        this.pending.clear();
+    }
+}
+// ── Helpers ──
+// Deep equality check for node data (ignoring $rev which server increments)
+function nodesMatch(a, b) {
+    const aClean = withoutRev(a);
+    const bClean = withoutRev(b);
+    return JSON.stringify(aClean) === JSON.stringify(bClean);
+}
+function withoutRev(node) {
+    const { $rev, ...rest } = node;
+    return rest;
+}
+//# sourceMappingURL=optimistic.js.map

package/dist/mod/optimistic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimistic.js","sourceRoot":"","sources":["../../src/mod/optimistic.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,uFAAuF;AACvF,kEAAkE;AAElE,OAAO,EAAE,YAAY,EAAiB,MAAM,OAAO,CAAC;AAcpD,MAAM,OAAO,gBAAgB;IACnB,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IAC/C,SAAS,GAAG,CAAC,CAAC;IAEtB,2EAA2E;IAC3E,KAAK,CACH,IAAc,EACd,QAAgB,EAChB,MAAc,EACd,MAA4C,EAC5C,IAAa;QAEb,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QAEpC,wDAAwD;QACxD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,QAAQ,uBAAuB,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAExF,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAErB,MAAM,EAAE,GAAG,OAAO,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAoB;YAChC,EAAE;YACF,IAAI,EAAE,IAAI,CAAC,KAAK;YAChB,QAAQ;YACR,MAAM;YACN,SAAS,EAAE,KAAK;YAChB,QAAQ;YACR,MAAM;YACN,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QAEF,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE7C,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC9C,CAAC;IAED,kEAAkE;IAClE,6DAA6D;IAC7D,OAAO,CAAC,IAAY,EAAE,UAAoB;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACjD,CAAC;QAED,wEAAwE;QACxE,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAE3B,4CAA4C;QAC5C,IAAI,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5C,8CAA8C;YAC9C,SAAS,CAAC,KAAK,EAAE,CAAC;YAClB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAEtD,gEAAgE;YAChE,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;YACpE,CAAC;YACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QACjD,CAAC;QAED,qEAAqE;QACrE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAChD,CAAC;IAED,wDAAwD;IAChD,MAAM,CAAC,IAAY,EAAE,IAAc;QACzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEtD,sDAAsD;QACtD,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,MAAM,SAAS,GAAsB,EAAE,CAAC;QAExC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;gBACvC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;gBAC/C,IAAI,CAAC,MAAM;oBAAE,SAAS;gBAEtB,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;gBACzB,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC;gBACrB,CAAC,CAAC,SAAS,GAAG,KAAK,CAAC;gBACpB,OAAO,GAAG,KAAK,CAAC;gBAChB,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;YAAC,MAAM,CAAC;gBACP,iDAAiD;YACnD,CAAC;QACH,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;;YACjD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAEvC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,oCAAoC;IACpC,WAAW,CAAC,UAAkB;QAC5B,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7C,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;YAC1D,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBACf,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBACzB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;oBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACtD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,4CAA4C;IAC5C,QAAQ,CAAC,IAAY;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3D,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC1B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,sDAAsD;IACtD,YAAY,CAAC,UAAkB;QAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7C,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;YAC1D,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBACf,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;gBACzC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBACzB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;oBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACtD,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,wEAAwE;IACxE,aAAa,CAAC,IAAY;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAC3D,OAAO,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACnD,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,eAAe,CAAC,IAAa;QAC3B,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC;QACrD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAAE,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,wCAAwC;IACxC,MAAM,CAAC,MAAc;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;YAChC,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,GAAG,MAAM,CAAC,CAAC;YACpE,IAAI,SAAS,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;gBAC9B,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACrF,CAAC;YACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;;gBACjD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF;AAED,gBAAgB;AAGhB,4EAA4E;AAC5E,SAAS,UAAU,CAAC,CAAW,EAAE,CAAW;IAC1C,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,UAAU,CAAC,IAAc;IAChC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,IAAW,CAAC;IACtC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/mod/prefab.d.ts

@@ -0,0 +1,18 @@
+import { type NodeData } from '#core';
+export type PrefabSetup = (nodes: NodeData[], params?: unknown) => NodeData[] | Promise<NodeData[]>;
+export type PrefabMeta = {
+    tier?: 'core';
+};
+export type PrefabEntry = {
+    nodes: NodeData[];
+    setup?: PrefabSetup;
+    meta?: PrefabMeta;
+};
+export declare function registerPrefab(mod: string, name: string, nodes: NodeData[], setup?: PrefabSetup, meta?: PrefabMeta): void;
+export declare function getPrefab(mod: string, name: string): PrefabEntry | undefined;
+export declare function getModPrefabs(mod: string): [string, PrefabEntry][];
+export declare function getRegisteredMods(): string[];
+/** All seed prefabs: [mod, PrefabEntry][] */
+export declare function getSeedPrefabs(): [string, PrefabEntry][];
+export declare function clearPrefabs(): void;
+//# sourceMappingURL=prefab.d.ts.map

package/dist/mod/prefab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefab.d.ts","sourceRoot":"","sources":["../../src/mod/prefab.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,QAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;AAEpG,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;CACnB,CAAC;AAKF,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,QAAQ,EAAE,EACjB,KAAK,CAAC,EAAE,WAAW,EACnB,IAAI,CAAC,EAAE,UAAU,GAChB,IAAI,CAIN;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE5E;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAMlE;AAED,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAI5C;AAED,6CAA6C;AAC7C,wBAAgB,cAAc,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAMxD;AAGD,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

package/dist/mod/prefab.js

@@ -0,0 +1,42 @@
+// Treenity Prefab Registry — in-memory store for module prefab declarations
+// Modules call registerPrefab() during import; mods-mount exposes data as virtual tree.
+// Prefabs named 'seed' are auto-deployed at startup by deploySeedPrefabs().
+// Key: "mod/name"
+const prefabs = new Map();
+export function registerPrefab(mod, name, nodes, setup, meta) {
+    const key = `${mod}/${name}`;
+    if (prefabs.has(key))
+        return; // sealed, like registry
+    prefabs.set(key, { nodes, setup, meta });
+}
+export function getPrefab(mod, name) {
+    return prefabs.get(`${mod}/${name}`);
+}
+export function getModPrefabs(mod) {
+    const result = [];
+    for (const [k, v] of prefabs) {
+        if (k.startsWith(mod + '/'))
+            result.push([k.slice(mod.length + 1), v]);
+    }
+    return result;
+}
+export function getRegisteredMods() {
+    const mods = new Set();
+    for (const k of prefabs.keys())
+        mods.add(k.split('/')[0]);
+    return [...mods];
+}
+/** All seed prefabs: [mod, PrefabEntry][] */
+export function getSeedPrefabs() {
+    const result = [];
+    for (const [k, v] of prefabs) {
+        if (k.endsWith('/seed'))
+            result.push([k.split('/')[0], v]);
+    }
+    return result;
+}
+// For tests
+export function clearPrefabs() {
+    prefabs.clear();
+}
+//# sourceMappingURL=prefab.js.map

package/dist/mod/prefab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefab.js","sourceRoot":"","sources":["../../src/mod/prefab.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,wFAAwF;AACxF,4EAA4E;AAc5E,kBAAkB;AAClB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;AAE/C,MAAM,UAAU,cAAc,CAC5B,GAAW,EACX,IAAY,EACZ,KAAiB,EACjB,KAAmB,EACnB,IAAiB;IAEjB,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,wBAAwB;IACtD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,IAAY;IACjD,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE;QAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;AACnB,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,YAAY;AACZ,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}

package/dist/mod/tracking.d.ts

@@ -0,0 +1,8 @@
+export declare function setCurrentMod(name: string | null): void;
+export declare function getCurrentMod(): string | null;
+export declare function trackType(typeName: string): void;
+export declare function getTypesForMod(modName: string): string[];
+/** Infer mod name from type name: tracked → exact; else first segment + alias lookup */
+export declare function inferModFromType(typeName: string): string;
+export declare function clearTracking(): void;
+//# sourceMappingURL=tracking.d.ts.map

package/dist/mod/tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/mod/tracking.ts"],"names":[],"mappings":"AAeA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEvD;AAED,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAMxD;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMzD;AAGD,wBAAgB,aAAa,IAAI,IAAI,CAGpC"}

package/dist/mod/tracking.js

@@ -0,0 +1,44 @@
+// Type→Mod tracking — runtime map of which mod registered which types
+// setCurrentMod() wraps import() in loader; trackType() called from registerType.
+// Convention fallback: first segment of type name = mod name (cafe.contact → cafe).
+let currentMod = null;
+// type → mod name
+const typeToMod = new Map();
+// Aliases for types whose first segment ≠ mod dir name
+const MOD_ALIASES = {
+    order: 'orders',
+    pult: 'pult',
+};
+export function setCurrentMod(name) {
+    currentMod = name;
+}
+export function getCurrentMod() {
+    return currentMod;
+}
+export function trackType(typeName) {
+    if (currentMod) {
+        typeToMod.set(typeName, currentMod);
+    }
+}
+export function getTypesForMod(modName) {
+    const types = [];
+    for (const [type, mod] of typeToMod) {
+        if (mod === modName)
+            types.push(type);
+    }
+    return types;
+}
+/** Infer mod name from type name: tracked → exact; else first segment + alias lookup */
+export function inferModFromType(typeName) {
+    const tracked = typeToMod.get(typeName);
+    if (tracked)
+        return tracked;
+    const first = typeName.split('.')[0];
+    return MOD_ALIASES[first] ?? first;
+}
+// For tests
+export function clearTracking() {
+    typeToMod.clear();
+    currentMod = null;
+}
+//# sourceMappingURL=tracking.js.map

package/dist/mod/tracking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.js","sourceRoot":"","sources":["../../src/mod/tracking.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,kFAAkF;AAClF,oFAAoF;AAEpF,IAAI,UAAU,GAAkB,IAAI,CAAC;AAErC,kBAAkB;AAClB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;AAE5C,uDAAuD;AACvD,MAAM,WAAW,GAA2B;IAC1C,KAAK,EAAE,QAAQ;IACf,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAmB;IAC/C,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,IAAI,UAAU,EAAE,CAAC;QACf,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,SAAS,EAAE,CAAC;QACpC,IAAI,GAAG,KAAK,OAAO;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;AACrC,CAAC;AAED,YAAY;AACZ,MAAM,UAAU,aAAa;IAC3B,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC"}

package/dist/mod/types.d.ts

@@ -0,0 +1,31 @@
+import type { Tree } from '#tree';
+export interface TreenityMod {
+    name: string;
+    dependencies?: string[];
+    server?: () => Promise<unknown>;
+    client?: () => Promise<unknown>;
+    seed?: (store: Tree) => Promise<void>;
+    onLoad?: () => void | Promise<void>;
+    onUnload?: () => void | Promise<void>;
+}
+export interface ModManifest {
+    name: string;
+    version: string;
+    types?: string[];
+    dependencies?: string[];
+    server?: string;
+    client?: string;
+    seed?: string;
+    packagePath?: string;
+}
+export type ModState = 'discovered' | 'loading' | 'loaded' | 'failed' | 'disabled';
+export interface LoadedMod {
+    manifest?: ModManifest;
+    mod?: TreenityMod;
+    name: string;
+    state: ModState;
+    error?: Error;
+    loadedAt?: number;
+}
+export declare function defineMod(mod: TreenityMod): TreenityMod;
+//# sourceMappingURL=types.d.ts.map

package/dist/mod/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/mod/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAElC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAGD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEnF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CAEvD"}

package/dist/mod/types.js

@@ -0,0 +1,5 @@
+// Treenity Module System — type definitions
+export function defineMod(mod) {
+    return mod;
+}
+//# sourceMappingURL=types.js.map

package/dist/mod/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/mod/types.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAqC5C,MAAM,UAAU,SAAS,CAAC,GAAgB;IACxC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/mod.d.ts

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

package/dist/mod.d.ts.map

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

package/dist/mod.js

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

package/dist/mod.js.map

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

package/dist/mods/autostart/server.d.ts

@@ -0,0 +1,2 @@
+import './service';
+//# sourceMappingURL=server.d.ts.map

package/dist/mods/autostart/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/mods/autostart/server.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,CAAC"}

package/dist/mods/autostart/server.js

@@ -0,0 +1,2 @@
+import './service';
+//# sourceMappingURL=server.js.map

package/dist/mods/autostart/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/mods/autostart/server.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,CAAC"}

package/dist/mods/autostart/service.d.ts

@@ -0,0 +1,14 @@
+export declare function startService(path: string): Promise<void>;
+export declare function stopService(path: string): Promise<void>;
+/** Service lifecycle manager — start/stop services via ref children */
+export declare class Autostart {
+    /** @description Start a service at given path */
+    start(data: {
+        path: string;
+    }): Promise<void>;
+    /** @description Stop a service at given path */
+    stop(data: {
+        path: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/mods/autostart/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/mods/autostart/service.ts"],"names":[],"mappings":"AAuCA,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAa9D;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS7D;AAED,uEAAuE;AACvE,qBAAa,SAAS;IACpB,iDAAiD;IAC3C,KAAK,CAAC,IAAI,EAAE;QAA0B,IAAI,EAAE,MAAM,CAAA;KAAE;IAC1D,gDAAgD;IAC1C,IAAI,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;CAClC"}

package/dist/mods/autostart/service.js

@@ -0,0 +1,88 @@
+// Autostart — service coordinator with dynamic start/stop
+// Walks children at boot, tracks handles, exposes start/stop actions
+// Tree = truth: ref child exists ↔ service is running
+import { registerType } from '#comp';
+import { isRef, register, resolve as coreResolve } from '#core';
+import { resolveRef } from '#tree';
+// ── Module-scope service tracking ──
+const handles = new Map();
+let _svcCtx = null;
+let _autostartPath = '/sys/autostart';
+async function _startService(path) {
+    if (handles.has(path))
+        return;
+    if (!_svcCtx)
+        throw new Error('autostart: not initialized');
+    const node = await _svcCtx.store.get(path);
+    if (!node)
+        throw new Error(`autostart: node not found: ${path}`);
+    const handler = coreResolve(node.$type, 'service');
+    if (!handler)
+        throw new Error(`autostart: no service handler for ${node.$type}`);
+    handles.set(path, await handler(node, _svcCtx));
+    console.log(`[autostart] started ${path}`);
+}
+async function _stopService(path) {
+    const h = handles.get(path);
+    if (!h)
+        return;
+    await h.stop();
+    handles.delete(path);
+    console.log(`[autostart] stopped ${path}`);
+}
+// ── Public API — direct import for server code, typed actions for MCP/tRPC ──
+export async function startService(path) {
+    if (!_svcCtx)
+        throw new Error('autostart: not initialized');
+    if (handles.has(path))
+        return;
+    // Add ref child → tree reflects reality
+    const name = path.split('/').filter(Boolean).join('-');
+    const refPath = `${_autostartPath}/${name}`;
+    const existing = await _svcCtx.store.get(refPath);
+    if (!existing) {
+        await _svcCtx.store.set({ $path: refPath, $type: 'ref', $ref: path });
+    }
+    await _startService(path);
+}
+export async function stopService(path) {
+    if (!_svcCtx)
+        throw new Error('autostart: not initialized');
+    await _stopService(path);
+    // Remove ref child → tree reflects reality
+    const { items } = await _svcCtx.store.getChildren(_autostartPath);
+    const ref = items.find(n => isRef(n) && n.$ref === path);
+    if (ref)
+        await _svcCtx.store.remove(ref.$path);
+}
+/** Service lifecycle manager — start/stop services via ref children */
+export class Autostart {
+    /** @description Start a service at given path */
+    async start(data) { await startService(data.path); }
+    /** @description Stop a service at given path */
+    async stop(data) { await stopService(data.path); }
+}
+registerType('autostart', Autostart);
+// ── Boot service handler ──
+register('autostart', 'service', async (node, ctx) => {
+    _svcCtx = ctx;
+    _autostartPath = node.$path;
+    const { items } = await ctx.store.getChildren(node.$path);
+    for (const child of items) {
+        try {
+            const target = await resolveRef(ctx.store, child);
+            await _startService(target.$path);
+        }
+        catch (e) {
+            console.error(`[autostart] failed ${child.$path}:`, e);
+        }
+    }
+    return {
+        stop: async () => {
+            for (const path of [...handles.keys()]) {
+                await _stopService(path).catch(console.error);
+            }
+        },
+    };
+});
+//# sourceMappingURL=service.js.map

package/dist/mods/autostart/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/mods/autostart/service.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,qEAAqE;AACrE,sDAAsD;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAErC,OAAO,EAAE,KAAK,EAAiB,QAAQ,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,OAAO,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEnC,sCAAsC;AAEtC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;AACjD,IAAI,OAAO,GAAsB,IAAI,CAAC;AACtC,IAAI,cAAc,GAAG,gBAAgB,CAAC;AAEtC,KAAK,UAAU,aAAa,CAAC,IAAY;IACvC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO;IAC9B,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAE5D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;IAEjE,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACnD,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAEjF,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY;IACtC,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,CAAC;QAAE,OAAO;IACf,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IACf,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,+EAA+E;AAE/E,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY;IAC7C,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAC5D,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO;IAE9B,wCAAwC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,GAAG,cAAc,IAAI,IAAI,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAc,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAE5D,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAEzB,2CAA2C;IAC3C,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC;IAClE,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACzD,IAAI,GAAG;QAAE,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AACjD,CAAC;AAED,uEAAuE;AACvE,MAAM,OAAO,SAAS;IACpB,iDAAiD;IACjD,KAAK,CAAC,KAAK,CAAC,IAA8C,IAAI,MAAM,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9F,gDAAgD;IAChD,KAAK,CAAC,IAAI,CAAC,IAAsB,IAAI,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CACrE;AACD,YAAY,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAErC,6BAA6B;AAE7B,QAAQ,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IACnD,OAAO,GAAG,GAAG,CAAC;IACd,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC;IAE5B,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAClD,MAAM,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,KAAK,CAAC,sBAAsB,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBACvC,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/mods/clients.d.ts

@@ -0,0 +1,2 @@
+import './uix/client';
+//# sourceMappingURL=clients.d.ts.map

package/dist/mods/clients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.d.ts","sourceRoot":"","sources":["../../src/mods/clients.ts"],"names":[],"mappings":"AACA,OAAO,cAAc,CAAC"}

package/dist/mods/clients.js

@@ -0,0 +1,3 @@
+// Barrel: all core mod client registrations
+import './uix/client';
+//# sourceMappingURL=clients.js.map

package/dist/mods/clients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clients.js","sourceRoot":"","sources":["../../src/mods/clients.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,cAAc,CAAC"}

package/dist/mods/llm/index.d.ts

@@ -0,0 +1,13 @@
+import { type ActionCtx } from '#server/actions';
+export type TypeInfo = {
+    type: string;
+    schema: Record<string, unknown> | null;
+    contexts: string[];
+    actions: string[];
+};
+export type SchemaExport = {
+    types: TypeInfo[];
+};
+export declare function exportSchemaForLLM(): SchemaExport;
+export declare function describeTree(ctx: ActionCtx, data: unknown): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/mods/llm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mods/llm/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAC;AAEjD,wBAAgB,kBAAkB,IAAI,YAAY,CAcjD;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBjF"}

package/dist/mods/llm/index.js

@@ -0,0 +1,43 @@
+// Treenity LLM Context — Layer 6
+// Schema export + tree description for LLM consumption
+// Type: t.llm — node at /llm, actions: schema, describe
+import { getContextsForType, getRegisteredTypes, register, resolve } from '#core';
+import { basename } from '#core/path';
+export function exportSchemaForLLM() {
+    const types = getRegisteredTypes();
+    return {
+        types: types.map((type) => {
+            const contexts = getContextsForType(type);
+            const schemaHandler = resolve(type, 'schema');
+            return {
+                type,
+                schema: schemaHandler ? schemaHandler() : null,
+                contexts: contexts.filter((c) => !c.startsWith('action:')),
+                actions: contexts.filter((c) => c.startsWith('action:')).map((c) => c.slice(7)),
+            };
+        }),
+    };
+}
+export async function describeTree(ctx, data) {
+    const depth = Number(data?.depth) || 3;
+    const path = ctx.node.$path;
+    const lines = [];
+    async function walk(p, indent, remaining) {
+        if (remaining <= 0)
+            return;
+        const { items } = await ctx.store.getChildren(p);
+        items.sort((a, b) => a.$path.localeCompare(b.$path));
+        for (const child of items) {
+            lines.push(`${'  '.repeat(indent)}${basename(child.$path)} (${child.$type})`);
+            await walk(child.$path, indent + 1, remaining - 1);
+        }
+    }
+    lines.push(`${path} (${ctx.node.$type})`);
+    await walk(path, 1, depth);
+    return lines.join('\n');
+}
+/** @description Export all registered types with schemas, contexts, and actions for LLM consumption */
+register('t.llm', 'action:schema', () => exportSchemaForLLM());
+/** @description Describe the subtree under this node as indented text (depth-limited) */
+register('t.llm', 'action:describe', describeTree);
+//# sourceMappingURL=index.js.map

package/dist/mods/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mods/llm/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,uDAAuD;AACvD,wDAAwD;AAExD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAClF,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAYtC,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACxB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC9C,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,aAAa,CAAC,CAAC,CAAE,aAAa,EAA8B,CAAC,CAAC,CAAC,IAAI;gBAC3E,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;gBAC1D,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aAChF,CAAC;QACJ,CAAC,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAc,EAAE,IAAa;IAC9D,MAAM,KAAK,GAAG,MAAM,CAAE,IAAgC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;IAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,UAAU,IAAI,CAAC,CAAS,EAAE,MAAc,EAAE,SAAiB;QAC9D,IAAI,SAAS,IAAI,CAAC;YAAE,OAAO;QAC3B,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QACjD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACrD,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;YAC9E,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IAC1C,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,uGAAuG;AACvG,QAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,kBAAkB,EAAE,CAAC,CAAC;AAC/D,yFAAyF;AACzF,QAAQ,CAAC,OAAO,EAAE,iBAAiB,EAAE,YAAY,CAAC,CAAC"}

package/dist/mods/llm/server.d.ts

@@ -0,0 +1,2 @@
+import './index';
+//# sourceMappingURL=server.d.ts.map

package/dist/mods/llm/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/mods/llm/server.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,CAAC"}

package/dist/mods/llm/server.js

@@ -0,0 +1,2 @@
+import './index';
+//# sourceMappingURL=server.js.map

package/dist/mods/llm/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/mods/llm/server.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,CAAC"}

package/dist/mods/mcp/server.d.ts

@@ -0,0 +1,2 @@
+import './types';
+import './service';

package/dist/mods/mcp/server.js

@@ -0,0 +1,2 @@
+import './types';
+import './service';

package/dist/mods/mcp/service.d.ts

@@ -0,0 +1 @@
+export {};