sensorium-mcp 3.0.103 → 3.1.0-refactor.0

package/README.md

@@ -210,6 +210,31 @@ When disabled, episodes are still stored locally but not sent to OpenAI.
 
 ## Architecture
 
+### Source layout
+
+`src/` is organized as a layered tree. Imports flow strictly downward (a module
+may import only from its own layer or lower), enforced by an ESLint import
+fence. `src/index.ts` is the only module outside the fence — the entry point
+that wires everything together via dynamic imports.
+
+```
+                 bottom → top
+lib → config → integrations → data, llm → sessions → services → tools, dashboard → server
+```
+
+| Layer | Contents |
+|---|---|
+| `lib/` | logger, shared types, utils, markdown conversion |
+| `config/` | env parsing, settings store, paths |
+| `integrations/` | external clients: Telegram Bot API, OpenAI |
+| `data/`, `llm/` | SQLite memory (episodes → semantic notes → narratives); LLM prompts + JSON parsing |
+| `sessions/` | name→thread mapping, MCP session registry |
+| `services/` | orchestration: keeper, process/spawn, dispatcher, scheduler, consolidation, self-update |
+| `tools/`, `dashboard/` | MCP tool handlers, dashboard API + SPA |
+| `server/` | HTTP/SSE and stdio transports, server factory |
+
+### Data directory
+
 ```
 ~/.remote-copilot-mcp/
   memory.db                   <- SQLite: episodes, semantic notes, voice signatures, thread registry

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

@@ -0,0 +1,69 @@
+/**
+ * Agent client settings — agent type selection, default models, Copilot
+ * BYOK provider config, per-agent custom spawn env vars, and Claude spawn
+ * overrides (CLI path, OAuth token, git-bash path, concurrency cap).
+ */
+export type AgentType = "copilot" | "claude" | "codex" | "openai_codex" | "fable";
+/** The single source of truth for the default agent type when none is configured. */
+export declare const DEFAULT_AGENT_TYPE: AgentType;
+export declare const VALID_AGENT_TYPES: readonly string[];
+export declare function isValidAgentType(v: unknown): v is AgentType;
+export declare function getAgentType(): AgentType;
+export declare function setAgentType(type: AgentType): void;
+export declare function getFableModel(): string;
+export declare function getDefaultThreadModel(): string;
+export declare function getDefaultWorkerModel(): string;
+export declare function updateDefaultThreadModel(model: string): void;
+export declare function updateDefaultWorkerModel(model: string): void;
+export type CopilotProviderType = "openai" | "azure" | "anthropic";
+/**
+ * "Bring Your Own Key" provider config for the Copilot CLI. When enabled and a
+ * baseUrl + apiKey are present, the Copilot child is spawned pointing at a
+ * custom OpenAI-compatible endpoint (OpenRouter, DeepSeek, Kimi, …) instead of
+ * GitHub-hosted models. GitHub authentication is not used in this mode.
+ */
+export interface CopilotByokConfig {
+    enabled: boolean;
+    providerType: CopilotProviderType;
+    baseUrl: string;
+    apiKey: string;
+    /** Optional COPILOT_PROVIDER_MODEL_ID — well-known base model for tool-calling config. */
+    modelId: string;
+    /** Optional COPILOT_PROVIDER_WIRE_MODEL — actual model id sent on the wire. */
+    wireModel: string;
+}
+export declare function isValidCopilotProviderType(v: unknown): v is CopilotProviderType;
+/** Model passed to the Copilot CLI via --model / COPILOT_MODEL (native or BYOK). */
+export declare function getCopilotModel(): string;
+export declare function setCopilotModel(model: string): void;
+export declare function getCopilotByokConfig(): CopilotByokConfig;
+/**
+ * Merge a partial patch into the stored BYOK config and persist. The merged
+ * result is re-validated through normalizeByokConfig so the settings file can
+ * never hold an invalid providerType or non-string field, even though the input
+ * originates from the dashboard.
+ */
+export declare function setCopilotByokConfig(patch: Partial<CopilotByokConfig>): CopilotByokConfig;
+/**
+ * Assemble the environment variables that configure the Copilot CLI's model and
+ * (optionally) a custom BYOK provider. Values here are meant to override any
+ * inherited process.env at spawn time.
+ */
+export declare function getCopilotSpawnEnv(): Record<string, string>;
+export declare function getClaudeCustomEnvVars(): Record<string, string>;
+export declare function setClaudeCustomEnvVars(vars: Record<string, string>): void;
+export declare function getCopilotCustomEnvVars(): Record<string, string>;
+export declare function setCopilotCustomEnvVars(vars: Record<string, string>): void;
+/** Explicit path to the Claude CLI binary (settings only — env is read at the call site). */
+export declare function getClaudeCliPath(): string | undefined;
+export declare function setClaudeCliPath(path: string): void;
+/** Long-lived Claude setup token used in place of the broken OAuth refresh flow. */
+export declare function getClaudeOauthToken(): string | undefined;
+export declare function setClaudeOauthToken(token: string): void;
+/** Path to git-bash (Windows) passed to Claude via CLAUDE_CODE_GIT_BASH_PATH. */
+export declare function getClaudeGitBashPath(): string | undefined;
+export declare function setClaudeGitBashPath(path: string): void;
+/** Maximum number of concurrent spawned threads. */
+export declare function getMaxConcurrentThreads(): number;
+export declare function setMaxConcurrentThreads(count: number): void;
+//# sourceMappingURL=agent-settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-settings.d.ts","sourceRoot":"","sources":["../../src/config/agent-settings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,cAAc,GAAG,OAAO,CAAC;AAElF,qFAAqF;AACrF,eAAO,MAAM,kBAAkB,EAAE,SAAoB,CAAC;AAEtD,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAM9C,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,SAAS,CAE3D;AAED,wBAAgB,YAAY,IAAI,SAAS,CAGxC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAIlD;AAWD,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAG9C;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAG9C;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAI5D;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAI5D;AAMD,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,mBAAmB,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;CACnB;AAWD,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,mBAAmB,CAE/E;AAED,oFAAoF;AACpF,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAInD;AAgBD,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAMzF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAY3D;AAqBD,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE/D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAIzE;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEhE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAI1E;AAiBD,6FAA6F;AAC7F,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,SAAS,CAErD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKnD;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAExD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAKvD;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,SAAS,CAEzD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAKvD;AAED,oDAAoD;AACpD,wBAAgB,uBAAuB,IAAI,MAAM,CAIhD;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAM3D"}

package/dist/config/agent-settings.js

@@ -0,0 +1,225 @@
+/**
+ * Agent client settings — agent type selection, default models, Copilot
+ * BYOK provider config, per-agent custom spawn env vars, and Claude spawn
+ * overrides (CLI path, OAuth token, git-bash path, concurrency cap).
+ */
+import { readSettings, updateSettings } from "./settings-store.js";
+/** The single source of truth for the default agent type when none is configured. */
+export const DEFAULT_AGENT_TYPE = "claude";
+export const VALID_AGENT_TYPES = [
+    "copilot",
+    "claude",
+    "codex",
+    "openai_codex",
+    "fable",
+];
+export function isValidAgentType(v) {
+    return typeof v === "string" && VALID_AGENT_TYPES.includes(v);
+}
+export function getAgentType() {
+    const t = readSettings().agentType;
+    return isValidAgentType(t) ? t : DEFAULT_AGENT_TYPE;
+}
+export function setAgentType(type) {
+    updateSettings((s) => {
+        s.agentType = type;
+    });
+}
+// ─── Default model settings ──────────────────────────────────────────────────
+const DEFAULT_THREAD_MODEL = "claude-opus-4-6";
+const DEFAULT_WORKER_MODEL = "claude-sonnet-4-6";
+// Model for the experimental "fable" agent type — a Claude-CLI thread pinned to
+// a distinct (premium) model. Overridable via settings.fableModel.
+const DEFAULT_FABLE_MODEL = "claude-fable-5";
+export function getFableModel() {
+    const v = readSettings().fableModel;
+    return typeof v === "string" && v.length > 0 ? v : DEFAULT_FABLE_MODEL;
+}
+export function getDefaultThreadModel() {
+    const v = readSettings().defaultThreadModel;
+    return typeof v === "string" && v.length > 0 ? v : DEFAULT_THREAD_MODEL;
+}
+export function getDefaultWorkerModel() {
+    const v = readSettings().defaultWorkerModel;
+    return typeof v === "string" && v.length > 0 ? v : DEFAULT_WORKER_MODEL;
+}
+export function updateDefaultThreadModel(model) {
+    updateSettings((s) => {
+        s.defaultThreadModel = model;
+    });
+}
+export function updateDefaultWorkerModel(model) {
+    updateSettings((s) => {
+        s.defaultWorkerModel = model;
+    });
+}
+// ─── Copilot provider (BYOK / OpenRouter) settings ──────────────────────────
+const DEFAULT_COPILOT_MODEL = "claude-opus-4-6";
+const DEFAULT_COPILOT_BYOK = {
+    enabled: false,
+    providerType: "openai",
+    baseUrl: "",
+    apiKey: "",
+    modelId: "",
+    wireModel: "",
+};
+export function isValidCopilotProviderType(v) {
+    return v === "openai" || v === "azure" || v === "anthropic";
+}
+/** Model passed to the Copilot CLI via --model / COPILOT_MODEL (native or BYOK). */
+export function getCopilotModel() {
+    const v = readSettings().copilotModel;
+    return typeof v === "string" && v.length > 0 ? v : DEFAULT_COPILOT_MODEL;
+}
+export function setCopilotModel(model) {
+    updateSettings((s) => {
+        s.copilotModel = model;
+    });
+}
+/** Coerce an untrusted value into a fully-valid CopilotByokConfig, filling defaults. */
+function normalizeByokConfig(raw) {
+    if (!raw || typeof raw !== "object")
+        return { ...DEFAULT_COPILOT_BYOK };
+    const e = raw;
+    return {
+        enabled: typeof e.enabled === "boolean" ? e.enabled : false,
+        providerType: isValidCopilotProviderType(e.providerType) ? e.providerType : "openai",
+        baseUrl: typeof e.baseUrl === "string" ? e.baseUrl : "",
+        apiKey: typeof e.apiKey === "string" ? e.apiKey : "",
+        modelId: typeof e.modelId === "string" ? e.modelId : "",
+        wireModel: typeof e.wireModel === "string" ? e.wireModel : "",
+    };
+}
+export function getCopilotByokConfig() {
+    return normalizeByokConfig(readSettings().copilotByok);
+}
+/**
+ * Merge a partial patch into the stored BYOK config and persist. The merged
+ * result is re-validated through normalizeByokConfig so the settings file can
+ * never hold an invalid providerType or non-string field, even though the input
+ * originates from the dashboard.
+ */
+export function setCopilotByokConfig(patch) {
+    const next = normalizeByokConfig({ ...getCopilotByokConfig(), ...patch });
+    updateSettings((s) => {
+        s.copilotByok = next;
+    });
+    return next;
+}
+/**
+ * Assemble the environment variables that configure the Copilot CLI's model and
+ * (optionally) a custom BYOK provider. Values here are meant to override any
+ * inherited process.env at spawn time.
+ */
+export function getCopilotSpawnEnv() {
+    const model = getCopilotModel();
+    const env = { COPILOT_MODEL: model };
+    const byok = getCopilotByokConfig();
+    if (byok.enabled && byok.baseUrl && byok.apiKey) {
+        env.COPILOT_PROVIDER_BASE_URL = byok.baseUrl;
+        env.COPILOT_PROVIDER_TYPE = byok.providerType;
+        env.COPILOT_PROVIDER_API_KEY = byok.apiKey;
+        env.COPILOT_PROVIDER_MODEL_ID = byok.modelId || model;
+        env.COPILOT_PROVIDER_WIRE_MODEL = byok.wireModel || model;
+    }
+    return env;
+}
+// ─── Custom spawn env vars (per agent) ──────────────────────────────────────
+//
+// Operator-supplied env vars merged into the respective agent's spawn env. They
+// are stored per agent so a var set for Claude is never injected into Copilot
+// (and vice-versa). Locked built-ins always win over these, and the spawn path
+// strips any ENV_DENYLIST key so a custom var can't smuggle a secret/cross-agent
+// value past the denylist.
+/** Coerce untrusted input into a clean string→string map (trimmed non-empty keys). */
+function normalizeCustomEnvVars(raw) {
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return {};
+    const out = {};
+    for (const [k, v] of Object.entries(raw)) {
+        const key = typeof k === "string" ? k.trim() : "";
+        if (key && typeof v === "string")
+            out[key] = v;
+    }
+    return out;
+}
+export function getClaudeCustomEnvVars() {
+    return normalizeCustomEnvVars(readSettings().claudeCustomEnvVars);
+}
+export function setClaudeCustomEnvVars(vars) {
+    updateSettings((s) => {
+        s.claudeCustomEnvVars = normalizeCustomEnvVars(vars);
+    });
+}
+export function getCopilotCustomEnvVars() {
+    return normalizeCustomEnvVars(readSettings().copilotCustomEnvVars);
+}
+export function setCopilotCustomEnvVars(vars) {
+    updateSettings((s) => {
+        s.copilotCustomEnvVars = normalizeCustomEnvVars(vars);
+    });
+}
+// ─── Claude spawn settings ──────────────────────────────────────────────────
+//
+// Overrides for values previously only discoverable from the environment or via
+// auto-detection. Precedence is always env var → dashboard setting → autodetect,
+// so setting an env var keeps the exact prior behavior and an unset setting is a
+// no-op. Returns undefined when neither env nor setting supplies a value, letting
+// the caller fall back to its existing auto-detection logic.
+const DEFAULT_MAX_CONCURRENT_THREADS = 20;
+function readStringSetting(key) {
+    const v = readSettings()[key];
+    return typeof v === "string" && v.length > 0 ? v : undefined;
+}
+/** Explicit path to the Claude CLI binary (settings only — env is read at the call site). */
+export function getClaudeCliPath() {
+    return readStringSetting("claudeCliPath");
+}
+export function setClaudeCliPath(path) {
+    updateSettings((s) => {
+        if (path)
+            s.claudeCliPath = path;
+        else
+            delete s.claudeCliPath;
+    });
+}
+/** Long-lived Claude setup token used in place of the broken OAuth refresh flow. */
+export function getClaudeOauthToken() {
+    return readStringSetting("claudeOauthToken");
+}
+export function setClaudeOauthToken(token) {
+    updateSettings((s) => {
+        if (token)
+            s.claudeOauthToken = token;
+        else
+            delete s.claudeOauthToken;
+    });
+}
+/** Path to git-bash (Windows) passed to Claude via CLAUDE_CODE_GIT_BASH_PATH. */
+export function getClaudeGitBashPath() {
+    return readStringSetting("claudeGitBashPath");
+}
+export function setClaudeGitBashPath(path) {
+    updateSettings((s) => {
+        if (path)
+            s.claudeGitBashPath = path;
+        else
+            delete s.claudeGitBashPath;
+    });
+}
+/** Maximum number of concurrent spawned threads. */
+export function getMaxConcurrentThreads() {
+    const v = readSettings().maxConcurrentThreads;
+    if (typeof v === "number" && Number.isFinite(v) && v >= 1)
+        return Math.round(v);
+    return DEFAULT_MAX_CONCURRENT_THREADS;
+}
+export function setMaxConcurrentThreads(count) {
+    const clamped = Math.max(1, Math.round(count));
+    if (!Number.isFinite(clamped))
+        return;
+    updateSettings((s) => {
+        s.maxConcurrentThreads = clamped;
+    });
+}
+//# sourceMappingURL=agent-settings.js.map

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

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

package/dist/config/agent-templates.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 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 { type AgentType } from "./agent-settings.js";
+import { type ThreadMcpServer } from "./mcp-settings.js";
+export interface AgentTemplate {
+    id: string;
+    name: string;
+    client: AgentType;
+    workingDirectory: string;
+    systemPrompt?: string;
+    mcpServers?: Record<string, ThreadMcpServer>;
+}
+/** All stored agent templates (malformed entries dropped). */
+export declare function getAgentTemplates(): AgentTemplate[];
+/** Single template by id, or null. */
+export declare function getAgentTemplate(id: string): AgentTemplate | 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 declare function saveAgentTemplate(input: {
+    id?: string;
+    name: string;
+    client: string;
+    workingDirectory: string;
+    systemPrompt?: string | null;
+    mcpServers?: Record<string, ThreadMcpServer> | null;
+}): AgentTemplate;
+/** Remove a template by id. Returns true if one was removed. */
+export declare function deleteAgentTemplate(id: string): boolean;
+//# sourceMappingURL=agent-templates.d.ts.map

package/dist/config/agent-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-templates.d.ts","sourceRoot":"","sources":["../../src/config/agent-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,KAAK,SAAS,EAAuC,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC9C;AAuBD,8DAA8D;AAC9D,wBAAgB,iBAAiB,IAAI,aAAa,EAAE,CASnD;AAED,sCAAsC;AACtC,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,IAAI,CAAC;CACrD,GAAG,aAAa,CA2BhB;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAQvD"}

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/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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 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;AAWnC,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,58 @@
+/**
+ * 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";
+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;AAEnC,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"}