sensorium-mcp 3.0.103 → 3.1.0-board.0

package/Install-Sensorium.ps1

@@ -3,9 +3,14 @@
 .SYNOPSIS
     Install or update sensorium-supervisor from GitHub Releases.
 .DESCRIPTION
-    Downloads the latest sensorium-supervisor release binary from GitHub Releases
-    (tag: supervisor-latest, repo: andriyshevchenko/sensorium-mcp) and places
-    it in ~/.remote-copilot-mcp/bin/ as sensorium-supervisor.exe.
+    Downloads the sensorium-supervisor release binary from GitHub Releases
+    (repo: andriyshevchenko/sensorium-mcp) and places it in
+    ~/.remote-copilot-mcp/bin/ as sensorium-supervisor.exe.
+
+    The release channel follows the SAME switch as the MCP server: the tag in
+    MCPStartCommand ("npx -y sensorium-mcp@<tag>"). @latest -> supervisor-latest
+    (stable, built from main); @refactor -> supervisor-refactor (built from the
+    refactor branch). One edit to install.config.json flips both node + supervisor.
 
     All configuration is read from ~/.remote-copilot-mcp/install.config.json.
     Edit that file to change settings. Defaults are written on first run.
@@ -13,13 +18,20 @@
     .\Install-Sensorium.ps1
 #>
 
+param(
+    # Internal: used when the script re-invokes itself via `securevault run` so the
+    # release fetch + download happens inside a child process with the profile's
+    # token injected as an env var. Not intended for direct use.
+    [switch]$SyncReleaseOnly
+)
+
 $ErrorActionPreference = "Stop"
 
 # ── Constants ────────────────────────────────────────────────────────────────
 $GithubRepo = "andriyshevchenko/sensorium-mcp"
-$ReleaseTag = "supervisor-latest"
 $AssetName = "sensorium-supervisor-windows-amd64.exe"
 $InstalledBinaryName = "sensorium-supervisor.exe"
+# $ReleaseTag is resolved from the MCPStartCommand channel after config load.
 
 $DataDir = Join-Path $env:USERPROFILE ".remote-copilot-mcp"
 $BinDir = Join-Path $DataDir "bin"
@@ -67,6 +79,15 @@ $SecureVaultProfile = $Config["SecureVaultProfile"]
 $UpdateMode = $Config["UpdateMode"]
 $EffectiveMCPStartCommand = $Config["MCPStartCommand"]
 
+# Resolve the supervisor release channel from the same tag the node server
+# follows: the "@<tag>" in MCPStartCommand. Only @refactor uses the branch
+# build; everything else (incl. @latest, a bare version pin, or no tag) stays
+# on the stable supervisor-latest release. This keeps the stable rollback path
+# intact — pointing the config back at @latest restores the main supervisor.
+$mcpTag = if ($EffectiveMCPStartCommand -match 'sensorium-mcp@([A-Za-z0-9._-]+)') { $Matches[1] } else { "latest" }
+$ReleaseTag = if ($mcpTag -eq "refactor") { "supervisor-refactor" } else { "supervisor-latest" }
+Write-Host "Supervisor channel: $ReleaseTag (from MCP tag '$mcpTag')" -ForegroundColor Cyan
+
 # Validate config values
 if ($UpdateMode -notin @("production", "development")) {
     Write-Host "[WARN] Invalid UpdateMode '$UpdateMode' in config — falling back to 'production'" -ForegroundColor Yellow
@@ -87,15 +108,43 @@ function Stop-SupervisorProcess {
     }
 }
 
+function Get-GithubAuthHeaders {
+    param([string]$Accept = "application/vnd.github+json")
+
+    $headers = @{
+        "User-Agent" = "Install-Sensorium.ps1"
+        "Accept"     = $Accept
+    }
+
+    # Dedicated env var so it never collides with `gh` CLI's own GH_TOKEN/GITHUB_TOKEN,
+    # which may be logged into a different (e.g. corporate) account.
+    $token = $env:SENSORIUM_GH_TOKEN
+    if ([string]::IsNullOrWhiteSpace($token)) {
+        $token = $env:GH_TOKEN
+    }
+    if ([string]::IsNullOrWhiteSpace($token)) {
+        $token = $env:GITHUB_TOKEN
+    }
+
+    if (-not [string]::IsNullOrWhiteSpace($token)) {
+        $headers["Authorization"] = "Bearer $token"
+    }
+
+    return $headers
+}
+
 function Get-ReleaseAssetInfo {
     $apiUrl = "https://api.github.com/repos/$GithubRepo/releases/tags/$ReleaseTag"
     Write-Host "Fetching release info from GitHub..."
 
-    $headers = @{ "User-Agent" = "Install-Sensorium.ps1" }
+    $headers = Get-GithubAuthHeaders
     try {
         $release = Invoke-RestMethod -Uri $apiUrl -Headers $headers -ErrorAction Stop
     }
     catch {
+        if ($_.Exception.Response -and [int]$_.Exception.Response.StatusCode -in @(401, 403, 404)) {
+            throw "Failed to fetch GitHub release info ($($_.Exception.Response.StatusCode)). If the repo is private, set `$env:SENSORIUM_GH_TOKEN to a personal access token with read access to '$GithubRepo'. Original error: $_"
+        }
         throw "Failed to fetch GitHub release info: $_"
     }
 
@@ -111,7 +160,6 @@ function Get-ReleaseAssetInfo {
         AssetName      = $asset.name
         AssetSize      = [int64]$asset.size
         AssetUpdatedAt = $asset.updated_at
-        DownloadUrl    = $asset.browser_download_url
     }
 }
 
@@ -174,15 +222,22 @@ function Get-BinaryAsset {
         [pscustomobject]$AssetInfo
     )
 
-    $downloadUrl = $AssetInfo.DownloadUrl
-    Write-Host "Downloading $($AssetInfo.AssetName) from $downloadUrl ..."
+    # For private repos, `browser_download_url` only works unauthenticated when the repo is
+    # public. Use the authenticated assets API endpoint (with an octet-stream Accept header)
+    # so a personal access token in $env:SENSORIUM_GH_TOKEN can pull private-repo releases.
+    $downloadUrl = "https://api.github.com/repos/$GithubRepo/releases/assets/$($AssetInfo.AssetId)"
+    $headers = Get-GithubAuthHeaders -Accept "application/octet-stream"
+    Write-Host "Downloading $($AssetInfo.AssetName) ..."
 
     $tmpFile = "$Destination.tmp"
     try {
-        Invoke-WebRequest -Uri $downloadUrl -OutFile $tmpFile -UseBasicParsing -ErrorAction Stop
+        Invoke-WebRequest -Uri $downloadUrl -Headers $headers -OutFile $tmpFile -UseBasicParsing -ErrorAction Stop
     }
     catch {
         if (Test-Path $tmpFile) { Remove-Item $tmpFile -Force }
+        if ($_.Exception.Response -and [int]$_.Exception.Response.StatusCode -in @(401, 403, 404)) {
+            throw "Download failed ($($_.Exception.Response.StatusCode)). If the repo is private, set `$env:SENSORIUM_GH_TOKEN to a personal access token with read access to '$GithubRepo'. Original error: $_"
+        }
         throw "Download failed: $_"
     }
 
@@ -260,7 +315,7 @@ function Start-Supervisor {
     if ($useSecureVault) {
         Write-Host "Starting sensorium-supervisor via SecureVault (profile: $SecureVaultProfile)..."
         try {
-            securevault run "`"$Binary`"" --profile $SecureVaultProfile --detached
+            securevault run "`"$Binary`"" --profile $SecureVaultProfile --detach
         }
         catch {
             Write-Host "[ERROR] SecureVault launch failed: $($_.Exception.Message)" -ForegroundColor Red
@@ -281,7 +336,16 @@ function Start-Supervisor {
         Write-Host "Starting sensorium-supervisor (secrets from .env)..."
         Start-Process -FilePath $Binary -WindowStyle Hidden
     }
-    Start-Sleep -Seconds 2
+
+    # Poll briefly instead of a single fixed sleep — the detached launch chain
+    # (securevault's node process -> shell -> the actual .exe) can take longer
+    # than a couple seconds to actually spawn the binary, especially on a cold
+    # start. Avoids a spurious "process not found" right after a real launch.
+    $deadline = (Get-Date).AddSeconds(10)
+    while ((Get-Date) -lt $deadline) {
+        if (Get-Process -Name "sensorium-supervisor" -ErrorAction SilentlyContinue) { break }
+        Start-Sleep -Milliseconds 500
+    }
 }
 
 function Show-Status {
@@ -300,6 +364,43 @@ function Show-Status {
     }
 }
 
+function Invoke-DirectReleaseSync {
+    $assetInfo = Get-ReleaseAssetInfo
+    $binaryUpToDate = Test-BinaryUpToDate -Destination $Binary -MetadataPath $BinaryMetadata -AssetInfo $assetInfo
+
+    if ($binaryUpToDate) {
+        Write-Host "Installed binary already matches release asset '$($assetInfo.AssetName)' - skipping download." -ForegroundColor Green
+    }
+    else {
+        Get-BinaryAsset -Destination $Binary -MetadataPath $BinaryMetadata -AssetInfo $assetInfo
+    }
+}
+
+function Sync-ReleaseBinary {
+    $useSecureVault = (-not [string]::IsNullOrWhiteSpace($SecureVaultProfile)) -and (Test-SecureVaultAvailable)
+
+    if (-not $useSecureVault) {
+        Invoke-DirectReleaseSync
+        return
+    }
+
+    # Re-invoke this same script through SecureVault so the profile's GitHub token
+    # (mapped to env var SENSORIUM_GH_TOKEN) is injected only inside this child
+    # process — the outer script/session never sees it.
+    Write-Host "Fetching release via SecureVault (profile: $SecureVaultProfile)..."
+    securevault run pwsh -NoProfile -File "`"$PSCommandPath`"" -SyncReleaseOnly --profile $SecureVaultProfile
+    if ($LASTEXITCODE -ne 0) {
+        throw "SecureVault-driven release sync failed (exit $LASTEXITCODE). Ensure profile '$SecureVaultProfile' maps a GitHub PAT to env var SENSORIUM_GH_TOKEN."
+    }
+}
+
+if ($SyncReleaseOnly) {
+    # Running as the SecureVault-spawned child: the profile's token is already in the
+    # environment. Do the fetch/download directly (no re-entrant SecureVault call).
+    Invoke-DirectReleaseSync
+    return
+}
+
 # ── Main ─────────────────────────────────────────────────────────────────────
 $alreadyExists = Test-Path $Binary
 
@@ -325,15 +426,7 @@ if ($alreadyExists) {
 New-Item -ItemType Directory -Path $BinDir -Force | Out-Null
 
 # Step 3 — fetch release metadata and download only when needed
-$assetInfo = Get-ReleaseAssetInfo
-$binaryUpToDate = Test-BinaryUpToDate -Destination $Binary -MetadataPath $BinaryMetadata -AssetInfo $assetInfo
-
-if ($binaryUpToDate) {
-    Write-Host "Installed binary already matches release asset '$($assetInfo.AssetName)' - skipping download." -ForegroundColor Green
-}
-else {
-    Get-BinaryAsset -Destination $Binary -MetadataPath $BinaryMetadata -AssetInfo $assetInfo
-}
+Sync-ReleaseBinary
 
 # Step 4 — install launcher and start
 Install-StartupLauncher

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,82 @@
+/**
+ * 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;
+/** Reasoning effort written to the Copilot CLI's settings.json (low/medium/high). */
+export declare function getCopilotEffortLevel(): string;
+export declare function setCopilotEffortLevel(level: string): void;
+/** Context window tier written to the Copilot CLI's settings.json (normal/long_context). */
+export declare function getCopilotContextTier(): string;
+export declare function setCopilotContextTier(tier: 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;
+/**
+ * Whether Claude Code's native auto-memory (MEMORY.md read/write) runs in spawned
+ * threads. Off by default — it conflicts with Sensorium's own memory system. Toggleable
+ * from the dashboard's Claude tab; applied to each thread's settings.json at spawn.
+ */
+export declare function getClaudeAutoMemoryEnabled(): boolean;
+export declare function setClaudeAutoMemoryEnabled(enabled: boolean): 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":"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"}

package/dist/config/agent-settings.js

@@ -0,0 +1,261 @@
+/**
+ * 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_EFFORT_LEVEL = "high";
+const DEFAULT_COPILOT_CONTEXT_TIER = "long_context";
+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;
+    });
+}
+/** Reasoning effort written to the Copilot CLI's settings.json (low/medium/high). */
+export function getCopilotEffortLevel() {
+    const v = readSettings().copilotEffortLevel;
+    return typeof v === "string" && v.length > 0 ? v : DEFAULT_COPILOT_EFFORT_LEVEL;
+}
+export function setCopilotEffortLevel(level) {
+    updateSettings((s) => {
+        s.copilotEffortLevel = level;
+    });
+}
+/** Context window tier written to the Copilot CLI's settings.json (normal/long_context). */
+export function getCopilotContextTier() {
+    const v = readSettings().copilotContextTier;
+    return typeof v === "string" && v.length > 0 ? v : DEFAULT_COPILOT_CONTEXT_TIER;
+}
+export function setCopilotContextTier(tier) {
+    updateSettings((s) => {
+        s.copilotContextTier = tier;
+    });
+}
+/** 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;
+    });
+}
+/**
+ * Whether Claude Code's native auto-memory (MEMORY.md read/write) runs in spawned
+ * threads. Off by default — it conflicts with Sensorium's own memory system. Toggleable
+ * from the dashboard's Claude tab; applied to each thread's settings.json at spawn.
+ */
+export function getClaudeAutoMemoryEnabled() {
+    const v = readSettings().claudeAutoMemoryEnabled;
+    return typeof v === "boolean" ? v : false;
+}
+export function setClaudeAutoMemoryEnabled(enabled) {
+    updateSettings((s) => {
+        s.claudeAutoMemoryEnabled = enabled;
+    });
+}
+//# 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"}