@jiggai/kitchen 0.3.1 → 0.3.3

package/src/lib/gateway.ts

@@ -1,100 +0,0 @@
-import { readOpenClawConfig } from "@/lib/paths";
-
-type ToolsInvokeRequest = {
-  tool: string;
-  action?: string;
-  args?: Record<string, unknown>;
-  sessionKey?: string;
-  dryRun?: boolean;
-};
-
-type ToolsInvokeResponse = {
-  ok: boolean;
-  result?: unknown;
-  error?: { message?: string } | string;
-};
-
-type GatewayConfigGetResult = {
-  path: string;
-  exists: boolean;
-  raw: string;
-  hash: string;
-};
-
-type ToolTextEnvelope = {
-  ok: boolean;
-  result: GatewayConfigGetResult;
-};
-
-async function getGatewayBaseUrlAndToken() {
-  // ClawKitchen runs in-process with the OpenClaw Gateway (as a plugin), so we can read
-  // the gateway port/token from the loaded config.
-  const cfg = await readOpenClawConfig();
-  const port = cfg.gateway?.port ?? 18789;
-  const token = cfg.gateway?.auth?.token;
-  if (!token) throw new Error("Missing gateway token (gateway.auth.token in ~/.openclaw/openclaw.json)");
-
-  const baseUrl = `http://127.0.0.1:${port}`;
-  return { baseUrl, token };
-}
-
-export async function toolsInvoke<T = unknown>(req: ToolsInvokeRequest): Promise<T> {
-  const { baseUrl, token } = await getGatewayBaseUrlAndToken();
-
-  const res = await fetch(`${baseUrl}/tools/invoke`, {
-    method: "POST",
-    headers: {
-      "content-type": "application/json",
-      authorization: `Bearer ${token}`,
-    },
-    body: JSON.stringify(req),
-  });
-
-  const json = (await res.json()) as ToolsInvokeResponse;
-  if (!res.ok || !json.ok) {
-    const msg =
-      (typeof json.error === "object" && json.error?.message) ||
-      (typeof json.error === "string" ? json.error : null) ||
-      `tools/invoke failed (${res.status})`;
-    throw new Error(msg);
-  }
-
-  return json.result as T;
-}
-
-export function getContentText(content: Array<{ type: string; text?: string }> | undefined): string | undefined {
-  return content?.find((c) => c.type === "text")?.text;
-}
-
-export async function gatewayConfigGet(): Promise<{ raw: string; hash: string }> {
-  const toolResult = await toolsInvoke<{ content: Array<{ type: string; text?: string }> }>({
-    tool: "gateway",
-    args: { action: "config.get", raw: "{}" },
-  });
-
-  const text = getContentText(toolResult?.content);
-  if (!text) throw new Error("gateway config.get: missing text payload");
-
-  const parsed = JSON.parse(text) as ToolTextEnvelope;
-  const raw = String(parsed?.result?.raw ?? "");
-  const hash = String(parsed?.result?.hash ?? "");
-  if (!raw) throw new Error("gateway config.get: missing result.raw");
-  if (!hash) throw new Error("gateway config.get: missing result.hash");
-  return { raw, hash };
-}
-
-export async function gatewayConfigPatch(patch: unknown, note?: string) {
-  const { hash } = await gatewayConfigGet();
-  const raw = JSON.stringify(patch, null, 2);
-
-  return toolsInvoke({
-    tool: "gateway",
-    args: {
-      action: "config.patch",
-      raw,
-      baseHash: hash,
-      note: note ?? "ClawKitchen settings update",
-      restartDelayMs: 1000,
-    },
-  });
-}

package/src/lib/goal-promote.ts

@@ -1,27 +0,0 @@
-import { slugifyId } from "./slugify";
-
-/** Slugify for file path parts (max 80 chars). */
-export function slugifyFilePart(input: string): string {
-  return slugifyId(input, 80);
-}
-
-const WORKFLOW_MARKER = "<!-- goal-workflow -->";
-
-export function ensureWorkflowInstructions(body: string): 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;
-}

package/src/lib/goals-client.ts

@@ -1,69 +0,0 @@
-"use client";
-
-import { useMemo, useState } from "react";
-
-/** Client-safe goal types and utils (no node deps). */
-
-export type GoalStatus = "planned" | "active" | "done";
-
-export type GoalFrontmatter = {
-  id: string;
-  title: string;
-  status: GoalStatus;
-  tags: string[];
-  teams: string[];
-  updatedAt: string;
-};
-
-/** Form state shape for GoalFormFields. */
-export type GoalFormState = {
-  title: string;
-  setTitle: (v: string) => void;
-  status: GoalStatus;
-  setStatus: (v: GoalStatus) => void;
-  tagsRaw: string;
-  setTagsRaw: (v: string) => void;
-  teamsRaw: string;
-  setTeamsRaw: (v: string) => void;
-  body: string;
-  setBody: (v: string) => void;
-};
-
-/** Parses comma-separated string into trimmed non-empty array. */
-export function parseCommaList(raw: string): string[] {
-  return raw.split(",").map((s) => s.trim()).filter(Boolean);
-}
-
-/** Shared form state for goal create/edit. Returns formState for GoalFormFields and parsed tags/teams. */
-export function useGoalFormState(initial?: Partial<GoalFormState>): {
-  formState: GoalFormState;
-  tags: string[];
-  teams: string[];
-} {
-  const [title, setTitle] = useState(initial?.title ?? "");
-  const [status, setStatus] = useState<GoalStatus>(initial?.status ?? "planned");
-  const [tagsRaw, setTagsRaw] = useState(initial?.tagsRaw ?? "");
-  const [teamsRaw, setTeamsRaw] = useState(initial?.teamsRaw ?? "");
-  const [body, setBody] = useState(initial?.body ?? "");
-
-  const formState: GoalFormState = useMemo(
-    () => ({
-      title,
-      setTitle,
-      status,
-      setStatus,
-      tagsRaw,
-      setTagsRaw,
-      teamsRaw,
-      setTeamsRaw,
-      body,
-      setBody,
-    }),
-    [title, status, tagsRaw, teamsRaw, body]
-  );
-
-  const tags = useMemo(() => parseCommaList(tagsRaw), [tagsRaw]);
-  const teams = useMemo(() => parseCommaList(teamsRaw), [teamsRaw]);
-
-  return { formState, tags, teams };
-}

package/src/lib/goals.ts

@@ -1,171 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { NextResponse } from "next/server";
-import YAML from "yaml";
-import { errorMessage } from "@/lib/errors";
-import { getWorkspaceGoalsDir } from "@/lib/paths";
-
-export type GoalStatus = "planned" | "active" | "done";
-
-/** Parses comma-separated string into trimmed non-empty array. */
-export function parseCommaList(raw: string): string[] {
-  return raw.split(",").map((s) => s.trim()).filter(Boolean);
-}
-
-export type GoalFrontmatter = {
-  id: string;
-  title: string;
-  status: GoalStatus;
-  tags: string[];
-  teams: string[];
-  updatedAt: string; // ISO
-};
-
-export type GoalSummary = GoalFrontmatter & {
-  filename: string;
-};
-
-const ID_RE = /^[a-z0-9][a-z0-9-]{1,63}$/;
-
-export function assertSafeGoalId(id: string) {
-  if (!ID_RE.test(id)) {
-    throw new Error(
-      `Invalid goal id "${id}". Use 2-64 chars: lowercase letters, numbers, hyphens. Example: "increase-trial-activation".`
-    );
-  }
-}
-
-/** Maps goal-related errors to HTTP status: 400 for validation, 500 for other. */
-export function goalErrorStatus(msg: string): 400 | 500 {
-  return /Invalid goal id|Path traversal/.test(msg) ? 400 : 500;
-}
-
-/** Returns NextResponse for goal API errors. Use in catch blocks. */
-export function goalErrorResponse(e: unknown): NextResponse {
-  const msg = errorMessage(e);
-  const status = goalErrorStatus(msg);
-  return NextResponse.json({ error: msg }, { status });
-}
-
-export function splitFrontmatter(md: string): { fm: unknown; body: string } {
-  if (md.startsWith("---\n")) {
-    const end = md.indexOf("\n---\n", 4);
-    if (end !== -1) {
-      const yamlText = md.slice(4, end + 1);
-      const body = md.slice(end + 5);
-      const fm = YAML.parse(yamlText) as unknown;
-      return { fm: fm ?? {}, body };
-    }
-  }
-  return { fm: {}, body: md };
-}
-
-export function normalizeFrontmatter(input: unknown, fallbackId: string, fallbackTitle: string): GoalFrontmatter {
-  const now = new Date().toISOString();
-  const obj = (input && typeof input === "object") ? (input as Record<string, unknown>) : {};
-  const id = String(obj.id ?? fallbackId).trim();
-  const title = String(obj.title ?? fallbackTitle ?? id).trim() || id;
-  const statusRaw = String(obj.status ?? "planned").trim();
-  const status: GoalStatus = statusRaw === "active" || statusRaw === "done" ? statusRaw : "planned";
-  const tags = Array.isArray(obj.tags) ? (obj.tags as unknown[]).map(String) : [];
-  const teams = Array.isArray(obj.teams) ? (obj.teams as unknown[]).map(String) : [];
-  const updatedAt = String(obj.updatedAt ?? now);
-
-  return { id, title, status, tags, teams, updatedAt };
-}
-
-async function ensureGoalsDir() {
-  const dir = await getWorkspaceGoalsDir();
-  await fs.mkdir(dir, { recursive: true });
-  return dir;
-}
-
-async function goalPathForId(id: string) {
-  assertSafeGoalId(id);
-  const root = await ensureGoalsDir();
-  const full = path.join(root, `${id}.md`);
-  const normalizedRoot = path.resolve(root) + path.sep;
-  const normalizedFull = path.resolve(full);
-  if (!normalizedFull.startsWith(normalizedRoot)) throw new Error("Path traversal rejected");
-  return { root, full };
-}
-
-export async function listGoals(): Promise<GoalSummary[]> {
-  const dir = await ensureGoalsDir();
-  const files = (await fs.readdir(dir)).filter((f) => f.endsWith(".md"));
-
-  const out: GoalSummary[] = [];
-  for (const f of files) {
-    const full = path.join(dir, f);
-    const md = await fs.readFile(full, "utf8");
-    const id = f.replace(/\.md$/, "");
-    const { fm } = splitFrontmatter(md);
-    const normalized = normalizeFrontmatter(fm, id, id);
-    out.push({ ...normalized, filename: f });
-  }
-
-  // sort: active first, then planned, then done; within status by updatedAt desc
-  const rank: Record<GoalStatus, number> = { active: 0, planned: 1, done: 2 };
-  out.sort((a, b) => {
-    const ra = rank[a.status];
-    const rb = rank[b.status];
-    if (ra !== rb) return ra - rb;
-    return String(b.updatedAt).localeCompare(String(a.updatedAt));
-  });
-
-  return out;
-}
-
-export async function readGoal(id: string): Promise<{ frontmatter: GoalFrontmatter; body: string; raw: string } | null> {
-  const { full } = await goalPathForId(id);
-  try {
-    const raw = await fs.readFile(full, "utf8");
-    const { fm, body } = splitFrontmatter(raw);
-    const fmObj = (fm && typeof fm === "object") ? (fm as Record<string, unknown>) : {};
-    const frontmatter = normalizeFrontmatter(fm, id, String(fmObj.title ?? id));
-    return { frontmatter, body, raw };
-  } catch (e: unknown) {
-    if (typeof e === "object" && e && (e as { code?: string }).code === "ENOENT") return null;
-    throw e;
-  }
-}
-
-export async function writeGoal(params: {
-  id: string;
-  title: string;
-  status?: GoalStatus;
-  tags?: string[];
-  teams?: string[];
-  body: string;
-}): Promise<{ frontmatter: GoalFrontmatter; raw: string }>
-{
-  const { id } = params;
-  const { full } = await goalPathForId(id);
-
-  const updatedAt = new Date().toISOString();
-  const fm: GoalFrontmatter = {
-    id,
-    title: params.title,
-    status: params.status ?? "planned",
-    tags: params.tags ?? [],
-    teams: params.teams ?? [],
-    updatedAt,
-  };
-
-  const raw = `---\n${YAML.stringify(fm).trim()}\n---\n\n${(params.body ?? "").trim()}\n`;
-  await fs.writeFile(full, raw, "utf8");
-  return { frontmatter: fm, raw };
-}
-
-export async function deleteGoal(id: string): Promise<{ ok: true } | { ok: false; reason: "not_found" }> {
-  const { full } = await goalPathForId(id);
-  try {
-    await fs.unlink(full);
-    return { ok: true };
-  } catch (e: unknown) {
-    if (typeof e === "object" && e && (e as { code?: string }).code === "ENOENT") {
-      return { ok: false, reason: "not_found" };
-    }
-    throw e;
-  }
-}

package/src/lib/json.ts

@@ -1,10 +0,0 @@
-/**
- * Safely parse JSON. Returns null on parse error.
- */
-export function safeJsonParse(raw: string): unknown {
-  try {
-    return JSON.parse(raw);
-  } catch {
-    return null;
-  }
-}

package/src/lib/kitchen-api.ts

@@ -1,19 +0,0 @@
-// NOTE: This file is compiled by Next.js.
-// Do not import `openclaw/plugin-sdk` here (it is provided by the gateway runtime, not as an npm dep).
-
-type KitchenApi = {
-  config: unknown;
-  runtime: {
-    system: { runCommandWithTimeout: (argv: string[], opts: { timeoutMs: number }) => Promise<{ stdout?: string; stderr?: string }> };
-  };
-};
-
-export function getKitchenApi(): KitchenApi {
-  const api = (globalThis as unknown as { __clawkitchen_api?: KitchenApi }).__clawkitchen_api;
-  if (!api) {
-    throw new Error(
-      "ClawKitchen: OpenClaw plugin API not available. (This should only happen if Kitchen is started outside the gateway process.)",
-    );
-  }
-  return api;
-}

package/src/lib/marketplace.ts

@@ -1,46 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-
-export type MarketplaceRecipe = {
-  slug: string;
-  kind: "team" | "agent";
-  name: string;
-  description: string;
-  version: string;
-  tags: string[];
-  sourceUrl: string;
-  homepageUrl?: string;
-};
-
-export type MarketplaceRegistry = {
-  version: number;
-  generatedAt: string;
-  recipes: MarketplaceRecipe[];
-};
-
-const REGISTRY_PATH = path.join(process.cwd(), "marketplace", "registry.json");
-
-export async function loadRegistry(): Promise<MarketplaceRegistry> {
-  const raw = await fs.readFile(REGISTRY_PATH, "utf8");
-  const data = JSON.parse(raw) as MarketplaceRegistry;
-  const obj = data as unknown as { recipes?: unknown };
-  if (!data || typeof data !== "object" || !Array.isArray(obj.recipes)) {
-    throw new Error("Invalid marketplace registry.json");
-  }
-  return data;
-}
-
-export function search(recipes: MarketplaceRecipe[], q: string | null) {
-  const query = (q ?? "").trim().toLowerCase();
-  if (!query) return recipes;
-
-  return recipes.filter((r) => {
-    const hay = [r.slug, r.name, r.description, ...(r.tags ?? [])].join(" ").toLowerCase();
-    return hay.includes(query);
-  });
-}
-
-export function getBySlug(recipes: MarketplaceRecipe[], slug: string) {
-  const s = slug.trim().toLowerCase();
-  return recipes.find((r) => r.slug.toLowerCase() === s) ?? null;
-}

package/src/lib/openclaw.ts

@@ -1,59 +0,0 @@
-import { getKitchenApi } from "@/lib/kitchen-api";
-
-export type OpenClawExecResult = {
-  ok: boolean;
-  exitCode: number;
-  stdout: string;
-  stderr: string;
-};
-
-function extractStdout(err: { stdout?: unknown }): string {
-  if (typeof err.stdout === "string") return err.stdout;
-  if (err.stdout && typeof err.stdout === "object" && "toString" in err.stdout) {
-    return String((err.stdout as { toString: () => string }).toString());
-  }
-  return "";
-}
-
-function resolveExitCode(res: { exitCode?: unknown; code?: unknown; status?: unknown }): number {
-  if (typeof res.exitCode === "number") return res.exitCode;
-  if (typeof res.code === "number") return res.code;
-  if (typeof res.status === "number") return res.status;
-  return 0;
-}
-
-function extractStderr(err: { stderr?: unknown; message?: unknown }, fallback: unknown): string {
-  if (typeof err.stderr === "string") return err.stderr;
-  if (err.stderr && typeof err.stderr === "object" && "toString" in err.stderr) {
-    return String((err.stderr as { toString: () => string }).toString());
-  }
-  if (typeof err.message === "string") return err.message;
-  return String(fallback);
-}
-
-export async function runOpenClaw(args: string[]): Promise<OpenClawExecResult> {
-  const api = getKitchenApi();
-  try {
-    const res = (await api.runtime.system.runCommandWithTimeout(["openclaw", ...args], { timeoutMs: 120000 })) as {
-      stdout?: unknown;
-      stderr?: unknown;
-      exitCode?: unknown;
-      code?: unknown;
-      status?: unknown;
-    };
-
-    const stdout = String(res.stdout ?? "");
-    const stderr = String(res.stderr ?? "");
-    const exitCode = resolveExitCode(res);
-
-
-    if (exitCode !== 0) return { ok: false, exitCode, stdout, stderr };
-    return { ok: true, exitCode: 0, stdout, stderr };
-  } catch (e: unknown) {
-    const err = e as { code?: unknown; stdout?: unknown; stderr?: unknown; message?: unknown };
-    const exitCode = typeof err.code === "number" ? err.code : 1;
-    const stdout = extractStdout(err);
-    const stderr = extractStderr(err, e);
-    return { ok: false, exitCode, stdout, stderr };
-  }
-}

package/src/lib/paths.ts

@@ -1,69 +0,0 @@
-import fs from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-
-type OpenClawConfig = {
-  agents?: { defaults?: { workspace?: string } };
-  gateway?: { port?: number; auth?: { token?: string } };
-  tools?: {
-    agentToAgent?: {
-      enabled?: boolean;
-      allow?: string[];
-    };
-  };
-  plugins?: {
-    installs?: { recipes?: { installPath?: string; sourcePath?: string } };
-    load?: { paths?: string[] };
-  };
-};
-
-export async function readOpenClawConfig(): Promise<OpenClawConfig> {
-  const p = path.join(os.homedir(), ".openclaw", "openclaw.json");
-  const text = await fs.readFile(p, "utf8");
-  return JSON.parse(text) as OpenClawConfig;
-}
-
-export async function getWorkspaceDir() {
-  const cfg = await readOpenClawConfig();
-  const ws = cfg.agents?.defaults?.workspace;
-  if (!ws) throw new Error("agents.defaults.workspace is not set in ~/.openclaw/openclaw.json");
-  return ws;
-}
-
-export async function getWorkspaceRecipesDir() {
-  const ws = await getWorkspaceDir();
-  return path.join(ws, "recipes");
-}
-
-export async function getWorkspaceGoalsDir() {
-  const ws = await getWorkspaceDir();
-  return path.join(ws, "notes", "goals");
-}
-
-export async function getTeamWorkspaceDir(teamId: string) {
-  const home = os.homedir();
-  if (!home) throw new Error("Could not resolve home directory");
-  return path.join(home, ".openclaw", `workspace-${teamId}`);
-}
-
-/** Team workspace dir derived from agents.defaults.workspace (sibling: .. / workspace-{teamId}) */
-export function teamDirFromBaseWorkspace(baseWorkspace: string, teamId: string) {
-  return path.resolve(baseWorkspace, "..", `workspace-${teamId}`);
-}
-
-/** Rejects path traversal and empty names; returns normalized name. */
-export function assertSafeRelativeFileName(name: string): string {
-  const n = name.replace(/\\/g, "/");
-  if (!n || n.startsWith("/") || n.includes("..")) throw new Error("Invalid file name");
-  return n;
-}
-
-export async function getBuiltinRecipesDir() {
-  const cfg = await readOpenClawConfig();
-  const p =
-    cfg.plugins?.installs?.recipes?.installPath ||
-    cfg.plugins?.installs?.recipes?.sourcePath ||
-    cfg.plugins?.load?.paths?.[0];
-  if (!p) throw new Error("Could not determine recipes plugin install path from ~/.openclaw/openclaw.json");
-  return path.join(p, "recipes", "default");
-}

package/src/lib/poll.ts

@@ -1,18 +0,0 @@
-/**
- * Polls until check returns a non-null value or timeout. Returns the value or null on timeout.
- */
-export async function pollUntil<T>(
-  check: () => Promise<T | null>,
-  opts: { timeoutMs: number; intervalMs?: number }
-): Promise<T | null> {
-  const intervalMs = opts.intervalMs ?? 500;
-  const started = Date.now();
-
-  while (Date.now() - started < opts.timeoutMs) {
-    const result = await check();
-    if (result !== null) return result;
-    await new Promise((r) => setTimeout(r, intervalMs));
-  }
-
-  return null;
-}

package/src/lib/recipe-clone.ts

@@ -1,42 +0,0 @@
-import YAML from "yaml";
-
-export function suggestIds(baseId: string): string[] {
-  const b = String(baseId || "recipe").trim();
-  return [`custom-${b}`, `my-${b}`, `${b}-2`, `${b}-alt`];
-}
-
-export function scaffoldCmdForKind(kind: string, toId: string): string[] | null {
-  if (kind === "team") {
-    return ["recipes", "scaffold-team", toId, "--team-id", toId, "--overwrite", "--overwrite-recipe"];
-  }
-  if (kind === "agent") {
-    return ["recipes", "scaffold", toId, "--agent-id", toId, "--overwrite", "--overwrite-recipe"];
-  }
-  return null;
-}
-
-export function patchFrontmatter(
-  original: string,
-  toId: string,
-  toName: string | undefined
-): { next: string; kind: string } {
-  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 teamPatch =
-    kind === "team"
-      ? {
-          team: {
-            ...(typeof fm.team === "object" && fm.team ? (fm.team as Record<string, unknown>) : {}),
-            teamId: toId,
-          },
-        }
-      : {};
-  const patched: Record<string, unknown> = { ...fm, id: toId, ...(toName ? { name: toName } : {}), ...teamPatch };
-  const nextYaml = YAML.stringify(patched).trimEnd();
-  const next = `---\n${nextYaml}\n---\n${original.slice(end + 5)}`;
-  return { next, kind };
-}

package/src/lib/recipe-team-agents.ts

@@ -1,30 +0,0 @@
-export function splitRecipeFrontmatter(md: string): { yamlText: string; rest: string } {
-  if (!md.startsWith("---\n")) throw new Error("Recipe markdown must start with YAML frontmatter (---)");
-  const end = md.indexOf("\n---\n", 4);
-  if (end === -1) throw new Error("Recipe frontmatter not terminated (---)");
-  const yamlText = md.slice(4, end + 1);
-  const rest = md.slice(end + 5);
-  return { yamlText, rest };
-}
-
-export function normalizeRole(role: string): string {
-  const r = role.trim();
-  if (!r) throw new Error("role is required");
-  if (!/^[a-z][a-z0-9-]{0,62}$/i.test(r)) throw new Error("role must be alphanumeric/dash");
-  return r;
-}
-
-/** Validates create-team or create-agent id. Returns error message or null. */
-export function validateCreateId(
-  recipe: { id: string } | null,
-  id: string,
-  entityLabel: "team" | "agent"
-): string | null {
-  if (!recipe) return null;
-  const t = id.trim();
-  const label = entityLabel === "team" ? "Team id" : "Agent id";
-  if (!t) return `${label} is required.`;
-  if (t === recipe.id)
-    return `${label} cannot be the same as the recipe id (${recipe.id}). Choose a new ${entityLabel} id.`;
-  return null;
-}