@deepseek-ai/dsh-experimental-inspector 0.1.6-alpha.1

package/lib/types/worker/realms/host/runtime.d.ts

@@ -0,0 +1,54 @@
+/** RuntimeBackend implementation over one native Node inspector session. */
+import type { RuntimeBackendObjectHandle } from '../../../shared/cdp/ids.ts';
+import type { RuntimeCompletion, RuntimeExceptionDetails, RuntimeRemoteObject, RuntimeExecutionContext, RuntimeStackTrace } from '../../../shared/cdp/index.ts';
+import type { HostInspectorSession } from './bridge.ts';
+import type { RuntimeBackend } from '../../../shared/cdp/realm.ts';
+/** Host Runtime adapter preserving native V8 semantics behind common values. */
+export declare class HostRuntimeBackend implements RuntimeBackend {
+    private readonly target;
+    private defaultContextId;
+    private readonly unsubscribe;
+    constructor(target: HostInspectorSession);
+    enable(): Promise<void>;
+    disable(): Promise<void>;
+    evaluate(request: Parameters<RuntimeBackend['evaluate']>[0]): ReturnType<RuntimeBackend['evaluate']>;
+    getProperties(request: Parameters<RuntimeBackend['getProperties']>[0]): ReturnType<RuntimeBackend['getProperties']>;
+    callFunction(request: Parameters<RuntimeBackend['callFunction']>[0]): ReturnType<RuntimeBackend['callFunction']>;
+    awaitPromise(request: Parameters<RuntimeBackend['awaitPromise']>[0]): ReturnType<RuntimeBackend['awaitPromise']>;
+    globalLexicalScopeNames(context?: RuntimeExecutionContext): Promise<readonly string[]>;
+    releaseObject(handle: RuntimeBackendObjectHandle): Promise<void>;
+    releaseObjectGroup(group: string): Promise<void>;
+    /** Release the native-context observer owned by this backend. */
+    close(): void;
+    /**
+     * Convert a native Runtime completion returned through another Node domain.
+     * @param value - Native result and optional exception details.
+     * @returns The realm-neutral completion.
+     */
+    completion(value: Readonly<Record<string, unknown>>): Promise<RuntimeCompletion<RuntimeBackendObjectHandle>>;
+    private properties;
+    private property;
+    private internalProperties;
+    private privateProperties;
+    /**
+     * Convert native exception details to the common Runtime model.
+     * @param value - Native `Runtime.ExceptionDetails` fields.
+     * @returns Exception details with normalized object references.
+     */
+    exceptionDetails(value: unknown): Promise<RuntimeExceptionDetails<RuntimeBackendObjectHandle>>;
+    /**
+     * Convert one native V8 RemoteObject to the common Runtime model.
+     * @param value - Native `Runtime.RemoteObject` fields.
+     * @returns Descriptor, backend handle, and optional Cordis identity.
+     */
+    remoteObject(value: unknown): Promise<RuntimeRemoteObject<RuntimeBackendObjectHandle>>;
+    /**
+     * Convert a native stack trace while retaining native script identities.
+     * @param value - Native `Runtime.StackTrace` fields.
+     * @returns Realm-neutral stack frames.
+     */
+    stackTrace(value: unknown): RuntimeStackTrace;
+    private observeContext;
+    private identifyObject;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/lib/types/worker/realms/host/scripts.d.ts

@@ -0,0 +1,9 @@
+/** Host-native script identity conversion for normalized source and debugger values. */
+import type { RuntimeScriptKey } from '../../../shared/cdp/ids.ts';
+/**
+ * Convert a Node inspector script id into the realm backend identity namespace.
+ * @param value - Native Node inspector script id.
+ * @returns The corresponding normalized script key.
+ */
+export declare function hostScriptKey(value: string): RuntimeScriptKey;
+//# sourceMappingURL=scripts.d.ts.map

package/lib/types/worker/realms/host/sources.d.ts

@@ -0,0 +1,26 @@
+/** SourceBackend implementation over native Node Debugger notifications. */
+import type { RuntimeScriptKey } from '../../../shared/cdp/ids.ts';
+import type { RuntimeScript } from '../../../shared/cdp/index.ts';
+import type { HostInspectorSession } from './bridge.ts';
+import type { SourceBackend } from '../../../shared/cdp/realm.ts';
+/** Maintains one connection-local catalog of scripts reported by Node's inspector. */
+export declare class HostSourceBackend implements SourceBackend {
+    private readonly target;
+    private readonly scripts;
+    private readonly listeners;
+    private readonly unsubscribe;
+    constructor(target: HostInspectorSession);
+    listScripts(): Promise<readonly RuntimeScript[]>;
+    getScriptSource(scriptKey: RuntimeScriptKey): Promise<string>;
+    getSourceMap(_scriptKey: RuntimeScriptKey): Promise<string | undefined>;
+    /**
+     * Subscribe to scripts discovered after the initial catalog read.
+     * @param listener - Consumer of newly discovered scripts.
+     * @returns A disposer removing the consumer.
+     */
+    subscribe(listener: (script: RuntimeScript) => void): () => void;
+    /** Release the native notification subscription and cached catalog. */
+    close(): void;
+    private receive;
+}
+//# sourceMappingURL=sources.d.ts.map

package/lib/types/worker/realms/host/values.d.ts

@@ -0,0 +1,22 @@
+/** Small validators for values returned by Node's native Inspector protocol. */
+/**
+ * Test whether a native protocol value is a non-array object record.
+ * @param value - Native protocol value.
+ * @returns Whether the value can be read as named fields.
+ */
+export declare function isNativeRecord(value: unknown): value is Readonly<Record<string, unknown>>;
+/**
+ * Require a native protocol object record.
+ * @param value - Native protocol value.
+ * @param label - Subject named in the validation error.
+ * @returns The validated object record.
+ */
+export declare function requireNativeRecord(value: unknown, label: string): Readonly<Record<string, unknown>>;
+/**
+ * Include an optional field only when the native request supplied a value.
+ * @param key - Native protocol field name.
+ * @param value - Optional field value.
+ * @returns An empty record or the requested field.
+ */
+export declare function optionalNativeField<Key extends string, Value>(key: Key, value: Value | undefined): Partial<Record<Key, Value>>;
+//# sourceMappingURL=values.d.ts.map

package/lib/types/worker/server.d.ts

@@ -0,0 +1,16 @@
+/** Inspector Worker assembly over one Host source port and one loopback endpoint. */
+import type { MessagePort } from 'node:worker_threads';
+import type { InspectorWorkerBoot } from '../shared/bridge/messages/control.ts';
+import { type InspectorEndpointInfo } from './bridge/endpoint.ts';
+/** Live Worker runtime. */
+export interface InspectorWorkerRuntime {
+    readonly endpoint: InspectorEndpointInfo;
+    close(): Promise<void>;
+}
+/**
+ * Assemble and start the Worker-owned source registry, Runtime router, Network domain, and endpoints.
+ * @param boot - Validated Worker configuration and transferred Host source port.
+ * @returns The listening endpoint and quiescent shutdown owner.
+ */
+export declare function startInspectorWorker(boot: InspectorWorkerBoot<MessagePort>): Promise<InspectorWorkerRuntime>;
+//# sourceMappingURL=server.d.ts.map