node-opcua-modeler-mcp-server 1.2.3 → 1.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/catalog.d.ts CHANGED
@@ -62,6 +62,12 @@ export declare function listNamespaces(): CompanionSpecEntry[];
62
62
  /**
63
63
  * Resolve the full dependency chain for a set of spec aliases.
64
64
  * Returns a topologically sorted list (dependencies before dependents).
65
+ *
66
+ * NOTE: this is an intentional standalone copy of the toposort. The published
67
+ * MCP server ships a frozen `catalog.json` and imports NO `@sterfive/*` package
68
+ * at runtime (IP-safe, zero-dep), so it cannot reuse ex's `topologicalOrder`.
69
+ * The catalog `deps` are generated from — and kept in sync with — the ex/KB
70
+ * registries by `scripts/extract-catalog.ts` + `check-registry-consistency.ts`.
65
71
  */
66
72
  export declare function resolveDependencies(aliases: string[]): string[];
67
73
  /** List all types in a companion spec namespace */
@@ -72,6 +78,25 @@ export declare function getTypeDetails(alias: string, browseName: string): TypeD
72
78
  export declare function searchTypes(query: string): (TypeSummary & {
73
79
  alias: string;
74
80
  })[];
81
+ export interface ReusableBlockMatch {
82
+ /** Alias-prefixed type name, e.g. `di:IVendorNameplateType`. */
83
+ browseName: string;
84
+ alias: string;
85
+ kind: "interface" | "addin";
86
+ isAbstract: boolean;
87
+ /** True if this addin type declares a DefaultInstanceBrowseName (composable by default name). */
88
+ hasDefaultInstanceBrowseName: boolean;
89
+ /** Member browseNames that matched the query. */
90
+ matchedMembers: string[];
91
+ /** All member browseNames (components + properties + methods). */
92
+ members: string[];
93
+ }
94
+ /**
95
+ * Find reusable Interfaces / AddIns by capability — e.g. `find_reusable_block("SerialNumber")`
96
+ * returns the interfaces/addins that expose a matching member. Matches member browseNames,
97
+ * plus the block's own name/description. Prefer an existing block over redefining members.
98
+ */
99
+ export declare function findReusableBlock(query: string): ReusableBlockMatch[];
75
100
  export interface UnitLookupResult {
76
101
  symbol: string;
77
102
  matchType: "exact" | "case-insensitive" | "alias" | "fuzzy";
package/dist/catalog.js CHANGED
@@ -32,6 +32,12 @@ export function listNamespaces() {
32
32
  /**
33
33
  * Resolve the full dependency chain for a set of spec aliases.
34
34
  * Returns a topologically sorted list (dependencies before dependents).
35
+ *
36
+ * NOTE: this is an intentional standalone copy of the toposort. The published
37
+ * MCP server ships a frozen `catalog.json` and imports NO `@sterfive/*` package
38
+ * at runtime (IP-safe, zero-dep), so it cannot reuse ex's `topologicalOrder`.
39
+ * The catalog `deps` are generated from — and kept in sync with — the ex/KB
40
+ * registries by `scripts/extract-catalog.ts` + `check-registry-consistency.ts`.
35
41
  */
36
42
  export function resolveDependencies(aliases) {
37
43
  const registry = getCatalog().registry;
@@ -80,6 +86,86 @@ export function searchTypes(query) {
80
86
  }
81
87
  return results;
82
88
  }
89
+ function memberBrowseNames(d) {
90
+ return [...d.components.map((m) => m.browseName), ...d.properties.map((m) => m.browseName), ...d.methods];
91
+ }
92
+ /** Build the set of interface types (alias:browseName) via a subtypeOf → BaseInterfaceType fixpoint. */
93
+ function buildInterfaceSet() {
94
+ const catalog = getCatalog();
95
+ const entries = [];
96
+ for (const [alias, details] of Object.entries(catalog.typeDetails)) {
97
+ for (const [bn, d] of Object.entries(details)) {
98
+ entries.push({ key: `${alias}:${bn}`, subtypeOf: d.subtypeOf });
99
+ }
100
+ }
101
+ const isInterface = new Set();
102
+ let changed = true;
103
+ while (changed) {
104
+ changed = false;
105
+ for (const e of entries) {
106
+ if (isInterface.has(e.key))
107
+ continue;
108
+ if (e.subtypeOf === "ua:BaseInterfaceType" || (e.subtypeOf !== undefined && isInterface.has(e.subtypeOf))) {
109
+ isInterface.add(e.key);
110
+ changed = true;
111
+ }
112
+ }
113
+ }
114
+ return isInterface;
115
+ }
116
+ let _interfaceSet = null;
117
+ /**
118
+ * Find reusable Interfaces / AddIns by capability — e.g. `find_reusable_block("SerialNumber")`
119
+ * returns the interfaces/addins that expose a matching member. Matches member browseNames,
120
+ * plus the block's own name/description. Prefer an existing block over redefining members.
121
+ */
122
+ export function findReusableBlock(query) {
123
+ const catalog = getCatalog();
124
+ const q = query.toLowerCase();
125
+ if (!_interfaceSet)
126
+ _interfaceSet = buildInterfaceSet();
127
+ const matches = [];
128
+ for (const [alias, details] of Object.entries(catalog.typeDetails)) {
129
+ for (const [bn, d] of Object.entries(details)) {
130
+ const key = `${alias}:${bn}`;
131
+ const isInterface = _interfaceSet.has(key);
132
+ const hasDefaultName = d.properties.some((m) => /defaultinstancebrowsename/i.test(m.browseName));
133
+ // Only interfaces and addin-capable types are "reusable blocks".
134
+ if (!isInterface && !hasDefaultName)
135
+ continue;
136
+ const members = memberBrowseNames(d);
137
+ const matchedMembers = members.filter((m) => m.toLowerCase().includes(q));
138
+ const nameMatch = bn.toLowerCase().includes(q) || (d.description?.toLowerCase().includes(q) ?? false);
139
+ if (matchedMembers.length === 0 && !nameMatch)
140
+ continue;
141
+ matches.push({
142
+ browseName: key,
143
+ alias,
144
+ kind: isInterface ? "interface" : "addin",
145
+ isAbstract: d.isAbstract,
146
+ hasDefaultInstanceBrowseName: hasDefaultName,
147
+ matchedMembers,
148
+ members
149
+ });
150
+ }
151
+ }
152
+ // Rank: member match before name-only; interfaces (the canonical member
153
+ // definers) before addins; more matched members first; abstract addin bases
154
+ // after concrete composable ones.
155
+ matches.sort((a, b) => {
156
+ const am = a.matchedMembers.length > 0 ? 0 : 1;
157
+ const bm = b.matchedMembers.length > 0 ? 0 : 1;
158
+ if (am !== bm)
159
+ return am - bm;
160
+ if (a.kind !== b.kind)
161
+ return a.kind === "interface" ? -1 : 1;
162
+ if (a.kind === "addin" && a.isAbstract !== b.isAbstract)
163
+ return a.isAbstract ? 1 : -1;
164
+ return b.matchedMembers.length - a.matchedMembers.length;
165
+ });
166
+ // Cap: this is a "point me at the right block" tool, not an exhaustive dump.
167
+ return matches.slice(0, 15);
168
+ }
83
169
  let _unitsLower = null;
84
170
  function getUnitsLowerMap() {
85
171
  if (!_unitsLower) {
@@ -1 +1 @@
1
- {"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"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"}
package/dist/cloud.d.ts CHANGED
@@ -1,14 +1,28 @@
1
1
  /**
2
2
  * ==========================================================================
3
- * OPC UA Modeler — Cloud API Client
3
+ * OPC UA Modeler — API Client
4
4
  *
5
- * Thin HTTP wrapper for proxying MCP tool calls to the Sterfive SaaS API.
6
- * ZERO proprietary dependencies — only native fetch.
5
+ * Thin HTTP wrapper for proxying MCP tool calls to a backend that speaks the
6
+ * /api/v1 contract: either the Sterfive SaaS, or a licensed
7
+ * `opcua-modeler serve` running on this machine.
8
+ *
9
+ * ZERO proprietary dependencies — native fetch for the cloud, node:http for
10
+ * the local pipe.
7
11
  *
8
12
  * Configuration via environment variables:
13
+ * OPCUA_MODELER_BACKEND — "cloud" (default) or "local"
9
14
  * OPCUA_MODELER_API_URL — Base URL (default: https://api.opcua-modeler.sterfive.io)
10
15
  * OPCUA_MODELER_API_KEY — API key (stfv_...) for authenticated endpoints
11
16
  *
17
+ * The two backends are NEVER mixed and there is no fallback between them:
18
+ * on-premise is chosen precisely so that models do not leave the network, and
19
+ * quietly retrying against the hosted API when a local daemon is down would
20
+ * be a data-egress bug rather than a convenience.
21
+ *
22
+ * Both transports resolve to a `Response`, so every status-handling branch
23
+ * below is shared. Only the messages differ, because "set your API key" is
24
+ * nonsense advice for a licensed local server.
25
+ *
12
26
  * IMPORTANT: Never use console.log() — stdout is reserved for JSON-RPC.
13
27
  * ==========================================================================
14
28
  */
@@ -30,11 +44,12 @@ export type CloudResult<T = unknown> = {
30
44
  * Make an authenticated request to the Sterfive SaaS API.
31
45
  *
32
46
  * @param path - API path (e.g. "/v1/validate")
33
- * @param body - Request body (string)
34
- * @param contentType - Content-Type header (e.g. "text/yaml", "application/xml")
47
+ * @param body - Request body (string); ignored for GET
48
+ * @param contentType - Content-Type header (e.g. "text/yaml", "application/xml"); ignored for GET
49
+ * @param method - HTTP method (default "POST")
35
50
  * @returns Parsed JSON response or structured error
36
51
  */
37
- export declare function cloudFetch<T = unknown>(path: string, body: string, contentType: string): Promise<CloudResult<T>>;
52
+ export declare function cloudFetch<T = unknown>(path: string, body: string, contentType: string, method?: "GET" | "POST"): Promise<CloudResult<T>>;
38
53
  /**
39
54
  * Format a CloudError into a user-friendly MCP tool error response.
40
55
  */
package/dist/cloud.js CHANGED
@@ -1,54 +1,126 @@
1
1
  /**
2
2
  * ==========================================================================
3
- * OPC UA Modeler — Cloud API Client
3
+ * OPC UA Modeler — API Client
4
4
  *
5
- * Thin HTTP wrapper for proxying MCP tool calls to the Sterfive SaaS API.
6
- * ZERO proprietary dependencies — only native fetch.
5
+ * Thin HTTP wrapper for proxying MCP tool calls to a backend that speaks the
6
+ * /api/v1 contract: either the Sterfive SaaS, or a licensed
7
+ * `opcua-modeler serve` running on this machine.
8
+ *
9
+ * ZERO proprietary dependencies — native fetch for the cloud, node:http for
10
+ * the local pipe.
7
11
  *
8
12
  * Configuration via environment variables:
13
+ * OPCUA_MODELER_BACKEND — "cloud" (default) or "local"
9
14
  * OPCUA_MODELER_API_URL — Base URL (default: https://api.opcua-modeler.sterfive.io)
10
15
  * OPCUA_MODELER_API_KEY — API key (stfv_...) for authenticated endpoints
11
16
  *
17
+ * The two backends are NEVER mixed and there is no fallback between them:
18
+ * on-premise is chosen precisely so that models do not leave the network, and
19
+ * quietly retrying against the hosted API when a local daemon is down would
20
+ * be a data-egress bug rather than a convenience.
21
+ *
22
+ * Both transports resolve to a `Response`, so every status-handling branch
23
+ * below is shared. Only the messages differ, because "set your API key" is
24
+ * nonsense advice for a licensed local server.
25
+ *
12
26
  * IMPORTANT: Never use console.log() — stdout is reserved for JSON-RPC.
13
27
  * ==========================================================================
14
28
  */
29
+ import { isLocalBackend, localFetch, readLocalEndpoint } from "./local.js";
15
30
  const DEFAULT_API_URL = "https://api.opcua-modeler.sterfive.io";
16
31
  const TIMEOUT_MS = 30_000;
32
+ /**
33
+ * The local engine runs in-process on the user's machine, where a large model
34
+ * with documentation can legitimately take minutes — there is no gateway
35
+ * timeout to race, and no other tenant to be fair to.
36
+ */
37
+ const LOCAL_TIMEOUT_MS = 300_000;
17
38
  function getApiUrl() {
18
39
  return process.env.OPCUA_MODELER_API_URL || DEFAULT_API_URL;
19
40
  }
20
41
  function getApiKey() {
21
42
  return process.env.OPCUA_MODELER_API_KEY;
22
43
  }
44
+ /**
45
+ * Extract a human-readable detail (and optional hint) from an error response.
46
+ *
47
+ * The SaaS serializes errors as `{ error: string, hint?: string }` (see
48
+ * api-helpers.ts apiError); `detail`/`message` are tolerated for proxies and
49
+ * older servers. The body is read ONCE as text — a failed response.json()
50
+ * consumes the stream and would make a fallback .text() throw.
51
+ */
52
+ async function readErrorBody(response) {
53
+ let text = "";
54
+ try {
55
+ text = await response.text();
56
+ }
57
+ catch {
58
+ return { detail: "" };
59
+ }
60
+ try {
61
+ const body = JSON.parse(text);
62
+ const detail = [body.error, body.detail, body.message].find((v) => typeof v === "string" && v.length > 0);
63
+ return {
64
+ detail: detail ?? text.trim(),
65
+ hint: typeof body.hint === "string" && body.hint ? body.hint : undefined,
66
+ code: typeof body.code === "string" && body.code ? body.code : undefined
67
+ };
68
+ }
69
+ catch {
70
+ return { detail: text.trim() };
71
+ }
72
+ }
73
+ /** Direct renewal link for expired keys — surfaced verbatim to agents/CLI. */
74
+ const KEY_SETTINGS_URL = "https://opcua-modeler.sterfive.io/app/settings/api";
23
75
  /**
24
76
  * Make an authenticated request to the Sterfive SaaS API.
25
77
  *
26
78
  * @param path - API path (e.g. "/v1/validate")
27
- * @param body - Request body (string)
28
- * @param contentType - Content-Type header (e.g. "text/yaml", "application/xml")
79
+ * @param body - Request body (string); ignored for GET
80
+ * @param contentType - Content-Type header (e.g. "text/yaml", "application/xml"); ignored for GET
81
+ * @param method - HTTP method (default "POST")
29
82
  * @returns Parsed JSON response or structured error
30
83
  */
31
- export async function cloudFetch(path, body, contentType) {
32
- const baseUrl = getApiUrl();
33
- const apiKey = getApiKey();
34
- const url = `${baseUrl}${path}`;
35
- const headers = {
36
- "Content-Type": contentType,
37
- Accept: "application/json"
38
- };
39
- if (apiKey) {
40
- headers["Authorization"] = `Bearer ${apiKey}`;
84
+ export async function cloudFetch(path, body, contentType, method = "POST") {
85
+ const local = isLocalBackend();
86
+ // Resolve the local endpoint BEFORE the try: "no server running" is a
87
+ // configuration answer, not a transport failure, and deserves its own
88
+ // message rather than being folded into the network-error branch.
89
+ let endpoint;
90
+ if (local) {
91
+ endpoint = readLocalEndpoint();
92
+ if (!endpoint.ok) {
93
+ return { ok: false, error: endpoint.error };
94
+ }
41
95
  }
42
96
  try {
43
- const controller = new AbortController();
44
- const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
45
- const response = await fetch(url, {
46
- method: "POST",
47
- headers,
48
- body,
49
- signal: controller.signal
50
- });
51
- clearTimeout(timeout);
97
+ let response;
98
+ if (local && endpoint?.ok) {
99
+ response = await localFetch(endpoint.endpoint, path, body, contentType, method, LOCAL_TIMEOUT_MS);
100
+ }
101
+ else {
102
+ const headers = { Accept: "application/json" };
103
+ if (method !== "GET") {
104
+ headers["Content-Type"] = contentType;
105
+ }
106
+ const apiKey = getApiKey();
107
+ if (apiKey) {
108
+ headers["Authorization"] = `Bearer ${apiKey}`;
109
+ }
110
+ const controller = new AbortController();
111
+ const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
112
+ try {
113
+ response = await fetch(`${getApiUrl()}${path}`, {
114
+ method,
115
+ headers,
116
+ ...(method !== "GET" ? { body } : {}),
117
+ signal: controller.signal
118
+ });
119
+ }
120
+ finally {
121
+ clearTimeout(timeout);
122
+ }
123
+ }
52
124
  if (response.ok) {
53
125
  const data = (await response.json());
54
126
  return { ok: true, data };
@@ -56,58 +128,98 @@ export async function cloudFetch(path, body, contentType) {
56
128
  // Handle specific HTTP error codes with actionable messages
57
129
  switch (response.status) {
58
130
  case 401:
59
- case 403:
131
+ case 403: {
132
+ // The server says WHY (invalid key, expired trial, …) — surface it.
133
+ const { detail, hint, code } = await readErrorBody(response);
134
+ // A local server authenticates with a token from its own discovery
135
+ // file, so every word of the SaaS signup advice below is wrong here.
136
+ // The realistic cause is a stale file from a server that has since
137
+ // restarted with a fresh token.
138
+ if (local) {
139
+ return {
140
+ ok: false,
141
+ error: {
142
+ error: detail || "The on-premise server rejected this token.",
143
+ status: response.status,
144
+ hint: "The token is read from the server's discovery file. If the server was restarted, " +
145
+ "the file now holds a new token — retry. If that fails, restart `opcua-modeler serve`."
146
+ }
147
+ };
148
+ }
149
+ // Expired beta key: the fix is a rotation, not a signup — surface
150
+ // the renewal link verbatim so agents can relay it to the user.
151
+ if (code === "key_expired") {
152
+ const renewalNote = `Rotate your key at ${KEY_SETTINGS_URL} ("Rotate & extend" grants a fresh 30-day window), ` +
153
+ "then update OPCUA_MODELER_API_KEY in this MCP server's config.";
154
+ return {
155
+ ok: false,
156
+ error: {
157
+ error: detail || "Your OPC UA Modeler API key has expired.",
158
+ status: response.status,
159
+ hint: hint?.includes(KEY_SETTINGS_URL)
160
+ ? `${hint} — then update OPCUA_MODELER_API_KEY in this MCP server's config.`
161
+ : renewalNote
162
+ }
163
+ };
164
+ }
165
+ const mcpNote = "This MCP server reads the key from OPCUA_MODELER_API_KEY in its config. " +
166
+ "Register at https://opcua-modeler.sterfive.io/signup then create an API key " +
167
+ "under Settings > API (free tier: 25 calls/day, 90-day trial).";
60
168
  return {
61
169
  ok: false,
62
170
  error: {
63
- error: "Authentication required. Set OPCUA_MODELER_API_KEY in your MCP server config.",
171
+ error: detail || "Authentication required. Set OPCUA_MODELER_API_KEY in your MCP server config.",
64
172
  status: response.status,
65
- hint: "Register at https://opcua-modeler.sterfive.io/signup then create an API key " +
66
- "under Settings > API (free tier: 25 calls/day, 90-day trial)."
173
+ hint: hint ? `${hint} — ${mcpNote}` : mcpNote
67
174
  }
68
175
  };
176
+ }
69
177
  case 429: {
178
+ // The server distinguishes burst / daily / discovery limits — surface it.
179
+ const { detail, hint } = await readErrorBody(response);
70
180
  const retryAfter = response.headers.get("Retry-After");
71
181
  const upgradeUrl = response.headers.get("X-Upgrade-URL");
72
182
  return {
73
183
  ok: false,
74
184
  error: {
75
- error: `Rate limit exceeded.${retryAfter ? ` Try again in ${retryAfter}s.` : ""}`,
185
+ error: `${detail || "Rate limit exceeded."}${retryAfter ? ` Try again in ${retryAfter}s.` : ""}`,
76
186
  status: 429,
77
- hint: upgradeUrl ? `Upgrade your plan at ${upgradeUrl}` : "Reduce request frequency or upgrade your plan."
187
+ hint: hint || (upgradeUrl ? `Upgrade your plan at ${upgradeUrl}` : "Reduce request frequency or upgrade your plan.")
78
188
  }
79
189
  };
80
190
  }
81
191
  case 422: {
82
192
  // Validation error from the API (e.g. malformed YAML)
83
- let detail = "";
84
- try {
85
- const errBody = (await response.json());
86
- detail = errBody.detail || errBody.message || "";
87
- }
88
- catch {
89
- detail = await response.text();
90
- }
193
+ const { detail, hint } = await readErrorBody(response);
194
+ return {
195
+ ok: false,
196
+ error: {
197
+ error: `Validation error: ${detail || response.statusText || "(the server returned no details)"}`,
198
+ status: 422,
199
+ ...(hint ? { hint } : {})
200
+ }
201
+ };
202
+ }
203
+ case 501: {
204
+ // This backend does not implement the endpoint — on-premise omits AI
205
+ // generation. Distinct from a 404: the URL was right, the capability
206
+ // is absent, and the agent should switch backends rather than retry.
207
+ const { detail, hint } = await readErrorBody(response);
91
208
  return {
92
209
  ok: false,
93
210
  error: {
94
- error: `Validation error: ${detail}`,
95
- status: 422
211
+ error: detail || "This backend does not provide that capability.",
212
+ status: 501,
213
+ hint: hint || "Set OPCUA_MODELER_BACKEND=cloud to use the hosted API for this tool."
96
214
  }
97
215
  };
98
216
  }
99
217
  default: {
100
- let text = "";
101
- try {
102
- text = await response.text();
103
- }
104
- catch {
105
- /* ignore */
106
- }
218
+ const { detail } = await readErrorBody(response);
107
219
  return {
108
220
  ok: false,
109
221
  error: {
110
- error: `API error (HTTP ${response.status}): ${text || response.statusText}`,
222
+ error: `API error (HTTP ${response.status}): ${detail || response.statusText || "(the server returned no details)"}`,
111
223
  status: response.status
112
224
  }
113
225
  };
@@ -124,8 +236,20 @@ export async function cloudFetch(path, body, contentType) {
124
236
  }
125
237
  };
126
238
  }
127
- // Network errors (DNS, connection refused, etc.)
128
239
  const message = e instanceof Error ? e.message : String(e);
240
+ // A dead pipe means the server exited since it published its file — a
241
+ // different situation from a network problem, and a different fix.
242
+ if (local) {
243
+ return {
244
+ ok: false,
245
+ error: {
246
+ error: `Cannot reach the on-premise OPC UA Modeler server: ${message}`,
247
+ hint: "The server may have stopped since it published its discovery file. " +
248
+ "Restart it with `opcua-modeler serve`, or set OPCUA_MODELER_BACKEND=cloud."
249
+ }
250
+ };
251
+ }
252
+ // Network errors (DNS, connection refused, etc.)
129
253
  return {
130
254
  ok: false,
131
255
  error: {
package/dist/cloud.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"cloud.js","sourceRoot":"","sources":["../src/cloud.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"cloud.js","sourceRoot":"","sources":["../src/cloud.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,74 @@
1
+ /**
2
+ * ==========================================================================
3
+ * OPC UA Modeler — On-premise backend transport
4
+ *
5
+ * Talks to `opcua-modeler serve` running as the same OS user, over a named
6
+ * pipe (Windows) or Unix socket. Selected with OPCUA_MODELER_BACKEND=local.
7
+ *
8
+ * Why a pipe rather than a localhost port:
9
+ *
10
+ * - Both processes are on one machine by definition, so a network socket
11
+ * buys nothing and adds a surface. There is no address to bind wrongly
12
+ * and no port to expose beyond the host.
13
+ * - Access control is the operating system's, not ours: pipe and socket
14
+ * permissions already scope the endpoint to the user who started it,
15
+ * with no port-level authorisation layer to design or get wrong.
16
+ * - No port to allocate, publish, or collide with another service — the
17
+ * endpoint is named per process and advertised in a discovery file.
18
+ *
19
+ * Why node:http rather than fetch: native fetch cannot address a pipe without
20
+ * a custom dispatcher, and pulling undici into a package whose only runtime
21
+ * deps are the MCP SDK and zod is a poor trade for one option. `socketPath`
22
+ * has been in node:http forever and costs nothing.
23
+ *
24
+ * IMPORTANT: Never use console.log() — stdout is reserved for JSON-RPC.
25
+ * ==========================================================================
26
+ */
27
+ /**
28
+ * Where `opcua-modeler serve` advertises itself.
29
+ *
30
+ * This is a wire contract between two independently-distributed packages, so
31
+ * the path is restated here rather than imported — this package stays
32
+ * installable on its own, with no build-time coupling to the CLI. Both sides
33
+ * carry a test asserting the same path; change one, change the other.
34
+ *
35
+ * The location follows each platform's convention for per-user runtime state
36
+ * (XDG_RUNTIME_DIR, LOCALAPPDATA), so the endpoint is scoped to the account
37
+ * that started the server.
38
+ */
39
+ export declare function discoveryFilePath(env?: NodeJS.ProcessEnv): string;
40
+ export interface LocalEndpoint {
41
+ pipe: string;
42
+ token: string;
43
+ pid: number;
44
+ version: string;
45
+ capabilities: string[];
46
+ }
47
+ /** True when the operator asked for the on-premise backend. */
48
+ export declare function isLocalBackend(env?: NodeJS.ProcessEnv): boolean;
49
+ /**
50
+ * Locate a running server.
51
+ *
52
+ * Deliberately does NOT fall back to the cloud when the file is missing.
53
+ * On-premise is chosen so that models never leave the network; silently
54
+ * shipping a model to the hosted API because a local daemon was down is a
55
+ * data-egress bug, not a convenience.
56
+ */
57
+ export declare function readLocalEndpoint(env?: NodeJS.ProcessEnv): {
58
+ ok: true;
59
+ endpoint: LocalEndpoint;
60
+ } | {
61
+ ok: false;
62
+ error: {
63
+ error: string;
64
+ hint: string;
65
+ };
66
+ };
67
+ /**
68
+ * One request over the pipe, adapted to a `Response`.
69
+ *
70
+ * Returning a real Response means the caller's status handling — 401, 429,
71
+ * 422, the JSON/text error parsing — is the SAME code for both backends. Two
72
+ * copies of that logic is exactly the drift this whole design avoids.
73
+ */
74
+ export declare function localFetch(endpoint: LocalEndpoint, apiPath: string, body: string, contentType: string, method: "GET" | "POST", timeoutMs: number): Promise<Response>;