openclaw-multi-auto 1.3.7 → 1.3.9

package/ui/src/ui/views/agents-utils.ts

@@ -0,0 +1,502 @@
+import { html } from "lit";
+import {
+  listCoreToolSections,
+  PROFILE_OPTIONS as TOOL_PROFILE_OPTIONS,
+} from "../../../../src/agents/tool-catalog.js";
+import {
+  expandToolGroups,
+  normalizeToolName,
+  resolveToolProfilePolicy,
+} from "../../../../src/agents/tool-policy-shared.js";
+import type { AgentIdentityResult, AgentsFilesListResult, AgentsListResult } from "../types.ts";
+
+export const TOOL_SECTIONS = listCoreToolSections();
+
+export const PROFILE_OPTIONS = TOOL_PROFILE_OPTIONS;
+
+type ToolPolicy = {
+  allow?: string[];
+  deny?: string[];
+};
+
+type AgentConfigEntry = {
+  id: string;
+  name?: string;
+  workspace?: string;
+  agentDir?: string;
+  model?: unknown;
+  skills?: string[];
+  tools?: {
+    profile?: string;
+    allow?: string[];
+    alsoAllow?: string[];
+    deny?: string[];
+  };
+};
+
+type ConfigSnapshot = {
+  agents?: {
+    defaults?: { workspace?: string; model?: unknown; models?: Record<string, { alias?: string }> };
+    list?: AgentConfigEntry[];
+  };
+  tools?: {
+    profile?: string;
+    allow?: string[];
+    alsoAllow?: string[];
+    deny?: string[];
+  };
+};
+
+export function normalizeAgentLabel(agent: {
+  id: string;
+  name?: string;
+  identity?: { name?: string };
+}) {
+  return agent.name?.trim() || agent.identity?.name?.trim() || agent.id;
+}
+
+function isLikelyEmoji(value: string) {
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return false;
+  }
+  if (trimmed.length > 16) {
+    return false;
+  }
+  let hasNonAscii = false;
+  for (let i = 0; i < trimmed.length; i += 1) {
+    if (trimmed.charCodeAt(i) > 127) {
+      hasNonAscii = true;
+      break;
+    }
+  }
+  if (!hasNonAscii) {
+    return false;
+  }
+  if (trimmed.includes("://") || trimmed.includes("/") || trimmed.includes(".")) {
+    return false;
+  }
+  return true;
+}
+
+export function resolveAgentEmoji(
+  agent: { identity?: { emoji?: string; avatar?: string } },
+  agentIdentity?: AgentIdentityResult | null,
+) {
+  const identityEmoji = agentIdentity?.emoji?.trim();
+  if (identityEmoji && isLikelyEmoji(identityEmoji)) {
+    return identityEmoji;
+  }
+  const agentEmoji = agent.identity?.emoji?.trim();
+  if (agentEmoji && isLikelyEmoji(agentEmoji)) {
+    return agentEmoji;
+  }
+  const identityAvatar = agentIdentity?.avatar?.trim();
+  if (identityAvatar && isLikelyEmoji(identityAvatar)) {
+    return identityAvatar;
+  }
+  const avatar = agent.identity?.avatar?.trim();
+  if (avatar && isLikelyEmoji(avatar)) {
+    return avatar;
+  }
+  return "";
+}
+
+export function agentBadgeText(agentId: string, defaultId: string | null) {
+  return defaultId && agentId === defaultId ? "default" : null;
+}
+
+export function formatBytes(bytes?: number) {
+  if (bytes == null || !Number.isFinite(bytes)) {
+    return "-";
+  }
+  if (bytes < 1024) {
+    return `${bytes} B`;
+  }
+  const units = ["KB", "MB", "GB", "TB"];
+  let size = bytes / 1024;
+  let unitIndex = 0;
+  while (size >= 1024 && unitIndex < units.length - 1) {
+    size /= 1024;
+    unitIndex += 1;
+  }
+  return `${size.toFixed(size < 10 ? 1 : 0)} ${units[unitIndex]}`;
+}
+
+export function resolveAgentConfig(config: Record<string, unknown> | null, agentId: string) {
+  const cfg = config as ConfigSnapshot | null;
+  const list = cfg?.agents?.list ?? [];
+  const entry = list.find((agent) => agent?.id === agentId);
+  return {
+    entry,
+    defaults: cfg?.agents?.defaults,
+    globalTools: cfg?.tools,
+  };
+}
+
+export type AgentContext = {
+  workspace: string;
+  model: string;
+  identityName: string;
+  identityEmoji: string;
+  skillsLabel: string;
+  isDefault: boolean;
+};
+
+export function buildAgentContext(
+  agent: AgentsListResult["agents"][number],
+  configForm: Record<string, unknown> | null,
+  agentFilesList: AgentsFilesListResult | null,
+  defaultId: string | null,
+  agentIdentity?: AgentIdentityResult | null,
+): AgentContext {
+  const config = resolveAgentConfig(configForm, agent.id);
+  const workspaceFromFiles =
+    agentFilesList && agentFilesList.agentId === agent.id ? agentFilesList.workspace : null;
+  const workspace =
+    workspaceFromFiles || config.entry?.workspace || config.defaults?.workspace || "default";
+  const modelLabel = config.entry?.model
+    ? resolveModelLabel(config.entry?.model)
+    : resolveModelLabel(config.defaults?.model);
+  const identityName =
+    agentIdentity?.name?.trim() ||
+    agent.identity?.name?.trim() ||
+    agent.name?.trim() ||
+    config.entry?.name ||
+    agent.id;
+  const identityEmoji = resolveAgentEmoji(agent, agentIdentity) || "-";
+  const skillFilter = Array.isArray(config.entry?.skills) ? config.entry?.skills : null;
+  const skillCount = skillFilter?.length ?? null;
+  return {
+    workspace,
+    model: modelLabel,
+    identityName,
+    identityEmoji,
+    skillsLabel: skillFilter ? `${skillCount} selected` : "all skills",
+    isDefault: Boolean(defaultId && agent.id === defaultId),
+  };
+}
+
+export function resolveModelLabel(model?: unknown): string {
+  if (!model) {
+    return "-";
+  }
+  if (typeof model === "string") {
+    return model.trim() || "-";
+  }
+  if (typeof model === "object" && model) {
+    const record = model as { primary?: string; fallbacks?: string[] };
+    const primary = record.primary?.trim();
+    if (primary) {
+      const fallbackCount = Array.isArray(record.fallbacks) ? record.fallbacks.length : 0;
+      return fallbackCount > 0 ? `${primary} (+${fallbackCount} fallback)` : primary;
+    }
+  }
+  return "-";
+}
+
+export function normalizeModelValue(label: string): string {
+  const match = label.match(/^(.+) \(\+\d+ fallback\)$/);
+  return match ? match[1] : label;
+}
+
+export function resolveModelPrimary(model?: unknown): string | null {
+  if (!model) {
+    return null;
+  }
+  if (typeof model === "string") {
+    const trimmed = model.trim();
+    return trimmed || null;
+  }
+  if (typeof model === "object" && model) {
+    const record = model as Record<string, unknown>;
+    const candidate =
+      typeof record.primary === "string"
+        ? record.primary
+        : typeof record.model === "string"
+          ? record.model
+          : typeof record.id === "string"
+            ? record.id
+            : typeof record.value === "string"
+              ? record.value
+              : null;
+    const primary = candidate?.trim();
+    return primary || null;
+  }
+  return null;
+}
+
+export function resolveModelFallbacks(model?: unknown): string[] | null {
+  if (!model || typeof model === "string") {
+    return null;
+  }
+  if (typeof model === "object" && model) {
+    const record = model as Record<string, unknown>;
+    const fallbacks = Array.isArray(record.fallbacks)
+      ? record.fallbacks
+      : Array.isArray(record.fallback)
+        ? record.fallback
+        : null;
+    return fallbacks
+      ? fallbacks.filter((entry): entry is string => typeof entry === "string")
+      : null;
+  }
+  return null;
+}
+
+export function resolveEffectiveModelFallbacks(
+  entryModel?: unknown,
+  defaultModel?: unknown,
+): string[] | null {
+  return resolveModelFallbacks(entryModel) ?? resolveModelFallbacks(defaultModel);
+}
+
+function addModelId(target: Set<string>, value: unknown) {
+  if (typeof value !== "string") {
+    return;
+  }
+  const trimmed = value.trim();
+  if (!trimmed) {
+    return;
+  }
+  target.add(trimmed);
+}
+
+function addModelConfigIds(target: Set<string>, modelConfig: unknown) {
+  if (!modelConfig) {
+    return;
+  }
+  if (typeof modelConfig === "string") {
+    addModelId(target, modelConfig);
+    return;
+  }
+  if (typeof modelConfig !== "object") {
+    return;
+  }
+  const record = modelConfig as Record<string, unknown>;
+  addModelId(target, record.primary);
+  addModelId(target, record.model);
+  addModelId(target, record.id);
+  addModelId(target, record.value);
+  const fallbacks = Array.isArray(record.fallbacks)
+    ? record.fallbacks
+    : Array.isArray(record.fallback)
+      ? record.fallback
+      : [];
+  for (const fallback of fallbacks) {
+    addModelId(target, fallback);
+  }
+}
+
+export function sortLocaleStrings(values: Iterable<string>): string[] {
+  const sorted = Array.from(values);
+  const buffer = Array.from({ length: sorted.length }, () => "");
+
+  const merge = (left: number, middle: number, right: number): void => {
+    let i = left;
+    let j = middle;
+    let k = left;
+    while (i < middle && j < right) {
+      buffer[k++] = sorted[i].localeCompare(sorted[j]) <= 0 ? sorted[i++] : sorted[j++];
+    }
+    while (i < middle) {
+      buffer[k++] = sorted[i++];
+    }
+    while (j < right) {
+      buffer[k++] = sorted[j++];
+    }
+    for (let idx = left; idx < right; idx += 1) {
+      sorted[idx] = buffer[idx];
+    }
+  };
+
+  const sortRange = (left: number, right: number): void => {
+    if (right - left <= 1) {
+      return;
+    }
+
+    const middle = (left + right) >>> 1;
+    sortRange(left, middle);
+    sortRange(middle, right);
+    merge(left, middle, right);
+  };
+
+  sortRange(0, sorted.length);
+  return sorted;
+}
+
+export function resolveConfiguredCronModelSuggestions(
+  configForm: Record<string, unknown> | null,
+): string[] {
+  if (!configForm || typeof configForm !== "object") {
+    return [];
+  }
+  const agents = (configForm as { agents?: unknown }).agents;
+  if (!agents || typeof agents !== "object") {
+    return [];
+  }
+  const out = new Set<string>();
+  const defaults = (agents as { defaults?: unknown }).defaults;
+  if (defaults && typeof defaults === "object") {
+    const defaultsRecord = defaults as Record<string, unknown>;
+    addModelConfigIds(out, defaultsRecord.model);
+    const defaultsModels = defaultsRecord.models;
+    if (defaultsModels && typeof defaultsModels === "object") {
+      for (const modelId of Object.keys(defaultsModels as Record<string, unknown>)) {
+        addModelId(out, modelId);
+      }
+    }
+  }
+  const list = (agents as { list?: unknown }).list;
+  if (list && typeof list === "object") {
+    for (const entry of Object.values(list as Record<string, unknown>)) {
+      if (!entry || typeof entry !== "object") {
+        continue;
+      }
+      addModelConfigIds(out, (entry as Record<string, unknown>).model);
+    }
+  }
+  return sortLocaleStrings(out);
+}
+
+export function parseFallbackList(value: string): string[] {
+  return value
+    .split(",")
+    .map((entry) => entry.trim())
+    .filter(Boolean);
+}
+
+type ConfiguredModelOption = {
+  value: string;
+  label: string;
+};
+
+function resolveConfiguredModels(
+  configForm: Record<string, unknown> | null,
+): ConfiguredModelOption[] {
+  const cfg = configForm as ConfigSnapshot | null;
+  const models = cfg?.agents?.defaults?.models;
+  if (!models || typeof models !== "object") {
+    return [];
+  }
+  const options: ConfiguredModelOption[] = [];
+  for (const [modelId, modelRaw] of Object.entries(models)) {
+    const trimmed = modelId.trim();
+    if (!trimmed) {
+      continue;
+    }
+    const alias =
+      modelRaw && typeof modelRaw === "object" && "alias" in modelRaw
+        ? typeof (modelRaw as { alias?: unknown }).alias === "string"
+          ? (modelRaw as { alias?: string }).alias?.trim()
+          : undefined
+        : undefined;
+    const label = alias && alias !== trimmed ? `${alias} (${trimmed})` : trimmed;
+    options.push({ value: trimmed, label });
+  }
+  return options;
+}
+
+export function buildModelOptions(
+  configForm: Record<string, unknown> | null,
+  current?: string | null,
+) {
+  const options = resolveConfiguredModels(configForm);
+  const hasCurrent = current ? options.some((option) => option.value === current) : false;
+  if (current && !hasCurrent) {
+    options.unshift({ value: current, label: `Current (${current})` });
+  }
+  if (options.length === 0) {
+    return html`
+      <option value="" disabled>No configured models</option>
+    `;
+  }
+  return options.map((option) => html`<option value=${option.value}>${option.label}</option>`);
+}
+
+type CompiledPattern =
+  | { kind: "all" }
+  | { kind: "exact"; value: string }
+  | { kind: "regex"; value: RegExp };
+
+function compilePattern(pattern: string): CompiledPattern {
+  const normalized = normalizeToolName(pattern);
+  if (!normalized) {
+    return { kind: "exact", value: "" };
+  }
+  if (normalized === "*") {
+    return { kind: "all" };
+  }
+  if (!normalized.includes("*")) {
+    return { kind: "exact", value: normalized };
+  }
+  const escaped = normalized.replace(/[.*+?^${}()|[\\]\\]/g, "\\$&");
+  return { kind: "regex", value: new RegExp(`^${escaped.replaceAll("\\*", ".*")}$`) };
+}
+
+function compilePatterns(patterns?: string[]): CompiledPattern[] {
+  if (!Array.isArray(patterns)) {
+    return [];
+  }
+  return expandToolGroups(patterns)
+    .map(compilePattern)
+    .filter((pattern) => {
+      return pattern.kind !== "exact" || pattern.value.length > 0;
+    });
+}
+
+function matchesAny(name: string, patterns: CompiledPattern[]) {
+  for (const pattern of patterns) {
+    if (pattern.kind === "all") {
+      return true;
+    }
+    if (pattern.kind === "exact" && name === pattern.value) {
+      return true;
+    }
+    if (pattern.kind === "regex" && pattern.value.test(name)) {
+      return true;
+    }
+  }
+  return false;
+}
+
+export function isAllowedByPolicy(name: string, policy?: ToolPolicy) {
+  if (!policy) {
+    return true;
+  }
+  const normalized = normalizeToolName(name);
+  const deny = compilePatterns(policy.deny);
+  if (matchesAny(normalized, deny)) {
+    return false;
+  }
+  const allow = compilePatterns(policy.allow);
+  if (allow.length === 0) {
+    return true;
+  }
+  if (matchesAny(normalized, allow)) {
+    return true;
+  }
+  if (normalized === "apply_patch" && matchesAny("exec", allow)) {
+    return true;
+  }
+  return false;
+}
+
+export function matchesList(name: string, list?: string[]) {
+  if (!Array.isArray(list) || list.length === 0) {
+    return false;
+  }
+  const normalized = normalizeToolName(name);
+  const patterns = compilePatterns(list);
+  if (matchesAny(normalized, patterns)) {
+    return true;
+  }
+  if (normalized === "apply_patch" && matchesAny("exec", patterns)) {
+    return true;
+  }
+  return false;
+}
+
+export function resolveToolProfile(profile: string) {
+  return resolveToolProfilePolicy(profile) ?? undefined;
+}