@netnodeag/kraftwerk 0.14.1 → 0.15.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/server.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") {