@cortexkit/opencode-magic-context 0.38.1 → 0.40.0

package/src/shared/rpc-utils.ts

@@ -5,6 +5,14 @@ import { join } from "node:path";
 
 export type ProcessKind = "OpenCode server" | "OpenCode instance (TUI/CLI)" | "Pi" | "process";
 
+/** Best-effort process details captured while validating a migration blocker. */
+export interface ProcessProbeEvidence {
+    /** Epoch milliseconds, or null when the platform/probe cannot provide it. */
+    startTime: number | null;
+    /** The raw command line, or null when the platform/probe cannot provide it. */
+    commandLine: string | null;
+}
+
 export interface RpcPortFileRecord {
     port: number;
     pid: number;
@@ -143,6 +151,24 @@ function readPsProcessStartTime(pid: number): number | null {
     }
 }
 
+/** Read a process start time without changing the guard's liveness decision. */
+export function readProcessStartTime(pid: number): number | null {
+    if (!Number.isInteger(pid) || pid <= 0) return null;
+    return rpcIdentityPlatform === "linux"
+        ? readLinuxProcessStartTime(pid)
+        : rpcIdentityPlatform === "win32"
+          ? null
+          : readPsProcessStartTime(pid);
+}
+
+/** Capture the command and start-time probes used to explain a blocker. */
+export function readProcessProbeEvidence(pid: number): ProcessProbeEvidence {
+    return {
+        startTime: readProcessStartTime(pid),
+        commandLine: readProcessCommand(pid),
+    };
+}
+
 interface ProcessListEntry {
     pid: number;
     command: string;
@@ -319,28 +345,27 @@ function commandLooksLikeOpenCode(command: string): boolean {
  */
 export type PidIdentityPlausibility = "plausible" | "implausible" | "inconclusive";
 
-export function isPidIdentityPlausible(record: RpcPortFileRecord): PidIdentityPlausibility {
+export function isPidIdentityPlausible(
+    record: RpcPortFileRecord,
+    evidence?: ProcessProbeEvidence,
+): PidIdentityPlausibility {
     if (!Number.isInteger(record.pid) || record.pid <= 0) return "implausible";
 
     if (Number.isFinite(record.started_at) && record.started_at > 0) {
-        const processStartTime =
-            rpcIdentityPlatform === "linux"
-                ? readLinuxProcessStartTime(record.pid)
-                : rpcIdentityPlatform === "win32"
-                  ? null
-                  : readPsProcessStartTime(record.pid);
+        const processStartTime = evidence ? evidence.startTime : readProcessStartTime(record.pid);
         if (processStartTime === null) return "inconclusive";
         return processStartTime <= record.started_at + RPC_IDENTITY_SKEW_TOLERANCE_MS
             ? "plausible"
             : "implausible";
     }
 
-    const command =
-        rpcIdentityPlatform === "linux"
-            ? readLinuxProcessCommand(record.pid)
-            : rpcIdentityPlatform === "win32"
-              ? (readWindowsProcess(record.pid).command ?? null)
-              : readPsProcessCommand(record.pid);
+    const command = evidence
+        ? evidence.commandLine
+        : rpcIdentityPlatform === "linux"
+          ? readLinuxProcessCommand(record.pid)
+          : rpcIdentityPlatform === "win32"
+            ? (readWindowsProcess(record.pid).command ?? null)
+            : readPsProcessCommand(record.pid);
     if (command === null) return "inconclusive";
     return commandLooksLikeOpenCode(command) ? "plausible" : "implausible";
 }

package/src/shared/status-detail-text.test.ts

@@ -0,0 +1,82 @@
+import { describe, expect, test } from "bun:test";
+import type { StatusDetail } from "./rpc-types";
+import { formatStatusDetailMarkdown } from "./status-detail-text";
+
+const STATUS_FIXTURE: StatusDetail = {
+    sessionId: "ses_status",
+    activeProfile: "work",
+    usagePercentage: 75,
+    inputTokens: 96_000,
+    contextLimit: 128_000,
+    systemPromptTokens: 4_000,
+    compartmentCount: 12,
+    memoryCount: 8,
+    memoryBlockCount: 3,
+    pendingOpsCount: 2,
+    historianRunning: true,
+    compartmentInProgress: true,
+    sessionNoteCount: 1,
+    readySmartNoteCount: 2,
+    cacheTtl: "5m",
+    lastTransformError: null,
+    lastDreamerRunAt: null,
+    projectIdentity: "/repo",
+    compartmentTokens: 22_000,
+    factTokens: 0,
+    memoryTokens: 1_200,
+    docsTokens: 500,
+    profileTokens: 100,
+    conversationTokens: 62_000,
+    toolCallTokens: 3_000,
+    toolDefinitionTokens: 3_200,
+    executeThreshold: 65,
+    executeThresholdClamped: false,
+    boundaryPresent: true,
+    coverageOrdinal: 12,
+    newWorkTokens: 1_000,
+    totalInputTokens: 96_000,
+    recompProgress: null,
+    tagCounter: 5,
+    activeTags: 4,
+    droppedTags: 1,
+    totalTags: 5,
+    activeBytes: 2_048,
+    lastResponseTime: 1,
+    lastNudgeTokens: 80_000,
+    pendingOps: [],
+    cacheTtlMs: 300_000,
+    cacheRemainingMs: 42_000,
+    cacheExpired: false,
+    cacheNeverExpires: false,
+    executeThresholdMode: "percentage",
+    protectedTagCount: 20,
+    historyBudgetPercentage: 0.15,
+    historyBlockTokens: 22_000,
+    compressionBudget: 12_480,
+    compressionUsage: "176%",
+    toastDurationMs: 5_000,
+    loggerDiagnostics: {
+        swallowedWriteCount: 0,
+        lastErrorMessage: null,
+        lastErrorTime: null,
+    },
+    storage_versions: {
+        context_db_schema_version: 79,
+        plugin_supported_version: 79,
+    },
+};
+
+describe("formatStatusDetailMarkdown", () => {
+    test("renders the fixed TUI status payload as compact markdown", () => {
+        expect(formatStatusDetailMarkdown(STATUS_FIXTURE)).toBe(`## Magic Context Status
+
+- **Mode:** Magic Context compaction
+- **Active profile:** work
+- **Usage:** 75.0% (96,000 / 128,000 usable tokens)
+- **Cache lane:** live (42s remaining); TTL 5m
+- **Historian:** running; boundary present; coverage 12
+- **Memory:** 8 active; 3 injected
+- **Tags:** 4 active, 1 dropped; 2 pending drops
+- **Execute threshold:** 65.0%`);
+    });
+});

package/src/shared/status-detail-text.ts

@@ -0,0 +1,57 @@
+import type { StatusDetail } from "./rpc-types";
+
+function formatCount(value: number): string {
+    return Math.round(value).toLocaleString();
+}
+
+function formatCacheLane(detail: StatusDetail): string {
+    if (detail.cacheNeverExpires) return `never expires; TTL ${detail.cacheTtl}`;
+    if (detail.lastResponseTime <= 0) return `waiting for first response; TTL ${detail.cacheTtl}`;
+    if (detail.cacheExpired) return `expired; TTL ${detail.cacheTtl}`;
+    return `live (${Math.round(detail.cacheRemainingMs / 1000)}s remaining); TTL ${detail.cacheTtl}`;
+}
+
+/** Render the same StatusDetail payload that powers the TUI dialog for chat-only clients. */
+export function formatStatusDetailMarkdown(detail: StatusDetail): string {
+    const usableLimit =
+        detail.contextLimit > 0
+            ? `${formatCount(detail.contextLimit)} usable tokens`
+            : "? usable tokens";
+    const historianState = detail.historianRunning ? "running" : "idle";
+    const historianDetails = [
+        detail.boundaryPresent === undefined
+            ? undefined
+            : `boundary ${detail.boundaryPresent ? "present" : "absent"}`,
+        detail.coverageOrdinal === undefined
+            ? undefined
+            : `coverage ${detail.coverageOrdinal === null ? "none" : detail.coverageOrdinal}`,
+    ].filter((value): value is string => value !== undefined);
+    const mode =
+        detail.compaction_enabled === false
+            ? "native compaction (Magic Context history compaction disabled)"
+            : "Magic Context compaction";
+
+    const lines = [
+        "## Magic Context Status",
+        "",
+        `- **Mode:** ${mode}`,
+        `- **Active profile:** ${detail.activeProfile ?? "none"}`,
+        `- **Usage:** ${detail.usagePercentage.toFixed(1)}% (${formatCount(detail.inputTokens)} / ${usableLimit})`,
+        `- **Cache lane:** ${formatCacheLane(detail)}`,
+        `- **Historian:** ${[historianState, ...historianDetails].join("; ")}`,
+        `- **Memory:** ${formatCount(detail.memoryCount)} active; ${formatCount(detail.memoryBlockCount)} injected`,
+        `- **Tags:** ${formatCount(detail.activeTags)} active, ${formatCount(detail.droppedTags)} dropped; ${formatCount(detail.pendingOpsCount)} pending drops`,
+        `- **Execute threshold:** ${detail.executeThreshold.toFixed(1)}%${detail.executeThresholdClamped ? " (clamped)" : ""}`,
+    ];
+
+    if (detail.recompProgress?.phase === "recomp") {
+        lines.push(
+            `- **${detail.recompProgress.kind === "embed" ? "Embed" : "Historian"} progress:** ${formatCount(detail.recompProgress.processedMessages)} / ${formatCount(detail.recompProgress.totalMessages)}`,
+        );
+    }
+    if (detail.lastTransformError) {
+        lines.push(`- **Last transform error:** ${detail.lastTransformError}`);
+    }
+
+    return lines.join("\n");
+}

package/src/shared/subagent-runner.ts

@@ -29,6 +29,8 @@
  * the runner contract is purely additive on the OpenCode side.
  */
 
+import type { ModelInput } from "./model-resolution";
+
 /**
  * Configuration for one subagent invocation.
  *
@@ -63,7 +65,7 @@ export interface SubagentRunOptions {
     systemPrompt: string;
     userMessage: string;
     model?: string | undefined;
-    fallbackModels?: readonly string[];
+    fallbackModels?: readonly ModelInput[];
     timeoutMs?: number | undefined;
     cwd?: string | undefined;
     signal?: AbortSignal | undefined;

package/src/tui/data/context-db.ts

@@ -181,6 +181,7 @@ export async function loadStatusDetail(
     const emptyDetail: StatusDetail = {
         ...EMPTY_SNAPSHOT,
         sessionId,
+        activeProfile: null,
         tagCounter: 0,
         activeTags: 0,
         droppedTags: 0,

package/src/tui-compiled/data/context-db.ts

@@ -181,6 +181,7 @@ export async function loadStatusDetail(
     const emptyDetail: StatusDetail = {
         ...EMPTY_SNAPSHOT,
         sessionId,
+        activeProfile: null,
         tagCounter: 0,
         activeTags: 0,
         droppedTags: 0,

package/dist/index-td9depx5.js

@@ -1,46 +0,0 @@
-// src/shared/resolve-fallbacks.ts
-function resolveFallbackChain(userFallbacks) {
-  const userList = normalizeUserFallbacks(userFallbacks);
-  return dedupe(userList.filter(isValidModelSpec));
-}
-function normalizeUserFallbacks(userFallbacks) {
-  if (!userFallbacks)
-    return [];
-  if (typeof userFallbacks === "string") {
-    const trimmed = userFallbacks.trim();
-    return trimmed ? [trimmed] : [];
-  }
-  return userFallbacks.map((s) => s.trim()).filter((s) => s.length > 0);
-}
-function isValidModelSpec(spec) {
-  const slash = spec.indexOf("/");
-  return slash > 0 && slash < spec.length - 1;
-}
-function dedupe(list) {
-  const seen = new Set;
-  const out = [];
-  for (const item of list) {
-    if (seen.has(item))
-      continue;
-    seen.add(item);
-    out.push(item);
-  }
-  return out;
-}
-function parseProviderModel(spec) {
-  const slash = spec.indexOf("/");
-  if (slash < 1 || slash >= spec.length - 1)
-    return null;
-  return {
-    providerID: spec.slice(0, slash).trim(),
-    modelID: spec.slice(slash + 1).trim()
-  };
-}
-function modelBodyField(spec) {
-  if (!spec)
-    return {};
-  const parsed = parseProviderModel(spec);
-  return parsed ? { model: parsed } : {};
-}
-
-export { resolveFallbackChain, parseProviderModel, modelBodyField };

package/dist/resolve-fallbacks-qf0ekmz9.js

@@ -1,11 +0,0 @@
-import {
-  modelBodyField,
-  parseProviderModel,
-  resolveFallbackChain
-} from "./index-td9depx5.js";
-import"./index-1yh8g550.js";
-export {
-  modelBodyField,
-  parseProviderModel,
-  resolveFallbackChain
-};