/**

* Channel setup wizard helper functions.

*

* Prompts account ids, credentials, allowlists, and account-scoped setup config updates.

*/

import { normalizeOptionalString } from "@openclaw/normalization-core/string-coerce";

import {

normalizeStringEntries,

/**

* Lazy setup wizard proxy helpers.

*

* Delegates setup wizard status, credential, allowlist, and finalization hooks to loaded wizards.

*/

import type { OpenClawConfig } from "../../config/types.openclaw.js";

import { createDelegatedSetupWizardStatusResolvers } from "./setup-wizard-binary.js";

import type { ChannelSetupDmPolicy } from "./setup-wizard-types.js";

/**

* Declarative channel setup wizard contract.

*

* Defines status, credentials, prompts, group access, and finalization types for setup flows.

*/

import type { DmPolicy } from "../../config/types.js";

import type { OpenClawConfig } from "../../config/types.openclaw.js";

import type { RuntimeEnv } from "../../runtime.js";

ChannelSetupInput,

} from "./types.core.js";

// Public setup wizard contract shared by bundled channel plugins and setup

// orchestration. Keep these types declarative; runtime behavior lives in

// setup-wizard.ts.

export type ChannelSetupPlugin = {

id: ChannelId;

meta: ChannelMeta;

/**

* Channel setup wizard adapter.

*

* Adapts declarative wizard definitions into imperative setup adapters used by onboarding.

*/

import { normalizeOptionalString } from "@openclaw/normalization-core/string-coerce";

import type { OpenClawConfig } from "../../config/types.openclaw.js";

import { DEFAULT_ACCOUNT_ID } from "../../routing/session-key.js";

} from "./setup-wizard-types.js";

import type { ChannelSetupInput } from "./types.core.js";

// Adapts declarative channel setup wizard definitions into the imperative

// setup adapter used by onboarding and channel configuration flows.

export type {

ChannelSetupWizard,

ChannelSetupWizardAllowFrom,

/**

* Built-in stateful binding target registration.

*

* Lazily registers ACP target drivers so non-ACP channel flows avoid ACP runtime imports.

*/

import { registerStatefulBindingTargetDriver } from "./stateful-target-drivers.js";

// Lazily registers built-in stateful binding target drivers. Keep imports

// dynamic so non-ACP channel flows do not load the ACP runtime boundary.

type AcpStatefulTargetDriverModule = typeof import("./acp-stateful-target-driver.js");

let builtinsRegisteredPromise: Promise<void> | null = null;

/**

* Stateful binding target driver registry.

*

* Stores lifecycle drivers for binding targets that carry mutable external session state.

*/

import type { OpenClawConfig } from "../../config/types.openclaw.js";

import type {

ConfiguredBindingResolution,

StatefulBindingTargetDescriptor,

} from "./binding-types.js";

// Registry for binding targets that carry external mutable session state, such

// as ACP-backed channels that need per-session reset and lookup behavior.

export type StatefulBindingTargetReadyResult = { ok: true } | { ok: false; error: string };

export type StatefulBindingTargetSessionResult =

| { ok: true; sessionKey: string }

/**

* Channel status issue helper utilities.

*

* Formats status metadata and finds enabled/configured account ids for diagnostics.

*/

import { normalizeOptionalString } from "@openclaw/normalization-core/string-coerce";

import { isRecord } from "../../../utils.js";

import type { ChannelAccountSnapshot, ChannelStatusIssue } from "../types.public.js";

export { isRecord };

/**

* Shared helpers for channel status issue collectors.

*/

/**

* Normalizes optional string metadata in status issue helpers.

*/

/**

* Channel status snapshot builders.

*

* Combines plugin status hooks, account inspection, and safe account field projection.

*/

import { normalizeOptionalString } from "@openclaw/normalization-core/string-coerce";

import type { OpenClawConfig } from "../../config/types.openclaw.js";

import { inspectChannelAccount } from "../account-inspection.js";

import { projectSafeChannelAccountSnapshotFields } from "../account-snapshot-fields.js";

import type { ChannelPlugin } from "./types.plugin.js";

import type { ChannelAccountSnapshot } from "./types.public.js";

// Channel docking: status snapshots flow through plugin.status hooks here.

export async function buildChannelAccountSnapshotFromAccount<ResolvedAccount>(params: {

plugin: ChannelPlugin<ResolvedAccount>;

cfg: OpenClawConfig;

/**

* Loaded-channel target parsing helpers.

*

* Bridges deprecated explicit target parsing with modern channel route target helpers.

*/

import {

normalizeLowercaseStringOrEmpty,

normalizeOptionalString,

import type { ChannelResolveResult } from "./types.adapters.js";

/**

* Shared helpers for channel target resolution flows.

* Channel target resolver helpers.

*

* Builds unresolved rows and token-gated resolution flows for setup/allowlist targets.

*/

import type { ChannelResolveResult } from "./types.adapters.js";

/**

* Builds unresolved target results with one common note.