talon-agent 4.3.1 → 4.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "talon-agent",
-  "version": "4.3.1",
+  "version": "4.3.2",
   "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/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";

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/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/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/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}`,
+    };
+  }
+}

package/src/frontend/discord/admin.ts

@@ -19,11 +19,11 @@ import {
   getAllCronJobs,
   describeSchedule,
   nextRunAt,
-} from "../../storage/cron-store.js";
+} from "../../storage/cron.js";
 import { getActiveCount } from "../../core/engine/dispatcher.js";
 import { getPulseStatus } from "../../core/background/pulse.js";
 import { getHealthStatus, getRecentErrors } from "../../util/watchdog.js";
-import { formatDuration, formatModelLabel } from "./helpers.js";
+import { formatDuration, formatModelLabel } from "./render.js";
 import {
   DISCORD_MAX_TEXT,
   DISCORD_SAFE_RESERVE,

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

@@ -31,7 +31,7 @@ import {
   enablePulse,
   isPulseEnabled,
 } from "../../../../core/background/pulse.js";
-import { renderSettingsText, EFFORT_DESCRIPTIONS } from "../../helpers.js";
+import { renderSettingsText, EFFORT_DESCRIPTIONS } from "../../render.js";
 import {
   getBackendIdForChat,
   resolveChatBackend,

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

@@ -8,7 +8,7 @@ import type { Gateway } from "../../../core/engine/gateway.js";
 import { setChatPulseInterval } from "../../../storage/chat-settings.js";
 import { registerChat, enablePulse } from "../../../core/background/pulse.js";
 import { isInteractionAllowed } from "../handlers/index.js";
-import { parseInterval, formatDuration } from "../helpers.js";
+import { parseInterval, formatDuration } from "../render.js";
 import { logError } from "../../../util/log.js";
 
 export async function handleModalSubmit(

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

@@ -18,7 +18,7 @@ import {
   formatDuration,
   renderMetricsMessages,
   renderDoctorMessages,
-} from "../helpers.js";
+} from "../render.js";
 import { collectDoctorReport } from "../../../core/doctor.js";
 import { getSoul } from "../../../core/soul/service.js";
 import { getMetrics, getTodayMetrics } from "../../../storage/metrics.js";
@@ -34,7 +34,7 @@ import {
   getRepoRoot,
   runSelfUpdate,
 } from "../../../core/update/self-update.js";
-import { reply } from "./shared.js";
+import { reply } from "./interaction.js";
 
 export async function handleRestart(
   i: ChatInputCommandInteraction,

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

@@ -11,13 +11,13 @@ import {
   formatDuration,
   renderMeshReport,
   renderUsageMessage,
-} from "../helpers.js";
+} from "../render.js";
 import type { TalonConfig } from "../../../util/config.js";
 import { collectPlanUsage } from "../../shared/plan-usage-report.js";
 import { getLoadedPlugins } from "../../../core/plugin/index.js";
 import { getMeshService } from "../../../core/mesh/index.js";
 import type { MeshPingResult } from "../../../core/mesh/service.js";
-import { reply } from "./shared.js";
+import { reply } from "./interaction.js";
 
 export async function handleStart(
   i: ChatInputCommandInteraction,

package/src/frontend/discord/commands/{shared.ts → interaction.ts}

@@ -1,5 +1,6 @@
 /**
- * Helpers shared by the Discord slash-command handlers + router.
+ * Interaction accessors for the Discord slash-command handlers + router:
+ * chat-id derivation, chunked reply, client.
  */
 
 import { type ChatInputCommandInteraction, MessageFlags } from "discord.js";

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

@@ -21,7 +21,7 @@ import {
   handleComponentInteraction,
   handleModalSubmit,
 } from "../callbacks/index.js";
-import { chatIdFromInteraction, reply, client } from "./shared.js";
+import { chatIdFromInteraction, reply, client } from "./interaction.js";
 import {
   handleStart,
   handleHelp,

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

@@ -14,7 +14,7 @@ import {
   formatTokenCount,
   formatBytes,
   formatUsd,
-} from "../helpers.js";
+} from "../render.js";
 import {
   getBackendIdForChat,
   resolveChatBackend,
@@ -24,7 +24,7 @@ import {
   collectSessionStatus,
 } from "../../shared/session-status.js";
 import { stopCurrentTurn } from "../../../core/engine/dispatcher.js";
-import { reply } from "./shared.js";
+import { reply } from "./interaction.js";
 
 export async function handleReset(
   i: ChatInputCommandInteraction,

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

@@ -33,7 +33,7 @@ import {
   parseInterval,
   renderSettingsText,
   EFFORT_DESCRIPTIONS,
-} from "../helpers.js";
+} from "../render.js";
 import {
   displayReasoningEffort,
   getActiveReasoningLevels,
@@ -45,7 +45,7 @@ import {
 } from "../../../core/engine/backend-controller/index.js";
 import { resolveActiveModelForChat } from "../../../core/models/active-model.js";
 import { safeSlice } from "../formatting.js";
-import { reply } from "./shared.js";
+import { reply } from "./interaction.js";
 import {
   buildModelPickerView,
   MODEL_NAV_PREFIX,

package/src/frontend/discord/{helpers.ts → render.ts}

@@ -1,5 +1,6 @@
 /**
- * Shared helpers for Discord commands, callbacks, and the settings panel.
+ * Message rendering for Discord commands, callbacks, and the settings panel:
+ * metrics, doctor, mesh, usage and settings text, sized to Discord's limits.
  *
  * Discord-specific quirks vs the Telegram helpers:
  *  - settings panel uses Components (Buttons + Select Menus), not inline keyboard.

package/src/frontend/native/extensions.ts

@@ -22,7 +22,7 @@ import { performPluginReload } from "../../core/engine/gateway-actions/plugins.j
 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/skill-store.js";
+import { listSkills, setSkillEnabled } from "../../storage/skills.js";
 import { rebuildSystemPrompt, type TalonConfig } from "../../util/config.js";
 import { log } from "../../util/log.js";
 import type { PluginItem, SkillItem, ToggleResult } from "./protocol.js";