wake-bridge 0.9.0-preview.8

package/dist/src/connectors/mcp-http-client.js

@@ -0,0 +1,108 @@
+import { BridgeError } from "../core.js";
+const LOOPBACK_HOSTS = new Set(["127.0.0.1", "[::1]", "::1"]);
+function decodeJsonRpc(text) {
+    const documents = text.split(/\r?\n/u)
+        .filter((line) => line.startsWith("data:"))
+        .map((line) => line.slice(5).trim())
+        .filter(Boolean);
+    const raw = documents.at(-1) || text.trim();
+    if (!raw)
+        return {};
+    try {
+        const value = JSON.parse(raw);
+        if (!value || typeof value !== "object" || Array.isArray(value))
+            throw new Error("object required");
+        return value;
+    }
+    catch {
+        throw new BridgeError("upstream MCP returned invalid JSON-RPC", "upstream_mcp_invalid_response", 424);
+    }
+}
+export class StreamableHttpMcpClient {
+    endpoint;
+    fetcher;
+    requestId = 0;
+    constructor(endpoint, fetcher = fetch) {
+        this.endpoint = endpoint;
+        this.fetcher = fetcher;
+        let url;
+        try {
+            url = new URL(endpoint);
+        }
+        catch {
+            throw new BridgeError("upstream MCP URL is invalid", "upstream_mcp_invalid_config", 400);
+        }
+        const transportAllowed = url.protocol === "https:"
+            || url.protocol === "http:" && LOOPBACK_HOSTS.has(url.hostname);
+        if (!transportAllowed || url.username || url.password || url.hash) {
+            throw new BridgeError("upstream MCP URL is invalid", "upstream_mcp_invalid_config", 400);
+        }
+    }
+    async callTool(name, args) {
+        const initialized = await this.post({
+            jsonrpc: "2.0",
+            id: this.nextId(),
+            method: "initialize",
+            params: {
+                protocolVersion: "2025-06-18",
+                capabilities: {},
+                clientInfo: { name: "wakebridge-source-connector", version: "0.1.0" },
+            },
+        });
+        if (initialized.body.error)
+            throw new BridgeError("upstream MCP initialize failed", "upstream_mcp_initialize_failed", 424);
+        await this.post({ jsonrpc: "2.0", method: "notifications/initialized" }, initialized.sessionId, true);
+        const called = await this.post({
+            jsonrpc: "2.0",
+            id: this.nextId(),
+            method: "tools/call",
+            params: { name, arguments: args },
+        }, initialized.sessionId);
+        if (called.body.error || called.body.result?.isError === true) {
+            throw new BridgeError("upstream MCP tool call failed", "upstream_mcp_tool_failed", 424);
+        }
+        const content = called.body.result?.content;
+        const text = Array.isArray(content)
+            ? content.find((item) => item && typeof item === "object" && item.type === "text")?.text
+            : undefined;
+        if (typeof text !== "string") {
+            throw new BridgeError("upstream MCP tool result has no text content", "upstream_mcp_invalid_response", 424);
+        }
+        return decodeJsonRpc(text);
+    }
+    nextId() {
+        this.requestId += 1;
+        return this.requestId;
+    }
+    async post(payload, sessionId, allowEmpty = false) {
+        let response;
+        try {
+            response = await this.fetcher(this.endpoint, {
+                method: "POST",
+                headers: {
+                    accept: "application/json, text/event-stream",
+                    "content-type": "application/json",
+                    ...(sessionId ? { "mcp-session-id": sessionId } : {}),
+                },
+                body: JSON.stringify(payload),
+                signal: AbortSignal.timeout(15_000),
+            });
+        }
+        catch {
+            throw new BridgeError("upstream MCP is unavailable", "upstream_mcp_unavailable", 503);
+        }
+        if (!response.ok) {
+            const retryable = response.status === 408 || response.status === 425 || response.status === 429 || response.status >= 500;
+            const errorClass = response.status === 401 || response.status === 403
+                ? "upstream_mcp_unauthorized"
+                : retryable ? "upstream_mcp_http_error" : "upstream_mcp_contract_error";
+            throw new BridgeError(`upstream MCP returned HTTP ${response.status}`, errorClass, retryable ? 503 : 424);
+        }
+        const text = await response.text();
+        return {
+            body: allowEmpty && !text.trim() ? {} : decodeJsonRpc(text),
+            sessionId: response.headers.get("mcp-session-id") || sessionId,
+        };
+    }
+}
+//# sourceMappingURL=mcp-http-client.js.map

package/dist/src/connectors/mcp-http-client.js.map

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

package/dist/src/core.d.ts

@@ -0,0 +1,170 @@
+import { SqliteDatabase } from "./db.js";
+import { MockTransport } from "./transport.js";
+import { WakeBridgeSdkError } from "./sdk-error.js";
+import type { ActivityObservation, ActivityObservationResult, ActivityWatch, ActivityWatchConfiguration, AttentionClaim, BatchState, Binding, BridgeConfig, ClaimState, DispatchResult, DeliveryCorrelation, Endpoint, EndpointRegistration, EventState, InstalledPolicyRule, JsonValue, PolicyMatchResult, PolicyPreviewResult, PolicyRule, PolicyVersionStatus, PresenceLease, PresenceRenewal, Receipt, ReceiptStage, ResourceRef, TickResult, WakeBatch, WakeEvent, WakeEventInput, WakeEchoObservation, WakeTransport } from "./types.js";
+export interface WakeBridgeOptions {
+    clock?: () => Date;
+    transports?: WakeTransport[];
+    autoMockTransport?: boolean;
+    /** Only the canonical dispatcher owner may reclaim expired dispatch leases. */
+    recoverDispatchLeases?: boolean;
+    /** Schema changes are only authorized by the release upgrade workflow. */
+    allowSchemaUpgrade?: boolean;
+}
+export interface EmitResult {
+    event: WakeEvent;
+    claim?: AttentionClaim;
+    duplicate: boolean;
+    suppressed: boolean;
+}
+export interface ScheduleClaimInput {
+    resource: ResourceRef;
+    eligible_after: string;
+    attention_channel?: string;
+    reason_code?: string;
+    note?: string | null;
+    expires_at?: string | null;
+    idempotency_key?: string | null;
+    defer_while_presence?: boolean;
+}
+export declare class BridgeError extends WakeBridgeSdkError {
+    readonly code: string;
+    readonly status: number;
+    constructor(message: string, code?: string, status?: number);
+}
+type DbRow = Record<string, any>;
+declare const DEFAULT_POLICY: PolicyRule;
+export declare function normalizePolicy(policy: PolicyRule): PolicyRule;
+export declare function activePolicyVersions(policies: PolicyRule[]): PolicyRule[];
+export declare class WakeBridge {
+    readonly config: Required<Pick<BridgeConfig, "instance_id" | "owner_id" | "db_path">> & BridgeConfig;
+    readonly db: SqliteDatabase;
+    readonly transports: Map<string, WakeTransport>;
+    readonly mockTransport: MockTransport;
+    private readonly clock;
+    constructor(config: BridgeConfig, options?: WakeBridgeOptions);
+    close(): void;
+    now(): Date;
+    nowIso(): string;
+    registerTransport(transport: WakeTransport): void;
+    unregisterTransport(kind: string, expected?: WakeTransport): void;
+    listPolicies(): InstalledPolicyRule[];
+    listActivePolicies(): InstalledPolicyRule[];
+    listPolicyStatuses(): PolicyVersionStatus[];
+    installPolicies(policies: PolicyRule[]): void;
+    private ensureDefaultPolicy;
+    updatePolicy(policy: PolicyRule): PolicyRule;
+    private policyRows;
+    private policyForEvent;
+    testPolicy(source: string, input: WakeEventInput, candidates?: PolicyRule[]): PolicyMatchResult;
+    previewPolicy(source: string, input: WakeEventInput, candidates?: PolicyRule[]): PolicyPreviewResult;
+    private matches;
+    private targetChannel;
+    private claimEligibleAfter;
+    private claimExpiresAt;
+    private validateEvent;
+    private duplicateEmitResult;
+    private isUniqueConflict;
+    /** Accept both emitEvent(source, input) and emitEvent(input, source). */
+    emitEvent(sourceOrInput: string | WakeEventInput, inputOrSource?: WakeEventInput | string): EmitResult;
+    emit(source: string, input: WakeEventInput): EmitResult;
+    scheduleClaim(input: ScheduleClaimInput): {
+        event: WakeEvent;
+        claim: AttentionClaim;
+        duplicate: boolean;
+    };
+    getEvent(eventId: string): WakeEvent | null;
+    listEvents(filters?: {
+        state?: EventState;
+        source?: string;
+        after?: string;
+        limit?: number;
+    }): WakeEvent[];
+    private eventFromRow;
+    getClaim(claimId: string): AttentionClaim | null;
+    listClaims(filters?: {
+        state?: ClaimState;
+        channel?: string;
+        source?: string;
+        limit?: number;
+    }): AttentionClaim[];
+    private claimFromRow;
+    private policy;
+    getBinding(channel: string): Binding | null;
+    listBindings(): Binding[];
+    private endpointFromRow;
+    getEndpoint(endpointId: string): Endpoint | null;
+    listEndpoints(): Endpoint[];
+    registerEndpoint(registration: EndpointRegistration): Endpoint;
+    renewEndpoint(endpointId: string, leaseToken: string, leaseMs?: number): Endpoint;
+    renewBoundEndpoint(endpointId: string, channel: string, expectedGeneration: number, leaseMs?: number): Endpoint;
+    revokeEndpoint(endpointId: string, leaseToken: string): Endpoint;
+    revokeBoundEndpoint(endpointId: string, channel: string, expectedGeneration: number): Endpoint;
+    private revokeEndpointState;
+    takeover(channel: string, endpointId: string, expectedGeneration?: number): Binding;
+    private endpointAuthorized;
+    renewPresence(input: PresenceRenewal): PresenceLease;
+    configureActivityWatch(input: ActivityWatchConfiguration): ActivityWatch;
+    getActivityWatch(channel: string): ActivityWatch | null;
+    listActivityWatches(): ActivityWatch[];
+    private activityWatchFromRow;
+    observeActivity(input: ActivityObservation): ActivityObservationResult;
+    consumeWakeEcho(input: WakeEchoObservation): ActivityObservationResult;
+    listDeliveryCorrelations(): DeliveryCorrelation[];
+    getPresence(channel: string): PresenceLease | null;
+    listPresence(): PresenceLease[];
+    private presenceFromRow;
+    private presenceActive;
+    private recover;
+    private materializeDueActivityWatches;
+    /** Advance due claims and freeze eligible claims into durable batches. */
+    tick(): TickResult;
+    private claimStateSql;
+    private claimDeferSql;
+    private eventStateSql;
+    private coalesceKey;
+    private batchKey;
+    private batchInsertSql;
+    private batchUpdateArraysSql;
+    getBatch(batchId: string): WakeBatch | null;
+    listBatches(filters?: {
+        states?: BatchState[];
+        channel?: string;
+        limit?: number;
+    }): WakeBatch[];
+    private batchFromRow;
+    private resolveBinding;
+    private chooseTransport;
+    private buildPayload;
+    private markNoEndpoint;
+    private acquireBatch;
+    private bindingStillCurrent;
+    private finalizeAttempt;
+    /** Dispatch due durable batches. The lease CAS prevents double-dispatch. */
+    dispatchDue(nowDate?: Date): Promise<DispatchResult[]>;
+    private receiptInsertSql;
+    private detachClaimFromOpenBatches;
+    listReceipts(batchId?: string): Receipt[];
+    listAttempts(batchId?: string): DbRow[];
+    private acceptedAttempt;
+    ackBatch(batchId: string, endpointId: string, generation: number): WakeBatch;
+    recordReceipt(batchId: string, stage: ReceiptStage, details?: Record<string, JsonValue> | null, endpointId?: string, generation?: number): Receipt;
+    private claimAction;
+    snoozeClaim(claimId: string, until: string): AttentionClaim;
+    dismissClaim(claimId: string, reason?: string): AttentionClaim;
+    consumeClaim(claimId: string, result?: JsonValue | null): AttentionClaim;
+    inspect(): {
+        instance: Pick<BridgeConfig, "instance_id" | "owner_id" | "timezone">;
+        events: WakeEvent[];
+        claims: AttentionClaim[];
+        batches: WakeBatch[];
+        bindings: Binding[];
+        endpoints: Endpoint[];
+        presence: PresenceLease[];
+        activity_watches: ActivityWatch[];
+        delivery_correlations: DeliveryCorrelation[];
+        receipts: Receipt[];
+        attempts: DbRow[];
+    };
+}
+export { DEFAULT_POLICY };