import {

isSubagentSessionKey,

normalizeAgentId,

normalizeOptionalAgentId,

parseAgentSessionKey,

resolveAgentIdFromSessionKey,

} from "../routing/session-key.js";

return Array.from(ids);

}

function normalizeOptionalAgentId(value: string | undefined | null): string | undefined {

const trimmed = normalizeOptionalString(value) ?? "";

if (!trimmed) {

return undefined;

}

return normalizeAgentId(trimmed);

}

function summarizeError(err: unknown): string {

return formatErrorMessage(err);

}

// Doctor scanner and repair for subagent allowlists that reference missing agents.

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

import { listAgentIds } from "../../../agents/agent-scope-config.js";

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

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

import { normalizeAgentId, normalizeOptionalAgentId } from "../../../routing/session-key.js";

export type StaleSubagentAllowlistHit = {

/** Config path containing the stale allowAgents entry. */

normalizedAgentId: string;

};

function normalizeOptionalAgentId(value: string | undefined | null): string | undefined {

const trimmed = normalizeOptionalString(value) ?? "";

if (!trimmed) {

return undefined;

}

return normalizeAgentId(trimmed);

}

function collectConfiguredSubagentTargetIds(cfg: OpenClawConfig): Set<string> {

const ids = new Set<string>(listAgentIds(cfg));

for (const agent of cfg.agents?.list ?? []) {

/** Name, agent id, and payload text normalization helpers for cron service ops. */

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

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

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

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

import type { CronPayload } from "../types.js";

}

/** Normalizes optional cron agent ids through the canonical session-key agent id rules. */

export function normalizeOptionalAgentId(raw: unknown) {

const trimmed = normalizeOptionalString(raw);

if (!trimmed) {

return undefined;

}

return normalizeAgentId(trimmed);

}

export { normalizeOptionalAgentId };

/** Infers a compact cron job name from payload text first, then schedule shape. */

export function inferCronJobName(job: {

// Routing session key helpers build stable session keys from route targets.

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

import {

normalizeLowercaseStringOrEmpty,

normalizeOptionalString,

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

import type { ChatType } from "../channels/chat-type.js";

import {

isCronRunSessionKey,

);

}

export function normalizeOptionalAgentId(value: unknown): string | undefined {

const trimmed = normalizeOptionalString(value);

return trimmed ? normalizeAgentId(trimmed) : undefined;

}

export function isValidAgentId(value: string | undefined | null): boolean {

const trimmed = (value ?? "").trim();

return Boolean(trimmed) && VALID_ID_RE.test(trimmed);