@netnodeag/kraftwerk 0.24.0 → 0.26.0

package/dist/inspector/server.js

@@ -8,9 +8,10 @@ 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, teamRoot, } from "./team.js";
+import { deleteMember, getMember, listMembers, saveMember, setMemberArchived, teamRoot, } from "./team.js";
 import { deleteAgentSkill, getSkill, listAgentSkills, listSkills, readSkill, saveAgentSkill, skillsRoot, } from "./skills.js";
 import { discoverInstances, registerInstance, unregisterInstance } from "./instances.js";
+import { getSettings, saveSettings } from "./settings.js";
 import { deleteRoutine, routineStatuses, runRoutineNow, saveRoutine, startRoutineScheduler, } from "./routines.js";
 /**
  * The inspector server: a plain node:http server with no dependencies.
@@ -118,6 +119,20 @@ async function handleApi(req, res, url) {
             switcher,
         });
     }
+    // GET /api/settings — kraftwerk.yml (parsed + resolved paths) for the settings page
+    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) back
+    if (seg.length === 2 && seg[1] === "settings" && method === "PUT") {
+        try {
+            const input = JSON.parse(await readBody(req));
+            return json(res, await saveSettings(input));
+        }
+        catch (err) {
+            return json(res, { error: err.message }, 400);
+        }
+    }
     // GET /api/update-check — ask the npm registry for the latest published version
     if (seg.length === 2 && seg[1] === "update-check" && method === "GET") {
         const name = await getPkgName();
@@ -343,6 +358,16 @@ async function handleApi(req, res, url) {
             }
         }
     }
+    // POST /api/team/:slug/archive — archive/unarchive a member ({ archived: boolean })
+    if (seg.length === 4 && seg[1] === "team" && seg[3] === "archive" && method === "POST") {
+        try {
+            const body = JSON.parse(await readBody(req));
+            return json(res, await setMemberArchived(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") {
         const slug = decodeURIComponent(seg[2]);

package/dist/inspector/settings.d.ts

@@ -0,0 +1,27 @@
+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) 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.
+ */
+export interface SettingsView {
+    root: string;
+    configPath: string;
+    exists: boolean;
+    config: ProjectConfig;
+    resolved: {
+        workflowsRoot: string | null;
+        outputDir: string;
+        port: number;
+    };
+}
+export interface SaveSettingsInput {
+    /** Omitted = untouched; empty string = remove the key. */
+    name?: string;
+    icon?: string;
+    /** Omitted = untouched; empty list = remove the key. */
+    switcher?: SwitcherEntry[];
+}
+export declare function getSettings(): Promise<SettingsView>;
+export declare function saveSettings(input: SaveSettingsInput): Promise<SettingsView>;

package/dist/inspector/settings.js

@@ -0,0 +1,59 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { parseDocument } from "yaml";
+import { resolveProject } from "../config.js";
+import { getProjectRoot } from "./context.js";
+export async function getSettings() {
+    const project = await resolveProject(getProjectRoot());
+    return {
+        root: project.root,
+        configPath: project.configPath ?? path.join(project.root, "kraftwerk.yml"),
+        exists: !!project.configPath,
+        config: project.config,
+        resolved: {
+            workflowsRoot: project.workflowsRoot ?? null,
+            outputDir: project.outputDir,
+            port: project.config.port ?? 1981,
+        },
+    };
+}
+function cleanSwitcher(value) {
+    if (!Array.isArray(value))
+        throw new Error("switcher must be a list");
+    return value.map((entry, i) => {
+        const name = typeof entry?.name === "string" ? entry.name.trim() : "";
+        const url = typeof entry?.url === "string" ? entry.url.trim() : "";
+        if (!name)
+            throw new Error(`switcher entry ${i + 1}: name is required`);
+        if (!/^https?:\/\//.test(url))
+            throw new Error(`switcher entry ${i + 1}: url must start with http:// or https://`);
+        const icon = typeof entry.icon === "string" ? entry.icon.trim() : "";
+        return icon ? { name, url, icon } : { name, url };
+    });
+}
+export async function saveSettings(input) {
+    if (input.name !== undefined && typeof input.name !== "string")
+        throw new Error("name must be a string");
+    if (input.icon !== undefined && typeof input.icon !== "string")
+        throw new Error("icon must be a string");
+    const switcher = input.switcher === undefined ? undefined : cleanSwitcher(input.switcher);
+    const project = await resolveProject(getProjectRoot());
+    const configPath = project.configPath ?? path.join(project.root, "kraftwerk.yml");
+    const raw = project.configPath ? await fs.readFile(configPath, "utf8") : "";
+    const doc = parseDocument(raw);
+    if (doc.errors.length > 0)
+        throw new Error(`${path.basename(configPath)}: ${doc.errors[0].message}`);
+    const setOrDelete = (key, value) => {
+        if (value === undefined)
+            return; // untouched
+        if (value === "" || (Array.isArray(value) && value.length === 0))
+            doc.delete(key);
+        else
+            doc.set(key, value);
+    };
+    setOrDelete("name", input.name?.trim());
+    setOrDelete("icon", input.icon?.trim());
+    setOrDelete("switcher", switcher);
+    await fs.writeFile(configPath, doc.toString());
+    return getSettings();
+}

package/dist/inspector/team.d.ts

@@ -30,6 +30,8 @@ export interface TeamMember {
      * Absent = all discovered skills; empty list = no skills.
      */
     skills?: string[];
+    /** Archived: hidden from the active roster, restorable any time. */
+    archived?: boolean;
 }
 export interface TeamMemberDetail extends TeamMember {
     /** Contents of system.md — the member's system prompt. */
@@ -58,4 +60,6 @@ export interface SaveMemberInput {
     system?: string;
 }
 export declare function saveMember(input: SaveMemberInput): Promise<TeamMemberDetail>;
+/** Archive/unarchive a member: toggles `archived:` in agent.yml, nothing else. */
+export declare function setMemberArchived(slug: string, archived: boolean): Promise<TeamMemberDetail>;
 export declare function deleteMember(slug: string): Promise<void>;

package/dist/inspector/team.js

@@ -52,6 +52,7 @@ function normalize(slug, raw) {
         workflows: Array.isArray(raw.workflows) ? raw.workflows.map(String) : [],
         knowledge: Array.isArray(raw.knowledge) ? raw.knowledge.map(String) : [],
         ...(Array.isArray(raw.skills) ? { skills: raw.skills.map(String) } : {}),
+        ...(raw.archived === true ? { archived: true } : {}),
     };
 }
 export async function listMembers() {
@@ -101,6 +102,11 @@ export async function saveMember(input) {
     const slug = input.slug ? safeMemberSlug(input.slug) : slugFromName(name);
     const dir = path.join(await teamRoot(), slug);
     await fs.mkdir(dir, { recursive: true });
+    // Profile edits must not silently unarchive: carry the flag over.
+    const existing = await fs
+        .readFile(path.join(dir, "agent.yml"), "utf8")
+        .then((raw) => (parse(raw) ?? {}))
+        .catch(() => null);
     const yml = {
         name,
         emoji: input.emoji?.trim() || "🤖",
@@ -112,11 +118,30 @@ export async function saveMember(input) {
         workflows: (input.workflows ?? []).map(String),
         knowledge: (input.knowledge ?? []).map(String),
         ...(input.skills ? { skills: input.skills.map(String) } : {}),
+        ...(existing?.archived === true ? { archived: true } : {}),
     };
     await fs.writeFile(path.join(dir, "agent.yml"), stringify(yml));
     await fs.writeFile(path.join(dir, "system.md"), (input.system ?? "").trim() + "\n");
     return (await getMember(slug));
 }
+/** Archive/unarchive a member: toggles `archived:` in agent.yml, nothing else. */
+export async function setMemberArchived(slug, archived) {
+    const dir = path.join(await teamRoot(), safeMemberSlug(slug));
+    let raw;
+    try {
+        raw = (parse(await fs.readFile(path.join(dir, "agent.yml"), "utf8")) ?? {});
+    }
+    catch {
+        throw new Error("agent not found");
+    }
+    const yml = { ...raw };
+    if (archived)
+        yml.archived = true;
+    else
+        delete yml.archived;
+    await fs.writeFile(path.join(dir, "agent.yml"), stringify(yml));
+    return (await getMember(slug));
+}
 export async function deleteMember(slug) {
     const dir = path.join(await teamRoot(), safeMemberSlug(slug));
     await fs.rm(dir, { recursive: true, force: true });