@epoch-agent/server 0.10.1 → 0.11.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { Lang, WireSkillImportFailure, WireSkillImportForm, WireSkillRemoveFailure, WireSkillStageFailure, WireProjectInventory, WireCapabilitiesResponse, WireSkillBodyResponse, EpochUserContent, AgentEvent, WireEnvelope, CustomCommandDef, ExpandedCommand, ModelRef, SetSelectionResult, WireCommandExpansion, WireCustomCommand, WireGoalPhase, WireGoalRefusal, WireTurnState, WireSessionFinish, ApprovalOutcome, QuestionAnswer, SessionSurfaceView, WireSessionReference, WireFileReference, ProviderType, ModelSelectionOrigin, WireModelCaveat, WireModelRejection, ContextBreakdown, PermissionLevel, WirePermissionRememberFailure, WirePluginSourceType, WirePluginVisibility, WirePluginStatus, WirePluginRefuseReason, WirePluginUploadFieldName, WirePluginUploadFields, WirePluginEntry, WireModelSource, WireModelProbeStatus, ScheduleDefinition, ScheduleRun, ScheduleBackendKind, OperationType, ScheduleTrigger, WireScheduleIssue, ScheduleRunStatus, TrustLevel, WireSandboxReason, WireAuditOutcome, WireAuditCode, WireCachedApproval, WireCachedDecision, WireToolVerdict, WireToolGateAxis, WireSecurityResponse, WireRewindScope, WireRewindRequest, WireCheckpointSummary, WireRewindPreview, WireRewindResponse, ActiveAgentRole, WireSettingValue, WireSettingLayer, WireSettingWriteLayer, WireSettingFutile, WireSettingApply, WireSettingValueKind, WireSettingsResponse, EpochConfig, TokenUsage, WireCompressionLine, WireProviderSummary, WireToolSummary, Diagnostic, WireReplayMessage, WireFileChange, WireAuthGuard, WireWorkspaceDiffResponse, BackgroundTaskInfo, WireTasksResponse, WireBackgroundTask, WireScheduleRow } from '@epoch-agent/protocol';
-import { SerializableApprovalRequest, SerializableQuestionRequest, ApprovalRevokeResult, LevelChangeResult, WorkspaceFilesView } from '@epoch-agent/runtime';
+import { Lang, WireSkillImportFailure, WireSkillImportForm, WireSkillRemoveFailure, WireSkillStageFailure, WireProjectInventory, WireCapabilitiesResponse, WireSkillBodyResponse, EpochUserContent, AgentEvent, WireEnvelope, CustomCommandDef, ExpandedCommand, ModelRef, SetSelectionResult, WireCommandExpansion, WireCustomCommand, WireGoalPhase, WireGoalRefusal, WireTurnState, WireSessionFinish, ApprovalOutcome, QuestionAnswer, SessionSurfaceView, WireSessionReference, WireFileReference, ProviderType, ModelSelectionOrigin, WireModelCaveat, WireModelRejection, ContextBreakdown, PermissionLevel, WirePermissionRememberFailure, WirePluginSourceType, WirePluginVisibility, WirePluginStatus, WirePluginRefuseReason, WirePluginUploadForm, WirePluginUploadFieldName, WirePluginUploadFields, WirePluginEntry, WireModelSource, WireModelProbeStatus, ScheduleDefinition, ScheduleRun, ScheduleBackendKind, OperationType, ScheduleTrigger, WireScheduleIssue, ScheduleRunStatus, TrustLevel, WireSandboxReason, WireAuditOutcome, WireAuditCode, WireCachedApproval, WireCachedDecision, WireToolVerdict, WireToolGateAxis, WireSecurityResponse, WireRewindScope, WireRewindRequest, WireCheckpointSummary, WireRewindPreview, WireRewindResponse, ActiveAgentRole, WireSettingValue, WireSettingLayer, WireSettingWriteLayer, WireSettingFutile, WireSettingApply, WireSettingValueKind, WireSettingsResponse, EpochConfig, TokenUsage, WireCompressionLine, WireProviderSummary, WireToolSummary, Diagnostic, WireReplayMessage, WireFileChange, WireAuthGuard, WireWorkspaceDiffResponse, BackgroundTaskInfo, WireTasksResponse, WireBackgroundTask, WireScheduleRow } from '@epoch-agent/protocol';
+import { SerializableApprovalRequest, SerializableQuestionRequest, RunningSchedule, ApprovalRevokeResult, LevelChangeResult, LastOpenSessionControl, WorkspaceFilesView } from '@epoch-agent/runtime';
 import { ServerResponse } from 'node:http';
 
 /**
@@ -2869,6 +2869,21 @@ type UploadPreviewOutcomeView = {
     ok: true;
     plan: PackPlanView;
     token: string;
+    /**
+     * 那张表单每一格**从什么值开始**（2026-09-15）。
+     *
+     * ⚠️ **这一层原样转，一格都不算**（口径同这个文件头那句「一条策略判断
+     * 都没有」）：四档优先级（宿主锁死 > 宿主初值 > 包里同名格 > 空）在
+     * runtime 的 `resolveUploadPrefill` 上，在这儿兜一次的表现是同一格
+     * 在两处得出两个值。
+     *
+     * ⚠️ 键取自 `WirePluginUploadFieldName` 而不是自造一套：这一份最终原样
+     * 落到 `WirePluginUploadPreviewResponse.prefill` 上，两套名字会逼出一张
+     * 会错的映射表（判据同 runtime 的 `PLUGIN_UPLOAD_FIELDS`）。
+     */
+    prefill: WirePluginUploadForm;
+    /** {@link prefill} 里值是从包里读出来的那几格。只管屏幕上那一句提示 */
+    fromManifest: readonly WirePluginUploadFieldName[];
 } | RefusalView;
 /**
  * 上传的结局。
@@ -3259,6 +3274,13 @@ interface ScheduleControlView {
     runs: (id: string, limit?: number) => ScheduleRun[];
     /** 全部任务的最近运行 —— 「运行记录」那个 tab 的素材 */
     recentRuns: (limit?: number) => ScheduleRun[];
+    /**
+     * **此刻**哪几条在跑（2026-09-15）。素材是那张锁表，判定（心跳 + pid）留在 core。
+     *
+     * ⚠️ **它和上面两格答的不是同一个问题**：那两格要等一轮**跑完**才有行
+     * （执行器收尾时才 `recordRun`），所以「正在跑」在它们眼里是不存在的。
+     */
+    running: () => readonly RunningSchedule[];
     capability: () => Promise<ScheduleCapabilityView>;
     create: (input: ScheduleCreateView, opts?: {
         register?: boolean;
@@ -4252,6 +4274,13 @@ interface CatalogRow {
     workspaceState?: 'bound' | 'none';
     /** `workspaceState === 'bound'` 那一档的目录 */
     workspaceRoot?: string;
+    /**
+     * 被收进归档了吗（方案 64 PR-2）。
+     *
+     * **必填**：这一列从会话库 v1 起就有、`NOT NULL DEFAULT 0`，
+     * 每一行都答得出。上面那两格可选说的是另一件事（v7 之前的老行没记过）。
+     */
+    archived: boolean;
 }
 /** 一条 FTS5 命中 —— runtime 的 `SessionHit` 结构上满足它 */
 interface CatalogHit {
@@ -4273,9 +4302,17 @@ interface CatalogDeletion {
  * 起不来（SQLite 挂了）时整个是 `null`，列表退化成「只有 Hub 里那几个」。
  */
 interface SessionCatalog {
-    list(limit?: number): CatalogRow[];
+    /**
+     * ⚠️ `archived` 是三态（方案 64 PR-2）：不给 = 只列没归档的，
+     * `true` = **只**列归档的。判据同 runtime 的 `SessionControl.list`。
+     */
+    list(limit?: number, opts?: {
+        archived?: boolean;
+    }): CatalogRow[];
     get(sessionId: string): CatalogRow | null;
     rename(sessionId: string, title: string): CatalogRow | null;
+    /** 收进归档 / 取回。**不是删除** —— 判据在 runtime 的 `SessionControl.setArchived` 上 */
+    setArchived(sessionId: string, archived: boolean): CatalogRow | null;
     delete(sessionId: string): Promise<CatalogDeletion>;
     search(query: string, limit?: number): CatalogHit[];
 }
@@ -4704,6 +4741,22 @@ interface WebRuntimeView extends RuntimeCapabilities, RuntimeSecurity, RuntimeSe
      * 而 DELETE / PATCH 回 503 —— 不是假装成功。
      */
     sessions: SessionCatalog | null;
+    /**
+     * 「这个项目上次停在哪段会话」（2026-09-14）。`EpochRuntime.lastOpenSession`
+     * 结构上正好满足它。
+     *
+     * ## ⚠️ 可选，而这一档和 `sessions` 那个 `| null` 不是同一种「没有」
+     *
+     * 那一格是「SQLite 起不来」（这个进程有这项能力，只是坏了）。这一格是
+     * **自己手拼 `WebRuntimeView` 的宿主压根没给** —— 嵌入宿主和
+     * `__tests__/harness.ts` 里那份假 runtime 都是手拼的，写成必填等于这一笔
+     * 改动把它们全打断，而它们不给这一格照样能跑（首屏退回引导会话，逐字等于
+     * 这一轮之前的行为）。
+     *
+     * 没给时：`GET /api/config` 不带 `lastSessionId`，`PUT /api/last-session`
+     * 回 503 —— **不是假装记下来了**（同 `sessions` 为 null 时那两条的口径）。
+     */
+    lastOpenSession?: LastOpenSessionControl;
     /**
      * `@:` 引用另一段会话那一片（方案 53 PR-4）。SQLite 起不来时为 null。
      * `EpochRuntime.sessionReferences` 结构上正好满足它。
@@ -5467,12 +5520,13 @@ declare function toWireTask(sessionId: string, info: BackgroundTaskInfo, registr
 declare function collectTasks(sessionId: string, registry: TaskRegistryView): WireTasksResponse;
 
 /**
- * 定时任务那十条端点（[方案 45](../../../../docs/verify/VERIFY_RECORD-45-automation.md)
- * PR-3 九条 + PR-4 那条 `pending`）。
+ * 定时任务那十一条端点（[方案 45](../../../../docs/verify/VERIFY_RECORD-45-automation.md)
+ * PR-3 九条 + PR-4 那条 `pending` + 2026-09-15 那条 `running`）。
  *
  * ```
  * GET    /api/schedules                              两个 tab 一次取齐
  * GET    /api/schedules/pending                      还欠着的那几张欠条（PR-4）
+ * GET    /api/schedules/running                      此刻哪几条在跑（2026-09-15）
  * POST   /api/schedules                              建一条
  * GET    /api/schedules/:id                          一条的全部字段
  * PATCH  /api/schedules/:id                          改一条（含那个开关）

package/dist/index.js

@@ -1,7 +1,7 @@
 import { createServer } from 'http';
 import { createLogger, t, ApprovalRelay, QuestionRelay, serializeStream, withRoleScope, withModelScope, withToolScope, nextRunAt, observeBackgroundTasks, skillIndexDescription, SANDBOX_EXCLUDES, SANDBOX_COVERS, isSystemOpenable, backgroundTaskOutput, listBackgroundTasks, providerLabel, MAX_REASON_CHARS, MAX_OBJECTIVE_CHARS, MAX_GOAL_MAX_ROUNDS, DEFAULT_GOAL_MAX_ROUNDS, SCHEDULE_DEFAULT_ALLOWLIST, SCHEDULE_DEFAULTS, coalesceRecording, readRecording } from '@epoch-agent/runtime';
 import { timingSafeEqual, randomBytes } from 'crypto';
-import { PLAN_OUTCOMES, WIRE_AUTH_COOKIE, WIRE_AUTH_COOKIE_ATTRS, WIRE_AUTH_TOKEN_PARAM, extractAllMentions, MAX_ATTACH_FILES, utf8ByteLength, MAX_SESSION_REFS, attachSessionSurface, isWireRewindScope, WIRE_REWIND_SCOPES, mcpConnectorState, MAX_ATTACH_TOTAL_BYTES, MAX_ATTACH_BYTES, truncateToBudget, WIRE_LANG_PARAM, isLang, isQuestionAnswerMap, isProviderType, apiKeyEnvVar, WIRE_FILE_STAT_MAX, WIRE_SETTING_WRITE_LAYERS, isWirePlanAction, WIRE_PLAN_ACTIONS, isPermissionLevel, PERMISSION_LEVELS, conformsToWire, WIRE_TRUST_REQUEST_FIELDS, WIRE_FORGET_WORKSPACE_FIELDS, collectPendingApprovals, unfixedRules, isWireSettingWriteLayer, parseModelRef, WIRE_GOAL_ACTIONS, OPERATION_TYPES, isOperationType, WIRE_PLUGIN_UPLOAD_FORM_FIELDS } from '@epoch-agent/protocol';
+import { PLAN_OUTCOMES, WIRE_AUTH_COOKIE, WIRE_AUTH_COOKIE_ATTRS, WIRE_AUTH_TOKEN_PARAM, extractAllMentions, MAX_ATTACH_FILES, utf8ByteLength, MAX_SESSION_REFS, attachSessionSurface, isWireRewindScope, WIRE_REWIND_SCOPES, mcpConnectorState, MAX_ATTACH_TOTAL_BYTES, MAX_ATTACH_BYTES, truncateToBudget, WIRE_LANG_PARAM, isLang, conformsToWire, WIRE_LAST_SESSION_FIELDS, isQuestionAnswerMap, isProviderType, apiKeyEnvVar, WIRE_FILE_STAT_MAX, WIRE_SETTING_WRITE_LAYERS, isWirePlanAction, WIRE_PLAN_ACTIONS, isPermissionLevel, PERMISSION_LEVELS, WIRE_TRUST_REQUEST_FIELDS, WIRE_FORGET_WORKSPACE_FIELDS, collectPendingApprovals, unfixedRules, isWireSettingWriteLayer, parseModelRef, WIRE_GOAL_ACTIONS, OPERATION_TYPES, isOperationType, WIRE_PLUGIN_UPLOAD_FORM_FIELDS } from '@epoch-agent/protocol';
 import { resolve, join, relative, isAbsolute, sep, dirname, basename, extname } from 'path';
 import { existsSync, realpathSync, statSync, mkdirSync, createReadStream, readdirSync, createWriteStream, accessSync, constants } from 'fs';
 import { stat, readFile, rm } from 'fs/promises';
@@ -376,6 +376,7 @@ function toWireSummary(id, hub, row, extra = {}) {
     turnStartedAt: state.turnStartedAt,
     lastFinish: state.lastFinish,
     role: extra.role ?? null,
+    archived: row?.archived ?? false,
     ...extra.snippet === void 0 ? {} : { snippet: extra.snippet }
   };
 }
@@ -388,7 +389,7 @@ function toWireSummaryWorkspace(bound, live, row) {
   }
   return row?.workspaceState === "none" ? { state: "none" } : { state: "unknown" };
 }
-function listSessionSummaries(hubStates, catalog, query, workspaceOf = () => null, roleOf = () => null, limit = DEFAULT_SESSION_LIST_LIMIT) {
+function listSessionSummaries(hubStates, catalog, query, workspaceOf = () => null, roleOf = () => null, limit = DEFAULT_SESSION_LIST_LIMIT, archived = false) {
   const byId = new Map(hubStates.map((s) => [s.id, s]));
   if (query) {
     if (!catalog) return [];
@@ -407,7 +408,7 @@ function listSessionSummaries(hubStates, catalog, query, workspaceOf = () => nul
     }
     return hits;
   }
-  const rows = catalog?.list(limit) ?? [];
+  const rows = catalog?.list(limit, archived ? { archived: true } : {}) ?? [];
   const summaries = rows.map(
     (row) => toWireSummary(row.id, byId.get(row.id), row, {
       workspace: workspaceOf(row.id),
@@ -415,7 +416,9 @@ function listSessionSummaries(hubStates, catalog, query, workspaceOf = () => nul
     })
   );
   const known = new Set(rows.map((r) => r.id));
-  const fresh = hubStates.filter((s) => !known.has(s.id)).map((s) => toWireSummary(s.id, s, null, { workspace: workspaceOf(s.id), role: roleOf(s.id) }));
+  const fresh = archived ? [] : hubStates.filter((s) => !known.has(s.id)).filter((s) => catalog?.get(s.id)?.archived !== true).map(
+    (s) => toWireSummary(s.id, s, null, { workspace: workspaceOf(s.id), role: roleOf(s.id) })
+  );
   return [...fresh, ...summaries].sort(compareSummaries).slice(0, limit);
 }
 function compareSummaries(a, b) {
@@ -1604,11 +1607,18 @@ var APPROVAL_OUTCOMES = /* @__PURE__ */ new Set([
 function health(ctx, res) {
   sendJson(res, 200, { ok: true, version: ctx.version });
 }
+function lastSessionField(ctx) {
+  const recorded = ctx.runtime.lastOpenSession?.get();
+  if (!recorded) return {};
+  if (!ctx.hub.has(recorded) && !ctx.runtime.sessions?.get(recorded)) return {};
+  return { lastSessionId: recorded };
+}
 function config(ctx, res, lang) {
   const { runtime } = ctx;
   const bound = runtime.workspaces.of(runtime.sessionId);
   sendJson(res, 200, {
     sessionId: runtime.sessionId,
+    ...lastSessionField(ctx),
     model: runtime.config.model,
     permission: runtime.config.permission,
     workspace: bound ? toWireSessionWorkspace(bound) : null,
@@ -1638,13 +1648,15 @@ function config(ctx, res, lang) {
     nativeDirPicker: ctx.nativeDirPicker
   });
 }
-function listSessions(ctx, res, query, _lang) {
+function listSessions(ctx, res, query, _lang, archived = false) {
   const sessions = listSessionSummaries(
     ctx.hub.listSessions(),
     ctx.runtime.sessions,
     query ?? null,
     (id) => ctx.runtime.workspaces.of(id),
-    (id) => ctx.runtime.sessionFactory.get(id)?.role ?? null
+    (id) => ctx.runtime.sessionFactory.get(id)?.role ?? null,
+    void 0,
+    archived
   );
   sendJson(res, 200, { sessions });
 }
@@ -1686,9 +1698,16 @@ async function deleteSession(ctx, res, sessionId, lang) {
 async function patchSession(ctx, req, res, sessionId, lang) {
   const body = await readJsonBody(req, void 0, lang);
   if (!body.ok) return sendError(res, body.status, "bad-body", body.message);
-  const raw = asRecord(body.value).title;
-  const title = typeof raw === "string" ? raw.trim() : "";
-  if (title.length === 0) {
+  const fields = asRecord(body.value);
+  const rawTitle = fields["title"];
+  const rawArchived = fields["archived"];
+  const wantsTitle = rawTitle !== void 0;
+  const wantsArchive = typeof rawArchived === "boolean";
+  if (!wantsTitle && !wantsArchive) {
+    return sendError(res, 400, "bad-patch", t("web.patch_needs_field", void 0, lang));
+  }
+  const title = typeof rawTitle === "string" ? rawTitle.trim() : "";
+  if (wantsTitle && title.length === 0) {
     return sendError(res, 400, "bad-title", t("web.title_required", void 0, lang));
   }
   const catalog = ctx.runtime.sessions;
@@ -1700,7 +1719,8 @@ async function patchSession(ctx, req, res, sessionId, lang) {
       t("web.session_store_unavailable", void 0, lang)
     );
   }
-  const row = catalog.rename(sessionId, title);
+  let row = wantsTitle ? catalog.rename(sessionId, title) : catalog.get(sessionId);
+  if (row && wantsArchive) row = catalog.setArchived(sessionId, rawArchived);
   if (!row) return sendUnknownSession(res, sessionId, lang);
   const hub = ctx.hub.listSessions().find((s) => s.id === sessionId);
   sendJson(res, 200, {
@@ -2284,6 +2304,32 @@ function listBlockedGoals(ctx, res, _lang) {
   );
   sendJson(res, 200, { items });
 }
+async function putLastSession(ctx, req, res, lang) {
+  const control = ctx.runtime.lastOpenSession;
+  if (!control) {
+    return sendError(
+      res,
+      503,
+      "no-last-session-store",
+      t("web.last_session_unavailable", {}, lang)
+    );
+  }
+  const body = await readJsonBody(req, void 0, lang);
+  if (!body.ok) return sendError(res, body.status, "bad-body", body.message);
+  if (!conformsToWire(body.value, WIRE_LAST_SESSION_FIELDS)) {
+    return sendError(res, 400, "bad-request", t("web.last_session_bad_request", {}, lang));
+  }
+  const { sessionId } = body.value;
+  if (typeof sessionId !== "string" || sessionId.length === 0) {
+    return sendError(res, 400, "bad-request", t("web.last_session_bad_request", {}, lang));
+  }
+  if (!ctx.hub.has(sessionId) && !ctx.runtime.sessions?.get(sessionId)) {
+    return sendUnknownSession(res, sessionId, lang);
+  }
+  const failure = control.set(sessionId);
+  if (failure) return sendError(res, 500, "write-failed", failure(lang));
+  sendJson(res, 200, { ok: true });
+}
 function readConfig(ctx, res, lang) {
   if (ctx.lanExposed) return sendLanExposed(res, lang);
   const outcome = ctx.runtime.mcp.readConfig();
@@ -2959,6 +3005,8 @@ function sendUploadPreview(res, outcome) {
       ok: false,
       plan: null,
       token: null,
+      prefill: null,
+      fromManifest: null,
       reason: outcome.reason,
       detail: outcome.detail
     });
@@ -2977,6 +3025,8 @@ function sendUploadPreview(res, outcome) {
       skippedLinks: [...skippedLinks]
     },
     token: outcome.token,
+    prefill: outcome.prefill,
+    fromManifest: [...outcome.fromManifest],
     reason: null,
     detail: null
   });
@@ -3361,6 +3411,12 @@ function listPending(ctx, res, lang) {
   const items = collectPendingApprovals(control.list(), control.recentRuns(RECENT_RUNS_LIMIT));
   sendJson(res, 200, { items });
 }
+function listRunning(ctx, res, lang) {
+  const control = schedulesOf(ctx, res, lang);
+  if (!control) return;
+  const items = control.running().map(({ scheduleId, startedAt }) => ({ scheduleId, startedAt }));
+  sendJson(res, 200, { items });
+}
 function getSchedule(ctx, res, id, lang) {
   const control = schedulesOf(ctx, res, lang);
   if (!control) return;
@@ -3394,10 +3450,20 @@ async function patchSchedule(ctx, req, res, id, lang) {
   if (!body.ok) return sendError(res, body.status, "bad-body", body.message);
   const parsed = parseUpdate2(body.value, lang);
   if (!parsed.ok) return sendError(res, 400, "bad-schedule", parsed.message);
-  const saved = await control.update(id, parsed.value, {
-    bypassAcknowledged: bypassAcknowledged(body.value)
-  });
-  sendJson(res, 200, toSaveResponse(control, saved));
+  const { enabled, ...rest } = parsed.value;
+  const saved = Object.keys(rest).length > 0 ? await control.update(id, rest, { bypassAcknowledged: bypassAcknowledged(body.value) }) : { issues: [] };
+  if (saved.issues.length > 0) return sendJson(res, 200, toSaveResponse(control, saved));
+  const registration = enabled === void 0 ? saved.registration : await control.setEnabled(id, enabled);
+  const next = control.get(id) ?? saved.schedule;
+  sendJson(
+    res,
+    200,
+    toSaveResponse(control, {
+      ...next ? { schedule: next } : {},
+      issues: [],
+      ...registration ? { registration } : {}
+    })
+  );
 }
 async function deleteSchedule(ctx, res, id, lang) {
   const control = schedulesOf(ctx, res, lang);
@@ -4738,6 +4804,9 @@ async function handleApi(opts, req, res, method, segments, lang) {
     return config(ctx, res, lang);
   }
   if (resource === "events" && method === "GET") return openStream(opts, req, res);
+  if (resource === "last-session" && first === void 0 && method === "PUT") {
+    return putLastSession(ctx, req, res, lang);
+  }
   if (resource === "sessions") {
     return handleSessions(opts, req, res, method, first, second, detail, lang);
   }
@@ -4865,6 +4934,10 @@ async function handleSchedules(ctx, req, res, method, scheduleId, action, runId,
     if (isRead(method)) return listPending(ctx, res, lang);
     return methodNotAllowed(res, "GET", lang);
   }
+  if (action === void 0 && scheduleId === "running") {
+    if (isRead(method)) return listRunning(ctx, res, lang);
+    return methodNotAllowed(res, "GET", lang);
+  }
   if (action === void 0) {
     if (isRead(method)) return getSchedule(ctx, res, scheduleId, lang);
     if (method === "PATCH") return patchSchedule(ctx, req, res, scheduleId, lang);
@@ -4888,7 +4961,9 @@ async function handleSchedules(ctx, req, res, method, scheduleId, action, runId,
 async function handleSessions(opts, req, res, method, sessionId, action, detail, lang) {
   const { ctx } = opts;
   if (sessionId === void 0) {
-    if (isRead(method)) return listSessions(ctx, res, searchQuery(req.url));
+    if (isRead(method)) {
+      return listSessions(ctx, res, searchQuery(req.url), lang, archivedFlag(req.url));
+    }
     if (method === "POST") return createSession(ctx, req, res, lang);
     return methodNotAllowed(res, "GET, POST", lang);
   }
@@ -5025,6 +5100,10 @@ function searchQuery(rawUrl) {
   const value = new URL(rawUrl ?? "/", "http://127.0.0.1").searchParams.get("q")?.trim();
   return value ? value : void 0;
 }
+function archivedFlag(rawUrl) {
+  const raw = new URL(rawUrl ?? "/", "http://127.0.0.1").searchParams.get("archived");
+  return raw === "1" || raw === "true";
+}
 function redirectWithoutToken(res, rawUrl) {
   const url = new URL(rawUrl ?? "/", "http://127.0.0.1");
   url.searchParams.delete(WIRE_AUTH_TOKEN_PARAM);