@netnodeag/kraftwerk 0.35.0 → 0.36.0

package/dist/inspector/chat/store.js

@@ -26,12 +26,24 @@ export async function writeMeta(meta) {
 }
 export async function readMeta(id) {
     try {
-        return JSON.parse(await fs.readFile(path.join(safeChatDir(id), "meta.json"), "utf8"));
+        return upgradeMeta(JSON.parse(await fs.readFile(path.join(safeChatDir(id), "meta.json"), "utf8")));
     }
     catch {
         return null;
     }
 }
+/**
+ * Chats written before 0.36 scoped agent sessions as
+ * { kind: "team", member } — read them as { kind: "agent", slug } so the
+ * folders on disk never need rewriting.
+ */
+function upgradeMeta(meta) {
+    const legacy = meta.scope;
+    if (legacy?.kind === "team" && typeof legacy.member === "string") {
+        meta.scope = { kind: "agent", slug: legacy.member, ...(legacy.routine ? { routine: legacy.routine } : {}) };
+    }
+    return meta;
+}
 export async function appendEvent(id, ev) {
     await fs.appendFile(path.join(safeChatDir(id), "events.jsonl"), JSON.stringify(ev) + "\n");
 }

package/dist/inspector/chat/types.d.ts

@@ -17,8 +17,8 @@ export type ChatScope = {
     kind: "knowledge";
     bundle?: string;
 } | {
-    kind: "team";
-    member: string;
+    kind: "agent";
+    slug: string;
     routine?: string;
 };
 export interface ChatMeta {

package/dist/inspector/instances.d.ts

@@ -1,3 +1,4 @@
+import type { AgentSummary } from "./agents.js";
 /** Durable per-project record. The root is the key; everything else derives from it. */
 export interface ProjectRecord {
     root: string;
@@ -6,6 +7,8 @@ export interface ProjectRecord {
     /** Set on clean shutdown; older than lastStarted means the last run died. */
     lastStopped?: string;
     startCount: number;
+    /** Active agents, as last seen by the instance serving this root. */
+    agents?: AgentSummary[];
 }
 /** A verified running instance, shaped like a switcher entry. */
 export interface DiscoveredInstance {
@@ -39,12 +42,21 @@ export interface WorkspaceEntry {
 export declare const tildify: (p: string) => string;
 /** Write this instance's registry file (call once the server listens). */
 export declare function registerInstance(port: number, root: string): Promise<void>;
+/** Where this instance answers, as the switcher links it (null before listen). */
+export declare const currentInstanceUrl: () => string | null;
 /** Remove this instance's registry file. Sync so exit handlers can call it. */
 export declare function unregisterInstance(): void;
 /** All other running instances, verified live. Cached briefly — /api/meta is polled. */
 export declare function discoverInstances(): Promise<DiscoveredInstance[]>;
 /** Upsert the project record for a root (call on every inspector start). */
 export declare function registerProject(root: string): Promise<void>;
+/**
+ * Write the roster into the project's record. Called on every roster read
+ * (the UI polls it, routines tick it), so a record only changes when the
+ * roster did. Roots with no record (a CLI run in a project that never
+ * started the inspector) are left alone.
+ */
+export declare function syncProjectAgents(root: string, agents: AgentSummary[]): Promise<void>;
 /** Stamp lastStopped on clean shutdown. Sync so exit handlers can call it. */
 export declare function markProjectStopped(): void;
 /** All known projects, most recently started first. */

package/dist/inspector/instances.js

@@ -20,6 +20,9 @@ import { selfCommand } from "./self-command.js";
  * the root's kraftwerk.yml at read time, so it is always current. A
  * project that is not running can be started again from the switcher or
  * `kraftwerk projects start` — that is what makes a killed UI findable.
+ * The record also carries the project's agent roster (written whenever the
+ * instance reads it), so the ⌘K palette can list every workspace's agents
+ * from a handful of small files without probing anything.
  */
 const HOME = path.join(os.homedir(), ".kraftwerk");
 const INSTANCES_DIR = path.join(HOME, "instances");
@@ -47,6 +50,8 @@ export async function registerInstance(port, root) {
     }
     catch { } // best-effort — without it discovery just won't see us
 }
+/** Where this instance answers, as the switcher links it (null before listen). */
+export const currentInstanceUrl = () => (selfPort ? `http://localhost:${selfPort}` : null);
 /** Remove this instance's registry file. Sync so exit handlers can call it. */
 export function unregisterInstance() {
     try {
@@ -137,6 +142,7 @@ async function readProject(file) {
             lastStarted: rec.lastStarted ?? rec.firstSeen ?? "",
             lastStopped: rec.lastStopped,
             startCount: rec.startCount ?? 1,
+            ...(Array.isArray(rec.agents) ? { agents: rec.agents } : {}),
         };
     }
     catch {
@@ -155,11 +161,33 @@ export async function registerProject(root) {
             firstSeen: prev?.firstSeen || now,
             lastStarted: now,
             startCount: (prev?.startCount ?? 0) + 1,
+            ...(prev?.agents ? { agents: prev.agents } : {}),
         };
         await fs.writeFile(projectFile(abs), JSON.stringify(rec, null, 2));
     }
     catch { } // best-effort, like the instance file
 }
+let syncedAgents = "";
+/**
+ * Write the roster into the project's record. Called on every roster read
+ * (the UI polls it, routines tick it), so a record only changes when the
+ * roster did. Roots with no record (a CLI run in a project that never
+ * started the inspector) are left alone.
+ */
+export async function syncProjectAgents(root, agents) {
+    const key = `${root}\n${JSON.stringify(agents)}`;
+    if (key === syncedAgents)
+        return;
+    try {
+        const file = projectFile(root);
+        const rec = await readProject(file);
+        if (!rec)
+            return;
+        await fs.writeFile(file, JSON.stringify({ ...rec, agents }, null, 2));
+        syncedAgents = key;
+    }
+    catch { }
+}
 /** Stamp lastStopped on clean shutdown. Sync so exit handlers can call it. */
 export function markProjectStopped() {
     if (!selfRoot)

package/dist/inspector/routines.d.ts

@@ -1,14 +1,14 @@
 /**
- * Routines: per-team-member scheduled prompts — "message your agent every
- * weekday at 9". Definitions live next to the member (git-tracked):
+ * Routines: per-agent scheduled prompts — "message your agent every
+ * weekday at 9". Definitions live next to the agent (git-tracked):
  *
  *   agents/<slug>/routines.yml    # list of { id, name, schedule, prompt, enabled }
  *
  * Runtime state (last run / last session / errors) is run-state, not
  * config, so it lives in <output>/routines-state.json. The scheduler is a
  * plain interval inside the inspector server: each due routine opens a new
- * session (chat) for the member and posts the prompt — the run shows up in
- * the member's sessions sidebar like any conversation. Schedules use
+ * session (chat) for the agent and posts the prompt — the run shows up in
+ * the agent's sessions sidebar like any conversation. Schedules use
  * standard 5-field cron in the server's local time.
  */
 export interface Routine {

package/dist/inspector/routines.js

@@ -2,7 +2,7 @@ import { promises as fs } from "node:fs";
 import path from "node:path";
 import { parse, stringify } from "yaml";
 import { getOutputDir } from "./context.js";
-import { getMember, listMembers, safeMemberSlug, teamRoot } from "./team.js";
+import { getAgent, listAgents, safeAgentSlug, agentsRoot } from "./agents.js";
 import { createChat, postMessage } from "./chat/sessions.js";
 /* ---------- cron ---------- */
 const ALIASES = {
@@ -86,7 +86,7 @@ export function nextRun(schedule, from = new Date()) {
 }
 /* ---------- definition CRUD (agents/<slug>/routines.yml) ---------- */
 async function routinesFile(slug) {
-    return path.join(await teamRoot(), safeMemberSlug(slug), "routines.yml");
+    return path.join(await agentsRoot(), safeAgentSlug(slug), "routines.yml");
 }
 function normalizeRoutine(raw) {
     const id = String(raw.id ?? "").trim();
@@ -179,14 +179,14 @@ export async function routineStatuses(slug) {
     });
 }
 /* ---------- firing ---------- */
-/** Open a fresh session for the member and post the routine's prompt. */
+/** Open a fresh session for the agent and post the routine's prompt. */
 async function fireRoutine(slug, routine) {
-    const member = await getMember(slug);
-    if (!member)
-        throw new Error(`team agent "${slug}" not found`);
+    const def = await getAgent(slug);
+    if (!def)
+        throw new Error(`agent "${slug}" not found`);
     const meta = await createChat({
-        agent: member.harness,
-        scope: { kind: "team", member: slug, routine: routine.id },
+        agent: def.harness,
+        scope: { kind: "agent", slug: slug, routine: routine.id },
         title: `⏰ ${routine.name}`,
     });
     const { error } = await postMessage(meta.id, routine.prompt);
@@ -219,16 +219,16 @@ async function tick() {
     const now = new Date();
     const p = (n) => String(n).padStart(2, "0");
     const minuteKey = `${now.getFullYear()}-${p(now.getMonth() + 1)}-${p(now.getDate())}T${p(now.getHours())}:${p(now.getMinutes())}`;
-    let members;
+    let agents;
     try {
-        members = await listMembers();
+        agents = await listAgents();
     }
     catch {
         return;
     }
     const state = await readState();
     let dirty = false;
-    for (const m of members) {
+    for (const m of agents) {
         for (const r of await listRoutines(m.slug).catch(() => [])) {
             if (!r.enabled)
                 continue;

package/dist/inspector/search.d.ts

@@ -0,0 +1,25 @@
+import { type AgentSummary } from "./agents.js";
+/**
+ * The ⌘K palette: every active agent in every workspace this machine
+ * knows, so a user can jump to one without switching workspaces first.
+ * This instance reads its own roster from disk; the others come from the
+ * project registry, where each instance records its roster whenever it
+ * reads it (see instances.ts). Stopped workspaces are listed too — the
+ * palette starts them on the way to the agent.
+ */
+export interface WorkspaceAgents {
+    name: string;
+    icon?: string;
+    /** Where the workspace's UI lives — hits link to `${url}/#/agents/<slug>`. */
+    url: string;
+    /** Project root (what /api/projects/start takes for a stopped workspace). */
+    root?: string;
+    /** The instance answering this request: hits navigate in place. */
+    current: boolean;
+    live: boolean;
+    agents: AgentSummary[];
+}
+export interface AgentSearch {
+    workspaces: WorkspaceAgents[];
+}
+export declare function searchAgents(): Promise<AgentSearch>;

package/dist/inspector/search.js

@@ -0,0 +1,31 @@
+import path from "node:path";
+import { resolveProject } from "../config.js";
+import { getProjectRoot } from "./context.js";
+import { listAgents, toSummary } from "./agents.js";
+import { currentInstanceUrl, discoverWorkspaces, listProjects } from "./instances.js";
+export async function searchAgents() {
+    const project = await resolveProject(getProjectRoot()).catch(() => null);
+    const self = {
+        name: project?.config.name ?? path.basename(project?.root ?? getProjectRoot()),
+        icon: project?.config.icon || undefined,
+        url: currentInstanceUrl() ?? "",
+        root: project?.root ?? getProjectRoot(),
+        current: true,
+        live: true,
+        agents: (await listAgents().catch(() => [])).filter((a) => !a.archived).map(toSummary),
+    };
+    const [workspaces, projects] = await Promise.all([discoverWorkspaces(), listProjects()]);
+    const rosters = new Map(projects.map((p) => [p.root, p.agents ?? []]));
+    const others = workspaces
+        .filter((w) => w.root && w.exists !== false)
+        .map((w) => ({
+        name: w.name,
+        icon: w.icon,
+        url: w.url,
+        root: w.root,
+        current: false,
+        live: w.live,
+        agents: rosters.get(w.root) ?? [],
+    }));
+    return { workspaces: [self, ...others] };
+}

package/dist/inspector/server.js

@@ -8,11 +8,12 @@ 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 { searchAgents } from "./search.js";
 import { deleteRoutine, routineStatuses, runRoutineNow, saveRoutine, startRoutineScheduler, } from "./routines.js";
 /**
  * The inspector server: a plain node:http server with no dependencies.
@@ -249,6 +250,10 @@ async function handleApi(req, res, url) {
         const result = await run();
         return json(res, result, result.ok ? 200 : 409);
     }
+    // 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());
@@ -516,33 +521,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 +561,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 +581,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 +596,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 +613,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 +648,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/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()))