@murphai/hosted-execution 0.1.1

package/dist/dispatch-ref.js

@@ -0,0 +1,74 @@
+import { HOSTED_EXECUTION_EVENT_KINDS } from "./contracts.js";
+const HOSTED_EXECUTION_EVENT_KIND_SET = new Set(HOSTED_EXECUTION_EVENT_KINDS);
+const HOSTED_EXECUTION_OUTBOX_PAYLOAD_SCHEMA_VERSION = "murph.execution-outbox.v2";
+export function buildHostedExecutionDispatchRef(dispatch) {
+    return {
+        eventId: dispatch.eventId,
+        eventKind: dispatch.event.kind,
+        occurredAt: dispatch.occurredAt,
+        ...(dispatch.event.kind === "vault.share.accepted"
+            ? {
+                share: {
+                    shareCode: dispatch.event.share.shareCode,
+                    shareId: dispatch.event.share.shareId,
+                },
+            }
+            : {}),
+        userId: dispatch.event.userId,
+    };
+}
+export function readHostedExecutionDispatchRef(payloadJson, fallback) {
+    const payloadObject = toHostedExecutionObject(payloadJson);
+    const nestedRef = toHostedExecutionObject(payloadObject.dispatchRef);
+    const schemaVersion = readHostedExecutionText(payloadObject.schemaVersion);
+    const storage = readHostedExecutionText(payloadObject.storage);
+    if (schemaVersion !== HOSTED_EXECUTION_OUTBOX_PAYLOAD_SCHEMA_VERSION || storage !== "reference") {
+        return null;
+    }
+    const eventId = readHostedExecutionText(nestedRef.eventId) ?? fallback.eventId;
+    const eventKind = readHostedExecutionEventKind(nestedRef.eventKind) ?? readHostedExecutionEventKind(fallback.eventKind);
+    const occurredAt = readHostedExecutionText(nestedRef.occurredAt) ?? fallback.occurredAt;
+    const share = readHostedExecutionShareReference(nestedRef.share);
+    const userId = readHostedExecutionText(nestedRef.userId) ?? fallback.userId;
+    if (!eventId || !eventKind || !occurredAt || !userId) {
+        return null;
+    }
+    return {
+        eventId,
+        eventKind,
+        occurredAt,
+        ...(share ? { share } : {}),
+        userId,
+    };
+}
+function readHostedExecutionEventKind(value) {
+    return typeof value === "string" && HOSTED_EXECUTION_EVENT_KIND_SET.has(value)
+        ? value
+        : null;
+}
+function readHostedExecutionShareReference(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    const record = value;
+    const shareId = readHostedExecutionText(record.shareId);
+    const shareCode = readHostedExecutionText(record.shareCode);
+    if (!shareId || !shareCode) {
+        return undefined;
+    }
+    return {
+        shareCode,
+        shareId,
+    };
+}
+function readHostedExecutionText(value) {
+    return typeof value === "string" && value.trim().length > 0
+        ? value
+        : null;
+}
+function toHostedExecutionObject(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+//# sourceMappingURL=dispatch-ref.js.map

package/dist/dispatch-ref.js.map

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

package/dist/env.d.ts

@@ -0,0 +1,46 @@
+export interface HostedExecutionDispatchEnvironment {
+    dispatchTimeoutMs: number;
+    dispatchUrl: string | null;
+    signingSecret: string | null;
+}
+export interface HostedExecutionControlEnvironment {
+    baseUrl: string | null;
+    controlToken: string | null;
+}
+export interface HostedExecutionWebControlPlaneEnvironment {
+    deviceSyncRuntimeBaseUrl: string | null;
+    internalToken: string | null;
+    schedulerToken: string | null;
+    shareBaseUrl: string | null;
+    shareToken: string | null;
+    usageBaseUrl?: string | null;
+}
+export interface HostedExecutionWorkerEnvironment {
+    allowedUserEnvKeys: string | null;
+    allowedUserEnvPrefixes: string | null;
+    bundleEncryptionKeyBase64: string;
+    bundleEncryptionKeyId: string;
+    bundleEncryptionKeyringJson: string | null;
+    controlToken: string | null;
+    defaultAlarmDelayMs: number;
+    dispatchSigningSecret: string;
+    maxEventAttempts: number;
+    retryDelayMs: number;
+    runnerControlToken: string | null;
+    runnerTimeoutMs: number;
+}
+type EnvSource = Readonly<Record<string, string | undefined>>;
+export interface HostedExecutionBaseUrlNormalizationOptions {
+    allowHttpHosts?: readonly string[];
+    allowHttpLocalhost?: boolean;
+}
+export declare function readHostedExecutionDispatchEnvironment(source?: EnvSource): HostedExecutionDispatchEnvironment;
+export declare function readHostedExecutionControlEnvironment(source?: EnvSource): HostedExecutionControlEnvironment;
+export declare function readHostedExecutionWebControlPlaneEnvironment(source?: EnvSource, options?: HostedExecutionBaseUrlNormalizationOptions): HostedExecutionWebControlPlaneEnvironment;
+export declare function readHostedExecutionVercelProductionBaseUrl(source?: EnvSource, options?: HostedExecutionBaseUrlNormalizationOptions): string | null;
+export declare function readHostedExecutionWorkerEnvironment(source?: EnvSource): HostedExecutionWorkerEnvironment;
+export declare function normalizeHostedExecutionBaseUrl(value: string | null | undefined, options?: HostedExecutionBaseUrlNormalizationOptions): string | null;
+export declare function hostedAssistantAutomationEnabledFromEnv(env: Readonly<Record<string, string | undefined>>): boolean;
+export declare function normalizeHostedExecutionString(value: string | null | undefined): string | null;
+export {};
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kCAAkC;IACjD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,iCAAiC;IAChD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,yCAAyC;IACxD,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,gCAAgC;IAC/C,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,yBAAyB,EAAE,MAAM,CAAC;IAClC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,2BAA2B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,KAAK,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAE9D,MAAM,WAAW,0CAA0C;IACzD,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAgB,sCAAsC,CACpD,MAAM,GAAE,SAAuB,GAC9B,kCAAkC,CAcpC;AAED,wBAAgB,qCAAqC,CACnD,MAAM,GAAE,SAAuB,GAC9B,iCAAiC,CAOnC;AAED,wBAAgB,6CAA6C,CAC3D,MAAM,GAAE,SAAuB,EAC/B,OAAO,CAAC,EAAE,0CAA0C,GACnD,yCAAyC,CAmB3C;AAED,wBAAgB,0CAA0C,CACxD,MAAM,GAAE,SAAuB,EAC/B,OAAO,CAAC,EAAE,0CAA0C,GACnD,MAAM,GAAG,IAAI,CAYf;AAED,wBAAgB,oCAAoC,CAClD,MAAM,GAAE,SAAuB,GAC9B,gCAAgC,CAyClC;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,0CAA0C,GACnD,MAAM,GAAG,IAAI,CA+Bf;AAED,wBAAgB,uCAAuC,CACrD,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAChD,OAAO,CAcT;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAO9F"}

package/dist/env.js

@@ -0,0 +1,116 @@
+export function readHostedExecutionDispatchEnvironment(source = process.env) {
+    const dispatchUrl = normalizeHostedExecutionBaseUrl(source.HOSTED_EXECUTION_DISPATCH_URL);
+    const signingSecret = normalizeHostedExecutionString(source.HOSTED_EXECUTION_SIGNING_SECRET);
+    const dispatchTimeout = normalizeHostedExecutionString(source.HOSTED_EXECUTION_DISPATCH_TIMEOUT_MS);
+    return {
+        dispatchTimeoutMs: parsePositiveInteger(dispatchTimeout, 30_000, "HOSTED_EXECUTION_DISPATCH_TIMEOUT_MS"),
+        dispatchUrl,
+        signingSecret,
+    };
+}
+export function readHostedExecutionControlEnvironment(source = process.env) {
+    const dispatchUrl = normalizeHostedExecutionBaseUrl(source.HOSTED_EXECUTION_DISPATCH_URL);
+    return {
+        baseUrl: dispatchUrl,
+        controlToken: normalizeHostedExecutionString(source.HOSTED_EXECUTION_CONTROL_TOKEN),
+    };
+}
+export function readHostedExecutionWebControlPlaneEnvironment(source = process.env, options) {
+    const sharedBaseUrl = normalizeHostedExecutionBaseUrl(source.HOSTED_WEB_BASE_URL, options)
+        ?? readHostedExecutionVercelProductionBaseUrl(source, options);
+    return {
+        deviceSyncRuntimeBaseUrl: normalizeHostedExecutionBaseUrl(source.HOSTED_DEVICE_SYNC_CONTROL_BASE_URL, options) ?? sharedBaseUrl,
+        internalToken: normalizeHostedExecutionString(source.HOSTED_EXECUTION_INTERNAL_TOKEN),
+        schedulerToken: normalizeHostedExecutionString(source.CRON_SECRET),
+        shareBaseUrl: normalizeHostedExecutionBaseUrl(source.HOSTED_SHARE_API_BASE_URL, options) ?? sharedBaseUrl,
+        shareToken: normalizeHostedExecutionString(source.HOSTED_SHARE_INTERNAL_TOKEN),
+        usageBaseUrl: normalizeHostedExecutionBaseUrl(source.HOSTED_AI_USAGE_BASE_URL, options) ?? sharedBaseUrl,
+    };
+}
+export function readHostedExecutionVercelProductionBaseUrl(source = process.env, options) {
+    const productionUrl = normalizeHostedExecutionString(source.VERCEL_PROJECT_PRODUCTION_URL);
+    if (!productionUrl) {
+        return null;
+    }
+    const normalizedInput = /^[a-z][a-z\d+.-]*:\/\//iu.test(productionUrl)
+        ? productionUrl
+        : `https://${productionUrl}`;
+    return normalizeHostedExecutionBaseUrl(normalizedInput, options);
+}
+export function readHostedExecutionWorkerEnvironment(source = process.env) {
+    return {
+        allowedUserEnvKeys: normalizeHostedExecutionString(source.HOSTED_EXECUTION_ALLOWED_USER_ENV_KEYS),
+        allowedUserEnvPrefixes: normalizeHostedExecutionString(source.HOSTED_EXECUTION_ALLOWED_USER_ENV_PREFIXES),
+        bundleEncryptionKeyBase64: requireHostedExecutionString(source.HOSTED_EXECUTION_BUNDLE_ENCRYPTION_KEY, "HOSTED_EXECUTION_BUNDLE_ENCRYPTION_KEY"),
+        bundleEncryptionKeyId: normalizeHostedExecutionString(source.HOSTED_EXECUTION_BUNDLE_ENCRYPTION_KEY_ID) ?? "v1",
+        bundleEncryptionKeyringJson: normalizeHostedExecutionString(source.HOSTED_EXECUTION_BUNDLE_ENCRYPTION_KEYRING_JSON),
+        controlToken: normalizeHostedExecutionString(source.HOSTED_EXECUTION_CONTROL_TOKEN),
+        defaultAlarmDelayMs: parsePositiveInteger(normalizeHostedExecutionString(source.HOSTED_EXECUTION_DEFAULT_ALARM_DELAY_MS), 15 * 60 * 1000, "HOSTED_EXECUTION_DEFAULT_ALARM_DELAY_MS"),
+        dispatchSigningSecret: requireHostedExecutionString(normalizeHostedExecutionString(source.HOSTED_EXECUTION_SIGNING_SECRET), "HOSTED_EXECUTION_SIGNING_SECRET"),
+        maxEventAttempts: parsePositiveInteger(normalizeHostedExecutionString(source.HOSTED_EXECUTION_MAX_EVENT_ATTEMPTS), 3, "HOSTED_EXECUTION_MAX_EVENT_ATTEMPTS"),
+        retryDelayMs: parsePositiveInteger(normalizeHostedExecutionString(source.HOSTED_EXECUTION_RETRY_DELAY_MS), 30_000, "HOSTED_EXECUTION_RETRY_DELAY_MS"),
+        runnerControlToken: normalizeHostedExecutionString(source.HOSTED_EXECUTION_RUNNER_CONTROL_TOKEN),
+        runnerTimeoutMs: parsePositiveInteger(normalizeHostedExecutionString(source.HOSTED_EXECUTION_RUNNER_TIMEOUT_MS), 60_000, "HOSTED_EXECUTION_RUNNER_TIMEOUT_MS"),
+    };
+}
+export function normalizeHostedExecutionBaseUrl(value, options) {
+    const normalized = normalizeHostedExecutionString(value);
+    if (!normalized) {
+        return null;
+    }
+    const url = new URL(normalized);
+    const protocol = url.protocol.toLowerCase();
+    const hostname = url.hostname.toLowerCase();
+    const allowHttpHosts = new Set((options?.allowHttpHosts ?? []).map((entry) => entry.toLowerCase()));
+    const allowHttp = protocol === "http:"
+        && (allowHttpHosts.has(hostname)
+            || (options?.allowHttpLocalhost === true && isHostedExecutionLoopbackHost(hostname)));
+    if (protocol !== "https:" && !allowHttp) {
+        throw new TypeError("Hosted execution base URLs must use HTTPS unless the host is explicitly allowlisted for HTTP.");
+    }
+    if (url.username || url.password) {
+        throw new TypeError("Hosted execution base URLs must not include embedded credentials.");
+    }
+    url.hash = "";
+    url.search = "";
+    return url.toString().replace(/\/$/u, "");
+}
+export function hostedAssistantAutomationEnabledFromEnv(env) {
+    const normalized = normalizeHostedExecutionString(env.HOSTED_EXECUTION_ENABLE_ASSISTANT_AUTOMATION)?.toLowerCase();
+    if (!normalized) {
+        return true;
+    }
+    return normalized !== "0"
+        && normalized !== "false"
+        && normalized !== "no"
+        && normalized !== "off"
+        && normalized !== "disabled";
+}
+export function normalizeHostedExecutionString(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const normalized = value.trim();
+    return normalized.length > 0 ? normalized : null;
+}
+function requireHostedExecutionString(value, label) {
+    const normalized = normalizeHostedExecutionString(value);
+    if (!normalized) {
+        throw new TypeError(`${label} is required.`);
+    }
+    return normalized;
+}
+function parsePositiveInteger(value, fallback, label) {
+    if (!value) {
+        return fallback;
+    }
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed) || parsed < 1) {
+        throw new RangeError(`${label} must be a positive integer.`);
+    }
+    return parsed;
+}
+function isHostedExecutionLoopbackHost(hostname) {
+    return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "::1" || hostname === "[::1]";
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

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

package/dist/hosted-email.d.ts

@@ -0,0 +1,15 @@
+type EnvSource = Readonly<Record<string, string | undefined>>;
+export interface HostedEmailCapabilities {
+    ingressReady: boolean;
+    sendReady: boolean;
+    senderIdentity: string | null;
+}
+export declare function readHostedEmailCapabilities(source?: EnvSource): HostedEmailCapabilities;
+export declare function resolveHostedEmailSenderIdentity(source?: EnvSource): string | null;
+export declare function resolveHostedEmailSelfAddresses(input: {
+    envelopeTo?: string | null;
+    extra?: ReadonlyArray<string | null | undefined> | null;
+    senderIdentity?: string | null;
+}): string[];
+export {};
+//# sourceMappingURL=hosted-email.d.ts.map

package/dist/hosted-email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosted-email.d.ts","sourceRoot":"","sources":["../src/hosted-email.ts"],"names":[],"mappings":"AAEA,KAAK,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,wBAAgB,2BAA2B,CACzC,MAAM,GAAE,SAAuB,GAC9B,uBAAuB,CAoBzB;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,GAAE,SAAuB,GAC9B,MAAM,GAAG,IAAI,CAcf;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;IACxD,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC,GAAG,MAAM,EAAE,CAqBX"}

package/dist/hosted-email.js

@@ -0,0 +1,76 @@
+import { normalizeHostedExecutionString } from "./env.js";
+export function readHostedEmailCapabilities(source = process.env) {
+    const domain = normalizeHostedExecutionString(source.HOSTED_EMAIL_DOMAIN)?.toLowerCase() ?? null;
+    const senderIdentity = resolveHostedEmailSenderIdentity(source);
+    const signingSecret = normalizeHostedExecutionString(source.HOSTED_EMAIL_SIGNING_SECRET);
+    const cloudflareAccountId = normalizeHostedExecutionString(source.HOSTED_EMAIL_CLOUDFLARE_ACCOUNT_ID);
+    const cloudflareApiToken = normalizeHostedExecutionString(source.HOSTED_EMAIL_CLOUDFLARE_API_TOKEN);
+    const inferredIngressReady = senderIdentity !== null && domain !== null && signingSecret !== null;
+    const inferredSendReady = inferredIngressReady
+        && cloudflareAccountId !== null
+        && cloudflareApiToken !== null;
+    const ingressReady = senderIdentity !== null
+        && (parseHostedEmailCapabilityFlag(source.HOSTED_EMAIL_INGRESS_READY) ?? inferredIngressReady);
+    const sendReady = senderIdentity !== null
+        && (parseHostedEmailCapabilityFlag(source.HOSTED_EMAIL_SEND_READY) ?? inferredSendReady);
+    return {
+        ingressReady,
+        sendReady,
+        senderIdentity,
+    };
+}
+export function resolveHostedEmailSenderIdentity(source = process.env) {
+    const explicit = normalizeHostedEmailAddress(source.HOSTED_EMAIL_FROM_ADDRESS);
+    if (explicit) {
+        return explicit;
+    }
+    const domain = normalizeHostedExecutionString(source.HOSTED_EMAIL_DOMAIN)?.toLowerCase() ?? null;
+    if (!domain) {
+        return null;
+    }
+    const localPart = normalizeHostedExecutionString(source.HOSTED_EMAIL_LOCAL_PART)?.toLowerCase()
+        ?? "assistant";
+    return `${localPart}@${domain}`;
+}
+export function resolveHostedEmailSelfAddresses(input) {
+    const seen = new Set();
+    const addresses = [];
+    const append = (value) => {
+        const normalized = normalizeHostedEmailAddress(value);
+        if (!normalized || seen.has(normalized)) {
+            return;
+        }
+        seen.add(normalized);
+        addresses.push(normalized);
+    };
+    append(input.senderIdentity);
+    append(input.envelopeTo);
+    for (const value of input.extra ?? []) {
+        append(value);
+    }
+    return addresses;
+}
+function normalizeHostedEmailAddress(value) {
+    const normalized = normalizeHostedExecutionString(value);
+    if (!normalized) {
+        return null;
+    }
+    const angleMatch = normalized.match(/<([^>]+)>/u);
+    const candidate = angleMatch?.[1] ?? normalized;
+    const trimmed = candidate.trim().toLowerCase();
+    return trimmed.length > 0 ? trimmed : null;
+}
+function parseHostedEmailCapabilityFlag(value) {
+    const normalized = normalizeHostedExecutionString(value)?.toLowerCase();
+    if (!normalized) {
+        return null;
+    }
+    if (normalized === "1" || normalized === "true") {
+        return true;
+    }
+    if (normalized === "0" || normalized === "false") {
+        return false;
+    }
+    return null;
+}
+//# sourceMappingURL=hosted-email.js.map

package/dist/hosted-email.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export * from "./auth.ts";
+export * from "./builders.ts";
+export * from "./bundles.ts";
+export * from "./callback-hosts.ts";
+export * from "./client.ts";
+export * from "./contracts.ts";
+export * from "./dispatch-ref.ts";
+export * from "./env.ts";
+export * from "./hosted-email.ts";
+export * from "./outbox-payload.ts";
+export * from "./observability.ts";
+export * from "./parsers.ts";
+export * from "./routes.ts";
+export * from "./side-effects.ts";
+export * from "./web-control-plane.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+export * from "./auth.js";
+export * from "./builders.js";
+export * from "./bundles.js";
+export * from "./callback-hosts.js";
+export * from "./client.js";
+export * from "./contracts.js";
+export * from "./dispatch-ref.js";
+export * from "./env.js";
+export * from "./hosted-email.js";
+export * from "./outbox-payload.js";
+export * from "./observability.js";
+export * from "./parsers.js";
+export * from "./routes.js";
+export * from "./side-effects.js";
+export * from "./web-control-plane.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC"}

package/dist/observability.d.ts

@@ -0,0 +1,65 @@
+export declare const HOSTED_EXECUTION_RUN_PHASES: readonly ["claimed", "dispatch.running", "container.starting", "container.ready", "runtime.starting", "commit.recorded", "side-effects.draining", "finalize.recorded", "completed", "retry.scheduled", "failed", "poisoned"];
+export type HostedExecutionRunPhase = (typeof HOSTED_EXECUTION_RUN_PHASES)[number];
+export declare const HOSTED_EXECUTION_RUN_LEVELS: readonly ["info", "warn", "error"];
+export type HostedExecutionRunLevel = (typeof HOSTED_EXECUTION_RUN_LEVELS)[number];
+export interface HostedExecutionRunContext {
+    attempt: number;
+    runId: string;
+    startedAt: string;
+}
+export interface HostedExecutionRunStatus extends HostedExecutionRunContext {
+    eventId: string;
+    phase: HostedExecutionRunPhase;
+    updatedAt: string;
+}
+export interface HostedExecutionTimelineEntry {
+    at: string;
+    attempt: number;
+    component: string;
+    errorCode?: string | null;
+    eventId: string;
+    level: HostedExecutionRunLevel;
+    message: string;
+    phase: HostedExecutionRunPhase;
+    runId: string;
+}
+export interface HostedExecutionStructuredLogRecord {
+    attempt: number | null;
+    component: string;
+    errorCode?: string | null;
+    errorMessage?: string | null;
+    errorName?: string | null;
+    eventId: string | null;
+    level: HostedExecutionRunLevel;
+    message: string;
+    phase: HostedExecutionRunPhase;
+    runId: string | null;
+    schema: "murph.hosted-execution.log.v1";
+    time: string;
+    userId: string | null;
+}
+interface HostedExecutionDispatchLike {
+    eventId?: string | null;
+}
+export interface HostedExecutionStructuredLogInput {
+    component: string;
+    dispatch?: HostedExecutionDispatchLike | null;
+    error?: unknown;
+    eventId?: string | null;
+    level?: HostedExecutionRunLevel;
+    message: string;
+    phase: HostedExecutionRunPhase;
+    run?: HostedExecutionRunContext | null;
+    time?: string;
+    userId?: string | null;
+}
+export declare function isHostedExecutionRunPhase(value: unknown): value is HostedExecutionRunPhase;
+export declare function isHostedExecutionRunLevel(value: unknown): value is HostedExecutionRunLevel;
+export declare function normalizeHostedExecutionErrorMessage(error: unknown): string;
+export declare function normalizeHostedExecutionOperatorMessage(message: string): string;
+export declare function deriveHostedExecutionErrorCode(error: unknown): string;
+export declare function summarizeHostedExecutionError(error: unknown): string;
+export declare function buildHostedExecutionStructuredLogRecord(input: HostedExecutionStructuredLogInput): HostedExecutionStructuredLogRecord;
+export declare function emitHostedExecutionStructuredLog(input: HostedExecutionStructuredLogInput): HostedExecutionStructuredLogRecord;
+export {};
+//# sourceMappingURL=observability.d.ts.map

package/dist/observability.d.ts.map

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