@unoverse-platform/spatial 1.0.0

package/dist/SpatialSearch/node/executor.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Spatial Search executor. A service node: it has no data-flow execution — it answers the
+ * MCP/tool channel (handleServiceCall) so a wired agent can discover (getSchema) and run
+ * (findIntent / discoverRelated) spatial searches. All real work is an HTTP call behind the
+ * platform's authenticated API.
+ */
+import { type NodeExecutionContext } from "@unoverse-platform/plugin-base";
+import { PromiseNode } from "../../shared/platform";
+import type { SpatialSearchConfig } from "../util/types";
+export default class SpatialSearchExecutor extends PromiseNode<SpatialSearchConfig> {
+    constructor();
+    protected executeNode(): Promise<any>;
+    handleServiceCall(method: string, params: any, config: SpatialSearchConfig, context: NodeExecutionContext): Promise<any>;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/SpatialSearch/node/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/SpatialSearch/node/executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,OAAO,EAAE,WAAW,EAAgB,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAkB,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAMzE,MAAM,CAAC,OAAO,OAAO,qBAAsB,SAAQ,WAAW,CAAC,mBAAmB,CAAC;;cAKjE,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC;IAMrC,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,GAAG,CAAC;CA2DhB"}

package/dist/SpatialSearch/node/executor.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const agent_mcp_1 = require("@unoverse-platform/plugin-base/agent-mcp");
+const platform_1 = require("../../shared/platform");
+const searchClient_1 = require("../service/searchClient");
+const skillClient_1 = require("../service/skillClient");
+const NODE_TYPE = "SpatialSearch";
+class SpatialSearchExecutor extends platform_1.PromiseNode {
+    constructor() {
+        super(NODE_TYPE);
+    }
+    async executeNode() {
+        throw new Error("SpatialSearch is a service node — attach it to an agent via a service edge; it is not run inline.");
+    }
+    async handleServiceCall(method, params, config, context) {
+        const logger = (0, platform_1.createLogger)("SpatialSearch");
+        // Tool discovery.
+        if (method === "getSchema")
+            return searchClient_1.SPATIAL_SCHEMA;
+        // Skill tools — read a discovered skill's instructions / a referenced resource file.
+        if (method === "readSkill")
+            return (0, skillClient_1.readSkill)(params, context);
+        if (method === "readSkillFile")
+            return (0, skillClient_1.readSkillFile)(params, context);
+        const mode = (0, searchClient_1.modeForMethod)(method);
+        if (!mode)
+            throw new Error(`SpatialSearch: unknown method "${method}"`);
+        // Author-set result filters (from node config) shape what the agent's search returns.
+        const filters = {
+            includeImages: config?.includeImages,
+            includeNeeds: config?.includeNeeds,
+            includeServices: config?.includeServices,
+            includeActions: config?.includeActions,
+            includeSkills: config?.includeSkills,
+            includeMcps: config?.includeMcps,
+        };
+        // maxResults + threshold + filters come from the NODE CONFIG (authoritative) — never from the agent's args.
+        const result = await (0, searchClient_1.runSearch)(mode, {
+            query: params?.query,
+            maxResults: config?.maxResults,
+            similarityThreshold: config?.similarityThreshold,
+            filters,
+        }, context);
+        logger.info("spatial search complete", { method, count: result.results?.length ?? 0 });
+        // CONTENT CARDS render DATA-DRIVEN, from the search that surfaced them
+        // (UNOVERSE_MCP_TEMPLATE_PROTOCOL §4b): a result row with a component app
+        // attached (`metadata.app`) renders its card on the caller's live session the
+        // moment it surfaces — never as a model tool, no prompt anywhere. The lane
+        // lives HERE so EVERY agent family gets it by wiring this node. The session
+        // identity is the execution's `publishingContext` (trigger-supplied); with no
+        // live session (builder/test/headless callers) rendering no-ops and the
+        // search stays pure. Author opt-out: node config `renderCards: false`.
+        if (config?.renderCards !== false) {
+            const pub = context?.publishingContext;
+            (0, agent_mcp_1.renderContentCards)((0, agent_mcp_1.contentCardsFromResults)(result.results), {
+                userId: pub?.userId,
+                conversationId: pub?.conversationId,
+                chatId: pub?.chatId,
+                accessToken: context?.auth?.accessToken,
+            }, (m) => logger.info(m));
+        }
+        return result;
+    }
+}
+exports.default = SpatialSearchExecutor;
+//# sourceMappingURL=executor.js.map

package/dist/SpatialSearch/node/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/SpatialSearch/node/executor.ts"],"names":[],"mappings":";;AAOA,wEAAuG;AACvG,oDAAkE;AAElE,0DAAmF;AACnF,wDAAkE;AAElE,MAAM,SAAS,GAAG,eAAe,CAAC;AAElC,MAAqB,qBAAsB,SAAQ,sBAAgC;IACjF;QACE,KAAK,CAAC,SAAS,CAAC,CAAC;IACnB,CAAC;IAES,KAAK,CAAC,WAAW;QACzB,MAAM,IAAI,KAAK,CACb,mGAAmG,CACpG,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,MAAc,EACd,MAAW,EACX,MAA2B,EAC3B,OAA6B;QAE7B,MAAM,MAAM,GAAG,IAAA,uBAAY,EAAC,eAAe,CAAC,CAAC;QAE7C,kBAAkB;QAClB,IAAI,MAAM,KAAK,WAAW;YAAE,OAAO,6BAAc,CAAC;QAElD,qFAAqF;QACrF,IAAI,MAAM,KAAK,WAAW;YAAE,OAAO,IAAA,uBAAS,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,MAAM,KAAK,eAAe;YAAE,OAAO,IAAA,2BAAa,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAEtE,MAAM,IAAI,GAAG,IAAA,4BAAa,EAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,MAAM,GAAG,CAAC,CAAC;QAExE,sFAAsF;QACtF,MAAM,OAAO,GAAmB;YAC9B,aAAa,EAAE,MAAM,EAAE,aAAa;YACpC,YAAY,EAAE,MAAM,EAAE,YAAY;YAClC,eAAe,EAAE,MAAM,EAAE,eAAe;YACxC,cAAc,EAAE,MAAM,EAAE,cAAc;YACtC,aAAa,EAAE,MAAM,EAAE,aAAa;YACpC,WAAW,EAAE,MAAM,EAAE,WAAW;SACjC,CAAC;QAEF,4GAA4G;QAC5G,MAAM,MAAM,GAAG,MAAM,IAAA,wBAAS,EAC5B,IAAI,EACJ;YACE,KAAK,EAAE,MAAM,EAAE,KAAK;YACpB,UAAU,EAAE,MAAM,EAAE,UAAU;YAC9B,mBAAmB,EAAE,MAAM,EAAE,mBAAmB;YAChD,OAAO;SACR,EACD,OAAO,CACR,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QAEvF,uEAAuE;QACvE,0EAA0E;QAC1E,8EAA8E;QAC9E,2EAA2E;QAC3E,4EAA4E;QAC5E,8EAA8E;QAC9E,wEAAwE;QACxE,uEAAuE;QACvE,IAAI,MAAM,EAAE,WAAW,KAAK,KAAK,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,OAAO,EAAE,iBAAiB,CAAC;YACvC,IAAA,8BAAkB,EAChB,IAAA,mCAAuB,EAAC,MAAM,CAAC,OAAO,CAAC,EACvC;gBACE,MAAM,EAAE,GAAG,EAAE,MAAM;gBACnB,cAAc,EAAE,GAAG,EAAE,cAAc;gBACnC,MAAM,EAAE,GAAG,EAAE,MAAM;gBACnB,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW;aACxC,EACD,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAC9B,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA3ED,wCA2EC"}

package/dist/SpatialSearch/node/index.d.ts

@@ -0,0 +1,10 @@
+import { type EnhancedNodeDefinition } from "@unoverse-platform/plugin-base";
+import SpatialSearchExecutor from "./executor";
+export declare const NODE_TYPE = "SpatialSearch";
+declare function createNodeDefinition(): EnhancedNodeDefinition;
+export declare const SpatialSearchNode: {
+    definition: any;
+    executor: typeof SpatialSearchExecutor;
+};
+export { createNodeDefinition };
+//# sourceMappingURL=index.d.ts.map

package/dist/SpatialSearch/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/SpatialSearch/node/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,qBAAqB,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,SAAS,kBAAkB,CAAC;AAEzC,iBAAS,oBAAoB,IAAI,sBAAsB,CAkEtD;AAID,eAAO,MAAM,iBAAiB;;;CAG7B,CAAC;AAEF,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/SpatialSearch/node/index.js

@@ -0,0 +1,79 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpatialSearchNode = exports.NODE_TYPE = void 0;
+exports.createNodeDefinition = createNodeDefinition;
+const executor_1 = __importDefault(require("./executor"));
+exports.NODE_TYPE = "SpatialSearch";
+function createNodeDefinition() {
+    return {
+        packageVersion: "1.0.0",
+        type: exports.NODE_TYPE,
+        name: "Spatial Search",
+        description: "Search the platform knowledge base for the needs, skills, services and content most relevant to a query.",
+        whenToUse: "Pick to give an agent semantic search over the platform's own knowledge base — find the needs, skills, services and content most relevant to a query, and discover what else lives near a topic. Two tools in one: precise intent lookup and spatial discovery. Reach elsewhere when the knowledge lives in an external vector store. Attach via a service edge to the agent node; it is not a data-flow step.",
+        category: "Knowledge & Vectors",
+        color: "#8b5cf6",
+        logoUrl: "https://res.cloudinary.com/sonik/image/upload/v1751366180/gravity/icons/gravityIcon.png",
+        template: "service",
+        inputs: [],
+        outputs: [],
+        serviceConnectors: [
+            {
+                name: "knowledgeSearch",
+                description: "Semantic + spatial search tools for an agent",
+                serviceType: "mcp",
+                methods: ["getSchema", "findIntent", "discoverRelated", "readSkill", "readSkillFile"],
+                isService: true, // PROVIDES search tools to a consuming agent
+            },
+        ],
+        // Ported from the legacy core SpatialSearch: the author shapes what an agent's searches
+        // return (result types, thresholds, caps). No credential — the node calls the platform's
+        // own search API internally and forwards the request's auth token.
+        configSchema: {
+            type: "object",
+            properties: {
+                maxResults: {
+                    type: "integer",
+                    title: "Max Results",
+                    description: "Maximum total results to return (safety cap)",
+                    default: 10,
+                    minimum: 5,
+                    maximum: 30,
+                },
+                similarityThreshold: {
+                    type: "number",
+                    title: "Min Similarity (Intent)",
+                    description: "Precision floor for findIntent (0–0.9). Results scoring below this cosine similarity are dropped. Discovery is unaffected (it ranks by spatial distance).",
+                    default: 0.35,
+                    minimum: 0,
+                    maximum: 0.9,
+                },
+                includeImages: { type: "boolean", title: "Include Images", description: "Fetch images from results", default: false },
+                includeNeeds: { type: "boolean", title: "Include Needs", description: "Fetch needs from results", default: false },
+                includeServices: { type: "boolean", title: "Include Services", description: "Fetch services from results", default: false },
+                includeActions: { type: "boolean", title: "Include Actions", description: "Fetch actions from results", default: false },
+                includeSkills: { type: "boolean", title: "Include Skills", description: "Fetch skills (behavioral instructions)", default: true },
+                includeMcps: { type: "boolean", title: "Include MCP", description: "Fetch MCP workflows from results", default: false },
+                renderCards: {
+                    type: "boolean",
+                    title: "Render Content Cards",
+                    description: "Auto-render cards for result rows that carry a component app (metadata.app) — data-driven, in the caller's conversation. No-ops for callers without a live session.",
+                    default: true,
+                },
+            },
+            required: [],
+        },
+        capabilities: {
+            isTrigger: false,
+        },
+    };
+}
+const definition = createNodeDefinition();
+exports.SpatialSearchNode = {
+    definition,
+    executor: executor_1.default,
+};
+//# sourceMappingURL=index.js.map

package/dist/SpatialSearch/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/SpatialSearch/node/index.ts"],"names":[],"mappings":";;;;;;AAgFS,oDAAoB;AA/E7B,0DAA+C;AAElC,QAAA,SAAS,GAAG,eAAe,CAAC;AAEzC,SAAS,oBAAoB;IAC3B,OAAO;QACL,cAAc,EAAE,OAAO;QACvB,IAAI,EAAE,iBAAS;QACf,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,0GAA0G;QACvH,SAAS,EACP,gZAAgZ;QAClZ,QAAQ,EAAE,qBAAqB;QAC/B,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,yFAAyF;QAClG,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;QACX,iBAAiB,EAAE;YACjB;gBACE,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EAAE,8CAA8C;gBAC3D,WAAW,EAAE,KAAK;gBAClB,OAAO,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,CAAC;gBACrF,SAAS,EAAE,IAAI,EAAE,6CAA6C;aAC/D;SACF;QACD,wFAAwF;QACxF,yFAAyF;QACzF,mEAAmE;QACnE,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,UAAU,EAAE;oBACV,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE,aAAa;oBACpB,WAAW,EAAE,8CAA8C;oBAC3D,OAAO,EAAE,EAAE;oBACX,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,EAAE;iBACZ;gBACD,mBAAmB,EAAE;oBACnB,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE,yBAAyB;oBAChC,WAAW,EACT,2JAA2J;oBAC7J,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,CAAC;oBACV,OAAO,EAAE,GAAG;iBACb;gBACD,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,2BAA2B,EAAE,OAAO,EAAE,KAAK,EAAE;gBACrH,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,0BAA0B,EAAE,OAAO,EAAE,KAAK,EAAE;gBAClH,eAAe,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,6BAA6B,EAAE,OAAO,EAAE,KAAK,EAAE;gBAC3H,cAAc,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,4BAA4B,EAAE,OAAO,EAAE,KAAK,EAAE;gBACxH,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,wCAAwC,EAAE,OAAO,EAAE,IAAI,EAAE;gBACjI,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,kCAAkC,EAAE,OAAO,EAAE,KAAK,EAAE;gBACvH,WAAW,EAAE;oBACX,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE,sBAAsB;oBAC7B,WAAW,EACT,qKAAqK;oBACvK,OAAO,EAAE,IAAI;iBACd;aACF;YACD,QAAQ,EAAE,EAAE;SACb;QACD,YAAY,EAAE;YACZ,SAAS,EAAE,KAAK;SACjB;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG,oBAAoB,EAAE,CAAC;AAE7B,QAAA,iBAAiB,GAAG;IAC/B,UAAU;IACV,QAAQ,EAAE,kBAAqB;CAChC,CAAC"}

package/dist/SpatialSearch/service/searchClient.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Spatial search client — the ONLY thing this node does: call the platform's authenticated
+ * spatial search API over HTTP. No DB, no engine internals (that all stays behind the API).
+ *
+ * Auth: forward the end-user's session token (context.auth.accessToken) as Bearer by default
+ * (Case A, shared IdP); if the connection credential carries a machine `apiKey`, use that
+ * instead (Case B, cross-domain).
+ */
+import type { SpatialFilters, SpatialMode, SpatialSearchResponse } from "../util/types";
+/** The two search tools this node exposes to an agent (mirrors the platform's spatial MCP). */
+export declare const SPATIAL_SCHEMA: {
+    readonly instructions: "You have access to the platform knowledge base with two search tools that answer DIFFERENT questions. Choose one based on the shape of the user's request — do not call both by default.\n\nKNOWLEDGE PROTOCOL (MANDATORY — do not skip):\n\nPhase 0 — Choose ONE search tool (think before calling):\n- findIntent = PRECISION. Answers \"what is the user asking for?\" — pinpoints the specific matches for a concrete request, pulled from wherever they live in the knowledge space. This is the DEFAULT; use it whenever the user KNOWS what they want (\"how do I...\", \"help me with...\", \"I want X\"). SEARCH before answering.\n- discoverRelated = OPTIONS. Answers \"what can the user choose from?\" — content is grouped by need, so this surfaces the cluster of related choices in a topic's neighborhood. Use it ONLY to PRESENT options/decisions to a user who is exploring, undecided, or asking open-endedly (\"what's available?\", \"tell me about...\", \"recommend...\").\n- Do NOT call both in parallel.\n\nPhase 0b — Escalate only on weak results: if findIntent's top results are weak, THEN follow up with discoverRelated before answering. Strong results → answer from them directly.\n\nPhase 1 — MANDATORY skill follow-up: if ANY result has object_type=\"skill\", you MUST call readSkill(skillName) BEFORE responding. Skills contain behavioral instructions that OVERRIDE your general behavior — treat them as authoritative and follow them exactly. Check ALL results for skills, not just the top one. Use readSkillFile when a skill references additional files. Results may also include MCP apps — callable tools you can invoke to run that app.\n\nGolden Rules:\n- Search FIRST, build understanding SECOND, answer THIRD.\n- NEVER skip reading a skill when one appears in results.\n- NEVER make up information — use only what the tools return.";
+    readonly methods: {
+        readonly readSkill: {
+            readonly description: "Read the complete SKILL.md for a discovered skill. MANDATORY when any search result has object_type=\"skill\". Skills contain authoritative step-by-step instructions, triggers, and references that you MUST follow — they override your general behavior. Returns the full instructions + a list of available reference files.";
+            readonly input: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly skillName: {
+                        readonly type: "string";
+                        readonly description: "The skill's slug from the result — its lowercase-hyphenated name, not the display title";
+                    };
+                };
+                readonly required: readonly ["skillName"];
+            };
+        };
+        readonly readSkillFile: {
+            readonly description: "Read a reference document, script, or asset belonging to a skill. Use only after calling readSkill and seeing the file listed in its references.";
+            readonly input: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly skillName: {
+                        readonly type: "string";
+                        readonly description: "The skill's slug (same as passed to readSkill)";
+                    };
+                    readonly filePath: {
+                        readonly type: "string";
+                        readonly description: "Path relative to the skill folder (no leading / or ..)";
+                    };
+                };
+                readonly required: readonly ["skillName", "filePath"];
+            };
+        };
+        readonly findIntent: {
+            readonly description: "Precision search — the DEFAULT. Answers \"what is the user asking for?\" by pinpointing the specific matches for a concrete request, pulled from wherever they live in the knowledge space. Use it whenever the user KNOWS what they want (a question, a task, a specific thing to find). Pass the user's EXACT words — do not paraphrase. If ANY result has object_type=\"skill\", you MUST call readSkill before responding; check ALL results, not just the top one. Do not pair with discoverRelated by default.";
+            readonly input: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly query: {
+                        readonly type: "string";
+                        readonly description: "The user's exact question or intent — pass their original words verbatim";
+                    };
+                };
+                readonly required: readonly ["query"];
+            };
+        };
+        readonly discoverRelated: {
+            readonly description: "Discovery search — NOT the default. Answers \"what are the options here?\" by surfacing the cluster of related choices in a topic's neighborhood (content is grouped by need, so nearby items are the alternatives a user could pick from). Use it to PRESENT options/decisions to a user who is exploring, undecided, or asking open-endedly (\"what's available?\", \"tell me about...\", \"recommend...\"), or as a fallback when findIntent's results were too weak. Low similarity is normal — these are neighbors, not exact matches.";
+            readonly input: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly query: {
+                        readonly type: "string";
+                        readonly description: "The topic or concept to explore";
+                    };
+                };
+                readonly required: readonly ["query"];
+            };
+        };
+    };
+};
+/** Map an exposed tool method to the platform search mode. */
+export declare function modeForMethod(method: string): SpatialMode | undefined;
+/** Call POST {base}/spatial/search. Returns the platform's results, top-level. */
+export declare function runSearch(mode: SpatialMode, params: {
+    query: string;
+    maxResults?: number;
+    similarityThreshold?: number;
+    filters?: SpatialFilters;
+}, context: any): Promise<SpatialSearchResponse>;
+//# sourceMappingURL=searchClient.d.ts.map

package/dist/SpatialSearch/service/searchClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchClient.d.ts","sourceRoot":"","sources":["../../../src/SpatialSearch/service/searchClient.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAcxF,+FAA+F;AAC/F,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCjB,CAAC;AAEX,8DAA8D;AAC9D,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAIrE;AAED,kFAAkF;AAClF,wBAAsB,SAAS,CAC7B,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,cAAc,CAAA;CAAE,EACtG,OAAO,EAAE,GAAG,GACX,OAAO,CAAC,qBAAqB,CAAC,CA8BhC"}

package/dist/SpatialSearch/service/searchClient.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPATIAL_SCHEMA = void 0;
+exports.modeForMethod = modeForMethod;
+exports.runSearch = runSearch;
+const skillClient_1 = require("./skillClient");
+// The platform's own search API. In-process the node reaches the engine on the standard
+// internal service URL (WORKFLOW_SERVICE_URL — the same one the node host already uses); no
+// per-node credential. Auth is the forwarded request token.
+function spatialApiBase() {
+    return (process.env.WORKFLOW_SERVICE_URL || "http://localhost:4101").replace(/\/$/, "");
+}
+// Pure module — no platform init dependency, so it's unit-testable standalone. The executor
+// (which runs inside the platform) uses the real platform logger; here console is enough.
+const logger = { info: (...a) => console.log("[SpatialSearch]", ...a) };
+/** The two search tools this node exposes to an agent (mirrors the platform's spatial MCP). */
+exports.SPATIAL_SCHEMA = {
+    instructions: `You have access to the platform knowledge base with two search tools that answer DIFFERENT questions. Choose one based on the shape of the user's request — do not call both by default.
+
+KNOWLEDGE PROTOCOL (MANDATORY — do not skip):
+
+Phase 0 — Choose ONE search tool (think before calling):
+- findIntent = PRECISION. Answers "what is the user asking for?" — pinpoints the specific matches for a concrete request, pulled from wherever they live in the knowledge space. This is the DEFAULT; use it whenever the user KNOWS what they want ("how do I...", "help me with...", "I want X"). SEARCH before answering.
+- discoverRelated = OPTIONS. Answers "what can the user choose from?" — content is grouped by need, so this surfaces the cluster of related choices in a topic's neighborhood. Use it ONLY to PRESENT options/decisions to a user who is exploring, undecided, or asking open-endedly ("what's available?", "tell me about...", "recommend...").
+- Do NOT call both in parallel.
+
+Phase 0b — Escalate only on weak results: if findIntent's top results are weak, THEN follow up with discoverRelated before answering. Strong results → answer from them directly.
+
+Phase 1 — MANDATORY skill follow-up: if ANY result has object_type="skill", you MUST call readSkill(skillName) BEFORE responding. Skills contain behavioral instructions that OVERRIDE your general behavior — treat them as authoritative and follow them exactly. Check ALL results for skills, not just the top one. Use readSkillFile when a skill references additional files. Results may also include MCP apps — callable tools you can invoke to run that app.
+
+Golden Rules:
+- Search FIRST, build understanding SECOND, answer THIRD.
+- NEVER skip reading a skill when one appears in results.
+- NEVER make up information — use only what the tools return.`,
+    methods: {
+        findIntent: {
+            description: `Precision search — the DEFAULT. Answers "what is the user asking for?" by pinpointing the specific matches for a concrete request, pulled from wherever they live in the knowledge space. Use it whenever the user KNOWS what they want (a question, a task, a specific thing to find). Pass the user's EXACT words — do not paraphrase. If ANY result has object_type="skill", you MUST call readSkill before responding; check ALL results, not just the top one. Do not pair with discoverRelated by default.`,
+            input: {
+                type: "object",
+                // query only — result count + which types come back are set by the node config, not the agent.
+                properties: { query: { type: "string", description: "The user's exact question or intent — pass their original words verbatim" } },
+                required: ["query"],
+            },
+        },
+        discoverRelated: {
+            description: `Discovery search — NOT the default. Answers "what are the options here?" by surfacing the cluster of related choices in a topic's neighborhood (content is grouped by need, so nearby items are the alternatives a user could pick from). Use it to PRESENT options/decisions to a user who is exploring, undecided, or asking open-endedly ("what's available?", "tell me about...", "recommend..."), or as a fallback when findIntent's results were too weak. Low similarity is normal — these are neighbors, not exact matches.`,
+            input: {
+                type: "object",
+                properties: { query: { type: "string", description: "The topic or concept to explore" } },
+                required: ["query"],
+            },
+        },
+        // Read + work with skills the searches surface.
+        ...skillClient_1.SKILL_METHODS,
+    },
+};
+/** Map an exposed tool method to the platform search mode. */
+function modeForMethod(method) {
+    if (method === "findIntent")
+        return "intent";
+    if (method === "discoverRelated")
+        return "related";
+    return undefined;
+}
+/** Call POST {base}/spatial/search. Returns the platform's results, top-level. */
+async function runSearch(mode, params, context) {
+    if (!params?.query)
+        throw new Error("SpatialSearch: query is required");
+    const token = context?.auth?.accessToken; // forward the request's user token (auth-gated /api path)
+    const url = `${spatialApiBase()}/spatial/search`;
+    const body = {
+        query: params.query,
+        mode,
+        maxResults: params.maxResults ?? 10,
+        // Omit when unset so the server's default floor applies.
+        ...(params.similarityThreshold != null ? { similarityThreshold: params.similarityThreshold } : {}),
+        workflowId: context?.workflowId,
+        ...(params.filters ?? {}),
+    };
+    logger.info("spatial search", { mode, url, hasToken: !!token });
+    const res = await fetch(url, {
+        method: "POST",
+        headers: {
+            "content-type": "application/json",
+            ...(token ? { authorization: `Bearer ${token}` } : {}),
+        },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const detail = await res.text().catch(() => "");
+        throw new Error(`spatial/search failed: ${res.status} ${detail.slice(0, 300)}`);
+    }
+    return (await res.json());
+}
+//# sourceMappingURL=searchClient.js.map

package/dist/SpatialSearch/service/searchClient.js.map

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

package/dist/SpatialSearch/service/skillClient.d.ts

@@ -0,0 +1,47 @@
+/** getSchema entries for the two skill tools — merged into the node's SPATIAL_SCHEMA. */
+export declare const SKILL_METHODS: {
+    readonly readSkill: {
+        readonly description: "Read the complete SKILL.md for a discovered skill. MANDATORY when any search result has object_type=\"skill\". Skills contain authoritative step-by-step instructions, triggers, and references that you MUST follow — they override your general behavior. Returns the full instructions + a list of available reference files.";
+        readonly input: {
+            readonly type: "object";
+            readonly properties: {
+                readonly skillName: {
+                    readonly type: "string";
+                    readonly description: "The skill's slug from the result — its lowercase-hyphenated name, not the display title";
+                };
+            };
+            readonly required: readonly ["skillName"];
+        };
+    };
+    readonly readSkillFile: {
+        readonly description: "Read a reference document, script, or asset belonging to a skill. Use only after calling readSkill and seeing the file listed in its references.";
+        readonly input: {
+            readonly type: "object";
+            readonly properties: {
+                readonly skillName: {
+                    readonly type: "string";
+                    readonly description: "The skill's slug (same as passed to readSkill)";
+                };
+                readonly filePath: {
+                    readonly type: "string";
+                    readonly description: "Path relative to the skill folder (no leading / or ..)";
+                };
+            };
+            readonly required: readonly ["skillName", "filePath"];
+        };
+    };
+};
+/** readSkill — GET {base}/skills/{name} → the skill's instructions.
+ *  GUARD: readSkill reads ONLY real skills. If the name isn't a skill (404 — it's an app,
+ *  a component, a need, etc.), return a CORRECTIVE result instead of throwing, so a confused
+ *  model self-corrects (invoke the app as a tool) rather than crashing the turn. Only a real
+ *  server failure (non-404) throws. */
+export declare function readSkill(params: {
+    skillName: string;
+}, context: any): Promise<any>;
+/** readSkillFile — GET {base}/skills/{name}/file?path=... → a resource file's content. */
+export declare function readSkillFile(params: {
+    skillName: string;
+    filePath: string;
+}, context: any): Promise<any>;
+//# sourceMappingURL=skillClient.d.ts.map

package/dist/SpatialSearch/service/skillClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillClient.d.ts","sourceRoot":"","sources":["../../../src/SpatialSearch/service/skillClient.ts"],"names":[],"mappings":"AAkBA,yFAAyF;AACzF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyBhB,CAAC;AAEX;;;;uCAIuC;AACvC,wBAAsB,SAAS,CAAC,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAezF;AAED,0FAA0F;AAC1F,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAY/G"}

package/dist/SpatialSearch/service/skillClient.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_METHODS = void 0;
+exports.readSkill = readSkill;
+exports.readSkillFile = readSkillFile;
+/**
+ * Skill tools — read a discovered skill's instructions + its resource files. Both are plain
+ * HTTP calls to the platform's skill server (the same endpoints the legacy node used); no DB,
+ * no engine internals. Skills are served on the internal lane (UNOVERSE_SERVICE_URL); the
+ * request's token is forwarded so the gated lane works too.
+ */
+const logger = { info: (...a) => console.log("[SpatialSearch:skills]", ...a) };
+/** The platform's skill server (internal lane by default — same env the legacy reader used). */
+function skillApiBase() {
+    return (process.env.UNOVERSE_SERVICE_URL || "http://localhost:4106").replace(/\/$/, "");
+}
+function authHeaders(context) {
+    const token = context?.auth?.accessToken;
+    return token ? { authorization: `Bearer ${token}` } : {};
+}
+/** getSchema entries for the two skill tools — merged into the node's SPATIAL_SCHEMA. */
+exports.SKILL_METHODS = {
+    readSkill: {
+        description: `Read the complete SKILL.md for a discovered skill. MANDATORY when any search result has object_type="skill". Skills contain authoritative step-by-step instructions, triggers, and references that you MUST follow — they override your general behavior. Returns the full instructions + a list of available reference files.`,
+        input: {
+            type: "object",
+            properties: {
+                skillName: {
+                    type: "string",
+                    description: "The skill's slug from the result — its lowercase-hyphenated name, not the display title",
+                },
+            },
+            required: ["skillName"],
+        },
+    },
+    readSkillFile: {
+        description: `Read a reference document, script, or asset belonging to a skill. Use only after calling readSkill and seeing the file listed in its references.`,
+        input: {
+            type: "object",
+            properties: {
+                skillName: { type: "string", description: "The skill's slug (same as passed to readSkill)" },
+                filePath: { type: "string", description: "Path relative to the skill folder (no leading / or ..)" },
+            },
+            required: ["skillName", "filePath"],
+        },
+    },
+};
+/** readSkill — GET {base}/skills/{name} → the skill's instructions.
+ *  GUARD: readSkill reads ONLY real skills. If the name isn't a skill (404 — it's an app,
+ *  a component, a need, etc.), return a CORRECTIVE result instead of throwing, so a confused
+ *  model self-corrects (invoke the app as a tool) rather than crashing the turn. Only a real
+ *  server failure (non-404) throws. */
+async function readSkill(params, context) {
+    const skillName = params?.skillName;
+    if (!skillName)
+        throw new Error("SpatialSearch: skillName is required");
+    const url = `${skillApiBase()}/skills/${encodeURIComponent(skillName)}`;
+    logger.info("readSkill", { skillName });
+    const res = await fetch(url, { headers: authHeaders(context) });
+    if (res.status === 404) {
+        logger.info("readSkill guard: not a skill", { skillName });
+        return {
+            notASkill: true,
+            error: `"${skillName}" is not a skill. readSkill reads ONLY skills (object_type="skill"). If it appeared as an app or component (object_type="mcp"), invoke it as a tool — do not readSkill it.`,
+        };
+    }
+    if (!res.ok)
+        throw new Error(`readSkill failed: ${res.status} ${(await res.text().catch(() => "")).slice(0, 200)}`);
+    return res.json();
+}
+/** readSkillFile — GET {base}/skills/{name}/file?path=... → a resource file's content. */
+async function readSkillFile(params, context) {
+    const { skillName, filePath } = params ?? {};
+    if (!skillName || !filePath)
+        throw new Error("SpatialSearch: skillName and filePath are required");
+    if (filePath.includes("..") || filePath.startsWith("/"))
+        throw new Error("SpatialSearch: invalid file path");
+    const url = `${skillApiBase()}/skills/${encodeURIComponent(skillName)}/file?path=${encodeURIComponent(filePath)}`;
+    logger.info("readSkillFile", { skillName, filePath });
+    const res = await fetch(url, { headers: authHeaders(context) });
+    if (res.status === 404) {
+        return { notFound: true, error: `No skill file "${filePath}" for skill "${skillName}" (the skill or file does not exist).` };
+    }
+    if (!res.ok)
+        throw new Error(`readSkillFile failed: ${res.status} ${(await res.text().catch(() => "")).slice(0, 200)}`);
+    return res.json();
+}
+//# sourceMappingURL=skillClient.js.map

package/dist/SpatialSearch/service/skillClient.js.map

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

package/dist/SpatialSearch/util/types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Types for the Spatial Search node.
+ */
+/** Author-set result filters (which result types come back). */
+export interface SpatialFilters {
+    includeImages?: boolean;
+    includeNeeds?: boolean;
+    includeServices?: boolean;
+    includeActions?: boolean;
+    includeSkills?: boolean;
+    includeMcps?: boolean;
+}
+export interface SpatialSearchConfig extends SpatialFilters {
+    maxResults?: number;
+    /** Render content-attached cards (result rows with `metadata.app`) on the caller's live session. Default true; no-ops without a session. */
+    renderCards?: boolean;
+    /** Intent-mode precision floor (cosine similarity); server defaults to 0.35 when unset. */
+    similarityThreshold?: number;
+}
+/** One search result row returned by the platform spatial API. */
+export interface SpatialResult {
+    universalId?: string;
+    objectType?: string;
+    score?: number;
+    content?: string;
+    [key: string]: any;
+}
+/** Shape returned by POST {base}/spatial/search. */
+export interface SpatialSearchResponse {
+    results: SpatialResult[];
+    queryPoint?: {
+        x: number;
+        y: number;
+        z: number;
+    } | null;
+    count?: number;
+}
+export type SpatialMode = "intent" | "related";
+//# sourceMappingURL=types.d.ts.map

package/dist/SpatialSearch/util/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/SpatialSearch/util/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4IAA4I;IAC5I,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2FAA2F;IAC3F,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,oDAAoD;AACpD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC"}

package/dist/SpatialSearch/util/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Types for the Spatial Search node.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/SpatialSearch/util/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/SpatialSearch/util/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+declare const plugin: import("@unoverse-platform/plugin-base").GravityPlugin;
+export default plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,QAAA,MAAM,MAAM,wDAaV,CAAC;AAEH,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,58 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Spatial package plugin — a sandboxed knowledge-search node that calls the platform's
+ * authenticated spatial search API. Search only (no upload/ingestion — that stays platform-side).
+ */
+const plugin_base_1 = require("@unoverse-platform/plugin-base");
+const package_json_1 = __importDefault(require("../package.json"));
+const plugin = (0, plugin_base_1.createPlugin)({
+    name: package_json_1.default.name,
+    version: package_json_1.default.version,
+    description: package_json_1.default.description,
+    async setup(api) {
+        const { initializePlatformFromAPI } = await Promise.resolve().then(() => __importStar(require("@unoverse-platform/plugin-base")));
+        initializePlatformFromAPI(api);
+        const { SpatialSearchNode } = await Promise.resolve().then(() => __importStar(require("./SpatialSearch/node")));
+        api.registerNode(SpatialSearchNode);
+        // No credential — the node calls the platform's own search API internally.
+    },
+});
+exports.default = plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;GAGG;AACH,gEAAqF;AACrF,mEAA0C;AAE1C,MAAM,MAAM,GAAG,IAAA,0BAAY,EAAC;IAC1B,IAAI,EAAE,sBAAW,CAAC,IAAI;IACtB,OAAO,EAAE,sBAAW,CAAC,OAAO;IAC5B,WAAW,EAAE,sBAAW,CAAC,WAAW;IAEpC,KAAK,CAAC,KAAK,CAAC,GAAqB;QAC/B,MAAM,EAAE,yBAAyB,EAAE,GAAG,wDAAa,gCAAgC,GAAC,CAAC;QACrF,yBAAyB,CAAC,GAAG,CAAC,CAAC;QAE/B,MAAM,EAAE,iBAAiB,EAAE,GAAG,wDAAa,sBAAsB,GAAC,CAAC;QACnE,GAAG,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;QACpC,2EAA2E;IAC7E,CAAC;CACF,CAAC,CAAC;AAEH,kBAAe,MAAM,CAAC"}

package/dist/shared/platform.d.ts

@@ -0,0 +1,5 @@
+export declare const PromiseNode: any;
+export declare const NodeInputType: any;
+export declare const createLogger: (name: string) => any;
+export declare const getNodeCredentials: (context: any, credentialName: string) => any;
+//# sourceMappingURL=platform.d.ts.map

package/dist/shared/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/shared/platform.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,WAAW,KAAoE,CAAC;AAC7F,eAAO,MAAM,aAAa,KAAwE,CAAC;AAEnG,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,GACgB,CAAC;AAE7D,eAAO,MAAM,kBAAkB,GAAI,SAAS,GAAG,EAAE,gBAAgB,MAAM,QAGR,CAAC"}

package/dist/shared/platform.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNodeCredentials = exports.createLogger = exports.NodeInputType = exports.PromiseNode = void 0;
+/**
+ * Shared platform dependencies for the Spatial node.
+ *
+ * In the platform, initializePlatformFromAPI(api) runs before node modules
+ * load (src/index.ts dynamic-imports them inside setup), so these resolve to
+ * the real engine implementations. Outside it (unit tests), classes and
+ * loggers fall back to the plugin-base stand-ins / console; credential access
+ * has no safe fallback and stays strict.
+ */
+const plugin_base_1 = require("@unoverse-platform/plugin-base");
+exports.PromiseNode = (0, plugin_base_1.hasPlatform)() ? (0, plugin_base_1.getPlatform)().PromiseNode : plugin_base_1.PromiseNode;
+exports.NodeInputType = (0, plugin_base_1.hasPlatform)() ? (0, plugin_base_1.getPlatform)().NodeInputType : plugin_base_1.NodeInputType;
+const createLogger = (name) => (0, plugin_base_1.hasPlatform)() ? (0, plugin_base_1.getPlatform)().createLogger(name) : console;
+exports.createLogger = createLogger;
+const getNodeCredentials = (context, credentialName) => context?.api?.getNodeCredentials
+    ? context.api.getNodeCredentials(context, credentialName)
+    : (0, plugin_base_1.getPlatform)().getNodeCredentials(context, credentialName);
+exports.getNodeCredentials = getNodeCredentials;
+//# sourceMappingURL=platform.js.map

package/dist/shared/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/shared/platform.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACH,gEAKwC;AAE3B,QAAA,WAAW,GAAG,IAAA,yBAAW,GAAE,CAAC,CAAC,CAAC,IAAA,yBAAW,GAAE,CAAC,WAAW,CAAC,CAAC,CAAC,yBAAqB,CAAC;AAChF,QAAA,aAAa,GAAG,IAAA,yBAAW,GAAE,CAAC,CAAC,CAAC,IAAA,yBAAW,GAAE,CAAC,aAAa,CAAC,CAAC,CAAC,2BAAuB,CAAC;AAE5F,MAAM,YAAY,GAAG,CAAC,IAAY,EAAO,EAAE,CAChD,IAAA,yBAAW,GAAE,CAAC,CAAC,CAAC,IAAA,yBAAW,GAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AADhD,QAAA,YAAY,gBACoC;AAEtD,MAAM,kBAAkB,GAAG,CAAC,OAAY,EAAE,cAAsB,EAAE,EAAE,CACzE,OAAO,EAAE,GAAG,EAAE,kBAAkB;IAC9B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,OAAO,EAAE,cAAc,CAAC;IACzD,CAAC,CAAC,IAAA,yBAAW,GAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;AAHnD,QAAA,kBAAkB,sBAGiC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@unoverse-platform/spatial",
+  "version": "1.0.0",
+  "description": "Spatial knowledge search for Unoverse — a sandboxed node that calls the platform's authenticated spatial search API (no direct DB access)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "dev": "tsc --watch",
+    "test": "node --import tsx --test --test-force-exit test/*.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "unoverse",
+    "workflow",
+    "spatial",
+    "search",
+    "knowledge",
+    "umap",
+    "vector",
+    "mcp"
+  ],
+  "author": "Unoverse",
+  "license": "MIT",
+  "devDependencies": {
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "@unoverse-platform/plugin-base": ">=1.1.6"
+  },
+  "gravity": {
+    "displayName": "Spatial",
+    "category": "search",
+    "logoUrl": "https://res.cloudinary.com/sonik/image/upload/v1751366180/gravity/icons/gravityIcon.png",
+    "nodes": [
+      {
+        "name": "Spatial Search",
+        "type": "PromiseNode",
+        "description": "Semantic + spatial (UMAP) search over the platform knowledge base, exposed to agents as MCP tools",
+        "category": "Knowledge & Vectors",
+        "mcp": true
+      }
+    ],
+    "features": [
+      "High-precision vector (intent) search",
+      "3D spatial (UMAP) discovery search",
+      "Exposed to agents as MCP tools via a service edge",
+      "Sandboxed — calls the platform's authenticated search API, no direct DB access"
+    ]
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}