create-windy 0.8.1 → 0.8.3

package/dist/cli.js

@@ -33,7 +33,7 @@ var __toESM = (mod, isNodeMode, target) => {
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __require = import.meta.require;
 
-// ../../node_modules/cli-width/index.js
+// ../../node_modules/.bun/cli-width@4.1.0/node_modules/cli-width/index.js
 var require_cli_width = __commonJS((exports, module2) => {
   module2.exports = cliWidth;
   function normalizeOpts(options) {
@@ -73,7 +73,7 @@ var require_cli_width = __commonJS((exports, module2) => {
   }
 });
 
-// ../../node_modules/mute-stream/lib/index.js
+// ../../node_modules/.bun/mute-stream@3.0.0/node_modules/mute-stream/lib/index.js
 var require_lib = __commonJS((exports, module2) => {
   var Stream = __require("stream");
 
@@ -325,6 +325,15 @@ var agentOptionalModule = {
     "apps/server/src/module-host/tool-handlers.test.ts",
     "apps/server/src/module-host/module-secret-tool-boundary.test.ts",
     "apps/web/src/pages/system/AiRuntimePage.vue",
+    "apps/web/src/pages/system/AgentToolsPage.vue",
+    "apps/web/src/pages/system/AgentDebugPage.vue",
+    "apps/web/src/pages/system/components/agent-workbench",
+    "apps/web/src/pages/system/composables/useAgentWorkbench.ts",
+    "apps/web/src/pages/system/composables/useAgentWorkbench.webtest.ts",
+    "apps/web/src/pages/system/composables/useSessionReplay.ts",
+    "apps/web/src/services/agent-admin-api.ts",
+    "apps/web/src/services/agent-admin-api.webtest.ts",
+    "apps/web/src/services/agent-workbench-event.ts",
     "apps/web/src/pages/system/AgentSessionPage.vue",
     "apps/web/src/pages/system/AgentSessionPage.webtest.ts",
     "apps/web/src/pages/system/AgentWorkflowPage.vue",
@@ -344,6 +353,9 @@ var agentOptionalModule = {
     "apps/web/src/services/ai-runtime-api.ts",
     "apps/web/src/services/ai-runtime-api.webtest.ts",
     "scripts/provision-speech-readiness.ts",
+    "packages/modules/src/system-agent-admin-registration.test.ts",
+    "packages/modules/src/system-agent-admin-menus.ts",
+    "packages/modules/src/system-agent-admin-bindings.ts",
     "packages/modules/src/system-agent-audit-actions.ts",
     "packages/modules/src/system-agent-tools.ts",
     "packages/modules/src/system-agent-supervisor.ts",
@@ -359,6 +371,8 @@ var agentOptionalModule = {
     "packages/server-sdk/src/workflow-input-materialization-handler.ts",
     "packages/database/src/agent-runtime-schema.test.ts",
     "packages/database/src/ai-output-artifacts.test.ts",
+    "packages/shared/src/agent-admin-catalog.ts",
+    "packages/shared/src/agent-workbench.ts",
     "packages/shared/src/agent-workflow-definition.ts",
     "packages/shared/src/agent-workflow-delegation.ts",
     "packages/shared/src/agent-workflow-evaluation.ts",
@@ -371,6 +385,8 @@ var agentOptionalModule = {
   ],
   documentation: [
     "docs/adr/0003-agent-session-event-source.md",
+    "docs/architecture/agent-admin-workbench-plan.md",
+    "docs/architecture/agent-admin-workbench-implementation.md",
     "docs/architecture/agent-harness.md",
     "docs/architecture/agent-runtime-compatibility.md",
     "docs/architecture/agent-workflow.md",
@@ -4677,7 +4693,7 @@ function isMissing6(error) {
 import { createInterface as createInterface2 } from "readline/promises";
 import { stdin, stdout } from "process";
 
-// ../../node_modules/@inquirer/core/dist/lib/key.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/key.js
 var keybindings = ["emacs", "vim"];
 var keybindingLookup = new Set(keybindings);
 function isKeybinding(value) {
@@ -4694,7 +4710,7 @@ var isDownKey = (key, keybindings2 = []) => key.name === "down" || keybindings2.
 var isSpaceKey = (key) => key.name === "space";
 var isNumberKey = (key) => "1234567890".includes(key.name);
 var isEnterKey = (key) => key.name === "enter" || key.name === "return";
-// ../../node_modules/@inquirer/core/dist/lib/errors.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/errors.js
 class AbortPromptError extends Error {
   name = "AbortPromptError";
   message = "Prompt was aborted";
@@ -4720,10 +4736,10 @@ class HookError extends Error {
 class ValidationError extends Error {
   name = "ValidationError";
 }
-// ../../node_modules/@inquirer/core/dist/lib/use-state.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/use-state.js
 import { AsyncResource as AsyncResource2 } from "async_hooks";
 
-// ../../node_modules/@inquirer/core/dist/lib/hook-engine.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/hook-engine.js
 import { AsyncLocalStorage, AsyncResource } from "async_hooks";
 var hookStorage = new AsyncLocalStorage;
 function createStore(rl) {
@@ -4828,7 +4844,7 @@ var effectScheduler = {
   }
 };
 
-// ../../node_modules/@inquirer/core/dist/lib/use-state.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/use-state.js
 function isFactory(value) {
   return typeof value === "function";
 }
@@ -4849,7 +4865,7 @@ function useState(defaultValue) {
   });
 }
 
-// ../../node_modules/@inquirer/core/dist/lib/use-effect.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/use-effect.js
 function useEffect(cb, depArray) {
   withPointer((pointer) => {
     const oldDeps = pointer.get();
@@ -4861,10 +4877,10 @@ function useEffect(cb, depArray) {
   });
 }
 
-// ../../node_modules/@inquirer/core/dist/lib/theme.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/theme.js
 import { styleText } from "util";
 
-// ../../node_modules/@inquirer/figures/dist/index.js
+// ../../node_modules/.bun/@inquirer+figures@2.0.7/node_modules/@inquirer/figures/dist/index.js
 import process2 from "process";
 function isUnicodeSupported() {
   if (!process2.platform.startsWith("win")) {
@@ -5153,7 +5169,7 @@ var figures = shouldUseMain ? mainSymbols : fallbackSymbols;
 var dist_default = figures;
 var replacements = Object.entries(specialMainSymbols);
 
-// ../../node_modules/@inquirer/core/dist/lib/theme.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/theme.js
 var defaultTheme = {
   prefix: {
     idle: styleText("blue", "?"),
@@ -5181,7 +5197,7 @@ function getDefaultTheme() {
   };
 }
 
-// ../../node_modules/@inquirer/core/dist/lib/make-theme.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/make-theme.js
 function isPlainObject(value) {
   if (typeof value !== "object" || value === null)
     return false;
@@ -5209,7 +5225,7 @@ function makeTheme(...themes) {
   return deepMerge(...themesToMerge);
 }
 
-// ../../node_modules/@inquirer/core/dist/lib/use-prefix.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/use-prefix.js
 function usePrefix({ status = "idle", theme }) {
   const [showLoader, setShowLoader] = useState(false);
   const [tick, setTick] = useState(0);
@@ -5239,7 +5255,7 @@ function usePrefix({ status = "idle", theme }) {
   const iconName = status === "loading" ? "idle" : status;
   return typeof prefix === "string" ? prefix : prefix[iconName] ?? prefix["idle"];
 }
-// ../../node_modules/@inquirer/core/dist/lib/use-memo.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/use-memo.js
 function useMemo(fn, dependencies) {
   return withPointer((pointer) => {
     const prev = pointer.get();
@@ -5251,12 +5267,12 @@ function useMemo(fn, dependencies) {
     return prev.value;
   });
 }
-// ../../node_modules/@inquirer/core/dist/lib/use-ref.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/use-ref.js
 function useRef(val) {
   return useState({ current: val })[0];
 }
 
-// ../../node_modules/@inquirer/core/dist/lib/use-keypress.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/use-keypress.js
 function useKeypress(userHandler) {
   const signal = useRef(userHandler);
   signal.current = userHandler;
@@ -5274,10 +5290,10 @@ function useKeypress(userHandler) {
     };
   }, []);
 }
-// ../../node_modules/@inquirer/core/dist/lib/utils.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/utils.js
 var import_cli_width = __toESM(require_cli_width(), 1);
 
-// ../../node_modules/fast-string-truncated-width/dist/utils.js
+// ../../node_modules/.bun/fast-string-truncated-width@3.0.3/node_modules/fast-string-truncated-width/dist/utils.js
 var getCodePointsLength = (() => {
   const SURROGATE_PAIR_RE = /[\uD800-\uDBFF][\uDC00-\uDFFF]/g;
   return (input) => {
@@ -5296,7 +5312,7 @@ var isWideNotCJKTNotEmoji = (x) => {
   return x === 8987 || x === 9001 || x >= 12272 && x <= 12287 || x >= 12289 && x <= 12350 || x >= 12441 && x <= 12543 || x >= 12549 && x <= 12591 || x >= 12593 && x <= 12686 || x >= 12688 && x <= 12771 || x >= 12783 && x <= 12830 || x >= 12832 && x <= 12871 || x >= 12880 && x <= 19903 || x >= 65040 && x <= 65049 || x >= 65072 && x <= 65106 || x >= 65108 && x <= 65126 || x >= 65128 && x <= 65131 || x >= 127488 && x <= 127490 || x >= 127504 && x <= 127547 || x >= 127552 && x <= 127560 || x >= 131072 && x <= 196605 || x >= 196608 && x <= 262141;
 };
 
-// ../../node_modules/fast-string-truncated-width/dist/index.js
+// ../../node_modules/.bun/fast-string-truncated-width@3.0.3/node_modules/fast-string-truncated-width/dist/index.js
 var ANSI_RE = /[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]|\u001b\]8;[^;]*;.*?(?:\u0007|\u001b\u005c)/y;
 var CONTROL_RE = /[\x00-\x08\x0A-\x1F\x7F-\x9F]{1,1000}/y;
 var CJKT_WIDE_RE = /(?:(?![\uFF61-\uFF9F\uFF00-\uFFEF])[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}\p{Script=Tangut}]){1,1000}/yu;
@@ -5395,7 +5411,7 @@ var getStringTruncatedWidth = (input, truncationOptions = {}, widthOptions = {})
 };
 var dist_default2 = getStringTruncatedWidth;
 
-// ../../node_modules/fast-string-width/dist/index.js
+// ../../node_modules/.bun/fast-string-width@3.0.2/node_modules/fast-string-width/dist/index.js
 var NO_TRUNCATION2 = {
   limit: Infinity,
   ellipsis: "",
@@ -5406,7 +5422,7 @@ var fastStringWidth = (input, options = {}) => {
 };
 var dist_default3 = fastStringWidth;
 
-// ../../node_modules/fast-wrap-ansi/lib/main.js
+// ../../node_modules/.bun/fast-wrap-ansi@0.2.2/node_modules/fast-wrap-ansi/lib/main.js
 var ESC = "\x1B";
 var CSI = "\x9B";
 var END_CODE = 39;
@@ -5618,7 +5634,7 @@ function wrapAnsi(string, columns, options) {
 `);
 }
 
-// ../../node_modules/@inquirer/core/dist/lib/utils.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/utils.js
 function breakLines(content, width) {
   return content.split(`
 `).flatMap((line) => wrapAnsi(line, width, { trim: false, wordWrap: false }).split(`
@@ -5629,7 +5645,7 @@ function readlineWidth() {
   return import_cli_width.default({ defaultWidth: 80, output: readline().output });
 }
 
-// ../../node_modules/@inquirer/core/dist/lib/pagination/use-pagination.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/pagination/use-pagination.js
 function usePointerPosition({ active, renderedItems, pageSize, loop }) {
   const state = useRef({
     lastPointer: active,
@@ -5695,12 +5711,12 @@ function usePagination({ items, active, renderItem, pageSize, loop = true }) {
   return pageBuffer.filter((line) => typeof line === "string").join(`
 `);
 }
-// ../../node_modules/@inquirer/core/dist/lib/create-prompt.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/create-prompt.js
 var import_mute_stream = __toESM(require_lib(), 1);
 import * as readline2 from "readline";
 import { AsyncResource as AsyncResource3 } from "async_hooks";
 
-// ../../node_modules/signal-exit/dist/mjs/signals.js
+// ../../node_modules/.bun/signal-exit@4.1.0/node_modules/signal-exit/dist/mjs/signals.js
 var signals = [];
 signals.push("SIGHUP", "SIGINT", "SIGTERM");
 if (process.platform !== "win32") {
@@ -5710,7 +5726,7 @@ if (process.platform === "linux") {
   signals.push("SIGIO", "SIGPOLL", "SIGPWR", "SIGSTKFLT");
 }
 
-// ../../node_modules/signal-exit/dist/mjs/index.js
+// ../../node_modules/.bun/signal-exit@4.1.0/node_modules/signal-exit/dist/mjs/index.js
 var processOk = (process3) => !!process3 && typeof process3 === "object" && typeof process3.removeListener === "function" && typeof process3.emit === "function" && typeof process3.reallyExit === "function" && typeof process3.listeners === "function" && typeof process3.kill === "function" && typeof process3.pid === "number" && typeof process3.on === "function";
 var kExitEmitter = Symbol.for("signal-exit emitter");
 var global = globalThis;
@@ -5908,10 +5924,10 @@ var {
   unload
 } = signalExitWrap(processOk(process3) ? new SignalExit(process3) : new SignalExitFallback);
 
-// ../../node_modules/@inquirer/core/dist/lib/screen-manager.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/screen-manager.js
 import { stripVTControlCharacters } from "util";
 
-// ../../node_modules/@inquirer/ansi/dist/index.js
+// ../../node_modules/.bun/@inquirer+ansi@2.0.7/node_modules/@inquirer/ansi/dist/index.js
 var ESC2 = "\x1B[";
 var cursorLeft = ESC2 + "G";
 var cursorHide = ESC2 + "?25l";
@@ -5927,7 +5943,7 @@ var cursorTo = (x, y) => {
 var eraseLine = ESC2 + "2K";
 var eraseLines = (lines) => lines > 0 ? (eraseLine + cursorUp(1)).repeat(lines - 1) + eraseLine + cursorLeft : "";
 
-// ../../node_modules/@inquirer/core/dist/lib/screen-manager.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/screen-manager.js
 var height = (content) => content.split(`
 `).length;
 var lastLine = (content) => content.split(`
@@ -5993,7 +6009,7 @@ class ScreenManager {
   }
 }
 
-// ../../node_modules/@inquirer/core/dist/lib/promise-polyfill.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/promise-polyfill.js
 class PromisePolyfill extends Promise {
   static withResolver() {
     let resolve6;
@@ -6006,7 +6022,7 @@ class PromisePolyfill extends Promise {
   }
 }
 
-// ../../node_modules/@inquirer/core/dist/lib/create-prompt.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/create-prompt.js
 import path from "path";
 var nativeSetImmediate = globalThis.setImmediate;
 function getCallSites() {
@@ -6117,7 +6133,7 @@ function createPrompt(view) {
   };
   return prompt;
 }
-// ../../node_modules/@inquirer/core/dist/lib/Separator.js
+// ../../node_modules/.bun/@inquirer+core@11.2.1+7cb241fc07b679d9/node_modules/@inquirer/core/dist/lib/Separator.js
 import { styleText as styleText2 } from "util";
 class Separator {
   separator = styleText2("dim", Array.from({ length: 15 }).join(dist_default.line));
@@ -6131,7 +6147,7 @@ class Separator {
     return Boolean(choice && typeof choice === "object" && "type" in choice && choice.type === "separator");
   }
 }
-// ../../node_modules/@inquirer/checkbox/dist/index.js
+// ../../node_modules/.bun/@inquirer+checkbox@5.2.1+7cb241fc07b679d9/node_modules/@inquirer/checkbox/dist/index.js
 import { styleText as styleText3 } from "util";
 var checkboxTheme = {
   icon: {
@@ -8529,7 +8545,9 @@ var recipes = [
     from: "0.7.0",
     to: "0.8.0"
   },
-  { id: "starter-0.8.0-to-0.8.1", from: "0.8.0", to: "0.8.1" }
+  { id: "starter-0.8.0-to-0.8.1", from: "0.8.0", to: "0.8.1" },
+  { id: "starter-0.8.1-to-0.8.2", from: "0.8.1", to: "0.8.2" },
+  { id: "starter-0.8.2-to-0.8.3", from: "0.8.2", to: "0.8.3" }
 ];
 function resolveRecipeChain(sourceVersion, targetVersion) {
   if (compareVersions2(sourceVersion, minimumSupportedUpdateVersion) < 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-windy",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "description": "创建单组织、单租户、私有部署优先的 Windy 企业 Dashboard Starter",
   "type": "module",
   "bin": {

package/template/.windy-template.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
-  "templateCommit": "066d8018c0ec0c82fbf01d26013b3b303aaa9c22",
-  "generatorVersion": "0.8.1",
+  "templateCommit": "c701e845048c839516533e164cb550e3348eb89c",
+  "generatorVersion": "0.8.3",
   "modules": [
     {
       "name": "system",

package/template/apps/agent-server/src/southwind_agent_server/attempt_context.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from dataclasses import dataclass
+from dataclasses import dataclass, replace
 
 from .attempt_context_projection import (
     AttemptContextPreparation,
@@ -15,6 +15,7 @@ from .contracts import JsonValue, LongSessionContext
 from .engine import EngineRunRequest, PreparedArtifact
 from .openai_provider import OpenAiCompatibleProvider
 from .provider_governance import GovernedAttempt, ProviderRequestGovernance
+from .provider_output_guidance import tool_output_messages
 
 
 @dataclass(frozen=True)
@@ -64,6 +65,13 @@ async def govern_provider_attempt(
                 )
             ),
         )
+        if governed.tools:
+            governed = replace(
+                governed,
+                messages=tool_output_messages(
+                    governed.messages, governed.output_schema
+                ),
+            )
         provider_request = provider.request_body(
             governed.messages,
             governed.tools,

package/template/apps/agent-server/src/southwind_agent_server/openai_provider.py

@@ -14,6 +14,7 @@ from .config import (
 from .contracts import AgentErrorCode, JsonValue, RuntimeToolDefinition
 from .engine import SafeEngineError
 from .multimodal import response_format
+from .provider_output_guidance import tool_output_messages
 from .report_types import UsageFacts
 from .vision_probe import probe_vision
 
@@ -97,6 +98,9 @@ class OpenAiCompatibleProvider:
         output_schema: dict[str, JsonValue] | None = None,
         max_output_tokens: int | None = None,
     ) -> bytes:
+        structured = response_format(output_schema_key, output_schema)
+        if tools:
+            messages = tool_output_messages(messages, output_schema)
         payload: dict[str, JsonValue] = {
             "model": self.config.model,
             "messages": cast(JsonValue, messages),
@@ -105,8 +109,7 @@ class OpenAiCompatibleProvider:
         }
         if tools:
             payload["tools"] = [tool_schema(tool) for tool in tools]
-        structured = response_format(output_schema_key, output_schema)
-        if structured is not None:
+        if structured is not None and not tools:
             payload["response_format"] = structured
         if max_output_tokens is not None:
             payload["max_tokens"] = max_output_tokens

package/template/apps/agent-server/src/southwind_agent_server/provider_output_guidance.py

@@ -0,0 +1,34 @@
+from __future__ import annotations
+
+import json
+
+from .contracts import JsonValue
+from .engine import SafeEngineError
+
+
+def tool_output_messages(
+    messages: list[dict[str, JsonValue]],
+    output_schema: dict[str, JsonValue] | None,
+) -> list[dict[str, JsonValue]]:
+    """Merge already-governed schema guidance without moving Context source ordinals."""
+    if output_schema is None:
+        return messages
+    if not messages or messages[0].get("role") != "system":
+        raise SafeEngineError(
+            "INVALID_INPUT", "工具结构化输出缺少系统指令", retryable=False
+        )
+    instructions = messages[0].get("content")
+    if not isinstance(instructions, str):
+        raise SafeEngineError(
+            "INVALID_INPUT", "工具结构化输出指令无效", retryable=False
+        )
+    guidance = (
+        "\n\n需要工具时，只通过 API 的 function calling 调用已提供的工具，"
+        "不要在正文中模拟工具调用。工具处理完成后的最终回复必须是符合以下 "
+        "JSON Schema 的单个 JSON 值，不含 Markdown 围栏或额外说明；"
+        "工具调用阶段不受最终 JSON 格式限制。\n"
+        + json.dumps(output_schema, ensure_ascii=False, separators=(",", ":"))
+    )
+    if instructions.endswith(guidance):
+        return messages
+    return [{**messages[0], "content": instructions + guidance}, *messages[1:]]

package/template/apps/agent-server/src/southwind_agent_server/structured_logging.py

@@ -124,11 +124,22 @@ class AgentStructuredLogHandler(logging.Handler):
 
 
 def configure_agent_logging() -> None:
-    """Attach once to package loggers; keep Uvicorn's own access logs separate."""
+    """Use one package sink without closing handlers shared with Uvicorn."""
     logger = logging.getLogger("southwind_agent_server")
-    if not any(
-        isinstance(handler, AgentStructuredLogHandler) for handler in logger.handlers
-    ):
-        logger.addHandler(AgentStructuredLogHandler())
+    structured = next(
+        (
+            handler
+            for handler in logger.handlers
+            if isinstance(handler, AgentStructuredLogHandler)
+        ),
+        None,
+    )
+    if structured is None:
+        structured = AgentStructuredLogHandler()
+    for handler in logger.handlers[:]:
+        if handler is not structured:
+            logger.removeHandler(handler)
+    if structured not in logger.handlers:
+        logger.addHandler(structured)
     logger.setLevel(logging.INFO)
     logger.propagate = False

package/template/apps/agent-server/tests/test_structured_logging.py

@@ -4,6 +4,8 @@ import logging
 from importlib import import_module
 from typing import TextIO, cast
 
+import pytest
+
 from southwind_agent_server.structured_logging import (
     MAX_LOG_BYTES,
     AgentStructuredLogHandler,
@@ -103,3 +105,38 @@ def test_stdout_failure_does_not_interrupt_runtime() -> None:
         }
     )
     handler.emit(record)
+
+
+def test_bootstrap_removes_borrowed_sink_without_closing_uvicorn(
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    stream = io.StringIO()
+    legacy_stream = io.StringIO()
+    legacy = logging.StreamHandler(legacy_stream)
+    structured = AgentStructuredLogHandler(stream)
+    logger = logging.getLogger("southwind_agent_server")
+    uvicorn = logging.getLogger("uvicorn")
+    monkeypatch.setattr(logger, "handlers", [legacy, structured])
+    monkeypatch.setattr(logger, "level", logging.INFO)
+    monkeypatch.setattr(logger, "propagate", False)
+    monkeypatch.setattr(uvicorn, "handlers", [legacy])
+    monkeypatch.setattr(uvicorn, "level", logging.INFO)
+    monkeypatch.setattr(uvicorn, "propagate", False)
+    closed: list[bool] = []
+    monkeypatch.setattr(legacy, "close", lambda: closed.append(True))
+
+    configure_agent_logging()
+    configure_agent_logging()
+    assert logger.handlers == [structured]
+    assert uvicorn.handlers == [legacy]
+    assert not closed
+    try:
+        raise ValueError("secret-exception")
+    except ValueError:
+        logger.exception("Agent Run 恢复轮询失败，将继续重试")
+    assert len(stream.getvalue().splitlines()) == 1
+    assert json.loads(stream.getvalue())["errorCode"] == "AGENT_RUN_RECOVERY_FAILED"
+    assert legacy_stream.getvalue() == ""
+    assert "secret-exception" not in stream.getvalue()
+    uvicorn.warning("independent-server-warning")
+    assert "independent-server-warning" in legacy_stream.getvalue()