From f1331bcea21150570002bee9735d103ffe0970a0 Mon Sep 17 00:00:00 2001
From: Peter Steinberger <peter@steipete.me>
Date: Mon, 13 Jul 2026 13:58:03 -0700
Subject: [PATCH] build(knip): model agent sessions SDK entry (#106807)

---
 config/knip.config.ts                       |  2 +
 scripts/deadcode-exports.baseline.mjs       | 48 ---------------------
 test/scripts/check-deadcode-exports.test.ts |  4 ++
 3 files changed, 6 insertions(+), 48 deletions(-)

diff --git a/config/knip.config.ts b/config/knip.config.ts
index da47829de166..ec1468d448e4 100644
--- a/config/knip.config.ts
+++ b/config/knip.config.ts
@@ -19,6 +19,8 @@ const rootEntries = [
   "src/infra/warning-filter.ts!",
   "src/infra/command-explainer/index.ts!",
   // Runtime modules loaded by path or namespace; static export tracing cannot see their contract.
+  // Jiti virtualizes openclaw/plugin-sdk/agent-sessions through this cycle-safe barrel.
+  "src/agents/sessions/extension-sdk.ts!",
   "src/plugins/runtime/index.ts!",
   "src/plugins/source-display.ts!",
   "src/mcp/codex-supervision-tools-serve.ts!",
diff --git a/scripts/deadcode-exports.baseline.mjs b/scripts/deadcode-exports.baseline.mjs
index 28e43d6996d8..5235b51445bc 100644
--- a/scripts/deadcode-exports.baseline.mjs
+++ b/scripts/deadcode-exports.baseline.mjs
@@ -820,54 +820,6 @@ export const KNIP_UNUSED_EXPORT_BASELINE = [
   "src/agents/session-suspension.ts: testing",
   "src/agents/session-write-lock.ts: resetSessionWriteLockStateForTest",
   "src/agents/session-write-lock.ts: testing",
-  "src/agents/sessions/extension-sdk.ts: BranchSummarySettings",
-  "src/agents/sessions/extension-sdk.ts: convertToLlm",
-  "src/agents/sessions/extension-sdk.ts: defineTool",
-  "src/agents/sessions/extension-sdk.ts: FileSettingsStorage",
-  "src/agents/sessions/extension-sdk.ts: getAgentDir",
-  "src/agents/sessions/extension-sdk.ts: ImageSettings",
-  "src/agents/sessions/extension-sdk.ts: InMemorySettingsStorage",
-  "src/agents/sessions/extension-sdk.ts: isBashToolResult",
-  "src/agents/sessions/extension-sdk.ts: isEditToolResult",
-  "src/agents/sessions/extension-sdk.ts: isFindToolResult",
-  "src/agents/sessions/extension-sdk.ts: isGrepToolResult",
-  "src/agents/sessions/extension-sdk.ts: isLsToolResult",
-  "src/agents/sessions/extension-sdk.ts: isReadToolResult",
-  "src/agents/sessions/extension-sdk.ts: isToolCallEventType",
-  "src/agents/sessions/extension-sdk.ts: isWriteToolResult",
-  "src/agents/sessions/extension-sdk.ts: MarkdownSettings",
-  "src/agents/sessions/extension-sdk.ts: PackageSource",
-  "src/agents/sessions/extension-sdk.ts: PromptTemplate",
-  "src/agents/sessions/extension-sdk.ts: ProviderRetrySettings",
-  "src/agents/sessions/extension-sdk.ts: ReadonlyFooterDataProvider",
-  "src/agents/sessions/extension-sdk.ts: ResourceCollision",
-  "src/agents/sessions/extension-sdk.ts: ResourceDiagnostic",
-  "src/agents/sessions/extension-sdk.ts: RetrySettings",
-  "src/agents/sessions/extension-sdk.ts: Settings",
-  "src/agents/sessions/extension-sdk.ts: SettingsError",
-  "src/agents/sessions/extension-sdk.ts: SettingsManager",
-  "src/agents/sessions/extension-sdk.ts: SettingsScope",
-  "src/agents/sessions/extension-sdk.ts: SettingsStorage",
-  "src/agents/sessions/extension-sdk.ts: Skill (bundledAgentSessions)",
-  "src/agents/sessions/extension-sdk.ts: TerminalSettings",
-  "src/agents/sessions/extension-sdk.ts: ThinkingBudgetsSettings",
-  "src/agents/sessions/extension-sdk.ts: TransportSetting",
-  "src/agents/sessions/extension-sdk.ts: VERSION",
-  "src/agents/sessions/extension-sdk.ts: WarningSettings",
-  "src/agents/sessions/extension-sdk.ts: wrapRegisteredTool",
-  "src/agents/sessions/extension-sdk.ts: wrapRegisteredTools (bundledAgentSessions)",
-  "src/agents/sessions/extensions/types.ts: ExtensionRuntimeState (bundledAgentSessions)",
-  "src/agents/sessions/extensions/types.ts: GetSessionNameHandler",
-  "src/agents/sessions/extensions/types.ts: OAuthAuthInfo",
-  "src/agents/sessions/extensions/types.ts: OAuthCredentials",
-  "src/agents/sessions/extensions/types.ts: OAuthLoginCallbacks",
-  "src/agents/sessions/extensions/types.ts: OAuthPrompt",
-  "src/agents/sessions/extensions/types.ts: OAuthSelectOption",
-  "src/agents/sessions/extensions/types.ts: OAuthSelectPrompt",
-  "src/agents/sessions/extensions/types.ts: RefreshToolsHandler",
-  "src/agents/sessions/extensions/types.ts: SetSessionNameHandler",
-  "src/agents/sessions/extensions/types.ts: ThinkingLevelSelectEvent",
-  "src/agents/sessions/extensions/types.ts: ToolRenderContext",
   "src/agents/sessions/keybindings.ts: AppKeybindings",
   "src/agents/sessions/keybindings.ts: Keybinding",
   "src/agents/sessions/keybindings.ts: KEYBINDINGS",
diff --git a/test/scripts/check-deadcode-exports.test.ts b/test/scripts/check-deadcode-exports.test.ts
index 40329c7a2335..ff8f9503a87a 100644
--- a/test/scripts/check-deadcode-exports.test.ts
+++ b/test/scripts/check-deadcode-exports.test.ts
@@ -24,6 +24,10 @@ describe("check-deadcode-exports", () => {
     expect(knipConfig.workspaces["."].entry).toContain("scripts/qa/render-maturity-docs.ts!");
   });
 
+  it("models the jiti virtual agent-sessions SDK entry", () => {
+    expect(knipConfig.workspaces["."].entry).toContain("src/agents/sessions/extension-sdk.ts!");
+  });
+
   it("parses all compact export sections and expands symbol lists", () => {
     expect(
       parseKnipCompactUnusedExports(`