@scotthuang/agent-knock-knock 0.12.15 → 0.12.16

package/dist/src/host-bridge-mcp.js.map

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

package/dist/src/host-bridge-tools.d.ts

@@ -0,0 +1,61 @@
+export interface HostBridgeToolContext {
+    readonly sessionKey: string;
+    readonly sessionId: string;
+}
+export interface HostBridgeToolLogger {
+    debug?(message: string): void;
+    info(message: string): void;
+    warn(message: string): void;
+    error?(message: string): void;
+}
+export interface HostBridgeToolContent {
+    readonly type: string;
+    readonly text?: string;
+    readonly [key: string]: unknown;
+}
+export interface HostBridgeToolResult {
+    readonly content?: readonly HostBridgeToolContent[];
+    readonly details?: unknown;
+    readonly isError?: boolean;
+    readonly [key: string]: unknown;
+}
+export interface HostBridgeCommandResult {
+    readonly text: string;
+    readonly isError?: boolean;
+}
+export interface HostBridgeCommandDescriptor {
+    readonly name: string;
+    readonly description: string;
+    readonly acceptsArgs: boolean;
+    execute(args: string): Promise<HostBridgeCommandResult>;
+}
+export interface HostBridgeToolDescriptor {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: Readonly<Record<string, unknown>>;
+    execute(toolCallId: string, args: Readonly<Record<string, unknown>>): Promise<HostBridgeToolResult>;
+}
+export interface HostBridgeToolRegistry {
+    list(): readonly HostBridgeToolDescriptor[];
+    get(name: string): HostBridgeToolDescriptor | undefined;
+    execute(name: string, toolCallId: string, args: Readonly<Record<string, unknown>>): Promise<HostBridgeToolResult>;
+}
+export interface HostBridgeCommandToolRegistry extends HostBridgeToolRegistry {
+    command(): HostBridgeCommandDescriptor;
+}
+export interface CreateHostBridgeToolsOptions {
+    readonly relayPath: string;
+    readonly relayEnvironment: NodeJS.ProcessEnv;
+    readonly pluginConfig: Readonly<Record<string, unknown>>;
+    readonly logger: HostBridgeToolLogger;
+    readonly context: HostBridgeToolContext;
+}
+/**
+ * Capture the established AKK semantic tools behind a host-neutral registry.
+ *
+ * Tool factories are instantiated exactly once with the trusted controller
+ * context. Keeping the same API object and definitions alive also preserves
+ * the private-authority state owned by the OpenClaw-compatible implementation.
+ */
+export declare function createHostBridgeToolRegistry(options: CreateHostBridgeToolsOptions): HostBridgeCommandToolRegistry;
+export declare function createHostBridgeTools(options: CreateHostBridgeToolsOptions): readonly HostBridgeToolDescriptor[];

package/dist/src/host-bridge-tools.js

@@ -0,0 +1,130 @@
+import { bindHostBridgeAsyncRelay, bindHostBridgeToolPresentation, bindOpenClawRelayEnvironment, bindOpenClawRelayPath, registerOpenClawCommands } from "./openclaw-plugin-command-adapter.js";
+/**
+ * Capture the established AKK semantic tools behind a host-neutral registry.
+ *
+ * Tool factories are instantiated exactly once with the trusted controller
+ * context. Keeping the same API object and definitions alive also preserves
+ * the private-authority state owned by the OpenClaw-compatible implementation.
+ */
+export function createHostBridgeToolRegistry(options) {
+    const descriptors = [];
+    const descriptorsByName = new Map();
+    let commandDescriptor;
+    const trustedContext = Object.freeze({
+        sessionKey: requiredString(options.context.sessionKey, "context.sessionKey"),
+        sessionId: requiredString(options.context.sessionId, "context.sessionId")
+    });
+    const api = {
+        pluginConfig: options.pluginConfig,
+        logger: options.logger,
+        registerCommand(command) {
+            if (commandDescriptor) {
+                throw new Error("host bridge registered more than one command");
+            }
+            const name = requiredString(command.name, "command name");
+            if (name !== "akk") {
+                throw new Error(`host bridge expected command akk, received ${name}`);
+            }
+            if (typeof command.description !== "string") {
+                throw new Error(`host bridge command ${name} has no description`);
+            }
+            if (typeof command.handler !== "function") {
+                throw new Error(`host bridge command ${name} has no handler`);
+            }
+            const handler = command.handler.bind(command);
+            commandDescriptor = Object.freeze({
+                name,
+                description: command.description,
+                acceptsArgs: command.acceptsArgs === true,
+                async execute(args) {
+                    const result = await handler({
+                        ...trustedContext,
+                        args: typeof args === "string" ? args : ""
+                    });
+                    if (!isRecord(result) || typeof result.text !== "string") {
+                        throw new Error(`host bridge command ${name} returned an invalid result`);
+                    }
+                    return {
+                        text: result.text,
+                        ...(result.isError === true ? { isError: true } : {})
+                    };
+                }
+            });
+        },
+        registerTool(tool, registration) {
+            const definition = typeof tool === "function"
+                ? tool(trustedContext)
+                : tool;
+            const name = requiredString(definition.name, "tool name");
+            const registeredName = requiredString(registration?.name, `registration name for ${name}`);
+            if (registeredName !== name) {
+                throw new Error(`host bridge tool registration name ${registeredName} does not match ${name}`);
+            }
+            if (descriptorsByName.has(name)) {
+                throw new Error(`duplicate host bridge tool ${name}`);
+            }
+            if (typeof definition.description !== "string") {
+                throw new Error(`host bridge tool ${name} has no description`);
+            }
+            if (!isRecord(definition.parameters)) {
+                throw new Error(`host bridge tool ${name} has no input schema`);
+            }
+            if (typeof definition.execute !== "function") {
+                throw new Error(`host bridge tool ${name} has no execute function`);
+            }
+            const execute = definition.execute.bind(definition);
+            const descriptor = Object.freeze({
+                name,
+                description: definition.description,
+                inputSchema: definition.parameters,
+                async execute(toolCallId, args) {
+                    const result = await execute(toolCallId, args);
+                    if (!isRecord(result)) {
+                        throw new Error(`host bridge tool ${name} returned an invalid result`);
+                    }
+                    return result;
+                }
+            });
+            descriptors.push(descriptor);
+            descriptorsByName.set(name, descriptor);
+        }
+    };
+    bindOpenClawRelayPath(api, requiredString(options.relayPath, "relayPath"));
+    bindOpenClawRelayEnvironment(api, options.relayEnvironment);
+    bindHostBridgeToolPresentation(api);
+    bindHostBridgeAsyncRelay(api);
+    registerOpenClawCommands(api, new Map());
+    if (!commandDescriptor) {
+        throw new Error("host bridge did not capture the akk command");
+    }
+    if (descriptors.length !== 16) {
+        throw new Error(`host bridge expected 16 semantic tools, received ${descriptors.length}`);
+    }
+    const listed = Object.freeze([...descriptors]);
+    const capturedCommand = commandDescriptor;
+    return Object.freeze({
+        command: () => capturedCommand,
+        list: () => listed,
+        get: (name) => descriptorsByName.get(name),
+        execute: async (name, toolCallId, args) => {
+            const descriptor = descriptorsByName.get(name);
+            if (!descriptor) {
+                throw new Error(`unknown host bridge tool ${name}`);
+            }
+            return descriptor.execute(toolCallId, args);
+        }
+    });
+}
+export function createHostBridgeTools(options) {
+    return createHostBridgeToolRegistry(options).list();
+}
+function requiredString(value, label) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new Error(`${label} is required`);
+    }
+    return value;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=host-bridge-tools.js.map

package/dist/src/host-bridge-tools.js.map

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

package/dist/src/host-bridge.d.ts

@@ -0,0 +1,28 @@
+import type { Readable, Writable } from "node:stream";
+export interface HostBridgeCliOptions extends Record<string, unknown> {
+    profile?: unknown;
+    host?: unknown;
+    hostVersion?: unknown;
+    storeDir?: unknown;
+}
+export interface RunHostBridgeOptions {
+    readonly profile: string;
+    readonly host: string;
+    readonly hostVersion: string;
+    readonly storeDir?: string;
+    readonly lifecycleIntervalMs?: number;
+    readonly environment?: NodeJS.ProcessEnv;
+    readonly cwd?: string;
+    readonly relayPath?: string;
+    readonly stdin?: Readable;
+    readonly stdout?: Writable;
+    readonly stderr?: Writable;
+    readonly signalSource?: Pick<NodeJS.Process, "on" | "off">;
+}
+/** CLI composition boundary; stdout remains exclusively owned by MCP/stdio. */
+export declare function runHostBridgeCli(options: HostBridgeCliOptions): Promise<void>;
+/**
+ * Run one foreground, Host-owned Bridge. It owns no daemon and returns only
+ * after stdio closes or the owning Host sends SIGINT/SIGTERM.
+ */
+export declare function runHostBridge(options: RunHostBridgeOptions): Promise<void>;

package/dist/src/host-bridge.js

@@ -0,0 +1,156 @@
+import fs from "node:fs";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createHostBridgeMcpServer, drainHostBridgeMcpCalls } from "./host-bridge-mcp.js";
+import { createHostBridgeToolRegistry } from "./host-bridge-tools.js";
+import { bindOpenClawRelayEnvironment, bindOpenClawRelayPath } from "./openclaw-plugin-command-adapter.js";
+import { createMonitorReconciliationService } from "./openclaw-plugin-supervisor.js";
+import { assertHostProfileCallbackExecutableReady } from "./host-profile.js";
+import { createTrustedHostProfileRuntime, hostProfileRelayEnvironment } from "./host-profile-runtime.js";
+import { packageRootDir } from "./cli-command-runtime.js";
+import { cliCwd, cliEnv } from "./cli-runtime-context.js";
+/** CLI composition boundary; stdout remains exclusively owned by MCP/stdio. */
+export async function runHostBridgeCli(options) {
+    await runHostBridge({
+        profile: requiredString(options.profile, "--profile"),
+        host: requiredString(options.host, "--host"),
+        hostVersion: requiredString(options.hostVersion, "--host-version"),
+        storeDir: optionalString(options.storeDir, "--store-dir"),
+        environment: cliEnv(),
+        cwd: cliCwd()
+    });
+}
+/**
+ * Run one foreground, Host-owned Bridge. It owns no daemon and returns only
+ * after stdio closes or the owning Host sends SIGINT/SIGTERM.
+ */
+export async function runHostBridge(options) {
+    const environment = { ...(options.environment ?? process.env) };
+    const cwd = options.cwd ?? process.cwd();
+    const runtime = createTrustedHostProfileRuntime({
+        selection: options.profile,
+        host: options.host,
+        hostVersion: options.hostVersion,
+        environment,
+        cwd
+    });
+    if (runtime.controllerScope === "route_bound_v1") {
+        throw new Error("Host Profile controllerContext.scope route_bound_v1 is not supported " +
+            "by the standalone Host Bridge; use the Host-native connector");
+    }
+    assertHostProfileCallbackExecutableReady(runtime.selected.profile.callback.executable, runtime.selected.profile.callback.environment.allow);
+    const relayPath = options.relayPath ?? fileURLToPath(new URL("./cli.js", import.meta.url));
+    const relayEnvironment = hostProfileRelayEnvironment(runtime, environment);
+    const pluginConfig = Object.freeze({
+        ...(options.storeDir ? { storeDir: options.storeDir } : {})
+    });
+    const stderr = options.stderr ?? process.stderr;
+    const logger = bridgeLogger(stderr);
+    const tools = createHostBridgeToolRegistry({
+        relayPath,
+        relayEnvironment,
+        pluginConfig,
+        logger,
+        context: {
+            sessionKey: runtime.controllerSessionId,
+            sessionId: runtime.controllerSessionId
+        }
+    });
+    const lifecycleApi = { pluginConfig, logger };
+    bindOpenClawRelayPath(lifecycleApi, relayPath);
+    bindOpenClawRelayEnvironment(lifecycleApi, relayEnvironment);
+    const lifecycle = createMonitorReconciliationService(lifecycleApi, options.lifecycleIntervalMs ?? 5_000);
+    const server = createHostBridgeMcpServer({
+        registry: tools,
+        version: packageVersion()
+    });
+    const input = options.stdin ?? process.stdin;
+    const output = options.stdout ?? process.stdout;
+    const transport = new StdioServerTransport(input, output);
+    const signals = options.signalSource ?? process;
+    let resolveClosed;
+    const closed = new Promise((resolve) => {
+        resolveClosed = resolve;
+    });
+    let shutdownPromise;
+    const shutdown = () => shutdownPromise ??= (async () => {
+        await settle("MCP transport close", () => server.close(), logger);
+        await settle("Host lifecycle drain", () => lifecycle.stop(), logger);
+        await settle("MCP tool drain", () => drainHostBridgeMcpCalls(server), logger);
+        resolveClosed();
+    })();
+    const onInputEnd = () => {
+        void shutdown();
+    };
+    const onInputError = (error) => {
+        logger.warn(`agent-knock-knock Host Bridge input error: ${error.message}`);
+        void shutdown();
+    };
+    const onSignal = () => {
+        void shutdown();
+    };
+    input.once("end", onInputEnd);
+    input.once("close", onInputEnd);
+    input.once("error", onInputError);
+    signals.on("SIGINT", onSignal);
+    signals.on("SIGTERM", onSignal);
+    try {
+        await server.connect(transport);
+        lifecycle.start();
+        if (input.readableEnded === true) {
+            await shutdown();
+        }
+        await closed;
+    }
+    finally {
+        input.off("end", onInputEnd);
+        input.off("close", onInputEnd);
+        input.off("error", onInputError);
+        signals.off("SIGINT", onSignal);
+        signals.off("SIGTERM", onSignal);
+        await shutdown();
+    }
+}
+function bridgeLogger(stderr) {
+    const write = (level, message) => {
+        const line = String(message)
+            .replace(/[\u0000-\u001f\u007f]+/gu, " ")
+            .replace(/\s+/gu, " ")
+            .trim()
+            .slice(0, 4_096);
+        stderr.write(`[agent-knock-knock:${level}] ${line}\n`);
+    };
+    return Object.freeze({
+        info: (message) => write("info", message),
+        warn: (message) => write("warn", message),
+        error: (message) => write("error", message)
+    });
+}
+async function settle(label, operation, logger) {
+    try {
+        await operation();
+    }
+    catch (error) {
+        logger.warn(`${label} failed: ${errorMessage(error)}`);
+    }
+}
+function packageVersion() {
+    const packageJson = JSON.parse(fs.readFileSync(`${packageRootDir()}/package.json`, "utf8"));
+    return requiredString(packageJson.version, "package version");
+}
+function optionalString(value, label) {
+    if (value === undefined)
+        return undefined;
+    return requiredString(value, label);
+}
+function requiredString(value, label) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new Error(`${label} is required`);
+    }
+    return value;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=host-bridge.js.map

package/dist/src/host-bridge.js.map

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

package/dist/src/host-lifecycle-service.d.ts

@@ -0,0 +1,39 @@
+export declare const HOST_LIFECYCLE_INTERVAL_MS = 5000;
+export type HostLifecycleSweepReason = "startup" | "periodic";
+export interface HostLifecyclePhaseContext {
+    reason: HostLifecycleSweepReason;
+}
+export interface HostLifecyclePhase {
+    name: string;
+    run(context: HostLifecyclePhaseContext): Promise<void> | void;
+}
+export interface HostLifecyclePhaseError {
+    phase: string;
+    reason: HostLifecycleSweepReason;
+    error: unknown;
+}
+/**
+ * Schedule one deferred callback and return a function that cancels it.
+ *
+ * A host may use this seam to choose whether the underlying timer is ref'ed or
+ * unref'ed. The default scheduler uses a normal ref'ed Node.js timer.
+ */
+export type HostLifecycleSchedule = (callback: () => void, delayMs: number) => () => void;
+export interface HostLifecycleServiceOptions {
+    intervalMs?: number;
+    phases: readonly HostLifecyclePhase[];
+    onPhaseError(error: HostLifecyclePhaseError): void;
+    schedule?: HostLifecycleSchedule;
+}
+export interface HostLifecycleService {
+    start(): void;
+    stop(): Promise<void>;
+}
+/**
+ * Run host-owned AKK reconciliation for as long as the embedding host is live.
+ *
+ * The service owns no process, Store, callback transport, or host configuration.
+ * Its phases are compile-time injected by the host adapter and run sequentially
+ * with independent error boundaries.
+ */
+export declare function createHostLifecycleService(options: HostLifecycleServiceOptions): HostLifecycleService;

package/dist/src/host-lifecycle-service.js

@@ -0,0 +1,101 @@
+export const HOST_LIFECYCLE_INTERVAL_MS = 5_000;
+const defaultSchedule = (callback, delayMs) => {
+    const timer = setTimeout(callback, delayMs);
+    return () => clearTimeout(timer);
+};
+function normalizedIntervalMs(configuredIntervalMs) {
+    return Number.isFinite(configuredIntervalMs) && Number(configuredIntervalMs) > 0
+        ? Math.max(50, Math.ceil(Number(configuredIntervalMs)))
+        : HOST_LIFECYCLE_INTERVAL_MS;
+}
+/**
+ * Run host-owned AKK reconciliation for as long as the embedding host is live.
+ *
+ * The service owns no process, Store, callback transport, or host configuration.
+ * Its phases are compile-time injected by the host adapter and run sequentially
+ * with independent error boundaries.
+ */
+export function createHostLifecycleService(options) {
+    const intervalMs = normalizedIntervalMs(options.intervalMs);
+    const scheduleAfter = options.schedule ?? defaultSchedule;
+    let state = "idle";
+    let cancelScheduled;
+    let inFlight;
+    let stopDrain;
+    const runSweep = async (reason) => {
+        for (const phase of options.phases) {
+            try {
+                await phase.run({ reason });
+            }
+            catch (error) {
+                try {
+                    options.onPhaseError({
+                        phase: phase.name,
+                        reason,
+                        error
+                    });
+                }
+                catch {
+                    // A host logger/reporting failure must not suppress later phases.
+                }
+            }
+        }
+    };
+    const beginSweep = (reason, after) => {
+        let settle;
+        let reject;
+        const execution = new Promise((resolve, rejectPromise) => {
+            settle = resolve;
+            reject = rejectPromise;
+        });
+        const sweep = execution.finally(() => {
+            if (inFlight === sweep) {
+                inFlight = undefined;
+            }
+            after();
+        });
+        // Register before invoking phase code. A phase may synchronously request
+        // Host shutdown; stop() must observe and drain the complete sweep while
+        // phase startup retains its pre-extraction synchronous ordering.
+        inFlight = sweep;
+        void runSweep(reason).then(settle, reject);
+    };
+    const scheduleNext = () => {
+        if (state !== "running") {
+            return;
+        }
+        cancelScheduled = scheduleAfter(() => {
+            cancelScheduled = undefined;
+            beginSweep("periodic", scheduleNext);
+        }, intervalMs);
+    };
+    return {
+        start() {
+            if (state !== "idle") {
+                return;
+            }
+            state = "running";
+            beginSweep("startup", scheduleNext);
+        },
+        async stop() {
+            if (state === "idle") {
+                return;
+            }
+            if (state === "stopping") {
+                await stopDrain;
+                return;
+            }
+            state = "stopping";
+            cancelScheduled?.();
+            cancelScheduled = undefined;
+            const activeSweep = inFlight;
+            stopDrain = (async () => {
+                await activeSweep;
+                state = "idle";
+                stopDrain = undefined;
+            })();
+            await stopDrain;
+        }
+    };
+}
+//# sourceMappingURL=host-lifecycle-service.js.map

package/dist/src/host-lifecycle-service.js.map

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

package/dist/src/host-profile-callback-transport.d.ts

@@ -0,0 +1,14 @@
+import type { CallbackTransport } from "./callback-transport.js";
+import { type SelectHostProfileOptions } from "./host-profile-runtime.js";
+export declare const HOST_PROFILE_CALLBACK_ROUTER_KIND = "host_profile_callback_router_v1";
+export interface CreateHostProfileCallbackTransportOptions extends SelectHostProfileOptions {
+    readonly legacyTransport: CallbackTransport;
+    readonly environment: () => NodeJS.ProcessEnv;
+    readonly now?: () => Date;
+}
+/**
+ * Route legacy OpenClaw callbacks exactly as before and resolve declarative
+ * callbacks only through the private Bridge runtime environment. The Store
+ * persists route identity, never executable or credential configuration.
+ */
+export declare function createHostProfileCallbackTransport(options: CreateHostProfileCallbackTransportOptions): CallbackTransport;

package/dist/src/host-profile-callback-transport.js

@@ -0,0 +1,70 @@
+import { COMMAND_JSON_CALLBACK_TRANSPORT_KIND, createCommandJsonCallbackTransport } from "./command-json-callback-transport.js";
+import { trustedHostProfileRuntimeFromEnvironment } from "./host-profile-runtime.js";
+export const HOST_PROFILE_CALLBACK_ROUTER_KIND = "host_profile_callback_router_v1";
+/**
+ * Route legacy OpenClaw callbacks exactly as before and resolve declarative
+ * callbacks only through the private Bridge runtime environment. The Store
+ * persists route identity, never executable or credential configuration.
+ */
+export function createHostProfileCallbackTransport(options) {
+    return Object.freeze({
+        kind: HOST_PROFILE_CALLBACK_ROUTER_KIND,
+        deliver(input) {
+            if (input.route.transport === options.legacyTransport.kind) {
+                return options.legacyTransport.deliver(input);
+            }
+            if (input.route.transport !== COMMAND_JSON_CALLBACK_TRANSPORT_KIND) {
+                return permanentFailure("unsupported_callback_transport");
+            }
+            let runtime;
+            try {
+                runtime = trustedHostProfileRuntimeFromEnvironment(options.environment(), { cwd: options.cwd, registry: options.registry });
+            }
+            catch {
+                return permanentFailure("host_profile_runtime_invalid");
+            }
+            if (!runtime) {
+                return permanentFailure("host_profile_runtime_missing");
+            }
+            if (runtime.callbackRoute.transport !== input.route.transport ||
+                runtime.callbackRoute.profile_id !== input.route.profile_id ||
+                runtime.callbackRoute.profile_revision !== input.route.profile_revision ||
+                (runtime.controllerScope === "startup_v1" &&
+                    runtime.callbackRoute.controller_session_id !==
+                        input.route.controller_session_id)) {
+                return permanentFailure("host_profile_callback_route_mismatch");
+            }
+            let transport;
+            try {
+                transport = createCommandJsonCallbackTransport({
+                    profile: runtime.selected.profile,
+                    controllerSessionId: runtime.controllerScope === "route_bound_v1"
+                        ? input.route.controller_session_id
+                        : runtime.controllerSessionId,
+                    environment: options.environment,
+                    now: options.now
+                });
+            }
+            catch {
+                return permanentFailure("host_profile_callback_transport_invalid");
+            }
+            try {
+                return transport.deliver(input);
+            }
+            catch {
+                return {
+                    disposition: "uncertain",
+                    error_code: "host_profile_callback_transport_threw",
+                    observed_at: (options.now?.() ?? new Date()).toISOString()
+                };
+            }
+        }
+    });
+}
+function permanentFailure(errorCode) {
+    return {
+        disposition: "permanent_failure",
+        error_code: errorCode
+    };
+}
+//# sourceMappingURL=host-profile-callback-transport.js.map

package/dist/src/host-profile-callback-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-profile-callback-transport.js","sourceRoot":"","sources":["../../src/host-profile-callback-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oCAAoC,EACpC,kCAAkC,EACnC,MAAM,sCAAsC,CAAC;AAM9C,OAAO,EACL,wCAAwC,EAEzC,MAAM,2BAA2B,CAAC;AAEnC,MAAM,CAAC,MAAM,iCAAiC,GAC5C,iCAAiC,CAAC;AASpC;;;;GAIG;AACH,MAAM,UAAU,kCAAkC,CAChD,OAAkD;IAElD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,iCAAiC;QACvC,OAAO,CAAC,KAAoC;YAC1C,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,KAAK,OAAO,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;gBAC3D,OAAO,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAChD,CAAC;YACD,IAAI,KAAK,CAAC,KAAK,CAAC,SAAS,KAAK,oCAAoC,EAAE,CAAC;gBACnE,OAAO,gBAAgB,CAAC,gCAAgC,CAAC,CAAC;YAC5D,CAAC;YAED,IAAI,OAAO,CAAC;YACZ,IAAI,CAAC;gBACH,OAAO,GAAG,wCAAwC,CAChD,OAAO,CAAC,WAAW,EAAE,EACrB,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CACjD,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,gBAAgB,CAAC,8BAA8B,CAAC,CAAC;YAC1D,CAAC;YACD,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,gBAAgB,CAAC,8BAA8B,CAAC,CAAC;YAC1D,CAAC;YACD,IACE,OAAO,CAAC,aAAa,CAAC,SAAS,KAAK,KAAK,CAAC,KAAK,CAAC,SAAS;gBACzD,OAAO,CAAC,aAAa,CAAC,UAAU,KAAK,KAAK,CAAC,KAAK,CAAC,UAAU;gBAC3D,OAAO,CAAC,aAAa,CAAC,gBAAgB,KAAK,KAAK,CAAC,KAAK,CAAC,gBAAgB;gBACvE,CACE,OAAO,CAAC,eAAe,KAAK,YAAY;oBACxC,OAAO,CAAC,aAAa,CAAC,qBAAqB;wBACzC,KAAK,CAAC,KAAK,CAAC,qBAAqB,CACpC,EACD,CAAC;gBACD,OAAO,gBAAgB,CAAC,sCAAsC,CAAC,CAAC;YAClE,CAAC;YAED,IAAI,SAAS,CAAC;YACd,IAAI,CAAC;gBACH,SAAS,GAAG,kCAAkC,CAAC;oBAC7C,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO;oBACjC,mBAAmB,EACjB,OAAO,CAAC,eAAe,KAAK,gBAAgB;wBAC1C,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,qBAAqB;wBACnC,CAAC,CAAC,OAAO,CAAC,mBAAmB;oBACjC,WAAW,EAAE,OAAO,CAAC,WAAW;oBAChC,GAAG,EAAE,OAAO,CAAC,GAAG;iBACjB,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,gBAAgB,CAAC,yCAAyC,CAAC,CAAC;YACrE,CAAC;YACD,IAAI,CAAC;gBACH,OAAO,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAClC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;oBACL,WAAW,EAAE,WAAW;oBACxB,UAAU,EAAE,uCAAuC;oBACnD,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE;iBAC3D,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,SAAiB;IACzC,OAAO;QACL,WAAW,EAAE,mBAAmB;QAChC,UAAU,EAAE,SAAS;KACtB,CAAC;AACJ,CAAC"}