wake-bridge 0.9.0-preview.8

package/dist/src/event-sdk.d.ts

@@ -0,0 +1,43 @@
+import type { JsonValue, WakeEventInput } from "./types.js";
+export declare const EVENT_CONTRACT_VERSION: 1;
+export declare const SUPPORTED_EVENT_CONTRACT_VERSIONS: readonly [1];
+/** Validate and normalize the stable v1 producer payload. */
+export declare function validateWakeEventInput(raw: WakeEventInput, now?: Date): WakeEventInput & {
+    schema_version: 1;
+    occurred_at: string;
+};
+export interface SourcePushClientOptions {
+    base_url: string;
+    source: string;
+    token: string;
+    fetch?: typeof fetch;
+    timeout_ms?: number;
+}
+export interface SourcePushReceipt {
+    event: {
+        id: string;
+        source: string;
+        type: string;
+        dedupe_key: string;
+        schema_version: number;
+        occurred_at: string;
+        received_at: string;
+    };
+    duplicate: boolean;
+    suppressed: boolean;
+    claim?: {
+        id: string;
+    };
+    [key: string]: JsonValue | object | undefined;
+}
+/** Narrow client for the credential-bound generic push ingress. */
+export declare class SourcePushClient {
+    private readonly options;
+    private readonly origin;
+    private readonly fetchImpl;
+    private readonly timeoutMs;
+    constructor(options: SourcePushClientOptions);
+    emit(input: WakeEventInput): Promise<SourcePushReceipt>;
+}
+export type { JsonPrimitive, JsonValue, PriorityHint, ResourceRef, WakeEventInput } from "./types.js";
+export { WakeBridgeSdkError } from "./sdk-error.js";

package/dist/src/event-sdk.js

@@ -0,0 +1,152 @@
+import { WakeBridgeSdkError } from "./sdk-error.js";
+export const EVENT_CONTRACT_VERSION = 1;
+export const SUPPORTED_EVENT_CONTRACT_VERSIONS = [EVENT_CONTRACT_VERSION];
+const ABSOLUTE_RFC3339 = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})$/u;
+const FORBIDDEN_INPUT_KEYS = new Set([
+    "owner_id", "instance_id", "policy", "policy_id", "endpoint", "endpoint_id",
+    "wake_prompt", "wakePrompt", "system_instruction", "systemInstruction", "instructions", "prompt",
+]);
+function validateNoPrompt(value, path = "input") {
+    if (!value || typeof value !== "object")
+        return;
+    if (Array.isArray(value)) {
+        value.forEach((item, index) => validateNoPrompt(item, `${path}[${index}]`));
+        return;
+    }
+    for (const [key, child] of Object.entries(value)) {
+        if (FORBIDDEN_INPUT_KEYS.has(key)) {
+            throw new WakeBridgeSdkError(`${path}.${key} is not accepted by event ingress`, "forbidden_field", 400);
+        }
+        validateNoPrompt(child, `${path}.${key}`);
+    }
+}
+function validateResource(resource) {
+    if (!resource || typeof resource !== "object" || typeof resource.uri !== "string") {
+        throw new WakeBridgeSdkError("resource.uri is required", "invalid_resource", 400);
+    }
+    if (resource.uri.length === 0 || resource.uri.length > 2048 || !/^[A-Za-z][A-Za-z0-9+.-]*:/u.test(resource.uri)) {
+        throw new WakeBridgeSdkError("resource.uri must be a bounded absolute URI", "invalid_resource", 400);
+    }
+    if (JSON.stringify(resource).length > 4096) {
+        throw new WakeBridgeSdkError("resource is too large", "oversized_event", 413);
+    }
+}
+function absoluteTimestamp(value, field) {
+    if (typeof value !== "string" || !ABSOLUTE_RFC3339.test(value)) {
+        throw new WakeBridgeSdkError(`${field} must be an absolute RFC3339 timestamp with Z or numeric offset`, "invalid_timestamp", 400);
+    }
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        throw new WakeBridgeSdkError(`${field} is invalid`, "invalid_timestamp", 400);
+    }
+    return date.toISOString();
+}
+/** Validate and normalize the stable v1 producer payload. */
+export function validateWakeEventInput(raw, now = new Date()) {
+    if (!raw || typeof raw.type !== "string" || !raw.type || raw.type.length > 200) {
+        throw new WakeBridgeSdkError("event type is required", "invalid_event", 400);
+    }
+    if (raw.schema_version != null && raw.schema_version !== EVENT_CONTRACT_VERSION) {
+        throw new WakeBridgeSdkError(`unsupported event schema_version: ${String(raw.schema_version)}`, "unsupported_schema", 400);
+    }
+    if (!raw.dedupe_key || typeof raw.dedupe_key !== "string" || raw.dedupe_key.length > 500) {
+        throw new WakeBridgeSdkError("dedupe_key is required and bounded", "invalid_event", 400);
+    }
+    validateNoPrompt(raw);
+    validateResource(raw.resource);
+    const metadata = raw.metadata ?? {};
+    if (!metadata || typeof metadata !== "object" || Array.isArray(metadata) || JSON.stringify(metadata).length > 8192) {
+        throw new WakeBridgeSdkError("metadata must be a bounded object", "oversized_event", 413);
+    }
+    if (raw.payload_preview != null && (typeof raw.payload_preview !== "string" || raw.payload_preview.length > 500)) {
+        throw new WakeBridgeSdkError("payload_preview is limited to 500 characters", "oversized_event", 413);
+    }
+    if (Number.isNaN(now.getTime())) {
+        throw new WakeBridgeSdkError("event clock is invalid", "invalid_event_clock", 500);
+    }
+    return {
+        schema_version: EVENT_CONTRACT_VERSION,
+        type: raw.type,
+        occurred_at: raw.occurred_at ? absoluteTimestamp(raw.occurred_at, "occurred_at") : now.toISOString(),
+        dedupe_key: raw.dedupe_key,
+        coalesce_key: raw.coalesce_key ?? null,
+        priority_hint: raw.priority_hint ?? null,
+        attention_channel_hint: raw.attention_channel_hint ?? null,
+        actor_ref: raw.actor_ref ?? null,
+        resource: raw.resource,
+        metadata,
+        payload_preview: raw.payload_preview ?? null,
+        idempotency_key: raw.idempotency_key ?? null,
+    };
+}
+const SOURCE_ID = /^[A-Za-z0-9_.:-]{1,128}$/u;
+function localOrigin(raw) {
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        throw new WakeBridgeSdkError("source push base_url is invalid", "invalid_source_push_config", 400);
+    }
+    if (url.protocol !== "http:" || !["127.0.0.1", "[::1]", "localhost"].includes(url.hostname)
+        || url.username || url.password || url.pathname !== "/" || url.search || url.hash) {
+        throw new WakeBridgeSdkError("source push base_url must be a credential-free loopback HTTP origin", "invalid_source_push_config", 400);
+    }
+    return url;
+}
+/** Narrow client for the credential-bound generic push ingress. */
+export class SourcePushClient {
+    options;
+    origin;
+    fetchImpl;
+    timeoutMs;
+    constructor(options) {
+        this.options = options;
+        this.origin = localOrigin(options.base_url);
+        if (!SOURCE_ID.test(options.source)) {
+            throw new WakeBridgeSdkError("source push source is invalid", "invalid_source_push_config", 400);
+        }
+        if (typeof options.token !== "string" || options.token.length < 32) {
+            throw new WakeBridgeSdkError("source push token must contain at least 32 characters", "invalid_source_push_config", 400);
+        }
+        this.fetchImpl = options.fetch ?? fetch;
+        this.timeoutMs = options.timeout_ms ?? 15_000;
+        if (!Number.isSafeInteger(this.timeoutMs) || this.timeoutMs < 1 || this.timeoutMs > 300_000) {
+            throw new WakeBridgeSdkError("source push timeout_ms is invalid", "invalid_source_push_config", 400);
+        }
+    }
+    async emit(input) {
+        const event = validateWakeEventInput(input);
+        let response;
+        try {
+            response = await this.fetchImpl(new URL(`v1/ingress/${encodeURIComponent(this.options.source)}/events`, this.origin), {
+                method: "POST",
+                headers: { authorization: `Bearer ${this.options.token}`, "content-type": "application/json", accept: "application/json" },
+                body: JSON.stringify(event),
+                redirect: "error",
+                signal: AbortSignal.timeout(this.timeoutMs),
+            });
+        }
+        catch (error) {
+            throw new WakeBridgeSdkError(`source push is unavailable: ${String(error)}`, "source_push_unavailable", 503);
+        }
+        let body;
+        try {
+            body = await response.json();
+        }
+        catch {
+            body = null;
+        }
+        if (!response.ok) {
+            const remote = body && typeof body === "object" ? body : {};
+            throw new WakeBridgeSdkError(typeof remote.error === "string" ? remote.error : `source push returned HTTP ${response.status}`, typeof remote.code === "string" ? remote.code : "source_push_rejected", response.status);
+        }
+        const receipt = body;
+        if (!receipt?.event || receipt.event.source !== this.options.source || receipt.event.schema_version !== EVENT_CONTRACT_VERSION) {
+            throw new WakeBridgeSdkError("source push returned an invalid receipt", "invalid_source_push_receipt", 502);
+        }
+        return receipt;
+    }
+}
+export { WakeBridgeSdkError } from "./sdk-error.js";
+//# sourceMappingURL=event-sdk.js.map

package/dist/src/event-sdk.js.map

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

package/dist/src/host-adapter-registry.d.ts

@@ -0,0 +1,21 @@
+import { type WakeBridge } from "./core.js";
+import { type HostAdapter, type HostAdapterLifecycleContext, type HostAdapterManifest } from "./transport-sdk.js";
+export interface HostBootstrapCredential {
+    id: string;
+    token: string;
+    adapter_kind: string;
+    host_kind: string;
+    attention_channels: string[];
+}
+/** Core-owned orchestration. This class is intentionally not a package export. */
+export declare class HostAdapterRegistry {
+    private readonly adapters;
+    private started;
+    private bridge;
+    constructor(adapters?: HostAdapter[]);
+    register(adapter: HostAdapter): void;
+    list(): HostAdapterManifest[];
+    get(kind: string): HostAdapter | null;
+    start(bridge: WakeBridge, context: HostAdapterLifecycleContext): Promise<void>;
+    stop(): Promise<void>;
+}

package/dist/src/host-adapter-registry.js

@@ -0,0 +1,59 @@
+import { BridgeError } from "./core.js";
+import { validateHostAdapterManifest, } from "./transport-sdk.js";
+/** Core-owned orchestration. This class is intentionally not a package export. */
+export class HostAdapterRegistry {
+    adapters = new Map();
+    started = [];
+    bridge = null;
+    constructor(adapters = []) {
+        for (const adapter of adapters)
+            this.register(adapter);
+    }
+    register(adapter) {
+        validateHostAdapterManifest(adapter.manifest);
+        if (adapter.kind !== adapter.manifest.adapter_kind) {
+            throw new BridgeError("adapter kind does not match manifest", "invalid_host_adapter", 400);
+        }
+        if (this.adapters.has(adapter.kind)) {
+            throw new BridgeError(`duplicate host adapter: ${adapter.kind}`, "duplicate_host_adapter", 409);
+        }
+        this.adapters.set(adapter.kind, adapter);
+    }
+    list() {
+        return [...this.adapters.values()].map((adapter) => adapter.manifest);
+    }
+    get(kind) {
+        return this.adapters.get(kind) ?? null;
+    }
+    async start(bridge, context) {
+        this.bridge = bridge;
+        for (const adapter of this.adapters.values()) {
+            const existing = bridge.transports.get(adapter.kind);
+            if (existing && existing !== adapter) {
+                throw new BridgeError(`transport kind already registered: ${adapter.kind}`, "duplicate_host_adapter", 409);
+            }
+            bridge.registerTransport(adapter);
+            this.started.push(adapter);
+            await adapter.start?.(context);
+        }
+    }
+    async stop() {
+        let firstError;
+        for (const adapter of [...this.started].reverse()) {
+            try {
+                await adapter.stop?.();
+            }
+            catch (error) {
+                firstError ??= error;
+            }
+            finally {
+                this.bridge?.unregisterTransport(adapter.kind, adapter);
+            }
+        }
+        this.started = [];
+        this.bridge = null;
+        if (firstError)
+            throw firstError;
+    }
+}
+//# sourceMappingURL=host-adapter-registry.js.map

package/dist/src/host-adapter-registry.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./version.js";
+export * from "./event-sdk.js";
+export * from "./source-sdk.js";
+export * from "./transport-sdk.js";
+export * from "./connector-catalog.js";

package/dist/src/index.js

@@ -0,0 +1,6 @@
+export * from "./version.js";
+export * from "./event-sdk.js";
+export * from "./source-sdk.js";
+export * from "./transport-sdk.js";
+export * from "./connector-catalog.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC"}

package/dist/src/instance-config.d.ts

@@ -0,0 +1,46 @@
+import type { BridgeConfig } from "./types.js";
+export interface WakeBridgeInstanceConfigFile {
+    version: 1;
+    instance_id: string;
+    owner_id: string;
+    db_path: string;
+    timezone: string;
+    admin_token: string;
+}
+export interface InitializeInstanceOptions {
+    data_dir: string;
+    instance_id: string;
+    owner_id: string;
+    timezone?: string;
+    db_path?: string;
+    config_path?: string;
+}
+export declare function loadInstanceConfig(path: string): WakeBridgeInstanceConfigFile;
+export declare function initializeInstance(options: InitializeInstanceOptions): {
+    config: WakeBridgeInstanceConfigFile;
+    config_path: string;
+    data_dir: string;
+};
+export declare function instanceConfigSecurity(path: string | undefined): {
+    configured: boolean;
+    path: string | null;
+    private_permissions: boolean | null;
+    database_exists: boolean | null;
+    database_private_permissions: boolean | null;
+    data_directory_private_permissions: boolean | null;
+    ready: boolean;
+    error: string | null;
+};
+export declare function instanceDataSecurity(dbPath: string): {
+    path: string;
+    exists: boolean;
+    private_permissions: boolean | null;
+    directory_private_permissions: boolean | null;
+    ready: boolean;
+    error: string | null;
+};
+export declare function bridgeConfigFromFile(path: string): BridgeConfig;
+export declare function rotateOwnerCredential(path: string): {
+    config_path: string;
+    rotated: true;
+};

package/dist/src/instance-config.js

@@ -0,0 +1,176 @@
+import { randomBytes } from "node:crypto";
+import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, statSync, writeFileSync, } from "node:fs";
+import { basename, dirname, isAbsolute, relative, resolve, sep } from "node:path";
+import { WakeBridge, BridgeError } from "./core.js";
+const INSTANCE_ID = /^[A-Za-z0-9_.:-]{1,128}$/u;
+function assertPrivateMode(path, kind) {
+    if (process.platform === "win32")
+        return;
+    const mode = statSync(path).mode & 0o777;
+    if ((mode & 0o077) !== 0) {
+        throw new BridgeError(`${kind} must not be accessible by group or other users: ${path}`, "insecure_file_permissions", 400);
+    }
+}
+function assertWithin(dataDir, path, kind) {
+    const relation = relative(dataDir, path);
+    if (relation === "" || relation === ".." || relation.startsWith(`..${sep}`) || isAbsolute(relation)) {
+        throw new BridgeError(`${kind} must be a file inside data_dir`, "invalid_instance_config", 400);
+    }
+}
+export function loadInstanceConfig(path) {
+    let parsed;
+    try {
+        assertPrivateMode(path, "instance config");
+        parsed = JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        if (error instanceof BridgeError)
+            throw error;
+        throw new BridgeError(`instance config is unreadable: ${String(error)}`, "invalid_instance_config", 400);
+    }
+    const config = parsed;
+    if (config?.version !== 1 || !INSTANCE_ID.test(config.instance_id ?? "") || !INSTANCE_ID.test(config.owner_id ?? "")
+        || typeof config.db_path !== "string" || !isAbsolute(config.db_path)
+        || typeof config.timezone !== "string" || !config.timezone
+        || typeof config.admin_token !== "string" || config.admin_token.length < 32) {
+        throw new BridgeError("instance config is invalid", "invalid_instance_config", 400);
+    }
+    try {
+        new Intl.DateTimeFormat("en-US", { timeZone: config.timezone }).format(new Date());
+    }
+    catch {
+        throw new BridgeError("instance config timezone is invalid", "invalid_instance_config", 400);
+    }
+    return config;
+}
+export function initializeInstance(options) {
+    if (!INSTANCE_ID.test(options.instance_id) || !INSTANCE_ID.test(options.owner_id)) {
+        throw new BridgeError("explicit valid instance_id and owner_id are required", "invalid_instance_config", 400);
+    }
+    const dataDir = resolve(options.data_dir);
+    const configPath = resolve(options.config_path ?? resolve(dataDir, "wakebridge.config.json"));
+    const dbPath = resolve(options.db_path ?? resolve(dataDir, "wake-bridge.sqlite"));
+    assertWithin(dataDir, configPath, "config_path");
+    assertWithin(dataDir, dbPath, "db_path");
+    if (existsSync(configPath)) {
+        throw new BridgeError(`instance config already exists: ${configPath}`, "instance_already_initialized", 409);
+    }
+    if (existsSync(dbPath)) {
+        throw new BridgeError(`instance database already exists without a matching config: ${dbPath}`, "instance_database_exists", 409);
+    }
+    try {
+        new Intl.DateTimeFormat("en-US", { timeZone: options.timezone ?? "UTC" }).format(new Date());
+    }
+    catch {
+        throw new BridgeError("timezone must be a valid IANA timezone", "invalid_instance_config", 400);
+    }
+    if (!existsSync(dataDir))
+        mkdirSync(dataDir, { recursive: true, mode: 0o700 });
+    if (!statSync(dataDir).isDirectory())
+        throw new BridgeError("data_dir must be a directory", "invalid_instance_config", 400);
+    assertPrivateMode(dataDir, "data_dir");
+    mkdirSync(dirname(dbPath), { recursive: true, mode: 0o700 });
+    mkdirSync(dirname(configPath), { recursive: true, mode: 0o700 });
+    const config = {
+        version: 1,
+        instance_id: options.instance_id,
+        owner_id: options.owner_id,
+        db_path: dbPath,
+        timezone: options.timezone ?? "UTC",
+        admin_token: randomBytes(32).toString("base64url"),
+    };
+    const bridge = new WakeBridge(config, { recoverDispatchLeases: false });
+    bridge.close();
+    chmodSync(dbPath, 0o600);
+    for (const suffix of ["-wal", "-shm"]) {
+        if (existsSync(`${dbPath}${suffix}`))
+            chmodSync(`${dbPath}${suffix}`, 0o600);
+    }
+    writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, { encoding: "utf8", mode: 0o600, flag: "wx" });
+    chmodSync(configPath, 0o600);
+    return { config, config_path: configPath, data_dir: dataDir };
+}
+export function instanceConfigSecurity(path) {
+    if (!path)
+        return {
+            configured: false,
+            path: null,
+            private_permissions: null,
+            database_exists: null,
+            database_private_permissions: null,
+            data_directory_private_permissions: null,
+            ready: true,
+            error: null,
+        };
+    try {
+        assertPrivateMode(path, "instance config");
+        const config = loadInstanceConfig(path);
+        if (!existsSync(config.db_path))
+            throw new BridgeError(`instance database does not exist: ${config.db_path}`, "invalid_instance_config", 400);
+        assertPrivateMode(config.db_path, "instance database");
+        assertPrivateMode(dirname(config.db_path), "instance data directory");
+        return {
+            configured: true,
+            path: resolve(path),
+            private_permissions: true,
+            database_exists: true,
+            database_private_permissions: true,
+            data_directory_private_permissions: true,
+            ready: true,
+            error: null,
+        };
+    }
+    catch (error) {
+        return {
+            configured: true,
+            path: resolve(path),
+            private_permissions: false,
+            database_exists: null,
+            database_private_permissions: null,
+            data_directory_private_permissions: null,
+            ready: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+export function instanceDataSecurity(dbPath) {
+    const path = resolve(dbPath);
+    try {
+        if (!existsSync(path))
+            throw new BridgeError(`instance database does not exist: ${path}`, "invalid_instance_config", 400);
+        assertPrivateMode(path, "instance database");
+        assertPrivateMode(dirname(path), "instance data directory");
+        return { path, exists: true, private_permissions: true, directory_private_permissions: true, ready: true, error: null };
+    }
+    catch (error) {
+        return {
+            path,
+            exists: existsSync(path),
+            private_permissions: null,
+            directory_private_permissions: null,
+            ready: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+export function bridgeConfigFromFile(path) {
+    const config = loadInstanceConfig(path);
+    return {
+        instance_id: config.instance_id,
+        owner_id: config.owner_id,
+        db_path: config.db_path,
+        timezone: config.timezone,
+        admin_token: config.admin_token,
+    };
+}
+export function rotateOwnerCredential(path) {
+    const configPath = resolve(path);
+    const config = loadInstanceConfig(configPath);
+    const next = { ...config, admin_token: randomBytes(32).toString("base64url") };
+    const temporary = resolve(dirname(configPath), `.${basename(configPath)}.${randomBytes(8).toString("hex")}.tmp`);
+    writeFileSync(temporary, `${JSON.stringify(next, null, 2)}\n`, { encoding: "utf8", mode: 0o600, flag: "wx" });
+    chmodSync(temporary, 0o600);
+    renameSync(temporary, configPath);
+    return { config_path: configPath, rotated: true };
+}
+//# sourceMappingURL=instance-config.js.map

package/dist/src/instance-config.js.map

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

package/dist/src/mcp.d.ts

@@ -0,0 +1,51 @@
+import { WakeBridge } from "./core.js";
+import type { BridgeConfig, JsonValue } from "./types.js";
+import type { AgentSourceControl } from "./source-control-client.js";
+/** MCP protocol version understood by this local stdio server. */
+export declare const MCP_PROTOCOL_VERSION = "2025-06-18";
+export declare const MCP_SERVER_NAME = "wake-bridge";
+export declare const MCP_SERVER_VERSION = "0.9.0-preview.8";
+type RpcId = string | number | null;
+type JsonObject = Record<string, unknown>;
+type StdioInput = NodeJS.ReadableStream;
+type StdioOutput = NodeJS.WritableStream;
+export interface McpRequest {
+    jsonrpc: "2.0";
+    id?: RpcId;
+    method: string;
+    params?: JsonObject;
+}
+export interface McpResponse {
+    jsonrpc: "2.0";
+    id: RpcId;
+    result?: JsonObject;
+    error?: {
+        code: number;
+        message: string;
+        data?: JsonValue;
+    };
+}
+export interface McpServerOptions {
+    bridge: WakeBridge;
+    source_control?: AgentSourceControl;
+}
+/**
+ * In-process MCP implementation. It deliberately has no wait/warm tool: a
+ * stdio invocation must finish so normal turns can settle and cold transport
+ * remains the lifecycle baseline.
+ */
+export declare class WakeBridgeMcpServer {
+    readonly bridge: WakeBridge;
+    private readonly sourceControl?;
+    constructor(options: McpServerOptions | WakeBridge);
+    handleRequest(request: unknown): Promise<McpResponse | null>;
+    callTool(name: string, args: JsonObject): Promise<JsonObject>;
+    private sources;
+    private errorValue;
+}
+export declare function createMcpServer(options: McpServerOptions | WakeBridge): WakeBridgeMcpServer;
+/** Run newline-delimited JSON-RPC over stdin/stdout, with no stdout logging. */
+export declare function runMcpStdio(server: WakeBridgeMcpServer, input?: StdioInput, output?: StdioOutput): Promise<void>;
+/** Construct a bridge and serve it until stdin closes. Used by the CLI. */
+export declare function runMcp(config: BridgeConfig): Promise<void>;
+export default WakeBridgeMcpServer;