talon-agent 4.3.1 → 4.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "talon-agent",
-  "version": "4.3.1",
+  "version": "4.3.3",
   "description": "Multi-frontend AI agent with full tool access, streaming, cron jobs, and plugin system",
   "author": "Dylan Neve",
   "license": "MIT",

package/src/app.ts

@@ -23,7 +23,7 @@ import {
   runStartupCatchup,
 } from "./core/background/cron.js";
 import { shutdownTriggers } from "./core/background/triggers/index.js";
-import { pruneSettledTriggers } from "./storage/trigger-store.js";
+import { pruneSettledTriggers } from "./storage/triggers.js";
 import { startWatchdog, stopWatchdog } from "./util/watchdog.js";
 import { spawnSuccessor } from "./util/respawn.js";
 import { log, logError, logWarn } from "./util/log.js";

package/src/backend/claude-sdk/doctor.ts

@@ -7,7 +7,7 @@
 import type {
   DoctorCheck,
   DoctorConfigSlice,
-} from "../../core/doctor-types.js";
+} from "../../core/doctor/types.js";
 import { getModels } from "../../core/models/catalog.js";
 import { binaryOnPath } from "../../util/binary-on-path.js";
 import { resolveModel } from "./model-provider.js";

package/src/backend/codex/doctor.ts

@@ -6,7 +6,7 @@
 import type {
   DoctorCheck,
   DoctorConfigSlice,
-} from "../../core/doctor-types.js";
+} from "../../core/doctor/types.js";
 import { binaryOnPath } from "../../util/binary-on-path.js";
 import { detectCodexAuth } from "./auth.js";
 

package/src/backend/openai-agents/doctor.ts

@@ -6,7 +6,7 @@
 import type {
   DoctorCheck,
   DoctorConfigSlice,
-} from "../../core/doctor-types.js";
+} from "../../core/doctor/types.js";
 
 export async function openAIAgentsDoctorChecks(
   config: DoctorConfigSlice | undefined,

package/src/bootstrap.ts

@@ -13,8 +13,8 @@ import { loadConfig, rebuildSystemPrompt } from "./util/config.js";
 import { initWorkspace } from "./util/workspace.js";
 import { loadSessions, resetSession } from "./storage/sessions.js";
 import { loadChatSettings } from "./storage/chat-settings.js";
-import { loadCronJobs } from "./storage/cron-store.js";
-import { loadTriggers } from "./storage/trigger-store.js";
+import { loadCronJobs } from "./storage/cron.js";
+import { loadTriggers } from "./storage/triggers.js";
 import { clearHistory, loadHistory } from "./storage/history.js";
 import { loadMediaIndex } from "./storage/media-index.js";
 import { cleanupOldLogs } from "./storage/daily-log.js";
@@ -27,7 +27,7 @@ import { appendToJournal } from "./storage/journal.js";
 import { initPulse, resetPulseTimer } from "./core/background/pulse.js";
 import { initCron } from "./core/background/cron.js";
 import { initPlanAlerts } from "./core/background/plan-alerts.js";
-import { setAdminNotifier } from "./core/notify.js";
+import { setAdminNotifier } from "./core/frontend-runtime/admin-notify.js";
 import { startAuthExpiryMonitor } from "./core/auth/expiry-monitor.js";
 import {
   initTriggers,

package/src/cli/doctor.ts

@@ -19,7 +19,7 @@ const DOCTOR_ICONS: Record<string, string> = {
 export async function runDoctor(): Promise<void> {
   printBanner();
   console.log(`  ${pc.bold("Environment check")}\n`);
-  const { collectDoctorReport } = await import("../core/doctor.js");
+  const { collectDoctorReport } = await import("../core/doctor/index.js");
   // Doctor composes each backend's own checks off the registry, and the
   // CLI runs standalone — nothing else has registered them yet.
   const { loadBuiltinBackends } = await import("../backend/builtins.js");

package/src/cli/skill.ts

@@ -2,7 +2,7 @@
  * `talon skill` — install / list / enable / disable / remove SKILL.md
  * workflow bundles.
  *
- * All lifecycle logic lives in storage/skill-store.ts; this module only
+ * All lifecycle logic lives in storage/skills.ts; this module only
  * resolves install sources and renders outcomes. Installs accept a local
  * folder, a git URL, or `owner/repo[/subpath]` (so `talon skill install
  * anthropics/skills/skills/pdf` works). A source folder either IS a skill
@@ -22,7 +22,7 @@ import {
   listSkills,
   setSkillEnabled,
   type Skill,
-} from "../storage/skill-store.js";
+} from "../storage/skills.js";
 import { cloneShallow, resolveSource } from "./install-sources.js";
 
 const USAGE = [

package/src/core/agent-runtime/backend-registry.ts

@@ -30,7 +30,7 @@
  */
 
 import type { Backend } from "./capabilities.js";
-import type { DoctorCheck, DoctorConfigSlice } from "../doctor-types.js";
+import type { DoctorCheck, DoctorConfigSlice } from "../doctor/types.js";
 import type { TalonConfig } from "../../util/config.js";
 
 // ── Types ───────────────────────────────────────────────────────────────────

package/src/core/auth/expiry-monitor.ts

@@ -9,7 +9,7 @@
  * fresh login clears it, so the next expiry warns again).
  */
 
-import { notifyAdmin } from "../notify.js";
+import { notifyAdmin } from "../frontend-runtime/admin-notify.js";
 import {
   daysUntil,
   PROVIDER_LABELS,

package/src/core/background/cron-spec.ts

@@ -18,7 +18,7 @@ import {
   type CatchupPolicy,
   type CronJob,
   type CronJobType,
-} from "../../storage/cron-store.js";
+} from "../../storage/cron.js";
 
 /** The scheduler ticks once a minute, so sub-minute intervals are meaningless. */
 const MIN_INTERVAL_SECONDS = 60;

package/src/core/background/cron.ts

@@ -31,7 +31,7 @@ import {
   describeSchedule,
   type CronJob,
   type CronRunOutcome,
-} from "../../storage/cron-store.js";
+} from "../../storage/cron.js";
 import { appendDailyLog } from "../../storage/daily-log.js";
 import { log, logError, logWarn } from "../../util/log.js";
 import { numericChatIdFor } from "../../util/chat-id.js";

package/src/core/background/heartbeat/agent.ts

@@ -11,7 +11,7 @@ import { logError, logWarn } from "../../../util/log.js";
 import { toYMD } from "../../../util/time.js";
 import { getDefaultModel } from "../../models/catalog.js";
 import { loadSystemTemplate } from "../../prompt/templates.js";
-import { formatGoal, getOpenGoals } from "../../../storage/goal-store.js";
+import { formatGoal, getOpenGoals } from "../../../storage/goals.js";
 import { taskTable, type TaskHandle } from "../../tasks/index.js";
 import type { Backend } from "../../agent-runtime/capabilities.js";
 import type { OneShotAgentParams } from "../../types.js";

package/src/core/background/triggers/command.ts

@@ -5,7 +5,7 @@
  */
 
 import { spawnSync } from "node:child_process";
-import type { Trigger } from "../../../storage/trigger-store.js";
+import type { Trigger } from "../../../storage/triggers.js";
 import { selfInvocation } from "../../../util/mcp-launcher.js";
 import { LUA_RUN_SUBCOMMAND } from "../../scripting/lua-runner.js";
 

package/src/core/background/triggers/exit.ts

@@ -11,7 +11,7 @@ import {
   SHUTDOWN_KILL_ERROR,
   type Trigger,
   type TriggerStatus,
-} from "../../../storage/trigger-store.js";
+} from "../../../storage/triggers.js";
 import { log, logDebug, logError } from "../../../util/log.js";
 import { appendDailyLog } from "../../../storage/daily-log.js";
 import {

package/src/core/background/triggers/output.ts

@@ -8,7 +8,7 @@ import {
   updateTrigger,
   type TriggerStatus,
   FIRE_PAYLOAD_MAX_BYTES,
-} from "../../../storage/trigger-store.js";
+} from "../../../storage/triggers.js";
 import { logError } from "../../../util/log.js";
 import {
   depsHolder,

package/src/core/background/triggers/resume.ts

@@ -11,7 +11,7 @@ import {
   RESTART_KILL_ERROR,
   SHUTDOWN_KILL_ERROR,
   type Trigger,
-} from "../../../storage/trigger-store.js";
+} from "../../../storage/triggers.js";
 import { log, logError } from "../../../util/log.js";
 import { depsHolder } from "./state.js";
 import { fireWake } from "./output.js";

package/src/core/background/triggers/spawn.ts

@@ -11,7 +11,7 @@ import {
   getTrigger,
   updateTrigger,
   type Trigger,
-} from "../../../storage/trigger-store.js";
+} from "../../../storage/triggers.js";
 import { log, logError, logWarn } from "../../../util/log.js";
 import { spawnWarden, type WardenExitEvent } from "../../../native/warden.js";
 import {

package/src/core/{doctor.ts → doctor/index.ts}

@@ -13,22 +13,22 @@
 
 import { existsSync } from "node:fs";
 import { stat } from "node:fs/promises";
-import { NATIVE_MODULES } from "../native/registry.js";
-import { dirs } from "../util/paths.js";
-import { getBackend, listBackends } from "./agent-runtime/backend-registry.js";
+import { NATIVE_MODULES } from "../../native/registry.js";
+import { dirs } from "../../util/paths.js";
+import { getBackend, listBackends } from "../agent-runtime/backend-registry.js";
 import type {
   DoctorCheck,
   DoctorConfigSlice,
   DoctorReport,
   NativeModuleCheck,
-} from "./doctor-types.js";
+} from "./types.js";
 
 export type {
   DoctorCheck,
   DoctorConfigSlice,
   DoctorReport,
   NativeModuleCheck,
-} from "./doctor-types.js";
+} from "./types.js";
 
 function errorNote(err: unknown): string {
   return err instanceof Error ? err.message : String(err);
@@ -180,7 +180,7 @@ async function checkPluginRuntimes(
   config: DoctorConfigSlice | undefined,
 ): Promise<DoctorCheck[]> {
   const checks: DoctorCheck[] = [];
-  const { NATIVE_RUNTIMES } = await import("./plugin/native-runtimes.js");
+  const { NATIVE_RUNTIMES } = await import("../plugin/native-runtimes.js");
   for (const runtime of NATIVE_RUNTIMES) {
     if (!runtime.enabled(config)) continue;
     try {
@@ -322,7 +322,7 @@ export async function collectDoctorReport(opts: {
   // on the in-process TS path. When present, report the live version.
   {
     const { wardenBinaryPath, wardenVersion } =
-      await import("../native/warden.js");
+      await import("../../native/warden.js");
     const wardenBin = wardenBinaryPath();
     if (wardenBin) {
       const version = wardenVersion();
@@ -350,7 +350,7 @@ export async function collectDoctorReport(opts: {
   // and on the event loop), so it's informational, not an issue. The
   // addon was digest-verified at load time by nativeBlake3().
   {
-    const { nativeBlake3 } = await import("../native/blake3.js");
+    const { nativeBlake3 } = await import("../../native/blake3.js");
     const addon = nativeBlake3();
     checks.push(
       addon
@@ -370,7 +370,7 @@ export async function collectDoctorReport(opts: {
   // ~/.talon/ns is the symlink farm only (file mounts fine, no live
   // proc//plugins views), so it's informational, not an issue.
   {
-    const { nativeFuseFs } = await import("../native/fusefs.js");
+    const { nativeFuseFs } = await import("../../native/fusefs.js");
     const addon = nativeFuseFs();
     checks.push(
       addon
@@ -392,7 +392,7 @@ export async function collectDoctorReport(opts: {
   // stale or the package is incomplete — caught at check time, not
   // mid-message when a backend assembles its system prompt.
   {
-    const { loadSystemTemplate } = await import("./prompt/index.js");
+    const { loadSystemTemplate } = await import("../prompt/index.js");
     try {
       const sample = loadSystemTemplate("workspace");
       checks.push(
@@ -423,7 +423,7 @@ export async function collectDoctorReport(opts: {
   // is which is the difference between "why didn't my prompt update?"
   // and a one-line answer.
   {
-    const { promptSeedReport } = await import("../util/workspace.js");
+    const { promptSeedReport } = await import("../../util/workspace.js");
     try {
       const { tracking, edited } = promptSeedReport();
       if (tracking.length + edited.length > 0) {

package/src/core/engine/gateway-actions/cron.ts

@@ -11,7 +11,7 @@ import {
   generateCronId,
   describeSchedule,
   nextRunAt,
-} from "../../../storage/cron-store.js";
+} from "../../../storage/cron.js";
 import { runJobNow } from "../../background/cron.js";
 import { parseCronSpec } from "../../background/cron-spec.js";
 import { log } from "../../../util/log.js";
@@ -22,7 +22,7 @@ import {
   acquireBackendInstance,
   isModelValidForBackend,
 } from "../backend-controller/index.js";
-import { validateJobModelOverride } from "./shared.js";
+import { validateJobModelOverride } from "./validation.js";
 import type { SharedActionHandlers } from "./types.js";
 
 /**

package/src/core/engine/gateway-actions/goals.ts

@@ -20,9 +20,9 @@ import {
   OPEN_GOAL_STATUSES,
   type Goal,
   type GoalStatus,
-} from "../../../storage/goal-store.js";
+} from "../../../storage/goals.js";
 import { log } from "../../../util/log.js";
-import { parseDueDate } from "./shared.js";
+import { parseDueDate } from "./validation.js";
 import type { SharedActionHandlers } from "./types.js";
 
 export const goalHandlers: SharedActionHandlers = {

package/src/core/engine/gateway-actions/scripts.ts

@@ -14,7 +14,7 @@ import {
   validateScriptLanguage,
   validateScriptName,
   validateScriptBody,
-} from "../../../storage/script-store.js";
+} from "../../../storage/scripts.js";
 import {
   runScript,
   validateScriptTimeout,

package/src/core/engine/gateway-actions/skills.ts

@@ -15,7 +15,7 @@ import {
   validateSkillBody,
   validateSkillDescription,
   validateSkillName,
-} from "../../../storage/skill-store.js";
+} from "../../../storage/skills.js";
 import { log } from "../../../util/log.js";
 import type { SharedActionHandlers } from "./types.js";
 

package/src/core/engine/gateway-actions/triggers.ts

@@ -21,13 +21,13 @@ import {
   DEFAULT_TIMEOUT_SECONDS,
   MAX_ACTIVE_PER_CHAT,
   type TriggerLanguage,
-} from "../../../storage/trigger-store.js";
+} from "../../../storage/triggers.js";
 import {
   cancelTrigger,
   spawnTrigger,
 } from "../../background/triggers/index.js";
 import { log } from "../../../util/log.js";
-import { validateJobModelOverride } from "./shared.js";
+import { validateJobModelOverride } from "./validation.js";
 import type { SharedActionHandlers } from "./types.js";
 
 export const triggerHandlers: SharedActionHandlers = {

package/src/core/engine/gateway-actions/{shared.ts → validation.ts}

@@ -1,6 +1,6 @@
 /**
- * Helpers shared across shared-action domains: due-date parsing and per-job
- * model-override validation.
+ * Field validation shared by the goal, cron and trigger actions: due-date
+ * parsing and per-job model-override validation.
  */
 
 import { resolveExplicitModelRef } from "../../models/active-model.js";

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/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/core/prompt/assemble.ts

@@ -63,8 +63,8 @@ import { log } from "../../util/log.js";
 import { loadSystemTemplate } from "./templates.js";
 import { renderMemoryView } from "./memory-view.js";
 import { renderWorkspaceListing } from "./workspace-listing.js";
-import { renderSkillsPrompt } from "../../storage/skill-store.js";
-import { renderStickerLibraryPrompt } from "../../storage/sticker-store.js";
+import { renderSkillsPrompt } from "../../storage/skills.js";
+import { renderStickerLibraryPrompt } from "../../storage/stickers.js";
 import { getSoul } from "../soul/service.js";
 
 // ── Types ───────────────────────────────────────────────────────────────────

package/src/core/scripts/runner.ts

@@ -16,7 +16,7 @@ import { spawn } from "node:child_process";
 import { dirs } from "../../util/paths.js";
 import { log } from "../../util/log.js";
 import { commandForLanguage } from "../background/triggers/index.js";
-import type { Script } from "../../storage/script-store.js";
+import type { Script } from "../../storage/scripts.js";
 
 export const DEFAULT_SCRIPT_TIMEOUT_SECONDS = 60;
 const MAX_SCRIPT_TIMEOUT_SECONDS = 300;

package/src/core/soul/forgetting.ts

@@ -93,7 +93,7 @@ export function effectiveStrength(
   );
 }
 
-export interface FsrsReinforceOpts {
+export interface FsrsReinforceOptions {
   readonly now: number;
   readonly cfg: SoulConfig;
   readonly amount: number;
@@ -111,7 +111,7 @@ export interface FsrsReinforceOpts {
  */
 export function reinforceFsrs(
   state: ActivationState,
-  opts: FsrsReinforceOpts,
+  opts: FsrsReinforceOptions,
 ): ActivationState {
   if (!Number.isFinite(halfLifeForKind(opts.cfg, opts.kind))) {
     state.salience += opts.amount;

package/src/core/soul/salience.ts

@@ -60,7 +60,7 @@ export function confidence(state: ActivationState): number {
   return Math.tanh(state.evidence / 4);
 }
 
-export interface ReinforceOpts {
+export interface ReinforceOptions {
   readonly now: number;
   readonly halfLifeMs: number;
   /** Salience increment for this activation (>= 0). */
@@ -74,7 +74,11 @@ export interface ReinforceOpts {
  * first (so the additive bump composes correctly with time), then adds the
  * increment and accumulates signed evidence.
  */
-export function reinforce(dag: SoulDag, hash: Hash, opts: ReinforceOpts): void {
+export function reinforce(
+  dag: SoulDag,
+  hash: Hash,
+  opts: ReinforceOptions,
+): void {
   const s = dag.stateOf(hash);
   s.salience = effectiveSalience(s, opts.now, opts.halfLifeMs) + opts.amount;
   s.evidence += opts.valence;
@@ -111,7 +115,7 @@ export function coactivate(
   }
 }
 
-export interface PredictionErrorOpts {
+export interface PredictionErrorOptions {
   readonly now: number;
   readonly halfLifeMs: number;
   /** How strongly the observed signal corrects the prediction, in (0, 1]. */
@@ -129,7 +133,7 @@ export function applyPredictionError(
   dag: SoulDag,
   hash: Hash,
   observed: number,
-  opts: PredictionErrorOpts,
+  opts: PredictionErrorOptions,
 ): number {
   const s = dag.stateOf(hash);
   const predicted = effectiveSalience(s, opts.now, opts.halfLifeMs);

package/src/frontend/discord/actions/{shared.ts → buttons.ts}

@@ -1,63 +1,10 @@
 /**
- * Shared helpers for Discord action handlers: clean error mapping, channel
- * resolution, and button-row construction.
+ * Button-row construction for model-authored inline buttons (Discord
+ * components), with custom_id namespacing and de-duplication.
  */
 
-import {
-  type Client,
-  type TextBasedChannel,
-  ActionRowBuilder,
-  ButtonBuilder,
-  ButtonStyle,
-} from "discord.js";
-import type { ActionResult } from "../../../core/types.js";
-import { lookupDiscordChat } from "../handlers/index.js";
+import { ActionRowBuilder, ButtonBuilder, ButtonStyle } from "discord.js";
 import { safeSlice } from "../formatting.js";
-import { logWarn } from "../../../util/log.js";
-import { mapDiscordError } from "../errors.js";
-
-/** Run a Discord action; convert DiscordAPIError into a clean ActionResult. */
-export async function tryAction(
-  context: string,
-  fn: () => Promise<ActionResult>,
-): Promise<ActionResult> {
-  try {
-    return await fn();
-  } catch (err) {
-    const mapped = mapDiscordError(err, context);
-    if (mapped) return mapped;
-    return {
-      ok: false,
-      error: `${context} failed: ${err instanceof Error ? err.message : err}`,
-    };
-  }
-}
-
-export async function resolveChannel(
-  client: Client,
-  numericChatId: number,
-): Promise<TextBasedChannel | null> {
-  const info = lookupDiscordChat(numericChatId);
-  if (!info) return null;
-  try {
-    const ch = await client.channels.fetch(info.channelId);
-    if (ch && "send" in ch && (ch as TextBasedChannel).isSendable?.()) {
-      return ch as TextBasedChannel;
-    }
-    if (info.userId) {
-      const user = await client.users.fetch(info.userId);
-      const dm = await user.createDM();
-      return dm as TextBasedChannel;
-    }
-    return null;
-  } catch (err) {
-    logWarn(
-      "discord",
-      `resolveChannel failed for chat ${numericChatId}: ${err instanceof Error ? err.message : err}`,
-    );
-    return null;
-  }
-}
 
 export function buildButtonRows(
   rows: Array<

package/src/frontend/discord/actions/channels.ts

@@ -0,0 +1,34 @@
+/**
+ * Resolve a registered Discord chat to a sendable channel (guild channel or
+ * the user's DM).
+ */
+
+import type { Client, TextBasedChannel } from "discord.js";
+import { lookupDiscordChat } from "../handlers/index.js";
+import { logWarn } from "../../../util/log.js";
+
+export async function resolveChannel(
+  client: Client,
+  numericChatId: number,
+): Promise<TextBasedChannel | null> {
+  const info = lookupDiscordChat(numericChatId);
+  if (!info) return null;
+  try {
+    const ch = await client.channels.fetch(info.channelId);
+    if (ch && "send" in ch && (ch as TextBasedChannel).isSendable?.()) {
+      return ch as TextBasedChannel;
+    }
+    if (info.userId) {
+      const user = await client.users.fetch(info.userId);
+      const dm = await user.createDM();
+      return dm as TextBasedChannel;
+    }
+    return null;
+  } catch (err) {
+    logWarn(
+      "discord",
+      `resolveChannel failed for chat ${numericChatId}: ${err instanceof Error ? err.message : err}`,
+    );
+    return null;
+  }
+}

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

@@ -6,7 +6,7 @@
 
 import { ChannelType } from "discord.js";
 import { logWarn } from "../../../util/log.js";
-import { tryAction } from "./shared.js";
+import { tryAction } from "./try-action.js";
 import type { DiscordActionHandlers } from "./types.js";
 
 export const chatInfoHandlers: DiscordActionHandlers = {

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

@@ -23,7 +23,7 @@
 import type { Client } from "discord.js";
 import type { Gateway } from "../../../core/engine/gateway.js";
 import type { ActionResult } from "../../../core/types.js";
-import { resolveChannel } from "./shared.js";
+import { resolveChannel } from "./channels.js";
 import { messagingHandlers, restoreScheduledMessages } from "./messaging.js";
 import { mediaHandlers } from "./media.js";
 import { chatInfoHandlers } from "./chat-info.js";

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

@@ -11,7 +11,7 @@ import { withRetry } from "../../../core/engine/gateway.js";
 import { sendChunked } from "../handlers/index.js";
 import { suppressMentions, DISCORD_MAX_TEXT } from "../formatting.js";
 import { maxAttachmentBytes } from "../errors.js";
-import { tryAction } from "./shared.js";
+import { tryAction } from "./try-action.js";
 import type { DiscordActionHandlers } from "./types.js";
 
 const sendAttachment: DiscordActionHandlers[string] = (

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

@@ -19,8 +19,10 @@ import {
   listScheduledForChat,
   MAX_OVERDUE_MS,
   type ScheduledMessage,
-} from "../../../storage/scheduled-store.js";
-import { tryAction, resolveChannel, buildButtonRows } from "./shared.js";
+} from "../../../storage/scheduled.js";
+import { tryAction } from "./try-action.js";
+import { resolveChannel } from "./channels.js";
+import { buildButtonRows } from "./buttons.js";
 import type { DiscordActionHandlers } from "./types.js";
 
 // ── Scheduled sends (persistent) ─────────────────────────────────────────────

package/src/frontend/discord/actions/try-action.ts

@@ -0,0 +1,24 @@
+/**
+ * Run a Discord action with uniform error mapping: DiscordAPIError becomes a
+ * clean ActionResult, anything else a labelled failure.
+ */
+
+import type { ActionResult } from "../../../core/types.js";
+import { mapDiscordError } from "../errors.js";
+
+/** Run a Discord action; convert DiscordAPIError into a clean ActionResult. */
+export async function tryAction(
+  context: string,
+  fn: () => Promise<ActionResult>,
+): Promise<ActionResult> {
+  try {
+    return await fn();
+  } catch (err) {
+    const mapped = mapDiscordError(err, context);
+    if (mapped) return mapped;
+    return {
+      ok: false,
+      error: `${context} failed: ${err instanceof Error ? err.message : err}`,
+    };
+  }
+}