@bryanhu/codexly 0.7.0 → 0.9.0

package/CHANGELOG.md

@@ -4,6 +4,27 @@
 
 ## [Unreleased]
 
+## [0.9.0] - 2026-08-28
+
+### 新增
+
+- 支持使用 PNG 或 WebP 自定义宠物精灵图，并兼容 `spriteVersionNumber: 2` 的 8×11 帧网格清单。
+
+### 修复
+
+- 修复 SQLite Worker 操作超时后 Repository 永久关闭的问题，终止状态未知的 Worker 并为后续请求自动重建连接。
+- 修复检查更新后 registry 版本继续推进时旧页面无法安装更新的问题，重新校验并安装当前最新版本。
+
+## [0.8.0] - 2026-08-27
+
+### 新增
+
+- 添加自定义工作台背景图片集合，支持批量添加、缩略图选择和单独删除，并将背景配置移至独立设置分类。
+
+### 修复
+
+- 修复已水合任务在后台 Snapshot 重验证期间错误显示挂起状态的问题，使现有内容保持可用。
+
 ## [0.7.0] - 2026-08-27
 
 ### 新增
@@ -137,7 +158,9 @@
 - 拆分全栈测试套件并限制 Vitest 并发，提升跨平台门禁稳定性；GitHub Release 改为严格提取对应版本的完整更新日志。
 - 将最低 Node.js 版本调整为 `22.14.0`，同步 CLI、CI、发布环境和使用文档。
 
-[Unreleased]: https://github.com/BryanHoo/Codexly/compare/v0.7.0...HEAD
+[Unreleased]: https://github.com/BryanHoo/Codexly/compare/v0.9.0...HEAD
+[0.9.0]: https://github.com/BryanHoo/Codexly/releases/tag/v0.9.0
+[0.8.0]: https://github.com/BryanHoo/Codexly/releases/tag/v0.8.0
 [0.7.0]: https://github.com/BryanHoo/Codexly/releases/tag/v0.7.0
 [0.6.0]: https://github.com/BryanHoo/Codexly/releases/tag/v0.6.0
 [0.5.0]: https://github.com/BryanHoo/Codexly/releases/tag/v0.5.0

package/README.md

@@ -43,8 +43,8 @@
 - Organize ordered multi-root projects, archive project or temporary tasks, and permanently delete tasks when needed
 - 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 activity bubbles for project and temporary tasks
-- Customize the workspace with image or Bing daily backgrounds, automatic foreground colors, overlay opacity, and background blur
+- Add animated workspace pets with separate task activity bubbles and custom PNG or WebP sprite manifests
+- Manage a collection of custom workspace backgrounds, or use Bing daily images, with automatic foreground colors, overlay opacity, and blur
 - Access the workspace from another device on a trusted local network
 
 ## Requirements

package/README.zh-CN.md

@@ -13,8 +13,8 @@ Codexly 是一个在浏览器中使用 Codex 的本地 AI 编程工作台。它
 - 组织有序的多根项目、归档项目或临时任务，并按需永久删除任务
 - 查看、预览、重命名和删除项目文件，审查差异，管理分支与 worktree，并提交或推送变更
 - 从 AI 回复处分叉任务，在新的 Git worktree 中继续工作
-- 添加工作台宠物动画，并用独立气泡区分项目与临时任务的活动状态
-- 使用图片或 Bing 每日壁纸自定义工作台，自动适配前景色并调节浮层遮罩与背景模糊
+- 添加工作台宠物动画，用独立气泡区分任务活动，并支持自定义 PNG 或 WebP 精灵图清单
+- 管理自定义工作台背景图片集合，或使用 Bing 每日壁纸，并自动适配前景色、浮层遮罩与背景模糊
 - 从可信局域网中的其他设备访问工作台
 
 ## 环境要求

package/dist/{chunk-NAHIDASP.js → chunk-7XFCPPAG.js}

@@ -1,6 +1,6 @@
 import { createRequire } from 'node:module';
 import { value_exports } from './chunk-DEKHLAWT.js';
-import { require_pino, require_safe_stable_stringify, CodexProtocolMappingError, CodexProviderConnectionError, RpcConnectionClosedError, RpcProtocolError, RpcResponseError, RpcTimeoutError } from './chunk-CGZ44LHJ.js';
+import { require_pino, require_safe_stable_stringify, CodexProtocolMappingError, CodexProviderConnectionError, RpcConnectionClosedError, RpcProtocolError, RpcResponseError, RpcTimeoutError } from './chunk-HEWCIXCQ.js';
 import { WorkbenchPetProviderError, PendingRequestResolutionError } from './chunk-RNTA4MFS.js';
 import { AGENT_FILE_EXTENSIONS, AGENT_FILE_MEDIA_TYPES, DEFAULT_COMMIT_MESSAGE_MODEL, TEMPORARY_TASK_API_PATH, TEMPORARY_TASK_SCOPE_ID, MAX_AGENT_FILE_BYTES, AccessStatusResponseSchema, PairAccessRequestSchema, HealthResponseSchema, AppInfoResponseSchema, AgentMutationErrorSchema, InstallAppUpdateResponseSchema, InstallAppUpdateRequestSchema, EventStreamMetricsResponseSchema, AgentCapabilitiesSchema, AgentModelPageSchema, AgentGlobalSettingsResponseSchema, AgentGlobalSettingsSchema, MAX_AGENT_IMAGE_BYTES, MAX_AGENT_TEXT_BYTES, 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, 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, AgentQueuedSubmissionPageSchema, 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, OpenAgentTaskAttachmentResponseSchema, OpenAgentTaskAttachmentRequestSchema, UpdateAgentGoalResponseSchema, UpdateAgentGoalRequestSchema, ClearAgentGoalResponseSchema, ProjectGitWorktreePageSchema, ProjectWorktreeMutationResponseSchema, CreateProjectWorktreeRequestSchema, SwitchProjectWorktreeRequestSchema, RenameProjectFileResponseSchema, RenameProjectFileRequestSchema, DeleteProjectFileResponseSchema, DeleteProjectFileRequestSchema, MAX_EVENT_BATCH_SIZE } from './chunk-TEWPWZPG.js';
 import { __commonJS, __require, __toESM } from './chunk-K6J42667.js';
@@ -61764,19 +61764,25 @@ function parseQueueWorkerRecord(record) {
 }
 var DEFAULT_SQLITE_REQUEST_TIMEOUT_MS = 1e4;
 var SqliteStateRepository = class _SqliteStateRepository {
+  #databasePath;
   #now;
+  #options;
   #pending = /* @__PURE__ */ new Map();
   #ready;
   #requestTimeoutMs;
   #worker;
   #workerExit;
   #closed = false;
+  #closing = false;
   #nextRequestId = 1;
+  #replacement;
   #workerExited = false;
   constructor(databasePath, options) {
     if (!isAbsolute(databasePath)) {
       throw new Error("SQLite database path must be absolute");
     }
+    this.#databasePath = databasePath;
+    this.#options = options;
     this.#requestTimeoutMs = options.requestTimeoutMs ?? DEFAULT_SQLITE_REQUEST_TIMEOUT_MS;
     if (!Number.isFinite(this.#requestTimeoutMs) || this.#requestTimeoutMs <= 0) {
       throw new RangeError("SQLite request timeout must be a positive number");
@@ -61873,6 +61879,15 @@ var SqliteStateRepository = class _SqliteStateRepository {
     }
   }
   async close() {
+    if (this.#closing) {
+      return;
+    }
+    this.#closing = true;
+    if (this.#replacement !== void 0) {
+      const replacement = await this.#replacement;
+      await replacement.close();
+      return;
+    }
     if (this.#closed) {
       return;
     }
@@ -61996,6 +62011,13 @@ var SqliteStateRepository = class _SqliteStateRepository {
     });
   }
   async #call(operation, payload, allowClosed = false) {
+    if (this.#closing && !allowClosed) {
+      throw new Error("SQLite repository is closed");
+    }
+    if (this.#replacement !== void 0) {
+      const replacement = await this.#replacement;
+      return replacement.#call(operation, payload, allowClosed);
+    }
     await this.#ready;
     if (this.#closed && !allowClosed) {
       throw new Error("SQLite repository is closed");
@@ -62010,8 +62032,15 @@ var SqliteStateRepository = class _SqliteStateRepository {
           `SQLite worker operation ${operation} timed out after ${String(this.#requestTimeoutMs)}ms`
         );
         this.#closed = true;
+        if (!this.#closing) {
+          const replacement = this.#replaceWorker();
+          this.#replacement = replacement;
+          void replacement.catch(() => void 0);
+        }
         this.#rejectPending(error);
-        void this.#worker.terminate();
+        if (this.#replacement === void 0) {
+          void this.#worker.terminate();
+        }
       }, this.#requestTimeoutMs);
       this.#pending.set(id, {
         reject: rejectRequest,
@@ -62036,6 +62065,12 @@ var SqliteStateRepository = class _SqliteStateRepository {
     }
     this.#pending.clear();
   }
+  async #replaceWorker() {
+    if (!this.#workerExited) {
+      await this.#worker.terminate();
+    }
+    return _SqliteStateRepository.open(this.#databasePath, this.#options);
+  }
   async #waitForWorkerExit() {
     let timeout;
     try {

package/dist/{chunk-CGZ44LHJ.js → chunk-HEWCIXCQ.js}

@@ -13153,12 +13153,26 @@ function imageDimensionsFromData(bytes) {
 }
 
 // packages/provider-codex/src/workbench-pet-image.ts
-function readWebpDimensions(data) {
+function readPetImageMetadata(data) {
   const dimensions = imageDimensionsFromData(data);
-  if (dimensions?.type !== "webp") {
+  if (dimensions?.type !== "png" && dimensions?.type !== "webp") {
+    throw new Error("Pet spritesheet must be a valid PNG or WebP image");
+  }
+  return {
+    contentType: dimensions.type === "png" ? "image/png" : "image/webp",
+    height: dimensions.height,
+    width: dimensions.width
+  };
+}
+async function readPetImageMetadataFromFile(path) {
+  return readPetImageMetadata(await readFile(path));
+}
+function readWebpDimensions(data) {
+  const metadata = readPetImageMetadata(data);
+  if (metadata.contentType !== "image/webp") {
     throw new Error("Pet spritesheet must be a valid WebP image");
   }
-  return dimensions;
+  return metadata;
 }
 async function readWebpDimensionsFromFile(path) {
   return readWebpDimensions(await readFile(path));
@@ -13167,6 +13181,7 @@ var MAX_MANIFEST_BYTES = 64 * 1024;
 var MAX_CUSTOM_ASSET_BYTES = 16 * 1024 * 1024;
 var MAX_FRAMES = 256;
 var MAX_FPS = 60;
+var PET_V2_ROWS = 11;
 async function loadCustomPet(input) {
   const baseDirectory = await realpath(input.directory);
   const manifestPath = resolve(baseDirectory, input.manifestName);
@@ -13186,14 +13201,16 @@ async function loadCustomPet(input) {
   if (!assetStats.isFile() || assetStats.size > MAX_CUSTOM_ASSET_BYTES) {
     throw new Error("Pet spritesheet is missing or too large");
   }
-  const dimensions = await readWebpDimensionsFromFile(path);
-  const frame = parseFrame(manifest["frame"]);
-  const frameCount = validateFrame(frame, dimensions.width, dimensions.height);
+  const image = await readPetImageMetadataFromFile(path);
+  const spriteVersion = parseSpriteVersion(manifest["spriteVersionNumber"]);
+  const frame = parseFrame(manifest["frame"], spriteVersion);
+  const frameCount = validateFrame(frame, image.width, image.height);
   const animations = parseAnimations(manifest["animations"], frameCount);
   const manifestId = readOptionalString(manifest, "id");
   return {
     assetId: input.assetId,
     baseDirectory,
+    contentType: image.contentType,
     descriptor: {
       animations,
       assetId: input.assetId,
@@ -13217,12 +13234,17 @@ async function validatePetAsset(record) {
   if (!assetStats.isFile() || assetStats.size > MAX_CUSTOM_ASSET_BYTES) {
     throw new Error("Pet spritesheet is unavailable");
   }
-  const dimensions = await readWebpDimensionsFromFile(resolved);
-  validateFrame(record.descriptor.frame, dimensions.width, dimensions.height);
+  const image = await readPetImageMetadataFromFile(resolved);
+  if (image.contentType !== record.contentType) {
+    throw new Error("Pet spritesheet format changed after discovery");
+  }
+  validateFrame(record.descriptor.frame, image.width, image.height);
   return { mtimeMs: assetStats.mtimeMs, size: assetStats.size };
 }
-function parseFrame(value) {
-  if (value === void 0 || value === null) return PET_FRAME;
+function parseFrame(value, spriteVersion) {
+  if (value === void 0 || value === null) {
+    return spriteVersion === 2 ? { ...PET_FRAME, rows: PET_V2_ROWS } : PET_FRAME;
+  }
   const frame = parseRecord(value, "Pet frame");
   return {
     columns: readPositiveInteger(frame, "columns"),
@@ -13231,6 +13253,11 @@ function parseFrame(value) {
     width: readPositiveInteger(frame, "width")
   };
 }
+function parseSpriteVersion(value) {
+  if (value === void 0 || value === null || value === 1) return 1;
+  if (value === 2) return 2;
+  throw new Error("Pet spriteVersionNumber must be 1 or 2");
+}
 function validateFrame(frame, width, height) {
   if (width === void 0 || height === void 0 || frame.width * frame.columns !== width || frame.height * frame.rows !== height) {
     throw new Error("Pet frame grid must cover the spritesheet exactly");
@@ -13365,7 +13392,7 @@ var CodexWorkbenchPetProvider = class {
       const content = await readFile(record.path);
       return {
         content,
-        contentType: "image/webp",
+        contentType: record.contentType,
         etag: `W/"${String(metadata.size)}-${String(Math.trunc(metadata.mtimeMs))}"`,
         size: metadata.size
       };
@@ -13384,7 +13411,13 @@ var CodexWorkbenchPetProvider = class {
     } catch {
     }
     const descriptor = createBuiltinDescriptor(pet, assetId, availability);
-    this.#assetRecords.set(assetId, { assetId, baseDirectory, descriptor, path });
+    this.#assetRecords.set(assetId, {
+      assetId,
+      baseDirectory,
+      contentType: "image/webp",
+      descriptor,
+      path
+    });
     return descriptor;
   }
   async #ensureBuiltin(pet) {

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import { createRequire } from 'node:module';
-import { createCodexlyServer, SqliteStateRepository, normalizeAllowedHost } from './chunk-NAHIDASP.js';
+import { createCodexlyServer, SqliteStateRepository, normalizeAllowedHost } from './chunk-7XFCPPAG.js';
 import './chunk-DEKHLAWT.js';
-import { startCodexAppServer, locateCodexBinary, createCodexRuntimeProvider, createCodexWorkbenchPetProvider, CodexProjectRepository, checkCodexVersion } from './chunk-CGZ44LHJ.js';
+import { startCodexAppServer, locateCodexBinary, createCodexRuntimeProvider, createCodexWorkbenchPetProvider, CodexProjectRepository, checkCodexVersion } from './chunk-HEWCIXCQ.js';
 import './chunk-RNTA4MFS.js';
 import './chunk-TEWPWZPG.js';
 import './chunk-K6J42667.js';
@@ -18,7 +18,7 @@ createRequire(import.meta.url);
 
 // package.json
 var package_default = {
-  version: "0.7.0"};
+  version: "0.9.0"};
 var PACKAGE_NAME = "@bryanhu/codexly";
 var INITIAL_APP_VERSION = "0.1.0";
 var CHANGELOG_URL_PREFIX = "https://raw.githubusercontent.com/BryanHoo/Codexly/v";
@@ -174,7 +174,8 @@ function createAppUpdateService(options) {
   return {
     async install(version) {
       const latestVersion = await readLatest();
-      if (version !== latestVersion || !isNewerVersion(latestVersion, options.appVersion)) {
+      const requestedVersionIsAvailable = isNewerVersion(version, options.appVersion) && !isNewerVersion(version, latestVersion);
+      if (!requestedVersionIsAvailable || !isNewerVersion(latestVersion, options.appVersion)) {
         throw new AppUpdateError("UPDATE_NOT_AVAILABLE", "The requested update is not available");
       }
       try {

package/dist/providers/codex/index.js

@@ -1,5 +1,5 @@
 import { createRequire } from 'node:module';
-export { CodexAppServerExitedError, CodexAppServerProcess, CodexAppServerShutdownError, CodexAppServerSpawnError, CodexProjectRepository, CodexProtocolMappingError, CodexProviderConnectionError, CodexProviderConnectionService, CodexRuntimeProvider, CodexWorkbenchPetProvider, JsonlRpcClient, RpcConnectionClosedError, RpcProtocolError, RpcResponseError, RpcTimeoutError, SUPPORTED_CODEX_VERSION, checkCodexVersion, createCodexRuntimeProvider, createCodexWorkbenchPetProvider, locateCodexBinary, startCodexAppServer } from '../../chunk-CGZ44LHJ.js';
+export { CodexAppServerExitedError, CodexAppServerProcess, CodexAppServerShutdownError, CodexAppServerSpawnError, CodexProjectRepository, CodexProtocolMappingError, CodexProviderConnectionError, CodexProviderConnectionService, CodexRuntimeProvider, CodexWorkbenchPetProvider, JsonlRpcClient, RpcConnectionClosedError, RpcProtocolError, RpcResponseError, RpcTimeoutError, SUPPORTED_CODEX_VERSION, checkCodexVersion, createCodexRuntimeProvider, createCodexWorkbenchPetProvider, locateCodexBinary, startCodexAppServer } from '../../chunk-HEWCIXCQ.js';
 import '../../chunk-RNTA4MFS.js';
 import '../../chunk-TEWPWZPG.js';
 import '../../chunk-K6J42667.js';

package/dist/server/index.js

@@ -1,7 +1,7 @@
 import { createRequire } from 'node:module';
-export { AccessSessionService, AgentEventStream, GitCommitError, GitCommitReviewError, SqliteStateRepository, commitSelectedProjectChanges, createCodexlyServer, normalizeAllowedHost, readProjectGitCommitFileDiff, readProjectGitCommitFiles } from '../chunk-NAHIDASP.js';
+export { AccessSessionService, AgentEventStream, GitCommitError, GitCommitReviewError, SqliteStateRepository, commitSelectedProjectChanges, createCodexlyServer, normalizeAllowedHost, readProjectGitCommitFileDiff, readProjectGitCommitFiles } from '../chunk-7XFCPPAG.js';
 import '../chunk-DEKHLAWT.js';
-import '../chunk-CGZ44LHJ.js';
+import '../chunk-HEWCIXCQ.js';
 import '../chunk-RNTA4MFS.js';
 import '../chunk-TEWPWZPG.js';
 import '../chunk-K6J42667.js';