talon-agent 4.3.2 → 4.4.0

package/src/core/engine/model-audit.ts

@@ -19,7 +19,7 @@
  */
 
 import type { Backend } from "../agent-runtime/capabilities.js";
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../config/index.js";
 import type { ReasoningEffortLevel } from "../types.js";
 import {
   normalizeReasoningLevels,

package/src/core/{notify.ts → frontend-runtime/admin-notify.ts}

@@ -14,7 +14,7 @@
  * watches. Alerts about a dead frontend must travel over a LIVE one.
  */
 
-import { log, logWarn } from "./../util/log.js";
+import { log, logWarn } from "../../util/log.js";
 
 let deliver: ((text: string) => Promise<void>) | null = null;
 

package/src/core/frontend-runtime/capabilities.ts

@@ -25,7 +25,7 @@
  */
 
 import type { ContextManager } from "../types.js";
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../config/index.js";
 import type { Gateway } from "../engine/gateway.js";
 import type { FrontendDescriptor } from "./registry.js";
 

package/src/core/models/active-model.ts

@@ -73,7 +73,7 @@ import {
   type ModelSource,
 } from "../agent-runtime/model-ref.js";
 import type { UnifiedModelInfo } from "../types.js";
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../config/index.js";
 import { logWarn } from "../../util/log.js";
 
 /**

package/src/core/plugin/builtins.ts

@@ -4,7 +4,7 @@
  */
 
 import { log, logError, logWarn } from "../../util/log.js";
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../config/index.js";
 import { registry, reloadState } from "./registry.js";
 import type { ProvisionOutcome } from "./provision.js";
 import { NATIVE_RUNTIMES, type NativePluginId } from "./native-runtimes.js";
@@ -226,7 +226,7 @@ export async function reloadPlugins(
 ): Promise<{ names: string[]; config: TalonConfig }> {
   // Validate config BEFORE tearing down existing plugins. If the config is
   // malformed the error propagates and current plugins stay intact.
-  const { loadConfig, getFrontends } = await import("../../util/config.js");
+  const { loadConfig, getFrontends } = await import("../config/index.js");
   const config = loadConfig();
 
   // Derive frontends from config if not explicitly provided

package/src/core/plugin/manage.ts

@@ -8,7 +8,7 @@
  * talon.json so the surface owns its own write path.
  */
 
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../config/index.js";
 import { isPathPlugin, type PluginEntry } from "./types.js";
 import {
   BUILTIN_PLUGINS,

package/src/core/plugin/native-runtimes.ts

@@ -13,7 +13,7 @@
  * import-cheap for consumers that only need the id list.
  */
 
-import type { DoctorCheck } from "../doctor.js";
+import type { DoctorCheck } from "../doctor/index.js";
 import type { ProvisionOutcome } from "./provision.js";
 import type { MempalaceSection } from "../../plugins/mempalace/provision.js";
 import type { PlaywrightSection } from "../../plugins/playwright/provision.js";

package/src/frontend/discord/admin.ts

@@ -9,7 +9,7 @@
 import { readFileSync } from "node:fs";
 import { files, dirs } from "../../util/paths.js";
 import { tailFile } from "../../util/tail-file.js";
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../../core/config/index.js";
 import type { Gateway } from "../../core/engine/gateway.js";
 import { resetSession, getAllSessions } from "../../storage/sessions.js";
 import { clearHistory } from "../../storage/history.js";

package/src/frontend/discord/callbacks/components/index.ts

@@ -22,7 +22,7 @@
  */
 
 import { MessageFlags } from "discord.js";
-import type { TalonConfig } from "../../../../util/config.js";
+import type { TalonConfig } from "../../../../core/config/index.js";
 import type { Gateway } from "../../../../core/engine/gateway.js";
 import { deriveNumericChatId } from "../../../../util/chat-id.js";
 import { logError } from "../../../../util/log.js";

package/src/frontend/discord/callbacks/components/settings.ts

@@ -15,7 +15,7 @@ import {
   StringSelectMenuBuilder,
   MessageFlags,
 } from "discord.js";
-import type { TalonConfig } from "../../../../util/config.js";
+import type { TalonConfig } from "../../../../core/config/index.js";
 import type { Gateway } from "../../../../core/engine/gateway.js";
 import {
   getChatSettings,

package/src/frontend/discord/callbacks/components/types.ts

@@ -12,7 +12,7 @@ import type {
   ButtonInteraction,
   StringSelectMenuInteraction,
 } from "discord.js";
-import type { TalonConfig } from "../../../../util/config.js";
+import type { TalonConfig } from "../../../../core/config/index.js";
 import type { Gateway } from "../../../../core/engine/gateway.js";
 
 export type ComponentInteraction =

package/src/frontend/discord/callbacks/modals.ts

@@ -3,7 +3,7 @@
  */
 
 import { type ModalSubmitInteraction, MessageFlags } from "discord.js";
-import type { TalonConfig } from "../../../util/config.js";
+import type { TalonConfig } from "../../../core/config/index.js";
 import type { Gateway } from "../../../core/engine/gateway.js";
 import { setChatPulseInterval } from "../../../storage/chat-settings.js";
 import { registerChat, enablePulse } from "../../../core/background/pulse.js";

package/src/frontend/discord/commands/admin.ts

@@ -10,7 +10,7 @@ import {
   ButtonStyle,
   MessageFlags,
 } from "discord.js";
-import type { TalonConfig } from "../../../util/config.js";
+import type { TalonConfig } from "../../../core/config/index.js";
 import type { Gateway } from "../../../core/engine/gateway.js";
 import { respawnSelf } from "../../../util/respawn.js";
 import { forceDream } from "../../../core/background/dream.js";
@@ -19,7 +19,7 @@ import {
   renderMetricsMessages,
   renderDoctorMessages,
 } from "../render.js";
-import { collectDoctorReport } from "../../../core/doctor.js";
+import { collectDoctorReport } from "../../../core/doctor/index.js";
 import { getSoul } from "../../../core/soul/service.js";
 import { getMetrics, getTodayMetrics } from "../../../storage/metrics.js";
 import { handleAdminSubcommand } from "../admin.js";

package/src/frontend/discord/commands/definitions.ts

@@ -13,7 +13,7 @@
  */
 
 import { type Client, REST, Routes, SlashCommandBuilder } from "discord.js";
-import type { TalonConfig } from "../../../util/config.js";
+import type { TalonConfig } from "../../../core/config/index.js";
 import { log, logError, logWarn } from "../../../util/log.js";
 import { getRepoRoot } from "../../../core/update/self-update.js";
 

package/src/frontend/discord/commands/info.ts

@@ -12,7 +12,7 @@ import {
   renderMeshReport,
   renderUsageMessage,
 } from "../render.js";
-import type { TalonConfig } from "../../../util/config.js";
+import type { TalonConfig } from "../../../core/config/index.js";
 import { collectPlanUsage } from "../../shared/plan-usage-report.js";
 import { getLoadedPlugins } from "../../../core/plugin/index.js";
 import { getMeshService } from "../../../core/mesh/index.js";

package/src/frontend/discord/commands/router.ts

@@ -9,7 +9,7 @@ import {
   type Interaction,
   MessageFlags,
 } from "discord.js";
-import type { TalonConfig } from "../../../util/config.js";
+import type { TalonConfig } from "../../../core/config/index.js";
 import type { Gateway } from "../../../core/engine/gateway.js";
 import { logError } from "../../../util/log.js";
 import {

package/src/frontend/discord/commands/session.ts

@@ -6,7 +6,7 @@
  */
 
 import { type ChatInputCommandInteraction, MessageFlags } from "discord.js";
-import type { TalonConfig } from "../../../util/config.js";
+import type { TalonConfig } from "../../../core/config/index.js";
 import type { Gateway } from "../../../core/engine/gateway.js";
 import {
   formatModelLabel,

package/src/frontend/discord/commands/settings.ts

@@ -10,7 +10,7 @@ import {
   StringSelectMenuBuilder,
   MessageFlags,
 } from "discord.js";
-import type { TalonConfig } from "../../../util/config.js";
+import type { TalonConfig } from "../../../core/config/index.js";
 import type { Gateway } from "../../../core/engine/gateway.js";
 import {
   getChatSettings,

package/src/frontend/discord/handlers/delivery.ts

@@ -5,7 +5,7 @@
  */
 
 import type { TextBasedChannel } from "discord.js";
-import type { TalonConfig } from "../../../util/config.js";
+import type { TalonConfig } from "../../../core/config/index.js";
 import { execute } from "../../../core/engine/dispatcher.js";
 import { toolInputToRecord } from "../../../core/agent-runtime/events.js";
 import { appendDailyLogResponse } from "../../../storage/daily-log.js";

package/src/frontend/discord/handlers/messages.ts

@@ -6,7 +6,7 @@
 
 import type { Client, Message } from "discord.js";
 import { ChannelType } from "discord.js";
-import type { TalonConfig } from "../../../util/config.js";
+import type { TalonConfig } from "../../../core/config/index.js";
 import { setMessageFilePath } from "../../../storage/history.js";
 import { addMedia } from "../../../storage/media-index.js";
 import { deriveNumericChatId } from "../../../util/chat-id.js";

package/src/frontend/discord/handlers/queue.ts

@@ -25,7 +25,7 @@ import {
   MAX_QUEUED_PER_CHAT,
   type QueuedMessage,
 } from "./state.js";
-import type { TalonConfig } from "../../../util/config.js";
+import type { TalonConfig } from "../../../core/config/index.js";
 
 export function enqueueMessage(
   config: TalonConfig,

package/src/frontend/discord/handlers/state.ts

@@ -6,7 +6,7 @@
  */
 
 import type { TextBasedChannel } from "discord.js";
-import type { TalonConfig } from "../../../util/config.js";
+import type { TalonConfig } from "../../../core/config/index.js";
 import {
   createDmUserTracker,
   createNoticeCooldown,

package/src/frontend/discord/index.ts

@@ -18,7 +18,7 @@
  * outbound, connection, and the handlers/commands/callbacks trees.
  */
 
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../../core/config/index.js";
 import type { ContextManager } from "../../core/types.js";
 import type { Gateway } from "../../core/engine/gateway.js";
 import { log } from "../../util/log.js";

package/src/frontend/discord/middleware.ts

@@ -16,7 +16,7 @@
 
 import type { Client, Message } from "discord.js";
 import { ChannelType } from "discord.js";
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../../core/config/index.js";
 import { pushMessage } from "../../storage/history.js";
 import { registerChat } from "../../core/background/pulse.js";
 import { deriveNumericChatId } from "../../util/chat-id.js";

package/src/frontend/discord/render.ts

@@ -14,7 +14,7 @@ import {
   DISCORD_SAFE_RESERVE,
   splitMessage,
 } from "./formatting.js";
-import type { DoctorReport } from "../../core/doctor.js";
+import type { DoctorReport } from "../../core/doctor/index.js";
 import type { MeshPingResult } from "../../core/mesh/service.js";
 import type { BackendUsageEntry } from "../shared/plan-usage-report.js";
 import {

package/src/frontend/discord/runtime.ts

@@ -9,7 +9,7 @@
  */
 
 import { Client, GatewayIntentBits, Partials } from "discord.js";
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../../core/config/index.js";
 import type { Gateway } from "../../core/engine/gateway.js";
 
 /** `config.discord`, narrowed once — the factory refuses to build without it. */

package/src/frontend/native/extensions.ts

@@ -23,7 +23,10 @@ import { getPluginPromptAdditions } from "../../core/plugin/index.js";
 import { listPluginItems, setPluginEnabled } from "../../core/plugin/manage.js";
 import { notifyPromptInputsChanged } from "../../core/prompt/invalidation.js";
 import { listSkills, setSkillEnabled } from "../../storage/skills.js";
-import { rebuildSystemPrompt, type TalonConfig } from "../../util/config.js";
+import {
+  rebuildSystemPrompt,
+  type TalonConfig,
+} from "../../core/config/index.js";
 import { log } from "../../util/log.js";
 import type { PluginItem, SkillItem, ToggleResult } from "./protocol.js";
 import { persistConfigPatch } from "./settings.js";

package/src/frontend/native/index.ts

@@ -14,7 +14,7 @@
  * delegate to — chat-wire, context, emit, turn, models, history, ….
  */
 
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../../core/config/index.js";
 import type { ContextManager } from "../../core/types.js";
 import type { Gateway } from "../../core/engine/gateway.js";
 import { log, logError } from "../../util/log.js";

package/src/frontend/native/runtime.ts

@@ -8,7 +8,7 @@
  * message-id minter and the broadcast sink; the modules own the behaviour.
  */
 
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../../core/config/index.js";
 import type { Gateway } from "../../core/engine/gateway.js";
 import { getMeshService, type MeshService } from "../../core/mesh/index.js";
 import { NativeChats } from "./chats.js";

package/src/frontend/native/settings.ts

@@ -14,7 +14,7 @@
 import { existsSync, readFileSync, mkdirSync } from "node:fs";
 import writeFileAtomic from "write-file-atomic";
 import { dirname } from "node:path";
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../../core/config/index.js";
 import { files as pathFiles } from "../../util/paths.js";
 import { setTimezone } from "../../util/time.js";
 import { resolveModel } from "../../core/models/catalog.js";

package/src/frontend/shared/model-commands.ts

@@ -10,7 +10,7 @@
  * about a socket, a bot API, or a keyboard.
  */
 
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../../core/config/index.js";
 import type { Backend } from "../../core/agent-runtime/capabilities.js";
 import type { ReasoningEffortLevel } from "../../core/types.js";
 import {

package/src/frontend/shared/plan-usage-report.ts

@@ -9,7 +9,7 @@
  * never silence.
  */
 
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../../core/config/index.js";
 import type { PlanUsage } from "../../core/agent-runtime/capabilities.js";
 import {
   listAvailableBackends,

package/src/frontend/shared/reasoning-levels.ts

@@ -4,7 +4,7 @@ import type {
 } from "../../core/types.js";
 import type { Backend } from "../../core/agent-runtime/capabilities.js";
 import { resolveActiveModelForChat } from "../../core/models/active-model.js";
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../../core/config/index.js";
 import {
   normalizeReasoningLevels,
   supportsReasoningLevel,

package/src/frontend/shared/session-status.ts

@@ -9,7 +9,7 @@
  * markup.
  */
 
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../../core/config/index.js";
 import type { Backend } from "../../core/agent-runtime/capabilities.js";
 import {
   resetSession,

package/src/frontend/teams/index.ts

@@ -12,7 +12,7 @@
  * chat-discovery, poll, commands, turn, outbound.
  */
 
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../../core/config/index.js";
 import type { ContextManager } from "../../core/types.js";
 import type { Gateway } from "../../core/engine/gateway.js";
 import { log } from "../../util/log.js";

package/src/frontend/teams/runtime.ts

@@ -7,7 +7,7 @@
  * poll, commands, turn, outbound) takes as its first parameter.
  */
 
-import type { TalonConfig } from "../../util/config.js";
+import type { TalonConfig } from "../../core/config/index.js";
 import type { Gateway } from "../../core/engine/gateway.js";
 import type { GraphClient } from "./graph.js";
 

package/src/frontend/telegram/actions/chat-info.ts

@@ -22,7 +22,7 @@ import {
   getOnlineCount as userbotOnlineCount,
 } from "../userbot.js";
 import { savePackToLibrary } from "../sticker-library.js";
-import { toPositiveId } from "./shared.js";
+import { toPositiveId } from "./coerce.js";
 import type { TelegramActionHandlers } from "./types.js";
 
 export const chatInfoHandlers: TelegramActionHandlers = {

package/src/frontend/telegram/actions/coerce.ts

@@ -0,0 +1,15 @@
+/**
+ * Id coercion for the Telegram action handlers.
+ */
+
+/**
+ * Telegram/GramJS APIs expect numeric IDs. `snowflakeOrIdSchema` normalizes IDs
+ * to digit-strings (so 17-19 digit Discord snowflakes survive validation), so a
+ * Telegram message/reply/offset ID can arrive here as a string. Coerce it back
+ * to a positive integer: Telegram IDs are well within 2^53, so this is lossless.
+ * Returns undefined for missing / non-positive / non-integer values.
+ */
+export function toPositiveId(v: unknown): number | undefined {
+  const n = typeof v === "number" ? v : typeof v === "string" ? Number(v) : NaN;
+  return Number.isInteger(n) && n > 0 ? n : undefined;
+}

package/src/frontend/telegram/actions/index.ts

@@ -22,10 +22,10 @@ import type { ActionResult } from "../../../core/types.js";
 import { messagingHandlers, restoreScheduledMessages } from "./messaging.js";
 import { mediaHandlers } from "./media.js";
 import { chatInfoHandlers } from "./chat-info.js";
-import { moderationHandlers } from "./moderation.js";
+import { moderationHandlers } from "./moderation/index.js";
 import type { TelegramActionContext, TelegramActionHandlers } from "./types.js";
 
-export { sendText } from "./shared.js";
+export { sendText } from "./send.js";
 
 // Null-prototype so a request `action` of "toString" / "constructor" / etc.
 // can't resolve an inherited Object.prototype method via `handlers[action]`.

package/src/frontend/telegram/actions/media.ts

@@ -9,7 +9,7 @@ import { expandFsPath } from "../../../util/fs-path.js";
 import { markdownToTelegramHtml } from "../formatting.js";
 import { withRetry } from "../../../core/engine/gateway.js";
 import { resolveStickerByEmoji } from "../sticker-library.js";
-import { replyParams, sendOpts } from "./shared.js";
+import { replyParams, sendOpts } from "./send.js";
 import type { TelegramActionHandlers } from "./types.js";
 
 type MediaSource = {

package/src/frontend/telegram/actions/messaging.ts

@@ -15,13 +15,12 @@ import {
   MAX_OVERDUE_MS,
   type ScheduledMessage,
 } from "../../../storage/scheduled.js";
+import { sendOpts, sendText } from "./send.js";
 import {
   noteRichMessageFailure,
   richMessagesAvailable,
-  sendOpts,
-  sendText,
-  toPositiveId,
-} from "./shared.js";
+} from "./rich-messages.js";
+import { toPositiveId } from "./coerce.js";
 import { resolveThreadId } from "../topics.js";
 import { TELEGRAM_MAX_TEXT, type TelegramActionHandlers } from "./types.js";
 

package/src/frontend/telegram/actions/moderation/chat.ts

@@ -0,0 +1,63 @@
+/**
+ * Chat-level ops — permissions, invite links, chat photo, unpin_all,
+ * leave_chat.
+ */
+
+import { toPositiveId } from "../coerce.js";
+import { resolveMediaInput } from "../media.js";
+import { toChatPermissions } from "./permissions.js";
+import type { ModerationOps } from "./types.js";
+
+export const chatOps: ModerationOps = {
+  set_permissions: async ({ body, chatId, ctx: { bot } }) => {
+    const raw = body.permissions;
+    if (!raw || typeof raw !== "object")
+      return { ok: false, error: "set_permissions: permissions required" };
+    await bot.api.setChatPermissions(
+      chatId,
+      toChatPermissions(raw as Record<string, boolean>),
+    );
+    return { ok: true };
+  },
+  create_invite_link: async ({ body, chatId, ctx: { bot } }) => {
+    const expireMin = Number(body.expire_minutes);
+    const link = await bot.api.createChatInviteLink(chatId, {
+      name: body.title ? String(body.title) : undefined,
+      expire_date:
+        Number.isFinite(expireMin) && expireMin > 0
+          ? Math.floor(Date.now() / 1000) + Math.round(expireMin * 60)
+          : undefined,
+      member_limit: toPositiveId(body.member_limit),
+    });
+    return { ok: true, invite_link: link.invite_link };
+  },
+  revoke_invite_link: async ({ body, chatId, ctx: { bot } }) => {
+    if (!body.link)
+      return { ok: false, error: "revoke_invite_link: link required" };
+    await bot.api.revokeChatInviteLink(chatId, String(body.link));
+    return { ok: true };
+  },
+  set_chat_photo: async ({ body, chatId, ctx: { bot, InputFileClass } }) => {
+    const resolved = resolveMediaInput(body, "set_chat_photo", InputFileClass);
+    if ("error" in resolved) return { ok: false, error: resolved.error };
+    if (typeof resolved.file === "string")
+      return {
+        ok: false,
+        error: "set_chat_photo needs a local file_path (no url/file_id)",
+      };
+    await bot.api.setChatPhoto(chatId, resolved.file);
+    return { ok: true };
+  },
+  delete_chat_photo: async ({ chatId, ctx: { bot } }) => {
+    await bot.api.deleteChatPhoto(chatId);
+    return { ok: true };
+  },
+  unpin_all: async ({ chatId, ctx: { bot } }) => {
+    await bot.api.unpinAllChatMessages(chatId);
+    return { ok: true };
+  },
+  leave_chat: async ({ chatId, ctx: { bot } }) => {
+    await bot.api.leaveChat(chatId);
+    return { ok: true };
+  },
+};

package/src/frontend/telegram/actions/moderation/index.ts

@@ -0,0 +1,74 @@
+/**
+ * Moderation actions — the `moderate` tool's member/chat/topic operations,
+ * plus profile-photo lookup.
+ *
+ * Handlers call the Bot API directly and let Telegram's own errors surface
+ * (missing admin rights come back as descriptive 400s the model can read);
+ * pre-checking rights here would just race the real check.
+ *
+ * `moderate` dispatches on `body.op` through the table below:
+ *   - `members` — ban / unban / mute / unmute / promote / demote /
+ *                 set_admin_title / *_join_request(s)
+ *   - `chat`    — set_permissions / *_invite_link / *_chat_photo /
+ *                 unpin_all / leave_chat
+ *   - `topics`  — create / edit / close / reopen / delete_topic
+ */
+
+import { toPositiveId } from "../coerce.js";
+import type { TelegramActionHandlers } from "../types.js";
+import { memberOps } from "./members.js";
+import { chatOps } from "./chat.js";
+import { topicOps } from "./topics.js";
+import type { ModerationOps } from "./types.js";
+
+// Null-prototype so an `op` of "toString" / "constructor" / etc. can't
+// resolve an inherited Object.prototype method via `ops[op]`.
+export const MODERATION_OPS: ModerationOps = Object.assign(
+  Object.create(null),
+  {
+    ...memberOps,
+    ...chatOps,
+    ...topicOps,
+  },
+);
+
+/** Ops that fail up front without a `user_id`. */
+export const OPS_NEEDING_USER = [
+  "ban",
+  "unban",
+  "mute",
+  "unmute",
+  "promote",
+  "demote",
+  "set_admin_title",
+  "approve_join_request",
+  "decline_join_request",
+];
+
+export const moderationHandlers: TelegramActionHandlers = {
+  moderate: async (body, chatId, ctx) => {
+    const op = String(body.op ?? "");
+    const userId = toPositiveId(body.user_id);
+    if (OPS_NEEDING_USER.includes(op) && userId === undefined)
+      return { ok: false, error: `${op}: user_id is required` };
+    const run = MODERATION_OPS[op];
+    if (!run) return { ok: false, error: `Unknown moderation op: ${op}` };
+    return run({ op, body, chatId, ctx, userId });
+  },
+
+  get_user_profile_photos: async (body, _chatId, { bot }) => {
+    const userId = toPositiveId(body.user_id);
+    if (userId === undefined)
+      return { ok: false, error: "user_id is required" };
+    const limit = toPositiveId(body.limit) ?? 5;
+    const photos = await bot.api.getUserProfilePhotos(userId, {
+      limit: Math.min(limit, 100),
+    });
+    return {
+      ok: true,
+      total: photos.total_count,
+      // Largest size of each photo; its file_id sends/downloads like media.
+      file_ids: photos.photos.map((sizes) => sizes[sizes.length - 1].file_id),
+    };
+  },
+};