@geminixiang/mikan 1.0.0-beta.6 → 1.0.0-beta.61

package/dist/sessions/types.d.ts

@@ -1,4 +1,7 @@
 import type { ConversationKind } from "../adapter.js";
+import type { AgentMessage, Entry, MessageEntry } from "@earendil-works/pi-agent-core";
+import type { ConversationLogMessage } from "../types.js";
+import type { SessionStore } from "./session-store.js";
 export interface MikanSessionHeader {
     type?: string;
     version?: number;
@@ -6,6 +9,7 @@ export interface MikanSessionHeader {
     timestamp?: string;
     cwd?: string;
     parentSession?: string;
+    /** Legacy platform-history marker; preserved in mikan's durable session metadata. */
     source?: {
         kind?: string;
         file?: string;
@@ -20,6 +24,48 @@ export interface ResolveSessionKeyOptions {
     persistentTopLevel?: boolean;
     scopeDirectThreads?: boolean;
 }
+/** Model-visible messages reconstructed from the active session branch. */
+export interface SessionContext {
+    messages: AgentMessage[];
+}
+/** Message entry as stored in mikan session files (Pi v4). */
+export type SessionMessageEntry = MessageEntry;
+/** Union of entry types mikan reads and writes. Alias of Pi's v4 entry. */
+export type SessionEntry = Entry;
+export declare const CURRENT_SESSION_VERSION = 4;
+export interface SessionCreateInfo {
+    id?: string;
+    parentSession?: string;
+    parentSessionId?: string;
+}
+/** Immutable session queries available to portals, admin, and migration code. */
+export interface SessionInspection {
+    getHeader(): SessionHeader;
+    getEntries(): Promise<Entry[]>;
+    getSessionName(): Promise<string | undefined>;
+    getBranch(fromId?: string): Promise<Entry[]>;
+    buildSessionContext(): Promise<SessionContext>;
+}
+/**
+ * Compatibility header view synthesized from the v4 file header for callers
+ * that read mikan session lineage. `metadata` carries mikan header extras (for
+ * example `parentSessionPath` and the legacy `source` marker preserved by
+ * the v3 migration).
+ */
+export interface SessionHeader {
+    type: "session";
+    version?: number;
+    id: string;
+    timestamp: string;
+    cwd: string;
+    parentSession?: string;
+    parentSessionId?: string;
+    [extra: string]: unknown;
+}
+export interface ParentSessionRef {
+    path: string;
+    id: string;
+}
 export interface ThreadRootMessage {
     text?: string;
     userName?: string;
@@ -32,7 +78,19 @@ export interface ResolvedSessionScope {
     contextFile: string;
     threadRootMessage: ThreadRootMessage | null;
 }
-export interface AgentMemoryFileManagerOptions {
+/** One parsed log.jsonl entry with its original line index. */
+export interface LogRecord {
+    message: ConversationLogMessage;
+    index: number;
+}
+/** What one sync pass actually did — the inspectable result of a sync. */
+export interface ChatSyncReport {
+    /** Log messages appended to the session in this pass. */
+    appended: number;
+    /** The log message id recorded as the new sync watermark. */
+    lastMessageId?: string;
+}
+export interface ChatHistorySyncOptions {
     recentDays?: number;
     maxTopLevelMessages?: number;
     now?: () => Date;
@@ -41,16 +99,14 @@ export interface ResolveChatSessionScopeOptions {
     conversationDir: string;
     sessionKey: string;
     cwd?: string;
-    /** The triggering platform message ID. Excluded from bootstrap to avoid duplicate user turns. */
+    /** The triggering platform message ID. History is capped before this turn to avoid future queued turns. */
     currentMessageId?: string;
-    /** Rotate top-level shared sessions on biweekly Sunday boundaries. */
-    rotateTopLevelSession?: boolean;
 }
-export interface SyncAgentMemoryFileManagerOptions {
+export interface SyncChatSessionOptions {
     conversationDir: string;
     sessionKey: string;
-    sessionManager: import("../harness/index.js").SessionStore;
-    /** The triggering platform message ID. Excluded from sync to avoid duplicate user turns. */
+    sessionManager: SessionStore;
+    /** The triggering platform message ID. Sync is capped before this turn to avoid future queued turns. */
     currentMessageId?: string;
 }
 export interface ResetChatSessionOptions {
@@ -75,4 +131,14 @@ export interface ThreadBootstrapWaitOptions {
     sleep?: (ms: number) => Promise<void>;
     pollMs?: number;
 }
+export interface MigrateResult {
+    file: string;
+    status: "migrated" | "already-v4" | "skipped";
+    detail?: string;
+}
+export interface Pi084MigrationResult {
+    file: string;
+    status: "migrated" | "already-current" | "not-pi-084";
+    detail?: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/sessions/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sessions/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAItD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAID,MAAM,WAAW,wBAAwB;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAID,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC7C;AAID,MAAM,WAAW,6BAA6B;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,8BAA8B;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iGAAiG;IACjG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,iCAAiC;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,OAAO,qBAAqB,EAAE,YAAY,CAAC;IAC3D,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,4BAA4B;IAC3C,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,6BAA6B;IAC5C,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sessions/types.ts"],"names":[],"mappings":"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"}

package/dist/sessions/types.js

@@ -1,2 +1,2 @@
-export {};
+export const CURRENT_SESSION_VERSION = 4;
 //# sourceMappingURL=types.js.map

package/dist/sessions/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sessions/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ConversationKind } from \"../adapter.js\";\n\n// ── session metadata ─────────────────────────────────────────────────────────\n\nexport interface MikanSessionHeader {\n  type?: string;\n  version?: number;\n  id?: string;\n  timestamp?: string;\n  cwd?: string;\n  parentSession?: string;\n  source?: {\n    kind?: string;\n    file?: string;\n    recentDays?: number;\n  };\n}\n\n// ── session policy ───────────────────────────────────────────────────────────\n\nexport interface ResolveSessionKeyOptions {\n  conversationId: string;\n  conversationKind: ConversationKind;\n  messageId: string;\n  threadTs?: string;\n  persistentTopLevel?: boolean;\n  scopeDirectThreads?: boolean;\n}\n\n// ── session store ────────────────────────────────────────────────────────────\n\nexport interface ThreadRootMessage {\n  text?: string;\n  userName?: string;\n  user?: string;\n  loggedAt?: number;\n  isMessagingBot?: boolean;\n}\n\nexport interface ResolvedSessionScope {\n  sessionDir: string;\n  contextFile: string;\n  threadRootMessage: ThreadRootMessage | null;\n}\n\n// ── chat session manager ─────────────────────────────────────────────────────\n\nexport interface AgentMemoryFileManagerOptions {\n  recentDays?: number;\n  maxTopLevelMessages?: number;\n  now?: () => Date;\n}\n\nexport interface ResolveChatSessionScopeOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n  /** The triggering platform message ID. Excluded from bootstrap to avoid duplicate user turns. */\n  currentMessageId?: string;\n  /** Rotate top-level shared sessions on biweekly Sunday boundaries. */\n  rotateTopLevelSession?: boolean;\n}\n\nexport interface SyncAgentMemoryFileManagerOptions {\n  conversationDir: string;\n  sessionKey: string;\n  sessionManager: import(\"../harness/index.js\").SessionStore;\n  /** The triggering platform message ID. Excluded from sync to avoid duplicate user turns. */\n  currentMessageId?: string;\n}\n\nexport interface ResetChatSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n}\n\nexport interface RegisterThreadSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n}\n\nexport interface HasMaterializedSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n}\n\nexport interface ThreadBootstrapWaitOptions {\n  parentSessionKey: string;\n  sessionKey: string;\n  hasThreadSession: () => boolean;\n  isParentRunning: () => boolean;\n  sleep?: (ms: number) => Promise<void>;\n  pollMs?: number;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sessions/types.ts"],"names":[],"mappings":"AA8CA,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC","sourcesContent":["import type { ConversationKind } from \"../adapter.js\";\nimport type { AgentMessage, Entry, MessageEntry } from \"@earendil-works/pi-agent-core\";\nimport type { ConversationLogMessage } from \"../types.js\";\nimport type { SessionStore } from \"./session-store.js\";\n\n// ── session metadata ─────────────────────────────────────────────────────────\n\nexport interface MikanSessionHeader {\n  type?: string;\n  version?: number;\n  id?: string;\n  timestamp?: string;\n  cwd?: string;\n  parentSession?: string;\n  /** Legacy platform-history marker; preserved in mikan's durable session metadata. */\n  source?: {\n    kind?: string;\n    file?: string;\n    recentDays?: number;\n  };\n}\n\n// ── session policy ───────────────────────────────────────────────────────────\n\nexport interface ResolveSessionKeyOptions {\n  conversationId: string;\n  conversationKind: ConversationKind;\n  messageId: string;\n  threadTs?: string;\n  persistentTopLevel?: boolean;\n  scopeDirectThreads?: boolean;\n}\n\n// ── session store ────────────────────────────────────────────────────────────\n\n/** Model-visible messages reconstructed from the active session branch. */\nexport interface SessionContext {\n  messages: AgentMessage[];\n}\n\n/** Message entry as stored in mikan session files (Pi v4). */\nexport type SessionMessageEntry = MessageEntry;\n\n/** Union of entry types mikan reads and writes. Alias of Pi's v4 entry. */\nexport type SessionEntry = Entry;\n\nexport const CURRENT_SESSION_VERSION = 4;\n\nexport interface SessionCreateInfo {\n  id?: string;\n  parentSession?: string;\n  parentSessionId?: string;\n}\n\n/** Immutable session queries available to portals, admin, and migration code. */\nexport interface SessionInspection {\n  getHeader(): SessionHeader;\n  getEntries(): Promise<Entry[]>;\n  getSessionName(): Promise<string | undefined>;\n  getBranch(fromId?: string): Promise<Entry[]>;\n  buildSessionContext(): Promise<SessionContext>;\n}\n\n/**\n * Compatibility header view synthesized from the v4 file header for callers\n * that read mikan session lineage. `metadata` carries mikan header extras (for\n * example `parentSessionPath` and the legacy `source` marker preserved by\n * the v3 migration).\n */\nexport interface SessionHeader {\n  type: \"session\";\n  version?: number;\n  id: string;\n  timestamp: string;\n  cwd: string;\n  parentSession?: string;\n  parentSessionId?: string;\n  [extra: string]: unknown;\n}\n\nexport interface ParentSessionRef {\n  path: string;\n  id: string;\n}\n\nexport interface ThreadRootMessage {\n  text?: string;\n  userName?: string;\n  user?: string;\n  loggedAt?: number;\n  isMessagingBot?: boolean;\n}\n\nexport interface ResolvedSessionScope {\n  sessionDir: string;\n  contextFile: string;\n  threadRootMessage: ThreadRootMessage | null;\n}\n\n/** One parsed log.jsonl entry with its original line index. */\nexport interface LogRecord {\n  message: ConversationLogMessage;\n  index: number;\n}\n\n// ── chat history sync ────────────────────────────────────────────────────────\n\n/** What one sync pass actually did — the inspectable result of a sync. */\nexport interface ChatSyncReport {\n  /** Log messages appended to the session in this pass. */\n  appended: number;\n  /** The log message id recorded as the new sync watermark. */\n  lastMessageId?: string;\n}\n\nexport interface ChatHistorySyncOptions {\n  recentDays?: number;\n  maxTopLevelMessages?: number;\n  now?: () => Date;\n}\n\nexport interface ResolveChatSessionScopeOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n  /** The triggering platform message ID. History is capped before this turn to avoid future queued turns. */\n  currentMessageId?: string;\n}\n\nexport interface SyncChatSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n  sessionManager: SessionStore;\n  /** The triggering platform message ID. Sync is capped before this turn to avoid future queued turns. */\n  currentMessageId?: string;\n}\n\nexport interface ResetChatSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n}\n\nexport interface RegisterThreadSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n  cwd?: string;\n}\n\nexport interface HasMaterializedSessionOptions {\n  conversationDir: string;\n  sessionKey: string;\n}\n\nexport interface ThreadBootstrapWaitOptions {\n  parentSessionKey: string;\n  sessionKey: string;\n  hasThreadSession: () => boolean;\n  isParentRunning: () => boolean;\n  sleep?: (ms: number) => Promise<void>;\n  pollMs?: number;\n}\n\n// ── v3 migration ─────────────────────────────────────────────────────────────\n\nexport interface MigrateResult {\n  file: string;\n  status: \"migrated\" | \"already-v4\" | \"skipped\";\n  detail?: string;\n}\n\nexport interface Pi084MigrationResult {\n  file: string;\n  status: \"migrated\" | \"already-current\" | \"not-pi-084\";\n  detail?: string;\n}\n"]}

package/dist/settings-mutation.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The one writer seam for settings mutations that affect live conversations.
+ * Chat commands (/model, /sandbox) and the Admin portal are adapters here;
+ * none of them call updateConversationSettings/updateGlobalSettings directly
+ * for these keys anymore.
+ *
+ * Policy, uniform across all adapters:
+ * - llm.* changes bake into cached session runners, so a conversation-scoped
+ *   change clears the conversation's cached runners BEFORE writing — and
+ *   refuses (no write, no clear) while the conversation has a running job.
+ *   Disk and cache never disagree.
+ * - Other keys (sandbox mount, slack replyMode, limits) are re-read at use
+ *   time and write without touching runners.
+ * - Global changes always write (the Admin default surface), then clear every
+ *   idle conversation's cached runners; conversations that were busy keep
+ *   their old runner until it settles, are reported as stale, and are cleared
+ *   automatically before their next turn.
+ */
+import { type WorkspacePolicyChoice } from "./config.js";
+import type { Office } from "./office/index.js";
+import type { AgentConfig, GlobalRunnerCacheControl, OfficeAddress, RunnerCacheControl, SettingsApplyResult } from "./types.js";
+export type { GlobalRunnerCacheControl, RunnerCacheControl, SettingsApplyResult } from "./types.js";
+export declare function applyConversationSettings(runtime: RunnerCacheControl | undefined, office: Office, patch: Partial<AgentConfig>): SettingsApplyResult;
+export declare function applyGlobalSettings(runtime: GlobalRunnerCacheControl | undefined, patch: Partial<AgentConfig>): {
+    ok: true;
+    staleConversations: OfficeAddress[];
+};
+/**
+ * Door-policy changes follow the same clear-or-refuse contract as model
+ * changes: the system prompt bakes the workspace projection (layout line,
+ * memory and skill guidance), so the cached runner must clear before the
+ * write, and the container is re-provisioned on the next message when its
+ * mount signature no longer matches.
+ */
+export declare function applyConversationWorkspacePolicy(runtime: RunnerCacheControl | undefined, office: Office, choice: WorkspacePolicyChoice | null): SettingsApplyResult;
+export declare function applyGlobalWorkspacePolicy(runtime: GlobalRunnerCacheControl | undefined, choice: WorkspacePolicyChoice | null): {
+    ok: true;
+    staleConversations: OfficeAddress[];
+};
+//# sourceMappingURL=settings-mutation.d.ts.map

package/dist/settings-mutation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-mutation.d.ts","sourceRoot":"","sources":["../src/settings-mutation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EACV,WAAW,EACX,wBAAwB,EACxB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAcpG,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,kBAAkB,GAAG,SAAS,EACvC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAC1B,mBAAmB,CAYrB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,wBAAwB,GAAG,SAAS,EAC7C,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,kBAAkB,EAAE,aAAa,EAAE,CAAA;CAAE,CAKnD;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,kBAAkB,GAAG,SAAS,EACvC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,qBAAqB,GAAG,IAAI,GACnC,mBAAmB,CAMrB;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,wBAAwB,GAAG,SAAS,EAC7C,MAAM,EAAE,qBAAqB,GAAG,IAAI,GACnC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,kBAAkB,EAAE,aAAa,EAAE,CAAA;CAAE,CAInD"}

package/dist/settings-mutation.js

@@ -0,0 +1,66 @@
+/**
+ * The one writer seam for settings mutations that affect live conversations.
+ * Chat commands (/model, /sandbox) and the Admin portal are adapters here;
+ * none of them call updateConversationSettings/updateGlobalSettings directly
+ * for these keys anymore.
+ *
+ * Policy, uniform across all adapters:
+ * - llm.* changes bake into cached session runners, so a conversation-scoped
+ *   change clears the conversation's cached runners BEFORE writing — and
+ *   refuses (no write, no clear) while the conversation has a running job.
+ *   Disk and cache never disagree.
+ * - Other keys (sandbox mount, slack replyMode, limits) are re-read at use
+ *   time and write without touching runners.
+ * - Global changes always write (the Admin default surface), then clear every
+ *   idle conversation's cached runners; conversations that were busy keep
+ *   their old runner until it settles, are reported as stale, and are cleared
+ *   automatically before their next turn.
+ */
+import { setConversationWorkspacePolicy, setGlobalWorkspacePolicy, updateConversationSettings, updateGlobalSettings, } from "./config.js";
+/** True when a patch touches keys a cached session runner bakes in. */
+function affectsCachedRunner(patch) {
+    return (patch.provider !== undefined ||
+        patch.model !== undefined ||
+        patch.thinkingLevel !== undefined ||
+        // MCP tools are connected when the runner is built, so a server change
+        // only takes effect on a fresh runner.
+        patch.mcpServers !== undefined);
+}
+export function applyConversationSettings(runtime, office, patch) {
+    let runtimeSwitched = null;
+    if (affectsCachedRunner(patch) && runtime) {
+        // Clear-or-refuse before writing. The clear and the write happen in the
+        // same synchronous tick, so no runner can be created in between.
+        if (!runtime.switchConversationModel(office.address, patch.provider ?? "", patch.model ?? "")) {
+            return { ok: false, reason: "busy" };
+        }
+        runtimeSwitched = true;
+    }
+    updateConversationSettings(office, patch);
+    return { ok: true, runtimeSwitched };
+}
+export function applyGlobalSettings(runtime, patch) {
+    updateGlobalSettings(patch);
+    const staleConversations = affectsCachedRunner(patch) && runtime ? runtime.refreshAllConversations().busy : [];
+    return { ok: true, staleConversations };
+}
+/**
+ * Door-policy changes follow the same clear-or-refuse contract as model
+ * changes: the system prompt bakes the workspace projection (layout line,
+ * memory and skill guidance), so the cached runner must clear before the
+ * write, and the container is re-provisioned on the next message when its
+ * mount signature no longer matches.
+ */
+export function applyConversationWorkspacePolicy(runtime, office, choice) {
+    if (runtime && !runtime.refreshConversationEnvironment(office.address)) {
+        return { ok: false, reason: "busy" };
+    }
+    setConversationWorkspacePolicy(office, choice);
+    return { ok: true, runtimeSwitched: runtime ? true : null };
+}
+export function applyGlobalWorkspacePolicy(runtime, choice) {
+    setGlobalWorkspacePolicy(choice);
+    const staleConversations = runtime ? runtime.refreshAllConversations().busy : [];
+    return { ok: true, staleConversations };
+}
+//# sourceMappingURL=settings-mutation.js.map

package/dist/settings-mutation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-mutation.js","sourceRoot":"","sources":["../src/settings-mutation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EACL,8BAA8B,EAC9B,wBAAwB,EACxB,0BAA0B,EAC1B,oBAAoB,GAErB,MAAM,aAAa,CAAC;AAYrB,uEAAuE;AACvE,SAAS,mBAAmB,CAAC,KAA2B;IACtD,OAAO,CACL,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC5B,KAAK,CAAC,KAAK,KAAK,SAAS;QACzB,KAAK,CAAC,aAAa,KAAK,SAAS;QACjC,uEAAuE;QACvE,uCAAuC;QACvC,KAAK,CAAC,UAAU,KAAK,SAAS,CAC/B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,OAAuC,EACvC,MAAc,EACd,KAA2B;IAE3B,IAAI,eAAe,GAAmB,IAAI,CAAC;IAC3C,IAAI,mBAAmB,CAAC,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QAC1C,wEAAwE;QACxE,iEAAiE;QACjE,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;YAC9F,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACvC,CAAC;QACD,eAAe,GAAG,IAAI,CAAC;IACzB,CAAC;IACD,0BAA0B,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAA6C,EAC7C,KAA2B;IAE3B,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,kBAAkB,GACtB,mBAAmB,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAC9C,OAAuC,EACvC,MAAc,EACd,MAAoC;IAEpC,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,8BAA8B,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACvE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACvC,CAAC;IACD,8BAA8B,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,OAA6C,EAC7C,MAAoC;IAEpC,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,MAAM,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;AAC1C,CAAC","sourcesContent":["/**\n * The one writer seam for settings mutations that affect live conversations.\n * Chat commands (/model, /sandbox) and the Admin portal are adapters here;\n * none of them call updateConversationSettings/updateGlobalSettings directly\n * for these keys anymore.\n *\n * Policy, uniform across all adapters:\n * - llm.* changes bake into cached session runners, so a conversation-scoped\n *   change clears the conversation's cached runners BEFORE writing — and\n *   refuses (no write, no clear) while the conversation has a running job.\n *   Disk and cache never disagree.\n * - Other keys (sandbox mount, slack replyMode, limits) are re-read at use\n *   time and write without touching runners.\n * - Global changes always write (the Admin default surface), then clear every\n *   idle conversation's cached runners; conversations that were busy keep\n *   their old runner until it settles, are reported as stale, and are cleared\n *   automatically before their next turn.\n */\nimport {\n  setConversationWorkspacePolicy,\n  setGlobalWorkspacePolicy,\n  updateConversationSettings,\n  updateGlobalSettings,\n  type WorkspacePolicyChoice,\n} from \"./config.js\";\nimport type { Office } from \"./office/index.js\";\nimport type {\n  AgentConfig,\n  GlobalRunnerCacheControl,\n  OfficeAddress,\n  RunnerCacheControl,\n  SettingsApplyResult,\n} from \"./types.js\";\n\nexport type { GlobalRunnerCacheControl, RunnerCacheControl, SettingsApplyResult } from \"./types.js\";\n\n/** True when a patch touches keys a cached session runner bakes in. */\nfunction affectsCachedRunner(patch: Partial<AgentConfig>): boolean {\n  return (\n    patch.provider !== undefined ||\n    patch.model !== undefined ||\n    patch.thinkingLevel !== undefined ||\n    // MCP tools are connected when the runner is built, so a server change\n    // only takes effect on a fresh runner.\n    patch.mcpServers !== undefined\n  );\n}\n\nexport function applyConversationSettings(\n  runtime: RunnerCacheControl | undefined,\n  office: Office,\n  patch: Partial<AgentConfig>,\n): SettingsApplyResult {\n  let runtimeSwitched: boolean | null = null;\n  if (affectsCachedRunner(patch) && runtime) {\n    // Clear-or-refuse before writing. The clear and the write happen in the\n    // same synchronous tick, so no runner can be created in between.\n    if (!runtime.switchConversationModel(office.address, patch.provider ?? \"\", patch.model ?? \"\")) {\n      return { ok: false, reason: \"busy\" };\n    }\n    runtimeSwitched = true;\n  }\n  updateConversationSettings(office, patch);\n  return { ok: true, runtimeSwitched };\n}\n\nexport function applyGlobalSettings(\n  runtime: GlobalRunnerCacheControl | undefined,\n  patch: Partial<AgentConfig>,\n): { ok: true; staleConversations: OfficeAddress[] } {\n  updateGlobalSettings(patch);\n  const staleConversations =\n    affectsCachedRunner(patch) && runtime ? runtime.refreshAllConversations().busy : [];\n  return { ok: true, staleConversations };\n}\n\n/**\n * Door-policy changes follow the same clear-or-refuse contract as model\n * changes: the system prompt bakes the workspace projection (layout line,\n * memory and skill guidance), so the cached runner must clear before the\n * write, and the container is re-provisioned on the next message when its\n * mount signature no longer matches.\n */\nexport function applyConversationWorkspacePolicy(\n  runtime: RunnerCacheControl | undefined,\n  office: Office,\n  choice: WorkspacePolicyChoice | null,\n): SettingsApplyResult {\n  if (runtime && !runtime.refreshConversationEnvironment(office.address)) {\n    return { ok: false, reason: \"busy\" };\n  }\n  setConversationWorkspacePolicy(office, choice);\n  return { ok: true, runtimeSwitched: runtime ? true : null };\n}\n\nexport function applyGlobalWorkspacePolicy(\n  runtime: GlobalRunnerCacheControl | undefined,\n  choice: WorkspacePolicyChoice | null,\n): { ok: true; staleConversations: OfficeAddress[] } {\n  setGlobalWorkspacePolicy(choice);\n  const staleConversations = runtime ? runtime.refreshAllConversations().busy : [];\n  return { ok: true, staleConversations };\n}\n"]}