@dotobokuri/fleet-console 1.54.1 → 1.56.0

package/dist/fleet-plugins/terminal/routes.mjs

@@ -26,10 +26,18 @@ var __export = (target2, all) => {
 function definePlugin(definition) {
   return definition;
 }
-function registerRouter(ctx, path42, handler) {
+function registerRouter(ctx, path42, handler, catalog) {
+  if (catalog) {
+    ctx.registerRouter(normalizePath(path42), handler, catalog);
+    return;
+  }
   ctx.registerRouter(normalizePath(path42), handler);
 }
-function registerWsHandler(ctx, path42, handler) {
+function registerWsHandler(ctx, path42, handler, catalog) {
+  if (catalog) {
+    ctx.registerWsHandler(normalizePath(path42), handler, catalog);
+    return;
+  }
   ctx.registerWsHandler(normalizePath(path42), handler);
 }
 function registerLaunchCatalog(ctx, provider) {
@@ -22260,6 +22268,21 @@ function functionCallStart(item, index) {
     }
   };
 }
+function findCauseCode(error51) {
+  let current = error51;
+  const seen = /* @__PURE__ */ new Set();
+  for (let depth = 0; depth <= 4; depth += 1) {
+    if (current === null || typeof current !== "object") return void 0;
+    if (seen.has(current)) return void 0;
+    seen.add(current);
+    if (Object.prototype.hasOwnProperty.call(current, "code")) {
+      const code = current.code;
+      if (typeof code === "string") return code;
+    }
+    current = current.cause;
+  }
+  return void 0;
+}
 var UpstreamBodyLimitError = class extends Error {
   constructor(maxBodyBytes) {
     super(`Upstream response exceeded ${maxBodyBytes} bytes`);
@@ -22350,6 +22373,51 @@ async function readWithIdleTimeout(reader, options) {
     );
   });
 }
+async function* parseUpstreamSseStream(body, options, parseFrame) {
+  if (body === null) {
+    options.onClose();
+    throw new UpstreamProtocolError(options.missingBodyMessage);
+  }
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let buffer = "";
+  let byteLength = 0;
+  try {
+    while (true) {
+      const result = await readWithIdleTimeout(reader, options);
+      if (result.done) {
+        buffer += decoder.decode();
+        break;
+      }
+      byteLength += result.value.byteLength;
+      if (byteLength > options.maxBodyBytes) {
+        const error51 = new UpstreamBodyLimitError(options.maxBodyBytes);
+        options.controller.abort(error51);
+        throw error51;
+      }
+      buffer += decoder.decode(result.value, { stream: true });
+      let boundary = nextEventBoundary(buffer);
+      while (boundary !== void 0) {
+        const frame = buffer.slice(0, boundary.index);
+        buffer = buffer.slice(boundary.index + boundary.length);
+        const event = parseFrame(frame);
+        if (event !== void 0) {
+          yield event;
+        }
+        boundary = nextEventBoundary(buffer);
+      }
+    }
+    if (buffer.trim().length > 0) {
+      const event = parseFrame(buffer);
+      if (event !== void 0) {
+        yield event;
+      }
+    }
+  } finally {
+    await reader.cancel().catch(() => void 0);
+    options.onClose();
+  }
+}
 function nextEventBoundary(buffer) {
   const match = /\r\n\r\n|\n\n|\r\r/.exec(buffer);
   return match === null ? void 0 : { index: match.index, length: match[0].length };
@@ -22593,7 +22661,9 @@ var OpenAIResponsesAdapter = class {
   }
 };
 var CodexResponsesAdapter = class extends OpenAIResponsesAdapter {
+  isMarkedFetchFailure;
   constructor(options = {}) {
+    const fetchFailureTracker = createCodexFetchFailureTracker(options.fetch ?? globalThis.fetch.bind(globalThis));
     super({
       url: CHATGPT_CODEX_RESPONSES_URL,
       dropSamplingParams: true,
@@ -22601,11 +22671,12 @@ var CodexResponsesAdapter = class extends OpenAIResponsesAdapter {
         ...options.accountId ? { "chatgpt-account-id": options.accountId } : {},
         ...options.headers
       },
-      fetch: markCodexFetchFailures(options.fetch ?? globalThis.fetch.bind(globalThis)),
+      fetch: fetchFailureTracker.fetch,
       // `!== undefined` 여야 명시적 0이 상속된 positiveInteger 검증을 통과한다.
       ...options.maxBodyBytes !== void 0 ? { maxBodyBytes: options.maxBodyBytes } : {},
       ...options.idleTimeoutMs !== void 0 ? { idleTimeoutMs: options.idleTimeoutMs } : {}
     });
+    this.isMarkedFetchFailure = fetchFailureTracker.isMarkedFailure;
   }
   async stream(request, options) {
     const callController = new AbortController();
@@ -22616,7 +22687,7 @@ var CodexResponsesAdapter = class extends OpenAIResponsesAdapter {
     try {
       response = await super.stream(request, callOptions);
     } catch (error51) {
-      if (!isRetryableCodexFetchSocketTermination(error51, callOptions.signal)) {
+      if (!isRetryableCodexFetchSocketTermination(error51, callOptions.signal, this.isMarkedFetchFailure)) {
         unlinkCallAbort();
         throw error51;
       }
@@ -22771,24 +22842,24 @@ function commitsCodexOutput(event) {
       return true;
   }
 }
-var codexFetchFailures = /* @__PURE__ */ new WeakSet();
-function markCodexFetchFailures(fetchImpl) {
-  return async (input, init) => {
-    try {
-      return await fetchImpl(input, init);
-    } catch (error51) {
-      if (error51 !== null && typeof error51 === "object") {
-        codexFetchFailures.add(error51);
+function createCodexFetchFailureTracker(fetchImpl) {
+  const fetchFailures = /* @__PURE__ */ new WeakSet();
+  return {
+    fetch: async (input, init) => {
+      try {
+        return await fetchImpl(input, init);
+      } catch (error51) {
+        if (error51 !== null && typeof error51 === "object") {
+          fetchFailures.add(error51);
+        }
+        throw error51;
       }
-      throw error51;
-    }
+    },
+    isMarkedFailure: (error51) => error51 !== null && typeof error51 === "object" && fetchFailures.has(error51)
   };
 }
-function isRetryableCodexFetchSocketTermination(error51, signal) {
-  return signal?.aborted !== true && isMarkedCodexFetchFailure(error51) && isUndiciSocketTermination(error51);
-}
-function isMarkedCodexFetchFailure(error51) {
-  return error51 !== null && typeof error51 === "object" && codexFetchFailures.has(error51);
+function isRetryableCodexFetchSocketTermination(error51, signal, isMarkedFailure) {
+  return signal?.aborted !== true && isMarkedFailure(error51) && isUndiciSocketTermination(error51);
 }
 function isUndiciSocketTermination(error51) {
   const seen = /* @__PURE__ */ new Set();
@@ -22904,50 +22975,12 @@ function isClaudeCodeSuggestionMode(request) {
   const last = request.input.at(-1);
   return last?.type === "message" && last.role === "user" && typeof last.content === "string" && last.content.startsWith(CLAUDE_CODE_SUGGESTION_MODE_PREFIX);
 }
-async function* parseOpenAIEventStream(body, options) {
-  if (body === null) {
-    options.onClose();
-    throw new UpstreamProtocolError("OpenAI streaming response had no body");
-  }
-  const reader = body.getReader();
-  const decoder = new TextDecoder();
-  let buffer = "";
-  let byteLength = 0;
-  try {
-    while (true) {
-      const result = await readWithIdleTimeout(reader, options);
-      if (result.done) {
-        buffer += decoder.decode();
-        break;
-      }
-      byteLength += result.value.byteLength;
-      if (byteLength > options.maxBodyBytes) {
-        const error51 = new UpstreamBodyLimitError(options.maxBodyBytes);
-        options.controller.abort(error51);
-        throw error51;
-      }
-      buffer += decoder.decode(result.value, { stream: true });
-      let boundary = nextEventBoundary(buffer);
-      while (boundary !== void 0) {
-        const frame = buffer.slice(0, boundary.index);
-        buffer = buffer.slice(boundary.index + boundary.length);
-        const event = parseEventFrame(frame);
-        if (event !== void 0) {
-          yield event;
-        }
-        boundary = nextEventBoundary(buffer);
-      }
-    }
-    if (buffer.trim().length > 0) {
-      const event = parseEventFrame(buffer);
-      if (event !== void 0) {
-        yield event;
-      }
-    }
-  } finally {
-    await reader.cancel().catch(() => void 0);
-    options.onClose();
-  }
+function parseOpenAIEventStream(body, options) {
+  return parseUpstreamSseStream(
+    body,
+    { ...options, missingBodyMessage: "OpenAI streaming response had no body" },
+    parseEventFrame
+  );
 }
 function parseEventFrame(frame) {
   const { event: eventName, data } = parseSseFrameFields(frame);
@@ -24396,50 +24429,12 @@ function forOpenCodeGoResponsesBackend(request) {
   }
   return payload;
 }
-async function* parseOpenCodeGoEventStream(body, options) {
-  if (body === null) {
-    options.onClose();
-    throw new UpstreamProtocolError("OpenCode Go streaming response had no body");
-  }
-  const reader = body.getReader();
-  const decoder = new TextDecoder();
-  let buffer = "";
-  let byteLength = 0;
-  try {
-    while (true) {
-      const result = await readWithIdleTimeout(reader, options);
-      if (result.done) {
-        buffer += decoder.decode();
-        break;
-      }
-      byteLength += result.value.byteLength;
-      if (byteLength > options.maxBodyBytes) {
-        const error51 = new UpstreamBodyLimitError(options.maxBodyBytes);
-        options.controller.abort(error51);
-        throw error51;
-      }
-      buffer += decoder.decode(result.value, { stream: true });
-      let boundary = nextEventBoundary(buffer);
-      while (boundary !== void 0) {
-        const frame = buffer.slice(0, boundary.index);
-        buffer = buffer.slice(boundary.index + boundary.length);
-        const event = parseEventFrame2(frame);
-        if (event !== void 0) {
-          yield event;
-        }
-        boundary = nextEventBoundary(buffer);
-      }
-    }
-    if (buffer.trim().length > 0) {
-      const event = parseEventFrame2(buffer);
-      if (event !== void 0) {
-        yield event;
-      }
-    }
-  } finally {
-    await reader.cancel().catch(() => void 0);
-    options.onClose();
-  }
+function parseOpenCodeGoEventStream(body, options) {
+  return parseUpstreamSseStream(
+    body,
+    { ...options, missingBodyMessage: "OpenCode Go streaming response had no body" },
+    parseEventFrame2
+  );
 }
 function parseEventFrame2(frame) {
   const { event: eventName, data } = parseSseFrameFields(frame);
@@ -25078,6 +25073,133 @@ function stringValue(value) {
 function isRecord7(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+var EXECUTE_HOOK_FIELD_NUMBER = 27;
+var EXEC_CLIENT_MESSAGE_FIELD_NUMBER = 2;
+var EXEC_CLIENT_CONTROL_MESSAGE_FIELD_NUMBER = 5;
+var SUPPORTED_HOOK_CASES = /* @__PURE__ */ new Set([1, 2, 3, 4, 5, 6, 7, 8, 9, 11]);
+function cursorUnknownExecReply(exec2, unknownFields) {
+  const executeHook = unknownFields.find(
+    (field) => field.no === EXECUTE_HOOK_FIELD_NUMBER && field.wireType === WireType.LengthDelimited
+  );
+  if (executeHook) {
+    const hookCase = executeHookRequestCase(executeHook);
+    if (hookCase !== void 0 && SUPPORTED_HOOK_CASES.has(hookCase)) {
+      return {
+        payloads: [executeHookReply(exec2, hookCase)],
+        replyKind: "exec.policy.executeHookArgs"
+      };
+    }
+  }
+  const caseName = cursorUnknownExecCaseName(unknownFields);
+  return {
+    payloads: unsupportedExecReplies(
+      exec2,
+      `Fleet AI Gateway cannot handle Cursor native exec ${caseName}; retry with an advertised client tool.`
+    ),
+    replyKind: `exec.control.${caseName}`
+  };
+}
+function cursorUnknownExecCaseName(unknownFields) {
+  const fieldNumbers = [...new Set(
+    unknownFields.filter((field) => field.wireType === WireType.LengthDelimited).map((field) => field.no)
+  )].sort((left, right) => left - right);
+  if (fieldNumbers.includes(EXECUTE_HOOK_FIELD_NUMBER)) return "executeHookArgs";
+  return fieldNumbers.length > 0 ? `unknownField${fieldNumbers.join("-")}` : "unknown";
+}
+function executeHookRequestCase(field) {
+  const args = lengthDelimitedPayload(field);
+  if (!args) return void 0;
+  const request = embeddedMessage(args, 1);
+  if (!request) return void 0;
+  try {
+    const reader = new BinaryReader(request);
+    while (reader.pos < reader.len) {
+      const [fieldNumber, wireType] = reader.tag();
+      if (wireType === WireType.LengthDelimited) return fieldNumber;
+      reader.skip(wireType, fieldNumber);
+    }
+  } catch {
+    return void 0;
+  }
+  return void 0;
+}
+function lengthDelimitedPayload(field) {
+  try {
+    const reader = new BinaryReader(field.data);
+    const payload = reader.bytes();
+    return reader.pos === reader.len ? payload : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function embeddedMessage(message, wantedFieldNumber) {
+  try {
+    const reader = new BinaryReader(message);
+    while (reader.pos < reader.len) {
+      const [fieldNumber, wireType] = reader.tag();
+      if (fieldNumber === wantedFieldNumber && wireType === WireType.LengthDelimited) {
+        return reader.bytes();
+      }
+      reader.skip(wireType, fieldNumber);
+    }
+  } catch {
+    return void 0;
+  }
+  return void 0;
+}
+function executeHookReply(exec2, hookCase) {
+  const response = encodeMessage((writer) => {
+    writer.tag(hookCase, WireType.LengthDelimited).bytes(new Uint8Array());
+  });
+  const result = encodeMessage((writer) => {
+    writer.tag(1, WireType.LengthDelimited).bytes(response);
+  });
+  const execClientMessage = encodeMessage((writer) => {
+    writer.tag(1, WireType.Varint).uint32(unknownExecUint32Value(exec2.id));
+    const execId = unknownExecStringValue(exec2.execId);
+    if (execId) writer.tag(15, WireType.LengthDelimited).string(execId);
+    writer.tag(EXECUTE_HOOK_FIELD_NUMBER, WireType.LengthDelimited).bytes(result);
+  });
+  return encodeMessage((writer) => {
+    writer.tag(EXEC_CLIENT_MESSAGE_FIELD_NUMBER, WireType.LengthDelimited).bytes(execClientMessage);
+  });
+}
+function unsupportedExecReplies(exec2, error51) {
+  const id = unknownExecUint32Value(exec2.id);
+  const execThrow = encodeMessage((writer) => {
+    writer.tag(1, WireType.Varint).uint32(id);
+    writer.tag(2, WireType.LengthDelimited).string(error51);
+  });
+  const streamClose = encodeMessage((writer) => {
+    writer.tag(1, WireType.Varint).uint32(id);
+  });
+  return [
+    encodeControlMessage(2, execThrow),
+    encodeControlMessage(1, streamClose)
+  ];
+}
+function encodeControlMessage(caseNumber, value) {
+  const control = encodeMessage((writer) => {
+    writer.tag(caseNumber, WireType.LengthDelimited).bytes(value);
+  });
+  return encodeMessage((writer) => {
+    writer.tag(EXEC_CLIENT_CONTROL_MESSAGE_FIELD_NUMBER, WireType.LengthDelimited).bytes(control);
+  });
+}
+function encodeMessage(write) {
+  const writer = new BinaryWriter();
+  write(writer);
+  return writer.finish();
+}
+function unknownExecUint32Value(value) {
+  if (typeof value === "number" && Number.isSafeInteger(value) && value >= 0 && value <= 4294967295) {
+    return value;
+  }
+  return 0;
+}
+function unknownExecStringValue(value) {
+  return typeof value === "string" ? value : "";
+}
 var READ_CANDIDATES = ["Read"];
 var GREP_CANDIDATES = ["Grep"];
 var SHELL_CANDIDATES = ["Bash", "shell_command", "exec_command"];
@@ -25720,133 +25842,6 @@ function stringValue2(value) {
 function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-var EXECUTE_HOOK_FIELD_NUMBER = 27;
-var EXEC_CLIENT_MESSAGE_FIELD_NUMBER = 2;
-var EXEC_CLIENT_CONTROL_MESSAGE_FIELD_NUMBER = 5;
-var SUPPORTED_HOOK_CASES = /* @__PURE__ */ new Set([1, 2, 3, 4, 5, 6, 7, 8, 9, 11]);
-function cursorUnknownExecReply(exec2, unknownFields) {
-  const executeHook = unknownFields.find(
-    (field) => field.no === EXECUTE_HOOK_FIELD_NUMBER && field.wireType === WireType.LengthDelimited
-  );
-  if (executeHook) {
-    const hookCase = executeHookRequestCase(executeHook);
-    if (hookCase !== void 0 && SUPPORTED_HOOK_CASES.has(hookCase)) {
-      return {
-        payloads: [executeHookReply(exec2, hookCase)],
-        replyKind: "exec.policy.executeHookArgs"
-      };
-    }
-  }
-  const caseName = cursorUnknownExecCaseName(unknownFields);
-  return {
-    payloads: unsupportedExecReplies(
-      exec2,
-      `Fleet AI Gateway cannot handle Cursor native exec ${caseName}; retry with an advertised client tool.`
-    ),
-    replyKind: `exec.control.${caseName}`
-  };
-}
-function cursorUnknownExecCaseName(unknownFields) {
-  const fieldNumbers = [...new Set(
-    unknownFields.filter((field) => field.wireType === WireType.LengthDelimited).map((field) => field.no)
-  )].sort((left, right) => left - right);
-  if (fieldNumbers.includes(EXECUTE_HOOK_FIELD_NUMBER)) return "executeHookArgs";
-  return fieldNumbers.length > 0 ? `unknownField${fieldNumbers.join("-")}` : "unknown";
-}
-function executeHookRequestCase(field) {
-  const args = lengthDelimitedPayload(field);
-  if (!args) return void 0;
-  const request = embeddedMessage(args, 1);
-  if (!request) return void 0;
-  try {
-    const reader = new BinaryReader(request);
-    while (reader.pos < reader.len) {
-      const [fieldNumber, wireType] = reader.tag();
-      if (wireType === WireType.LengthDelimited) return fieldNumber;
-      reader.skip(wireType, fieldNumber);
-    }
-  } catch {
-    return void 0;
-  }
-  return void 0;
-}
-function lengthDelimitedPayload(field) {
-  try {
-    const reader = new BinaryReader(field.data);
-    const payload = reader.bytes();
-    return reader.pos === reader.len ? payload : void 0;
-  } catch {
-    return void 0;
-  }
-}
-function embeddedMessage(message, wantedFieldNumber) {
-  try {
-    const reader = new BinaryReader(message);
-    while (reader.pos < reader.len) {
-      const [fieldNumber, wireType] = reader.tag();
-      if (fieldNumber === wantedFieldNumber && wireType === WireType.LengthDelimited) {
-        return reader.bytes();
-      }
-      reader.skip(wireType, fieldNumber);
-    }
-  } catch {
-    return void 0;
-  }
-  return void 0;
-}
-function executeHookReply(exec2, hookCase) {
-  const response = encodeMessage((writer) => {
-    writer.tag(hookCase, WireType.LengthDelimited).bytes(new Uint8Array());
-  });
-  const result = encodeMessage((writer) => {
-    writer.tag(1, WireType.LengthDelimited).bytes(response);
-  });
-  const execClientMessage = encodeMessage((writer) => {
-    writer.tag(1, WireType.Varint).uint32(uint32Value(exec2.id));
-    const execId = stringValue3(exec2.execId);
-    if (execId) writer.tag(15, WireType.LengthDelimited).string(execId);
-    writer.tag(EXECUTE_HOOK_FIELD_NUMBER, WireType.LengthDelimited).bytes(result);
-  });
-  return encodeMessage((writer) => {
-    writer.tag(EXEC_CLIENT_MESSAGE_FIELD_NUMBER, WireType.LengthDelimited).bytes(execClientMessage);
-  });
-}
-function unsupportedExecReplies(exec2, error51) {
-  const id = uint32Value(exec2.id);
-  const execThrow = encodeMessage((writer) => {
-    writer.tag(1, WireType.Varint).uint32(id);
-    writer.tag(2, WireType.LengthDelimited).string(error51);
-  });
-  const streamClose = encodeMessage((writer) => {
-    writer.tag(1, WireType.Varint).uint32(id);
-  });
-  return [
-    encodeControlMessage(2, execThrow),
-    encodeControlMessage(1, streamClose)
-  ];
-}
-function encodeControlMessage(caseNumber, value) {
-  const control = encodeMessage((writer) => {
-    writer.tag(caseNumber, WireType.LengthDelimited).bytes(value);
-  });
-  return encodeMessage((writer) => {
-    writer.tag(EXEC_CLIENT_CONTROL_MESSAGE_FIELD_NUMBER, WireType.LengthDelimited).bytes(control);
-  });
-}
-function encodeMessage(write) {
-  const writer = new BinaryWriter();
-  write(writer);
-  return writer.finish();
-}
-function uint32Value(value) {
-  if (typeof value === "number" && Number.isSafeInteger(value) && value >= 0 && value <= 4294967295) {
-    return value;
-  }
-  return 0;
-}
-function stringValue3(value) {
-  return typeof value === "string" ? value : "";
-}
 var cursorAgentDescriptor = [
   "CgthZ2VudC5wcm90bxIIYWdlbnQudjEicgoOR2xvYlRvb2xSZXN1bHQSLAoHc3VjY2VzcxgBIAEoCzIZLmFnZW50LnYxLkdsb2JUb29sU3VjY2Vzc0gAEigK",
   "BWVycm9yGAIgASgLMhcuYWdlbnQudjEuR2xvYlRvb2xFcnJvckgAQggKBnJlc3VsdCIeCg1HbG9iVG9vbEVycm9yEg0KBWVycm9yGAEgASgJIokBCg9HbG9i",
@@ -28767,9 +28762,9 @@ function cursorInteractionQueryReply(query) {
   });
   if (isRecord9(query.createPlanRequestQuery)) {
     const args = isRecord9(query.createPlanRequestQuery.args) ? query.createPlanRequestQuery.args : void 0;
-    const name = stringValue4(args?.name)?.trim();
-    const overview = stringValue4(args?.overview)?.trim();
-    const plan = stringValue4(args?.plan)?.trim();
+    const name = stringValue3(args?.name)?.trim();
+    const overview = stringValue3(args?.overview)?.trim();
+    const plan = stringValue3(args?.plan)?.trim();
     const parts = [
       name ? `Plan: ${name}` : void 0,
       overview || void 0,
@@ -28924,16 +28919,16 @@ function mcpCallFromToolUpdate(value) {
   const toolCall = isRecord9(value.toolCall) ? value.toolCall : void 0;
   const args = toolCall ? mcpArgsFromToolCall(toolCall) : void 0;
   if (!args) return null;
-  const publicCallId = stringValue4(value.callId);
-  const toolCallId = stringValue4(args.toolCallId);
+  const publicCallId = stringValue3(value.callId);
+  const toolCallId = stringValue3(args.toolCallId);
   const callId = publicCallId ?? toolCallId;
   if (!callId) return null;
   return {
     callId,
     ...publicCallId ? { publicCallId } : {},
     ...toolCallId ? { toolCallId } : {},
-    name: stringValue4(args?.toolName) ?? stringValue4(args?.name) ?? "tool",
-    ...stringValue4(args?.providerIdentifier) ? { providerIdentifier: stringValue4(args?.providerIdentifier) } : {},
+    name: stringValue3(args?.toolName) ?? stringValue3(args?.name) ?? "tool",
+    ...stringValue3(args?.providerIdentifier) ? { providerIdentifier: stringValue3(args?.providerIdentifier) } : {},
     ...args ? cursorMcpArguments(args) : {}
   };
 }
@@ -28985,18 +28980,18 @@ function isCursorParkedResidueFrame(frame, parked) {
 function mcpCallFromExecMessage(value) {
   const args = isRecord9(value.mcpArgs) ? value.mcpArgs : void 0;
   if (!args) return null;
-  const toolCallId = stringValue4(args.toolCallId);
+  const toolCallId = stringValue3(args.toolCallId);
   if (!toolCallId) return null;
   const rawMessageId = value.id ?? 0;
   const messageId = typeof rawMessageId === "number" && Number.isSafeInteger(rawMessageId) ? rawMessageId : void 0;
-  const execId = stringValue4(value.execId);
+  const execId = stringValue3(value.execId);
   return {
     callId: toolCallId,
     toolCallId,
     ...messageId === void 0 ? {} : { messageId },
     ...execId ? { execId } : {},
-    name: stringValue4(args.toolName) ?? stringValue4(args.name) ?? "tool",
-    ...stringValue4(args.providerIdentifier) ? { providerIdentifier: stringValue4(args.providerIdentifier) } : {},
+    name: stringValue3(args.toolName) ?? stringValue3(args.name) ?? "tool",
+    ...stringValue3(args.providerIdentifier) ? { providerIdentifier: stringValue3(args.providerIdentifier) } : {},
     ...cursorMcpArguments(args)
   };
 }
@@ -29074,7 +29069,7 @@ function completeJson(value) {
     return void 0;
   }
 }
-function stringValue4(value) {
+function stringValue3(value) {
   return typeof value === "string" && value.length > 0 ? value : void 0;
 }
 function cursorError(value) {
@@ -29501,24 +29496,9 @@ data: ${data}
   } catch {
   }
 }
-function findCauseCode2(error51) {
-  let current = error51;
-  const seen = /* @__PURE__ */ new Set();
-  for (let depth = 0; depth <= 4; depth += 1) {
-    if (current === null || typeof current !== "object") return void 0;
-    if (seen.has(current)) return void 0;
-    seen.add(current);
-    if (Object.prototype.hasOwnProperty.call(current, "code")) {
-      const code = current.code;
-      if (typeof code === "string") return code;
-    }
-    current = current.cause;
-  }
-  return void 0;
-}
 function errorMessage(error51) {
   const message = error51 instanceof Error ? error51.message : String(error51);
-  const code = findCauseCode2(error51);
+  const code = findCauseCode(error51);
   return code !== void 0 && !message.includes(code) ? `${message} (${code})` : message;
 }
 function isOpencodeAnthropicPassthrough(model) {
@@ -33555,7 +33535,7 @@ async function writeWikiEntryAtTarget(entry, target2, paths) {
     throw new Error("wiki patch body id must match target filename");
   }
   await mkdir(path18__default.dirname(absoluteTarget), { recursive: true });
-  await writeMarkdownAtomic(absoluteTarget, serializeWikiEntry(entry), paths);
+  await writeAtomic(absoluteTarget, serializeWikiEntry(entry), paths);
   return path18__default.join("wiki", relativeTarget).replaceAll(path18__default.sep, "/");
 }
 async function writeRawSourceEntry(entry, paths) {
@@ -33575,7 +33555,7 @@ async function writeRawSourceEntry(entry, paths) {
     },
     entry.content
   );
-  await writeMarkdownAtomic(path18__default.join(paths.root, relativePath), content, paths);
+  await writeAtomic(path18__default.join(paths.root, relativePath), content, paths);
   return relativePath;
 }
 async function readRawSourceEntry(rawSourceRef, paths) {
@@ -33623,7 +33603,7 @@ async function rebuildIndex(paths) {
     entryPathMap[item.entry.id] = item.path;
   }
   await writeJsonAtomic(paths.indexFile, nextIndex, paths);
-  await writeMarkdownAtomic(getIndexMarkdownFile(paths), renderIndexMarkdown(entries.map((item) => item.entry), entryPathMap), paths);
+  await writeAtomic(getIndexMarkdownFile(paths), renderIndexMarkdown(entries.map((item) => item.entry), entryPathMap), paths);
   await appendLog(paths, "index rebuilt", { entry_count: entries.length });
   return nextIndex;
 }
@@ -33703,7 +33683,7 @@ async function readPatchFile(filePath) {
   return readFile(filePath, "utf8");
 }
 async function writePatchFile(filePath, content, paths) {
-  await writeMarkdownAtomic(filePath, content, paths);
+  await writeAtomic(filePath, content, paths);
 }
 async function readJsonFile2(filePath) {
   const raw = await readFile(filePath, "utf8");
@@ -33970,9 +33950,6 @@ function isFrontmatterBlock(rawFrontmatter) {
   }
   return keys.has("id") && keys.has("title");
 }
-async function writeMarkdownAtomic(filePath, content, paths) {
-  await writeAtomic(filePath, content, paths);
-}
 async function writeJsonAtomic(filePath, value, paths) {
   await writeAtomic(filePath, JSON.stringify(value, null, 2), paths);
 }
@@ -45273,7 +45250,10 @@ function registerTerminalSettingsRoutes(ctx, deps) {
     }
     ctx.host.http.writeJson(res, 405, { error: "Method not allowed" });
     return true;
-  });
+  }, [
+    { method: "GET", path: "", summary: "Read Terminal plugin settings.", category: "Terminal Plugin", gate: "loopback", transport: "http" },
+    { method: "PUT", path: "", summary: "Save Terminal plugin settings.", category: "Terminal Plugin", gate: "origin-write", transport: "http" }
+  ]);
 }
 function toTerminalSettingsState(data, aiGateway, wireLogEnabled2) {
   const configured = (aiGateway.models?.length ?? 0) > 0 || (aiGateway.providerPriority?.length ?? 0) > 0;
@@ -45370,7 +45350,23 @@ async function registerAgentRoutes(ctx, terminalRuntime, deps) {
     await api.handleExit(operationId);
   });
   ctx.host.lifecycle.registerCleanup(api.cleanup);
-  registerRouter(ctx, "agent", api.handle);
+  registerRouter(ctx, "agent", api.handle, [
+    { method: "GET", path: "/state", summary: "Read Agent session state.", category: "Terminal Plugin", gate: "loopback", transport: "http" },
+    { method: "GET", path: "/agent-cli/state", summary: "Read installed Agent CLI status.", category: "Terminal Plugin", gate: "loopback", transport: "http" },
+    { method: "GET", path: "/agent-cli/diagnostics", summary: "Read Agent CLI diagnostics.", category: "Terminal Plugin", gate: "origin-write", transport: "http" },
+    { method: "PUT", path: "/agent-cli/path", summary: "Save an Agent CLI executable path.", category: "Terminal Plugin", gate: "origin-write", transport: "http" },
+    { method: "GET", path: "/events", summary: "Stream Agent session events.", category: "Terminal Plugin", gate: "loopback", transport: "sse" },
+    { method: "GET", path: "/sessions", summary: "List Agent sessions.", category: "Terminal Plugin", gate: "origin-write", transport: "http" },
+    { method: "POST", path: "/sessions", summary: "Create an Agent session.", category: "Terminal Plugin", gate: "origin-write", transport: "http" },
+    { method: "DELETE", path: "/sessions/:sessionId", summary: "Delete an Agent session.", category: "Terminal Plugin", gate: "origin-write", transport: "http" },
+    { method: "POST", path: "/sessions/:sessionId/resume", summary: "Resume an Agent session.", category: "Terminal Plugin", gate: "origin-write", transport: "http" },
+    { method: "POST", path: "/sessions/:sessionId/turn", summary: "Receive an Agent turn hook.", category: "Terminal Plugin", gate: "lock-token", transport: "http" },
+    { method: "POST", path: "/sessions/:sessionId/background", summary: "Receive an Agent background-task hook.", category: "Terminal Plugin", gate: "lock-token", transport: "http" },
+    { method: "POST", path: "/sessions/:sessionId/attention", summary: "Receive an Agent attention hook.", category: "Terminal Plugin", gate: "lock-token", transport: "http" },
+    { method: "POST", path: "/sessions/:sessionId/auto-name", summary: "Receive an Agent auto-name hook.", category: "Terminal Plugin", gate: "lock-token", transport: "http" },
+    { method: "POST", path: "/sessions/:sessionId/capture", summary: "Receive an Agent session capture hook.", category: "Terminal Plugin", gate: "lock-token", transport: "http" },
+    { method: "POST", path: "/ticket", summary: "Issue an Agent Terminal WebSocket ticket.", category: "Terminal Plugin", gate: "origin-write", transport: "http" }
+  ]);
   return api.launchKinds;
 }
 function buildAgentLaunchKindBackfillPatch(operation) {
@@ -45686,7 +45682,11 @@ async function createAgentApi(ctx, terminalRuntime, deps) {
       // toOperationPayload가 지우는 키 목록 밖이라 resume·복원을 지나도 그대로 남는다.
       payload: {
         ...toOperationPayload(void 0, cwd, session),
-        [AGENT_LAUNCH_PROVIDER_PAYLOAD_KEY]: agentLaunchProviderFromModel(launchOptions.model)
+        [AGENT_LAUNCH_PROVIDER_PAYLOAD_KEY]: agentLaunchProviderFromModel(launchOptions.model),
+        // Claude Code의 resume가 launch 좌표를 자체 복원한다고 가정하지 않는다 — 정규화된
+        // 최초 선택을 Operation에 남겨 dormant·Console 재시작 뒤에도 같은 인자로 재개한다.
+        ...launchOptions.model ? { launchModel: launchOptions.model } : {},
+        ...launchOptions.effort ? { launchEffort: launchOptions.effort } : {}
       },
       createdAt: session.createdAt
     });
@@ -45714,7 +45714,7 @@ async function createAgentApi(ctx, terminalRuntime, deps) {
     } catch (error51) {
       if (error51 instanceof GatewayLaunchOptionError) {
         removeSession(sessionId);
-        ctx.host.http.writeJson(res, error51.code === "gateway_model_not_enabled" ? 409 : 400, { error: error51.code });
+        ctx.host.http.writeJson(res, gatewayLaunchOptionErrorStatus(error51), { error: error51.code });
         return;
       }
       if (error51 instanceof LaunchPromptError) {
@@ -45747,6 +45747,8 @@ async function createAgentApi(ctx, terminalRuntime, deps) {
       ctx.host.http.writeJson(res, node ? 409 : 404, { error: node ? "resume_unavailable" : "session_not_found" });
       return true;
     }
+    const launchModel = readPayloadString(node.payload, "launchModel") || (cliId === "claude-gateway" ? "opus[1m]" : void 0);
+    const launchEffort = readPayloadString(node.payload, "launchEffort") || void 0;
     resetOscActivity(sessionId);
     const starting = observability.updateTerminalSessionStatus(sessionId, "starting") ?? injectOperation(node);
     try {
@@ -45769,6 +45771,8 @@ async function createAgentApi(ctx, terminalRuntime, deps) {
         pluginId: node.pluginId,
         theaterId: node.theaterId,
         cliId,
+        ...launchModel ? { model: launchModel } : {},
+        ...launchEffort ? { effort: launchEffort } : {},
         ...fresh ? {} : { resumeSessionId: providerSession?.sessionId }
       });
       const runtimeSession = pendingRuntimeSessions.get(sessionId);
@@ -45777,9 +45781,11 @@ async function createAgentApi(ctx, terminalRuntime, deps) {
       observability.notifySessionUpdated(resumed);
       const currentPayload = fresh ? ctx.host.operations.get(sessionId)?.payload : node.payload;
       const effectiveProviderSession = fresh ? readProviderSession(currentPayload) : providerSession;
-      ctx.host.operations.patch(sessionId, { payload: toOperationPayload(currentPayload ?? node.payload, cwd, resumed, effectiveProviderSession, observability.getDurableOperation(sessionId)?.providerTitle) });
+      const resumedPayload = toOperationPayload(currentPayload ?? node.payload, cwd, resumed, effectiveProviderSession, observability.getDurableOperation(sessionId)?.providerTitle);
+      if (!readPayloadString(resumedPayload, "launchModel") && launchModel) resumedPayload.launchModel = launchModel;
+      ctx.host.operations.patch(sessionId, { payload: resumedPayload });
       ctx.host.http.writeJson(res, 200, resumed);
-    } catch {
+    } catch (error51) {
       resetOscActivity(sessionId);
       if (fresh && providerSession) {
         const rollbackPayload = { ...ctx.host.operations.get(sessionId)?.payload ?? {} };
@@ -45790,7 +45796,11 @@ async function createAgentApi(ctx, terminalRuntime, deps) {
       pendingRuntimeSessions.delete(sessionId);
       const reverted = observability.updateTerminalSessionStatus(sessionId, "dormant");
       if (reverted) observability.notifySessionUpdated(reverted);
-      ctx.host.http.writeJson(res, 503, { error: "terminal_unavailable" });
+      if (error51 instanceof GatewayLaunchOptionError) {
+        ctx.host.http.writeJson(res, gatewayLaunchOptionErrorStatus(error51), { error: error51.code });
+      } else {
+        ctx.host.http.writeJson(res, 503, { error: "terminal_unavailable" });
+      }
     }
     return true;
   }
@@ -46142,6 +46152,9 @@ function readProviderTitle(value) {
   if (candidate.source !== "provider" || Object.keys(candidate).length !== 1) return void 0;
   return { source: "provider" };
 }
+function gatewayLaunchOptionErrorStatus(error51) {
+  return error51.code === "gateway_model_not_enabled" ? 409 : 400;
+}
 function readPayloadString(payload, key) {
   const value = payload[key];
   return typeof value === "string" ? value : "";
@@ -47097,7 +47110,17 @@ function registerAnalysisRoutes(ctx, deps = {}) {
     if (action === "message") return handleMessage(ctx, req, res, operationId, registry3);
     if (action === "stream") return handleStream(ctx, req, res, operationId, registry3);
     return handleStop(ctx, req, res, operationId, registry3);
-  });
+  }, [
+    { method: "GET", path: "/catalog", summary: "Read Analyst model catalog.", category: "Terminal Plugin", gate: "origin-write", transport: "http" },
+    { method: "GET", path: "/stream", summary: "Stream all Analyst events.", category: "Terminal Plugin", gate: "origin-write", transport: "sse" },
+    { method: "GET", path: "/artifacts/:artifactId", summary: "Read an Analyst artifact.", category: "Terminal Plugin", gate: "origin-write", transport: "http" },
+    { method: "DELETE", path: "/:operationId/artifacts", summary: "Clear Analyst artifacts.", category: "Terminal Plugin", gate: "origin-write", transport: "http" },
+    { method: "GET", path: "/:operationId/ready", summary: "Read Analyst readiness.", category: "Terminal Plugin", gate: "origin-write", transport: "http" },
+    { method: "POST", path: "/:operationId/start", summary: "Start an Analyst session.", category: "Terminal Plugin", gate: "origin-write", transport: "http" },
+    { method: "POST", path: "/:operationId/message", summary: "Send an Analyst message.", category: "Terminal Plugin", gate: "origin-write", transport: "http" },
+    { method: "GET", path: "/:operationId/stream", summary: "Stream Analyst session events.", category: "Terminal Plugin", gate: "origin-write", transport: "sse" },
+    { method: "POST", path: "/:operationId/stop", summary: "Stop an Analyst session.", category: "Terminal Plugin", gate: "origin-write", transport: "http" }
+  ]);
   const unsubscribeDelete = ctx.host.events.subscribe(OPERATION_DELETED_EVENT_CHANNEL, (payload) => {
     if (isOperationDeletedEvent(payload) && payload.pluginId === ctx.pluginId) {
       for (const marker of inFlightStartDeletionMarkers) {
@@ -47589,7 +47612,11 @@ function registerAiGatewayRoutes(ctx, deps = {}) {
     router.dispose();
     return ownedDiagnostics?.flush();
   });
-  registerRouter(ctx, AI_GATEWAY_ROUTE_SEGMENT, router.handle);
+  registerRouter(ctx, AI_GATEWAY_ROUTE_SEGMENT, router.handle, [
+    { method: "*", path: "/api/hello", summary: "Read the AI Gateway health response.", category: "Terminal Plugin", gate: "loopback", transport: "http" },
+    { method: "*", path: "/v1/models", summary: "Proxy the AI Gateway model listing.", category: "Terminal Plugin", gate: "anthropic-credential", transport: "proxy" },
+    { method: "POST", path: "/v1/messages", summary: "Proxy an Anthropic Messages request through the AI Gateway.", category: "Terminal Plugin", gate: "anthropic-credential", transport: "proxy" }
+  ]);
 }
 
 // ../fleet-plugins/terminal/server/global.ts
@@ -47663,7 +47690,7 @@ function registerGlobalShellRoutes(ctx, runtime) {
       ...role ? { role } : {}
     }));
     return true;
-  });
+  }, { method: "POST", path: "", summary: "Issue a Global Shell WebSocket ticket.", category: "Terminal Plugin", gate: "origin-strict", transport: "http" });
 }
 
 // ../fleet-plugins/terminal/server/model-auth-state.ts
@@ -47699,7 +47726,11 @@ function registerTerminalModelAuthRoutes(ctx, deps) {
   registerRouter(ctx, "model-auth", createTerminalModelAuthRouter(ctx, {
     ...deps,
     validateApiKey: (provider, apiKey) => MODEL_AUTH_VALIDATORS[provider](apiKey)
-  }));
+  }), [
+    { method: "GET", path: "/state", summary: "Read Terminal model provider authentication state.", category: "Terminal Plugin", gate: "loopback", transport: "http" },
+    { method: "PUT", path: "/providers/:providerId", summary: "Save Terminal model provider credentials.", category: "Terminal Plugin", gate: "origin-write", transport: "http" },
+    { method: "DELETE", path: "/providers/:providerId", summary: "Remove Terminal model provider credentials.", category: "Terminal Plugin", gate: "origin-write", transport: "http" }
+  ]);
 }
 function createTerminalModelAuthRouter(ctx, deps) {
   return async function handleTerminalModelAuthRoute({ req, res, pathname }) {
@@ -47864,7 +47895,7 @@ function registerShellRoutes(ctx, runtime) {
       ...role ? { role } : {}
     }));
     return true;
-  });
+  }, { method: "POST", path: "", summary: "Issue a Shell WebSocket ticket.", category: "Terminal Plugin", gate: "origin-write", transport: "http" });
   registerRouter(ctx, "shell/sessions", ({ req, res, pathname }) => {
     const suffix = pathname.slice(`${ctx.basePath}/shell/sessions/`.length);
     const match = suffix.match(/^([^/]+)(?:\/(relaunch))?$/);
@@ -47901,7 +47932,10 @@ function registerShellRoutes(ctx, runtime) {
     ctx.host.operations.delete(operationId);
     ctx.host.http.writeJson(res, 200, { ok: true });
     return true;
-  });
+  }, [
+    { method: "DELETE", path: "/:operationId", summary: "Terminate a Shell session.", category: "Terminal Plugin", gate: "origin-write", transport: "http" },
+    { method: "POST", path: "/:operationId/relaunch", summary: "Relaunch a dormant Shell session.", category: "Terminal Plugin", gate: "origin-write", transport: "http" }
+  ]);
 }
 function isRestoredShellEvent(value, pluginId) {
   if (!value || typeof value !== "object") return false;
@@ -47943,7 +47977,7 @@ var routes_default = definePlugin({
     ctx.host.operations.registerPayloadSanitizer(ctx.pluginId, TERMINAL_SENSITIVE_FIELDS);
     const infraServices = createInfraServices();
     const runtime = createTerminalRuntime(ctx);
-    registerWsHandler(ctx, "/", runtime.handleUpgrade);
+    registerWsHandler(ctx, "/", runtime.handleUpgrade, { method: "GET", path: "", summary: "Open the Terminal WebSocket transport.", category: "Terminal Plugin", gate: "one-use-ticket", transport: "websocket" });
     ctx.host.lifecycle.registerCleanup(() => runtime.stop());
     const unsubscribeDelete = ctx.host.events.subscribe(OPERATION_DELETED_EVENT_CHANNEL2, (payload) => {
       if (!isOperationDeletedEvent2(payload) || payload.pluginId !== ctx.pluginId) return;