@skj1724/oh-my-opencode 3.17.13 → 3.18.1

package/dist/cli/index.js

@@ -6048,22 +6048,31 @@ function detectConfigFile(basePath) {
   return { format: "none", path: jsonPath };
 }
 function detectPluginConfigFile(dir) {
+  const cachedResult = pluginConfigFileDetectionCache.get(dir);
+  if (cachedResult !== undefined) {
+    return cachedResult;
+  }
   const canonicalResult = detectConfigFile(join4(dir, CONFIG_BASENAME));
   const legacyResult = detectConfigFile(join4(dir, LEGACY_CONFIG_BASENAME));
+  let detectionResult;
   if (canonicalResult.format !== "none") {
-    return {
+    detectionResult = {
       ...canonicalResult,
       legacyPath: legacyResult.format !== "none" ? legacyResult.path : undefined
     };
+  } else if (legacyResult.format !== "none") {
+    detectionResult = legacyResult;
+  } else {
+    detectionResult = { format: "none", path: join4(dir, `${CONFIG_BASENAME}.json`) };
   }
-  if (legacyResult.format !== "none") {
-    return legacyResult;
-  }
-  return { format: "none", path: join4(dir, `${CONFIG_BASENAME}.json`) };
+  pluginConfigFileDetectionCache.set(dir, detectionResult);
+  return detectionResult;
 }
+var pluginConfigFileDetectionCache;
 var init_jsonc_parser = __esm(() => {
   init_main();
   init_plugin_identity();
+  pluginConfigFileDetectionCache = new Map;
 });
 
 // src/shared/migration/agent-names.ts
@@ -6086,30 +6095,24 @@ var init_agent_names = __esm(() => {
     OmO: "sisyphus",
     Sisyphus: "sisyphus",
     "Sisyphus (Ultraworker)": "sisyphus",
-    "Sisyphus - \u8D85\u7EA7Agent": "sisyphus",
     sisyphus: "sisyphus",
     "Hephaestus (Deep Agent)": "hephaestus",
-    "Hephaestus - \u6DF1\u5EA6Agent": "hephaestus",
     "OmO-Plan": "prometheus",
     "omo-plan": "prometheus",
     "Planner-Sisyphus": "prometheus",
     "planner-sisyphus": "prometheus",
     "Prometheus - Plan Builder": "prometheus",
-    "Prometheus - \u8BA1\u5212\u6784\u5EFA": "prometheus",
     "Prometheus (Plan Builder)": "prometheus",
     prometheus: "prometheus",
     "orchestrator-sisyphus": "atlas",
     Atlas: "atlas",
     "Atlas (Plan Executor)": "atlas",
-    "Atlas - \u8BA1\u5212\u6267\u884C": "atlas",
     atlas: "atlas",
     "plan-consultant": "metis",
     "Metis - Plan Consultant": "metis",
-    "Metis - \u8BA1\u5212\u987E\u95EE": "metis",
     "Metis (Plan Consultant)": "metis",
     metis: "metis",
     "Momus - Plan Critic": "momus",
-    "Momus - \u8BA1\u5212\u8BC4\u5BA1": "momus",
     "Momus (Plan Critic)": "momus",
     momus: "momus",
     "Sisyphus-Junior": "sisyphus-junior",
@@ -6630,8 +6633,10 @@ var init_opencode_storage_detection = __esm(() => {
   cachedResult = NOT_CACHED2;
 });
 // src/shared/load-opencode-plugins.ts
+var opencodePluginsCache;
 var init_load_opencode_plugins = __esm(() => {
   init_jsonc_parser();
+  opencodePluginsCache = new Map;
 });
 
 // src/shared/external-plugin-detector.ts
@@ -6731,15 +6736,15 @@ function getAgentConfigKey(agentName) {
 var AGENT_DISPLAY_NAMES, AGENT_LIST_SORT_PREFIXES, INVISIBLE_AGENT_CHARACTERS_REGEX, REVERSE_DISPLAY_NAMES, LEGACY_DISPLAY_NAMES;
 var init_agent_display_names = __esm(() => {
   AGENT_DISPLAY_NAMES = {
-    sisyphus: "Sisyphus - \u8D85\u7EA7Agent",
-    hephaestus: "Hephaestus - \u6DF1\u5EA6Agent",
-    prometheus: "Prometheus - \u8BA1\u5212\u6784\u5EFA",
-    atlas: "Atlas - \u8BA1\u5212\u6267\u884C",
+    sisyphus: "Sisyphus - Ultraworker",
+    hephaestus: "Hephaestus - Deep Agent",
+    prometheus: "Prometheus - Plan Builder",
+    atlas: "Atlas - Plan Executor",
     "sisyphus-junior": "Sisyphus-Junior",
-    metis: "Metis - \u8BA1\u5212\u987E\u95EE",
-    momus: "Momus - \u8BA1\u5212\u8BC4\u5BA1",
-    athena: "Athena - \u59D4\u5458\u4F1A",
-    "athena-junior": "Athena-Junior - \u59D4\u5458\u4F1A",
+    metis: "Metis - Plan Consultant",
+    momus: "Momus - Plan Critic",
+    athena: "Athena - Council",
+    "athena-junior": "Athena-Junior - Council",
     oracle: "oracle",
     librarian: "librarian",
     explore: "explore",
@@ -6747,10 +6752,10 @@ var init_agent_display_names = __esm(() => {
     "council-member": "council-member"
   };
   AGENT_LIST_SORT_PREFIXES = {
-    sisyphus: "",
-    hephaestus: "",
-    prometheus: "",
-    atlas: ""
+    sisyphus: "\u200B",
+    hephaestus: "\u200B\u200B",
+    prometheus: "\u200B\u200B\u200B",
+    atlas: "\u200B\u200B\u200B\u200B"
   };
   INVISIBLE_AGENT_CHARACTERS_REGEX = /[\u200B\u200C\u200D\uFEFF]/g;
   REVERSE_DISPLAY_NAMES = Object.fromEntries(Object.entries(AGENT_DISPLAY_NAMES).map(([key, displayName]) => [displayName.toLowerCase(), key]));
@@ -50563,12 +50568,6 @@ var init_pane_spawn = __esm(() => {
   init_tmux_path_resolver();
   init_server_health();
 });
-
-// src/shared/tmux/tmux-utils/pane-close.ts
-var init_pane_close = __esm(() => {
-  init_tmux_path_resolver();
-});
-
 // src/shared/tmux/tmux-utils/pane-replace.ts
 var init_pane_replace = __esm(() => {
   init_tmux_path_resolver();
@@ -50585,6 +50584,8 @@ var init_session_spawn = __esm(() => {
   init_tmux_path_resolver();
   init_server_health();
 });
+// src/shared/tmux/tmux-utils/stale-session-sweep.ts
+var init_stale_session_sweep = () => {};
 
 // src/shared/tmux/tmux-utils/layout.ts
 var init_layout = __esm(() => {
@@ -50596,10 +50597,10 @@ var init_tmux_utils = __esm(() => {
   init_server_health();
   init_pane_dimensions();
   init_pane_spawn();
-  init_pane_close();
   init_pane_replace();
   init_window_spawn();
   init_session_spawn();
+  init_stale_session_sweep();
   init_layout();
 });
 
@@ -50614,6 +50615,139 @@ var init_model_suggestion_retry = __esm(() => {
 });
 
 // src/shared/opencode-server-auth.ts
+function getServerBasicAuthHeader() {
+  const password = process.env.OPENCODE_SERVER_PASSWORD;
+  if (!password) {
+    return;
+  }
+  const username = process.env.OPENCODE_SERVER_USERNAME ?? "opencode";
+  const token = Buffer.from(`${username}:${password}`, "utf8").toString("base64");
+  return `Basic ${token}`;
+}
+function isRecord4(value) {
+  return typeof value === "object" && value !== null;
+}
+function isRequestFetch(value) {
+  return typeof value === "function";
+}
+function wrapRequestFetch(baseFetch, auth) {
+  return async (request) => {
+    const headers = new Headers(request.headers);
+    headers.set("Authorization", auth);
+    return baseFetch(new Request(request, { headers }));
+  };
+}
+function getInternalClient(client) {
+  if (!isRecord4(client)) {
+    return null;
+  }
+  const internal = client["_client"];
+  return isRecord4(internal) ? internal : null;
+}
+function tryInjectViaSetConfigHeaders(internal, auth) {
+  const setConfig = internal["setConfig"];
+  if (typeof setConfig !== "function") {
+    return false;
+  }
+  setConfig({
+    headers: {
+      Authorization: auth
+    }
+  });
+  return true;
+}
+function tryInjectViaInterceptors(internal, auth) {
+  const interceptors = internal["interceptors"];
+  if (!isRecord4(interceptors)) {
+    return false;
+  }
+  const requestInterceptors = interceptors["request"];
+  if (!isRecord4(requestInterceptors)) {
+    return false;
+  }
+  const use = requestInterceptors["use"];
+  if (typeof use !== "function") {
+    return false;
+  }
+  use.call(requestInterceptors, (request) => {
+    if (!request.headers.get("Authorization")) {
+      request.headers.set("Authorization", auth);
+    }
+    return request;
+  });
+  return true;
+}
+function tryInjectViaFetchWrapper(internal, auth) {
+  const getConfig = internal["getConfig"];
+  const setConfig = internal["setConfig"];
+  if (typeof getConfig !== "function" || typeof setConfig !== "function") {
+    return false;
+  }
+  const config = getConfig();
+  if (!isRecord4(config)) {
+    return false;
+  }
+  const fetchValue = config["fetch"];
+  if (!isRequestFetch(fetchValue)) {
+    return false;
+  }
+  setConfig({
+    fetch: wrapRequestFetch(fetchValue, auth)
+  });
+  return true;
+}
+function tryInjectViaMutableInternalConfig(internal, auth) {
+  const configValue = internal["_config"];
+  if (!isRecord4(configValue)) {
+    return false;
+  }
+  const fetchValue = configValue["fetch"];
+  if (!isRequestFetch(fetchValue)) {
+    return false;
+  }
+  configValue["fetch"] = wrapRequestFetch(fetchValue, auth);
+  return true;
+}
+function tryInjectViaTopLevelFetch(client, auth) {
+  if (!isRecord4(client)) {
+    return false;
+  }
+  const fetchValue = client["fetch"];
+  if (!isRequestFetch(fetchValue)) {
+    return false;
+  }
+  client["fetch"] = wrapRequestFetch(fetchValue, auth);
+  return true;
+}
+function injectServerAuthIntoClient(client) {
+  const auth = getServerBasicAuthHeader();
+  if (!auth) {
+    return;
+  }
+  try {
+    const internal = getInternalClient(client);
+    if (internal) {
+      const injectedHeaders = tryInjectViaSetConfigHeaders(internal, auth);
+      const injectedInterceptors = tryInjectViaInterceptors(internal, auth);
+      const injectedFetch = tryInjectViaFetchWrapper(internal, auth);
+      const injectedMutable = tryInjectViaMutableInternalConfig(internal, auth);
+      const injected2 = injectedHeaders || injectedInterceptors || injectedFetch || injectedMutable;
+      if (!injected2) {
+        log("[opencode-server-auth] OPENCODE_SERVER_PASSWORD is set but SDK client structure is incompatible", {
+          keys: Object.keys(internal)
+        });
+      }
+      return;
+    }
+    const injected = tryInjectViaTopLevelFetch(client, auth);
+    if (!injected) {
+      log("[opencode-server-auth] OPENCODE_SERVER_PASSWORD is set but no compatible SDK client found");
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    log("[opencode-server-auth] Failed to inject server auth", { message });
+  }
+}
 var init_opencode_server_auth = __esm(() => {
   init_logger();
 });
@@ -50683,7 +50817,10 @@ var init_opencode_command_dirs = __esm(() => {
 });
 
 // src/shared/project-discovery-dirs.ts
-var init_project_discovery_dirs = () => {};
+var worktreePathCache;
+var init_project_discovery_dirs = __esm(() => {
+  worktreePathCache = new Map;
+});
 
 // src/shared/session-directory-resolver.ts
 var init_session_directory_resolver = () => {};
@@ -50867,12 +51004,35 @@ var init_model_string_parser = __esm(() => {
   ]);
 });
 
+// src/shared/excluded-dirs.ts
+var EXCLUDED_DIR_NAMES, EXCLUDED_DIRS;
+var init_excluded_dirs = __esm(() => {
+  EXCLUDED_DIR_NAMES = [
+    "node_modules",
+    ".git",
+    "dist",
+    "build",
+    ".next",
+    ".sisyphus",
+    ".omx",
+    ".turbo",
+    "coverage",
+    "out",
+    ".cache",
+    ".vscode-test",
+    "target",
+    ".local-ignore"
+  ];
+  EXCLUDED_DIRS = Object.freeze(new Set(EXCLUDED_DIR_NAMES));
+});
+
 // src/shared/index.ts
 var init_shared = __esm(() => {
   init_model_resolver();
   init_model_resolution_pipeline();
   init_session_category_registry();
   init_model_string_parser();
+  init_excluded_dirs();
   init_frontmatter();
   init_command_executor();
   init_contains_path();
@@ -53315,6 +53475,12 @@ var init_background_update_check = __esm(() => {
   runBackgroundUpdateCheck = createBackgroundUpdateCheckRunner();
 });
 
+// src/hooks/auto-update-checker/hook/deferred-startup-check.ts
+function scheduleDeferredStartupCheck(runCheck) {
+  const timeout = setTimeout(runCheck, 5000);
+  timeout.unref?.();
+}
+
 // src/hooks/auto-update-checker/hook/config-errors-toast.ts
 async function showConfigErrorsIfAny(ctx) {
   const errors3 = getConfigLoadErrors();
@@ -53494,44 +53660,57 @@ v${latestVersion} available. Restart to apply.` : "Sisyphus on steroids is steer
 v${latestVersion} available. Restart OpenCode to apply.` : "OpenCode is now on Steroids. oMoMoMoMo...";
   };
   let hasChecked = false;
+  let hasScheduled = false;
   return {
     event: ({ event }) => {
       if (event.type !== "session.created")
         return;
       if (isCliRunMode)
         return;
-      if (hasChecked)
+      if (hasChecked || hasScheduled)
         return;
-      const props = event.properties;
-      if (props?.info?.parentID)
+      if (getParentID(event.properties))
         return;
-      hasChecked = true;
-      setTimeout(async () => {
-        const cachedVersion2 = deps.getCachedVersion();
-        const localDevVersion = deps.getLocalDevVersion(ctx.directory);
-        const displayVersion = localDevVersion ?? cachedVersion2;
-        await deps.showConfigErrorsIfAny(ctx);
-        await deps.updateAndShowConnectedProvidersCacheStatus(ctx);
-        await deps.refreshModelCapabilitiesOnStartup(modelCapabilities);
-        await deps.showModelCacheWarningIfNeeded(ctx);
-        if (localDevVersion) {
+      hasScheduled = true;
+      scheduleDeferredStartupCheck(() => {
+        hasChecked = true;
+        (async () => {
+          const cachedVersion2 = deps.getCachedVersion();
+          const localDevVersion = deps.getLocalDevVersion(ctx.directory);
+          const displayVersion = localDevVersion ?? cachedVersion2;
+          await deps.showConfigErrorsIfAny(ctx);
+          await deps.updateAndShowConnectedProvidersCacheStatus(ctx);
+          await deps.refreshModelCapabilitiesOnStartup(modelCapabilities);
+          await deps.showModelCacheWarningIfNeeded(ctx);
+          if (localDevVersion) {
+            if (showStartupToast) {
+              deps.showLocalDevToast(ctx, displayVersion, isSisyphusEnabled).catch(() => {});
+            }
+            deps.log("[auto-update-checker] Local development mode");
+            return;
+          }
           if (showStartupToast) {
-            deps.showLocalDevToast(ctx, displayVersion, isSisyphusEnabled).catch(() => {});
+            deps.showVersionToast(ctx, displayVersion, getToastMessage(false)).catch(() => {});
           }
-          deps.log("[auto-update-checker] Local development mode");
-          return;
-        }
-        if (showStartupToast) {
-          deps.showVersionToast(ctx, displayVersion, getToastMessage(false)).catch(() => {});
-        }
-        deps.runBackgroundUpdateCheck(ctx, autoUpdate, getToastMessage).catch((err) => {
-          deps.log("[auto-update-checker] Background update check failed:", err);
-        });
-      }, 0);
+          deps.runBackgroundUpdateCheck(ctx, autoUpdate, getToastMessage).catch((err) => {
+            deps.log("[auto-update-checker] Background update check failed:", err);
+          });
+        })();
+      });
     }
   };
 }
-var defaultDeps2;
+var defaultDeps2, isRecord6 = (value) => {
+  return typeof value === "object" && value !== null;
+}, getParentID = (properties) => {
+  if (!isRecord6(properties))
+    return;
+  const { info } = properties;
+  if (!isRecord6(info))
+    return;
+  const { parentID } = info;
+  return typeof parentID === "string" && parentID.length > 0 ? parentID : undefined;
+};
 var init_hook = __esm(() => {
   init_logger();
   init_checker();
@@ -53591,7 +53770,7 @@ var {
 // package.json
 var package_default = {
   name: "@skj1724/oh-my-opencode",
-  version: "3.17.13",
+  version: "3.18.1",
   description: "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
   main: "./dist/index.js",
   types: "dist/index.d.ts",
@@ -53660,7 +53839,7 @@ var package_default = {
     "jsonc-parser": "^3.3.1",
     picocolors: "^1.1.1",
     picomatch: "^4.0.2",
-    "posthog-node": "^5.29.2",
+    "posthog-node": "5.28.11",
     "vscode-jsonrpc": "^8.2.0"
   },
   devDependencies: {
@@ -54238,7 +54417,6 @@ var types_PostHogPersistedProperty = /* @__PURE__ */ function(PostHogPersistedPr
   PostHogPersistedProperty["Surveys"] = "surveys";
   PostHogPersistedProperty["RemoteConfig"] = "remote_config";
   PostHogPersistedProperty["FlagsEndpointWasHit"] = "flags_endpoint_was_hit";
-  PostHogPersistedProperty["DeviceId"] = "device_id";
   return PostHogPersistedProperty;
 }({});
 
@@ -55076,8 +55254,6 @@ class PostHogCoreStateless {
       group_properties: groupProperties,
       ...extraPayload
     };
-    if (personProperties.$device_id)
-      requestData.$device_id = personProperties.$device_id;
     if (this.evaluationContexts && this.evaluationContexts.length > 0)
       requestData.evaluation_contexts = this.evaluationContexts;
     const fetchOptions = {
@@ -56529,7 +56705,7 @@ class ErrorTracking {
 }
 
 // node_modules/posthog-node/dist/version.mjs
-var version = "5.29.2";
+var version = "5.28.11";
 
 // node_modules/posthog-node/dist/types.mjs
 var FeatureFlagError2 = {
@@ -74191,6 +74367,11 @@ var WebsearchConfigSchema = exports_external.object({
   provider: WebsearchProviderSchema.optional()
 });
 
+// src/config/schema/i18n.ts
+var I18nConfigSchema = exports_external.object({
+  language: exports_external.string().min(1).optional()
+});
+
 // src/config/schema/oh-my-opencode-config.ts
 var OhMyOpenCodeConfigSchema = exports_external.object({
   $schema: exports_external.string().optional(),
@@ -74231,6 +74412,7 @@ var OhMyOpenCodeConfigSchema = exports_external.object({
   tmux: TmuxConfigSchema.optional(),
   sisyphus: SisyphusConfigSchema.optional(),
   start_work: StartWorkConfigSchema.optional(),
+  i18n: I18nConfigSchema.optional(),
   _migrations: exports_external.array(exports_external.string()).optional()
 });
 // src/plugin-config.ts
@@ -75968,6 +76150,7 @@ async function createOpencode(options) {
 }
 
 // src/cli/run/server-connection.ts
+init_opencode_server_auth();
 init_port_utils();
 var import_picocolors10 = __toESM(require_picocolors(), 1);
 
@@ -76042,6 +76225,15 @@ async function withWorkingOpencodePath(startServer, finder = findWorkingOpencode
 }
 
 // src/cli/run/server-connection.ts
+var LOOPBACK_HOSTS = new Set(["127.0.0.1", "localhost", "::1", "[::1]", "0.0.0.0"]);
+function isLoopbackAttachUrl(url2) {
+  try {
+    const parsed = new URL(url2);
+    return LOOPBACK_HOSTS.has(parsed.hostname);
+  } catch {
+    return false;
+  }
+}
 function isPortStartFailure(error48, port) {
   if (!(error48 instanceof Error)) {
     return false;
@@ -76065,6 +76257,9 @@ async function createServerConnection(options) {
   if (attach !== undefined) {
     console.log(import_picocolors10.default.dim("Attaching to existing server at"), import_picocolors10.default.cyan(attach));
     const client3 = createOpencodeClient({ baseUrl: attach });
+    if (isLoopbackAttachUrl(attach)) {
+      injectServerAuthIntoClient(client3);
+    }
     return { client: client3, cleanup: () => {} };
   }
   if (port !== undefined) {
@@ -76086,11 +76281,13 @@ async function createServerConnection(options) {
         }
         console.log(import_picocolors10.default.dim("Port"), import_picocolors10.default.cyan(port.toString()), import_picocolors10.default.dim("became occupied, attaching to existing server"));
         const client4 = createOpencodeClient({ baseUrl: `http://127.0.0.1:${port}` });
+        injectServerAuthIntoClient(client4);
         return { client: client4, cleanup: () => {} };
       }
     }
     console.log(import_picocolors10.default.dim("Port"), import_picocolors10.default.cyan(port.toString()), import_picocolors10.default.dim("is occupied, attaching to existing server"));
     const client3 = createOpencodeClient({ baseUrl: `http://127.0.0.1:${port}` });
+    injectServerAuthIntoClient(client3);
     return { client: client3, cleanup: () => {} };
   }
   let selectedPort;
@@ -76109,6 +76306,7 @@ async function createServerConnection(options) {
     }
     console.log(import_picocolors10.default.dim("Port range exhausted, attaching to existing server on"), import_picocolors10.default.cyan(DEFAULT_SERVER_PORT.toString()));
     const client3 = createOpencodeClient({ baseUrl: `http://127.0.0.1:${DEFAULT_SERVER_PORT}` });
+    injectServerAuthIntoClient(client3);
     return { client: client3, cleanup: () => {} };
   }
   if (wasAutoSelected) {
@@ -79556,7 +79754,7 @@ async function getOrRegisterClient(options) {
   }
 }
 function parseRegistrationResponse(data) {
-  if (!isRecord5(data))
+  if (!isRecord7(data))
     return null;
   const clientId = data.client_id;
   if (typeof clientId !== "string" || clientId.length === 0)
@@ -79567,7 +79765,7 @@ function parseRegistrationResponse(data) {
   }
   return { clientId };
 }
-function isRecord5(value) {
+function isRecord7(value) {
   return typeof value === "object" && value !== null;
 }
 

package/dist/config/schema/i18n.d.ts

@@ -0,0 +1,21 @@
+import { z } from "zod";
+/**
+ * Internationalization configuration for agent interaction language.
+ *
+ * Controls the language used for agent prompts and thinking output guidance.
+ * When set, agents will be instructed to respond in the specified language.
+ *
+ * Supported values: IETF BCP 47 format (e.g., "zh-CN", "en-US", "ja-JP", "ko-KR")
+ *
+ * @example
+ * // In ~/.config/opencode/oh-my-opencode.jsonc
+ * {
+ *   "i18n": {
+ *     "language": "zh-CN"
+ *   }
+ * }
+ */
+export declare const I18nConfigSchema: z.ZodObject<{
+    language: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type I18nConfig = z.infer<typeof I18nConfigSchema>;

package/dist/config/schema/oh-my-opencode-config.d.ts

@@ -2106,6 +2106,9 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
     start_work: z.ZodOptional<z.ZodObject<{
         auto_commit: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
+    i18n: z.ZodOptional<z.ZodObject<{
+        language: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
     _migrations: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type OhMyOpenCodeConfig = z.infer<typeof OhMyOpenCodeConfigSchema>;

package/dist/features/builtin-commands/templates/handoff.d.ts

@@ -1 +1 @@
-export declare const HANDOFF_TEMPLATE = "# Handoff \u547D\u4EE4\n\n## \u76EE\u7684\n\n\u5728\u4EE5\u4E0B\u60C5\u51B5\u4F7F\u7528 /handoff\uFF1A\n- \u5F53\u524D\u4F1A\u8BDD\u4E0A\u4E0B\u6587\u53D8\u5F97\u8FC7\u957F\uFF0C\u8D28\u91CF\u6B63\u5728\u4E0B\u964D\n- \u4F60\u60F3\u91CD\u65B0\u5F00\u59CB\u540C\u65F6\u4FDD\u7559\u6B64\u4F1A\u8BDD\u7684\u57FA\u672C\u4E0A\u4E0B\u6587\n- \u4E0A\u4E0B\u6587\u7A97\u53E3\u63A5\u8FD1\u5BB9\u91CF\n\n\u8FD9\u4F1A\u521B\u5EFA\u4E00\u4E2A\u8BE6\u7EC6\u7684\u4E0A\u4E0B\u6587\u6458\u8981\uFF0C\u53EF\u7528\u4E8E\u5728\u65B0\u4F1A\u8BDD\u4E2D\u7EE7\u7EED\u5DE5\u4F5C\u3002\n\n---\n\n# PHASE 0: \u9A8C\u8BC1\u8BF7\u6C42\n\n\u5728\u7EE7\u7EED\u4E4B\u524D\uFF0C\u786E\u8BA4\uFF1A\n- [ ] \u6B64\u4F1A\u8BDD\u4E2D\u6709\u9700\u8981\u4FDD\u7559\u7684\u6709\u610F\u4E49\u7684\u5DE5\u4F5C\u6216\u4E0A\u4E0B\u6587\n- [ ] \u7528\u6237\u60F3\u8981\u521B\u5EFA handoff \u6458\u8981\uFF08\u4E0D\u4EC5\u4EC5\u662F\u8BE2\u95EE\uFF09\n\n\u5982\u679C\u4F1A\u8BDD\u51E0\u4E4E\u4E3A\u7A7A\u6216\u6CA1\u6709\u6709\u610F\u4E49\u7684\u4E0A\u4E0B\u6587\uFF0C\u8BF7\u544A\u77E5\u7528\u6237\u6CA1\u6709\u5B9E\u8D28\u6027\u5185\u5BB9\u53EF\u4EE5\u4EA4\u63A5\u3002\n\n---\n\n# PHASE 1: \u6536\u96C6\u7A0B\u5E8F\u5316\u4E0A\u4E0B\u6587\n\n\u6267\u884C\u8FD9\u4E9B\u5DE5\u5177\u4EE5\u6536\u96C6\u5177\u4F53\u6570\u636E\uFF1A\n\n1. session_read({ session_id: \"$SESSION_ID\" }) - \u5B8C\u6574\u4F1A\u8BDD\u5386\u53F2\n2. todoread() - \u5F53\u524D\u4EFB\u52A1\u8FDB\u5EA6\n3. Bash({ command: \"git diff --stat HEAD~10..HEAD\" }) - \u8FD1\u671F\u6587\u4EF6\u53D8\u66F4\n4. Bash({ command: \"git status --porcelain\" }) - \u672A\u63D0\u4EA4\u7684\u53D8\u66F4\n\n\u5EFA\u8BAE\u6267\u884C\u987A\u5E8F\uFF1A\n\n```\nsession_read({ session_id: \"$SESSION_ID\" })\ntodoread()\nBash({ command: \"git diff --stat HEAD~10..HEAD\" })\nBash({ command: \"git status --porcelain\" })\n```\n\n\u5206\u6790\u6536\u96C6\u5230\u7684\u8F93\u51FA\u4EE5\u7406\u89E3\uFF1A\n- \u7528\u6237\u8981\u6C42\u4E86\u4EC0\u4E48\uFF08\u786E\u5207\u63AA\u8F9E\uFF09\n- \u5B8C\u6210\u4E86\u4EC0\u4E48\u5DE5\u4F5C\n- \u54EA\u4E9B\u4EFB\u52A1\u4ECD\u672A\u5B8C\u6210\uFF08\u5305\u542B todo \u72B6\u6001\uFF09\n- \u505A\u4E86\u54EA\u4E9B\u51B3\u5B9A\n- \u4FEE\u6539\u6216\u8BA8\u8BBA\u4E86\u54EA\u4E9B\u6587\u4EF6\uFF08\u5305\u542B git diff/stat + status\uFF09\n- \u5EFA\u7ACB\u4E86\u54EA\u4E9B\u6A21\u5F0F\u3001\u7EA6\u675F\u6216\u504F\u597D\n\n---\n\n# PHASE 2: \u63D0\u53D6\u4E0A\u4E0B\u6587\n\n\u4EE5\u7B2C\u4E00\u4EBA\u79F0\u89C6\u89D2\u64B0\u5199\u4E0A\u4E0B\u6587\u6458\u8981\uFF08\"\u6211\u505A\u4E86...\"\uFF0C\"\u6211\u544A\u8BC9\u4F60\u4E86...\"\uFF09\u3002\n\n\u5173\u6CE8\uFF1A\n- \u80FD\u529B\u548C\u884C\u4E3A\uFF0C\u800C\u975E\u9010\u6587\u4EF6\u7684\u5B9E\u73B0\u7EC6\u8282\n- \u5BF9\u7EE7\u7EED\u5DE5\u4F5C\u91CD\u8981\u7684\u4E8B\u9879\n- \u907F\u514D\u8FC7\u591A\u7684\u5B9E\u73B0\u7EC6\u8282\uFF08\u53D8\u91CF\u540D\u3001\u5B58\u50A8\u952E\u3001\u5E38\u91CF\uFF09\uFF0C\u9664\u975E\u5173\u952E\n- \u7528\u6237\u8BF7\u6C42\u5FC5\u987B\u9010\u5B57\u4FDD\u7559\uFF08\u4E0D\u8981\u6539\u8FF0\uFF09\n- \u660E\u786E\u7EA6\u675F\u5FC5\u987B\u9010\u5B57\u4FDD\u7559\uFF08\u4E0D\u8981\u7F16\u9020\uFF09\n\n\u63D0\u53D6\u65F6\u8003\u8651\u7684\u95EE\u9898\uFF1A\n- \u6211\u521A\u521A\u505A\u4E86\u4EC0\u4E48\u6216\u5B9E\u73B0\u4E86\u4EC0\u4E48\uFF1F\n- \u6211\u5DF2\u7ECF\u7ED9\u51FA\u4E86\u54EA\u4E9B\u4ECD\u7136\u76F8\u5173\u7684\u6307\u793A\uFF08\u4F8B\u5982\uFF1A\u9075\u5FAA\u4EE3\u7801\u5E93\u4E2D\u7684\u6A21\u5F0F\uFF09\uFF1F\n- \u6211\u544A\u8BC9\u8FC7\u4F60\u54EA\u4E9B\u91CD\u8981\u6587\u4EF6\u6216\u6211\u6B63\u5728\u5904\u7406\u7684\u6587\u4EF6\uFF1F\n- \u6211\u662F\u5426\u63D0\u4F9B\u4E86\u5E94\u8BE5\u5305\u542B\u7684\u8BA1\u5212\u6216\u89C4\u683C\uFF1F\n- \u6211\u5DF2\u7ECF\u544A\u8BC9\u4F60\u7684\u54EA\u4E9B\u91CD\u8981\u5185\u5BB9\uFF08\u5E93\u3001\u6A21\u5F0F\u3001\u7EA6\u675F\u3001\u504F\u597D\uFF09\uFF1F\n- \u6211\u53D1\u73B0\u4E86\u54EA\u4E9B\u91CD\u8981\u7684\u6280\u672F\u7EC6\u8282\uFF08API\u3001\u65B9\u6CD5\u3001\u6A21\u5F0F\uFF09\uFF1F\n- \u6211\u53D1\u73B0\u4E86\u54EA\u4E9B\u6CE8\u610F\u4E8B\u9879\u3001\u9650\u5236\u6216\u672A\u89E3\u51B3\u7684\u95EE\u9898\uFF1F\n\n---\n\n# PHASE 3: \u683C\u5F0F\u5316\u8F93\u51FA\n\n\u4F7F\u7528\u6B64\u786E\u5207\u683C\u5F0F\u751F\u6210 handoff \u6458\u8981\uFF1A\n\n```\nHANDOFF CONTEXT\n===============\n\nUSER REQUESTS (AS-IS)\n---------------------\n- [\u786E\u5207\u9010\u5B57\u7684\u7528\u6237\u8BF7\u6C42 - \u4E0D\u8981\u6539\u8FF0]\n\nGOAL\n----\n[\u4E00\u53E5\u8BDD\u63CF\u8FF0\u4E0B\u4E00\u6B65\u5E94\u8BE5\u505A\u4EC0\u4E48]\n\nWORK COMPLETED\n--------------\n- [\u5DF2\u5B8C\u6210\u5DE5\u4F5C\u7684\u7B2C\u4E00\u4EBA\u79F0\u8981\u70B9]\n- [\u76F8\u5173\u65F6\u5305\u542B\u5177\u4F53\u6587\u4EF6\u8DEF\u5F84]\n- [\u8BB0\u5F55\u5173\u952E\u5B9E\u73B0\u51B3\u7B56]\n\nCURRENT STATE\n-------------\n- [\u4EE3\u7801\u5E93\u6216\u4EFB\u52A1\u7684\u5F53\u524D\u72B6\u6001]\n- [\u9002\u7528\u65F6\u7684\u6784\u5EFA/\u6D4B\u8BD5\u72B6\u6001]\n- [\u4EFB\u4F55\u73AF\u5883\u6216\u914D\u7F6E\u72B6\u6001]\n\nPENDING TASKS\n-------------\n- [\u5DF2\u8BA1\u5212\u4F46\u672A\u5B8C\u6210\u7684\u4EFB\u52A1]\n- [\u4E0B\u4E00\u6B65\u903B\u8F91\u6B65\u9AA4]\n- [\u9047\u5230\u7684\u4EFB\u4F55\u963B\u788D\u6216\u95EE\u9898]\n- [\u5305\u542B\u6765\u81EA todoread() \u7684\u5F53\u524D todo \u72B6\u6001]\n\nKEY FILES\n---------\n- [path/to/file1] - [\u7B80\u8981\u89D2\u8272\u63CF\u8FF0]\n- [path/to/file2] - [\u7B80\u8981\u89D2\u8272\u63CF\u8FF0]\n\uFF08\u6700\u591A 10 \u4E2A\u6587\u4EF6\uFF0C\u6309\u91CD\u8981\u6027\u6392\u5E8F\uFF09\n- \uFF08\u5305\u542B\u6765\u81EA git diff/stat \u548C git status \u7684\u6587\u4EF6\uFF09\n\nIMPORTANT DECISIONS\n-------------------\n- [\u505A\u51FA\u7684\u6280\u672F\u51B3\u7B56\u53CA\u539F\u56E0]\n- [\u8003\u8651\u7684\u6743\u8861]\n- [\u5EFA\u7ACB\u7684\u6A21\u5F0F\u6216\u7EA6\u5B9A]\n\nEXPLICIT CONSTRAINTS\n--------------------\n- [\u4EC5\u9010\u5B57\u7EA6\u675F - \u6765\u81EA\u7528\u6237\u6216\u73B0\u6709 AGENTS.md]\n- \u5982\u679C\u6CA1\u6709\uFF0C\u5199\uFF1ANone\n\nCONTEXT FOR CONTINUATION\n------------------------\n- [\u4E0B\u4E00\u4F1A\u8BDD\u9700\u8981\u77E5\u9053\u7684\u5185\u5BB9\u4EE5\u7EE7\u7EED\u5DE5\u4F5C]\n- [\u9700\u8981\u6CE8\u610F\u7684\u8B66\u544A\u6216\u9677\u9631]\n- [\u76F8\u5173\u6587\u6863\u7684\u53C2\u8003]\n```\n\n\u6458\u8981\u89C4\u5219\uFF1A\n- \u5E26\u9879\u76EE\u7B26\u53F7\u7684\u7EAF\u6587\u672C\n- \u4E0D\u4F7F\u7528 # markdown \u6807\u9898\uFF08\u4F7F\u7528\u4E0A\u9762\u7684\u5E26\u7834\u6298\u53F7\u7684\u683C\u5F0F\uFF09\n- \u5185\u5BB9\u4E2D\u4E0D\u4F7F\u7528\u7C97\u4F53\u3001\u659C\u4F53\u6216\u4EE3\u7801\u5757\n- \u4F7F\u7528\u76F8\u5BF9\u4E8E\u5DE5\u4F5C\u533A\u7684\u6587\u4EF6\u8DEF\u5F84\n- \u4FDD\u6301\u805A\u7126 - \u4EC5\u5305\u542B\u5BF9\u7EE7\u7EED\u5DE5\u4F5C\u91CD\u8981\u7684\u4E8B\u9879\n- \u6839\u636E\u590D\u6742\u5EA6\u9009\u62E9\u9002\u5F53\u957F\u5EA6\n- \u7528\u6237\u8BF7\u6C42\u5FC5\u987B\u9010\u5B57\u4FDD\u7559\n\n---\n\n# PHASE 4: \u63D0\u4F9B\u8BF4\u660E\n\n\u751F\u6210\u6458\u8981\u540E\uFF0C\u6307\u5BFC\u7528\u6237\uFF1A\n\n```\n---\n\nTO CONTINUE IN A NEW SESSION:\n\n1. \u5728 OpenCode TUI \u4E2D\u6309 'n' \u6253\u5F00\u65B0\u4F1A\u8BDD\uFF0C\u6216\u5728\u65B0\u7EC8\u7AEF\u4E2D\u8FD0\u884C 'opencode'\n2. \u5C06\u4E0A\u9762\u7684 HANDOFF CONTEXT \u4F5C\u4E3A\u7B2C\u4E00\u6761\u6D88\u606F\u7C98\u8D34\n3. \u6DFB\u52A0\u4F60\u7684\u8BF7\u6C42\uFF1A\"\u4ECE\u4E0A\u9762\u7684 handoff context \u7EE7\u7EED\u3002[\u4F60\u7684\u4E0B\u4E00\u4E2A\u4EFB\u52A1]\"\n\n\u65B0\u4F1A\u8BDD\u5C06\u62E5\u6709\u7EE7\u7EED\u5DE5\u4F5C\u6240\u9700\u7684\u6240\u6709\u4E0A\u4E0B\u6587\u3002\n```\n\n---\n\n# \u91CD\u8981\u7EA6\u675F\n\n- \u4E0D\u8981\u5C1D\u8BD5\u4EE5\u7F16\u7A0B\u65B9\u5F0F\u521B\u5EFA\u65B0\u4F1A\u8BDD\uFF08\u4EE3\u7406\u65E0\u6CD5\u4F7F\u7528 API\uFF09\n- \u63D0\u4F9B\u4E0D\u4F9D\u8D56\u6B64\u4F1A\u8BDD\u8BBF\u95EE\u7684\u72EC\u7ACB\u6458\u8981\n- \u5305\u542B\u76F8\u5BF9\u4E8E\u5DE5\u4F5C\u533A\u7684\u6587\u4EF6\u8DEF\u5F84\n- \u4E0D\u8981\u5305\u542B\u654F\u611F\u4FE1\u606F\uFF08API \u5BC6\u94A5\u3001\u51ED\u8BC1\u3001\u5BC6\u94A5\uFF09\n- KEY FILES \u90E8\u5206\u4E0D\u8D85\u8FC7 10 \u4E2A\u6587\u4EF6\n- \u5C06 GOAL \u90E8\u5206\u4FDD\u6301\u5728\u4E00\u53E5\u8BDD\u6216\u77ED\u6BB5\u843D\n\n---\n\n# \u7ACB\u5373\u6267\u884C\n\n\u9996\u5148\u6536\u96C6\u7A0B\u5E8F\u5316\u4E0A\u4E0B\u6587\uFF0C\u7136\u540E\u7EFC\u5408 handoff \u6458\u8981\u3002\n";
+export declare const HANDOFF_TEMPLATE = "# Handoff Command\n\n## Purpose\n\nUse /handoff when:\n- The current session context is getting too long and quality is degrading\n- You want to start fresh while preserving essential context from this session\n- The context window is approaching capacity\n\nThis creates a detailed context summary that can be used to continue work in a new session.\n\n---\n\n# PHASE 0: VALIDATE REQUEST\n\nBefore proceeding, confirm:\n- [ ] There is meaningful work or context in this session to preserve\n- [ ] The user wants to create a handoff summary (not just asking about it)\n\nIf the session is nearly empty or has no meaningful context, inform the user there is nothing substantial to hand off.\n\n---\n\n# PHASE 1: GATHER PROGRAMMATIC CONTEXT\n\nExecute these tools to gather concrete data:\n\n1. session_read({ session_id: \"$SESSION_ID\" }) - full session history\n2. todoread() - current task progress\n3. Bash({ command: \"git diff --stat HEAD~10..HEAD\" }) - recent file changes\n4. Bash({ command: \"git status --porcelain\" }) - uncommitted changes\n\nSuggested execution order:\n\n```\nsession_read({ session_id: \"$SESSION_ID\" })\ntodoread()\nBash({ command: \"git diff --stat HEAD~10..HEAD\" })\nBash({ command: \"git status --porcelain\" })\n```\n\nAnalyze the gathered outputs to understand:\n- What the user asked for (exact wording)\n- What work was completed\n- What tasks remain incomplete (include todo state)\n- What decisions were made\n- What files were modified or discussed (include git diff/stat + status)\n- What patterns, constraints, or preferences were established\n\n---\n\n# PHASE 2: EXTRACT CONTEXT\n\nWrite the context summary from first person perspective (\"I did...\", \"I told you...\").\n\nFocus on:\n- Capabilities and behavior, not file-by-file implementation details\n- What matters for continuing the work\n- Avoiding excessive implementation details (variable names, storage keys, constants) unless critical\n- USER REQUESTS (AS-IS) must be verbatim (do not paraphrase)\n- EXPLICIT CONSTRAINTS must be verbatim only (do not invent)\n\nQuestions to consider when extracting:\n- What did I just do or implement?\n- What instructions did I already give which are still relevant (e.g. follow patterns in the codebase)?\n- What files did I tell you are important or that I am working on?\n- Did I provide a plan or spec that should be included?\n- What did I already tell you that is important (libraries, patterns, constraints, preferences)?\n- What important technical details did I discover (APIs, methods, patterns)?\n- What caveats, limitations, or open questions did I find?\n\n---\n\n# PHASE 3: FORMAT OUTPUT\n\nGenerate a handoff summary using this exact format:\n\n```\nHANDOFF CONTEXT\n===============\n\nUSER REQUESTS (AS-IS)\n---------------------\n- [Exact verbatim user requests - NOT paraphrased]\n\nGOAL\n----\n[One sentence describing what should be done next]\n\nWORK COMPLETED\n--------------\n- [First person bullet points of what was done]\n- [Include specific file paths when relevant]\n- [Note key implementation decisions]\n\nCURRENT STATE\n-------------\n- [Current state of the codebase or task]\n- [Build/test status if applicable]\n- [Any environment or configuration state]\n\nPENDING TASKS\n-------------\n- [Tasks that were planned but not completed]\n- [Next logical steps to take]\n- [Any blockers or issues encountered]\n- [Include current todo state from todoread()]\n\nKEY FILES\n---------\n- [path/to/file1] - [brief role description]\n- [path/to/file2] - [brief role description]\n(Maximum 10 files, prioritized by importance)\n- (Include files from git diff/stat and git status)\n\nIMPORTANT DECISIONS\n-------------------\n- [Technical decisions that were made and why]\n- [Trade-offs that were considered]\n- [Patterns or conventions established]\n\nEXPLICIT CONSTRAINTS\n--------------------\n- [Verbatim constraints only - from user or existing AGENTS.md]\n- If none, write: None\n\nCONTEXT FOR CONTINUATION\n------------------------\n- [What the next session needs to know to continue]\n- [Warnings or gotchas to be aware of]\n- [References to documentation if relevant]\n```\n\nRules for the summary:\n- Plain text with bullets\n- No markdown headers with # (use the format above with dashes)\n- No bold, italic, or code fences within content\n- Use workspace-relative paths for files\n- Keep it focused - only include what matters for continuation\n- Pick an appropriate length based on complexity\n- USER REQUESTS (AS-IS) and EXPLICIT CONSTRAINTS must be verbatim only\n\n---\n\n# PHASE 4: PROVIDE INSTRUCTIONS\n\nAfter generating the summary, instruct the user:\n\n```\n---\n\nTO CONTINUE IN A NEW SESSION:\n\n1. Press 'n' in OpenCode TUI to open a new session, or run 'opencode' in a new terminal\n2. Paste the HANDOFF CONTEXT above as your first message\n3. Add your request: \"Continue from the handoff context above. [Your next task]\"\n\nThe new session will have all context needed to continue seamlessly.\n```\n\n---\n\n# IMPORTANT CONSTRAINTS\n\n- DO NOT attempt to programmatically create new sessions (no API available to agents)\n- DO provide a self-contained summary that works without access to this session\n- DO include workspace-relative file paths\n- DO NOT include sensitive information (API keys, credentials, secrets)\n- DO NOT exceed 10 files in the KEY FILES section\n- DO keep the GOAL section to a single sentence or short paragraph\n\n---\n\n# EXECUTE NOW\n\nBegin by gathering programmatic context, then synthesize the handoff summary.\n";