@netnodeag/kraftwerk 0.14.2 → 0.16.0

package/README.md

@@ -96,6 +96,16 @@ directory, default `output/`), `knowledge:` (OKF knowledge-bundle root,
 default `knowledge/`), and `agents:` (team agent-definition root, default
 `agents/`).
 
+`switcher:` links other kraftwerk workspaces from the inspector header —
+the workspace name becomes a dropdown listing them:
+
+```yaml
+switcher:
+  - name: other space
+    url: https://localhost:1985
+    icon: "🛰"   # optional
+```
+
 ### Triggering from CI / cron / webhooks
 
 `run --json` is the machine mode: non-interactive, one JSON result object

package/dist/config.d.ts

@@ -17,12 +17,25 @@
  *   knowledge: knowledge       # OKF knowledge-bundle root, relative to the file
  *   agents: agents             # team agent-definition root, relative to the file
  *   skills: skills             # workspace skill root, relative to the file
+ *   switcher:                  # other kraftwerk workspaces, linked from the header dropdown
+ *     - name: other space
+ *       url: https://localhost:1985
+ *       icon: "🛰"              # optional emoji shown next to the entry
  */
 /** Stable, versionless URL of the workflow JSON schema (editor validation). */
 export declare const SCHEMA_URL = "https://raw.githubusercontent.com/NETNODEAG/kraftwerk/main/kraftwerk/schema/workflow.schema.json";
 /** Stable, versionless URL of the kraftwerk.yml JSON schema (editor validation). */
 export declare const CONFIG_SCHEMA_URL = "https://raw.githubusercontent.com/NETNODEAG/kraftwerk/main/kraftwerk/schema/kraftwerk.schema.json";
 export declare const CONFIG_FILENAMES: string[];
+/** One entry of the workspace switcher: another kraftwerk instance to link to. */
+export interface SwitcherEntry {
+    /** Display name of the other workspace. */
+    name: string;
+    /** URL the other workspace's inspector runs on, e.g. https://localhost:1985 */
+    url: string;
+    /** Optional emoji shown next to the entry. */
+    icon?: string;
+}
 export interface ProjectConfig {
     /** Display name of the project ("environment"), shown in the inspector header. */
     name?: string;
@@ -40,6 +53,8 @@ export interface ProjectConfig {
     agents?: string;
     /** Workspace skill root relative to the project root. Default: skills */
     skills?: string;
+    /** Other kraftwerk workspaces, shown as a switcher dropdown in the inspector header. */
+    switcher?: SwitcherEntry[];
 }
 export interface Project {
     /** Absolute project root the CLI operates on. */

package/dist/config.js

@@ -20,6 +20,10 @@ import { parse } from "yaml";
  *   knowledge: knowledge       # OKF knowledge-bundle root, relative to the file
  *   agents: agents             # team agent-definition root, relative to the file
  *   skills: skills             # workspace skill root, relative to the file
+ *   switcher:                  # other kraftwerk workspaces, linked from the header dropdown
+ *     - name: other space
+ *       url: https://localhost:1985
+ *       icon: "🛰"              # optional emoji shown next to the entry
  */
 /** Stable, versionless URL of the workflow JSON schema (editor validation). */
 export const SCHEMA_URL = "https://raw.githubusercontent.com/NETNODEAG/kraftwerk/main/kraftwerk/schema/workflow.schema.json";
@@ -89,10 +93,10 @@ async function loadConfig(configPath) {
     if (raw === null || raw === undefined)
         return {};
     if (typeof raw !== "object" || Array.isArray(raw)) {
-        throw new Error(`${path.basename(configPath)}: expected a mapping (name, icon, port, workflows, output, knowledge, agents, skills)`);
+        throw new Error(`${path.basename(configPath)}: expected a mapping (name, icon, port, workflows, output, knowledge, agents, skills, switcher)`);
     }
     const config = raw;
-    const known = ["name", "icon", "port", "workflows", "output", "knowledge", "agents", "skills"];
+    const known = ["name", "icon", "port", "workflows", "output", "knowledge", "agents", "skills", "switcher"];
     for (const key of Object.keys(config)) {
         if (!known.includes(key)) {
             throw new Error(`${path.basename(configPath)}: unknown key "${key}" (allowed: ${known.join(", ")})`);
@@ -102,9 +106,38 @@ async function loadConfig(configPath) {
                 throw new Error(`${path.basename(configPath)}: port must be an integer`);
             }
         }
+        else if (key === "switcher") {
+            validateSwitcher(configPath, config[key]);
+        }
         else if (typeof config[key] !== "string") {
             throw new Error(`${path.basename(configPath)}: ${key} must be a string`);
         }
     }
     return config;
 }
+function validateSwitcher(configPath, value) {
+    const file = path.basename(configPath);
+    if (!Array.isArray(value)) {
+        throw new Error(`${file}: switcher must be a list of { name, url, icon? } entries`);
+    }
+    value.forEach((entry, i) => {
+        if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
+            throw new Error(`${file}: switcher[${i}] must be a mapping with name and url`);
+        }
+        const e = entry;
+        for (const key of Object.keys(e)) {
+            if (!["name", "url", "icon"].includes(key)) {
+                throw new Error(`${file}: switcher[${i}]: unknown key "${key}" (allowed: name, url, icon)`);
+            }
+        }
+        if (typeof e.name !== "string" || !e.name.trim()) {
+            throw new Error(`${file}: switcher[${i}]: name must be a non-empty string`);
+        }
+        if (typeof e.url !== "string" || !/^https?:\/\//.test(e.url)) {
+            throw new Error(`${file}: switcher[${i}]: url must be an http(s) URL`);
+        }
+        if (e.icon !== undefined && typeof e.icon !== "string") {
+            throw new Error(`${file}: switcher[${i}]: icon must be a string`);
+        }
+    });
+}

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

@@ -1,4 +1,6 @@
 import type { ChatAgentId, ChatMeta, ChatScope, StoredChatEvent } from "./types.js";
+/** Server shutdown: no agent subprocess may outlive the inspector. */
+export declare function disposeAllBackends(): void;
 export declare function createChat(opts: {
     agent: ChatAgentId;
     scope: ChatScope;

package/dist/inspector/chat/sessions.js

@@ -10,6 +10,32 @@ import { startAcpBackend } from "./acp.js";
 import { startPiBackend } from "./pi.js";
 import { appendEvent, listChatMetas, newChatId, readEvents, readMeta, safeChatDir, writeMeta, } from "./store.js";
 const states = new Map();
+/** Kill a chat's agent subprocess; the next message spawns a fresh one. */
+function dropBackend(state) {
+    state.backend?.dispose();
+    state.backend = null;
+}
+// Idle reaper: a finished chat must not keep its agent subprocess alive
+// forever (one ACP adapter + one harness binary per chat adds up fast —
+// hourly routines used to leak a process pair per tick). History is on
+// disk and ensureBackend re-sends scope context, so reaping just costs
+// the next message one respawn. busy=true covers the whole turn including
+// pending permission prompts, so nothing is killed mid-work.
+const IDLE_BACKEND_MS = 15 * 60_000;
+const reaper = setInterval(() => {
+    const cutoff = Date.now() - IDLE_BACKEND_MS;
+    for (const state of states.values()) {
+        if (state.backend && !state.busy && Date.parse(state.meta.updatedAt) < cutoff) {
+            dropBackend(state);
+        }
+    }
+}, 60_000);
+reaper.unref?.();
+/** Server shutdown: no agent subprocess may outlive the inspector. */
+export function disposeAllBackends() {
+    for (const state of states.values())
+        dropBackend(state);
+}
 async function loadState(id) {
     const existing = states.get(id);
     if (existing)
@@ -387,13 +413,17 @@ export async function postMessage(id, text) {
             const promptText = context ? `<context>\n${context}\n</context>\n\n${body}` : body;
             const stopReason = await backend.prompt(promptText);
             emit(state, { type: "turn_end", stopReason });
+            // Routine sessions are one-shot and unattended: release the agent
+            // process as soon as the turn ends instead of waiting for the reaper.
+            const scope = state.meta.scope;
+            if (scope.kind === "team" && scope.routine)
+                dropBackend(state);
         }
         catch (err) {
             emit(state, { type: "error", message: err.message });
             // A failed turn may mean a dead subprocess; drop it so the next
             // message spawns a fresh agent (thread history stays on disk).
-            state.backend?.dispose();
-            state.backend = null;
+            dropBackend(state);
         }
         finally {
             state.busy = false;
@@ -419,7 +449,7 @@ export async function deleteChat(id) {
         return { error: "not found" };
     for (const resolve of state.pendingPermissions.values())
         resolve(null);
-    state.backend?.dispose();
+    dropBackend(state);
     states.delete(id);
     await fs.rm(safeChatDir(id), { recursive: true, force: true });
     return {};

package/dist/inspector/server.js

@@ -6,7 +6,7 @@ import { resolveProject } from "../config.js";
 import { listRuns, getRun, readRunFile } from "./runs.js";
 import { listWorkflows, getWorkflow } from "./workflows.js";
 import { dockerStatus, triggerRun, stopRun } from "./runner.js";
-import { cancelChat, createChat, deleteChat, getChat, listChats, postMessage, resolvePermission, subscribeChat, } from "./chat/sessions.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 { getSkill, listSkills, skillsRoot } from "./skills.js";
@@ -76,7 +76,12 @@ async function handleApi(req, res, url) {
     if (seg.length === 2 && seg[1] === "meta" && method === "GET") {
         const project = await resolveProject(getProjectRoot()).catch(() => null);
         const projectName = project?.config.name ?? (project ? path.basename(project.root) : "");
-        return json(res, { version: await getPkgVersion(), projectName, projectIcon: project?.config.icon ?? "" });
+        return json(res, {
+            version: await getPkgVersion(),
+            projectName,
+            projectIcon: project?.config.icon ?? "",
+            switcher: project?.config.switcher ?? [],
+        });
     }
     // GET /api/runs
     if (seg.length === 2 && seg[1] === "runs" && method === "GET") {
@@ -483,6 +488,15 @@ export function startInspector(opts) {
     if (opts.projectRoot)
         setProjectRoot(opts.projectRoot);
     startRoutineScheduler();
+    // Chat agent subprocesses must die with the server — signals bypass
+    // "exit" handlers, so hook the signals themselves.
+    for (const sig of ["SIGINT", "SIGTERM"]) {
+        process.once(sig, () => {
+            disposeAllBackends();
+            process.exit(sig === "SIGINT" ? 130 : 143);
+        });
+    }
+    process.once("exit", disposeAllBackends);
     const server = http.createServer(async (req, res) => {
         try {
             const url = new URL(req.url ?? "/", "http://localhost");