@jiggai/kitchen 0.1.12 → 0.2.0

package/src/app/api/goals/[id]/promote/route.ts

@@ -3,42 +3,12 @@ import path from "node:path";
 
 import { NextResponse } from "next/server";
 
-import { readGoal, writeGoal } from "@/lib/goals";
+import { slugifyFilePart, ensureWorkflowInstructions } from "@/lib/goal-promote";
+import { goalErrorResponse, readGoal, writeGoal } from "@/lib/goals";
 import { getTeamWorkspaceDir, readOpenClawConfig } from "@/lib/paths";
+import { errorMessage } from "@/lib/errors";
 import { runOpenClaw } from "@/lib/openclaw";
 
-function slugifyFilePart(input: string) {
-  return input
-    .toLowerCase()
-    .trim()
-    .replace(/[^a-z0-9\s-]/g, "")
-    .replace(/[\s_-]+/g, "-")
-    .replace(/-+/g, "-")
-    .replace(/^-+|-+$/g, "")
-    .slice(0, 80);
-}
-
-const WORKFLOW_MARKER = "<!-- goal-workflow -->";
-
-function ensureWorkflowInstructions(body: string) {
-  if (body.includes(WORKFLOW_MARKER)) return body;
-  const snippet = [
-    "",
-    "## Workflow",
-    WORKFLOW_MARKER,
-    "- Use **Promote to inbox** to send this goal to the development-team inbox for scoping.",
-    "- When promoted, set goal status to **active**.",
-    "- Track implementation work via tickets (add links/IDs under a **Tickets** section in this goal).",
-    "- When development is complete (all associated tickets marked done), set goal status to **done**.",
-    "",
-    "## Tickets",
-    "- (add ticket links/ids)",
-    "",
-  ].join("\n");
-
-  return (body ?? "").trim() + snippet;
-}
-
 export async function POST(_: Request, { params }: { params: Promise<{ id: string }> }) {
   try {
     const { id } = await params;
@@ -54,7 +24,7 @@ export async function POST(_: Request, { params }: { params: Promise<{ id: strin
     await fs.mkdir(inboxDir, { recursive: true });
 
     const received = new Date().toISOString();
-    const stamp = received.replace(/[-:]/g, "").replace(/\..+$/, "");
+    const stamp = received.replace(/[-:]/g, "").split(".")[0] ?? received;
     const titlePart = slugifyFilePart(existing.frontmatter.title || goalId);
     const filename = `${received.slice(0, 10)}-${received.slice(11, 16).replace(":", "")}-goal-${titlePart || goalId}.md`;
 
@@ -101,17 +71,16 @@ export async function POST(_: Request, { params }: { params: Promise<{ id: strin
       body: updatedBody,
     });
 
-    // 3) Optional lead ping only if config is permissive
-    let pingAttempted = false;
-    let pingOk = false;
-    let pingReason: string | null = null;
-
     const cfg = await readOpenClawConfig();
     const enabled = cfg.tools?.agentToAgent?.enabled === true;
     const allow = cfg.tools?.agentToAgent?.allow ?? [];
     const targetAgentId = "development-team-lead";
     const permitted = enabled && (allow.includes("*") || allow.includes(targetAgentId));
 
+    let pingAttempted = false;
+    let pingOk = false;
+    let pingReason: string | null = null;
+
     if (!permitted) {
       pingReason = enabled
         ? `agentToAgent.allow does not include "*" or "${targetAgentId}"`
@@ -132,7 +101,7 @@ export async function POST(_: Request, { params }: { params: Promise<{ id: strin
         if (!res.ok) throw new Error(res.stderr || `openclaw exit ${res.exitCode}`);
         pingOk = true;
       } catch (e: unknown) {
-        pingReason = e instanceof Error ? e.message : String(e);
+        pingReason = errorMessage(e);
       }
     }
 
@@ -145,8 +114,6 @@ export async function POST(_: Request, { params }: { params: Promise<{ id: strin
       pingReason,
     });
   } catch (e: unknown) {
-    const msg = e instanceof Error ? e.message : String(e);
-    const status = /Invalid goal id|Path traversal/.test(msg) ? 400 : 500;
-    return NextResponse.json({ error: msg }, { status });
+    return goalErrorResponse(e);
   }
 }

package/src/app/api/goals/[id]/route.ts

@@ -1,21 +1,19 @@
 import { NextResponse } from "next/server";
-import { deleteGoal, readGoal, writeGoal } from "@/lib/goals";
+import { deleteGoal, goalErrorResponse, readGoal, writeGoal } from "@/lib/goals";
 
-export async function GET(_req: Request, ctx: { params: Promise<{ id: string }> }) {
-  const { id } = await ctx.params;
+export async function GET(_req: Request, { params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params;
   try {
     const goal = await readGoal(id);
     if (!goal) return NextResponse.json({ error: "Not found" }, { status: 404 });
     return NextResponse.json({ goal: goal.frontmatter, body: goal.body, raw: goal.raw });
   } catch (e: unknown) {
-    const msg = e instanceof Error ? e.message : String(e);
-    const status = /Invalid goal id|Path traversal/.test(msg) ? 400 : 500;
-    return NextResponse.json({ error: msg }, { status });
+    return goalErrorResponse(e);
   }
 }
 
-export async function PUT(req: Request, ctx: { params: Promise<{ id: string }> }) {
-  const { id } = await ctx.params;
+export async function PUT(req: Request, { params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params;
   type GoalPutBody = {
     title: string;
     status?: "planned" | "active" | "done";
@@ -40,21 +38,17 @@ export async function PUT(req: Request, ctx: { params: Promise<{ id: string }> }
 
     return NextResponse.json({ goal: result.frontmatter });
   } catch (e: unknown) {
-    const msg = e instanceof Error ? e.message : String(e);
-    const status = /Invalid goal id|Path traversal/.test(msg) ? 400 : 500;
-    return NextResponse.json({ error: msg }, { status });
+    return goalErrorResponse(e);
   }
 }
 
-export async function DELETE(_req: Request, ctx: { params: Promise<{ id: string }> }) {
-  const { id } = await ctx.params;
+export async function DELETE(_req: Request, { params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params;
   try {
     const result = await deleteGoal(id);
     if (!result.ok) return NextResponse.json({ error: "Not found" }, { status: 404 });
     return NextResponse.json({ ok: true });
   } catch (e: unknown) {
-    const msg = e instanceof Error ? e.message : String(e);
-    const status = /Invalid goal id|Path traversal/.test(msg) ? 400 : 500;
-    return NextResponse.json({ error: msg }, { status });
+    return goalErrorResponse(e);
   }
 }

package/src/app/api/goals/route.ts

@@ -1,13 +1,12 @@
 import { NextResponse } from "next/server";
-import { listGoals, writeGoal } from "@/lib/goals";
+import { goalErrorResponse, listGoals, writeGoal } from "@/lib/goals";
 
 export async function GET() {
   try {
     const goals = await listGoals();
     return NextResponse.json({ goals });
   } catch (e: unknown) {
-    const msg = e instanceof Error ? e.message : String(e);
-    return NextResponse.json({ error: msg }, { status: 500 });
+    return goalErrorResponse(e);
   }
 }
 
@@ -40,8 +39,6 @@ export async function POST(req: Request) {
 
     return NextResponse.json({ goal: result.frontmatter });
   } catch (e: unknown) {
-    const msg = e instanceof Error ? e.message : String(e);
-    const status = /Invalid goal id|Path traversal/.test(msg) ? 400 : 500;
-    return NextResponse.json({ error: msg }, { status });
+    return goalErrorResponse(e);
   }
 }

package/src/app/api/ids/check/route.ts

@@ -2,6 +2,7 @@ import { NextResponse } from "next/server";
 import fs from "node:fs/promises";
 import path from "node:path";
 import { runOpenClaw } from "@/lib/openclaw";
+import { errorMessage } from "@/lib/errors";
 import { readOpenClawConfig } from "@/lib/paths";
 
 type Kind = "team" | "agent";
@@ -20,6 +21,20 @@ function normalizeId(v: unknown) {
   return String(v ?? "").trim();
 }
 
+function parseIdsFromJson(stdout: string): Set<string> {
+  const ids = new Set<string>();
+  try {
+    const items = JSON.parse(stdout) as Array<{ id?: unknown }>;
+    for (const item of items) {
+      const id = normalizeId(item.id);
+      if (id) ids.add(id);
+    }
+  } catch {
+    // ignore
+  }
+  return ids;
+}
+
 async function getSnapshot(): Promise<Snapshot> {
   const now = Date.now();
   if (snapshot && now - snapshot.atMs < SNAPSHOT_TTL_MS) return snapshot;
@@ -31,31 +46,8 @@ async function getSnapshot(): Promise<Snapshot> {
       runOpenClaw(["agents", "list", "--json"]),
     ]);
 
-    const recipeIds = new Set<string>();
-    if (recipesRes.ok) {
-      try {
-        const items = JSON.parse(recipesRes.stdout) as Array<{ id?: unknown }>;
-        for (const r of items) {
-          const id = normalizeId(r.id);
-          if (id) recipeIds.add(id);
-        }
-      } catch {
-        // ignore
-      }
-    }
-
-    const agentIds = new Set<string>();
-    if (agentsRes.ok) {
-      try {
-        const items = JSON.parse(agentsRes.stdout) as Array<{ id?: unknown }>;
-        for (const a of items) {
-          const id = normalizeId(a.id);
-          if (id) agentIds.add(id);
-        }
-      } catch {
-        // ignore
-      }
-    }
+    const recipeIds = recipesRes.ok ? parseIdsFromJson(recipesRes.stdout) : new Set<string>();
+    const agentIds = agentsRes.ok ? parseIdsFromJson(agentsRes.stdout) : new Set<string>();
 
     const s: Snapshot = { atMs: now, recipeIds, agentIds };
     snapshot = s;
@@ -114,7 +106,7 @@ export async function GET(req: Request) {
     return NextResponse.json({ ok: true, available: true });
   } catch (e: unknown) {
     return NextResponse.json(
-      { ok: false, error: e instanceof Error ? e.message : String(e) },
+      { ok: false, error: errorMessage(e) },
       { status: 500 },
     );
   }

package/src/app/api/marketplace/recipes/[slug]/route.ts

@@ -1,9 +1,9 @@
 import { NextRequest, NextResponse } from "next/server";
 import { getBySlug, loadRegistry } from "@/lib/marketplace";
 
-export async function GET(_req: NextRequest, ctx: { params: Promise<{ slug: string }> }) {
+export async function GET(_req: NextRequest, { params }: { params: Promise<{ slug: string }> }) {
   try {
-    const { slug } = await ctx.params;
+    const { slug } = await params;
     const registry = await loadRegistry();
     const recipe = getBySlug(registry.recipes, slug);
     if (!recipe) return NextResponse.json({ ok: false, error: "Not found" }, { status: 404 });

package/src/app/api/recipes/[id]/route.ts

@@ -1,7 +1,7 @@
 import crypto from "node:crypto";
 import { NextResponse } from "next/server";
 import { runOpenClaw } from "@/lib/openclaw";
-import { parseFrontmatterId, resolveRecipePath, type RecipeListItem, writeRecipeFile } from "@/lib/recipes";
+import { findRecipeById, parseFrontmatterId, resolveRecipePath, writeRecipeFile } from "@/lib/recipes";
 
 function sha256(text: string) {
   return crypto.createHash("sha256").update(text, "utf8").digest("hex");
@@ -13,10 +13,7 @@ export async function GET(
 ) {
   const { id } = await params;
 
-  // Get list to learn the source (builtin/workspace) and metadata.
-  const list = await runOpenClaw(["recipes", "list"]);
-  const recipes = JSON.parse(list.stdout) as RecipeListItem[];
-  const item = recipes.find((r) => r.id === id);
+  const item = await findRecipeById(id);
   if (!item) return NextResponse.json({ error: `Recipe not found: ${id}` }, { status: 404 });
 
   const shown = await runOpenClaw(["recipes", "show", id]);
@@ -51,10 +48,7 @@ export async function PUT(
     );
   }
 
-  // Determine source/path via list.
-  const list = await runOpenClaw(["recipes", "list"]);
-  const recipes = JSON.parse(list.stdout) as RecipeListItem[];
-  const item = recipes.find((r) => r.id === id);
+  const item = await findRecipeById(id);
   if (!item) return NextResponse.json({ error: `Recipe not found: ${id}` }, { status: 404 });
 
   if (item.source === "builtin") {

package/src/app/api/recipes/clone/route.ts

@@ -1,9 +1,9 @@
 import fs from "node:fs/promises";
 import path from "node:path";
-import YAML from "yaml";
 import { NextResponse } from "next/server";
 import { getWorkspaceRecipesDir } from "@/lib/paths";
 import { runOpenClaw } from "@/lib/openclaw";
+import { suggestIds, scaffoldCmdForKind, patchFrontmatter } from "@/lib/recipe-clone";
 
 export async function POST(req: Request) {
   const body = (await req.json()) as {
@@ -40,38 +40,8 @@ export async function POST(req: Request) {
 
   const original = String(shown.stdout ?? "");
 
-  // Patch the frontmatter for the new recipe id/name.
-  // For team recipes, also patch team.teamId so downstream scaffold targets the new team workspace.
-  // (Agent ids for team members are derived from teamId + role by scaffold-team.)
   if (!original.startsWith("---\n")) throw new Error("Recipe markdown must start with YAML frontmatter (---)");
-  const end = original.indexOf("\n---\n", 4);
-  if (end === -1) throw new Error("Recipe frontmatter not terminated (---)");
-  const yamlText = original.slice(4, end + 1);
-  const fm = (YAML.parse(yamlText) ?? {}) as Record<string, unknown>;
-  const kind = String(fm.kind ?? "").trim().toLowerCase();
-
-  const patched: Record<string, unknown> = {
-    ...fm,
-    id: toId,
-    ...(toName ? { name: toName } : {}),
-    ...(kind === "team"
-      ? {
-          team: {
-            ...(typeof fm.team === "object" && fm.team ? (fm.team as Record<string, unknown>) : {}),
-            teamId: toId,
-          },
-        }
-      : {}),
-  };
-
-  const nextYaml = YAML.stringify(patched).trimEnd();
-  const next = `---\n${nextYaml}\n---\n${original.slice(end + 5)}`;
-
-  function suggestIds(baseId: string) {
-    const b = String(baseId || "recipe").trim();
-    // Keep it simple/predictable: no timestamps, just common prefixes + auto-increment style.
-    return [`custom-${b}`, `my-${b}`, `${b}-2`, `${b}-alt`];
-  }
+  const { next, kind } = patchFrontmatter(original, toId, toName);
 
   const dir = await getWorkspaceRecipesDir();
   const filePath = path.join(dir, `${toId}.md`);
@@ -106,12 +76,7 @@ export async function POST(req: Request) {
     | null = null;
 
   if (scaffold) {
-    const cmd =
-      kind === "team"
-        ? ["recipes", "scaffold-team", toId, "--team-id", toId, "--overwrite", "--overwrite-recipe"]
-        : kind === "agent"
-          ? ["recipes", "scaffold", toId, "--agent-id", toId, "--overwrite", "--overwrite-recipe"]
-          : null;
+    const cmd = scaffoldCmdForKind(kind, toId);
 
     if (!cmd) {
       scaffoldResult = {

package/src/app/api/recipes/custom-team/route.ts

@@ -0,0 +1,193 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { NextResponse } from "next/server";
+import { getWorkspaceRecipesDir } from "@/lib/paths";
+
+function isValidId(id: string) {
+  // Keep consistent with common recipe/team id expectations.
+  return /^[a-z0-9][a-z0-9_-]{1,62}$/.test(id);
+}
+
+function yamlEscape(s: string) {
+  // Minimal YAML escaping for simple strings.
+  const trimmed = s.replace(/\r\n/g, "\n").trimEnd();
+  if (!trimmed) return "\"\"";
+  // If it's a safe bare string, keep it readable.
+  if (/^[A-Za-z0-9 _.,:;()\[\]{}\-+/@]+$/.test(trimmed) && !/[:#\n]/.test(trimmed)) {
+    return trimmed;
+  }
+  return JSON.stringify(trimmed);
+}
+
+export async function POST(req: Request) {
+  const body = (await req.json()) as {
+    dryRun?: boolean;
+    recipeId?: string;
+    teamId?: string;
+    name?: string;
+    description?: string;
+    roles?: Array<{ roleId?: string; displayName?: string }>;
+  };
+
+  const dryRun = !!body.dryRun;
+  const recipeId = String(body.recipeId ?? body.teamId ?? "").trim();
+  const teamId = String(body.teamId ?? recipeId).trim();
+  const name = typeof body.name === "string" ? body.name.trim() : "";
+  const description = typeof body.description === "string" ? body.description.trim() : "";
+  const roles = Array.isArray(body.roles) ? body.roles : [];
+
+  if (!recipeId) return NextResponse.json({ ok: false, error: "recipeId is required" }, { status: 400 });
+  if (!teamId) return NextResponse.json({ ok: false, error: "teamId is required" }, { status: 400 });
+  if (!isValidId(recipeId)) {
+    return NextResponse.json(
+      { ok: false, error: "Invalid recipeId. Use lowercase letters/numbers with - or _ (2-63 chars)." },
+      { status: 400 },
+    );
+  }
+  if (!isValidId(teamId)) {
+    return NextResponse.json(
+      { ok: false, error: "Invalid teamId. Use lowercase letters/numbers with - or _ (2-63 chars)." },
+      { status: 400 },
+    );
+  }
+  if (!teamId.endsWith("-team")) {
+    return NextResponse.json(
+      { ok: false, error: "teamId must end with -team" },
+      { status: 400 },
+    );
+  }
+
+  if (roles.length < 1) {
+    return NextResponse.json({ ok: false, error: "Select at least one role/agent" }, { status: 400 });
+  }
+
+  const normalizedRoles = roles
+    .map((r) => ({
+      roleId: String(r.roleId ?? "").trim(),
+      displayName: typeof r.displayName === "string" ? r.displayName.trim() : "",
+    }))
+    .filter((r) => r.roleId);
+
+  if (normalizedRoles.length < 1) {
+    return NextResponse.json({ ok: false, error: "Each selected agent must have a roleId" }, { status: 400 });
+  }
+
+  const roleSet = new Set<string>();
+  for (const r of normalizedRoles) {
+    if (!isValidId(r.roleId)) {
+      return NextResponse.json(
+        { ok: false, error: `Invalid roleId: ${r.roleId}. Use lowercase letters/numbers with - or _.` },
+        { status: 400 },
+      );
+    }
+    if (roleSet.has(r.roleId)) {
+      return NextResponse.json({ ok: false, error: `Duplicate roleId: ${r.roleId}` }, { status: 400 });
+    }
+    roleSet.add(r.roleId);
+  }
+
+  const dir = await getWorkspaceRecipesDir();
+  const filePath = path.join(dir, `${recipeId}.md`);
+
+  try {
+    await fs.access(filePath);
+    return NextResponse.json({ ok: false, error: `Recipe already exists: ${recipeId}` }, { status: 409 });
+  } catch {
+    // ok
+  }
+
+  const lines: string[] = [];
+  lines.push("---");
+  lines.push(`id: ${recipeId}`);
+  lines.push(`name: ${yamlEscape(name || recipeId)}`);
+  lines.push(`version: 0.1.0`);
+  if (description) lines.push(`description: ${yamlEscape(description)}`);
+  lines.push("kind: team");
+  lines.push("requiredSkills: []");
+  lines.push("team:");
+  lines.push(`  teamId: ${teamId}`);
+  lines.push("agents:");
+
+  for (const r of normalizedRoles) {
+    lines.push(`  - role: ${r.roleId}`);
+    if (r.displayName) lines.push(`    name: ${yamlEscape(r.displayName)}`);
+    lines.push("    tools:");
+    lines.push("      profile: coding");
+    lines.push("      allow:");
+    lines.push("        - group:fs");
+    lines.push("        - group:web");
+    lines.push("        - group:runtime");
+    lines.push("      deny:");
+    lines.push("        - exec");
+  }
+
+  lines.push("templates:");
+
+  for (const r of normalizedRoles) {
+    const roleId = r.roleId;
+
+    lines.push(`  ${roleId}.soul: |`);
+    lines.push(`    # SOUL.md`);
+    lines.push(`    `);
+    lines.push(`    Role: ${roleId}`);
+    lines.push(`    `);
+
+    lines.push(`  ${roleId}.agents: |`);
+    lines.push(`    # AGENTS.md`);
+    lines.push(`    `);
+    lines.push(`    You are the ${roleId} role in team ${teamId}.`);
+    lines.push(`    `);
+
+    lines.push(`  ${roleId}.tools: |`);
+    lines.push(`    # TOOLS.md`);
+    lines.push(`    `);
+    lines.push(`    - (empty)`);
+    lines.push(`    `);
+
+    lines.push(`  ${roleId}.status: |`);
+    lines.push(`    # STATUS.md`);
+    lines.push(`    `);
+    lines.push(`    - (empty)`);
+    lines.push(`    `);
+
+    lines.push(`  ${roleId}.notes: |`);
+    lines.push(`    # NOTES.md`);
+    lines.push(`    `);
+    lines.push(`    - (empty)`);
+    lines.push("");
+  }
+
+  lines.push("files:");
+  lines.push("  - path: SOUL.md");
+  lines.push("    template: soul");
+  lines.push("    mode: createOnly");
+  lines.push("  - path: AGENTS.md");
+  lines.push("    template: agents");
+  lines.push("    mode: createOnly");
+  lines.push("  - path: TOOLS.md");
+  lines.push("    template: tools");
+  lines.push("    mode: createOnly");
+  lines.push("  - path: STATUS.md");
+  lines.push("    template: status");
+  lines.push("    mode: createOnly");
+  lines.push("  - path: NOTES.md");
+  lines.push("    template: notes");
+  lines.push("    mode: createOnly");
+
+  lines.push("---");
+  lines.push("");
+  lines.push("# Custom team recipe");
+  lines.push("");
+  lines.push("Generated by ClawKitchen Custom Team Builder.");
+  lines.push("");
+
+  const md = lines.join("\n");
+
+  if (dryRun) {
+    return NextResponse.json({ ok: true, dryRun: true, recipeId, teamId, filePath, md });
+  }
+
+  await fs.writeFile(filePath, md, "utf8");
+
+  return NextResponse.json({ ok: true, recipeId, teamId, filePath });
+}

package/src/app/api/recipes/delete/helpers.ts

@@ -0,0 +1,65 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { runOpenClaw } from "@/lib/openclaw";
+
+export async function getAttachedTeams(workspaceRoot: string, recipeId: string): Promise<string[]> {
+  const attachedTeams: string[] = [];
+  const teamsRoot = path.resolve(workspaceRoot, "..");
+
+  try {
+    const entries = await fs.readdir(teamsRoot, { withFileTypes: true });
+    const workspaceDirs = entries.filter((e) => e.isDirectory() && e.name.startsWith("workspace-"));
+
+    for (const dirent of workspaceDirs) {
+      const metaPath = path.join(teamsRoot, dirent.name, "team.json");
+      try {
+        const raw = await fs.readFile(metaPath, "utf8");
+        const meta = JSON.parse(raw) as { recipeId?: unknown; teamId?: unknown };
+        if (String(meta.recipeId ?? "").trim() === recipeId) {
+          attachedTeams.push(
+            String(meta.teamId ?? dirent.name.replace(/^workspace-/, "")).trim() || dirent.name
+          );
+        }
+      } catch {
+        // ignore
+      }
+    }
+  } catch {
+    // ignore
+  }
+
+  return attachedTeams;
+}
+
+export async function getAttachedAgents(
+  workspaceRoot: string,
+  recipeId: string
+): Promise<{ attachedAgents: string[]; hasSameIdAgent: boolean }> {
+  const attachedAgents: string[] = [];
+  let hasSameIdAgent = false;
+
+  const agentsRes = await runOpenClaw(["agents", "list", "--json"]);
+  if (!agentsRes.ok) return { attachedAgents, hasSameIdAgent };
+
+  try {
+    const agents = JSON.parse(agentsRes.stdout) as Array<{ id?: unknown }>;
+    hasSameIdAgent = agents.some((a) => String(a.id ?? "").trim() === recipeId);
+
+    for (const a of agents) {
+      const agentId = String(a.id ?? "").trim();
+      if (!agentId) continue;
+      const metaPath = path.join(workspaceRoot, "agents", agentId, "agent.json");
+      try {
+        const raw = await fs.readFile(metaPath, "utf8");
+        const meta = JSON.parse(raw) as { recipeId?: unknown };
+        if (String(meta.recipeId ?? "").trim() === recipeId) attachedAgents.push(agentId);
+      } catch {
+        // ignore
+      }
+    }
+  } catch {
+    // ignore
+  }
+
+  return { attachedAgents, hasSameIdAgent };
+}