@jiggai/kitchen 0.1.3 → 0.1.7

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "kitchen",
   "name": "ClawKitchen",
   "description": "Local UI for managing OpenClaw recipes, teams, agents, cron jobs, and skills.",
-  "version": "0.1.0",
+  "version": "0.1.6",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jiggai/kitchen",
-  "version": "0.1.3",
+  "version": "0.1.7",
   "private": false,
   "openclaw": {
     "extensions": [

package/src/app/agents/[agentId]/agent-editor.tsx

@@ -109,7 +109,7 @@ export default function AgentEditor({ agentId, returnTo }: { agentId: string; re
   const [agentFiles, setAgentFiles] = useState<Array<FileEntry & { required?: boolean; rationale?: string }>>([]);
   const [agentFilesLoading, setAgentFilesLoading] = useState(false);
   const [showOptionalFiles, setShowOptionalFiles] = useState(false);
-  const [fileName, setFileName] = useState<string>("IDENTITY.md");
+  const [fileName, setFileName] = useState<string>("SOUL.md");
   const [fileContent, setFileContent] = useState<string>("");
 
   const teamId = agentId.includes("-") ? agentId.split("-").slice(0, -1).join("-") : "";
@@ -225,8 +225,6 @@ export default function AgentEditor({ agentId, returnTo }: { agentId: string; re
     setSaving(true);
     setPageMsg("");
 
-    // Auto-clear after a moment (non-blocking).
-    setTimeout(() => setPageMsg(""), 6000);
     try {
       const res = await fetch("/api/agents/update", {
         method: "POST",
@@ -261,7 +259,6 @@ export default function AgentEditor({ agentId, returnTo }: { agentId: string; re
       setFileContent(String(json.content ?? ""));
     } catch (e: unknown) {
       setFileError(e instanceof Error ? e.message : String(e));
-      setTimeout(() => setFileError(""), 12000);
     } finally {
       setLoadingFile(false);
     }
@@ -288,6 +285,29 @@ export default function AgentEditor({ agentId, returnTo }: { agentId: string; re
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [activeTab, agentId, agentFiles.length]);
 
+  function defaultFileContent(name: string) {
+    switch (name) {
+      case "SOUL.md":
+        return "# SOUL.md\n\n";
+      case "AGENTS.md":
+        return "# AGENTS.md\n\n";
+      case "TOOLS.md":
+        return "# TOOLS.md\n\n";
+      case "STATUS.md":
+        return "# STATUS.md\n\n- (empty)\n";
+      case "NOTES.md":
+        return "# NOTES.md\n\n- (empty)\n";
+      case "IDENTITY.md":
+        return "# IDENTITY.md\n\n- **Name:**\n- **Creature:**\n- **Vibe:**\n- **Emoji:**\n- **Avatar:**\n";
+      case "USER.md":
+        return "# USER.md\n\n";
+      case "HEARTBEAT.md":
+        return "# HEARTBEAT.md\n\n# Keep this file empty (or with only comments) to skip heartbeat API calls.\n";
+      default:
+        return "";
+    }
+  }
+
   async function onSaveAgentFile() {
     setSaving(true);
     setFileError("");
@@ -299,15 +319,28 @@ export default function AgentEditor({ agentId, returnTo }: { agentId: string; re
       });
       const json = (await res.json()) as { ok?: boolean; error?: string };
       if (!res.ok || !json.ok) throw new Error(json.error || "Failed to save file");
+
+      // Refresh the file list so missing/mtime updates immediately.
+      const r = await fetch(`/api/agents/files?agentId=${encodeURIComponent(agentId)}`, { cache: "no-store" });
+      const j = await r.json();
+      if (r.ok && j.ok && Array.isArray(j.files)) {
+        setAgentFiles(j.files);
+      }
       // No-op: saving a file doesn't need a global notice.
     } catch (e: unknown) {
       setFileError(e instanceof Error ? e.message : String(e));
-      setTimeout(() => setFileError(""), 12000);
     } finally {
       setSaving(false);
     }
   }
 
+  async function onCreateMissingFile(name: string) {
+    setFileName(name);
+    setFileError("");
+    setFileContent(defaultFileContent(name));
+    await onSaveAgentFile();
+  }
+
   async function onDeleteAgent() {
     setDeleteBusy(true);
     setDeleteError(null);
@@ -533,14 +566,12 @@ export default function AgentEditor({ agentId, returnTo }: { agentId: string; re
                       const json = await res.json();
                       if (!res.ok || !json.ok) throw new Error(json.error || "Failed to install skill");
                       setSkillMsg(`Installed skill: ${selectedSkill}`);
-                      setTimeout(() => setSkillMsg(""), 8000);
                       // Refresh installed list.
                       const r = await fetch(`/api/agents/skills?agentId=${encodeURIComponent(agentId)}`, { cache: "no-store" });
                       const j = await r.json();
                       if (r.ok && j.ok) setSkillsList(Array.isArray(j.skills) ? j.skills : []);
                     } catch (e: unknown) {
                       setSkillError(e instanceof Error ? e.message : String(e));
-                      setTimeout(() => setSkillError(""), 12000);
                     } finally {
                       setInstallingSkill(false);
                     }
@@ -587,22 +618,34 @@ export default function AgentEditor({ agentId, returnTo }: { agentId: string; re
                   .filter((f) => (showOptionalFiles ? true : Boolean(f.required) || !f.missing))
                   .map((f) => (
                     <li key={f.name}>
-                      <button
-                        onClick={() => onLoadAgentFile(f.name)}
-                        className={
-                          fileName === f.name
-                            ? "w-full rounded-[var(--ck-radius-sm)] bg-white/10 px-3 py-2 text-left text-sm text-[color:var(--ck-text-primary)]"
-                            : "w-full rounded-[var(--ck-radius-sm)] px-3 py-2 text-left text-sm text-[color:var(--ck-text-secondary)] hover:bg-white/5"
-                        }
-                      >
-                        <span className={f.required ? "text-[color:var(--ck-text-primary)]" : "text-[color:var(--ck-text-secondary)]"}>
-                          {f.name}
-                        </span>
-                        <span className="ml-2 text-[10px] uppercase tracking-wide text-[color:var(--ck-text-tertiary)]">
-                          {f.required ? "required" : "optional"}
-                        </span>
-                        {f.missing ? <span className="ml-2 text-xs text-[color:var(--ck-text-tertiary)]">missing</span> : null}
-                      </button>
+                      <div className="flex items-center gap-2">
+                        <button
+                          onClick={() => onLoadAgentFile(f.name)}
+                          className={
+                            fileName === f.name
+                              ? "w-full rounded-[var(--ck-radius-sm)] bg-white/10 px-3 py-2 text-left text-sm text-[color:var(--ck-text-primary)]"
+                              : "w-full rounded-[var(--ck-radius-sm)] px-3 py-2 text-left text-sm text-[color:var(--ck-text-secondary)] hover:bg-white/5"
+                          }
+                        >
+                          <span className={f.required ? "text-[color:var(--ck-text-primary)]" : "text-[color:var(--ck-text-secondary)]"}>
+                            {f.name}
+                          </span>
+                          <span className="ml-2 text-[10px] uppercase tracking-wide text-[color:var(--ck-text-tertiary)]">
+                            {f.required ? "required" : "optional"}
+                          </span>
+                          {f.missing ? <span className="ml-2 text-xs text-[color:var(--ck-text-tertiary)]">missing</span> : null}
+                        </button>
+                        {f.missing ? (
+                          <button
+                            type="button"
+                            disabled={saving}
+                            onClick={() => void onCreateMissingFile(f.name)}
+                            className="shrink-0 rounded-[var(--ck-radius-sm)] border border-white/10 bg-white/5 px-2 py-1 text-xs font-medium text-[color:var(--ck-text-primary)] hover:bg-white/10 disabled:opacity-50"
+                          >
+                            Create
+                          </button>
+                        ) : null}
+                      </div>
                     </li>
                   ))}
               </ul>

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

@@ -1,6 +1,9 @@
+import fs from "node:fs/promises";
+import path from "node:path";
 import { NextResponse } from "next/server";
 
 import { runOpenClaw } from "@/lib/openclaw";
+import { parseTeamRoleWorkspace } from "@/lib/agent-workspace";
 
 export async function DELETE(_req: Request, { params }: { params: Promise<{ id: string }> }) {
   try {
@@ -8,6 +11,17 @@ export async function DELETE(_req: Request, { params }: { params: Promise<{ id:
     const agentId = String(id ?? "").trim();
     if (!agentId) return NextResponse.json({ ok: false, error: "agent id is required" }, { status: 400 });
 
+    // Resolve workspace BEFORE deleting (after deletion it may disappear from list).
+    let workspace: string | null = null;
+    try {
+      const { stdout } = await runOpenClaw(["agents", "list", "--json"]);
+      const list = JSON.parse(stdout) as Array<{ id: string; workspace?: string }>;
+      const agent = list.find((a) => a.id === agentId);
+      workspace = agent?.workspace ? String(agent.workspace) : null;
+    } catch {
+      workspace = null;
+    }
+
     const result = await runOpenClaw(["agents", "delete", agentId, "--force", "--json"]);
     if (!result.ok) {
       return NextResponse.json(
@@ -28,6 +42,29 @@ export async function DELETE(_req: Request, { params }: { params: Promise<{ id:
       parsed = null;
     }
 
+    // If this was a team role agent, also remove its role directory.
+    // Safer than rm: move to a team-local .trash folder.
+    if (workspace) {
+      const info = parseTeamRoleWorkspace(workspace);
+      if (info.kind === "teamRole") {
+        const trashDir = path.join(info.teamDir, ".trash", "roles");
+        const ts = new Date().toISOString().replace(/[:.]/g, "-");
+        const dst = path.join(trashDir, `${info.role}-${ts}`);
+        try {
+          await fs.mkdir(trashDir, { recursive: true });
+          // Only move if the dir exists.
+          await fs.rename(info.roleDir, dst);
+        } catch {
+          // If rename fails (cross-device / missing), fall back to best-effort recursive removal.
+          try {
+            await fs.rm(info.roleDir, { recursive: true, force: true });
+          } catch {
+            // ignore
+          }
+        }
+      }
+    }
+
     return NextResponse.json({ ok: true, result: parsed ?? result.stdout });
   } catch (err: unknown) {
     return NextResponse.json(

package/src/app/api/agents/add/route.ts

@@ -1,11 +1,10 @@
-import { execFile } from "node:child_process";
 import fs from "node:fs/promises";
+import os from "node:os";
 import path from "node:path";
-import { promisify } from "node:util";
 
 import { NextResponse } from "next/server";
 
-const execFileAsync = promisify(execFile);
+import { getKitchenApi } from "@/lib/kitchen-api";
 
 function normalizeAgentId(id: string) {
   const s = id.trim();
@@ -32,9 +31,9 @@ export async function POST(req: Request) {
     const newAgentId = normalizeAgentId(String(body.newAgentId ?? body.agentId ?? ""));
     const overwrite = Boolean(body.overwrite);
 
-    const configPath = path.join(process.env.HOME || "", ".openclaw", "openclaw.json");
-    if (!process.env.HOME) {
-      return NextResponse.json({ ok: false, error: "HOME is not set" }, { status: 500 });
+    const configPath = path.join(os.homedir(), ".openclaw", "openclaw.json");
+    if (!configPath.trim()) {
+      return NextResponse.json({ ok: false, error: "Could not resolve config path" }, { status: 500 });
     }
 
     const raw = await fs.readFile(configPath, "utf8");
@@ -95,7 +94,8 @@ export async function POST(req: Request) {
   await fs.rename(tmpPath, configPath);
 
   // Restart gateway so the new agent is live.
-  await execFileAsync("openclaw", ["gateway", "restart"], { timeout: 120000 });
+  const api = getKitchenApi();
+  await api.runtime.system.runCommandWithTimeout(["openclaw", "gateway", "restart"], { timeoutMs: 120000 });
 
   return NextResponse.json({ ok: true, agentId: newAgentId, workspace: newWorkspace, restarted: true });
   } catch (err) {

package/src/app/api/agents/files/route.ts

@@ -26,11 +26,13 @@ export async function GET(req: Request) {
 
   // Required vs optional classification to avoid "missing" noise.
   const candidates: Array<{ name: string; required: boolean; rationale: string }> = [
-    { name: "IDENTITY.md", required: true, rationale: "Identity (name/emoji/avatar)" },
     { name: "SOUL.md", required: true, rationale: "Agent persona/instructions" },
     { name: "AGENTS.md", required: true, rationale: "Agent operating rules" },
     { name: "TOOLS.md", required: true, rationale: "Agent local notes" },
 
+    { name: "STATUS.md", required: false, rationale: "Optional current status snapshot" },
+    { name: "NOTES.md", required: false, rationale: "Optional scratchpad" },
+    { name: "IDENTITY.md", required: false, rationale: "Optional identity (name/emoji/avatar)" },
     { name: "USER.md", required: false, rationale: "Optional user profile" },
     { name: "HEARTBEAT.md", required: false, rationale: "Optional periodic checklist" },
   ];

package/src/app/api/agents/skills/install/route.ts

@@ -1,5 +1,6 @@
 import { NextResponse } from "next/server";
 import { runOpenClaw } from "@/lib/openclaw";
+import { parseTeamRoleWorkspace } from "@/lib/agent-workspace";
 
 export async function POST(req: Request) {
   const body = (await req.json()) as { agentId?: string; skill?: string };
@@ -9,14 +10,37 @@ export async function POST(req: Request) {
   if (!agentId) return NextResponse.json({ ok: false, error: "agentId is required" }, { status: 400 });
   if (!skill) return NextResponse.json({ ok: false, error: "skill is required" }, { status: 400 });
 
-  const args = ["recipes", "install-skill", skill, "--agent-id", agentId, "--yes"];
+  // For role-based team agents, install at team scope to avoid creating a separate
+  // workspace-<agentId> directory that diverges from roles/<role>.
+  let args = ["recipes", "install-skill", skill, "--agent-id", agentId, "--yes"];
+  try {
+    const { stdout } = await runOpenClaw(["agents", "list", "--json"]);
+    const list = JSON.parse(stdout) as Array<{ id: string; workspace?: string }>;
+    const agent = list.find((a) => a.id === agentId);
+    const ws = agent?.workspace ? String(agent.workspace) : "";
+    const info = parseTeamRoleWorkspace(ws);
+    if (info.kind === "teamRole") {
+      args = ["recipes", "install-skill", skill, "--team-id", info.teamId, "--yes"];
+    }
+  } catch {
+    // If anything goes wrong, fall back to agent scope.
+  }
+
   const res = await runOpenClaw(args);
   if (!res.ok) {
+    const stdout = res.stdout?.trim();
+    const stderr = res.stderr?.trim();
     return NextResponse.json(
-      { ok: false, error: res.stderr.trim() || `openclaw ${args.join(" ")} failed (exit=${res.exitCode})`, stdout: res.stdout, stderr: res.stderr },
+      {
+        ok: false,
+        error: stderr || stdout || `openclaw ${args.join(" ")} failed (exit=${res.exitCode})`,
+        stdout: res.stdout,
+        stderr: res.stderr,
+        scopeArgs: args,
+      },
       { status: 500 },
     );
   }
 
-  return NextResponse.json({ ok: true, agentId, skill, stdout: res.stdout, stderr: res.stderr });
+  return NextResponse.json({ ok: true, agentId, skill, scopeArgs: args, stdout: res.stdout, stderr: res.stderr });
 }

package/src/app/api/agents/skills/route.ts

@@ -2,6 +2,7 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import { NextResponse } from "next/server";
 import { runOpenClaw } from "@/lib/openclaw";
+import { parseTeamRoleWorkspace } from "@/lib/agent-workspace";
 
 type AgentListItem = { id: string; workspace?: string };
 
@@ -19,17 +20,32 @@ export async function GET(req: Request) {
   if (!agentId) return NextResponse.json({ ok: false, error: "agentId is required" }, { status: 400 });
 
   const ws = await resolveAgentWorkspace(agentId);
-  const skillsDir = path.join(ws, "skills");
-
-  try {
-    const entries = await fs.readdir(skillsDir, { withFileTypes: true });
-    const skills = entries
-      .filter((e) => e.isDirectory())
-      .map((e) => e.name)
-      .sort((a, b) => a.localeCompare(b));
-
-    return NextResponse.json({ ok: true, agentId, workspace: ws, skillsDir, skills });
-  } catch (e: unknown) {
-    return NextResponse.json({ ok: true, agentId, workspace: ws, skillsDir, skills: [], note: e instanceof Error ? e.message : String(e) });
+
+  const info = parseTeamRoleWorkspace(ws);
+  const dirs: string[] = [path.join(ws, "skills")];
+  if (info.kind === "teamRole") {
+    // If skills were installed at the team scope, surface them for the role agent too.
+    dirs.push(path.join(info.teamDir, "skills"));
   }
+
+  const skills = new Set<string>();
+  const notes: string[] = [];
+
+  for (const skillsDir of dirs) {
+    try {
+      const entries = await fs.readdir(skillsDir, { withFileTypes: true });
+      for (const e of entries) if (e.isDirectory()) skills.add(e.name);
+    } catch (e: unknown) {
+      notes.push(`${skillsDir}: ${e instanceof Error ? e.message : String(e)}`);
+    }
+  }
+
+  return NextResponse.json({
+    ok: true,
+    agentId,
+    workspace: ws,
+    skillsDirs: dirs,
+    skills: Array.from(skills).sort((a, b) => a.localeCompare(b)),
+    note: notes.length ? notes.join("; ") : undefined,
+  });
 }

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

@@ -1,14 +1,11 @@
-import { execFile } from "node:child_process";
 import fs from "node:fs/promises";
 import path from "node:path";
-import { promisify } from "node:util";
 
 import { NextResponse } from "next/server";
 
 import { readGoal, writeGoal } from "@/lib/goals";
 import { getTeamWorkspaceDir, readOpenClawConfig } from "@/lib/paths";
-
-const execFileAsync = promisify(execFile);
+import { runOpenClaw } from "@/lib/openclaw";
 
 function slugifyFilePart(input: string) {
   return input
@@ -122,20 +119,17 @@ export async function POST(_: Request, { params }: { params: Promise<{ id: strin
     } else {
       pingAttempted = true;
       try {
-        await execFileAsync(
-          "openclaw",
-          [
-            "agent",
-            "--agent",
-            targetAgentId,
-            "--message",
-            `New goal promoted to development-team inbox: ${updated.frontmatter.title} (${goalId}). Inbox file: ${inboxPath}`,
-            "--timeout",
-            "60",
-            "--json",
-          ],
-          { timeout: 70000 },
-        );
+        const res = await runOpenClaw([
+          "agent",
+          "--agent",
+          targetAgentId,
+          "--message",
+          `New goal promoted to development-team inbox: ${updated.frontmatter.title} (${goalId}). Inbox file: ${inboxPath}`,
+          "--timeout",
+          "60",
+          "--json",
+        ]);
+        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);

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

@@ -65,7 +65,7 @@ export async function POST(req: Request) {
     templatesRaw && typeof templatesRaw === "object" && !Array.isArray(templatesRaw)
       ? (templatesRaw as Record<string, unknown>)
       : {};
-  let nextTemplates: Record<string, unknown> = { ...templates };
+  const nextTemplates: Record<string, unknown> = { ...templates };
 
   if (op === "remove") {
     const role = normalizeRole(String(body.role ?? ""));

package/src/app/api/teams/skills/install/route.ts

@@ -12,10 +12,12 @@ export async function POST(req: Request) {
   const args = ["recipes", "install-skill", skill, "--team-id", teamId, "--yes"];
   const res = await runOpenClaw(args);
   if (!res.ok) {
+    const stdout = res.stdout?.trim();
+    const stderr = res.stderr?.trim();
     return NextResponse.json(
       {
         ok: false,
-        error: res.stderr.trim() || `openclaw ${args.join(" ")} failed (exit=${res.exitCode})`,
+        error: stderr || stdout || `openclaw ${args.join(" ")} failed (exit=${res.exitCode})`,
         stdout: res.stdout,
         stderr: res.stderr,
       },

package/src/app/api/tickets/move/route.ts

@@ -1,8 +1,6 @@
 import { NextResponse } from "next/server";
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
 
-const execFileAsync = promisify(execFile);
+import { runOpenClaw } from "@/lib/openclaw";
 
 export async function POST(req: Request) {
   try {
@@ -29,7 +27,8 @@ export async function POST(req: Request) {
       "--yes",
     ];
 
-    await execFileAsync("openclaw", args, { timeout: 30_000 });
+    const res = await runOpenClaw(args);
+    if (!res.ok) throw new Error(res.stderr || `openclaw exit ${res.exitCode}`);
 
     return NextResponse.json({ ok: true });
   } catch (err: unknown) {

package/src/app/recipes/[id]/page.tsx

@@ -1,7 +1,12 @@
 import Link from "next/link";
+import { unstable_noStore as noStore } from "next/cache";
+
 import { runOpenClaw } from "@/lib/openclaw";
 import RecipeEditor from "./RecipeEditor";
 
+export const dynamic = "force-dynamic";
+export const revalidate = 0;
+
 type RecipeListItem = {
   id: string;
   name: string;
@@ -21,6 +26,8 @@ async function getKind(id: string): Promise<"agent" | "team" | null> {
 }
 
 export default async function RecipePage({ params }: { params: Promise<{ id: string }> }) {
+  noStore();
+
   const { id } = await params;
   const kind = await getKind(id);
 

package/src/app/recipes/page.tsx

@@ -1,7 +1,12 @@
 import Link from "next/link";
+import { unstable_noStore as noStore } from "next/cache";
+
 import { runOpenClaw } from "@/lib/openclaw";
 import RecipesClient from "./recipes-client";
 
+export const dynamic = "force-dynamic";
+export const revalidate = 0;
+
 type Recipe = {
   id: string;
   name: string;
@@ -39,6 +44,8 @@ async function getAgents(): Promise<{ agentIds: string[]; error: string | null }
 }
 
 export default async function RecipesPage() {
+  noStore();
+
   const [{ recipes, error }, { agentIds }] = await Promise.all([getRecipes(), getAgents()]);
 
   const builtin = recipes.filter((r) => r.source === "builtin");

package/src/app/recipes/recipes-client.tsx

@@ -126,7 +126,6 @@ export default function RecipesClient({
 
   const [overlayOpen, setOverlayOpen] = useState(false);
   const [overlayStep, setOverlayStep] = useState<ScaffoldOverlayStep>(1);
-  const [overlayDetails, setOverlayDetails] = useState<string>("");
   const router = useRouter();
 
   const [deleteOpen, setDeleteOpen] = useState(false);
@@ -266,7 +265,6 @@ export default function RecipesClient({
 
     setOverlayOpen(true);
     setOverlayStep(1);
-    setOverlayDetails("");
 
     let serveTimer: ReturnType<typeof setTimeout> | null = null;
 
@@ -295,7 +293,6 @@ export default function RecipesClient({
       }, 20_000);
 
       const stderr = typeof json.stderr === "string" ? json.stderr : "";
-      if (stderr.trim()) setOverlayDetails(stderr.trim());
 
       // Some CLI failures currently still surface as { ok: true, stderr: "...Error: ..." }.
       // Treat those as hard failures so we don't navigate into a broken team page.
@@ -361,7 +358,6 @@ export default function RecipesClient({
 
     setOverlayOpen(true);
     setOverlayStep(1);
-    setOverlayDetails("");
 
     let serveTimer: ReturnType<typeof setTimeout> | null = null;
 
@@ -388,7 +384,6 @@ export default function RecipesClient({
       }, 20_000);
 
       const stderr = typeof json.stderr === "string" ? json.stderr : "";
-      if (stderr.trim()) setOverlayDetails(stderr.trim());
 
       if (/Failed to start CLI:/i.test(stderr) || /\bError: /i.test(stderr)) {
         throw new Error(stderr.trim() || "Scaffold failed");

package/src/lib/agent-workspace.ts

@@ -0,0 +1,14 @@
+import path from "node:path";
+
+export function parseTeamRoleWorkspace(ws: string):
+  | { kind: "teamRole"; teamDir: string; teamId: string; roleDir: string; role: string }
+  | { kind: "other" } {
+  const normalized = ws.replace(/\\/g, "/");
+  const m = normalized.match(/^(.*\/workspace-([^\/]+))\/roles\/([^\/]+)\/?$/);
+  if (!m) return { kind: "other" };
+  const teamDir = m[1];
+  const teamId = m[2];
+  const role = m[3];
+  const roleDir = path.join(teamDir, "roles", role);
+  return { kind: "teamRole", teamDir, teamId, roleDir, role };
+}

package/src/lib/gateway.ts

@@ -27,17 +27,14 @@ type ToolTextEnvelope = {
 };
 
 async function getGatewayBaseUrlAndToken() {
-  // Allow running ClawKitchen on a different host than the OpenClaw gateway.
-  // Useful for remote dev/prod deployments where the gateway lives elsewhere.
-  const envUrl = (process.env.OPENCLAW_GATEWAY_HTTP_URL || process.env.OPENCLAW_GATEWAY_URL || "").trim();
-  const envToken = (process.env.OPENCLAW_GATEWAY_TOKEN || "").trim();
-
+  // 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 = envToken || cfg.gateway?.auth?.token;
-  if (!token) throw new Error("Missing gateway token. Set OPENCLAW_GATEWAY_TOKEN or gateway.auth.token in ~/.openclaw/openclaw.json");
+  const token = cfg.gateway?.auth?.token;
+  if (!token) throw new Error("Missing gateway token (gateway.auth.token in ~/.openclaw/openclaw.json)");
 
-  const baseUrl = envUrl || `http://127.0.0.1:${port}`;
+  const baseUrl = `http://127.0.0.1:${port}`;
   return { baseUrl, token };
 }
 

package/src/lib/kitchen-api.ts

@@ -0,0 +1,19 @@
+// 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;
+}