@bryanhu/codexly 0.21.1 → 0.22.1

package/CHANGELOG.md

@@ -4,6 +4,22 @@
 
 ## [Unreleased]
 
+## [0.22.1] - 2026-09-16
+
+### 修复
+
+- 修复内置更新和全局安装复用过期 npm 元数据、可能无法及时发现新版本的问题。
+
+## [0.22.0] - 2026-09-16
+
+### 新增
+
+- 添加任务、历史消息和项目文件的全局搜索，支持结果分页、消息定位与文件预览。
+
+### 修复
+
+- 修复 Linux 系统级全局安装因目录权限不足而无法使用内置更新的问题。
+
 ## [0.21.1] - 2026-09-15
 
 ### 新增

package/README.md

@@ -43,6 +43,7 @@
 - Choose the model, reasoning effort, Fast mode, approval behavior, and file access level for each task
 - Manage installed Skills, official Plugins, MCP servers, and compatible third-party Skills from ClawHub in one extension center
 - Organize ordered multi-root projects, archive project or temporary tasks, and permanently delete tasks when needed
+- Search tasks, conversation history, and project files globally, then jump to a matching message or preview a file
 - Inspect, preview, rename, and delete project files; review diffs; manage branches and worktrees; and commit or push changes
 - Fork a task from an AI response and continue it in a new Git worktree
 - Add animated workspace pets with separate task activity bubbles and custom PNG or WebP sprite manifests
@@ -73,11 +74,11 @@ On first launch, sign in with ChatGPT or configure an OpenAI-compatible service
 For regular use, install Codexly globally:
 
 ```bash
-npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirror.com --prefer-offline || npm install --global @bryanhu/codexly@latest --registry=https://registry.npmjs.org --prefer-offline
+npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirror.com || npm install --global @bryanhu/codexly@latest --registry=https://registry.npmjs.org
 codexly
 ```
 
-The installation command tries the China mirror first, falls back to the official registry on failure, and reuses the npm cache. `||` works in Bash, Zsh, cmd, and PowerShell 7+. In Windows PowerShell 5.1, run the command to the right of `||` separately if the first command fails.
+The installation command tries the China mirror first, falls back to the official registry on failure, reuses the npm cache, and revalidates stale package metadata. `||` works in Bash, Zsh, cmd, and PowerShell 7+. In Windows PowerShell 5.1, run the command to the right of `||` separately if the first command fails.
 
 ## Usage
 
@@ -113,9 +114,11 @@ Run `codexly doctor` when startup, Codex, or local data checks fail. Run `codexl
 Interactive startup and **Settings > About** check for new releases. Built-in updates try the China mirror first for version checks, package downloads, and dependency installation, falling back to the official registry on failure and reusing your npm cache. New releases may appear later while the mirror synchronizes. A global installation can also be updated with:
 
 ```bash
-npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirror.com --prefer-offline || npm install --global @bryanhu/codexly@latest --registry=https://registry.npmjs.org --prefer-offline
+npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirror.com || npm install --global @bryanhu/codexly@latest --registry=https://registry.npmjs.org
 ```
 
+If an older Linux release was installed into a system directory with `sudo npm install --global`, manually run the command above with `sudo` once to reach a release that supports elevated updates. Later built-in updates request `sudo` access when needed.
+
 ## Help
 
 - [Report an issue](https://github.com/BryanHoo/Codexly/issues)

package/README.zh-CN.md

@@ -13,6 +13,7 @@ Codexly 是一个在浏览器中使用 Codex 的本地 AI 编程工作台。它
 - 为每个任务选择模型、思考量、快速模式、审批方式和文件访问范围
 - 在扩展中心统一管理已安装 Skills、官方 Plugins、MCP Servers，以及来自 ClawHub 的兼容第三方 Skills
 - 组织有序的多根项目、归档项目或临时任务，并按需永久删除任务
+- 全局搜索任务、历史消息和项目文件，并定位匹配消息或预览文件
 - 查看、预览、重命名和删除项目文件，审查差异，管理分支与 worktree，并提交或推送变更
 - 从 AI 回复处分叉任务，在新的 Git worktree 中继续工作
 - 添加工作台宠物动画，用独立气泡区分任务活动，并支持自定义 PNG 或 WebP 精灵图清单
@@ -43,11 +44,11 @@ Codexly 会自动打开浏览器。若未打开，请访问终端输出的地址
 经常使用时可以全局安装：
 
 ```bash
-npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirror.com --prefer-offline || npm install --global @bryanhu/codexly@latest --registry=https://registry.npmjs.org --prefer-offline
+npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirror.com || npm install --global @bryanhu/codexly@latest --registry=https://registry.npmjs.org
 codexly
 ```
 
-安装命令优先使用国内镜像，失败后回退官方源，并复用 npm 缓存。`||` 适用于 Bash、Zsh、cmd 和 PowerShell 7+；Windows PowerShell 5.1 请在第一条命令失败后单独执行 `||` 右侧的命令。
+安装命令优先使用国内镜像，失败后回退官方源，复用 npm 缓存并重新校验过期的包元数据。`||` 适用于 Bash、Zsh、cmd 和 PowerShell 7+；Windows PowerShell 5.1 请在第一条命令失败后单独执行 `||` 右侧的命令。
 
 ## 使用方式
 
@@ -83,9 +84,11 @@ codexly start --lan
 交互式启动和“设置 > 关于”会检查新版本。内置更新的版本查询、包下载和依赖安装优先使用国内镜像，失败后回退官方源；下载和安装复用用户的 npm 缓存。镜像同步期间可能稍晚显示新版本。全局安装也可以通过以下命令更新：
 
 ```bash
-npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirror.com --prefer-offline || npm install --global @bryanhu/codexly@latest --registry=https://registry.npmjs.org --prefer-offline
+npm install --global @bryanhu/codexly@latest --registry=https://registry.npmmirror.com || npm install --global @bryanhu/codexly@latest --registry=https://registry.npmjs.org
 ```
 
+如果 Linux 上的旧版本通过 `sudo npm install --global` 安装到系统目录，首次升级到支持提权更新的版本时需要手动执行一次上述命令并在前面加上 `sudo`。后续内置更新会在需要时请求 `sudo` 权限。
+
 ## 获取帮助
 
 - [问题反馈](https://github.com/BryanHoo/Codexly/issues)

package/dist/{chunk-2J5P2EG2.js → chunk-4VM2ZUPT.js}

@@ -1,8 +1,8 @@
 import { createRequire } from 'node:module';
-import { value_exports } from './chunk-ZUECHB6L.js';
-import { require_pino, require_safe_stable_stringify, CodexProtocolMappingError, CodexProviderConnectionError, RpcConnectionClosedError, RpcProtocolError, RpcResponseError, RpcTimeoutError } from './chunk-AIACWU7L.js';
+import { value_exports } from './chunk-6JWQNFM2.js';
+import { require_pino, require_safe_stable_stringify, CodexProtocolMappingError, CodexProviderConnectionError, RpcConnectionClosedError, RpcProtocolError, RpcResponseError, RpcTimeoutError } from './chunk-NUJPWN62.js';
 import { WorkbenchPetProviderError, listTaskCatalog, PendingRequestResolutionError, deleteArchivedTasks, queryCompletedTasks, CompletedTasksQueryError, submitTask, TaskSubmissionError, collectQuestionGroups, formatQuestionAnswers, ProjectTodoError, saveProjectTodo } from './chunk-B2673ODM.js';
-import { Type, SkillInstallScopeSchema, ScheduledTaskSchema, SubmitTaskResponseSchema, AgentTaskSchema, AsyncQuestionGroupSchema, AnswerAsyncQuestionResultSchema, AgentTurnSchema, DEFAULT_COMMIT_MESSAGE_MODEL, TEMPORARY_TASK_API_PATH, TEMPORARY_TASK_SCOPE_ID, MAX_AGENT_FILE_BYTES, AccessStatusResponseSchema, PairAccessRequestSchema, BingWallpaperCatalogSchema, HealthResponseSchema, AppInfoResponseSchema, AppUpdateProgressResponseSchema, AgentMutationErrorSchema, InstallAppUpdateResponseSchema, InstallAppUpdateRequestSchema, EventStreamMetricsResponseSchema, AgentCapabilitiesSchema, AgentModelPageSchema, AgentGlobalSettingsResponseSchema, AgentGlobalSettingsSchema, MAX_AGENT_IMAGE_BYTES, MAX_AGENT_TEXT_BYTES, GlobalInstructionsSchema, MemorySettingsSchema, AgentPreferencesSchema, SaveGlobalInstructionsSchema, MemorySettingsUpdateSchema, PersonalizationResetSchema, AgentProviderConnectionStatusSchema, StartOfficialProviderLoginResponseSchema, StartOfficialProviderLoginRequestSchema, AgentProviderConnectionMutationResponseSchema, CancelProviderLoginRequestSchema, ConfigureCustomProviderResponseSchema, ConfigureCustomProviderRequestSchema, WorkbenchPetCatalogResponseSchema, WorkbenchPetDownloadResponseSchema, WorkbenchPetDownloadRequestSchema, ProjectPageSchema, HostFileListingSchema, HostFileQuerySchema, ProjectDirectoryListingSchema, ProjectDirectoryQuerySchema, ProjectOpenCapabilitiesResponseSchema, OpenProjectResponseSchema, ProjectRootQuerySchema, OpenProjectRequestSchema, ReorderProjectsResponseSchema, ReorderProjectsRequestSchema, AgentSkillPageSchema, AgentProjectDefaultsResponseSchema, AgentProjectDefaultsSchema, AddProjectResponseSchema, AddProjectRequestSchema, RenameProjectResponseSchema, RenameProjectRequestSchema, RemoveProjectResponseSchema, RemoveProjectRequestSchema, InstalledSkillPageSchema, OfficialPluginPageSchema, OfficialPluginDetailSchema, OfficialPluginInstallResponseSchema, OfficialPluginUninstallResponseSchema, ClawhubSkillPageSchema, ClawhubSkillDetailSchema, ConfiguredMcpServerPageSchema, OpenSkillDirectoryResponseSchema, SetSkillEnabledResponseSchema, SetMcpServerEnabledResponseSchema, SkillInstallResponseSchema, ScheduledTaskPreviewSchema, ScheduledTaskPreviewRequestSchema, ScheduledTaskPageSchema, ScheduledTaskMutationResponseSchema, ScheduledTaskInputSchema, DeleteScheduledTaskResponseSchema, SetScheduledTaskEnabledRequestSchema, AgentTaskPageSchema, UnsubscribeAgentTaskResponseSchema, AgentTaskSnapshotResponseSchema, AgentMcpServerPageSchema, AgentBackgroundTerminalPageSchema, TerminateAgentBackgroundTerminalResponseSchema, PinAgentTaskResponseSchema, PinAgentTaskRequestSchema, RenameAgentTaskResponseSchema, RenameAgentTaskRequestSchema, ArchiveAgentTaskResponseSchema, ArchiveAgentTaskRequestSchema, UnarchiveAgentTaskResponseSchema, UnarchiveAgentTaskRequestSchema, DeleteAgentTaskResponseSchema, DeleteAgentTaskRequestSchema, StartAgentTaskResponseSchema, StartAgentTaskRequestSchema, StartAgentTurnResponseSchema, StartAgentTurnRequestSchema, SteerAgentTurnResponseSchema, SteerAgentTurnRequestSchema, InterruptAgentTurnResponseSchema, InterruptAgentTurnRequestSchema, ResolvePendingRequestResponseSchema, ResolvePendingRequestRequestSchema, SubmitTaskRequestSchema, AsyncQuestionPageSchema, AnswerAsyncQuestionResponseSchema, AnswerAsyncQuestionRequestSchema, DismissAsyncQuestionsRequestSchema, ProjectTodoPageSchema, ProjectTodoResponseSchema, ProjectTodoDraftSchema, SaveProjectTodoRequestSchema, DeleteProjectTodoResponseSchema, DeleteProjectTodoRequestSchema, AgentQueuedSubmissionListSchema, AddAgentQueuedSubmissionResponseSchema, AddAgentQueuedSubmissionRequestSchema, UpdateAgentQueuedSubmissionResponseSchema, UpdateAgentQueuedSubmissionRequestSchema, DeleteAgentQueuedSubmissionResponseSchema, ReorderAgentQueuedSubmissionsResponseSchema, ReorderAgentQueuedSubmissionsRequestSchema, StartAgentQueuedSubmissionResponseSchema, StartAgentQueuedSubmissionRequestSchema, AgentPromptInputSchema, AgentProviderConnectionRecordSchema, MAX_AGENT_IMAGES, MAX_AGENT_IMAGE_TOTAL_BYTES, MAX_AGENT_FILE_TOTAL_BYTES, ProjectGitStatusSchema, ProjectGitStatusQuerySchema, ProjectGitHistoryPageSchema, ProjectGitHistoryQuerySchema, ProjectGitCommitFilesPageSchema, ProjectGitCommitFilesQuerySchema, ProjectGitCommitFileDiffSchema, ProjectGitCommitFileDiffQuerySchema, SwitchProjectBranchRequestSchema, CreateProjectBranchRequestSchema, GenerateCommitMessageResponseSchema, GenerateCommitMessageRequestSchema, CommitProjectChangesResponseSchema, CommitProjectChangesRequestSchema, ProjectFileTreeSchema, ProjectFileTreeQuerySchema, ProjectFileSearchPageSchema, ProjectFileSearchQuerySchema, StopProjectFileSearchResponseSchema, StopProjectFileSearchRequestSchema, ProjectSourceFileQuerySchema, ProjectSourceFileSchema, AgentAttachmentUploadResponseSchema, HostFileKindSchema, ImportHostAttachmentRequestSchema, AgentAttachmentKindSchema, AgentTaskSettingsResponseSchema, AgentTaskSettingsSchema, ReloadAgentMcpServersResponseSchema, ReloadAgentMcpServersRequestSchema, ReviewAgentTaskResponseSchema, ReviewAgentTaskRequestSchema, CompactAgentTaskResponseSchema, CompactAgentTaskRequestSchema, ForkAgentTaskResponseSchema, ForkAgentTaskRequestSchema, UploadAgentFeedbackResponseSchema, UploadAgentFeedbackRequestSchema, DeleteArchivedTasksResponseSchema, DeleteArchivedTasksRequestSchema, AgentTaskCatalogSchema, TaskCatalogQuerySchema, CompletedTasksPageSchema, CompletedTasksQuerySchema, UpdateTaskSettingsAndDefaultsResponseSchema, UpdateTaskSettingsAndDefaultsRequestSchema, NavigableAgentTaskResponseSchema, OpenAgentTaskAttachmentResponseSchema, OpenAgentTaskAttachmentRequestSchema, UpdateAgentGoalResponseSchema, UpdateAgentGoalRequestSchema, ClearAgentGoalResponseSchema, ProjectTodoSchema, AgentMessageAttachmentSchema, ProjectGitWorktreePageSchema, CreateProjectWorktreeResponseSchema, CreateProjectWorktreeRequestSchema, ProjectWorktreeMutationResponseSchema, SwitchProjectWorktreeRequestSchema, RenameProjectFileResponseSchema, RenameProjectFileRequestSchema, DeleteProjectFileResponseSchema, DeleteProjectFileRequestSchema, MAX_EVENT_BATCH_SIZE } from './chunk-X5JZ3VOF.js';
+import { Type, SkillInstallScopeSchema, ScheduledTaskSchema, SubmitTaskResponseSchema, AgentTaskSchema, AsyncQuestionGroupSchema, AnswerAsyncQuestionResultSchema, AgentTurnSchema, DEFAULT_COMMIT_MESSAGE_MODEL, TEMPORARY_TASK_API_PATH, TEMPORARY_TASK_SCOPE_ID, MAX_AGENT_FILE_BYTES, AccessStatusResponseSchema, PairAccessRequestSchema, BingWallpaperCatalogSchema, HealthResponseSchema, AppInfoResponseSchema, AppUpdateProgressResponseSchema, AgentMutationErrorSchema, InstallAppUpdateResponseSchema, InstallAppUpdateRequestSchema, EventStreamMetricsResponseSchema, AgentCapabilitiesSchema, AgentModelPageSchema, AgentGlobalSettingsResponseSchema, AgentGlobalSettingsSchema, MAX_AGENT_IMAGE_BYTES, MAX_AGENT_TEXT_BYTES, GlobalInstructionsSchema, MemorySettingsSchema, AgentPreferencesSchema, SaveGlobalInstructionsSchema, MemorySettingsUpdateSchema, PersonalizationResetSchema, AgentProviderConnectionStatusSchema, StartOfficialProviderLoginResponseSchema, StartOfficialProviderLoginRequestSchema, AgentProviderConnectionMutationResponseSchema, CancelProviderLoginRequestSchema, ConfigureCustomProviderResponseSchema, ConfigureCustomProviderRequestSchema, WorkbenchPetCatalogResponseSchema, WorkbenchPetDownloadResponseSchema, WorkbenchPetDownloadRequestSchema, ProjectPageSchema, HostFileListingSchema, HostFileQuerySchema, ProjectDirectoryListingSchema, ProjectDirectoryQuerySchema, ProjectOpenCapabilitiesResponseSchema, OpenProjectResponseSchema, ProjectRootQuerySchema, OpenProjectRequestSchema, ReorderProjectsResponseSchema, ReorderProjectsRequestSchema, AgentSkillPageSchema, AgentProjectDefaultsResponseSchema, AgentProjectDefaultsSchema, AddProjectResponseSchema, AddProjectRequestSchema, RenameProjectResponseSchema, RenameProjectRequestSchema, RemoveProjectResponseSchema, RemoveProjectRequestSchema, InstalledSkillPageSchema, OfficialPluginPageSchema, OfficialPluginDetailSchema, OfficialPluginInstallResponseSchema, OfficialPluginUninstallResponseSchema, ClawhubSkillPageSchema, ClawhubSkillDetailSchema, ConfiguredMcpServerPageSchema, OpenSkillDirectoryResponseSchema, SetSkillEnabledResponseSchema, SetMcpServerEnabledResponseSchema, SkillInstallResponseSchema, ScheduledTaskPreviewSchema, ScheduledTaskPreviewRequestSchema, ScheduledTaskPageSchema, ScheduledTaskMutationResponseSchema, ScheduledTaskInputSchema, DeleteScheduledTaskResponseSchema, SetScheduledTaskEnabledRequestSchema, AgentTaskPageSchema, UnsubscribeAgentTaskResponseSchema, AgentTaskSnapshotResponseSchema, AgentMcpServerPageSchema, AgentBackgroundTerminalPageSchema, TerminateAgentBackgroundTerminalResponseSchema, PinAgentTaskResponseSchema, PinAgentTaskRequestSchema, RenameAgentTaskResponseSchema, RenameAgentTaskRequestSchema, ArchiveAgentTaskResponseSchema, ArchiveAgentTaskRequestSchema, UnarchiveAgentTaskResponseSchema, UnarchiveAgentTaskRequestSchema, DeleteAgentTaskResponseSchema, DeleteAgentTaskRequestSchema, TaskSearchPageSchema, TaskSearchQuerySchema, SearchOccurrencesPageSchema, SearchOccurrencesQuerySchema, StartAgentTaskResponseSchema, StartAgentTaskRequestSchema, StartAgentTurnResponseSchema, StartAgentTurnRequestSchema, SteerAgentTurnResponseSchema, SteerAgentTurnRequestSchema, InterruptAgentTurnResponseSchema, InterruptAgentTurnRequestSchema, ResolvePendingRequestResponseSchema, ResolvePendingRequestRequestSchema, SubmitTaskRequestSchema, AsyncQuestionPageSchema, AnswerAsyncQuestionResponseSchema, AnswerAsyncQuestionRequestSchema, DismissAsyncQuestionsRequestSchema, ProjectTodoPageSchema, ProjectTodoResponseSchema, ProjectTodoDraftSchema, SaveProjectTodoRequestSchema, DeleteProjectTodoResponseSchema, DeleteProjectTodoRequestSchema, AgentQueuedSubmissionListSchema, AddAgentQueuedSubmissionResponseSchema, AddAgentQueuedSubmissionRequestSchema, UpdateAgentQueuedSubmissionResponseSchema, UpdateAgentQueuedSubmissionRequestSchema, DeleteAgentQueuedSubmissionResponseSchema, ReorderAgentQueuedSubmissionsResponseSchema, ReorderAgentQueuedSubmissionsRequestSchema, StartAgentQueuedSubmissionResponseSchema, StartAgentQueuedSubmissionRequestSchema, AgentPromptInputSchema, AgentProviderConnectionRecordSchema, MAX_AGENT_IMAGES, MAX_AGENT_IMAGE_TOTAL_BYTES, MAX_AGENT_FILE_TOTAL_BYTES, ProjectGitStatusSchema, ProjectGitStatusQuerySchema, ProjectGitHistoryPageSchema, ProjectGitHistoryQuerySchema, ProjectGitCommitFilesPageSchema, ProjectGitCommitFilesQuerySchema, ProjectGitCommitFileDiffSchema, ProjectGitCommitFileDiffQuerySchema, SwitchProjectBranchRequestSchema, CreateProjectBranchRequestSchema, GenerateCommitMessageResponseSchema, GenerateCommitMessageRequestSchema, CommitProjectChangesResponseSchema, CommitProjectChangesRequestSchema, ProjectFileTreeSchema, ProjectFileTreeQuerySchema, ProjectFileSearchPageSchema, ProjectFileSearchQuerySchema, StopProjectFileSearchResponseSchema, StopProjectFileSearchRequestSchema, ProjectSourceFileQuerySchema, ProjectSourceFileSchema, AgentAttachmentUploadResponseSchema, HostFileKindSchema, ImportHostAttachmentRequestSchema, AgentAttachmentKindSchema, AgentTaskSettingsResponseSchema, AgentTaskSettingsSchema, ReloadAgentMcpServersResponseSchema, ReloadAgentMcpServersRequestSchema, ReviewAgentTaskResponseSchema, ReviewAgentTaskRequestSchema, CompactAgentTaskResponseSchema, CompactAgentTaskRequestSchema, ForkAgentTaskResponseSchema, ForkAgentTaskRequestSchema, UploadAgentFeedbackResponseSchema, UploadAgentFeedbackRequestSchema, DeleteArchivedTasksResponseSchema, DeleteArchivedTasksRequestSchema, AgentTaskCatalogSchema, TaskCatalogQuerySchema, CompletedTasksPageSchema, CompletedTasksQuerySchema, UpdateTaskSettingsAndDefaultsResponseSchema, UpdateTaskSettingsAndDefaultsRequestSchema, NavigableAgentTaskResponseSchema, OpenAgentTaskAttachmentResponseSchema, OpenAgentTaskAttachmentRequestSchema, UpdateAgentGoalResponseSchema, UpdateAgentGoalRequestSchema, ClearAgentGoalResponseSchema, ProjectTodoSchema, AgentMessageAttachmentSchema, ProjectGitWorktreePageSchema, CreateProjectWorktreeResponseSchema, CreateProjectWorktreeRequestSchema, ProjectWorktreeMutationResponseSchema, SwitchProjectWorktreeRequestSchema, RenameProjectFileResponseSchema, RenameProjectFileRequestSchema, DeleteProjectFileResponseSchema, DeleteProjectFileRequestSchema, MAX_EVENT_BATCH_SIZE } from './chunk-ZXTTTT25.js';
 import { __commonJS, __require, __toESM } from './chunk-K6J42667.js';
 import { Buffer as Buffer$1 } from 'buffer';
 import { randomBytes, createHash, timingSafeEqual, randomUUID } from 'crypto';
@@ -70155,6 +70155,69 @@ var registerTaskRoutes = (app, context, done) => {
   done();
 };
 
+// packages/server/src/routes/search-routes.ts
+var registerSearchRoutes = (app, context, done) => {
+  const { getProjectContext, projectRepository, provider } = context;
+  app.get(
+    "/v1/search/tasks",
+    {
+      schema: {
+        querystring: TaskSearchQuerySchema,
+        response: {
+          200: TaskSearchPageSchema,
+          503: ErrorResponseSchema
+        }
+      }
+    },
+    async (request2, reply) => {
+      if (provider.search === void 0) {
+        return reply.code(503).send({
+          code: "GLOBAL_SEARCH_UNAVAILABLE",
+          message: "Global search is unavailable"
+        });
+      }
+      const projects = await projectRepository.list();
+      const scopes = [
+        { id: TEMPORARY_TASK_SCOPE_ID, kind: "temporary" },
+        ...projects.map((project) => ({ id: project.id, kind: "project" }))
+      ];
+      return provider.search.searchTasks(request2.query, scopes);
+    }
+  );
+  app.get(
+    "/v1/projects/:projectId/tasks/:taskId/search-occurrences",
+    {
+      schema: {
+        params: ProjectTaskParamsSchema,
+        querystring: SearchOccurrencesQuerySchema,
+        response: {
+          200: SearchOccurrencesPageSchema,
+          404: ErrorResponseSchema,
+          503: ErrorResponseSchema
+        }
+      }
+    },
+    async (request2, reply) => {
+      const project = await getProjectContext(request2.params.projectId);
+      if (project === void 0) {
+        return reply.code(404).send({ code: "PROJECT_NOT_FOUND", message: "Project not found" });
+      }
+      if (provider.search === void 0) {
+        return reply.code(503).send({
+          code: "GLOBAL_SEARCH_UNAVAILABLE",
+          message: "Global search is unavailable"
+        });
+      }
+      return provider.search.searchTaskOccurrences(
+        request2.params.taskId,
+        request2.query,
+        project.scope
+      );
+    }
+  );
+  done();
+};
+
 // packages/server/src/routes/turn-routes.ts
 var registerTurnRoutes = (app, context, done) => {
   const {
@@ -73178,6 +73241,7 @@ async function createCodexlyServer(options) {
   await app.register(registerSkillMarketRoutes, routeContext);
   await app.register(registerScheduledTaskRoutes, routeContext);
   await app.register(registerTaskRoutes, routeContext);
+  await app.register(registerSearchRoutes, routeContext);
   await app.register(registerTurnRoutes, routeContext);
   await app.register(registerSubmissionRoutes, routeContext);
   await app.register(registerAsyncQuestionRoutes, routeContext);

package/dist/{chunk-ZUECHB6L.js → chunk-6JWQNFM2.js}

@@ -1,5 +1,5 @@
 import { createRequire } from 'node:module';
-import { IsArray, IsDate, IsTypedArray, IsMap, IsSet, IsObject, IsValueType, TypeBoxError, Object as Object$1, Unknown, String, Literal, Union, IsBoolean, IsBigInt, IsNull, IsNumber, IsString, IsSymbol, IsUint8Array, IsUndefined, Kind, type_exports, IsStandardObject, TypeSystemPolicy, format_exports, IsPromise, IsIterator, KeyOfPattern, IsSchema, IsInteger, IsFunction, IsAsyncIterator, Never, HasPropertyKey, IsTemplateLiteralFinite, TemplateLiteralGenerate, IsKind, KeyOfPropertyKeys, IsTransform, TransformKind, IsUndefined2, IndexFromPropertyKeys } from './chunk-X5JZ3VOF.js';
+import { IsArray, IsDate, IsTypedArray, IsMap, IsSet, IsObject, IsValueType, TypeBoxError, Object as Object$1, Unknown, String, Literal, Union, IsBoolean, IsBigInt, IsNull, IsNumber, IsString, IsSymbol, IsUint8Array, IsUndefined, Kind, type_exports, IsStandardObject, TypeSystemPolicy, format_exports, IsPromise, IsIterator, KeyOfPattern, IsSchema, IsInteger, IsFunction, IsAsyncIterator, Never, HasPropertyKey, IsTemplateLiteralFinite, TemplateLiteralGenerate, IsKind, KeyOfPropertyKeys, IsTransform, TransformKind, IsUndefined2, IndexFromPropertyKeys } from './chunk-ZXTTTT25.js';
 import { __export } from './chunk-K6J42667.js';
 
 createRequire(import.meta.url);

package/dist/{chunk-AIACWU7L.js → chunk-NUJPWN62.js}

@@ -1,6 +1,6 @@
 import { createRequire } from 'node:module';
 import { WorkbenchPetProviderError, PendingRequestResolutionError } from './chunk-B2673ODM.js';
-import { TEMPORARY_TASK_SCOPE_ID, MAX_AGENT_HISTORY_IMAGE_TOTAL_BYTES, isAgentFastModeAvailable, MAX_REALTIME_FILE_CHANGES, MAX_REALTIME_DIFF_BYTES, stripLeadingAgentSkillReferences, MAX_AGENT_HISTORY_IMAGES, MAX_AGENT_TEXT_BYTES } from './chunk-X5JZ3VOF.js';
+import { TEMPORARY_TASK_SCOPE_ID, MAX_AGENT_HISTORY_IMAGE_TOTAL_BYTES, isAgentFastModeAvailable, MAX_REALTIME_FILE_CHANGES, MAX_REALTIME_DIFF_BYTES, stripLeadingAgentSkillReferences, MAX_AGENT_HISTORY_IMAGES, MAX_AGENT_TEXT_BYTES } from './chunk-ZXTTTT25.js';
 import { __commonJS, __require, __toESM } from './chunk-K6J42667.js';
 import { execFile, spawn } from 'child_process';
 import { constants, mkdtempSync, rmSync, createReadStream, mkdirSync, unlinkSync, renameSync, writeFileSync, openSync, readSync, closeSync, statSync } from 'fs';
@@ -12824,6 +12824,138 @@ var CodexGitMetadataWatchService = class {
   }
 };
 
+// packages/provider-codex/src/global-search.ts
+var SEARCH_PAGE_SIZE = 30;
+var HISTORY_OCCURRENCE_CONCURRENCY = 4;
+function validateQuery(value) {
+  const query = value.trim();
+  if (query.length === 0 || Array.from(query).length > 1024) {
+    throw new CodexProtocolMappingError("Global search query is invalid");
+  }
+  return query;
+}
+function parsePage(value, label) {
+  const page = expectRecord(value, label);
+  if (!Array.isArray(page["data"])) {
+    throw new CodexProtocolMappingError(`${label} data must be an array`);
+  }
+  const nextCursor = page["nextCursor"];
+  if (nextCursor !== null && typeof nextCursor !== "string") {
+    throw new CodexProtocolMappingError(`${label} nextCursor must be a string or null`);
+  }
+  return { data: page["data"], nextCursor };
+}
+function parseOccurrence(value) {
+  const occurrence = expectRecord(value, "thread/searchOccurrences item");
+  const range = expectRecord(
+    occurrence["snippetMatchRange"],
+    "thread/searchOccurrences snippetMatchRange"
+  );
+  const start = range["start"];
+  const end = range["end"];
+  if (!Number.isInteger(start) || !Number.isInteger(end) || Number(start) < 0 || Number(end) < 0) {
+    throw new CodexProtocolMappingError("thread/searchOccurrences range must be non-negative");
+  }
+  const nativeTurnCursor = expectString(
+    occurrence["turnCursor"],
+    "thread/searchOccurrences turnCursor"
+  );
+  const turnCursor = encodeTaskTurnCursor(nativeTurnCursor, void 0);
+  if (turnCursor === null) {
+    throw new CodexProtocolMappingError("thread/searchOccurrences turnCursor must not be null");
+  }
+  return {
+    itemId: expectString(occurrence["itemId"], "thread/searchOccurrences itemId"),
+    snippet: expectString(occurrence["snippet"], "thread/searchOccurrences snippet"),
+    snippetMatchRange: { end: Number(end), start: Number(start) },
+    turnCursor,
+    turnId: expectString(occurrence["turnId"], "thread/searchOccurrences turnId")
+  };
+}
+function scopeForThread(thread, scopes) {
+  return scopes.find((scope) => isProjectThread(thread, scope));
+}
+async function mapWithConcurrency(values, concurrency, map) {
+  const results = new Array(values.length);
+  const entries = values.entries();
+  await Promise.all(
+    Array.from({ length: Math.min(concurrency, values.length) }, async () => {
+      let entry = entries.next();
+      while (!entry.done) {
+        const [index, value] = entry.value;
+        results[index] = await map(value);
+        entry = entries.next();
+      }
+    })
+  );
+  return results;
+}
+var CodexGlobalSearchService = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async searchTasks(input, scopes) {
+    const query = validateQuery(input.query);
+    const params = {
+      archived: input.archived,
+      ...input.cursor === void 0 ? {} : { cursor: input.cursor },
+      limit: SEARCH_PAGE_SIZE,
+      searchTerm: query,
+      sortDirection: "desc",
+      sortKey: "recency_at"
+    };
+    const page = parsePage(
+      await this.client.request(
+        input.kind === "tasks" ? "thread/list" : "thread/search",
+        input.kind === "tasks" ? { ...params, modelProviders: [] } : params
+      ),
+      input.kind === "tasks" ? "thread/list response" : "thread/search response"
+    );
+    const mapped = await mapWithConcurrency(
+      page.data.slice(0, SEARCH_PAGE_SIZE),
+      input.kind === "history" ? HISTORY_OCCURRENCE_CONCURRENCY : SEARCH_PAGE_SIZE,
+      async (value) => {
+        const result = input.kind === "tasks" ? { thread: value } : expectRecord(value, "thread/search item");
+        const thread = expectRecord(result["thread"], "global search thread");
+        const scope = scopeForThread(thread, scopes);
+        if (scope === void 0) return void 0;
+        const task = await mapAgentTask(thread, scope);
+        if (input.kind === "tasks") return { snippet: "", task };
+        const occurrences = await this.requestOccurrences(task.id, query, void 0, 1);
+        const occurrence = occurrences.data[0];
+        if (occurrence === void 0) return void 0;
+        return { occurrence, snippet: occurrence.snippet, task };
+      }
+    );
+    return { data: mapped.filter((item) => item !== void 0), nextCursor: page.nextCursor };
+  }
+  async searchTaskOccurrences(taskId, input, scope) {
+    const query = validateQuery(input.query);
+    const response = expectRecord(
+      await this.client.request("thread/read", { includeTurns: false, threadId: taskId }),
+      "thread/read response"
+    );
+    const thread = expectRecord(response["thread"], "thread/read thread");
+    if (!isProjectThread(thread, scope)) {
+      throw new CodexProtocolMappingError("Search task does not belong to the requested project");
+    }
+    return this.requestOccurrences(taskId, query, input.cursor, SEARCH_PAGE_SIZE);
+  }
+  async requestOccurrences(taskId, query, cursor, limit) {
+    const page = parsePage(
+      await this.client.request("thread/searchOccurrences", {
+        ...cursor === void 0 ? {} : { cursor },
+        limit,
+        searchTerm: query,
+        threadId: taskId
+      }),
+      "thread/searchOccurrences response"
+    );
+    return { data: page.data.map(parseOccurrence), nextCursor: page.nextCursor };
+  }
+};
+
 // packages/provider-codex/src/skill-market-provider.ts
 var OFFICIAL_MARKETPLACES = /* @__PURE__ */ new Set([
   "openai-curated",
@@ -13062,6 +13194,7 @@ async function setCodexMcpServerEnabled(client, name, enabled) {
 var CodexRuntimeProvider = class {
   personalization;
   fileSearch;
+  search;
   #client;
   #taskTitles;
   #logger;
@@ -13090,6 +13223,7 @@ var CodexRuntimeProvider = class {
     this.#logger = logger;
     this.#providerConnection = new CodexProviderConnectionService(client, options);
     this.fileSearch = new CodexFuzzyFileSearchService(client);
+    this.search = new CodexGlobalSearchService(client);
     this.#gitMetadataWatch = new CodexGitMetadataWatchService(client, {
       logger,
       onChanged: (projectId, rootPath) => {