@murphai/hosted-execution 0.1.1

package/dist/callback-hosts.js

@@ -0,0 +1,19 @@
+export const HOSTED_EXECUTION_CALLBACK_HOSTS = {
+    artifacts: "artifacts.worker",
+    commit: "commit.worker",
+    email: "email.worker",
+    sideEffects: "side-effects.worker",
+};
+export const HOSTED_EXECUTION_PROXY_HOSTS = {
+    deviceSync: "device-sync.worker",
+    sharePack: "share-pack.worker",
+    usage: "usage.worker",
+};
+export const DEFAULT_HOSTED_EXECUTION_ARTIFACTS_BASE_URL = `http://${HOSTED_EXECUTION_CALLBACK_HOSTS.artifacts}`;
+export const DEFAULT_HOSTED_EXECUTION_COMMIT_BASE_URL = `http://${HOSTED_EXECUTION_CALLBACK_HOSTS.commit}`;
+export const DEFAULT_HOSTED_EXECUTION_DEVICE_SYNC_PROXY_BASE_URL = `http://${HOSTED_EXECUTION_PROXY_HOSTS.deviceSync}`;
+export const DEFAULT_HOSTED_EXECUTION_EMAIL_BASE_URL = `http://${HOSTED_EXECUTION_CALLBACK_HOSTS.email}`;
+export const DEFAULT_HOSTED_EXECUTION_SIDE_EFFECTS_BASE_URL = `http://${HOSTED_EXECUTION_CALLBACK_HOSTS.sideEffects}`;
+export const DEFAULT_HOSTED_EXECUTION_SHARE_PACK_PROXY_BASE_URL = `http://${HOSTED_EXECUTION_PROXY_HOSTS.sharePack}`;
+export const DEFAULT_HOSTED_EXECUTION_USAGE_PROXY_BASE_URL = `http://${HOSTED_EXECUTION_PROXY_HOSTS.usage}`;
+//# sourceMappingURL=callback-hosts.js.map

package/dist/callback-hosts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-hosts.js","sourceRoot":"","sources":["../src/callback-hosts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,SAAS,EAAE,kBAAkB;IAC7B,MAAM,EAAE,eAAe;IACvB,KAAK,EAAE,cAAc;IACrB,WAAW,EAAE,qBAAqB;CAC1B,CAAC;AAEX,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,UAAU,EAAE,oBAAoB;IAChC,SAAS,EAAE,mBAAmB;IAC9B,KAAK,EAAE,cAAc;CACb,CAAC;AAEX,MAAM,CAAC,MAAM,2CAA2C,GACtD,UAAU,+BAA+B,CAAC,SAAS,EAAE,CAAC;AACxD,MAAM,CAAC,MAAM,wCAAwC,GACnD,UAAU,+BAA+B,CAAC,MAAM,EAAE,CAAC;AACrD,MAAM,CAAC,MAAM,mDAAmD,GAC9D,UAAU,4BAA4B,CAAC,UAAU,EAAE,CAAC;AACtD,MAAM,CAAC,MAAM,uCAAuC,GAClD,UAAU,+BAA+B,CAAC,KAAK,EAAE,CAAC;AACpD,MAAM,CAAC,MAAM,8CAA8C,GACzD,UAAU,+BAA+B,CAAC,WAAW,EAAE,CAAC;AAC1D,MAAM,CAAC,MAAM,kDAAkD,GAC7D,UAAU,4BAA4B,CAAC,SAAS,EAAE,CAAC;AACrD,MAAM,CAAC,MAAM,6CAA6C,GACxD,UAAU,4BAA4B,CAAC,KAAK,EAAE,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,26 @@
+import type { HostedExecutionDispatchResult, HostedExecutionDispatchRequest, HostedExecutionUserEnvStatus, HostedExecutionUserEnvUpdate, HostedExecutionUserStatus } from "./contracts.ts";
+export interface HostedExecutionDispatchClient {
+    dispatch(input: HostedExecutionDispatchRequest): Promise<HostedExecutionDispatchResult>;
+}
+export interface HostedExecutionDispatchClientOptions {
+    baseUrl: string;
+    fetchImpl?: typeof fetch;
+    now?: () => string;
+    signingSecret: string;
+    timeoutMs?: number;
+}
+export interface HostedExecutionControlClient {
+    clearUserEnv(userId: string): Promise<HostedExecutionUserEnvStatus>;
+    getStatus(userId: string): Promise<HostedExecutionUserStatus>;
+    getUserEnvStatus(userId: string): Promise<HostedExecutionUserEnvStatus>;
+    run(userId: string): Promise<HostedExecutionUserStatus>;
+    updateUserEnv(userId: string, update: HostedExecutionUserEnvUpdate): Promise<HostedExecutionUserEnvStatus>;
+}
+export interface HostedExecutionControlClientOptions {
+    baseUrl: string;
+    controlToken: string;
+    fetchImpl?: typeof fetch;
+}
+export declare function createHostedExecutionDispatchClient(options: HostedExecutionDispatchClientOptions): HostedExecutionDispatchClient;
+export declare function createHostedExecutionControlClient(options: HostedExecutionControlClientOptions): HostedExecutionControlClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,6BAA6B,EAC7B,8BAA8B,EAC9B,4BAA4B,EAC5B,4BAA4B,EAC5B,yBAAyB,EAC1B,MAAM,gBAAgB,CAAC;AAgBxB,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,KAAK,EAAE,8BAA8B,GAAG,OAAO,CAAC,6BAA6B,CAAC,CAAC;CACzF;AAED,MAAM,WAAW,oCAAoC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,4BAA4B;IAC3C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACpE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC9D,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;IACxE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACxD,aAAa,CACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,4BAA4B,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,mCAAmC;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAED,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,oCAAoC,GAC5C,6BAA6B,CAiC/B;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,mCAAmC,GAC3C,4BAA4B,CAmF9B"}

package/dist/client.js

@@ -0,0 +1,165 @@
+import { createHostedExecutionSignatureHeaders } from "./auth.js";
+import { normalizeHostedExecutionBaseUrl } from "./env.js";
+import { parseHostedExecutionDispatchResult, parseHostedExecutionDispatchRequest, parseHostedExecutionUserEnvStatus, parseHostedExecutionUserEnvUpdate, parseHostedExecutionUserStatus, } from "./parsers.js";
+import { buildHostedExecutionUserEnvPath, buildHostedExecutionUserRunPath, buildHostedExecutionUserStatusPath, HOSTED_EXECUTION_DISPATCH_PATH, } from "./routes.js";
+export function createHostedExecutionDispatchClient(options) {
+    const baseUrl = requireHostedExecutionBaseUrl(options.baseUrl);
+    const fetchImpl = options.fetchImpl ?? fetch;
+    return {
+        async dispatch(input) {
+            const requestPayload = parseHostedExecutionDispatchRequest(input);
+            const payload = JSON.stringify(requestPayload);
+            const timestamp = options.now?.() ?? new Date().toISOString();
+            const signatureHeaders = await createHostedExecutionSignatureHeaders({
+                payload,
+                secret: options.signingSecret,
+                timestamp,
+            });
+            return requestHostedExecutionJson({
+                baseUrl,
+                fetchImpl,
+                label: "dispatch",
+                parse: parseHostedExecutionDispatchResult,
+                path: HOSTED_EXECUTION_DISPATCH_PATH,
+                request: {
+                    body: payload,
+                    headers: {
+                        "content-type": "application/json; charset=utf-8",
+                        ...signatureHeaders,
+                    },
+                    method: "POST",
+                    signal: resolveHostedExecutionTimeoutSignal(options.timeoutMs),
+                },
+            });
+        },
+    };
+}
+export function createHostedExecutionControlClient(options) {
+    const baseUrl = requireHostedExecutionBaseUrl(options.baseUrl);
+    const controlToken = requireHostedExecutionControlToken(options.controlToken);
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const authenticatedHeaders = withHostedExecutionControlToken(undefined, controlToken);
+    const authenticatedJsonHeaders = withHostedExecutionControlToken({
+        "content-type": "application/json; charset=utf-8",
+    }, controlToken);
+    return {
+        clearUserEnv(userId) {
+            return requestHostedExecutionJson({
+                baseUrl,
+                fetchImpl,
+                label: "user env clear",
+                parse: parseHostedExecutionUserEnvStatus,
+                path: buildHostedExecutionUserEnvPath(userId),
+                request: {
+                    headers: authenticatedHeaders,
+                    method: "DELETE",
+                },
+            });
+        },
+        getStatus(userId) {
+            return requestHostedExecutionJson({
+                baseUrl,
+                fetchImpl,
+                label: "status",
+                parse: parseHostedExecutionUserStatus,
+                path: buildHostedExecutionUserStatusPath(userId),
+                request: {
+                    headers: authenticatedHeaders,
+                    method: "GET",
+                },
+            });
+        },
+        getUserEnvStatus(userId) {
+            return requestHostedExecutionJson({
+                baseUrl,
+                fetchImpl,
+                label: "user env status",
+                parse: parseHostedExecutionUserEnvStatus,
+                path: buildHostedExecutionUserEnvPath(userId),
+                request: {
+                    headers: authenticatedHeaders,
+                    method: "GET",
+                },
+            });
+        },
+        run(userId) {
+            return requestHostedExecutionJson({
+                baseUrl,
+                fetchImpl,
+                label: "manual run",
+                parse: parseHostedExecutionUserStatus,
+                path: buildHostedExecutionUserRunPath(userId),
+                request: {
+                    body: JSON.stringify({}),
+                    headers: authenticatedJsonHeaders,
+                    method: "POST",
+                },
+            });
+        },
+        updateUserEnv(userId, update) {
+            const requestPayload = parseHostedExecutionUserEnvUpdate(update);
+            return requestHostedExecutionJson({
+                baseUrl,
+                fetchImpl,
+                label: "user env update",
+                parse: parseHostedExecutionUserEnvStatus,
+                path: buildHostedExecutionUserEnvPath(userId),
+                request: {
+                    body: JSON.stringify(requestPayload),
+                    headers: authenticatedJsonHeaders,
+                    method: "PUT",
+                },
+            });
+        },
+    };
+}
+function requireHostedExecutionBaseUrl(value) {
+    const normalized = normalizeHostedExecutionBaseUrl(value);
+    if (!normalized) {
+        throw new TypeError("Hosted execution baseUrl must be configured.");
+    }
+    return normalized;
+}
+function requireHostedExecutionControlToken(value) {
+    const normalized = normalizeHostedExecutionControlToken(value);
+    if (!normalized) {
+        throw new TypeError("Hosted execution controlToken must be configured.");
+    }
+    return normalized;
+}
+function normalizeHostedExecutionControlToken(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const normalized = value.trim();
+    return normalized.length > 0 ? normalized : null;
+}
+function resolveHostedExecutionTimeoutSignal(timeoutMs) {
+    return typeof timeoutMs === "number" ? AbortSignal.timeout(timeoutMs) : undefined;
+}
+async function requestHostedExecutionJson(input) {
+    const response = await input.fetchImpl(new URL(input.path.replace(/^\/+/u, ""), `${input.baseUrl}/`).toString(), input.request);
+    const text = await response.text();
+    const payload = parseHostedExecutionJsonPayload(text);
+    if (!response.ok) {
+        throw new Error(`Hosted execution ${input.label} failed with HTTP ${response.status}${text ? `: ${text.slice(0, 500)}` : ""}.`);
+    }
+    return input.parse(payload);
+}
+function withHostedExecutionControlToken(headers, controlToken) {
+    const nextHeaders = new Headers(headers);
+    nextHeaders.set("authorization", `Bearer ${controlToken}`);
+    return nextHeaders;
+}
+function parseHostedExecutionJsonPayload(text) {
+    if (!text.trim()) {
+        return null;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/contracts.d.ts

@@ -0,0 +1,252 @@
+import type { HostedExecutionBundleKind as RuntimeHostedExecutionBundleKind, HostedExecutionBundleRef as RuntimeHostedExecutionBundleRef } from "@murphai/runtime-state";
+import type { HostedExecutionBundlePayloads, HostedExecutionBundleRefs } from "./bundles.ts";
+import type { SharePack } from "@murphai/contracts";
+import type { HostedExecutionRunContext, HostedExecutionRunStatus, HostedExecutionTimelineEntry } from "./observability.ts";
+export declare const HOSTED_EXECUTION_SIGNATURE_HEADER = "x-hosted-execution-signature";
+export declare const HOSTED_EXECUTION_TIMESTAMP_HEADER = "x-hosted-execution-timestamp";
+export declare const HOSTED_EXECUTION_EVENT_KINDS: readonly ["member.activated", "linq.message.received", "telegram.message.received", "email.message.received", "assistant.cron.tick", "device-sync.wake", "vault.share.accepted", "gateway.message.send"];
+export type HostedExecutionEventKind = (typeof HOSTED_EXECUTION_EVENT_KINDS)[number];
+export interface HostedExecutionBaseEvent {
+    kind: HostedExecutionEventKind;
+    userId: string;
+}
+export interface HostedExecutionMemberActivatedEvent extends HostedExecutionBaseEvent {
+    kind: "member.activated";
+}
+export interface HostedExecutionLinqMessageReceivedEvent extends HostedExecutionBaseEvent {
+    kind: "linq.message.received";
+    linqEvent: Record<string, unknown>;
+    phoneLookupKey: string;
+}
+export interface HostedExecutionTelegramMessageReceivedEvent extends HostedExecutionBaseEvent {
+    botUserId: string | null;
+    kind: "telegram.message.received";
+    telegramUpdate: Record<string, unknown>;
+}
+export interface HostedExecutionEmailMessageReceivedEvent extends HostedExecutionBaseEvent {
+    kind: "email.message.received";
+    identityId: string;
+    rawMessageKey: string;
+}
+export interface HostedExecutionAssistantCronTickEvent extends HostedExecutionBaseEvent {
+    kind: "assistant.cron.tick";
+    reason: "alarm" | "manual" | "device-sync";
+}
+export interface HostedExecutionDeviceSyncJobHint {
+    availableAt?: string;
+    dedupeKey?: string | null;
+    kind: string;
+    maxAttempts?: number;
+    payload?: Record<string, unknown>;
+    priority?: number;
+}
+export interface HostedExecutionDeviceSyncWakeHint {
+    eventType?: string | null;
+    jobs?: HostedExecutionDeviceSyncJobHint[];
+    nextReconcileAt?: string | null;
+    occurredAt?: string | null;
+    reason?: string | null;
+    resourceCategory?: string | null;
+    revokeWarning?: {
+        code: string;
+        message: string;
+    } | null;
+    scopes?: string[];
+    traceId?: string | null;
+}
+export interface HostedExecutionDeviceSyncWakeEvent extends HostedExecutionBaseEvent {
+    connectionId?: string | null;
+    hint?: HostedExecutionDeviceSyncWakeHint | null;
+    kind: "device-sync.wake";
+    provider?: string | null;
+    reason: "connected" | "webhook_hint" | "disconnected" | "reauthorization_required";
+}
+export interface HostedExecutionShareReference {
+    shareCode: string;
+    shareId: string;
+}
+export interface HostedExecutionVaultShareAcceptedEvent extends HostedExecutionBaseEvent {
+    kind: "vault.share.accepted";
+    share: HostedExecutionShareReference;
+}
+export interface HostedExecutionGatewayMessageSendEvent extends HostedExecutionBaseEvent {
+    clientRequestId: string | null;
+    kind: "gateway.message.send";
+    replyToMessageId: string | null;
+    sessionKey: string;
+    text: string;
+}
+export type HostedExecutionEvent = HostedExecutionMemberActivatedEvent | HostedExecutionLinqMessageReceivedEvent | HostedExecutionTelegramMessageReceivedEvent | HostedExecutionEmailMessageReceivedEvent | HostedExecutionAssistantCronTickEvent | HostedExecutionDeviceSyncWakeEvent | HostedExecutionVaultShareAcceptedEvent | HostedExecutionGatewayMessageSendEvent;
+export interface HostedExecutionDispatchRequest {
+    event: HostedExecutionEvent;
+    eventId: string;
+    occurredAt: string;
+}
+export type HostedExecutionBundleKind = RuntimeHostedExecutionBundleKind;
+export interface HostedExecutionRunnerRequest {
+    bundles: HostedExecutionBundlePayloads;
+    dispatch: HostedExecutionDispatchRequest;
+    run?: HostedExecutionRunContext | null;
+}
+export interface HostedExecutionRunnerResult {
+    bundles: HostedExecutionBundlePayloads;
+    result: {
+        eventsHandled: number;
+        nextWakeAt?: string | null;
+        summary: string;
+    };
+}
+export type HostedExecutionBundleRef = RuntimeHostedExecutionBundleRef;
+export interface HostedExecutionUserStatus {
+    backpressuredEventIds?: string[];
+    bundleRefs: HostedExecutionBundleRefs;
+    inFlight: boolean;
+    lastError: string | null;
+    lastErrorAt?: string | null;
+    lastErrorCode?: string | null;
+    lastEventId: string | null;
+    lastRunAt: string | null;
+    nextWakeAt: string | null;
+    pendingEventCount: number;
+    poisonedEventIds: string[];
+    run?: HostedExecutionRunStatus | null;
+    retryingEventId: string | null;
+    timeline?: HostedExecutionTimelineEntry[];
+    userId: string;
+}
+export declare const HOSTED_EXECUTION_EVENT_DISPATCH_STATES: readonly ["queued", "duplicate_pending", "duplicate_consumed", "backpressured", "completed", "poisoned"];
+export type HostedExecutionEventDispatchState = (typeof HOSTED_EXECUTION_EVENT_DISPATCH_STATES)[number];
+export interface HostedExecutionEventDispatchStatus {
+    eventId: string;
+    lastError: string | null;
+    state: HostedExecutionEventDispatchState;
+    userId: string;
+}
+export interface HostedExecutionDispatchResult {
+    event: HostedExecutionEventDispatchStatus;
+    status: HostedExecutionUserStatus;
+}
+export interface HostedExecutionUserEnvStatus {
+    configuredUserEnvKeys: string[];
+    userId: string;
+}
+export interface HostedExecutionUserEnvUpdate {
+    env: Record<string, string | null>;
+    mode: "merge" | "replace";
+}
+export declare const HOSTED_EXECUTION_USER_ID_HEADER = "x-hosted-execution-user-id";
+export declare const HOSTED_EXECUTION_RUNNER_PROXY_TOKEN_HEADER = "x-hosted-execution-runner-proxy-token";
+export interface HostedExecutionSharePackResponse {
+    pack: SharePack;
+    shareId: string;
+}
+export interface HostedExecutionDeviceSyncRuntimeTokenBundle {
+    accessToken: string;
+    accessTokenExpiresAt: string | null;
+    keyVersion: string;
+    refreshToken: string | null;
+    tokenVersion: number;
+}
+export interface HostedExecutionDeviceSyncRuntimeConnectionStateSnapshot {
+    accessTokenExpiresAt: string | null;
+    connectedAt: string;
+    createdAt: string;
+    displayName: string | null;
+    externalAccountId: string;
+    id: string;
+    metadata: Record<string, unknown>;
+    provider: string;
+    scopes: string[];
+    status: "active" | "reauthorization_required" | "disconnected";
+    updatedAt?: string;
+}
+export interface HostedExecutionDeviceSyncRuntimeLocalStateSnapshot {
+    lastErrorCode: string | null;
+    lastErrorMessage: string | null;
+    lastSyncCompletedAt: string | null;
+    lastSyncErrorAt: string | null;
+    lastSyncStartedAt: string | null;
+    lastWebhookAt: string | null;
+    nextReconcileAt: string | null;
+}
+export interface HostedExecutionDeviceSyncRuntimeConnectionSnapshot {
+    connection: HostedExecutionDeviceSyncRuntimeConnectionStateSnapshot;
+    localState: HostedExecutionDeviceSyncRuntimeLocalStateSnapshot;
+    tokenBundle: HostedExecutionDeviceSyncRuntimeTokenBundle | null;
+}
+export interface HostedExecutionDeviceSyncRuntimeSnapshotRequest {
+    connectionId?: string | null;
+    provider?: string | null;
+    userId: string;
+}
+export interface HostedExecutionDeviceSyncRuntimeSnapshotResponse {
+    connections: HostedExecutionDeviceSyncRuntimeConnectionSnapshot[];
+    generatedAt: string;
+    userId: string;
+}
+export interface HostedExecutionDeviceSyncRuntimeConnectionStateUpdate {
+    displayName?: string | null;
+    metadata?: Record<string, unknown>;
+    scopes?: string[];
+    status?: "active" | "reauthorization_required" | "disconnected";
+}
+export interface HostedExecutionDeviceSyncRuntimeLocalStateUpdate {
+    clearError?: boolean;
+    lastErrorCode?: string | null;
+    lastErrorMessage?: string | null;
+    lastSyncCompletedAt?: string | null;
+    lastSyncErrorAt?: string | null;
+    lastSyncStartedAt?: string | null;
+    lastWebhookAt?: string | null;
+    nextReconcileAt?: string | null;
+}
+export interface HostedExecutionDeviceSyncRuntimeConnectionUpdate {
+    connectionId: string;
+    connection?: HostedExecutionDeviceSyncRuntimeConnectionStateUpdate;
+    localState?: HostedExecutionDeviceSyncRuntimeLocalStateUpdate;
+    observedUpdatedAt?: string | null;
+    observedTokenVersion?: number | null;
+    tokenBundle?: HostedExecutionDeviceSyncRuntimeTokenBundle | null;
+}
+export interface HostedExecutionDeviceSyncRuntimeApplyRequest {
+    occurredAt?: string | null;
+    updates: HostedExecutionDeviceSyncRuntimeConnectionUpdate[];
+    userId: string;
+}
+export interface HostedExecutionDeviceSyncRuntimeApplyEntry {
+    connection: HostedExecutionDeviceSyncRuntimeConnectionSnapshot["connection"] | null;
+    connectionId: string;
+    status: "missing" | "updated";
+    tokenUpdate: "applied" | "cleared" | "missing" | "skipped_version_mismatch" | "unchanged";
+}
+export interface HostedExecutionDeviceSyncRuntimeApplyResponse {
+    appliedAt: string;
+    updates: HostedExecutionDeviceSyncRuntimeApplyEntry[];
+    userId: string;
+}
+export interface HostedExecutionDispatchStateSnapshot {
+    backpressured: boolean;
+    consumed: boolean;
+    lastError: string | null;
+    pending: boolean;
+    poisoned: boolean;
+}
+export declare const HOSTED_EXECUTION_DISPATCH_NOT_CONFIGURED_ERROR = "Hosted execution dispatch is not configured.";
+export declare const HOSTED_EXECUTION_DISPATCH_LIFECYCLE_STATUSES: readonly ["pending", "accepted", "completed", "failed"];
+export type HostedExecutionDispatchLifecycleStatus = (typeof HOSTED_EXECUTION_DISPATCH_LIFECYCLE_STATUSES)[number];
+export interface HostedExecutionDispatchLifecycle {
+    lastError: string | null;
+    status: HostedExecutionDispatchLifecycleStatus;
+}
+export declare function resolveHostedExecutionDispatchOutcomeState(input: {
+    initialState: HostedExecutionDispatchStateSnapshot;
+    nextState: HostedExecutionDispatchStateSnapshot;
+}): HostedExecutionDispatchResult["event"]["state"];
+export declare function resolveHostedExecutionDispatchLifecycle(dispatchResult: HostedExecutionDispatchResult): HostedExecutionDispatchLifecycle;
+export declare function resolveHostedDeviceSyncWakeContext(event: HostedExecutionDeviceSyncWakeEvent): {
+    connectionId: string | null;
+    hint: HostedExecutionDeviceSyncWakeEvent["hint"];
+    provider: string | null;
+};
+export declare function normalizeHostedDeviceSyncJobHints(value: HostedExecutionDeviceSyncWakeEvent["hint"]): HostedExecutionDeviceSyncJobHint[];
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,IAAI,gCAAgC,EAC7D,wBAAwB,IAAI,+BAA+B,EAC5D,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EACV,6BAA6B,EAC7B,yBAAyB,EAC1B,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EACV,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC7B,MAAM,oBAAoB,CAAC;AAE5B,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAChF,eAAO,MAAM,iCAAiC,iCAAiC,CAAC;AAEhF,eAAO,MAAM,4BAA4B,0MAS/B,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAClC,CAAC,OAAO,4BAA4B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mCAAoC,SAAQ,wBAAwB;IACnF,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,MAAM,WAAW,uCAAwC,SAAQ,wBAAwB;IACvF,IAAI,EAAE,uBAAuB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,2CAA4C,SAAQ,wBAAwB;IAC3F,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,2BAA2B,CAAC;IAClC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,wCAAyC,SAAQ,wBAAwB;IACxF,IAAI,EAAE,wBAAwB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AACD,MAAM,WAAW,qCAAsC,SAAQ,wBAAwB;IACrF,IAAI,EAAE,qBAAqB,CAAC;IAC5B,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,aAAa,CAAC;CAC5C;AAED,MAAM,WAAW,gCAAgC;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iCAAiC;IAChD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,EAAE,gCAAgC,EAAE,CAAC;IAC1C,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,CAAC,EAAE;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,GAAG,IAAI,CAAC;IACT,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,kCAAmC,SAAQ,wBAAwB;IAClF,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,EAAE,iCAAiC,GAAG,IAAI,CAAC;IAChD,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,WAAW,GAAG,cAAc,GAAG,cAAc,GAAG,0BAA0B,CAAC;CACpF;AAED,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sCAAuC,SAAQ,wBAAwB;IACtF,IAAI,EAAE,sBAAsB,CAAC;IAC7B,KAAK,EAAE,6BAA6B,CAAC;CACtC;AAED,MAAM,WAAW,sCAAuC,SAAQ,wBAAwB;IACtF,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,EAAE,sBAAsB,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,oBAAoB,GAC5B,mCAAmC,GACnC,uCAAuC,GACvC,2CAA2C,GAC3C,wCAAwC,GACxC,qCAAqC,GACrC,kCAAkC,GAClC,sCAAsC,GACtC,sCAAsC,CAAC;AAE3C,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,oBAAoB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,yBAAyB,GAAG,gCAAgC,CAAC;AAEzE,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,6BAA6B,CAAC;IACvC,QAAQ,EAAE,8BAA8B,CAAC;IACzC,GAAG,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,6BAA6B,CAAC;IACvC,MAAM,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,MAAM,wBAAwB,GAAG,+BAA+B,CAAC;AAEvE,MAAM,WAAW,yBAAyB;IACxC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,UAAU,EAAE,yBAAyB,CAAC;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,GAAG,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACtC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,EAAE,4BAA4B,EAAE,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,sCAAsC,0GAOzC,CAAC;AAEX,MAAM,MAAM,iCAAiC,GAC3C,CAAC,OAAO,sCAAsC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,iCAAiC,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,kCAAkC,CAAC;IAC1C,MAAM,EAAE,yBAAyB,CAAC;CACnC;AAED,MAAM,WAAW,4BAA4B;IAC3C,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,4BAA4B;IAC3C,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACnC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;CAC3B;AAED,eAAO,MAAM,+BAA+B,+BAA+B,CAAC;AAC5E,eAAO,MAAM,0CAA0C,0CACd,CAAC;AAE1C,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,2CAA2C;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uDAAuD;IACtE,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,0BAA0B,GAAG,cAAc,CAAC;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kDAAkD;IACjE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,kDAAkD;IACjE,UAAU,EAAE,uDAAuD,CAAC;IACpE,UAAU,EAAE,kDAAkD,CAAC;IAC/D,WAAW,EAAE,2CAA2C,GAAG,IAAI,CAAC;CACjE;AAED,MAAM,WAAW,+CAA+C;IAC9D,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gDAAgD;IAC/D,WAAW,EAAE,kDAAkD,EAAE,CAAC;IAClE,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qDAAqD;IACpE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,QAAQ,GAAG,0BAA0B,GAAG,cAAc,CAAC;CACjE;AAED,MAAM,WAAW,gDAAgD;IAC/D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,gDAAgD;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,qDAAqD,CAAC;IACnE,UAAU,CAAC,EAAE,gDAAgD,CAAC;IAC9D,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,WAAW,CAAC,EAAE,2CAA2C,GAAG,IAAI,CAAC;CAClE;AAED,MAAM,WAAW,4CAA4C;IAC3D,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,gDAAgD,EAAE,CAAC;IAC5D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0CAA0C;IACzD,UAAU,EAAE,kDAAkD,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC;IACpF,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,WAAW,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,0BAA0B,GAAG,WAAW,CAAC;CAC3F;AAED,MAAM,WAAW,6CAA6C;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,0CAA0C,EAAE,CAAC;IACtD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oCAAoC;IACnD,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,eAAO,MAAM,8CAA8C,iDACX,CAAC;AAEjD,eAAO,MAAM,4CAA4C,yDAK/C,CAAC;AAEX,MAAM,MAAM,sCAAsC,GAChD,CAAC,OAAO,4CAA4C,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE,MAAM,WAAW,gCAAgC;IAC/C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,sCAAsC,CAAC;CAChD;AAED,wBAAgB,0CAA0C,CAAC,KAAK,EAAE;IAChE,YAAY,EAAE,oCAAoC,CAAC;IACnD,SAAS,EAAE,oCAAoC,CAAC;CACjD,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAsBlD;AAED,wBAAgB,uCAAuC,CACrD,cAAc,EAAE,6BAA6B,GAC5C,gCAAgC,CAsClC;AAED,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,kCAAkC,GACxC;IACD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,kCAAkC,CAAC,MAAM,CAAC,CAAC;IACjD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAMA;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,kCAAkC,CAAC,MAAM,CAAC,GAChD,gCAAgC,EAAE,CAWpC"}

package/dist/contracts.js

@@ -0,0 +1,100 @@
+export const HOSTED_EXECUTION_SIGNATURE_HEADER = "x-hosted-execution-signature";
+export const HOSTED_EXECUTION_TIMESTAMP_HEADER = "x-hosted-execution-timestamp";
+export const HOSTED_EXECUTION_EVENT_KINDS = [
+    "member.activated",
+    "linq.message.received",
+    "telegram.message.received",
+    "email.message.received",
+    "assistant.cron.tick",
+    "device-sync.wake",
+    "vault.share.accepted",
+    "gateway.message.send",
+];
+export const HOSTED_EXECUTION_EVENT_DISPATCH_STATES = [
+    "queued",
+    "duplicate_pending",
+    "duplicate_consumed",
+    "backpressured",
+    "completed",
+    "poisoned",
+];
+export const HOSTED_EXECUTION_USER_ID_HEADER = "x-hosted-execution-user-id";
+export const HOSTED_EXECUTION_RUNNER_PROXY_TOKEN_HEADER = "x-hosted-execution-runner-proxy-token";
+export const HOSTED_EXECUTION_DISPATCH_NOT_CONFIGURED_ERROR = "Hosted execution dispatch is not configured.";
+export const HOSTED_EXECUTION_DISPATCH_LIFECYCLE_STATUSES = [
+    "pending",
+    "accepted",
+    "completed",
+    "failed",
+];
+export function resolveHostedExecutionDispatchOutcomeState(input) {
+    if (input.nextState.poisoned) {
+        return "poisoned";
+    }
+    if (input.nextState.backpressured) {
+        return "backpressured";
+    }
+    if (input.initialState.consumed) {
+        return "duplicate_consumed";
+    }
+    if (input.initialState.pending) {
+        return "duplicate_pending";
+    }
+    if (input.nextState.consumed) {
+        return "completed";
+    }
+    return "queued";
+}
+export function resolveHostedExecutionDispatchLifecycle(dispatchResult) {
+    const { event, status, } = dispatchResult;
+    switch (event.state) {
+        case "completed":
+        case "duplicate_consumed":
+            return {
+                lastError: null,
+                status: "completed",
+            };
+        case "poisoned":
+            return {
+                lastError: event.lastError ?? status.lastError ?? "Hosted execution event was poisoned.",
+                status: "failed",
+            };
+        case "backpressured":
+            return {
+                lastError: event.lastError ?? status.lastError,
+                status: "pending",
+            };
+        case "queued":
+        case "duplicate_pending":
+            return {
+                lastError: status.lastError === HOSTED_EXECUTION_DISPATCH_NOT_CONFIGURED_ERROR
+                    ? status.lastError
+                    : event.lastError ?? status.lastError,
+                status: status.lastError === HOSTED_EXECUTION_DISPATCH_NOT_CONFIGURED_ERROR
+                    ? "pending"
+                    : "accepted",
+            };
+        default:
+            return event.state;
+    }
+}
+export function resolveHostedDeviceSyncWakeContext(event) {
+    return {
+        connectionId: event.connectionId ?? null,
+        hint: event.hint ?? null,
+        provider: event.provider ?? null,
+    };
+}
+export function normalizeHostedDeviceSyncJobHints(value) {
+    return Array.isArray(value?.jobs)
+        ? value.jobs.map((job) => ({
+            kind: job.kind,
+            ...(job.availableAt ? { availableAt: job.availableAt } : {}),
+            ...(job.dedupeKey !== undefined ? { dedupeKey: job.dedupeKey ?? null } : {}),
+            ...(typeof job.maxAttempts === "number" ? { maxAttempts: job.maxAttempts } : {}),
+            ...(job.payload ? { payload: { ...job.payload } } : {}),
+            ...(typeof job.priority === "number" ? { priority: job.priority } : {}),
+        }))
+        : [];
+}
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

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

package/dist/dispatch-ref.d.ts

@@ -0,0 +1,17 @@
+import type { HostedExecutionDispatchRequest, HostedExecutionEventKind, HostedExecutionShareReference } from "./contracts.ts";
+export interface HostedExecutionDispatchRef {
+    eventId: string;
+    eventKind: HostedExecutionEventKind;
+    occurredAt: string;
+    share?: HostedExecutionShareReference;
+    userId: string;
+}
+export interface HostedExecutionDispatchRefFallback {
+    eventId: string;
+    eventKind: string;
+    occurredAt: string | null;
+    userId: string;
+}
+export declare function buildHostedExecutionDispatchRef(dispatch: HostedExecutionDispatchRequest): HostedExecutionDispatchRef;
+export declare function readHostedExecutionDispatchRef(payloadJson: unknown, fallback: HostedExecutionDispatchRefFallback): HostedExecutionDispatchRef | null;
+//# sourceMappingURL=dispatch-ref.d.ts.map

package/dist/dispatch-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-ref.d.ts","sourceRoot":"","sources":["../src/dispatch-ref.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,8BAA8B,EAC9B,wBAAwB,EACxB,6BAA6B,EAC9B,MAAM,gBAAgB,CAAC;AAMxB,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,wBAAwB,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,6BAA6B,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kCAAkC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,8BAA8B,GACvC,0BAA0B,CAe5B;AAED,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,OAAO,EACpB,QAAQ,EAAE,kCAAkC,GAC3C,0BAA0B,GAAG,IAAI,CA2BnC"}