@netnodeag/kraftwerk 0.35.0 → 0.37.0

package/dist/inspector/server.js

@@ -8,11 +8,13 @@ import { listWorkflows, getWorkflow } from "./workflows.js";
 import { dockerStatus, triggerRun, stopRun } from "./runner.js";
 import { cancelChat, createChat, deleteChat, disposeAllBackends, getChat, listChats, postMessage, resolvePermission, subscribeChat, } from "./chat/sessions.js";
 import { bundleDetail, conceptDetail, createBundle, knowledgeIndex, putConcept, verifyFromUi, } from "./knowledge.js";
-import { deleteMember, getMember, listMembers, saveMember, setMemberArchived, teamRoot, } from "./team.js";
+import { deleteAgent, getAgent, listAgents, saveAgent, setAgentArchived, agentsRoot, } from "./agents.js";
 import { deleteAgentSkill, getSkill, listAgentSkills, listSkills, readSkill, saveAgentSkill, skillsRoot, } from "./skills.js";
 import { discoverWorkspaces, forgetProject, listWorkspacesDetailed, markProjectStopped, registerInstance, registerProject, startProject, stopProject, tildify, unregisterInstance, } from "./instances.js";
 import { gitCommit, gitDiff, gitFetch, gitPull, gitPush, gitStatus, startGitSync, } from "./git.js";
 import { getSettings, saveSettings } from "./settings.js";
+import { addRepo, listRepos, openRepos, removeRepo, updateRepo } from "./repos.js";
+import { searchAgents } from "./search.js";
 import { deleteRoutine, routineStatuses, runRoutineNow, saveRoutine, startRoutineScheduler, } from "./routines.js";
 /**
  * The inspector server: a plain node:http server with no dependencies.
@@ -214,6 +216,7 @@ async function handleApi(req, res, url) {
             projectRoot: project?.root ?? getProjectRoot(),
             projectRootLabel: tildify(project?.root ?? getProjectRoot()),
             git: (project?.config.git && project.config.git.enabled !== false) === true,
+            repos: (project?.config.repos && project.config.repos.enabled !== false) === true,
             switcher,
         });
     }
@@ -249,6 +252,50 @@ async function handleApi(req, res, url) {
         const result = await run();
         return json(res, result, result.ok ? 200 : 409);
     }
+    // GET /api/repos — every clone under the repos root, read live from git
+    if (seg.length === 2 && seg[1] === "repos" && method === "GET") {
+        return json(res, await listRepos());
+    }
+    // POST /api/repos {url, name?, branch?, depth?} — clone into the root
+    if (seg.length === 2 && seg[1] === "repos" && method === "POST") {
+        if ((await openRepos()).off)
+            return json(res, { error: "repositories are off" }, 409);
+        try {
+            const body = JSON.parse(await readBody(req));
+            const str = (v) => (typeof v === "string" ? v : undefined);
+            const depth = body.depth === undefined ? undefined : typeof body.depth === "number" ? body.depth : Number.NaN;
+            const repo = await addRepo({ url: str(body.url) ?? "", name: str(body.name), branch: str(body.branch), depth });
+            return json(res, repo, 201);
+        }
+        catch (err) {
+            return json(res, { error: err.message }, 400);
+        }
+    }
+    // POST /api/repos/<slug>/update — fetch, fast-forward when clean
+    if (seg.length === 4 && seg[1] === "repos" && seg[3] === "update" && method === "POST") {
+        try {
+            const result = await updateRepo(seg[2]);
+            return json(res, result, result.ok ? 200 : result.repo || result.off ? 409 : 404);
+        }
+        catch (err) {
+            return json(res, { error: err.message }, 400);
+        }
+    }
+    // DELETE /api/repos/<slug>[?force=1] — remove the clone; 409 while it holds unpushed or uncommitted work
+    if (seg.length === 3 && seg[1] === "repos" && method === "DELETE") {
+        try {
+            const force = ["1", "true"].includes(url.searchParams.get("force") ?? "");
+            const result = await removeRepo(seg[2], force);
+            return json(res, result, result.ok ? 200 : result.conflict || result.off ? 409 : 404);
+        }
+        catch (err) {
+            return json(res, { error: err.message }, 400);
+        }
+    }
+    // GET /api/search/agents — active agents of every reachable workspace (the ⌘K palette)
+    if (seg.length === 3 && seg[1] === "search" && seg[2] === "agents" && method === "GET") {
+        return json(res, await searchAgents());
+    }
     // GET /api/projects — every known workspace incl. this one, with state + counts (admin screen)
     if (seg.length === 2 && seg[1] === "projects" && method === "GET") {
         return json(res, await listWorkspacesDetailed());
@@ -296,7 +343,7 @@ async function handleApi(req, res, url) {
     if (seg.length === 2 && seg[1] === "settings" && method === "GET") {
         return json(res, await getSettings());
     }
-    // PUT /api/settings — write the UI-editable subset (name, icon, switcher, git) back
+    // PUT /api/settings — write the UI-editable subset (name, icon, switcher, git, repos) back
     if (seg.length === 2 && seg[1] === "settings" && method === "PUT") {
         try {
             const input = JSON.parse(await readBody(req));
@@ -516,33 +563,33 @@ async function handleApi(req, res, url) {
         const skill = await getSkill(decodeURIComponent(seg[2]));
         return skill ? json(res, skill) : json(res, { error: "not found" }, 404);
     }
-    // GET/POST /api/team — member list / create a member
-    if (seg.length === 2 && seg[1] === "team") {
+    // GET/POST /api/agents — member list / create a member
+    if (seg.length === 2 && seg[1] === "agents") {
         if (method === "GET") {
-            return json(res, { root: await teamRoot(), members: await listMembers() });
+            return json(res, { root: await agentsRoot(), agents: await listAgents() });
         }
         if (method === "POST") {
             try {
                 const body = JSON.parse(await readBody(req));
-                return json(res, await saveMember({ ...body, slug: undefined }));
+                return json(res, await saveAgent({ ...body, slug: undefined }));
             }
             catch (err) {
                 return json(res, { error: err.message }, 400);
             }
         }
     }
-    // POST /api/team/:slug/archive — archive/unarchive a member ({ archived: boolean })
-    if (seg.length === 4 && seg[1] === "team" && seg[3] === "archive" && method === "POST") {
+    // POST /api/agents/:slug/archive — archive/unarchive a member ({ archived: boolean })
+    if (seg.length === 4 && seg[1] === "agents" && seg[3] === "archive" && method === "POST") {
         try {
             const body = JSON.parse(await readBody(req));
-            return json(res, await setMemberArchived(decodeURIComponent(seg[2]), body.archived === true));
+            return json(res, await setAgentArchived(decodeURIComponent(seg[2]), body.archived === true));
         }
         catch (err) {
             return json(res, { error: err.message }, 400);
         }
     }
-    // GET/POST /api/team/:slug/skills — the agent's own skills / create or update one
-    if (seg.length === 4 && seg[1] === "team" && seg[3] === "skills") {
+    // GET/POST /api/agents/:slug/skills — the agent's own skills / create or update one
+    if (seg.length === 4 && seg[1] === "agents" && seg[3] === "skills") {
         const slug = decodeURIComponent(seg[2]);
         try {
             if (method === "GET")
@@ -556,8 +603,8 @@ async function handleApi(req, res, url) {
             return json(res, { error: err.message }, 400);
         }
     }
-    // GET/DELETE /api/team/:slug/skills/:name — one agent skill with content / delete
-    if (seg.length === 5 && seg[1] === "team" && seg[3] === "skills") {
+    // GET/DELETE /api/agents/:slug/skills/:name — one agent skill with content / delete
+    if (seg.length === 5 && seg[1] === "agents" && seg[3] === "skills") {
         const slug = decodeURIComponent(seg[2]);
         const name = decodeURIComponent(seg[4]);
         try {
@@ -576,8 +623,8 @@ async function handleApi(req, res, url) {
             return json(res, { error: err.message }, 400);
         }
     }
-    // GET/POST /api/team/:slug/routines — list (with run state) / upsert
-    if (seg.length === 4 && seg[1] === "team" && seg[3] === "routines") {
+    // GET/POST /api/agents/:slug/routines — list (with run state) / upsert
+    if (seg.length === 4 && seg[1] === "agents" && seg[3] === "routines") {
         const slug = decodeURIComponent(seg[2]);
         try {
             if (method === "GET")
@@ -591,8 +638,8 @@ async function handleApi(req, res, url) {
             return json(res, { error: err.message }, 400);
         }
     }
-    // DELETE /api/team/:slug/routines/:id | POST /api/team/:slug/routines/:id/run
-    if (seg.length >= 5 && seg[1] === "team" && seg[3] === "routines") {
+    // DELETE /api/agents/:slug/routines/:id | POST /api/agents/:slug/routines/:id/run
+    if (seg.length >= 5 && seg[1] === "agents" && seg[3] === "routines") {
         const slug = decodeURIComponent(seg[2]);
         const id = decodeURIComponent(seg[4]);
         try {
@@ -608,20 +655,20 @@ async function handleApi(req, res, url) {
             return json(res, { error: err.message }, 400);
         }
     }
-    // GET/PUT/DELETE /api/team/:slug
-    if (seg.length === 3 && seg[1] === "team") {
+    // GET/PUT/DELETE /api/agents/:slug
+    if (seg.length === 3 && seg[1] === "agents") {
         const slug = decodeURIComponent(seg[2]);
         try {
             if (method === "GET") {
-                const member = await getMember(slug);
-                return member ? json(res, member) : json(res, { error: "not found" }, 404);
+                const agent = await getAgent(slug);
+                return agent ? json(res, agent) : json(res, { error: "not found" }, 404);
             }
             if (method === "PUT") {
                 const body = JSON.parse(await readBody(req));
-                return json(res, await saveMember({ ...body, slug }));
+                return json(res, await saveAgent({ ...body, slug }));
             }
             if (method === "DELETE") {
-                await deleteMember(slug);
+                await deleteAgent(slug);
                 return json(res, { ok: true });
             }
         }
@@ -643,13 +690,13 @@ async function handleApi(req, res, url) {
             }
             let agent = body.agent;
             let scope;
-            if (body.scope?.kind === "team" && body.scope.member) {
-                // Team sessions run on the member's configured harness.
-                const member = await getMember(body.scope.member).catch(() => null);
-                if (!member)
-                    return json(res, { error: "team agent not found" }, 404);
-                scope = { kind: "team", member: member.slug };
-                agent = member.harness;
+            if (body.scope?.kind === "agent" && body.scope.slug) {
+                // Agent sessions run on the agent's configured harness.
+                const def = await getAgent(body.scope.slug).catch(() => null);
+                if (!def)
+                    return json(res, { error: "agent not found" }, 404);
+                scope = { kind: "agent", slug: def.slug };
+                agent = def.harness;
             }
             else if (body.scope?.kind === "run" && body.scope.runId) {
                 scope = { kind: "run", runId: body.scope.runId };

package/dist/inspector/settings.d.ts

@@ -1,7 +1,7 @@
 import { type ProjectConfig, type SwitcherEntry } from "../config.js";
 /**
  * Workspace settings: read kraftwerk.yml for the UI and write the
- * UI-editable subset (name, icon, switcher, git) back. Edits go through the
+ * UI-editable subset (name, icon, switcher, git, repos) back. Edits go through the
  * yaml Document API so comments and every other key survive untouched;
  * a missing kraftwerk.yml is created at the project root on first save.
  */
@@ -24,6 +24,12 @@ export interface SaveSettingsInput {
     switcher?: SwitcherEntry[];
     /** Omitted = untouched. See cleanGit for how the block is written. */
     git?: GitSettingsInput;
+    /** Omitted = untouched. Same rules as git: off with defaults = no block. */
+    repos?: ReposSettingsInput;
+}
+export interface ReposSettingsInput {
+    enabled: boolean;
+    root?: string;
 }
 /** The git form as the settings screen posts it. Every field but `enabled` may be blank. */
 export interface GitSettingsInput {

package/dist/inspector/settings.js

@@ -1,8 +1,9 @@
 import { promises as fs } from "node:fs";
 import path from "node:path";
 import { parseDocument } from "yaml";
-import { resolveProject } from "../config.js";
+import { ignoreEntryFor, REPOS_DEFAULT_ROOT, resolveProject } from "../config.js";
 import { getProjectRoot } from "./context.js";
+import { ensureReposRoot } from "./repos.js";
 const GIT_DEFAULTS = { remote: "origin", interval: 300, autosync: "pull" };
 export async function getSettings() {
     const project = await resolveProject(getProjectRoot());
@@ -69,6 +70,25 @@ function cleanGit(value) {
         return null;
     return { enabled: false, ...out };
 }
+/** The repos block to write; null when the feature is off and nothing else is set. */
+function cleanRepos(value, projectRoot) {
+    if (typeof value !== "object" || value === null)
+        throw new Error("repos must be an object");
+    if (typeof value.enabled !== "boolean")
+        throw new Error("repos.enabled must be true or false");
+    const out = {};
+    const root = typeof value.root === "string" ? value.root.trim().replace(/\/+$/, "") : "";
+    if (root && !ignoreEntryFor(projectRoot, root)) {
+        throw new Error('repos.root must be a directory inside the project (not ".", ".." or an absolute path outside it)');
+    }
+    if (root && root !== REPOS_DEFAULT_ROOT)
+        out.root = root;
+    if (value.enabled)
+        return out;
+    if (Object.keys(out).length === 0)
+        return null;
+    return { enabled: false, ...out };
+}
 export async function saveSettings(input) {
     if (input.name !== undefined && typeof input.name !== "string")
         throw new Error("name must be a string");
@@ -99,6 +119,17 @@ export async function saveSettings(input) {
         else
             doc.set("git", git);
     }
+    if (input.repos !== undefined) {
+        const repos = cleanRepos(input.repos, project.root);
+        if (repos === null)
+            doc.delete("repos");
+        else
+            doc.set("repos", repos);
+    }
     await fs.writeFile(configPath, doc.toString());
+    // Turning repositories on prepares the folder so the first clone and the
+    // workspace git both find it in the right state.
+    if (input.repos?.enabled)
+        await ensureReposRoot().catch(() => { });
     return getSettings();
 }

package/dist/inspector/skills.d.ts

@@ -13,12 +13,12 @@
  * skill. Skills are surfaced to every chat as context (and expanded on
  * /<name> invocation), so they work identically on claude, codex, and pi.
  *
- * On top of the shared roots, each team agent can carry private skills in
+ * On top of the shared roots, each agent can carry private skills in
  *
  *   agents/<slug>/skills/<name>/SKILL.md            (agent, git-tracked)
  *
  * Agent skills are visible only to that agent's sessions, always apply
- * (the member's allowlist narrows shared skills only), and shadow
+ * (the agent's allowlist narrows shared skills only), and shadow
  * same-named shared skills.
  */
 export interface SkillInfo {
@@ -31,7 +31,7 @@ export interface SkillInfo {
     dir: string;
     /** workspace = kraftwerk skills root; project = .claude/skills; user = ~/.claude/skills; agent = agents/<slug>/skills. */
     source: "workspace" | "project" | "user" | "agent";
-    /** For source "agent": the owning member's slug. */
+    /** For source "agent": the owning agent's slug. */
     agent?: string;
 }
 export interface SkillDetail extends SkillInfo {
@@ -42,15 +42,15 @@ export interface SkillDetail extends SkillInfo {
 }
 /** Absolute workspace skills root (kraftwerk.yml `skills`, default skills/). */
 export declare function skillsRoot(): Promise<string>;
-/** The private skills root of one team agent: agents/<slug>/skills. */
+/** The private skills root of one agent: agents/<slug>/skills. */
 export declare function agentSkillsRoot(slug: string): Promise<string>;
 /** One agent's private skills (agents/<slug>/skills/<name>/SKILL.md). */
 export declare function listAgentSkills(slug: string): Promise<SkillInfo[]>;
 /**
- * All discovered skills; agent (when a member is given) shadows workspace
+ * All discovered skills; agent (when an agent slug is given) shadows workspace
  * shadows project shadows user (global).
  */
-export declare function listSkills(member?: string): Promise<SkillInfo[]>;
+export declare function listSkills(agent?: string): Promise<SkillInfo[]>;
 /** Create or update one agent skill; writes agents/<slug>/skills/<name>/SKILL.md. */
 export declare function saveAgentSkill(slug: string, name: string, content: string): Promise<SkillInfo & {
     content: string;

package/dist/inspector/skills.js

@@ -4,7 +4,7 @@ import path from "node:path";
 import { parse } from "yaml";
 import { resolveProject } from "../config.js";
 import { getProjectRoot } from "./context.js";
-import { safeMemberSlug, teamRoot } from "./team.js";
+import { safeAgentSlug, agentsRoot } from "./agents.js";
 const NAME_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/i;
 function frontmatter(md) {
     const m = /^---\r?\n([\s\S]*?)\r?\n---(\r?\n|$)/.exec(md);
@@ -58,9 +58,9 @@ async function scanRoot(root, source) {
     }));
     return skills.filter(Boolean).sort((a, b) => a.name.localeCompare(b.name));
 }
-/** The private skills root of one team agent: agents/<slug>/skills. */
+/** The private skills root of one agent: agents/<slug>/skills. */
 export async function agentSkillsRoot(slug) {
-    return path.join(await teamRoot(), safeMemberSlug(slug), "skills");
+    return path.join(await agentsRoot(), safeAgentSlug(slug), "skills");
 }
 /** One agent's private skills (agents/<slug>/skills/<name>/SKILL.md). */
 export async function listAgentSkills(slug) {
@@ -68,17 +68,17 @@ export async function listAgentSkills(slug) {
     return skills.map((s) => ({ ...s, agent: slug }));
 }
 /**
- * All discovered skills; agent (when a member is given) shadows workspace
+ * All discovered skills; agent (when an agent slug is given) shadows workspace
  * shadows project shadows user (global).
  */
-export async function listSkills(member) {
-    const [agent, workspace, project, user] = await Promise.all([
-        member ? listAgentSkills(member).catch(() => []) : [],
+export async function listSkills(agent) {
+    const [own, workspace, project, user] = await Promise.all([
+        agent ? listAgentSkills(agent).catch(() => []) : [],
         skillsRoot().then((root) => scanRoot(root, "workspace")),
         scanRoot(path.join(getProjectRoot(), ".claude", "skills"), "project"),
         scanRoot(path.join(os.homedir(), ".claude", "skills"), "user"),
     ]);
-    const out = [...agent];
+    const out = [...own];
     const seen = new Set(out.map((s) => s.name.toLowerCase()));
     for (const s of [...workspace, ...project, ...user]) {
         if (seen.has(s.name.toLowerCase()))