agent-relay-server 0.16.0 → 0.17.0

package/docs/openapi.json

@@ -2,7 +2,7 @@
   "openapi": "3.1.0",
   "info": {
     "title": "Agent Relay API",
-    "version": "0.12.4",
+    "version": "0.16.0",
     "description": "Real-time message bus for inter-agent communication. Agent-first: this spec is designed for machine consumption — agents can self-discover the full API surface via GET /api/spec.",
     "license": {
       "name": "MIT",
@@ -5957,6 +5957,100 @@
         ]
       }
     },
+    "/api/workspace-config": {
+      "get": {
+        "operationId": "getWorkspaceConfigRoute",
+        "summary": "Get global workspace (isolated worktree) config",
+        "tags": [
+          "Other"
+        ],
+        "description": "Returns the global workspace provisioning config `{ symlinkPaths: string[] }` — untracked files/filename patterns symlinked from the main checkout into each isolated worktree (the dashboard \"Workspace\" spawn option). Defaults seed `AGENTS.md` and `.claude-rig`; merged over defaults until set.",
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {}
+            }
+          },
+          "400": {
+            "description": "Bad request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": []
+          },
+          {
+            "tokenHeader": []
+          },
+          {
+            "tokenQuery": []
+          }
+        ]
+      },
+      "put": {
+        "operationId": "putWorkspaceConfigRoute",
+        "summary": "Set global workspace (isolated worktree) config",
+        "tags": [
+          "Other"
+        ],
+        "description": "Updates the global workspace config. Body: `{ value: { symlinkPaths: [...] }, updatedBy? }`. Each entry is a relative path or glob pattern; plain names match files and directories, entries with `*?[]{}` are expanded against main. A path is only linked if it exists in main — missing entries are ignored at spawn time. Rejects absolute paths and `..` traversal (400). Versioned with full config history.",
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "value": {
+                    "type": "string"
+                  },
+                  "updatedBy": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Success",
+            "content": {
+              "application/json": {}
+            }
+          },
+          "400": {
+            "description": "Bad request",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/Error"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearerAuth": []
+          },
+          {
+            "tokenHeader": []
+          },
+          {
+            "tokenQuery": []
+          }
+        ]
+      }
+    },
     "/api/insights/config": {
       "get": {
         "operationId": "getInsightsConfigRoute",
@@ -6143,6 +6237,9 @@
                   },
                   "source": {
                     "type": "string"
+                  },
+                  "occurredAt": {
+                    "type": "string"
                   }
                 }
               }
@@ -7217,6 +7314,9 @@
                   "maxAgeSeconds": {
                     "type": "string"
                   },
+                  "occurredAt": {
+                    "type": "string"
+                  },
                   "channel": {
                     "type": "string"
                   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay-server",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Lightweight HTTP message relay for inter-agent communication across machines",
   "module": "src/index.ts",
   "type": "module",
@@ -33,7 +33,7 @@
     "CONTRIBUTING.md"
   ],
   "dependencies": {
-    "agent-relay-sdk": "0.2.7"
+    "agent-relay-sdk": "0.2.8"
   },
   "scripts": {
     "prepack": "bun run build:dashboard:bundle >&2",

package/public/index.html

@@ -125641,6 +125641,9 @@ function chatTimestamp(iso) {
 		minute: "2-digit"
 	});
 }
+function messageEventTime(msg) {
+	return new Date(msg.occurredAt ?? msg.createdAt).getTime();
+}
 function dateSeparatorLabel(dateStr) {
 	const today = /* @__PURE__ */ new Date();
 	const [y, m, d] = dateStr.split("-").map(Number);
@@ -126444,7 +126447,7 @@ var MessageBubble = (0, import_react.memo)(function MessageBubble({ msg, peer, o
 	const pointerStartRef = (0, import_react.useRef)(null);
 	const suppressBubbleClickRef = (0, import_react.useRef)(false);
 	const body = messageBody(msg);
-	const time = chatTimestamp(msg.createdAt);
+	const time = chatTimestamp(msg.occurredAt ?? msg.createdAt);
 	const attachments = messageAttachments(msg);
 	const reactions = groupedReactions(msg);
 	const receipt = isOutbound ? outboundReceipt(msg, peer) : null;
@@ -126580,7 +126583,7 @@ function sessionActivityStep(msg) {
 		kind: s.type,
 		label: typeof s.label === "string" ? s.label : void 0,
 		text: msg.body,
-		ts: new Date(msg.createdAt).getTime(),
+		ts: messageEventTime(msg),
 		turnId: typeof s.turnId === "string" ? s.turnId : void 0
 	};
 }
@@ -126674,7 +126677,7 @@ function buildTimeline(messages, statusEvents, createdAt, importedHistory = [])
 			continue;
 		}
 		raw.push({
-			ts: new Date(msg.createdAt).getTime(),
+			ts: messageEventTime(msg),
 			entry: {
 				type: "message",
 				msg
@@ -153682,11 +153685,80 @@ function SettingsView() {
 					]
 				})]
 			}),
+			/* @__PURE__ */ (0, import_jsx_runtime.jsx)(WorkspaceSettings, {}),
 			/* @__PURE__ */ (0, import_jsx_runtime.jsx)(StewardSettings, {}),
 			/* @__PURE__ */ (0, import_jsx_runtime.jsx)(VoiceSettings, {})
 		]
 	});
 }
+var DEFAULT_WORKSPACE = { symlinkPaths: [] };
+function WorkspaceSettings() {
+	const [config, setConfig] = (0, import_react.useState)(DEFAULT_WORKSPACE);
+	const [status, setStatus] = (0, import_react.useState)("");
+	(0, import_react.useEffect)(() => {
+		api("GET", "/workspace-config").then((entry) => setConfig({
+			...DEFAULT_WORKSPACE,
+			...entry.value
+		})).catch((e) => setStatus(e.message));
+	}, []);
+	async function save() {
+		try {
+			const saved = await api("PUT", "/workspace-config", config);
+			setConfig({
+				...DEFAULT_WORKSPACE,
+				...saved.value
+			});
+			setStatus("Workspace config saved");
+		} catch (e) {
+			setStatus(e.message);
+		}
+	}
+	return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("section", {
+		className: "space-y-3 rounded-lg border p-4",
+		children: [
+			/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+				className: "flex items-center gap-2",
+				children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)(FolderSymlink, { className: "w-4 h-4" }), /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)("h2", {
+					className: "text-sm font-semibold",
+					children: "Isolated worktree symlinks"
+				}), /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("p", {
+					className: "text-xs text-muted-foreground",
+					children: [
+						"Untracked files or filename patterns symlinked from main into each isolated worktree (the \"Workspace\" spawn option), one per line. Plain names like ",
+						/* @__PURE__ */ (0, import_jsx_runtime.jsx)("code", { children: "AGENTS.md" }),
+						" or ",
+						/* @__PURE__ */ (0, import_jsx_runtime.jsx)("code", { children: ".claude-rig" }),
+						" match files and directories; entries with ",
+						/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("code", { children: ["*?[]", "{}"] }),
+						" are expanded as globs. A path is only linked if it exists in main."
+					]
+				})] })]
+			}),
+			/* @__PURE__ */ (0, import_jsx_runtime.jsx)(Field, {
+				label: "Paths / patterns",
+				children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Textarea, {
+					rows: 5,
+					placeholder: "AGENTS.md\n.claude-rig",
+					value: config.symlinkPaths.join("\n"),
+					onChange: (e) => setConfig({
+						...config,
+						symlinkPaths: lines(e.target.value)
+					})
+				})
+			}),
+			/* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", {
+				className: "flex items-center gap-2 pt-1",
+				children: [/* @__PURE__ */ (0, import_jsx_runtime.jsxs)(Button, {
+					onClick: save,
+					children: [/* @__PURE__ */ (0, import_jsx_runtime.jsx)(Save, { className: "w-4 h-4" }), "Save"]
+				}), status && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("p", {
+					className: "text-sm text-muted-foreground",
+					children: status
+				})]
+			})
+		]
+	});
+}
 function VoiceSettings() {
 	const voiceInputMode = useRelayStore((s) => s.voiceInputMode);
 	const setVoiceInputMode = useRelayStore((s) => s.setVoiceInputMode);

package/src/automations.ts

@@ -12,7 +12,7 @@ import {
   ValidationError,
 } from "./db";
 import { createCommand } from "./commands-db";
-import { getAgentProfile, getSpawnPolicy } from "./config-store";
+import { getAgentProfile, getSpawnPolicy, workspaceSpawnParams } from "./config-store";
 import { resolveProviderSelection, type ProviderEffort } from "agent-relay-sdk/provider-catalog";
 import { runnerRuntimeTokenEnv } from "./runtime-tokens";
 import type {
@@ -559,6 +559,7 @@ function dispatchOnDemandAutomation(
       effort: selection.effort,
       profile: policy.profile,
       agentProfile,
+      ...workspaceSpawnParams(),
       cwd: policy.cwd || orchestrator.baseDir,
       workspaceMode: policy.workspaceMode ?? "inherit",
       label,

package/src/config-store.ts

@@ -12,6 +12,7 @@ import type {
   SpawnPolicy,
   SpawnProvider,
   StewardConfig,
+  WorkspaceConfig,
 } from "./types";
 
 const CONFIG_HISTORY_LIMIT = 50;
@@ -21,6 +22,8 @@ const STEWARD_NAMESPACE = "steward";
 const STEWARD_KEY = "default";
 const INSIGHTS_NAMESPACE = "insights";
 const INSIGHTS_KEY = "default";
+const WORKSPACE_NAMESPACE = "workspace";
+const WORKSPACE_KEY = "default";
 const VALID_PROVIDERS = ["claude", "codex"] as const;
 const VALID_PROFILE_PROVIDERS = ["any", "claude", "codex"] as const;
 const VALID_PROFILE_BASES = ["host", "minimal", "isolated"] as const;
@@ -472,12 +475,34 @@ function validateInsightsConfig(value: unknown): InsightsConfig {
   };
 }
 
+// Global workspace provisioning config for isolated worktrees (#159 follow-up).
+// Defaults seed the two untracked paths an isolated agent almost always needs:
+// the agent guide and the rig config, both gitignored so a fresh worktree lacks them.
+const WORKSPACE_CONFIG_DEFAULTS: WorkspaceConfig = {
+  symlinkPaths: ["AGENTS.md", ".claude-rig"],
+};
+
+function validateWorkspaceConfig(value: unknown): WorkspaceConfig {
+  if (!isRecord(value)) throw new ValidationError("workspace config value must be an object");
+  const symlinkPaths = cleanStringArray(value.symlinkPaths, "symlinkPaths");
+  // Reject absolute paths and parent-traversal up front: symlink sources must stay
+  // inside the main checkout. The orchestrator re-checks containment at link time,
+  // but failing here gives the operator immediate feedback in the dashboard.
+  for (const entry of symlinkPaths) {
+    if (entry.startsWith("/") || entry.split(/[\\/]/).includes("..")) {
+      throw new ValidationError(`symlinkPaths entry must be a relative path within the repo: ${entry}`);
+    }
+  }
+  return { symlinkPaths };
+}
+
 function normalizeValue(namespace: string, key: string, value: unknown): unknown {
   if (value === undefined) throw new ValidationError("value required");
   if (namespace === SPAWN_POLICY_NAMESPACE) return validateSpawnPolicy(key, value);
   if (namespace === AGENT_PROFILE_NAMESPACE) return validateAgentProfile(key, value);
   if (namespace === STEWARD_NAMESPACE) return validateStewardConfig(value);
   if (namespace === INSIGHTS_NAMESPACE) return validateInsightsConfig(value);
+  if (namespace === WORKSPACE_NAMESPACE) return validateWorkspaceConfig(value);
   if (JSON.stringify(value) === undefined) throw new ValidationError("value must be valid JSON");
   return value;
 }
@@ -614,6 +639,40 @@ export function setInsightsConfig(value: unknown, updatedBy?: string): ConfigEnt
   return setConfig(INSIGHTS_NAMESPACE, INSIGHTS_KEY, value as InsightsConfig, updatedBy);
 }
 
+/** Global workspace config, merged over defaults (always returns a usable value). */
+export function getWorkspaceConfig(): WorkspaceConfig {
+  const entry = getConfig<Partial<WorkspaceConfig>>(WORKSPACE_NAMESPACE, WORKSPACE_KEY);
+  if (!entry) return { ...WORKSPACE_CONFIG_DEFAULTS };
+  return validateWorkspaceConfig({ ...WORKSPACE_CONFIG_DEFAULTS, ...entry.value });
+}
+
+export function getWorkspaceConfigEntry(): ConfigEntry<WorkspaceConfig> {
+  const entry = getConfig<WorkspaceConfig>(WORKSPACE_NAMESPACE, WORKSPACE_KEY);
+  return entry ?? {
+    namespace: WORKSPACE_NAMESPACE,
+    key: WORKSPACE_KEY,
+    value: { ...WORKSPACE_CONFIG_DEFAULTS },
+    version: 0,
+    updatedAt: "default",
+    updatedBy: "system",
+  };
+}
+
+export function setWorkspaceConfig(value: unknown, updatedBy?: string): ConfigEntry<WorkspaceConfig> {
+  return setConfig(WORKSPACE_NAMESPACE, WORKSPACE_KEY, value as WorkspaceConfig, updatedBy);
+}
+
+/**
+ * Spawn-param fragment carrying the global workspace symlink list to the orchestrator.
+ * Spread into every spawn command's params next to `agentProfile` so any isolated
+ * worktree — direct spawn, managed policy, restart, automation — provisions the same
+ * untracked paths. Returns `{}` when nothing is configured (keeps params lean).
+ */
+export function workspaceSpawnParams(): { workspaceSymlinks?: string[] } {
+  const { symlinkPaths } = getWorkspaceConfig();
+  return symlinkPaths.length ? { workspaceSymlinks: symlinkPaths } : {};
+}
+
 function builtInProfileEntry(profile: AgentProfile): ConfigEntry<AgentProfile> {
   return {
     namespace: AGENT_PROFILE_NAMESPACE,

package/src/db.ts

@@ -239,7 +239,8 @@ export function initDb(path: string = "agent-relay.db"): Database {
       payload TEXT NOT NULL DEFAULT '{}',
       meta TEXT NOT NULL DEFAULT '{}',
       read_by TEXT NOT NULL DEFAULT '[]',
-      created_at INTEGER NOT NULL
+      created_at INTEGER NOT NULL,
+      occurred_at INTEGER
     );
 
     CREATE INDEX IF NOT EXISTS idx_msg_to ON messages(to_target);
@@ -890,6 +891,11 @@ export function initDb(path: string = "agent-relay.db"): Database {
   if (!colNames.includes("resolved_to_agent")) {
     db.run("ALTER TABLE messages ADD COLUMN resolved_to_agent TEXT");
   }
+  // Event time (#196): when a Runner queues a message in its durable outbox during an
+  // outage, occurred_at preserves when it really happened vs. the later receive time.
+  if (!colNames.includes("occurred_at")) {
+    db.run("ALTER TABLE messages ADD COLUMN occurred_at INTEGER");
+  }
   db.query(
     "UPDATE messages SET claim_expires_at = coalesce(claimed_at, ?) + ? WHERE claimed_by IS NOT NULL AND claim_expires_at IS NULL",
   ).run(Date.now(), CLAIM_LEASE_MS);
@@ -1308,6 +1314,7 @@ function rowToMessage(row: any): Message {
     reactions: parseJson(row.reactions_json ?? "[]", []),
     readBy: parseJson(row.read_by_agents ?? "[]", []),
     createdAt: row.created_at,
+    occurredAt: row.occurred_at ?? undefined,
   };
 }
 
@@ -3680,6 +3687,16 @@ function findRecentDuplicateReply(input: SendMessageInput, threadId: number | nu
   return row ? rowToMessage(row) : null;
 }
 
+// Event time may be queued-then-backfilled, so it can legitimately be older than the
+// receive time — but it must be a sane epoch-ms value. Returns null (column stays NULL, so
+// readers fall back to created_at) for absent/invalid values or anything more than a minute
+// in the future (clock-skew guard). Only a real backfilled time is stored.
+function sanitizeOccurredAt(occurredAt: number | undefined, receivedAt: number): number | null {
+  if (typeof occurredAt !== "number" || !Number.isFinite(occurredAt)) return null;
+  if (occurredAt <= 0 || occurredAt > receivedAt + 60_000) return null;
+  return Math.floor(occurredAt);
+}
+
 export function sendMessageWithResult(input: SendMessageInput): { message: Message; created: boolean } {
   const now = Date.now();
   const payload = input.payload ?? {};
@@ -3710,12 +3727,12 @@ export function sendMessageWithResult(input: SendMessageInput): { message: Messa
     INSERT INTO messages (
       from_agent, to_target, kind, channel, subject, body, thread_id, reply_to, claimable,
       idempotency_key, delivery_status, queued_at, max_age_seconds, resolved_to_agent,
-      payload, meta, created_at
+      payload, meta, created_at, occurred_at
     )
     VALUES (
       $from, $to, $kind, $channel, $subject, $body, $threadId, $replyTo, $claimable,
       $idempotencyKey, $deliveryStatus, $queuedAt, $maxAgeSeconds, $resolvedToAgent,
-      $payload, $meta, $now
+      $payload, $meta, $now, $occurredAt
     )
   `);
   const setSelfThread = db.query("UPDATE messages SET thread_id = ? WHERE id = ?");
@@ -3756,6 +3773,8 @@ export function sendMessageWithResult(input: SendMessageInput): { message: Messa
       $payload: JSON.stringify(payload),
       $meta: JSON.stringify(input.meta ?? {}),
       $now: now,
+      // Sanitize: only accept a plausible epoch-ms event time, else fall back to receive time.
+      $occurredAt: sanitizeOccurredAt(input.occurredAt, now),
     });
     const newId = Number(result.lastInsertRowid);
     if (threadId === null) setSelfThread.run(newId, newId);

package/src/managed-policy.ts

@@ -1,5 +1,5 @@
 import { resolveProviderSelection } from "agent-relay-sdk/provider-catalog";
-import { getAgentProfile } from "./config-store";
+import { getAgentProfile, workspaceSpawnParams } from "./config-store";
 import { runnerRuntimeTokenEnv } from "./runtime-tokens";
 import type { SpawnPolicy, WorkspaceMode } from "./types";
 
@@ -55,6 +55,7 @@ export function buildManagedSpawnParams(policy: SpawnPolicy, requestId: string,
     ...resolvedModelParams(policy),
     ...(policy.profile ? { profile: policy.profile } : {}),
     ...(agentProfile ? { agentProfile } : {}),
+    ...workspaceSpawnParams(),
     label: policy.label,
     tags: policy.tags,
     capabilities: policy.capabilities,

package/src/routes.ts

@@ -108,6 +108,9 @@ import {
   getStewardConfigEntry,
   getInsightsConfigEntry,
   setInsightsConfig,
+  getWorkspaceConfigEntry,
+  setWorkspaceConfig,
+  workspaceSpawnParams,
   listAgentProfiles,
   listSpawnPolicies,
   listConfig,
@@ -594,6 +597,12 @@ function normalizeMessageInput(body: unknown): SendMessageInput {
     }
     input.maxAgeSeconds = body.maxAgeSeconds;
   }
+  if (body.occurredAt !== undefined) {
+    if (typeof body.occurredAt !== "number" || !Number.isFinite(body.occurredAt) || body.occurredAt <= 0) {
+      throw new ValidationError("occurredAt must be a positive epoch-ms number");
+    }
+    input.occurredAt = body.occurredAt;
+  }
 
   const channel = cleanString(body.channel, "channel", { max: 120 });
   if (channel) input.channel = channel;
@@ -2296,6 +2305,7 @@ function restartSpawnParamsForAgent(
     workspaceMode,
     ...(profileName ? { profile: profileName } : {}),
     ...(agentProfile ? { agentProfile } : {}),
+    ...workspaceSpawnParams(),
     ...(label ? { label } : {}),
     agentId: agent.id,
     tags: agent.tags,
@@ -3612,6 +3622,7 @@ const postOrchestratorSpawn: Handler = async (req, params) => {
         permissionMode: approvalMode,
         profile,
         agentProfile,
+        ...workspaceSpawnParams(),
         providerArgs,
         prompt,
         systemPromptAppend,
@@ -4599,6 +4610,25 @@ const putStewardConfigRoute: Handler = async (req) => {
   }
 };
 
+const getWorkspaceConfigRoute: Handler = () => json(getWorkspaceConfigEntry());
+
+const putWorkspaceConfigRoute: Handler = async (req) => {
+  const parsed = await parseBody<unknown>(req);
+  if (!parsed.ok) return error(parsed.error, parsed.status);
+  try {
+    const value = isRecord(parsed.body) && Object.prototype.hasOwnProperty.call(parsed.body, "value")
+      ? parsed.body.value
+      : parsed.body;
+    const updatedBy = isRecord(parsed.body) ? cleanString(parsed.body.updatedBy, "updatedBy", { max: 200 }) : undefined;
+    const entry = setWorkspaceConfig(value, updatedBy);
+    emitConfigChanged(entry.namespace, entry.key, entry.version);
+    return json(entry, entry.version === 1 ? 201 : 200);
+  } catch (e) {
+    if (e instanceof ValidationError) return error(e.message, 400);
+    throw e;
+  }
+};
+
 // --- Insights / self-improvement (epic #183, docs/self-improvement.md) ---
 
 const getInsightsConfigRoute: Handler = () => json(getInsightsConfigEntry());
@@ -4635,6 +4665,14 @@ const getInsightsObservationsRoute: Handler = (req) => {
   });
 };
 
+// Accept a backfilled event time only when it's a sane epoch-ms value within a minute of
+// now (clock-skew guard); otherwise let recordObservation default to receive time.
+function sanitizeObservationOccurredAt(occurredAt: unknown): number | undefined {
+  if (typeof occurredAt !== "number" || !Number.isFinite(occurredAt)) return undefined;
+  if (occurredAt <= 0 || occurredAt > Date.now() + 60_000) return undefined;
+  return Math.floor(occurredAt);
+}
+
 const postInsightsObservationRoute: Handler = async (req) => {
   const parsed = await parseBody<unknown>(req);
   if (!parsed.ok) return error(parsed.error, parsed.status);
@@ -4656,6 +4694,10 @@ const postInsightsObservationRoute: Handler = async (req) => {
       value: isRecord(body.value) ? body.value : {},
       outcome: isRecord(body.outcome) ? body.outcome : undefined,
       source: body.source === "server" ? "server" : "agent",
+      // For insights the event time IS the record time (end-of-session). When the Runner
+      // backfilled this through its durable outbox (#196), occurredAt preserves the real
+      // moment rather than the later server-receive time.
+      createdAt: sanitizeObservationOccurredAt(body.occurredAt),
     });
     return json(observation, 201);
   } catch (e) {
@@ -6569,6 +6611,8 @@ const routes: Route[] = [
   route("DELETE", "/api/agent-profiles/:name", deleteAgentProfileRoute),
   route("GET", "/api/steward-config", getStewardConfigRoute),
   route("PUT", "/api/steward-config", putStewardConfigRoute),
+  route("GET", "/api/workspace-config", getWorkspaceConfigRoute),
+  route("PUT", "/api/workspace-config", putWorkspaceConfigRoute),
   route("GET", "/api/insights/config", getInsightsConfigRoute),
   route("PUT", "/api/insights/config", putInsightsConfigRoute),
   route("GET", "/api/insights/observations", getInsightsObservationsRoute),