@classcad/mcp 0.1.0

package/dist/bridge/server.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,98 @@
+import WebSocket from 'ws';
+import type { ApiResult, Graphic, Structure } from './types.js';
+import type { BridgeRegistry } from './bridge/server.js';
+import { type LocalEngine, type LocalWasmOptions } from './engine/wasm.js';
+export type EnginePolicy = 'auto' | 'drogon' | 'wasm';
+export type Transport = 'ws' | 'bridge' | 'wasm';
+/**
+ * Around a graphic pull inside a suppressed script: kernel graphics only —
+ * the content the renderer contract has always been built on. Switched back
+ * right after the GetTree. (The suppression profile itself lives in
+ * @classcad/script's emission.ts and is applied by runScript.)
+ */
+export declare const PULL_GRAPHIC_ON: Record<string, unknown>;
+export type ConnectOptions = {
+    graphics?: boolean;
+    requestTimeoutMs?: number;
+    connectTimeoutMs?: number;
+    debug?: boolean;
+    sessionId?: string | null;
+    /** Accessor for the bridge registry (apps announcing share tokens); needed for reconnectBridge. */
+    bridge?: () => BridgeRegistry | null;
+    /** Which engine to use when no token/URL decides it. Default 'auto'. */
+    engine?: EnginePolicy;
+    /** Settings of the local WASM engine; null/undefined = no key = not available. */
+    wasm?: LocalWasmOptions | null;
+    /** Where connection decisions are reported (stderr / daemon log). */
+    log?: (msg: string) => void;
+};
+/**
+ * This release does not hand out OFB (the native, parametric format): the
+ * commands that serialize to OFB — common.save and assembly.exportNode, whose
+ * default format IS OFB — are refused whether the data would be returned,
+ * written to a file or sent to a url. STEP/STL exports and loading OFB stay.
+ * Returns the refusal message, or null when the task may run.
+ */
+export declare function ofbExportRefusal(task: object): string | null;
+export type Client = {
+    /** Raw request. Tracked as a potential mutation unless `opts.track === false`. */
+    request: <T = unknown>(command: string, extra?: object, opts?: {
+        track?: boolean;
+    }) => Promise<ApiResult<T>>;
+    /** One API task. OFB exports are refused (see ofbExportRefusal) unless `internalOfb` — the checkpoint's in-process save. */
+    execute: <T = unknown>(task: object, opts?: {
+        internalOfb?: boolean;
+    }) => Promise<ApiResult<T>>;
+    close: () => void;
+    /** Cached structure (as of the last pull). */
+    getStructure: () => Structure | null;
+    /** Cached graphic (as of the last pull). */
+    getLastGraphic: () => Graphic | null;
+    /** Structure tree, pulled only when stale (or `refresh`). */
+    getTree: (o?: {
+        refresh?: boolean;
+    }) => Promise<Structure['tree']>;
+    /** Graphic, pulled only when stale. `recalc: true` regenerates first (destroys entity-injection bodies). */
+    getGraphic: (o?: {
+        recalc?: boolean;
+    }) => Promise<Graphic | null>;
+    /** Forced pull of structure + graphic (GetTree, with the kernel graphic switched on around it). */
+    pull: () => Promise<void>;
+    /** Effective per-connection emission config (server-side state). */
+    getEmissionConfig: () => Promise<Record<string, unknown>>;
+    /** Merge `partial` into the connection config; returns the effective flags. Restore SUPPRESS_EMISSION when done. */
+    setEmissionConfig: (partial: Record<string, unknown>) => Promise<Record<string, unknown>>;
+    /** @deprecated alias of pull() that returns the structure — kept for existing tools. */
+    refreshTree: () => Promise<Structure | null>;
+    reconnect: (sessionId: string | null, engine?: EnginePolicy) => Promise<void>;
+    /** Reconnect to a DIFFERENT server URL — e.g. a multi-client token/invite URL (`wss://…/?invite=…`), used verbatim. */
+    reconnectUrl: (url: string) => Promise<void>;
+    /**
+     * Attach to an in-app engine (WASM) through the bridge: the app announced
+     * `token` on the MCP's bridge listener; from then on every engine command
+     * is relayed to the app (engine.execute) instead of a WebSocket worker.
+     */
+    reconnectBridge: (token: string) => Promise<void>;
+    /** 'ws' (a ClassCAD worker over WebSocket), 'bridge' (an app's in-page engine) or 'wasm' (the MCP's own engine). */
+    readonly transport: Transport;
+    /** The engine policy in force when no token/URL decides ('auto' | 'drogon' | 'wasm'). */
+    readonly engine: EnginePolicy;
+    /** True when a key for the local WASM engine is configured. */
+    readonly wasmAvailable: boolean;
+    /** The running local engine, if any. */
+    readonly localEngine: LocalEngine | null;
+    /** The share token this client joined with (invite or bridge token), or null. */
+    readonly shareToken: string | null;
+    /** True while the engine link is usable. */
+    readonly connected: boolean;
+    /** The configured worker URL (session-id reconnects always return to it). */
+    readonly baseUrl: string;
+    /** Increments on every reconnect/reconnectUrl — cache invalidation key for per-session state. */
+    readonly generation: number;
+    /** Tracked requests since the last (re)connect — cache-invalidation key for pulls. */
+    readonly version: number;
+    readonly ws: WebSocket | undefined;
+    readonly sessionId: string | null;
+    readonly url: string;
+};
+export declare function connect(url?: string, opts?: ConnectOptions): Promise<Client>;