sensorium-mcp 3.0.103 → 3.1.0-board.0

package/dist/config/agent-templates.js

@@ -0,0 +1,105 @@
+/**
+ * Custom agent templates (reusable spawn presets).
+ *
+ * A template captures everything needed to stamp out a fresh root thread:
+ * client, working directory, an optional identity/system prompt, and optional
+ * per-thread MCP servers. Stored as an array in settings.json (no DB schema
+ * change). The dashboard "Agents" tab manages them; a Start action spawns a
+ * normal root thread from a template. Templates never touch running threads.
+ */
+import { randomUUID } from "node:crypto";
+import { readSettings, updateSettings } from "./settings-store.js";
+import { isValidAgentType, VALID_AGENT_TYPES } from "./agent-settings.js";
+import { parseThreadMcpServers, sanitizeThreadMcpServers, } from "./mcp-settings.js";
+/** Parse+validate one stored template, or null if malformed. */
+function parseAgentTemplate(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return null;
+    const o = raw;
+    if (typeof o.id !== "string" || !o.id)
+        return null;
+    if (typeof o.name !== "string" || !o.name)
+        return null;
+    if (!isValidAgentType(o.client))
+        return null;
+    if (typeof o.workingDirectory !== "string" || !o.workingDirectory)
+        return null;
+    const tpl = {
+        id: o.id,
+        name: o.name,
+        client: o.client,
+        workingDirectory: o.workingDirectory,
+    };
+    if (typeof o.systemPrompt === "string" && o.systemPrompt.length > 0)
+        tpl.systemPrompt = o.systemPrompt;
+    const mcp = parseThreadMcpServers(o.mcpServers);
+    if (Object.keys(mcp).length > 0)
+        tpl.mcpServers = mcp;
+    return tpl;
+}
+/** All stored agent templates (malformed entries dropped). */
+export function getAgentTemplates() {
+    const raw = readSettings().agentTemplates;
+    if (!Array.isArray(raw))
+        return [];
+    const result = [];
+    for (const item of raw) {
+        const parsed = parseAgentTemplate(item);
+        if (parsed)
+            result.push(parsed);
+    }
+    return result;
+}
+/** Single template by id, or null. */
+export function getAgentTemplate(id) {
+    return getAgentTemplates().find((t) => t.id === id) ?? null;
+}
+/**
+ * Upsert a template. A blank id creates a new one (server-assigned id); an
+ * existing id replaces in place. Validates required fields and the MCP map;
+ * throws on violation so the dashboard can surface a 400.
+ */
+export function saveAgentTemplate(input) {
+    const name = input.name?.trim();
+    if (!name)
+        throw new Error("name is required");
+    if (!isValidAgentType(input.client))
+        throw new Error(`client must be one of: ${VALID_AGENT_TYPES.join(", ")}`);
+    const workingDirectory = input.workingDirectory?.trim();
+    if (!workingDirectory)
+        throw new Error("workingDirectory is required");
+    const mcpServers = sanitizeThreadMcpServers(input.mcpServers ?? undefined);
+    const tpl = {
+        id: input.id?.trim() ? input.id.trim() : `tpl_${randomUUID().replace(/-/g, "").slice(0, 12)}`,
+        name,
+        client: input.client,
+        workingDirectory,
+    };
+    const systemPrompt = typeof input.systemPrompt === "string" ? input.systemPrompt.trim() : "";
+    if (systemPrompt)
+        tpl.systemPrompt = systemPrompt;
+    if (Object.keys(mcpServers).length > 0)
+        tpl.mcpServers = mcpServers;
+    updateSettings((s) => {
+        const list = getAgentTemplates();
+        const idx = list.findIndex((t) => t.id === tpl.id);
+        if (idx >= 0)
+            list[idx] = tpl;
+        else
+            list.push(tpl);
+        s.agentTemplates = list;
+    });
+    return tpl;
+}
+/** Remove a template by id. Returns true if one was removed. */
+export function deleteAgentTemplate(id) {
+    const before = getAgentTemplates();
+    const after = before.filter((t) => t.id !== id);
+    if (after.length === before.length)
+        return false;
+    updateSettings((s) => {
+        s.agentTemplates = after;
+    });
+    return true;
+}
+//# sourceMappingURL=agent-templates.js.map

package/dist/config/agent-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-templates.js","sourceRoot":"","sources":["../../src/config/agent-templates.ts"],"names":[],"mappings":"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"}

package/dist/config/detail-grant.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Ephemeral, per-thread "detail grant" — an operator-side opt-in that lets the
+ * agent's next long report_progress bubble bypass the hard length cap.
+ *
+ * This is the ONE trustworthy verbosity signal: it is set by an operator
+ * `/detail` command that the SERVER sees (poller.ts), never by a flag the agent
+ * sets on itself. A bare `detailed:true` is now ignored — the length check only
+ * relaxes while a grant is live. Semantics: "next long message OR N minutes,
+ * whichever comes first" — consumed when the first over-cap message passes, else
+ * it expires.
+ *
+ * Deliberately in-memory only: a ~30-minute grant surviving a server restart has
+ * no value, so it is never persisted to settings.json.
+ */
+/** Length of a granted window, in minutes. Configurable via DETAIL_GRANT_MINUTES. */
+export declare const DETAIL_GRANT_MINUTES: number;
+/**
+ * Open a detail window for a thread: valid until the next long message or
+ * DETAIL_GRANT_MINUTES from now, whichever comes first. Overwrites any existing
+ * grant (a fresh `/detail` restarts the clock).
+ */
+export declare function grantDetailWindow(threadId: number, nowMs?: number): void;
+/** Drop a thread's grant immediately (operator `/detail off`). Idempotent. */
+export declare function revokeDetailGrant(threadId: number): void;
+/**
+ * Non-consuming peek: is there a live (unexpired) grant for this thread? Lazily
+ * evicts an expired entry so the Map never accumulates stale grants.
+ *
+ * `nowMs` defaults to `Date.now()`; it is injectable purely so the window's
+ * expiry is testable without stubbing the clock.
+ */
+export declare function isDetailGrantActive(threadId: number, nowMs?: number): boolean;
+/**
+ * Consume the grant: if active, delete it and return true (one long message is
+ * allowed through). If inactive or expired, return false and leave nothing
+ * behind. One-shot — a second long message needs a fresh `/detail`.
+ */
+export declare function consumeDetailGrant(threadId: number, nowMs?: number): boolean;
+//# sourceMappingURL=detail-grant.d.ts.map

package/dist/config/detail-grant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detail-grant.d.ts","sourceRoot":"","sources":["../../src/config/detail-grant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,qFAAqF;AACrF,eAAO,MAAM,oBAAoB,QACkE,CAAC;AAUpG;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,IAAI,CAEpF;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAExD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,OAAO,CAQzF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAmB,GAAG,OAAO,CAIxF"}

package/dist/config/detail-grant.js

@@ -0,0 +1,61 @@
+/**
+ * Ephemeral, per-thread "detail grant" — an operator-side opt-in that lets the
+ * agent's next long report_progress bubble bypass the hard length cap.
+ *
+ * This is the ONE trustworthy verbosity signal: it is set by an operator
+ * `/detail` command that the SERVER sees (poller.ts), never by a flag the agent
+ * sets on itself. A bare `detailed:true` is now ignored — the length check only
+ * relaxes while a grant is live. Semantics: "next long message OR N minutes,
+ * whichever comes first" — consumed when the first over-cap message passes, else
+ * it expires.
+ *
+ * Deliberately in-memory only: a ~30-minute grant surviving a server restart has
+ * no value, so it is never persisted to settings.json.
+ */
+const DEFAULT_GRANT_MINUTES = 30;
+const rawGrantMinutes = parseFloat(process.env.DETAIL_GRANT_MINUTES ?? "");
+/** Length of a granted window, in minutes. Configurable via DETAIL_GRANT_MINUTES. */
+export const DETAIL_GRANT_MINUTES = Number.isFinite(rawGrantMinutes) && rawGrantMinutes > 0 ? rawGrantMinutes : DEFAULT_GRANT_MINUTES;
+/** threadId → active grant. Absent key = no grant. */
+const grants = new Map();
+/**
+ * Open a detail window for a thread: valid until the next long message or
+ * DETAIL_GRANT_MINUTES from now, whichever comes first. Overwrites any existing
+ * grant (a fresh `/detail` restarts the clock).
+ */
+export function grantDetailWindow(threadId, nowMs = Date.now()) {
+    grants.set(threadId, { expiresAt: nowMs + DETAIL_GRANT_MINUTES * 60_000 });
+}
+/** Drop a thread's grant immediately (operator `/detail off`). Idempotent. */
+export function revokeDetailGrant(threadId) {
+    grants.delete(threadId);
+}
+/**
+ * Non-consuming peek: is there a live (unexpired) grant for this thread? Lazily
+ * evicts an expired entry so the Map never accumulates stale grants.
+ *
+ * `nowMs` defaults to `Date.now()`; it is injectable purely so the window's
+ * expiry is testable without stubbing the clock.
+ */
+export function isDetailGrantActive(threadId, nowMs = Date.now()) {
+    const grant = grants.get(threadId);
+    if (!grant)
+        return false;
+    if (grant.expiresAt <= nowMs) {
+        grants.delete(threadId);
+        return false;
+    }
+    return true;
+}
+/**
+ * Consume the grant: if active, delete it and return true (one long message is
+ * allowed through). If inactive or expired, return false and leave nothing
+ * behind. One-shot — a second long message needs a fresh `/detail`.
+ */
+export function consumeDetailGrant(threadId, nowMs = Date.now()) {
+    if (!isDetailGrantActive(threadId, nowMs))
+        return false;
+    grants.delete(threadId);
+    return true;
+}
+//# sourceMappingURL=detail-grant.js.map

package/dist/config/detail-grant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detail-grant.js","sourceRoot":"","sources":["../../src/config/detail-grant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAEjC,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;AAC3E,qFAAqF;AACrF,MAAM,CAAC,MAAM,oBAAoB,GAC/B,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,eAAe,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,qBAAqB,CAAC;AAOpG,sDAAsD;AACtD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;AAE9C;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,QAAgB,IAAI,CAAC,GAAG,EAAE;IAC5E,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,GAAG,oBAAoB,GAAG,MAAM,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,QAAgB,IAAI,CAAC,GAAG,EAAE;IAC9E,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,QAAgB,IAAI,CAAC,GAAG,EAAE;IAC7E,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Centralized configuration — reads environment variables at startup and
+ * exports validated values used throughout the codebase. Settings-file-backed
+ * options live in domain modules under src/config/ and are re-exported here so
+ * import sites are unchanged (settings-store itself stays internal).
+ */
+import type { AppConfig } from "../lib/types.js";
+export * from "./agent-settings.js";
+export * from "./mcp-settings.js";
+export * from "./agent-templates.js";
+export * from "./keep-alive-settings.js";
+export * from "./misc-settings.js";
+export * from "./detail-grant.js";
+export declare const AUTONOMOUS_MODE: boolean;
+export declare const TEMPLATES_DIR: string;
+export declare const config: AppConfig;
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAWlC,eAAO,MAAM,eAAe,SAAyC,CAAC;AA8BtE,eAAO,MAAM,aAAa,QAAsD,CAAC;AAKjF,eAAO,MAAM,MAAM,EAAE,SAUpB,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,59 @@
+/**
+ * Centralized configuration — reads environment variables at startup and
+ * exports validated values used throughout the codebase. Settings-file-backed
+ * options live in domain modules under src/config/ and are re-exported here so
+ * import sites are unchanged (settings-store itself stays internal).
+ */
+import { createRequire } from "node:module";
+import { mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { log } from "../lib/logger.js";
+import { getWaitTimeoutMinutes } from "./misc-settings.js";
+export * from "./agent-settings.js";
+export * from "./mcp-settings.js";
+export * from "./agent-templates.js";
+export * from "./keep-alive-settings.js";
+export * from "./misc-settings.js";
+export * from "./detail-grant.js";
+const esmRequire = createRequire(import.meta.url);
+const { version: PKG_VERSION } = esmRequire("../../package.json");
+// ─── Environment variables ──────────────────────────────────────────────────
+const TELEGRAM_TOKEN = process.env.TELEGRAM_TOKEN ?? "";
+const TELEGRAM_CHAT_ID = process.env.TELEGRAM_CHAT_ID ?? "";
+const OPENAI_API_KEY = process.env.OPENAI_API_KEY ?? "";
+const VOICE_ANALYSIS_URL = process.env.VOICE_ANALYSIS_URL ?? "";
+export const AUTONOMOUS_MODE = process.env.AUTONOMOUS_MODE === "true";
+const rawDmnActivationHours = parseFloat(process.env.DMN_ACTIVATION_HOURS ?? "");
+const DMN_ACTIVATION_HOURS = Math.max(0.5, Number.isFinite(rawDmnActivationHours) ? rawDmnActivationHours : 4);
+// ─── Validation ─────────────────────────────────────────────────────────────
+if (!TELEGRAM_TOKEN || !TELEGRAM_CHAT_ID) {
+    log.error("TELEGRAM_TOKEN and TELEGRAM_CHAT_ID environment variables are required.");
+    process.exit(1);
+}
+if (!OPENAI_API_KEY) {
+    log.warn("OPENAI_API_KEY not set — voice messages will not be transcribed.");
+}
+if (VOICE_ANALYSIS_URL) {
+    log.info(`Voice analysis service configured: ${VOICE_ANALYSIS_URL}`);
+}
+if (process.env.TRANSCRIPTION_BASE_URL) {
+    const model = process.env.TRANSCRIPTION_MODEL || "whisper-1";
+    log.info(`Transcription provider configured: ${process.env.TRANSCRIPTION_BASE_URL} (model: ${model})`);
+}
+// ─── Templates directory ────────────────────────────────────────────────────
+export const TEMPLATES_DIR = join(homedir(), ".remote-copilot-mcp", "templates");
+mkdirSync(TEMPLATES_DIR, { recursive: true });
+// ─── Exported config object ─────────────────────────────────────────────────
+export const config = {
+    TELEGRAM_TOKEN,
+    TELEGRAM_CHAT_ID,
+    OPENAI_API_KEY,
+    VOICE_ANALYSIS_URL,
+    get WAIT_TIMEOUT_MINUTES() {
+        return getWaitTimeoutMinutes();
+    },
+    DMN_ACTIVATION_HOURS,
+    PKG_VERSION,
+};
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAElC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,UAAU,CAAC,oBAAoB,CAAwB,CAAC;AAEzF,+EAA+E;AAE/E,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;AACxD,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;AAC5D,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;AACxD,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC;AAChE,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,MAAM,CAAC;AAEtE,MAAM,qBAAqB,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;AACjF,MAAM,oBAAoB,GAAG,IAAI,CAAC,GAAG,CACnC,GAAG,EACH,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CACnE,CAAC;AAEF,+EAA+E;AAE/E,IAAI,CAAC,cAAc,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACzC,GAAG,CAAC,KAAK,CAAC,yEAAyE,CAAC,CAAC;IACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,CAAC,cAAc,EAAE,CAAC;IACpB,GAAG,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;AAC/E,CAAC;AACD,IAAI,kBAAkB,EAAE,CAAC;IACvB,GAAG,CAAC,IAAI,CAAC,sCAAsC,kBAAkB,EAAE,CAAC,CAAC;AACvE,CAAC;AACD,IAAI,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,WAAW,CAAC;IAC7D,GAAG,CAAC,IAAI,CACN,sCAAsC,OAAO,CAAC,GAAG,CAAC,sBAAsB,YAAY,KAAK,GAAG,CAC7F,CAAC;AACJ,CAAC;AAED,+EAA+E;AAE/E,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,qBAAqB,EAAE,WAAW,CAAC,CAAC;AACjF,SAAS,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAE9C,+EAA+E;AAE/E,MAAM,CAAC,MAAM,MAAM,GAAc;IAC/B,cAAc;IACd,gBAAgB;IAChB,cAAc;IACd,kBAAkB;IAClB,IAAI,oBAAoB;QACtB,OAAO,qBAAqB,EAAE,CAAC;IACjC,CAAC;IACD,oBAAoB;IACpB,WAAW;CACZ,CAAC"}

package/dist/config/keep-alive-settings.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Keep-alive settings — global keeper toggle/target/retry policy, keeper
+ * client type, and per-thread keep-alive overrides.
+ */
+export declare function getKeepAliveEnabled(): boolean;
+export declare function setKeepAliveEnabled(enabled: boolean): void;
+export declare function getKeepAliveThreadId(): number;
+export declare function setKeepAliveThreadId(threadId: number): void;
+export declare function getKeepAliveMaxRetries(): number;
+export declare function setKeepAliveMaxRetries(retries: number): void;
+export declare function getKeepAliveCooldownMs(): number;
+export declare function setKeepAliveCooldownMs(ms: number): void;
+export type KeeperClient = "claude" | "copilot";
+export declare function isValidKeeperClient(v: unknown): v is KeeperClient;
+export declare function getKeepAliveClient(): KeeperClient;
+export declare function setKeepAliveClient(client: KeeperClient): void;
+export interface ThreadKeepAliveSettings {
+    enabled: boolean;
+    client?: string;
+    maxRetries?: number;
+    cooldownMs?: number;
+}
+/** Sets keep-alive settings for a specific thread. */
+export declare function setThreadKeepAlive(threadId: number, settings: ThreadKeepAliveSettings): void;
+/** Removes per-thread keep-alive settings. */
+export declare function removeThreadKeepAlive(threadId: number): void;
+/** Returns all per-thread keep-alive overrides. */
+export declare function getAllThreadKeepAlive(): Record<string, ThreadKeepAliveSettings>;
+//# sourceMappingURL=keep-alive-settings.d.ts.map

package/dist/config/keep-alive-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-alive-settings.d.ts","sourceRoot":"","sources":["../../src/config/keep-alive-settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,wBAAgB,mBAAmB,IAAI,OAAO,CAI7C;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAI1D;AAED,wBAAgB,oBAAoB,IAAI,MAAM,CAI7C;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI3D;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAI/C;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI5D;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAI/C;AAED,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAIvD;AAID,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEhD,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,YAAY,CAEjE;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CAGjD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAI7D;AAID,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,sDAAsD;AACtD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAM5F;AAED,8CAA8C;AAC9C,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAM5D;AAED,mDAAmD;AACnD,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAiB/E"}

package/dist/config/keep-alive-settings.js

@@ -0,0 +1,100 @@
+/**
+ * Keep-alive settings — global keeper toggle/target/retry policy, keeper
+ * client type, and per-thread keep-alive overrides.
+ */
+import { readSettings, updateSettings } from "./settings-store.js";
+// ─── Keep-alive settings ─────────────────────────────────────────────────────
+const DEFAULT_KEEP_ALIVE_MAX_RETRIES = 5;
+const DEFAULT_KEEP_ALIVE_COOLDOWN_MS = 300_000;
+export function getKeepAliveEnabled() {
+    const v = readSettings().keepAliveEnabled;
+    if (typeof v === "boolean")
+        return v;
+    return false; // default: disabled
+}
+export function setKeepAliveEnabled(enabled) {
+    updateSettings((s) => {
+        s.keepAliveEnabled = enabled;
+    });
+}
+export function getKeepAliveThreadId() {
+    const v = readSettings().keepAliveThreadId;
+    if (typeof v === "number" && Number.isFinite(v) && v > 0)
+        return v;
+    return 0;
+}
+export function setKeepAliveThreadId(threadId) {
+    updateSettings((s) => {
+        s.keepAliveThreadId = threadId;
+    });
+}
+export function getKeepAliveMaxRetries() {
+    const v = readSettings().keepAliveMaxRetries;
+    if (typeof v === "number" && Number.isFinite(v) && v > 0)
+        return v;
+    return DEFAULT_KEEP_ALIVE_MAX_RETRIES;
+}
+export function setKeepAliveMaxRetries(retries) {
+    updateSettings((s) => {
+        s.keepAliveMaxRetries = retries;
+    });
+}
+export function getKeepAliveCooldownMs() {
+    const v = readSettings().keepAliveCooldownMs;
+    if (typeof v === "number" && Number.isFinite(v) && v > 0)
+        return v;
+    return DEFAULT_KEEP_ALIVE_COOLDOWN_MS;
+}
+export function setKeepAliveCooldownMs(ms) {
+    updateSettings((s) => {
+        s.keepAliveCooldownMs = ms;
+    });
+}
+export function isValidKeeperClient(v) {
+    return v === "claude" || v === "copilot";
+}
+export function getKeepAliveClient() {
+    const v = readSettings().keepAliveClient;
+    return isValidKeeperClient(v) ? v : "claude";
+}
+export function setKeepAliveClient(client) {
+    updateSettings((s) => {
+        s.keepAliveClient = client;
+    });
+}
+/** Sets keep-alive settings for a specific thread. */
+export function setThreadKeepAlive(threadId, settings) {
+    updateSettings((s) => {
+        const map = (s.threadKeepAlive ?? {});
+        map[String(threadId)] = settings;
+        s.threadKeepAlive = map;
+    });
+}
+/** Removes per-thread keep-alive settings. */
+export function removeThreadKeepAlive(threadId) {
+    updateSettings((s) => {
+        const map = (s.threadKeepAlive ?? {});
+        delete map[String(threadId)];
+        s.threadKeepAlive = map;
+    });
+}
+/** Returns all per-thread keep-alive overrides. */
+export function getAllThreadKeepAlive() {
+    const map = readSettings().threadKeepAlive;
+    if (!map || typeof map !== "object")
+        return {};
+    const result = {};
+    for (const [k, v] of Object.entries(map)) {
+        if (v && typeof v === "object") {
+            const e = v;
+            result[k] = {
+                enabled: typeof e.enabled === "boolean" ? e.enabled : false,
+                client: isValidKeeperClient(e.client) ? e.client : undefined,
+                cooldownMs: typeof e.cooldownMs === "number" && e.cooldownMs >= 1000 ? e.cooldownMs : undefined,
+                maxRetries: typeof e.maxRetries === "number" && e.maxRetries > 0 ? e.maxRetries : undefined,
+            };
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=keep-alive-settings.js.map

package/dist/config/keep-alive-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-alive-settings.js","sourceRoot":"","sources":["../../src/config/keep-alive-settings.ts"],"names":[],"mappings":"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"}

package/dist/config/mcp-settings.d.ts

@@ -0,0 +1,59 @@
+/**
+ * MCP server settings — the global user-configured server map plus the
+ * security-hardened per-thread server entries (http-only, reserved-name and
+ * header-name invariants) and dashboard masking helpers.
+ */
+export type McpServerConfig = {
+    type: "stdio";
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+} | {
+    type: "http";
+    url: string;
+    headers?: Record<string, string>;
+    env?: Record<string, string>;
+};
+/** Returns all user-configured MCP servers (excludes auto-injected sensorium). */
+export declare function getMcpServers(): Record<string, McpServerConfig>;
+/** Overwrites the entire MCP servers map. */
+export declare function setMcpServers(servers: Record<string, McpServerConfig>): void;
+/** Add or update a single MCP server by name. */
+export declare function addMcpServer(name: string, config: McpServerConfig): void;
+/** Remove an MCP server by name. Returns true if it existed. */
+export declare function removeMcpServer(name: string): boolean;
+/** MCP server names a per-thread entry may never use. */
+export declare const RESERVED_MCP_NAMES: readonly string[];
+/** A per-thread MCP server entry — HTTP transport only (no stdio, by design). */
+export type ThreadMcpServer = {
+    type: "http";
+    url: string;
+    headers?: Record<string, string>;
+};
+/** Parse a per-thread server map, dropping reserved names and non-http/invalid entries. */
+export declare function parseThreadMcpServers(raw: unknown): Record<string, ThreadMcpServer>;
+/** Returns a thread's custom MCP servers (http-only, reserved names excluded). */
+export declare function getThreadMcpServers(threadId: number): Record<string, ThreadMcpServer>;
+/**
+ * Validate a caller-supplied server map against the per-thread invariants
+ * (http-only, non-reserved name, safe header names). Throws on any violation so
+ * the dashboard can surface a 400. Shared by per-thread MCP writes and agent
+ * templates (which carry the same kind of map).
+ */
+export declare function sanitizeThreadMcpServers(servers: Record<string, ThreadMcpServer> | null | undefined): Record<string, ThreadMcpServer>;
+/** Header value the dashboard shows in place of a stored secret; must never be persisted back. */
+export declare const MASK_SENTINEL = "\u2022\u2022\u2022\u2022";
+type MaskedThreadMcpServer = {
+    type: "http";
+    url: string;
+    headers?: Record<string, string>;
+};
+/** Mask header values so the dashboard shows which headers exist without leaking the secret. */
+export declare function maskThreadMcpServers(servers: Record<string, ThreadMcpServer>): Record<string, MaskedThreadMcpServer>;
+export declare function setThreadMcpServers(threadId: number, servers: Record<string, ThreadMcpServer> | null): void;
+/** Remove a thread's custom MCP servers entirely (called on hard-delete). */
+export declare function deleteThreadMcpServers(threadId: number): void;
+/** All per-thread MCP servers (for dashboard enrichment), reserved/invalid excluded. */
+export declare function getAllThreadMcpServers(): Record<string, Record<string, ThreadMcpServer>>;
+export {};
+//# sourceMappingURL=mcp-settings.d.ts.map

package/dist/config/mcp-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-settings.d.ts","sourceRoot":"","sources":["../../src/config/mcp-settings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACjF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAQlG,kFAAkF;AAClF,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAE/D;AAED,6CAA6C;AAC7C,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,IAAI,CAI5E;AAED,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAUxE;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAWrD;AAmBD,yDAAyD;AACzD,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAA6B,CAAC;AAE9E,iFAAiF;AACjF,MAAM,MAAM,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AA2B9F,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CASnF;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAGrF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,IAAI,GAAG,SAAS,GAC1D,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CA4BjC;AAED,kGAAkG;AAClG,eAAO,MAAM,aAAa,6BAAS,CAAC;AAEpC,KAAK,qBAAqB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAE7F,gGAAgG;AAChG,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GACvC,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAWvC;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,IAAI,GAC9C,IAAI,CAQN;AAED,6EAA6E;AAC7E,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAQ7D;AAED,wFAAwF;AACxF,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CASxF"}