agent-embassy 1.0.0

package/dist/src/gateway/live-dashboard.js

@@ -0,0 +1,190 @@
+import { randomBytes } from "node:crypto";
+import { getDashboardCopy, } from "./dashboard-copy.js";
+import { renderLiveDashboardAssets } from "./live-dashboard-assets.js";
+import { createLiveDashboardBootstrap, } from "./live-dashboard-bootstrap.js";
+import { createLiveDashboardRequestHandler, } from "./live-dashboard-http.js";
+import { liveDashboardSecurityHeaders } from "./live-dashboard-protocol.js";
+import { bindLiveDashboardServer, defaultLiveDashboardHttpFactory, } from "./live-dashboard-server.js";
+import { createLiveDashboardStreamHub, } from "./live-dashboard-stream.js";
+export class LiveDashboardStartupCancelledError extends Error {
+    code = "LIVE_DASHBOARD_START_CANCELLED";
+    constructor() {
+        super("Live dashboard startup was cancelled.");
+        this.name = "LiveDashboardStartupCancelledError";
+    }
+}
+export function isLiveDashboardStartupCancelled(error) {
+    return (error instanceof LiveDashboardStartupCancelledError ||
+        (typeof error === "object" &&
+            error !== null &&
+            "code" in error &&
+            error.code === "LIVE_DASHBOARD_START_CANCELLED"));
+}
+function throwIfStartupCancelled(signal) {
+    if (signal?.aborted === true) {
+        throw new LiveDashboardStartupCancelledError();
+    }
+}
+async function awaitStartupStep(operation, signal, onLateSuccess) {
+    if (signal === undefined)
+        return operation;
+    if (signal.aborted) {
+        void operation.then((value) => Promise.resolve(onLateSuccess?.(value)).catch(() => undefined), () => undefined);
+        throw new LiveDashboardStartupCancelledError();
+    }
+    return await new Promise((resolve, reject) => {
+        let settled = false;
+        const onAbort = () => {
+            if (settled)
+                return;
+            settled = true;
+            signal.removeEventListener("abort", onAbort);
+            reject(new LiveDashboardStartupCancelledError());
+        };
+        signal.addEventListener("abort", onAbort, { once: true });
+        void operation.then((value) => {
+            if (settled) {
+                void Promise.resolve(onLateSuccess?.(value)).catch(() => undefined);
+                return;
+            }
+            settled = true;
+            signal.removeEventListener("abort", onAbort);
+            resolve(value);
+        }, (error) => {
+            if (settled)
+                return;
+            settled = true;
+            signal.removeEventListener("abort", onAbort);
+            reject(error);
+        });
+    });
+}
+function randomBase64Url(size, random) {
+    const value = Buffer.from(random(size)).toString("base64url");
+    const expectedLength = size === 16 ? 22 : size === 32 ? 43 : undefined;
+    if (expectedLength === undefined ||
+        value.length !== expectedLength ||
+        !/^[A-Za-z0-9_-]+$/u.test(value)) {
+        throw new Error("LIVE_DASHBOARD_RANDOM_SOURCE_INVALID");
+    }
+    return value;
+}
+function notReadyHandler(lang) {
+    const body = `${getDashboardCopy(lang)["live.http.starting"]}\n`;
+    return (_request, response) => {
+        if (response.headersSent) {
+            response.end();
+            return;
+        }
+        response.writeHead(503, {
+            ...liveDashboardSecurityHeaders(),
+            "Content-Type": "text/plain; charset=utf-8",
+            "Content-Length": String(Buffer.byteLength(body, "utf8")),
+        });
+        response.end(body);
+    };
+}
+export async function startLiveDashboard(options) {
+    throwIfStartupCancelled(options.signal);
+    const dependencies = options.dependencies ?? {};
+    const random = dependencies.random ?? randomBytes;
+    const http = dependencies.http ?? defaultLiveDashboardHttpFactory;
+    const locale = options.locale ?? "en";
+    const instancePath = `/${randomBase64Url(16, random)}`;
+    const sessionSecret = randomBase64Url(32, random);
+    const assets = renderLiveDashboardAssets(locale);
+    const hub = createLiveDashboardStreamHub({
+        observer: options.observer,
+        ...(dependencies.clock === undefined ? {} : { clock: dependencies.clock }),
+    });
+    let activeHandler = notReadyHandler(locale);
+    const server = http.createServer((request, response) => {
+        void activeHandler(request, response);
+    });
+    let bound;
+    let bootstrap;
+    try {
+        bound = await bindLiveDashboardServer(server, options.signal);
+        throwIfStartupCancelled(options.signal);
+        const expectedHost = `${bound.address.host}:${bound.address.port}`;
+        const expectedOrigin = `http://${expectedHost}`;
+        const bootstrapOperation = createLiveDashboardBootstrap({
+            privateStateRoot: options.privateStateRoot,
+            bootstrapTargetWithoutFragment: `${expectedOrigin}${instancePath}/bootstrap`,
+            lang: locale,
+            random,
+            ...(dependencies.fileSystem === undefined
+                ? {}
+                : { fileSystem: dependencies.fileSystem }),
+        });
+        bootstrap = await awaitStartupStep(bootstrapOperation, options.signal, async (lateBootstrap) => await lateBootstrap.close());
+        throwIfStartupCancelled(options.signal);
+        activeHandler = createLiveDashboardRequestHandler({
+            instancePath,
+            expectedHost,
+            expectedOrigin,
+            capability: bootstrap.capability,
+            sessionSecret,
+            cookieName: "embassy_live",
+            lang: locale,
+            assets,
+            hub,
+            actions: options.actions,
+            ...(dependencies.clock === undefined
+                ? {}
+                : { now: dependencies.clock.now }),
+        });
+        if (dependencies.openBootstrap !== undefined) {
+            await awaitStartupStep(Promise.resolve(dependencies.openBootstrap(bootstrap.bootstrapPath)), options.signal);
+        }
+        throwIfStartupCancelled(options.signal);
+    }
+    catch (error) {
+        hub.shutdown();
+        await bound?.close().catch(() => undefined);
+        await bootstrap?.close().catch(() => undefined);
+        if (options.signal?.aborted === true) {
+            throw new LiveDashboardStartupCancelledError();
+        }
+        throw error;
+    }
+    let closeInFlight;
+    const close = async () => {
+        if (closeInFlight !== undefined)
+            return closeInFlight;
+        closeInFlight = (async () => {
+            options.signal?.removeEventListener("abort", onAbortAfterReady);
+            hub.shutdown();
+            let closeError;
+            try {
+                await bound.close();
+            }
+            catch (error) {
+                closeError = error;
+            }
+            try {
+                await bootstrap.close();
+            }
+            catch (error) {
+                closeError ??= error;
+            }
+            if (closeError !== undefined)
+                throw closeError;
+        })();
+        return closeInFlight;
+    };
+    const onAbortAfterReady = () => {
+        void close().catch(() => undefined);
+    };
+    options.signal?.addEventListener("abort", onAbortAfterReady, { once: true });
+    if (options.signal?.aborted === true) {
+        await close();
+        throw new LiveDashboardStartupCancelledError();
+    }
+    return {
+        address: bound.address,
+        bootstrapPath: bootstrap.bootstrapPath,
+        close,
+    };
+}
+//# sourceMappingURL=live-dashboard.js.map

package/dist/src/gateway/live-dashboard.js.map

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

package/dist/src/gateway/locale.d.ts

@@ -0,0 +1,4 @@
+export declare const dashboardLocales: readonly ["en", "zh-CN"];
+export type DashboardLocale = (typeof dashboardLocales)[number];
+export declare function isDashboardLocale(value: unknown): value is DashboardLocale;
+export declare function assertDashboardLocale(value: unknown): asserts value is DashboardLocale;

package/dist/src/gateway/locale.js

@@ -0,0 +1,10 @@
+export const dashboardLocales = ["en", "zh-CN"];
+export function isDashboardLocale(value) {
+    return value === "en" || value === "zh-CN";
+}
+export function assertDashboardLocale(value) {
+    if (!isDashboardLocale(value)) {
+        throw new Error("DASHBOARD_LOCALE_UNSUPPORTED");
+    }
+}
+//# sourceMappingURL=locale.js.map

package/dist/src/gateway/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.js","sourceRoot":"","sources":["../../../src/gateway/locale.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,OAAO,CAAU,CAAC;AAIzD,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,OAAO,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAc;IAEd,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;AACH,CAAC"}

package/dist/src/gateway/progress-watch-machine.d.ts

@@ -0,0 +1,97 @@
+export declare const progressWatchPhases: readonly ["quiet", "episode"];
+export type ProgressWatchPhase = (typeof progressWatchPhases)[number];
+export declare const progressWatchCapabilities: readonly ["conversation", "route"];
+export type ProgressWatchCapability = (typeof progressWatchCapabilities)[number];
+export declare const progressWatchOutcomes: readonly ["done", "unresponsive", "endpoint_retired", "disabled"];
+export type ProgressWatchOutcome = (typeof progressWatchOutcomes)[number];
+export declare const progressWatchJournalKinds: readonly ["opened", "activity", "nudge", "worker_reported_complete", "capability_degraded", "done", "unresponsive", "endpoint_retired", "disabled"];
+export type ProgressWatchJournalKind = (typeof progressWatchJournalKinds)[number];
+export declare const PROGRESS_WATCH_DEFAULT_IDLE_MS: number;
+export declare const PROGRESS_WATCH_MIN_IDLE_MS = 60000;
+export declare const PROGRESS_WATCH_MAX_IDLE_MS: number;
+export declare const PROGRESS_WATCH_DEFAULT_CAPACITY = 32;
+export declare const PROGRESS_WATCH_HARD_CAPACITY = 256;
+/**
+ * Durable, content-free liveness state. Route leases keep a watch attached to
+ * the exact consent edge that opened it; they are never publicly projected.
+ */
+export type ProgressWatchMachine = Readonly<{
+    conversationId: string;
+    ownerAlias: string;
+    workerAlias: string;
+    ownerLease: string;
+    workerLease: string;
+    createdAt: string;
+    updatedAt: string;
+    lastActivityAt: string;
+    idleMs: number;
+    phase: ProgressWatchPhase;
+    nudgeCount: 0 | 1 | 2;
+    nextActionAt: string;
+    capability: ProgressWatchCapability;
+    degradedNoticeSent: boolean;
+    workerReportedCompleteAt?: string;
+}>;
+export type ProgressWatchJournalEvent = Readonly<{
+    sequence: number;
+    timestamp: string;
+    conversationId: string;
+    ownerAlias: string;
+    workerAlias: string;
+    kind: ProgressWatchJournalKind;
+    nudgeNumber?: 1 | 2;
+}>;
+export type ProgressWatchEvent = Readonly<{
+    type: "activity";
+    at: number;
+    workerReportedComplete?: true;
+}> | Readonly<{
+    type: "route_activity";
+    at: number;
+}> | Readonly<{
+    type: "due";
+    at: number;
+    bothIdle: boolean;
+    endpointsPresent: boolean;
+}> | Readonly<{
+    type: "restart";
+    at: number;
+    conversationCapabilityRestored: boolean;
+}> | Readonly<{
+    type: "nudge_deferred";
+    at: number;
+    retryAt: number;
+}> | Readonly<{
+    type: "owner_done";
+    at: number;
+}> | Readonly<{
+    type: "endpoint_retired";
+    at: number;
+}> | Readonly<{
+    type: "disabled";
+    at: number;
+}>;
+export type ProgressWatchEffect = Readonly<{
+    type: "send_nudge";
+    nudgeNumber: 1 | 2;
+}> | Readonly<{
+    type: "notify_capability_degraded";
+}> | Readonly<{
+    type: "settled";
+    outcome: ProgressWatchOutcome;
+}>;
+export type ProgressWatchTransition = Readonly<{
+    state: ProgressWatchMachine | null;
+    effects: readonly ProgressWatchEffect[];
+}>;
+export declare function createProgressWatchMachine(input: Readonly<{
+    conversationId: string;
+    ownerAlias: string;
+    workerAlias: string;
+    ownerLease: string;
+    workerLease: string;
+    idleMs: number;
+    at: number;
+}>): ProgressWatchMachine;
+/** Pure, deterministic owner-ended progress-watch transition function. */
+export declare function transitionProgressWatch(state: ProgressWatchMachine, event: ProgressWatchEvent): ProgressWatchTransition;

package/dist/src/gateway/progress-watch-machine.js

@@ -0,0 +1,172 @@
+export const progressWatchPhases = ["quiet", "episode"];
+export const progressWatchCapabilities = ["conversation", "route"];
+export const progressWatchOutcomes = [
+    "done",
+    "unresponsive",
+    "endpoint_retired",
+    "disabled",
+];
+export const progressWatchJournalKinds = [
+    "opened",
+    "activity",
+    "nudge",
+    "worker_reported_complete",
+    "capability_degraded",
+    "done",
+    "unresponsive",
+    "endpoint_retired",
+    "disabled",
+];
+export const PROGRESS_WATCH_DEFAULT_IDLE_MS = 5 * 60_000;
+export const PROGRESS_WATCH_MIN_IDLE_MS = 60_000;
+export const PROGRESS_WATCH_MAX_IDLE_MS = 24 * 60 * 60_000;
+export const PROGRESS_WATCH_DEFAULT_CAPACITY = 32;
+export const PROGRESS_WATCH_HARD_CAPACITY = 256;
+function iso(at) {
+    if (!Number.isFinite(at))
+        throw new RangeError("INVALID_PROGRESS_WATCH_TIME");
+    return new Date(at).toISOString();
+}
+function plus(at, delayMs) {
+    return iso(at + delayMs);
+}
+function settle(outcome) {
+    return { state: null, effects: [{ type: "settled", outcome }] };
+}
+export function createProgressWatchMachine(input) {
+    if (!Number.isSafeInteger(input.idleMs) ||
+        input.idleMs < PROGRESS_WATCH_MIN_IDLE_MS ||
+        input.idleMs > PROGRESS_WATCH_MAX_IDLE_MS) {
+        throw new RangeError("INVALID_PROGRESS_WATCH_IDLE_MS");
+    }
+    const timestamp = iso(input.at);
+    return {
+        conversationId: input.conversationId,
+        ownerAlias: input.ownerAlias,
+        workerAlias: input.workerAlias,
+        ownerLease: input.ownerLease,
+        workerLease: input.workerLease,
+        createdAt: timestamp,
+        updatedAt: timestamp,
+        lastActivityAt: timestamp,
+        idleMs: input.idleMs,
+        phase: "quiet",
+        nudgeCount: 0,
+        nextActionAt: plus(input.at, input.idleMs),
+        capability: "conversation",
+        degradedNoticeSent: false,
+    };
+}
+/** Pure, deterministic owner-ended progress-watch transition function. */
+export function transitionProgressWatch(state, event) {
+    const at = event.at;
+    const timestamp = iso(at);
+    switch (event.type) {
+        case "owner_done":
+            return settle("done");
+        case "endpoint_retired":
+            return settle("endpoint_retired");
+        case "disabled":
+            return settle("disabled");
+        case "activity":
+        case "route_activity": {
+            const workerReportedComplete = event.type === "activity" && event.workerReportedComplete === true;
+            return {
+                state: {
+                    ...state,
+                    updatedAt: timestamp,
+                    lastActivityAt: timestamp,
+                    phase: "quiet",
+                    nudgeCount: 0,
+                    nextActionAt: plus(at, state.idleMs),
+                    ...(workerReportedComplete
+                        ? { workerReportedCompleteAt: timestamp }
+                        : {}),
+                },
+                effects: [],
+            };
+        }
+        case "restart": {
+            if (event.conversationCapabilityRestored) {
+                return {
+                    state: {
+                        ...state,
+                        updatedAt: timestamp,
+                        capability: "conversation",
+                    },
+                    effects: [],
+                };
+            }
+            const notify = !state.degradedNoticeSent;
+            return {
+                state: {
+                    ...state,
+                    updatedAt: timestamp,
+                    capability: "route",
+                    degradedNoticeSent: true,
+                },
+                effects: notify ? [{ type: "notify_capability_degraded" }] : [],
+            };
+        }
+        case "nudge_deferred": {
+            if (!Number.isFinite(event.retryAt) ||
+                event.retryAt <= at ||
+                event.retryAt > at + Math.min(state.idleMs, 60_000)) {
+                throw new RangeError("INVALID_PROGRESS_WATCH_RETRY_AT");
+            }
+            return {
+                state: {
+                    ...state,
+                    updatedAt: timestamp,
+                    nextActionAt: iso(event.retryAt),
+                },
+                effects: [],
+            };
+        }
+        case "due": {
+            if (at < Date.parse(state.nextActionAt)) {
+                return { state, effects: [] };
+            }
+            if (!event.endpointsPresent)
+                return settle("endpoint_retired");
+            if (!event.bothIdle) {
+                return {
+                    state: {
+                        ...state,
+                        updatedAt: timestamp,
+                        lastActivityAt: timestamp,
+                        phase: "quiet",
+                        nudgeCount: 0,
+                        nextActionAt: plus(at, state.idleMs),
+                    },
+                    effects: [],
+                };
+            }
+            if (state.phase === "quiet") {
+                return {
+                    state: {
+                        ...state,
+                        updatedAt: timestamp,
+                        phase: "episode",
+                        nudgeCount: 1,
+                        nextActionAt: plus(at, state.idleMs),
+                    },
+                    effects: [{ type: "send_nudge", nudgeNumber: 1 }],
+                };
+            }
+            if (state.nudgeCount === 1) {
+                return {
+                    state: {
+                        ...state,
+                        updatedAt: timestamp,
+                        nudgeCount: 2,
+                        nextActionAt: plus(at, state.idleMs * 2),
+                    },
+                    effects: [{ type: "send_nudge", nudgeNumber: 2 }],
+                };
+            }
+            return settle("unresponsive");
+        }
+    }
+}
+//# sourceMappingURL=progress-watch-machine.js.map

package/dist/src/gateway/progress-watch-machine.js.map

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