unity-open-mcp 0.1.2 → 0.3.0

package/dist/output-profile.js

@@ -0,0 +1,255 @@
+// M22 Plan 1 — Token-budget-aware output profiles + uniform paging.
+//
+// Single source of truth for two envelope concerns shared by the heavy tools
+// (read_asset / search_assets / scene_get_data / find_references / validate_edit
+// / scan_paths):
+//
+//  1. **Output profiles** (`compact` | `balanced` | `full`) — a uniform knob that
+//     maps onto each tool's existing `detail` axis (summary / normal / verbose).
+//     This reuses the M9 compression module instead of re-implementing folding:
+//     `compact` IS the existing summary/folded shape; `balanced` is the current
+//     default; `full` is verbose. The profile is the public, documented param;
+//     `detail` remains as a backwards-compatible alias.
+//
+//  2. **Uniform paging** (`page_size` / `cursor` / `next_cursor`) — replaces the
+//     ad-hoc `max_results` / `max_nodes` / `object_limit` caps with a resumable
+//     cursor. The old caps stay as aliases (they request a single bounded page).
+//     Every paginated response carries a `pagination` block.
+//
+// The module is pure (no I/O, no cross-file runtime imports) so it loads cleanly
+// under `node --experimental-strip-types` in tests.
+export const PROFILES = ["compact", "balanced", "full"];
+export function isOutputProfile(value) {
+    return value === "compact" || value === "balanced" || value === "full";
+}
+export function profileToDetail(profile) {
+    switch (profile) {
+        case "compact":
+            return "summary";
+        case "balanced":
+            return "normal";
+        case "full":
+            return "verbose";
+    }
+}
+/**
+ * Resolve the effective detail level for a call.
+ *
+ * Precedence: an explicit `profile` wins; otherwise an explicit legacy `detail`
+ * is honored (back-compat alias); otherwise the per-tool `fallback` is used.
+ * `compact` is the documented default for the heavy families, so most callers
+ * should pass `fallback: "summary"`. Tools whose legacy default was `normal`
+ * (find_references) still default to `summary` now — compact is the default
+ * everywhere per the M22 design decision.
+ */
+export function resolveDetail(profile, legacyDetail, fallback) {
+    if (profile)
+        return profileToDetail(profile);
+    if (legacyDetail === "summary" || legacyDetail === "normal" || legacyDetail === "verbose") {
+        return legacyDetail;
+    }
+    return fallback;
+}
+/**
+ * Read `profile` / `detail` off a raw args object and return the effective
+ * detail level. Returns the profile too (when present) so callers can branch on
+ * compact vs. expanded for result folding.
+ */
+export function readProfileAndDetail(args, fallback = "summary") {
+    const profileRaw = args.profile;
+    const profile = isOutputProfile(profileRaw) ? profileRaw : undefined;
+    const legacyDetail = typeof args.detail === "string" ? args.detail : undefined;
+    return { detail: resolveDetail(profile, legacyDetail, fallback), profile };
+}
+export function encodeCursor(toolKey, offset) {
+    return `${toolKey}:${offset}`;
+}
+export function splitCursor(cursor, expectedToolKey) {
+    if (typeof cursor !== "string" || cursor === "")
+        return 0;
+    const colon = cursor.lastIndexOf(":");
+    if (colon <= 0)
+        return 0;
+    const toolKey = cursor.slice(0, colon);
+    const offsetStr = cursor.slice(colon + 1);
+    // A cursor minted for a different tool (or a stale cursor from before a tool
+    // rename) must not silently page the wrong data — treat it as "start over".
+    if (toolKey !== expectedToolKey)
+        return 0;
+    const offset = parseNonNegativeInt(offsetStr);
+    return offset === null ? 0 : offset;
+}
+function parseNonNegativeInt(value) {
+    if (value.length === 0)
+        return null;
+    let out = 0;
+    for (let i = 0; i < value.length; i++) {
+        const ch = value[i];
+        if (ch < "0" || ch > "9")
+            return null;
+        out = out * 10 + (ch.charCodeAt(0) - "0".charCodeAt(0));
+    }
+    return out;
+}
+/**
+ * Slice `items` into one page starting at the cursor offset.
+ *
+ * - `page_size` <= 0 ⇒ disabled: returns the whole list with a terminal block
+ *   (next_cursor null, truncated 0). This is the back-compat / alias path.
+ * - A cursor with the wrong tool key resets to offset 0 (see splitCursor).
+ * - Count invariant: `page.length + block.truncated == items.length - offset`.
+ */
+export function applyPaging(items, toolKey, input) {
+    const pageSize = typeof input.page_size === "number" && input.page_size > 0
+        ? Math.floor(input.page_size)
+        : 0;
+    if (pageSize <= 0) {
+        return {
+            page: items.slice(),
+            block: {
+                page_size: 0,
+                cursor: typeof input.cursor === "string" && input.cursor !== "" ? input.cursor : null,
+                next_cursor: null,
+                truncated: 0,
+            },
+        };
+    }
+    const offset = Math.min(splitCursor(input.cursor, toolKey), items.length);
+    const page = items.slice(offset, offset + pageSize);
+    const remaining = items.length - (offset + page.length);
+    const nextCursor = remaining > 0 ? encodeCursor(toolKey, offset + page.length) : null;
+    return {
+        page,
+        block: {
+            page_size: pageSize,
+            cursor: typeof input.cursor === "string" && input.cursor !== "" ? input.cursor : null,
+            next_cursor: nextCursor,
+            truncated: remaining,
+        },
+    };
+}
+// ===========================================================================
+// Envelope attachment.
+//
+// Heavy-tool results are plain objects serialized to the MCP text block. We
+// merge a `pagination` block in (and optionally fold fields) as the last step
+// of each route, mirroring how injectRouteMeta appends `_route`.
+// ===========================================================================
+/**
+ * Return a shallow copy of `result` with `pagination` set. Idempotent: a result
+ * that already carries a `pagination` block (e.g. built inline by a router) is
+ * returned unchanged so two post-processors never clobber each other.
+ *
+ * Generic over the concrete result interface so callers can pass a typed
+ * CompactSearchResult / FindReferencesOfflineResult without an index signature.
+ */
+export function attachPagination(result, block) {
+    const r = result;
+    if (r.pagination !== undefined)
+        return r;
+    return { ...result, pagination: block };
+}
+/**
+ * Fold a verify result (`passed` + `issues[]` + metadata) per the requested
+ * profile, optionally paging the issues list.
+ *
+ * - `compact`: drop `issues[]`, emit `issueCount` + `issuesBySeverity` counts.
+ * - `balanced` / `full`: keep `issues[]` (paged when `page_size` is set).
+ *
+ * `fail_on_severity` and other verify-specific fields are passed through
+ * untouched.
+ */
+export function foldVerifyResult(result, toolKey, profile, paging) {
+    const issues = Array.isArray(result.issues)
+        ? result.issues
+        : [];
+    const issueCount = issues.length;
+    const issuesBySeverity = countBySeverity(issues);
+    // compact: counts only — strip the issues array.
+    if (profile === "compact") {
+        const { issues: _dropped, ...rest } = result;
+        void _dropped;
+        return {
+            ...rest,
+            issueCount,
+            issuesBySeverity,
+        };
+    }
+    // balanced / full: page the issues list when a page size is requested.
+    const pageSize = typeof paging.page_size === "number" && paging.page_size > 0
+        ? Math.floor(paging.page_size)
+        : 0;
+    if (pageSize <= 0) {
+        return {
+            ...result,
+            issueCount,
+            issuesBySeverity,
+        };
+    }
+    const offset = Math.min(splitCursor(paging.cursor, toolKey), issues.length);
+    const page = issues.slice(offset, offset + pageSize);
+    const remaining = issues.length - (offset + page.length);
+    const nextCursor = remaining > 0 ? encodeCursor(toolKey, offset + page.length) : null;
+    const { issues: _replaced, pagination: _existingPagination, ...rest } = result;
+    void _replaced;
+    void _existingPagination;
+    return {
+        ...rest,
+        issues: page,
+        issueCount,
+        issuesBySeverity,
+        pagination: {
+            page_size: pageSize,
+            cursor: typeof paging.cursor === "string" && paging.cursor !== "" ? paging.cursor : null,
+            next_cursor: nextCursor,
+            truncated: remaining,
+        },
+    };
+}
+function countBySeverity(issues) {
+    const counts = {};
+    for (const issue of issues) {
+        const sev = issue.severity ?? "unknown";
+        counts[sev] = (counts[sev] ?? 0) + 1;
+    }
+    return counts;
+}
+// ===========================================================================
+// Result-block helpers — operate on the CallToolResult text block.
+// ===========================================================================
+/**
+ * Parse the first text content block of a CallToolResult as JSON. Returns null
+ * when there is no text block or it is not a JSON object (so callers can fall
+ * through without throwing).
+ */
+export function parseResultBody(result) {
+    const first = result.content[0];
+    if (!first || first.type !== "text" || typeof first.text !== "string")
+        return null;
+    try {
+        const parsed = JSON.parse(first.text);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        // fall through
+    }
+    return null;
+}
+/**
+ * Rewrite the first text content block of a CallToolResult with a new JSON
+ * body. Other content blocks (e.g. an MCP image block from capture_inline) are
+ * preserved untouched. `isError` and `_meta` are preserved.
+ */
+export function withResultBody(result, body) {
+    const textIndex = result.content.findIndex((c) => c.type === "text");
+    const newBlock = { type: "text", text: JSON.stringify(body) };
+    if (textIndex < 0) {
+        return { ...result, content: [newBlock, ...result.content] };
+    }
+    const newContent = result.content.slice();
+    newContent[textIndex] = newBlock;
+    return { ...result, content: newContent };
+}
+//# sourceMappingURL=output-profile.js.map

package/dist/output-profile.js.map

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

package/dist/retry-policy.d.ts

@@ -0,0 +1,72 @@
+import type { LifecycleClass } from "./capabilities/lifecycle.js";
+/**
+ * How the LiveClient should wait between a failure and the next attempt.
+ *
+ *   - `compile-settle`  — poll /ping until the domain reload completes (the
+ *                         bridge tears down its listener for the reload; the
+ *                         poll detects when it comes back). Used by
+ *                         compile-reload tools.
+ *   - `heartbeat-poll`  — bounded backoff re-probing /ping; relies on the
+ *                         heartbeat staying fresh. Used by process-stale tools
+ *                         where the bridge may stall but not die.
+ *   - `transient-backoff` — short escalating backoff for connection churn that
+ *                         isn't reflected in the lock yet. The default for
+ *                         read-only (none) tools.
+ *   - `none`            — do not retry. The failure is surfaced immediately;
+ *                         the agent must resolve the underlying state (e.g.
+ *                         save or discard a dirty scene before retrying a
+ *                         scene-dirty tool).
+ */
+export type SettleStrategy = "compile-settle" | "heartbeat-poll" | "transient-backoff" | "none";
+export interface RetryConfig {
+    /** Lifecycle class this config applies to. */
+    readonly lifecycleClass: LifecycleClass;
+    /** Max retry attempts after the initial failure (0 = never retry). */
+    readonly maxAttempts: number;
+    /** Base backoff in ms; the n-th attempt sleeps backoffMs * n (escalating). */
+    readonly backoffMs: number;
+    /** How to wait between attempts. */
+    readonly settleStrategy: SettleStrategy;
+}
+export declare const DEFAULT_COMPILE_WAIT_MS = 120000;
+export declare const DEFAULT_COMPILE_POLL_INTERVAL_MS = 2000;
+export declare const DEFAULT_TRANSIENT_RETRY_ATTEMPTS = 3;
+export declare const DEFAULT_TRANSIENT_BACKOFF_MS = 500;
+/**
+ * Per-class retry policy. The `none` (read-only) class inherits the original
+ * transient-backoff behaviour; `scene-dirty` explicitly does not retry (the
+ * guard error must be resolved by the agent, not retried through).
+ */
+export declare const RETRY_CONFIG: Readonly<Record<LifecycleClass, RetryConfig>>;
+/**
+ * Resolve the retry policy for a lifecycle class. Falls back to the `none`
+ * (read-only) policy for an unknown class so a new class added without an
+ * entry gets safe defaults.
+ */
+export declare function retryConfigFor(lifecycleClass: LifecycleClass, overrides?: Partial<RetryTunables>): RetryConfig;
+/**
+ * Numeric tunables an operator can override via env vars without changing the
+ * per-class settle strategy. Resolved once at LiveClient construction.
+ */
+export interface RetryTunables {
+    /** Hard cap on the compile-settle poll loop, in ms. */
+    readonly compileWaitMs: number;
+    /** Interval between /ping probes during compile-settle, in ms. */
+    readonly compilePollIntervalMs: number;
+    /** Max transient retry attempts for the backoff loops. */
+    readonly transientRetryAttempts: number;
+    /** Base backoff (ms) for the transient-backoff + heartbeat-poll loops. */
+    readonly transientBackoffMs: number;
+}
+export declare const RETRY_ENV: {
+    readonly compileWait: "UNITY_OPEN_MCP_COMPILE_WAIT_MS";
+    readonly compilePollInterval: "UNITY_OPEN_MCP_COMPILE_POLL_INTERVAL_MS";
+    readonly transientRetryAttempts: "UNITY_OPEN_MCP_TRANSIENT_RETRY_ATTEMPTS";
+    readonly transientBackoff: "UNITY_OPEN_MCP_TRANSIENT_BACKOFF_MS";
+};
+/**
+ * Read retry tunables from the environment. Unset / invalid values fall back
+ * to the documented defaults. Pure aside from the env read; takes the env as
+ * an argument so tests can inject a fake environment.
+ */
+export declare function readRetryTunables(env?: NodeJS.ProcessEnv): RetryTunables;

package/dist/retry-policy.js

@@ -0,0 +1,146 @@
+// Structured retry policy per agent-facing lifecycle class.
+//
+// Formalizes the ad-hoc retry loops that previously lived as module constants
+// in live-client.ts (TRANSIENT_RETRY_ATTEMPTS / TRANSIENT_RETRY_BACKOFF_MS /
+// MAX_COMPILE_WAIT_MS). Each lifecycle class (capabilities/lifecycle.ts) now
+// carries an explicit retry + settle policy so an agent (or the MCP server on
+// its behalf) can branch recovery programmatically instead of parsing
+// free-text errors or relying on hardcoded numbers.
+//
+// The policy is consulted by the LiveClient's transient-offline handler: given
+// the tool's lifecycle class, it picks the settle strategy and backoff
+// parameters. The dead-bridge / reloading classification in
+// instance-discovery.ts is unchanged — this module only governs *how long and
+// how often* to retry, not *what* a failure means.
+//
+// Pure data + pure functions (no I/O). Env overrides are parsed once via
+// readRetryConfig() so the live-client can resolve them at construction time,
+// mirroring the readDismissConfig() pattern in dialog-dismiss.ts.
+// ---------------------------------------------------------------------------
+// Per-class defaults.
+//
+// These are the documented defaults; every value is overridable via env vars
+// (see readRetryConfig). The numbers match the pre-existing hardcoded values
+// in live-client.ts so behaviour is preserved when no env override is set.
+// ---------------------------------------------------------------------------
+export const DEFAULT_COMPILE_WAIT_MS = 120_000;
+export const DEFAULT_COMPILE_POLL_INTERVAL_MS = 2_000;
+export const DEFAULT_TRANSIENT_RETRY_ATTEMPTS = 3;
+export const DEFAULT_TRANSIENT_BACKOFF_MS = 500;
+/**
+ * Per-class retry policy. The `none` (read-only) class inherits the original
+ * transient-backoff behaviour; `scene-dirty` explicitly does not retry (the
+ * guard error must be resolved by the agent, not retried through).
+ */
+export const RETRY_CONFIG = {
+    // Read-only: short transient retry for socket churn during a reload.
+    none: {
+        lifecycleClass: "none",
+        maxAttempts: DEFAULT_TRANSIENT_RETRY_ATTEMPTS,
+        backoffMs: DEFAULT_TRANSIENT_BACKOFF_MS,
+        settleStrategy: "transient-backoff",
+    },
+    // Domain reload: wait out the compile, then retry once the listener is back.
+    "compile-reload": {
+        lifecycleClass: "compile-reload",
+        maxAttempts: DEFAULT_TRANSIENT_RETRY_ATTEMPTS,
+        backoffMs: DEFAULT_TRANSIENT_BACKOFF_MS,
+        settleStrategy: "compile-settle",
+    },
+    // OS modal: no first-class retry here — the dialog dismiss loop
+    // (dialog-policy.ts) runs concurrently inside the compile-settle wait. A
+    // mid-call modal that the dismiss loop cannot handle surfaces as a
+    // timeout; the agent must dismiss it manually.
+    "modal-dialog": {
+        lifecycleClass: "modal-dialog",
+        maxAttempts: DEFAULT_TRANSIENT_RETRY_ATTEMPTS,
+        backoffMs: DEFAULT_TRANSIENT_BACKOFF_MS,
+        settleStrategy: "compile-settle",
+    },
+    // scene-dirty: NEVER retry. The dirty guard refusal is the contract — the
+    // agent must save/discard or pass ignore_scene_dirty: true.
+    "scene-dirty": {
+        lifecycleClass: "scene-dirty",
+        maxAttempts: 0,
+        backoffMs: 0,
+        settleStrategy: "none",
+    },
+    // process-stale: the heartbeat may stall during a long op; re-probe with
+    // bounded backoff rather than declaring the bridge dead.
+    "process-stale": {
+        lifecycleClass: "process-stale",
+        maxAttempts: DEFAULT_TRANSIENT_RETRY_ATTEMPTS,
+        backoffMs: DEFAULT_TRANSIENT_BACKOFF_MS,
+        settleStrategy: "heartbeat-poll",
+    },
+};
+/**
+ * Resolve the retry policy for a lifecycle class. Falls back to the `none`
+ * (read-only) policy for an unknown class so a new class added without an
+ * entry gets safe defaults.
+ */
+export function retryConfigFor(lifecycleClass, overrides) {
+    const base = RETRY_CONFIG[lifecycleClass] ?? RETRY_CONFIG.none;
+    if (!overrides)
+        return base;
+    // Only the numeric tunables are overridable; the settle strategy is a
+    // structural property of the class, not a knob.
+    return {
+        ...base,
+        maxAttempts: clampNonNegInt(overrides.transientRetryAttempts, base.maxAttempts),
+        backoffMs: clampPositiveInt(overrides.transientBackoffMs, base.backoffMs),
+    };
+}
+export const RETRY_ENV = {
+    compileWait: "UNITY_OPEN_MCP_COMPILE_WAIT_MS",
+    compilePollInterval: "UNITY_OPEN_MCP_COMPILE_POLL_INTERVAL_MS",
+    transientRetryAttempts: "UNITY_OPEN_MCP_TRANSIENT_RETRY_ATTEMPTS",
+    transientBackoff: "UNITY_OPEN_MCP_TRANSIENT_BACKOFF_MS",
+};
+/**
+ * Read retry tunables from the environment. Unset / invalid values fall back
+ * to the documented defaults. Pure aside from the env read; takes the env as
+ * an argument so tests can inject a fake environment.
+ */
+export function readRetryTunables(env = process.env) {
+    return {
+        compileWaitMs: parsePositiveInt(env[RETRY_ENV.compileWait], DEFAULT_COMPILE_WAIT_MS),
+        compilePollIntervalMs: parsePositiveInt(env[RETRY_ENV.compilePollInterval], DEFAULT_COMPILE_POLL_INTERVAL_MS),
+        transientRetryAttempts: parseNonNegInt(env[RETRY_ENV.transientRetryAttempts], DEFAULT_TRANSIENT_RETRY_ATTEMPTS),
+        transientBackoffMs: parsePositiveInt(env[RETRY_ENV.transientBackoff], DEFAULT_TRANSIENT_BACKOFF_MS),
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers.
+// ---------------------------------------------------------------------------
+function parsePositiveInt(raw, fallback) {
+    if (raw === undefined || raw === "")
+        return fallback;
+    const n = parseInt(raw, 10);
+    if (!Number.isFinite(n) || n <= 0)
+        return fallback;
+    return n;
+}
+function parseNonNegInt(raw, fallback) {
+    if (raw === undefined || raw === "")
+        return fallback;
+    const n = parseInt(raw, 10);
+    if (!Number.isFinite(n) || n < 0)
+        return fallback;
+    return n;
+}
+function clampPositiveInt(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isFinite(value) || value <= 0)
+        return fallback;
+    return value;
+}
+function clampNonNegInt(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (!Number.isFinite(value) || value < 0)
+        return fallback;
+    return value;
+}
+//# sourceMappingURL=retry-policy.js.map

package/dist/retry-policy.js.map

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

package/dist/routers.d.ts

@@ -9,6 +9,10 @@ export interface ResolvedEnv {
     projectPath: string;
     port: number;
     authToken: string | undefined;
+    /** Parsed UNITY_OPEN_MCP_BRIDGE_PORT (or CLI --port override), else undefined.
+     *  Threaded into LiveClient so refreshEndpointFromLock respects the same
+     *  override precedence as construction (env override ⇒ no lock refresh). */
+    envPort: number | undefined;
 }
 /**
  * Resolve the project path / port / auth token from explicit overrides (CLI

package/dist/routers.js

@@ -35,7 +35,7 @@ export function resolveEnv(projectPathOverride, portOverride) {
     const effectiveEnvPort = rawEnvPort && Number.isInteger(envPort) ? envPort : undefined;
     const port = resolvePort(projectPath, portOverride ?? effectiveEnvPort);
     const authToken = resolveAuthToken(projectPath, portOverride ?? effectiveEnvPort);
-    return { projectPath, port, authToken };
+    return { projectPath, port, authToken, envPort: portOverride ?? effectiveEnvPort };
 }
 export class ResolveEnvError extends Error {
 }
@@ -46,7 +46,7 @@ export class ResolveEnvError extends Error {
  */
 export function buildRouterStack(env) {
     const pingCache = new PingCache();
-    const live = new LiveClient(env.port, pingCache, env.authToken, env.projectPath);
+    const live = new LiveClient(env.port, pingCache, env.authToken, env.projectPath, undefined, env.envPort);
     const batch = new BatchSpawn();
     const eventStream = new BridgeEventStream(`http://127.0.0.1:${env.port}`, undefined, env.authToken);
     const sessionState = new ToolSessionState();

package/dist/routers.js.map

@@ -1 +1 @@
-{"version":3,"file":"routers.js","sourceRoot":"","sources":["../src/routers.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yBAAyB;AAEzB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAQ3D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,UAAU,CACxB,mBAA4B,EAC5B,YAAqB;IAErB,MAAM,WAAW,GAAG,mBAAmB,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC1E,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,eAAe,CACvB,sDAAsD;YACpD,6BAA6B,CAChC,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC;IAC1D,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,MAAM,gBAAgB,GACpB,UAAU,IAAI,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAEhE,MAAM,IAAI,GAAG,WAAW,CACtB,WAAW,EACX,YAAY,IAAI,gBAAgB,CACjC,CAAC;IACF,MAAM,SAAS,GAAG,gBAAgB,CAChC,WAAW,EACX,YAAY,IAAI,gBAAgB,CACjC,CAAC;IAEF,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;CAAG;AAkB7C;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAgB;IAC/C,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,IAAI,UAAU,EAAE,CAAC;IAC/B,MAAM,WAAW,GAAG,IAAI,iBAAiB,CACvC,oBAAoB,GAAG,CAAC,IAAI,EAAE,EAC9B,SAAS,EACT,GAAG,CAAC,SAAS,CACd,CAAC;IACF,MAAM,YAAY,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;IACvF,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC;QACxC,IAAI;QACJ,SAAS;QACT,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;KACf,CAAC,CAAC;IACH,OAAO;QACL,IAAI;QACJ,KAAK;QACL,MAAM;QACN,SAAS;QACT,cAAc;QACd,WAAW;QACX,YAAY;QACZ,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"routers.js","sourceRoot":"","sources":["../src/routers.ts"],"names":[],"mappings":"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"}

package/dist/server-instructions.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Build the server instructions string. Memoized at the module level so
+ * repeated `Server` constructions (tests, multi-project) do not re-stringify.
+ */
+export declare function buildServerInstructions(): string;
+/**
+ * Return the server instructions, memoized. The string is constant for the
+ * lifetime of the process, so a single computation is sufficient.
+ */
+export declare function getServerInstructions(): string;
+/**
+ * Test hook: assert the instructions carry no internal IDs / reference-project
+ * handles. Exposed so the test suite can call it without duplicating the
+ * banned-pattern list.
+ *
+ * @returns an array of offending patterns (empty when clean).
+ */
+export declare function findBannedInstructionsReferences(text: string): string[];